ddadmin
1dd5838fb5
Указатели в AGENTS.md и оглавлении ведут к авторской заметке в solution; учебная ветка сохраняет свой состав документации. Проверка: ссылки сверены с локальной веткой solution, git diff --cached --check пройден.
4.5 KiB
Документация
Знакомство и первое задание
После запуска стенда пройдите три шага:
- Структура DWH: смысл строк и связей на примере поездки.
- От карты к SQL загрузки: разбор готового справочника ODS. Сборка факта понадобится позже, перед DDS.
- Учебные задания: файлы для работы, порядок запуска и самопроверка. Поля и бизнес-правила находятся в ТЗ.
Найти деталь во время работы
Интерактивная карта ведет от таблицы к ее
источникам, потребителям, SQL и пункту задания.
Откройте локальный файл docs/design/architecture-map.html в браузере;
просмотр исходного HTML в Gitea не показывает карту.
Руководство объясняет открытие и адресные ссылки.
| Вопрос | Основной документ |
|---|---|
| В каком порядке запускать слои? | Порядок запуска DAG |
| Что делает загрузка и где искать ошибку? | Руководства STG, ODS, DDS, DM |
| Какие поля и преобразования нужны в моем задании? | ТЗ |
| Как называются служебные поля и что означают метки времени? | Соглашения об именах |
| Какие проверки включить в DQ? | Классы DQ-проверок |
| Как устроены контейнеры, Connections и настройки? | Справочник стенда |
Проверки разработки и диагностика
TESTING.md описывает проверки изменений репозитория: pytest, линтеры, проверку карты и прогоны стенда. Для выполнения первого задания достаточно самопроверки из его инструкции.
Для углубленного разбора доступны исторический QA-план с многодневными и негативными сценариями полной реализации и заметки о генераторе Bookings. QA-план требует отдельного тестового стенда и сверки с текущими SQL.
Разработка учебных заданий
Перед созданием или пересмотром лабораторных прочитайте заметку о развитии программы в ветке solution: аудитория, принятые решения, предложения по обязательному циклу и общие критерии заданий.
История разработки
Планы слоев сохранены по прежним адресам: STG, ODS, DDS, DM. В них остаются исходные обоснования, варианты SQL и последовательность создания файлов. В начале каждого плана есть переход к действующему руководству. Для реализации учебных загрузок используйте ТЗ и готовые SQL-примеры.
Полные материалы проектирования (PRD, дизайн заданий, архитектурные решения)
находятся в ветке solution.