docs(generator): закрыта задача 18 в трекере

- Зачем:
  - coordinator-loop отделяет рабочие изменения от статусов и журнала.
- Что:
  - задача 18 переведена в done с закрытыми критериями.
  - журнал дополнен ревью, проверками чистого маршрута и коммитом.
- Проверка:
  - staged-состав содержит только issue 18 и журнал.
This commit is contained in:
2026-07-05 22:01:44 +03:00
parent 77e4fb6119
commit 6d64f3909a
2 changed files with 45 additions and 7 deletions
@@ -514,3 +514,41 @@
gate оставил `clickhouse`, `kafka` running. gate оставил `clickhouse`, `kafka` running.
- 21:32 Issue 17 рабочий коммит: `00c97eb` - 21:32 Issue 17 рабочий коммит: `00c97eb`
(`test(generator): усилены проверки startup-history и Superset`). (`test(generator): усилены проверки startup-history и Superset`).
- 21:33 Перед issue 18: дерево clean; dependencies 15, 16, 17 закрыты. Issue
18 запущен worker-у. Режим ревью: обычный; worker reasoning_effort=`medium`;
code review/docs review после реализации `high`. Примечание: runtime gate 17
оставил `clickhouse`, `kafka` running; worker должен сам очистить или
подготовить стенд перед проверкой курса.
- 21:51 Issue 18: worker вернул `DONE_WITH_CONCERNS`. Индекс: урок 00
объясняет служебные топики генератора; урок 01 переводит перезаливку
`kafka_msg_ts` на `CLEAN_START=0`; урок 05 согласован с no-live default и
consumer lag; course README добавляет HITL-пункт чистого маршрута 00/01/05;
OPERATIONS ведёт STG-путь через startup-history, `make data` архивный.
Checks worker-а: `make generated-history-analytics` PASS на чистом стенде;
`make up` PASS; SQL-проверка `kafka_msg_ts` + `CLEAN_START=0` PASS
(16054/16054); восстановление схемы PASS; Kafka topics PASS; Prometheus
targets PASS (`generator=0` no-live); `system.kafka_consumers` PASS;
`git diff --check` PASS. Concern: стенд после проверки не свежий из-за
намеренного `CLEAN_START=0`.
- 21:52 Issue 18 code/docs review запущен координатором: свежий
observer-субагент `Hume`, reasoning_effort=`high`, без правок репозитория и
среды.
- 21:53 Issue 18 code/docs review `Hume`: `APPROVED` с medium finding:
урок 05 говорит о трёх Prometheus scrape-блоках, но в `configs/prometheus.yml`
их четыре, включая `generator`; находка возвращена worker-у для короткого
триажа перед коммитом.
- 21:54 Issue 18: worker вернул `DONE` после medium finding. Исправлено:
урок 05 говорит о четырёх scrape-блоках и связывает `generator:9109` с
ожидаемым `DOWN` без live. Checks: `rg` PASS; `git diff --check` по уроку
PASS.
- 21:55 Issue 18 docs narrow rerun отправлен `Hume`: проверить закрытие
medium-находки по Prometheus scrape-блокам.
- 21:55 Issue 18 docs narrow rerun `Hume`: `APPROVED`. Findings: нет.
Chain-level решение: открыть коммит-гейт 18.
- 22:00 Issue 18 commit gate: doc `rg` PASS; `git diff --check` PASS;
`make generated-history-analytics` PASS (manifest profile `ci`,
T_end=`2026-01-01T06:00:00+00:00`, 16054 events); `make up` PASS. Diff в
границах issue 18; журнал не staged.
- 22:00 Issue 18 рабочий коммит: `77e4fb6`
(`docs(course): согласованы уроки со startup-history`).
@@ -1,4 +1,4 @@
Status: ready-for-agent Status: done
# Курс проходит по startup-history на чистом стенде # Курс проходит по startup-history на чистом стенде
@@ -20,19 +20,19 @@ Status: ready-for-agent
## Acceptance criteria ## Acceptance criteria
- [ ] Упражнение урока 01 с добавлением `kafka_msg_ts` воспроизводимо на стенде: - [x] Упражнение урока 01 с добавлением `kafka_msg_ts` воспроизводимо на стенде:
повторная заливка данных не сбрасывает схему, которую только что изменил повторная заливка данных не сбрасывает схему, которую только что изменил
менти. менти.
- [ ] Урок 00 объясняет служебные топики генератора настолько, чтобы список - [x] Урок 00 объясняет служебные топики генератора настолько, чтобы список
топиков не выглядел как набор неожиданных артефактов. топиков не выглядел как набор неожиданных артефактов.
- [ ] Уроки 00 и 05 не противоречат друг другу в описании видимости consumer lag; - [x] Уроки 00 и 05 не противоречат друг другу в описании видимости consumer lag;
утверждение проверено на текущем стенде. утверждение проверено на текущем стенде.
- [ ] Урок мониторинга согласован с no-live default: либо явно запускает live, - [x] Урок мониторинга согласован с no-live default: либо явно запускает live,
либо не обещает, что алерт отсутствия сообщений будет тихим на здоровом либо не обещает, что алерт отсутствия сообщений будет тихим на здоровом
стенде без live. стенде без live.
- [ ] Операционная документация не ведёт учебный путь первым делом к архивному - [x] Операционная документация не ведёт учебный путь первым делом к архивному
`make data`; startup-history остаётся основным источником аналитики. `make data`; startup-history остаётся основным источником аналитики.
- [ ] Проход уроков 00, 01 и 05 на чистом стенде проверен командно или вынесен - [x] Проход уроков 00, 01 и 05 на чистом стенде проверен командно или вынесен
в явный HITL-пункт с точной инструкцией, что должен подтвердить человек. в явный HITL-пункт с точной инструкцией, что должен подтвердить человек.
## Blocked by ## Blocked by