admin_szolgáltatók_

backend/app/services/gamification_service.py

@@ -1,6 +1,7 @@
 # /opt/docker/dev/service_finder/backend/app/services/gamification_service.py
 import logging
 import math
+from copy import deepcopy
 from decimal import Decimal
 from sqlalchemy.ext.asyncio import AsyncSession
 from sqlalchemy import select, desc
@@ -12,6 +13,25 @@ from app.services.config_service import config # 2.0 Központi konfigurátor
 
 logger = logging.getLogger("Gamification-Service-2.0")
 
+
+def _deep_merge_config(base: dict, overlay: dict) -> dict:
+    """
+    Rekurzívan egyesít két dictionary-t.
+    Az overlay kulcsai felülírják a base kulcsait, de a base-ben lévő
+    hiányzó kulcsok megmaradnak az overlay-ből.
+    
+    Ez biztosítja, hogy a GAMIFICATION_MASTER_CONFIG minden szükséges
+    kulcsot tartalmazzon, még akkor is, ha az adatbázisban lévő konfiguráció
+    hiányos (pl. régebbi verzióból származik).
+    """
+    result = deepcopy(base)
+    for key, value in overlay.items():
+        if key in result and isinstance(result[key], dict) and isinstance(value, dict):
+            result[key] = _deep_merge_config(result[key], value)
+        elif key not in result:
+            result[key] = deepcopy(value)
+    return result
+
 class GamificationService:
     """
     Gamification Service 2.0 - A 'Jövevény' lelke.
@@ -22,22 +42,24 @@ class GamificationService:
     """
 
     @staticmethod
-    async def award_points(db: AsyncSession, user_id: int, amount: int, reason: str, social_points: int = 0, commit: bool = True):
+    async def award_points(db: AsyncSession, user_id: int, amount: int, reason: str, social_points: int = 0, commit: bool = True, action_key: str | None = None):
         """ Statikus segédfüggvény a Robotok számára az egyszerűbb híváshoz.
         
         Args:
             commit: If True (default), commits the transaction internally.
                     Set to False when called from within a larger transaction
                     (e.g., from AuthService.complete_kyc).
+            action_key: Opcionális. Ha meg van adva, a point_rules táblából
+                        olvassa a pontértékeket a master config helyett.
         """
         service = GamificationService()
-        return await service.process_activity(db, user_id, xp_amount=amount, social_amount=social_points, reason=reason, commit=commit)
+        return await service.process_activity(db, user_id, xp_amount=amount, social_amount=social_points, reason=reason, commit=commit, action_key=action_key)
 
     async def _get_point_rule(self, db: AsyncSession, action_key: str) -> dict | None:
         """Lekér egy pontszabályt a point_rules táblából action_key alapján.
         
         Returns:
-            dict with 'points' and 'description' or None if not found/inactive.
+            dict with 'points', 'description', 'rule_id' or None if not found/inactive.
         """
         stmt = select(PointRule).where(
             PointRule.action_key == action_key,
@@ -46,7 +68,7 @@ class GamificationService:
         result = await db.execute(stmt)
         rule = result.scalar_one_or_none()
         if rule:
-            return {"points": rule.points, "description": rule.description}
+            return {"points": rule.points, "description": rule.description, "rule_id": rule.id}
         return None
 
     async def process_activity(
@@ -80,7 +102,7 @@ class GamificationService:
         try:
             # 1. ADMIN KONFIGURÁCIÓ BETÖLTÉSE
             # Minden paraméter az admin felületről módosítható JSON-ként
-            cfg = await config.get_setting(db, "GAMIFICATION_MASTER_CONFIG", default={
+            _DEFAULT_GAMIFICATION_CONFIG = {
                 "xp_logic": {"base_xp": 500, "exponent": 1.5},
                 "penalty_logic": {
                     "recovery_rate": 0.5,
@@ -89,15 +111,28 @@ class GamificationService:
                 },
                 "conversion_logic": {"social_to_credit_rate": 100},
                 "level_rewards": {"credits_per_10_levels": 50}
-            })
+            }
+            cfg = await config.get_setting(db, "GAMIFICATION_MASTER_CONFIG", default=_DEFAULT_GAMIFICATION_CONFIG)
+            
+            # 🔐 HIÁNYZÓ KULCSOK VÉDELME (Deep Merge)
+            # Ha a GAMIFICATION_MASTER_CONFIG már létezik az adatbázisban, de hiányoznak
+            # belőle kulcsok (pl. penalty_logic egy régebbi verzióból), a default értékek
+            # automatikusan kiegészítik a hiányzó részeket.
+            # Ez megakadályozza a KeyError kivételeket a cfg["penalty_logic"] hívásoknál.
+            if isinstance(cfg, dict):
+                cfg = _deep_merge_config(cfg, _DEFAULT_GAMIFICATION_CONFIG)
 
             # 1/b. POINT RULES TÁBLA LEKÉRÉSE (ha action_key meg van adva)
             # A point_rules tábla elsőbbséget élvez a master config-gal szemben!
+            point_rule_id = None
+            points_at_time = None
             if action_key:
                 rule = await self._get_point_rule(db, action_key)
                 if rule:
                     # A point_rules-ból jövő pontok felülírják a paraméterként kapott értékeket
                     xp_amount = rule["points"]
+                    point_rule_id = rule.get("rule_id")
+                    points_at_time = rule["points"]
                     if rule.get("description"):
                         reason = f"{action_key}: {rule['description']}"
                     logger.debug(f"Point rule applied: {action_key} -> {xp_amount} XP")
@@ -152,7 +187,18 @@ class GamificationService:
                     stats.social_points %= rate # A maradék pont megmarad
                     await self._add_earned_credits(db, user_id, credits_to_add, "SOCIAL_ACTIVITY_CONVERSION")
 
-            # 7. NAPLÓZÁS (kibővítve xp, source_type, source_id mezőkkel)
+            # 7. NAPLÓZÁS (kibővítve xp, source_type, source_id, points_snapshot mezőkkel)
+            # A points_snapshot JSONB tárolja a kiosztáskor érvényes point_rules adatokat,
+            # hogy a pontértékek megőrződjenek a ledger-ben, még akkor is, ha a
+            # point_rules táblában később módosítják a pontértékeket.
+            snapshot = None
+            if action_key and point_rule_id and points_at_time is not None:
+                snapshot = {
+                    "action_key": action_key,
+                    "point_rule_id": point_rule_id,
+                    "points_at_time": points_at_time,
+                    "multiplier": multiplier,
+                }
             db.add(PointsLedger(
                 user_id=user_id,
                 points=final_xp,
@@ -160,6 +206,7 @@ class GamificationService:
                 reason=reason,
                 source_type=source_type,
                 source_id=source_id,
+                points_snapshot=snapshot,
             ))
             
             # Only commit if caller wants us to manage the transaction