chore(rules): добавить ReUI workflow для ИИ и обновить правила frontend

Зафиксированы registry @reui, MCP-ветка, размещение компонентов и матрица выбора shadcn vs ReUI. Co-authored-by: Cursor <[email protected]>
2026-06-28 22:28:56 +07:00
parent baa13260c6
commit f3dbd85523
12 changed files with 273 additions and 50 deletions
@@ -8,7 +8,7 @@ alwaysApply: false

 **Источник истины — MCP shadcn + официальная документация.** Не выдумывать UI, не писать кастомный CSS, не обходить MCP и CLI.

-Monorepo layout — [`frontend-monorepo.mdc`](frontend-monorepo.mdc). MCP workflow — [`shadcn-mcp.mdc`](shadcn-mcp.mdc). UI patterns — [`frontend-ui-patterns.mdc`](frontend-ui-patterns.mdc).
+Monorepo layout — [`frontend-monorepo.mdc`](frontend-monorepo.mdc). MCP workflow — [`shadcn-mcp.mdc`](shadcn-mcp.mdc), ReUI — [`reui-mcp.mdc`](reui-mcp.mdc). UI patterns — [`frontend-ui-patterns.mdc`](frontend-ui-patterns.mdc).

 | Документ | URL |
 |----------|-----|
@@ -18,6 +18,9 @@ Monorepo layout — [`frontend-monorepo.mdc`](frontend-monorepo.mdc). MCP workfl
 | **Monorepo** | https://ui.shadcn.com/docs/monorepo |
 | **Theming** | https://ui.shadcn.com/docs/theming |
 | **Dark Mode** | https://ui.shadcn.com/docs/dark-mode |
+| **ReUI (enterprise)** | https://reui.io/llms.txt |
+| **ReUI Get Started** | https://reui.io/docs/get-started |
+| **ReUI Styling** | https://reui.io/docs/styling |
 | **Forms (RHF)** | https://ui.shadcn.com/docs/forms/react-hook-form |

 ## Шаг 0 — перед любым UI-кодом
