specs/openspec/changes/evolve-frontend-stack/proposal.md

Why

У WealthLedger уже есть общий визуальный фундамент, каталог компонентов и типизированное взаимодействие с сервером. Следующий шаг — сделать границы переиспользования и поставки этого фундамента явными: участник должен быстро находить подходящее решение, а приложение — получать проверенную совместимую версию без копирования реализаций.

Исследование текущего frontend выявило конкретные незавершённые границы: повторяющиеся рисунки иконок, обход существующих цветовых ролей, продуктовую навигацию в общем UI и неполную автоматизацию архитектурных ограничений.

What Changes

Статус: локальная реализация и итоговая проверка завершены. Локальные границы приложения и private workspace-пакеты реализованы; проверенные пункты и оставшиеся ограничения перечислены в tasks. Независимое версионирование и публикация через Nexus отложены до оценки пользы пилота и не входят в требования этого перехода.

Первоначальный комплект плановых Markdown-файлов был подготовлен по запросу пользователя в одной сессии. Последующие разрешения касались ограниченных этапов; они не разрешают публикацию, deployment или archive.

• Выделить используемый общий визуальный фундамент в приватные workspace-пакеты, сохранив внешний вид и работоспособность приложения между небольшими этапами.
• Установить единый порядок выбора компонентов и понятную границу между общим представлением, предметным UI и сценариями приложения.
• Сделать повторно используемые собственные иконки доступными с единым визуальным и доступным контрактом.
• Подтвердить переход существующим небольшим продуктовым срезом и проверкой потребления собранных артефактов, а не только локальных исходников.
• Уточнить применимые инженерные правила после соответствующих изменений, сохранить существующие проверки и поэтапно закрыть найденные пробелы.

Сохраняются денежная точность, обработка неизвестных значений, поведение авторизации, запросов, форм, восстановления после ошибок и существующих страниц. Предметные расчёты и серверные контракты не становятся частью общего UI.

Не входят редизайн, тёмная тема, мобильный адаптер, календарь обязательных платежей, смена работающего стека, переустройство всех репозиториев и массовое перемещение компонентов. Публикация, deployment, commit, push, PR и archive не разрешены. Локальная реализация ограничена отдельно согласованными этапами.

Capabilities

New Capabilities

Нет: новая capability на каждый пакет или каталог не требуется.

Modified Capabilities

• specs/frontend-design-system/spec.md: добавить требования к потреблению локальных пакетов общего фундамента и доступному контракту собственных общих иконок. Существующие требования к единой теме и предметной независимости сохраняются. Delta.

Impact

• Frontend: поставка общей основы, выбор источников компонентов, ограниченная миграция потребителей и развитие существующих проверок.
• Backend: производственный контракт и поведение не меняются; отдельное замечание к описанию ошибок остаётся отложенным исследованием владельца API.
• Specs: этот change и delta; основные as-built требования пока не изменяются.
• Docs: описание текущего локального устройства обновлено в 7.2; независимая registry-поставка не заявляется.

Решения, альтернативы и каталог источников — в design, единственная очередь работ и текущее состояние — в tasks.