Просьба с эксплуатации: после «Обновить сейчас» непонятно, подхватились ли
правки таблицы. Теперь кэш считает sha256 скачанного файла и сравнивает с
предыдущим чтением:
- в логе: «Расписание загружено: N групп …; файл изменился/не изменился
(sha256 ab12cd34)»;
- состояние для админки дополнено полями changed / changed_at / content_hash;
- в панели чипы «Файл при последнем обновлении», «Содержимое менялось»,
«sha256 файла», а после кнопки — понятное сообщение: «обнаружены изменения»
либо «файл не изменился (на Диске та же версия)» с подсказкой про задержку
публикации у Яндекса;
- ответы API отдаются с Cache-Control: no-store, чтобы браузер не показывал
закэшированные данные после обновления;
- запросы к Яндекс.Диску идут с no-cache заголовками и меткой времени —
меньше шансов получить закэшированную версию файла.
Тест: test_state_reports_file_changes (первая загрузка, изменение файла,
повторное чтение без изменений).
Панель без публичного входа: страница живёт по ADMIN_PATH, логин/пароль —
ADMIN_LOGIN/ADMIN_PASSWORD из .env (пусто = админка выключена и маршруты
/api/admin/* не регистрируются, прод можно не трогать).
Умеет: посмотреть текущую ссылку и состояние кэша, вставить новую ссылку
(проверяется скачиванием и разбором до сохранения, при ошибке откат),
принудительно обновить таблицу вне интервала и без проверки modified,
задать интервал в минутах (1..1440).
Реализация:
- backend/admin.py — cookie-сессия на HMAC (ключ = пароль, 12 часов,
HttpOnly/SameSite/Secure-за-https), сравнение за постоянное время;
compare_digest по байтам — кириллица в логине не роняет сервер;
- schedule/settings.py — ссылка и интервал в JSON (SETTINGS_FILE), атомарная
запись, терпимость к битому/недоступному файлу (тогда живёт в памяти);
- schedule/cache.py — интервал вместо TTL, apply_link с откатом,
force_reload, state() для панели; кэш без ссылки больше не роняет старт;
- frontend: страница admin.html (вне static, прямой /admin.html закрыт) и
прокси /api/admin/* с телом и Set-Cookie;
- docker-compose: том schedule_data для настроек, ADMIN_* в окружении;
- deploy/: nginx-конфиг и инструкция для стенда dev.schedule.our-place.ru.
Тесты: 138 (новые — админ-API, сессии, ссылка/интервал, force, хранилище).