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

Точное соответствие каждого раздела пульса коннектору, который его даёт. **Запускайте все вызовы одним параллельным пакетом** — не тяните последовательно. Под РФ-сервисы публичных MCP-серверов почти нет, поэтому большинство работает через ручную выгрузку (CSV/Excel) или собственный коннектор — `url` в `.mcp.json` стоит пустым плейсхолдером.

## Деньги и финансы (`~~бухгалтерия`)

Примеры: 1С:Бухгалтерия, МойСклад, Контур.Эльба, СБИС.

| Метрика | Откуда | Примечания |
|---|---|---|
| Остаток на счетах | Денежный поток из бухгалтерии | Текущий остаток; покажите дельту к прошлой неделе, если есть |
| Выручка с начала месяца | ОПиУ | Текущий месяц против прошлого |
| Открытая дебиторка | Список счетов | Фильтр: открытые/неоплаченные |
| Возраст дебиторки | Список счетов | Группировка по дням с момента срока: 0–30, 31–60, 61+ |
| Просроченные счета | Список счетов | Фильтр: срок > 30 дней назад; имя контрагента + сумма + дни просрочки |

**Обработка состояний:** если коннектор бухгалтерии вернул ошибку, пустой ответ или состояние «не подключён», пометьте весь раздел «Деньги» как «н/д — бухгалтерия недоступна» и продолжайте. Не повторяйте.

## Выручка и продажи (`~~платежи`)

Примеры: ЮKassa, Тинькофф Касса, СБП, Сбер Эквайринг, выписка банк-клиента.

| Метрика | Откуда | Примечания |
|---|---|---|
| Поступления за 7 дней | Операции платёжного сервиса | Сумма завершённых поступлений в окне |
| Тренд продаж | Операции | Эти 7 дней против предыдущих 7; дельта |
| Неуспешные / зависшие операции | Операции | Пометить любые > 20 000 ₽ |
| Поступления второго сервиса | Если подключён | То же — сумма + тренд |

Используйте любые доступные платёжные коннекторы. Если подключено несколько — отчёт по совокупности и по источникам.

> Если плательщик НДС — учитывайте, что поступления приходят с НДС внутри суммы; для тренда выручки это не критично, но при сверке с ОПиУ держите это в уме.

## Воронка (`~~crm`)

Примеры: Битрикс24, amoCRM, RetailCRM.

| Метрика | Откуда | Примечания |
|---|---|---|
| Воронка по этапам | Сделки CRM | Группировка по этапу; сумма |
| Сделки закрыты за неделю | Сделки CRM | Фильтр: дата закрытия в окне, этап «успешно закрыта» |
| Остывшие сделки | Сделки CRM | Фильтр: последняя активность > 7 дней назад, открытый этап |
| Новые лиды за неделю | Сделки CRM | Фильтр: дата создания в окне |
| Зависшие/сдвинутые сделки | Сделки CRM | Открытые сделки с датой закрытия в прошлом |

## Обязательства (`~~календарь`)

Примеры: Яндекс Календарь, календарь Битрикс24.

| Метрика | Откуда | Примечания |
|---|---|---|
| Ключевое на этой неделе | События календаря | Фильтр: текущая неделя; встречи с клиентами, дедлайны, важные брони |
| Ближайшие 7 дней | События календаря | Взгляд вперёд; выделить всё с внешними сторонами |

## Список наблюдения (`~~почта`)

Примеры: Яндекс 360, Mail.ru для бизнеса, VK WorkMail.

| Метрика | Откуда | Примечания |
|---|---|---|
| Срочные цепочки | Поиск по почте | Запрос: важные/помеченные за 7 дней |
| Эскалации клиентов | Поиск по почте | Слова: «эскалация», «жалоба», «отказ», «возврат», «срочно» за 7 дней |
| Срочные запросы | Поиск по почте | Непрочитанные + слова «дедлайн», «срочно», «сегодня» |

**Фолбэк почты:** если вызов падает (авторизация бывает нестабильной), тихо пропустите «Список наблюдения» и добавьте «Почта недоступна» в приложение. Не выводите ошибку в теле пульса.

## Внутренние сигналы (`~~мессенджер`)

Примеры: Telegram, VK Teams, Пачка, Compass.

