Hanc.AI Documentation Update Plan

For Claude: REQUIRED SUB-SKILL: Use superpowers:executing-plans to implement this plan task-by-task.

Goal: Привести всю документацию в соответствие с текущим состоянием платформы — актуальные тарифы, новые фичи, удаление устаревшего.

Принципы:

• Документация для пользователя, НЕ техническая
• Никаких технических деталей (LLM модели, провайдеры TTS/STT, Egress, etc.)
• Всё из реальных данных репозиториев, ничего не выдумывать
• Говорим "advanced conversational AI", НЕ называем модели

Источники данных:

• Тарифы: hanc-app-frontend/src/utils/plans.ts + UserPaymentPlan.tsx
• Фичи: hanc-app-frontend компоненты (tools, actions, settings, widgets)
• API: /home/anton/hanc/api-key-capabilities.md
• Виджеты: hanc-webrtc-widget + frontend widget config

---

Сводка изменений

Что	Было	Стало
Тарифы	Free €10, Starter €30, Pro €250, Agency €800	Free €0 (€10 credit), Starter €29.95 (€30), Pro €99.95 (€100), Business €249.95 (€250), Enterprise custom
Годовая скидка	Не было	15%: Starter €25.46, Pro €84.96, Business €212.46
Тарифы/мин	Плоские	Дифференцированные: Free/Starter phone €0.15 web €0.13, Pro phone €0.13 web €0.11, Business phone €0.12 web €0.10
Кредиты	Не описано	Roll over, 100% подписки → кредит, auto top-up
Инструменты	Call Forwarding, Cal.com, API RAG	Call Forwarding, Google Calendar, API RAG (Cal.com убран из UI)
Действия	Email, SMS, API	Email, SMS, WhatsApp, API Call
Виджеты	4 типа, 10 тем	4 типа, 11 тем (+ tangerine, ember; default вместо indigo)
Настройки агента	Частично	+ Запись звонков, Анализ тональности, Резюме звонка, Opt-out данных
SLA	Упоминался	Убираем полностью
Outbound	Упоминался	Не документируем
API Reference	Заглушка "Coming soon"	Полное описание API (из api-key-capabilities.md)
Agency	Отдельный план €800	Agency — скрытый план, описание переделать в раздел про sub-accounts/workspaces в рамках Business+

---

Task 1: Обновить billing.md — тарифы и кредиты

Файл: docs/account/billing.md

Изменения:

1. Заменить таблицу тарифов на актуальную:
   • Free: €0/мес, одноразовый кредит €10
   • Starter: €29.95/мес, кредит €30
   • Pro: €99.95/мес, кредит €100 (пометка "Most Popular")
   • Business: €249.95/мес, кредит €250
   • Enterprise: индивидуально (Contact Sales)
2. Добавить годовые тарифы (скидка 15%): Starter €25.46, Pro €84.96, Business €212.46
3. Обновить тарифы за минуту (таблица phone/web по планам)
4. Добавить: кредиты переносятся на следующий месяц (roll over)
5. Добавить: 100% подписки конвертируется в кредит
6. Добавить: auto top-up (автоматическое пополнение)
7. Убрать упоминания Agency плана (или оставить минимальную ссылку "для агентств — свяжитесь с нами")
8. Убрать SLA упоминания если есть
9. Убрать outbound упоминания если есть

---

Task 2: Обновить agency.md — sub-accounts и workspaces

Файл: docs/account/agency.md

Изменения:

1. Убрать конкретную цену Agency €800 — это скрытый план
2. Переписать как раздел про управление клиентами (sub-accounts) и workspaces
3. Описать: создание клиентов, управление видимостью (dashboard, prompt, config, deployment, actions)
4. Описать: workspaces — создание, приглашение участников, переключение
5. Убрать "Agency vs Pro" сравнение — заменить на описание функционала для тех, кто управляет несколькими клиентами
6. Убрать SLA/white-label/custom domain если упоминаются как существующие (white-label — только Enterprise)

---

Task 3: Обновить voice-agents/tools.md — инструменты

Файл: docs/voice-agents/tools.md

Изменения:

