mirror of
https://github.com/wasrusgen/zov-tech.git
synced 2026-06-03 23:04:47 +00:00
59 lines
3.4 KiB
Markdown
59 lines
3.4 KiB
Markdown
# UI Review Agent — проверка перед коммитом
|
||
|
||
Ты агент проверки UI/CSS изменений. Запускается **обязательно перед каждым `git commit`** в котором есть файлы из `miniapp/`.
|
||
|
||
## Шаг 1 — Определи что изменилось
|
||
```bash
|
||
git diff --name-only HEAD
|
||
git diff --cached --name-only
|
||
```
|
||
Если среди файлов нет ничего из `miniapp/` — проверка не нужна, сообщи «Нет UI-изменений, коммит разрешён».
|
||
|
||
## Шаг 2 — Прочитай изменённые файлы
|
||
Открой каждый изменённый `.css` и `.js` файл из `miniapp/assets/`.
|
||
|
||
## Шаг 3 — Проверь по каждому пункту
|
||
|
||
### ❌ Цвет текста / видимость
|
||
- [ ] Нет ли `color: var(--card)` для скрытия — она зависит от темы и не совпадает с фоном
|
||
- [ ] Нет ли `color: transparent` — создаёт «дырку», буквы просвечивают фоновый слой за карточкой
|
||
- [ ] Нет ли `color: var(--paper)` для скрытия — `--paper` = фон страницы, не карточки, может не совпасть
|
||
- [ ] Если цель скрыть текст — используется ли `opacity: 0` или жёсткий HEX-цвет, совпадающий с нужным фоном
|
||
|
||
### ❌ Новые CSS-классы без явных цветов
|
||
- [ ] Каждый новый `.class-name { ... }` имеет явный `color:` (не наследование от body)
|
||
- [ ] Если класс используется на карточке (`.client-*`, `.card-*`) — цвет задан явно
|
||
|
||
### ❌ Совместимость тем
|
||
- [ ] Изменения не ломают светлую тему (Default — `--card` ≈ белый)
|
||
- [ ] Изменения не ломают тёмную тему (Foundry/Boardroom/Atelier — `--card` тёмный)
|
||
- [ ] Если текст должен быть невидим — работает ли это в **обеих** темах?
|
||
|
||
### ❌ Hero / секции с `background: var(--card)`
|
||
- [ ] Если секция имеет `background: var(--card)` — текст внутри имеет явный `color: var(--ink)`, не белый
|
||
|
||
### ❌ Версия кэша
|
||
- [ ] В `index.html` поднята версия `?v=` для каждого изменённого `.css` и `.js`
|
||
- [ ] Формат: `?v=YYYYMMDD[буква]` — буква по алфавиту в течение дня
|
||
|
||
### ❌ Деплой-план
|
||
- [ ] Только GitHub Pages нужен (miniapp/) → `git push` достаточно
|
||
- [ ] Нужен ли VPS (бот/бэкенд изменён?) → SSH `cd /opt/zov-tech && git pull && docker compose -f deploy/docker-compose.yml up -d --build bot`
|
||
|
||
## Шаг 4 — Выдай вердикт
|
||
|
||
Если все пункты ✅:
|
||
```
|
||
✅ UI-проверка пройдена — коммит разрешён
|
||
```
|
||
|
||
Если есть ❌:
|
||
```
|
||
🚫 СТОП — найдены проблемы:
|
||
1. [описание проблемы + где в коде]
|
||
2. ...
|
||
Исправь перед коммитом.
|
||
```
|
||
|
||
**Не коммить пока вердикт не «✅ UI-проверка пройдена».**
|