From 16b52cdfe80ccc34569d068914f63d76fcb9e4f7 Mon Sep 17 00:00:00 2001 From: wasrusgen Date: Sun, 17 May 2026 12:11:44 +0300 Subject: [PATCH] =?UTF-8?q?chore:=20=D0=B4=D0=BE=D0=B1=D0=B0=D0=B2=D0=B8?= =?UTF-8?q?=D1=82=D1=8C=20CLAUDE.md=20=E2=80=94=20pre-commit=20checklist?= =?UTF-8?q?=20=D0=B4=D0=BB=D1=8F=20UI/CSS=20=D0=B8=D0=B7=D0=BC=D0=B5=D0=BD?= =?UTF-8?q?=D0=B5=D0=BD=D0=B8=D0=B9?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Co-Authored-By: Claude Sonnet 4.6 --- CLAUDE.md | 56 +++++++++++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 56 insertions(+) create mode 100644 CLAUDE.md diff --git a/CLAUDE.md b/CLAUDE.md new file mode 100644 index 0000000..200ff90 --- /dev/null +++ b/CLAUDE.md @@ -0,0 +1,56 @@ +# Claude — правила работы с проектом zov-tech + +## ⚠️ ОБЯЗАТЕЛЬНЫЙ PRE-COMMIT CHECKLIST для любых UI/CSS изменений + +Перед каждым `git commit` с изменениями в `miniapp/` — пройти все пункты: + +### 1. Цвет и читаемость +- [ ] Используется ли `color: transparent` для скрытия текста? (НЕ `var(--card)` — она зависит от Telegram-темы и может быть не нужным цветом) +- [ ] Нет ли текста, где `color` и `background` одинаковы только в светлой теме? +- [ ] Проверены ли все 4 темы: **Default, Foundry, Boardroom, Atelier** — в каждой из них `--card`, `--paper`, `--ink`, `--muted` могут быть разными +- [ ] Если добавляется новый CSS-класс — указан ли явный `color:` (не наследование)? + +### 2. Новые CSS-классы +- [ ] Для каждого нового класса (`.foo`) — проверить, что стили явно определены и не полагаются на наследование от `body` +- [ ] Добавлены ли стили для всех тем (ищи блоки `[data-theme="foundry"]`, `[data-theme="boardroom"]`, `[data-theme="atelier"]` в styles.css)? + +### 3. Версия кэша +- [ ] Бамп `?v=` в `index.html` для каждого изменённого `.css` или `.js` файла +- [ ] Формат: `?v=YYYYMMDD[буква]` — буква растёт по алфавиту в течение дня + +### 4. Деплой +- [ ] После `git push` — GitHub Actions деплоит ~1-2 мин (смотреть на вкладке Actions в GitHub) +- [ ] VPS (бот + бэкенд) обновляется отдельно: `ssh root@94.241.170.144 "cd /opt/zov-tech && git pull && docker compose -f deploy/docker-compose.yml up -d --build bot"` + +--- + +## Архитектура проекта + +``` +miniapp/ → статика, деплой через GitHub Pages (github.com/wasrusgen/zov-tech) +bot/ → Telegram-бот, работает на VPS 94.241.170.144 +backend-py/ → FastAPI-бэкенд, работает на VPS +deploy/ → docker-compose.yml, Caddyfile.snippet +``` + +- **MINIAPP_URL**: `https://wasrusgen.github.io/zov-tech/` +- **API**: `https://api.wasrusgen1.pro` +- **VPS SSH**: `ssh -i ~/.ssh/zov_vps_ed25519 root@94.241.170.144` + +## CSS-переменные по темам + +| Переменная | Default (светлая) | Foundry | Boardroom | Atelier | +|---|---|---|---|---| +| `--card` | `tg-section-bg` (≈белый) | `#EAE3CC` | `#EDE5D0` | `#FFFFFF` | +| `--ink` | `tg-text-color` | `#1A150E` | `#1A150E` | тёмный | +| `--muted` | серый | `#7A6E5F` | `#6B6256` | серый | + +> ⚠️ `var(--card)` в дефолтной теме читается из `--tg-theme-section-bg-color` Telegram. +> В тёмном Telegram-клиенте это НЕ белый цвет. Для полного скрытия текста — только `color: transparent`. + +## Типичные ошибки (уже были) + +1. **`color: var(--card)` для скрытия текста** → не работает в тёмных Telegram-темах. Используй `color: transparent` +2. **Новый JS-класс без CSS** → текст наследует `color: var(--ink)` от body → видим на фоне карточки +3. **Не бамп версии** → WebView грузит старый кэш → изменения не видны +4. **`var(--card)` как фон у hero-секции** → при изменении темы текст становится невидимым (светлый текст на светлом фоне). Решение: явный `color: var(--ink)` inline