webdev1881/scale-S2L / .claude/skills/device-settings
device-settings
VerifiedНастройки устройства в settings.json, пути и конфигурация бэкенда. Использовать при добавлении настройки, правке settings_store.py, .env, путей к базе и данным.
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 4.9 KB |
SKILL.md
View on GitHub---
name: device-settings
description: Настройки устройства в settings.json, пути и конфигурация бэкенда. Использовать при добавлении настройки, правке settings_store.py, .env, путей к базе и данным.
---
# Настройки устройства
Живут в `backend/data/settings.json`, а не в БД: их переносят на новый прибор, кладут в
резервную копию и правят руками, когда админка недоступна — запирать их в SQLite вместе
с товарами незачем. Запись атомарна (временный файл + замена): обесточивание в момент
сохранения иначе оставило бы обрезанный JSON, и прибор поднялся бы на значениях по
умолчанию.
В гите файла нет: он у каждого прибора свой, правится из админки, и, лежа в
репозитории, давал конфликт при каждом пуле — настройки с двух машин расходятся
всегда. Вместо него `backend/data/settings.example.json` — образец с подобранными
сеткой, кеглями и цветами; при первом запуске `load_settings` заводит рабочий файл
с него (`_from_example`), а не с голых умолчаний модели, чтобы прибор из коробки
выглядел как надо. Меняете умолчания для всех приборов — обновите образец.
Размеры подписей, доля высоты под фото, высота и цвет плашки — оттуда же, в вёрстку
приезжают CSS-переменными `--ui-*` на корне киоска.
# Правка в админке доходит до экрана сразу
Бэкенд говорит киоску, что тронули: `services/live.py` держит по очереди на каждого
слушателя, сокет `/api/ws/updates` их раздаёт, а `PUT /api/settings` и правки товаров
зовут `live.notify()`. Киоск на событие перечитывает настройки или каталог —
`shared/live.ts` плюс `onDeviceChanged` в `kiosk/App.vue`.
Так это устроено, потому что раньше настройки перечитывались только на возврате к
начальному экрану, а потом их стал опрашивать таймер раз в пять секунд. Опрос не
замечал правок каталога вовсе и слал запрос весь день ради события, которое случается
раз в сутки. Сокет к тому же уже есть — прибор держит его ради веса.
После обрыва связи киоск перечитывает **всё**: что успели поменять, пока его не было,
узнать уже нельзя. Номер страницы при этом удерживается в пределах каталога — оператор
мог погасить товар, и страница оказалась бы за последней.
Замер: правка сетки 6 -> 4 колонки меняет экран за доли секунды без перезагрузки
(12 карточек на странице стало 8, пейджер с 22 страниц на 32); переименование товара
доезжает до карточки так же.
Метрологические параметры (НПВ, цена деления, наименьшая навеска) в настройках **не**
живут — это свойства прибора, их место в `.env`.
# Пути и конфигурация
Расположение данных не должно зависеть от того, откуда запущен процесс. Уже дважды
ловили одно и то же (issues #1 и #2): относительный путь резолвится от рабочего каталога,
а uvicorn запускают то из `backend/`, то из корня репозитория, то из systemd. Поэтому
`env_file` абсолютный, а относительный путь в `S2L_DB_URL` привязывается к каталогу
`backend/`. Каталог под базу создаём сами: SQLite этого не делает и падает с невнятным
«unable to open database file».
Любой новый путь в конфиге проверяйте запуском из корня репозитория, а не только из
`backend/`.
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 |