webdev1881/scale-S2L / .claude/skills/admin-ui
admin-ui
VerifiedАдминка — роутинг, шапка с кнопками раздела, форма настроек. Использовать при правке frontend/src/admin.
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 11.5 KB |
SKILL.md
View on GitHub---
name: admin-ui
description: Админка — роутинг, шапка с кнопками раздела, форма настроек. Использовать при правке frontend/src/admin.
---
# Админка
- Админка использует хэш-роутинг: одинаково работает и на `/admin.html`, и на `/admin`.
Тема у неё всегда светлая.
- Блоки страниц (карточки настроек, таблицы товаров и операций) оформлены общими
правилами в `admin/styles.css`, а не в scoped-стилях страниц: блоки собраны из
компонентов Element Plus, и до их внутренней разметки scoped-правила не достают.
Всё под `.admin`, чтобы ничего не утекло в киоск.
- Заголовок блока — его главная примета: крупнее текста внутри, на своей подложке и с
полосой акцента слева. Таблицы оформлены как те же блоки, иначе страница распадается
на «карточки здесь, голая таблица там».
- Кнопки раздела живут в шапке админки: страница телепортирует их в `#admin-actions`
(`<Teleport … defer>`, иначе цель ещё не отрисована). Форма настроек длинная, и кнопка
сохранения не должна уезжать под нижний край вместе с ней.
- Тара и обнуление живут в админке, а не в шапке киоска: покупателю они не нужны, а
случайное нажатие тары посреди взвешивания портит покупку.
- Вкладка «Етикетка» — конструктор: слева живое превью с перетаскиваемыми рамками
блоков, справа их список и свойства выбранного. Своей отрисовки этикетки во фронтенде
нет и не должно появиться — картинку рисует бэкенд тем же рендером, что и печать
(см. скилл `label-printing`). Рамки позиционируются в процентах от листа, поэтому
переживают любое масштабирование окна, а перетаскивание пересчитывает миллиметры
через ширину листа.
- В конструкторе есть то, без чего редактор не редактор: **отмена и повтор**
(`Ctrl+Z`, `Ctrl+Y`; хранятся снимки раскладки целиком — в ней десяток блоков, и
обратные операции городить незачем), **стрелки** для точной установки (0.5 мм, с
Shift 5 мм; серия нажатий подряд — одна запись в истории), **`Ctrl+D`** для копии,
**Delete** для удаления.
- **Прилипание** к краям этикетки и к краям соседних блоков (порог 1.2 мм, `Alt`
отключает): ровнять блоки на глаз по растру в четверть натуральной величины
невозможно, а бумага разницу покажет. Направляющие видно ровно в момент прилипания.
- **Уход с несохранённой раскладкой перехватывается** (`onBeforeRouteLeave` плюс
`beforeunload`), а у кнопки сохранения стоит точка, пока есть незаписанные правки:
соседний пункт меню в одном клике, и работа исчезала бы молча.
- **Ответы превью нумеруются**: при быстрой правке они приходят вперемешку, и медленный
затирал бы свежий. Ответ с устаревшим номером отбрасывается.
- Блок, ушедший за край этикетки, помечается красным и пересчитывается в предупреждение
под листом: на бумаге он просто не напечатается.
- Метрологические параметры в админку не выносятся (см. скилл `device-settings`).
## Страница настроек
Полсотни настроек разложены по семи блокам про части экрана прибора (`SECTIONS` в
`SettingsView.vue`: устройство, этикетка и штрихкод, взвешивание и печать, экран и
сессия, каталог, кнопки и клавиатура, размеры и цвета), а внутри больших блоков —
подзаголовки (`.group`: «після друку», «заставки», «повідомлення», «сітка», «що на
картці», «фото», «нижня панель», «клавіатура», «кеглі», «кольори»): десять полей
подряд читаются как список, а не как настройки чего-то конкретного.
Выключатели живут отдельным списком (`.switch-row`), а не в сетке полей: у каждого
своя строка-пояснение, и в двух колонках они рвутся по-разному. Числа с парой
(«столбцов × строк», «ширина × высота») держатся в одной строке (`.row.nowrap`) —
разорванные по строкам, они читаются как два независимых поля. Пресеты и «одразу на
ваги» переехали из шапки админки в панель самой страницы: в шапке они мешались с
кнопками сохранения и датами обновлений. У каждого
блока схема экрана с подсвеченной зоной — `components/KioskSketch.vue`, рисуется
SVG кодом, а не картинкой из файла: подсветка зоны — заливка того же
прямоугольника, и схема красится в цвета темы. Слева прилипшее оглавление с теми
же схемами; активный пункт — по `IntersectionObserver`. Поля в две колонки с
подписью сверху: вдвое короче простыни с подписями слева, а подсказка остаётся под
своим полем. Новую настройку класть в блок про её часть экрана, а не в конец.
## Даты обновлений в шапке
Шапка всегда показывает четыре отметки (`GET /api/updated-at`): каталог из 1С
(время и число позиций), правка настроек, версия ПО и время последнего успешного
опроса прибора. Оператор приходит с вопросом «свежий ли тут каталог и та ли
сборка» — ответ должен быть на экране, а не за тремя кликами; замершее время
опроса краснеет, когда прибор перестал отвечать.
Откуда что берётся: выгрузка — `data/state.json` (`services/device_state.py`,
отметка ставится в `import_1c`), настройки — время файла `settings.json`, версия —
`S2L_BUILD_SHA`/`S2L_BUILD_AT` из образа (их подставляет сборка в CI), а на машине
разработчика их нет, и версией считается время сборки фронта. Отметку выгрузки
нельзя держать в `DeviceSettings`: админка шлёт настройки целиком, и сохранение
формы затирало бы её значением, прочитанным при открытии страницы.
## «Одразу на ваги»
Переключатель в шапке страницы настроек: правка уезжает на прибор без «Зберегти»,
с паузой 400 мс (ползунок и поле дают десяток правок в секунду). Оператор настраивает
сетку и кегли, глядя на сам прибор, — ходить к кнопке после каждого щелчка стрелкой
бессмысленно. Выбор хранится в `localStorage` браузера, а не в настройках прибора:
это привычка того, кто сейчас настраивает, а не свойство весов.
Название магазина из живой отправки исключено: оно печатается на этикетке, и прибор
не должен увидеть его недописанным — в payload подставляется то, что уже стоит на
приборе, а само имя уезжает по «Зберегти». Ответ сервера в форму не пишется: оператор
может печатать прямо сейчас, и подмена значений стёрла бы половину слова. Снимок
«что на приборе» держится в `applied` — по нему же отсекаются пустые отправки.
## Пароль
Админка закрыта HTTP Basic (`backend/app/auth.py`, middleware в `main.py`): логин
`S2L_ADMIN_USER` (по умолчанию `admin`), пароль `S2L_ADMIN_PASSWORD` из `.env`. Пустой
пароль — админка открыта (режим разработки, при старте предупреждение в логе).
Basic выбран за то, что ему не нужны ни форма входа, ни сессии: браузер спрашивает
пароль один раз и сам подставляет его во все XHR той же страницы. Под паролем:
`/admin*`, все не-GET запросы к `/api/*` кроме того, что делает сам киоск (`/api/print`,
`/api/scale/tare|zero`) и приёма из 1С (свой токен), а из чтения — журнал
`/api/transactions` и растры `/labels/`. Всё, что читает киоск, остаётся открытым.
Осторожно с проверками: `PUT /api/settings` с пустым телом `{}` — это не «ничего», а
сброс всех настроек к заводским. И не гонять настройки через `Invoke-RestMethod`
Windows PowerShell 5.1: ответ без `charset` он читает как Latin-1, «грн» превращается
в «Ð³Ñн», и обратный PUT записывает это в файл. Для правок настроек из консоли —
python с `.decode("utf-8")` и `ensure_ascii=False`.
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| brainstormingobra/superpowersYou MUST use this before any creative work - creating features, building components, adding functionality, modifying behavior, or planning anything new, in software or out of it (a talk, a business, a renovation). | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| brand-guidelinesanthropics/skillsApplies Anthropic's official brand colors and typography to any sort of artifact that may benefit from having Anthropic's look-and-feel. Use it when brand colors or style guidelines, visual formatting, or company design standards apply. | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |
| frontend-designanthropics/skillsGuidance for distinctive, intentional visual design when building new UI or reshaping an existing one. Helps with aesthetic direction, typography, and making choices that don't read as templated defaults. | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |
| mcp-builderanthropics/skillsGuide for creating high-quality MCP (Model Context Protocol) servers that enable LLMs to interact with external services through well-designed tools. Use when building MCP servers to integrate external APIs or services, whether in Python (FastMCP) or Node/TypeScript (MCP SDK). | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |