📦 Архів сайту

🤖 Мануал для десктопного Hermes-агента

Як працювати, щоб не затирати дані крону. Обов'язковий до виконання контракт між серверним Hermes (Linux) і десктопним Hermes (Windows).

1. Архітектура (хто що пише — не перетинай)

2. Головне правило: звірка з Vercel перед правкою

Це правило вирішує ВСІ конфлікти раз і назавжди. Воно усуває race-condition: серверний крон о 06:00 пушить нові tickets/ та stt/ в main, а якщо десктоп зробить git pull між 06:00 і 09:00, його локальна копія старіша за main, і rebase виглядає ніби крон затирає desktop-зміни, хоча насправді це desktop затирає дані крону.

curl https://chets-schedule.vercel.app/service-worker.js | Select-String "CACHE_NAME"
# Запам'ятай: v756 — це поточна версія на Vercel

Ця команда показує, що зараз на production-сайті. Vercel бере з main. master — це legacy, туди не пушимо.

3. Повний workflow (8 кроків — робити КОЖЕН раз)

cd C:\Users\St_Lv\hermes-server\vercel-project
git checkout main
git pull origin main

git checkout --theirs tickets/ stt/
git add tickets/ stt/
git rebase --continue

git status

git checkout -- tickets/ stt/

$vercelIndex = (Invoke-WebRequest "https://chets-schedule.vercel.app/index.html" -UseBasicParsing).Content
git diff .vercel-baseline-index.html index.html
# Якщо diff порожній — у тебе та сама версія що й на Vercel, можна редагувати

const CACHE_NAME = 'chets-schedule-v757';  // було 756

git status

git add -A
git commit -m "Короткий опис зміни"
git push origin main

Start-Sleep -Seconds 45
curl https://chets-schedule.vercel.app/service-worker.js | Select-String "CACHE_NAME"

4. Заборонено

git push origin master  # ЗАБОРОНЕНО

git push origin main --force  # ЗАБОРОНЕНО

5. Типові задачі

Оновити щоденний графік (daily)

cd C:\Users\St_Lv\hermes-server\vercel-project
git checkout main
git pull origin main
notepad daily\10.09.26.html
# Відкрий service-worker.js, v756 → v757
git add -A
git commit -m "daily 10.09: додав пару 4 Битко+Ніколіч"
git push origin main
# Зачекай 45 сек, перевір Vercel

Оновити головну (index.html)

cd C:\Users\St_Lv\hermes-server\vercel-project
git checkout main
git pull origin main
notepad index.html
# Відкрий service-worker.js, v756 → v757
git add -A
git commit -m "index: додав ДН-кнопку"
git push origin main
# Зачекай 45 сек, перевір Vercel

Оновити дільниці (districts)

cd C:\Users\St_Lv\hermes-server\vercel-project
git checkout main
git pull origin main
notepad districts\2026-09.html
# Відкрий service-worker.js, v756 → v757
git add -A
git commit -m "districts 09: додав Іваненко"
git push origin main
# Зачекай 45 сек, перевір Vercel

Один файл — одна правка — один commit

Не змішуй правки в одному коміті:

• ✅ daily 10.09: додав пару 4 (тільки daily + SW)
• ❌ оновив все (коли там і index, і daily, і districts)

Чому: якщо один коміт зламає сайт, можна git revert тільки його, не зачіпаючи інше.

6. Як працювати з sync-desktop.ps1

sync-desktop.ps1 — це спрощений скрипт для рутинних комітів. Він має параметр -CheckVercel:

.\sync-desktop.ps1 -CheckVercel "daily 10.09: додав пару 4"

Що робить скрипт з -CheckVercel:

1. Curl Vercel → зберігає еталон SW і index.html в .vercel-baseline-*.html
2. Git pull origin main
3. Якщо конфлікт на tickets/stt → автоматично --theirs
4. Перевіряє git status — якщо в M з'явились tickets/stt/assets → автоматично відкочує
5. git add -A → якщо -A додало заборонені → автоматично прибирає і зупиняється
6. git commit + git push origin main
7. Через 30 сек — перевіряє Vercel і порівнює з локальним SW

Скрипт фізично не може затерти дані крону — навіть якщо правило забуте.

7. Коли щось зламалось

"Я бачу старі дані на Vercel після мого push"

# 1. Перевір чи push дійсно був
git log --oneline -3

# 2. Зачекай 60 сек (Vercel іноді тупить)
Start-Sleep -Seconds 60

# 3. Перевір знову
curl https://chets-schedule.vercel.app/service-worker.js | Select-String "CACHE_NAME"

# 4. Якщо все ще старий — backup deploy
.\vercel-deploy.ps1

"Git конфлікт на tickets/ або stt/"

Це крон оновив файли поки ти працював. Завжди бери THEIR:

git checkout --theirs tickets/ stt/
git add tickets/ stt/
git rebase --continue
# Якщо rebase каже "nothing to commit":
git rebase --skip

"Я випадково запушив tickets/ або stt/ — дані крону зникли на Vercel"

Не панікуй. GitHub зберігає історію. Знайди останній коміт крону і відкоти:

# Знайди коміт крону (шукай в історії 'tickets+STT sync' або 'stt/')
git log --all --oneline | Select-String "tickets"
# Наприклад знайшов: 35a1a9c tickets/09.09.2026

# Відкоти файли з того коміту:
git checkout 35a1a9c -- tickets/ stt/

# Закоміть як відновлення:
git add tickets/ stt/
git commit -m "RESTORE: повернув дані крону з 35a1a9c після випадкового затирання"
git push origin main

Або швидко: напиши в Telegram серверному Hermes: "я затер tickets/stt, відкоти".

"Vercel каже 404 на мій новий файл"

Vercel деплоїть тільки ті файли, що закомічені в main. Перевір:

git ls-files | Select-String "11.09"
# Має показати daily/11.09.26.html якщо ти його додав

8. Структура проєкту

C:\Users\St_Lv\hermes-server\vercel-project\
├── index.html              # ГОЛОВНА (вересень 2026) — ТВІЙ
├── daily.html, districts.html, problems.html, stt.html
├── vacations.html, tab.html, needs.html, editor.html
├── months/2026-XX.html     # місячні графіки — ТВІЙ
├── daily/DD.MM.YY.html     # щоденні графіки — ТВІЙ
├── districts/YYYY-MM.html  # дільниці — ТВІЙ
├── tickets/                # ⚠️ КРОНУ, не редагуй
├── stt/                    # ⚠️ КРОНУ, не редагуй
├── tab/                    # табель — ТВІЙ
├── assets/
│   ├── month-redirect.js   # авто-підсвічування місяця
│   ├── problems-auto-month.js
│   ├── vacations-auto-month.js
│   ├── data/               # ⚠️ КРОНУ (controller-tickets.json)
│   ├── stt-reports/        # ⚠️ КРОНУ
│   └── archives/           # ⚠️ КРОНУ
├── service-worker.js       # CACHE_NAME — ЗАВЖДИ бампати
├── sync-desktop.ps1        # pull+commit+push+verify
├── vercel-deploy.ps1       # backup deploy
├── backup-hermes.ps1       # backup to D:\
├── restore-hermes.ps1      # restore from backup
├── install-scheduled-task.ps1
├── MACHINE_OPERATING_MANUAL_LOCAL.md
├── SURVIVAL_GUIDE.md
└── INSTALL_SYNC.md

📞 Контакти

• Серверний Hermes — Linux, /opt/data/vercel-project/, керує cron-ами
• Десктопний Hermes (ти) — Windows, C:\Users\St_Lv\hermes-server\vercel-project\, редагує HTML
• Сайт: https://chets-schedule.vercel.app/
• GitHub: https://github.com/latthorizon-arch/chets-schedule-site

🎓 ЗОЛОТЕ ПРАВИЛО: Vercel — правда. GitHub main — її дзеркало. Локально — твій чорновик.