# Production deployment

При проверке выпуска шрифтов: у HTML и HTTP Link header нет `as=font`
preload; CSS содержит Montserrat 400/600/800 с `font-display: swap`. Проверить
Chromium/Firefox, 1440/390 px. Новых env, API и миграций для этой правки нет.

Карта и маршрут: координаты из 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).

## Выпуск cart/payment v1.21

Commit/push, пересборка без кэша и deployment обоих приложений выполнены 6 ноября 2026. Startup migration бота применена после проверки восстановленной копии.
Сначала совместимый бот, затем сайт. Bot Dockerfile обязан включать
order_policy.py и order_policy_store.py. Его Db.connect создаёт четыре пустые
таблицы policy 3 (см. bot docs/ORDER_POLICY3.md); перед разрешённым выпуском
backup MariaDB и проверка upgrade на изолированной копии. PostgreSQL schema и
env для этого дополнения не меняются. POLICY_ENABLED остаётся False;
не назначать version=3 вручную, такой payment POST отклоняется.
Проверить 180s cart undo, 15s availability, fresh POST даже с cached link,
expired/paid/shortage, архивную подпись, совместимость Mini App. Bot rollback
не должен активировать незавершённый native flow. Новые пустые таблицы при
откате не удалять автоматически. См. docs/CART_AND_PAYMENT.md.

Системная служба маршрутизации OpenAI установлена отдельно от приложений:
`deploy/openai-domain-router/README.md`. Её restart/rollback не требует
rebuild/redeploy сайта/бота и не меняет конфигурацию существующего Xray.
Не очищать глобальные firewall rules при её откате.

Изменение выбора сессий в совместном Gum-меню не требует rebuild/restart:
установленная обёртка исполняет `deploy/admin-menu/kiln-system.sh` из checkout.
После изменения открыть меню заново. Совместные инструкции/VS Code workspace
установлены в `/var/www/html/kiln-system`; исходные шаблоны — в
`deploy/admin-menu/workspace/`. Resume отбирает только сайт/бот/общий корень,
без глобального `--all`; процедуру и безопасные тесты см. README этого меню.
В списке выводятся безопасно очищенные name/title вместо UUID; схема индекса
проверяется read-only. Переоткрытие меню применяет это изменение сразу.
Resume явно восстанавливает сохранённые права; --add-dir используется только
при workspace-write. Ошибка дополнительных roots в режиме default read-only
устранена без изменения глобальной конфигурации Codex.

Для этой рабочей копии сначала обновить совместимый бот и его MariaDB schema:
booking_deposits, booking_cancellations, bookings.sbis_snapshot. Новые заявки
заказов получают payment policy 3; версии 0/1 сохраняют прежнее поведение.
Новых миграций PostgreSQL/секретов нет. См. OPERATIONS.md бота и общий
docs/AUDIT_INDEX.md. Наличие файлов не означает, что production обновлён.

Совместное Gum-меню описано в deploy/admin-menu/README.md. Перед выпуском
обязательны обе резервные копии, проверка миграции на копии и закреплённые
rollback-образы. Пункт rollback меняет только приложения, не данные. Старый
бот не обслуживает новые deposit состояния: перед его откатом разобрать
активные платежи, не восстанавливать старую БД поверх новых финансовых событий.
HTTP/браузерные offline проверки не заменяют согласованные реальные оплату,
refund, кассу и курьера: docs/PRODUCTION_MANUAL_TEST_PLAN.md.

Перед выпуском прочитайте `AGENTS.md` и `TECHNICAL_CONTEXT.md`. Команды ниже
предназначены для production-каталога `/var/www/html/kiln`; секреты находятся
в `.env.production`, имеют права `600` и не выводятся в журнал/чат.

## Текущая топология