1. Заменить Cal.com (Book Appointment) на Google Calendar:
   • Подключение Google аккаунта
   • Выбор календаря
   • Настройка рабочих дней и часов
   • Длительность слота
   • Часовой пояс
   • Агент видит доступные слоты и может создавать встречи
2. Оставить Call Forwarding (актуально)
3. Оставить API RAG (актуально)
4. Убрать Cal.com полностью
5. Описание Google Calendar — пользовательским языком, без технических деталей OAuth

---

Task 4: Обновить voice-agents/actions.md — действия

Файл: docs/voice-agents/actions.md

Изменения:

1. Убедиться что WhatsApp описан (в текущих доках уже есть — проверить актуальность)
2. Добавить описание шаблонных переменных WhatsApp: {{call_from}}, {{call_to}}, {{call_summary}}, {{call_sentiment}}, {{call_task_achieved}}, {{call_transcription}}
3. Упомянуть поддержку Twilio WhatsApp шаблонов (Template SID) для сообщений вне 24-часового окна
4. Проверить что Retrieval Variables описаны корректно (4 типа: text, number, boolean, selector)
5. Убедиться что условные получатели (conditioned recipients) описаны

---

Task 5: Обновить voice-agents/widgets.md — виджеты

Файл: docs/voice-agents/widgets.md

Изменения:

1. Обновить список тем — 11 штук: default, purple, blue, cyan, emerald, amber, tangerine, rose, ember, black, white
2. Проверить что типы виджетов актуальны (4: Inline, Pill, Pill Float, Floating)
3. Проверить embed-коды:
   • <hanc-ai-inline-call>
   • <hanc-ai-pill-call>
   • <hanc-ai-pill-float-call>
   • <hanc-ai-floating-call>
   • script: https://unpkg.com/hanc-webrtc-widgets
4. Убедиться что T&C модалка описана
5. Убедиться что ограничение доменов описано (до 50)
6. Убедиться что события виджета описаны (call-start, call-end)

---

Task 6: Обновить voice-agents/settings.md — настройки агента

Файл: docs/voice-agents/settings.md

Изменения:

1. Проверить/добавить: Голосовые настройки — выбор языка, голоса, громкость, скорость
2. Проверить/добавить: Настройки звонка — End Call After Silence (10-30 сек), Reminder Trigger (10-30 сек), Max Reminders (1-10)
3. Проверить/добавить: Запись звонков (toggle) — описать пользовательски: "включите чтобы записывать аудио звонков"
4. Проверить/добавить: Opt-out хранения данных (toggle) — для GDPR
5. Проверить/добавить: Анализ тональности (toggle) — после звонка определяет настроение (позитивное/нейтральное/негативное)
6. Проверить/добавить: Резюме звонка (toggle) — автоматическое текстовое резюме после звонка
7. Проверить/добавить: STT языки — до 4 дополнительных языков для распознавания речи
8. НЕ раскрывать технические детали (LiveKit Egress, провайдеры STT)

---

Task 7: Обновить integrations/index.md — интеграции

Файл: docs/integrations/index.md

Изменения:

1. Заменить Cal.com на Google Calendar:
   • Подключение Google аккаунта
   • Просмотр встреч
   • Отключение
   • Доступно на всех планах
2. Оставить Microsoft Outlook (если есть в UI) — проверить
3. Убрать Cal.com если упоминается как отдельная интеграция
4. Обновить список webhook событий если изменился
5. Проверить актуальность описания API Keys (макс. 3)
6. Проверить SIP trunk описание
7. Убрать SLA упоминания
8. Убрать outbound упоминания
9. Обновить таблицу доступности по планам

---

Task 8: Обновить faq/index.md — FAQ

Файл: docs/faq/index.md

Изменения:

1. Обновить все упоминания тарифов на актуальные
2. Обновить тарифы за минуту
3. Обновить список доступных инструментов (Google Calendar вместо Cal.com)
4. Обновить список действий (+ WhatsApp)
5. Убрать SLA упоминания
6. Убрать outbound упоминания
7. Обновить список интеграций
8. Проверить все числовые данные (лимиты файлов, ключей и т.д.)
9. Обновить информацию о планах (Agency → Business/Enterprise)

