fix: correct get_db imports and remove duplicate definition

docs/api/dashboards/pm/PM_DASHBOARD_API_REFERENCE.md

@@ -0,0 +1,1054 @@
+# Project Manager Dashboard - API Reference
+
+**Version:** 1.0  
+**Last Updated:** 2025-11-19  
+**Audience:** Frontend Development Team
+
+---
+
+## Overview
+
+This document provides all API endpoints needed to build a comprehensive Project Manager (PM) dashboard. The PM role requires visibility across sales, operations, finance, and resources to orchestrate daily field service operations.
+
+### PM Core Responsibilities
+- Convert sales orders to work tickets
+- Assign tickets to field agents
+- Approve expenses and manage finances
+- Track inventory and resources
+- Generate payroll and invoices
+- Monitor team performance
+
+---
+
+## Dashboard Layout Structure
+
+### Recommended Sections
+
+1. **Today's Overview** - Key metrics at a glance
+2. **Financial Snapshot** - Cash position and pending payments
+3. **Quick Actions** - Common PM tasks
+4. **Pending Sales Orders** - Orders awaiting conversion
+5. **Active Tickets** - Work in progress
+6. **Pending Approvals** - Expenses, payroll, invoices
+7. **Inventory Status** - Stock levels and alerts
+8. **Map View** - Geographic visualization
+9. **Team Status** - Agent availability
+
+---
+
+## API Endpoints by Feature
+
+### 1. Dashboard Overview Statistics
+
+#### Get Platform Dashboard Stats
+```
+GET /api/v1/analytics/platform-admin/dashboard
+Authorization: Bearer {token}
+```
+
+**Response Fields:**
+- `users` - User statistics (total, active, by role)
+- `organizations` - Client and contractor counts
+- `tickets` - Ticket counts by status and type
+- `projects` - Project statistics
+- `assignments` - Assignment statistics
+- `recent_activity` - Latest 10 audit logs
+- `system_health` - 30-day trends
+
+**Use Case:** Main dashboard metrics widget
+
+---
+
+### 2. Sales Order Management
+
+#### List Sales Orders
+```
+GET /api/v1/sales-orders
+Authorization: Bearer {token}
+
+Query Parameters:
+- skip (int, default: 0)
+- limit (int, default: 50, max: 100)
+- project_id (UUID, optional)
+- status (string, optional) - "pending", "processed", "cancelled", "duplicate"
+- project_region_id (UUID, optional)
+- sales_agent_id (UUID, optional)
+- from_date (date, optional)
+- to_date (date, optional)
+- pending_processing (boolean, optional) - Show only pending orders
+- customer_phone (string, optional)
+```
+
+**Response:**
+- `items[]` - Array of sales orders with computed properties
+- `total` - Total count
+- `skip`, `limit` - Pagination info
+
+**Key Fields per Item:**
+- `id`, `order_number`, `customer_name`, `customer_preferred_package`
+- `package_price`, `installation_address_line1`, `installation_latitude`, `installation_longitude`
+- `status`, `project_title`, `region_name`, `sales_agent_name`
+- `is_pending`, `has_ticket`, `can_promote_to_ticket`
+
+#### Get Sales Order Statistics
+```
+GET /api/v1/sales-orders/stats
+Authorization: Bearer {token}
+
+Query Parameters:
+- project_id (UUID, optional)
+- project_region_id (UUID, optional)
+- sales_agent_id (UUID, optional)
+```
+
+**Response:** Metrics on orders by status, region, agent
+
+#### Assign Sales Order to Region
+```
+POST /api/v1/sales-orders/{sales_order_id}/assign-region
+Authorization: Bearer {token}
+Content-Type: application/json
+
+Body:
+{
+  "project_region_id": "uuid"
+}
+```
+
+#### Promote Sales Order to Ticket (Single)
+```
+POST /api/v1/sales-orders/{sales_order_id}/promote
+Authorization: Bearer {token}
+Content-Type: application/json
+
+Body:
+{
+  "priority": "normal",
+  "scheduled_date": "2025-01-20",
+  "scheduled_time_slot": "morning",
+  "work_description": "Install fiber",
+  "notes": "Customer prefers morning"
+}
+```
+
+**Response:**
+- `message`, `sales_order_id`, `ticket_id`, `ticket_name`, `status`
+
+#### Bulk Promote Sales Orders to Tickets
+```
+POST /api/v1/sales-orders/bulk-promote
+Authorization: Bearer {token}
+Content-Type: application/json
+
+Body:
+{
+  "sales_order_ids": ["uuid1", "uuid2"],
+  "priority": "normal",
+  "notes": "Batch promotion"
+}
+```
+
+**Response:**
+- `total`, `successful`, `failed`, `errors[]`, `created_ticket_ids[]`
+
+---
+
+### 3. Ticket Management
+
+#### List Tickets
+```
+GET /api/v1/tickets
+Authorization: Bearer {token}
+
+Query Parameters:
+- skip (int, default: 0)
+- limit (int, default: 50, max: 100)
+- project_id (UUID, optional)
+- status (enum, optional) - "open", "assigned", "in_progress", "pending_review", "completed", "cancelled"
+- ticket_type (enum, optional) - "installation", "support", "infrastructure"
+- priority (enum, optional) - "low", "normal", "high", "urgent"
+- project_region_id (UUID, optional)
+- source (enum, optional) - "sales_order", "incident", "task"
+- from_date (date, optional)
+- to_date (date, optional)
+- is_overdue (boolean, optional)
+```
+
+**Response:**
+- `tickets[]` - Array of tickets
+- `total`, `skip`, `limit`
+
+**Key Fields per Ticket:**
+- `id`, `ticket_name`, `status`, `priority`, `ticket_type`
+- `work_description`, `scheduled_date`, `scheduled_time_slot`
+- `project_title`, `region_name`, `customer_name`
+- `is_overdue`, `can_be_assigned`
+
+#### Get Ticket Statistics
+```
+GET /api/v1/tickets/stats
+Authorization: Bearer {token}
+
+Query Parameters:
+- project_id (UUID, optional)
+- project_region_id (UUID, optional)
+```
+
+**Response:**
+- Counts by status, type, priority
+- `overdue_tickets`, `avg_completion_time_hours`, `completion_rate`
+
+#### Update Ticket
+```
+PUT /api/v1/tickets/{ticket_id}
+Authorization: Bearer {token}
+Content-Type: application/json
+
+Body:
+{
+  "priority": "urgent",
+  "work_description": "Updated description",
+  "notes": "Additional notes"
+}
+```
+
+#### Reschedule Ticket
+```
+POST /api/v1/tickets/{ticket_id}/reschedule
+Authorization: Bearer {token}
+Content-Type: application/json
+
+Body:
+{
+  "scheduled_date": "2025-01-25",
+  "scheduled_time_slot": "afternoon",
+  "reason": "Customer requested later date"
+}
+```
+
+#### Cancel Ticket
+```
+POST /api/v1/tickets/{ticket_id}/cancel
+Authorization: Bearer {token}
+Content-Type: application/json
+
+Body:
+{
+  "reason": "Customer cancelled service"
+}
+```
+
+---
+
+### 4. Ticket Assignment & Dispatch
+
+#### List Ticket Assignments
+```
+GET /api/v1/ticket-assignments
+Authorization: Bearer {token}
+
+Query Parameters:
+- skip (int, default: 0)
+- limit (int, default: 50)
+- ticket_id (UUID, optional)
+- user_id (UUID, optional)
+- status (string, optional)
+- project_id (UUID, optional)
+- from_date (date, optional)
+- to_date (date, optional)
+```
+
+#### Get Available Agents for Assignment
+```
+GET /api/v1/ticket-assignments/available-agents
+Authorization: Bearer {token}
+
+Query Parameters:
+- ticket_id (UUID, required)
+```
+
+**Response:** List of agents available to be assigned to the ticket
+
+#### Assign Ticket to Agent
+```
+POST /api/v1/ticket-assignments
+Authorization: Bearer {token}
+Content-Type: application/json
+
+Body:
+{
+  "ticket_id": "uuid",
+  "user_id": "uuid",
+  "notes": "Assigned to John"
+}
+```
+
+#### Reassign Ticket
+```
+POST /api/v1/ticket-assignments/{assignment_id}/reassign
+Authorization: Bearer {token}
+Content-Type: application/json
+
+Body:
+{
+  "new_user_id": "uuid",
+  "reason": "Original agent unavailable"
+}
+```
+
+---
+
+### 5. Expense Management
+
+#### List Expenses
+```
+GET /api/v1/expenses
+Authorization: Bearer {token}
+
+Query Parameters:
+- page (int, default: 1)
+- page_size (int, default: 50, max: 100)
+- ticket_id (UUID, optional)
+- assignment_id (UUID, optional)
+- approval_status (string, optional) - "pending", "approved", "rejected"
+- payment_status (string, optional) - "pending", "paid"
+- from_date (date, optional)
+- to_date (date, optional)
+```
+
+**Response:**
+- `items[]` - Array of expenses
+- `total`, `page`, `page_size`
+
+**Key Fields per Expense:**
+- `id`, `expense_type`, `amount`, `currency`
+- `description`, `receipt_url`
+- `approval_status`, `payment_status`
+- `submitted_by_name`, `approved_by_name`
+
+#### Get Expense Statistics
+```
+GET /api/v1/expenses/stats
+Authorization: Bearer {token}
+
+Query Parameters:
+- ticket_id (UUID, optional)
+- assignment_id (UUID, optional)
+```
+
+**Response:** Total expenses, pending approvals, payment status breakdown
+
+#### Approve/Reject Expense
+```
+POST /api/v1/expenses/{expense_id}/approve
+Authorization: Bearer {token}
+Content-Type: application/json
+
+Body:
+{
+  "approved": true,
+  "notes": "Approved - receipt verified"
+}
+```
+
+#### Mark Expense as Paid
+```
+POST /api/v1/expenses/{expense_id}/mark-paid
+Authorization: Bearer {token}
+Content-Type: application/json
+
+Body:
+{
+  "payment_date": "2025-01-20",
+  "payment_method": "mobile_money",
+  "payment_reference": "TXN123456",
+  "notes": "Paid via M-Pesa"
+}
+```
+
+---
+
+### 6. Financial Management
+
+#### List Financial Transactions
+```
+GET /api/v1/finance
+Authorization: Bearer {token}
+
+Query Parameters:
+- skip (int, default: 0)
+- limit (int, default: 50, max: 100)
+- project_id (UUID, optional)
+- transaction_type (string, optional) - "inflow", "outflow"
+- status (string, optional) - "pending", "approved", "paid", "rejected", "cancelled"
+- category (string, optional)
+- from_date (date, optional)
+- to_date (date, optional)
+- pending_approval (boolean, optional)
+```
+
+#### Get Cash Flow Summary
+```
+GET /api/v1/finance/cash-flow/{project_id}
+Authorization: Bearer {token}
+
+Query Parameters:
+- from_date (date, optional)
+- to_date (date, optional)
+```
+
+**Response:**
+- Total inflows, outflows, net cash flow
+- Breakdown by category
+- Pending transactions
+
+#### Create Financial Transaction
+```
+POST /api/v1/finance
+Authorization: Bearer {token}
+Content-Type: application/json
+
+Body:
+{
+  "project_id": "uuid",
+  "transaction_type": "outflow",
+  "amount": 50000,
+  "currency": "KES",
+  "category": "equipment_purchase",
+  "description": "Purchased 50 ONTs",
+  "transaction_date": "2025-01-20"
+}
+```
+
+#### Approve Transaction
+```
+POST /api/v1/finance/{transaction_id}/approve
+Authorization: Bearer {token}
+Content-Type: application/json
+
+Body:
+{
+  "notes": "Approved by PM"
+}
+```
+
+---
+
+### 7. Contractor Invoice Management
+
+#### List Contractor Invoices
+```
+GET /api/v1/invoices
+Authorization: Bearer {token}
+
+Query Parameters:
+- skip (int, default: 0)
+- limit (int, default: 100, max: 500)
+- contractor_id (UUID, optional)
+- client_id (UUID, optional)
+- project_id (UUID, optional)
+- status (string, optional) - "draft", "sent", "partially_paid", "paid", "cancelled"
+- overdue_only (boolean, optional)
+- unpaid_only (boolean, optional)
+- latest_versions_only (boolean, default: true)
+```
+
+**Response:**
+- `invoices[]` - Array of invoices
+- `total`, `skip`, `limit`
+
+**Key Fields per Invoice:**
+- `id`, `invoice_number`, `contractor_name`, `client_name`
+- `subtotal_amount`, `tax_amount`, `total_amount`
+- `amount_paid`, `amount_due`
+- `status`, `due_date`, `is_overdue`
+
+#### Create Contractor Invoice
+```
+POST /api/v1/invoices
+Authorization: Bearer {token}
+Content-Type: application/json
+
+Body:
+{
+  "contractor_id": "uuid",
+  "client_id": "uuid",
+  "project_id": "uuid",
+  "invoice_date": "2025-01-20",
+  "due_date": "2025-02-20",
+  "currency": "KES",
+  "tax_rate": 16.0,
+  "notes": "Monthly invoice"
+}
+```
+
+**Response:** Created invoice with auto-generated invoice number
+
+#### Add Line Item to Invoice
+```
+POST /api/v1/invoices/{invoice_id}/line-items
+Authorization: Bearer {token}
+Content-Type: application/json
+
+Body:
+{
+  "line_item_type": "ticket",
+  "ticket_id": "uuid",
+  "description": "Installation service",
+  "quantity": 1,
+  "unit_price": 5000,
+  "amount": 5000
+}
+```
+
+**Note:** Creates new invoice version
+
+#### Record Payment
+```
+POST /api/v1/invoices/{invoice_id}/payments
+Authorization: Bearer {token}
+Content-Type: application/json
+
+Body:
+{
+  "amount": 50000,
+  "payment_date": "2025-01-20",
+  "payment_method": "bank_transfer",
+  "payment_reference": "TXN123456",
+  "notes": "Partial payment"
+}
+```
+
+**Response:** Updated invoice with new payment recorded
+
+---
+
+### 8. Inventory Management
+
+#### List Main Office Inventory
+```
+GET /api/v1/inventory
+Authorization: Bearer {token}
+
+Query Parameters:
+- page (int, default: 1)
+- page_size (int, default: 50, max: 100)
+- project_id (UUID, optional)
+- item_type (string, optional) - "tool", "equipment", "consumable", "ppe"
+- status (string, optional)
+- is_active (boolean, optional)
+- search (string, optional)
+```
+
+**Response:**
+- `items[]` - Inventory batches
+- `total`, `page`, `page_size`
+
+**Key Fields per Item:**
+- `id`, `equipment_type`, `equipment_name`, `item_type`
+- `quantity_received`, `quantity_available`, `quantity_distributed`
+- `status`, `received_date`
+
+#### Create Inventory Batch
+```
+POST /api/v1/inventory
+Authorization: Bearer {token}
+Content-Type: application/json
+
+Body:
+{
+  "project_id": "uuid",
+  "equipment_type": "ONT",
+  "equipment_name": "Huawei HG8145V5",
+  "item_type": "equipment",
+  "quantity_received": 100,
+  "received_date": "2025-01-20",
+  "supplier_name": "TechSupply Ltd",
+  "unit_cost": 2500,
+  "currency": "KES"
+}
+```
+
+#### List Regional Distributions
+```
+GET /api/v1/inventory/distributions
+Authorization: Bearer {token}
+
+Query Parameters:
+- page (int, default: 1)
+- page_size (int, default: 50)
+- project_id (UUID, optional)
+- region_id (UUID, optional)
+- inventory_id (UUID, optional)
+- item_type (string, optional)
+- is_active (boolean, optional)
+```
+
+**Response:** Inventory distributed to regional hubs
+
+#### Distribute Inventory to Regional Hub
+```
+POST /api/v1/inventory/distributions
+Authorization: Bearer {token}
+Content-Type: application/json
+
+Body:
+{
+  "inventory_id": "uuid",
+  "project_region_id": "uuid",
+  "quantity_distributed": 20,
+  "distributed_date": "2025-01-20",
+  "notes": "Distribution to Nairobi hub"
+}
+```
+
+#### List Inventory Assignments (Issued to Agents)
+```
+GET /api/v1/inventory/assignments
+Authorization: Bearer {token}
+
+Query Parameters:
+- page (int, default: 1)
+- page_size (int, default: 50)
+- user_id (UUID, optional)
+- region_id (UUID, optional)
+- status (string, optional)
+- is_returned (boolean, optional)
+- ticket_id (UUID, optional)
+```
+
+**Response:** Equipment issued to field agents
+
+---
+
+### 9. Payroll Management
+
+#### List Payroll Records
+```
+GET /api/v1/payroll
+Authorization: Bearer {token}
+
+Query Parameters:
+- skip (int, default: 0)
+- limit (int, default: 50, max: 100)
+- user_id (UUID, optional)
+- project_id (UUID, optional)
+- period_start (date, optional)
+- period_end (date, optional)
+- status (string, optional)
+```
+
+**Response:**
+- `items[]` - Payroll records
+- `total`, `skip`, `limit`
+
+**Key Fields per Record:**
+- `id`, `user_name`, `period_start`, `period_end`
+- `total_earnings`, `deductions`, `net_pay`
+- `status`, `payment_status`
+
+#### Generate Payroll
+```
+POST /api/v1/payroll/generate
+Authorization: Bearer {token}
+Content-Type: application/json
+
+Body:
+{
+  "project_id": "uuid",
+  "period_start": "2025-01-01",
+  "period_end": "2025-01-31",
+  "user_ids": ["uuid1", "uuid2"]
+}
+```
+
+**Response:** Generated payroll records
+
+#### Approve Payroll
+```
+POST /api/v1/payroll/{payroll_id}/approve
+Authorization: Bearer {token}
+Content-Type: application/json
+
+Body:
+{
+  "notes": "Approved for payment"
+}
+```
+
+---
+
+### 10. Timesheet Management
+
+#### List Timesheets
+```
+GET /api/v1/timesheets
+Authorization: Bearer {token}
+
+Query Parameters:
+- skip (int, default: 0)
+- limit (int, default: 50, max: 100)
+- user_id (UUID, optional)
+- project_id (UUID, optional)
+- from_date (date, optional)
+- to_date (date, optional)
+- status (string, optional) - "present", "absent", "on_leave", "sick_leave", "half_day"
+```
+
+#### Get Timesheet Statistics
+```
+GET /api/v1/timesheets/stats
+Authorization: Bearer {token}
+
+Query Parameters:
+- user_id (UUID, optional)
+- project_id (UUID, optional)
+- from_date (date, optional)
+- to_date (date, optional)
+```
+
+**Response:** Attendance metrics, days worked, absences
+
+---
+
+### 11. User Management
+
+#### List Users
+```
+GET /api/v1/users
+Authorization: Bearer {token}
+
+Query Parameters:
+- skip (int, default: 0)
+- limit (int, default: 50, max: 100)
+- role (string, optional)
+- client_id (UUID, optional)
+- contractor_id (UUID, optional)
+- is_active (boolean, optional)
+- status (string, optional)
+- search (string, optional)
+```
+
+**Response:**
+- `users[]` - Array of users
+- `total`, `skip`, `limit`
+
+#### Search Users
+```
+GET /api/v1/users/search
+Authorization: Bearer {token}
+
+Query Parameters:
+- q (string, required) - Search query
+- role (string, optional)
+- limit (int, default: 20)
+```
+
+**Response:** Matching users (useful for assignment dropdowns)
+
+#### Invite New User
+```
+POST /api/v1/invitations
+Authorization: Bearer {token}
+Content-Type: application/json
+
+Body:
+{
+  "email": "john@example.com",
+  "name": "John Doe",
+  "phone": "+254712345678",
+  "role": "field_agent",
+  "contractor_id": "uuid"
+}
+```
+
+---
+
+### 12. Map & Location Services
+
+#### Get Map Entities
+```
+GET /api/v1/map/entities
+Authorization: Bearer {token}
+
+Query Parameters:
+- project_id (UUID, required)
+- entity_types (array, optional) - ["customers", "tickets", "sales_orders", "agents", "regions"]
+- status (string, optional)
+```
+
+**Response:**
+- `customers[]` - Customer locations
+- `tickets[]` - Ticket locations
+- `sales_orders[]` - Sales order locations
+- `agents[]` - Agent current locations
+- `regions[]` - Regional hub locations
+
+**Use Case:** Render all entities on map view
+
+#### Get Regional Hub Locations
+```
+GET /api/v1/map/regions/{project_id}
+Authorization: Bearer {token}
+
+Query Parameters:
+- include_inactive (boolean, default: false)
+```
+
+**Response:** Regional hubs with coordinates, coverage radius, active tickets/agents count
+
+#### Get Journey Details
+```
+GET /api/v1/map/journey/{assignment_id}
+Authorization: Bearer {token}
+```
+
+**Response:**
+- Timeline (start, arrival, completion times)
+- GPS breadcrumb trail (array of coordinates with timestamps)
+- Journey statistics (distance, duration, speed)
+- Location information
+
+**Use Case:** Track agent movement during work assignment
+
+#### Find Nearest Regional Hub
+```
+GET /api/v1/map/nearest-region
+Authorization: Bearer {token}
+
+Query Parameters:
+- project_id (UUID, required)
+- latitude (float, required)
+- longitude (float, required)
+- max_distance_km (float, optional)
+```
+
+**Response:** Nearest regional hub with distance
+
+---
+
+### 13. Task Management
+
+#### List Tasks
+```
+GET /api/v1/tasks
+Authorization: Bearer {token}
+
+Query Parameters:
+- skip (int, default: 0)
+- limit (int, default: 50, max: 100)
+- project_id (UUID, optional)
+- status (string, optional) - "pending", "assigned", "in_progress", "completed", "cancelled", "blocked"
+- assigned_to (UUID, optional)
+- priority (string, optional)
+- from_date (date, optional)
+- to_date (date, optional)
+```
+
+#### Create Task
+```
+POST /api/v1/tasks
+Authorization: Bearer {token}
+Content-Type: application/json
+
+Body:
+{
+  "project_id": "uuid",
+  "task_type": "installation",
+  "title": "Install fiber cable",
+  "description": "Install cable from pole A to B",
+  "priority": "high",
+  "due_date": "2025-01-25",
+  "assigned_to": "uuid"
+}
+```
+
+---
+
+### 14. Customer Management
+
+#### List Customers
+```
+GET /api/v1/customers
+Authorization: Bearer {token}
+
+Query Parameters:
+- skip (int, default: 0)
+- limit (int, default: 50, max: 100)
+- client_id (UUID, optional)
+- search (string, optional)
+- phone (string, optional)
+```
+
+#### Get Customer Details
+```
+GET /api/v1/customers/{customer_id}
+Authorization: Bearer {token}
+```
+
+**Response:** Customer profile with all related data (subscriptions, tickets, sales orders)
+
+---
+
+### 15. Notifications
+
+#### List Notifications
+```
+GET /api/v1/notifications
+Authorization: Bearer {token}
+
+Query Parameters:
+- skip (int, default: 0)
+- limit (int, default: 50)
+- is_read (boolean, optional)
+- type (string, optional)
+```
+
+#### Get Unread Count
+```
+GET /api/v1/notifications/unread-count
+Authorization: Bearer {token}
+```
+
+**Response:** `{ "count": 5 }`
+
+#### Mark Notification as Read
+```
+PUT /api/v1/notifications/{notification_id}/read
+Authorization: Bearer {token}
+```
+
+---
+
+## Authentication
+
+All endpoints require Bearer token authentication:
+
+```
+Authorization: Bearer {access_token}
+```
+
+**Token Refresh:**
+```
+POST /api/v1/auth/refresh
+Content-Type: application/json
+
+Body:
+{
+  "refresh_token": "your_refresh_token"
+}
+```
+
+**Response:**
+```json
+{
+  "access_token": "new_access_token",
+  "refresh_token": "new_refresh_token",
+  "token_type": "bearer",
+  "expires_in": 3600
+}
+```
+
+---
+
+## Error Handling
+
+All endpoints follow standard HTTP status codes:
+
+- `200 OK` - Success
+- `201 Created` - Resource created
+- `204 No Content` - Success with no response body
+- `400 Bad Request` - Invalid input
+- `401 Unauthorized` - Missing or invalid token
+- `403 Forbidden` - Insufficient permissions
+- `404 Not Found` - Resource not found
+- `409 Conflict` - Duplicate or conflicting resource
+- `422 Unprocessable Entity` - Validation error
+- `500 Internal Server Error` - Server error
+
+**Error Response Format:**
+```json
+{
+  "detail": "Error message here"
+}
+```
+
+---
+
+## Pagination
+
+List endpoints use offset-based pagination:
+
+**Request:**
+- `skip` - Number of items to skip (default: 0)
+- `limit` - Number of items to return (default: 50, max varies by endpoint)
+
+**Response:**
+- `items[]` or `users[]` or similar - Array of results
+- `total` - Total count of items
+- `skip` - Current offset
+- `limit` - Current limit
+
+---
+
+## Date/Time Formats
+
+- **Dates:** ISO 8601 format `YYYY-MM-DD` (e.g., `2025-01-20`)
+- **DateTimes:** ISO 8601 with timezone `YYYY-MM-DDTHH:MM:SSZ` (e.g., `2025-01-20T14:30:00Z`)
+- **Time Slots:** `"morning"`, `"afternoon"`, `"evening"`, `"any"`
+
+---
+
+## Filtering Best Practices
+
+1. **Combine filters** - Most list endpoints support multiple filters simultaneously
+2. **Use pagination** - Always paginate large result sets
+3. **Cache where appropriate** - Dashboard stats can be cached for 1-5 minutes
+4. **Real-time updates** - Use polling or WebSockets for live data (tickets, assignments)
+
+---
+
+## Common UI Patterns
+
+### Dashboard Widgets
+- Fetch stats on page load
+- Refresh every 30-60 seconds for live data
+- Show loading skeletons during fetch
+
+### List Views
+- Implement infinite scroll or traditional pagination
+- Add filters in sidebar or top bar
+- Show total count and current range
+
+### Map Views
+- Lazy load entities based on viewport
+- Cluster markers when zoomed out
+- Show details on marker click
+
+### Approval Workflows
+- Show pending count badge
+- Provide bulk approve/reject actions
+- Confirm destructive actions (reject, cancel)
+
+---
+
+## Performance Recommendations
+
+1. **Lazy load** - Don't fetch all data at once
+2. **Debounce searches** - Wait 300ms before searching
+3. **Cache reference data** - Roles, statuses, regions rarely change
+4. **Optimize map rendering** - Use clustering for large datasets
+5. **Batch operations** - Use bulk endpoints when available
+
+---
+
+## Support & Questions
+
+For API questions or issues:
+- Backend Team Lead: [Contact Info]
+- API Documentation: `/api/v1/docs` (Swagger UI)
+- Base URL: `https://api.swiftops.example.com`
+
+---
+
+**End of Document**

