Диаграммы по сценариям¶

Диаграммы взаимодействия по сценариям (Mermaid, рендерится в MkDocs Material): кто с кем взаимодействует и куда уходит информация. Ведёт агент doc-architect.

Правила¶

Только Mermaid в fenced-блоке (без внешних картинок/CDN — CSP/офлайн-сборка).
Узлы = реальные сервисы/акторы; рёбра = реальные вызовы (gRPC/Kafka/HTTP/внешние), подтверждённые кодом.
Не раскрывать секреты (DSN/токены).
Типы: sequenceDiagram (поток сценария), flowchart (карта взаимодействия), stateDiagram-v2 (жизненный цикл), erDiagram (БД).

Пример (шаблон)¶

sequenceDiagram
    actor U as Пользователь
    participant GW as api-gateway
    participant US as users
    participant KYC as kyc
    U->>GW: запрос
    GW->>US: gRPC
    US-->>GW: ответ

Что наполнять (приоритет)¶

Сквозной путь: регистрация → KYC → счёт → платёж/обмен → AML/лимиты.
AML-сценарии (scenarios ↔ scoring/limiter/admin-api).
Платёжные и крипто-потоки (accounts ↔ acquiring/crypto-gateway).
Карта потоков данных для GDPR-аудита (источник связей — код, см. admin_panel «Карта потоков данных»).

Готовые диаграммы складывать рядом (docs/diagrams/<тема>.md) и ссылаться из соответствующего сценария.