# Sections

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

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

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.