V5.14.7: Add fix_balance endpoint and balance safety check

main.py

@@ -259,6 +259,30 @@ async def update_quota(request: Request, req: QuotaUpdateRequest):
         logger.error(f"Failed to update quota: {e}")
         raise HTTPException(status_code=500, detail=str(e))
 
+@app.post("/admin/fix_balance/{uid}")
+async def fix_balance(uid: str, request: Request):
+    """
+    V5.14.7: Temporary fix for negative token balances.
+    """
+    await verify_admin_access(request)
+    try:
+        db = firebase_manager.get_db()
+        user_ref = db.collection('users').document(uid)
+        doc = user_ref.get()
+        if doc.exists:
+            data = doc.to_dict()
+            wallet = data.get('wallet', {})
+            balance = wallet.get('token_balance', 0)
+            if balance < 0:
+                pos_balance = abs(balance)
+                user_ref.update({'wallet.token_balance': pos_balance})
+                logger.info(f"✅ [ADMIN] Fixed negative balance for {uid}: {balance} -> {pos_balance}")
+                return {"status": "success", "fixed_to": pos_balance}
+        return {"status": "no_fix_needed"}
+    except Exception as e:
+        logger.error(f"Failed to fix balance: {e}")
+        raise HTTPException(status_code=500, detail=str(e))
+
 @app.post("/admin/reset_usage/{uid}")
 async def reset_usage(uid: str, request: Request):
     """