contsql 0.2.3__tar.gz → 0.3.0__tar.gz

contsql-0.3.0/MANIFEST.in

@@ -0,0 +1 @@
+include domain_notes.txt

{contsql-0.2.3 → contsql-0.3.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: contsql
-Version: 0.2.3
+Version: 0.3.0
 Requires-Python: >=3.10
 Requires-Dist: duckdb
 Requires-Dist: requests

{contsql-0.2.3 → contsql-0.3.0}/contsql.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: contsql
-Version: 0.2.3
+Version: 0.3.0
 Requires-Python: >=3.10
 Requires-Dist: duckdb
 Requires-Dist: requests

{contsql-0.2.3 → contsql-0.3.0}/contsql.egg-info/SOURCES.txt

@@ -1,5 +1,7 @@
+MANIFEST.in
 README.md
 contsql.py
+domain_notes.txt
 pyproject.toml
 contsql.egg-info/PKG-INFO
 contsql.egg-info/SOURCES.txt

{contsql-0.2.3 → contsql-0.3.0}/contsql.py

@@ -1,5 +1,5 @@
 #!/usr/bin/env python3
-# v0.2.3 | 2026-04-13 | entity_id+unvan zorunlu kural + slash commands (/s /schema /trace /help)
+# v0.2.9 | 2026-04-13 | JSONL session loglama — her şey kaydedilir, default açık
 """contsql — Minimal DuckDB SQL agent. Soru sor, SQL üret, çalıştır, göster."""
 
 import argparse
@@ -22,6 +22,27 @@ TIMEOUT = int(os.environ.get("CONTSQL_TIMEOUT", "120"))
 
 BANNED_SQL = ["INSERT", "UPDATE", "DELETE", "DROP", "ALTER", "CREATE", "TRUNCATE", "EXEC"]
 
+# ── Loglama ──
+
+_LOG_FILE = None
+
+
+def _init_log(db_path):
+    """Log dosyasını aç. DB'nin yanına contsql_log.jsonl yazar."""
+    global _LOG_FILE
+    log_path = Path(db_path).parent / "contsql_log.jsonl"
+    _LOG_FILE = open(log_path, "a", encoding="utf-8")
+    return log_path
+
+
+def _log(event, **data):
+    """Tek satır JSONL log yaz."""
+    if _LOG_FILE is None:
+        return
+    entry = {"ts": time.strftime("%Y-%m-%d %H:%M:%S"), "event": event, **data}
+    _LOG_FILE.write(json.dumps(entry, ensure_ascii=False) + "\n")
+    _LOG_FILE.flush()
+
 
 # ── Schema discovery ──
 
@@ -45,6 +66,31 @@ def read_schema(conn):
     return "\n".join(lines)
 
 
+def build_column_owner_map(conn):
+    """Her kolonun hangi tablo(lar)da olduğunu çıkar. Açılışta bir kez çalışır."""
+    tables = conn.execute(
+        "SELECT table_name FROM information_schema.tables WHERE table_schema='main'"
+    ).fetchall()
+    col_map = {}
+    for (tname,) in tables:
+        cols = conn.execute(f"""
+            SELECT column_name FROM information_schema.columns
+            WHERE table_schema='main' AND table_name='{tname}'
+        """).fetchall()
+        for (cname,) in cols:
+            col_map.setdefault(cname, []).append(tname)
+    return col_map
+
+
+def format_column_hints(col_map):
+    """Tek tabloya ait kolonları vurgula — bunlar JOIN gerektirir."""
+    lines = ["KOLON SAHİPLİĞİ (JOIN gerektiren kolonlar):"]
+    for col, tables in sorted(col_map.items()):
+        if len(tables) == 1:
+            lines.append(f"  {col} → SADECE {tables[0]}")
+    return "\n".join(lines)
+
+
 def read_domain_notes(db_path):
     """domain_notes.txt veya ews_domain.yaml varsa oku."""
     for name in ("domain_notes.txt", "ews_domain.yaml"):
@@ -73,10 +119,29 @@ def has_reference_trigger(question):
     return any(trigger in q_lower for trigger in REFERANS_TRIGGERS)
 
 
+SORGU_TRIGGERS = [
+    "yanına ekle", "yanına da ekle", "yanına", "buna ekle", "buna da ekle",
+    "kolonu da ekle", "kolonunu da ekle", "bir de", "aynısına",
+    "aynı sorguya", "aynı sorgu", "üstüne ekle", "ekle yanına",
+    "göster yanında", "da göster", "da getir", "de göster", "de getir",
+    "tablodan", "tablodaki", "tabloyu", "tabloya",
+    "çıkart", "çıkar", "kaldır", "at şunu", "filtrele", "daralt",
+    "sadece", "hariç", "hariç tut",
+]
+
+MAX_SQL_CONTEXT_LENGTH = 500
+
+
+def has_query_trigger(question):
+    """Kullanıcı önceki sorguyu modifiye etmek mi istiyor?"""
+    q_lower = question.lower()
+    return any(trigger in q_lower for trigger in SORGU_TRIGGERS)
+
+
 # ── System prompt ──
 
 def build_system_prompt(schema_text, domain_text="", last_result_entities=None,
-                        question=None):
+                        question=None, last_sql=None, column_hints=""):
     prompt = f"""Sen bir SQL asistanısın. Kullanıcının sorusuna uygun SQL yaz.
 
 Kurallar:
@@ -93,11 +158,39 @@ Veritabanı şeması:
 """
     if domain_text:
         prompt += f"\nDomain bilgisi:\n{domain_text}\n"
