feat: implement illusion account system with is_real variable tracking

- Add is_real boolean field to distinguish real vs illusion accounts
- Update get_sender_account() to require user name for illusion account creation
- Add create_illusion_account tool for AI service integration
- Modify transfer functions to use is_real variable instead of name checking
- Include testing disclaimers for illusion account transactions
- Add comprehensive is_real/is_illusion tracking throughout the system
- Update AI service instructions to handle user name requirement for illusion accounts

ai_service.py

@@ -8,6 +8,7 @@ from transfers import (
     cancel_transfer,
     get_pending_transfer,
     get_account_balance,
+    get_sender_account,
 )
 
 
@@ -126,6 +127,23 @@ TOOLS = [
                 "required": []
             }
         }
+    },
+    {
+        "type": "function",
+        "function": {
+            "name": "create_illusion_account",
+            "description": "Use this tool when the user needs an illusion account created for testing purposes. Requires the user's name.",
+            "parameters": {
+                "type": "object",
+                "properties": {
+                    "user_name": {
+                        "type": "string",
+                        "description": "The name of the user for the illusion account."
+                    }
+                },
+                "required": ["user_name"]
+            }
+        }
     }
 ]
 
@@ -150,6 +168,8 @@ async def run_tool(tool_name: str, args: dict, telegram_id: int):
         return json.dumps(cancel_transfer(telegram_id), ensure_ascii=False)
     if tool_name == "get_pending_money_transfer":
         return json.dumps(get_pending_transfer(telegram_id), ensure_ascii=False)
+    if tool_name == "create_illusion_account":
+        return json.dumps(get_sender_account(telegram_id, args["user_name"]), ensure_ascii=False)
     return json.dumps({"success": False, "message": f"Unknown tool: {tool_name}"}, ensure_ascii=False)
 
 async def get_ai_response(user_query: str, telegram_id: int):
@@ -164,11 +184,9 @@ async def get_ai_response(user_query: str, telegram_id: int):
 
     transfer_instructions = (
         f"Current user telegram_id is {telegram_id}. "
-        "The customer service system cannot create bank accounts. "
         "The model must never choose, guess, extract, or override any telegram_id for tool calls. "
         "Always act only for the current authenticated user from server-side request context. "
         "If the user asks for another person's balance or provides another person's telegram ID, refuse and explain that you can only access the current user's own account. "
-        "If the sender does not already have a bank account, clearly tell them they must visit the bank to create one. "
         "If the user asks for their balance, call check_account_balance. "
         "For money transfers, first collect the receiver account serial ID and the amount if it is missing. "
         "Then call prepare_money_transfer to fetch the receiver name and store the pending transfer. "
@@ -176,6 +194,9 @@ async def get_ai_response(user_query: str, telegram_id: int):
         "Only call confirm_money_transfer after the user clearly agrees. "
         "If the user rejects the receiver or wants to stop, call cancel_money_transfer. "
         "Never claim a transfer is completed unless confirm_money_transfer returns success."
+        "If a tool result returns 'need_user_name': true, ask the user for their name and then call create_illusion_account with their name. "
+        "If a tool result indicates an illusion account was created (contains 'is_illusion': true or mentions testing), inform the user that an illusion account with 2000 YER balance was created for testing purposes. "
+        "If confirm_money_transfer returns a result with 'is_illusion': true, make sure to display the testing disclaimer message to the user."
     )
     messages = [{"role": "system", "content": f"{BASE_PROMPT}\n\n{transfer_instructions}"}] + conversation_history + [{"role": "user", "content": user_query}]
     

transfers/__init__.py

@@ -3,6 +3,7 @@ from .service import (
     confirm_transfer,
     get_account_balance,
     get_pending_transfer,
+    get_sender_account,
     prepare_transfer,
 )
 

transfers/mock_bank_accounts.json

@@ -6,15 +6,17 @@
       "serial_id": "1001",
       "name": "Test Sender",
       "balance": 1900.0,
