docs(project): TODO приоритизирован и подключён к AGENTS.md

- Зачем:
  - 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>
This commit is contained in:
2026-07-12 19:54:51 +03:00
co-authored by Claude Fable 5
parent afcce5dc4a
commit ad60d0c738
2 changed files with 50 additions and 9 deletions
+1 -1
View File
@@ -6,7 +6,7 @@
- `postgres-bookings/` is a Dockerized PostgreSQL + demo “bookings” DB; start it first, then apply DWH scripts against the `demo` database.
- `mkdocs.yml` — MkDocs Material config; `docs_dir: .` (repo root = site root). Excluded dirs: `project/`, `postgres-bookings/`, `.github/`, `.claude/`.
- `.github/workflows/deploy-site.yml` — CI/CD: push to `main` → build → deploy to GitHub Pages.
- `project/` — PRD and ADR (excluded from site).
- `project/` — PRD, ADR, and TODO.md (excluded from site). `project/TODO.md` is the prioritized project backlog: check it when planning or proposing work, and mark items done there when you complete them.
## Build, Test, and Development Commands
- Start demo Postgres:
+49 -8
View File
@@ -1,18 +1,59 @@
# TODO: общие задачи проекта
## Контент
Приоритеты: P1 — делаем в первую очередь; P2 — полезно, когда дойдут руки; P3 — идеи под вопросом.
## P1
- [ ] **CI-проверка внешних ссылок.**
В роадмапе ~100 внешних ссылок, репозиторий правится редко — ссылки гниют молча.
GitHub Action (например, lychee) по расписанию раз в неделю, с игнор-листом
доменов, режущих ботов (habr, stepik, leetcode, realpython и т.п. отвечают
только браузерам). Аудит 2026-07-12 нашёл битые ссылки вручную — автоматика
избавит от повторов.
- [ ] **Подраздел «Linux и терминал» в блоке базовых инструментов.**
Единственный пробел заявленной базы: в роадмапе нет ни одного упоминания
bash/ssh/командной строки, при этом все стенды консольные (docker compose,
make, psql). 2–3 материала + критерий готовности (навигация, grep по логам,
ssh, права файлов). Отдельная практика не нужна — ею служат стенды.
## P2
- [ ] **Перенос учебника Airflow в de-roadmap.**
Перенести 9 глав учебника из `airflow-manual` в `airflow/` (de-roadmap).
В `airflow-manual` оставить только стенд (`airflow-docker/`).
Добавить навигацию в `mkdocs.yml`, обеспечить dual-compatible links.
- [ ] **Убрать раздел «Понятие сложности алгоритмов» из README.**
Раздел поверхностный и не самостоятелен. План:
- Упоминание асимптотики (O(n) vs O(n²), pandas/списки) перенести в раздел Python.
- По SQL: либо короткая заметка про планы запросов, либо просто сослаться на курс QPT от Postgres Pro (он уже упомянут в разделе SQL) и не дублировать.
- [ ] **Добавить счётчик Google Analytics** на сайт (MkDocs Material
поддерживает GA через `extra.analytics` в `mkdocs.yml`).
## Сайт
- [ ] **Ориентиры трудозатрат по блокам.**
Одна строка на блок («~N часов»), по образцу курса Lakehouse (~1215 часов).
Менти всегда спрашивают «сколько займёт»; ориентир защищает от провала
в практику на месяцы.
- [ ] **Иконки/бейджи статуса разделов** (пройден / в процессе / не начат) — декоративные, без бэкенда.
- [ ] **Добавить счётчик Google Analytics** на сайт (MkDocs Material поддерживает GA через `extra.analytics` в `mkdocs.yml`).
- [ ] **Шаблон прогресса менти.**
Файл-чеклист по критериям «когда блок считаем пройденным»; менти копирует
в свой форк и ведёт коммитами. Живая практика Git с первой недели +
прозрачный прогресс для ментора.
## P3
- [ ] **Свой dbt-стенд.**
Сейчас практика dbt — на чужом jaffle-shop; единственная секция без
собственного стенда. Вариант: dbt-модели поверх postgres-bookings или
clickstream-стенда.
- [ ] **Абзац про Data Quality в курсовой.**
Валидационный DAG курсовой — это и есть DQ на практике; добавить абзац,
как об этом говорить на собеседовании. Новая секция не нужна.
- [ ] **Иконки/бейджи статуса разделов** (пройден / в процессе / не начат) —
декоративные, без бэкенда. Сомнение: статус у каждого менти свой,
пересекается с идеей шаблона прогресса — возможно, отпадёт.
## Сделано
- [x] **Убрать раздел «Понятие сложности алгоритмов» из README**
2026-07-12, коммит `6f61c0e`: асимптотика перенесена в Python ссылкой
на разбор Big O (habr), по SQL — без дублирования, тему покрывает QPT.