Init

2026-08-04 18:33:48 +07:00
commit b5f31c1083
227 changed files with 31375 additions and 0 deletions
@@ -0,0 +1,81 @@
+---
+description: Структура telemt-panel — pnpm monorepo (apps/web, apps/api, packages/ui, packages/shared, packages/db)
+alwaysApply: true
+---
+
+# Структура проекта telemt-panel
+
+pnpm workspaces monorepo. Frontend — shadcn/ui + ReUI (`@reui`) + TanStack Router/Query + TS. Backend — Fastify + Drizzle + better-sqlite3 + TS.
+
+## Layout
+
+```
+telemt-panel/
+├── apps/
+│   ├── web/              # Vite SPA (TSX) — TanStack Router + Query, shadcn/ui + ReUI
+│   └── api/              # Fastify 5 API (TS) — @fastify/* + Drizzle
+├── packages/
+│   ├── ui/               # @telemt/ui — shadcn primitives (output `shadcn add`)
+│   ├── shared/           # @telemt/shared — Zod-схемы контрактов, общие типы
+│   └── db/               # @telemt/db — Drizzle schema, repositories, миграции
+├── data/                 # SQLite база (том Docker, gitignored)
+├── pnpm-workspace.yaml
+├── package.json
+└── tsconfig.base.json
+```
+
+## apps/web
+
+```
+apps/web/
+├── components.json       # ui alias → @telemt/ui/components
+├── vite.config.ts        # React + TanStack Router plugin, proxy /api → apps/api
+├── tsconfig.json
+└── src/
+    ├── main.tsx          # QueryClientProvider, createRouter, import '@telemt/ui/globals.css'
+    ├── routes/           # file-based routes (__root.tsx, _auth/...)
+    ├── queries/          # queryOptions + key factories по сущностям
+    ├── components/       # shared + layout + domain (blocks)
+    └── lib/              # api-client, queryClient, router, schemas
+```
+
+## apps/api
+
+```
+apps/api/
+└── src/
+    ├── index.ts          # buildApp()
+    ├── config.ts         # env через Zod
+    ├── routes/           # тонкие Fastify plugins
+    ├── services/         # бизнес-логика + адаптеры (billmanager/*)
+    └── plugins/          # @fastify/* registration
+```
+
+## packages/db
+
+```
+packages/db/src/
+├── schema/               # Drizzle tables по сущностям
+├── repositories/         # typed queries (inArray, JOIN, transaction)
+└── migrations/           # drizzle-kit generate/migrate
+```
+
+## Именование
+
+- Файлы: kebab-case (`provider-accounts.ts`, `row-mappers.ts`)
+- Компоненты: PascalCase (`PageHeader.tsx`)
+- Роуты API: `/api/vps`, `/api/provider-accounts`, `/api/sync/:accountId`
+- ID записей: `vps-bm-{accountId}-{externalId}`, `pay-bm-{accountId}-{externalId}`
+
+## Barrel exports
+
+- `packages/ui` — `@telemt/ui/components/*`, `@telemt/ui/lib/utils`, `@telemt/ui/hooks/*`, `@telemt/ui/globals.css`
+- `packages/shared` — `@telemt/shared/contracts/*` (Zod), `@telemt/shared/types/*`
+- `packages/db` — `@telemt/db/schema`, `@telemt/db/repositories/*`
+- `apps/api/src/services/billmanager/index.ts` — `testConnection`, `syncFromBillmanager`, `fetchDashboardInfo`
+
+## Скоупы правил
+
+- Frontend (`apps/web`, `packages/ui`) — [`frontend-monorepo.mdc`](frontend-monorepo.mdc), [`frontend-shadcn.mdc`](frontend-shadcn.mdc), [`frontend-ui-patterns.mdc`](frontend-ui-patterns.mdc), [`vite-tanstack-frontend.mdc`](vite-tanstack-frontend.mdc), [`shadcn-mcp.mdc`](shadcn-mcp.mdc), [`reui-mcp.mdc`](reui-mcp.mdc), [`shadcn-ui-production.mdc`](shadcn-ui-production.mdc)
+- Backend (`apps/api`, `packages/db`, `packages/shared`) — [`backend-fastify.mdc`](backend-fastify.mdc), [`backend-drizzle.mdc`](backend-drizzle.mdc), [`backend-mcp.mdc`](backend-mcp.mdc), [`backend-testing.mdc`](backend-testing.mdc), [`backend-api-ui.mdc`](backend-api-ui.mdc), [`sqlite.mdc`](sqlite.mdc)
+- API + UI-связка — [`backend-api-ui.mdc`](backend-api-ui.mdc)