- Ветка: `feat/menu-postgres-yandex-feed`.
- Compose-файл: `docker-compose.production.yml`, project `kiln`.
- `kiln-app-1`: Next.js, host `127.0.0.1:3100` -> container `3000`.
- `kiln-postgres-1`: PostgreSQL 17 во внутренней сети `kiln_internal`, volume
  `kiln_kiln_postgres`.
- `kiln-bot-bot-1`: бот из `/srv/kiln-bot`, доступный приложению как
  `http://bot:8383` по сети `kiln_bot_api`.
- Apache принимает HTTP/HTTPS на `80/443`, перенаправляет bot-owned маршруты
  на `127.0.0.1:8383`, остальные — на `127.0.0.1:3100`.
- Сертификат `kiln.spb.ru` покрывает `kiln.spb.ru`, `kiln.beer`, `kiln.bar` и
  `xn--h1adei.xn--90a1af.xn--p1ai`.

Не направляйте `BOT_API_BASE_URL` на публичный `https://kiln.spb.ru`: это
создаёт лишний круг через Apache и смешивает приватный API с публичной
маршрутизацией.

## Первичная установка

```bash
git clone https://github.com/qwantru/kiln.git /var/www/html/kiln
cd /var/www/html/kiln
git switch feat/menu-postgres-yandex-feed
cp .env.production.example .env.production
chmod 600 .env.production
```

Заполните уникальные `POSTGRES_PASSWORD`, `DATABASE_URL`, `ADMIN_LOGIN`,
`ADMIN_PASSWORD_HASH`, `AUTH_SECRET` и совпадающий с ботом `BOT_API_KEY`.
Пароль администратора хешируется командой
`npm run admin:hash -- 'длинный-случайный-пароль'`; исходный пароль не хранится
в репозитории. В штатной Docker-схеме задайте `BOT_API_BASE_URL=http://bot:8383`.

Бот должен уже создать внешнюю сеть `kiln_bot_api`. Проверьте её перед
запуском, затем соберите приложение:

```bash
docker network inspect kiln_bot_api >/dev/null
docker compose --env-file .env.production -f docker-compose.production.yml config --quiet
docker compose --env-file .env.production -f docker-compose.production.yml up -d --build
docker compose --env-file .env.production -f docker-compose.production.yml ps
```

Контейнер приложения применяет checked-in миграции перед запуском Next.js.
Первый production-запуск допустим только после резервной копии или на пустой
БД.

## Apache и TLS

Включите необходимые модули и подготовьте webroot Certbot:

```bash
sudo a2enmod proxy proxy_http headers ssl rewrite
sudo mkdir -p /var/www/kiln-acme/.well-known/acme-challenge
sudo chown -R www-data:www-data /var/www/kiln-acme
sudo cp deploy/apache/kiln.conf /etc/apache2/sites-available/kiln.conf
sudo a2ensite kiln.conf
sudo apachectl configtest
sudo systemctl reload apache2
```

Выпустите сертификат:

```bash
sudo certbot certonly --webroot -w /var/www/kiln-acme \
  --cert-name kiln.spb.ru \
  -d kiln.spb.ru \
  -d kiln.beer \
  -d kiln.bar \
  -d xn--h1adei.xn--90a1af.xn--p1ai
sudo certbot renew --dry-run
```

После выпуска сертификата:

```bash
sudo cp deploy/apache/kiln-ssl.conf /etc/apache2/sites-available/kiln-ssl.conf
sudo a2ensite kiln-ssl.conf
sudo apachectl configtest
sudo systemctl reload apache2
```

Перед копированием всегда сравнивайте tracked vhost с действующим файлом:
маршруты `/api/order` и `/api/booking` должны оставаться на сайте, а только
`/api/ma/`, `/o/`, `/z/`, `/pay/`, `/cal/`, `/dv/`, `/media/` и `/health`
направляются в бот.

## Обновление

