# 22. Дорожная карта бизнес-инструментов

🔵 Каких инструментов не хватает платформе для типовых бизнес-сценариев
(CRM, платежи, учёт, каналы связи) и в каком порядке их внедрять.

Анализ текущего покрытия — в справочнике инструментов
[05-tools-reference](05-tools-reference.md) и каналов
[19-widget-and-channels](19-widget-and-channels.md).

## Фаза 0 — Расширение `site_tool` (фундамент)

`site_tool` уже полноценный REST-клиент (все методы, `json`/`form`/`multipart`,
заголовки с доступом к `env`, общий профиль `fetch.extends`, двухшаговая
токен-авторизация, ретраи, пагинация). Поэтому новый generic-движок не нужен —
достаточно двух опций:

| Что | Зачем | Статус |
|---|---|---|
| `fetch.oauth2` — code-flow + refresh-ротация + кэширование токена | Bitrix24 (app), amoCRM, Google | готово |
| `fetch.sign` — HMAC-SHA256 (ключ из env, каноническое тело) | ЮKassa, Тинькофф, Сбер | готово |

## Фаза 1 — Приоритетные интеграции (P0)

| Инструмент | Реализация | Статус |
|---|---|---|
| Bitrix24 (сделки/лиды/задачи/чат) | `site_tool` (webhook-режим) + outbound-webhook на `inbound` | план |
| amoCRM (лиды, воронки) | `site_tool` + `fetch.oauth2` | план |
| ЮKassa / Тинькофф (оплата, статус) | `site_tool` + `fetch.sign` + проверка коллбэка | план |
| Генерация счёта/УПД (PDF) | `office_tool` (template fill) — уже есть | готово |
| PostgreSQL / MySQL | нативный `sql_tool` (аналог `duckdb_tool`) | готово |
| Веб-поиск (Yandex/SerpApi/Brave) | `site_tool` + ключ из env | план |
| Яндекс.Карты (геокодинг/маршруты РФ) | `site_tool` + расширение `geo_tool` | план |

## Фаза 2 — Каналы связи (P1)

| Инструмент | Реализация | Статус |
|---|---|---|
| WhatsApp Business API (WABA) | нативный канал (webhook + `messages`) | план |
| SMS (sms.ru / SMS Aero) | `site_tool` + тонкая обёртка | план |
| Push (FCM/APNs) для Android-клиента | нативный канал | план |

## Фаза 3 — Данные и ИИ (P2)

| Инструмент | Реализация | Статус |
|---|---|---|
| RAG / векторный поиск по корп. документам | нативный `vector_tool` (подключаемый store) | план |
| OCR (сканы, фото документов) | нативный / `shell_tool` (tesseract / внешний API) | план |
| Vision (анализ изображений) | мультимодальный `http_fetch` + провайдер | план |
| Календарь (Google/Outlook) | `site_tool` + `fetch.oauth2` | план |

## Фаза 4 — Инфраструктура (P3)

| Инструмент | Реализация | Статус |
|---|---|---|
| S3/MinIO, FTP/SFTP | нативный `storage_tool` | план |
| Headless-браузер (Chromium/CDP) для JS-сайтов | нативный `browser_tool` (шаги + JS в странице) | готово |
| Notion / Jira / Slack | `site_tool` | план |

## Критерии порядка

1. **Фаза 0** — снимает ключевые блокеры (`oauth2`, подпись) и разблокирует
   почти все интеграции без новых движков.
2. **Фаза 1** — главные бизнес-сценарии РФ (CRM + платежи + учёт).
3. **Фаза 2** — расширение охвата пользователей (WhatsApp — крупнейший канал
   после TG/VK).
4. **Фазы 3–4** — по мере появления клиентских задач.

## Старт

1. `site_tool`: `fetch.oauth2` + `fetch.sign` + `sql_tool` (Postgres).
2. Bitrix24 + amoCRM + ЮKassa поверх них.
3. Пилотный бизнес-агент «продажи/поддержка», закрытый насквозь.
