# KILN website

Шрифты Montserrat 400/600/800 загружаются по необходимости через CSS;
глобальный font preload отключён. Оформление и `font-display: swap` сохранены.

Карта и маршрут: координаты из runtime `/api/info` бота; центр, метка и
маршрут совпадают. Причина исправления и кэширование —
[RESTAURANT_LOCATION.md](docs/RESTAURANT_LOCATION.md).

## Ручные брони СБИС — 8 ноября 2026

Исправлены Mode=books, shared SBIS formats (f без повторного s) и чтение
длительности из документа. Импорт охватывает три календарных месяца, с тремя
параллельными запросами и паузой 180 секунд между циклами. Ручные количество
гостей/столы/нестандартная длительность отражаются без автоматического
переназначения или счёта; клиентские ограничения не расширены. Один INSERT
фиксирует внешний Sale, статус и snapshot; повтор не дублирует бронь.
Подробности и ограничения: [руководство синхронизации бота](/srv/kiln-bot/docs/MANUAL_BOOKING_SYNC.md).

Выпуск 6 ноября 2026 применён к обоим приложениям: commit/push,
Docker build --no-cache, бот первым с аддитивной миграцией, затем сайт.
Health/info/ma/cart/checkout — 200, закрытые API анонимно — 401.
Runtime source hashes сверены. Подробности, версии и ограничения — [IMPLEMENTATION_HANDOFF.md](docs/IMPLEMENTATION_HANDOFF.md).

## Остатки и возвраты: уточнение 6 ноября 2026

Владелец уточнил: СБИС списывает остаток ПРИ ОТПРАВКЕ НА КУХНЮ. До этого
количество заказа не вычтено из GetBalance. Первый короткий старт оплаты
создаёт количественный резерв KILN. Доступный остаток = свежий GetBalance
минус активные резервы ДРУГИХ заказов KILN; свой hold повторно не вычитается.
Каталог/корзина учитывают все holds. Sale.Check дополнительно проверяет заказ,
но не доказывает раннее списание и не разрешает прибавлять позиции к остатку.

На «Выполнение» СБИС списывает сам; после verified readback hold становится
consumed и перестаёт вычитаться. Отмена до кухни освобождает только локальный
hold, без прибавления к неизменённому Balance. First start и kitchen transition
сериализуются между workers через order_stock_mutex; срок фиксируется атомарно
в обеих таблицах. Long 3 часа не продлевается и не получает short hold.
Новые версии policy 3/fulfillment 1; legacy не backfill. Продажи прямо на кассе
не блокируются локальным резервом: перед кухней fresh проверка, при нехватке
paid сохраняется и нужен оператор. Абсолютных Balance writes нет.

B перечитан: входящий аванс — Type=1/OperationType=1, возврат — Type=2/OperationType=2.
Источник истины — зарегистрированный возврат СБИС, включая снятие банковского
холда. Не ждём ClosedWTZ, обнуления PaidSum или зачисления банком. До включённой
границы отмены брони оформляется один штатный возврат с журналом booking_refunds;
неопределённый ответ только перечитывается. После границы — решение ресторана.
Карточки сайта, оператора и Mini App показывают полный/частичный результат СБИС.
Оплаченная отмена обычного заказа остаётся отдельной процедурой.

Штатные чеки начала готовки и отмены подтверждены владельцем. Собственной
печати/фискализации нет. Реальный оплаченный E2E ещё не проводился; сценарий E
проверяет всю цепочку после выпуска и больше не является условием включения
нативного учёта. Контракт v1.23, подробности — [NATIVE_ORDER_RELEASE.md](docs/NATIVE_ORDER_RELEASE.md).

## Корзина и оплата — рабочая копия 6 ноября

[Подробная инструкция и связь с ботом](docs/CART_AND_PAYMENT.md).
Корзина до submit локальная, очистку можно отменить 180 секунд вместе с
комментарием после перехода/перезагрузки. Наличие проверяется каждые 15 секунд
на видимой корзине/checkout, серверный shared snapshot — до 5 секунд.
Недоступные/исчезнувшие блюда сохраняются для решения клиента.
Сохранённая платёжная ссылка больше не обходит fresh document/stock/deadline
проверку. Отмена без оплаты отмечается отдельно в архивной карточке.
Новые заявки используют policy 3, штатные остатки СБИС, один старт оплаты
и подтверждённый fulfillment version 1; legacy не пересчитывается. См. docs/AUDIT_INDEX.md.

