---
title: Local Development Setup
impact: LOW
impactDescription: Актуальный локальный запуск после split репозиториев
tags: reference, setup, development, qadam-core, qadam-web
---
## Паспорт документа

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

## Локальная разработка

## Предпосылки

- Node.js 20+
- pnpm 9+
- PostgreSQL 17+ или совместимая dev-инсталляция
- Redis 7+
- Docker опционально, только если удобно поднимать локальные PostgreSQL/Redis контейнеры

## Backend: `qadam-core`

```bash
git clone https://git.2fab.app/eldar/qadam-core.git
cd qadam-core
pnpm install
cp .env.example .env
pnpm --filter @repo/prisma migrate dev --name init_local
pnpm --filter @repo/prisma db seed
pnpm dev
```

Минимальные переменные:

```env
DATABASE_URL=postgresql://postgres:postgres@localhost:5432/qadam
DATABASE_REPLICA_URL=postgresql://postgres:postgres@localhost:5432/qadam
REDIS_URL=redis://localhost:6379
PORT=5001
CORS_ORIGIN=http://localhost:5002
```

## Frontend: `qadam-web`

```bash
git clone https://git.2fab.app/eldar/qadam-web.git
cd qadam-web
pnpm install
cp .env.example .env
pnpm generate:api-contract
pnpm dev
```

Для локального сервиса документации:

```bash
pnpm dev:roadmap
```

Минимальные переменные:

```env
NEXT_PUBLIC_API_URL=http://localhost:5001/api/v1
API_URL=http://localhost:5001/api/v1
```

## Ожидаемая локальная схема

- API: `http://localhost:5001`
- Web: `http://localhost:5002`
- Сервис документации: `http://localhost:3001`

## Важно

- Текущий production не использует Docker как канонический runtime, поэтому local Docker Compose не должен считаться production truth.
- Source of truth по API-маршрутам: `qadam-core/docs/architecture/api-routes.md` и OpenAPI artifact.
- Source of truth по статусу платформы и ближайшим задачам: `qadam-core/docs/project/current-state.md` и `qadam-core/docs/project/roadmap.md`.