Це головне джерело плутанини.

Глобальний режим (auto / semi / manual) — впливає на ВСІ діалоги одразу. Перемикається через дашборд, Telegram-бот, або /api/mode.

driver=human — глушить Олену в ОДНОМУ конкретному діалозі, навіть якщо глобальний режим = auto. Ставиться автоматично коли власник відповідає напряму з Telegram магазину. TTL: 6 годин, або скидається через /reset.

awaiting_owner — теж per-діалог блок: Claude ескалював → чекає відповіді власника. Знімається після Reply в боті алертів.

Пріоритет перевірок:
1. D1 status=paused → мовчить
2. system:mode ≠ auto → мовчить
3. driver=human → мовчить
4. awaiting_owner → мовчить
5. Інакше → Олена відповідає

🟢 Auto — Олена відповідає на всі повідомлення, нові замовлення обробляються автоматично (підтвердження + LiqPay). Штатний режим.

🟡 Напівавто (Semi) — нові замовлення обробляються (підтвердження, посилання), але Олена НЕ відповідає на повідомлення клієнток. Повідомлення зберігаються в thread. Для ситуацій коли потрібно контролювати відповіді, але не хочеш втрачати замовлення.

🔴 Ручний (Manual) — все вимкнено. Нові замовлення → лише алерт власнику. Повідомлення → тільки thread. Для планового обслуговування або аварійної паузи.

⛔ СТОП — миттєве перемикання в Manual з підтвердженням. Безпечне повернення: Manual → Semi → Auto.

Передплата 200 грн (method_id=21) — підтвердження замовлення + LiqPay посилання 200 грн. Після оплати: COD на залишок + тег АФНП.

IBAN (method_id=19) — підтвердження + два LiqPay посилання (200 грн і повна сума). Клієнтка обирає. clean slate: thread/awaiting_owner/clarify_pending очищаються.

Online (Mono/LiqPay full) (method_id=10,11) — якщо оплачено → подяка. Якщо ні → генерація fallback-посилань + уточнення. clean slate аналогічно IBAN.

Всі флоу валідують LiqPay ключі перед генерацією посилань (крім Передплати 200, яка генерує локально).

reply — відповідь клієнтці. Може бути одне повідомлення або масив (для реквізитів, карток).

clarify — уточнювальне питання ("Який саме розмір вас цікавить?"). Ставить clarify_pending на 4 год.

defer (needs_owner: false) — агент просить артикул/фото сам. Не сповіщає власника. Claude залишається активним.

defer (needs_owner: true) — реальна ескалація: повернення, скарга, знижка. Повідомляє "уточню 🤍", блокує Claude (awaiting_owner), шле алерт власнику.

escalate — мовчки шле алерт. Клієнтка нічого не отримує. Тільки для: агресія, шахрайство, юридичне.

driver=human — ставиться автоматично коли власник відповідає напряму з Telegram магазину (direction:outgoing). Олена мовчить 6 годин. Скинути: /reset в боті.

awaiting_owner — ставиться при defer(needs_owner:true) і escalate. Claude заблоковано поки власник не відповість через бот алертів. TTL: 4 год.

Як повернути Олену:
• driver=human → /reset в Telegram-боті (або чекати 6 год)
• awaiting_owner → Reply на алерт або кнопка ▶️ Хай бот продовжує
• paused → кнопка ▶️ або /resume {id}

Коли клієнтка пише вперше, а прив'язки до замовлення ще немає — Олена сама шукає замовлення за номером телефону месенджера (не чекає, поки клієнтка назве номер).

Матриця вибору:
• 1 активне замовлення → soft confirm
• кілька свіжих (<48 год) з тим самим товаром → дублі → бере найновіше
• кілька різних або старі → питає «яке саме замовлення?»
• тільки ручні замовлення → алерт власнику, клієнтці мовчить

Soft confirm — 3 кроки безпеки: Олена НІКОЛИ не називає товар/місто/суму першою — тільки питає. Клієнтка має сама назвати товар → якщо не збіг, нейтральна деталь (місто доставки або приблизна сума) → якщо знову ні, передає менеджеру. Захист: чужа людина не підтвердить те, чого не знає.

Розбіжність номерів: якщо телефон месенджера ≠ телефон у замовленні — Олена все одно знаходить замовлення й звіряє через soft confirm, перш ніж відкрити доступ.

Після підтвердження оплати/передплати система автоматично надсилає одне страхувальне повідомлення: «Для вашого спокою пропонуємо ще раз швиденько звірити замовлення 🌸» зі списком по кожному товару — Модель · Колір · Розмір · Кількість.

Надсилається один раз на замовлення (не повторюється), детерміністично — не залежить від того, чи Олена «вирішить» питати.

Джерело характеристик: KeyCRM offer.properties → каталог D1 → SKU. Колір і розмір беруться незалежно — якщо один є, другий все одно шукається далі.

Якщо характеристики не підтягнулись — Олена чесно просить назвати колір/розмір («не підтягнулись характеристики — підкажіть, будь ласка…»), не вигадує.

Відповідь клієнтки: «все вірно» → готуємо до відправки; правки (інший розмір/колір) → передає власнику + коментар у CRM (правка не губиться).