Совместная рабочая область сайта и бота: `KILN.code-workspace`.
Общий контекст Codex: `/var/www/html/kiln-system`; возврат через совместное
меню ограничен сессиями сайта, бота и этого каталога. HotelERP исключён.
В списке показаны заголовки сессий, проект и время последней активности по Москве.
Возврат восстанавливает сохранённые права сессии; --add-dir передаётся только
при workspace-write. Codex CLI и managed app-server обновлены до 0.167.0.
Системное Gum-меню: `deploy/admin-menu/README.md`.
Серверная маршрутизация двух доменов OpenAI через существующий proxy:
`deploy/openai-domain-router/README.md`; настройки приложений сохраняются.
Оставшиеся ручные проверки: `docs/PRODUCTION_MANUAL_TEST_PLAN.md`.

Checkout: условия доставки показаны только в «Состав и оплата», платный тариф
выделен оранжевым, бесплатный — зелёным. «Как можно быстрее» отключает дату.
Срок оплаты поступает от бота. Для policy 2/3 просрочка запускает общую
проверенную отмену; неясный внешний результат требует оператора.

Production-сайт ресторана KILN на Next.js App Router.

Перед любыми изменениями прочитайте `AGENTS.md` и `TECHNICAL_CONTEXT.md`.
Администрирование меню описано в `ADMIN_MENU.md`, production-развёртывание —
в `DEPLOY.md`. Сервер-сервер контракт с ботом находится только в
`/srv/kiln-bot/api_site_contract.md`.

Сводная документация системы:

- `docs/AUDIT_INDEX.md` — единая точка входа в аудит **обоих** проектов;
- `/srv/kiln-bot/docs/FUNCTIONAL_GUIDE.md` — отдельное руководство по боту;
- `docs/CODE_INDEX.md` и `/srv/kiln-bot/docs/CODE_INDEX.md` — индексы кода;

- `docs/FUNCTIONAL_GUIDE.md` — человекочитаемые функции и сквозные сценарии;
- `docs/FUNCTION_INVENTORY.md` — полный реестр UI, API, workers и ownership;
- `docs/SYSTEM_AUDIT.md` — фактическая архитектура, фоновые процессы и backlog;
- `docs/SITE_API.md` и `docs/MINIAPP.md` — отдельные границы API и Mini App;
- `docs/SBIS_BOOKING_CAPTURE.md` — безопасная подготовка capture столов СБИС;
- `docs/MIGRATION_ASSESSMENT.md` — самостоятельная оценка переноса бота.

## Запуск

Используйте отдельную development-машину или checkout. На production-хосте не
запускайте обычный `docker compose up`: он может пересоздать действующий Compose
project. Для изолированной локальной среды:

```bash
npm ci
docker compose -p kiln-dev up -d --wait postgres
DATABASE_URL=postgres://kiln:kiln@localhost:55432/kiln npm run db:migrate
DATABASE_URL=postgres://kiln:kiln@localhost:55432/kiln npm run dev -- --port 3001
```

Откройте `http://localhost:3001`. Скрипт `dev:3001` запускает фиксированный порт и не должен незаметно переключать демонстрацию на другой адрес.

## Где менять данные

- Общие данные ресторана, ссылки, рейтинг, часы, feature flags: `src/config/site.ts`.
- Меню из PDF 2026 года: `src/data/menu.ts`.
- Типы: `src/lib/types.ts`.
- Используемые изображения сайта находятся в `public/brand`, `public/dishes`,
  `public/gallery`, `public/legend`, `public/og`; исходные макеты и старые версии
  графики в репозитории не хранятся.
- Основной favicon — `public/favicon.svg`; PNG с суффиксом `-v2` служат только
  fallback для Apple/PWA и браузеров без SVG favicon.
- Локальные файлы шрифта, необходимые сборке: `files/Fonts/`.

## Feature flags

В `src/config/site.ts` можно включать и выключать:

- `deliveryEnabled`;
- `pickupEnabled`;
- `bookingEnabled`;
- `eventsEnabled`;
- `loyaltyEnabled`;
- `onlinePaymentEnabled`.

Отключенные функции не выводятся в основную навигацию, если у них есть флаг.

## Интеграция с ботом и СБИС

