Skip to content

webdev1881/scale-S2L / .claude/skills/kiosk-input

kiosk-input

Verified

Ввод в киоске — экранная клавиатура поиска, цифровой блок, поиск по названию и коду, отмена набора, печать по касанию карточки. Использовать при правке Keyboard.vue, Numpad.vue и логики поиска в kiosk/App.vue.

FileKindSize
SKILL.mdskill md23.8 KB
---
name: kiosk-input
description: Ввод в киоске — экранная клавиатура поиска, цифровой блок, поиск по названию и коду, отмена набора, печать по касанию карточки. Использовать при правке Keyboard.vue, Numpad.vue и логики поиска в kiosk/App.vue.
---

# Ввод и поиск в киоске

Экранные клавиатуры свои, системная (squeekboard/onboard) не используется: `Numpad.vue` —
цифры для кода, `Keyboard.vue` — буквы и цифры для поиска, открывается по фокусу в поле
поиска. Раскладка идёт за языком интерфейса.

## Где выезжают панели

- Клавиатура поиска выезжает снизу **внутри колонки каталога** (`position: absolute` в
  `.main`), а не поверх всего экрана: `--s2l-kb-height` задаёт её высоту и нижний отступ
  этой же колонки. Весы остаются видны целиком, сжимается только сетка.
- Пока открыта клавиатура поиска, с экрана уходят весы и итоговая панель, а сетка
  показывает два ряда. Уходит именно шапка: товар ещё не выбран, показание в этот момент
  ничего не решает, а её 186 px нужнее карточкам. Замер на 1920x1080: ряд получает
  299 px против 259 px в обычном режиме — карточек вдвое больше, и каждая не мельче
  прежней. Третьего ряда нет: настройка сетки задаёт размер карточки для полного экрана,
  а клавиатура забирает снизу 340 px (`min(38vh, 340px)`).
- Цифровой блок, наоборот, выходит панелью у правого края блока карточек, ростом ровно
  с него, и под собой ничего не двигает. Сетка не сжимается, столбцы не меняются,
  карточки остаются на своих местах: набор кода — временное состояние каталога, ради
  него незачем перекладывать сетку.
- Затемнения под панелью нет: код набирают, чтобы найти товар, и найденное нужно уметь
  нажать — затемняющий слой перехватывал касания, и карточки переставали выбираться.
  Панель отбивается от карточек тенью, а не заслонкой.
- Как только набранный код оставил **один** товар, панель уходит сама: искали именно
  его, а карточку, накрытую панелью, нажать нельзя. Фильтр при этом остаётся — на
  экране ровно та карточка, ради которой набирали код. Выбор товара тоже закрывает
  панель.
- Панель позиционируется от `.catalog-area` (`position: absolute`), а не от экрана:
  весы, строка поиска и итоговая панель к набору кода отношения не имеют.

## Клавиши

Клавиши обеих панелей шлют события (`key`, `backspace`, `clear`), а строку меняет
владелец состояния. Если читать текущее значение из пропа, два быстрых нажатия в одном
тике прочитают одно и то же старое значение и символ потеряется.

## Поиск

- Поиск по коду динамический: каждая цифра сразу сужает каталог, как и буквы в поиске по
  названию, — кнопка «Знайти» только подтверждает выбор (точное совпадение либо
  единственный оставшийся товар). Набранный код показывается в заголовке каталога:
  строки с ним на экране нет, и без подписи отфильтрованный каталог выглядел бы
  поредевшим сам по себе.
- Выбор товара из результатов по коду проваливает в его группу и снимает фильтр: иначе в
  каталоге осталась бы одна карточка без видимой причины.

## Отмена набора

- Касание мимо поля и клавиатуры отменяет поиск: экран возвращается к состоянию до
  набора (строка, открытая группа, страница — снимок берётся при открытии клавиатуры).
  Касание самих результатов поиском не считается отказом — оно лишь закрывает
  клавиатуру. «Готово» тоже сохраняет результаты.
- **Пейджер не закрывает панели ввода вовсе.** Закрытие возвращает нижнюю панель и
  распрямляет сетку до двух рядов, пейджер уезжает из-под пальца — и `click` прилетает
  уже по кнопке «ПОШУК товару», которая стоит на его месте и открывает клавиатуру
  заново. Со стороны это выглядит так, будто стрелка пейджера вызывает клавиатуру.
  Листание результатов — продолжение поиска, а не отказ от него.
