Merge pull request #4 from rrad0812/develop

Dodata uputstva

Author: platipusica

utils/admin_exporter/uputstvo/201 admin.sqlite metadata exporter.md

@@ -0,0 +1,202 @@
+
+# Admin metadata exporter
+
+Izvoz `admin.sqlite` meta-podataka u `SQLAlchemy` ORM klase. Svaka `SYS_` tabela iz baze dobija jednu `SQLAlchemy` klasu u posebnom `.py` fajlu unutar direktorijuma `models/`.
+
+## Implementacija `admin.sqlite_exporter.py`
+
+```py
+import os
+import sqlite3
+
+OUTPUT_DIR = "models"
+
+def ensure_dir(path):
+    if not os.path.exists(path):
+        os.makedirs(path)
+
+def map_sqlite_type(sqlite_type: str):
+    if not sqlite_type:
+        return "String"
+    t = sqlite_type.upper()
+    if "INT" in t:
+        return "Integer"
+    if "CHAR" in t or "CLOB" in t or "TEXT" in t:
+        return "String"
+    if "BLOB" in t:
+        return "LargeBinary"
+    if "REAL" in t or "FLOA" in t or "DOUB" in t:
+        return "Float"
+    if "DATE" in t or "TIME" in t:
+        return "DateTime"
+    return "String"
+
+def export_sys_models(db_path="admin.sqlite"):
+    ensure_dir(OUTPUT_DIR)
+    conn = sqlite3.connect(db_path)
+    cur = conn.cursor()
+
+    # Sve SYS_ tabele iz admin.sqlite baze podataka
+    cur.execute("SELECT name FROM sqlite_master WHERE type='table' AND name LIKE 'SYS_%' ORDER BY name")
+    tables = [r[0] for r in cur.fetchall()]
+
+    generated = []
+
+    for table_name in tables:
+        cur.execute(f"PRAGMA table_info({table_name})")
+        columns = cur.fetchall()
+        if not columns:
+            continue
+
+        class_name = "".join([w.capitalize() for w in table_name.lower().split("_")])
+        generated.append((table_name, class_name))
+
+        lines = [
+            "from sqlalchemy import String, Integer, Float, LargeBinary, DateTime, Boolean, Text",
+            "from sqlalchemy.orm import Mapped, mapped_column",
+            "from . import Base",
+            "",
+            f"class {class_name}(Base):",
+            f"    __tablename__ = '{table_name}'",
+            "",
+        ]
+
+        for cid, name, col_type, notnull, default_value, pk in columns:
+            sa_type = map_sqlite_type(col_type)
+            pk_flag = ", primary_key=True" if pk else ""
+            nullable = "" if notnull else ", nullable=True"
+            default = f", default={default_value}" if default_value else ""
+            lines.append(f"    {name}: Mapped[{sa_type}] = mapped_column({sa_type}{pk_flag}{nullable}{default})")
+
+        lines.append("")
+        lines.append("    def __repr__(self):")
+        lines.append(f"        return f\"<{class_name}(id={{getattr(self, 'ID', '?')}})>\"")
+        lines.append("")
+
+        out_path = os.path.join(OUTPUT_DIR, f"{table_name.lower()}.py")
+        with open(out_path, "w", encoding="utf-8") as f:
+            f.write("\n".join(lines))
+        print(f"Generisano: {out_path}")
+
+    # --- automatski __init__.py ---
+    init_lines = [
+        "# Auto-generated: Import All SYS_* Models",
+        "from sqlalchemy.orm import DeclarativeBase",
+        "",
+        "class Base(DeclarativeBase):",
+        "    pass",
+        "",
+    ]
+    for table_name, class_name in generated:
+        init_lines.append(f"from .{table_name.lower()} import {class_name}")
+    init_lines.append("")
+    init_lines.append("__all__ = [")
+    for _, class_name in generated:
+        init_lines.append(f"    '{class_name}',")
+    init_lines.append("]")
+    init_lines.append("")
+
+    init_path = os.path.join(OUTPUT_DIR, "__init__.py")
+    with open(init_path, "w", encoding="utf-8") as f:
+        f.write("\n".join(init_lines))
+
+    conn.close()
+    print("\n✅ Gotovo! Sve SYS_* ORM klase koriste zajednički Base iz models/__init__.py.")
+
+if __name__ == "__main__":
+    export_sys_models("admin.sqlite")
+```
+
+### Primer generisanog fajla
+
+`models/sys_items.py` nakon izvoza izgleda ovako:
+
+```py
+from sqlalchemy import String, Integer, Float, LargeBinary, DateTime, Boolean, Text
+from sqlalchemy.orm import Mapped, mapped_column
+from . import Base
+
+
+class SysItems(Base):
+    __tablename__ = 'SYS_ITEMS'
+
+    ID: Mapped[Integer] = mapped_column(Integer, primary_key=True)
+    DELETED: Mapped[Integer] = mapped_column(Integer)
+    PARENT: Mapped[Integer] = mapped_column(Integer)
+    TASK_ID: Mapped[Integer] = mapped_column(Integer)
+    F_NAME: Mapped[String] = mapped_column(String)
+
+    def __repr__(self):
+        return f"<SysItems(id={getattr(self, 'ID', '?')})>"
+```
+
+## Loader/tester za proveru ORM modela
+
+```py
+from sqlalchemy import create_engine, inspect, select
+from sqlalchemy.orm import Session
+from models import Base
+
+DB_PATH = "admin.sqlite"
+
+engine = create_engine(f"sqlite:///{DB_PATH}", echo=False, future=True)
+
+def main():
+    print("Povezujem se na:", DB_PATH)
+    Base.metadata.create_all(engine)
+
+    inspector = inspect(engine)
+    tables = inspector.get_table_names()
+
+    print("\n📋 Pronađene tabele u bazi:")
+    for t in tables:
+        print(f"  • {t}")
+
+    with Session(engine) as session:
+        print("\n🔍 Brz pregled SYS_ tabela:")
+        for cls in Base.registry.mappers:
+            model = cls.class_
+            table_name = model.__tablename__
+            try:
+                count = session.execute(select(model)).fetchall()
+                print(f"  {table_name:<25} → {len(count)} redova")
+            except Exception as e:
+                print(f"  {table_name:<25} {e.__class__.__name__}: {e}")
+
+    print("\nORM povezivanje završeno.")
+
+if __name__ == "__main__":
+    main()
+```
+
+### Pokretanje
+
+- Generiši ORM modele:
+
+  ```sh
+  python3 admin.sqlite_exporter.py
+  ```
+
+- Testiraj ih:
+
+  ```sh
+  python3 jam_orm_loader.py
+  ```
+
+- Ako sve radi, očekivani izlaz:
+
+  ```sh
+  Pronađene tabele u bazi:
+    • SYS_COUNTRIES
+    • SYS_FIELDS
+    • SYS_ITEMS
+    • SYS_PARAMS
+    • SYS_PRIVILEGES
+  Brz pregled SYS_ tabela:
+    SYS_COUNTRIES              → 250 redova
+    SYS_FIELDS                 → 354 redova
+    SYS_ITEMS                  → 73 redova
+    SYS_PARAMS                 → 1 red
+    SYS_PRIVILEGES             → 0 redova
+  ORM povezivanje završeno.
+  ```