fix(ticket-assignment): resolve SQLAlchemy mapper initialization errors

- Fix circular import issue by reordering model imports in ticket assignment schema
- Update ticket assignment service to properly initialize TicketStatusHistory relationship
- Correct relationship definition in Ticket model to reference TicketStatusHistory after class definition
- Add explicit model registration order in API endpoints to ensure proper mapper initialization
- Update devlogs with successful ticket assignment response and corrected startup logs
- Resolves "failed to locate a name ('TicketStatusHistory')" mapper initialization errors that prevented authentication and ticket operations

docs/devlogs/browser/response.json

@@ -1 +1,43 @@
-Internal Server Error
+{
+    "id": "a82a3824-f4f1-4283-a2e3-8c348dbb28ce",
+    "ticket_id": "f59b29fc-d0b9-4618-b0d1-889e340da612",
+    "user_id": "43b778b0-2062-4724-abbb-916a4835a9b0",
+    "assigned_by_user_id": "43b778b0-2062-4724-abbb-916a4835a9b0",
+    "action": "accepted",
+    "is_self_assigned": true,
+    "execution_order": null,
+    "planned_start_time": null,
+    "assigned_at": "2025-11-30T10:21:10.085152Z",
+    "responded_at": "2025-11-30T10:21:10.085155Z",
+    "journey_started_at": null,
+    "arrived_at": null,
+    "ended_at": null,
+    "journey_start_latitude": null,
+    "journey_start_longitude": null,
+    "arrival_latitude": null,
+    "arrival_longitude": null,
+    "arrival_verified": false,
+    "journey_location_history": [],
+    "status": "ACCEPTED",
+    "is_active": true,
+    "travel_time_minutes": null,
+    "work_time_minutes": null,
+    "total_time_minutes": null,
+    "journey_distance_km": null,
+    "reason": null,
+    "notes": null,
+    "user": {
+        "id": "43b778b0-2062-4724-abbb-916a4835a9b0",
+        "full_name": "Viyisa Sasa",
+        "email": "viyisa8151@feralrex.com",
+        "phone": "+25470000001"
+    },
+    "assigned_by": {
+        "id": "43b778b0-2062-4724-abbb-916a4835a9b0",
+        "full_name": "Viyisa Sasa",
+        "email": "viyisa8151@feralrex.com",
+        "phone": "+25470000001"
+    },
+    "created_at": "2025-11-30T10:21:10.111327Z",
+    "updated_at": "2025-11-30T10:21:10.111330Z"
+}

docs/devlogs/server/runtimeerror.txt

@@ -1,72 +1,107 @@
-===== Application Startup at 2025-11-30 10:02:22 =====
+===== Application Startup at 2025-11-30 10:20:04 =====
 
 INFO:     Started server process [7]
 INFO:     Waiting for application startup.
