Denozordec
cb8a79260e
quality / commitlint (push) Skipped
CD / update-wiki (push) Failing after 7s
quality / changes (push) Successful in 4s
quality / docker-check (push) Skipped
quality / web (push) Failing after 38s
quality / api (push) Successful in 49s
CD / quality (push) Failing after 1m36s
CD / publish (push) Skipped
44 lines
1.3 KiB
Plaintext
44 lines
1.3 KiB
Plaintext
---
|
|
description: Fastify API — слои, плагины, контракт ошибок
|
|
globs: apps/api/**/*
|
|
alwaysApply: false
|
|
---
|
|
|
|
# Backend Fastify
|
|
|
|
Стек: **Node.js 22**, **Fastify 5**, `@fastify/*` plugins, `@cdnmanager/shared`, `@cdnmanager/db`.
|
|
|
|
MCP — [`backend-mcp.mdc`](backend-mcp.mdc).
|
|
|
|
## Слои
|
|
|
|
```
|
|
routes/ → services/ → @cdnmanager/db (repositories)
|
|
↘ lib/cf-client.ts
|
|
```
|
|
|
|
- Routes — тонкие Fastify plugins (`fastify-plugin`)
|
|
- **Запрещено:** SQL в routes, `fetch` к CF вне `cf-client`
|
|
|
|
## Плагины (официальные)
|
|
|
|
`@fastify/jwt`, `@fastify/cors`, `@fastify/sensible`, `@fastify/static`, `@fastify/helmet`, `@fastify/rate-limit`, `@fastify/type-provider-zod`, `fastify-plugin`
|
|
|
|
## Ошибки
|
|
|
|
Формат: `{ error: { code, message } }`
|
|
|
|
Коды: `NOT_FOUND`, `VALIDATION_ERROR`, `UNAUTHORIZED`, `FORBIDDEN`, `CONFLICT`, `CLOUDFLARE_ERROR`, `INTERNAL_ERROR`
|
|
|
|
## Правила
|
|
|
|
- Zod schemas только из `@cdnmanager/shared`
|
|
- `db.transaction()` для multi-step writes
|
|
- Операции >2s → async job (`sync_jobs` + `p-queue`)
|
|
- Env через Zod в `config.ts`; prod fail-fast на dev `JWT_SECRET`
|
|
- TypeScript strict; `function` для handlers/services
|
|
|
|
## API + UI
|
|
|
|
[`backend-api-ui.mdc`](backend-api-ui.mdc)
|