Сайт обращается к закрытому API бота только с backend по `BOT_API_BASE_URL`
и `BOT_API_KEY`. В production используется Docker DNS `http://bot:8383` в
общей внутренней сети `kiln_bot_api`. Бот отвечает за СБИС, доставку, историю,
сообщения, SMS и email-транспорт; ключ API не должен попадать в браузер.

- SMS используется только для первого подтверждения телефона в личном кабинете.
- Email PIN генерирует и проверяет сайт, а письмо отправляет бот через SMTP.
- Цена, наличие, зоны, тарифы, порог бесплатной доставки и время приходят из СБИС через бота.
- Привязки и заказы используют настоящий ID номенклатуры СБИС. Если бот
  исправляет ранее отданный ID строки прайса, синхронизация переносит активную
  связь по `position_id`, сохраняя закрытую старую запись в истории.
- Калорийность и БЖУ можно явно получить из карточки СБИС или заполнить вручную; автоматическая синхронизация не затирает редакционные значения.
- Аллергены заполняются вручную и показываются с пометкой «Может содержать».
- Карточки СБИС в админке открываются в модальном окне; список сохраняет поиск,
  выделение и прокрутку, а связи локальных карточек видны в редакторе. Связь
  позиции можно заменить или снять, а категорию СБИС выбрать из списка.
- В текущих и завершённых заказах показываются сохранённые позиции и сумма;
  технический `client_ref` не используется как видимый номер заказа.
- После подтверждения полной оплаты в СБИС polling автоматически скрывает
  кнопку и ссылку оплаты; дальнейшие приготовление и delivery dispatch
  принадлежат state machine бота, а не браузеру.
- Время API содержит явный UTC/offset и во всех клиентских и операторских
  карточках отображается в `Europe/Moscow`. Recovery оплаты не показывает
  клиенту технический `needs_operator`, устаревшее напоминание об оплате или
  ложное изменение состава.
- В админке настройка «Среда Достависты» мгновенно переключает только новые
  доставки между TEST и PROD. Она недоступна операторской роли. Браузер
  администратора получает только enum и признаки
  настроенности; endpoint и четыре credentials остаются в backend бота.
  Карточки уже созданных доставок показывают закреплённый badge TEST/PROD.
- Форма входа оператора не показывает рабочий email: request/verify endpoints
  сами используют фиксированный server-side адрес и принимают только код.
- В текущих заказах доступны серверно разрешённые действия: изменение до
  оплаты, безопасная отмена без удаления истории и переход к переписке с
  рестораном. Завершённые заказы отменять нельзя.
- В отложенной pending-заявке клиент и оператор видят отправленный состав и
  сумму позиций; до подтверждения клиент может вернуть состав в корзину и
  заменить заявку с тем же `client_ref`.
- Авторизованный клиент хранит адреса доставки на сервере, выбирает их в
  checkout и может менять, назначать основным или архивировать. Схему добавляет
  миграция `drizzle/0014_customer_addresses.sql`.
- Checkout инвалидирует расчёт при любом изменении адреса или subtotal и до
  нового успешного quote не показывает прежний тариф. Для доставки выводятся
  minimum, текущая стоимость, порог бесплатной доставки и shortfall; номер и
  название технической зоны клиенту не показываются. Кнопка оплаты требует
  актуальный quote и `subtotal >= minOrder`. Самовывоз не имеет delivery
  minimum и показывает централизованный адрес ресторана из contact settings.
- В открытой корзине и checkout наличие/количество проверяется через backend
  каждые 15 секунд. Ошибка СБИС сохраняет last-good; перед созданием бот всегда
  делает отдельную свежую проверку заказанных SKU.
- Маркетинговое согласие в checkout по умолчанию скрыто; администратор может
  включить его настройкой «Маркетинговое согласие» без изменения кода.

Для сайта SMTP-переменные не требуются. SMTP настраивается только в `.env`
бота; сайту нужны `BOT_API_BASE_URL` и совпадающий с ботом `BOT_API_KEY`.

Операторский кабинет сайта доступен только по непубличному адресу
`/operator/`: вход выполняется кодом из письма на `bar@kiln.spb.ru`, код
действует 3 минуты. `/ma` обслуживается сайтом и при запуске из привязанного
ресторанного чата автоматически создаёт операторскую сессию через подписанный
Mini App API бота. В чатах остаются только штатные кнопки WebView.

## Проверки

```bash
npm run lint
npm run typecheck
npm run build
npm run test:visual
```