+    if column_hints:
+        prompt += f"\n{column_hints}\n"
+    if last_sql and question and has_query_trigger(question):
+        if len(last_sql) <= MAX_SQL_CONTEXT_LENGTH:
+            prompt += f"""\nÖNCEKİ SQL'İ MODİFİYE ET:
+
+{last_sql}
+
+KURALLAR:
+1. Yukarıdaki SQL'i TEMEL AL. Sıfırdan sorgu YAZMA.
+2. WHERE koşullarını AYNEN KORU (filtre, LIMIT, entity_id değerleri dahil).
+3. JOIN'leri AYNEN KORU. Yeni kolon için ek JOIN gerekiyorsa EKLE ama mevcutları ÇIKARMA.
+4. Sadece istenen değişikliği yap:
+   - "ekle" / "göster" → SELECT'e kolon ekle
+   - "çıkar" / "kaldır" → SELECT'ten kolon çıkar
+   - "filtrele" / "sadece" → WHERE'e koşul ekle
+5. LIMIT varsa KORU. ORDER BY varsa KORU.
+6. Kolon eklerken dönem belirsizse son dönemi kullan: f.donem = (SELECT MAX(donem) FROM fact_periodic). Tüm dönemleri getirme.
+"""
     if last_result_entities and question and has_reference_trigger(question):
-        prompt += (
-            f"\nÖNCEKİ SORGU SONUCUNDAKI FİRMALAR (entity_id): {last_result_entities}\n"
-            "Bu entity_id listesini WHERE koşulunda kullan.\n"
-        )
+        ids = last_result_entities
+        ids_quoted = ", ".join(str(eid) for eid in ids)
+        prompt += f"""\nÖNCEKİ SORGU FİRMALARI (entity_id): {ids}
+
+Bu entity_id değerlerini SQL'de DOĞRUDAN yaz.
+DOĞRU: WHERE fp.entity_id IN ({ids_quoted})
+YANLIŞ: WHERE entity_id = :muta
+YANLIŞ: WHERE entity_id = 'MUTA_DEGERI'
+YANLIŞ: WHERE entity_id = '1234567890'
+
+Placeholder, parametre, bind variable, örnek değer KULLANMA.
+Gerçek entity_id değerlerini doğrudan SQL string'ine yaz.
+"""
     return prompt
 
 
@@ -117,6 +210,9 @@ def extract_sql(response_text):
 
 def _like_to_ilike(sql):
     """LIKE → ILIKE guardrail. String literal içindekilere dokunmaz."""
