2.7 KiB
2.7 KiB
Диаграммы (PlantUML)
Исходники диаграмм для диссертации. Построены по фактическому коду
(src/lib/api/*, src/lib/features/tracking/*, src/lib/features/wind/*).
Архитектура
| Файл | Что описывает |
|---|---|
| architecture.puml | Слоистая архитектура клиента: routes → features → lib (api/map/ui/state/i18n/auth/domain), внешние сервисы (Backend, предсказатель) и библиотеки |
Диаграммы последовательности (по всем запросам)
| Файл | Что описывает | Запросы |
|---|---|---|
| seq-request-csrf.puml | Сквозная обёртка request<T>(): CSRF, cookie, обработка ошибок и 401 |
GET /api/csrf/ |
| seq-auth.puml | Проверка сессии, вход, выход | GET /api/session/, GET /api/whoami/, POST /api/login/, POST /api/logout/ |
| seq-resource-crud.puml | Единый CRUD-шаблон справочников | /api/saved-points/, /api/saved-templates/, /api/saved-profiles/ (GET/POST/PUT/DELETE) |
| seq-prediction.puml | Запуск прогноза траектории | POST /api/predictions/ |
| seq-telemetry.puml | Загрузка истории и приём телеметрии | GET /api/{id}/telemetry/, WS /api/ws/satellite/{id}/telemetry/ |
| seq-wind.puml | Визуализация поля ветра (статика + синхронизация) | GET /api/v1/wind/field, GET /api/v1/wind/meta |
Диаграмма потоков данных
| Файл | Что описывает |
|---|---|
| dfd-telemetry.puml | DFD подсистемы слежения: внешние сущности, процессы 1.0–5.0, хранилища D1–D3 |
Рендеринг в PNG/SVG
В системе есть Java, но нет CLI PlantUML. Один раз скачать jar и собрать все диаграммы:
curl -L -o plantuml.jar https://github.com/plantuml/plantuml/releases/latest/download/plantuml.jar
java -jar plantuml.jar -tpng docs/diagrams/*.puml # PNG
java -jar plantuml.jar -tsvg docs/diagrams/*.puml # SVG (для печати)
Альтернатива без установки — онлайн-редактор https://www.plantuml.com/plantuml
или расширение PlantUML для VS Code (предпросмотр Alt+D).