При выпуске изменений истории заказов сначала обновите совместимый бот и его
контракт, проверьте `GET /api/history/{phone}` и только затем пересобирайте сайт.
Проверьте, что история содержит `reference`, видимый `order_id`, `items` и
`details_pending`, а операторская карточка принимает `attach_existing_order`.
Для pending-заявки дополнительно проверьте `total_source=submitted_items`,
кнопку изменения состава и замену с прежним `client_ref`; после подтверждения
изменение должно завершаться 409 без второго заказа.
Для клиентских действий дополнительно проверьте флаги `can_cancel`,
`can_change_due`, `can_edit_items`: неоплаченный текущий заказ отменяется с
сохранением записи в истории, оплаченный и завершённый возвращают запрет, а
старая `pay_url` не показывается при `can_pay=false`. Расчёт доставки проверяйте
после обновления бота: production endpoint Достависты и токен должны относиться
к одной среде. Сначала выпустите совместимый бот с `quote_mode=checkout` и
`POST /api/catalog/availability`, затем сайт. Проверьте адреса в пешей и
автомобильной зонах на subtotal ниже/equal/выше minimum и freeFrom: UI не
показывает имя зоны, старый quote исчезает при смене адреса/корзины, а
самовывоз остаётся доступен на любой ненулевой subtotal и показывает адрес.
После post-payment обновления дополнительно проверьте, что свежий ответ бота с
`paid=true` даёт сайту `can_pay=false` и `pay_url=null`; браузер не должен
создавать повторную оплату или самостоятельно запускать внешние side effects.
Проверьте клиентскую ленту recovery-заказа: устаревшее «не оплачен» и ложное
«заказ изменён» не показываются, paid стоит по времени документа СБИС, а все
даты отображаются в `Europe/Moscow` независимо от timezone браузера/контейнера.
После выпуска переключателя Достависты проверьте в admin settings, что текущий
mode остаётся PROD, TEST/PROD показывают только boolean настроенности, а
operator session не имеет доступа к API переключения. Payload браузера не
должен содержать endpoint или credentials. Без боевой доставки переключите TEST,
выполните согласованный smoke в тестовом API, верните PROD и убедитесь, что
TEST-доставка продолжает читаться/отменяться через TEST badge и credentials.
Проверьте также недостаточное количество: бот возвращает `stock_changed` без
создания документа, а checkout сохраняет проблемную строку для исправления.
При выпуске исправления идентичности каталога сначала обновите бот, затем сайт.
После первой синхронизации убедитесь, что активные привязки используют
`sbis_id` номенклатуры, старые привязки по `position_id` закрыты с причиной
`catalog_position_id_migrated`, а `sbis_sync_state.last_error` пуст.
Преобразование collation MariaDB и восстановление осиротевшего заказа выполняются
по `/srv/kiln-bot/OPERATIONS.md`, после отдельного backup и проверки на копии.

1. Проверьте чистоту рабочей копии и remote, не скрывая локальные изменения:

```bash
git status --short
git branch --show-current
git fetch origin feat/menu-postgres-yandex-feed
git log --oneline --decorate -5
git diff --stat HEAD..origin/feat/menu-postgres-yandex-feed
```

2. До миграций создайте дамп в защищённый каталог вне репозитория. Имя файла
   должно содержать дату и текущий commit. Пример запуска `pg_dump` без вывода
   пароля:

```bash
install -d -m 700 /var/backups/kiln
set -o noclobber
docker compose --env-file .env.production -f docker-compose.production.yml \
  exec -T postgres sh -lc 'pg_dump -U "$POSTGRES_USER" -d "$POSTGRES_DB" -Fc' \
  > /var/backups/kiln/site-before-update.dump
test -s /var/backups/kiln/site-before-update.dump
```

Для выпуска адресной книги до запуска приложения проверьте миграцию
`0014_customer_addresses.sql` на копии БД: повторный запуск должен быть
идемпотентным, существующие пользователи и заказы не изменяются. Rollback до
начала пользовательской записи — удаление только новой таблицы и её индексов;
после появления адресов rollback выполняется восстановлением проверенного дампа
или совместимым откатом приложения без удаления таблицы.

