webdev1881/scale-S2L / .claude/skills/kiosk-input
kiosk-input
UnverifiedВвод в киоске — экранная клавиатура поиска, цифровой блок, поиск по названию и коду, отмена набора, печать по касанию карточки. Использовать при правке 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 мс воспроизводится.
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| 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: 196k | Updated | Claude CodeCodex | Verified | Install |
| 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: 192k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-debtDietrichGebert/ponytailHarvest every shortcut: comment into one debt ledger, so deferrals get tracked instead of forgotten. One-shot report. | Stars: 192k | Updated | Claude CodeCodex | Verified | Install |
| 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: 192k | Updated | Claude CodeCodex | Verified | Install |