fix: enrich ticket-expense endpoints with full ticket + assignment context and add my-expenses + my-stats endpoints

src/app/api/v1/ticket_expenses.py

@@ -352,6 +352,113 @@ def delete_expense(
     return None
 
 
+# ============================================
+# FIELD AGENT HELPER ENDPOINTS
+# ============================================
+
+@router.get(
+    "/my-expenses",
+    response_model=TicketExpenseListResponse,
+    summary="Get current user's expenses"
+)
+def get_my_expenses(
+    is_approved: Optional[bool] = Query(None, description="Filter by approval status"),
+    is_paid: Optional[bool] = Query(None, description="Filter by payment status"),
+    from_date: Optional[date] = Query(None, description="Filter from date"),
+    to_date: Optional[date] = Query(None, description="Filter to date"),
+    page: int = Query(1, ge=1, description="Page number"),
+    page_size: int = Query(100, ge=1, le=100, description="Items per page"),
+    db: Session = Depends(get_db),
+    current_user: User = Depends(get_current_user)
+):
+    """
+    Get all expenses for the current user.
+    
+    **Purpose:** Field agents can see all their expenses in one place
+    
+    **Returns:** List of user's expenses with full context (ticket info, approval/payment status)
+    """
+    expenses, total = TicketExpenseService.list_expenses(
+        db=db,
+        current_user=current_user,
+        user_id=current_user.id,  # Force filter to current user
+        is_approved=is_approved,
+        is_paid=is_paid,
+        from_date=from_date,
+        to_date=to_date,
+        page=page,
+        page_size=page_size
+    )
+    
+    # Build responses with contextual information
+    expense_responses = []
+    for expense in expenses:
+        response = TicketExpenseResponse.model_validate(expense)
+        
+        # User names
+        if expense.incurred_by_user:
+            response.incurred_by_user_name = expense.incurred_by_user.name
+        if expense.approved_by_user:
+            response.approved_by_user_name = expense.approved_by_user.name
+        if expense.paid_to_user:
+            response.paid_to_user_name = expense.paid_to_user.name
+        
+        # Ticket context
+        if expense.ticket:
+            response.ticket_reference = expense.ticket.ticket_reference
+            response.ticket_title = expense.ticket.title
+            response.ticket_status = expense.ticket.status
+        
+        # Assignment context
+        if expense.ticket_assignment:
+            response.assignment_status = expense.ticket_assignment.status
+        
+        expense_responses.append(response)
+    
+    pages = (total + page_size - 1) // page_size
+    
+    return TicketExpenseListResponse(
+        expenses=expense_responses,
+        total=total,
+        page=page,
+        page_size=page_size,
+        pages=pages
+    )
+
+
+@router.get(
+    "/my-stats",
+    response_model=TicketExpenseStats,
+    summary="Get current user's expense statistics"
+)
+def get_my_expense_stats(
+    from_date: Optional[date] = Query(None, description="Filter from date"),
+    to_date: Optional[date] = Query(None, description="Filter to date"),
+    db: Session = Depends(get_db),
+    current_user: User = Depends(get_current_user)
+):
+    """
+    Get expense statistics for the current user.
+    
+    **Purpose:** Field agents can see their own expense summary
+    
+    **Returns:**
+    - Total expenses and amount
+    - Pending approval count and amount
+    - Approved/paid breakdown
+    - Category breakdown
+    """
+    stats = TicketExpenseService.get_expense_stats(
+        db=db,
+        current_user=current_user,
+        user_id=current_user.id,  # Force filter to current user
+        from_date=from_date,
+        to_date=to_date
+    )
+    
+    return stats
+
+
 # ============================================
 # GET EXPENSE
 # ============================================
@@ -378,6 +485,8 @@ def get_expense(
     )
     
     response = TicketExpenseResponse.model_validate(expense)
+    
+    # User names
     if expense.incurred_by_user:
         response.incurred_by_user_name = expense.incurred_by_user.name
     if expense.approved_by_user:
@@ -385,6 +494,16 @@ def get_expense(
     if expense.paid_to_user:
         response.paid_to_user_name = expense.paid_to_user.name
     
+    # Ticket context
+    if expense.ticket:
+        response.ticket_reference = expense.ticket.ticket_reference
+        response.ticket_title = expense.ticket.title
+        response.ticket_status = expense.ticket.status
+    
+    # Assignment context
+    if expense.ticket_assignment:
+        response.assignment_status = expense.ticket_assignment.status
+    
     return response
 
 
@@ -448,16 +567,29 @@ def list_expenses(
         page_size=page_size
     )
     
-    # Build responses with user names
+    # Build responses with user names and contextual information
     expense_responses = []
     for expense in expenses:
         response = TicketExpenseResponse.model_validate(expense)
+        
+        # User names
         if expense.incurred_by_user:
             response.incurred_by_user_name = expense.incurred_by_user.name
         if expense.approved_by_user:
             response.approved_by_user_name = expense.approved_by_user.name
         if expense.paid_to_user:
             response.paid_to_user_name = expense.paid_to_user.name
+        
+        # Ticket context
+        if expense.ticket:
+            response.ticket_reference = expense.ticket.ticket_reference
+            response.ticket_title = expense.ticket.title
+            response.ticket_status = expense.ticket.status
+        
+        # Assignment context
+        if expense.ticket_assignment:
+            response.assignment_status = expense.ticket_assignment.status
+        
         expense_responses.append(response)
     
     pages = (total + page_size - 1) // page_size

src/app/schemas/ticket_expense.py

@@ -305,6 +305,12 @@ class TicketExpenseResponse(BaseModel):
     created_at: datetime
     updated_at: datetime
     
+    # Contextual information (populated by API)
+    ticket_reference: Optional[str] = None
+    ticket_title: Optional[str] = None
+    ticket_status: Optional[str] = None
+    assignment_status: Optional[str] = None
+    
     class Config:
         from_attributes = True
 

src/app/services/ticket_expense_service.py

@@ -635,7 +635,8 @@ class TicketExpenseService:
             joinedload(TicketExpense.incurred_by_user),
             joinedload(TicketExpense.approved_by_user),
             joinedload(TicketExpense.paid_to_user),
-            joinedload(TicketExpense.ticket)
+            joinedload(TicketExpense.ticket),
+            joinedload(TicketExpense.ticket_assignment)
         ).filter(
             TicketExpense.id == expense_id,
             TicketExpense.deleted_at.is_(None)
@@ -689,7 +690,8 @@ class TicketExpenseService:
             joinedload(TicketExpense.incurred_by_user),
             joinedload(TicketExpense.approved_by_user),
             joinedload(TicketExpense.paid_to_user),
-            joinedload(TicketExpense.ticket)
+            joinedload(TicketExpense.ticket),
+            joinedload(TicketExpense.ticket_assignment)
         ).filter(
             TicketExpense.deleted_at.is_(None)
         )