3. Выполняйте только fast-forward и пересборку:

```bash
git merge --ff-only origin/feat/menu-postgres-yandex-feed
docker compose --env-file .env.production -f docker-compose.production.yml \
  up -d --build
```

4. Проверьте контейнеры, health и маршрутизацию, явно обходя системный proxy
   для localhost:

```bash
docker compose --env-file .env.production -f docker-compose.production.yml ps
docker compose --env-file .env.production -f docker-compose.production.yml logs --tail 200 app
curl --noproxy '*' -fsS http://127.0.0.1:3100/api/info >/dev/null
curl --noproxy '*' -fsS http://127.0.0.1:8383/health >/dev/null
curl -fsS https://kiln.spb.ru/ >/dev/null
curl -fsS https://kiln.spb.ru/favicon.svg?v=2 | grep -q '<svg'
curl -fsS https://kiln.spb.ru/favicon-v2.png >/dev/null
```

После выпуска графики дополнительно проверьте шапку на ширине 320 px и favicon
в новой вкладке: SVG должен быть первым icon в HTML, а Apple/PWA-иконки должны
показывать тот же знак с вилкой и ножом.

При ошибке не правьте production-БД вручную. Остановите выпуск, сохраните логи
и верните предыдущий commit/image по заранее проверенному rollback-плану. Если
миграция изменила данные, восстановление выполняется из проверенного дампа с
учётом возникших после него пользовательских операций.

При выпуске многосоставных броней сначала сделайте backup MariaDB и на копии
проверьте идемпотентное создание/расширение `bookings`,
`booking_table_groups`, `booking_table_assignments`, `booking_payment_events`
и `booking_group_events`. Сначала выпустите бот с актуальным контрактом, затем
сайт. После запуска проверьте read-only карту столов и одной согласованной
безопасной тестовой бронью подтвердите запись любого числа столов одним
документом СБИС, обязательный readback, изменение и отмену. Отдельно проверьте
один тестовый аванс: повторный sync не должен создавать второе событие или
сообщение. Rollback приложения выполняется предыдущим image/commit; новые
таблицы аддитивны и не удаляются, созданные документы СБИС вручную не
пересоздаются и не исправляются.

## Retention ПДн

```bash
sudo cp deploy/systemd/kiln-pdn-maintenance.* /etc/systemd/system/
sudo systemctl daemon-reload
sudo systemctl enable --now kiln-pdn-maintenance.timer
sudo systemctl start kiln-pdn-maintenance.service
systemctl status kiln-pdn-maintenance.timer kiln-pdn-maintenance.service
```

Worker идемпотентен, использует PostgreSQL advisory lock и пропускает аккаунты
под legal hold. Предупреждения о lock проверяйте по логам и соединениям; не
подавляйте их без установления причины.


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

Для исправлений черновика бронирования миграций и изменений бота/env нет.
Проверка UI: `TEST_BASE_URL=http://127.0.0.1:<test-port> node scripts/check-booking-form-ui.mjs`
на изолированном сайте/БД; все API браузера перехватываются синтетическими
fixtures, настоящая бронь не создаётся. Скрипт проверяет desktop/mobile,
закрытие тремя способами, время при смене длительности, стабильные отступы,
гостей, ошибку отправки и очистку после успеха.


Календарь новых броней: Москва, сегодня..+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.

## Фактический выпуск Android — 9 ноября 2026

