# Каталог ассистентов (packs) — для новичков

> **Pack (пак)** = готовый **ассистент** под профессию или задачу бизнеса (CRM, playbooks, карточки).  
> **PromptHub** = отдельный [каталог промптов](./PROMPTHUB_CATALOG_RU.md) (инструкции для моделей: боты, скрипты, сайты). Не путать с packs.

> Внутри pack: карточки (как мини-CRM), поля, playbooks (сценарии «нажми — получи результат»), disclaimer и инструкции для ИИ.

---

## Как это устроено простыми словами

| Термин | Что это | Пример |
|--------|---------|--------|
| **Pack** | Готовый ассистент | «Ассистент маркетолога» |
| **Record (запись)** | Карточка клиента, пациента, товара… | Карточка «ООО Ромашка» |
| **Playbook** | Сценарий: ИИ делает разбор по вашим данным | «Исследование бренда» |
| **Tenant** | Ваш личный «ящик» данных (изоляция) | Данные не смешиваются с другими пользователями |
| **БД** | SQLite на сервере: `records.db` + файлы на диске | До ~500 МБ файлов на tenant (настраивается) |

**Где хранятся данные:** на вашем ReasonService (локально — на вашем ПК; в prod — на вашем сервере). Это **не** общая облачная база пользователей.

---

## Сколько всего паков

**38 packs** (37 отраслевых + **1 универсальный** `universal-crm`).

### Универсальный (старт для любого бизнеса)

| ID | Название | Для кого |
|----|----------|----------|
| `universal-crm` | Универсальный CRM-ассистент | Любой бизнес с клиентами и лидами, если нет узкого отраслевого пака |

**Что умеет:** клиенты + лиды, OCR документов, сводка перед звонком, черновик письма, план на неделю, разбор переписки.

---

### Flagship (глубокие vertical-first паки)

| ID | Категория | Полноценность | Playbooks |
|----|-----------|---------------|-----------|
| `marketer` | marketing | ★★★★★ CRM брендов, кампании, deep research | 5+ (портрет, каналы, креатив, реклама) |
| `medicine` | health | ★★★★★ Пациенты, приёмы, анализы | lab-review, разборы (не диагноз!) |
| `lawyer` | legal | ★★★★★ Дела, договоры, юрисдикция | contract-review, analysis |
| `accountant` | finance | ★★★★★ Клиенты, документы, налоги РФ | classify-doc, checklist, explain |
| `fitness` | fitness | ★★★★☆ Клиенты, планы тренировок/питания | fitness-plan, planning |
| `support-chat` | support | ★★★★★ FAQ-бот + эскалация человеку | answer, escalation, summary |

Эти паки — **эталон полноты**: свои `recordTypes`, disclaimers EN/RU, playbooks с mode quick/standard/deep.

---

### Маркетплейс (public vertical packs)

Готовые паки с `"visibility": "public"` — видны в [маркетплейсе](/marketplace.html):

| Группа | Паки | Задача |
|--------|------|--------|
| **SMM** | `smm-content-plan`, `smm-multiplatform`, `smm-community` | Контент-планы, мультиплощадки, комьюнити |
| **Sales** | `sales-outreach`, `sales-qualifier`, `sales-negotiation` | Аутрич, квалификация, переговоры |
| **HR** | `hr-jd-master`, `hr-screening`, `hr-onboarding` | Вакансии, скрининг, онбординг |
| **E-commerce** | `ecom-listing`, `ecom-reviews`, `ecom-support` | Карточки товаров, отзывы, поддержка |
| **Real estate** | `realestate-listing`, `realestate-matcher`, `realestate-mortgage-faq` | Объявления, подбор, ипотека FAQ |
| **Restaurant** | `restaurant-menu`, `restaurant-booking`, `restaurant-reviews` | Меню, бронь, отзывы |
| **Construction** | `construct-estimate`, `construct-schedule`, `construct-faq` | Сметы, графики, FAQ |
| **Education** | `edu-tutor`, `edu-quiz`, `edu-explainer` | Репетитор, тесты, объяснения |
| **Tourism** | `tour-itinerary`, `tour-packages`, `tour-visa-faq` | Маршруты, пакеты, виза FAQ |
| **Productivity** | `prod-coach`, `prod-meetings`, `prod-weekly` | Коучинг, встречи, недельный обзор |