docs/api/dashboards/pm/PM_DASHBOARD_DESIGN_GUIDE.md

@@ -0,0 +1,604 @@
+# Project Manager Dashboard - Design & UX Guide
+
+**Version:** 1.0  
+**Last Updated:** 2025-11-19  
+**Audience:** Frontend Development Team, UI/UX Designers
+
+---
+
+## Executive Summary
+
+The Project Manager (PM) dashboard is the command center for daily field service operations. It provides real-time visibility across sales, operations, finance, and resources, enabling PMs to orchestrate work efficiently.
+
+### Key Design Principles
+
+1. **Information at a Glance** - Critical metrics visible without scrolling
+2. **Action-Oriented** - Every metric has a corresponding action
+3. **Context-Aware** - Show relevant data based on time, location, status
+4. **Progressive Disclosure** - Summary → Details → Actions
+5. **Real-Time Updates** - Live data for time-sensitive operations
+
+---
+
+## User Persona: The Project Manager
+
+### Daily Workflow
+
+**Morning (8:00 AM - 10:00 AM)**
+- Review overnight sales orders
+- Check today's scheduled tickets
+- Approve pending expenses from yesterday
+- Assign unassigned tickets to field agents
+- Check inventory levels
+
+**Midday (10:00 AM - 2:00 PM)**
+- Monitor active tickets in progress
+- Handle reassignments (agent issues, emergencies)
+- Approve expense claims as they come in
+- Respond to customer escalations
+- Track agent locations on map
+
+**Afternoon (2:00 PM - 5:00 PM)**
+- Review completed tickets
+- Generate invoices for completed work
+- Process payroll for the period
+- Plan tomorrow's assignments
+- Review financial position
+
+### Pain Points to Solve
+
+❌ **Too many clicks** - Accessing critical info requires navigation  
+❌ **No overview** - Can't see overall status at a glance  
+❌ **Manual tracking** - Spreadsheets for inventory, assignments  
+❌ **Delayed approvals** - Expenses pile up, agents wait for payment  
+❌ **Poor visibility** - Don't know where agents are or what they're doing
+
+---
+
+## Dashboard Layout
+
+### Recommended Structure
+
+```
+┌─────────────────────────────────────────────────────────────────┐
+│  HEADER: SwiftOps | PM Dashboard | [Notifications] [Profile]   │
+├─────────────────────────────────────────────────────────────────┤
+│                                                                 │
+│  ┌─────────────────────────────────────────────────────────┐  │
+│  │  TODAY'S OVERVIEW (4 metric cards)                       │  │
+│  │  [Open Tickets] [Active Agents] [Overdue] [Pending $]   │  │
+│  └─────────────────────────────────────────────────────────┘  │
+│                                                                 │
+│  ┌─────────────────────────────────────────────────────────┐  │
+│  │  FINANCIAL SNAPSHOT (1 card, 4 metrics)                  │  │
+│  │  Cash | Pending Expenses | Unpaid Invoices | Payroll    │  │
+│  └─────────────────────────────────────────────────────────┘  │
+│                                                                 │
+│  ┌─────────────────────────────────────────────────────────┐  │
+│  │  QUICK ACTIONS (6 buttons)                               │  │
+│  │  [Assign Tickets] [Approve Expenses] [Add Inventory]    │  │
+│  │  [Generate Payroll] [Create Invoice] [Add User]         │  │
+│  └─────────────────────────────────────────────────────────┘  │
+│                                                                 │
+│  ┌───────────────────────────┬─────────────────────────────┐  │
+│  │  PENDING SALES ORDERS     │  INVENTORY STATUS           │  │
+│  │  (List with actions)      │  (Stock levels + alerts)    │  │
+│  │                           │                             │  │
+│  │  15 orders pending        │  ONTs: 45 ⚠️ Low           │  │
+│  │  [View All] [Bulk Assign] │  Routers: 120 ✓            │  │
+│  └───────────────────────────┴─────────────────────────────┘  │
+│                                                                 │
+│  ┌─────────────────────────────────────────────────────────┐  │
+│  │  ACTIVE TICKETS MAP                                      │  │
+│  │  (Interactive map showing tickets, agents, regions)      │  │
+│  │  [Full Screen] [Filters]                                │  │
+│  └─────────────────────────────────────────────────────────┘  │
+│                                                                 │
+│  ┌───────────────────────────┬─────────────────────────────┐  │
+│  │  PENDING APPROVALS        │  TEAM STATUS                │  │
+│  │  (Expenses, Payroll)      │  (Agent availability)       │  │
+│  └───────────────────────────┴─────────────────────────────┘  │
+│                                                                 │
+└─────────────────────────────────────────────────────────────────┘
+```
+
+---
+
+## Component Specifications
+
+### 1. Today's Overview Cards
+
+**Purpose:** At-a-glance metrics for daily operations
+
+**Layout:** 4 cards in a row (responsive: 2x2 on tablet, stacked on mobile)
+
+**Card 1: Open Tickets**
+- **Primary Metric:** Count of unassigned tickets
+- **Secondary Info:** "12 need assignment"
+- **Action:** Click → Navigate to tickets page with filter `status=open`
+- **Visual:** Orange/amber color if > 10, green if < 5
+- **API:** `GET /tickets/stats`
+
+**Card 2: Active Agents**
+- **Primary Metric:** Count of agents currently working
+- **Secondary Info:** "8 out of 25 agents"
+- **Action:** Click → Navigate to team page
+- **Visual:** Progress bar showing utilization
+- **API:** `GET /ticket-assignments?status=in_progress` (count unique users)
+
+**Card 3: Overdue Tickets**
+- **Primary Metric:** Count of overdue tickets
+- **Secondary Info:** "3 past SLA"
+- **Action:** Click → Navigate to tickets page with filter `is_overdue=true`
+- **Visual:** Red color if > 0, green if 0
+- **API:** `GET /tickets/stats` (overdue_tickets field)
+
+**Card 4: Pending Expenses**
+- **Primary Metric:** Count of pending expense approvals
+- **Secondary Info:** "KES 25,000 total"
+- **Action:** Click → Navigate to expenses page with filter `approval_status=pending`
+- **Visual:** Badge with count
+- **API:** `GET /expenses/stats`
+
+### 2. Financial Snapshot Card
+
+**Purpose:** Quick view of financial position
+
+**Layout:** Single card with 4 metrics in a row
+
+**Metrics:**
+1. **Cash Position** - Current available funds
+2. **Pending Expenses** - Awaiting approval
+3. **Unpaid Invoices** - Owed to contractors
+4. **Payroll Due** - Upcoming payroll obligations
+
+**Data Sources:**
+- `GET /finance/cash-flow/{project_id}`
+- `GET /expenses/stats`
+- `GET /invoices?unpaid_only=true`
+- `GET /payroll?status=approved&payment_status=pending`
+
+**Visual Design:**
+- Green for positive cash flow
+- Amber for low cash warnings
+- Red for negative/critical
+
+### 3. Quick Actions Bar
+
+**Purpose:** One-click access to common PM tasks
+
+**Layout:** 6 buttons in 2 rows (responsive: 3x2 on tablet, stacked on mobile)
+
+**Buttons:**
+1. **Assign Tickets** → Opens ticket assignment modal
+2. **Approve Expenses** → Opens expense approval queue
+3. **Add Inventory** → Opens inventory creation form
+4. **Generate Payroll** → Opens payroll generation wizard
+5. **Create Invoice** → Opens invoice creation form
+6. **Add User** → Opens user invitation form
+
+**Design:**
+- Icon + Label
+- Hover state shows tooltip with description
+- Disabled state if no pending items (e.g., "Approve Expenses" disabled if none pending)
+
+### 4. Pending Sales Orders Widget
+
+**Purpose:** Convert sales orders to work tickets
+
+**Layout:** List view with inline actions
+
+**Display:**
+- Show top 5 pending orders
+- Each row: Customer name, package, location, price
+- Actions per row: [Assign Region] [Convert to Ticket]
+- Footer: "15 total" + [View All] [Bulk Convert]
+
+**API:** `GET /sales-orders?pending_processing=true&limit=5`
+
+**Interactions:**
+- **Assign Region** → Opens region selector dropdown
+- **Convert to Ticket** → Opens ticket creation modal (pre-filled with order data)
+- **Bulk Convert** → Opens multi-select modal for batch conversion
+
+**Visual Indicators:**
+- ⚠️ No region assigned
+- ⚠️ No location coordinates
+- ✓ Ready to convert
+
+### 5. Inventory Status Widget
+
+**Purpose:** Monitor stock levels and prevent shortages
+
+**Layout:** Compact list with progress bars
+
+**Display:**
+- Equipment type + quantity + status indicator
+- Progress bar showing available vs. total
+- Alert icon for low stock (< 20% remaining)
+
+**Example:**
+```
+ONTs:        [████░░░░░░] 45 / 200  ⚠️ Low
+Routers:     [████████░░] 120 / 150 ✓
+Cables:      [██████████] 200 / 200 ✓
+```
+
+**API:** `GET /inventory?project_id={id}`
+
+**Actions:**
+- [Distribute to Hubs] → Opens distribution modal
+- [Add Stock] → Opens inventory creation form
+
+**Alert Thresholds:**
+- Red: < 10% remaining
+- Amber: < 20% remaining
+- Green: > 20% remaining
+
+### 6. Active Tickets Map
+
+**Purpose:** Geographic visualization of operations
+
+**Layout:** Interactive map (Google Maps, Mapbox, or Leaflet)
+
+**Map Layers:**
+1. **Regional Hubs** - Blue markers with coverage circles
+2. **Open Tickets** - Red markers
+3. **In-Progress Tickets** - Yellow markers
+4. **Completed Tickets** - Green markers
+5. **Field Agents** - Agent icons with real-time location
+6. **Sales Orders** - Purple markers (pending installation sites)
+
+**API:** `GET /map/entities?project_id={id}&entity_types=tickets,agents,regions,sales_orders`
+
+**Interactions:**
+- Click marker → Show popup with entity details
+- Click agent → Show current assignment + journey trail
+- Filter by entity type (toggle layers)
+- [Full Screen] button → Expand to full page
+
+**Performance:**
+- Use marker clustering for > 50 markers
+- Lazy load markers based on viewport
+- Update agent positions every 30 seconds
+
+### 7. Pending Approvals Widget
+
+**Purpose:** Queue of items requiring PM approval
+
+**Layout:** Tabbed interface or segmented list
+
+**Tabs:**
+1. **Expenses** (count badge)
+2. **Payroll** (count badge)
+3. **Invoices** (count badge)
+
+**Display per Tab:**
+- List of pending items (top 5)
+- Each row: Submitter, amount, date, [Approve] [Reject]
+- Footer: "12 total" + [View All]
+
+**APIs:**
+- `GET /expenses?approval_status=pending&limit=5`
+- `GET /payroll?status=pending&limit=5`
+- `GET /invoices?status=draft&limit=5`
+
+**Bulk Actions:**
+- [Approve All] - Approve all visible items
+- [Review Queue] - Navigate to full approval page
+
+### 8. Team Status Widget
+
+**Purpose:** Monitor agent availability and workload
+
+**Layout:** List or grid of agents
+
+**Display:**
+- Agent name + photo
+- Current status (Available, On Job, Off Duty)
+- Current assignment (if any)
+- Location (region/area)
+
+**API:** `GET /users?role=field_agent&is_active=true`
+
+**Status Indicators:**
+- 🟢 Available - No active assignment
+- 🟡 On Job - Has active assignment
+- 🔴 Off Duty - Not working today
+- ⚫ Offline - No recent location update
+
+**Interactions:**
+- Click agent → View profile + assignment history
+- Filter by status, region
+
+---
+
+## User Flows
+
+### Flow 1: Morning Routine - Review & Assign
+
+1. **PM logs in** → Dashboard loads
+2. **Sees "12 Open Tickets"** → Clicks card
+3. **Tickets page opens** → Filtered to `status=open`
+4. **Reviews first ticket** → Clicks "Assign"
+5. **Assignment modal opens** → Shows available agents
+6. **Selects agent** → Clicks "Assign"
+7. **Ticket assigned** → Notification sent to agent
+8. **Returns to dashboard** → Counter updates to "11 Open Tickets"
+
+**API Sequence:**
+```
+1. GET /tickets/stats
+2. GET /tickets?status=open
+3. GET /ticket-assignments/available-agents?ticket_id={id}
+4. POST /ticket-assignments
+5. GET /tickets/stats (refresh)
+```
+
+### Flow 2: Convert Sales Order to Ticket
+
+1. **PM sees "15 Pending Sales Orders"** → Reviews list
+2. **Clicks "Convert to Ticket"** on an order
+3. **Modal opens** → Pre-filled with order data
+4. **Selects priority, schedule** → Clicks "Create Ticket"
+5. **Ticket created** → Order marked as processed
+6. **Dashboard updates** → "14 Pending Sales Orders"
+
+**API Sequence:**
+```
+1. GET /sales-orders?pending_processing=true
+2. POST /sales-orders/{id}/promote
+3. GET /sales-orders?pending_processing=true (refresh)
+```
+
+### Flow 3: Approve Expenses
+
+1. **PM sees "5 Pending Expenses"** → Clicks widget
+2. **Expense approval page opens**
+3. **Reviews first expense** → Checks receipt, location
+4. **Clicks "Approve"** → Adds approval note
+5. **Expense approved** → Agent notified
+6. **Returns to dashboard** → "4 Pending Expenses"
+
+**API Sequence:**
+```
+1. GET /expenses?approval_status=pending
+2. POST /expenses/{id}/approve
+3. GET /expenses/stats (refresh)
+```
+
+### Flow 4: Distribute Inventory
+
+1. **PM sees "ONTs: 45 ⚠️ Low"** → Clicks "Distribute to Hubs"
+2. **Distribution modal opens** → Shows main office stock
+3. **Selects region, quantity** → Clicks "Distribute"
+4. **Inventory distributed** → Hub stock updated
+5. **Dashboard updates** → "ONTs: 25 ⚠️ Low" (main office)
+
+**API Sequence:**
+```
+1. GET /inventory?project_id={id}
+2. POST /inventory/distributions
+3. GET /inventory?project_id={id} (refresh)
+```
+
+### Flow 5: Track Agent on Map
+
+1. **PM clicks agent marker on map**
+2. **Popup shows** → Agent name, current assignment, status
+3. **Clicks "View Journey"**
+4. **Journey details load** → GPS breadcrumb trail displayed
+5. **PM sees** → Start time, arrival time, current location
+
+**API Sequence:**
+```
+1. GET /map/entities?entity_types=agents
+2. GET /map/journey/{assignment_id}
+```
+
+---
+
+## Data Refresh Strategy
+
+### Real-Time Updates (Every 10-30 seconds)
+- Active ticket assignments
+- Agent locations on map
+- Pending approvals count
+
+### Periodic Refresh (Every 1-5 minutes)
+- Dashboard statistics
+- Inventory levels
+- Financial metrics
+
+### On-Demand Refresh
+- After user action (assign ticket, approve expense)
+- Manual refresh button
+- Page focus/visibility change
+
+### Implementation Options
+
+**Option 1: Polling**
+```javascript
+// Refresh dashboard stats every 60 seconds
+setInterval(() => {
+  fetchDashboardStats();
+}, 60000);
+```
+
+**Option 2: WebSockets** (Future Enhancement)
+```javascript
+// Real-time updates via WebSocket
+socket.on('ticket_assigned', (data) => {
+  updateDashboardStats();
+});
+```
+
+**Option 3: Server-Sent Events** (Future Enhancement)
+```javascript
+// One-way real-time updates
+const eventSource = new EventSource('/api/v1/notifications/stream');
+eventSource.onmessage = (event) => {
+  handleUpdate(event.data);
+};
+```
+
+---
+
+## Responsive Design
+
+### Desktop (> 1200px)
+- Full dashboard layout as shown
+- All widgets visible
+- Map at comfortable size (400-600px height)
+
+### Tablet (768px - 1200px)
+- 2-column layout for metric cards
+- Stacked widgets (sales orders above inventory)
+- Collapsible sidebar for filters
+
+### Mobile (< 768px)
+- Single column layout
+- Metric cards stacked
+- Map hidden by default (accessible via tab)
+- Bottom navigation for quick actions
+
+---
+
+## Accessibility
+
+### Keyboard Navigation
+- All actions accessible via keyboard
+- Tab order follows visual hierarchy
+- Escape key closes modals
+
+### Screen Readers
+- Proper ARIA labels on all interactive elements
+- Status announcements for updates
+- Descriptive button labels
+
+### Color Contrast
+- WCAG AA compliance minimum
+- Don't rely solely on color for status (use icons too)
+
+### Focus Management
+- Clear focus indicators
+- Focus trap in modals
+- Return focus after modal close
+
+---
+
+## Performance Optimization
+
+### Initial Load
+- Lazy load below-the-fold widgets
+- Skeleton screens during fetch
+- Critical CSS inline
+
+### Data Fetching
+- Parallel API calls where possible
+- Cache reference data (roles, statuses)
+- Debounce search inputs (300ms)
+
+### Map Rendering
+- Marker clustering for > 50 markers
+- Viewport-based loading
+- Throttle zoom/pan events
+
+### Bundle Size
+- Code splitting by route
+- Lazy load heavy components (map, charts)
+- Tree shaking unused code
+
+---
+
+## Error Handling
+
+### Network Errors
+- Show toast notification
+- Retry button for failed requests
+- Offline indicator
+
+### API Errors
+- Display user-friendly error messages
+- Log errors for debugging
+- Fallback to cached data if available
+
+### Empty States
+- "No pending sales orders" with illustration
+- "All tickets assigned" success message
+- "No expenses to approve" with helpful tip
+
+---
+
+## Testing Recommendations
+
+### Unit Tests
+- Component rendering
+- User interactions (clicks, form submissions)
+- Data transformations
+
+### Integration Tests
+- API call sequences
+- State management
+- Navigation flows
+
+### E2E Tests
+- Critical user flows (assign ticket, approve expense)
+- Cross-browser compatibility
+- Mobile responsiveness
+
+---
+
+## Future Enhancements
+
+### Phase 2 Features
+- Real-time notifications (WebSockets)
+- Advanced analytics (charts, trends)
+- Customizable dashboard (drag-and-drop widgets)
+- Export reports (PDF, Excel)
+
+### Phase 3 Features
+- AI-powered assignment recommendations
+- Predictive inventory alerts
+- Automated expense approval rules
+- Voice commands for mobile
+
+---
+
+## Design Assets
+
+### Color Palette
+- **Primary:** #1976D2 (Blue)
+- **Success:** #4CAF50 (Green)
+- **Warning:** #FF9800 (Amber)
+- **Error:** #F44336 (Red)
+- **Info:** #2196F3 (Light Blue)
+
+### Typography
+- **Headings:** Inter, Roboto, or system font
+- **Body:** Same as headings
+- **Monospace:** Courier New (for IDs, codes)
+
+### Icons
+- Use consistent icon library (Material Icons, Feather, or Heroicons)
+- 24px for buttons, 16px for inline icons
+
+### Spacing
+- Base unit: 8px
+- Small: 8px, Medium: 16px, Large: 24px, XL: 32px
+
+---
+
+## Questions & Support
+
+For design questions:
+- UI/UX Lead: [Contact Info]
+- Design System: [Link to Figma/Storybook]
+
+For technical questions:
+- See `PM_DASHBOARD_API_REFERENCE.md`
+- Backend Team: [Contact Info]
+
+---
+
+**End of Document**

