← Назад к библиотеке

проектdocs/Agents/rules/reference-file-locations.md

reference-file-locations.md

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

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

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

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 новой разработки.