refactor(generator): нормализованное имя вместо имени в DDS, тесты на имена сняты
- Зачем:
- контракт вёл себя как хозяин чужого слоя: поле называлось dds_name, в
описании стоял столбец «Имя в DDS», а два теста прибивали имена
гвоздями. Спека же задала вид имени (snake_case), а не список: имена
атрибутов складывает модель данных DDS, и решать это не трекеру.
- Что:
- поле контракта и столбец описания стали нормализованным именем: имя
источника в нашем стиле. В описании и в докстринге сказано прямо, что
слой DDS называет атрибуты по своей модели.
- сняты оба теста на имена — копия имён DDS и конспект состава по
мастер-спеке. Они не проверяли верность имени, только неизменность, а
неизменность и так сторожит пересборка описания: молчаливой правки
контракта не бывает, она всплывает диффом документа.
- остались проверки формы: 47 колонок, уникальность, стили имён,
заполненность, согласие типов numpy и ClickHouse, порядок групп.
- спека генератора (раздел 3) и CONTEXT.md согласованы тем же
коммитом: уточнение внесено как расхождение, найденное при исполнении.
- Проверка:
- make test (248 тестов), make lint, make config-test;
- make docs, затем git diff --exit-code docs/ — пусто.
Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
This commit is contained in:
@@ -156,9 +156,13 @@
|
||||
валидация и публичное «описание выгрузки» в доках — рендеренная таблица
|
||||
колонок, аналог документации Метрики.
|
||||
- **Форма контракта — импортируемый python-модуль с чистыми данными**:
|
||||
описатели колонок (имя Метрики, тип ClickHouse, тип numpy, snake_case-имя
|
||||
для DDS, группа полей, порядок), никакой логики. Читаемость для менти
|
||||
несёт рендеренная таблица в доках, не модуль.
|
||||
описатели колонок (имя Метрики, тип ClickHouse, тип numpy, нормализованное
|
||||
snake_case-имя, группа полей, порядок), никакой логики. Читаемость для
|
||||
менти несёт рендеренная таблица в доках, не модуль. Уточнение при
|
||||
исполнении (#36): нормализованное имя — имя источника, приведённое к
|
||||
нашему стилю, а не имя атрибута в модели данных. Слой DDS складывает свою
|
||||
модель и называет атрибуты по ней; `dds.v_event` эти имена берёт (раздел 7
|
||||
мастер-спеки), но контракт их не диктует и тестами не сторожит.
|
||||
- **Сторона хранилища пишется по документации, не генерируется.** DDL
|
||||
`ods.event`, SELECT матвью, `dds.v_event`, трансформации — работа
|
||||
следующих этапов по «описанию выгрузки», как в бою хранилище адаптируется
|
||||
|
||||
Reference in New Issue
Block a user