feat: vocabulary YAML + demo DB script + auto-load vocab

configs/example_vocabulary.yaml

@@ -1,33 +1,60 @@
-# Бизнес-словарь компании — пример заполнения
-# Скопируй этот файл, переименуй под свою компанию и заполни своими терминами.
-# Путь к файлу указывается при запуске утилиты.
+# Бизнес-словарь для демо-базы (data/demo/sales.sqlite)
+# Загружается автоматически при подключении к демо-базе.
+#
+# Скопируй этот файл и переименуй под свою компанию.
+# Затем загрузи через боковую панель → «Применить словарь».
 
-company: "ООО Ромашка"
+company: "Демо: Интернет-магазин электроники"
+
+# ──────────────────────────────────────────────
+# СХЕМА ДЕМО-БАЗЫ (справка)
+# ──────────────────────────────────────────────
+# customers  : id, name, city, phone, email, created_at
+# managers   : id, name, department
+# products   : id, name, category, price, is_active
+# orders     : id, customer_id, manager_id, AMOUNT, status, order_date
+# order_items: id, order_id, product_id, quantity, price
+#
+# orders.amount      = итоговая сумма заказа (рублей)
+# order_items.price  = цена единицы товара
+# order_items.quantity = количество штук
+# Итог позиции = order_items.quantity * order_items.price
+# В order_items НЕТ колонки amount!
 
-# Бизнес-термины и метрики
-# Ключ — слово/фраза как говорит аналитик
-# Значение — что это означает в терминах SQL / данных
 terms:
-  выручка: "SUM(orders.amount) при условии orders.status = 'paid'"
+  выручка: >
+    SUM(orders.amount) WHERE orders.status = 'paid'.
+    Колонка amount есть только в таблице orders, не в order_items.
   оборот: "SUM(orders.amount) по всем заказам включая отменённые"
-  активный клиент: "клиент, совершивший хотя бы одну покупку за последние 90 дней"
-  новый клиент: "клиент, зарегистрированный менее 30 дней назад"
-  этот год: "YEAR(order_date) совпадает с текущим годом"
-  прошлый месяц: "месяц предшествующий текущему"
-  этот квартал: "текущий квартал календарного года (Q1=янв-март, Q2=апр-июн и т.д.)"
-  средний чек: "AVG(orders.amount) по оплаченным заказам"
-  конверсия: "доля оплаченных заказов от общего числа"
+  средний чек: "AVG(orders.amount) WHERE orders.status = 'paid'"
+  топ клиентов: >
+    GROUP BY customers.id, customers.name ORDER BY SUM(orders.amount) DESC LIMIT N.
+    JOIN customers ON orders.customer_id = customers.id WHERE orders.status = 'paid'.
+  топ товаров: >
+    GROUP BY products.name ORDER BY SUM(order_items.quantity) DESC LIMIT N.
+    JOIN order_items ON orders.id = order_items.order_id WHERE orders.status = 'paid'.
+  выручка по товарам: >
+    SUM(order_items.quantity * order_items.price) GROUP BY products.name.
+    Итог позиции считается как quantity * price из order_items.
+  количество заказов: "COUNT(*) FROM orders WHERE status = 'paid'"
+  активный товар: "products.is_active = 1"
+  этот год: "strftime('%Y', orders.order_date) = strftime('%Y', 'now')"
+  прошлый год: "strftime('%Y', orders.order_date) = CAST(strftime('%Y', 'now') - 1 AS TEXT)"
+  этот месяц: "strftime('%Y-%m', orders.order_date) = strftime('%Y-%m', 'now')"
+  конверсия: >
+    CAST(SUM(CASE WHEN status='paid' THEN 1 ELSE 0 END) AS REAL) / COUNT(*) * 100 FROM orders.
 
-# Стандартные условия фильтрации (применяются по умолчанию если аналитик явно не указал иное)
 filters:
   только_оплаченные: "orders.status = 'paid'"
-  без_возвратов: "orders.is_return = 0 или orders.is_return IS NULL"
   только_активные_товары: "products.is_active = 1"
 
-# Дополнительные правила и особенности схемы
 notes:
