41 lines
3.8 KiB
Markdown
41 lines
3.8 KiB
Markdown
# Frontend router
|
||
|
||
Репозиторий самостоятельный: обязательные инструкции и проверки используют
|
||
только его файлы и предоставленные публичные контракты. Перед работой прочитай
|
||
[порядок работы](.ai/conventions/engineering.md#граница-и-порядок-работы), затем
|
||
объединяй triggers задачи и путей; читай активированные темы до решения.
|
||
До edits найди/создай подходящую Gitea Issue, проверь AC и ветку; чтение
|
||
допускается без Issue. Общий маршрут — [Engineering Workflow](https://git.personal.ksv741.ru/WealthLedger/main/src/commit/03b3b59e6ff2ba391f9dfc42a039a96d0d84c1c9/.ai/conventions/engineering-workflow.md)
|
||
(main#28; после merge — актуальная версия `develop`).
|
||
|
||
| Решение / сигнал | Читать |
|
||
| --- | --- |
|
||
| Устройство/data flow, component/module/slice, owner/FSD, cross-slice imports | [Architecture](.ai/architecture.md) |
|
||
| TS types/props/imports/exports, hooks/effects, derived state, memoization, domain literals | [TypeScript/React](.ai/conventions/typescript-react.md) |
|
||
| UI/Mantine, form, container/VM/view, state owner, loading/error/recovery | [UI](.ai/conventions/ui.md) |
|
||
| Только продуктовая строка / Zod message | [Строки](.ai/conventions/ui.md#строки-и-валидация) |
|
||
| Query/mutation, server cache, shared/api, generated types | [Data](.ai/conventions/data.md) |
|
||
| API/network/application errors, codes и сообщения | [Errors](.ai/conventions/data.md#errors) |
|
||
| Login/refresh/logout, token/cookie, session ownership | [Data/auth](.ai/conventions/data.md#auth-и-invalidation) + [Testing](.ai/conventions/testing.md) |
|
||
| Request/response field, route/status/error shape, OpenAPI | [Data/contract](.ai/conventions/data.md#типы-и-contract) |
|
||
| Tests или behavior с regression risk | [Testing](.ai/conventions/testing.md) |
|
||
| Storybook/stories/play, theme/tokens/shared UI | [Storybook](.ai/conventions/storybook.md), UI; design facts — в разделе Источники |
|
||
| Helper/dependency/новый pattern, refactor/scope | [Change scope](.ai/conventions/engineering.md#change-scope), для пакета — [Dependencies](.ai/conventions/engineering.md#dependencies) |
|
||
| Выбор gate, tooling, завершение | [Проверки](.ai/conventions/engineering.md#проверки-и-завершение) |
|
||
|
||
Показ query state не означает изменение fetching. Изменение тестов активирует
|
||
Testing и без production diff. Перед завершением повтори routing по новым и
|
||
изменённым файлам. Для Git/release прочитай
|
||
[Git и релизы](.ai/conventions/engineering.md#git-и-релизы).
|
||
|
||
## Источники
|
||
|
||
| Вопрос | Локальный источник |
|
||
| --- | --- |
|
||
| HTTP request/response/errors | [OpenAPI snapshot](src/shared/api/spec/openapi.json), generated types и [Data](.ai/conventions/data.md) |
|
||
| Auth/session/refresh/cache | [Data](.ai/conventions/data.md#auth-и-invalidation), source и colocated tests владельца |
|
||
| Money, account/position/income | Entity types, API snapshot, formatters и tests соответствующего slice |
|
||
| Theme/tokens, UI-каталог | [UI](.ai/conventions/ui.md), [Storybook](README.md#ui-каталог-storybook) |
|
||
| Поведение области | Source и tests её page/entity/feature; неясное ожидание уточни до изменения |
|
||
| Versions/scripts/check scope | Manifest/lockfile, ESLint/TypeScript/dependency configs |
|