| Метрика | Откуда | Примечания |
|---|---|---|
| Срочные ветки | Поиск по мессенджеру | Ветки с упоминаниями или сигналами срочности в релевантных каналах |
| Пункты к действию | Поиск по мессенджеру | Сообщения, адресованные собственнику или помеченные к исполнению |

## Поддержка клиентов (если подключена)

| Метрика | Откуда | Примечания |
|---|---|---|
| Открытые тикеты | Система поддержки | Счёт открытых; пометить > 48ч без решения |
| Эскалации | Система поддержки | Фильтр: приоритет или метка эскалации |

Включать, только если коннектор есть; иначе раздел опустить целиком.

## Скан рисков

Запускайте вместе с метриками — не ждите их завершения.

| Риск | Источник | Условие срабатывания |
|---|---|---|
| Просроченная дебиторка | `~~бухгалтерия` | срок > 30 дней назад, не оплачено |
| Зависшие сделки | `~~crm` | открытая сделка, без активности 7+ дней |
| Сдвинутые сделки | `~~crm` | открытая сделка, дата закрытия в прошлом |
| Срочные цепочки в почте | `~~почта` | важные или слова-эскалации |
| Неуспешные платежи | `~~платежи` | неуспешные или зависшие > 20 000 ₽ |

## Параллелизация

Всё перечисленное должно стрелять одним пакетом вызовов. Полный пульс — обычно 8–15 параллельных вызовов. Если один падает, остальные идут нормально, а упавший источник попадает в «Источники недоступны» внизу пульса.

# Ловушки

Известные режимы сбоя скилла business-pulse. Пары «хорошо / плохо».

---

## Ловушка: бухгалтерия вернула неожиданное состояние

**Почему важно:** учётная система может вернуть пустой результат, состояние «синхронизация идёт» или ошибку авторизации без жёсткого исключения. Если принять молчание за «нет данных», пульс тихо пропустит раздел «Деньги», не сказав собственнику — и тот решит, что у его бизнеса нет данных в учёте.

### ✗ Плохо

```
Claude: [бухгалтерия вернула пустой ответ]
        → тихо пропускает раздел «Деньги»
        → пульс без данных по деньгам; собственник думает, что учёт не подключён
```

Собственник 10 минут переподключает учёт, прежде чем поймёт, что он всегда был подключён — просто в переходном состоянии.

### ✓ Хорошо

```
Claude: [бухгалтерия вернула пустой ответ или ошибку]
        → заголовок «Деньги» на месте с пометкой: «н/д — бухгалтерия недоступна (ошибка синхронизации или нужна авторизация)»
        → «Источники недоступны: бухгалтерия — пустой ответ» в приложении
```

Собственник видит пробел явно и сам решает, переподключать или работать с частичным пульсом.

---

## Ловушка: сбой авторизации почты посреди пульса

**Почему важно:** авторизация почтовых коннекторов бывает нестабильной. Сырая ошибка авторизации посреди пульса выглядит как поломка и подрывает доверие к скиллу.

### ✗ Плохо

```
Claude: [ошибка авторизации почты при сборке]
        → «Ошибка: авторизация почты не удалась. Авторизуйтесь заново.»
        → вывод пульса останавливается или показывает сырую ошибку в «Списке наблюдения»
```

Собственник видит сломанный инструмент, а не полезный бриф.

### ✓ Хорошо

```
Claude: [ошибка авторизации почты]
        → продолжает пульс без раздела «Список наблюдения»
        → приложение: «Почта — ошибка авторизации; Список наблюдения недоступен в этом запуске»
        → остальные разделы не затронуты
```

Пульс всё равно даёт ценность. Собственник информирован, а не встревожен.

---

## Ловушка: спрашивать разрешения перед тем, как тянуть данные

**Почему важно:** главная ценность скилла — делать работу без переспросов. Собственник, вызвавший пульс, уже неявно одобрил выгрузку. Вопрос «проверить бухгалтерию?» убивает смысл и подрывает доверие к скиллу как к автономному помощнику.

### ✗ Плохо

```
Собственник: «введи в курс по бизнесу»
Claude: «Проверить остаток в бухгалтерии? И можно посмотреть воронку в CRM?»
```

Ещё три круга переписки до первого полезного результата.

### ✓ Хорошо

```
Собственник: «введи в курс по бизнесу»
Claude: [сразу запускает все параллельные вызовы]
        → выдаёт пульс одним ответом
```

