- Зачем: - docs/internal/ превратился в свалку: дизайн-документы, ревью, планы и справочники лежали вперемешку. - архивные планы были неотличимы от живых документов. - Что: - docs/internal/ удалён; файлы распределены по docs/design/, docs/reference/, docs/archive/, docs/plans/, docs/assignment/. - educational-tasks.md убран из корня в архив (устарел). - обновлены все перекрёстные ссылки в AGENTS.md, TODO.md, README.md, docs/README.md и внутри design/reference/. - актуализированы architecture_review.md (статус DM-слоя), db_schema.md (DM-слой), TESTING.md, dag_execution_order.md, pxf_bookings.md. - добавлены заглушки docs/assignment/README.md и docs/plans/README.md. - Проверка: - make test && make lint - rg 'docs/internal' --glob '!docs/archive/*' — должно быть пусто.
2.4 KiB
2.4 KiB
Документация
Этот каталог содержит дополнительные материалы к учебному стенду.
Быстрый путь (для менти)
- Быстрый старт и команды
- Учебные задания
- План тестирования и проверки
- Главный учебный DAG: bookings → stg
- Учебный DAG: stg -> ods
- Учебный DAG: ods -> dds
- Учебный DAG: dds -> dm
Дизайн (design/)
- Единые конвенции нейминга DWH (служебные поля и SCD)
- Схема БД всех слоёв DWH
- Дизайн-документ STG
- Дизайн-документ ODS
- Дизайн-документ DDS
- Дизайн-документ DM
- Архитектурные решения (ADR)
- PRD: стратегия курсовой
- Дизайн задания
Справочники (reference/)
- Как устроен Docker-стенд (образы, Connections, переменные окружения)
- PXF в этом проекте (проектная реализация)
- Про время/UTC в bookings
- Известные проблемы bookings-db
- Бенчмарк генерации данных
- QA-план отладки пайплайна
- Порядок запуска DAG-ов
- End-to-end протокол тестирования
- Тестирование DAG-ов через API
Планы (plans/)
Активные планы работ. После выполнения переносятся в archive/.
Архив (archive/)
Выполненные планы, закрытые ревью. Ссылки внутри файлов могут быть устаревшими.