docs/api/dashboards/pm/QUICK_REFERENCE.md

@@ -0,0 +1,303 @@
+# PM Dashboard - Quick Reference
+
+**Quick lookup for common PM operations**
+
+---
+
+## 🎯 Dashboard Overview
+
+```
+GET /api/v1/analytics/platform-admin/dashboard
+→ All dashboard statistics in one call
+```
+
+---
+
+## 📋 Sales Orders
+
+| Action | Endpoint | Method |
+|--------|----------|--------|
+| List pending orders | `/sales-orders?pending_processing=true` | GET |
+| Get stats | `/sales-orders/stats` | GET |
+| Assign to region | `/sales-orders/{id}/assign-region` | POST |
+| Convert to ticket | `/sales-orders/{id}/promote` | POST |
+| Bulk convert | `/sales-orders/bulk-promote` | POST |
+
+---
+
+## 🎫 Tickets
+
+| Action | Endpoint | Method |
+|--------|----------|--------|
+| List all tickets | `/tickets` | GET |
+| Get stats | `/tickets/stats` | GET |
+| Get open tickets | `/tickets?status=open` | GET |
+| Get overdue | `/tickets?is_overdue=true` | GET |
+| Update ticket | `/tickets/{id}` | PUT |
+| Reschedule | `/tickets/{id}/reschedule` | POST |
+| Cancel | `/tickets/{id}/cancel` | POST |
+
+**Common Filters:**
+- `status`: open, assigned, in_progress, pending_review, completed, cancelled
+- `priority`: low, normal, high, urgent
+- `ticket_type`: installation, support, infrastructure
+- `project_region_id`: Filter by region
+
+---
+
+## 👥 Ticket Assignments
+
+| Action | Endpoint | Method |
+|--------|----------|--------|
+| List assignments | `/ticket-assignments` | GET |
+| Get available agents | `/ticket-assignments/available-agents?ticket_id={id}` | GET |
+| Assign ticket | `/ticket-assignments` | POST |
+| Reassign | `/ticket-assignments/{id}/reassign` | POST |
+
+---
+
+## 💰 Expenses
+
+| Action | Endpoint | Method |
+|--------|----------|--------|
+| List expenses | `/expenses` | GET |
+| Get stats | `/expenses/stats` | GET |
+| Get pending | `/expenses?approval_status=pending` | GET |
+| Approve/Reject | `/expenses/{id}/approve` | POST |
+| Mark paid | `/expenses/{id}/mark-paid` | POST |
+
+---
+
+## 💵 Finance
+
+| Action | Endpoint | Method |
+|--------|----------|--------|
+| List transactions | `/finance` | GET |
+| Get cash flow | `/finance/cash-flow/{project_id}` | GET |
+| Create transaction | `/finance` | POST |
+| Approve | `/finance/{id}/approve` | POST |
+
+---
+
+## 📄 Contractor Invoices
+
+| Action | Endpoint | Method |
+|--------|----------|--------|
+| List invoices | `/invoices` | GET |
+| Get unpaid | `/invoices?unpaid_only=true` | GET |
+| Create invoice | `/invoices` | POST |
+| Add line item | `/invoices/{id}/line-items` | POST |
+| Record payment | `/invoices/{id}/payments` | POST |
+| Change status | `/invoices/{id}/status` | POST |
+
+---
+
+## 📦 Inventory
+
+| Action | Endpoint | Method |
+|--------|----------|--------|
+| List main office | `/inventory` | GET |
+| Create batch | `/inventory` | POST |
+| List distributions | `/inventory/distributions` | GET |
+| Distribute to hub | `/inventory/distributions` | POST |
+| List assignments | `/inventory/assignments` | GET |
+
+---
+
+## 💼 Payroll
+
+| Action | Endpoint | Method |
+|--------|----------|--------|
+| List payroll | `/payroll` | GET |
+| Generate | `/payroll/generate` | POST |
+| Approve | `/payroll/{id}/approve` | POST |
+
+---
+
+## 🗓️ Timesheets
+
+| Action | Endpoint | Method |
+|--------|----------|--------|
+| List timesheets | `/timesheets` | GET |
+| Get stats | `/timesheets/stats` | GET |
+
+---
+
+## 👤 Users
+
+| Action | Endpoint | Method |
+|--------|----------|--------|
+| List users | `/users` | GET |
+| Search | `/users/search?q={query}` | GET |
+| Invite | `/invitations` | POST |
+
+---
+
+## 🗺️ Map & Location
+
+| Action | Endpoint | Method |
+|--------|----------|--------|
+| Get all map entities | `/map/entities?project_id={id}` | GET |
+| Get regional hubs | `/map/regions/{project_id}` | GET |
+| Get journey details | `/map/journey/{assignment_id}` | GET |
+| Find nearest hub | `/map/nearest-region` | GET |
+
+---
+
+## 🔔 Notifications
+
+| Action | Endpoint | Method |
+|--------|----------|--------|
+| List notifications | `/notifications` | GET |
+| Get unread count | `/notifications/unread-count` | GET |
+| Mark as read | `/notifications/{id}/read` | PUT |
+
+---
+
+## 🔐 Authentication
+
+```
+POST /api/v1/auth/refresh
+Body: { "refresh_token": "..." }
+→ Returns new access_token
+```
+
+**All requests require:**
+```
+Authorization: Bearer {access_token}
+```
+
+---
+
+## 📊 Common Response Patterns
+
+### List Response
+```json
+{
+  "items": [...],
+  "total": 150,
+  "skip": 0,
+  "limit": 50
+}
+```
+
+### Stats Response
+```json
+{
+  "total": 150,
+  "by_status": { "open": 20, "completed": 80 },
+  "by_type": { "installation": 100, "support": 50 }
+}
+```
+
+### Error Response
+```json
+{
+  "detail": "Error message"
+}
+```
+
+---
+
+## ⚡ Quick Workflows
+
+### Assign a Ticket
+```
+1. GET /ticket-assignments/available-agents?ticket_id={id}
+2. POST /ticket-assignments
+   Body: { "ticket_id": "...", "user_id": "..." }
+```
+
+### Convert Sales Order to Ticket
+```
+1. GET /sales-orders?pending_processing=true
+2. POST /sales-orders/{id}/promote
+   Body: { "priority": "normal", "scheduled_date": "..." }
+```
+
+### Approve Expense
+```
+1. GET /expenses?approval_status=pending
+2. POST /expenses/{id}/approve
+   Body: { "approved": true, "notes": "..." }
+```
+
+### Distribute Inventory
+```
+1. GET /inventory?project_id={id}
+2. POST /inventory/distributions
+   Body: { "inventory_id": "...", "project_region_id": "...", "quantity_distributed": 20 }
+```
+
+### Generate Payroll
+```
+1. GET /timesheets?from_date=...&to_date=...
+2. POST /payroll/generate
+   Body: { "project_id": "...", "period_start": "...", "period_end": "..." }
+```
+
+---
+
+## 🎨 Status Values
+
+### Ticket Status
+- `open` - Not assigned
+- `assigned` - Assigned to agent
+- `in_progress` - Agent working on it
+- `pending_review` - Awaiting review
+- `completed` - Done
+- `cancelled` - Cancelled
+
+### Sales Order Status
+- `pending` - Awaiting processing
+- `processed` - Converted to ticket
+- `cancelled` - Cancelled
+- `duplicate` - Marked as duplicate
+
+### Expense Approval Status
+- `pending` - Awaiting approval
+- `approved` - Approved
+- `rejected` - Rejected
+
+### Payment Status
+- `pending` - Not paid
+- `paid` - Paid
+
+---
+
+## 📅 Date Formats
+
+- **Date:** `YYYY-MM-DD` (e.g., `2025-01-20`)
+- **DateTime:** `YYYY-MM-DDTHH:MM:SSZ` (e.g., `2025-01-20T14:30:00Z`)
+- **Time Slots:** `morning`, `afternoon`, `evening`, `any`
+
+---
+
+## 🔢 Pagination
+
+Default: `skip=0&limit=50`
+
+Example: `/tickets?skip=0&limit=50`
+
+---
+
+## 🎯 Priority Levels
+
+- `low` - Can wait
+- `normal` - Standard priority
+- `high` - Important
+- `urgent` - Immediate attention
+
+---
+
+## 📱 Base URL
+
+```
+https://api.swiftops.example.com/api/v1
+```
+
+---
+
+**For detailed documentation, see:**
+- `PM_DASHBOARD_API_REFERENCE.md` - Full API details
+- `PM_DASHBOARD_DESIGN_GUIDE.md` - UX and design specs