---

## Ловушка: отправка в мессенджер требует явного подтверждения

**Почему важно:** отправка в мессенджер постит в каналы, которые видят другие люди. Автоотправка без подтверждения может поставить собственника в неловкое положение или заспамить команду.

### ✗ Плохо

```
Claude: [в конце пульса]
        «Отправил это в общий канал.»
```

Собственник не просил отправку; теперь вся команда видит финансовые данные.

### ✓ Хорошо

```
Claude: [в конце пульса]
        «Отправить это в мессенджер? Если да — в какой канал?»
```

Отправка происходит только при конкретном «да + название канала» от собственника. Никогда не предполагайте.

# Шаблон вывода

Это точная структура, которой следует каждый пульс. Не меняйте порядок разделов. Опускайте раздел, только если его коннектор не вернул данных — никогда не оставляйте пустой заголовок.

Переменные в `{{двойных скобках}}` — плейсхолдеры, замените вычисленными значениями. Стрелки: ▲ вверх, ▼ вниз, ▬ ровно (<1% изменения). Всегда показывайте значение дельты после стрелки. Суммы в рублях, формат `1 234,56 ₽`. Даты ДД.ММ.ГГГГ.

---

```markdown
# Пульс бизнеса — {{ДД.ММ.ГГГГ}}

**Итог: {{🟢|🟡|🔴}} {{строка статуса, например «Деньги в порядке, один просроченный счёт требует внимания.»}}**

## TL;DR

- {{Самый важный факт с числом, например «Остаток на счёте 840 000 ₽, −60 000 ₽ н/н — прошли два крупных платежа поставщикам.»}}
- {{Второй по важности, например «34 000 ₽ от „Ромашки“ просрочены на 47 дней — без ответа с 12.03.»}}
- {{Третий, например «Воронка 1 280 000 ₽ взвешенно; две сделки остыли за неделю.»}}

---

## 💰 Деньги и финансы — {{🟢|🟡|🔴}}

- **Остаток на счетах**: {{BALANCE}} ₽ ({{▲|▼|▬}} {{DELTA}} ₽ н/н)
- **Выручка с начала месяца**: {{MTD}} ₽ против {{PRIOR_MTD}} ₽ в прошлом месяце ({{▲|▼|▬}} {{PCT}}%)
- **Открытая дебиторка**: {{AR_TOTAL}} ₽ по {{N}} открытым счетам

**Возраст дебиторки**
- 0–30 дней: {{AR_0_30}} ₽
- 31–60 дней: {{AR_31_60}} ₽ {{🟡 если не ноль}}
- 61+ дней: {{AR_61}} ₽ {{🔴 если не ноль}}

**Просрочка > 30 дней**
- {{контрагент}} — {{сумма}} ₽ ({{дни}} дней просрочки)
- {{контрагент}} — {{сумма}} ₽ ({{дни}} дней)

---

## 📈 Выручка и продажи — {{🟢|🟡|🔴}}

- **Поступления за 7 дней**: {{SETTLEMENTS}} ₽ ({{▲|▼|▬}} {{PCT}}% против предыдущих 7 дней)
- **По источникам**: {{сервис 1}} {{TOTAL}} ₽ | {{сервис 2}} {{TOTAL}} ₽ {{опустить, если не подключён}}

**Необычные операции**
- {{сумма}} ₽ — {{контрагент}} — {{статус: неуспешная/зависшая/крупная}}
- {{или «Необычных операций за неделю нет.»}}

---

## 🔮 Воронка — {{🟢|🟡|🔴}}

- **Взвешенная воронка**: {{WEIGHTED}} ₽ ({{▲|▼|▬}} {{DELTA}} ₽ н/н)
- **Покрытие цели**: {{RATIO}}× месячной цели {{🟢|🟡|🔴}}
- **Успешно закрыто за неделю**: {{CW}} ₽ по {{N}} сделкам
- **Новых сделок создано**: {{N}} ({{TOTAL}} ₽)

**Сделки, требующие внимания**
- {{название сделки}} — {{этап}} — {{почему: остыла / сдвинулась / зависла}}
- {{или «Сделок без флагов за неделю нет.»}}

---

## 📅 Эта неделя

- {{Встреча/дедлайн — внешняя сторона, почему важно}}
- {{Встреча/дедлайн}}
- {{Встреча/дедлайн}}
{{3–5 пунктов максимум. Опустить внутренний шум календаря.}}

---

## ✉️ Список наблюдения

- {{отправитель / источник}} — {{строка о том, что требует внимания}}
- {{отправитель / источник}} — {{строка}}
{{Или: «Срочных цепочек не обнаружено.» — включить явно, чтобы собственник знал, что проверка прошла.}}

---

## ⚠️ Приоритет №1

{{Одна конкретная вещь на сегодня. Имена, суммы, дедлайны.
Не «проверить деньги» — а «Счёт на 42 000 ₽ от „Ромашки“ просрочен на 23 дня.
Позвонить Сергею Чену по +7 915 555-01-92 сегодня.»}}

---

## Приложение

**Окно**: {{диапазон дат}}

**Источники с данными**: {{список коннекторов, вернувших данные}}

**Источники недоступны**: {{список с причиной, например «Почта — ошибка авторизации» или «Поддержка — не подключена»}}

**Пороги**: {{отметить пороги, которые ещё на дефолтах}}
```

