Skip to content

webdev1881/scale-S2L / .claude/skills/behaviour-logs

behaviour-logs

Verified

Логи и замеры поведения киоска — журнал операций, лог бэкенда, временный журнал касаний, приёмы измерения в браузере и ловушки фоновой вкладки. Использовать, когда «на приборе не работает», нужно доказать причину, а не угадать её.

FileKindSize
SKILL.mdskill md7.9 KB
---
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, когда закрытие клавиатуры
возвращало шапку). Оба раза лечилось одинаково: отложить перестройку экрана до конца
касания. Ищите это первым, когда «нажимается со второго раза» или «нажал одно, получил
другое».
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