docs/index.md

Sova: документация проекта

Эта документация помогает быстро понять состав исходников, запустить окружение и найти основные точки входа.

Что находится в репозитории

• apps/backend - новое единое хранилище данных и API на Symfony 7.3.
• apps/adminPanel - админка на React (врачи, филиалы, акции, контент).
• apps/cabinet - старый личный кабинет на Symfony 5.4 с Twig и Webpack Encore.
• environments - набор Docker Compose-файлов для сетей, БД, приложений, мониторинга и Jenkins.
• infrastructure - Dockerfile и конфигурация nginx, PHP-FPM, PostgreSQL, Redis, Node.js.
• monitoring - конфигурация Prometheus, Grafana и дашборды.
• jenkins - Jenkins pipelines для backend и cabinet.
• scripts - эксплуатационные скрипты: cron, certbot, webhooks.

С чего начать

1. Прочитать быстрый старт.
2. Проверить окружение и наличие всех приложений.
3. Поднять Docker Compose через make dev.
4. Открыть страницы по Backend API и Cabinet.

Подробная архитектура

• Архитектура - Mermaid-схемы контейнеров, слоев и request flow.
• Потоки данных - запуск, синхронизация, расписание, запись и авторизация.
• adminPanel: CRUD контента - маршруты, виджеты полей, apiContent, валидация без alert (issues/27-future).
• Backend: CRUD для контентных сущностей - Pagerfanta, CrudResponder, фильтры, sync-сервисы, MR по веткам.
• adminPanel: обзор - React, RTK Query, layout, переиспользуемые компоненты.
• Backend: DDD / бизнес-сущности - ограниченные контексты, сущности, контроллеры, сервисы, команды по доменам.
• Backend: бизнес-сценарии (use cases) - пошаговые потоки: Identity, врачи/расписание, запись, синхронизация, интеграции.
• Backend: архитектура модулей - контроллеры, сервисы, команды, async-сообщения.
• Cabinet: архитектура модулей - монолит, Twig, формы, bundles-интеграции.
• Модели данных - ER-схемы и основные сущности.