-INFO: 2025-11-30T10:02:36 - app.main: ============================================================
-INFO: 2025-11-30T10:02:36 - app.main: 🚀 SwiftOps API v1.0.0 | PRODUCTION
-INFO: 2025-11-30T10:02:36 - app.main: 📊 Dashboard: Enabled
-INFO: 2025-11-30T10:02:36 - app.main: ============================================================
-INFO: 2025-11-30T10:02:36 - app.main: 📦 Database:
-INFO: 2025-11-30T10:02:36 - app.main:    ✓ Connected | 44 tables | 6 users
-INFO: 2025-11-30T10:02:36 - app.main: 💾 Cache & Sessions:
-INFO: 2025-11-30T10:02:37 - app.services.otp_service: ✅ OTP Service initialized with Redis storage
-INFO: 2025-11-30T10:02:38 - app.main:    ✓ Redis: Connected
-INFO: 2025-11-30T10:02:38 - app.main: 🔌 External Services:
-INFO: 2025-11-30T10:02:38 - app.main:    ✓ Cloudinary: Connected
-INFO: 2025-11-30T10:02:38 - app.main:    ✓ Resend: Configured
-INFO: 2025-11-30T10:02:38 - app.main:    ○ WASender: Failed
-INFO: 2025-11-30T10:02:38 - app.main:    ✓ Supabase: Connected | 6 buckets
-INFO: 2025-11-30T10:02:38 - app.main: ============================================================
-INFO: 2025-11-30T10:02:38 - app.main: ✅ Startup complete | Ready to serve requests
-INFO: 2025-11-30T10:02:38 - app.main: ============================================================
+INFO: 2025-11-30T10:20:14 - app.main: ============================================================
+INFO: 2025-11-30T10:20:14 - app.main: 🚀 SwiftOps API v1.0.0 | PRODUCTION
+INFO: 2025-11-30T10:20:14 - app.main: 📊 Dashboard: Enabled
+INFO: 2025-11-30T10:20:14 - app.main: ============================================================
+INFO: 2025-11-30T10:20:14 - app.main: 📦 Database:
+INFO: 2025-11-30T10:20:14 - app.main:    ✓ Connected | 44 tables | 6 users
+INFO: 2025-11-30T10:20:14 - app.main: 💾 Cache & Sessions:
+INFO: 2025-11-30T10:20:15 - app.services.otp_service: ✅ OTP Service initialized with Redis storage
+INFO: 2025-11-30T10:20:16 - app.main:    ✓ Redis: Connected
+INFO: 2025-11-30T10:20:16 - app.main: 🔌 External Services:
+INFO: 2025-11-30T10:20:16 - app.main:    ✓ Cloudinary: Connected
+INFO: 2025-11-30T10:20:16 - app.main:    ✓ Resend: Configured
+INFO: 2025-11-30T10:20:16 - app.main:    ○ WASender: Failed
+INFO: 2025-11-30T10:20:16 - app.main:    ✓ Supabase: Connected | 6 buckets
+INFO: 2025-11-30T10:20:16 - app.main: ============================================================
+INFO: 2025-11-30T10:20:16 - app.main: ✅ Startup complete | Ready to serve requests
+INFO: 2025-11-30T10:20:16 - app.main: ============================================================
 INFO:     Application startup complete.
 INFO:     Uvicorn running on http://0.0.0.0:7860 (Press CTRL+C to quit)
