План MVP: месяц, полгода и год
Даты здесь являются ориентирами. Важен порядок: сначала проверяем инженерную платформу, затем строим один сквозной сценарий, после этого расширяем продукт.
Рабочая гипотеза MVP
Первый сценарий: пользователь пишет или говорит «создай встречу», видит независимую от канала карточку, явно подтверждает данные, после чего система создаёт событие календаря и показывает результат.
Правила первого сценария подтверждены. Начинаем с fake-calendar; обязательны название, начало, конец
и часовой пояс; создание всегда требует явного подтверждения. Описание и участники необязательны.
Fake-сценарий и настоящий Telegram уже доказали транспортный путь. Естественная русская фраза проверена
через локальную Qwen с typed structured output. Connection Service, Google OAuth и Google Calendar
provider реализованы. Следующий проверяемый рубеж — повторный ручной sandbox N2N на актуальной Temporal
history. После него проектируется составной план нескольких действий. Speech-to-text остаётся следующим
адаптером того же текстового сценария.
Переводы денег не входят в MVP. До отдельного threat model они доступны только как будущие
read-only или simulation сценарии.
Первый месяц — инженерный полигон
Цель: любой участник поднимает систему, запускает тесты и видит её состояние до появления бизнес-кода.
Неделя 1 — правила и воспроизводимость
- завершить rulesets, CODEOWNERS и обязательные CI checks;
- зафиксировать маленькие TDD-коммиты и шаблон pull request;
- создать ADR для каждого нового инструмента;
- подготовить одну команду для проверки каждого репозитория;
- добавить публичный roadmap, RFC-шаблон и tech radar.
Результат: чистый checkout можно проверить по README без устных инструкций.
Неделя 2 — локальные окружения
- спроектировать отдельные репозитории
deploy,infraиtest-lab; - быстрый профиль Docker Compose для ежедневной разработки;
- полный профиль k3d для проверки Kubernetes;
- Helm charts и одинаковые настройки
local,dev,stage; - PostgreSQL, Keycloak, Temporal, Kafka и OPA с тестовыми данными;
- секреты только через локальные примеры и External Secrets, без значений в Git.
Результат: быстрый профиль запускается одной командой; полный профиль воспроизводим на чистой машине.
Неделя 3 — наблюдаемость и тесты системы
- OpenTelemetry SDK и Collector как единая точка telemetry;
- Prometheus, Grafana, Tempo и Loki;
- correlation id проходит через HTTP, событие и workflow;
- smoke и end-to-end тесты на fake-коннекторах;
- k6: smoke, baseline, stress и короткий soak;
- дашборд latency, throughput, errors и saturation.
Результат: один тестовый запрос виден в логах, метриках и trace от входа до fake-коннектора.
Неделя 4 — масштабирование и отказы
- ephemeral namespace для pull request через Argo CD ApplicationSet;
- Horizontal Pod Autoscaler на измеряемой метрике;
- тесты повторной доставки, idempotency и потери внешнего сервиса;
- Chaos Mesh только в отдельном разрешённом namespace;
- SBOM, Trivy, Cosign, provenance и OpenSSF Scorecard;
- отчёт с найденными пределами, а не «красивое» число RPS.
Результат: каркас переживает перезапуск pod и временную недоступность зависимости без тихой потери данных.
Ближайшие бизнес-инкременты
1. Естественный язык вместо технического формата
Состояние: основной полный запрос работает; уточняющий диалог при неполных данных остаётся задачей.
- принять фразы вроде «Поставь завтра в 19:00 созвон с Колей на полчаса»;
- учитывать часовой пояс пользователя, относительные даты и длительность;
- задавать короткий уточняющий вопрос при неоднозначности или нехватке данных;
- отделить
IntentModelот бизнес-валидации: модель предлагает типизированный draft, но не выполняет действие; - оставить детерминированную fake-модель для CI и добавить сменный OpenAI-compatible provider для локального или облачного LLM;
- проверять structured output общей схемой контрактов и не передавать в Action Service неполный payload.
Результат: Telegram принимает обычную пользовательскую фразу и показывает точную карточку встречи.
2. Настоящий календарь
Состояние: код и контракты готовы; автономный fake acceptance зелёный; ручной Google sandbox N2N нужно повторить на актуальных версиях.
- сохранить единый
calendar-mcp, а провайдеры выбирать через стратегиюfake/google; - добавить Google OAuth connection flow и хранить refresh token только в зашифрованном виде;
- использовать тот же
calendar.create_event,requestKeyи защиту от дублей, что и у fake-провайдера; - покрыть Google API contract-тестами на stub и отдельным ручным sandbox N2N;
- оставить fake-провайдер обязательным для автономного CI и внешних contributors.
Граница OAuth и передача пользователя зафиксированы в ADR-0015: refresh token принадлежит отдельному
Connection Service, а Calendar MCP получает только короткоживущий access token для доверенного
tenantId + actorId.
Результат: подтверждённая команда из Telegram создаёт реальное событие Google Calendar, а тесты не требуют внешнего аккаунта.
2.1 Составной план действий
- принять одно сообщение с несколькими намерениями;
- вернуть из Agent Runtime упорядоченный типизированный план;
- хранить отдельные input, output и статус каждого шага;
- передавать output предыдущего шага только по явному mapping-контракту;
- определить остановку, повтор и компенсацию до добавления второго реального коннектора;
- проверить первый сценарий
Google Calendar → Notionсначала на fake-провайдерах.
Результат: одно подтверждение запускает понятную последовательность, а Temporal UI показывает каждый шаг и его параметры без чтения внутренних логов.
3. Сквозная наблюдаемость после real N2N
- передавать W3C
traceparentчерез Telegram Adapter, Gateway, Conversation, Agent, Action, Temporal и MCP; - показывать полную последовательность span в Grafana Tempo;
- писать структурированные логи с
service.name,service.version,deployment.environment,trace_id,span_idи безопаснымrequest_id; - добавлять в Loki метки
compose_serviceи Kubernetes metadata через Collector, не задавая фиксированныйcontainer_name, который мешает нескольким replica; - связать логи, trace, Temporal workflow ID и итоговый audit trail без записи prompt, токенов и персональных данных в обычные логи.
Результат: один реальный Telegram-запрос открывается в Grafana как последовательность всех сервисов, а логи фильтруются по сервису, окружению и trace.
Два–три месяца — работающий MVP
- Согласовать RFC первого календарного сценария.
- Сначала написать сквозной acceptance-тест на fake AI и fake Calendar MCP.
- Реализовать Channel Gateway без зависимости от Telegram.
- Сделать Telegram адаптер примером канала, а не центром архитектуры.
- Добавить совместимый контракт ответа диалога и карточки подтверждения.
- Реализовать Conversation Service минимального размера и переключить на него Channel Gateway.
- Создать Widget SDK, который проверяет и отображает общий контракт.
- Реализовать Approval Service только когда появятся правила подтверждения сложнее текущего Action API.
- Подключить один реальный календарь за тем же контрактом, что и fake.
- Добавить audit trail, policy decision и durable workflow.
- Провести load, soak, chaos и restore проверки.
- Выпустить публичную MVP-версию с demo и инструкцией запуска.
Definition of Done MVP:
- текстовая команда проходит весь путь до календаря;
- голос является адаптером того же сценария;
- пользователь видит точные данные до подтверждения;
- повтор запроса не создаёт дубль;
- все шаги видны в trace и audit trail;
- система работает с fake-интеграциями без внешних аккаунтов;
- документация позволяет стороннему разработчику повторить demo.
Шесть месяцев — публичная alpha
- multi-tenancy и отдельные подключения пользователей;
- Web/PWA и Telegram используют один Widget SDK;
- календарь, задачи и Jira как три независимых MCP-коннектора;
- quotas, rate limits и контроль стоимости AI;
- versioned contracts и автоматическая проверка совместимости;
- preview environments для pull request и постоянный stage;
- SLO, alerts, backup/restore и регулярные game days;
- SDK и шаблон для внешнего MCP-коннектора;
- публичные RFC, changelog, release notes и community meetings;
- первые внешние contributors проходят путь от issue до release.
Критерий alpha: продукт полезен небольшой группе тестировщиков, а сбой одного коннектора не ломает остальные сценарии.
Один год — beta или 1.0
- стабильный публичный API и политика совместимости;
- каталог проверенных коннекторов и процесс их security review;
- горизонтальное масштабирование stateless-сервисов и worker pools;
- multi-region план, проверенный restore и documented disaster recovery;
- canary/blue-green release и автоматический rollback по SLO;
- управление стоимостью, capacity model и регулярные нагрузочные отчёты;
- зрелая governance-модель с maintainers и review ownership;
- security baseline OpenSSF и воспроизводимый release supply chain;
- высокорисковые сценарии только после threat model, step-up auth и независимого аудита;
- wallet остаётся
read-only/simulation, пока отдельный пилот не докажет безопасность.
Критерий 1.0: стабильность контрактов, понятная эксплуатация и безопасное расширение важнее количества интеграций.
Правило изменения плана
Каждый этап заканчивается измеримым результатом и коротким отчётом. Если измерение не прошло, следующий
этап не начинается. Новая технология сначала получает статус assess или trial в tech radar и ADR;
статус adopt появляется только после успешного теста на полигоне.