Завершить аудит и подготовить AI Lead Processor к публикации

docs/implementation_plan.md

@@ -1,29 +1,25 @@
-# AI Lead Processor · план пилотного запуска
+# AI Lead Processor · план пилота
 
-**Проблема бизнеса.** Менеджер ремонтной компании читает каждое письмо, определяет срочность и переносит сведения в журнал. Пока он отвечает на вопрос о цене, в очереди может ждать сообщение о протечке.
+**Проблема.** В сервисе бытовой техники менеджер вручную разбирает письма и заполняет журнал. Сообщение о протечке может ждать, пока сотрудник отвечает на вопрос о цене.
 
-**Предлагаемое решение.** Локальная форма готовит категорию, объяснение и черновик на русском языке. Менеджер отвечает за итоговую категорию, обещания клиенту и отправку сообщения.
+**Решение и порядок работы.** Менеджер переносит текст в форму. Сервис предлагает приоритет, объяснение и черновик. Менеджер исправляет результат, подтверждает запись в Excel и сам отправляет ответ. Для спама достаточно проверить категорию.
 
-**Как будет работать процесс.** Менеджер вставляет текст, проверяет выделенный приоритет и при необходимости правит ответ. После подтверждения в Excel появляется запись. Для спама черновик пуст. Сбой сервиса возвращает менеджера к обычной обработке письма.
+**Предполагаемый эффект.** При 120 заявках в неделю ручная обработка по 4 минуты занимает 8 часов. Если с проверкой черновика достаточно 1,5 минуты, высвобождается 5 часов в неделю, или 21,65 часа за 4,33 недели. При 500 ₽/ч этот ресурс оценивается в 2 500 ₽ в неделю.
 
-**Предполагаемый экономический эффект.** Иллюстративные допущения составляют 120 заявок в неделю, 4 минуты вручную и 1,5 минуты с проверкой черновика. Занятость снижается с 8 до 3 часов в неделю. При 500 ₽/ч высвобождается ресурс стоимостью 2 500 ₽ в неделю, или 10 825 ₽ за 4,33 недели.
+**Эксплуатация.** При 600 входных и 250 выходных токенах на заявку расходы на API составят около $0,078 в неделю. При условных 90 ₽/$ оценка времени за вычетом API составит 2 493 ₽ в неделю. Все числа иллюстративны. Настройка, обучение и сопровождение требуют отдельной сметы. [Расчёт](economics.md)
 
-**Расходы на эксплуатацию.** При 600 входных и 250 выходных токенах на заявку API обойдётся примерно в $0,078 в неделю. При условных 90 ₽/$ это 7,02 ₽ в неделю и 30,40 ₽ в месяц. За вычетом API оценка ресурса составит около 10 795 ₽ в месяц. Настройку, обучение и сопровождение владелец оценивает отдельно. [Допущения и тарифы](economics.md)
+**Пилотный запуск**
 
-**План пилота.** Предлагаем три этапа.
+1. День 1. Владелец и менеджер согласуют признаки критической срочности, допустимые ответы, состав передаваемых данных и доступ к журналу.
+2. Дни 2–3. Ответственный подключает API. Менеджер проверяет на синтетических примерах приоритет, обещания клиенту и действия при сбое.
+3. Одна рабочая неделя. После согласования обработки данных менеджер заранее размечает 50 обезличенных обращений. Сравнивает исходные ответы модели с разметкой и замеряет полное время двух способов работы на сопоставимых заявках.
 
-1. **Подготовка, день 1.** Владелец и менеджер согласуют признаки срочности и спама, допустимые обещания в ответах, перечень передаваемых данных и круг лиц с доступом к журналу.
-2. **Пробный запуск, дни 2–3.** Ответственный за внедрение подключает API. Менеджер сверяет результат с эталоном на синтетических примерах, включая протечки, короткие обращения и попытку изменить инструкцию.
-3. **Контроль, одна рабочая неделя.** После согласования правил обработки данных отбирают 50 обезличенных обращений. Для сопоставимых заявок фиксируют полное время обычной работы и время с ИИ. Менеджер заранее размечает категории, сверяет их с первоначальными предложениями модели и считает пропуски срочных случаев. Владелец изучает ошибки и расходы.
+**Три риска.** Вероятность и влияние — предварительные оценки.
 
-**Три ключевых риска.** Вероятность и влияние ниже — предварительные оценки команды для обсуждения до пилота.
+| Риск и последствия | Вероятность / влияние | Защита и остаточное ограничение |
+|---|---|---|
+| Ошибка категории задержит выезд при протечке | Средняя / высокое | Менеджер видит цвет приоритета, проверяет и исправляет каждую категорию. При неполном описании уточняет ситуацию. |
+| Контакты клиента станут доступны посторонним | Средняя / высокое | Удалять лишние сведения до отправки, ограничить доступ к Excel и копиям. Отладка на синтетике, ключ в локальном .env, книги исключены из Git. Обезличивание требует ручной проверки. |
+| Сбой API остановит работу, ошибочный ответ создаст ложное обещание | Средняя / среднее | Ограниченные повторы, проверка формата, отдельная инструкция модели и ручной резерв. Даже корректный формат допускает фактическую ошибку или влияние команды внутри заявки. |
 
-| Риск | Вероятность / влияние | Последствия и защита | Остаточное ограничение |
-|---|---|---|---|
-| Ошибка категории | Средняя / высокое | Пропуск протечки задержит помощь. Менеджер проверяет каждую заявку, видит цвет приоритета, исправляет категорию. Неоднозначные примеры включают в контроль. | Описание может скрывать срочность. Иногда потребуется уточнение клиента. |
-| Утечка данных | Средняя / высокое | Контакты могут попасть во внешний сервис или репозиторий. Удаляют лишние детали до отправки, на отладке используют синтетику, ключ хранят в исключённом из Git .env. Excel исключён из Git, доступ к папке ограничивает владелец. | Обезличивание требует внимания. У скачанной копии Excel отдельные права доступа. |
-| Сбой API или ошибочный ответ | Средняя / среднее | Работа задержится, клиенту могут пообещать лишнее. Система ограничивает время и повторы, проверяет структуру ответа и сообщает об ошибке. Инструкции клиента считаются недоверенным текстом. Менеджер проверяет смысл и при сбое работает вручную. | Даже корректный формат допускает выдуманные факты и влияние вредоносной инструкции. |
-
-**Критерии успешности пилота.** Предлагаемые пороги — не менее 90% совпадений с эталоном, ноль пропусков критически срочных случаев, снижение среднего полного времени обработки не менее чем на 40%. Для проверки срочности в контрольном наборе нужны хотя бы 10 критических случаев. Если их мало, набор дополняют отдельной размеченной серией и отмечают её происхождение.
-
-**Рекомендация.** Расширять использование после достижения всех трёх порогов и оценки полных затрат. При пропуске критического случая пересмотреть правила и повторить проверку на новых примерах.
+**Критерии и рекомендация.** Расширять пилот при совпадении категорий от 90%, отсутствии пропусков среди хотя бы 10 критических случаев и снижении среднего времени от 40%. Если срочных обращений мало, проверить дополнительную размеченную серию и учесть её отдельно. При пропуске критического случая пересмотреть правила и повторить проверку. Это предлагаемые цели пилота.