Локальная разработка

Текущий состав — в ARCHITECTURE. Локальная композиция: docker-compose.yml. Удалённые Ruby/workflow profiles и WebRTC ingress не являются вариантами запуска.

Перед запуском

В локальном окружении должны быть настроены значения, требуемые Compose: CHAT_NATS_AUTH_SEED, CHAT_NATS_AUTH_ISSUER, CHAT_NATS_AUTH_USER, CHAT_NATS_AUTH_PASSWORD, а для сборки PostgreSQL — CI_CHAT_AGENT_POSTGRES_BASE_IMAGE. Не копируйте production credentials в репозиторий. Параметры внешней модели и ASR задавайте по текущей конфигурации, без скрытой подмены адреса.

cd docker
docker compose config --quiet
docker compose up -d --build

Этот запуск требует доступных внешних зависимостей и Docker. Не запускайте down, не удаляйте volumes и не пересоздавайте пользовательский стек ради проверки документации. Локальный Front: http://127.0.0.1:8080/, Gateway: http://127.0.0.1:8101/api. Browser chat NATS проходит через Front /chat-ws; внутренние адреса заданы в Compose.

Изолированные проверки

cd src_front
npm ci --no-audit
npm test -- src/extension/domRuntime.test.ts
npm run build
npm run extension:build

Python-зависимости устанавливаются в отдельное venv по requirements затронутых частей. PostgreSQL/NATS integration использует явно выделенные тестовые ресурсы; см. init_database.py и штатные CI commands.

Debug использует override, пример настроек и существующие .run/Attach_*. Задайте абсолютный PYCHARM_PROJECT_ROOT, запуск остаётся detached. Правила проверки и поставки.