docs: add baseline OpenSpec change

2026-08-12 23:04:36 +03:00
parent 446789d658
commit 2d1777823b
8 changed files with 240 additions and 0 deletions
@@ -0,0 +1,29 @@
+## 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`.