+    # ILIKE(col, pattern) fonksiyon syntax'ini col ILIKE pattern'e çevir
+    sql = re.sub(r'\bILIKE\s*\(\s*(\w+\.?\w*)\s*,\s*', r'\1 ILIKE ', sql,
+                 flags=re.IGNORECASE)
     return re.sub(
         r"""(?x)
         (                           # Grup 1: string literal — atla
@@ -170,24 +266,77 @@ def ask_model(system_prompt, question):
         return f"LLM HATA: {e}", time.time() - t0, 0
 
 
-def generate_sql(conn, question, last_result_entities=None, domain_text=""):
+def _short_error(msg):
+    """Trace için kısa hata özeti."""
+    first = str(msg).split('\n')[0]
+    return first[:77] + "..." if len(first) > 80 else first
+
+
+def _extract_column_hint(error_message, col_map):
+    """Hata mesajından kolon adını çıkar, doğru tabloyu bul."""
+    err = str(error_message)
+    m = re.search(r'[Cc]olumn "(\w+)" not found', err)
+    if not m:
+        m = re.search(r'does not have a column named "(\w+)"', err)
+    if not m:
+        return None
+    col_name = m.group(1)
+    if col_name not in col_map:
+        return f"'{col_name}' kolonu veritabanında hiç yok. Schema'yı kontrol et."
+    owners = col_map[col_name]
+    if len(owners) == 1:
+        return (f"'{col_name}' kolonu SADECE '{owners[0]}' tablosundadır. "
+                f"JOIN {owners[0]} ... yapıp {owners[0]}.{col_name} olarak eriş.")
+    tables_str = ", ".join(owners)
+    return (f"'{col_name}' kolonu şu tablolarda var: {tables_str}. "
+            f"Doğru tabloyu JOIN ile ekle ve tablo alias'ı kullan.")
+
+
+def _build_retry_prompt(question, failed_sql, error_message, col_map=None):
+    """Hata sonrası modele gönderilecek retry prompt."""
+    hint_block = ""
+    if col_map:
+        hint = _extract_column_hint(error_message, col_map)
+        if hint:
+            hint_block = f"\n\nİPUCU: {hint}\n"
+
+    return f"""Kullanıcı sorusu: {question}
+
+Ürettiğin SQL hata verdi:
+
+SQL:
+{failed_sql}
+
+Hata:
+{error_message}
+{hint_block}
+Bu hatayı düzelt ve yeni SQL yaz. Kurallar:
+- Hata mesajındaki ipucunu kullan
+- Doğru tabloyu JOIN ile ekle
+- Her kolon referansında tablo alias'ı kullan
+- Placeholder, parametre, bind variable KULLANMA — gerçek değerleri yaz
+- Sadece düzeltilmiş SQL yaz, açıklama yapma
+"""
+
+
+def generate_sql(conn, question, last_result_entities=None, domain_text="",
+                 col_map=None):
     """Soru → SQL string. Test runner için callable. Başarısızsa None."""
     schema_text = read_schema(conn)
+    column_hints = format_column_hints(col_map) if col_map else ""
     system_prompt = build_system_prompt(schema_text, domain_text, last_result_entities,
-                                       question=question)
+                                       question=question, column_hints=column_hints)
     response, _, _ = ask_model(system_prompt, question)
     sql = extract_sql(response)
     if not sql or check_sql_safety(sql):
         return None
     sql = _like_to_ilike(sql)
 
-    # Ambiguous column retry: EXPLAIN ile ön kontrol
+    # Genel SQL hata retry: EXPLAIN ile ön kontrol
     try:
         conn.execute(f"EXPLAIN {sql}")
     except Exception as e:
-        if "ambiguous" not in str(e).lower():
-            return sql
-        retry_q = f"{question}\n\nÖNCEKİ SQL HATA: {e}\nJOIN'de tablo alias kullan."
+        retry_q = _build_retry_prompt(question, sql, e, col_map)
         resp2, _, _ = ask_model(system_prompt, retry_q)
         sql2 = extract_sql(resp2)
         if sql2 and not check_sql_safety(sql2):
@@ -265,10 +414,12 @@ def _extract_entity_ids(columns, rows, max_entities=100):
     return ids or None
 
 
-def run_query(conn, system_prompt, question):
-    """Tek soru → SQL → çalıştır → sonuç. entity_id listesi döndürür."""
+def run_query(conn, system_prompt, question, col_map=None):
+    """Tek soru → SQL → çalıştır → sonuç. (entity_id listesi, sql) tuple döndürür."""
     # 1. Model'e sor
     response, elapsed, tokens = ask_model(system_prompt, question)
+    _log("model", question=question, elapsed=round(elapsed, 1), tokens=tokens,
+         response=response)
 
     print(f"\n💭 MODEL ({elapsed:.1f}s, ~{tokens} tok)")
     if not response.startswith("LLM HATA"):
@@ -281,14 +432,16 @@ def run_query(conn, system_prompt, question):
     if not sql:
         print(f"\n❌ Model SQL üretmedi:")
         print(f"   {response[:300]}")
-        return None
+        _log("no_sql", question=question)
+        return None, None
 
     # 3. Güvenlik kontrolü
     safety_error = check_sql_safety(sql)
     if safety_error:
         print(f"\n⛔ {safety_error}")
         print(f"🔍 SQL: {sql[:200]}")
-        return None
+        _log("safety", question=question, sql=sql, error=safety_error)
+        return None, None
 
     # 3b. LIKE → ILIKE guardrail
     sql = _like_to_ilike(sql)
@@ -305,37 +458,47 @@ def run_query(conn, system_prompt, question):
 
         print(f"\n📊 SONUÇ ({len(rows)} satır, {query_ms:.0f}ms)")
         print(format_table(columns, rows))
+        if len(rows) > 50:
+            print(f"  ⚠ {len(rows)} satır döndü, ilk 50 gösteriliyor. Soruyu daraltın.")
 
         # Entity context çıkar
         entities = _extract_entity_ids(columns, rows)
         if entities is None and len(rows) > 100:
-            print("  ⚠ Önceki sorgu çok geniş — firma referansı için soruyu daraltın.")
-        return entities
+            print("  ⚠ Firma referansı için soruyu daraltın (max 100 entity).")
+        _log("ok", question=question, sql=sql, row_count=len(rows),
+             query_ms=round(query_ms), columns=columns)
+        return entities, sql
     except duckdb.Error as e:
-        # Ambiguous column retry
-        if "ambiguous" in str(e).lower():
-            print(f"🔄 Ambiguous column, retry...")
-            retry_q = f"{question}\n\nSQL HATA: {e}\nJOIN'de tablo alias kullan."
-            resp2, _, _ = ask_model(system_prompt, retry_q)
-            sql2 = extract_sql(resp2)
-            if sql2 and not check_sql_safety(sql2):
-                sql2 = _like_to_ilike(sql2)
-                print(f"🔍 Retry SQL: {sql2}")
-                try:
-                    result = conn.execute(sql2)
-                    columns = [desc[0] for desc in result.description]
-                    rows = result.fetchall()
-                    query_ms = (time.time() - t0) * 1000
-                    print(f"\n📊 SONUÇ ({len(rows)} satır, {query_ms:.0f}ms)")
-                    print(format_table(columns, rows))
-                    entities = _extract_entity_ids(columns, rows)
-                    return entities
-                except duckdb.Error as e2:
-                    print(f"\n❌ Retry hatası: {e2}")
-                    return None
+        _log("error", question=question, sql=sql, error=str(e))
+        # Genel SQL hata retry — tek retry, her hata tipinde
+        print(f"🔄 Retry ({_short_error(e)})...")
+        retry_q = _build_retry_prompt(question, sql, e, col_map)
+        resp2, _, _ = ask_model(system_prompt, retry_q)
+        sql2 = extract_sql(resp2)
+        if sql2 and not check_sql_safety(sql2):
+            sql2 = _like_to_ilike(sql2)
+            print(f"🔍 Retry SQL: {sql2}")
+            try:
+                result = conn.execute(sql2)
+                columns = [desc[0] for desc in result.description]
+                rows = result.fetchall()
+                query_ms = (time.time() - t0) * 1000
+                print(f"\n📊 SONUÇ ({len(rows)} satır, {query_ms:.0f}ms)")
+                print(format_table(columns, rows))
+                entities = _extract_entity_ids(columns, rows)
+                if entities is None and len(rows) > 100:
+                    print("  ⚠ Önceki sorgu çok geniş — firma referansı için soruyu daraltın.")
+                _log("retry_ok", question=question, original_sql=sql,
+                     retry_sql=sql2, row_count=len(rows), columns=columns)
+                return entities, sql2
+            except duckdb.Error as e2:
+                print(f"\n❌ Retry de başarısız: {_short_error(e2)}")
+                _log("retry_fail", question=question, original_sql=sql,
+                     retry_sql=sql2, error=str(e2))
+                return None, None
         print(f"\n❌ SQL hatası: {e}")
         print(f"🔍 SQL: {sql}")
-        return None
+        return None, None
 
 
 def handle_slash_command(cmd, state):
@@ -344,7 +507,9 @@ def handle_slash_command(cmd, state):
 
     if cmd == "/s":
         state["last_result_entities"] = None
+        state["last_sql"] = None
         print("🧹 Bellek temizlendi.")
+        _log("cmd", cmd="/s")
         return True
 
     if cmd == "/schema":
@@ -368,13 +533,16 @@ def handle_slash_command(cmd, state):
     return False
 
 
-def interactive_loop(conn, schema_text, domain_text):
+def interactive_loop(conn, schema_text, domain_text, col_map):
     """REPL döngüsü."""
     print(f"\ncontsql hazır. Model: {MODEL} | /help komutlar")
     print("Çıkmak için: quit/exit/q\n")
 
+    column_hints = format_column_hints(col_map)
+
     state = {
         "last_result_entities": None,
+        "last_sql": None,
         "trace": False,
         "schema_text": schema_text,
     }
@@ -396,12 +564,21 @@ def interactive_loop(conn, schema_text, domain_text):
                 print(f"Bilinmeyen komut: {question}. /help yazın.")
             continue
 
+        # SQL context uzunluk uyarısı
+        if state["last_sql"] and has_query_trigger(question) \
+                and len(state["last_sql"]) > MAX_SQL_CONTEXT_LENGTH:
+            print("⚠ Önceki sorgu çok uzun — lütfen soruyu tam yazın.")
+
         system_prompt = build_system_prompt(schema_text, domain_text,
                                            state["last_result_entities"],
-                                           question=question)
-        entities = run_query(conn, system_prompt, question)
+                                           question=question,
+                                           last_sql=state["last_sql"],
+                                           column_hints=column_hints)
+        entities, sql = run_query(conn, system_prompt, question, col_map)
         if entities is not None:
             state["last_result_entities"] = entities
+        if sql is not None:
+            state["last_sql"] = sql
         print()
 
 
@@ -425,19 +602,26 @@ def main():
 
     conn = duckdb.connect(str(db_path), read_only=True)
 
-    # Schema + domain
+    # Loglama başlat
+    log_path = _init_log(db_path)
+
+    # Schema + domain + column map
     schema_text = read_schema(conn)
     domain_text = read_domain_notes(str(db_path))
+    col_map = build_column_owner_map(conn)
 
-    print(f"DB: {db_path} | Model: {MODEL}")
+    print(f"DB: {db_path} | Model: {MODEL} | Log: {log_path}")
+    _log("session_start", db=str(db_path), model=MODEL)
 
     # Tek soru veya interaktif
     if args.question:
+        column_hints = format_column_hints(col_map)
         system_prompt = build_system_prompt(schema_text, domain_text,
-                                           question=args.question)
-        run_query(conn, system_prompt, args.question)
+                                           question=args.question,
+                                           column_hints=column_hints)
+        run_query(conn, system_prompt, args.question, col_map)
     else:
-        interactive_loop(conn, schema_text, domain_text)
+        interactive_loop(conn, schema_text, domain_text, col_map)
 
     conn.close()
 

contsql-0.3.0/domain_notes.txt

@@ -0,0 +1,103 @@
+EWS (Early Warning System) Domain Bilgisi
+
+Tablolar:
+- map_identity: Firma kimlik (entity_id, muta, unvan). entity_id = muta.
+- dim_entity: Firma boyut bilgisi (entity_id, segment, bolge_kodu, sube_kodu, ...)
+- fact_periodic: Dönemsel risk metrikleri (entity_id, donem, ews_skor, kombine_risk, ...)
+- brz_memzuc: Merkez Bankası uzun vadeli kredi (muta, donem, idari_kanuni_takip, ikt_6ay_ort)
+- brz_kik_izleme: KİK izleme verileri (muta, donem, ykn_izl_flag, tfrs_rating, kik_risk, ...)
+- brz_kredi_risk: Kredi risk tutarları (muta, donem, kredi_risk)
+- brz_statik: Statik firma bilgileri (muta, bolge_kodu, sube_kodu, grup_tanimi, ...)
+- brz_train_features: Eğitim veri segmentleri (muta, donem, segment)
+- ref_sube_bolge: Şube-bölge eşleme (sube_kodu, sube_adi, bolge_kodu, bolge_adi)
+
+Metrikler:
+- ews_skor: Risk skoru (VARCHAR — sayısal değerler + 'YI' = Yakın İzleme). Yüksek = riskli.
+- kombine_risk: Toplam kredi riski (TL, BIGINT). Büyük tutar = büyük firma.
+- kredi_risk, kik_risk, depo_risk, nakit_risk, gnakit_risk: Alt risk kırılımları.
+- risk_degisim: Önceki döneme göre risk farkı.
+- yis_skor: YİS skoru (INTEGER). ews_skor'un model bileşeni.
+- eus_skor: EUS skoru (DOUBLE).
+- tfrs_rating: TFRS rating (A/B/C/D).
+
+MODEL VE KAYNAK TABLO İLİŞKİLERİ:
+- "YIS" → brz_yis_tahmin tablosu (muta, donem, yis_skor, yis_ihtimal, yis_label).
+  Bu tablo YIS modelinin HAM tahmin çıktısıdır. fact_periodic'teki yis kolonları buradan kopyalanmıştır
+  ama brz_yis_tahmin daha fazla dönem içerir (21 dönem vs fact_periodic 12 dönem).
+  YIS detay sorgusu → brz_yis_tahmin kullan, fact_periodic DEĞİL.
+- "YIS21", "yis 2.1", "yis21 datası" → brz_train_features tablosu (muta, donem, segment).
+  Kaynak: yis_21_v21_YYMM.parquet dosyaları. Bu dosyalar YIS 2.1 model eğitim verisini içerir.
+  Pipeline sadece SON dönemi yükler (segment bilgisi için). Firma segmenti (KOBI, KUR-TIC, ESKK, MIKRO)
+  bu tablodan gelir ve dim_entity'ye aktarılır.
+  NOT: brz_yis_tahmin ile KARIŞTIRILMAMALI — yis_tahmin tahmin çıktısı, yis21 eğitim verisidir.
+- "EUS" → brz_eus_tahmin tablosu (muta, donem, eus_skor, eus_ihtimal).
+  EUS modelinin HAM çıktısı. Aynı mantık: EUS detay sorgusu → brz_eus_tahmin kullan.
+- "EUS kapsam" → brz_eus_kapsam (muta, donem). Firma bu dönem EUS kapsamında mı.
+- "EUS hedef" → brz_eus_hedef (muta, donem). Firma bu dönem EUS hedefi mi.
+- fact_periodic: TÜM modellerin ÖZET sonuçlarını birleştirir. Genel sorgu için kullan.
+  Model-spesifik detay sorgusu için brz_* kaynak tabloları kullan.
+
+ÖNEMLİ KAVRAMLAR:
+- "riskli" veya "risk" → ews_skor kullan (yüksek = riskli)
+- "büyük" veya "hacim" → kombine_risk kullan (büyük tutar = büyük firma)
+- Büyük firma ≠ riskli firma. kombine_risk ile ews_skor korelasyon göstermez.
+- "MUTA" → entity_id/muta numarası (firma kimlik no)
+- Dönem belirtilmezse en son dönem: MAX(donem)
+- unvan SADECE map_identity tablosundadır. dim_entity'de unvan YOK.
+- segment SADECE dim_entity tablosundadır.
+
+VERİ TİPİ UYARILARI:
+- entity_id ve muta VARCHAR tipindedir (sayısal görünür ama string).
+- ews_skor VARCHAR: sayısal değerler ('100'-'950') + 'YI' (Yakın İzleme).
+  Sayısal sıralama için: TRY_CAST(ews_skor AS INTEGER) DESC NULLS LAST
+- donem VARCHAR: 'YYMM' formatında (ör. '2602' = 2026 Şubat).
+
+TEMPORAL SORGULAR:
+"artan", "düşen", "yükselen", "azalan" → iki dönem karşılaştırması gerektirir.
+Önceki dönem için: önce MAX(donem), sonra ondan bir önceki dönemi bul.
+
+ÇAPRAZ TABLO JOIN KURALI:
+Dönemsel tabloları JOIN'lerken dönem eşleştir:
+  ON t1.entity_id = t2.entity_id AND t1.donem = t2.donem
+muta bazlı tablolarda:
+  ON mi.muta = brz.muta AND fp.donem = brz.donem
+Dönem eşleştirmesi yoksa satır sayısı dönem² patlar.
+
+SQL YAZIM KURALLARI:
+- JOIN'de her kolona tablo alias kullan: fp.entity_id, mi.unvan
+- ILIKE operatör olarak kullan: WHERE unvan ILIKE '%x%' (fonksiyon syntax DEĞİL)
+- Alias: fp=fact_periodic, mi=map_identity, de=dim_entity, bm=brz_memzuc
+
+HER SORGUDA entity_id ve unvan kolonlarını dahil et.
+Firmalar bu iki alanla tanımlanır.
+Sadece COUNT/SUM gibi tek değer döndüren aggregation'larda gerekmez.
+
+"BÜTÜN BİLGİLERİ GETİR" KURALI:
+Kullanıcı bir firma hakkında "bütün bilgileri", "tüm bilgileri", "her şeyi" istediğinde
+sadece fact_periodic YETERSİZDİR. Tüm ilgili tabloları JOIN ile birleştir:
+  SELECT mi.muta, mi.unvan, de.segment, de.grup_tanimi,
+         fp.ews_skor, fp.kombine_risk, fp.kredi_risk, fp.kik_risk,
+         fp.depo_risk, fp.nakit_risk, fp.gnakit_risk, fp.risk_degisim,
+         fp.yis_skor, fp.eus_skor, fp.tfrs_rating, fp.ykn_izl_flag,
+         bm.idari_kanuni_takip, bm.ikt_6ay_ort,
+         bk.ykn_izl_flag as kik_ykn_izl, bk.gckm_gun_say,
+         bs.bolge_adi, bs.sube_adi, bs.aksiyon_sahibi
+  FROM fact_periodic fp
+  JOIN map_identity mi ON fp.entity_id = mi.entity_id
+  JOIN dim_entity de ON fp.entity_id = de.entity_id
+  LEFT JOIN brz_memzuc bm ON mi.muta = bm.muta AND fp.donem = bm.donem
+  LEFT JOIN brz_kik_izleme bk ON mi.muta = bk.muta AND fp.donem = bk.donem
+  LEFT JOIN brz_statik bs ON mi.muta = bs.muta
+  WHERE mi.muta = 'XXXXX' AND fp.donem = 'YYYY'
+Tek dönem isteniyorsa WHERE ile filtrele.
+Dönem belirtilmezse MAX(donem) kullan.
+
+FİRMA ARAMA KURALLARI:
+1. Tam eşleşme: WHERE unvan ILIKE 'merkez tekstil a.ş.'
+2. Başlangıç: WHERE unvan ILIKE 'merkez tekstil%'
+3. İçerik: WHERE unvan ILIKE '%merkez tekstil%'
+Her aşamada sonuç varsa dur. Çok fazla sonuçta LIMIT 10.
+Sayısal değer = doğrudan WHERE mi.muta = 'XXXXX'
+
+Segmentler: KOBI, KUR-TIC, ESKK, MIKRO
+Dönem formatı: YYMM (ör. '2602')

{contsql-0.2.3 → contsql-0.3.0}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "contsql"
-version = "0.2.3"
+version = "0.3.0"
 requires-python = ">=3.10"
 dependencies = ["duckdb", "requests"]
 
@@ -13,3 +13,6 @@ contsql = "contsql:main"
 
 [tool.setuptools]
 py-modules = ["contsql"]
+
+[tool.setuptools.data-files]
+"contsql_data" = ["domain_notes.txt"]