---

Task 9: Обновить api-reference/index.md — API документация

Файл: docs/api-reference/index.md

Изменения:

1. Убрать заглушку "Coming soon"
2. Написать полное описание API на основе api-key-capabilities.md
3. Переписать пользовательским языком (не техническим):
   • Описать что можно делать через API
   • Группировать по разделам: Звонки, Агенты, База знаний, Телефонные номера, Голоса, Подписка
   • Для каждого эндпоинта: что делает, метод, путь
   • НЕ включать: LLM конфигурацию (техническое), roadmap идеи
4. Упомянуть: аутентификация через API ключ (x-api-key header)
5. Упомянуть: base URL https://api.hanc.me
6. Упомянуть: формат JSON
7. Упомянуть: что НЕ доступно через API (OAuth интеграции, биллинг)
8. НЕ включать LLM endpoints — пользователю не нужно знать про модели

---

Task 10: Обновить voice-agents/index.md — обзор агентов

Файл: docs/voice-agents/index.md

Изменения:

1. Обновить список инструментов (Google Calendar вместо Cal.com)
2. Обновить список действий (+ WhatsApp)
3. Проверить описание настроек (+ sentiment, summary, recording)
4. Убрать outbound упоминания
5. Проверить что описание архитектуры не раскрывает технические детали

---

Task 11: Обновить analytics/index.md — аналитика

Файл: docs/analytics/index.md

Изменения:

1. Проверить что метрики соответствуют реальному дашборду: Total Calls, Total Duration, Average Duration
2. Добавить: Cost Breakdown (разбивка расходов) — по агентам, по датам
3. Проверить что Sentiment Analysis описан (3 категории: Positive, Neutral, Negative)
4. Проверить экспорт: CSV (подтверждено в API), Excel, PDF
5. Убрать SLA метрики если есть

---

Task 12: Обновить phone-numbers/index.md

Файл: docs/phone-numbers/index.md

Изменения:

1. Убрать описание outbound calling
2. Обновить: доступно с плана Starter (не Free)
3. Проверить актуальность описания Twilio интеграции
4. Проверить SIP trunk описание
5. Обновить информацию о планах если упоминается

---

Task 13: Обновить остальные файлы — сквозные правки

Файлы: Все файлы в docs/ — поиск и замена по ключевым словам.

Сквозные замены:

1. Поиск "Agency" план → заменить на Business/Enterprise где уместно
2. Поиск "SLA" → убрать
3. Поиск "outbound" → убрать или не акцентировать
4. Поиск "Cal.com" → заменить на Google Calendar
5. Поиск устаревших цен (€800, €250/month для Pro) → обновить
6. Поиск "€0.11/min" и прочих плоских тарифов → обновить на дифференцированные
7. Поиск упоминаний моделей AI (GPT, OpenAI, Claude, Anthropic) → заменить на "advanced conversational AI"

---

Task 14: Обновить немецкую локализацию

Папка: i18n/de/docusaurus-plugin-content-docs/current/

Изменения:

• После обновления всех английских файлов — перенести те же изменения в немецкие версии
• Те же тарифы, те же фичи, те же удаления

---

Порядок выполнения

1. Tasks 1-2 (биллинг, agency) — базовые данные о тарифах
2. Tasks 3-6 (tools, actions, widgets, settings) — фичи агентов
3. Tasks 7-8 (integrations, FAQ) — интеграции и FAQ ссылаются на всё выше
4. Task 9 (API reference) — отдельный блок
5. Tasks 10-12 (обзор агентов, аналитика, телефоны) — обновления на основе предыдущих
6. Task 13 (сквозные правки) — финальная проверка
7. Task 14 (немецкая локализация) — последним

---

Что НЕ делаем

• ❌ Русская локализация
• ❌ SLA документация
• ❌ Outbound calling документация
• ❌ Customer Memory (не реализовано)
• ❌ Технические подробности (модели, провайдеры, Egress, OAuth flow internals)
• ❌ Video Tutorials (контент ещё не создан)
• ❌ LLM endpoints в API reference
• ❌ Roadmap из api-key-capabilities.md