-INFO:     10.16.18.114:55928 - "GET /health HTTP/1.1" 200 OK
-INFO:     10.16.6.70:56128 - "GET /health HTTP/1.1" 200 OK
-INFO:     10.16.6.70:56561 - "GET /health HTTP/1.1" 200 OK
-INFO:     10.16.18.114:10241 - "GET /health HTTP/1.1" 200 OK
-INFO:     10.16.11.176:46093 - "GET /health HTTP/1.1" 200 OK
-INFO:     10.16.11.176:25317 - "GET /health HTTP/1.1" 200 OK
-INFO:     10.16.6.70:58656 - "GET /health HTTP/1.1" 200 OK
-INFO:     10.16.11.176:46518 - "GET /health HTTP/1.1" 200 OK
-INFO:     10.16.11.176:52236 - "GET /health HTTP/1.1" 200 OK
-INFO:     10.16.6.70:15409 - "GET /health HTTP/1.1" 200 OK
-INFO:     10.16.6.70:62819 - "GET /health HTTP/1.1" 200 OK
-INFO:     10.16.25.209:50726 - "GET /health HTTP/1.1" 200 OK
-ERROR: 2025-11-30T10:07:42 - app.api.deps: Authentication error: When initializing mapper Mapper[Ticket(tickets)], expression 'TicketStatusHistory' failed to locate a name ('TicketStatusHistory'). If this is a class name, consider adding this relationship() to the <class 'app.models.ticket.Ticket'> class after both dependent classes have been defined.
-INFO:     10.16.25.209:50726 - "GET /api/v1/auth/me HTTP/1.1" 401 Unauthorized
-INFO: 2025-11-30T10:07:43 - app.core.supabase_auth: Session refreshed successfully
-ERROR: 2025-11-30T10:07:43 - app.api.v1.auth: ❌ Token refresh error: One or more mappers failed to initialize - can't proceed with initialization of other mappers. Triggering mapper: 'Mapper[Ticket(tickets)]'. Original exception was: When initializing mapper Mapper[Ticket(tickets)], expression 'TicketStatusHistory' failed to locate a name ('TicketStatusHistory'). If this is a class name, consider adding this relationship() to the <class 'app.models.ticket.Ticket'> class after both dependent classes have been defined.
-INFO:     10.16.6.70:13712 - "POST /api/v1/auth/refresh-token HTTP/1.1" 401 Unauthorized
-INFO:     10.16.18.114:1142 - "GET /health HTTP/1.1" 200 OK
-INFO:     10.16.6.70:23975 - "GET /health HTTP/1.1" 200 OK
-INFO: 2025-11-30T10:08:39 - app.core.supabase_auth: User signed in successfully: viyisa8151@feralrex.com
-ERROR: 2025-11-30T10:08:39 - app.api.v1.auth: Login error: One or more mappers failed to initialize - can't proceed with initialization of other mappers. Triggering mapper: 'Mapper[Ticket(tickets)]'. Original exception was: When initializing mapper Mapper[Ticket(tickets)], expression 'TicketStatusHistory' failed to locate a name ('TicketStatusHistory'). If this is a class name, consider adding this relationship() to the <class 'app.models.ticket.Ticket'> class after both dependent classes have been defined.
-ERROR: 2025-11-30T10:08:39 - app.services.audit_service: Failed to create audit log: One or more mappers failed to initialize - can't proceed with initialization of other mappers. Triggering mapper: 'Mapper[Ticket(tickets)]'. Original exception was: When initializing mapper Mapper[Ticket(tickets)], expression 'TicketStatusHistory' failed to locate a name ('TicketStatusHistory'). If this is a class name, consider adding this relationship() to the <class 'app.models.ticket.Ticket'> class after both dependent classes have been defined.
-INFO:     10.16.25.209:28616 - "POST /api/v1/auth/login HTTP/1.1" 401 Unauthorized
-INFO:     10.16.34.155:12295 - "GET /health HTTP/1.1" 200 OK
-INFO:     10.16.6.70:18122 - "GET /health HTTP/1.1" 200 OK
-INFO:     10.16.6.70:5588 - "GET /health HTTP/1.1" 200 OK
-INFO:     10.16.25.209:12555 - "GET /health HTTP/1.1" 200 OK
-INFO:     10.16.6.70:58652 - "GET /health HTTP/1.1" 200 OK
-INFO:     10.16.18.114:8697 - "GET /health HTTP/1.1" 200 OK
-INFO:     10.16.6.70:7897 - "GET /health HTTP/1.1" 200 OK
-INFO:     10.16.6.70:39538 - "GET /health HTTP/1.1" 200 OK
-INFO:     10.16.11.176:6264 - "GET /health HTTP/1.1" 200 OK
-INFO:     10.16.6.70:5580 - "GET /health HTTP/1.1" 200 OK
-INFO:     10.16.25.209:28827 - "GET /health HTTP/1.1" 200 OK
-INFO:     10.16.34.155:27217 - "GET /health HTTP/1.1" 200 OK
-INFO:     10.16.6.70:44523 - "GET /health HTTP/1.1" 200 OK
-INFO:     10.16.34.155:25939 - "GET /health HTTP/1.1" 200 OK
-INFO:     10.16.34.155:3936 - "GET /health HTTP/1.1" 200 OK
-INFO:     10.16.6.70:62519 - "GET /health HTTP/1.1" 200 OK
-INFO:     10.16.11.176:51920 - "GET /health HTTP/1.1" 200 OK
-INFO:     10.16.18.114:28609 - "GET /health HTTP/1.1" 200 OK
-INFO:     10.16.11.176:8729 - "GET / HTTP/1.1" 200 OK
-INFO:     10.16.34.155:40138 - "GET /health HTTP/1.1" 200 OK
-INFO: 2025-11-30T10:16:27 - app.core.supabase_auth: User signed in successfully: viyisa8151@feralrex.com
-ERROR: 2025-11-30T10:16:27 - app.api.v1.auth: Login error: One or more mappers failed to initialize - can't proceed with initialization of other mappers. Triggering mapper: 'Mapper[Ticket(tickets)]'. Original exception was: When initializing mapper Mapper[Ticket(tickets)], expression 'TicketStatusHistory' failed to locate a name ('TicketStatusHistory'). If this is a class name, consider adding this relationship() to the <class 'app.models.ticket.Ticket'> class after both dependent classes have been defined.
-ERROR: 2025-11-30T10:16:27 - app.services.audit_service: Failed to create audit log: One or more mappers failed to initialize - can't proceed with initialization of other mappers. Triggering mapper: 'Mapper[Ticket(tickets)]'. Original exception was: When initializing mapper Mapper[Ticket(tickets)], expression 'TicketStatusHistory' failed to locate a name ('TicketStatusHistory'). If this is a class name, consider adding this relationship() to the <class 'app.models.ticket.Ticket'> class after both dependent classes have been defined.
-INFO:     10.16.6.70:22674 - "POST /api/v1/auth/login HTTP/1.1" 401 Unauthorized
-INFO:     10.16.6.70:30069 - "GET /health HTTP/1.1" 200 OK
-INFO:     10.16.25.209:49805 - "GET /health HTTP/1.1" 200 OK
+INFO:     10.16.11.176:37653 - "GET /health HTTP/1.1" 200 OK
+INFO:     10.16.11.176:37653 - "GET /health HTTP/1.1" 200 OK
+INFO:     10.16.11.176:51654 - "GET /health HTTP/1.1" 200 OK
+INFO:     10.16.6.70:45423 - "GET /health HTTP/1.1" 200 OK
+INFO:     10.16.34.155:12449 - "GET /health HTTP/1.1" 200 OK
+INFO: 2025-11-30T10:20:54 - app.core.supabase_auth: User signed in successfully: viyisa8151@feralrex.com
+INFO: 2025-11-30T10:20:54 - app.services.audit_service: Audit log created: login on auth by viyisa8151@feralrex.com
+INFO: 2025-11-30T10:20:54 - app.api.v1.auth: User logged in successfully: viyisa8151@feralrex.com
+INFO:     10.16.11.176:11276 - "POST /api/v1/auth/login HTTP/1.1" 200 OK
+INFO: 2025-11-30T10:20:55 - app.api.deps: Checking active user: 43b778b0-2062-4724-abbb-916a4835a9b0, is_active: True, type: <class 'bool'>
+INFO: 2025-11-30T10:20:55 - app.api.deps: User 43b778b0-2062-4724-abbb-916a4835a9b0 is active - proceeding
+INFO:     10.16.11.176:11276 - "GET /api/v1/auth/me HTTP/1.1" 200 OK
+INFO: 2025-11-30T10:20:56 - app.api.deps: Checking active user: 43b778b0-2062-4724-abbb-916a4835a9b0, is_active: True, type: <class 'bool'>
+INFO: 2025-11-30T10:20:56 - app.api.deps: User 43b778b0-2062-4724-abbb-916a4835a9b0 is active - proceeding
+INFO:     10.16.34.155:49018 - "GET /api/v1/auth/me/preferences/available-apps HTTP/1.1" 200 OK
+INFO: 2025-11-30T10:20:56 - app.api.deps: Checking active user: 43b778b0-2062-4724-abbb-916a4835a9b0, is_active: True, type: <class 'bool'>
+INFO: 2025-11-30T10:20:56 - app.api.deps: User 43b778b0-2062-4724-abbb-916a4835a9b0 is active - proceeding
+INFO:     10.16.34.155:45714 - "GET /api/v1/auth/me/preferences HTTP/1.1" 200 OK
+INFO: 2025-11-30T10:20:56 - app.api.deps: Checking active user: 43b778b0-2062-4724-abbb-916a4835a9b0, is_active: True, type: <class 'bool'>
+INFO: 2025-11-30T10:20:56 - app.api.deps: User 43b778b0-2062-4724-abbb-916a4835a9b0 is active - proceeding
+INFO:     10.16.6.70:20389 - "GET /api/v1/analytics/user/overview?limit=50 HTTP/1.1" 200 OK
+INFO: 2025-11-30T10:20:57 - app.api.deps: Checking active user: 43b778b0-2062-4724-abbb-916a4835a9b0, is_active: True, type: <class 'bool'>
+INFO: 2025-11-30T10:20:57 - app.api.deps: User 43b778b0-2062-4724-abbb-916a4835a9b0 is active - proceeding
+INFO:     10.16.34.155:45714 - "GET /api/v1/projects?page=1&per_page=100&status=active HTTP/1.1" 200 OK
+INFO:     10.16.6.70:7828 - "GET /health HTTP/1.1" 200 OK
+INFO:     10.16.6.70:7828 - "GET /api/v1/tickets/8f08ad14-df8b-4780-84e7-0d45e133f2a6/detail HTTP/1.1" 200 OK
+/app/src/app/services/ticket_service.py:694: SAWarning: Coercing Subquery object into a select() for use in IN(); please pass a select() construct explicitly
+  query = query.filter(Ticket.project_id.in_(team_projects))
+INFO:     10.16.18.114:24662 - "GET /api/v1/tickets?project_id=0ade6bd1-e492-4e25-b681-59f42058d29a&skip=0&limit=50 HTTP/1.1" 200 OK
+INFO:     10.16.11.176:10506 - "GET /api/v1/tickets/stats?project_id=0ade6bd1-e492-4e25-b681-59f42058d29a HTTP/1.1" 200 OK
+INFO: 2025-11-30T10:21:05 - app.api.deps: Checking active user: 43b778b0-2062-4724-abbb-916a4835a9b0, is_active: True, type: <class 'bool'>
+INFO: 2025-11-30T10:21:05 - app.api.deps: User 43b778b0-2062-4724-abbb-916a4835a9b0 is active - proceeding
+INFO:     10.16.11.176:10506 - "GET /api/v1/projects/0ade6bd1-e492-4e25-b681-59f42058d29a/regions HTTP/1.1" 200 OK
+INFO:     10.16.34.155:55245 - "GET /api/v1/tickets/f59b29fc-d0b9-4618-b0d1-889e340da612/detail HTTP/1.1" 200 OK
+INFO: 2025-11-30T10:21:10 - app.services.ticket_assignment_service: Ticket f59b29fc-d0b9-4618-b0d1-889e340da612 self-assigned by Viyisa Sasa - notification queued
+INFO:     10.16.6.70:14190 - "POST /api/v1/ticket-assignments/tickets/f59b29fc-d0b9-4618-b0d1-889e340da612/self-assign HTTP/1.1" 201 Created
+INFO:     10.16.6.70:14190 - "GET /api/v1/tickets/f59b29fc-d0b9-4618-b0d1-889e340da612/detail HTTP/1.1" 200 OK
+INFO:     10.16.25.209:61895 - "GET /health HTTP/1.1" 200 OK
+INFO:     10.16.25.209:21306 - "GET /health HTTP/1.1" 200 OK
+INFO:     10.16.6.70:54905 - "GET /health HTTP/1.1" 200 OK
+ERROR: 2025-11-30T10:22:11 - app.core.supabase_auth: Session refresh error: Invalid Refresh Token: Already Used
+ERROR: 2025-11-30T10:22:11 - app.api.v1.auth: ❌ Token refresh error: Invalid Refresh Token: Already Used
+INFO:     10.16.6.70:54905 - "POST /api/v1/auth/refresh-token HTTP/1.1" 401 Unauthorized
+INFO:     10.16.25.209:11050 - "GET /health HTTP/1.1" 200 OK
+INFO: 2025-11-30T10:22:19 - app.core.supabase_auth: User signed in successfully: nadina73@nembors.com
+INFO: 2025-11-30T10:22:19 - app.services.audit_service: Audit log created: login on auth by nadina73@nembors.com
+INFO: 2025-11-30T10:22:19 - app.api.v1.auth: User logged in successfully: nadina73@nembors.com
+INFO:     10.16.34.155:36441 - "POST /api/v1/auth/login HTTP/1.1" 200 OK
+INFO: 2025-11-30T10:22:20 - app.api.deps: Checking active user: c5cf92be-4172-4fe2-af5c-f05d83b3a938, is_active: True, type: <class 'bool'>
+INFO: 2025-11-30T10:22:20 - app.api.deps: User c5cf92be-4172-4fe2-af5c-f05d83b3a938 is active - proceeding
+INFO:     10.16.25.209:52587 - "GET /api/v1/auth/me HTTP/1.1" 200 OK
+INFO: 2025-11-30T10:22:21 - app.api.deps: Checking active user: c5cf92be-4172-4fe2-af5c-f05d83b3a938, is_active: True, type: <class 'bool'>
+INFO: 2025-11-30T10:22:21 - app.api.deps: User c5cf92be-4172-4fe2-af5c-f05d83b3a938 is active - proceeding
+INFO:     10.16.34.155:36441 - "GET /api/v1/auth/me/preferences HTTP/1.1" 200 OK
+INFO: 2025-11-30T10:22:21 - app.api.deps: Checking active user: c5cf92be-4172-4fe2-af5c-f05d83b3a938, is_active: True, type: <class 'bool'>
+INFO: 2025-11-30T10:22:21 - app.api.deps: User c5cf92be-4172-4fe2-af5c-f05d83b3a938 is active - proceeding
+INFO: 2025-11-30T10:22:21 - app.api.deps: Checking active user: c5cf92be-4172-4fe2-af5c-f05d83b3a938, is_active: True, type: <class 'bool'>
+INFO: 2025-11-30T10:22:21 - app.api.deps: User c5cf92be-4172-4fe2-af5c-f05d83b3a938 is active - proceeding
+INFO:     10.16.18.114:63198 - "GET /api/v1/auth/me/preferences/available-apps HTTP/1.1" 200 OK
+INFO:     10.16.6.70:46136 - "GET /api/v1/analytics/user/overview HTTP/1.1" 200 OK
+INFO: 2025-11-30T10:22:22 - app.api.deps: Checking active user: c5cf92be-4172-4fe2-af5c-f05d83b3a938, is_active: True, type: <class 'bool'>
+INFO: 2025-11-30T10:22:22 - app.api.deps: User c5cf92be-4172-4fe2-af5c-f05d83b3a938 is active - proceeding
+INFO:     10.16.34.155:36441 - "GET /api/v1/projects?page=1&per_page=100 HTTP/1.1" 200 OK
+INFO: 2025-11-30T10:22:28 - app.api.deps: Checking active user: c5cf92be-4172-4fe2-af5c-f05d83b3a938, is_active: True, type: <class 'bool'>
+INFO: 2025-11-30T10:22:28 - app.api.deps: User c5cf92be-4172-4fe2-af5c-f05d83b3a938 is active - proceeding
+INFO: 2025-11-30T10:22:28 - app.services.audit_service: Audit log created: update on user_preferences by nadina73@nembors.com
+INFO: 2025-11-30T10:22:28 - app.api.v1.auth: Preferences updated for user: nadina73@nembors.com
+INFO:     10.16.6.70:40549 - "PUT /api/v1/auth/me/preferences HTTP/1.1" 200 OK
+INFO: 2025-11-30T10:22:28 - app.api.deps: Checking active user: c5cf92be-4172-4fe2-af5c-f05d83b3a938, is_active: True, type: <class 'bool'>
+INFO: 2025-11-30T10:22:28 - app.api.deps: User c5cf92be-4172-4fe2-af5c-f05d83b3a938 is active - proceeding
+INFO: 2025-11-30T10:22:29 - app.services.dashboard_service: Dashboard cache MISS for project 0ade6bd1-e492-4e25-b681-59f42058d29a, user c5cf92be-4172-4fe2-af5c-f05d83b3a938 - building fresh data
+INFO: 2025-11-30T10:22:29 - app.services.dashboard_service: Built and cached dashboard for project 0ade6bd1-e492-4e25-b681-59f42058d29a
+INFO:     10.16.25.209:42985 - "GET /api/v1/projects/0ade6bd1-e492-4e25-b681-59f42058d29a/dashboard HTTP/1.1" 200 OK
+INFO: 2025-11-30T10:22:29 - app.api.deps: Checking active user: c5cf92be-4172-4fe2-af5c-f05d83b3a938, is_active: True, type: <class 'bool'>
+INFO: 2025-11-30T10:22:29 - app.api.deps: User c5cf92be-4172-4fe2-af5c-f05d83b3a938 is active - proceeding
+INFO:     10.16.18.114:64034 - "GET /api/v1/auth/me HTTP/1.1" 200 OK
+INFO:     10.16.18.114:4512 - "GET /api/v1/notifications?project_id=0ade6bd1-e492-4e25-b681-59f42058d29a&page_size=50 HTTP/1.1" 200 OK
+INFO:     10.16.6.70:40549 - "GET /api/v1/tickets/stats?project_id=0ade6bd1-e492-4e25-b681-59f42058d29a HTTP/1.1" 200 OK
+INFO:     10.16.6.70:40549 - "GET /health HTTP/1.1" 200 OK
+INFO:     10.16.11.176:16113 - "GET /health HTTP/1.1" 200 OK
+INFO:     10.16.25.209:8875 - "GET /health HTTP/1.1" 200 OK
+INFO:     10.16.34.155:9722 - "GET /health HTTP/1.1" 200 OK
+INFO:     10.16.11.176:17094 - "GET /health HTTP/1.1" 200 OK
+ 

