# 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/**`.