# Технический контекст KILN website

Montserrat в root layout использует `preload: false`: Next.js больше не
добавляет font preload в HTML/Link header. CSS, веса 400/600/800 и 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).

## Обновление cart/payment, 6 ноября 2026

`cart-storage.ts` сохраняет live cart/comment и undo с абсолютным expiresAt
180 секунд; успешный submit очищает без undo. Stock polling в CartProvider:
15 секунд, visible only, abort stale request, immediate visibility return.
Неизвестные блюда не исчезают. menu-db сохраняет deliveryAllowed/pickupAllowed
отдельно от mutable stock availability, чтобы свежий остаток не снимал
редакционный запрет и мог вернуть доступность после восстановления остатка.
OrderStatusView всегда POST-ит payment; site API санитизирует разрешённые
ошибки. GET pay_url ведёт в карточку #payment, настоящий URL — только POST.
Проверка cached link в боте fresh, с Sale.Check собственного заказа.
Policy 3 для новых заявок фиксирует старт оплаты/дедлайн; существующие
policy tables сохраняются, добавлена booking_refunds. Новых PG/env изменений нет.
Точная механика и ограничения: docs/CART_AND_PAYMENT.md и bot docs/ORDER_POLICY3.md.

Совместное Gum-меню использует отдельный выбор сессий по точным cwd сайта,
бота и `/var/www/html/kiln-system`. Общий `codex resume --all` удалён:
он включал посторонние проекты. История читается только как служебные
метаданные read-only, UUID перепроверяется перед resume. Общий контекст имеет
собственный AGENTS.md. Resume явно восстанавливает сохранённые sandbox/approval;
--add-dir используется только при workspace-write. Full access не получает
избыточных roots; read-only не повышается. NO_PROXY сохраняет localhost bypass.
Видимые названия берутся из name/title только разрешённых cwd; UUID остаётся
скрытым значением выбора. Текст разговоров/preview не читается.

Сервер: отдельная openai-domain-router.service маршрутизирует только
chatgpt.com/openai.com и поддомены через прежний proxy, без изменений
Codex/Xray/контейнеров. Устройство, проверки и ограничения DNS/UDP:
deploy/openai-domain-router/README.md. Это не часть API KILN.

Рабочая копия: операторский фильтр даты использует видимый native input,
применяется при изменении и имеет сброс. Кнопка отмены неоплаченного заказа
приходит из operator actions бота и требует текст причины.

Карточки сайта и Mini App отображают аддитивное `payment_deadline_at` в
московском времени. Новые policy 2 отменяются общим verified workflow после
15 минут сегодня / 3 часов на последующие даты; policy 1 только уведомляет.
BookingPaymentConditions используется формой, статусом, Mini App и оператором.
Preview получает сумму/условия с backend, принятая бронь хранит frozen policy.
Admin settings меняет B/k через защищённый proxy; оператор прав на это не имеет.
Отмена брони доступна при любом активном статусе/оплате; своевременный refund автоматический по СБИС, поздний решает ресторан.
Полные сведения обоих проектов: `docs/AUDIT_INDEX.md` и документы бота.

Актуальность кода и выкладки проверена 6 ноября 2026 года в ветке
`feat/menu-postgres-yandex-feed`.

## Назначение и границы

Сайт — Next.js-приложение ресторана: публичные страницы и меню, корзина и
checkout, бронирование, личный кабинет, административная и операторская панели,
а также интерфейс Telegram Mini App `/ma`.

Сайт не реализует протоколы СБИС, Достависты, Telegram/MAX, SMS и SMTP. Этими
интеграциями владеет `/srv/kiln-bot`; сайт обращается к нему только со своего
backend по контракту `/srv/kiln-bot/api_site_contract.md` с `X-Api-Key`.

## Стек и основные точки входа

- Next.js 16 App Router, React 19, TypeScript, Node.js 22.
- PostgreSQL 17; схема Drizzle в `src/db/schema.ts`, последовательные SQL-
  миграции в `drizzle/`, runner — `scripts/migrate-db.mjs`.
- Маршруты и server API — `src/app`; UI — `src/components`.
- Статический конфиг ресторана и feature flags — `src/config/site.ts`.
- Работа с ботом и DTO — `src/lib/bot-api.ts`.
- Меню и снимки СБИС — `src/lib/menu-db.ts`, `src/lib/sbis-catalog-sync.ts`.
- Аутентификация и роли — `src/lib/auth.ts`, `admin-auth.ts`,
  `operator-auth.ts`.
- Публичные assets — `public/`; загружаемые изображения production —
  `/var/www/html/kiln/uploads`, примонтированный в контейнер.
- Шапка использует `public/brand/kiln-logo-content.webp`; favicon использует
  SVG с вилкой и ножом и согласованные растровые fallback-иконки `*-v2.png`.

