From 8932148c44ae902e0bb439e9d16a36c6e21b2c79 Mon Sep 17 00:00:00 2001 From: Dmitry Dementev Date: Wed, 11 Mar 2026 19:34:45 +0300 Subject: [PATCH] =?UTF-8?q?chore(docs):=20=D0=B2=D0=B2=D0=B5=D0=B4=D0=B5?= =?UTF-8?q?=D0=BD=D0=B0=20=D0=BA=D0=BE=D0=BD=D0=B2=D0=B5=D0=BD=D1=86=D0=B8?= =?UTF-8?q?=D1=8F=20=D0=BD=D0=B5=D0=B9=D0=BC=D0=B8=D0=BD=D0=B3=D0=B0=20?= =?UTF-8?q?=D0=BF=D0=BB=D0=B0=D0=BD=D0=BE=D0=B2,=20=D0=BF=D0=B5=D1=80?= =?UTF-8?q?=D0=B5=D0=B8=D0=BC=D0=B5=D0=BD=D0=BE=D0=B2=D0=B0=D0=BD=D1=8B=20?= =?UTF-8?q?=D0=B0=D1=80=D1=85=D0=B8=D0=B2=D0=BD=D1=8B=D0=B5=20=D1=84=D0=B0?= =?UTF-8?q?=D0=B9=D0=BB=D1=8B?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit - Зачем: - файлы планов именовались хаотично (микс snake_case/kebab-case, без дат), из-за чего архив не сортировался хронологически. - Что: - установлен формат YYYY-MM-DD_краткое-описание.md для docs/plans/ и docs/archive/. - переименованы 6 архивных файлов по новой конвенции (git mv). - конвенция зафиксирована в AGENTS.md (секция «Карта проекта»). - Проверка: - ls docs/archive/ — все файлы начинаются с даты в kebab-case. --- AGENTS.md | 1 + ...stg_code_review.md => 2026-01-18_bookings-stg-code-review.md} | 0 ...lization_plan.md => 2026-03-04_dim-routes-denormalization.md} | 0 ...cs_restructuring_plan.md => 2026-03-10_docs-restructuring.md} | 0 .../{educational-tasks.md => 2026-03-10_educational-tasks.md} | 0 ..._unification_plan.md => 2026-03-10_stg-naming-unification.md} | 0 .../{docs-etl-quality-plan.md => 2026-03-11_docs-etl-quality.md} | 0 7 files changed, 1 insertion(+) rename docs/archive/{bookings_stg_code_review.md => 2026-01-18_bookings-stg-code-review.md} (100%) rename docs/archive/{dim_routes_denormalization_plan.md => 2026-03-04_dim-routes-denormalization.md} (100%) rename docs/archive/{docs_restructuring_plan.md => 2026-03-10_docs-restructuring.md} (100%) rename docs/archive/{educational-tasks.md => 2026-03-10_educational-tasks.md} (100%) rename docs/archive/{stg_naming_unification_plan.md => 2026-03-10_stg-naming-unification.md} (100%) rename docs/archive/{docs-etl-quality-plan.md => 2026-03-11_docs-etl-quality.md} (100%) diff --git a/AGENTS.md b/AGENTS.md index e01e4ef..bd05319 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -14,6 +14,7 @@ - *Правило ИИ:* DDL таблиц хранится строго рядом с объектом (напр. `sql/stg/bookings_ddl.sql`). - `docs/` — документация. Подкаталоги: `design/` (дизайн, стандарты), `reference/` (справочники), `plans/` (активные планы), `archive/` (выполненные планы), `assignment/` (задание для студента). - `docs/design/naming_conventions.md` — единый источник нейминга служебных и SCD-полей. *Правило ИИ: всегда сверяться при генерации DDL/SQL.* + - Нейминг файлов планов: `YYYY-MM-DD_краткое-описание.md` (дата — ISO 8601, `_` отделяет дату от описания, описание в kebab-case, без суффикса `-plan`). - `tests/` — pytest-тесты (smoke-тесты DAG'ов и юнит-тесты). - `.env` — Настройки окружения (все секреты `GP_*`, `AIRFLOW_*` берем только отсюда). diff --git a/docs/archive/bookings_stg_code_review.md b/docs/archive/2026-01-18_bookings-stg-code-review.md similarity index 100% rename from docs/archive/bookings_stg_code_review.md rename to docs/archive/2026-01-18_bookings-stg-code-review.md diff --git a/docs/archive/dim_routes_denormalization_plan.md b/docs/archive/2026-03-04_dim-routes-denormalization.md similarity index 100% rename from docs/archive/dim_routes_denormalization_plan.md rename to docs/archive/2026-03-04_dim-routes-denormalization.md diff --git a/docs/archive/docs_restructuring_plan.md b/docs/archive/2026-03-10_docs-restructuring.md similarity index 100% rename from docs/archive/docs_restructuring_plan.md rename to docs/archive/2026-03-10_docs-restructuring.md diff --git a/docs/archive/educational-tasks.md b/docs/archive/2026-03-10_educational-tasks.md similarity index 100% rename from docs/archive/educational-tasks.md rename to docs/archive/2026-03-10_educational-tasks.md diff --git a/docs/archive/stg_naming_unification_plan.md b/docs/archive/2026-03-10_stg-naming-unification.md similarity index 100% rename from docs/archive/stg_naming_unification_plan.md rename to docs/archive/2026-03-10_stg-naming-unification.md diff --git a/docs/archive/docs-etl-quality-plan.md b/docs/archive/2026-03-11_docs-etl-quality.md similarity index 100% rename from docs/archive/docs-etl-quality-plan.md rename to docs/archive/2026-03-11_docs-etl-quality.md