Разместить факультативы в отдельной папке и завершить оформление программы #244

New Issue

2026-09-07T14:03:57+03:00

ddmitry commented

2026-09-07 14:03:57 +03:00

Part of #206

Цель

Выполнить решение
«Факультативы: отдельная папка»
и убрать отмеченный в карте редакционный долг справочника DM.

Менти сможет отличить обязательный маршрут от задания по выбору уже по
расположению файла, а объяснение формы витрин поможет связать устройство
стенда с учебной задачей. Цена изменения для читателя: одна подпапка для
факультативов; общий вход и порядок основной программы сохраняются.

Что сделать

Перенести готовое задание в
docs/labs/optional/superset-dashboard.md. Содержание задания, состав
дашборда и приемка остаются прежними.

Обновить входящие ссылки и относительную ссылку внутри перенесенного
задания. В AGENTS.md записать размещение факультативов в optional/ и
имена без номеров. Общий вход остается в docs/labs/README.md; отдельный
индекс подпапки не нужен.

В начале docs/architecture/dm.md объяснить выбранную форму витрин через
учебную цель: материализованные агрегаты дают практику пересборки
конвейером, представление сохраняет зерно исходных событий без их
копирования. Убрать обобщение про все боевые хранилища. Техническое
устройство витрин сохранить. В абзаце со ссылкой на факультатив указать
его место в программе: после ступени 2.

Критерии приемки

Задание находится только в
docs/labs/optional/superset-dashboard.md; изменились лишь путь
файла и относительная ссылка внутри него.
Ссылки в индексе лаб, справочнике DM и спеке программы ведут на
новый файл. Упоминание пути в инвентаризации также актуализировано.
Ссылок на прежнее расположение в репозитории нет.
AGENTS.md различает размещение основной программы и
факультативов. Общий индекс лаб сохранил тематические разделы и
условия доступа к ним; optional/README.md не добавлен.
Первый раздел справочника DM объясняет форму витрин как выбор
этого стенда и называет его учебный смысл. Прежние физические
объекты, способ наполнения и публичные представления сохранены.
В справочнике DM доступность факультатива согласована с индексом
программы и самим заданием: после ступени 2.
Относительные ссылки в измененных документах проверены;
git diff --check проходит. Измененную прозу проверили через
/ai-text-lint и вычитали на русском языке.

Границы

Меняем размещение существующего задания, связанные с ним указатели,
правило размещения в AGENTS.md и указанные абзацы справочника DM.
В спеке программы достаточно актуализировать ссылку: правило размещения
живет в AGENTS.md.

Состав программы, условия выполнения задания и его технические
требования сохраняются. Новые факультативы, индексы, проверочные
скрипты и изменения работающего стенда в задачу не входят.

Сначала прочитать

«Реализация учебной программы: документация стенда и ТЗ лаб»
целиком, включая оба комментария: учебная цель и принятое размещение.
AGENTS.md, разделы о цели репозитория и структуре документов.
docs/labs/README.md и docs/labs/superset-dashboard.md.
docs/architecture/dm.md, первые два раздела.
docs/specs/2026-09-01-labs-program.md, раздел «Superset и BI».

Документы править через /writing-for-agents: правило размещения имеет
один источник, ссылки дают доступ к нему по необходимости.

Проверка

Из корня репозитория:

git diff --check
rg -n 'superset-dashboard' AGENTS.md docs
test ! -e docs/labs/superset-dashboard.md
test -f docs/labs/optional/superset-dashboard.md

По результату поиска проверить все упоминания пути. Отдельно открыть
каждую относительную ссылку в перенесенном задании и измененные ссылки
в остальных документах: перенос меняет глубину каталога.

Работа ограничена Markdown. Проверки работающих служб и пересборка
данных для ее приемки не требуются.

