webdev1881/scale-S2L / .claude/skills/behaviour-logs
behaviour-logs
VerifiedЛоги и замеры поведения киоска — журнал операций, лог бэкенда, временный журнал касаний, приёмы измерения в браузере и ловушки фоновой вкладки. Использовать, когда «на приборе не работает», нужно доказать причину, а не угадать её.
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 7.9 KB |
SKILL.md
View on GitHub---
name: behaviour-logs
description: Логи и замеры поведения киоска — журнал операций, лог бэкенда, временный журнал касаний, приёмы измерения в браузере и ловушки фоновой вкладки. Использовать, когда «на приборе не работает», нужно доказать причину, а не угадать её.
---
# Логи поведения
Киоск стоит в зале, и жалобы приходят словами покупателя: «срабатывает со второго
раза», «свайп не работает», «этикетка не печатается». Угадывать по описанию дорого —
в этом проекте три подряд правильно звучавшие догадки оказались мимо. Здесь собрано,
что прибор записывает сам, что можно включить на время и как получить доказательство.
## Что записывается постоянно
- **Журнал операций** — таблица `transactions`, видна в админке и через
`GET /api/transactions`. Одна строка на напечатанную этикетку: время (местное, чтобы
совпадало с бумагой), товар, вес, цена, сумма, штрихкод, файл растра. Это
единственный долгоживущий след поведения покупателя.
- **Чего в нём нет**: касаний, выбранных и брошенных товаров, поисковых запросов,
отказов печати. Если понадобится статистика «что смотрели, но не купили» — это новая
сущность, а не расширение журнала операций: тот привязан к факту продажи и на него
ссылается мягкое удаление товаров.
- **Лог бэкенда** — вывод uvicorn. Там видны все запросы и трассировки. Проверять его
стоит раньше, чем лезть в код: `POST /api/print 500` с `sqlite3.OperationalError:
disk I/O error` однажды выглядел как «печать сломалась во фронтенде», а на деле
процесс держал битое подключение к базе после блокировки папки антивирусом.
## Журнал касаний
Для разбора «срабатывает со второго раза» в киоск временно вводится журнал указателя:
слушатели `pointerdown`, `pointerup`, `pointercancel`, `click`, `touchstart`,
`touchend`, `touchcancel` на окне в фазе перехвата, вывод — поверх экрана, включается
`?taps=1` в адресе.
Что из него удалось узнать и чего иначе не увидеть:
- клик может **не родиться вовсе**: `pointerdown` и `pointerup` по карточке в журнале
есть, `click` отсутствует — так проявляется подавление касания после броска;
- клик может **родиться и не дойти**: пишите его дважды, на перехвате (`click↓`) и на
всплытии (`click↑`), и станет видно, что его гасят по дороге;
- `touchstart` с флагом «неотменяемое» означает, что жест забрал себе браузер, и
дальше искать надо в его правилах, а не в нашем коде.
Журнал держат ровно до починки и убирают: он вешает семь слушателей на каждое касание
и рисует поверх всего экрана. В истории он есть — `git log -S "tapsDebug"`.
## Ловушки измерения в браузере
Проверять киоск удобно через браузерную автоматизацию, но **фоновая вкладка врёт**, и
врёт правдоподобно. `document.visibilityState === 'hidden'` — и тогда:
- `requestAnimationFrame` не идёт: переходы Vue не доигрывают, уходящие элементы
копятся в DOM. Насчитать «две ленты вместо одной» и пойти чинить утечку — потеря
вечера;
- таймеры зажимаются до секунды, а после пяти минут в фоне — до минуты: полуторасекундная
выдержка «платформа освободилась» срабатывает с задержкой, и кажется, что не работает;
- `loading="lazy"` не грузит **ничего**: пересечения с вьюпортом не вычисляются;
- синтетический `left_click_drag` шлёт `pointermove` без `pointerdown` — жест не
начинается, и любой свайп «не работает».
Отсюда правило: прежде чем поверить измерению, спросите `document.visibilityState`, а
жесты проверяйте синтетическими `PointerEvent` — они честнее псевдо-мыши.
## Приёмы замера
- **Экран прибора** воспроизводится так: корню задаются 1920x1080 и `transform: scale()`
для обзора, а `--s2l-kb-height` выставляется значением для 1080 (340 px) — это
единственная величина в вёрстке, завязанная на `vh`.
- **Живая лента** среди уходящих: `[...document.querySelectorAll('.track')]
.find(t => !/leave/.test(t.className))`. Без этого замеры идут по уходящей копии, и
клики попадают в мёртвые элементы.
- **Геометрию считайте в слоях**: `getBoundingClientRect()` под `scale()` делится на
масштаб, а `getComputedStyle` возвращает уже честные пиксели раскладки — для долей и
порогов берите второе.
- **Весы гоняются через `/api/sim/weight`**: положить груз, качнуть, снять. Симулятор
качается затухающим колебанием, поэтому им проверяется и «зачекайте на стабілізацію»,
и конец сессии по освобождению платформы (см. скилл `hardware-hal`).
## Правило, которое эти логи выявили
**Пока касание не завершилось, на экране не двигается ничего.** Между `pointerdown` и
`click` браузер решает, по какому элементу отдать клик; если раскладка успела съехать,
клик уходит соседу или растворяется в общем предке. Так ломались пейджер при открытой
клавиатуре и печать по карточке (сетка уезжала на 123 px, когда закрытие клавиатуры
возвращало шапку). Оба раза лечилось одинаково: отложить перестройку экрана до конца
касания. Ищите это первым, когда «нажимается со второго раза» или «нажал одно, получил
другое».
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: 198k | 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: 194k | 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: 194k | 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: 194k | Updated | Claude CodeCodex | Verified | Install |