Search by

bimakaza4enko-hash / up-server-practice3

bimakaza4enko-hash

Реестр помещений учебно-методического управления

Package info

github.com/bimakaza4enko-hash/up-server-practice3

Type:project

pkg:composer/bimakaza4enko-hash/up-server-practice3

Statistics

Installs: 0

Dependents: 0

Suggesters: 0

Stars: 0

Open Issues: 0

dev-main 2026-11-18 03:59 UTC

This package is auto-updated.

Last update: 2026-11-18 04:01:37 UTC


README

УМУ — Учёт помещений учебно-методического управления

Информационная система для учёта помещений учебно-методического управления (вариант 5): здания, помещения, их площадь и посадочные места.

Возможности

  • Роли: Администратор системы и Сотрудник деканата;
  • администратор добавляет учётные записи сотрудников деканата;
  • сотрудник деканата добавляет здания и помещения;
  • фильтрация помещений по зданию;
  • подсчёт общей площади учебных аудиторий по зданиям и в целом;
  • подсчёт общего количества посадочных мест по зданиям;
  • web-интерфейс и JSON API.
  1. Установка

Окружение использует:

Склонировать репозиторий и установить зависимости Composer:

git clone <repository-url>
composer install
  1. Настройка

Скопировать .env.example в .env и заполнить его:

  1. PROJECT_NAME — название проекта;
  2. USER/PASSWORD — пользователь веб-сервера в контейнере;
  3. WEB_PORT — внешний порт веб-сервера (по умолчанию 8080);
  4. DB_DRIVER, DB_HOST, DB_PORT, DB_CONTAINER_PORT — параметры подключения к MariaDB;
  5. DB_DATABASE, DB_USERNAME, DB_PASSWORD — имя БД и учётные данные;
  6. APP_DB_USERNAME, APP_DB_PASSWORD — привилегированный пользователь для автосоздания схемы;
  7. DB_AUTO_SETUP — если true, автоматически создаётся схема и демо-данные (admin@company.local — администратор, dean@company.local — сотрудник деканата);
  8. 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 Сотрудник деканата

  1. Тесты

Тесты запускаются в контейнере:

docker compose exec php ./vendor/bin/phpunit

Либо локально (нужны расширения dom, json, libxml, mbstring, xml, xmlwriter):

./vendor/bin/phpunit

Сценарии тестирования описаны в docs/test-scenarios.md.

  1. Документация
  • docs/use-case.md — Use-Case диаграмма;
  • docs/logical-model.md — ER-модель;
  • docs/prototypes.md — прототипы интерфейсов;
  • docs/test-scenarios.md — сценарии тестирования.