frontend/AGENTS.md

Frontend

Назначение

React/Vite-клиент WealthLedger. Функциональные изменения сначала планируются в ../specs/openspec; контракт API задает backend OpenAPI, а не ручные DTO.

Проверка

npm run lint
npm run typecheck
npm run test:run
npm run build
npm run check:no-todo

npm run openapi:generate получает документ работающего backend по ${VITE_API_BASE_URL:-http://localhost:3000}/api/docs-json; фактическая генерация выполняется только в задаче 5.1. build выполняет tsc -b.

Документация для агента

• Перед изменением API или transport types прочитать docs/API-LAYER.md.
• Перед созданием формы, страницы или UI-состояний прочитать docs/UI-PATTERN.md.
• Перед изменением структуры слайса или импортов прочитать docs/STRUCTURE.md.
• Перед кодом и тестами прочитать docs/CONVENTIONS.md и docs/TESTING.md.

Границы

• Текущий baseline использует FSD, React Router, i18n, Mantine, React Query и typed API scaffold.
• Зависимости FSD идут app -> pages -> features -> entities -> shared; слайсы импортируются только через публичный index.ts.
• HTTP идет только через типизированный клиент; request/response types выводятся из generated OpenAPI paths[...], а не дублируются вручную. UI-строки - только через i18n. Каждый маршрут имеет loading, error и empty состояния.
• Соблюдать strict TypeScript: import type для типов, без enum и namespace.
• Не добавлять прямые вызовы T-Bank и не переносить Todo-код из ../references/.