**Полнота:** ★★★★☆ — каждый пак закрывает **одну задачу** внутри отрасли (не «всё сразу»). Для полного цикла берите 2–3 пака или соберите свой в [конструкторе](/builder.html).

---

### Специальные

| ID | Примечание |
|----|------------|
| `astrology` | Развлекательно-консультационный; disclaimer обязателен |

---

## Достаточно ли этого для «любого бизнеса»?

### ✅ Покрыто хорошо

- CRM клиентов и лидов (универсальный + sales + marketer)
- Медицина, юристы, бухгалтерия (regulated verticals + disclaimers)
- Поддержка клиентов (support-chat, ecom-support)
- Контент и маркетинг (marketer, SMM-паки)
- HR, недвижимость, рестораны, стройка, туризм, e-commerce

### ⚠️ Пробелы (можно закрыть конструктором из модулей)

| Ниша | Сейчас | Как закрыть |
|------|--------|-------------|
| Автосервис / СТО | Нет отдельного пака | `universal-crm` + preset `crm-client` в builder |
| Страхование | Нет отдельного пака | `accountant` / `finance-docs` preset + свои поля |
| Склад / inventory-heavy retail | Модуль `data-inventory` есть, пака нет | Builder: inventory + support-reply |
| WhatsApp-канал | Только Web + Telegram | W5 integr (webhook) — в плане wave max |

### Модули vs паки

- **55 модулей** в `packs/_catalog/modules.json` — «кирпичики»
- **17 пресетов** в `presets.json` — готовые наборы кирпичиков
- **54 профессии** в `professions.json` — AI-fit фильтр в конструкторе

Подробнее: [MODULES_GUIDE_RU.md](./MODULES_GUIDE_RU.md)

---

## Нагрузки и БД — адекватно ли?

| Параметр | Значение | Комментарий |
|----------|----------|-------------|
| БД записей | SQLite `records.db` per deployment | Tenant изолирован в каждой строке |
| Файлы | `{data}/assistant-files/{tenant}/{recordId}/` | Лимит ~10 МБ/файл, ~500 МБ/tenant |
| OCR | Асинхронно после upload | PDF/image → текст → KB для RAG |
| Параллельные пользователи | Kestrel + per-tenant | Для SMB/local — достаточно; Postgres — отдельная миграция |
| Playbook deep | Browser/API LLM | Тяжёлые задачи — через очередь (см. hang P0 в плане) |

**Вывод:** для целевой аудитории (малый бизнес, частные специалисты, локальный/prod single-server) — **нагрузки адекватны**. Enterprise multi-tenant на миллионы записей — **не цель текущей волны**.

---

## С чего начать новичку

1. Откройте [маркетплейс](/marketplace.html) → **Try** на `universal-crm` или своей отрасли.
2. Создайте **одну карточку клиента** с реальными данными.
3. Запустите playbook **«Сводка по клиенту»** — увидите, как работает контекст.
4. Если нужна своя профессия → [конструктор](/builder.html) + AI-fit по профессии.

---

## Связанные документы

- [MODULES_GUIDE_RU.md](./MODULES_GUIDE_RU.md) — слои модулей
- [SEO_I18N_STRATEGY_RU.md](./SEO_I18N_STRATEGY_RU.md) — язык и поисковый трафик
- [ASSISTANT_GUIDE.md](../ASSISTANT_GUIDE.md) — работа в интерфейсе ассистента
- [PROMPTHUB_CATALOG_RU.md](./PROMPTHUB_CATALOG_RU.md) — полки PromptHub (боты / скрипты / сайты)