---

## Правила форматирования

1. **Суммы**: `840 тыс ₽` для тысяч, `1,2 млн ₽` для миллионов в сжатых местах; полная форма `1 234,56 ₽` в таблицах. Без лишних копеек, где не нужны.
2. **Проценты**: один знак для трендов (например, «▲ 8,3%»), целые в остальных местах.
3. **Даты**: ДД.ММ.ГГГГ в тексте и метаданных.
4. **Отступ у стрелки**: `▲ 2 тыс ₽`, не `▲2 тыс ₽`.
5. **Длина**: цель — одна страница. Максимум две. Если раздел разрастается — ужмите текст.

# Пороги

Пороги красный/жёлтый/зелёный для каждого раздела пульса. Это дефолты для малого бизнеса — правьте под реальные цели и план собственника.

Любой порог с пометкой `# TODO: уточнить у собственника` должен дать примечание в начале первого пульса, чтобы собственник знал, что нужно настроить.

---

## Деньги и финансы

**Денежная подушка (на сколько хватит)**
- 🟢 ≥ 6 месяцев  # TODO: уточнить у собственника
- 🟡 3–6 месяцев
- 🔴 < 3 месяцев

**Тренд выручки (м/м)**
- 🟢 ≥ 0% (ровно или рост)
- 🟡 −5% … 0%
- 🔴 < −5%

**Возраст дебиторки**
- 🟢 Нет счетов старше 31 дня
- 🟡 Любой счёт с просрочкой 31–60 дней
- 🔴 Любой счёт с просрочкой 60+ дней ИЛИ корзина 61+ > 10% от всей дебиторки

**Порог просрочки**: любой отдельный счёт с просрочкой > 30 дней называется в пульсе явно — не просто считается.

---

## Выручка и продажи

**Тренд продаж за 7 дней (против предыдущих 7)**
- 🟢 ≥ 0%
- 🟡 −10% … 0%
- 🔴 < −10%

**Неуспешные операции**
- 🟡 Любая неуспешная операция > 20 000 ₽
- 🔴 Любая неуспешная операция > 100 000 ₽ или 3+ сбоя за неделю

---

## Воронка

**Покрытие воронки** (взвешенная воронка ÷ месячная цель по выручке)  # TODO: уточнить цель у собственника
- 🟢 ≥ 2× месячной цели
- 🟡 1–2×
- 🔴 < 1×

**Зависшая сделка**: без активности 7+ дней → флаг  # TODO: собственник может предпочесть 14 дней
**Сдвинутая сделка**: открытая сделка с датой закрытия в прошлом → всегда флаг

---

## Список наблюдения

Числовых порогов нет — любая эскалация или жалоба в почте/мессенджере выносится. Серьёзность контекстна; выносите и давайте собственнику решить.

---

## Сводный статус

Общий статус пульса — худший из статусов разделов. Перекрытие: если хоть один риск называет конкретного контрагента с суммой и дедлайном в пределах 7 дней — сводный статус 🔴 независимо от цветов разделов.

---

## Когда настраивать

Пересмотрите пороги после 4 недель использования. Дефолты — консервативные стартовые точки; здоровый бизнес будет ощущаться вечно 🟢. Затягивайте их так, чтобы они отражали, где собственник реально хочет действовать.