feat(generator): эталонный мир в git и import по умолчанию

ddmitry/clickstream-ch-kafka-superset-demo

- Зачем:
  - менти собирал мир генерацией (минуты и десятки минут CPU); теперь
    готовый трёхдневный мир загружается импортом за ~2 минуты, и числа
    у всех менти совпадают число-в-число (issue #3).
- Что:
  - артефакт data/startup_history/reference-world.json.xz в git:
    3 модельных дня daily-wave, ~850 МБ JSON → 32 МБ xz;
  - чтение и запись артефакта понимают .xz потоково (lzma); пустое поле
    artifact_path в пульте и make startup-history-import читают эталон;
  - длительность профиля daily-wave стала 3d — в тон эталонному миру;
  - предпроверка чистого стенда ставит зависимости генератора через uv;
    экспорт и импорт разведены отдельными переменными Makefile;
  - доки и runbook обновлены; новые контрактные тесты: xz round-trip
    и дефолтные пути артефакта.
- Проверка:
  - make test (210 + 31) и make lint зелёные; импорт на чистом стенде
    за 2м03с, manifest совпал (280437 событий), Superset-проверка
    зелёная; независимое ревью — APPROVED.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>

This commit is contained in:

ddadmin

2026-07-22 18:49:02 +03:00

co-authored by

Claude Fable 5

parent b87dde79b7

commit 10ee1a1cb6

21 changed files with 165 additions and 35 deletions

									
										scripts/check_startup_history_manifest.sh
									
		+1
		-1
	
												View File
												
				@@ -27,7 +27,7 @@ clickhouse_datetime_literal() {

				[[ -s "${ARTIFACT}" ]] || fail "артефакт не найден или пуст: ${ARTIFACT}"

				ARTIFACT_DIR="$(dirname "${ARTIFACT}")"

				ARTIFACT_DIR="$(cd "$(dirname "${ARTIFACT}")" && pwd)"

				ARTIFACT_FILE="$(basename "${ARTIFACT}")"

				manifest_summary="$(${COMPOSE_BIN} run --rm --no-deps \