Рабочий план команды документации¶

Назначение: durable-бэклог по 7-шаговой дорожной карте владельца. Точка возобновления работы (в т.ч. после перезапуска Claude Code, когда станут доступны субагенты .claude/agents/). Обновлено: 2026-06-26.

Источники истины (приоритет)¶

Код сервисов: d:/Project/CREL/<svc>/, d:/Project/services/* (welID, support-chat).
Доки платформы: d:/Project/admin_panel/docs/ (services/, analysis/, scenarios/ SC-001..015, services_data.md), а также d:/Project/mock_ss/docs/, d:/Project/support-chat/docs/.
Выгрузка вики: docs/wiki/ (исходные сценарии; сверять с кодом).
Доступ к БД (TEST): туннель + креды — docs/_shared/techdoc/tesla-test-map.md (по решению владельца креды допустимы в wiki за авторизацией; в LLM-промпты не вставлять — читать локально).

Артефакты-основания¶

Шаблон сценария: docs/projects/_TEMPLATE/scenarios/sc-000-template.md (+ пример _example-sepa-transfer.md).
Gap-анализ: docs/scenarios/gap-analysis.md.
Спека структуры: docs/projects/_STRUCTURE.md. Charter/DoD: docs/team/charter.md.
Контракт с админкой: docs/team/admin-integration.md.

Статус по шагам¶

Шаг	Что	Статус	Артефакт
1	Разблокировать админку: mkdocs без CDN + манифесты + `service_connect.data.docs`	✅ Готово	`mkdocs.yml`, `material/overrides/hooks/manifests.py`, `team/admin-integration.md`
3	Единый шаблон бизнес-сценария (для doc-ba)	✅ Готово	`_TEMPLATE/scenarios/sc-000-template.md`
4	Gap-анализ сценариев (покрытие + продуктовые пробелы)	✅ Готово	`scenarios/gap-analysis.md`
2	Наполнить Trientes (база из TeslaPay + крипто-эквайринг)	⬜ Ожидает	—
5	Дописать бизнес-сценарии по шаблону	⬜ Ожидает	—
6	Диаграммы по всем сценариям (Mermaid)	⬜ Ожидает (после ⅖)	`docs/diagrams/`
7	СА: описать все таблицы + связи данных между ними	⬜ Ожидает (параллельно)	`docs/_shared/database/`, `<proj>/tech-info/database`

Очередь работ (после рестарта → субагенты)¶

Шаг 5 — дописать сценарии (doc-sa по сервисам, doc-ba сквозные)¶

Порядок групп из gap-analysis.md: - A. Переписать ~50 сценариев TeslaPay по шаблону + сверка с кодом. Делить по доменам: auth/kyc-aml → doc-sa(users/kyc/scoring); accounts/payments → doc-sa(accounts/limiter/sender); cards → doc-sa(cards); b2b → doc-sa. - B. Описать существующее-недокументированное: возврат/чарджбэк, 3DS онлайн-оплата, депозит Trientes, выписки (если есть). - C. Целевые to-be (P0 вперёд) — только после сверки с кодом (аудит 2026-03 мог устареть). Каждый сценарий: front-matter заполнен, verified_with_code+дата, обновлён индекс домена.

Шаг 2 — Trientes¶

Базовые сценарии (auth/accounts/cards/...) — пометить копии sync: copy или fork, адаптировать терминологию Trientes.
Написать крипто-эквайринговые: депозит, фиатный офрамп (P0), котировка→подтверждение, AML-блокировка в реальном времени.
Источник: CREL/crypto-acquiring, CREL/crypto-gateway, admin_panel/docs/analysis/crypto-services-analysis.md.

Шаг 6 — диаграммы (doc-architect)¶

На каждый готовый сценарий — Mermaid (sequence/flow/state) в секции «Диаграмма» либо файл в docs/diagrams/.
Узлы=реальные сервисы/акторы, рёбра=реальные вызовы/события (gRPC/Kafka), сверка с кодом. Без внешних CDN.
Swimlane-зоны уже заложены в шаблон (Пользователь/МП/Система/Партнёр).

Шаг 7 — таблицы и связи данных (doc-sa, параллельно)¶

Описаны частично: docs/_shared/database/ (accounts, users, scoring, market_maker, market_market, admin_panel/profile).
Дописать по каждому сервису остальные таблицы (источник: БД через туннель tesla-test-map.md + миграции/модели в CREL/<svc>, admin_panel/docs/analysis/db/*).
Проставить связи (FK/логические) между таблицами; целевая раскладка <proj>/tech-info/database (ER-диаграммы — с doc-architect).

Границы (обязательны)¶

Русский, .md, без внешних CDN. Пути — латиница kebab-case.
Не выдумывать поведение/эндпоинты/ссылки — подтверждать кодом (путь:строка) или ставить TODO.
PII/секреты — не в LLM-промпты, не в тест-данные (синтетика). Креды БД читать локально.
service_connect = источник gRPC-адресов; деньги = decimal/NUMERIC; изоляция по project_id.

Открытые вопросы владельцу¶

Включать ли docs/wiki/ и docs/_archive/ в навигацию прод-сборки или скрыть.
Способ встраивания тела документа в админку: iframe+origin-check / прокси admin-api (см. admin-integration.md).