# Чек-лист очистки

Поля, которые скилл `crm-maintenance` проверяет при очистке сделки, плюс доказательства для пометки каждого. Запускается, когда собственник говорит «почисти CRM» или «актуальна ли эта сделка» применительно к конкретной сделке.

Проходи по каждому пункту. Показывай находки как список на ревью; пиши только то, что собственник одобрил.

## 1. Дата последней активности

**Проверь:** дата последней активности сделки старше, чем самое свежее реальное взаимодействие (письмо или встреча) с её связанными контактами?

**Доказательство для пометки:** переписка или событие календаря за последние 14 дней с одним из контактов сделки, новее даты последней активности.

**Предлагаемое действие:** предложи занести недостающую активность. Не помечай саму сделку; занесение активности обновит дату последней активности автоматически.

## 2. Поле «следующий шаг»

**Проверь:** отражает ли текущий «следующий шаг» то, о чём договорились в последнем письме или на встрече?

**Доказательство для пометки:** поле говорит «отправить КП», а последующее письмо показывает, что КП отправлено. Или поле пустое, а недавняя встреча явно задала следующее действие.

**Предлагаемое действие:** предложи новое значение (или пусто, если шаг выполнен). Покажи текущее → предлагаемое рядом.

## 3. Стадия сделки

**Проверь:** говорят ли недавние взаимодействия о том, что сделка сменила стадию — например, КП отправлено, договор подписан, проиграли конкуренту?

**Доказательство для пометки:** явные формулировки в письме/заметках встречи вроде «мы движемся дальше», «мы подписали», «мы выбрали [конкурента]», или изменение ритма встреч.

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

## 4. Дата закрытия

**Проверь:** ссылалось ли последнее письмо/встреча на пересмотренный срок, который конфликтует с текущей датой закрытия?

**Доказательство для пометки:** фразы вроде «сдвигаем на 3 кв.», «подпишем до конца месяца» или «откладываем до следующего квартала».

**Предлагаемое действие:** предложи обновлённую дату (формат ДД.ММ.ГГГГ). Покажи текущее → предлагаемое.

## 5. Сумма

**Проверь:** упоминало ли последнее письмо/встреча другой размер сделки?

**Доказательство для пометки:** явно пересмотренная цена в письме, расширенный объём на встрече или сокращённый объём, который клиент принял.

**Предлагаемое действие:** предложи обновлённую сумму в ₽. Покажи текущее → предлагаемое.

## 6. Связанные контакты

**Проверь:** есть ли люди в недавних письмах или на встречах с контактами сделки, которые сами не связаны со сделкой?

**Доказательство для пометки:** копия в письме или участник встречи, чей домен совпадает с доменом существующего контакта сделки, но кого нет в сделке.

**Предлагаемое действие:** предложи добавить недостающий контакт(ы) в сделку. Сначала создай контакт в CRM, если его ещё нет.

## 7. Гигиена примечаний

**Проверь:** есть ли примечания или активности старше 90 дней, которые явно противоречат текущему состоянию сделки?

**Доказательство для пометки:** примечание «клиент потерян» на сделке всё ещё в открытой стадии, или примечание с устаревшей суммой договора.

**Предлагаемое действие:** добавь новое примечание, проясняющее текущее состояние — **никогда не редактируй и не удаляй** старое. Дописывай, не переписывай историю.

## Формат вывода

Показывай находки нумерованным списком, каждый пункт с:
- что помечено
- доказательство (тема письма + дата, или название встречи + дата)
- предлагаемое действие (или «только пометить» для смены стадии)

Затем спроси одобрение по пунктам или массово. Пиши только одобренное.

# Краевые случаи

Случаи, где скилл `crm-maintenance` с наибольшей вероятностью породит плохие данные в CRM. Каждый пункт — по паттерну «хорошо / плохо».

---

## Краевой случай: создание дубля контакта, когда email уже есть в CRM в другом регистре

**Почему важно:** CRM дедуплицирует по точному совпадению email. `Svetlana.Lisina@acme.ru` и `svetlana.lisina@acme.ru` считаются разными, и собственник, уже создавший один контакт, получит тихий дубль. Это убивает доверие к скиллу.