## Владение данными

| Данные | Источник истины |
| --- | --- |
| Цена, наличие, остаток, вес из СБИС | СБИС через бот |
| График, способы получения, зоны и тарифы | СБИС через бот |
| Заказ, бронь, оплата, доставка и переписка | Бот/MariaDB и внешние сервисы |
| Редакционные название, описание, фото, аллергены | Сайт/PostgreSQL |
| Привязки карточек и снимок каталога СБИС | Сайт/PostgreSQL |
| Пользователи сайта, роли, сессии, согласия и сохранённые адреса | Сайт/PostgreSQL |
| Telegram/MAX-привязки и Mini App-сессии | Бот/MariaDB |
| Рейтинг и количество отзывов | Кэш данных Яндекса с last-good fallback |

PostgreSQL также содержит попытки создания заказов, аудит административных
операций, настройки сайта и очередь обработки жизненного цикла ПДн. Завершённые
документы нельзя изменять вслед за карточкой меню.
Каталог различает `sbis_id` номенклатуры и служебный `position_id` строки
прайса. При переходе со старой идентичности синхронизация атомарно закрывает
прежнюю активную привязку и создаёт новую, не удаляя историю; неоднозначность
останавливает транзакцию и требует ручного разбора.

## Основные потоки

### Заказ

Сайт получает каталог и условия из бота, валидирует форму, сохраняет один
`client_ref` и вызывает бот. Бот повторно проверяет СБИС и либо создаёт заказ,
либо сохраняет заявку на подтверждение рестораном. Сайт показывает состояние и
polling по тому же `client_ref`; платёжная ссылка всегда приходит от бота.
Личный кабинет также использует этот стабильный reference, поэтому pending-
заявка остаётся на той же странице после подтверждения. Страница опрашивает
статус каждые пять секунд, пока заказ не завершён. `client_ref` служит только
для маршрутизации: интерфейс показывает номер СБИС, а до его появления —
«Заявка на заказ». История получает от бота сохранённый состав и сумму; сайт
добавляет фотографии по устойчивой связи `sbis_id` с локальной карточкой.
Pending-заявка показывает клиенту и оператору снимок отправленной корзины и
сумму позиций (не финальный итог СБИС). До подтверждения рестораном клиент
может вернуть этот снимок в корзину и заменить состав с тем же `client_ref`;
после начала подтверждения изменение отклоняется без создания дубля.

Бот возвращает `can_pay`, `can_cancel`, `can_change_due` и
`can_edit_items`; сайт не вычисляет эти разрешения самостоятельно. Отмена
неоплаченного заказа — серверный переход состояния в СБИС/боте, а не удаление
записи: завершённые и оплаченные заказы остаются неизменяемой историей. Кнопка
связи открывает чат в подробной карточке заказа.

Payment state ортогонален operational status. Бот нормализует полную оплату
по свежему документу СБИС; после неё polling получает `paid=true`,
`can_pay=false`, `pay_url=null`, даже если заказ уже находится в приготовлении,
поиске курьера либо recovery. Сайт не интерпретирует сырой `PayState` и не
запускает приготовление, печать или Достависту из браузера.
MariaDB timestamps приходят как ISO 8601 UTC (`Z`), а ресторанные due/eta и
время событий СБИС — с `+03:00`; UI форматирует их строго в
`Europe/Moscow`. При `stale_payment_recovery` клиентский status берётся из
этапа СБИС, а внутренний `needs_operator` остаётся только операторским сигналом.

Адресная книга хранится в `customer_addresses`, принадлежит пользователю сайта
и использует мягкое удаление через `archived_at`. В checkout сохранённый адрес
показывается строкой; выбор, добавление, редактирование и архивирование находятся
в модальном окне. Гость продолжает вводить адрес в форму без сохранения.
Стоимость доставки запрашивается у бота после выбора адреса; зона и тариф
остаются данными СБИС, а геокодирование выполняет сервис доставки.
Публичный `/api/delivery/quote` передаёт боту явный `quote_mode=checkout` и
subtotal блюд. HTTP 400 `min_sum` разбирается как корректный бизнес-результат с
`minOrder`, `deliveryFee`, `freeFrom`, `shortfall` и total; остальные 4xx/5xx —
ошибка расчёта. Quote связан ключом нормализованного адреса и subtotal, поэтому
при их смене прежний тариф исчезает немедленно. Checkout разрешает доставку
только при актуальном успешном quote и `subtotal >= minOrder`; стоимость
доставки в minimum не входит. Самовывоз игнорирует delivery minimum, а адрес
получает из централизованных contact settings.