-  - "Таблица orders содержит все заказы. Колонка amount — сумма в рублях."
-  - "Клиенты хранятся в таблице customers, товары — в products."
-  - "Связь заказ-товар через таб��ицу order_items (order_id, product_id, quantity, price)."
-  - "Даты хранятся в формате YYYY-MM-DD в колонке order_date."
-  - "Менеджеры хранятся в таблице managers, связь с заказами через orders.manager_id."
+  - "КРИТИЧНО: колонка 'amount' существует ТОЛЬКО в таблице 'orders'. В 'order_items' её НЕТ."
+  - "order_items содержит колонки: id, order_id, product_id, quantity, price. Никакой колонки amount."
+  - "Стоимость позиции заказа = order_items.quantity * order_items.price (отдельной колонки нет)."
+  - "Даты хранятся как TEXT 'YYYY-MM-DD'. Для фильтрации используй BETWEEN или strftime()."
+  - "Статусы заказов: 'paid' (оплачен), 'pending' (ожидает), 'cancelled' (отменён)."
+  - "Связи: orders.customer_id → customers.id, orders.manager_id → managers.id."
+  - "Связи: order_items.order_id → orders.id, order_items.product_id → products.id."
+  - "База данных: SQLite. Функции дат: strftime('%Y', date_col), date('now', '-N days')."
+  - "База содержит данные за 2025-01-01 — 2026-04-30, 8 клиентов, 4 менеджера, 10 товаров."

configs/sales_vocabulary.yaml

@@ -0,0 +1,79 @@
+# Бизнес-словарь для демо-базы sales.sqlite
+# Загрузи этот файл в приложении через боковую панель → «Применить словарь»
+
+company: "Демо: Интернет-магазин электроники"
+
+# ──────────────────────────────────────────────
+# СХЕМА (справочная часть — влияет на промпт)
+# ──────────────────────────────────────────────
+#
+# customers  : id, name, city, phone, email, created_at
+# managers   : id, name, department
+# products   : id, name, category, price, is_active
+# orders     : id, customer_id, manager_id, AMOUNT, status, order_date
+# order_items: id, order_id, product_id, quantity, price
+#
+# ВАЖНО:
+#   orders.amount    — итоговая сумма заказа в рублях (считается как сумма позиций)
+#   order_items.price — цена единицы товара (НЕ итог позиции)
+#   order_items.quantity — количество штук
+#   Итог позиции = order_items.quantity * order_items.price
+#   В order_items НЕТ колонки amount — только в orders!
+
+# ──────────────────────────────────────────────
+# БИЗНЕС-ТЕРМИНЫ
+# ──────────────────────────────────────────────
+terms:
+  выручка: >
+    SUM(orders.amount) WHERE orders.status = 'paid'.
+    Используй таблицу orders, колонку amount. НЕ используй order_items для расчёта выручки если не нужна детализация по товарам.
+  оборот: >
+    SUM(orders.amount) по всем заказам независимо от статуса.
+  средний чек: >
+    AVG(orders.amount) WHERE orders.status = 'paid'.
+  количество заказов: >
+    COUNT(*) FROM orders. Если нужны только оплаченные — добавь WHERE status = 'paid'.
+  топ клиентов: >
+    GROUP BY customers.id, customers.name ORDER BY SUM(orders.amount) DESC LIMIT N.
+    JOIN orders ON orders.customer_id = customers.id WHERE orders.status = 'paid'.
+  топ товаров: >
+    GROUP BY products.id, products.name ORDER BY SUM(order_items.quantity) DESC LIMIT N.
+    JOIN order_items ON order_items.product_id = products.id
+    JOIN orders ON orders.id = order_items.order_id WHERE orders.status = 'paid'.
+  выручка по товару: >
+    SUM(order_items.quantity * order_items.price) GROUP BY products.name.
+    JOIN orders ON orders.id = order_items.order_id WHERE orders.status = 'paid'.
+  активный товар: "products.is_active = 1"
+  новый клиент: >
+    customers.created_at >= date('now', '-30 days').
+  этот год: "strftime('%Y', orders.order_date) = strftime('%Y', 'now')"
+  прошлый год: "strftime('%Y', orders.order_date) = CAST(strftime('%Y', 'now') - 1 AS TEXT)"
+  этот месяц: >
+    strftime('%Y-%m', orders.order_date) = strftime('%Y-%m', 'now').
+  январь 2025: "orders.order_date BETWEEN '2025-01-01' AND '2025-01-31'"
+  за период: "orders.order_date BETWEEN 'YYYY-MM-DD' AND 'YYYY-MM-DD'"
+  конверсия: >
+    CAST(SUM(CASE WHEN status='paid' THEN 1 ELSE 0 END) AS REAL) / COUNT(*) * 100 FROM orders.
+
+# ──────────────────────────────────────────────
+# СТАНДАРТНЫЕ ФИЛЬТРЫ
+# ──────────────────────────────────────────────
+filters:
+  только_оплаченные: "orders.status = 'paid'"
+  только_активные_товары: "products.is_active = 1"
+
+# ──────────────────────────────────────────────
+# КРИТИЧЕСКИЕ ПРАВИЛА СХЕМЫ
+# ──────────────────────────────────────────────
+notes:
+  - "КРИТИЧНО: колонка 'amount' существует ТОЛЬКО в таблице 'orders'. В 'order_items' её НЕТ."
+  - "order_items содержит: id, order_id, product_id, quantity, price. Никаких других колонок."
+  - "Стоимость позиции заказа = order_items.quantity * order_items.price (не отдельная колонка)."
+  - "orders.amount — это уже посчитанная итоговая сумма всего заказа в рублях."
+  - "Даты хранятся как TEXT в формате 'YYYY-MM-DD'. Используй strftime() или BETWEEN для фильтрации."
+  - "Статусы заказов: 'paid' (оплачен), 'pending' (ожидает оплаты), 'cancelled' (отменён)."
+  - "Для выручки по умолчанию фильтруй orders.status = 'paid'."
+  - "Связи: orders.customer_id → customers.id, orders.manager_id → managers.id."
+  - "Связи: order_items.order_id → orders.id, order_items.product_id → products.id."
+  - "is_active: 1 = товар продаётся, 0 = снят с продажи (например, Принтер HP LaserJet)."
+  - "База содержит данные за период 2025-01-01 — 2026-04-30."

