48 lines
3.1 KiB
Markdown
48 lines
3.1 KiB
Markdown
# Документация
|
|
|
|
## Знакомство и первое задание
|
|
|
|
После [запуска стенда](../README.md) пройдите три шага:
|
|
|
|
1. [Структура DWH](design/db_schema.md): смысл строк и связей на примере поездки.
|
|
2. [От карты к SQL загрузки](design/reading_the_pipeline.md#ods-airports):
|
|
разбор готового справочника ODS. Сборка факта понадобится позже, перед DDS.
|
|
3. [Учебные задания](assignment/README.md): файлы для работы, порядок запуска
|
|
и проверка результата. Поля и бизнес-правила находятся в [ТЗ](assignment/analyst_spec.md).
|
|
|
|
## Найти деталь во время работы
|
|
|
|
[Интерактивная карта](design/architecture-map.html) ведет от таблицы к ее
|
|
источникам, потребителям, SQL и пункту задания.
|
|
|
|
Карту открывайте из локальной копии: `docs/design/architecture-map.html` в браузере.
|
|
Сервер не нужен. Просмотр исходного HTML в Gitea не показывает карту.
|
|
[Руководство](design/db_schema.md#как-открыть-карту) объясняет открытие и адресные ссылки.
|
|
|
|
Если вопрос о запуске или проверке, откройте нужный материал:
|
|
|
|
- [Порядок запуска DAG](dag_execution_order.md) и [план проверки стенда](../TESTING.md).
|
|
- Руководства загрузок: [STG](bookings_to_gp_stage.md), [ODS](bookings_to_gp_ods.md),
|
|
[DDS](bookings_to_gp_dds.md), [DM](bookings_to_gp_dm.md).
|
|
- [Соглашения об именах](design/naming_conventions.md) и [классы DQ-проверок](reference/dq_taxonomy.md).
|
|
|
|
## Дизайн (`design/`)
|
|
|
|
- [Единые конвенции нейминга DWH (служебные поля и SCD)](design/naming_conventions.md)
|
|
- [Структура DWH и маршрут по карте](design/db_schema.md)
|
|
- [От карты к SQL загрузки](design/reading_the_pipeline.md)
|
|
- [Дизайн-документ STG](design/bookings_stg_design.md)
|
|
- [Дизайн-документ ODS](design/bookings_ods_design.md)
|
|
- [Дизайн-документ DDS](design/bookings_dds_design.md)
|
|
- [Дизайн-документ DM](design/bookings_dm_design.md)
|
|
|
|
> Полные дизайн-документы (PRD, assignment_design, архитектурные решения) — в ветке `solution`.
|
|
|
|
## Справочники (`reference/`)
|
|
|
|
- [Как устроен Docker-стенд (образы, Connections, переменные окружения)](stack.md)
|
|
- [Известные проблемы bookings-db](reference/bookings_db_issues.md)
|
|
- [QA-план отладки пайплайна](reference/qa-plan.md)
|
|
- [Классы DQ-проверок](reference/dq_taxonomy.md)
|
|
- [Порядок запуска DAG-ов](dag_execution_order.md)
|