### ✗ Плохо

> Искал в CRM `Svetlana.Lisina@acme.ru` — не найдено. Создаю новый контакт: Светлана Лисина (Svetlana.Lisina@acme.ru).

Новый контакт создан; у существующего `svetlana.lisina@acme.ru` теперь дубль.

### ✓ Хорошо

> Искал в CRM `svetlana.lisina@acme.ru` (без учёта регистра) — не найдено. Создаю новый контакт: Светлана Лисина (svetlana.lisina@acme.ru). Объявляю перед записью.

Всегда приводи email к нижнему регистру перед поиском. Объявляй о создании, чтобы собственник поймал промахи.

---

## Краевой случай: запись всей переписки как тела активности

**Почему важно:** активности в CRM — это поверхность сигналов для быстрого просмотра, а не архив-стенограмма. Ветка из 12 сообщений, вставленная в тело активности, бесполезна; сводка в три предложения о том, о чём договорились, — действенна.

### ✗ Плохо

> **Тело активности:**
> *От: Светлана Лисина — чт 09.04…*
> *Здравствуйте! Возвращаюсь к нашему звонку, вот спецификации, которые мы обсуждали…*
> *[ещё 1200 слов]*

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

### ✓ Хорошо

> **Тело активности:** Светлана подтвердила объём на расширение 2 кв. — 50 рабочих мест, 1 500 000 ₽, старт 01.06. Подписанный договор пришлёт до пятницы. Открытых вопросов нет.

Сводка называет решения, цифры и следующий шаг.

---

## Краевой случай: автосоздание сделки, когда правильную не получается определить

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

### ✗ Плохо

> Открытой сделки для Светланы Лисиной в Акме не найдено. Создаю новую сделку «Акме — новая возможность» и заношу к ней звонок.

Теперь две сделки по Акме, и собственник не понимает, какая настоящая.

### ✓ Хорошо

> Открытой сделки для Светланы Лисиной в Акме не найдено. К какой сделке занести? Варианты: (1) Акме, расширение 2 кв. (выиграна в феврале), (2) Акме, продление 2027 (открыта). Или пока пропустить занесение?

Спрашивай. Никогда не создавай сделку за собственника.

---

## Краевой случай: предложение сменить стадию сделки по формулировке из письма

**Почему важно:** «мы движемся дальше» в письме не всегда значит «перевести в выиграна». Клиенты так говорят, когда движутся дальше с оценкой или с закупочной процедурой. У собственника есть контекст, которого нет у скилла. Авто-продвижение стадии разрушительно для воронки.

### ✗ Плохо

> Письмо от Светланы говорит «мы движемся дальше». Предлагаю стадию → Выиграна. Пишу сейчас.

### ✓ Хорошо

> Помечаю: письмо от Светланы от 18.04 («мы движемся дальше с оценкой») может означать смену стадии. Текущая стадия — «КП отправлено». Перевести дальше? Без вашего явного согласия стадию не меняю.

Покажи доказательство, удержи запись.

---

## Краевой случай: затирание заданного собственником «следующего шага» при очистке

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

### ✗ Плохо

> «Следующий шаг» сейчас «ждать юр. проверку». Последнее письмо от Светланы говорит «давайте назначим разбор условий». Обновляю «следующий шаг» на «назначить разбор условий».

### ✓ Хорошо

> «Следующий шаг» сейчас «ждать юр. проверку» (задано вами 3 дня назад). Письмо от Светланы от 19.04 предполагает, что нужен ещё и разбор условий. Дописать или заменить? Текущее → предлагаемое: «ждать юр. проверку» → «ждать юр. проверку; затем назначить разбор условий». Одобряете?

Покажи текущее значение, предложи изменение явно, жди одобрения.

# Поля CRM и типы активностей

Конкретные объекты, свойства и типы активностей CRM, из которых скилл `crm-maintenance` читает и в которые пишет. В скоупе только перечисленные здесь поля — всё остальное в CRM остаётся нетронутым.

