Frontend Debt Audit and Backlog

Дата: 2026-06-23 Статус: спецификация

Контекст

Frontend уже прошёл крупные волны миграции: FSD-рефакторинг, дизайн-система, тестовая инфраструктура, tooling и часть архитектурных cleanup-задач. После этого в репозитории осталось два типа техдолга:

реальные открытые хвосты, которые ещё нужно довести до конца;
устаревшие или слишком широкие документы, которые описывают уже изменившееся состояние кода.

Сейчас нужна отдельная 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/**.

5.2 KiB Raw Blame History Unescape Escape