Sections

Паспорт документа

• Статус документа: living standard
• Актуально на: 28 марта 2026 года
• Владелец: backend/platform-команда
• Пересмотр: при изменении инженерной практики, CI/CD, архитектурных правил или локального workflow
• Область применения: внутренние rule/reference-card документы для инженерной команды
• Связанные документы:
  • Индекс Agents
  • Команды разработки
  • Инженерные принципы

This file defines all sections, their ordering, impact levels, and descriptions. The section ID (in parentheses) is the filename prefix used to group rules.

---

1. Architecture (architecture)

Impact: CRITICAL Description: Feature-based code organization, Server Components strategy, API separation and repo-boundary rules for the current split model (qadam-core + qadam-web).

2. Code Quality (quality)

Impact: CRITICAL Description: Standards for maintaining high-quality, maintainable code including PR reviews, error handling, imports, and accountability.

3. Data Layer (data)

Impact: HIGH Description: Repository patterns, Prisma best practices, read/write replica separation, Redis caching, and DTO boundaries.

4. API Design (api)

Impact: HIGH Description: NestJS controller patterns, input validation, API versioning, and proper separation of HTTP concerns from business logic.

5. Performance (performance)

Impact: HIGH Description: Server rendering strategy, database query optimization, caching patterns, and algorithm complexity.

6. Testing (testing)

Impact: MEDIUM-HIGH Description: Test coverage requirements, NestJS testing patterns, and Playwright E2E strategies.

7. Design Patterns (patterns)

Impact: MEDIUM Description: NestJS Dependency Injection, shared Zod schemas, and internationalization patterns.

8. CI/CD (ci)

Impact: HIGH Description: Type checking priorities, git workflow standards, and deployment pipeline.

9. Reference (reference)

Impact: LOW Description: Informational lookups, file locations, and local development setup guides.