30 lines
3.2 KiB
Markdown
30 lines
3.2 KiB
Markdown
## Why
|
||
|
||
В WealthLedger есть пустые стартовые проекты NestJS и React/Vite, но отсутствуют общий технический фундамент, документированная архитектура и повторяемый SDD-процесс. Установление этих границ до реализации пользовательских возможностей не позволит последующим фичам авторизации и T-Bank переопределить общие контракты проекта.
|
||
|
||
## What Changes
|
||
|
||
- Создать правила для рабочей области с четырьмя репозиториями и локальный план поставки MVP.
|
||
- Создать структуру документации и зафиксировать устойчивые архитектурные решения о хранении данных, API-контрактах, внешней интеграции, секретах, сессиях и кэшировании.
|
||
- Адаптировать инфраструктуру frontend-шаблона без Todo-домена: FSD, русская локализация, тема Mantine, маршрутизация, генерация API-клиента и проверки качества.
|
||
- Подготовить backend-инфраструктуру для версионированного REST API, генерируемого OpenAPI, локального SQLite через Prisma, валидации конфигурации, CORS и безопасной обработки ошибок.
|
||
- Определить правила реализации и верификации baseline; авторизация, подключение T-Bank, получение брокерских счетов и отображение портфеля в него не входят.
|
||
|
||
## Capabilities
|
||
|
||
### New Capabilities
|
||
- `project-foundation`: Документированный и версионируемый фундамент frontend и backend, необходимый для будущих SDD-изменений.
|
||
- `api-contract-generation`: Генерируемый OpenAPI как контракт между NestJS backend и React frontend.
|
||
- `project-documentation`: Устойчивые архитектурные решения и правила документирования фич.
|
||
|
||
### Modified Capabilities
|
||
|
||
Нет.
|
||
|
||
## Impact
|
||
|
||
- Затрагивает репозитории `frontend`, `backend`, `specs` и `docs`, а также локальные корневые `MVP.md` и `AGENTS.md`.
|
||
- Добавляет инфраструктурные зависимости frontend и зависимости backend для Swagger/OpenAPI, конфигурации, валидации, Prisma и SQLite.
|
||
- Устанавливает `/api/v1` как префикс API backend, а сгенерированный OpenAPI-документ как источник frontend-клиента.
|
||
- Создает границу реализации для последующих изменений `add-authentication`, `add-tbank-connection`, `add-brokerage-accounts` и `add-portfolio-view`.
|