feat(infra): поднят кластер ClickHouse из двух шардов и keeper

- Зачем:
  - этап 1 спеки требует стенд, поднимаемый одной командой; кластер —
    единственный режим, выключателя «без кластера» нет (issue #12).
- Что:
  - compose.yaml: две ноды ClickHouse и отдельный clickhouse-keeper на
    зафиксированном LTS-образе 26.3.17.56, порты только на 127.0.0.1.
  - infra/clickhouse: общее описание кластера, подключение к keeper и
    отдельные макросы shard и replica для каждой ноды.
  - scripts/clickhouse-smoke.sh: восемь проверок ON CLUSTER от описания
    кластера до удаления временных таблиц, вывод по-русски.
  - tests/smoke-guards.sh: три проверки самой smoke-команды —
    ограниченная аварийная очистка, обработка прерывания, окружение keeper.
  - README.md: быстрый старт, роли нод, обоснование выбора версии.
- Проверка:
  - make up && make smoke && make smoke-guards && make clean

README.md

@@ -8,9 +8,64 @@ clickhouse-keeper), Airflow, Superset. Преемник учебного сте
 
 Репозиторий строится по спеке
 [«Боевой реализм стенда (v2)»](docs/specs/2026-07-30-stand-v2-realism.md).
-Работающего стенда пока нет: здесь только спека, исследование формата данных и
-контракт работы ([AGENTS.md](AGENTS.md)). Быстрый старт появится вместе с
-этапом «Каркас стенда».
+Сейчас готов первый элемент каркаса: кластер ClickHouse из двух шардов и
+отдельного clickhouse-keeper.
+
+## Быстрый старт
+
+Нужны Docker с Compose и свободные порты `28123`, `28124`, `29000`, `29001`.
+Настройки портов и образа лежат в `.env` и не попадают в git:
+
+```bash
+cp .env.example .env
+make up
+make smoke
+```
+
+`make up` поднимает единственный режим стенда: два шарда ClickHouse по одной
+реплике и отдельный keeper. Команда ждёт здорового состояния всех трёх
+контейнеров. Нода `clickhouse-01` служит инициатором DDL и позже будет точкой
+подключения Airflow. К `clickhouse-02` позже подключится Superset.
+
+`make smoke` одной командой проверяет описание кластера, макросы нод, связь с
+keeper, создание `ReplicatedMergeTree` и `Distributed` через `ON CLUSTER`,
+путь в keeper из макроса, вставку через первую ноду и чтение со второй,
+очередь распределённых DDL и удаление временных таблиц. Скрипт печатает каждый
+шаг и зелёный результат по-русски.
+
+`make smoke-guards` проверяет саму smoke-команду: аварийную очистку, обработку
+прерывания, подсказку о незапущенном стенде и окружение keeper.
+
+Остановить контейнеры можно командой `make down`. Для холодного старта с
+удалением данных используйте `make clean`.
+
+HTTP-интерфейсы доступны только с локальной машины:
+
+- нода 1 — `http://127.0.0.1:28123`;
+- нода 2 — `http://127.0.0.1:28124`.
+
+У локального учебного кластера нет пароля: ноды используют общего пользователя
+`default` для запросов `Distributed`. Порты поэтому привязаны к `127.0.0.1` и
+не открыты во внешнюю сеть.
+
+В бою перед репликами ClickHouse обычно был бы балансировщик. Здесь в каждом
+шарде одна реплика, поэтому балансировать нечего. Балансировщик и топология
+2×2 намеренно не входят в стенд.
+
+Конфигурация сверена 30 июля 2026 года с официальной документацией ClickHouse:
+[настройками сервера](https://clickhouse.com/docs/operations/server-configuration-parameters/settings),
+[Keeper](https://clickhouse.com/docs/guides/oss/deployment-and-scaling/keeper/),
+[ReplicatedMergeTree](https://clickhouse.com/docs/engines/table-engines/mergetree-family/replication),
+[ON CLUSTER](https://clickhouse.com/docs/sql-reference/distributed-ddl) и
+[Distributed](https://clickhouse.com/docs/engines/table-engines/special/distributed).
+Описание кластера задаётся через `remote_servers`, макросы — через `macros`,
+подключение к keeper — через `zookeeper`; путь `ReplicatedMergeTree` содержит
+`{shard}` и `{replica}`, а `Distributed` получает имя кластера, базу, локальную
+таблицу и ключ шардирования. Макросы выбраны, чтобы один DDL через `ON CLUSTER`
+создавал отдельный путь каждого шарда без вписанных вручную значений. Для
+образа зафиксирован точный текущий
+[LTS-выпуск 26.3.17.56](https://github.com/ClickHouse/ClickHouse/releases/tag/v26.3.17.56-lts);
+серверы и keeper используют один образ.
 
 ## Что здесь будет