# Модули ассистентов — слои и «кирпичики»

> Модули описаны в `packs/_catalog/modules.json`.  
> Пресеты (готовые наборы) — в `presets.json`.  
> Профессии с AI-fit — в `professions.json`.

---

## 8 слоёв (для новичка)

```
DATA      → что храним (клиенты, пациенты, товары, тикеты…)
INTEL     → что умеем анализировать и генерировать
ACCESS    → как чатится (общий чат vs чат по карточке)
CHANNEL   → где общаемся (веб, Telegram)
INTEG     → внешние связи (webhook, MCP)
BEHAVIOR  → тон, guardrails, проактивность
KNOW      → базы знаний / FAQ для RAG
TOOL      → экспорт, планировщик, формы (M9 runtime)
```

**Pack** = выбранные модули + свои поля + playbooks + тексты.

---

## DATA — данные (13 модулей)

| ID | Название | Когда нужен |
|----|----------|-------------|
| `data-client-card` | Карточка клиента | Любой CRM |
| `data-lead` | Лид / заявка | Воронка продаж |
| `data-patient-card` | Пациент | Медицина |
| `data-legal-case` | Юридическое дело | Юристы |
| `data-finance-docs` | Финансовые документы | Бухгалтерия |
| `data-project` | Проект / задача | PM, маркетинг |
| `data-files-ocr` | Файлы + OCR | Скан/PDF → текст |
| `data-inventory` | Склад / номенклатура | Розница, e-com |
| `data-ticket` | Тикет поддержки | Helpdesk |
| `data-employee` | Сотрудник | HR |
| `data-asset` | Актив / оборудование | СТО, IT, стройка |
| `data-contract` | Договор | B2B, юристы |

**БД:** все записи → SQLite `records`, файлы → диск + `record_files`.

---

## INTEL — интеллект (16 модулей)

| ID | Название | Пример использования |
|----|----------|----------------------|
| `intel-research` | Исследование | Портрет бренда, рынок |
| `intel-analysis` | Анализ | SWOT, разбор ситуации |
| `intel-copywriting` | Тексты | Посты, письма, КП |
| `intel-planning` | Планирование | План на неделю |
| `intel-summary` | Саммари | Кратко по переписке |
| `intel-doc-review` | Разбор документа | Договор, акт |
| `intel-lab-review` | Разбор анализов | Медицина |
| `intel-contract-review` | Договор | Юристы |
| `intel-finance-analysis` | Финансы | Бухгалтерия |
| `intel-fitness-plan` | План тренировок | Фитнес |
| `intel-support-reply` | Ответ поддержки | FAQ-бот |
| `intel-sentiment` | Тональность | Отзывы |
| `intel-comparison` | Сравнение | Два файла |
| `intel-translation` | Перевод | RU↔EN |
| `intel-meeting-notes` | Протокол встречи | PM |
| `intel-risk-assessment` | Риски | Юристы, стройка |
| `intel-vision-inspect` | Осмотр по фото | Дефекты, визуал |

---

## ACCESS + CHANNEL + INTEG

| Слой | Модули | Зачем |
|------|--------|-------|
| ACCESS | `access-chat-general`, `access-chat-record` | Общий чат ≠ чат «внутри карточки клиента» |
| CHANNEL | `channel-web`, `channel-telegram` | Где пользователь работает |
| INTEG | `integ-webhook`, `integ-mcp` | CRM, n8n, Cursor MCP |

---

## BEHAVIOR + KNOW + TOOL

**Behavior:** formal / friendly / concise / proactive / guardrails / multilingual / socratic.

**Knowledge (KNOW):** faq, product, policy, onboarding, troubleshooting, industry — для RAG.

**Tools (TOOL):** export PDF/CSV, scheduler, docgen, forms, dashboard, calendar-sync, platform browser/docs/sql/mcp — включаются флагами `VERITHINK_RUNTIME_*`.

---

## 17 пресетов — быстрый выбор

| Preset | Для кого |
|--------|----------|
| `crm-client` | Универсальный CRM |
| `records-medical` | Врач / клиника |
| `support-bot` | Поддержка + TG |
| `creative-marketing` | Маркетинг |
| `finance-docs` | Бухгалтер / финансы |
| `legal-cases` | Юрист |
| `fitness-coach` | Тренер |
| `hr-recruiting` | HR |
| `sales-outreach` | B2B продажи |
| `education` | Репетитор / курсы |
| `ecommerce` | Интернет-магазин |
| `smm` | SMM |
| `real-estate` | Недвижимость |
| `restaurant-beauty` | Ресторан / бьюти |
| `productivity` | PM / продуктивность |
| `tourism` | Туризм |
| `construction` | Строительство |

В конструкторе: выбрали профессию → AI-fit → preset → можно добавить/убрать модули.

---

## Хватает ли модулей для любого бизнеса?

**Да для 90% SMB-сценариев:** клиент + лид + файлы + intel + канал + KB.

**Не хватает «из коробки» (wave max backlog):**

- WhatsApp / VK как channel-модули
- Глубокая интеграция 1С / МойСклад (только webhook stub)
- Произвольные SQL к внешним БД (есть `tool-platform-sql`, но ops-only)

Новые vertical packs добавляются **комбинацией существующих модулей**, не переписыванием движка.