Update pnpm-lock.yaml to include new dependencies for @dnd-kit packages; enhance frontend documentation with MCP patterns and shadcn guidelines; refactor route handling for groups and services; implement new DataTableCard and KanbanBoard components for better domain and service management; add service binding functionality and improve DNS record management with new schemas and queries.

2026-06-15 16:41:10 +07:00
parent b1467575c5
commit 5f7b3ac388
50 changed files with 3364 additions and 367 deletions
@@ -26,6 +26,8 @@ Rust backend: `backend/src/` (Axum, sqlx). Frontend потребляет API ч

 ## Рекомендуемые shadcn-паттерны для типовых API

+Перед выбором паттерна — **MCP** `search_items_in_registries` ([`shadcn-mcp.mdc`](shadcn-mcp.mdc)).
+
 | API-данные | UI (из docs) |
 |------------|--------------|
 | Список сущностей | `Table` в `DataTableCard` или `data-table` block |
@@ -6,9 +6,9 @@ alwaysApply: false

 # Frontend — shadcn/ui (обязательно)

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

-Monorepo layout — [`frontend-monorepo.mdc`](frontend-monorepo.mdc).
+Monorepo layout — [`frontend-monorepo.mdc`](frontend-monorepo.mdc). MCP workflow — [`shadcn-mcp.mdc`](shadcn-mcp.mdc).

 | Документ | URL |
 |----------|-----|
@@ -22,10 +22,11 @@ Monorepo layout — [`frontend-monorepo.mdc`](frontend-monorepo.mdc).

 ## Шаг 0 — перед любым UI-кодом

-1. Открыть **Components** или **Blocks** — найти готовое решение
-2. `cd apps/web && pnpm dlx shadcn@latest docs <component>` — API и примеры
-3. `cd apps/web && pnpm dlx shadcn@latest search "<query>"` — если компонент неочевиден
-4. Только потом писать код
+1. **MCP `plugin-shadcn-shadcn`:** `search_items_in_registries` → `get_item_examples_from_registries` → `get_add_command_for_items` ([`shadcn-mcp.mdc`](shadcn-mcp.mdc))
+2. Открыть **Components** или **Blocks** — найти готовое решение
+3. `cd apps/web && pnpm dlx shadcn@latest docs <component>` — API и примеры
+4. `cd apps/web && pnpm dlx shadcn@latest search "@shadcn/<query>"` — если MCP не дал результат
+5. Только потом писать код

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

@@ -141,6 +142,7 @@ packages/ui/src/

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

+- [ ] MCP shadcn: search + examples (+ add command при новых примитивах)
 - [ ] Решение есть в https://ui.shadcn.com/docs/components или /blocks
 - [ ] Компоненты добавлены через `pnpm dlx shadcn@latest add` из `apps/web`
 - [ ] Нет кастомного CSS и raw HTML-примитивов
@@ -0,0 +1,43 @@
+---
+description: ВСЕГДА использовать MCP-плагин shadcn UI перед любым UI-кодом
+alwaysApply: true
+---
+
+# shadcn MCP — обязательно
+
+Перед **любой** задачей с UI (новый экран, компонент, стили, рефакторинг внешнего вида) — **сначала MCP** `plugin-shadcn-shadcn`, не память и не веб-поиск.
+
+CLI и docs — **после** MCP, по команде из `get_add_command_for_items`.
+
+## Порядок (строго)
+
+1. **`get_project_registries`** — какие registry доступны в проекте
+2. **`search_items_in_registries`** — компонент, block, example (`query`: `"card"`, `"tabs demo"`, `"dashboard"`, `"scroll-area"`)
+3. **`get_item_examples_from_registries`** — полный код примера перед написанием JSX
+4. **`get_add_command_for_items`** — точная CLI-команда `pnpm dlx shadcn@latest add ...`
+5. Выполнить add из `apps/web` (см. [`frontend-monorepo.mdc`](frontend-monorepo.mdc))
+6. Адаптировать пример под TanStack Router / Query → `apps/web/src/`
+
+## Когда вызывать MCP
+
+| Задача | MCP |
+|--------|-----|
+| Новая страница / layout | `search` → `types: ["block"]` → examples → add block |
+| Нет примитива в `@cfdm/ui` | `search` → `get_add_command_for_items` → add |
+| Сомнение в API/props | `get_item_examples_from_registries` |
+| Ревью UI перед сдачей | `get_audit_checklist` |
+
+## Запрещено
+
+- Писать UI по памяти, не проверив MCP
+- Копипаст с ui.shadcn.com без examples/add из MCP
+- Самописные примитивы, если есть item в registry
+- Пропускать MCP «потому что компонент простой»
+
+## Сервер и инструменты
+
+- **MCP server:** `plugin-shadcn-shadcn`
+- **Инструменты:** `get_project_registries`, `search_items_in_registries`, `get_item_examples_from_registries`, `get_add_command_for_items`, `view_items_in_registries`, `list_items_in_registries`, `get_audit_checklist`
+- Перед вызовом — прочитать schema в `mcps/plugin-shadcn-shadcn/tools/`
+
+Связанные правила: [`shadcn-ui-production.mdc`](shadcn-ui-production.mdc), [`frontend-shadcn.mdc`](frontend-shadcn.mdc).
@@ -7,6 +7,8 @@ alwaysApply: true

 UI строится **исключительно** по [shadcn/ui](https://ui.shadcn.com/docs/installation): [Components](https://ui.shadcn.com/docs/components), [Blocks](https://ui.shadcn.com/blocks), [Monorepo](https://ui.shadcn.com/docs/monorepo).

+**Первый шаг любой UI-задачи — MCP `plugin-shadcn-shadcn`** (см. [`shadcn-mcp.mdc`](shadcn-mcp.mdc)): search → examples → add command → CLI.
+
 ## Разработка frontend

 **Все правила frontend** — в [`frontend-shadcn.mdc`](frontend-shadcn.mdc) и [`frontend-monorepo.mdc`](frontend-monorepo.mdc) (globs: `apps/web/**`, `packages/ui/**`).