Skip to content

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 мс воспроизводится.

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: 196kUpdated 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: 192kUpdated Claude CodeCodexVerifiedInstall
ponytail-debtDietrichGebert/ponytailHarvest every shortcut: comment into one debt ledger, so deferrals get tracked instead of forgotten. One-shot report.Stars: 192kUpdated 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: 192kUpdated Claude CodeCodexVerifiedInstall