`npm test` намеренно не входит в безопасный минимальный набор: он записывает
данные в PostgreSQL, использует generated-файлы `data/import` и HTTP-сервер.
Запускайте его только с отдельной тестовой БД и тестовым приложением. Полные
условия описаны в `AGENTS.md`.

## Миграции

`npm run db:migrate` идемпотентно применяет все файлы `drizzle/*.sql`.
Уже применённые файлы не изменяются: для новой схемы добавляется новая
миграция и одновременно обновляется `src/db/schema.ts`.
При production-развёртывании миграции выполняются внутри контейнера приложения
после создания резервной копии PostgreSQL.

Выпуск manual booking sync 8 ноября подтверждён: normal poller 93 даты,
три импорта, повторный цикл без дублей. Source SHA/проверки — в shared
IMPLEMENTATION_HANDOFF.md, manifest /var/backups/kiln-system/20261108T103301Z/release.json.


Идентичность, прямой доступ к старым карточкам, 5-секундное обновление и общий
журнал просмотра: [ACTIVITY_REFRESH.md](docs/ACTIVITY_REFRESH.md). Контракт бота v1.25, аддитивная MariaDB миграция,
без PostgreSQL/env изменений. Проверки и фактический выпуск — в общем handoff.

Форма бронирования сохраняет черновик при закрытии модалки, сохраняет доступное
время при смене длительности и допускает пустой промежуточный ввод гостей без
ведущего нуля. Описание: [FUNCTIONAL_GUIDE.md](docs/FUNCTIONAL_GUIDE.md#черновик-формы-бронирования).


Календарь новых броней: Москва, сегодня..+9 календарных месяцев включительно,
прошедшее время запрещено. Только создание: переносы и вся сохранённая история
без нового ограничения. Синхронизация минимум/default 9 месяцев (9..12),
concurrency 3, пауза 180 секунд. Контракт v1.26; схема БД не меняется.
Календарь сайта показывает причины недоступности на hover/focus/tap; черновик
сохраняется, неверная дата блокирует отправку. Выпуск бот первым, сайт вторым.


Карточки бронирований используют display_number от бота: настоящий Number
СБИС либо временный номер неподтверждённой заявки. Успешная отправка закрывает
модалку перед переходом в карточку. Восстановление известного документа —
операторским действием бота, без повторного создания. См.
[руководство бота](/srv/kiln-bot/docs/BOOKING_NATIVE_RECOVERY.md).


Бронирования: постоянный выбор 1..9 часов (default 2), API — минуты
60..540 с шагом 60. Окончание ограничено расписанием ресторана. Старые
длительности в истории не пересчитываются. Нативный duration строго integer;
float 2.0 СБИС отклоняет. Бот v1.28 выпускается перед сайтом.


Отмена v1.29: повтор сохранённого запроса доступен клиенту; постоянное
сообщение о состоянии отображается в карточке. Retry оператора требует
подтверждения без пустой обязательной textarea. Для проверенной несозданной
заявки — отдельное действие с основанием и аудитом бота.

Обновление 9 ноября 2026: бронирования, сортировка всех списков до пагинации,
ручной просмотр/undo, короткий доступ по двум кодам и отдельный worker каталога —
[описание](docs/BOOKING_ACTIVITY_ACCESS.md).


## Изменения бронирований: часовой минимум и текущая занятость

Клиентское создание и выбор нового времени требуют минимум 60 минут по
серверному времени Москвы. Менее чем за час клиентские правки параметров
недоступны; операторские правки этим минимумом не ограничены. Отмена сохраняет
прежние правила. Для сегодняшней доступности добавлена карта PrestoSale.List
Mode=orders: текущие заказы блокируют новые назначения до освобождения стола.
Неизвестная схема не считается свободным столом. Оператор сохраняет параметры
и столы после проверки доступности кнопкой «Сохранить изменения в СБИС».
Исходный HAR не входит в Git. Проверка перехода занятого стола в свободный
на production остаётся отдельным сценарием обычного обслуживания.



## Отдельное исправление счётчиков аудитории
Клиентский профиль и мобильное меню не складывают клиентские и ресторанные
события. У ссылки оператора — отдельный ресторанный бейдж. Для оператора
добавлен разрез активных/архивных уведомлений. Изолированная проверка
одновременных сессий: client=0/restaurant=4 в Chromium/Firefox, 1440/390 px — pass.
Выпускается отдельно от Android; без нативных API и изменений схемы устройств.

## Android оператора и счётчики — 9 ноября 2026

Счётчик клиентского профиля и мобильного меню использует только клиентскую
аудиторию. В /operator — только ресторанную; архивные события видны на вкладке
архива. Исходный дефект был суммированием двух одновременно открытых сессий.
События и отметки просмотра не удалялись.

Android: универсальный подписанный APK 0.1.0, minSdk 24 (Android 7), target 35;
WebView 111+. Firebase/Google Play Services не используются. Исходники и
GitHub Actions находятся только в репозитории бота, android/operator.
Сайт отображается в WebView; обновления панели не требуют новой версии APK.
Вход по email-коду выдаёт отзываемую учётную запись устройства. Она хранится
в Keystore и обновляет web-сессию; обычное закрытие/очистка кэша не завершает
вход. Очистка данных, выход или отзыв устройства требуют повторного входа.

Фоновая доставка — foreground service specialUse и WSS с коротким обновляемым
билетом. Курсор фиксируется до ACK. ACK не отмечает сообщения прочитанными:
прочтение по-прежнему ручное. Собственные действия ресторана обновляют
состояние без нового звукового уведомления. Каналы: действия, сообщения,
информация; прочитанные события удаляются из SystemUI. Новое устройство
получает события после регистрации, без массовой доставки старого архива.

Проверено изолированно: 307 тестов бота с MariaDB без пропусков; сайт 63 pass,
1 opt-in email skip, typecheck/lint/build; native OTP/session/revoke/role checks,
реальный WSS/ACK/renewal; Android release compile и lintDebug. Chromium/Firefox
1440/390: client=0 и restaurant=4 не смешиваются. Физические устройства и
реальные email-коды проверяет владелец вручную. GitHub Actions настроен;
успешный запуск в аккаунте не подтверждён (нет доступа к API Actions).

Выпуск: аддитивная PostgreSQL 0016 и MariaDB origin/delivery cursors;
OPERATOR_APP_ENABLED=true в обоих сервисах,
OPERATOR_SITE_INTERNAL_URL=http://app:3000 у бота. Apache проксирует WSS.
Backup/rollback: /var/backups/kiln-system/android-20261109.
Подробности и ручная проверка: /srv/kiln-bot/docs/ANDROID_OPERATOR.md.

## Ручное бронирование на несколько столов — 9 ноября 2026

Исправлены самоблокировка столов ручного source=sbis без локальной группы,
потеря текущего выбора и невозможность постепенно собрать несколько столов.
Availability исключает собственный sbis_sale_id, проверяет чужие бронирования
и сегодняшнюю занятость, передаёт current_assignment и основной стол.
Текущий набор сохраняется даже при исходной нехватке вместимости; оператор
может исправить набор/число гостей. Сохранение требует полной валидной
рассадки, не обходит реальные конфликты или вместимость. СБИС отдаёт общее
число гостей и массив столов; начальная рассадка ручной записи рассчитана
по вместимости, UI явно сообщает об этом. Локальная сохранённая рассадка
не перераспределяется при обновлении доступности.

Первое сохранение ручной записи присоединяет её существующий Sale к
локальной группе и обновляет этот же документ; повтор идемпотентен. Новый
Sale для записи с известным sbis_sale_id создавать запрещено. Readback
сверяет также дату и гостей, кроме столов/основного стола/длительности.
При неопределённости сохраняется известный внешний ID и требуется проверка;
повторного создания нет. Длительность локальных holds проверяется по запросу.

Схема БД и переменные окружения не меняются. Нормативный контракт v1.33
в репозитории бота. Проверки и выпуск — в общем IMPLEMENTATION_HANDOFF.md.

## Рабочая панель Android 0.1.2

Все операторы остаются одним пользователем ресторана. Собственные события
получают receipt автора в AFTER INSERT activity_events в той же транзакции;
получатель и предыдущие непрочитанные события не затрагиваются. Client actor
проставляется только доверенными авторизованными обработчиками. Фоновые
задачи запускаются без наследования автора. История и ручное прочтение сохранены.

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

APK использует /operator/app и UA KILNOperator/0.1.2. Native layout не загружает
публичные header/footer, каталог, аналитику или клиентские провайдеры; UA —
только представление, не авторизация. Сессия оператора проверяется как раньше.
В toolbar — основной логотип, профиль с выходом и одна шестерёнка настроек.
Статус-бар тёмный, значки светлые. Уведомления имеют явный PendingIntent,
обрабатываются onNewIntent и cold launch, объект — в свою карточку.
Информационный канал v2 создаётся со звуком/вибрацией; технические счётчики
и соединение бесшумные. Полный логотип — вывеска, шестерёнка серая; маска
современного лаунчера контролируется ОС, логотип помещён без обрезки.

POST /api/operator/bookings/create: операторская сессия + CSRF на сайте,
X-Api-Key у бота; request_ref UUID, name/phone/date_time/persons/duration_minutes,
необязательные email/comment. Телефон гостя обязателен. Будущее время менее
чем через час доступно ресторану, клиентские правила не расширены. Обычная
предоплата сохраняется. После создания открывается карточка для выбора
столов и подтверждения. Повтор request_ref идемпотентен, изменённый payload —409.
MariaDB: nullable unique bookings.operator_request_ref; схема и startup ALTER
идемпотентны. PostgreSQL/секреты без изменений.

## Иконка и поля бронирования — 11 ноября 2026

APK 0.1.3 использует обычный bitmap во всех конфигурациях launcher icon, включая
API26 и roundIcon. Полный логотип и серая шестерёнка собраны в PNG RGBA пяти
плотностей из исходного арта. Лишняя чёрная adaptive-подложка удалена. Генератор
android/operator/tools/icons.mjs воспроизводим; npm ci и --check проверяют
плотности. Release-проверка aapt2 разрешает ссылки по resources.arsc (AGP
сокращает имена файлов), проверяет bitmap roots и пять PNG. Проверка XML
исходников дополняет, но не заменяет проверку APK. Системная подложка некоторых
лаунчеров остаётся поведением ОС; собственный Launcher3 в KILN отсутствует.

Операторская форма разделяет дату и время. Защищённый GET сайта
/api/operator/bookings/slots?date=&duration_minutes= использует те же расписание
и длительности, что клиентский список; для оператора — любое будущее время,
для клиента прежний минимум 60 минут. date_time в POST неизменен (+03:00).
При смене длительности допустимое время сохраняется, устаревшие запросы
отменяются, при ошибке есть повтор. Черновик и request_ref сохраняются.

GuestCountField показывает постоянную подпись, пример пустого значения,
склоняемый суффикс и пояснение: клиенту «Укажите общее количество гостей, включая
себя», оператору «Всего, включая бронирующего». Компонент общий для сайта,
создания в APK и клиентских изменений в ЛК/Mini App. В Telegram/MAX клиентский
мастер явно просит общий размер компании, включая самого клиента. Значение
persons всегда уже включает бронирующего; плюс один не прибавляется.

Базы, интервалы синхронизации, предоплата, доступ и авторизация не меняются.

## Android 0.1.4: обновления из приложения

Обновление нативной оболочки добавлено в APK 0.1.4, versionCode 5. Версии до
0.1.4 требуют одной ручной установки поверх прежней с сохранением входа.
Далее приложение проверяет HTTPS /uploads/apps/operator-update.json при
открытии и каждый час работающим foreground service, показывает предложение
и отдельное системное уведомление. Ручная проверка — в шестерёнке.
По согласию загружает версионный APK с того же сайта, проверяет размер/SHA-256,
package/version и прежнюю подпись. При первом обновлении Android 8+ запрашивает
право установки из источника КИЛН, затем открывает системный установщик;
Android 7 использует штатные настройки неизвестных источников. Установку всегда
подтверждает пользователь. Панель и авторизация при отказе продолжают работать.

Исходники, тесты, сборка и publisher — в репозитории бота, android/operator.
Publisher сначала проверяет подпись/версию и публикует immutable APK, затем
атомарно заменяет update manifest. Запрос metadata содержит cache-buster и
no-cache; файл версии отдаётся с no-store, APK сохраняет версионное имя.
Не назначать immutable-кэш пути operator-update.json. Новых API, миграций и env нет. В общем маршруте uploads добавлен no-store
для файла версии и корректные MIME-типы JSON/APK; остальные файлы неизменны.
Последующие выпуски APK не требуют рестарта сервисов.
Подробные команды и ручная матрица Android —
[ANDROID_OPERATOR.md](/srv/kiln-bot/docs/ANDROID_OPERATOR.md).

## Оплата и доставка: серверная сверка и общая история — 11 ноября 2026

Контракт бота v1.35 добавляет timeline к прежним messages. Интерфейсы ЛК,
прямых ссылок, Mini App и ресторана предпочитают timeline; при старом боте
используют messages. Статусы представлены элементами id=-activity_event_id,
обычные сообщения сохраняют положительные IDs. Системное сообщение и его
событие объединяются; manual read snapshot v2 и защита более поздних событий
сохраняются. Ресторанные note не выдаются клиенту. Поллинг/черновики сохранены.
Новая версия APK не нужна: меняются backend и браузерная панель.

Бот сверяет оплату отдельно каждые15с без возврата браузера, доставку каждые30с
через API и по HMAC callback. Fresh provider state применяется до надбавки,
отмены/повторного вызова; при outage нет платных изменений. Terminal delivery
не возвращается в поиск; подтверждение завершения СБИС — отдельный durable
readback без повторного неопределённого write. Ресторанные предупреждения о
надбавке/попытках/дедлайне однократны на вызов и видны в его истории.

Аддитивная MariaDB migration: nullable activity_events.payload и business-safe
before/after в триггерах. Прежние events, receipts и эпоха включения сохраняются.
PostgreSQL/env без изменений. Bot-first/site-second, перед выпуском backup
обеих БД и проверка миграции/отката. Старый сайт совместим с новым ботом.

Аудит двух экземпляров чека: штатная копия в Presto подтверждена, для автоматизации
нужны проверка настроек либо контекст встроенного нефискального print trigger.
Непроверенная автопечать и повторная фискализация не добавлены. Нужен capture
действия «Копия чека» для подтверждения HTTP-контракта. Подробности:
[SBIS_DELIVERY_RECEIPT_AUDIT.md](/srv/kiln-bot/docs/SBIS_DELIVERY_RECEIPT_AUDIT.md).
Реальная печать кухни при закрытом браузере остаётся отдельной проверкой с рестораном.


## Изменения заказов 12 ноября 2026 (выпущено)

Checkout различает заказчика и получателя (имя/телефон/email); авторизованный заказчик определяется сервером. Ресторанная карточка показывает два блока. Контракт бота v1.36 и описание: [/srv/kiln-bot/docs/ORDER_23279_CORRECTIONS.md](/srv/kiln-bot/docs/ORDER_23279_CORRECTIONS.md). APK не меняется; PostgreSQL без миграций. Фактические проверки/выпуск — в IMPLEMENTATION_HANDOFF.md.

Выпуск: runtime бот e5f0084 / сайт 6f675d5, bot-first/site-second. Проверки,
backup/rollback и инцидент нехватки диска: [общий handoff](/var/www/html/kiln/docs/IMPLEMENTATION_HANDOFF.md).


Короткий доступ12.11.2026: бот8cfb85c исправляет403 из-за Origin:null
(Referrer-Policy:same-origin), оформление формы и работу нескольких вкладок.
Chromium/Firefox desktop/mobile и реальный вход23279 PASS. Runtime сайта без
изменений. Очистка старых KILN images/журналов дала около9GiB доступного места;
текущие/последние rollback images и БД сохранены. Проверки/backup/retention:
[handoff](/var/www/html/kiln/docs/IMPLEMENTATION_HANDOFF.md).


## План выдачи курьеру

Ресторанная карточка показывает общий план забора группы с редактированием
до назначения курьера. Расчёт от оплаты+12мин сохранён, scheduled — прежний.
Сохранение требует readback Достависты; pending не выдаётся за успех.
После назначения — запрет изменения и прямой звонок курьеру. Формы сохраняют
черновики при polling. Контракт v1.37: /srv/kiln-bot/api_site_contract.md.
Автооценка курьера исключена: API не поддерживает. Новых миграций/APK нет.


## Баланс и готовность самовывоза — 12 ноября 2026

Независимые ручные доставка/самовывоз; автоматический gate доставки<=600,
восстановление>650, ошибки/проверка старше15мин блокируют новые доставки.
Самовывоз и существующие документы сохраняются. Дополнительная настраиваемая
рассылка при2150 с общим cooldown24h, который не сбрасывается колебаниями.
Готовность самовывоза: payment+12min/scheduled due, отдельная ручная отметка
оператора и клиентское чтение/уведомление, без переноса времени в СБИС.
Контрактv1.38: /srv/kiln-bot/api_site_contract.md. Проверки и фактический выпуск
фиксируются в /var/www/html/kiln/docs/IMPLEMENTATION_HANDOFF.md.
