docs(map): ссылки на материалы перенесены в Gitea
This commit is contained in:
1 parent
6be0442838
commit
ec9dd4c1a8
6 files changed
+42
-16
No files matched your search
@@ -1,8 +1,8 @@
|
||||
# Исходники карты DWH
|
||||
|
||||
Готовый файл - [../architecture-map.html](../architecture-map.html).
|
||||
Откройте его локально в браузере. Сервер и интернет не требуются;
|
||||
SQL и Markdown открываются из соседних каталогов репозитория.
|
||||
Откройте его локально в браузере. Для самой карты сервер и интернет не требуются.
|
||||
Ссылки на SQL, DAG и Markdown открывают Gitea, поэтому для переходов нужен интернет.
|
||||
Учебный маршрут находится в [руководстве о структуре](../db_schema.md).
|
||||
|
||||
## Редактирование и сборка
|
||||
@@ -28,6 +28,13 @@ uv run docs/design/architecture-map/render.py --check
|
||||
Проверка входов учитывает именованные таблицы в FROM/JOIN;
|
||||
смысл соединений нужно сверять при изменении SQL вручную.
|
||||
|
||||
`repository_url` в `map.json` задает адрес Gitea с окончанием `/src/`.
|
||||
В нем нет имени ветки или коммита: Gitea открывает файл из текущей ветки
|
||||
по умолчанию. Пути в `links` остаются относительными к готовому HTML,
|
||||
чтобы сборка проверяла файлы и разделы в локальном репозитории;
|
||||
интерфейс преобразует их в адреса Gitea. Ссылки вида `#node=…` остаются
|
||||
в локальной карте. Ссылка на руководство в шапке собирается из того же адреса.
|
||||
|
||||
Внешние `stg.*_ext` представлены в карточках STG, поскольку это входы чтения,
|
||||
а не еще одна копия данных. Поля источника сверяются с контрактом PXF.
|
||||
Для заглушек используются DDL и `docs/assignment/analyst_spec.md`.
|
||||
@@ -55,6 +62,8 @@ uv run docs/design/architecture-map/render.py --check
|
||||
4. У факта откройте обе роли `dim_airports`, путь через `ods.routes`
|
||||
и выбор версии `dim_routes`. Проверьте отдельные карточки связей.
|
||||
5. Откройте адрес объекта, обновите страницу, проверьте назад/вперед.
|
||||
Откройте DDL, загрузку, DQ и пункт задания из карточки.
|
||||
Откройте DDL, загрузку, DQ, DAG и пункт задания из карточки в Gitea.
|
||||
Проверьте форматирование Markdown, подсветку кода и переход к разделу задания.
|
||||
Ссылка на таблицу должна открывать локальную карту с тем же выбором.
|
||||
6. Проверьте выбор клавишами Enter/пробел и вид на узком экране.
|
||||
На узком экране карта прокручивается, карточка находится под ней.
|
||||
Reference in new issue
Block a user