src/app/api/v1/tickets.py

@@ -459,7 +459,7 @@ def get_ticket_detail(
     - Images list
     - Comments list
     - Assignments list
-    - Status history (if available)
+    - Status history (complete audit trail with location tracking)
     
     **Authorization:** Must have access to ticket's project
     
@@ -472,6 +472,7 @@ def get_ticket_detail(
     from app.models.ticket_image import TicketImage
     from app.models.ticket_comment import TicketComment
     from app.models.ticket_assignment import TicketAssignment
+    from app.models.ticket_status_history import TicketStatusHistory
     from app.services.ticket_action_service import TicketActionService
     from sqlalchemy.orm import joinedload
     
@@ -493,7 +494,8 @@ def get_ticket_detail(
         "expenses": [],
         "images": [],
         "comments": [],
-        "assignments": []
+        "assignments": [],
+        "status_history": []
     }
     
     # Get source-specific data based on ticket source
@@ -701,6 +703,33 @@ def get_ticket_detail(
         "ended_at": assignment.ended_at.isoformat() if assignment.ended_at else None
     } for assignment in assignments]
     
+    # Get status history
+    status_history = db.query(TicketStatusHistory).options(
+        joinedload(TicketStatusHistory.changed_by),
+        joinedload(TicketStatusHistory.assignment)
+    ).filter(
+        TicketStatusHistory.ticket_id == ticket_id,
+        TicketStatusHistory.deleted_at.is_(None)
+    ).order_by(TicketStatusHistory.changed_at.desc()).all()
+    
+    response["status_history"] = [{
+        "id": str(history.id),
+        "old_status": history.old_status,
+        "new_status": history.new_status,
+        "changed_at": history.changed_at.isoformat() if history.changed_at else None,
+        "changed_by_user_id": str(history.changed_by_user_id) if history.changed_by_user_id else None,
+        "changed_by_user_name": history.changed_by.full_name if history.changed_by else None,
+        "assignment_id": str(history.ticket_assignment_id) if history.ticket_assignment_id else None,
+        "change_reason": history.change_reason,
+        "notes": history.notes,
+        "location_latitude": float(history.location_latitude) if history.location_latitude else None,
+        "location_longitude": float(history.location_longitude) if history.location_longitude else None,
+        "location_accuracy": float(history.location_accuracy) if history.location_accuracy else None,
+        "location_verified": history.location_verified,
+        "communication_method": history.communication_method,
+        "additional_metadata": history.additional_metadata
+    } for history in status_history]
+    
     return response
 
 

src/app/schemas/ticket_assignment.py

@@ -46,6 +46,7 @@ class TicketAssignCreate(BaseModel):
     execution_order: Optional[int] = Field(None, ge=1, description="Agent's planned execution order")
     planned_start_time: Optional[datetime] = Field(None, description="When agent plans to start")
     notes: Optional[str] = Field(None, max_length=1000, description="Assignment notes")
+    location: Optional[LocationPoint] = Field(None, description="Dispatcher's GPS location when assigning")
 
     class Config:
         json_schema_extra = {
@@ -53,7 +54,12 @@ class TicketAssignCreate(BaseModel):
                 "user_id": "123e4567-e89b-12d3-a456-426614174000",
                 "execution_order": 1,
                 "planned_start_time": "2024-03-20T09:00:00Z",
-                "notes": "Customer prefers morning visit"
+                "notes": "Customer prefers morning visit",
+                "location": {
+                    "latitude": -1.2921,
+                    "longitude": 36.8219,
+                    "accuracy": 10
+                }
             }
         }
 
