feat: file naming

docs/devlogs/db/logs.json

@@ -2,4 +2,9 @@ INSERT INTO "public"."ticket_images" ("id", "ticket_id", "document_id", "image_t
 
 
 and here is the project data that we use to generate the completion form
-[{"idx":0,"id":"0ade6bd1-e492-4e25-b681-59f42058d29a","client_id":"a2455244-d87e-4279-9fca-dc067f06b5c3","contractor_id":"1af9fb24-e5bb-40ac-a748-0997580b4c32","title":"Atomio Fttx","description":"Install of testing purposes","service_type":"ftth","primary_manager_id":"c5cf92be-4172-4fe2-af5c-f05d83b3a938","status":"active","planned_start_date":"2025-11-22","planned_end_date":"2026-01-23","actual_start_date":null,"actual_end_date":null,"is_closed":false,"closed_at":null,"closed_by_user_id":null,"platform_billing_plan":null,"is_billable":true,"budget":"{}","inventory_requirements":"{}","photo_requirements":"[{\"type\": \"Speedtest\", \"required\": true, \"max_photos\": 1, \"min_photos\": 1, \"description\": \"speed test collected \"}, {\"type\": \"Airtel network\", \"required\": true, \"max_photos\": 1, \"min_photos\": 1, \"description\": \"strength metrics\"}, {\"type\": \"ODU outdoor image\", \"required\": true, \"max_photos\": 1, \"min_photos\": 1, \"description\": \"take a photo of the odu antenna\"}]","activation_requirements":"[{\"type\": \"text\", \"field\": \"ont_serial\", \"label\": \"ONT\", \"options\": null, \"required\": true}, {\"type\": \"text\", \"field\": \"odu_serial\", \"label\": \"ODU\", \"options\": null, \"required\": true}]","additional_metadata":"{\"setup_finalized_at\": \"2025-11-23T13:47:18.729614\", \"setup_finalized_by\": \"c5cf92be-4172-4fe2-af5c-f05d83b3a938\"}","created_at":"2025-11-20 19:04:04.11638+00","updated_at":"2025-11-24 13:16:22.370045+00","deleted_at":null,"project_type":"customer_service"}]
+[{"idx":0,"id":"0ade6bd1-e492-4e25-b681-59f42058d29a","client_id":"a2455244-d87e-4279-9fca-dc067f06b5c3","contractor_id":"1af9fb24-e5bb-40ac-a748-0997580b4c32","title":"Atomio Fttx","description":"Install of testing purposes","service_type":"ftth","primary_manager_id":"c5cf92be-4172-4fe2-af5c-f05d83b3a938","status":"active","planned_start_date":"2025-11-22","planned_end_date":"2026-01-23","actual_start_date":null,"actual_end_date":null,"is_closed":false,"closed_at":null,"closed_by_user_id":null,"platform_billing_plan":null,"is_billable":true,"budget":"{}","inventory_requirements":"{}","photo_requirements":"[{\"type\": \"Speedtest\", \"required\": true, \"max_photos\": 1, \"min_photos\": 1, \"description\": \"speed test collected \"}, {\"type\": \"Airtel network\", \"required\": true, \"max_photos\": 1, \"min_photos\": 1, \"description\": \"strength metrics\"}, {\"type\": \"ODU outdoor image\", \"required\": true, \"max_photos\": 1, \"min_photos\": 1, \"description\": \"take a photo of the odu antenna\"}]","activation_requirements":"[{\"type\": \"text\", \"field\": \"ont_serial\", \"label\": \"ONT\", \"options\": null, \"required\": true}, {\"type\": \"text\", \"field\": \"odu_serial\", \"label\": \"ODU\", \"options\": null, \"required\": true}]","additional_metadata":"{\"setup_finalized_at\": \"2025-11-23T13:47:18.729614\", \"setup_finalized_by\": \"c5cf92be-4172-4fe2-af5c-f05d83b3a938\"}","created_at":"2025-11-20 19:04:04.11638+00","updated_at":"2025-11-24 13:16:22.370045+00","deleted_at":null,"project_type":"customer_service"}]
+
+Documents system
+
+INSERT INTO "public"."documents" ("id", "entity_type", "entity_id", "file_name", "file_type", "file_size", "file_url", "document_type", "document_category", "version", "is_latest_version", "previous_version_id", "description", "tags", "additional_metadata", "uploaded_by_user_id", "is_public", "created_at", "updated_at", "deleted_at", "storage_provider") VALUES ('03b98bf0-00bf-489b-b82e-b5ac8ed93ff1', 'ticket', 'f59b29fc-d0b9-4618-b0d1-889e340da612', 'Screenshot_20251111-113721.png', 'image/png', '435778', 'https://res.cloudinary.com/dnhajmziu/image/upload/v1764500238/file_ejhwnj.png', 'ticket_photo_ODU outdoor image', 'evidence', '1', 'true', null, 'ODU outdoor image photo for ticket Elizabeth Muthoni', '["ticket", "photo", "ODU outdoor image"]', '{"etag": "83d1240488876d014700628e0be9930d", "type": "upload", "bytes": 435778, "width": 720, "format": "png", "height": 1600, "version": 1764500238, "public_id": "file_ejhwnj", "created_at": "2025-11-30T10:57:18Z", "secure_url": "https://res.cloudinary.com/dnhajmziu/image/upload/v1764500238/file_ejhwnj.png", "resource_type": "image"}', '43b778b0-2062-4724-abbb-916a4835a9b0', 'false', '2025-11-30 10:57:18.713582+00', '2025-11-30 10:57:18.713589+00', null, 'cloudinary'), ('28e39514-4ffd-44f3-8a38-3972597264a3', 'ticket', 'f59b29fc-d0b9-4618-b0d1-889e340da612', 'passport 2025-11-27 101849.png', 'image/png', '265110', 'https://res.cloudinary.com/dnhajmziu/image/upload/v1764500237/file_a6bhg3.png', 'ticket_photo_Speedtest', 'evidence', '1', 'true', null, 'Speedtest photo for ticket Elizabeth Muthoni', '["ticket", "photo", "Speedtest"]', '{"etag": "d0c2d78da84c52beb8d77ce9e252c8d8", "type": "upload", "bytes": 265110, "width": 510, "format": "png", "height": 364, "version": 1764500237, "public_id": "file_a6bhg3", "created_at": "2025-11-30T10:57:17Z", "secure_url": "https://res.cloudinary.com/dnhajmziu/image/upload/v1764500237/file_a6bhg3.png", "resource_type": "image"}', '43b778b0-2062-4724-abbb-916a4835a9b0', 'false', '2025-11-30 10:57:18.189524+00', '2025-11-30 10:57:18.189535+00', null, 'cloudinary'), ('e76d848f-640a-4998-9a2c-948d4bc94d77', 'ticket', 'f59b29fc-d0b9-4618-b0d1-889e340da612', 'Gemini_Generated_Image_anof4fanof4fanof-removebg-preview.png', 'image/png', '101003', 'https://res.cloudinary.com/dnhajmziu/image/upload/v1764500236/file_kistjf.png', 'ticket_photo_Airtel network', 'evidence', '1', 'true', null, 'Airtel network photo for ticket Elizabeth Muthoni', '["ticket", "photo", "Airtel network"]', '{"etag": "b15f466735aea70f7c419b7e4f58c29e", "type": "upload", "bytes": 101003, "width": 684, "format": "png", "height": 365, "version": 1764500236, "public_id": "file_kistjf", "created_at": "2025-11-30T10:57:16Z", "secure_url": "https://res.cloudinary.com/dnhajmziu/image/upload/v1764500236/file_kistjf.png", "resource_type": "image"}', '43b778b0-2062-4724-abbb-916a4835a9b0', 'false', '2025-11-30 10:57:17.268748+00', '2025-11-30 10:57:17.268755+00', null, 'cloudinary');
+

docs/devlogs/server/runtimeerror.txt

@@ -1,137 +1,95 @@
-===== Application Startup at 2025-11-30 10:44:27 =====
+===== Application Startup at 2025-11-30 11:44:53 =====
 
 INFO:     Started server process [7]
 INFO:     Waiting for application startup.
-INFO: 2025-11-30T10:44:39 - app.main: ============================================================
-INFO: 2025-11-30T10:44:39 - app.main: 🚀 SwiftOps API v1.0.0 | PRODUCTION
-INFO: 2025-11-30T10:44:39 - app.main: 📊 Dashboard: Enabled
-INFO: 2025-11-30T10:44:39 - app.main: ============================================================
-INFO: 2025-11-30T10:44:39 - app.main: 📦 Database:
-INFO: 2025-11-30T10:44:39 - app.main:    ✓ Connected | 44 tables | 6 users
-INFO: 2025-11-30T10:44:39 - app.main: 💾 Cache & Sessions:
-INFO: 2025-11-30T10:44:40 - app.services.otp_service: ✅ OTP Service initialized with Redis storage
-INFO: 2025-11-30T10:44:40 - app.main:    ✓ Redis: Connected
-INFO: 2025-11-30T10:44:40 - app.main: 🔌 External Services:
-INFO: 2025-11-30T10:44:41 - app.main:    ✓ Cloudinary: Connected
-INFO: 2025-11-30T10:44:41 - app.main:    ✓ Resend: Configured
-INFO: 2025-11-30T10:44:41 - app.main:    ○ WASender: Failed
-INFO: 2025-11-30T10:44:41 - app.main:    ✓ Supabase: Connected | 6 buckets
-INFO: 2025-11-30T10:44:41 - app.main: ============================================================
-INFO: 2025-11-30T10:44:41 - app.main: ✅ Startup complete | Ready to serve requests
-INFO: 2025-11-30T10:44:41 - app.main: ============================================================
+INFO: 2025-11-30T11:45:08 - app.main: ============================================================
+INFO: 2025-11-30T11:45:08 - app.main: 🚀 SwiftOps API v1.0.0 | PRODUCTION
+INFO: 2025-11-30T11:45:08 - app.main: 📊 Dashboard: Enabled
+INFO: 2025-11-30T11:45:08 - app.main: ============================================================
+INFO: 2025-11-30T11:45:08 - app.main: 📦 Database:
+INFO: 2025-11-30T11:45:08 - app.main:    ✓ Connected | 44 tables | 6 users
+INFO: 2025-11-30T11:45:08 - app.main: 💾 Cache & Sessions:
+INFO: 2025-11-30T11:45:09 - app.services.otp_service: ✅ OTP Service initialized with Redis storage
+INFO: 2025-11-30T11:45:09 - app.main:    ✓ Redis: Connected
+INFO: 2025-11-30T11:45:09 - app.main: 🔌 External Services:
+INFO: 2025-11-30T11:45:10 - app.main:    ✓ Cloudinary: Connected
+INFO: 2025-11-30T11:45:10 - app.main:    ✓ Resend: Configured
+INFO: 2025-11-30T11:45:10 - app.main:    ○ WASender: Failed
+INFO: 2025-11-30T11:45:10 - app.main:    ✓ Supabase: Connected | 6 buckets
 INFO:     Application startup complete.
+INFO: 2025-11-30T11:45:10 - app.main: ============================================================
+INFO: 2025-11-30T11:45:10 - app.main: ✅ Startup complete | Ready to serve requests
+INFO: 2025-11-30T11:45:10 - app.main: ============================================================
 INFO:     Uvicorn running on http://0.0.0.0:7860 (Press CTRL+C to quit)
-INFO: 2025-11-30T10:44:46 - app.api.deps: Checking active user: 43b778b0-2062-4724-abbb-916a4835a9b0, is_active: True, type: <class 'bool'>
-INFO: 2025-11-30T10:44:46 - app.api.deps: User 43b778b0-2062-4724-abbb-916a4835a9b0 is active - proceeding
-INFO:     10.16.11.176:44468 - "GET /api/v1/auth/me HTTP/1.1" 200 OK
-INFO:     10.16.34.155:33289 - "GET /health HTTP/1.1" 200 OK
-INFO: 2025-11-30T10:44:46 - app.api.deps: Checking active user: 43b778b0-2062-4724-abbb-916a4835a9b0, is_active: True, type: <class 'bool'>
-INFO: 2025-11-30T10:44:46 - app.api.deps: User 43b778b0-2062-4724-abbb-916a4835a9b0 is active - proceeding
-INFO:     10.16.11.176:44468 - "GET /api/v1/auth/me/preferences/available-apps HTTP/1.1" 200 OK
-INFO: 2025-11-30T10:44:46 - app.api.deps: Checking active user: 43b778b0-2062-4724-abbb-916a4835a9b0, is_active: True, type: <class 'bool'>
-INFO: 2025-11-30T10:44:46 - app.api.deps: User 43b778b0-2062-4724-abbb-916a4835a9b0 is active - proceeding
-INFO:     10.16.25.209:26712 - "GET /api/v1/auth/me/preferences HTTP/1.1" 200 OK
-INFO:     10.16.25.209:48972 - "GET /api/v1/tickets/f59b29fc-d0b9-4618-b0d1-889e340da612/detail HTTP/1.1" 200 OK
-INFO:     10.16.25.209:2106 - "GET /health HTTP/1.1" 200 OK
-INFO:     10.16.6.70:56240 - "GET /health HTTP/1.1" 200 OK
-INFO: 2025-11-30T10:45:35 - app.api.deps: Checking active user: 43b778b0-2062-4724-abbb-916a4835a9b0, is_active: True, type: <class 'bool'>
-INFO: 2025-11-30T10:45:35 - app.api.deps: User 43b778b0-2062-4724-abbb-916a4835a9b0 is active - proceeding
-INFO:     10.16.34.155:28174 - "GET /api/v1/auth/me HTTP/1.1" 200 OK
-INFO:     10.16.6.70:4951 - "GET /health HTTP/1.1" 200 OK
-INFO: 2025-11-30T10:45:35 - app.api.deps: Checking active user: 43b778b0-2062-4724-abbb-916a4835a9b0, is_active: True, type: <class 'bool'>
-INFO: 2025-11-30T10:45:35 - app.api.deps: User 43b778b0-2062-4724-abbb-916a4835a9b0 is active - proceeding
-INFO:     10.16.34.155:28174 - "GET /api/v1/auth/me/preferences HTTP/1.1" 200 OK
-INFO: 2025-11-30T10:45:35 - app.api.deps: Checking active user: 43b778b0-2062-4724-abbb-916a4835a9b0, is_active: True, type: <class 'bool'>
-INFO: 2025-11-30T10:45:35 - app.api.deps: User 43b778b0-2062-4724-abbb-916a4835a9b0 is active - proceeding
-INFO:     10.16.25.209:63687 - "GET /api/v1/auth/me/preferences/available-apps HTTP/1.1" 200 OK
-INFO:     10.16.11.176:12875 - "GET /api/v1/tickets/f59b29fc-d0b9-4618-b0d1-889e340da612/detail HTTP/1.1" 200 OK
-INFO:     10.16.18.114:44621 - "GET /health HTTP/1.1" 200 OK
-INFO:     10.16.34.155:18720 - "GET /health HTTP/1.1" 200 OK
-INFO:     10.16.6.70:37291 - "GET /health HTTP/1.1" 200 OK
-INFO:     10.16.6.70:37464 - "GET /health HTTP/1.1" 200 OK
-INFO:     10.16.6.70:61632 - "GET /health HTTP/1.1" 200 OK
-INFO:     10.16.6.70:49849 - "GET /health HTTP/1.1" 200 OK
-INFO:     10.16.18.114:45207 - "GET /health HTTP/1.1" 200 OK
-INFO:     10.16.11.176:1595 - "GET /health HTTP/1.1" 200 OK
-INFO:     10.16.6.70:20115 - "GET /health HTTP/1.1" 200 OK
-INFO:     10.16.18.114:13081 - "GET /health HTTP/1.1" 200 OK
-INFO:     10.16.25.209:4876 - "GET /health HTTP/1.1" 200 OK
-INFO:     10.16.6.70:4890 - "GET /health HTTP/1.1" 200 OK
-INFO: 2025-11-30T10:49:04 - app.api.deps: Checking active user: 43b778b0-2062-4724-abbb-916a4835a9b0, is_active: True, type: <class 'bool'>
-INFO: 2025-11-30T10:49:04 - app.api.deps: User 43b778b0-2062-4724-abbb-916a4835a9b0 is active - proceeding
-INFO:     10.16.34.155:32608 - "GET /api/v1/auth/me/preferences/available-apps HTTP/1.1" 200 OK
-INFO:     10.16.25.209:56255 - "GET /health HTTP/1.1" 200 OK
-INFO: 2025-11-30T10:49:04 - app.api.deps: Checking active user: 43b778b0-2062-4724-abbb-916a4835a9b0, is_active: True, type: <class 'bool'>
-INFO: 2025-11-30T10:49:04 - app.api.deps: User 43b778b0-2062-4724-abbb-916a4835a9b0 is active - proceeding
-INFO:     10.16.11.176:20419 - "GET /api/v1/auth/me/preferences HTTP/1.1" 200 OK
-INFO:     10.16.34.155:17206 - "GET /health HTTP/1.1" 200 OK
-INFO:     10.16.18.114:24637 - "GET /health HTTP/1.1" 200 OK
-INFO:     10.16.34.155:43834 - "GET /health HTTP/1.1" 200 OK
-INFO:     10.16.11.176:39270 - "GET / HTTP/1.1" 200 OK
-INFO:     10.16.6.70:24221 - "GET /health HTTP/1.1" 200 OK
-INFO:     10.16.25.209:58970 - "GET /health HTTP/1.1" 200 OK
-INFO:     10.16.11.176:23159 - "GET /health HTTP/1.1" 200 OK
-INFO:     10.16.11.176:39192 - "GET /health HTTP/1.1" 200 OK
-INFO:     10.16.11.176:19174 - "GET /health HTTP/1.1" 200 OK
-INFO:     10.16.11.176:19174 - "GET /health HTTP/1.1" 200 OK
-INFO:     10.16.34.155:63357 - "GET /health HTTP/1.1" 200 OK
-INFO:     10.16.11.176:31952 - "GET /health HTTP/1.1" 200 OK
-INFO:     10.16.11.176:43886 - "GET /health HTTP/1.1" 200 OK
-INFO:     10.16.34.155:45381 - "GET /health HTTP/1.1" 200 OK
-INFO:     10.16.25.209:23771 - "GET /health HTTP/1.1" 200 OK
-INFO:     10.16.25.209:63336 - "GET /health HTTP/1.1" 200 OK
-INFO:     10.16.25.209:64141 - "GET /health HTTP/1.1" 200 OK
-INFO:     10.16.6.70:48596 - "GET /health HTTP/1.1" 200 OK
-INFO:     10.16.6.70:13091 - "GET /health HTTP/1.1" 200 OK
-INFO:     10.16.18.114:2584 - "GET /health HTTP/1.1" 200 OK
-INFO:     10.16.6.70:49060 - "GET /health HTTP/1.1" 200 OK
-INFO:     10.16.11.176:45525 - "GET /health HTTP/1.1" 200 OK
-INFO:     10.16.25.209:12389 - "GET /health HTTP/1.1" 200 OK
-INFO:     10.16.6.70:8793 - "GET /health HTTP/1.1" 200 OK
-INFO:     10.16.25.209:30861 - "GET /health HTTP/1.1" 200 OK
-INFO:     10.16.25.209:30861 - "GET /health HTTP/1.1" 200 OK
-INFO:     10.16.18.114:22088 - "GET /health HTTP/1.1" 200 OK
-INFO: 2025-11-30T10:55:21 - app.api.deps: Checking active user: 43b778b0-2062-4724-abbb-916a4835a9b0, is_active: True, type: <class 'bool'>
-INFO: 2025-11-30T10:55:21 - app.api.deps: User 43b778b0-2062-4724-abbb-916a4835a9b0 is active - proceeding
-INFO:     10.16.34.155:29232 - "GET /api/v1/auth/me HTTP/1.1" 200 OK
-INFO: 2025-11-30T10:55:22 - app.api.deps: Checking active user: 43b778b0-2062-4724-abbb-916a4835a9b0, is_active: True, type: <class 'bool'>
-INFO: 2025-11-30T10:55:22 - app.api.deps: User 43b778b0-2062-4724-abbb-916a4835a9b0 is active - proceeding
-INFO:     10.16.34.155:29232 - "GET /api/v1/auth/me/preferences HTTP/1.1" 200 OK
-INFO: 2025-11-30T10:55:22 - app.api.deps: Checking active user: 43b778b0-2062-4724-abbb-916a4835a9b0, is_active: True, type: <class 'bool'>
-INFO: 2025-11-30T10:55:22 - app.api.deps: User 43b778b0-2062-4724-abbb-916a4835a9b0 is active - proceeding
-INFO:     10.16.34.155:37709 - "GET /api/v1/auth/me/preferences/available-apps HTTP/1.1" 200 OK
-INFO:     10.16.18.114:22088 - "GET /api/v1/tickets/f59b29fc-d0b9-4618-b0d1-889e340da612/detail HTTP/1.1" 200 OK
-INFO:     10.16.6.70:17441 - "GET /health HTTP/1.1" 200 OK
-INFO:     10.16.18.114:26540 - "POST /api/v1/ticket-assignments/assignments/a82a3824-f4f1-4283-a2e3-8c348dbb28ce/start-journey HTTP/1.1" 200 OK
-INFO:     10.16.6.70:14508 - "GET /api/v1/tickets/f59b29fc-d0b9-4618-b0d1-889e340da612/detail HTTP/1.1" 200 OK
-INFO:     10.16.11.176:20636 - "POST /api/v1/ticket-assignments/assignments/a82a3824-f4f1-4283-a2e3-8c348dbb28ce/update-location HTTP/1.1" 200 OK
-INFO:     10.16.11.176:17733 - "GET /health HTTP/1.1" 200 OK
-INFO:     10.16.18.114:40864 - "POST /api/v1/ticket-assignments/assignments/a82a3824-f4f1-4283-a2e3-8c348dbb28ce/update-location HTTP/1.1" 200 OK
-INFO:     10.16.34.155:18221 - "POST /api/v1/ticket-assignments/assignments/a82a3824-f4f1-4283-a2e3-8c348dbb28ce/arrived HTTP/1.1" 200 OK
-INFO:     10.16.6.70:41146 - "GET /api/v1/tickets/f59b29fc-d0b9-4618-b0d1-889e340da612/detail HTTP/1.1" 200 OK
-INFO:     10.16.11.176:54402 - "GET /health HTTP/1.1" 200 OK
-INFO:     10.16.34.155:39104 - "GET /api/v1/tickets/f59b29fc-d0b9-4618-b0d1-889e340da612/completion-checklist HTTP/1.1" 200 OK
-INFO:     10.16.25.209:18778 - "GET /health HTTP/1.1" 200 OK
-INFO: 2025-11-30T10:57:16 - app.services.media_service: Using forced provider: cloudinary
-INFO: 2025-11-30T10:57:16 - app.services.media_service: Uploading Gemini_Generated_Image_anof4fanof4fanof-removebg-preview.png (image/png) to cloudinary
-INFO: 2025-11-30T10:57:17 - app.integrations.cloudinary: Uploaded file to Cloudinary: https://res.cloudinary.com/dnhajmziu/image/upload/v1764500236/file_kistjf.png
-INFO: 2025-11-30T10:57:17 - app.services.media_service: Document created: e76d848f-640a-4998-9a2c-948d4bc94d77 (version 1)
-INFO: 2025-11-30T10:57:17 - app.services.ticket_completion_service: Photos updated for ticket f59b29fc-d0b9-4618-b0d1-889e340da612: ['Airtel network']
-INFO:     10.16.18.114:36731 - "POST /api/v1/tickets/f59b29fc-d0b9-4618-b0d1-889e340da612/upload-photos HTTP/1.1" 200 OK
-INFO: 2025-11-30T10:57:17 - app.services.media_service: Using forced provider: cloudinary
-INFO: 2025-11-30T10:57:17 - app.services.media_service: Uploading passport 2025-11-27 101849.png (image/png) to cloudinary
-INFO: 2025-11-30T10:57:18 - app.integrations.cloudinary: Uploaded file to Cloudinary: https://res.cloudinary.com/dnhajmziu/image/upload/v1764500237/file_a6bhg3.png
-INFO: 2025-11-30T10:57:18 - app.services.media_service: Document created: 28e39514-4ffd-44f3-8a38-3972597264a3 (version 1)
-INFO: 2025-11-30T10:57:18 - app.services.ticket_completion_service: Photos updated for ticket f59b29fc-d0b9-4618-b0d1-889e340da612: ['Speedtest']
-INFO:     10.16.34.155:33974 - "POST /api/v1/tickets/f59b29fc-d0b9-4618-b0d1-889e340da612/upload-photos HTTP/1.1" 200 OK
-INFO: 2025-11-30T10:57:18 - app.services.media_service: Using forced provider: cloudinary
-INFO: 2025-11-30T10:57:18 - app.services.media_service: Uploading Screenshot_20251111-113721.png (image/png) to cloudinary
-INFO: 2025-11-30T10:57:18 - app.integrations.cloudinary: Uploaded file to Cloudinary: https://res.cloudinary.com/dnhajmziu/image/upload/v1764500238/file_ejhwnj.png
-INFO: 2025-11-30T10:57:18 - app.services.media_service: Document created: 03b98bf0-00bf-489b-b82e-b5ac8ed93ff1 (version 1)
-INFO: 2025-11-30T10:57:18 - app.services.ticket_completion_service: Photos updated for ticket f59b29fc-d0b9-4618-b0d1-889e340da612: ['ODU outdoor image']
-INFO:     10.16.11.176:21259 - "POST /api/v1/tickets/f59b29fc-d0b9-4618-b0d1-889e340da612/upload-photos HTTP/1.1" 200 OK
-INFO:     10.16.11.176:21259 - "GET /api/v1/tickets/f59b29fc-d0b9-4618-b0d1-889e340da612/completion-checklist HTTP/1.1" 200 OK
-INFO:     10.16.6.70:11342 - "GET /health HTTP/1.1" 200 OK
-INFO:     10.16.6.70:42258 - "POST /api/v1/tickets/f59b29fc-d0b9-4618-b0d1-889e340da612/activation-data HTTP/1.1" 404 Not Found
-INFO:     10.16.11.176:27978 - "GET /health HTTP/1.1" 200 OK
- 
+INFO:     10.16.11.176:29788 - "GET /health HTTP/1.1" 200 OK
+INFO:     10.16.6.70:65359 - "GET /health HTTP/1.1" 200 OK
+INFO: 2025-11-30T11:45:23 - app.api.deps: Checking active user: 43b778b0-2062-4724-abbb-916a4835a9b0, is_active: True, type: <class 'bool'>
+INFO: 2025-11-30T11:45:23 - app.api.deps: User 43b778b0-2062-4724-abbb-916a4835a9b0 is active - proceeding
+INFO:     10.16.11.176:21546 - "GET /api/v1/auth/me HTTP/1.1" 200 OK
+INFO: 2025-11-30T11:45:24 - app.api.deps: Checking active user: 43b778b0-2062-4724-abbb-916a4835a9b0, is_active: True, type: <class 'bool'>
+INFO: 2025-11-30T11:45:24 - app.api.deps: User 43b778b0-2062-4724-abbb-916a4835a9b0 is active - proceeding
+INFO:     10.16.11.176:21546 - "GET /api/v1/auth/me/preferences HTTP/1.1" 200 OK
+INFO: 2025-11-30T11:45:25 - app.api.deps: Checking active user: 43b778b0-2062-4724-abbb-916a4835a9b0, is_active: True, type: <class 'bool'>
+INFO: 2025-11-30T11:45:25 - app.api.deps: User 43b778b0-2062-4724-abbb-916a4835a9b0 is active - proceeding
+INFO:     10.16.25.209:44475 - "GET /api/v1/auth/me/preferences/available-apps HTTP/1.1" 200 OK
+INFO:     10.16.18.114:8849 - "GET /api/v1/tickets/f59b29fc-d0b9-4618-b0d1-889e340da612/detail HTTP/1.1" 500 Internal Server Error
+ERROR:    Exception in ASGI application
+Traceback (most recent call last):
+  File "/usr/local/lib/python3.11/site-packages/uvicorn/protocols/http/httptools_impl.py", line 426, in run_asgi
+    result = await app(  # type: ignore[func-returns-value]
+             ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+  File "/usr/local/lib/python3.11/site-packages/uvicorn/middleware/proxy_headers.py", line 84, in __call__
+    return await self.app(scope, receive, send)
+           ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+  File "/usr/local/lib/python3.11/site-packages/fastapi/applications.py", line 1106, in __call__
+    await super().__call__(scope, receive, send)
+  File "/usr/local/lib/python3.11/site-packages/starlette/applications.py", line 122, in __call__
+    await self.middleware_stack(scope, receive, send)
+  File "/usr/local/lib/python3.11/site-packages/starlette/middleware/errors.py", line 184, in __call__
+    raise exc
+  File "/usr/local/lib/python3.11/site-packages/starlette/middleware/errors.py", line 162, in __call__
+    await self.app(scope, receive, _send)
+  File "/usr/local/lib/python3.11/site-packages/starlette/middleware/cors.py", line 91, in __call__
+    await self.simple_response(scope, receive, send, request_headers=headers)
+  File "/usr/local/lib/python3.11/site-packages/starlette/middleware/cors.py", line 146, in simple_response
+    await self.app(scope, receive, send)
+  File "/usr/local/lib/python3.11/site-packages/starlette/middleware/exceptions.py", line 79, in __call__
+    raise exc
+  File "/usr/local/lib/python3.11/site-packages/starlette/middleware/exceptions.py", line 68, in __call__
+    await self.app(scope, receive, sender)
+  File "/usr/local/lib/python3.11/site-packages/fastapi/middleware/asyncexitstack.py", line 20, in __call__
+    raise e
+  File "/usr/local/lib/python3.11/site-packages/fastapi/middleware/asyncexitstack.py", line 17, in __call__
+    await self.app(scope, receive, send)
+  File "/usr/local/lib/python3.11/site-packages/starlette/routing.py", line 718, in __call__
+    await route.handle(scope, receive, send)
+  File "/usr/local/lib/python3.11/site-packages/starlette/routing.py", line 276, in handle
+    await self.app(scope, receive, send)
+  File "/usr/local/lib/python3.11/site-packages/starlette/routing.py", line 66, in app
+    response = await func(request)
+               ^^^^^^^^^^^^^^^^^^^
+  File "/usr/local/lib/python3.11/site-packages/fastapi/routing.py", line 274, in app
+    raw_response = await run_endpoint_function(
+                   ^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+  File "/usr/local/lib/python3.11/site-packages/fastapi/routing.py", line 193, in run_endpoint_function
+    return await run_in_threadpool(dependant.call, **values)
+           ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+  File "/usr/local/lib/python3.11/site-packages/starlette/concurrency.py", line 41, in run_in_threadpool
+    return await anyio.to_thread.run_sync(func, *args)
+           ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+  File "/usr/local/lib/python3.11/site-packages/anyio/to_thread.py", line 33, in run_sync
+    return await get_asynclib().run_sync_in_worker_thread(
+           ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+  File "/usr/local/lib/python3.11/site-packages/anyio/_backends/_asyncio.py", line 877, in run_sync_in_worker_thread
+    return await future
+           ^^^^^^^^^^^^
+  File "/usr/local/lib/python3.11/site-packages/anyio/_backends/_asyncio.py", line 807, in run
+    result = context.run(func, *args)
+             ^^^^^^^^^^^^^^^^^^^^^^^^
+  File "/app/src/app/api/v1/tickets.py", line 660, in get_ticket_detail
+    response["images"] = [{
+                         ^^
+  File "/app/src/app/api/v1/tickets.py", line 662, in <listcomp>
+    "image_url": img.image_url,
+                 ^^^^^^^^^^^^^
+AttributeError: 'TicketImage' object has no attribute 'image_url'

src/app/api/v1/tickets.py

@@ -651,18 +651,21 @@ def get_ticket_detail(
         "created_at": exp.created_at.isoformat() if exp.created_at else None
     } for exp in expenses]
     
-    # Get images
-    images = db.query(TicketImage).filter(
+    # Get images with document relationship
+    images = db.query(TicketImage).options(
+        joinedload(TicketImage.document)
+    ).filter(
         TicketImage.ticket_id == ticket_id,
         TicketImage.deleted_at.is_(None)
     ).order_by(TicketImage.created_at.desc()).all()
     
     response["images"] = [{
         "id": str(img.id),
-        "image_url": img.image_url,
+        "image_url": img.document.file_url if img.document else None,
         "image_type": img.image_type,
-        "caption": img.caption,
-        "uploaded_by_user_id": str(img.uploaded_by_user_id) if img.uploaded_by_user_id else None,
+        "description": img.description,
+        "captured_at": img.captured_at.isoformat() if img.captured_at else None,
+        "uploaded_by_user_id": str(img.captured_by_user_id) if img.captured_by_user_id else None,
         "created_at": img.created_at.isoformat() if img.created_at else None
     } for img in images]
     

src/app/integrations/cloudinary.py

@@ -58,7 +58,8 @@ class CloudinaryService:
         file: UploadFile,
         entity_type: str,
         entity_id: str,
-        document_type: str
+        document_type: str,
+        contextual_filename: str = None
     ) -> Dict[str, Any]:
         """
         Upload file to Cloudinary
@@ -68,6 +69,7 @@ class CloudinaryService:
             entity_type: Type of entity (user, ticket, etc.)
             entity_id: ID of the entity
             document_type: Type of document (profile_photo, ticket_image, etc.)
+            contextual_filename: Optional contextual filename (without extension)
         
         Returns:
             Dict containing upload response with secure_url, public_id, etc.
@@ -91,16 +93,29 @@ class CloudinaryService:
             # Get folder path
             folder = CloudinaryService.get_folder_path(entity_type)
             
+            # Prepare upload options
+            upload_options = {
+                'asset_folder': folder,  # Where it appears in Media Library
+                'overwrite': False,
+                'resource_type': resource_type,
+                'tags': [entity_type, document_type, str(entity_id)]  # For searching
+            }
+            
+            # Use contextual filename if provided, otherwise use original with unique suffix
+            if contextual_filename:
+                # Use contextual filename as public_id (Cloudinary will add folder prefix)
+                upload_options['public_id'] = contextual_filename
+                upload_options['use_filename'] = False
+                upload_options['unique_filename'] = False
+            else:
+                # Fallback to original filename with unique suffix
+                upload_options['use_filename'] = True
+                upload_options['unique_filename'] = True
+            
             # Upload to Cloudinary
-            # Using asset_folder for organization and letting Cloudinary generate unique public_id
             upload_result = cloudinary.uploader.upload(
                 file_content,
-                asset_folder=folder,  # Where it appears in Media Library
-                use_filename=True,
-                unique_filename=True,  # Prevents collisions
-                overwrite=False,
-                resource_type=resource_type,
-                tags=[entity_type, document_type, str(entity_id)]  # For searching
+                **upload_options
             )
             
             logger.info(f"Uploaded file to Cloudinary: {upload_result.get('secure_url')}")

src/app/integrations/supabase.py

@@ -44,17 +44,19 @@ class SupabaseStorageService:
     def get_file_path(entity_type: str, entity_id: str, file_name: str) -> str:
         """
         Generate file path in bucket
-        Format: {entity_type}/{entity_id}/{unique_id}_{filename}
+        Format: {entity_type}/{entity_id}/{filename}
+        
+        Note: filename should already be contextual and unique from FileNamingService
         """
-        unique_id = str(uuid.uuid4())[:8]
-        return f"{entity_type}/{entity_id}/{unique_id}_{file_name}"
+        return f"{entity_type}/{entity_id}/{file_name}"
     
     @staticmethod
     async def upload(
         file: UploadFile,
         entity_type: str,
         entity_id: str,
-        document_type: str
+        document_type: str,
+        contextual_filename: str = None
     ) -> Dict[str, Any]:
         """
         Upload file to Supabase Storage
@@ -64,6 +66,7 @@ class SupabaseStorageService:
             entity_type: Type of entity (user, ticket, etc.)
             entity_id: ID of the entity
             document_type: Type of document
+            contextual_filename: Optional contextual filename to use instead of original
         
         Returns:
             Dict containing upload response with public URL
@@ -77,9 +80,12 @@ class SupabaseStorageService:
             # Read file content
             file_content = await file.read()
             
+            # Use contextual filename if provided, otherwise use original
+            filename_to_use = contextual_filename if contextual_filename else file.filename
+            
             # Get bucket and file path
             bucket_name = SupabaseStorageService.get_bucket_name(entity_type)
-            file_path = SupabaseStorageService.get_file_path(entity_type, entity_id, file.filename)
+            file_path = SupabaseStorageService.get_file_path(entity_type, entity_id, filename_to_use)
             
             # Upload to Supabase Storage
             response = client.storage.from_(bucket_name).upload(

src/app/services/media_service.py

@@ -4,14 +4,16 @@ Routes uploads to appropriate storage provider based on file type
 """
 from fastapi import UploadFile, HTTPException
 from sqlalchemy.orm import Session
-from typing import Dict, Any
+from typing import Dict, Any, Optional
 from uuid import UUID
 import logging
+from pathlib import Path
 
 from app.integrations.cloudinary import CloudinaryService
 from app.integrations.supabase import SupabaseStorageService
 from app.models.document import Document
 from app.models.user import User
+from app.utils.file_naming import FileNamingService
 
 logger = logging.getLogger(__name__)
 
@@ -60,7 +62,8 @@ class StorageService:
         uploaded_by_user_id: UUID,
         db: Session,
         force_provider: str = None,
-        enable_versioning: bool = True
+        enable_versioning: bool = True,
+        additional_context: Optional[str] = None
     ) -> Document:
         """
         Universal file upload handler with automatic fallback
@@ -92,10 +95,22 @@ class StorageService:
             HTTPException: If both providers fail
         """
         try:
+            # Generate contextual filename (without extension)
+            contextual_filename = FileNamingService.generate_contextual_filename(
+                entity_type=entity_type,
+                entity_id=entity_id,
+                document_type=document_type,
+                original_filename=file.filename,
+                additional_context=additional_context
+            )
+            
+            # Remove extension for Cloudinary public_id (Cloudinary adds it back)
+            contextual_filename_no_ext = Path(contextual_filename).stem
+            
             # Determine primary provider
             provider = StorageService.determine_provider(file.content_type, force_provider)
             
-            logger.info(f"Uploading {file.filename} ({file.content_type}) to {provider}")
+            logger.info(f"Uploading {file.filename} as {contextual_filename} to {provider}")
             
             # Try primary provider with fallback
             upload_result = None
@@ -109,7 +124,8 @@ class StorageService:
                         file=file,
                         entity_type=entity_type,
                         entity_id=str(entity_id),
-                        document_type=document_type
+                        document_type=document_type,
+                        contextual_filename=contextual_filename_no_ext
                     )
                     file_url = upload_result['secure_url']
                     file_size = upload_result.get('bytes')
@@ -128,7 +144,8 @@ class StorageService:
                             file=file,
                             entity_type=entity_type,
                             entity_id=str(entity_id),
-                            document_type=document_type
+                            document_type=document_type,
+                            contextual_filename=contextual_filename
                         )
                         file_url = upload_result['public_url']
                         file_size = upload_result.get('size')
@@ -151,7 +168,8 @@ class StorageService:
                     file=file,
                     entity_type=entity_type,
                     entity_id=str(entity_id),
-                    document_type=document_type
+                    document_type=document_type,
+                    contextual_filename=contextual_filename
                 )
                 file_url = upload_result['public_url']
                 file_size = upload_result.get('size')
@@ -178,11 +196,11 @@ class StorageService:
                     version_number = existing_doc.version + 1
                     logger.info(f"Creating version {version_number} (previous: {existing_doc.id})")
             
-            # Create document record
+            # Create document record with contextual filename
             document = Document(
                 entity_type=entity_type,
                 entity_id=entity_id,
-                file_name=file.filename,
+                file_name=contextual_filename,  # Store contextual name, not original
                 file_type=file.content_type,
                 file_size=file_size,
                 file_url=file_url,
@@ -191,7 +209,11 @@ class StorageService:
                 document_category=document_category,
                 description=description,
                 tags=tags,
-                additional_metadata=additional_metadata,
+                additional_metadata={
+                    **additional_metadata,
+                    'original_filename': file.filename,  # Preserve original name
+                    'contextual_filename': contextual_filename
+                },
                 uploaded_by_user_id=uploaded_by_user_id,
                 is_public=is_public,
                 version=version_number,

src/app/services/ticket_completion_service.py

@@ -239,7 +239,7 @@ class TicketCompletionService:
         # Upload photos using media_service.py (routes to Cloudinary for images)
         for photo_type, files in photos.items():
             for file in files:
-                # Upload via universal storage service
+                # Upload via universal storage service with contextual naming
                 document = await StorageService.upload_file(
                     file=file,
                     entity_type="ticket",
@@ -252,7 +252,8 @@ class TicketCompletionService:
                     uploaded_by_user_id=uploaded_by_user_id,
                     db=db,
                     force_provider="cloudinary",  # Force Cloudinary for photos
-                    enable_versioning=False
+                    enable_versioning=False,
+                    additional_context=photo_type  # Add photo type to filename
                 )
                 
                 # Create ticket_image record linking ticket to document

src/app/utils/file_naming.py

@@ -0,0 +1,211 @@
+"""
+File Naming Utility
+
+Generates contextual, self-documenting filenames for object storage.
+Makes files easily identifiable even if database is lost.
+
+Naming Pattern:
+{entity_type}_{entity_short_id}_{document_type}_{timestamp}_{original_name}
+
+Examples:
+- ticket_8f08ad14_completion_photo_speedtest_20251130_105718.png
+- user_43b778b0_profile_photo_20251130_105718.jpg
+- expense_decafa10_receipt_20251130_105718.pdf
+- project_0ade6bd1_contract_20251130_105718.pdf
+"""
+
+from datetime import datetime
+from uuid import UUID
+import re
+from pathlib import Path
+
+
+class FileNamingService:
+    """Service for generating contextual filenames"""
+    
+    @staticmethod
+    def sanitize_filename(filename: str) -> str:
+        """
+        Sanitize filename to be filesystem and URL safe
+        
+        - Remove special characters
+        - Replace spaces with underscores
+        - Lowercase
+        - Keep only alphanumeric, underscore, hyphen, dot
+        """
+        # Get filename without extension
+        stem = Path(filename).stem
+        ext = Path(filename).suffix
+        
+        # Remove special characters, keep alphanumeric, underscore, hyphen
+        stem = re.sub(r'[^\w\-]', '_', stem)
+        
+        # Replace multiple underscores with single
+        stem = re.sub(r'_+', '_', stem)
+        
+        # Lowercase and strip
+        stem = stem.lower().strip('_')
+        
+        # Limit length to 50 chars
+        if len(stem) > 50:
+            stem = stem[:50]
+        
+        return f"{stem}{ext.lower()}"
+    
+    @staticmethod
+    def get_short_id(entity_id: UUID) -> str:
+        """
+        Get short version of UUID for filename (first 8 chars)
+        
+        Example: 8f08ad14-df8b-4780-84e7-0d45e133f2a6 -> 8f08ad14
+        """
+        return str(entity_id).split('-')[0]
+    
+    @staticmethod
+    def get_timestamp() -> str:
+        """
+        Get timestamp for filename in format: YYYYMMDD_HHMMSS
+        
+        Example: 20251130_105718
+        """
+        return datetime.utcnow().strftime('%Y%m%d_%H%M%S')
+    
+    @staticmethod
+    def generate_contextual_filename(
+        entity_type: str,
+        entity_id: UUID,
+        document_type: str,
+        original_filename: str,
+        additional_context: str = None
+    ) -> str:
+        """
+        Generate contextual, self-documenting filename
+        
+        Args:
+            entity_type: Type of entity (ticket, user, expense, etc.)
+            entity_id: UUID of the entity
+            document_type: Type of document (completion_photo, receipt, profile_photo, etc.)
+            original_filename: Original uploaded filename
+            additional_context: Optional additional context (photo_type, etc.)
+        
+        Returns:
+            Contextual filename
+        
+        Examples:
+            ticket_8f08ad14_completion_photo_speedtest_20251130_105718.png
+            user_43b778b0_profile_photo_20251130_105718.jpg
+            expense_decafa10_receipt_fuel_20251130_105718.pdf
+        """
+        # Get components
+        short_id = FileNamingService.get_short_id(entity_id)
+        timestamp = FileNamingService.get_timestamp()
+        sanitized_original = FileNamingService.sanitize_filename(original_filename)
+        
+        # Remove extension from original for now
+        original_stem = Path(sanitized_original).stem
+        extension = Path(sanitized_original).suffix
+        
+        # Build filename parts
+        parts = [
+            entity_type.lower(),
+            short_id,
+            document_type.lower().replace(' ', '_')
+        ]
+        
+        # Add additional context if provided
+        if additional_context:
+            sanitized_context = re.sub(r'[^\w\-]', '_', additional_context.lower())
+            parts.append(sanitized_context)
+        
+        # Add timestamp
+        parts.append(timestamp)
+        
+        # Add original filename (without extension) if it's meaningful
+        # Skip if it's generic like "image", "photo", "file", "screenshot"
+        generic_names = ['image', 'photo', 'file', 'screenshot', 'document', 'img', 'pic']
+        if original_stem and original_stem.lower() not in generic_names:
+            # Limit original name to 30 chars
+            if len(original_stem) > 30:
+                original_stem = original_stem[:30]
+            parts.append(original_stem)
+        
+        # Join parts and add extension
+        filename = '_'.join(parts) + extension
+        
+        return filename
+    
+    @staticmethod
+    def generate_ticket_photo_filename(
+        ticket_id: UUID,
+        photo_type: str,
+        original_filename: str
+    ) -> str:
+        """
+        Generate filename for ticket completion photos
+        
+        Example: ticket_8f08ad14_completion_photo_speedtest_20251130_105718.png
+        """
+        return FileNamingService.generate_contextual_filename(
+            entity_type='ticket',
+            entity_id=ticket_id,
+            document_type='completion_photo',
+            original_filename=original_filename,
+            additional_context=photo_type
+        )
+    
+    @staticmethod
+    def generate_expense_receipt_filename(
+        expense_id: UUID,
+        expense_category: str,
+        original_filename: str
+    ) -> str:
+        """
+        Generate filename for expense receipts
+        
+        Example: expense_decafa10_receipt_fuel_20251130_105718.pdf
+        """
+        return FileNamingService.generate_contextual_filename(
+            entity_type='expense',
+            entity_id=expense_id,
+            document_type='receipt',
+            original_filename=original_filename,
+            additional_context=expense_category
+        )
+    
+    @staticmethod
+    def generate_user_document_filename(
+        user_id: UUID,
+        document_type: str,
+        original_filename: str
+    ) -> str:
+        """
+        Generate filename for user documents
+        
+        Examples:
+            user_43b778b0_profile_photo_20251130_105718.jpg
+            user_43b778b0_id_document_20251130_105718.pdf
+        """
+        return FileNamingService.generate_contextual_filename(
+            entity_type='user',
+            entity_id=user_id,
+            document_type=document_type,
+            original_filename=original_filename
+        )
+    
+    @staticmethod
+    def generate_project_document_filename(
+        project_id: UUID,
+        document_type: str,
+        original_filename: str
+    ) -> str:
+        """
+        Generate filename for project documents
+        
+        Example: project_0ade6bd1_contract_20251130_105718.pdf
+        """
+        return FileNamingService.generate_contextual_filename(
+            entity_type='project',
+            entity_id=project_id,
+            document_type=document_type,
+            original_filename=original_filename
+        )