Overview

BR 6.3 — OpenClaw агент: Декомпозиция

Демо 29.05.2026 — Сценарий 3

Пользователь в чате админки: «Создай заказ на маргариту и колу на вынос для Арбата» → агент за ≤ 15 сек собирает и создаёт заказ через API → виден в Order Service и на KDS.

Источники

Слой	Документ
Требование	BR 6.3
ADR — архитектура	ADR-022
ADR — LLM-стек	ADR-023
Бизнес-спека	AI-агент
Бэкенд: OpenClaw Agent	API, Data Model, Events
Бэкенд: User Service	миграция agent.use, agent.config
Фронтенд: Админка	AI-агент — Чат
DevOps	Windows LLM Host Setup (выполнено), деплой 2 новых сервисов

Прогресс

• User Service — миграция permissions agent.use, agent.config + назначение системной роли «Администратор»
• OpenClaw Agent — новый репозиторий erp-openclaw-agent (Node.js + TS + Fastify): ReAct цикл, tool registry, SSE стрим, история сессий в PostgreSQL. LLM Gateway — самопис отказан 2026-05-13, агент ходит к LLM-провайдеру напрямую (TBD)
• Admin BFF — proxy-роут /api/v1/admin/agent/* (SSE pass-through)
• Admin Web — <AgentChatBubble /> в Layout, страница чата, API-клиент agent.ts
• Infra — деплой 2 новых сервисов на VPS (docker-compose, nginx, env, миграция БД, postgres database)

Затронутые репозитории

Репозиторий	Тип изменения	Новый?
erp-user-service	Liquibase миграция: permissions + role-permission link	нет
erp-openclaw-agent	Создать с нуля	да
erp-admin (BFF + web)	Proxy-роут + UI	нет
erp-infrastructure	docker-compose, nginx, env	нет

Зависимости и порядок

flowchart TD
    A[User Service миграция] --> B[Deploy User Service]
    E[OpenClaw Agent repo] --> F[Deploy OpenClaw Agent]
    B --> F
    G[Admin BFF route] --> H[Admin Web component]
    F --> H
    H --> I{Smoke test}
    I --> J[Demo ready]

Acceptance для демо

См. BR 6.3 Acceptance.

Открытые риски

Риск	Митигация
Qwen 14B на сложных русских фразах ошибается с store_id	Каталог tools — добавим helper find_store(name) если будет много промахов
LLM-хост падает за 5 мин до демо	Запасная Windows-машина с предзагруженной моделью; SSH-ключ прокинут заранее
Кассир случайно нажал «✨ AI» на POS	На POS UI кнопки нет — она только в админке, кассир туда не ходит
Slow inference (>30 сек на ход)	Видимый стрим показывает прогресс, юзер видит что что-то происходит