Об этом проекте

Этот репозиторий представляет собой самостоятельно размещаемую платформу управления школой для одной школы на развёртывание. Она построена на Laravel 13, PHP 8.3, MySQL 8 и Redis 7 и поставляется со стеком Docker Compose (app, nginx, db, redis, MinIO, Horizon, scheduler). Административный интерфейс отрисовывается на сервере с помощью Laravel Blade и Bootstrap 5. Объём и модули: в README описаны 26 доменных модулей, сгруппированных в базовую платформу (школа, учебные годы/классы/секции/предметы/расписания, пользователи и аутентификация), жизненный цикл учащегося (зачисление, перевод в следующий класс, перевод, онлайн-приём, импорт данных), учебный процесс (экзамены, оценки, GPA/табуляция, сертификаты, посещаемость с RFID), финансы (статьи сборов, платежи через bKash/SSLCommerz/Stripe/PayPal, чеки, возвраты, расчёт заработной платы, отчёты), коммуникации (объявления, пакетная отправка SMS, цепочки сообщений) и операционные функции (персонал, отпуска, библиотека, транспорт, ID-карты, LMS, CMS для сайта). Модуль локализации предоставляет хранимые в базе данных переводы с поддержкой RTL. Роли включают супер-администратора, администратора, учителя, бухгалтера, библиотекаря, регистратора, учащегося и родителя, с отдельными порталами для администраторов, персонала и учащихся/опекунов. Авторизация использует Spatie Laravel Permission для веб-интерфейса и токены Laravel Sanctum с разрешениями для API. Замечания по архитектуре: документированный 10-шаговый шаблон модуля (миграция, модель, репозиторий, сервис, наблюдатель, запросы, ресурсы, контроллер/маршруты, тесты, стиль/документация), шаблон репозитория с кэшированием на основе тегов, которое также работает в хранилищах кэша без Redis, финансовые операции, обёрнутые в транзакции базы данных, и запросы с областью действия по school_id. В README указано, что имеется более 206 функциональных тестов и что PHPStan работает на уровне 5. Развёртывание: быстрый старт с Docker с предварительно заполненными демонстрационными учётными данными, а также документированные пути для установки на общем хостинге cPanel и VPS, которые переключаются на кэш/очереди/сессии на базе базы данных и локальное файловое хранилище. Документация API генерируется с помощью Scribe. Поддержка нескольких стран охватывает локаль, валюту, часовой пояс, выходные дни, платёжные шлюзы для конкретных стран и несколько шаблонов оценивания (Бангладеш 5.0, США 4.0, Великобритания 9-1, процентная шкала). В README проект описывается как хобби/R&D-разработка, в значительной степени созданная с помощью агента ИИ для программирования, и прямо позиционируется как площадка для прототипирования, а не как профессионально прошедший контроль качества продукт. Он лицензирован под AGPL-3.0, условие которой о сетевом использовании требует публикации модификаций при работе в качестве сетевого сервиса.