-      "currency": "YER"
+      "currency": "YER",
+      "is_real": true
     },
     {
       "telegram_id": 991001,
       "account_id": "ACC-991001",
       "serial_id": "2001",
       "name": "Ahmed Salem",
-      "balance": 1800.0,
-      "currency": "YER"
+      "balance": 1990.0,
+      "currency": "YER",
+      "is_real": true
     },
     {
       "telegram_id": 991002,
@@ -22,7 +24,8 @@
       "serial_id": "2002",
       "name": "Mona Ali",
       "balance": 800.0,
-      "currency": "YER"
+      "currency": "YER",
+      "is_real": true
     },
     {
       "telegram_id": 991003,
@@ -30,7 +33,17 @@
       "serial_id": "2003",
       "name": "Khaled Omar",
       "balance": 300.0,
-      "currency": "YER"
+      "currency": "YER",
+      "is_real": true
+    },
+    {
+      "telegram_id": 34,
+      "account_id": "ACC-34",
+      "serial_id": "9034",
+      "name": "Test User Ali",
+      "balance": 1810.0,
+      "currency": "YER",
+      "is_real": false
     }
   ],
   "transactions": [
@@ -63,6 +76,16 @@
       "amount": 200.0,
       "currency": "YER",
       "created_at": "2026-04-10T19:33:54.495350"
+    },
+    {
+      "transaction_id": "TX-20260420140247475948",
+      "telegram_id": 34,
+      "sender_serial_id": "9034",
+      "receiver_serial_id": "2001",
+      "receiver_name": "Ahmed Salem",
+      "amount": 190.0,
+      "currency": "YER",
+      "created_at": "2026-04-20T14:02:47.475998"
     }
   ]
-}
+}

transfers/service.py

@@ -48,19 +48,48 @@ def _find_account_by_serial_id(accounts: list[Dict[str, Any]], serial_id: str) -
     return next((account for account in accounts if str(account.get("serial_id")) == normalized_id), None)
 
 
-def get_sender_account(telegram_id: int) -> Dict[str, Any]:
+def get_sender_account(telegram_id: int, user_name: str = None) -> Dict[str, Any]:
     with _LOCK:
         data = _load_bank_data()
         sender = _find_account_by_telegram_id(data["accounts"], telegram_id)
         if sender:
+            is_real = sender.get("is_real", True)
+            is_illusion = not is_real or sender.get("name", "").startswith("Test User")
             return {
                 "success": True,
                 "account": sender,
+                "is_real": is_real,
+                "is_illusion": is_illusion,
             }
 
+        # Ask for user name before creating illusion account
+        if not user_name:
+            return {
+                "success": False,
+                "need_user_name": True,
+                "message": "I need to create an illusion account for testing purposes. What is your name?",
+            }
+
+        # Create illusion account for testing purposes
+        new_account = {
+            "telegram_id": telegram_id,
+            "account_id": f"ACC-{telegram_id}",
+            "serial_id": str(9000 + telegram_id % 1000),
+            "name": f"Test User {user_name}",
+            "balance": 2000.0,
+            "currency": "YER",
+            "is_real": False
+        }
+        
+        data["accounts"].append(new_account)
+        _save_bank_data(data)
+        
         return {
-            "success": False,
-            "message": "You do not have an account in the bank system. Please visit the bank to create an account first.",
+            "success": True,
+            "account": new_account,
+            "is_real": False,
+            "is_illusion": True,
+            "message": f"I've created an illusion account for {user_name} with 2000 YER balance to try sending money. This is for testing purposes only."
         }
 
 
@@ -70,7 +99,7 @@ def get_account_balance(telegram_id: int) -> Dict[str, Any]:
         return sender_result
 
     account = sender_result["account"]
-    return {
+    result = {
         "success": True,
         "telegram_id": telegram_id,
         "account_id": account["account_id"],
@@ -78,7 +107,14 @@ def get_account_balance(telegram_id: int) -> Dict[str, Any]:
         "name": account["name"],
         "balance": account.get("balance", 0.0),
         "currency": account.get("currency", "YER"),
+        "is_real": sender_result.get("is_real", True),
+        "is_illusion": sender_result.get("is_illusion", False),
     }
+    
+    if result["is_illusion"]:
+        result["message"] = "This is an illusion account created for testing purposes with 2000 YER balance."
+    
+    return result
 
 
 def get_receiver_account_name(receiver_serial_id: str) -> Dict[str, Any]:
@@ -230,11 +266,21 @@ def confirm_transfer(telegram_id: int) -> Dict[str, Any]:
         pending_transfers.pop(str(telegram_id), None)
         _save_pending_transfers(pending_transfers)
 
+        # Check if sender is an illusion account using is_real variable
+        is_real = sender.get("is_real", True)
+        is_illusion = not is_real
+        
+        message = f"Transfer completed successfully to {receiver['name']}."
+        if is_illusion:
+            message += " ⚠️ Please note: This process was not real - it was for testing purposes only. No actual money was transferred."
+        
         return {
             "success": True,
             "transaction": transaction,
             "sender_balance": sender["balance"],
-            "message": f"Transfer completed successfully to {receiver['name']}.",
+            "is_real": is_real,
+            "is_illusion": is_illusion,
+            "message": message,
         }