Файлы · 343ab7134aff6da6c32b25d2d5be8176d174d56c · Латипов Руслан Шамильевич / swarm · Mos.Hub

.
├── apps/
│   ├── api/      # Бекенд на Hono: округа, районы, заявки, инженеры, планы + auth
│   └── admin/    # Админка (Vite + React SPA), структура по FSD:
│                 #   app / pages / features / entities / shared
├── packages/
│   ├── db/       # Слой БД: схемы Drizzle, миграции, подключение к Postgres
│   ├── shared/   # @beeline/shared — hc-клиент, конфиг auth, типы, theme.css
│   ├── ui/       # @beeline/ui — React-компоненты дизайн-системы
│   └── onboarding/ # @beeline/onboarding — движок туров driver.js (router-агностичный)
├── docker-compose.yml   # Локальный PostgreSQL
├── .env.example         # Шаблон общего окружения для api + db
├── CLAUDE.md            # Подробный док проекта для AI-агентов
└── pnpm-workspace.yaml
pnpm install                                 # 1. зависимости всех воркспейсов
cp .env.example .env                         # 2. общий .env для apps/api + packages/db
cp apps/admin/.env.example apps/admin/.env   # 3. .env админки (VITE_API_URL)
docker compose up -d db valhalla             # 4. PostgreSQL и маршрутизатор
pnpm build                                   # 5. @beeline/db и @beeline/api собираются в dist
pnpm db:migrate                              # 6. миграции (db:generate — создать новую)
pnpm --filter @beeline/api seed:tz           # 7. датасет заказчика на 2026-08-17
pnpm --filter @beeline/api seed:admin        # 8. админ из ADMIN_EMAIL/ADMIN_PASSWORD
pnpm dev:api                                 # 9. API на http://localhost:3030 (tsx watch)
pnpm dev:admin                               # 10. админка на http://localhost:5173 (Vite)
cd solver && uv sync --frozen
# httpx уважает системный прокси и не достучится до localhost — гасим его для процесса
env -u HTTP_PROXY -u HTTPS_PROXY -u http_proxy -u https_proxy NO_PROXY='*' uv run python src/main.py
cp .env.example .env                          # корневой (api + db)
cp apps/admin/.env.example apps/admin/.env    # админка (VITE_API_URL)
Get-NetTCPConnection -LocalPort 3030 -State Listen | ForEach-Object { Stop-Process -Id $_.OwningProcess -Force }
# на машинах с системным прокси localhost перехватывается — нужен --noproxy
curl --noproxy '*' http://localhost:3030/districts
curl --noproxy '*' "http://localhost:3030/plans/day?districtSlug=vostok&date=2026-08-17"
pnpm --filter @beeline/api check:plan 2026-08-17   # инварианты готового плана
pnpm --filter @beeline/api exec vitest run         # юнит-тесты API (без watch)
cd solver && uv run python src/check_solver_policy.py   # политика решателя без БД
bash apps/api/scripts/smoke/replan-trigger.sh      # заявка сама попадает в план
bash apps/api/scripts/smoke/export.sh              # выгрузка: BOM, колонки, число строк
pnpm --filter admin test                           # юнит-тесты фронта (дифф плана, кластеры карты)
apps/admin/src/
  app/        шелл, провайдеры, роутинг (react-router-dom), стили
  pages/      plan, calendar, orders, engineers, catalogs, ui-kit — цели маршрутов
  features/   pick-district, create-order, assign-order, theme-toggle — по одному действию
  entities/   district — чтение (useDistricts) + ключи кэша + типы
  shared/     api (client+auth), config (query-client), model (ui-store)
import { createApiClient, unwrap } from '@beeline/shared';
const api = createApiClient(import.meta.env.VITE_API_URL);
const { data, meta } = await unwrap(
  await api.districts.$get({ query: { limit: '10' } }),
);