bimakaza4enko-hash / up-server-practice3
Реестр помещений учебно-методического управления
Package info
github.com/bimakaza4enko-hash/up-server-practice3
Type:project
pkg:composer/bimakaza4enko-hash/up-server-practice3
Requires
- php: ^8.0.2
- ext-pdo: *
- bimakaza4enko-hash/collection: dev-main
- illuminate/database: ^9.0
- illuminate/events: ^9.0
- nikic/fast-route: ^1.3
Requires (Dev)
- phpunit/phpunit: ^9.6
Suggests
None
Provides
None
Conflicts
None
Replaces
None
This package is auto-updated.
Last update: 2026-11-18 04:01:37 UTC
README
УМУ — Учёт помещений учебно-методического управления
Информационная система для учёта помещений учебно-методического управления (вариант 5): здания, помещения, их площадь и посадочные места.
Возможности
- Роли: Администратор системы и Сотрудник деканата;
- администратор добавляет учётные записи сотрудников деканата;
- сотрудник деканата добавляет здания и помещения;
- фильтрация помещений по зданию;
- подсчёт общей площади учебных аудиторий по зданиям и в целом;
- подсчёт общего количества посадочных мест по зданиям;
- web-интерфейс и JSON API.
- Установка
Окружение использует:
- Docker и Docker Compose;
- Apache + PHP — контейнер с веб-сервером;
- MariaDB 10.7 — СУБД;
- PhpMyAdmin — панель управления БД.
Склонировать репозиторий и установить зависимости Composer:
git clone <repository-url> composer install
- Настройка
Скопировать .env.example в .env и заполнить его:
PROJECT_NAME— название проекта;USER/PASSWORD— пользователь веб-сервера в контейнере;WEB_PORT— внешний порт веб-сервера (по умолчанию8080);DB_DRIVER,DB_HOST,DB_PORT,DB_CONTAINER_PORT— параметры подключения к MariaDB;DB_DATABASE,DB_USERNAME,DB_PASSWORD— имя БД и учётные данные;APP_DB_USERNAME,APP_DB_PASSWORD— привилегированный пользователь для автосоздания схемы;DB_AUTO_SETUP— еслиtrue, автоматически создаётся схема и демо-данные (admin@company.local— администратор,dean@company.local— сотрудник деканата);DB_ROOT_PASSWORD,WEB_PORT_PHPMYADMIN— пароль root и порт phpMyAdmin.
Контейнеры php и phpmyadmin подключаются к MariaDB по внутреннему адресу db:3306.
3. Запуск и остановка
docker compose up -d docker compose down
Входные учётные записи (при DB_AUTO_SETUP=1):
Логин | Роль
admin@company.local/telephony123 Администратор системы dean@company.local / telephony123 Сотрудник деканата
- Тесты
Тесты запускаются в контейнере:
docker compose exec php ./vendor/bin/phpunit
Либо локально (нужны расширения dom, json, libxml, mbstring, xml, xmlwriter):
./vendor/bin/phpunit
Сценарии тестирования описаны в docs/test-scenarios.md.
- Документация
docs/use-case.md— Use-Case диаграмма;docs/logical-model.md— ER-модель;docs/prototypes.md— прототипы интерфейсов;docs/test-scenarios.md— сценарии тестирования.