docs(handbook): интерактивная карта слоев хранилища #223

2026-09-03T10:40:19+03:00

ddmitry commented

2026-09-03 10:40:19 +03:00

Closes #222

Интерактивная карта слоев хранилища: один самодостаточный HTML в docs/handbook/, исходники рядом в docs/handbook/architecture-map/, рендер проверяется в make lint.

Что смотреть:

docs/handbook/architecture-map.html — открыть из своей копии репозитория (Gitea показывает файл как текст).
docs/handbook/architecture-map/map.yaml — содержание: 17 узлов, 17 стрелок, карточки.
docs/handbook/architecture-map/template.html — форма и поведение, чистые CSS и JS.
docs/handbook/architecture-map/render.py — сборка, флаг --check.

Проверка: make lint; карта прощелкана в headless Chromium на ширинах 1280–1920. Ревью: постановка — Opus; реализация — Codex (Sol); два слепых ревью Opus (уместность и вкус, код), все находки закрыты; вычитка прозы — Sol, 34 из 36 правок внесены.

🤖 Generated with Claude Code

Closes #222 Интерактивная карта слоев хранилища: один самодостаточный HTML в `docs/handbook/`, исходники рядом в `docs/handbook/architecture-map/`, рендер проверяется в `make lint`. Что смотреть: - `docs/handbook/architecture-map.html` — открыть из своей копии репозитория (Gitea показывает файл как текст). - `docs/handbook/architecture-map/map.yaml` — содержание: 17 узлов, 17 стрелок, карточки. - `docs/handbook/architecture-map/template.html` — форма и поведение, чистые CSS и JS. - `docs/handbook/architecture-map/render.py` — сборка, флаг `--check`. Проверка: `make lint`; карта прощелкана в headless Chromium на ширинах 1280–1920. Ревью: постановка — Opus; реализация — Codex (Sol); два слепых ревью Opus (уместность и вкус, код), все находки закрыты; вычитка прозы — Sol, 34 из 36 правок внесены. 🤖 Generated with [Claude Code](https://claude.com/claude-code)

ddmitry added 1 commit 2026-09-03 10:40:21 +03:00

docs(handbook): интерактивная карта слоев хранилища 466acafce6

Зачем: путеводитель рассказывает путь данных через слои словами, а карта
дает его увидеть и потрогать: у одного смысла в каждом слое свое имя и своя
поверхность, а переносят данные три разных механизма — матвью непрерывно,
даг пачкой, представление без копии. Постановка — тикет #222, форма —
резолюция #208 (один самодостаточный HTML, исходники рядом).

Что: docs/handbook/architecture-map.html — готовая карта; исходники в
docs/handbook/architecture-map/ (map.yaml — слои, узлы, стрелки, карточки;
template.html — разметка, стили, скрипт; render.py — сборка и --check;
README.md). Щелчок по узлу открывает карточку и подсвечивает путь, щелчок по
стрелке — кто и каким SQL переносит данные; переключатель потока приглушает
чужую часть карты. Ссылки карточек ведут в справочники и DDL на Gitea.
Путеводитель и глава о хранилище ведут на карту; make lint проверяет ruff
для сборщика и свежесть рендера; testing.md и AGENTS.md обновлены.

Проверка: uv run docs/handbook/architecture-map/render.py --check и
make lint зеленые; внешних запросов в HTML нет; ссылки и якоря карточек
сверены с Gitea; карта прощелкана в headless Chromium на ширинах
1280–1920: подсветка пути, фильтр, Esc, карточки узлов и стрелок.
Ревью: постановка — Opus; реализация — Codex (Sol), два слепых ревью Opus
(уместность и код), вычитка прозы Sol.

ddmitry referenced this pull request

2026-09-03 10:41:17 +03:00

Интерактивная карта архитектуры: слои хранилища и путь данных #222

ddmitry referenced this pull request

2026-09-03 10:41:20 +03:00

Реализация учебной программы: документация стенда и ТЗ лаб #206

ddmitry merged commit fddb35c8c4 into main

2026-09-03 11:06:38 +03:00

ddmitry deleted branch 222-architecture-map

2026-09-03 11:06:38 +03:00

Sign in to join this conversation.