data/demo/create_demo_db.py

@@ -0,0 +1,152 @@
+"""
+Скрипт создания демо-базы данных для Ru2SQL.
+
+Запуск из корня проекта:
+    python data/demo/create_demo_db.py
+"""
+
+import random
+import sqlite3
+from datetime import date, timedelta
+from pathlib import Path
+
+DB_PATH = Path(__file__).parent / "sales.sqlite"
+
+
+def create_db():
+    if DB_PATH.exists():
+        DB_PATH.unlink()
+
+    conn = sqlite3.connect(DB_PATH)
+    cur = conn.cursor()
+
+    cur.executescript("""
+        CREATE TABLE customers (
+            id         INTEGER PRIMARY KEY AUTOINCREMENT,
+            name       TEXT    NOT NULL,
+            city       TEXT,
+            phone      TEXT,
+            email      TEXT,
+            created_at TEXT    DEFAULT (date('now'))
+        );
+
+        CREATE TABLE managers (
+            id         INTEGER PRIMARY KEY AUTOINCREMENT,
+            name       TEXT NOT NULL,
+            department TEXT
+        );
+
+        CREATE TABLE products (
+            id        INTEGER PRIMARY KEY AUTOINCREMENT,
+            name      TEXT    NOT NULL,
+            category  TEXT,
+            price     REAL    NOT NULL,
+            is_active INTEGER DEFAULT 1
+        );
+
+        -- amount — итоговая сумма заказа в рублях (не путать с order_items.price)
+        CREATE TABLE orders (
+            id          INTEGER PRIMARY KEY AUTOINCREMENT,
+            customer_id INTEGER REFERENCES customers(id),
+            manager_id  INTEGER REFERENCES managers(id),
+            amount      REAL    NOT NULL,
+            status      TEXT    DEFAULT 'paid',
+            order_date  TEXT    NOT NULL
+        );
+
+        -- price — цена за единицу товара; quantity — количество штук
+        CREATE TABLE order_items (
+            id         INTEGER PRIMARY KEY AUTOINCREMENT,
+            order_id   INTEGER REFERENCES orders(id),
+            product_id INTEGER REFERENCES products(id),
+            quantity   INTEGER NOT NULL,
+            price      REAL    NOT NULL
+        );
+    """)
+
+    customers = [
+        ("ООО Ромашка",          "Москва",          "+7 495 111-22-33", "romashka@example.com"),
+        ("ИП Петров",            "Санкт-Петербург", "+7 812 333-44-55", "petrov@example.com"),
+        ("Сеть магазинов Радуга","Казань",           "+7 843 555-66-77", "raduga@example.com"),
+        ("АО Стройснаб",         "Екатеринбург",    "+7 343 777-88-99", "stroysnab@example.com"),
+        ("ООО Технолайн",        "Новосибирск",     "+7 383 999-00-11", "technoline@example.com"),
+        ("ИП Сидорова",          "Москва",          "+7 495 222-33-44", "sidorova@example.com"),
+        ("ООО Прогресс",         "Краснодар",       "+7 861 444-55-66", "progress@example.com"),
+        ("ЗАО Мегатрейд",        "Самара",          "+7 846 666-77-88", "megatrade@example.com"),
+    ]
+    cur.executemany(
+        "INSERT INTO customers (name, city, phone, email) VALUES (?,?,?,?)",
+        customers,
+    )
+
+    managers = [
+        ("Иванов Алексей",  "Продажи"),
+        ("Смирнова Мария",  "Продажи"),
+        ("Козлов Дмитрий",  "Корпоративные клиенты"),
+        ("Новикова Анна",   "Корпоративные клиенты"),
+    ]
+    cur.executemany("INSERT INTO managers (name, department) VALUES (?,?)", managers)
+
+    products_data = [
+        ("Ноутбук Dell XPS 15",      "Электроника",         89990.0, 1),
+        ("Монитор LG 27inch",         "Электроника",         24990.0, 1),
+        ("Клавиатура Logitech MX",    "Периферия",            8990.0, 1),
+        ("Мышь Logitech G502",        "Периферия",            5490.0, 1),
+        ("Наушники Sony WH-1000XM5",  "Аудио",               29990.0, 1),
+        ("Веб-камера Logitech C920",  "Периферия",            7990.0, 1),
+        ("SSD Samsung 1TB",           "Комплектующие",        6990.0, 1),
+        ("Принтер HP LaserJet",       "Оргтехника",          18990.0, 0),
+        ("Роутер TP-Link AX3000",     "Сетевое оборудование", 4990.0, 1),
+        ("ИБП APC 1500VA",            "Сетевое оборудование",14990.0, 1),
+    ]
+    cur.executemany(
+        "INSERT INTO products (name, category, price, is_active) VALUES (?,?,?,?)",
+        products_data,
+    )
+
+    random.seed(42)
+    start = date(2025, 1, 1)
+    end   = date(2026, 4, 30)
+    delta = (end - start).days
+    statuses = ["paid", "paid", "paid", "pending", "cancelled"]
+
+    order_id = 1
+    items_rows = []
+    for _ in range(120):
+        d           = start + timedelta(days=random.randint(0, delta))
+        customer_id = random.randint(1, 8)
+        manager_id  = random.randint(1, 4)
+        status      = random.choice(statuses)
+        n_items     = random.randint(1, 4)
+        picked      = random.sample(range(1, 11), n_items)
+        total = 0.0
+        for prod_id in picked:
+            qty   = random.randint(1, 5)
+            price = products_data[prod_id - 1][2]
+            total += qty * price
+            items_rows.append((order_id, prod_id, qty, price))
+        cur.execute(
+            "INSERT INTO orders (customer_id, manager_id, amount, status, order_date) "
+            "VALUES (?,?,?,?,?)",
+            (customer_id, manager_id, round(total, 2), status, d.isoformat()),
+        )
+        order_id += 1
+
+    cur.executemany(
+        "INSERT INTO order_items (order_id, product_id, quantity, price) VALUES (?,?,?,?)",
+        items_rows,
+    )
+
+    conn.commit()
+    conn.close()
+
+    print(f"База создана: {DB_PATH}")
+    conn2 = sqlite3.connect(DB_PATH)
+    for tbl in ["customers", "managers", "products", "orders", "order_items"]:
+        cnt = conn2.execute(f"SELECT COUNT(*) FROM {tbl}").fetchone()[0]
+        print(f"  {tbl}: {cnt} строк")
+    conn2.close()
+
+
+if __name__ == "__main__":
+    create_db()

streamlit_app.py

@@ -188,6 +188,16 @@ with st.sidebar:
             st.session_state.db_connector = connector
             st.session_state.db_executor = executor
             st.session_state.db_connection_string = cs
+            # Автоматически применяем словарь для демо-базы
+            if "sales" in cs and st.session_state.vocabulary is None:
+                try:
+                    demo_vocab_path = ROOT / "configs" / "example_vocabulary.yaml"
+                    if demo_vocab_path.exists():
+                        st.session_state.vocabulary = _load_vocab_from_yaml(
+                            demo_vocab_path.read_text(encoding="utf-8")
+                        )
+                except Exception:
+                    pass
             st.success(f"Подключено! Таблиц: {len(tables)}")
         except Exception as e:
             st.error(f"Ошибка подключения: {e}")