Каталожная проекция запускается demand-driven с окном 45 секунд. Бот отделяет
30-секундный stop-list cache от 120-секундных метаданных каталога; поэтому
нормальный верхний возраст availability на общей витрине около 75 секунд.
`available=null`/ошибка stop-list не перезаписывает последнюю успешную
availability в PostgreSQL. Открытые `/cart` и `/checkout` дополнительно
вызывают `/api/cart/availability` сразу и каждые 15 секунд, включая сравнение
запрошенного количества с `stock_left`. Этот снимок — UX: сервер заказа не
отклоняет заявку только из-за потенциально устаревшей PostgreSQL-проекции, а
бот делает свежую целевую проверку СБИС непосредственно перед созданием.

Показ необязательного маркетингового согласия управляется ключом
`site_settings.marketing_enabled`; значение по умолчанию — `false`.

Административная вкладка «Настройки» читает и меняет среду Достависты через
защищённый site route `/api/admin/settings/dostavista`. GET требует admin
session, PATCH дополнительно требует admin CSRF; операторской роли route и UI
недоступны. Route передаёт внутренний ID администратора боту и никогда не
принимает URL или credentials из браузера. UI получает только mode
`test|production` и boolean настроенности каждой среды. Переключение на
production требует подтверждения; badge в операторском списке и карточке
заказа остаётся read-only и показывает `delivery_provider_env` конкретной
доставки. Владельцем endpoint, секретов, callback validation и delivery
lifecycle остаётся бот.

Форма входа оператора не содержит рабочего email в HTML/клиентском state.
`/api/operator/request` и `/api/operator/verify` выбирают фиксированный адрес
на сервере; браузер отправляет только пустой request и шестизначный код.

### Бронирование и сообщения

Сайт передаёт заявку боту. Изменение даты, времени или числа гостей создаёт
запрос, который вступает в силу только после решения ресторана. Сообщения
заказа и брони используют единый архив бота, а не отдельный чат сайта.
Operator API дополнительно предоставляет read-only availability столов из
СБИС: номера, вместимость и предложенные комбинации на московские дату/время.
Начало выбирается с шагом пять минут, длительность — от 30 до 180 минут с
шагом 30 (по умолчанию 120); последний старт задаётся ресторанным расписанием, а бронь
заканчивается не позднее чем через час после него. Пересечение считается по
реальным интервалам без выдуманного технического буфера. Выбранная комбинация
из любого числа столов записывается одним штатным документом СБИС: основной
стол находится в `Location`, полный набор — в `Properties.reservation.tables`.
После записи бот обязательно перечитывает документ и сверяет столы.

Новая заявка от шести гостей получает frozen nonlinear deposit policy.
После выбора свободных столов бот формирует штатную ссылку СБИС и отправляет
через SMTP; сумма/ссылка/deadline/cutoff показываются в общей карточке.
Недостаточная вместимость требует решения оператора до ссылки. Bot sync читает
оплаты, хранит их идемпотентные события и показывает клиенту отдельное
системное сообщение для каждого обнаруженного платежа; свободный комментарий
менеджера источником факта оплаты не является.

Системные timestamps форматируются из UTC, а `due`, booking `dt` и ETA — как
ресторанные значения `Europe/Moscow`. `datetime-local` никогда не трактуется
как timezone браузера или UTC-контейнера: перед Site/Bot API добавляется
явный `+03:00`.

### Аутентификация

Клиентские, административные и операторские сессии разделены. Email PIN
создаёт и проверяет сайт, бот является только SMTP-транспортом. SMS PIN
используется лишь для первого подтверждения телефона. Вход через мессенджер
использует одноразовый nonce и серверный claim API бота.

### Mini App

Страница `/ma` и компоненты интерфейса находятся на сайте. Публичные
`/api/ma/*` направляются Apache непосредственно боту: он проверяет Telegram
initData, связь чата и выдаёт HttpOnly-сессию. Операторская страница сайта
может получить сессию через backend API, не раскрывая `BOT_API_KEY` браузеру.

## Production-топология

```text
Интернет
  -> Apache :80/:443
     -> Next.js 127.0.0.1:3100 (все обычные страницы и API сайта)
     -> Bot 127.0.0.1:8383 (/api/ma, /o, /z, /pay, /cal, /dv, /media, /health)

kiln-app-1 -> PostgreSQL kiln-postgres-1 по сети kiln_internal
kiln-app-1 -> kiln-bot-bot-1:8383 по сети kiln_bot_api
kiln-bot-bot-1 -> MariaDB kiln-bot-db-1 по сети kiln-bot_default
```

Сайт запускается `docker-compose.production.yml` из `/var/www/html/kiln`.
PostgreSQL хранится в Docker volume `kiln_kiln_postgres`, uploads — в каталоге
хоста. Apache-конфигурации находятся в `deploy/apache`, а ежедневная retention-
задача — в `deploy/systemd`.

