каркас: домен, генерация типов фронта, стенд и карточки задач

Контракт в коде: КИО по нормативу, 43 события WS по шести союзам направлений,
таймеры ГОСТ, таксономия E1–E6, шесть компетенций радара. make types гоняет
их через JSON Schema в generated.ts, тест ловит забытую регенерацию.

Стенд: docker compose postgres + backend, health отвечает, база досягаема
из контейнера бэкенда. Makefile не врёт — нереализованные цели падают
и называют карточку, которая их закроет.

frontend/.npmrc: под WSL2 npm install зависает на дефолтных 15 сокетах.
This commit is contained in:
Ivan Gerasimov 2026-09-15 19:35:03 +03:00
commit 7b7dd38e9f
36 changed files with 4997 additions and 0 deletions

48
Makefile Normal file
View file

@ -0,0 +1,48 @@
# Подъём стенда и рутина. Цели, которых ещё нет, честно падают
# и называют карточку, которая их закрывает, — README не должен врать.
UV ?= uv
COMPOSE ?= docker compose
.DEFAULT_GOAL := help
help: ## Список целей
@grep -hE '^[a-z-]+:.*##' $(MAKEFILE_LIST) | sed 's/:.*##/\t/' | expand -t22
dev: ## Поднять стенд: postgres + backend --reload + frontend
$(COMPOSE) up --build
down: ## Погасить стенд
$(COMPOSE) down
back: ## Только бэкенд, локально, без докера
cd backend && $(UV) run uvicorn app.main:app --reload --port 8000
front: ## Только фронтенд, локально
npm --prefix frontend install && npm --prefix frontend run dev
types: ## domain/events.py → frontend/src/shared/types/generated.ts
cd backend && $(UV) run --no-project --with 'pydantic>=2.7' python scripts/export_types.py
test: ## Тесты бэкенда
cd backend && $(UV) run --extra dev pytest -q
typecheck: ## Проверить фронтенд компилятором
npm --prefix frontend run typecheck
models: ## Скачать веса GigaAM (STT) и Silero (TTS) в backend/models/
@echo "не реализовано — карточка tasks/lct-02-latency-baseline.md"; exit 1
seed: ## Залить сценарии из /scenarios в БД
@echo "не реализовано — карточка tasks/lct-04-scenario-loader.md"; exit 1
repl: ## Текстовый диалог со звонящим без голоса
@echo "не реализовано — карточка tasks/lct-07-caller-slots.md"; exit 1
pregen: ## Дерево диалога и WAV первых реплик для офлайна
@echo "не реализовано — карточка tasks/lct-19-reference-dialog.md"; exit 1
demo: ## Поднять всё в демо-режиме: офлайн, прогретые модели
@echo "не реализовано — карточка tasks/lct-21-demo-readiness.md"; exit 1
.PHONY: help dev down back front types test typecheck models seed repl pregen demo