Part of #206 ## Цель Выполнить решение [«Факультативы: отдельная папка»](https://git.dementev.space/ddmitry/clickstream-data-platform/issues/206#issuecomment-2898) и убрать отмеченный в карте редакционный долг справочника DM. Менти сможет отличить обязательный маршрут от задания по выбору уже по расположению файла, а объяснение формы витрин поможет связать устройство стенда с учебной задачей. Цена изменения для читателя: одна подпапка для факультативов; общий вход и порядок основной программы сохраняются. ## Что сделать Перенести готовое задание в `docs/labs/optional/superset-dashboard.md`. Содержание задания, состав дашборда и приемка остаются прежними. Обновить входящие ссылки и относительную ссылку внутри перенесенного задания. В `AGENTS.md` записать размещение факультативов в `optional/` и имена без номеров. Общий вход остается в `docs/labs/README.md`; отдельный индекс подпапки не нужен. В начале `docs/architecture/dm.md` объяснить выбранную форму витрин через учебную цель: материализованные агрегаты дают практику пересборки конвейером, представление сохраняет зерно исходных событий без их копирования. Убрать обобщение про все боевые хранилища. Техническое устройство витрин сохранить. В абзаце со ссылкой на факультатив указать его место в программе: после ступени 2. ## Критерии приемки - [x] Задание находится только в `docs/labs/optional/superset-dashboard.md`; изменились лишь путь файла и относительная ссылка внутри него. - [x] Ссылки в индексе лаб, справочнике DM и спеке программы ведут на новый файл. Упоминание пути в инвентаризации также актуализировано. Ссылок на прежнее расположение в репозитории нет. - [x] `AGENTS.md` различает размещение основной программы и факультативов. Общий индекс лаб сохранил тематические разделы и условия доступа к ним; `optional/README.md` не добавлен. - [x] Первый раздел справочника DM объясняет форму витрин как выбор этого стенда и называет его учебный смысл. Прежние физические объекты, способ наполнения и публичные представления сохранены. - [x] В справочнике DM доступность факультатива согласована с индексом программы и самим заданием: после ступени 2. - [x] Относительные ссылки в измененных документах проверены; `git diff --check` проходит. Измененную прозу проверили через `/ai-text-lint` и вычитали на русском языке. ## Границы Меняем размещение существующего задания, связанные с ним указатели, правило размещения в `AGENTS.md` и указанные абзацы справочника DM. В спеке программы достаточно актуализировать ссылку: правило размещения живет в `AGENTS.md`. Состав программы, условия выполнения задания и его технические требования сохраняются. Новые факультативы, индексы, проверочные скрипты и изменения работающего стенда в задачу не входят. ## Сначала прочитать - [«Реализация учебной программы: документация стенда и ТЗ лаб»](https://git.dementev.space/ddmitry/clickstream-data-platform/issues/206) целиком, включая оба комментария: учебная цель и принятое размещение. - `AGENTS.md`, разделы о цели репозитория и структуре документов. - `docs/labs/README.md` и `docs/labs/superset-dashboard.md`. - `docs/architecture/dm.md`, первые два раздела. - `docs/specs/2026-09-01-labs-program.md`, раздел «Superset и BI». Документы править через `/writing-for-agents`: правило размещения имеет один источник, ссылки дают доступ к нему по необходимости. ## Проверка Из корня репозитория: git diff --check rg -n 'superset-dashboard' AGENTS.md docs test ! -e docs/labs/superset-dashboard.md test -f docs/labs/optional/superset-dashboard.md По результату поиска проверить все упоминания пути. Отдельно открыть каждую относительную ссылку в перенесенном задании и измененные ссылки в остальных документах: перенос меняет глубину каталога. Работа ограничена Markdown. Проверки работающих служб и пересборка данных для ее приемки не требуются.

ddmitry added the ready-for-agent wayfinder:task labels 2026-09-07 14:03:57 +03:00

ddmitry referenced this issue

2026-09-07 14:04:27 +03:00

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

ddmitry self-assigned this 2026-09-07 14:04:44 +03:00

ddmitry referenced a pull request that will close this issue

2026-09-07 14:32:23 +03:00

Факультативы в отдельной папке #245

ddmitry closed this issue

2026-09-07 14:54:12 +03:00

Sign in to join this conversation.