Бот e4d1bcd, сайт 3f03e3c выпущены в этом порядке. Счётчики ранее отдельно
выпущены d8698c6/191ff9b. APK подписан и доступен по
https://kiln.spb.ru/uploads/apps/kiln-operator-0.1.0.apk .
Production smoke: health/menu/booking/operator/activity/APK — 200, закрытый
dashboard и native API — 401, анонимный WebSocket upgrade — 403. Скачанный
APK совпадает по SHA-256. Логи без traceback/unhandled/fatal; миграционное
сообщение DropErrorMsgNonExistent штатное. Образы сверены с исходниками.
Backup обеих БД проверен восстановлением на изолированных сервисах; миграции
каждой БД выполнены дважды на production-копии. Feature flags включены, WSS
проксируется Apache. Manifest/smoke/log/lint и закрытая копия ключа подписи:
/var/backups/kiln-system/android-20261109. Резервные копии доступны только root.
Реальные устройства, первый email-вход и фоновая доставка на телефонах ещё
проверяются владельцем вручную. Платные операции и запись в СБИС не выполнялись.

## Ручное бронирование на несколько столов — 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 — 9 ноября 2026

Сайт dcb716d, бот 3a763db с последующим исправлением маршрута a783455 выпущены.
Readonly production-проверка 23249: 4 выбранных стола, сумма вместимости и
рассадки 21, все собственные столы доступны, основной стол сохранён. Параметры
в СБИС не менялись. Исходная ошибка была самоблокировкой и UI-проверкой
полной вместимости на каждом промежуточном выборе, не нехваткой 21 места.

316 тестов бота с реальной изолированной MariaDB без пропусков; сайт 63 pass,
1 opt-in email skip; typecheck/lint/build. Chromium/Firefox 1440/390: текущий
набор, последовательное добавление, исправление неверного набора и save pass.
После исправления catch-all проверены настоящие ASGI/HTTP маршруты регистрации
и полная native auth цепочка с отдельными PostgreSQL/MariaDB (без SMTP).
Код одноразовый; ранее погашенный при неудачной регистрации код нужно запросить
заново. Production invalid UUID — 400; health/menu/booking/operator/info — 200.
Новых schema/env миграций нет. Backup и rollback images:
/var/backups/kiln-system/table-repair-20261109, kiln-table-rollback-bot:20261109
и kiln-table-rollback-site:20261109. Для отката оставить новые JSON-поля: старый
код их игнорирует. Бизнес-БД не восстанавливать поверх текущих операций.

## APK 0.1.1 опубликован — 9 ноября 2026

Сборка GitHub успешна, source 76678f4, assembleRelease + lintDebug, 71 tasks:
https://github.com/wolk-tambowskij/kiln-bot/actions/runs/42655983465 .
Постоянный сертификат прежний (e0ffd20a711fbfa214b6371b0b070926331b03d17f040a37ee650b32109d290f),
v2/v3 подписи проверены; Android 7+/SDK24 и target35 сохранены, versionCode=2.
Скачать: https://kiln.spb.ru/uploads/apps/kiln-operator-0.1.1.apk
SHA-256: 5240e83c36a8574e566b26ab84930c51b79fd3172aee45307c20321955fbcba6 .
Проверено скачивание production файла и точное совпадение SHA-256.
Новый APK ставится поверх предыдущего; сайт и bot login fix уже выпущены.
Физические диалоги батареи, unused permissions и отображение badge конкретным
лаунчером проверяет владелец вручную. Android выбирает число/точку; бесшумный
сводный канал счётчика не является новой входящей тревогой.

По явному запросу владельца снят исчерпанный лимит 3 отправок/час только для
Android входа: три погашенных challenge архивированы отдельным purpose
operator_android_reset_20261109, каждая операция записана в admin_audit_events.
Исходные timestamps/attempts/consumed_at и сами записи сохранены; старые коды
не оживляются. Квота текущего purpose после операции — 0; обычные operator,
client/admin OTP и активные сессии не менялись. Backup до операции:
/var/backups/kiln-system/table-repair-20261109/before-android-quota-reset.sql.gz.

## Рабочая панель 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/секреты без изменений.

## Фактический выпуск 0.1.2 — 9 ноября 2026

