Перейти к содержанию

Журнал слияния 91-doc (ветка docs/full-docs)

Дата: 2026-09-17. Куратор: composer-2.5. Метод: git checkout docs2/<ветка> -- <каталог> на ветку docs/full-docs.

Таблица разделов

Раздел Ветка-источник Вердикт ревью Влит Диаграмм (mermaid) Виды диаграмм Объём (байт, все .md в каталоге)
geoscan 01-business docs2/gs-business принят да 6 flowchart, journey, mindmap, quadrantChart, sequenceDiagram, stateDiagram-v2 21 949
geoscan 02-usecases docs2/gs-usecases принят да 4 flowchart, journey, sequenceDiagram, stateDiagram-v2 32 528
geoscan 03-userflow docs2/gs-userflow НА ДОРАБОТКУ нет 4 (в ветке) stateDiagram-v2, journey, sequenceDiagram, flowchart 29 654
geoscan 04-architecture docs2/gs-architecture принят да 6 C4Context, C4Container, classDiagram, erDiagram, flowchart, sequenceDiagram 32 380
geoscan 05-domain docs2/gs-domain принят да 4 classDiagram, flowchart, mindmap, sequenceDiagram 25 298
geoscan 06-api docs2/gs-api НА ДОРАБОТКУ нет 5+ (в ветке) flowchart, sequenceDiagram, … 48 132
geoscan 07-operate docs2/gs-operate принят да 4 flowchart×2, sequenceDiagram, stateDiagram-v2 28 071
simulate 01-business docs2/sim-business принят да 6 flowchart, mindmap, quadrantChart, sequenceDiagram, stateDiagram-v2, timeline 26 655
simulate 02-usecases docs2/sim-usecases принят да 4 flowchart, journey, sequenceDiagram, stateDiagram-v2 25 989
simulate 03-architecture docs2/sim-architecture принят да 7 C4Context, classDiagram, erDiagram, flowchart×2, sequenceDiagram, stateDiagram-v2 28 905
simulate 04-api docs2/sim-api НА ДОРАБОТКУ нет 4+ (в ветке) flowchart, … 43 116
simulate 05-operate docs2/sim-operate принят да 4 flowchart×2, sequenceDiagram, stateDiagram-v2 23 271

Итого влито: 9 разделов, 47 диаграмм mermaid (минимум 4 на раздел, виды не повторяются в пределах раздела).

Непринятые разделы — чего не хватило

docs2/gs-userflow → 03-userflow

  • Текст опирается на смесь офлайн-моков (scenarios.ts, только s04) и API-режима без единой матрицы «что видит оператор в каждом режиме» после волн Б-1…Б-9.
  • Локальный npm run dev задокументирован как невоспроизводимый (конфликт vite 7/8 в lockfile); нет явного решения «чиним lockfile vs только стенд».
  • Ссылки на соседний 06-api и приёмочный 96-acceptance/00-verdict.md без стабильного пути в рабочей ветке.
  • Нет полного прохода по SSE/ошибкам/пустым состояниям всех восьми маршрутов (replan, export 409, dirty + serverScenarioId) в одной таблице «экран → API → ожидаемый UI».

docs2/gs-api → 06-api

  • В contract-gaps.md перечислены живые расхождения REST/gRPC/фронт (G3-04, scenario_id vs inline body, camelCase job vs snake_case plan, неполный OpenAPI snapshot) — раздел описывает API, но не закрывает трассировку всех маршрутов gateway к openapi.snapshot.json / live /api/openapi.json.
  • Нет сквозных примеров для SSE (/api/plans/{id}/events), replan, всех форматов export с заголовками X-Plan-Admitted.
  • gRPC: proto и поток Plan описаны фрагментарно относительно grpc-schemas-exports.md; нужна сверка с src/backend/shared/proto и интеграционными тестами как единый контракт.

docs2/sim-api → 04-api

  • Разнесение по четырём файлам без единого оглавления входа (частично закрыто в ветке, но ревью не приняло).
  • Несогласованность с кодом: Swagger UI отключён, OpenAPI только JSON; CLI мапит RunIdCollisionError в INTERNAL_ERROR, HTTP — 409 RUN_ID_COLLISION (нужна одна таблица кодов CLI↔HTTP).
  • Неполная связка журнал / fact_report / metrics с полями fidelity_class и известными NOT_COMPUTED (coverage, makespan).

Конфликты каталогов

Пересечений путей между ветками не было — каждый агент писал в свой каталог 91-doc/NN-*.

Симптом Причина Решение
— — конфликтов merge не возникло

Снятые противоречия (приведено к коду / 95-deploy)

Тема Было Стало
Кластер для aerozveno В 04-architecture subgraph «k3s n2 — ns aerozveno» n1 — как в 95-deploy/frontend-on-aerozveno.md и 07-operate/k3s-aerozveno.md
deploy.sh для aerozveno «aerozveno n2» рядом с geoscan Только kubectl --context n1 apply -k k3s/aerozveno/; deploy.sh — для geoscan на n2
gRPC порты planner/validator Разные упоминания 5001 / 5002 (GRPC_PORT в server.py, gateway config.schema.ts)
Ops HTTP planner/validator — 3001 / 3002 (ops.py, Dockerfile EXPOSE)
Симулятор HTTP — sim serve --port default 8080 (cli/__init__.py)
Health gateway Риск путаницы /api/healthz Liveness GET /healthz без префикса /api (ops.controller.ts)

Починенные ссылки

Проверка: относительные ссылки из влитых .md в docs/task5/91-doc и simulate/docs/91-doc (скрипт resolve).

Было битым Исправление
../03-userflow/README.md, ../06-api/README.md (каталоги не влиты) Якорь README.md#разделы-вне-этой-сборки + черновики 95-manual/01-user-guide.md, 91-system/03-public-api.md
simulate/.../04-api/README.md 92-api/01-http-api.md + якорь в simulate 91-doc/README.md
07-operate → ../../../simulate/... ../../../../simulate/docs/91-doc/05-operate/README.md
03-architecture → ../../../docs/task5/... ../../../../docs/task5/91-doc/04-architecture/README.md
96-status/00-final-status.md:55-61 в ссылке Убран псевдо-якорь :55-61
96-acceptance/00-verdict.md 96-status/00-final-status.md + указание архива в release/

После правок битых относительных ссылок в влитых разделах не осталось.

Сверх слияния

Что осталось

  1. Влить и доработать 03-userflow, 06-api, simulate 04-api (ветки docs2/* выше).
  2. После влития API — убрать временные ссылки на 91-system/03-public-api.md и 92-api/01-http-api.md из соседних разделов.
  3. Закрыть продуктовые блокеры, на которые ссылаются влитые разделы (G3-04, allowed ВП в planner, и т.д.) — вне scope документации, но отражено в customer-gaps.