Digital Reception — Фаза 1

Видеоаналитика рецепции клиники: распознавание лиц, ручной enrollment, согласия, история визитов. Компонент Платформы цифровых сервисов клиники (ПЦС).

ТЗ: TZ (1).md. План разработки: ~/.claude/plans/plan-mode-reflective-wand.md.

Стек

• Монорепо: pnpm workspaces + Turborepo.
• БД: PostgreSQL 16 + pgvector, Prisma 5.
• Backend: NestJS 10 (apps/api, apps/polimed-mock), Python + FastAPI (apps/face-service, apps/video-ingest).
• Frontend: Next.js 15 (App Router) + shadcn/ui + Recharts (apps/web-admin).
• Очереди: BullMQ (Redis).
• Хранилище кадров: MinIO (S3-совместимое).
• Распознавание лиц: InsightFace buffalo_l, 512-d cosine.

Структура

apps/
  api/             # NestJS — auth, RBAC, треки, согласия, визиты, аудит
  face-service/    # Python FastAPI — InsightFace + pgvector + re-id
  polimed-mock/    # NestJS — мок МИС Полимед (вне скоупа Ф1)
  video-ingest/    # Python — минимальный mp4-консьюмер (скаффолд)
  fixtures-runner/ # Node — e2e сценарии треков и событий
  web-admin/       # Next.js 15 + shadcn/ui — админка
packages/
  db/              # Prisma schema, миграции, сид
  ui/              # shadcn/ui компоненты (shared)
  tsconfig/        # base / nest / next tsconfig пресеты
  eslint-config/   # общий ESLint
docker/
  docker-compose.yml   # postgres + redis + minio
  init.sql             # CREATE EXTENSION vector

Быстрый старт

# 1. Инфраструктура
cp .env.example .env
pnpm docker:up                    # postgres+redis+minio

# 2. Зависимости
pnpm install

# 3. БД
pnpm db:migrate                   # создаёт схему
pnpm db:seed                      # 4 юзера, 3 камеры, 3 зоны

# 4. Сервисы (каждый в своём терминале)
pnpm --filter=@reception/api dev
pnpm --filter=@reception/polimed-mock dev
pnpm --filter=@reception/web-admin dev
# face-service:
cd apps/face-service && uvicorn main:app --reload --port 8001

Контроль доступа

Сидер создаёт 4 dev-пользователя (пароли в .env.example):

Email	Роль	Что видит
manager@local	MANAGER	Дашборд, история визитов
senior@local	SENIOR_ADMIN	Enrollment, согласия
security@local	SECURITY	Лента инцидентов (Ф2)
admin@local	SYSADMIN	Аудит, пользователи, камеры

Скоуп Фазы 1

• ✅ face-service + pgvector + cross-camera re-id.
• ✅ Web-admin: ручной enrollment, согласия, история визитов, аудит.
• ✅ Фиксация бумажных согласий, отзыв → удаление эмбеддингов за 24 ч.
• 🚫 Полимед API — замокан apps/polimed-mock, реальной интеграции нет.
• 🚫 RTSP / GPU / ByteTrack — работа Фазы 0, в Ф1 только минимальный mp4-скаффолд.
• 🚫 Поведенческие алерты (Max-бот) — Фаза 2.