docs: документация переведена на канон av-dev-pm 3

- роадмап отвечает «что умеет и чего не умеет»: PLAN.md → ROADMAP.md, четыре
  канонические секции, достигнутые звенья строками в «Готово», цели
  переформулированы возможностями приложения
- задачи: род работы и «Затрагивает» набору спринта, 34 заголовка в форму
  действия, «Завершение» целей перечнями со ссылкой из каждой задачи
- вычитка проходами task-form и doc-wording, починены протухшие факты в README,
  паспорте и review.md
This commit is contained in:
av
2026-08-04 20:48:30 +03:00
parent b1d3b25827
commit d33f37249c
63 changed files with 489 additions and 346 deletions
+11 -7
View File
@@ -1,7 +1,7 @@
# Swagger UI без внешней сети
# Поднять Swagger UI без внешней сети
- **Секция:** ядро
- **Зачем:** Контракт читается машиной, но человеку нечем ткнуть в живой сервис, а внешних CDN в локальной сети нет
- **Секция:** Ядро
- **Зачем:** Контракт читается машиной, но человеку нечем выполнить запрос к живому сервису из браузера, а внешних CDN в локальной сети нет
- **Теги:** goal:read-api, sprint:2026-08-04
Человек открывает UI на отдельном пути и выполняет запрос к живому сервису — не
@@ -11,18 +11,22 @@
статика отдаётся самим сервисом и лежит в бинаре: внешние CDN здесь означают
«работает, пока работает чужой сайт».
**UI — новый адресат недоверенного входа наизнанку:** он даёт человеку в один
клик дёрнуть любой описанный маршрут, включая приём. Права на запись из
браузера не должны появляться сами собой — это ровно та граница, которую
**UI — новый адресат недоверенного входа наизнанку:** он даёт человеку одним
нажатием выполнить запрос к любому описанному маршруту, включая приём. Права
на запись из браузера не должны появляться сами собой — это ровно та граница, которую
описывает `docs/security.md`.
Двигает строку «Завершения» цели: «Контракт чтения читается машиной».
## Критерии приёмки
- UI открывается и выполняет запрос при отключённой внешней сети — оракул:
запуск контейнера без доступа наружу
- бинарь работает без каталога со статикой рядом — оракул: запуск одного файла
из пустого каталога
- маршрут приёма из UI не вызывается без явного токена приёма — оракул: тест
- запрос к маршруту приёма без заголовка с токеном приёма отклоняется, откуда
бы он ни пришёл, а отдаваемая UI статика токена приёма в себе не держит —
оракул: тест на обработчике приёма плюс поиск токена в отдаваемой статике
## Рамки