@@ -27,15 +30,16 @@ Monorepo layout — [`frontend-monorepo.mdc`](frontend-monorepo.mdc). MCP workfl
 2. Открыть **Components** или **Blocks** — найти готовое решение
 3. `cd apps/web && pnpm dlx shadcn@latest docs <component>` — сверить API с [Components](https://ui.shadcn.com/docs/components)
 4. Сверить MCP examples ↔ docs API — только потом писать код
-5. `cd apps/web && pnpm dlx shadcn@latest search "@shadcn/<query>"` — если MCP не дал результат
+5. `cd apps/web && pnpm dlx shadcn@latest search "@shadcn/<query>"` или `"@reui/<query>"` — если MCP не дал результат
+6. Enterprise-компоненты (data grid, filters) → [`reui-mcp.mdc`](reui-mcp.mdc) + [llms.txt](https://reui.io/llms.txt)

 **Новая страница** → сначала [Blocks](https://ui.shadcn.com/blocks), потом `pnpm dlx shadcn@latest add <block-id>`.

 ## Docs workflow

-1. MCP `plugin-shadcn-shadcn` — search → examples → add command
-2. `pnpm dlx shadcn@latest docs <component>` — fetch URLs, сверить API
-3. Skill `.agents/skills/shadcn/SKILL.md` — critical rules
+1. MCP `plugin-shadcn-shadcn` — search → examples → add command (`@shadcn` и/или `@reui`)
+2. `@shadcn/*` → `pnpm dlx shadcn@latest docs <component>`; `@reui/*` → ReUI docs + llms.txt
+3. ReUI enterprise → [`reui-mcp.mdc`](reui-mcp.mdc)
 4. Context7 — только TanStack / Recharts

 ## Shared components (обязательно)
@@ -67,9 +71,12 @@ pnpm dlx shadcn@latest add table select badge card field input button ...
 pnpm dlx shadcn@latest add sidebar-07    # layout
 pnpm dlx shadcn@latest add dashboard-01 # dashboard
 pnpm dlx shadcn@latest add login-03     # auth
+pnpm dlx shadcn@latest add @reui/data-grid   # ReUI enterprise (→ apps/web/src/components/reui/)
+pnpm dlx shadcn@latest add @reui/filters
 pnpm dlx shadcn@latest apply b2fA --only theme -y   # тема — ТОЛЬКО так
 ```

+- ReUI: `add @reui/<name>` → `apps/web/src/components/reui/` (см. [`reui-mcp.mdc`](reui-mcp.mdc))
 - Копипаст с сайта **без** CLI — запрещено
 - `packages/ui/src/components/*` — только registry; domain-логика → `apps/web/src/components/<name>.tsx`

@@ -79,8 +86,9 @@ pnpm dlx shadcn@latest apply b2fA --only theme -y   # тема — ТОЛЬКО

 1. Установленный `@cfdm/ui/components/*`
 2. Block из registry (адаптация под TanStack Router)
-3. Shared проекта: `PageShell`, `PageHeader`, `EmptyState`, `QueryState`, `ConfirmDialog`, `DataTableCard`, `SectionCards`, `StatusBadge`
-4. Domain-обёртка — последний уровень кастомизации
+3. ReUI `@/components/reui/*` через shared: `DataGridCard`, `VpsFiltersToolbar`, `AutoCompleteInput` ([`reui-mcp.mdc`](reui-mcp.mdc))
+4. Shared проекта: `PageShell`, `PageHeader`, `EmptyState`, `QueryState`, `ConfirmDialog`, `SectionCards`, `StatusBadge`
+5. Domain-обёртка — последний уровень кастомизации

 ### Запрещено в apps/web

@@ -131,8 +139,9 @@ pnpm dlx shadcn@latest apply b2fA --only theme -y   # тема — ТОЛЬКО

 ### Таблицы

-`Table`, `TableHeader`, `TableBody`, `TableRow`, `TableHead`, `TableCell` — из docs.  
-Сложная таблица → [Data Table](https://ui.shadcn.com/docs/components/data-table) + block `dashboard-01`.
+Простая таблица → shadcn `Table` из docs.
+
+Сложные data-списки (сортировка, пагинация, virtual, column visibility) → **`DataGridCard`** (`@reui/data-grid` под капотом), не shadcn Data Table и не raw `<table>`.

 ### Графики

@@ -164,14 +173,15 @@ TanStack Router + Query — [`vite-tanstack-frontend.mdc`](vite-tanstack-fronten
 | Shell | `apps/web/src/components/layout/app-shell.tsx` | [sidebar-07](https://ui.shadcn.com/blocks) |
 | Login | `apps/web/src/routes/login.tsx` | [login-03](https://ui.shadcn.com/blocks) |
 | Dashboard | `apps/web/src/routes/_auth/index.tsx` | [dashboard-01](https://ui.shadcn.com/blocks) |
-| CRUD | `routes/_auth/services.tsx`, `domains/index.tsx` | Card + Field + Table |
+| CRUD | `routes/_auth/vps.tsx`, `payments.tsx` и др. | `DataGridCard` + `FormSheet` |

 ## Структура файлов

 ```
 apps/web/src/
  components/        ← domain + layout + shared (blocks)
-  routes/            ← страницы (композиция @cfdm/ui, без raw HTML)
+    reui/            ← ReUI CLI output (@reui/*) — не в packages/ui
+  routes/            ← страницы (композиция @cfdm/ui + ReUI, без raw HTML)
  queries/           ← queryOptions (не inline в routes)
  lib/schemas.ts     ← Zod для форм

@@ -184,12 +194,13 @@ packages/ui/src/

 ## Чеклист перед завершением задачи

- [ ] MCP shadcn: search + examples (+ add command при новых примитивах)
- [ ] Решение есть в https://ui.shadcn.com/docs/components или /blocks
+- [ ] MCP shadcn: search + examples (`@shadcn` и/или `@reui`)
+- [ ] Enterprise-компоненты — [`reui-mcp.mdc`](reui-mcp.mdc) + llms.txt
+- [ ] Решение есть в shadcn docs/blocks или ReUI catalog
 - [ ] Компоненты добавлены через `pnpm dlx shadcn@latest add` из `apps/web`
 - [ ] Нет кастомного CSS и raw HTML-примитивов
- [ ] Semantic tokens, `variant`/`size` вместо переопределения className
- [ ] UI-импорты через `@cfdm/ui/components/*`
+- [ ] Semantic tokens / ReUI `variant` вместо raw Tailwind-цветов
+- [ ] shadcn → `@cfdm/ui`; ReUI → `@/components/reui`
 - [ ] `pnpm --filter web build` без ошибок

 ## Язык