## Проверки и известные ограничения

- `npm run typecheck` проходит.
- `npm run lint` проходит с существующим предупреждением `no-img-element` в
  `feedback-dialog.tsx`.
- `npm test` не является автономным: требуется отдельная подготовленная БД,
  generated-файлы импорта и тестовый сайт; тесты выполняют записи в БД.
- В production-логах наблюдались предупреждения PostgreSQL о снятии чужого
  advisory lock при успешном health. Не скрывать их без отдельной диагностики.
- Запросы с некорректным Next.js Server Action ID могут быть внешним шумом;
  оценивать их вместе с частотой, источником и влиянием, а не менять обработку
  по единичной записи.

Выпуск 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.

Identity/activity выпущены 8 ноября 2026: bot-first/site-second, контракт v1.25.
Runtime site `c811823daf95292688ea53f1eec731d8d8f49e7b`, bot
`c84695312c15858292944f90324c2057c50bdc3c`. Финальные образы: сайт 63/63,
Python 252 tests (23 штатных skips), SQL/ASGI на изолированной схеме, Chromium
1440/390 — passed. HTTPS proxy origin CSRF проверен отдельно; receipts имеют
свою квоту и не расходуют прежние 10 клиентских действий/минуту.
Manifest/backup/rollback: `/var/backups/kiln-system/20261108T162538Z/release.json`.
Production smoke и runtime hashes passed; реальный Telegram/paid E2E не заявлен.

Форма бронирования: lazy mount один раз в BookingModalProvider, далее hidden
без потери DOM/состояния. Черновик только в памяти вкладки, успешный submit
очищает controlled/uncontrolled поля. Guests хранится строкой; slots update
сохраняет выбранное время, если оно допустимо для новой длительности. Пустой
preview не создаёт grid-строку; загрузка не удаляет last-good conditions.
Контракт/бот/БД не меняются. Проверки и статус выпуска — в текущем handoff.

Исправления формы бронирования выпущены: runtime site `9b7ab0a444a30c78674e1ea0d48ebf6bcb0038be`.
Финальный образ: build/typecheck, 10/10 booking tests, Chromium 1440/390 и
production smoke/hashes — passed. Бот/контракт/env/схема без изменений.
Manifest и rollback: `/var/backups/kiln-system/20261108T180328Z/release.json`.


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

Контракт v1.26 выпущен: runtime site 9e415a4, bot 702cfdf. Проверки:
254 Python tests (23 штатных skips), 63/63 сайта, build/typecheck/lint,
Chromium 1440/390 в New York и production smoke/hashes PASS. Первый
production sync — 274 даты, failed=0, imported=0. Manifest/backup/rollback:
`/var/backups/kiln-system/20261108T183828Z/release.json`.


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

Бронирования v1.27 выпущены: bot 23d782f, site 390fa79; финальные образы,
260 Python tests (23 skips), 63/63 сайта, Chromium 1440/390 и production smoke
PASS. Backup/manifest: /var/backups/kiln-system/20261108T193620Z/release.json.
R-65707 остаётся на проверке журнала СБИС, без повторного создания.


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

1..9 часов выпущены: runtime bot ceee4a8, site b7a48fd, контракт v1.28.
264 Python tests (23 skips), 63/63 сайта, build/typecheck/lint, Chromium 1440/390
и production slots/smoke PASS. R-32755 отменён по сохранённому запросу;
R-35383 can_cancel=true. Manifest: /var/backups/kiln-system/20261108T200111Z/release.json.

Исправление импорта phone/name/comment/email ручных source=sbis и сохранение
Number при обновлении столов: bot c84101a, сайт без изменений. Подробнее в
[MANUAL_BOOKING_SYNC.md](/srv/kiln-bot/docs/MANUAL_BOOKING_SYNC.md) и shared handoff.

Импорт контактов выпущен: bot c84101a, сайт без изменения runtime. 271 unit
(25 skips), 4/4 isolated MariaDB PASS; normal sync 274 dates/0 failed/0 imports.
В реальной operator card 23140 телефон заполнен и совпал с СБИС; остальные
сверенные поля совпали, confirmed сохранён. Manifest: /var/backups/kiln-system/20261108T205145Z/release.json.


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

Отмена v1.29 выпущена: bot e7279a0/site 12a0e59. R-65707 штатно canceled,
подтверждено в клиентском DTO; исходная дата запроса сохранена. 277 tests
(27 skips), 2 SQL cases, 63/63 сайта, Chromium 1440/390 PASS. Manifest:
/var/backups/kiln-system/20261108T211511Z/release.json. Повтор незавершённой
отмены доступен клиенту; несозданная заявка закрывается после staff attestation.

Обновление 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.
