تم الانتهاء من آخر دفعة تحسينات على المشروع، وتشمل:

تحويل لوحة الإدارة الداخلية من secret header إلى session auth حقيقي مع صلاحيات admin.
إضافة دعم إدارة الأدوار من داخل لوحة الإدارة نفسها، مع حماية الحسابات المعتمدة عبر INTERNAL_ADMIN_EMAILS.
تحسين بيانات المستخدم في الواجهة والباكند لتشمل role وis_allowlisted_admin.
إضافة اختبار frontend مخصص لصفحة /internal/admin بدل الاعتماد فقط على build واختبار routes.
تحسين إضافي في الأداء عبر إزالة الاعتماد على pdfjs-dist/pdf.worker في عدّ صفحات PDF واستبداله بمسار أخف باستخدام pdf-lib.
تحسين تقسيم الـ chunks في build لتقليل أثر الحزم الكبيرة وفصل أجزاء مثل network, icons, pdf-core, وeditor.
التحقق الذي تم:

نجاح build للواجهة.
نجاح اختبار صفحة الإدارة الداخلية في frontend.
نجاح اختبارات auth/admin في backend.
نجاح full backend suite مسبقًا مع EXIT:0.
ولو تريد نسخة أقصر جدًا، استخدم هذه:

آخر التحديثات:
تم تحسين نظام الإدارة الداخلية ليعتمد على صلاحيات وجلسات حقيقية بدل secret header، مع إضافة إدارة أدوار من لوحة admin نفسها، وإضافة اختبارات frontend مخصصة للوحة، وتحسين أداء الواجهة عبر إزالة pdf.worker وتحسين تقسيم الـ chunks في build. جميع الاختبارات والتحققات الأساسية المطلوبة نجح

backend/app/utils/database.py

@@ -0,0 +1,91 @@
+"""Database abstraction — supports SQLite (dev) and PostgreSQL (production).
+
+Usage:
+    from app.utils.database import get_connection
+
+The returned connection behaves like a sqlite3.Connection with row_factory set.
+For PostgreSQL it wraps psycopg2 with RealDictCursor for dict-like rows.
+
+Selection logic:
+    - If DATABASE_URL env var is set (starts with ``postgres``), use PostgreSQL.
+    - Otherwise fall back to SQLite via DATABASE_PATH config.
+"""
+import logging
+import os
+import sqlite3
+from contextlib import contextmanager
+
+from flask import current_app
+
+logger = logging.getLogger(__name__)
+
+_pg_available = False
+try:
+    import psycopg2
+    import psycopg2.extras
+    _pg_available = True
+except ImportError:
+    pass
+
+
+def is_postgres() -> bool:
+    """Return True when the app is configured to use PostgreSQL."""
+    db_url = os.getenv("DATABASE_URL", "")
+    return db_url.startswith("postgres")
+
+
+def _sqlite_connect() -> sqlite3.Connection:
+    db_path = current_app.config["DATABASE_PATH"]
+    db_dir = os.path.dirname(db_path)
+    if db_dir:
+        os.makedirs(db_dir, exist_ok=True)
+    conn = sqlite3.connect(db_path)
+    conn.row_factory = sqlite3.Row
+    conn.execute("PRAGMA foreign_keys = ON")
+    return conn
+
+
+def _pg_connect():
+    """Return a psycopg2 connection with RealDictCursor."""
+    if not _pg_available:
+        raise RuntimeError("psycopg2 is not installed — cannot use PostgreSQL.")
+    db_url = os.getenv("DATABASE_URL", "")
+    conn = psycopg2.connect(db_url, cursor_factory=psycopg2.extras.RealDictCursor)
+    conn.autocommit = False
+    return conn
+
+
+def get_connection():
+    """Get a database connection (SQLite or PostgreSQL based on config)."""
+    if is_postgres():
+        return _pg_connect()
+    return _sqlite_connect()
+
+
+@contextmanager
+def db_connection():
+    """Context manager that yields a connection and handles commit/rollback."""
+    conn = get_connection()
+    try:
+        yield conn
+        conn.commit()
+    except Exception:
+        conn.rollback()
+        raise
+    finally:
+        conn.close()
+
+
+def adapt_sql(sql: str) -> str:
+    """Adapt SQLite SQL to PostgreSQL if needed.
+
+    Converts:
+      - INTEGER PRIMARY KEY AUTOINCREMENT -> SERIAL PRIMARY KEY
+      - ? placeholders -> %s placeholders
+    """
+    if not is_postgres():
+        return sql
+
+    sql = sql.replace("INTEGER PRIMARY KEY AUTOINCREMENT", "SERIAL PRIMARY KEY")
+    sql = sql.replace("?", "%s")
+    return sql