- **Слот действия в нижней панели «касанием мимо» не считается вовсе.** Он сам знает,
  что делать: «Усі товари» снимает набор и закрывает обе панели ввода, «ПОШУК товару»
  открывает клавиатуру. Закрытие панели на `pointerdown` перерисовывало слот, надпись
  под пальцем сменялась, и `click` доставался уже кнопке поиска — нажав «Усі товари»,
  покупатель попадал в поиск. По той же причине `allProducts` закрывает клавиатуру сам,
  а не полагается на обработчик «мимо».
- **Касание карточки клавиатуру не закрывает вовсе** — её снимает сам `selectProduct`,
  когда выбор состоялся. Закрытие на `pointerdown` возвращало шапку и итоговую панель,
  сетка уезжала вниз на 123 px (замер на 1920x1080), и `click` приходил уже по другой
  карточке. Печать идёт от касания, поэтому покупатель получал этикетку на чужой товар —
  или не получал ничего, если под пальцем оказывался промежуток. Пока касание не
  завершилось, на экране не должно двигаться ничего.
- Класс, по которому распознаются результаты, обязан существовать в разметке: с
  устаревшим `.catalog` касание карточки откатывало экран к состоянию до набора, и палец
  попадал уже по другому товару.
- Касание мимо цифрового блока убирает его так же, как касание мимо клавиатуры: касание
  результатов оставляет найденное, всё остальное возвращает экран к состоянию до набора.
  Кнопка, которая блок открывает (`.code-toggle` в шапке), в «мимо» не входит — иначе
  повторное нажатие сначала отменяло бы набор, а потом открывало блок заново.

## Печать

Кнопки печати нет: касание карточки — это и есть заказ этикетки. Покупатель к этому
моменту уже положил товар на платформу, и отдельное подтверждение стоило бы ему лишнего
шага у прибора. Повторное касание печатает снова — например, когда первое пришлось на
неустоявшийся вес.

Причина, по которой печать невозможна («покладіть товар», «зачекайте на стабілізацію»,
ошибка принтера), показывается сообщением в ответ на само касание. Молчать нельзя:
нажатие было, и без ответа прибор выглядит сломанным — а показать причину теперь негде,
кнопки с подписью не осталось.

## Конец покупки

Покупка кончается не по таймеру, а когда покупатель забрал товар: платформа — это
единственный достоверный сигнал, который у прибора есть. Жёсткие восемь секунд показа
этикетки были плохи с обеих сторон — обрывали экран у того, кто ещё отрывает этикетку,
и держали чужую покупку перед тем, кто уже подошёл.

Каталог за диалогом этикетки встаёт начальным **сразу при печати**: группа, поиск,
страница и панели ввода сбрасываются, не дожидаясь конца сессии. Этикетка висит до
двадцати пяти секунд, и всё это время следующий покупатель видел бы чужую страницу с
чужим набранным поиском. Выбранный товар при этом остаётся — цена и стоимость в шапке
и подпись в нижней панели показывают, за что человек заплатит; они обнуляются вместе с
концом сессии.

Касание карточки, с которой печать невозможна, товар не выбирает вовсе
(`blockReasonFor` в `selectProduct`): в нижней плашке остаётся «Товар не обрано», а
причину говорит тост. Иначе рядом с названием висели «0,00 грн» за несуществующий
вес — покупатель читал это как цену. Тара у ещё не выбранного товара своя, поэтому
проверка считает нетто с ней, а не берёт `netG` выбранного.

Штучный товар тоже требует груза на платформе (`kiosk_piece_needs_load`, по
умолчанию включено): цена у него от веса не зависит, но касание карточки при пустой
платформе печатало этикетку мгновенно — и экран уходил к началу, а покупатель не
понимал, что случилось. Порог тут не наименьшая навеска (пучок зелени легче её), а
`PIECE_PRESENCE_G = 5` — выше шума АЦП. Ловушка усиливается данными из 1С: у
заказчика 201 позиция из 449 приходит `piece`, включая явные «кг» вроде «Фізаліс кг»,
потому что реквизит «Весовой» в номенклатуре не проставлен.