@@ -230,13 +236,19 @@ class TicketSelfAssign(BaseModel):
     execution_order: Optional[int] = Field(None, ge=1, description="Agent's planned execution order")
     planned_start_time: Optional[datetime] = Field(None, description="When agent plans to start")
     notes: Optional[str] = Field(None, max_length=1000, description="Assignment notes")
+    location: Optional[LocationPoint] = Field(None, description="Current GPS location when self-assigning")
 
     class Config:
         json_schema_extra = {
             "example": {
                 "execution_order": 1,
                 "planned_start_time": "2024-03-20T09:00:00Z",
-                "notes": "I know this area well, can complete quickly"
+                "notes": "I know this area well, can complete quickly",
+                "location": {
+                    "latitude": -1.2921,
+                    "longitude": 36.8219,
+                    "accuracy": 10
+                }
             }
         }
 

src/app/services/ticket_assignment_service.py

@@ -109,10 +109,24 @@ class TicketAssignmentService:
         )
         
         self.db.add(assignment)
+        self.db.flush()  # Flush to get assignment.id before creating status history
         
         # Update ticket status
+        old_status = ticket.status
         if ticket.status == TicketStatus.OPEN.value:
             ticket.status = TicketStatus.ASSIGNED.value
+            
+            # Create status history entry with assignment_id
+            self._create_status_history(
+                ticket=ticket,
+                old_status=old_status,
+                new_status=TicketStatus.ASSIGNED.value,
+                changed_by_user_id=assigned_by_user_id,
+                assignment_id=assignment.id,
+                reason=f"Assigned to {agent.full_name}",
+                location_lat=data.location.latitude if data.location else None,
+                location_lng=data.location.longitude if data.location else None
+            )
         
         self.db.commit()
         self.db.refresh(assignment)
@@ -384,19 +398,22 @@ class TicketAssignmentService:
         )
         
         self.db.add(assignment)
+        self.db.flush()  # Flush to get assignment.id before creating status history
         
-        # Update ticket status and log history
+        # Update ticket status
         old_status = ticket.status
         ticket.status = TicketStatus.ASSIGNED.value
         
-        # Create status history entry
+        # Create status history entry with assignment_id
         self._create_status_history(
             ticket=ticket,
             old_status=old_status,
             new_status=TicketStatus.ASSIGNED.value,
             changed_by_user_id=user_id,
-            assignment_id=assignment.id,
-            reason="Self-assigned by agent"
+            assignment_id=assignment.id,  # Now has ID from flush
+            reason="Self-assigned by agent",
+            location_lat=data.location.latitude if data.location else None,
+            location_lng=data.location.longitude if data.location else None
         )
         
         self.db.commit()