59 lines
3.4 KiB
Markdown
59 lines
3.4 KiB
Markdown
# Frontend Docs Sync
|
||
|
||
Дата: 2026-06-23
|
||
Статус: выполнено
|
||
|
||
## Контекст
|
||
|
||
Frontend-архитектура уже сильно изменилась: большая часть FSD-миграции завершена, часть cleanup
|
||
работ закрыта, а некоторые документы всё ещё описывают промежуточное состояние проекта. Из-за этого
|
||
новому участнику сложно понять, какие frontend-решения уже живые, какие только планировались, а
|
||
какие нужно держать как backlog.
|
||
|
||
Эта фича нужна, чтобы привести `docs/inbox.md`, `docs/roadmap.md` и frontend-спецификации к текущему
|
||
состоянию репозитория без изменения runtime-поведения приложения.
|
||
|
||
## Цель
|
||
|
||
Синхронизировать frontend-документацию с текущим состоянием кода и перенести устаревшие идеи в
|
||
явный backlog, чтобы docs отражали реальность, а не промежуточный план миграции.
|
||
|
||
## Требования
|
||
|
||
### 1. Обновить inbox
|
||
|
||
`docs/inbox.md` должен содержать только идеи и гипотезы, которые ещё не оформлены в спецификации или
|
||
roadmap. Устаревшие миграционные заметки нужно либо удалить, либо явно пометить как уже покрытые
|
||
отдельной фичей.
|
||
|
||
### 2. Обновить roadmap
|
||
|
||
`docs/roadmap.md` должен содержать только актуальные кандидаты следующих фич. Элементы, которые уже
|
||
превратились в отдельные SDD-фичи, не должны дублироваться как абстрактные заметки.
|
||
|
||
### 3. Согласовать frontend feature docs
|
||
|
||
Спецификации по frontend должны ссылаться друг на друга так, чтобы было ясно:
|
||
|
||
- что уже завершено;
|
||
- что ещё в backlog;
|
||
- какие фичи являются follow-up к audit/backlog эпикам.
|
||
|
||
### 4. Не менять продуктовое поведение
|
||
|
||
Эта фича касается только документации и статуса работ. Код frontend и backend не меняется.
|
||
|
||
## Ограничения
|
||
|
||
- Только `docs/`.
|
||
- Не создавать дублирующие записи о тех же идеях в inbox и roadmap.
|
||
- Не смешивать документационный sync с реализацией кода.
|
||
|
||
## Критерии приемки
|
||
|
||
- `docs/inbox.md` отражает только живые идеи и не дублирует завершённые frontend cleanup-фичи.
|
||
- `docs/roadmap.md` содержит актуальные candidate features без устаревших промежуточных формулировок.
|
||
- Все новые frontend-fича документы ссылаются на общий epic `Frontend Debt Backlog`.
|
||
- Документация по frontend не противоречит текущему состоянию `apps/frontend/src/`.
|
||
- Не изменены runtime-файлы приложения.
|