Куда встаёт экран после печати — и после того, как товар сняли, — настройка
`kiosk_after_print` (`landAfterPurchase` в `App.vue`): `home` — к началу (по умолчанию:
следующий человек не должен видеть чужую группу и чужой поиск); `catalog` — та же
группа и страница; `search` — она же с открытой клавиатурой. Два последних — для
отдела, где берут по нескольку товаров подряд. Набранный поиск и код снимаются в любом
режиме — они принадлежали предыдущему товару. Снятие товара без печати и простой
ведут к началу всегда.

Сигналов о конце сессии три, и ни один в одиночку не надёжен:

- **Сняли товар** — экран к началу всегда, и после печати, и без неё: так решил
  владелец, пустая платформа значит «покупатель ушёл», и следующий не должен видеть
  чужой выбор. Считается от груза (`hadLoad`): пока платформу ни разу не нагружали,
  пустота ничего не значит — покупатель листает каталог, ещё не положив товар, и
  сбрасывать его каждые полсекунды нельзя. Выдержка `kiosk_clear_hold_s` (0.5 с)
  без ожидания покоя: платформа качается, пока товар снимают, но ниже наименьшей
  навески при этом остаётся. Таймер заводит булево `loaded`, а не сырые отсчёты:
  следя за самим `net_g`, watcher перезаводил таймер на каждом отсчёте, а на пустой
  платформе они гуляют 0↔2 г десять раз в секунду — выдержка не набиралась никогда.
  На симуляторе от `sim 0` до сброса ≈2 с — это осадка пружины модели, на живой
  плате показание падает быстрее.
- **Выбор без груза** — нажали карточку с пустой платформой (печать отказала:
  «положите товар») и ушли: через `kiosk_unselect_s` (5 с, 0 — выключено) выбор
  снимается, каталог остаётся где был. Единственный случай, который правило выше не
  ловит: груза не было.
- **Предел показа** `kiosk_label_max_s` (25 с) — страховка на случай, когда товар не
  сняли вовсе или оборвалась связь с весовой платой. Если предел сработал при занятой
  платформе, экран заодно говорит «Заберіть товар з платформи»: иначе следующий
  покупатель встанет к прибору с чужим грузом на чаше.
- **Касание** отодвигает предел (`bumpIdle`), но не отменяет возврат по снятию товара:
  таймаут отменять положено, а осознанное действие покупателя — нет. Экран не должен
  уходить из-под руки того, кто на него смотрит.

До печати снятие товара сессию **не** завершает: это не «ушёл», а «переложил».

## Размеры клавиатуры

Обе стороны настраиваются в админке и приезжают на прибор без перезагрузки.

Высота — `kiosk_keyboard_height`, проценты высоты экрана (20–50, по умолчанию 32 —
столько же, сколько давала прежняя зашитая `min(38vh, 340px)` на экране 1080).
Предел в пикселях убран: оператор задал долю, и предел спорил бы с ней ровно там, где
её и увеличивают. Значение уходит в `--s2l-kb-height`, которым пользуются двое —
сама клавиатура и нижний отступ каталога под ней (`.main.kb-open`), так что карточки
поджимаются вместе с ней.

Ширина — `kiosk_keyboard_width`, доля ширины каталога (40–100 %, по умолчанию 60).

Шрифт клавиш — `kiosk_keyboard_font` (ключ из `shared/fonts.ts`: system, arial, dejavu,
ubuntu, mono, serif — каждый со своим стеком запасных, потому что на приборе Ubuntu
нет Segoe UI, а на машине разработчика нет Ubuntu), `kiosk_keyboard_font_size` (px,
14–40, по умолчанию 23 — столько давала прежняя `clamp(17px, 2vw, 23px)` на 1920) и
`kiosk_keyboard_bold`. Уходят в `--ui-kb-font`, `--ui-kb-font-size`,
`--ui-kb-font-weight`; в админке под выбором шрифта живой образец тем же кеглем и
жирностью. Ключ хранится в настройках, стек — во фронтенде: CSS в JSON прибора не место.
На экране 1920 клавиатура во всю ширину растягивает ряды так, что до дальних букв
тянутся рукой через весь экран, а узкая держит их под кистью. Задаётся отступами
(`--ui-kb-inset` — половина остатка с каждой стороны), а не `width` с центрированием:
центрирование сдвигом заняло бы `transform`, которым клавиатура выезжает снизу.