Имена полей даны как ориентир для Битрикс24/amoCRM — в вашей системе они могут называться чуть иначе; сопоставьте по смыслу.

## Контакты — запись

| Поле (смысл) | Битрикс24 / amoCRM | Использование |
|---|---|---|
| Email | `EMAIL` | Основной идентификатор для поиска + дедупа. Всегда задаётся при создании. |
| Имя | `NAME` | Из подписи письма или приглашения календаря, если доступно. Оставь пустым, если неизвестно. |
| Фамилия | `LAST_NAME` | Из подписи письма или приглашения календаря, если доступно. Оставь пустым, если неизвестно. |
| Телефон | `PHONE` | Из подписи письма, если доступно. |
| Компания | `COMPANY_TITLE` | Из домена email в подписи или организации в календаре, если доступно. |

Не пиши никакие другие свойства контакта. Ответственный, стадия воронки и источник лида — поля, которыми управляет собственник; никогда не перезаписывай.

## Контакты — чтение (для поиска)

| Поле (смысл) | Использование |
|---|---|
| Email | Ключ поиска. Точное совпадение без учёта регистра. |
| Имя · Фамилия · Компания | Показываются собственнику при разрешении неоднозначности. |
| ID объекта | Используется для связывания со сделками и активностями. |

## Сделки — чтение (все пути очистки + поиска)

| Поле (смысл) | Битрикс24 / amoCRM | Использование |
|---|---|---|
| Название сделки | `TITLE` | Показывается собственнику; используется для нечёткого совпадения с темой письма/встречи |
| Стадия сделки | `STAGE_ID` / статус | Только чтение при очистке — помечай расхождения, никогда не меняй |
| Сумма | `OPPORTUNITY` / бюджет (₽) | Чтение при очистке; помечай, если недавнее письмо/встреча подразумевает изменение |
| Дата закрытия | `CLOSEDATE` / дата | Чтение при очистке; помечай, если устарела (формат ДД.ММ.ГГГГ) |
| Следующий шаг | поле «следующий шаг» / задача | Чтение + предложение правок при очистке |
| Ответственный | `ASSIGNED_BY_ID` | Показывается собственнику; никогда не меняется |
| Дата последней активности | `LAST_ACTIVITY` | Используется для определения зависших сделок |
| Связанные контакты | привязки контактов | Используются, чтобы определить, кто из участников недавних писем/встреч есть в сделке |

## Сделки — запись (только путь очистки, с одобрением)

| Поле (смысл) | Правило |
|---|---|
| Следующий шаг | Предлагай правки; пиши только с явного одобрения собственника |
| Дата закрытия | Предлагай правки; пиши только с явного одобрения собственника |
| Сумма (₽) | Предлагай правки; пиши только с явного одобрения собственника |
| Привязка контакта | Предлагай добавить недостающих участников сделки; пиши только с одобрения |

**Никогда не пиши** стадию сделки, воронку, ответственного или любое пользовательское поле при очистке. Ими управляет собственник.

## Активности — запись

| Тип активности | Используется | Задаваемые поля |
|---|---|---|
| Письмо (Email) | Путь письма | Тема (тема переписки), тело (сводка, не вся переписка), метка времени (время последнего сообщения), связанные контакт(ы) + сделка |
| Звонок (Call) | Путь звонка | Заголовок (название события), тело (сводка), длительность (из календаря), метка времени (начало события), связанные контакт(ы) + сделка |
| Примечание (Note) | Путь очистки | Тело примечания (когда помечаешь что-то на будущий разбор, что не ложится в правку поля) |

Используй стандартный словарь активностей вашей CRM. Не выдумывай пользовательские типы активностей.

## Правила связывания

- Каждая активность должна связываться со сделкой И минимум с одним контактом.
- Если контакт создан на лету при занесении активности, свяжи его со сделкой в той же операции, чтобы активность отображалась и в ленте контакта, и в ленте сделки.
- Не связывай контакт со сделкой в потоке занесения активности, если контакт реально не участвовал в этой переписке или встрече.