# TODO

## Tasks - API / Backend

| # | Task | Weight | Status |
|---|------|--------|--------|
| 1 | (!) Add internal getter for retrieving invoices from the DHL API | S | todo |
| 2 | (!) Add PDF parsing for DHL invoice uploads in DHLInvoiceApi.ts | M | todo |
| 3 | (!) Add automatic daily DHL invoice sync endpoint | M | todo |
| 4 | Create LostShipmentApi.ts with case CRUD endpoints | M | todo |
| 5 | Add lost shipment document upload to S3 with signed URLs | M | todo |
| 6 | Add `getBigOrdersByShopifyCustomerId` query + `/admin/shop/orders/by-customer/:id` endpoint | S | todo |
| 7 | Add `/admin/analytics/unshipped-reasons` endpoint to categorize orders by blocker | M | todo |
| 8 | Fix `createShipmentRateEstimate` to return all carrier rates and auto-select cheapest | M | todo |
| 9 | Add batch cheapest-rate option to `generateShippingLabelInternal` | S | todo |
| 10 | Create QAToolsApi.ts backend for orchestrated test sequences and cleanup | L | todo |
| 11 | Create config management API for product/customs/shipping data (Roadmap #13) | L | todo |
| 12 | Migrate hardcoded ShopifyData.ts product variant mappings (140+) to DB-driven config | M | todo |
| 13 | Migrate hardcoded customs info (FabricatorSchemas.ts:3100-3605) to DB-driven config | M | todo |
| 14 | Migrate hardcoded shipping package configs (FabricatorSchemas.ts:3640-4011) to DB-driven config | M | todo |

## Tasks - Database

| # | Task | Weight | Status |
|---|------|--------|--------|
| 1 | Create `big_lost_shipment_cases` table in beyond_db_setup.ts | S | todo |
| 2 | Add lost shipment CRUD methods to FabricatorDatabase.ts | S | todo |
| 3 | Create config tables for product variant mappings, customs info, and shipping configs | M | todo |

## Tasks - Frontend

| # | Task | Weight | Status |
|---|------|--------|--------|
| 1 | (!) Connect DHLChargesPage.jsx to real API (replace mock invoice/charge data) | M | todo |
| 2 | Create DHLChargesList.jsx table component for charge discrepancies | S | todo |
| 3 | Create LostShipmentsPage.jsx with case list and filtering | M | todo |
| 4 | Create LostShipmentCase.jsx detail view with document upload | M | todo |
| 5 | Add "Report Lost" button to BigShipment.jsx | S | todo |
| 6 | Add "Related Orders" section to BigOrderComponent.jsx showing same-customer orders | S | todo |
| 7 | Add multi-order indicator to BigOrderTableCells.jsx | S | todo |
| 8 | Add Shopify admin link to BigOrderComponent.jsx and BigOrderTableCells.jsx | S | todo |
| 9 | Create DailyShipmentSummary.jsx with date picker and copy-to-clipboard | M | todo |
| 10 | Integrate Darshan's analytics dashboard into Arda (DarshanDashboard.jsx) | M | todo |
| 11 | Create UnshippedOrdersReport.jsx with blocker categorization | M | todo |
| 12 | Enable rate comparison UI in BigShipment.jsx for multi-carrier selection | S | todo |
| 13 | Add batch cheapest-rate option to BigBatchShipper.jsx | S | todo |
| 14 | Add backend orchestration + test cleanup to FactoryQATools.jsx | M | todo |
| 15 | Create admin UI for editing product/customs/shipping config (Roadmap #13) | L | todo |
| 16 | Update audio files from Jeff and add sound toggle to shipper pages | S | todo |

## Tasks - Routing / Registration

| # | Task | Weight | Status |
|---|------|--------|--------|
| 1 | Register lost shipment API routes in admin_api.ts | S | todo |
| 2 | Register QA tools API routes in admin_api.ts | S | todo |
| 3 | Register config management API routes in admin_api.ts | S | todo |
| 4 | Add nav links: Lost Shipments, Daily Summary, DHL Charges in BigShipperWrapper.jsx | S | todo |
| 5 | Add analytics nav links in AnalyticsWrapper.jsx | S | todo |

## Blocked

| # | Task | Weight | Status |
|---|------|--------|---------|
| 1 | Fix VAT calculation for mixed product orders in ShippingAdminApi.ts:2289-2320 (pending EU warehouse decision) | L | blocked |
| 2 | QC system evaluation: needs team discussion on workflow, metrics, and requirements | L | blocked |

## Archived

| # | Task | Weight | Status | From | Completed |
|---|------|--------|--------|------|-----------|
| 1 | Batch Shipment Page (Roadmap #1) | XL | done | Tasks | 2026-03-10 |