Статуси доставки (KeyCRM): invoice = ТТН створено, посилка ще у власника (очікує передачі кур'єру) → transit = Нова Пошта прийняла, в дорозі → delivered = у відділенні.

Клієнтці «відправлено»: надсилається ТІЛЬКИ коли статус став transit (НП реально прийняла) — не при створенні ТТН, щоб не писати «посилка прямує», поки вона ще у власника. При delivered — окреме «прибула у відділення». З дедупом, урахуванням ручних відправок і grey-zone станів.

Власнику — кур'єрська картка (не клієнтці): номер, отримувач, товари згруповані по постачальниках. Формується лише для замовлень зі статусом invoice (що очікують передачі). Нова ТТН на тому ж замовленні → позначка «🔄 оновлена ТТН». Дедуп per-ТТН (courier_card:{id}:{ttn}).

Два шляхи картки:
• Авто (cron): щогодини перевіряє замовлення за -updated_at, для нових invoice-ТТН одразу шле картку власнику.
• Кнопка «🔄 Перевірити нові ТТН» (Дашборд): показує список invoice-ТТН з чекбоксами (всі позначені), знімаєш зайве → «📤 Надіслати картки (N)» шле лише обрані. Обходить годинне вікно; безпечно тиснути повторно (дедуп).

Конфіденційність: назва постачальника є в кур'єрській картці для власника, але клієнткам НІКОЛИ не розкривається.

Cloudflare зупиняє Worker через 30 секунд. Якщо Олена думає довго (понад 12 с) — клієнтці одразу йде «Секундочку, перевіряю ваше замовлення 🤍», а повна відповідь досилається коли готова: у фоні або cron-ом кожні 2 хв.

Тому клієнтка ніколи не лишається без відповіді, навіть на складних запитах, що потребують довгих роздумів. Пріоритет — якість відповіді, а не миттєвість.

Збій оплати: якщо LiqPay callback повертає failure/error — cron надсилає м'яке уточнення («помітили, що оплата не завершилась 🙏») через ~20 хв або одразу при відомій помилці.

Зміна розміру: Олена консультує за замірами моделі (показує ВСІ доступні розміри з ✓ біля замовленого, тон позитивний). При зміні — коментар у CRM, за потреби алерт власнику.

Теги оплати: автотегування замовлення за методом (LiqPay 200 / повна, IBAN 200 / повна, АФНП для фіскалізації НП). Non-blocking — не блокує основний флоу.

Критично: в тестовому режимі клієнтки отримують sandbox-посилання — реальна оплата НЕ працює.

Перемикання: /liqpay_test і /liqpay_live в Telegram-боті, або через адмінку (вкладка Тестування).

Кожне замовлення зберігає режим на момент створення (liqpay:balfe_{n}:mode). Callback використовує саме цей ключ для підпису — тому зміна режиму НЕ впливає на вже видані посилання.

Кнопки на алертах: ⏸ Я відповім сам · ✍️ Відповісти клієнтці · ▶️ Хай бот продовжує · 💤 Ще чекаю · 🧠 Режим мозку

Режим мозку — вільні текстові інструкції Claude. Може: надіслати повідомлення, змінити KV, поставити на паузу, надіслати LiqPay посилання. Активується кнопкою 🧠 або /brain [{phone}]. Діє 2 години.

Команди: /stop {id} · /resume {id} · /status {id} · /history {id} · /debug {n} · /reset · /panel · /auto · /semi · /manual · /stop_all

KV — Cloudflare Key-Value store, швидкий кеш зі стану діалогів.

D1 — SQL-база (SQLite), зберігає діалоги, повідомлення, аналітику, каталог.

thread:{phone} — JSON-масив останніх 20 повідомлень розмови (KV, TTL 30 днів).

conv:{channel}:{phone} — прив'язка телефону до замовлення (KV).

driver — хто веде діалог: "human" (власник) або відсутній (Олена).

awaiting_owner — Claude заблоковано, чекає відповіді власника.

clarify_pending — Claude задав уточнювальне питання, чекає відповіді клієнтки.

topic_product — товар що обговорюється (артикул або назва), зберігається між повідомленнями.

sendDelayed — відправка з typing-delay і fallback на альтернативний канал.

debounce — буфер ~0.5 секунди: об'єднує burst-повідомлення (текст + фото) в одне.

order_verify_sent — прапорець, що страхувальну звірку для замовлення вже надіслано (щоб не повторювати).

Статичний журнал (адмінка не має git-доступу — оновлюється вручну при деплої). Синхронізовано з VERSIONS.md. Поточна версія — верхня.

Олена відповідає дурниці: натисни ⛔ СТОП на дашборді → manual. Потім розберись з промптом/директивами.

LiqPay в тестовому режимі в бою: /liqpay_live в Telegram-боті. Вже видані тестові посилання залишаться тестовими (по order-level ключу).

Клієнтка не отримує відповідей: перевір driver (може human), awaiting_owner, status=paused. /reset скидає все.

Безпечне повернення після паузи: Manual → Semi (замовлення обробляються, але Олена мовчить) → Auto (повний автомат).