Бот 33f47ec выпущен перед сайтом b501b83; исправление повтора после наступления
времени бронирования проверено отдельным SQL сценарием. 319 тестов бота с SQL
без пропусков; сайт 63 pass, 1 opt-in skip; production build/typecheck/lint pass
(старое предупреждение next/image). Chromium/Firefox 1440/390: disabled baseline,
последовательная рассадка, save и возврат к baseline pass. Дополнительный браузерный
прогон проверил отсутствие storefront и сохранение черновика новой формы.

Миграция дважды применена к восстановленной production MariaDB; старые события
не backfill. Образы kiln-operator-012-bot/site сверены с исходниками. Health,
menu, operator, operator/app и info — 200; anonymous create —401. Native UA
в production HTML не получает публичную шапку/подвал. Smoke не создавал броней
и не изменял СБИС, не отправлял платных операций или реальных email-кодов.

APK source ec018c1 собран в GitHub, assembleRelease и lintDebug success:
https://github.com/wolk-tambowskij/kiln-bot/actions/runs/42668624897 .
Скачать: https://kiln.spb.ru/uploads/apps/kiln-operator-0.1.2.apk
SHA-256: daabcc6b78163b02ee06f1f5117a7ff294b21f5f17d7be56a52671b9192ea8f0
Прежний сертификат e0ffd20a711fbfa214b6371b0b070926331b03d17f040a37ee650b32109d290f,
v2/v3 проверены. Версия 3/0.1.2, min24/target35, без Google Play Services.
APK скачан из production и сверен. Физические телефоны, уведомления и диалоги
проверяет владелец вручную; автоматизированная проверка не является device E2E.

Backup и release manifest: /var/backups/kiln-system/operator-012-20261109.
Rollback images kiln-012-rollback-bot:20261109 / kiln-012-rollback-site:20261109.
При откате удалить только новый trigger activity_author_read_v1, вернуть образы;
nullable operator_request_ref и уже созданные receipts/бронирования оставить.
Не восстанавливать старый дамп поверх новых бизнес-операций.

## Иконка и поля бронирования — 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 всегда уже включает бронирующего; плюс один не прибавляется.

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

## Выпуск 0.1.3 — выполнен 11 ноября 2026

Бот ec315a9, сайт 4f2eb34 (браузерный тест 7f9e877). Финальные образы
kiln-icon-013-bot/site. 319 тестов бота на изолированной MariaDB без пропусков;
сайт 64 pass, 1 opt-in email skip. Production build/TypeScript/lint pass
(прежнее предупреждение next/image). Chromium/Firefox 1440/390: дата/время,
disabled до выбора даты, склонения, очистка числа, черновик и публичный hint pass.
Реальные HTTP обработчики изолированного сайта: staff first12:05, client13:00
при server_time12:00; без авторизации staff slots401. Providers заменены
локальным read-only fixture, реальная рассылка и записи в СБИС не выполнялись.

APK source0ec689d; GitHub release/lint и проверка настоящих aapt2 ресурсов PASS:
https://github.com/wolk-tambowskij/kiln-bot/actions/runs/43021412588 .
Подписанный APK также проверен локально: bitmap во всех launcher-конфигурациях,
5 PNG-плотностей; min24/target35, versionCode4, прежний сертификат/v2/v3.
https://kiln.spb.ru/uploads/apps/kiln-operator-0.1.3.apk
SHA-256 a3040d8b9919b918ce82f06efa5759d70dfad2cfb1e65496f62856f46f84120f
Скачивание production файла и hash проверены. Данные приложения при установке
поверх предыдущего APK сохраняются. Форма/кэш иконки в реальном launcher и
обёртка AOSP/OEM остаются ручной проверкой владельца; приложение не является
лаунчером и не изменяет системный IconProvider.

Backup/manifest: /var/backups/kiln-system/icon-013-20261111. Rollback images:
kiln-013-rollback-bot:20261111, kiln-013-rollback-site:20261111. Schema/env/API
создания не менялись; routine rollback — образы, без восстановления business DB.
Smoke health/menu/booking/operator/app/info/APK200, anonymous staff slots401.

## 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.
