Семантические модели: как сделать ИИ-ассистента, который действительно понимает ваш бизнес

# Минимальная семантическая модель для ИИ-интеграции
semantic_model:
  # 1. Подключение к данным
  data_sources:
    - name: "main_warehouse"
      type: "postgresql"  # или redshift, snowflake, bigquery
      connection_string: "${DATABASE_URL}"
      
  # 2. Основные сущности (базовые таблицы)
  entities:
    - name: "sales_transactions"
      source_table: "sales.fact_sales"
      primary_key: "transaction_id"
      
    - name: "customers"
      source_table: "customers.dim_customers"
      primary_key: "customer_id"
      
  # 3. Измерения (как данные можно группировать)
  dimensions:
    - name: "region"
      entity: "sales_transactions"
      column: "region_code"
      type: "string"
      description: "Географический регион продажи"
      
    - name: "sale_date"
      entity: "sales_transactions"
      column: "created_at"
      type: "date"
      description: "Дата совершения продажи"
      
  # 4. Меры (что можно посчитать)
  measures:
    - name: "total_revenue"
      entity: "sales_transactions"
      column: "amount_usd"
      aggregation: "sum"
      description: "Общая выручка в долларах"
      
    - name: "transaction_count"
      entity: "sales_transactions"
      column: "transaction_id"
      aggregation: "count"
      description: "Количество транзакций"
      
  # 5. Связи между сущностями
  relationships:
    - name: "sales_to_customers"
      from: "sales_transactions.customer_id"
      to: "customers.customer_id"
      type: "many_to_one"
      
  # 6. Бизнес-контекст (критически важно для ИИ!)
  business_context:
    # Синонимы для естественного языка
    synonyms:
      "выручка": ["revenue", "доход", "продажи", "оборот"]
      "регион": ["область", "зона", "территория", "location"]
      "клиент": ["customer", "покупатель", "заказчик"]
      
    # Готовые метрики
    metrics:
      - name: "monthly_revenue"
        formula: "SUM(total_revenue) WHERE sale_date >= CURRENT_DATE - INTERVAL '30 days'"
        description: "Выручка за последние 30 дней"
        
      - name: "avg_transaction_value"
        formula: "total_revenue / transaction_count"
        description: "Средний чек"
        
  # 7. Правила доступа (для корпоративного использования)
  access_control:
    - role: "sales_analyst"
      allowed_entities: ["sales_transactions", "customers"]
      row_filter: "region IN ('North', 'South')"
      
    - role: "executive"
      allowed_entities: ["sales_transactions", "customers"]
      # Без ограничений