docs(ui): сделать подсказки и сообщения проверок понятными менти #251

New Issue

2026-09-13T20:32:41+03:00

ddmitry commented

2026-09-13 20:32:41 +03:00

Режим выполнения

Редактуру выполняет Codex самостоятельно, без субагентов. Рекомендуемый reasoning effort: medium. Словарь рекомендуется выполнить первым: его определения станут опорой для остальных материалов.

Чему учит

Осознанно запускать учебные действия и по результату проверки понимать, что произошло и где искать причину ошибки.

Работа

Вычитать тексты, которые менти видит при работе со стендом. Начать с конкретных мест: «Сколько дней прожить» в форме Airflow, «сверьте договор колонок» в самопроверке, «Выручка purchase» в Superset.

Проверить пользовательские подписи и подсказки в dags/world_control.py, сообщения dags/homework_check.py и dags/dq_check.py, вывод scripts/run-dag.sh. С ними за один проход — заголовки, описания и подписи полей в infra/superset/import/{datasets,charts,dashboards}/ и трех дашбордах infra/grafana/provisioning/dashboards/{data,cluster,queries}.json.

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

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

Перед запуском понятно, сколько модельных дней будет создано и что означает параметр; подписи согласованы с handbook и фактическим поведением.
При неудачной самопроверке понятно, что проверить дальше; сохранены полезные имена объектов, значения и детали ошибки.
Названия показателей позволяют различить данные событий и заказов без расшифровки смешанных русско-английских фраз.
Подсказки помогают расследованию, но не содержат готового решения лабораторной и не скрывают ошибки.
Изменены только отображаемые тексты: условия проверок, параметры запуска, запросы, метрики, идентификаторы и UUID сохранены.

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

CONTEXT.md, docs/handbook/airflow-dags.md, docs/handbook/monitoring.md, docs/handbook/superset.md, описание самопроверки в docs/architecture/dm.md, затем перечисленные исходники.

Проверка

git diff --check, корневой make lint при изменении Python. Проверить разбор измененных YAML/JSON и просмотреть представительные подписи, форму и сообщения. Проверять на безопасных примерах без создания новых дней, очистки данных и перезаписи пользовательских объектов BI. В результате отдельно указать, что проверено в интерфейсе, а что только по исходникам.

Общие границы

Это продолжение редактуры материалов для начинающего инженера данных. Образцы языка — корневой README, главы docs/handbook/ и задания docs/labs/. Писать простым русским языком; термины объяснять при первом употреблении. Не упрощать технический смысл и не подменять объяснение образными оборотами.

Уже вычитанные лабораторные, handbook и карту не переписывать. Исторические спеки, ADR и внутренние инструкции не входят в задачу. Перед приемкой сделать проход на сокращение: убрать повторы и пояснения, которые не помогают пройти учебную программу. Имена объектов, технические условия и полезные примеры сохранить.

## Режим выполнения Редактуру выполняет Codex самостоятельно, без субагентов. Рекомендуемый reasoning effort: `medium`. Словарь рекомендуется выполнить первым: его определения станут опорой для остальных материалов. ## Чему учит Осознанно запускать учебные действия и по результату проверки понимать, что произошло и где искать причину ошибки. ## Работа Вычитать тексты, которые менти видит при работе со стендом. Начать с конкретных мест: «Сколько дней прожить» в форме Airflow, «сверьте договор колонок» в самопроверке, «Выручка purchase» в Superset. Проверить пользовательские подписи и подсказки в `dags/world_control.py`, сообщения `dags/homework_check.py` и `dags/dq_check.py`, вывод `scripts/run-dag.sh`. С ними за один проход — заголовки, описания и подписи полей в `infra/superset/import/{datasets,charts,dashboards}/` и трех дашбордах `infra/grafana/provisioning/dashboards/{data,cluster,queries}.json`. Править найденные непонятные формулировки, а не все строки перечисленных файлов. Сообщение об ошибке должно называть проверяемый объект, объяснять наблюдаемый результат и указывать, где посмотреть подробности. Подсказка к параметру должна объяснять действие и значение параметра. ## Критерии приемки - [x] Перед запуском понятно, сколько модельных дней будет создано и что означает параметр; подписи согласованы с handbook и фактическим поведением. - [x] При неудачной самопроверке понятно, что проверить дальше; сохранены полезные имена объектов, значения и детали ошибки. - [x] Названия показателей позволяют различить данные событий и заказов без расшифровки смешанных русско-английских фраз. - [x] Подсказки помогают расследованию, но не содержат готового решения лабораторной и не скрывают ошибки. - [x] Изменены только отображаемые тексты: условия проверок, параметры запуска, запросы, метрики, идентификаторы и UUID сохранены. ## Сначала прочитать `CONTEXT.md`, `docs/handbook/airflow-dags.md`, `docs/handbook/monitoring.md`, `docs/handbook/superset.md`, описание самопроверки в `docs/architecture/dm.md`, затем перечисленные исходники. ## Проверка `git diff --check`, корневой `make lint` при изменении Python. Проверить разбор измененных YAML/JSON и просмотреть представительные подписи, форму и сообщения. Проверять на безопасных примерах без создания новых дней, очистки данных и перезаписи пользовательских объектов BI. В результате отдельно указать, что проверено в интерфейсе, а что только по исходникам. ## Общие границы Это продолжение редактуры материалов для начинающего инженера данных. Образцы языка — корневой README, главы `docs/handbook/` и задания `docs/labs/`. Писать простым русским языком; термины объяснять при первом употреблении. Не упрощать технический смысл и не подменять объяснение образными оборотами. Уже вычитанные лабораторные, handbook и карту не переписывать. Исторические спеки, ADR и внутренние инструкции не входят в задачу. Перед приемкой сделать проход на сокращение: убрать повторы и пояснения, которые не помогают пройти учебную программу. Имена объектов, технические условия и полезные примеры сохранить.

ddmitry added the ready-for-agent label 2026-09-13 20:32:41 +03:00

ddmitry self-assigned this 2026-09-13 23:34:53 +03:00

ddmitry referenced a pull request that will close this issue

2026-09-13 23:42:07 +03:00

docs(ui): уточнены подсказки и сообщения учебного стенда #254

ddmitry closed this issue

2026-09-14 09:08:43 +03:00

Sign in to join this conversation.

1 Participants

Notifications

Due Date

No due date set.

Dependencies

No dependencies set.

Reference: ddmitry/clickstream-data-platform#251