docs: add UML and architecture documentation (Mermaid)

- docs/README.md — index and short system overview
- 01-architecture.md — context, per-service components, Gradle modules,
  authentication/authorization, web interceptors (flowcharts)
- 02-deployment.md — deployment diagram, containers/env/volumes, build stages,
  nginx, update sequence
- 03-domain-model.md — class diagrams for identity/academic/progress and web,
  ER model of all schemas (cross-schema references noted)
- 04-sequences.md — 10 sequence diagrams (login, JWT check, forced password
  change, lab import, distribution, submission, defense, grades+publication,
  content publishing, group page aggregation)
- 05-states.md — state diagrams for defense session, grade publication, lab
  status, content visibility, submission lifecycle, variant assignment, password
MS
git log --oneline -3

docs/README.md

@@ -0,0 +1,30 @@
+# Документация LMS
+
+UML- и архитектурные диаграммы проекта. Все диаграммы — в формате **Mermaid**,
+поэтому они рендерятся прямо в Gitea/GitHub, в VS Code (расширение Markdown
+Preview Mermaid Support) и в IntelliJ IDEA (плагин Mermaid).
+
+## Содержание
+
+| Документ | Что описывает |
+|---|---|
+| [01-architecture.md](01-architecture.md) | Контекст системы, компоненты, модули Gradle, схема аутентификации |
+| [02-deployment.md](02-deployment.md) | Диаграмма развёртывания: Docker, nginx, тома, порты, переменные окружения |
+| [03-domain-model.md](03-domain-model.md) | Диаграммы классов по сервисам, ER-модель БД, модель web-слоя |
+| [04-sequences.md](04-sequences.md) | Диаграммы последовательностей: вход, импорт ЛР, раздача вариантов, сдача, защита, оценки, материалы |
+| [05-states.md](05-states.md) | Диаграммы состояний: защита, публикация оценок, статус ЛР, публикация материалов |
+
+## Кратко о системе
+
+LMS — микросервисное приложение на Kotlin/Spring Boot 3 (Java 21) с
+server-side-rendered UI на Thymeleaf + htmx:
+
+- **gateway** (`:8080`) — единая точка входа для REST API: маршрутизация и проверка JWT;
+- **identity-service** (`:8081`) — аккаунты, группы, студенты, аутентификация (JWT + JWKS);
+- **academic-service** (`:8082`) — семестры, лабораторные (уровни, варианты), учебные материалы;
+- **progress-service** (`:8083`) — варианты/уровни студентов, сдачи, оценки и комментарии, защиты;
+- **web** (`:8090`) — BFF: сессии, CSRF, страницы админа и студента, markdown-рендер;
+- **PostgreSQL 18** — одна БД `lms` со схемами `identity`, `academic`, `progress`.
+
+Поток запроса: браузер → nginx → web → gateway → сервис → PostgreSQL.
+Подробности — в [01-architecture.md](01-architecture.md).