docs(labs): упрощен язык учебных заданий

Зачем: помочь менти понять действия, проверить результат и оценить освоенное умение.

Что: вычитаны 13 заданий основной программы и общий индекс. Итоговые списки обращены к учащемуся, убраны история разработки и повторы. Правила учебного текста записаны в программе, из AGENTS.md добавлена ссылка.

Проверка: git diff --check, локальные ссылки и ссылки на измененные заголовки прошли. Блоки кода и таблицы требований совпадают с исходными. Упражнения на стенде повторно не выполнялись: изменен только текст.
This commit is contained in:
ddadmin committed 2026-09-13 11:01:35 -04:00
1 parent a03838b953
commit 4058e18864
16 files changed
+287 -269

No files matched your search

+32 -3
View File
@@ -40,6 +40,35 @@
- *расследование* — данные уже лежат на стенде или стенд намеренно ломается, а
менти ищет причину и объясняет ее.
### Как писать задания
Задание обращается к учащемуся на «вы». Начните с «Чему учит»: назовите
умение, которое он получит. Затем объясните, для чего нужен результат, и
ведите читателя по действиям. Термины раскрывайте там, где без них нельзя
понять следующий шаг. Историю разработки оставляйте в рабочих справочниках.
Раздел «Как проверить себя» описывает способ проверки: что выполнить,
с чем сравнить и где искать причину расхождения. Если проверка и есть ход
исследования, сохраните ее в шагах, без повторного раздела. В конце задания
«Что должно получиться» помогает учащемуся оценить результат: что у него
работает, что он проверил и что может объяснить. Чекбоксы обращены к нему:
«вы сверили числа», «у вас сохранен запрос». Подробный порядок действий
остается в основной части.
Заголовки остальных разделов выбирайте по содержанию: «Для чего нужна
витрина», «Найдите причину», «Как даг запускает ваши запросы». Число разделов
и пунктов определяется упражнением. Ограничения объясняйте рядом с действием,
которого они касаются; завершение опыта включает восстановление данных или
удаление временных объектов, когда это требуется.
При вычитке сохраняйте состав результата, технические условия, способы
проверки и самостоятельную часть работы. Новое упражнение или готовое решение
под видом пояснения меняет учебный смысл и требует отдельного обсуждения.
Формат инженерных issues из правил трекера относится к разработке стенда;
учебные задания пишутся по этим правилам. Образцы:
[дашборд Superset](../labs/optional/superset-dashboard.md) и
[расследование подключения](../labs/optional/superset-missing-object.md).
## 3. Основная программа — семь ступеней
### Ступень 1. Построй пять витрин слоя DM
@@ -64,7 +93,7 @@
ступени предстоит написать при реализации программы. Полный собственный дашборд
остается факультативом в разделе «Superset и BI».
### Ступень 3. Нарежь сессии сам
### Ступень 3. Нарежьте сессии сами
До того как открыть стендовый SQL нарезки сессий в DDS, менти самостоятельно
делит события на визиты. Сначала он сравнивает число своих сессий с эталоном
@@ -75,7 +104,7 @@
Форма — построить свое по ТЗ и провести расследование. Обратная связь состоит
из счетной сверки с `VisitID` и ручного сопоставления границ.
### Ступень 4. Перепиши нарезку стенда
### Ступень 4. Перепишите нарезку стенда
Менти удаляет и заново пишет SQL нарезки сессий DDS: расчет объема, пересборку
и замену. Урок — изменить расчетную сущность внутри готового конвейера и
@@ -86,7 +115,7 @@
Форма — вычитание. Обратную связь дают `dq_check` и поштучная сверка,
построенная на третьей ступени.
### Ступень 5. Сначала сторож, потом ломай: заказы
### Ступень 5. Проверьте заказы перед изменением обработки
Сначала менти строит две недостающие DQ-проверки. Первая утверждает равенство
«цена × количество = items_total». Вторая сверяет слой с источником по дням. Их