# START_HERE

## 0) Подключи контекст Codex

Работай из корня checkout: Codex автоматически загрузит [`../AGENTS.md`](</experiments/voice-ai/archive/c/AGENTS.md>). Project inventory и workflows находятся в [`../.knowledge/`](#archive-availability); reusable skills и роль `monitorsoft_voice_chat_runtime_debugger` устанавливаются private `codex-workspace`, а не копируются в репозиторий.

## 1) Подними стек

```bash
cd docker
docker compose down --remove-orphans
docker compose up -d --build
```

Активный runtime для локального Docker задается в `docker/.env`:
- `COMPOSE_PROFILES=langgraph_rb` + Ruby subjects
- `COMPOSE_PROFILES=langgraph` + Python subjects

## 2) Открой UI

- `http://127.0.0.1:8080/`

Дополнительные локальные endpoints:

- Core: `http://127.0.0.1:8000/core`
- API Gateway: `http://127.0.0.1:8101/api`
- NATS WebSocket: `ws://127.0.0.1:9222`

Production:

- основной UI: `https://webrtc-komaroff.gis-master.ru/`
- file UI: `/whisper-trasncription/`, `/whisper-diarization/`, `/whisper-staged/`, `/whisper-bench/`, `/whisper-summary/`
- диагностика: `/status/`, compatibility alias `/health/`
- stack: `https://gis-master.ru/insight/stack?stack=web-rtc-komaroff`

## 3) Что происходит в системе

- text turn: `src_front -> /core/message -> nats.agent.* -> runtime -> nats.llm.* / nats.tools.* -> nats.events.*`
- live voice: `WebRTC -> src_core -> inference.whisper.stream.* -> stt_whisper_to_nats -> inference.whisper.text.* -> src_core -> nats.agent.*`
- file transcription: `Browser -> <whisper-page>/api/file-transcribe -> inference.whisper.file.* -> file worker -> NATS WS progress/result`
- LLM inference идет через `src_llm` и внешний `rag-stack` / `llm-models`.

Полная карта сервисов, subject-ов, payload-ов и `rag-stack` integration: [`ARCHITECTURE.md`](</experiments/voice-ai/archive/c/DOCS/ARCHITECTURE.md>)

## 4) Проверка сценариев

1. `где мой рейс`
2. `SU123`
3. `найди аэропорт`
4. `как дела`

## 5) Где менять сценарии

- `src_langgraph/config/scenarios/*.json` — промпты, tool names, схемы.
- `src_langgraph/scenarios/*.py` — логика сценариев.
- `src_langgraph/engine.py` — подключение сценария в граф.
- Ruby runtime и DSL: [`src_langgraph_rb/README.md`](</experiments/voice-ai/archive/c/src_langgraph_rb/README.md>)