Vladislav Kopnin
6246d4c8d3
- markdown: new directives `:::figure assets/x.png | Подпись` and `:::video assets/x.mp4 | Подпись` rendered as figure/figcaption and a video player (works with HTML escaping on); sanitizer allows video/source/ track/figure with safe attributes only - assets: video extensions (mp4/webm/ogg) allowed, separate limits — images up to 10 MB, video up to 100 MB; correct content types - upload limits raised: web/academic multipart 120 MB per file / 200 MB per request, nginx client_max_body_size 200m (covers media inside ZIP imports) - docs: new docs/06-authoring.md (markdown, images, video, assets, limits, import semantics); import message now says "медиафайлов"
Документация LMS
UML- и архитектурные диаграммы проекта. Все диаграммы — в формате Mermaid, поэтому они рендерятся прямо в Gitea/GitHub, в VS Code (расширение Markdown Preview Mermaid Support) и в IntelliJ IDEA (плагин Mermaid).
Содержание
| Документ | Что описывает |
|---|---|
| 01-architecture.md | Контекст системы, компоненты, модули Gradle, схема аутентификации |
| 02-deployment.md | Диаграмма развёртывания: Docker, nginx, тома, порты, переменные окружения |
| 03-domain-model.md | Диаграммы классов по сервисам, ER-модель БД, модель web-слоя |
| 04-sequences.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.