97bf3cc50a
Админка, настройки, логин, кабинеты преподавателя и студента полностью переведены на React 19 (модель strangler, docs/REACT_MIGRATION.md). - 15 вкладок админки: lazy-загрузка, общий error boundary, сервисный слой - Удалены legacy-views и переходный слой LegacyTabView (45 файлов) - Сборка esbuild (frontend/scripts/build-react.mjs) с бюджетами gzip на чанки - CSP-хэши, кэширование: chunk'и immutable, CSS/HTML no-cache (react-cache.conf) - Фиксы: lazy-импорт именованных экспортов (краш после авторизации), растяжение #admin-root/#settings-root на всю ширину, возврат subjects/lessonTypes из справочников (краш просмотра расписаний), отказ от заведомо широкого поиска расписания без выбранной цели, центрирование карточки логина - Тесты: 237/237 (npm run check), регрессионные на lazy-вкладки и ширину - Документация: REACT_MIGRATION.md, REACT_MIGRATION_RESULT.md, FRONTEND.md
99 lines
6.0 KiB
Markdown
Executable File
99 lines
6.0 KiB
Markdown
Executable File
# AGENTS.md - Руководство для агентных помощников
|
||
|
||
## Обзор проекта
|
||
|
||
Проект представляет собой систему управления университетским расписанием.
|
||
- **Backend**: Java 17, Spring Boot 3.5.16 (Мультитенантная архитектура: отдельная БД для каждого клиента)
|
||
- **Frontend**: поэтапный переход с Vanilla JavaScript на React 19 + HTML/CSS
|
||
- **Database**: PostgreSQL (множество БД, управляются через Flyway)
|
||
- **Локальный URL**: localhost:80
|
||
- **Продакшн URL**: https://magistr.zuev.company
|
||
|
||
---
|
||
|
||
## Структура директорий
|
||
|
||
```
|
||
magistr/
|
||
├── backend/ # Java Spring Boot приложение
|
||
│ └── src/main/java/com/magistr/app/
|
||
│ ├── controller/ # REST контроллеры
|
||
│ ├── model/ # JPA сущности
|
||
│ ├── dto/ # Data Transfer Objects
|
||
│ ├── repository/ # Spring Data JPA репозитории
|
||
│ ├── config/ # Конфигурация приложения
|
||
│ ├── utils/ # Утилиты
|
||
│ └── src/main/resources/db/migration/ # Flyway SQL миграции (версионирование схемы БД)
|
||
├── frontend/ # Статические файлы
|
||
│ ├── react/ # React entrypoint и компоненты уже перенесённых страниц
|
||
│ ├── admin/ # Интерфейс администратора
|
||
│ │ └── settings/ # Страница настроек (отдельный SPA)
|
||
│ ├── department/ # Redirect в кабинет кафедры внутри admin SPA
|
||
│ ├── edu-office/ # Redirect в кабинет учебного отдела внутри admin SPA
|
||
│ ├── teacher/ # Интерфейс преподавателя
|
||
│ └── student/ # Интерфейс студента
|
||
├── docs/ # 📖 Документация проекта
|
||
├── compose.yaml # Docker Compose конфигурация
|
||
└── .env # Переменные окружения
|
||
```
|
||
|
||
**Внешние зависимости (родительская директория)**
|
||
|
||
На уровень выше расположен конфиг kubernetes `../k8s/`, все файлы сборки на проде расположены там.
|
||
|
||
---
|
||
|
||
## Быстрый справочник команд
|
||
|
||
```bash
|
||
# Сборка и запуск
|
||
docker compose up -d --build
|
||
|
||
# Полный сброс БД
|
||
docker compose down -v && docker compose up -d
|
||
|
||
# Логи конкретного сервиса
|
||
docker compose logs -f backend
|
||
```
|
||
|
||
Подробнее — см. [`docs/README.md`](docs/README.md) и [`docs/INFRASTRUCTURE.md`](docs/INFRASTRUCTURE.md).
|
||
|
||
---
|
||
|
||
## Критические правила для агентов
|
||
|
||
### Flyway миграции
|
||
- До отдельного решения владельца проект работает в режиме пересобираемого baseline:
|
||
**все постоянные изменения схемы БД, функций, триггеров, индексов и ограничений вносить
|
||
только в `V1__init.sql`**.
|
||
- `V2__test_data.sql` зарезервирован исключительно для тестовых и демонстрационных данных.
|
||
Постоянный DDL в V2 запрещён; допустимы только временные staging-таблицы, удаляемые в конце миграции.
|
||
- Не создавать `V3` и последующие миграции, пока владелец явно не отменит этот временный режим.
|
||
- Изменение V1/V2 меняет контрольные суммы Flyway и требует полного сброса всех затронутых
|
||
tenant-БД. Не выполнять такой сброс без прямой команды владельца.
|
||
- Подробнее — см. [`docs/DATABASE.md`](docs/DATABASE.md)
|
||
|
||
### Языковые требования
|
||
- **Все ответы и комментарии на русском языке**
|
||
- Сообщения об ошибках и логи на русском
|
||
- Пользовательский интерфейс на русском
|
||
|
||
---
|
||
|
||
## Подробная документация
|
||
|
||
Полная документация проекта находится в папке `docs/`:
|
||
|
||
| Документ | Содержание |
|
||
|----------|-----------|
|
||
| [`docs/README.md`](docs/README.md) | Обзор проекта, стек технологий, быстрый старт |
|
||
| [`docs/ARCHITECTURE.md`](docs/ARCHITECTURE.md) | Архитектура системы, мультитенантность, аутентификация |
|
||
| [`docs/BUSINESS_LOGIC.md`](docs/BUSINESS_LOGIC.md) | Бизнес-логика, ролевая модель, правила расписания |
|
||
| [`docs/DATABASE.md`](docs/DATABASE.md) | Схема БД (ER-диаграмма), описание всех таблиц, Flyway |
|
||
| [`docs/API.md`](docs/API.md) | REST API эндпоинты с примерами запросов и ответов |
|
||
| [`docs/INFRASTRUCTURE.md`](docs/INFRASTRUCTURE.md) | Docker, Kubernetes, CI/CD, мониторинг (SigNoz) |
|
||
| [`docs/DEVELOPMENT.md`](docs/DEVELOPMENT.md) | Code Style, соглашения, пошаговое создание нового эндпоинта |
|
||
| [`docs/FRONTEND.md`](docs/FRONTEND.md) | Frontend архитектура, SPA-маршрутизация, CSS, адаптивность |
|
||
| [`docs/LOGGING.md`](docs/LOGGING.md) | Логирование: SLF4J + Logback, MDC, OpenTelemetry → SigNoz |
|
||
| [`docs/UI_COMPONENTS.md`](docs/UI_COMPONENTS.md) | Использование дизайн-системы (кастомные селекты, чекбоксы и др.) |
|