docs/api/dashboards/pm/README.md

@@ -0,0 +1,376 @@
+# Project Manager Dashboard Documentation
+
+**Complete documentation package for building the PM dashboard**
+
+---
+
+## 📚 Documentation Overview
+
+This directory contains comprehensive documentation for implementing the Project Manager (PM) dashboard in the SwiftOps platform.
+
+### Documents in This Package
+
+1. **[PM_DASHBOARD_API_REFERENCE.md](./PM_DASHBOARD_API_REFERENCE.md)** ⭐ **START HERE**
+   - Complete API endpoint reference
+   - Request/response formats
+   - Query parameters and filters
+   - Authentication and error handling
+   - **Audience:** Frontend developers
+
+2. **[PM_DASHBOARD_DESIGN_GUIDE.md](./PM_DASHBOARD_DESIGN_GUIDE.md)**
+   - Dashboard layout and structure
+   - Component specifications
+   - User flows and interactions
+   - Responsive design guidelines
+   - **Audience:** UI/UX designers, frontend developers
+
+3. **[QUICK_REFERENCE.md](./QUICK_REFERENCE.md)**
+   - Cheat sheet for common operations
+   - Quick endpoint lookup
+   - Common workflows
+   - Status values and formats
+   - **Audience:** All team members
+
+---
+
+## 🎯 What is the PM Dashboard?
+
+The Project Manager dashboard is the **command center** for daily field service operations. It provides:
+
+- **Real-time visibility** across sales, operations, finance, and resources
+- **Action-oriented interface** for quick decision-making
+- **Geographic visualization** of field operations
+- **Approval workflows** for expenses, payroll, and invoices
+- **Resource management** for inventory and team allocation
+
+### Key Capabilities
+
+✅ Convert sales orders to work tickets  
+✅ Assign tickets to field agents  
+✅ Approve expenses and track payments  
+✅ Monitor inventory levels and distributions  
+✅ Generate payroll and contractor invoices  
+✅ Track agent locations and journeys on map  
+✅ View real-time operational metrics  
+
+---
+
+## 🚀 Getting Started
+
+### For Frontend Developers
+
+1. **Read the API Reference** - [PM_DASHBOARD_API_REFERENCE.md](./PM_DASHBOARD_API_REFERENCE.md)
+   - Understand available endpoints
+   - Review request/response formats
+   - Note authentication requirements
+
+2. **Review the Design Guide** - [PM_DASHBOARD_DESIGN_GUIDE.md](./PM_DASHBOARD_DESIGN_GUIDE.md)
+   - Understand dashboard layout
+   - Review component specifications
+   - Study user flows
+
+3. **Use the Quick Reference** - [QUICK_REFERENCE.md](./QUICK_REFERENCE.md)
+   - Keep handy during development
+   - Quick endpoint lookup
+   - Common workflow patterns
+
+### For UI/UX Designers
+
+1. **Start with Design Guide** - [PM_DASHBOARD_DESIGN_GUIDE.md](./PM_DASHBOARD_DESIGN_GUIDE.md)
+   - Dashboard structure and layout
+   - Component specifications
+   - User personas and workflows
+
+2. **Reference API capabilities** - [PM_DASHBOARD_API_REFERENCE.md](./PM_DASHBOARD_API_REFERENCE.md)
+   - Understand data availability
+   - Review filtering options
+   - Note computed fields
+
+### For Project Managers
+
+1. **Review Quick Reference** - [QUICK_REFERENCE.md](./QUICK_REFERENCE.md)
+   - Understand dashboard capabilities
+   - Review common workflows
+   - Provide feedback on priorities
+
+---
+
+## 📊 Dashboard Sections
+
+### 1. Today's Overview
+- Open tickets count
+- Active agents count
+- Overdue tickets alert
+- Pending expenses count
+
+### 2. Financial Snapshot
+- Cash position
+- Pending expenses
+- Unpaid invoices
+- Payroll obligations
+
+### 3. Quick Actions
+- Assign tickets
+- Approve expenses
+- Add inventory
+- Generate payroll
+- Create invoices
+- Add users
+
+### 4. Pending Sales Orders
+- List of orders awaiting conversion
+- Inline actions (assign region, convert to ticket)
+- Bulk conversion capability
+
+### 5. Active Tickets Map
+- Geographic visualization
+- Real-time agent locations
+- Journey tracking
+- Multi-layer filtering
+
+### 6. Inventory Status
+- Stock levels by equipment type
+- Low stock alerts
+- Distribution management
+
+### 7. Pending Approvals
+- Expenses awaiting approval
+- Payroll pending review
+- Draft invoices
+
+### 8. Team Status
+- Agent availability
+- Current assignments
+- Location tracking
+
+---
+
+## 🔑 Key API Endpoints
+
+### Dashboard Stats
+```
+GET /api/v1/analytics/platform-admin/dashboard
+```
+
+### Sales Orders
+```
+GET /api/v1/sales-orders?pending_processing=true
+POST /api/v1/sales-orders/{id}/promote
+```
+
+### Tickets
+```
+GET /api/v1/tickets?status=open
+GET /api/v1/tickets/stats
+POST /api/v1/ticket-assignments
+```
+
+### Expenses
+```
+GET /api/v1/expenses?approval_status=pending
+POST /api/v1/expenses/{id}/approve
+```
+
+### Map
+```
+GET /api/v1/map/entities?project_id={id}
+GET /api/v1/map/journey/{assignment_id}
+```
+
+**See [QUICK_REFERENCE.md](./QUICK_REFERENCE.md) for complete list**
+
+---
+
+## 🎨 Design Principles
+
+1. **Information at a Glance** - Critical metrics visible without scrolling
+2. **Action-Oriented** - Every metric has a corresponding action button
+3. **Context-Aware** - Show relevant data based on time, location, status
+4. **Progressive Disclosure** - Summary → Details ��� Actions
+5. **Real-Time Updates** - Live data for time-sensitive operations
+
+---
+
+## 🔄 Data Refresh Strategy
+
+### Real-Time (10-30 seconds)
+- Active ticket assignments
+- Agent locations on map
+- Pending approvals count
+
+### Periodic (1-5 minutes)
+- Dashboard statistics
+- Inventory levels
+- Financial metrics
+
+### On-Demand
+- After user actions
+- Manual refresh button
+- Page focus change
+
+---
+
+## 📱 Responsive Design
+
+### Desktop (> 1200px)
+- Full dashboard layout
+- All widgets visible
+- Comfortable map size
+
+### Tablet (768px - 1200px)
+- 2-column layout
+- Stacked widgets
+- Collapsible filters
+
+### Mobile (< 768px)
+- Single column
+- Stacked cards
+- Bottom navigation
+- Map accessible via tab
+
+---
+
+## 🔐 Authentication
+
+All API requests require Bearer token authentication:
+
+```
+Authorization: Bearer {access_token}
+```
+
+**Token Refresh:**
+```
+POST /api/v1/auth/refresh
+Body: { "refresh_token": "your_refresh_token" }
+```
+
+**See API Reference for details**
+
+---
+
+## ⚡ Performance Tips
+
+1. **Lazy load** below-the-fold widgets
+2. **Debounce** search inputs (300ms)
+3. **Cache** reference data (roles, statuses, regions)
+4. **Cluster** map markers when > 50 items
+5. **Parallel** API calls where possible
+6. **Skeleton screens** during data fetch
+
+---
+
+## 🧪 Testing Recommendations
+
+### Unit Tests
+- Component rendering
+- User interactions
+- Data transformations
+
+### Integration Tests
+- API call sequences
+- State management
+- Navigation flows
+
+### E2E Tests
+- Critical workflows (assign ticket, approve expense)
+- Cross-browser compatibility
+- Mobile responsiveness
+
+---
+
+## 📋 Implementation Checklist
+
+### Phase 1: Core Dashboard
+- [ ] Dashboard layout structure
+- [ ] Today's overview cards
+- [ ] Financial snapshot widget
+- [ ] Quick actions bar
+- [ ] Authentication integration
+
+### Phase 2: Operations
+- [ ] Pending sales orders widget
+- [ ] Ticket list and assignment
+- [ ] Expense approval workflow
+- [ ] Inventory status widget
+
+### Phase 3: Advanced Features
+- [ ] Interactive map view
+- [ ] Journey tracking
+- [ ] Payroll generation
+- [ ] Invoice management
+
+### Phase 4: Polish
+- [ ] Real-time updates
+- [ ] Responsive design
+- [ ] Error handling
+- [ ] Performance optimization
+
+---
+
+## 🐛 Troubleshooting
+
+### Common Issues
+
+**Issue:** API returns 401 Unauthorized  
+**Solution:** Check token expiration, refresh if needed
+
+**Issue:** Dashboard stats not loading  
+**Solution:** Verify user has PM role and project access
+
+**Issue:** Map markers not showing  
+**Solution:** Check entity_types parameter and data availability
+
+**Issue:** Slow performance  
+**Solution:** Implement lazy loading, reduce API call frequency
+
+---
+
+## 📞 Support & Resources
+
+### Documentation
+- **API Docs:** `/api/v1/docs` (Swagger UI)
+- **Base URL:** `https://api.swiftops.example.com`
+
+### Team Contacts
+- **Backend Team:** [Contact Info]
+- **Frontend Team:** [Contact Info]
+- **UI/UX Team:** [Contact Info]
+- **Product Manager:** [Contact Info]
+
+### Related Documentation
+- User Role Documentation: `/docs/api/user-profile/APP_MANAGEMENT_SYSTEM.md`
+- Authentication Guide: `/docs/AUTH_API_COMPLETE.md`
+- Finance API: `/docs/FINANCE_MANAGEMENT_IMPLEMENTATION.md`
+
+---
+
+## 🔄 Version History
+
+### Version 1.0 (2025-11-19)
+- Initial documentation release
+- Complete API reference
+- Design guide
+- Quick reference
+
+---
+
+## 📝 Contributing
+
+Found an issue or have suggestions?
+
+1. Check existing documentation
+2. Contact backend team lead
+3. Submit feedback with specific examples
+4. Include API endpoint and expected behavior
+
+---
+
+## 📄 License
+
+Internal documentation for SwiftOps platform development team.
+
+---
+
+**Last Updated:** 2025-11-19  
+**Maintained By:** SwiftOps Backend Team  
+**Status:** Active Development

docs/hflogs/runtimeerror.txt

@@ -1,627 +1,110 @@
-===== Application Startup at 2025-11-18 18:50:31 =====
+===== Application Startup at 2025-11-19 10:47:20 =====
 
