@bonesofspring/ai-rules 0.1.41 → 0.2.0

package/presets/cursor/next/rules/feature-delivery-flow.mdc

@@ -1,74 +0,0 @@
----
-description: Сквозной flow фичи (типы, API, моки, store, UI, тесты) и точки регистрации в репозитории
-alwaysApply: false
----
-
-# Поставка фичи: порядок слоёв и регистрация
-
-Плейсхолдеры: `<FeatureName>`, `<ServiceRoot>`, `<Area>` — нейтральные имена; реальные имена брать из соседних фич того же типа.
-
-## Инварианты перед кодом
-
-- Найти в том же слое фичу сопоставимой сложности и **повторить структуру каталогов и паттерн именования**.
-- Не добавлять `any`; при необходимости — `unknown` и сужение типа.
-- После правок выполнить проверки из **`package.json` каталога `app/`** (типизация, ESLint и связанные скрипты), не оставлять новых ошибок без причины.
-
-## Полный flow (слой за слоем)
-
-```mermaid
-flowchart LR
-  typesNode["types_domain"]
-  apiNode["api_services_mappers"]
-  mocksNode["mocks_msw"]
-  storeNode["store_slice_thunks"]
-  mwNode["middleware_optional"]
-  uiNode["ui_pages_components"]
-  unitNode["unit_tests"]
-  e2eNode["e2e_plans_specs"]
-
-  typesNode --> apiNode
-  apiNode --> mocksNode
-  apiNode --> storeNode
-  storeNode --> mwNode
-  storeNode --> uiNode
-  apiNode --> unitNode
-  storeNode --> unitNode
-  uiNode --> unitNode
-  uiNode --> e2eNode
-  mocksNode --> e2eNode
-```
-
-## Чеклист по слоям (куда класть и что зарегистрировать)
-
-1. **Типы** — `app/src/types/**` (или согласованное имя вроде `<FeatureName>.types.ts`). Доменная модель — источник правды для UI и store.
-
-2. **API** — `app/src/api/services/<ServiceRoot>/<Segment>/`: вызовы HTTP, DTO ответов, `*responseMappers.ts`. Новые публичные экспорты (фасады сервисов, типы, **константы путей** для моков) добавить в **`app/src/api/index.ts`** (`@/api`).
-
-3. **Моки (MSW)** — `app/src/mocks/data/<feature>/`: `data.ts`, `handlers.ts`; собрать хендлеры в **`app/src/mocks/handlers.ts`**. В хендлерах использовать **те же константы путей**, что и в API (импорт из `@/api`), **не дублировать сырые строки URL**. В репозитории могут быть **два контура** (браузерный worker и Node `setupServer` для тестов): общий список хендлеров должен оставаться согласованным — при добавлении проверять существующие входные точки в `app/src/mocks/**`, чтобы моки были доступны там, где ожидается.
-
-4. **Store** — `app/src/store/slices/<FeatureName>/`: slice, thunk’и вызывают методы из **`@/api`**, не HTTP‑клиент. Подключить редюсер в **`app/src/store/reducers.ts`**. Новый **middleware**: реализация в `app/src/store/middleware/**`, регистрация в **`app/src/store/index.ts`** в цепочке `configureStore` (порядок `prepend`/`concat` — как у соседних middleware в этом файле).
-
-5. **UI** — `app/src/ui/pages/<FeatureName>Page/**` и/или `app/src/ui/components/**`; стили — как в проекте (см. `package.json` и соседние компоненты). Данные и побочные эффекты загрузки — через store/hooks, без DTO и без прямого HTTP‑клиента.
-
-6. **Unit‑тесты** — `*.spec.ts` / `*.spec.tsx` (см. `tests-unit.mdc`); мапперы и нетривиальная логика — обязательно покрыть; e2e Jest не запускает (см. `jest.config.js`).
-
-7. **E2E** — план: `app/__tests__/e2e/<Area>/<plan>.cases.md`; реализация: `*.spec.ts` рядом; детали — `tests-e2e-structure.mdc`.
-
-## Частичные сценарии (вход с середины)
-
-| Задача | Минимум действий |
-|--------|------------------|
-| Только API + типы | Типы в `app/src/types/**`, сервис и мапперы, реэкспорт в `app/src/api/index.ts`; unit на маппер. |
-| Только моки | Константа пути уже в `@/api`; `handlers.ts` + данные; регистрация в `app/src/mocks/handlers.ts`; при необходимости убедиться, что хендлеры подхватываются и в браузерном, и в Node‑контуре MSW, если в проекте используются оба. |
-| Только store | Thunk на существующий метод `@/api`; slice + `app/src/store/reducers.ts`. |
-| Только UI | Читать готовое состояние из store; не добавлять HTTP/DTO; `data-testid` при необходимости для e2e. |
-| Только e2e | Синхронизировать `*.cases.md` и спеки; page object и `_shared`. |
-
-## Антипаттерны
-
-- DTO и структуры ответа бэкенда в UI или в нетипизированных кусках store.
-- Прямой вызов HTTP‑клиента из компонента или thunk’а в обход сервисного слоя.
-- Deep‑импорты в `app/src/api/services/**/…` из UI/store там, где принят импорт из `@/api`.
-- Проброс пропсов в компоненты через `{...props}` — см. `no-props-spread.mdc`.
-
-Подробные границы слоёв: `architecture-boundaries.mdc`, `store-rtk.mdc`, `api-services.mdc`, `react-ui.mdc`.