feat: add runtime locale overrides

backend/db/dal/__init__.py

@@ -1,6 +1,7 @@
 from . import (
     ad_dal,
     app_settings_dal,
+    locale_overrides_dal,
     message_log_dal,
     panel_sync_dal,
     payment_dal,
@@ -23,5 +24,6 @@ __all__ = (
     "ad_dal",
     "security_dal",
     "app_settings_dal",
+    "locale_overrides_dal",
     "support_dal",
 )

backend/db/dal/locale_overrides_dal.py

@@ -0,0 +1,86 @@
+"""Persistent overrides for localization strings."""
+
+from datetime import datetime, timezone
+from typing import Dict, List, Optional, Tuple
+
+from sqlalchemy import delete, select
+from sqlalchemy.dialects.postgresql import insert as pg_insert
+from sqlalchemy.ext.asyncio import AsyncSession
+
+from db.models import LocaleOverride
+
+
+async def get_all_overrides(session: AsyncSession) -> Dict[str, Dict[str, str]]:
+    rows = (await session.execute(select(LocaleOverride))).scalars().all()
+    result: Dict[str, Dict[str, str]] = {}
+    for row in rows:
+        result.setdefault(row.lang, {})[row.key] = row.value
+    return result
+
+
+async def get_overrides_with_meta(session: AsyncSession) -> List[Dict[str, object]]:
+    rows = (await session.execute(select(LocaleOverride))).scalars().all()
+    items: List[Dict[str, object]] = []
+    for row in rows:
+        items.append(
+            {
+                "lang": row.lang,
+                "key": row.key,
+                "value": row.value,
+                "updated_at": row.updated_at.isoformat() if row.updated_at else None,
+                "updated_by": row.updated_by,
+            }
+        )
+    return items
+
+
+async def upsert_override(
+    session: AsyncSession,
+    *,
+    lang: str,
+    key: str,
+    value: str,
+    updated_by: Optional[int],
+) -> None:
+    now = datetime.now(timezone.utc)
+    stmt = (
+        pg_insert(LocaleOverride)
+        .values(lang=lang, key=key, value=value, updated_at=now, updated_by=updated_by)
+        .on_conflict_do_update(
+            index_elements=[LocaleOverride.lang, LocaleOverride.key],
+            set_={
+                "value": value,
+                "updated_at": now,
+                "updated_by": updated_by,
+            },
+        )
+    )
+    await session.execute(stmt)
+
+
+async def delete_override(session: AsyncSession, *, lang: str, key: str) -> bool:
+    stmt = delete(LocaleOverride).where(
+        LocaleOverride.lang == lang,
+        LocaleOverride.key == key,
+    )
+    result = await session.execute(stmt)
+    return bool(result.rowcount or 0)
+
+
+async def bulk_apply(
+    session: AsyncSession,
+    *,
+    updates: Dict[Tuple[str, str], Tuple[bool, str]],
+    updated_by: Optional[int],
+) -> None:
+    for (lang, key), (set_flag, value) in updates.items():
+        if set_flag:
+            await upsert_override(
+                session,
+                lang=lang,
+                key=key,
+                value=value,
+                updated_by=updated_by,
+            )
+        else:
+            await delete_override(session, lang=lang, key=key)