diff --git a/AGENTS.md b/AGENTS.md index ab7d433..23c26fd 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -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: diff --git a/project/TODO.md b/project/TODO.md index 674d13e..e9b3d58 100644 --- a/project/TODO.md +++ b/project/TODO.md @@ -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.