Qadam Roadmap
← Назад к библиотеке
проектdocs/Agents/rules/reference-local-dev.md

reference-local-dev.md

Обновлён 1 апр. 2026 г., 12:41 · 0 комментариев

ИсходникСкачать

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 документы для инженерной команды
  • Связанные документы:

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

Предпосылки

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

Backend: qadam-core

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

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

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

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

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

pnpm dev:roadmap

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

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.