simbiot-harness/out/simbiot_ui_product_plan.md

164 lines
15 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

# Simbiot UI — план продукта: продаваемый доступ к CloudCLI UI (claudecodeui)
*t-261008114514 · v0.2 (решения Alex зафиксированы, m-516173892) · 2026-10-08*
> **v0.2 — что изменилось:** получены ответы на все 7 вопросов v0.1 §9. Продукт
> зафиксирован: брендинг Simbiot UI / Simbiot Dashboard, одна цена **$99.9/мес,
> claude seat included**, ключи выдаём свои, наш RAG клиентам не даём — но строим
> **общий студийный RAG** (как строить стартапы + условия студии), подключение
> клиентов на старте **только вручную через Alex**. Пресейл-страница и онбординг
> обновлены под эти решения; юнит-экономика пересчитана под $99.9.
---
## 1. Суть продукта
Клиент покупает **доступ «из коробки» к развёрнутому claudecodeui** (web-UI для Claude Code):
регистрируется → получает аккаунт агента с мэйлом на нашем домене → заходит в личный UI
и работает с Claude-кодом через браузер, без установки чего-либо. Инфраструктура, старт,
авторизация и контекст — на нашей стороне.
**Ценность (фильтр AUM):** recurring-выручка (SaaS-подписка) на уже существующем железе
и моделях → прямой вклад в AUM на дистанции год+; каждая новая продажа не съедает базу.
## 2. Продуктовая рамка (v0.2 — по решениям Alex)
- **Нейминг (решено, A1):** **Simbiot UI** — сам продукт-интерфейс; **Simbiot Dashboard** —
панель управления/мониторинга. Подпись «powered by claudecodeui» в футере — честно про
опенсорс-основу (доверие, не слабость).
- **Цена (решено, A2):** **$99.9/мес, claude seat included** — один тариф, без BYO-вариантов
на старте. Claude-сид входит в цену.
- **API-ключи (решено, A3):** **даём наши** — клиент не приносит свой ключ, работает наш
шлюз (9router) с per-client spend-трекингом и лимитами. Клиент наших ключей не видит.
- **Онбординг (решено, A7):** **только вручную через Alex** на всю первую партию — заявка →
Alex подключает. Автоматический self-service провижининг — не раньше фазы 2 (см. §6).
- **Формат продажи:** подписка месяц-к-месяцу, оплата — существующий стек (Stripe live
обкатан на presale; p2p/счёт — для СНГ).
- **Кто клиент (стартовая гипотеза):** команды 1–5 человек, которым нужен Claude Code,
но лень/страшно разворачивать самим; последователи «перформанс-аудитории» студии.
- **Регистрация:** лендинг на ui.cil.by → форма-заявка (без мгновенной оплаты до ручного
подтверждения) → Alex подключает → оплата → доступы.
## 3. Архитектура и оркестратор
```
ui.cil.by (Caddy, существующий reverse-proxy)
├── веб-приложение Simbiot UI (заявки, биллинг, админка)
├── claudecodeui (UI-движок) ←── контейнеры/юниты на инстансе
├── Claude Code runtime (сервер) ←── claudecodeui дергает его
└── MCP-студии: общий студийный RAG (см. §3a), файловая, 9router-шлюз
```
- **Оркестратор** = сервис-провижинер (один Python-демон): по команде «новый клиент»
поднимает связку `сервер + UI-движок`, создаёт агента, прописывает прокси, пишет CLAUDE.md.
Стек: Docker (уже живёт на хосте) или systemd-юниты + Caddy-автосайты.
- Изоляция клиентов: отдельный контейнер на клиента (vCPU/RAM-лимиты, отдельный том).
- **9router — единственный LLM-шлюз** (A3: ключи наши): даёт маржу на моделях, per-client
spend-трекинг и защиту «клиент не видит наши ключи».
- **Свой RAG кооператива клиентам НЕ даём** (A6). Вместо него — общий студийный RAG (§3a).
### 3a. Общий студийный RAG (решение A6)
- **Что это:** отдельная база знаний общего назначения «как строить стартапы» + публичные
условия студии (типовые договоры, процессы, FAQ) — то, что не жалко показать клиенту.
- **Из чего:** частичный перегон **публичных** знаний кооператива (условия студии, методология
запуска проектов — studio-conditions-2026-10, SALES-PLAN-*, playbook-материалы), плюс
новые материалы, написанные специально для RAG.
- **Как:** отдельный RAG-индекс (не /root/rag кооператива!), своё векторное пространство;
подключение к клиентским инстансам через MCP-сервер read-only. Перегон — отдельной
задачей с ревью Alex (что именно пускать наружу).
- **Экономика:** входит в тариф как дифференциатор («агент знает методологию студии»),
апселл-фаза после первых 5 клиентов.
## 4. Онбординг-флоу (v0.2 — ручной, admin-first)
> Решение A7: подключение клиентов — **только вручную через Alex**, пока не решим иначе.
> Всё, что «авто» в v0.1, переезжает в фазу 2. Ручной флоу — тоже продукт, его надо
> сделать гладким.
1. Клиент оставляет заявку на лендинге (имя, email, телеграм, 2–3 предложения о задачах).
2. Заявка падает в очередь админки (и TG-уведомление Alex).
3. **Alex вручную** подтверждает и подключает: поднимает инстанс, создаёт мэйл агента
(`agent.<client>@cil.by`, Postfix+Dovecot уже подняты), авторизует claude seat.
4. Оркестратор пишет креды в vault (реестр ключей docs/KEYS-REGISTRY.md расширяется), клиенту
уходит письмо: логин, пароль, URL, что дальше (см. §5 CLAUDE.md).
5. Статус-индикатор в админке: заявка → подтверждена → подключается → активна.
**Гейт:** целевая пропускная способность ручного онбординга — 3–5 клиентов/нед до упора;
когда очередь копится > 1 недели — сигнал включать автопровижининг (фаза 2).
## 5. Claude-контекст (CLAUDE.md)
Оркестратор генерирует каждому клиенту `CLAUDE.md` при провижининге и обновляет при изменениях:
- где стартовано (инстанс, ОС, путь к дому проекта, лимиты);
- как ходить в сеть (9router-эндпоинт, ключи из env, а не в файлах);
- что за мэйл у агента и как им пользоваться (IMAP 993 / SMTP 587 cil.by);
- **как пользоваться студийным RAG** (MCP, какие знания там есть — §3a);
- правила безопасности (не трогать чужие тома, лимиты токенов, политика данных);
- как запросить помощь (саппорт-канал).
Обновления — через хук оркестратора (деплой = regenerate CLAUDE.md), чтобы у Claude-кода
всегда актуальная карта окружения.
## 6. План работ (фазы, v0.2)
| Фаза | Что делаем | Оценка |
|---|---|---|
| **0. Спайк (сейчас)** | Развернуть 1 инстанс claudecodeui на хосте за Caddy (ui.cil.by), проверить UX, OAuth Claude, MCP-хуки | 1–2 дня |
| **0b. Пресейл-лендинг ui.cil.by** | Страница Simbiot UI $99.9/мес, форма-заявка → TG-очередь к Alex (без мгновенной оплаты) — artefact: out/simbiot_ui_presale.html | 1 день |
| **1. Каркас продукта** | Админка заявок (очередь, статусы), Stripe-ссылка после ручного подтверждения | 2–3 дня |
| **2. Оркестратор (ручной режим)** | Провижининг по кнопке Alex (не по оплате): контейнер, мэйл, CLAUDE.md, teardown | 3–4 дня |
| **3. Общий студийный RAG** | Отдельный индекс; отбор публичных знаний (список на ревью Alex), MCP read-only | 3–4 дня |
| **4. Пилот** | 3–5 платящих клиентов через ручной онбординг Alex, фидбек, юнит-экономика на реальных числах | 1–2 недели |
| **5. Автопровижининг (отложено)** | Self-service оплата→доступ; включаем при копящейся очереди (гейт §4) | отложено |
**MVP-гейт:** ручной онбординг — не обходной путь, а план-А на пилот. Автоматизация —
только после подтверждённого спроса (фаза 5).
## 7. Юнит-экономика (v0.2, под $99.9/мес)
- **Цена:** $99.9/мес, claude seat included. Один тариф.
- Себестоимость: контейнер ~0 vCPU в простое; токены — через 9router (per-client трекинг
уже есть); домен/железо оплачены.
- **Кейс-1 (умеренное использование, ~$30/мес токенов на клиента):** маржа ≈ $69.9 (70%).
- **Кейс-2 (тяжёлый клиент, ~$80/мес токенов):** маржа ≈ $19.9 (20%) → нужны fair-use
лимиты в оффере.
- 20 клиентов × $99.9 = **$2.0к/мес recurring** при почти нулевой marginal cost.
- Fair-use: зафиксировать лимит токенов/мес в оффере (soft-limit с заголовком «overage
по договорённости»), чтобы кейс-2 не съедал маржу.
- По фильтру AUM: 20 клиентов = +$24к ARR recurring — долгосрочная база, не разовый доход.
## 8. Риски и как закрываем
- **ToS Claude** (перепродажа доступа, A2+A3 усугубляют — сид и ключи наши) → формат
«инфраструктура + сопровождение», лимиты, юр-модель уточнить с Alex до масштабирования
за пределы пилота.
- Нагрузка/лимиты хоста → квоты на клиента, мониторинг (spend-трекинг 9router уже есть).
- Support-нагрузка → CLAUDE.md-контекст + FAQ + агента-саппортёра в чат.
- **Бутылочное горлышко Alex (A7):** ручной онбординг ограничивает рост → гейт §4
(очередь > 1 нед → фаза 5).
- **Утечка знаний через студийный RAG (A6):** перегон только публичных материалов,
список на ревью Alex, read-only MCP.
## 9. Решения Alex (m-516173892, зафиксировано 2026-10-08)
| # | Вопрос v0.1 §9 | Решение Alex | Влияние на план |
|---|---|---|---|
| 1 | Нейминг | **Simbiot UI ok, Simbiot Dashboard ok** | Брендинг зафиксирован (§2) |
| 2 | Цена и тарифы | **$99.9/мес, claude seat included** | Один тариф (§2, §7) |
| 3 | Claude-аккаунты | **наши даём** | 9router — единственный шлюз, ToS-риск выше (§8) |
| 4 | Лимит первых клиентов | **да ок** | 10 ручных → фаза 5 авто |
| 5 | Мэйл-домен | **ок** | ящики на cil.by (§4) |
| 6 | MCP / RAG студии | **наш RAG — нет; общий студийный RAG — да** (как строить стартапы, условия студии, частичный перегон) | §3a, фаза 3 |
| 7 | Кто админ Claude-аккаунтов | **пока только я (Alex)** | Ручной онбординг (§4), гейт фазы 5 |
## 10. Что уже есть и переиспользуем
- Caddy reverse-proxy, Docker, домены cil.by — готовы.
- Postfix+Dovecot (SMTP/IMAP) — мэйл-агенты без нового софта.
- 9router — LLM-шлюз с spend-трекингом.
- Stripe live (обкатан на presale) — биллинг.
- Практики провижининга агентов: mx_provision_agent.py (Matrix), wizard-установщик харнеса.
- Портал кооператива — как референс регистрации/админки (форк или отдельное приложение).
- **out/simbiot_ui_presale.html** — пресейл-страница Simbiot UI $99.9/мес (создана в v0.2).
- **docs/ROADMAP-SIMBIOT-UI.md** — roadmap с ручным онбордингом как ограничением (v0.2).