- Зачем:
- runbook требовал незафиксированного контекста для первого деплоя и восстановления сайта на чистой VPS.
- Что:
- добавлены prerequisites, установка пакетов, первый workflow, UFW и проверенный атомарный откат.
- спецификация и PRD обновлены по факту завершённого переноса на VPS.
- локальные команды Snap uv заменены на persistent Python venv.
- Проверка:
- mkdocs build --strict выполнен через persistent venv пользователя gitea-runner.
- последовательность rollback проверена на временном дереве releases и symlink.
- Зачем:
- основной сайт не должен зависеть от заблокированной учётной записи GitHub.
- Что:
- добавлены строгая сборка и атомарная публикация через repository-scoped runner.
- добавлены воспроизводимые конфигурации systemd, nginx и эксплуатационный runbook.
- проектная документация и ссылки на репозиторий обновлены для Gitea.
- Проверка:
- выполнены mkdocs build --strict, Bash/YAML-проверки и локальный HTTP smoke-check.
- runner зарегистрирован, ограничен средствами systemd и виден в Gitea как online.
- Зачем:
- project/TODO.md не упоминался в AGENTS.md — агенты и участники
его не находили при планировании работ;
- список не имел приоритетов, выполненное не отмечалось
- Что:
- в AGENTS.md добавлен указатель на project/TODO.md как бэклог проекта;
- задачи сгруппированы по приоритетам P1–P3: наверху CI-проверка
ссылок и подраздел «Linux и терминал», ниже перенос учебника
Airflow, GA, трудозатраты, шаблон прогресса, затем dbt-стенд,
абзац про DQ и бейджи статусов (помечены сомнения);
- раздел «Сделано»: пункт про сложность алгоритмов закрыт
коммитом 6f61c0e
- Проверка:
- mkdocs build --strict (без ошибок; project/ исключён из сайта)
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
- Зачем:
- роадмап нуждается в презентабельном виде с навигацией и поиском, а не только GitHub README.
- Что:
- создан mkdocs.yml (Material, docs_dir: ., поиск на русском, тёмная/светлая тема).
- создан .github/workflows/deploy-site.yml (push в main → сборка → GitHub Pages).
- адаптирован Markdown для dual compatibility (GitHub + MkDocs): пустые строки перед списками, отступы 2sp→4sp, заголовки README #→## для корректного TOC.
- заменены em-dash на запятые в 4 заголовках dwh-modeling/README.md (фикс расхождения якорей).
- добавлены правила Markdown Style и команды MkDocs/Playwright в AGENTS.md.
- Проверка:
- uv run --with 'mkdocs-material==9.6.14' --with 'mkdocs-same-dir==0.1.3' mkdocs build --strict
- Зачем:
- в статье и скриптах обнаружены фактические ошибки и несостыковки
- Что:
- README: f.order_date -> d.date_actual в примере витрины (колонки order_date нет в fact_sales)
- README: «календарь на 10 лет» -> «5 лет» (соответствует генерации 2023-2027 в скрипте)
- 09_solution: bounds CTE теперь использует CURRENT_DATE для открытых интервалов (valid_to IS NULL)
- 09_solution: комментарий про дубли в STG при повторном запуске блока 3
- 05_ddl_dm: выравнивание total_line_items
- AGENTS.md: обновлён диапазон скриптов 01-09
- Проверка:
- визуальная проверка diff
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
- Зачем:
- нужна единая спецификация для сообщений коммитов
- облегчение code review и читаемости истории
- Что:
- создан COMMIT_RULES.md с правилами Conventional Commits
- адаптированы scopes под репозиторий: sql, modeling, bookings, docs, data
- обновлена секция в AGENTS.md с ссылкой на полные правила
- Проверка:
- git log --oneline -1
- cat COMMIT_RULES.md | head -20
ddadmin
