---
title: Key File Locations
impact: LOW
impactDescription: Quick reference for current split-repository layout
tags: reference, navigation, 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)

## Key File Locations

## `qadam-core`

| Purpose | Path |
|---------|------|
| Backend entry point | `apps/api/src/main.ts` |
| API modules | `apps/api/src/modules/{feature}/` |
| OpenAPI setup | `apps/api/src/openapi/` |
| OpenAPI artifact | `apps/api/openapi/openapi.json` |
| Prisma schema | `packages/prisma/schema.prisma` |
| Prisma migrations | `packages/prisma/migrations/` |
| Shared Zod schemas | `packages/shared/src/schemas/` |
| Shared constants | `packages/shared/src/constants/` |
| Canonical docs | `docs/` |
| Platform specs | `specs/qadam-platform/` |

## `qadam-web`

| Purpose | Path |
|---------|------|
| Next.js app root | `apps/web/src/app/` |
| Catalog page | `apps/web/src/app/page.tsx` |
| Item detail page | `apps/web/src/app/item/[slug]/page.tsx` |
| Buyer area | `apps/web/src/app/me/` |
| Seller area | `apps/web/src/app/seller/` |
| Admin area | `apps/web/src/app/admin/` |
| Roadmap app root | `apps/roadmap/src/app/` |
| Roadmap document store | `apps/roadmap/src/lib/roadmap-store.ts` |
| Shared API layer | `apps/web/src/shared/api/` |
| Generated OpenAPI types | `apps/web/src/shared/api/generated/openapi.d.ts` |
| Local OpenAPI mirror | `openapi/openapi.json` |
| Frontend docs | `docs/` |

## Production runtime on current server

| Purpose | Path |
|---------|------|
| API repo checkout | `/data/qadam-core` |
| Web repo checkout | `/data/qadam-web` |
| API systemd unit | `/etc/systemd/system/qadam-api.service` |
| Web systemd unit | `/etc/systemd/system/qadam-web.service` |
| Roadmap systemd unit | `/etc/systemd/system/qadam-roadmap.service` |
| Shared env file | `/etc/qadam/qadam.env` |
| Roadmap env file | `/etc/qadam/qadam-roadmap.env` |
| Nginx vhost: product | `/etc/nginx/sites-available/qadam.2fab.app.conf` |
| Nginx vhost: roadmap | `/etc/nginx/sites-available/qadam-roadmap.2fab.app.conf` |

## Legacy path

- `/data/uzbek` — legacy checkout, не использовать как source of truth новой разработки.