89 lines
5.2 KiB
Markdown
89 lines
5.2 KiB
Markdown
# Frontend Debt Audit and Backlog
|
||
|
||
Дата: 2026-06-23
|
||
Статус: спецификация
|
||
|
||
## Контекст
|
||
|
||
Frontend уже прошёл крупные волны миграции: FSD-рефакторинг, дизайн-система, тестовая инфраструктура,
|
||
tooling и часть архитектурных cleanup-задач. После этого в репозитории осталось два типа
|
||
техдолга:
|
||
|
||
1. реальные открытые хвосты, которые ещё нужно довести до конца;
|
||
2. устаревшие или слишком широкие документы, которые описывают уже изменившееся состояние кода.
|
||
|
||
Сейчас нужна отдельная SDD-фича, которая не внедряет поведение, а проводит аудит текущего frontend
|
||
состояния и превращает его в приоритизированный backlog для следующих узких фич.
|
||
|
||
## Цель
|
||
|
||
Зафиксировать актуальное состояние frontend-техдолга, отделить завершённые и устаревшие пункты от
|
||
реально открытых, и сформировать приоритизированный backlog следующих фич с понятными границами.
|
||
|
||
Этот аудит обслуживает отдельный epic `Frontend Debt Backlog` и должен приводить к разложению открытого
|
||
долга на следующие независимые фичи:
|
||
|
||
- `frontend-docs-sync`
|
||
- `frontend-infrastructure-hardening`
|
||
- `frontend-shared-boundary-cleanup`
|
||
- `frontend-test-hygiene`
|
||
|
||
## Требования
|
||
|
||
### 1. Инвентаризация текущего состояния
|
||
|
||
Нужно проверить актуальное состояние frontend по трём источникам:
|
||
|
||
- `apps/frontend/src/` — код, экспорты, зависимости слоёв, test helpers, API surface;
|
||
- `docs/features/` — существующие спецификации, планы и задачи по frontend;
|
||
- `docs/inbox.md` и `docs/roadmap.md` — гипотезы и уже зафиксированные кандидатные работы.
|
||
|
||
Аудит должен явно разделить находки на категории:
|
||
|
||
- уже закрыто;
|
||
- ещё открыто;
|
||
- устарело и подлежит пересмотру;
|
||
- требует отдельной новой фичи.
|
||
|
||
### 2. Приоритизация открытого долга
|
||
|
||
Все открытые пункты должны быть сгруппированы в небольшие независимые фичи. Для каждой группы нужно
|
||
зафиксировать:
|
||
|
||
- цель;
|
||
- почему это долг;
|
||
- примерный риск/сложность;
|
||
- рекомендуемый порядок реализации;
|
||
- какие текущие документы это затрагивает.
|
||
|
||
### 3. Синхронизация проектной доки
|
||
|
||
Результаты аудита должны быть отражены в проектных документах:
|
||
|
||
- `docs/inbox.md` — как источник идей и низкосигнальных заметок;
|
||
- `docs/roadmap.md` — как список следующих фич и кандидатов;
|
||
- `docs/features/frontend-debt-audit/*` — как SDD-артефакты самой audit-фичи.
|
||
|
||
Плюс результаты аудита должны служить входом для эпика `Frontend Debt Backlog`.
|
||
|
||
### 4. Никаких изменений поведения
|
||
|
||
Эта фича не меняет runtime-поведение frontend, не трогает backend и не вводит продуктовые улучшения
|
||
сверх формализации найденного долга.
|
||
|
||
## Ограничения
|
||
|
||
- Только frontend-область и связанные с ней docs.
|
||
- Не выполнять миграции кода в рамках этой фичи.
|
||
- Не смешивать аудит с внедрением follow-up задач.
|
||
- Не дублировать уже закрытые FSD/infra cleanup работы как новые задачи.
|
||
|
||
## Критерии приемки
|
||
|
||
- Зафиксирован перечень проверенных областей frontend-аудита с доказательствами по каждой области.
|
||
- Для каждого открытого debt-item есть приоритет и рекомендация по разбиению на следующую фичу.
|
||
- В `docs/inbox.md` добавлена актуальная заметка о frontend debt backlog.
|
||
- В `docs/roadmap.md` добавлен новый кандидат или уточнён существующий блок, отражающий audit-backlog.
|
||
- `docs/features/frontend-debt-audit/plan.md` и `tasks.md` согласованы с результатом аудита.
|
||
- Не изменены файлы `apps/frontend/src/**`.
|