## Тайный вход в админку

Семь касаний подряд по плитке «Товар не обрано» (не больше 1.5 с между ними) —
`secretTap` в `App.vue` — уводят прибор на `/admin`. У прибора нет ни клавиатуры, ни
мыши, а открыть админку на месте бывает нужно. Семь — случайно столько не нажмёшь,
оператор делает за три секунды. Пароль спросит браузер, так что покупатель, повторив
жест, дальше окна с паролем не пройдёт; обратно — «Відкрити кіоск» в шапке админки.
Плитка с выбранным товаром жест не ловит: там касание ничего не значит.

## Беда принтера закрывает экран

Кончилась бумага, открыта крышка, устройство пропало — киоск накрывается тёмной
пеленой с сообщением и ждёт, пока починят (`printerFault` в `App.vue`,
`blocking` у `KioskToast`). Такое сообщение не тает по таймеру: покупателю
бесполезно листать каталог, когда этикетку всё равно не напечатать, а тост в углу
он прочтёт и продолжит тыкать.

Состояние спрашиваем опросом `/api/status` раз в три секунды, а не по отказу
печати: о пустом рулоне надо узнать до того, как человек выбрал товар и положил
его на платформу. Потеря связи с прибором сюда не входит — там своя заставка
«Оновлення», и спорить с ней незачем. Проверять на симуляторе:
`POST /api/sim/printer {"paper_out": true}` (с паролем админки — симулятор не киоск).

## Когда тост уходит

Обычное сообщение («Покладіть товар на платформу») снимается, как только вес на
платформе изменился больше чем на наименьшую навеску: покупатель уже делает то, о
чём просили, и держать надпись до конца выдержки незачем. Вес сравнивается с тем,
что был в момент показа (`toastWeight`), а не с прошлым отсчётом: платформа
качается, и пара граммов — не действие покупателя.

«Заберіть товар з платформи» — особый случай (`showToast(..., sticky)`): забытый
товар сам не денется никуда, и следующий покупатель должен видеть, почему прибор
занят чужим грузом. Такой тост не тает по выдержке и не снимается от шевеления
(товар подвинули, доложили ещё) — только от пустой платформы.

Проверять в видимой вкладке: в фоновой браузер душит таймеры, и предел показа
этикетки (`kiosk_label_max_s`), от которого приходит «Заберіть товар», срабатывает
с задержкой до минуты.

## Касание мимо клавиатуры

Узкая клавиатура (ширина меньше 100 %) оставляет полосы экрана слева и справа от
себя. Касание в такую полосу закрывает набор — и тем самым двигает экран: исчезает
отступ под клавиатурой, нижняя панель съезжает вниз, ровно под палец, и `click`
прилетает по «ПОШУК товару». Клавиатура открывалась заново, и выглядело это так,
будто касание рядом с ней её и вызывает.

Лечится тем же `swallowDragClick`, что и клик после протяжки, но с окном 500 мс:
панель встаёт на место только после ухода клавиатуры (переход 0.22 с), а касание
пальцем даёт `click` и через треть секунды после отрыва. Проверять синтетикой с
задержкой между `pointerup` и `click` — при 60 мс ловушка не воспроизводится, при
300 мс воспроизводится.

slack-gif-creatoranthropics/skillsKnowledge and utilities for creating animated GIFs optimized for Slack. Provides constraints, validation tools, and animation concepts. Use when users request animated GIFs for Slack like "make me a GIF of X doing Y for Slack."Stars: 198kUpdated Claude CodeCodexVerifiedInstall
ponytailDietrichGebert/ponytailLazy senior dev mode for any coding task: the smallest change that fully solves it, and a reply a busy human understands in one read.Stars: 194kUpdated Claude CodeCodexVerifiedInstall
ponytail-debtDietrichGebert/ponytailHarvest every shortcut: comment into one debt ledger, so deferrals get tracked instead of forgotten. One-shot report.Stars: 194kUpdated Claude CodeCodexVerifiedInstall
ponytail-debtDietrichGebert/ponytailList every `shortcut:` comment (and older `ponytail:` ones) as a debt ledger. One-shot report, changes nothing. Use for "ponytail debt", "what did ponytail defer", "list the shortcuts", /ponytail-debt.Stars: 194kUpdated Claude CodeCodexVerifiedInstall