Refactor project structure to use pnpm monorepo; update Dockerfile and related configurations for frontend build process. Adjust .dockerignore and .gitignore to reflect new paths. Modify .env.example for cron job timing. Update CONTRIBUTING.md and README.md for new development instructions.

2026-06-15 15:37:36 +07:00
parent 87789fa82d
commit b1467575c5
803 changed files with 16646 additions and 8251 deletions
@@ -0,0 +1,153 @@
+---
+description: Frontend — ТОЛЬКО shadcn/ui docs (Components, Blocks, Installation); best practices, CLI-first
+globs: apps/web/**/*,packages/ui/**/*
+alwaysApply: false
+---
+
+# Frontend — shadcn/ui (обязательно)
+
+**Источник истины — только официальная документация.** Не выдумывать UI, не писать кастомный CSS, не обходить CLI.
+
+Monorepo layout — [`frontend-monorepo.mdc`](frontend-monorepo.mdc).
+
+| Документ | URL |
+|----------|-----|
+| **Components** | https://ui.shadcn.com/docs/components |
+| **Blocks** | https://ui.shadcn.com/blocks |
+| **Installation** | https://ui.shadcn.com/docs/installation |
+| **Monorepo** | https://ui.shadcn.com/docs/monorepo |
+| **Theming** | https://ui.shadcn.com/docs/theming |
+| **Dark Mode** | https://ui.shadcn.com/docs/dark-mode |
+| **Forms (RHF)** | https://ui.shadcn.com/docs/forms/react-hook-form |
+
+## Шаг 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. Только потом писать код
+
+**Новая страница** → сначала [Blocks](https://ui.shadcn.com/blocks), потом `pnpm dlx shadcn@latest add <block-id>`.
+
+## Шаг 1 — CLI (обязательно)
+
+```bash
+cd apps/web
+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 apply b2fA --only theme -y   # тема — ТОЛЬКО так
+```
+
+- Копипаст с сайта **без** CLI — запрещено
+- `packages/ui/src/components/*` — только registry; domain-логика → `apps/web/src/components/<name>.tsx`
+
+## Шаг 2 — композиция (best practices)
+
+### Приоритет
+
+1. Установленный `@cfdm/ui/components/*`
+2. Block из registry (адаптация под TanStack Router)
+3. Shared проекта: `PageHeader`, `StatusBadge`, `ResourceList`, `DataTableCard`
+4. Domain-обёртка — последний уровень кастомизации
+
+### Запрещено
+
+| ❌ | ✅ из [Components](https://ui.shadcn.com/docs/components) |
+|----|-----------------------------------------------------------|
+| `<table>`, `<select>`, `<hr>` | `Table`, `Select`, `Separator` |
+| `bg-emerald-*`, `text-blue-500`, hex в className | `bg-primary`, `text-muted-foreground`, `Badge variant` |
+| Ручной `globals.css`, `.css` модули | CLI `apply b2fA --only theme` |
+| `space-y-*` / `space-x-*` | `flex` + `gap-*` |
+| `w-10 h-10` | `size-10` |
+| `className` для цветов Button/Badge | `variant`, `size` |
+| `useState` для полей формы | `FieldGroup` + RHF + Zod |
+| Styled `<Link>` | `Button variant="link"` + `render={<Link />}` |
+| `inline style={{}}` в routes | layout Tailwind |
+| `animate-pulse` div | `Skeleton` |
+| кастомный toast | `sonner` → `toast()` |
+| `@/components/ui/*` | `@cfdm/ui/components/*` |
+
+### Формы
+
+По https://ui.shadcn.com/docs/forms/react-hook-form:
+
+```tsx
+<FieldGroup>
+  <Field data-invalid={!!errors.name}>
+    <FieldLabel htmlFor="name">Имя</FieldLabel>
+    <Input id="name" aria-invalid={!!errors.name} {...register('name')} />
+  </Field>
+</FieldGroup>
+```
+
+### Card
+
+`CardHeader` / `CardTitle` / `CardDescription` / `CardContent` / `CardFooter` — полная композиция из docs.
+
+### Таблицы
+
+`Table`, `TableHeader`, `TableBody`, `TableRow`, `TableHead`, `TableCell` — из docs.  
+Сложная таблица → [Data Table](https://ui.shadcn.com/docs/components/data-table) + block `dashboard-01`.
+
+### Графики
+
+`Chart` + `ChartContainer` + `chartConfig` с `var(--chart-1)` — не raw recharts без обёртки.
+
+### Иконки в Button
+
+```tsx
+<Button>
+  <PlusIcon data-icon="inline-start" />
+  Создать
+</Button>
+```
+
+Без `size-4` на иконке внутри shadcn-компонента.
+
+## Стек (не shadcn, но обязателен)
+
+TanStack Router + Query — [`vite-tanstack-frontend.mdc`](vite-tanstack-frontend.mdc).
+
+- Preset: **base-nova** + **neutral** — [`apps/web/components.json`](apps/web/components.json), [`packages/ui/components.json`](packages/ui/components.json)
+- `@base-ui/react` → `render` prop (не Radix `asChild`)
+- **Не Next.js** — нет Server Components, `'use client'`
+
+## Эталоны проекта
+
+| Зона | Файл | Block |
+|------|------|-------|
+| 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 |
+
+## Структура файлов
+
+```
+apps/web/src/
+  components/        ← domain + layout + shared (blocks)
+  routes/            ← страницы (композиция @cfdm/ui, без raw HTML)
+  queries/           ← queryOptions (не inline в routes)
+  lib/schemas.ts     ← Zod для форм
+
+packages/ui/src/
+  components/        ← только CLI (не трогать под кейс)
+  hooks/             ← registry hooks (use-mobile)
+  lib/utils.ts       ← cn()
+  styles/globals.css ← только output shadcn CLI
+```
+
+## Чеклист перед завершением задачи
+
+- [ ] Решение есть в https://ui.shadcn.com/docs/components или /blocks
+- [ ] Компоненты добавлены через `pnpm dlx shadcn@latest add` из `apps/web`
+- [ ] Нет кастомного CSS и raw HTML-примитивов
+- [ ] Semantic tokens, `variant`/`size` вместо переопределения className
+- [ ] UI-импорты через `@cfdm/ui/components/*`
+- [ ] `pnpm --filter web build` без ошибок
+
+## Язык
+
+Ответы пользователю — русский. Commits — [`commit-messages-ru.mdc`](commit-messages-ru.mdc).