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,44 @@
+---
+description: Backend API — при изменениях, затрагивающих UI, строго следовать shadcn Components/Blocks
+globs: backend/**/*
+alwaysApply: false
+---
+
+# Backend API + shadcn/ui
+
+Rust backend: `backend/src/` (Axum, sqlx). Frontend потребляет API через TanStack Query.
+
+## Когда правило активно
+
+Любое изменение в `backend/src/api/handlers/`, DTO, полей ответа, которые отображаются в UI.
+
+## Обязательный порядок
+
+1. **Backend** — handler, валидация, тесты API
+2. **Схемы frontend** — `apps/web/src/lib/schemas.ts`, `apps/web/src/queries/index.ts`
+3. **UI** — **только** [shadcn Components](https://ui.shadcn.com/docs/components) и [Blocks](https://ui.shadcn.com/blocks)
+
+## Запрещено на frontend при доработке API
+
+- Новые raw `<table>` / `<select>` / кастомные badge-цвета
+- Кастомный CSS для отображения новых полей
+- Самописные формы без `Field` + RHF + Zod
+
+## Рекомендуемые shadcn-паттерны для типовых API
+
+| API-данные | UI (из docs) |
+|------------|--------------|
+| Список сущностей | `Table` в `DataTableCard` или `data-table` block |
+| Создание записи | `Card` + `FieldGroup` + RHF |
+| Enum/фильтр | `Select` |
+| Статус | `StatusBadge` → shadcn `Badge` variants |
+| Ошибка мутации | `sonner` `toast.error` |
+| Пустой список | `Empty` |
+| Сводка/метрики | `Card` section-cards ([dashboard-01](https://ui.shadcn.com/blocks)) |
+
+## Согласованность
+
+- Имена полей JSON — camelCase или snake_case как в существующем API; типы в Zod должны совпадать
+- Новый endpoint → `queryOptions` factory в `apps/web/src/queries/`, не inline в route
+
+Главное правило frontend: [`frontend-shadcn.mdc`](frontend-shadcn.mdc) · monorepo: [`frontend-monorepo.mdc`](frontend-monorepo.mdc) · обзор: [`shadcn-ui-production.mdc`](shadcn-ui-production.mdc)