-INFO:     Started server process [7]
-INFO:     Waiting for application startup.
-INFO: 2025-11-18T18:50:43 - app.main: ============================================================
-INFO: 2025-11-18T18:50:43 - app.main: 🚀 SwiftOps API v1.0.0 | PRODUCTION
-INFO: 2025-11-18T18:50:43 - app.main: ============================================================
-INFO: 2025-11-18T18:50:43 - app.main: 📦 Database:
-INFO: 2025-11-18T18:50:46 - app.main:    ✓ Connected | 42 tables | 13 users
-INFO: 2025-11-18T18:50:46 - app.main: 💾 Cache & Sessions:
-INFO: 2025-11-18T18:50:47 - app.services.otp_service: ✅ OTP Service initialized with Redis storage
-INFO: 2025-11-18T18:50:48 - app.main:    ✓ Redis: Connected
-INFO: 2025-11-18T18:50:48 - app.main: 🔌 External Services:
-INFO: 2025-11-18T18:50:49 - app.main:    ✓ Cloudinary: Connected
-INFO: 2025-11-18T18:50:49 - app.main:    ✓ Resend: Configured
-INFO: 2025-11-18T18:50:49 - app.main:    ✓ WASender: Connected
-INFO: 2025-11-18T18:50:49 - app.main:    ✓ Supabase: Connected | 6 buckets
-INFO: 2025-11-18T18:50:49 - app.main: ============================================================
-INFO: 2025-11-18T18:50:49 - app.main: ✅ Startup complete | Ready to serve requests
-INFO: 2025-11-18T18:50:49 - app.main: ============================================================
-INFO:     Application startup complete.
-INFO:     Uvicorn running on http://0.0.0.0:7860 (Press CTRL+C to quit)
-INFO:     10.16.24.73:60709 - "GET /health HTTP/1.1" 200 OK
-INFO:     10.16.42.67:57874 - "GET /health HTTP/1.1" 200 OK
-INFO:     10.16.42.67:12808 - "GET /health HTTP/1.1" 200 OK
-INFO:     10.16.42.67:12808 - "GET /health HTTP/1.1" 200 OK
-INFO:     10.16.4.177:42265 - "GET /health HTTP/1.1" 200 OK
-INFO:     10.16.24.73:50145 - "GET /health HTTP/1.1" 200 OK
-INFO:     10.16.42.67:6135 - "GET /health HTTP/1.1" 200 OK
-INFO:     10.16.4.177:42229 - "GET /health HTTP/1.1" 200 OK
-INFO:     10.16.24.73:1989 - "GET /health HTTP/1.1" 200 OK
-INFO:     10.16.42.67:50009 - "GET /health HTTP/1.1" 200 OK
-INFO:     10.16.42.67:50009 - "GET /health HTTP/1.1" 200 OK
-INFO:     10.16.24.73:4083 - "GET /health HTTP/1.1" 200 OK
-INFO:     10.16.2.183:3447 - "GET /health HTTP/1.1" 200 OK
-INFO:     10.16.2.183:54428 - "GET /health HTTP/1.1" 200 OK
-INFO:     10.16.24.73:55483 - "GET /health HTTP/1.1" 200 OK
-INFO: 2025-11-18T18:59:30 - app.core.supabase_auth: Session refreshed successfully
-INFO: 2025-11-18T18:59:31 - app.api.v1.auth: ✅ Token refreshed successfully for: lewiskimaru01@gmail.com
-INFO:     10.16.24.73:31772 - "POST /api/v1/auth/refresh-token HTTP/1.1" 200 OK
-ERROR: 2025-11-18T18:59:31 - app.core.supabase_auth: Get user error: invalid JWT: unable to parse or verify signature, token has invalid claims: token is expired
-WARNING: 2025-11-18T18:59:31 - app.api.deps: Invalid or expired token
-INFO:     10.16.2.183:36719 - "GET /api/v1/auth/me HTTP/1.1" 401 Unauthorized
-INFO:     10.16.24.73:46966 - "GET /health HTTP/1.1" 200 OK
-INFO:     10.16.42.67:1882 - "GET /api/v1/auth/me HTTP/1.1" 200 OK
-INFO:     10.16.42.67:28447 - "GET /api/v1/auth/me/preferences HTTP/1.1" 200 OK
-INFO:     10.16.42.67:23737 - "GET /api/v1/auth/me/preferences/available-apps HTTP/1.1" 200 OK
-INFO:     10.16.42.67:1882 - "GET /api/v1/users?skip=0&limit=20 HTTP/1.1" 200 OK
-INFO:     10.16.2.183:51732 - "GET /api/v1/clients?skip=0&limit=20 HTTP/1.1" 200 OK
-INFO:     10.16.4.177:51359 - "GET /api/v1/contractors?skip=0&limit=20 HTTP/1.1" 200 OK
-INFO:     10.16.42.67:1882 - "GET /api/v1/audit-logs?skip=0&limit=20 HTTP/1.1" 200 OK
-INFO:     10.16.4.177:51359 - "GET /health HTTP/1.1" 200 OK
-INFO:     10.16.42.67:11888 - "GET /health HTTP/1.1" 200 OK
-INFO:     10.16.24.73:2931 - "GET /health HTTP/1.1" 200 OK
-INFO:     10.16.4.177:4762 - "GET /health HTTP/1.1" 200 OK
-INFO:     10.16.42.67:34846 - "GET /health HTTP/1.1" 200 OK
-INFO:     10.16.42.67:59242 - "GET /health HTTP/1.1" 200 OK
-INFO:     10.16.4.177:43996 - "GET /health HTTP/1.1" 200 OK
-INFO:     10.16.4.177:35128 - "GET /health HTTP/1.1" 200 OK
-INFO:     10.16.24.73:26057 - "GET /health HTTP/1.1" 200 OK
-INFO:     10.16.24.73:23106 - "GET /health HTTP/1.1" 200 OK
-INFO:     10.16.24.73:44037 - "GET /health HTTP/1.1" 200 OK
-INFO:     10.16.4.177:60432 - "GET /health HTTP/1.1" 200 OK
-INFO:     10.16.4.177:46955 - "GET /health HTTP/1.1" 200 OK
-INFO:     10.16.24.73:13655 - "GET /api/v1/auth/me/preferences/available-apps HTTP/1.1" 200 OK
-INFO:     10.16.4.177:50943 - "GET /api/v1/auth/me HTTP/1.1" 200 OK
-INFO:     10.16.2.183:33387 - "GET /api/v1/auth/me/preferences HTTP/1.1" 200 OK
-INFO:     10.16.4.177:50943 - "GET /api/v1/clients?skip=0&limit=20 HTTP/1.1" 200 OK
-INFO:     10.16.2.183:33387 - "GET /api/v1/users?skip=0&limit=20 HTTP/1.1" 200 OK
-INFO:     10.16.42.67:14600 - "GET /api/v1/contractors?skip=0&limit=20 HTTP/1.1" 200 OK
-INFO:     10.16.42.67:14600 - "GET /api/v1/audit-logs?skip=0&limit=20 HTTP/1.1" 200 OK
-INFO:     10.16.2.183:53410 - "GET /health HTTP/1.1" 200 OK
-INFO:     10.16.4.177:47228 - "GET /health HTTP/1.1" 200 OK
-INFO:     10.16.42.67:10892 - "GET /api/v1/auth/me HTTP/1.1" 200 OK
-INFO:     10.16.2.183:11836 - "GET /health HTTP/1.1" 200 OK
-INFO:     10.16.4.177:54424 - "GET /api/v1/auth/me/preferences HTTP/1.1" 200 OK
-INFO:     10.16.42.67:33024 - "GET /api/v1/auth/me/preferences/available-apps HTTP/1.1" 200 OK
-INFO:     10.16.42.67:10892 - "GET /api/v1/contractors?skip=0&limit=20 HTTP/1.1" 200 OK
-INFO:     10.16.2.183:40462 - "GET /api/v1/clients?skip=0&limit=20 HTTP/1.1" 200 OK
-INFO:     10.16.4.177:27449 - "GET /api/v1/users?skip=0&limit=20 HTTP/1.1" 200 OK
-INFO:     10.16.24.73:15350 - "GET /api/v1/audit-logs?skip=0&limit=20 HTTP/1.1" 200 OK
-INFO:     10.16.4.177:54920 - "GET /health HTTP/1.1" 200 OK
-INFO:     10.16.32.101:9894 - "GET /health HTTP/1.1" 200 OK
-INFO:     10.16.42.67:47892 - "GET /health HTTP/1.1" 200 OK
-INFO:     10.16.2.183:50070 - "GET /health HTTP/1.1" 200 OK
-INFO:     10.16.32.101:32108 - "GET /health HTTP/1.1" 200 OK
-INFO:     10.16.2.183:62613 - "GET /health HTTP/1.1" 200 OK
-INFO:     10.16.32.101:33073 - "GET /health HTTP/1.1" 200 OK
-INFO:     10.16.2.183:17374 - "GET /health HTTP/1.1" 200 OK
-INFO:     10.16.2.183:39173 - "GET /health HTTP/1.1" 200 OK
-INFO:     10.16.2.183:37085 - "GET /health HTTP/1.1" 200 OK
-INFO:     10.16.24.73:9390 - "GET /health HTTP/1.1" 200 OK
-INFO:     10.16.2.183:55660 - "GET /health HTTP/1.1" 200 OK
-INFO:     10.16.2.183:55305 - "GET /health HTTP/1.1" 200 OK
-INFO:     10.16.24.73:59709 - "GET /health HTTP/1.1" 200 OK
-INFO:     10.16.42.67:28146 - "GET /api/v1/auth/me HTTP/1.1" 200 OK
-INFO:     10.16.2.183:8887 - "GET /health HTTP/1.1" 200 OK
-INFO:     10.16.32.101:28853 - "GET /api/v1/auth/me/preferences HTTP/1.1" 200 OK
-INFO:     10.16.32.101:22519 - "GET /api/v1/auth/me/preferences/available-apps HTTP/1.1" 200 OK
-INFO:     10.16.24.73:40290 - "GET /api/v1/users?skip=0&limit=20 HTTP/1.1" 200 OK
-INFO:     10.16.2.183:38399 - "GET /api/v1/clients?skip=0&limit=20 HTTP/1.1" 200 OK
-INFO:     10.16.4.177:33495 - "GET /api/v1/contractors?skip=0&limit=20 HTTP/1.1" 200 OK
-INFO:     10.16.2.183:38399 - "GET /api/v1/audit-logs?skip=0&limit=20 HTTP/1.1" 200 OK
-INFO:     10.16.24.73:65237 - "GET /health HTTP/1.1" 200 OK
-INFO: 2025-11-18T19:09:20 - app.services.audit_service: Audit log created: update on user_preferences by lewiskimaru01@gmail.com
-INFO: 2025-11-18T19:09:20 - app.api.v1.auth: Preferences updated for user: lewiskimaru01@gmail.com
-INFO:     10.16.4.177:19903 - "PUT /api/v1/auth/me/preferences HTTP/1.1" 200 OK
-INFO:     10.16.4.177:1242 - "GET /health HTTP/1.1" 200 OK
-INFO:     10.16.4.177:56763 - "GET /health HTTP/1.1" 200 OK
-INFO:     10.16.24.73:10443 - "GET /health HTTP/1.1" 200 OK
-INFO:     10.16.32.101:21895 - "GET /health HTTP/1.1" 200 OK
-INFO:     10.16.42.67:42642 - "GET /health HTTP/1.1" 200 OK
-INFO:     10.16.2.183:24496 - "GET /health HTTP/1.1" 200 OK
-INFO:     10.16.2.183:3350 - "GET /health HTTP/1.1" 200 OK
-INFO:     10.16.4.177:2901 - "GET /health HTTP/1.1" 200 OK
-INFO:     10.16.2.183:35947 - "GET /health HTTP/1.1" 200 OK
-INFO:     10.16.24.73:34289 - "GET /health HTTP/1.1" 200 OK
-INFO:     10.16.2.183:1049 - "GET /health HTTP/1.1" 200 OK
-INFO:     10.16.4.177:35653 - "GET /health HTTP/1.1" 200 OK
-INFO:     10.16.2.183:51150 - "GET /health HTTP/1.1" 200 OK
-INFO:     10.16.4.177:43279 - "GET /health HTTP/1.1" 200 OK
-INFO:     10.16.42.67:11310 - "GET /health HTTP/1.1" 200 OK
-INFO:     10.16.24.73:35037 - "GET /health HTTP/1.1" 200 OK
-INFO:     10.16.24.73:54078 - "GET /health HTTP/1.1" 200 OK
-INFO:     10.16.2.183:9083 - "GET /health HTTP/1.1" 200 OK
-INFO:     10.16.2.183:45466 - "GET /health HTTP/1.1" 200 OK
-INFO:     10.16.2.183:8925 - "GET /health HTTP/1.1" 200 OK
-INFO:     10.16.42.67:43405 - "GET /health HTTP/1.1" 200 OK
-INFO:     10.16.42.67:26416 - "GET /health HTTP/1.1" 200 OK
-INFO:     10.16.24.73:51168 - "GET /health HTTP/1.1" 200 OK
-INFO:     10.16.4.177:23684 - "GET /health HTTP/1.1" 200 OK
-INFO:     10.16.42.67:45875 - "GET /health HTTP/1.1" 200 OK
-INFO:     10.16.42.67:26455 - "GET /health HTTP/1.1" 200 OK
-INFO:     10.16.24.73:1362 - "GET /api/v1/auth/me HTTP/1.1" 200 OK
-INFO:     10.16.24.73:1362 - "GET /api/v1/users?skip=0&limit=20 HTTP/1.1" 200 OK
-INFO:     10.16.24.73:25500 - "GET /api/v1/contractors?skip=0&limit=20 HTTP/1.1" 200 OK
-INFO:     10.16.42.67:23487 - "GET /api/v1/clients?skip=0&limit=20 HTTP/1.1" 200 OK
-INFO:     10.16.2.183:24873 - "GET /health HTTP/1.1" 200 OK
-INFO:     10.16.4.177:28689 - "GET /api/v1/audit-logs?skip=0&limit=20 HTTP/1.1" 200 OK
-INFO:     10.16.2.183:28579 - "GET /health HTTP/1.1" 200 OK
-INFO:     10.16.42.67:52849 - "GET /health HTTP/1.1" 200 OK
-INFO:     10.16.42.67:62755 - "GET /health HTTP/1.1" 200 OK
-INFO:     10.16.24.73:28385 - "GET /health HTTP/1.1" 200 OK
-INFO:     10.16.42.67:31797 - "GET /health HTTP/1.1" 200 OK
-INFO:     10.16.2.183:39394 - "GET /health HTTP/1.1" 200 OK
-INFO:     10.16.42.67:24134 - "GET /health HTTP/1.1" 200 OK
-INFO:     10.16.24.73:36305 - "GET /health HTTP/1.1" 200 OK
-INFO:     10.16.42.67:52657 - "GET /health HTTP/1.1" 200 OK
-INFO:     10.16.2.183:20544 - "GET /health HTTP/1.1" 200 OK
-INFO:     10.16.2.183:4596 - "GET /health HTTP/1.1" 200 OK
-INFO:     10.16.24.73:39932 - "GET /health HTTP/1.1" 200 OK
-INFO:     10.16.2.183:33709 - "GET /health HTTP/1.1" 200 OK
-INFO:     10.16.4.177:11790 - "GET /health HTTP/1.1" 200 OK
-INFO:     10.16.32.101:34312 - "GET /health HTTP/1.1" 200 OK
-INFO:     10.16.42.67:1313 - "GET /health HTTP/1.1" 200 OK
-INFO:     10.16.24.73:63949 - "GET /health HTTP/1.1" 200 OK
-INFO:     10.16.4.177:5892 - "GET /health HTTP/1.1" 200 OK
-INFO:     10.16.2.183:25020 - "GET /health HTTP/1.1" 200 OK
-INFO:     10.16.2.183:31384 - "GET /health HTTP/1.1" 200 OK
-INFO:     10.16.32.101:52843 - "GET /health HTTP/1.1" 200 OK
-INFO:     10.16.32.101:52843 - "GET /health HTTP/1.1" 200 OK
-INFO:     10.16.32.101:23243 - "GET /health HTTP/1.1" 200 OK
-INFO:     10.16.4.177:46110 - "GET /health HTTP/1.1" 200 OK
-INFO:     10.16.24.73:4614 - "GET /health HTTP/1.1" 200 OK
-INFO:     10.16.24.73:31206 - "GET /health HTTP/1.1" 200 OK
-INFO:     10.16.32.101:30230 - "GET /health HTTP/1.1" 200 OK
-INFO:     10.16.42.67:53286 - "GET /health HTTP/1.1" 200 OK
-INFO:     10.16.4.177:10592 - "GET /health HTTP/1.1" 200 OK
-INFO:     10.16.42.67:31196 - "GET /health HTTP/1.1" 200 OK
-INFO:     10.16.2.183:30179 - "GET /health HTTP/1.1" 200 OK
-INFO:     10.16.4.177:13538 - "GET /health HTTP/1.1" 200 OK
-INFO:     10.16.42.67:33157 - "GET /health HTTP/1.1" 200 OK
-INFO:     10.16.24.73:46396 - "GET /health HTTP/1.1" 200 OK
-INFO:     10.16.2.183:1408 - "GET /api/v1/auth/me/preferences/available-apps HTTP/1.1" 403 Forbidden
-INFO:     10.16.4.177:56761 - "GET /health HTTP/1.1" 200 OK
-INFO:     10.16.4.177:46932 - "GET /health HTTP/1.1" 200 OK
-INFO:     10.16.42.67:59371 - "GET /health HTTP/1.1" 200 OK
-INFO:     10.16.2.183:24702 - "GET /health HTTP/1.1" 200 OK
-INFO:     10.16.42.67:44719 - "GET /health HTTP/1.1" 200 OK
-INFO:     10.16.24.73:31374 - "GET /health HTTP/1.1" 200 OK
-INFO:     10.16.2.183:21887 - "GET /health HTTP/1.1" 200 OK
-INFO:     10.16.24.73:2894 - "GET /health HTTP/1.1" 200 OK
-INFO:     10.16.4.177:45637 - "GET /health HTTP/1.1" 200 OK
-INFO:     10.16.24.73:28334 - "GET /health HTTP/1.1" 200 OK
-INFO:     10.16.24.73:45702 - "GET / HTTP/1.1" 200 OK
-INFO:     10.16.42.67:46200 - "GET /health HTTP/1.1" 200 OK
-INFO:     10.16.42.67:26422 - "GET /health HTTP/1.1" 200 OK
-INFO: 2025-11-18T19:55:46 - app.core.supabase_auth: Session refreshed successfully
-INFO: 2025-11-18T19:55:47 - app.api.v1.auth: ✅ Token refreshed successfully for: lewiskimaru01@gmail.com
-INFO:     10.16.42.67:42821 - "POST /api/v1/auth/refresh-token HTTP/1.1" 200 OK
-INFO:     10.16.42.67:45316 - "GET /health HTTP/1.1" 200 OK
-INFO:     10.16.4.177:52344 - "GET /health HTTP/1.1" 200 OK
-INFO:     10.16.24.73:26923 - "GET /health HTTP/1.1" 200 OK
-INFO:     10.16.2.183:10006 - "GET /health HTTP/1.1" 200 OK
-INFO:     10.16.42.67:28896 - "GET /health HTTP/1.1" 200 OK
-INFO:     10.16.24.73:11808 - "GET /health HTTP/1.1" 200 OK
-INFO:     10.16.4.177:25799 - "GET /health HTTP/1.1" 200 OK
-INFO:     10.16.24.73:61041 - "GET /health HTTP/1.1" 200 OK
-INFO:     10.16.24.73:3530 - "GET /health HTTP/1.1" 200 OK
-INFO:     10.16.4.177:46326 - "GET /health HTTP/1.1" 200 OK
-INFO:     10.16.24.73:6918 - "GET /health HTTP/1.1" 200 OK
-INFO:     10.16.4.177:35282 - "GET /health HTTP/1.1" 200 OK
-INFO:     10.16.4.177:12323 - "GET /health HTTP/1.1" 200 OK
-INFO:     10.16.42.67:3473 - "GET /health HTTP/1.1" 200 OK
-INFO:     10.16.24.73:36480 - "GET /health HTTP/1.1" 200 OK
-INFO:     10.16.2.183:25507 - "GET /health HTTP/1.1" 200 OK
-INFO:     10.16.24.73:17019 - "GET /health HTTP/1.1" 200 OK
-INFO:     10.16.2.183:25230 - "GET /health HTTP/1.1" 200 OK
-INFO:     10.16.42.67:40643 - "GET /health HTTP/1.1" 200 OK
-INFO:     10.16.4.177:56906 - "GET /health HTTP/1.1" 200 OK
-INFO:     10.16.4.177:43249 - "GET /health HTTP/1.1" 200 OK
-INFO:     10.16.24.73:23472 - "GET /health HTTP/1.1" 200 OK
-INFO:     10.16.24.73:35057 - "GET /health HTTP/1.1" 200 OK
-INFO:     10.16.17.175:56973 - "GET /health HTTP/1.1" 200 OK
-ERROR: 2025-11-18T19:56:11 - app.core.supabase_auth: Get user error: invalid JWT: unable to parse or verify signature, token has invalid claims: token is expired
-WARNING: 2025-11-18T19:56:11 - app.api.deps: Invalid or expired token
-ERROR: 2025-11-18T19:56:12 - app.core.supabase_auth: Get user error: invalid JWT: unable to parse or verify signature, token has invalid claims: token is expired
-WARNING: 2025-11-18T19:56:12 - app.api.deps: Invalid or expired token
-INFO:     10.16.42.67:21176 - "GET /api/v1/contractors?skip=0&limit=50 HTTP/1.1" 401 Unauthorized
-INFO:     10.16.4.177:10227 - "GET /api/v1/clients?skip=0&limit=50 HTTP/1.1" 401 Unauthorized
-INFO:     10.16.4.177:58943 - "GET /health HTTP/1.1" 200 OK
-INFO:     10.16.42.67:10300 - "GET /health HTTP/1.1" 200 OK
-INFO:     10.16.4.177:58943 - "GET /api/v1/contractors?skip=0&limit=50 HTTP/1.1" 200 OK
-INFO:     10.16.4.177:10227 - "GET /api/v1/clients?skip=0&limit=50 HTTP/1.1" 200 OK
-INFO:     10.16.2.183:57778 - "GET /health HTTP/1.1" 200 OK
-INFO:     10.16.2.183:41718 - "GET /health HTTP/1.1" 200 OK
-INFO:     10.16.17.175:58682 - "GET /health HTTP/1.1" 200 OK
-INFO:     10.16.24.73:14242 - "GET /health HTTP/1.1" 200 OK
-INFO:     10.16.42.67:50622 - "GET /health HTTP/1.1" 200 OK
-INFO:     10.16.24.73:32216 - "GET /health HTTP/1.1" 200 OK
-INFO:     10.16.42.67:64263 - "GET /health HTTP/1.1" 200 OK
-INFO:     10.16.4.177:56807 - "GET /health HTTP/1.1" 200 OK
-INFO:     10.16.2.183:65229 - "GET /health HTTP/1.1" 200 OK
-INFO:     10.16.2.183:21119 - "GET /health HTTP/1.1" 200 OK
-INFO:     10.16.24.73:54186 - "GET /health HTTP/1.1" 200 OK
-INFO:     10.16.4.177:9018 - "GET /health HTTP/1.1" 200 OK
-INFO:     10.16.42.67:25163 - "GET /health HTTP/1.1" 200 OK
-INFO:     10.16.2.183:30343 - "GET /health HTTP/1.1" 200 OK
-INFO:     10.16.4.177:53427 - "GET /health HTTP/1.1" 200 OK
-INFO:     10.16.4.177:53427 - "GET /api/v1/auth/me HTTP/1.1" 200 OK
-INFO:     10.16.4.177:53427 - "GET /api/v1/clients?skip=0&limit=20 HTTP/1.1" 200 OK
-INFO:     10.16.17.175:29023 - "GET /api/v1/contractors?skip=0&limit=20 HTTP/1.1" 200 OK
-INFO:     10.16.4.177:59479 - "GET /api/v1/users?skip=0&limit=20 HTTP/1.1" 200 OK
-INFO:     10.16.17.175:29023 - "GET /api/v1/audit-logs?skip=0&limit=20 HTTP/1.1" 200 OK
-INFO:     10.16.4.177:31683 - "GET /health HTTP/1.1" 200 OK
-INFO:     10.16.24.73:62343 - "GET /api/v1/users?skip=0&limit=50 HTTP/1.1" 200 OK
-INFO:     10.16.4.177:13211 - "GET /api/v1/audit-logs?skip=0&limit=50 HTTP/1.1" 200 OK
-INFO:     10.16.2.183:47811 - "GET /health HTTP/1.1" 200 OK
-INFO:     10.16.42.67:9644 - "GET /health HTTP/1.1" 200 OK
-INFO:     10.16.4.177:45860 - "GET /health HTTP/1.1" 200 OK
-INFO:     10.16.42.67:45768 - "GET /health HTTP/1.1" 200 OK
-INFO:     10.16.4.177:63910 - "GET /health HTTP/1.1" 200 OK
-INFO:     10.16.24.73:28357 - "GET /api/v1/auth/me HTTP/1.1" 200 OK
-INFO:     10.16.42.67:1230 - "GET /health HTTP/1.1" 200 OK
-INFO:     10.16.4.177:21445 - "GET /api/v1/auth/me/preferences HTTP/1.1" 200 OK
-INFO:     10.16.24.73:50132 - "GET /api/v1/auth/me/preferences/available-apps HTTP/1.1" 200 OK
-INFO:     10.16.42.67:1230 - "GET /api/v1/audit-logs?skip=0&limit=50 HTTP/1.1" 200 OK
-INFO:     10.16.4.177:43720 - "GET /health HTTP/1.1" 200 OK
-INFO:     10.16.4.177:56844 - "GET /health HTTP/1.1" 200 OK
-INFO:     10.16.4.177:3583 - "GET /health HTTP/1.1" 200 OK
-INFO:     10.16.24.73:10758 - "GET /health HTTP/1.1" 200 OK
-INFO:     10.16.4.177:59687 - "GET /health HTTP/1.1" 200 OK
-INFO:     10.16.24.73:10221 - "GET /health HTTP/1.1" 200 OK
-INFO:     10.16.24.73:50998 - "GET /health HTTP/1.1" 200 OK
-INFO:     10.16.4.177:13202 - "GET /health HTTP/1.1" 200 OK
-INFO:     10.16.2.183:31672 - "GET /health HTTP/1.1" 200 OK
-INFO:     10.16.17.175:20301 - "GET /health HTTP/1.1" 200 OK
-INFO:     10.16.4.177:13530 - "GET /health HTTP/1.1" 200 OK
-INFO:     10.16.2.183:46734 - "GET /health HTTP/1.1" 200 OK
-INFO:     10.16.4.177:24139 - "GET /health HTTP/1.1" 200 OK
-INFO:     10.16.17.175:36330 - "GET /health HTTP/1.1" 200 OK
-INFO:     10.16.2.183:1526 - "GET /health HTTP/1.1" 200 OK
-INFO:     10.16.4.177:46414 - "GET /health HTTP/1.1" 200 OK
-INFO:     10.16.42.67:42359 - "GET /health HTTP/1.1" 200 OK
-INFO:     10.16.42.67:27906 - "GET /health HTTP/1.1" 200 OK
-INFO:     10.16.42.67:15813 - "GET /health HTTP/1.1" 200 OK
-INFO:     10.16.42.67:46955 - "GET /health HTTP/1.1" 200 OK
-INFO:     10.16.42.67:65132 - "GET /health HTTP/1.1" 200 OK
-INFO:     10.16.42.67:31438 - "GET /health HTTP/1.1" 200 OK
-INFO:     10.16.42.67:30436 - "GET /health HTTP/1.1" 200 OK
-INFO:     10.16.2.183:33655 - "GET /health HTTP/1.1" 200 OK
-INFO:     10.16.42.67:63505 - "GET /health HTTP/1.1" 200 OK
-INFO:     10.16.42.67:31088 - "GET /health HTTP/1.1" 200 OK
-INFO:     10.16.2.183:38008 - "GET /api/v1/contractors?skip=0&limit=50 HTTP/1.1" 200 OK
-INFO:     10.16.4.177:62441 - "GET /api/v1/clients?skip=0&limit=50 HTTP/1.1" 200 OK
-INFO:     10.16.17.175:36193 - "GET /health HTTP/1.1" 200 OK
-INFO:     10.16.17.175:44411 - "GET /api/v1/users?skip=0&limit=50 HTTP/1.1" 200 OK
-INFO:     10.16.2.183:29830 - "GET /health HTTP/1.1" 200 OK
-INFO:     10.16.2.183:60280 - "GET /api/v1/users?skip=0&limit=20 HTTP/1.1" 200 OK
-INFO:     10.16.24.73:28744 - "GET /api/v1/contractors?skip=0&limit=20 HTTP/1.1" 200 OK
-INFO:     10.16.4.177:29046 - "GET /api/v1/clients?skip=0&limit=20 HTTP/1.1" 200 OK
-INFO:     10.16.2.183:60280 - "GET /api/v1/audit-logs?skip=0&limit=20 HTTP/1.1" 200 OK
-INFO:     10.16.2.183:54610 - "GET /health HTTP/1.1" 200 OK
-INFO:     10.16.24.73:13586 - "GET /health HTTP/1.1" 200 OK
-INFO:     10.16.2.183:55737 - "GET /health HTTP/1.1" 200 OK
-INFO:     10.16.24.73:63158 - "GET /health HTTP/1.1" 200 OK
-INFO:     10.16.4.177:13754 - "GET /health HTTP/1.1" 200 OK
-INFO:     10.16.24.73:30613 - "GET /health HTTP/1.1" 200 OK
-INFO:     10.16.4.177:29811 - "GET /health HTTP/1.1" 200 OK
-INFO:     10.16.2.183:33733 - "GET /health HTTP/1.1" 200 OK
-INFO:     10.16.2.183:33983 - "GET /health HTTP/1.1" 200 OK
-INFO:     10.16.24.73:22716 - "GET /health HTTP/1.1" 200 OK
-INFO:     10.16.2.183:42607 - "GET /health HTTP/1.1" 200 OK
-INFO:     10.16.2.183:28296 - "GET /health HTTP/1.1" 200 OK
-INFO:     10.16.42.67:2829 - "GET /health HTTP/1.1" 200 OK
-INFO:     10.16.24.73:45531 - "GET /health HTTP/1.1" 200 OK
-INFO:     10.16.42.67:44633 - "GET /health HTTP/1.1" 200 OK
-INFO:     10.16.24.73:47194 - "GET /health HTTP/1.1" 200 OK
-INFO: 2025-11-18T20:23:08 - app.core.supabase_auth: User signed in successfully: lewiskimaru01@gmail.com
-INFO: 2025-11-18T20:23:10 - app.services.audit_service: Audit log created: login on auth by lewiskimaru01@gmail.com
-INFO: 2025-11-18T20:23:10 - app.api.v1.auth: User logged in successfully: lewiskimaru01@gmail.com
-INFO:     10.16.42.67:36053 - "POST /api/v1/auth/login HTTP/1.1" 200 OK
-INFO:     10.16.2.183:50123 - "GET /api/v1/auth/me HTTP/1.1" 200 OK
-INFO:     10.16.2.183:50123 - "GET /api/v1/clients?skip=0&limit=20 HTTP/1.1" 200 OK
-INFO:     10.16.4.177:35016 - "GET /api/v1/contractors?skip=0&limit=20 HTTP/1.1" 200 OK
-INFO:     10.16.4.177:50387 - "GET /api/v1/users?skip=0&limit=20 HTTP/1.1" 200 OK
-INFO:     10.16.4.177:50387 - "GET /api/v1/audit-logs?skip=0&limit=20 HTTP/1.1" 200 OK
-INFO:     10.16.24.73:39787 - "GET /health HTTP/1.1" 200 OK
-INFO:     10.16.42.67:7567 - "GET /health HTTP/1.1" 200 OK
-INFO:     10.16.42.67:38182 - "GET /health HTTP/1.1" 200 OK
-INFO:     10.16.2.183:18679 - "GET /health HTTP/1.1" 200 OK
-INFO:     10.16.42.67:25826 - "GET /health HTTP/1.1" 200 OK
-INFO:     10.16.42.67:38562 - "GET /health HTTP/1.1" 200 OK
-INFO:     10.16.24.73:40955 - "GET /health HTTP/1.1" 200 OK
-INFO:     10.16.2.183:7240 - "GET /health HTTP/1.1" 200 OK
-INFO:     10.16.4.177:1198 - "GET /health HTTP/1.1" 200 OK
-INFO:     10.16.4.177:26804 - "GET /health HTTP/1.1" 200 OK
-INFO:     10.16.24.73:25835 - "GET /health HTTP/1.1" 200 OK
-INFO:     10.16.24.73:58339 - "GET /health HTTP/1.1" 200 OK
-INFO:     10.16.4.177:4533 - "GET /health HTTP/1.1" 200 OK
-INFO:     10.16.24.73:61483 - "GET /health HTTP/1.1" 200 OK
-INFO:     10.16.4.177:20828 - "GET /health HTTP/1.1" 200 OK
-INFO:     10.16.24.73:58786 - "GET /health HTTP/1.1" 200 OK
-INFO:     10.16.2.183:18946 - "GET /health HTTP/1.1" 200 OK
-INFO:     10.16.24.73:35647 - "GET /health HTTP/1.1" 200 OK
-INFO:     10.16.2.183:1081 - "GET /health HTTP/1.1" 200 OK
-INFO:     10.16.4.177:52734 - "GET /health HTTP/1.1" 200 OK
-INFO:     10.16.24.73:2465 - "GET /health HTTP/1.1" 200 OK
-INFO:     10.16.42.67:59547 - "GET /health HTTP/1.1" 200 OK
-INFO:     10.16.42.67:14987 - "GET /health HTTP/1.1" 200 OK
-INFO:     10.16.2.183:8051 - "GET /health HTTP/1.1" 200 OK
-INFO:     10.16.2.183:52270 - "GET /health HTTP/1.1" 200 OK
-INFO:     10.16.2.183:52799 - "GET /health HTTP/1.1" 200 OK
-INFO:     10.16.42.67:23702 - "GET /health HTTP/1.1" 200 OK
-INFO:     10.16.24.73:24357 - "GET /health HTTP/1.1" 200 OK
-INFO:     10.16.42.67:58261 - "GET /health HTTP/1.1" 200 OK
-INFO:     10.16.24.73:51569 - "GET /health HTTP/1.1" 200 OK
-INFO:     10.16.24.73:32527 - "GET /health HTTP/1.1" 200 OK
-INFO:     10.16.2.183:1599 - "GET /health HTTP/1.1" 200 OK
-INFO:     10.16.24.73:12838 - "GET /health HTTP/1.1" 200 OK
-INFO:     10.16.2.183:15752 - "GET /health HTTP/1.1" 200 OK
-INFO:     10.16.2.183:36166 - "GET /health HTTP/1.1" 200 OK
-INFO:     10.16.24.73:39485 - "GET /health HTTP/1.1" 200 OK
-INFO:     10.16.4.177:65051 - "GET /health HTTP/1.1" 200 OK
-INFO:     10.16.2.183:34587 - "GET /health HTTP/1.1" 200 OK
-INFO:     10.16.2.183:13415 - "GET /api/v1/users?skip=0&limit=20 HTTP/1.1" 200 OK
-INFO:     10.16.42.67:3804 - "GET /api/v1/contractors?skip=0&limit=20 HTTP/1.1" 200 OK
-INFO:     10.16.4.177:9240 - "GET /health HTTP/1.1" 200 OK
-INFO:     10.16.2.183:50707 - "GET /api/v1/clients?skip=0&limit=20 HTTP/1.1" 200 OK
-INFO:     10.16.2.183:13415 - "GET /api/v1/contractors?skip=0&limit=20 HTTP/1.1" 200 OK
-INFO:     10.16.4.177:26930 - "GET /api/v1/users?skip=0&limit=20 HTTP/1.1" 200 OK
-INFO:     10.16.42.67:3804 - "GET /api/v1/clients?skip=0&limit=20 HTTP/1.1" 200 OK
-INFO:     10.16.2.183:13415 - "GET /api/v1/audit-logs?skip=0&limit=20 HTTP/1.1" 200 OK
-INFO:     10.16.24.73:3887 - "GET /api/v1/contractors?skip=0&limit=20 HTTP/1.1" 200 OK
-INFO:     10.16.2.183:50707 - "GET /api/v1/users?skip=0&limit=20 HTTP/1.1" 200 OK
-INFO:     10.16.42.67:3804 - "GET /api/v1/clients?skip=0&limit=20 HTTP/1.1" 200 OK
-INFO:     10.16.2.183:13415 - "GET /api/v1/contractors?skip=0&limit=20 HTTP/1.1" 200 OK
-INFO:     10.16.24.73:3887 - "GET /api/v1/users?skip=0&limit=20 HTTP/1.1" 200 OK
-INFO:     10.16.2.183:50707 - "GET /api/v1/clients?skip=0&limit=20 HTTP/1.1" 200 OK
-INFO:     10.16.2.183:50707 - "GET /api/v1/contractors?skip=0&limit=20 HTTP/1.1" 200 OK
-INFO:     10.16.2.183:45066 - "GET /api/v1/users?skip=0&limit=20 HTTP/1.1" 200 OK
-INFO:     10.16.24.73:51559 - "GET /api/v1/clients?skip=0&limit=20 HTTP/1.1" 200 OK
-INFO:     10.16.2.183:50707 - "GET /api/v1/contractors?skip=0&limit=20 HTTP/1.1" 200 OK
-INFO:     10.16.42.67:46099 - "GET /api/v1/users?skip=0&limit=20 HTTP/1.1" 200 OK
-INFO:     10.16.2.183:45066 - "GET /api/v1/clients?skip=0&limit=20 HTTP/1.1" 200 OK
-INFO:     10.16.42.67:47734 - "GET /api/v1/contractors?skip=0&limit=20 HTTP/1.1" 200 OK
-INFO:     10.16.42.67:46099 - "GET /api/v1/users?skip=0&limit=20 HTTP/1.1" 200 OK
-INFO:     10.16.42.67:2643 - "GET /api/v1/clients?skip=0&limit=20 HTTP/1.1" 200 OK
-INFO:     10.16.24.73:56243 - "GET /health HTTP/1.1" 200 OK
-INFO:     10.16.42.67:8311 - "GET /health HTTP/1.1" 200 OK
-INFO:     10.16.42.67:41171 - "GET /health HTTP/1.1" 200 OK
-INFO:     10.16.24.73:5179 - "GET /api/v1/auth/me HTTP/1.1" 200 OK
-INFO:     10.16.42.67:49760 - "GET /api/v1/clients?skip=0&limit=20 HTTP/1.1" 200 OK
-INFO:     10.16.4.177:4968 - "GET /api/v1/users?skip=0&limit=20 HTTP/1.1" 200 OK
-INFO:     10.16.4.177:6371 - "GET /api/v1/contractors?skip=0&limit=20 HTTP/1.1" 200 OK
-INFO:     10.16.24.73:63807 - "GET /health HTTP/1.1" 200 OK
-INFO:     10.16.24.73:7825 - "GET /health HTTP/1.1" 200 OK
-INFO:     10.16.42.67:41712 - "GET /health HTTP/1.1" 200 OK
-INFO:     10.16.24.73:59247 - "GET /health HTTP/1.1" 200 OK
-INFO:     10.16.4.177:8578 - "GET /health HTTP/1.1" 200 OK
-INFO:     10.16.4.177:15840 - "GET /health HTTP/1.1" 200 OK
-INFO:     10.16.2.183:55237 - "GET /health HTTP/1.1" 200 OK
-INFO:     10.16.2.183:1281 - "GET /health HTTP/1.1" 200 OK
-INFO:     10.16.4.177:55913 - "GET /health HTTP/1.1" 200 OK
-INFO:     10.16.4.177:23927 - "GET /health HTTP/1.1" 200 OK
-INFO:     10.16.2.183:39887 - "GET /health HTTP/1.1" 200 OK
-INFO:     10.16.42.67:47296 - "GET /health HTTP/1.1" 200 OK
-ERROR: 2025-11-18T20:57:44 - app.core.supabase_auth: Get user error: invalid JWT: unable to parse or verify signature, token has invalid claims: token is expired
-WARNING: 2025-11-18T20:57:44 - app.api.deps: Invalid or expired token
-INFO:     10.16.42.67:18104 - "GET /health HTTP/1.1" 200 OK
-INFO:     10.16.24.73:54913 - "GET /health HTTP/1.1" 200 OK
-INFO:     10.16.2.183:52230 - "GET /health HTTP/1.1" 200 OK
-INFO:     10.16.24.73:15341 - "GET /health HTTP/1.1" 200 OK
-INFO:     10.16.24.73:62813 - "GET /health HTTP/1.1" 200 OK
-INFO:     10.16.2.183:54376 - "GET /health HTTP/1.1" 200 OK
-INFO:     10.16.2.183:25092 - "GET /health HTTP/1.1" 200 OK
-INFO:     10.16.2.183:2732 - "GET /health HTTP/1.1" 200 OK
-INFO:     10.16.4.177:54053 - "GET /health HTTP/1.1" 200 OK
-INFO:     10.16.42.67:1458 - "GET /health HTTP/1.1" 200 OK
-INFO:     10.16.2.183:1970 - "GET /health HTTP/1.1" 200 OK
-INFO:     10.16.2.183:39171 - "GET /health HTTP/1.1" 200 OK
-INFO:     10.16.2.183:31631 - "GET /health HTTP/1.1" 200 OK
-INFO: 2025-11-18T20:57:58 - app.core.supabase_auth: Session refreshed successfully
-INFO: 2025-11-18T20:57:58 - app.api.v1.auth: ✅ Token refreshed successfully for: lewiskimaru01@gmail.com
-INFO:     10.16.2.183:46306 - "GET /health HTTP/1.1" 200 OK
-INFO:     10.16.2.183:57772 - "GET /health HTTP/1.1" 200 OK
-INFO:     10.16.2.183:16281 - "GET /health HTTP/1.1" 200 OK
-INFO:     10.16.42.67:28690 - "GET /health HTTP/1.1" 200 OK
-INFO:     10.16.24.73:61506 - "GET /health HTTP/1.1" 200 OK
-INFO:     10.16.32.101:49923 - "GET /health HTTP/1.1" 200 OK
-INFO:     10.16.42.67:54183 - "GET /health HTTP/1.1" 200 OK
-INFO:     10.16.42.67:54878 - "GET /health HTTP/1.1" 200 OK
-INFO:     10.16.42.67:7134 - "GET /health HTTP/1.1" 200 OK
-INFO:     10.16.32.101:26991 - "GET /health HTTP/1.1" 200 OK
-INFO:     10.16.32.101:35984 - "GET /health HTTP/1.1" 200 OK
-INFO:     10.16.24.73:23627 - "GET /health HTTP/1.1" 200 OK
-INFO:     10.16.2.183:60025 - "GET /health HTTP/1.1" 200 OK
-INFO:     10.16.32.101:21380 - "GET /health HTTP/1.1" 200 OK
-INFO:     10.16.42.67:7066 - "GET /health HTTP/1.1" 200 OK
-INFO:     10.16.2.183:19222 - "GET /health HTTP/1.1" 200 OK
-INFO:     10.16.32.101:39468 - "GET /health HTTP/1.1" 200 OK
-INFO:     10.16.2.183:38508 - "GET /health HTTP/1.1" 200 OK
-INFO:     10.16.4.177:36127 - "GET /health HTTP/1.1" 200 OK
-INFO:     10.16.24.73:47417 - "GET /health HTTP/1.1" 200 OK
-INFO:     10.16.2.183:48815 - "GET /health HTTP/1.1" 200 OK
-INFO:     10.16.4.177:47884 - "GET /health HTTP/1.1" 200 OK
-INFO:     10.16.24.73:6357 - "GET /health HTTP/1.1" 200 OK
-INFO:     10.16.32.101:3181 - "GET /api/v1/auth/me HTTP/1.1" 200 OK
-INFO:     10.16.2.183:21053 - "GET /health HTTP/1.1" 200 OK
-INFO:     10.16.24.73:25442 - "GET /api/v1/auth/me/preferences HTTP/1.1" 200 OK
-INFO:     10.16.2.183:28211 - "GET /api/v1/auth/me/preferences/available-apps HTTP/1.1" 200 OK
-INFO:     10.16.32.101:3181 - "GET /api/v1/users?skip=0&limit=20 HTTP/1.1" 200 OK
-INFO:     10.16.2.183:21053 - "GET /api/v1/contractors?skip=0&limit=20 HTTP/1.1" 200 OK
-INFO:     10.16.24.73:46513 - "GET /api/v1/clients?skip=0&limit=20 HTTP/1.1" 200 OK
-INFO:     10.16.4.177:26166 - "GET /api/v1/audit-logs?skip=0&limit=20 HTTP/1.1" 200 OK
-INFO:     10.16.42.67:26501 - "GET /health HTTP/1.1" 200 OK
-INFO:     10.16.42.67:58512 - "GET /health HTTP/1.1" 200 OK
-INFO:     10.16.2.183:22407 - "GET /health HTTP/1.1" 200 OK
-INFO:     10.16.2.183:17473 - "GET /health HTTP/1.1" 200 OK
-INFO: 2025-11-18T20:59:43 - app.core.supabase_auth: User signed in successfully: lewiskimaru01@gmail.com
-INFO: 2025-11-18T20:59:45 - app.services.audit_service: Audit log created: login on auth by lewiskimaru01@gmail.com
-INFO: 2025-11-18T20:59:45 - app.api.v1.auth: User logged in successfully: lewiskimaru01@gmail.com
-INFO:     10.16.42.67:33772 - "POST /api/v1/auth/login HTTP/1.1" 200 OK
-INFO:     10.16.42.67:33772 - "GET /api/v1/auth/me HTTP/1.1" 200 OK
-INFO:     10.16.42.67:33772 - "GET /api/v1/contractors?skip=0&limit=20 HTTP/1.1" 200 OK
-INFO:     10.16.24.73:8023 - "GET /api/v1/clients?skip=0&limit=20 HTTP/1.1" 200 OK
-INFO:     10.16.4.177:35710 - "GET /api/v1/users?skip=0&limit=20 HTTP/1.1" 200 OK
-INFO:     10.16.42.67:33772 - "GET /health HTTP/1.1" 200 OK
-INFO:     10.16.42.67:32061 - "GET /api/v1/audit-logs?skip=0&limit=20 HTTP/1.1" 200 OK
-INFO:     10.16.24.73:12751 - "GET /health HTTP/1.1" 200 OK
-INFO:     10.16.24.73:39562 - "GET /health HTTP/1.1" 200 OK
-INFO:     10.16.2.183:28946 - "GET /health HTTP/1.1" 200 OK
-INFO:     10.16.24.73:61189 - "GET /health HTTP/1.1" 200 OK
-INFO:     10.16.4.177:1872 - "GET /health HTTP/1.1" 200 OK
-INFO:     10.16.42.67:2928 - "GET /health HTTP/1.1" 200 OK
-INFO:     10.16.24.73:6668 - "GET /health HTTP/1.1" 200 OK
-INFO:     10.16.2.183:9599 - "GET /health HTTP/1.1" 200 OK
-INFO:     10.16.42.67:17623 - "GET /health HTTP/1.1" 200 OK
-INFO:     10.16.42.67:14762 - "GET /health HTTP/1.1" 200 OK
-INFO:     10.16.24.73:43216 - "GET /health HTTP/1.1" 200 OK
-INFO:     10.16.42.67:17685 - "GET /health HTTP/1.1" 200 OK
-INFO:     10.16.24.73:48382 - "GET /health HTTP/1.1" 200 OK
-INFO:     10.16.4.177:2652 - "GET /health HTTP/1.1" 200 OK
-INFO:     10.16.24.73:53262 - "GET /health HTTP/1.1" 200 OK
-INFO:     10.16.42.67:47692 - "GET /health HTTP/1.1" 200 OK
-INFO:     10.16.4.177:64326 - "GET /health HTTP/1.1" 200 OK
-INFO:     10.16.42.67:7307 - "GET /health HTTP/1.1" 200 OK
-INFO:     10.16.2.183:25534 - "GET /health HTTP/1.1" 200 OK
-INFO:     10.16.42.67:52068 - "GET /api/v1/auth/me HTTP/1.1" 200 OK
-INFO:     10.16.2.183:19931 - "GET /api/v1/auth/me/preferences HTTP/1.1" 200 OK
-INFO:     10.16.4.177:4433 - "GET /api/v1/auth/me/preferences/available-apps HTTP/1.1" 200 OK
-INFO:     10.16.42.67:52068 - "GET /api/v1/users?skip=0&limit=20 HTTP/1.1" 200 OK
-INFO:     10.16.2.183:25534 - "GET /api/v1/contractors?skip=0&limit=20 HTTP/1.1" 200 OK
-INFO:     10.16.4.177:4433 - "GET /health HTTP/1.1" 200 OK
-INFO:     10.16.4.177:37222 - "GET /api/v1/clients?skip=0&limit=20 HTTP/1.1" 200 OK
-INFO:     10.16.42.67:12340 - "GET /api/v1/audit-logs?skip=0&limit=20 HTTP/1.1" 200 OK
-INFO:     10.16.2.183:17646 - "GET /health HTTP/1.1" 200 OK
-INFO:     10.16.4.177:56071 - "GET /health HTTP/1.1" 200 OK
-INFO:     10.16.24.73:3415 - "GET /health HTTP/1.1" 200 OK
-INFO:     10.16.2.183:49486 - "GET /health HTTP/1.1" 200 OK
-INFO:     10.16.2.183:49486 - "GET /health HTTP/1.1" 200 OK
-INFO:     10.16.42.67:2060 - "GET /health HTTP/1.1" 200 OK
-INFO:     10.16.4.177:63825 - "GET /health HTTP/1.1" 200 OK
-INFO:     10.16.4.177:37926 - "GET /health HTTP/1.1" 200 OK
-INFO:     10.16.24.73:28604 - "GET /health HTTP/1.1" 200 OK
-ERROR: 2025-11-19T04:37:19 - app.core.supabase_auth: Session refresh error: Invalid Refresh Token: Already Used
-ERROR: 2025-11-19T04:37:19 - app.api.v1.auth: ❌ Token refresh error: Invalid Refresh Token: Already Used
-ERROR: 2025-11-19T04:37:19 - app.core.supabase_auth: Get user error: invalid JWT: unable to parse or verify signature, token has invalid claims: token is expired
-WARNING: 2025-11-19T04:37:19 - app.api.deps: Invalid or expired token
-ERROR: 2025-11-19T04:37:20 - app.core.supabase_auth: Get user error: invalid JWT: unable to parse or verify signature, token has invalid claims: token is expired
-WARNING: 2025-11-19T04:37:20 - app.api.deps: Invalid or expired token
-ERROR: 2025-11-19T04:37:20 - app.core.supabase_auth: Get user error: invalid JWT: unable to parse or verify signature, token has invalid claims: token is expired
-WARNING: 2025-11-19T04:37:20 - app.api.deps: Invalid or expired token
-INFO:     10.16.24.73:33660 - "POST /api/v1/auth/refresh-token HTTP/1.1" 401 Unauthorized
-INFO:     10.16.24.73:34541 - "GET /api/v1/auth/me/preferences HTTP/1.1" 401 Unauthorized
-INFO:     10.16.32.101:40596 - "GET /api/v1/auth/me HTTP/1.1" 401 Unauthorized
-INFO:     10.16.2.183:34221 - "GET /api/v1/auth/me/preferences/available-apps HTTP/1.1" 401 Unauthorized
-INFO:     10.16.42.67:8059 - "GET /health HTTP/1.1" 200 OK
-INFO:     10.16.2.183:48493 - "GET /health HTTP/1.1" 200 OK
-INFO:     10.16.32.101:9358 - "GET /health HTTP/1.1" 200 OK
-INFO:     10.16.32.101:9358 - "GET /health HTTP/1.1" 200 OK
-INFO:     10.16.2.183:8594 - "GET /health HTTP/1.1" 200 OK
-INFO:     10.16.24.73:57651 - "GET /health HTTP/1.1" 200 OK
-INFO: 2025-11-19T04:40:11 - app.core.supabase_auth: User signed in successfully: lewiskimaru01@gmail.com
-INFO: 2025-11-19T04:40:12 - app.services.audit_service: Audit log created: login on auth by lewiskimaru01@gmail.com
-INFO: 2025-11-19T04:40:12 - app.api.v1.auth: User logged in successfully: lewiskimaru01@gmail.com
-INFO:     10.16.2.183:6394 - "POST /api/v1/auth/login HTTP/1.1" 200 OK
-INFO:     10.16.2.183:6394 - "GET /api/v1/auth/me HTTP/1.1" 200 OK
-INFO:     10.16.2.183:6394 - "GET /api/v1/clients?skip=0&limit=20 HTTP/1.1" 200 OK
-INFO:     10.16.24.73:42530 - "GET /api/v1/contractors?skip=0&limit=20 HTTP/1.1" 200 OK
-INFO:     10.16.32.101:33933 - "GET /api/v1/users?skip=0&limit=20 HTTP/1.1" 200 OK
-INFO:     10.16.32.101:33933 - "GET /api/v1/audit-logs?skip=0&limit=20 HTTP/1.1" 200 OK
-INFO:     10.16.2.183:26743 - "GET /health HTTP/1.1" 200 OK
-INFO:     10.16.24.73:42664 - "GET /health HTTP/1.1" 200 OK
-INFO:     10.16.24.73:15309 - "GET /api/v1/auth/me HTTP/1.1" 200 OK
-INFO:     10.16.32.101:35036 - "GET /api/v1/auth/me/preferences/available-apps HTTP/1.1" 200 OK
-INFO:     10.16.2.183:43122 - "GET /api/v1/auth/me/preferences HTTP/1.1" 200 OK
-INFO:     10.16.2.183:16243 - "GET /api/v1/clients?skip=0&limit=20 HTTP/1.1" 200 OK
-INFO:     10.16.32.101:52836 - "GET /api/v1/contractors?skip=0&limit=20 HTTP/1.1" 200 OK
-INFO:     10.16.42.67:1154 - "GET /api/v1/users?skip=0&limit=20 HTTP/1.1" 200 OK
-INFO:     10.16.24.73:12930 - "GET /api/v1/audit-logs?skip=0&limit=20 HTTP/1.1" 200 OK
-INFO:     10.16.32.101:58437 - "GET /health HTTP/1.1" 200 OK
-INFO: 2025-11-19T04:42:58 - app.core.supabase_auth: Session refreshed successfully
-INFO: 2025-11-19T04:42:59 - app.api.v1.auth: ✅ Token refreshed successfully for: lewiskimaru01@gmail.com
-INFO:     10.16.29.62:60594 - "POST /api/v1/auth/refresh-token HTTP/1.1" 200 OK
-ERROR: 2025-11-19T04:42:59 - app.core.supabase_auth: Get user error: invalid JWT: unable to parse or verify signature, token has invalid claims: token is expired
-WARNING: 2025-11-19T04:42:59 - app.api.deps: Invalid or expired token
-ERROR: 2025-11-19T04:42:59 - app.core.supabase_auth: Get user error: invalid JWT: unable to parse or verify signature, token has invalid claims: token is expired
-WARNING: 2025-11-19T04:42:59 - app.api.deps: Invalid or expired token
-ERROR: 2025-11-19T04:42:59 - app.core.supabase_auth: Get user error: invalid JWT: unable to parse or verify signature, token has invalid claims: token is expired
-WARNING: 2025-11-19T04:42:59 - app.api.deps: Invalid or expired token
-INFO:     10.16.2.183:39737 - "GET /api/v1/auth/me/preferences HTTP/1.1" 401 Unauthorized
-INFO:     10.16.24.73:1491 - "GET /api/v1/auth/me HTTP/1.1" 401 Unauthorized
-INFO:     10.16.29.62:12374 - "GET /api/v1/auth/me/preferences/available-apps HTTP/1.1" 401 Unauthorized
-INFO:     10.16.24.73:1491 - "GET /health HTTP/1.1" 200 OK
-INFO: 2025-11-19T04:43:30 - app.core.supabase_auth: User signed in successfully: lewiskimaru01@gmail.com
-INFO: 2025-11-19T04:43:32 - app.services.audit_service: Audit log created: login on auth by lewiskimaru01@gmail.com
-INFO: 2025-11-19T04:43:32 - app.api.v1.auth: User logged in successfully: lewiskimaru01@gmail.com
-INFO:     10.16.2.183:44311 - "POST /api/v1/auth/login HTTP/1.1" 200 OK
-INFO:     10.16.24.73:33537 - "GET /api/v1/auth/me HTTP/1.1" 200 OK
-INFO:     10.16.24.73:33537 - "GET /api/v1/clients?skip=0&limit=20 HTTP/1.1" 200 OK
-INFO:     10.16.29.62:37849 - "GET /api/v1/contractors?skip=0&limit=20 HTTP/1.1" 200 OK
-INFO:     10.16.32.101:29195 - "GET /api/v1/users?skip=0&limit=20 HTTP/1.1" 200 OK
-INFO:     10.16.32.101:29195 - "GET /api/v1/audit-logs?skip=0&limit=20 HTTP/1.1" 200 OK
-INFO:     10.16.32.101:28157 - "GET /api/v1/auth/me HTTP/1.1" 200 OK
-INFO:     10.16.32.101:30477 - "GET /health HTTP/1.1" 200 OK
-INFO:     10.16.29.62:51264 - "GET /api/v1/auth/me/preferences HTTP/1.1" 200 OK
-INFO:     10.16.32.101:32205 - "GET /api/v1/auth/me/preferences/available-apps HTTP/1.1" 200 OK
-INFO:     10.16.29.62:17615 - "GET /api/v1/clients?skip=0&limit=20 HTTP/1.1" 200 OK
-INFO:     10.16.42.67:6702 - "GET /api/v1/contractors?skip=0&limit=20 HTTP/1.1" 200 OK
-INFO:     10.16.42.67:4910 - "GET /api/v1/users?skip=0&limit=20 HTTP/1.1" 200 OK
-INFO:     10.16.42.67:4910 - "GET /api/v1/audit-logs?skip=0&limit=20 HTTP/1.1" 200 OK
-INFO:     10.16.42.67:44047 - "GET /api/v1/clients?skip=0&limit=50 HTTP/1.1" 200 OK
-INFO:     10.16.24.73:16591 - "GET /api/v1/contractors?skip=0&limit=50 HTTP/1.1" 200 OK
-INFO:     10.16.32.101:58521 - "GET /health HTTP/1.1" 200 OK
-INFO:     10.16.24.73:34404 - "GET /api/v1/users?skip=0&limit=50 HTTP/1.1" 200 OK
-INFO:     10.16.24.73:44278 - "GET /api/v1/audit-logs?skip=0&limit=50 HTTP/1.1" 200 OK
-INFO:     10.16.42.67:50328 - "GET /health HTTP/1.1" 200 OK
-INFO:     10.16.42.67:10442 - "GET /health HTTP/1.1" 200 OK
-INFO:     10.16.29.62:10878 - "GET /api/v1/auth/me/preferences HTTP/1.1" 200 OK
-INFO:     10.16.32.101:46692 - "GET /api/v1/auth/me HTTP/1.1" 200 OK
-INFO:     10.16.2.183:1137 - "GET /health HTTP/1.1" 200 OK
-INFO:     10.16.32.101:25681 - "GET /api/v1/auth/me/preferences/available-apps HTTP/1.1" 200 OK
-INFO:     10.16.24.73:64236 - "GET /api/v1/clients?skip=0&limit=20 HTTP/1.1" 200 OK
-INFO:     10.16.2.183:39926 - "GET /api/v1/users?skip=0&limit=20 HTTP/1.1" 200 OK
-INFO:     10.16.24.73:39456 - "GET /api/v1/contractors?skip=0&limit=20 HTTP/1.1" 200 OK
-INFO:     10.16.2.183:39926 - "GET /api/v1/audit-logs?skip=0&limit=20 HTTP/1.1" 200 OK
-INFO:     10.16.32.101:60235 - "GET /health HTTP/1.1" 200 OK
-INFO:     10.16.32.101:11361 - "GET /health HTTP/1.1" 200 OK
-INFO:     10.16.32.101:22289 - "GET /health HTTP/1.1" 200 OK
-INFO:     10.16.24.73:14015 - "GET /health HTTP/1.1" 200 OK
-INFO:     10.16.42.67:18436 - "GET /health HTTP/1.1" 200 OK
-INFO:     10.16.32.101:55877 - "GET /health HTTP/1.1" 200 OK
-INFO:     10.16.24.73:52870 - "GET /health HTTP/1.1" 200 OK
-INFO: 2025-11-19T05:10:14 - app.core.supabase_auth: Session refreshed successfully
-INFO: 2025-11-19T05:10:16 - app.api.v1.auth: ✅ Token refreshed successfully for: kamirujoel2000@gmail.com
-INFO:     10.16.42.67:60173 - "POST /api/v1/auth/refresh-token HTTP/1.1" 200 OK
-ERROR: 2025-11-19T05:10:16 - app.core.supabase_auth: Get user error: invalid JWT: unable to parse or verify signature, token has invalid claims: token is expired
-WARNING: 2025-11-19T05:10:16 - app.api.deps: Invalid or expired token
-ERROR: 2025-11-19T05:10:16 - app.core.supabase_auth: Get user error: invalid JWT: unable to parse or verify signature, token has invalid claims: token is expired
-WARNING: 2025-11-19T05:10:16 - app.api.deps: Invalid or expired token
-ERROR: 2025-11-19T05:10:17 - app.core.supabase_auth: Get user error: invalid JWT: unable to parse or verify signature, token has invalid claims: token is expired
-WARNING: 2025-11-19T05:10:17 - app.api.deps: Invalid or expired token
-INFO:     10.16.24.73:7288 - "GET /api/v1/auth/me HTTP/1.1" 401 Unauthorized
-ERROR: 2025-11-19T05:10:17 - app.core.supabase_auth: Get user error: invalid JWT: unable to parse or verify signature, token has invalid claims: token is expired
-WARNING: 2025-11-19T05:10:17 - app.api.deps: Invalid or expired token
-INFO:     10.16.2.183:16465 - "GET /api/v1/clients?skip=0&limit=100 HTTP/1.1" 401 Unauthorized
-INFO:     10.16.2.183:62132 - "GET /api/v1/users?skip=0&limit=100 HTTP/1.1" 401 Unauthorized
-INFO:     10.16.2.183:47393 - "GET /api/v1/contractors?skip=0&limit=100 HTTP/1.1" 401 Unauthorized
-INFO:     10.16.42.67:57285 - "GET /health HTTP/1.1" 200 OK
-INFO: 2025-11-19T07:30:23 - app.core.supabase_auth: Session refreshed successfully
-INFO: 2025-11-19T07:30:25 - app.api.v1.auth: ✅ Token refreshed successfully for: lewiskimaru01@gmail.com
-INFO:     10.16.42.67:51262 - "POST /api/v1/auth/refresh-token HTTP/1.1" 200 OK
-ERROR: 2025-11-19T07:30:26 - app.core.supabase_auth: Get user error: invalid JWT: unable to parse or verify signature, token has invalid claims: token is expired
-WARNING: 2025-11-19T07:30:26 - app.api.deps: Invalid or expired token
-ERROR: 2025-11-19T07:30:26 - app.core.supabase_auth: Get user error: invalid JWT: unable to parse or verify signature, token has invalid claims: token is expired
-WARNING: 2025-11-19T07:30:26 - app.api.deps: Invalid or expired token
-ERROR: 2025-11-19T07:30:26 - app.core.supabase_auth: Get user error: invalid JWT: unable to parse or verify signature, token has invalid claims: token is expired
-WARNING: 2025-11-19T07:30:26 - app.api.deps: Invalid or expired token
-INFO:     10.16.2.183:13623 - "GET /api/v1/auth/me HTTP/1.1" 401 Unauthorized
-INFO:     10.16.32.101:65493 - "GET /api/v1/auth/me/preferences/available-apps HTTP/1.1" 401 Unauthorized
-INFO:     10.16.32.101:63769 - "GET /api/v1/auth/me/preferences HTTP/1.1" 401 Unauthorized
-INFO: 2025-11-19T07:30:49 - app.core.supabase_auth: User signed in successfully: lewiskimaru01@gmail.com
-INFO: 2025-11-19T07:30:52 - app.services.audit_service: Audit log created: login on auth by lewiskimaru01@gmail.com
-INFO: 2025-11-19T07:30:52 - app.api.v1.auth: User logged in successfully: lewiskimaru01@gmail.com
-INFO:     10.16.2.183:60486 - "POST /api/v1/auth/login HTTP/1.1" 200 OK
-INFO:     10.16.24.73:55086 - "GET /api/v1/auth/me HTTP/1.1" 200 OK
-INFO:     10.16.32.101:27054 - "GET /api/v1/contractors?skip=0&limit=20 HTTP/1.1" 200 OK
-INFO:     10.16.42.67:5575 - "GET /api/v1/clients?skip=0&limit=20 HTTP/1.1" 200 OK
-INFO:     10.16.32.101:16146 - "GET /api/v1/users?skip=0&limit=20 HTTP/1.1" 200 OK
-INFO:     10.16.2.183:56271 - "GET /api/v1/audit-logs?skip=0&limit=20 HTTP/1.1" 200 OK
-INFO:     10.16.32.101:35137 - "GET /health HTTP/1.1" 200 OK
-INFO:     10.16.24.73:29699 - "GET /health HTTP/1.1" 200 OK
-INFO:     10.16.2.183:8281 - "GET /health HTTP/1.1" 200 OK
-INFO:     10.16.2.183:34724 - "GET /health HTTP/1.1" 200 OK
-INFO:     10.16.2.183:44681 - "GET /health HTTP/1.1" 200 OK
-INFO:     10.16.2.183:43318 - "GET /health HTTP/1.1" 200 OK
+Traceback (most recent call last):
+  File "/usr/local/bin/uvicorn", line 8, in <module>
+    sys.exit(main())
+             ^^^^^^
+  File "/usr/local/lib/python3.11/site-packages/click/core.py", line 1485, in __call__
+    return self.main(*args, **kwargs)
+           ^^^^^^^^^^^^^^^^^^^^^^^^^^
+  File "/usr/local/lib/python3.11/site-packages/click/core.py", line 1406, in main
+    rv = self.invoke(ctx)
+         ^^^^^^^^^^^^^^^^
+  File "/usr/local/lib/python3.11/site-packages/click/core.py", line 1269, in invoke
+    return ctx.invoke(self.callback, **ctx.params)
+           ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+  File "/usr/local/lib/python3.11/site-packages/click/core.py", line 824, in invoke
+    return callback(*args, **kwargs)
+           ^^^^^^^^^^^^^^^^^^^^^^^^^
+  File "/usr/local/lib/python3.11/site-packages/uvicorn/main.py", line 416, in main
+    run(
+  File "/usr/local/lib/python3.11/site-packages/uvicorn/main.py", line 587, in run
+    server.run()
+  File "/usr/local/lib/python3.11/site-packages/uvicorn/server.py", line 61, in run
+    return asyncio.run(self.serve(sockets=sockets))
+           ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+  File "/usr/local/lib/python3.11/asyncio/runners.py", line 190, in run
+    return runner.run(main)
+           ^^^^^^^^^^^^^^^^
+  File "/usr/local/lib/python3.11/asyncio/runners.py", line 118, in run
+    return self._loop.run_until_complete(task)
+           ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+  File "uvloop/loop.pyx", line 1518, in uvloop.loop.Loop.run_until_complete
+  File "/usr/local/lib/python3.11/site-packages/uvicorn/server.py", line 68, in serve
+    config.load()
+  File "/usr/local/lib/python3.11/site-packages/uvicorn/config.py", line 467, in load
+    self.loaded_app = import_from_string(self.app)
+                      ^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+  File "/usr/local/lib/python3.11/site-packages/uvicorn/importer.py", line 21, in import_from_string
+    module = importlib.import_module(module_str)
+             ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+  File "/usr/local/lib/python3.11/importlib/__init__.py", line 126, in import_module
+    return _bootstrap._gcd_import(name[level:], package, level)
+           ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+  File "<frozen importlib._bootstrap>", line 1204, in _gcd_import
+  File "<frozen importlib._bootstrap>", line 1176, in _find_and_load
+  File "<frozen importlib._bootstrap>", line 1147, in _find_and_load_unlocked
+  File "<frozen importlib._bootstrap>", line 690, in _load_unlocked
+  File "<frozen importlib._bootstrap_external>", line 940, in exec_module
+  File "<frozen importlib._bootstrap>", line 241, in _call_with_frames_removed
+  File "/app/src/app/main.py", line 141, in <module>
+    from app.api.v1.router import api_router
+  File "/app/src/app/api/v1/router.py", line 5, in <module>
+    from app.api.v1 import (
+  File "/app/src/app/api/v1/expenses.py", line 18, in <module>
+    from app.core.database import get_db
+ImportError: cannot import name 'get_db' from 'app.core.database' (/app/src/app/core/database.py)
+Traceback (most recent call last):
+  File "/usr/local/bin/uvicorn", line 8, in <module>
+    sys.exit(main())
+             ^^^^^^
+  File "/usr/local/lib/python3.11/site-packages/click/core.py", line 1485, in __call__
+    return self.main(*args, **kwargs)
+           ^^^^^^^^^^^^^^^^^^^^^^^^^^
+  File "/usr/local/lib/python3.11/site-packages/click/core.py", line 1406, in main
+    rv = self.invoke(ctx)
+         ^^^^^^^^^^^^^^^^
+  File "/usr/local/lib/python3.11/site-packages/click/core.py", line 1269, in invoke
+    return ctx.invoke(self.callback, **ctx.params)
+           ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+  File "/usr/local/lib/python3.11/site-packages/click/core.py", line 824, in invoke
+    return callback(*args, **kwargs)
+           ^^^^^^^^^^^^^^^^^^^^^^^^^
+  File "/usr/local/lib/python3.11/site-packages/uvicorn/main.py", line 416, in main
+    run(
+  File "/usr/local/lib/python3.11/site-packages/uvicorn/main.py", line 587, in run
+    server.run()
+  File "/usr/local/lib/python3.11/site-packages/uvicorn/server.py", line 61, in run
+    return asyncio.run(self.serve(sockets=sockets))
+           ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+  File "/usr/local/lib/python3.11/asyncio/runners.py", line 190, in run
+    return runner.run(main)
+           ^^^^^^^^^^^^^^^^
+  File "/usr/local/lib/python3.11/asyncio/runners.py", line 118, in run
+    return self._loop.run_until_complete(task)
+           ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+  File "uvloop/loop.pyx", line 1518, in uvloop.loop.Loop.run_until_complete
+  File "/usr/local/lib/python3.11/site-packages/uvicorn/server.py", line 68, in serve
+    config.load()
+  File "/usr/local/lib/python3.11/site-packages/uvicorn/config.py", line 467, in load
+    self.loaded_app = import_from_string(self.app)
+                      ^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+  File "/usr/local/lib/python3.11/site-packages/uvicorn/importer.py", line 21, in import_from_string
+    module = importlib.import_module(module_str)
+             ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+  File "/usr/local/lib/python3.11/importlib/__init__.py", line 126, in import_module
+    return _bootstrap._gcd_import(name[level:], package, level)
+           ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+  File "<frozen importlib._bootstrap>", line 1204, in _gcd_import
+  File "<frozen importlib._bootstrap>", line 1176, in _find_and_load
+  File "<frozen importlib._bootstrap>", line 1147, in _find_and_load_unlocked
+  File "<frozen importlib._bootstrap>", line 690, in _load_unlocked
+  File "<frozen importlib._bootstrap_external>", line 940, in exec_module
+  File "<frozen importlib._bootstrap>", line 241, in _call_with_frames_removed
+  File "/app/src/app/main.py", line 141, in <module>
+    from app.api.v1.router import api_router
+  File "/app/src/app/api/v1/router.py", line 5, in <module>
+    from app.api.v1 import (
+  File "/app/src/app/api/v1/expenses.py", line 18, in <module>
+    from app.core.database import get_db
+ImportError: cannot import name 'get_db' from 'app.core.database' (/app/src/app/core/database.py)

src/app/api/v1/expenses.py

@@ -15,8 +15,7 @@ from sqlalchemy.orm import Session
 from typing import Optional, List
 from uuid import UUID
 
-from app.core.database import get_db
-from app.core.auth import get_current_user
+from app.api.deps import get_db, get_current_user
 from app.models.user import User
 from app.schemas.ticket_expense import (
     TicketExpenseCreate,

src/app/api/v1/incident_reports.py

@@ -13,8 +13,7 @@ from sqlalchemy.orm import Session
 from typing import List, Optional
 from uuid import UUID
 
-from app.core.database import get_db
-from app.core.auth import get_current_user
+from app.api.deps import get_db, get_current_user
 from app.models.user import User
 from app.schemas.ticket_progress import (
     TicketIncidentReportCreate,

src/app/api/v1/progress_reports.py

@@ -14,8 +14,7 @@ from sqlalchemy.orm import Session
 from typing import List, Optional
 from uuid import UUID
 
-from app.core.database import get_db
-from app.core.auth import get_current_user
+from app.api.deps import get_db, get_current_user
 from app.models.user import User
 from app.schemas.ticket_progress import (
     TicketProgressReportCreate,

tests/integration/test_auth_audit_logs.py

@@ -18,7 +18,7 @@ from sqlalchemy.orm import Session
 from fastapi.testclient import TestClient
 
 from app.main import app
-from app.core.database import get_db
+from app.api.deps import get_db
 from app.models.user import User
 from app.models.audit_log import AuditLog
 from app.services.password_reset_service import PasswordResetService

tests/integration/test_password_reset.py

@@ -16,7 +16,7 @@ from sqlalchemy.orm import Session
 from fastapi.testclient import TestClient
 
 from app.main import app
-from app.core.database import get_db
+from app.api.deps import get_db
 from app.models.user import User
 from app.models.invitation import UserInvitation
 from app.models.audit_log import AuditLog