Команды сборки, проверки и локальной разработки

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

• Статус документа: working reference
• Актуально на: 28 марта 2026 года
• Владелец: backend/platform-команда
• Пересмотр: при изменении инженерного backlog, локального workflow или платформенного статуса
• Область применения: внутренний инженерный knowledge/rules/backlog слой проекта
• Связанные документы:
  • Индекс документации
  • Текущее состояние
  • Roadmap

Общий принцип

После split проекта команды нужно запускать в контексте соответствующего репозитория:

• backend/platform: qadam-core
• frontend/web: qadam-web

qadam-core

Запускать из корня репозитория qadam-core:

• pnpm install — установить зависимости
• pnpm dev — локально поднять API
• pnpm check-types — type-check backend-пакета
• pnpm test — unit tests backend
• pnpm build — production build backend
• pnpm export:openapi — собрать apps/api/openapi/openapi.json

Prisma

• pnpm --filter @repo/prisma generate — пересобрать Prisma client
• pnpm --filter @repo/prisma migrate dev --name <migration_name> — dev migration
• pnpm --filter @repo/prisma migrate deploy — применить production migrations
• pnpm --filter @repo/prisma db seed — заполнить dev-данные
• pnpm --filter @repo/prisma studio — Prisma Studio

qadam-web

Запускать из корня репозитория qadam-web:

• pnpm install — установить зависимости
• pnpm dev — локально поднять product frontend apps/web
• pnpm dev:roadmap — локально поднять сервис документации apps/roadmap
• pnpm generate:api-contract — пересобрать generated contract из openapi/openapi.json
• pnpm check:api-contract — проверить drift между artifact и generated types
• pnpm check-types — type-check всего repo (apps/web + apps/roadmap)
• pnpm build — production build всего repo (apps/web + apps/roadmap)
• pnpm build:web — production build только apps/web
• pnpm build:roadmap — production build только apps/roadmap

Базовый quality gate

Для backend change package:

• pnpm check-types
• pnpm test
• pnpm build
• pnpm export:openapi
• если change package добавляет или меняет endpoint'ы, update docs/frontend/frontend-change-log.md

Для frontend change package:

• pnpm generate:api-contract
• pnpm check:api-contract
• pnpm check-types
• pnpm build

Полезные проверки production

• systemctl status qadam-api qadam-web qadam-roadmap nginx
• curl https://qadam.2fab.app/api/v1/health
• curl -I https://qadam.2fab.app/api/docs
• curl -I https://qadam.2fab.app/roadmap
• curl -I -u <login>:<password> https://qadam-roadmap.2fab.app
• curl -u <login>:<password> https://qadam-roadmap.2fab.app/api/health

Redis и PostgreSQL

• redis-cli ping — проверить Redis
• psql "$DATABASE_URL" — подключиться к PostgreSQL

Важно

• Не использовать старые команды вида pnpm dev --filter=web или pnpm dev --filter=api как основной workflow новой разработки.
• Не использовать /data/uzbek как рабочую площадку после cutover.