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:
@@ -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
@@ -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 (~12–15 часов).
|
||||
Менти всегда спрашивают «сколько займёт»; ориентир защищает от провала
|
||||
в практику на месяцы.
|
||||
|
||||
- [ ] **Иконки/бейджи статуса разделов** (пройден / в процессе / не начат) — декоративные, без бэкенда.
|
||||
- [ ] **Добавить счётчик 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.
|
||||
|
||||
Reference in New Issue
Block a user