Skip to content

Handoff — передача документации и команды агентов

Дата: 2026-06-26 · Ответственный за передачу: doc-cto (СТО).

Что передано

  1. Команда агентов (.claude/agents/): doc-cto, doc-sa, doc-ba, doc-architect — обучены под этот проект (источники истины, задачи, границы). Запуск — см. team/index.md.
  2. Продуктовая структура документации (docs/): index + разделы services / scenarios / schemes / integrations / diagrams / testing / team.
  3. Выгрузка исходной Wiki (docs/wiki/, 279 страниц) — материал бизнес-сценариев с живой wiki.gsmsoft.eu, HTML→Markdown сконвертирован, структура путей сохранена, есть _inventory.md.
  4. Старый контент (TAL/staking/pallets) перенесён в docs/_archive/ (не поддерживается).

Состояние

  • Сценарии из Wiki — исходные, требуют сверки с текущим кодом (это и есть основная работа команды).
  • Разделы services/scenarios/schemes/integrations/diagrams/testing содержат индексы + процесс; детальное наполнение — по циклам актуализации.
  • testing/ реестр пуст — наполняется по мере покрытия.

Важные находки при передаче

  • Railway-БД Wiki (switchback.proxy.rlwy.net) — повреждена (кириллица → ?, необратимо, подтверждено по pages+history). Использовать нельзя. Источник — живая wiki.gsmsoft.eu.
  • Канонические актуальные доки сейчас в admin_panel/docs/ — команда сводит/обогащает их сюда, сверяя с кодом.

Первые шаги для команды (рекомендация doc-cto)

  1. Сквозной путь пользователя (doc-ba): связать SC-001..SC-015 (admin_panel/docs/scenarios) с Wiki-сценариями.
  2. Приоритетные сервис-сценарии (doc-sa): accounts (деньги/транзакции), kyc, sender (рассылки), scoring/limiter (AML).
  3. Диаграммы (doc-architect): сквозной путь + AML + платёжные/крипто-потоки.
  4. Тест-кейсы (doc-cto): на каждый актуализированный сценарий + unit-тесты в сервисах; для accounts — тест целостности баланса.

Интеграция с админ-панелью (раздел «Документация»)

Контракт и статус готовности — admin-integration.md. Кратко:

  • ✅ Манифесты генерируются на сборке (hook material/overrides/hooks/manifests.py): /projects/<slug>/manifest.json + /projects/manifest.index.json.
  • ✅ mkdocs.yml очищен от внешних CDN: font: false (без Google Fonts), удалён Google Analytics.
  • 🟡 service_connect.data.docs — SQL готов (teslapay, trientes), применить на admin_api_test.
  • ⛔ Wiki за авторизацией (forward-auth) — инфра-задача вне репозитория, до публикации для встраивания.

Открытые вопросы / решения владельца

  • Развёртывание сайта MkDocs (push в master → CI деплой): включать ли разделы wiki/_archive в навигацию или скрыть.
  • Способ встраивания тела документа в админку: iframe+origin-check (узкий frame-src) либо прокси через admin-api — на выбор команды админки.