diff --git a/sql/ddl_gp.sql b/sql/ddl_gp.sql
index 026e601..a33111d 100644
--- a/sql/ddl_gp.sql
+++ b/sql/ddl_gp.sql
@@ -1,4 +1,17 @@
--- Greenplum DDL (GPDB 6 совместимо)
+-- Главный входной DDL-скрипт для Greenplum в учебном стенде.
+-- Выполняется из контейнера командой `make ddl-gp` и создаёт/обновляет
+-- все объекты, которые нужны базовым DAG (csv_to_greenplum, bookings_to_gp_stage).
+--
+-- Идея такая:
+--   - здесь описаны только верхнеуровневые объекты (orders, внешняя таблица bookings);
+--   - более подробный DDL для отдельных слоёв (stg, src и т.п.) лежит в соседних файлах
+--     в каталоге sql/ и подключается через psql-команду \i;
+--   - чтобы не ломать задания, новые объекты лучше добавлять в отдельные файлы и
+--     подключать их отсюда, а существующие определения не удалять.
+--
+-- Подробнее про STG/bookings: см. docs/internal/bookings_stg_readme.md.
+
+-- Таблица для CSV‑пайплайна (csv_to_greenplum).
 -- Колонночная таблица (append-optimized) и распределение по ключу.
 -- Внимание: append-optimized таблицы не поддерживают UNIQUE/PRIMARY KEY,
 -- поэтому контроль дублей выполняем в DAG при загрузке.