CargoM8 System Blueprint

flowchart TD subgraph FF["Freight Forwarder"] A[Create Job] -->|"POST /transportjobs\n-2 credits"| B[Job: OPEN] end subgraph MKT["Marketplace"] B --> C{Carriers see job} C -->|Browse / Match| D[Carrier places bid] D -->|"POST /bids\n-1 credit"| E[Bid: PENDING] end subgraph NEG["Negotiation"] E --> F{FF reviews bids} F -->|Accept| G[Bid: ACCEPTED] F -->|Reject| H[Bid: REJECTED] F -->|Counter-offer| I[Counter: PENDING] I -->|Carrier accepts| G I -->|Carrier rejects| H G --> J[Job: IN_PROGRESS] end subgraph EXEC["Execution"] J -->|Auto-create| K[TransportTask: ASSIGNED] K -->|Driver accepts| L[Task: ACCEPTED] L -->|Pickup done| M[Task: IN_TRANSIT] M -->|Delivered| N[Task: DELIVERED] N -->|POD uploaded| O[Task: COMPLETED] O --> P[Job: DELIVERED] P -->|FF confirms| Q[Job: COMPLETED] end subgraph FIN["Financial"] A -->|"Job creation: -2 credits"| R[credit_transactions] D -->|"Bid placement: -1 credit"| R G -->|Fee calculated| S[billing_ledger] Q -->|Invoice generated| T[invoices] end subgraph SIG["Real-time"] D -.->|SignalR| U[BidNotification] G -.->|SignalR| V[AcceptNotification] M -.->|SignalR| W[GPS LiveTracking] end style FF fill:#0F766E,stroke:#14B8A6,color:#fff style MKT fill:#1E3A5F,stroke:#3B82F6,color:#fff style NEG fill:#78350F,stroke:#F59E0B,color:#fff style EXEC fill:#1E3A5F,stroke:#06B6D4,color:#fff style FIN fill:#064E3B,stroke:#10B981,color:#fff style SIG fill:#312E81,stroke:#8B5CF6,color:#fff

flowchart TD subgraph PILOT["Pilot"] A1[Create Flight] -->|"POST /pilot/flights"| B1[Flight: SCHEDULED] B1 --> C1[Assign CoPilot] C1 -->|SignalR notify| D1[CoPilot: PENDING] end subgraph PREFLIGHT["Pre-Flight Intelligence"] B1 --> E1[Weather Briefing METAR/TAF] B1 --> F1[Weight & Balance CG calc] B1 --> G1[Fuel Planning + Range] end subgraph CREW["Crew Workflow"] D1 -->|Accept| H1[CoPilot: ACCEPTED] H1 --> I1[CoPilot executes Checklist] H1 --> J1[CoPilot loads Cargo Manifest] I1 -->|Complete| K1[Pilot approves Checklist] J1 -->|Lock| L1[Pilot signs Manifest] end subgraph OPS["Flight Operations"] K1 --> M1[Flight: PREFLIGHT] L1 --> M1 M1 --> N1[Flight: BOARDING] N1 --> O1[Flight: IN_FLIGHT] O1 -->|GPS position updates| P1[flight_telemetry] O1 --> Q1[Flight: LANDED] Q1 --> R1[Flight: COMPLETED] end style PILOT fill:#0F766E,stroke:#14B8A6,color:#fff style PREFLIGHT fill:#1E3A5F,stroke:#06B6D4,color:#fff style CREW fill:#78350F,stroke:#F59E0B,color:#fff style OPS fill:#312E81,stroke:#8B5CF6,color:#fff

flowchart TD subgraph SIGNUP["User Signup"] A2[Register] -->|"handle_new_user trigger"| B2[Profile created] B2 --> C2[Subscription: FREE tier] B2 --> D2[Credits: 0] end subgraph UPGRADE["Upgrade Flow"] C2 --> E2{User wants features} E2 -->|LockedOverlay| F2[/subscription/checkout?tier=X] F2 -->|Stripe Checkout Session| G2[Stripe payment page] G2 -->|Payment success| H2[/checkout/success] end subgraph ACTIVATE["Activation - dual path"] G2 -.->|"Webhook: customer.subscription.created"| I2[PaymentWebhookController] H2 -->|"verify endpoint"| J2[EnsureSubscriptionExistsAsync] I2 --> K2[user_subscriptions: ACTIVE] J2 --> K2 K2 --> L2[profiles.subscription_tier synced] K2 --> M2[Credits provisioned] end subgraph CREDITS["Credit System"] M2 --> N2[user_credits.balance] N2 -->|Place bid: -1| O2[credit_transactions] N2 -->|Create job: -2| O2 N2 -->|AI analysis: -5| O2 N2 -->|Buy package| P2[Stripe PaymentIntent] P2 -->|Success webhook| Q2[Credits added] end style SIGNUP fill:#064E3B,stroke:#10B981,color:#fff style UPGRADE fill:#1E3A5F,stroke:#3B82F6,color:#fff style ACTIVATE fill:#0F766E,stroke:#14B8A6,color:#fff style CREDITS fill:#78350F,stroke:#F59E0B,color:#fff

erDiagram profiles ||--o{ user_subscriptions : has profiles ||--o{ user_credits : has profiles ||--o{ transport_jobs : creates profiles ||--o{ bids : places profiles ||--o{ messages : sends profiles ||--o{ notifications : receives profiles ||--o{ documents : owns profiles ||--o{ reviews : writes profiles ||--o{ two_factor_auth : configures profiles ||--o{ saved_searches : saves profiles ||--o{ activity_logs : generates transport_jobs ||--o{ bids : receives transport_jobs ||--o{ transport_tasks : spawns transport_jobs ||--o{ job_metrics : tracked_by transport_jobs ||--o{ job_target_carriers : targets bids ||--o{ credit_transactions : consumes bids }o--|| profiles : bidder transport_tasks ||--o{ delivery_confirmations : has transport_tasks ||--o{ proof_of_delivery : has transport_tasks ||--o{ pod_photos : has subscription_tiers ||--o{ user_subscriptions : defines subscription_tiers ||--o{ subscription_tier_features : has user_subscriptions }o--|| profiles : belongs_to user_subscriptions }o--|| subscription_tiers : uses user_credits }o--|| profiles : belongs_to user_credits ||--o{ credit_transactions : tracks invoices }o--|| profiles : billed_to billing_ledger }o--|| profiles : records payments }o--|| profiles : pays vehicle_fleet }o--|| profiles : owned_by vehicle_fleet ||--o{ vehicle_assignments : assigned vehicle_fleet ||--o{ vehicle_verifications : verified carrier_routes }o--|| profiles : owned_by carrier_service_areas }o--|| profiles : covers carrier_specializations }o--|| profiles : has carrier_insurance }o--|| profiles : insured driver_locations }o--|| profiles : reports driver_time_entries }o--|| profiles : logs driver_vehicle_checks }o--|| profiles : checks driver_certifications }o--|| profiles : certified driver_licenses }o--|| profiles : holds flights }o--|| profiles : piloted_by flights ||--o{ flight_assignments : assigns flights ||--o{ flight_telemetry : tracks flights ||--o{ preflight_checklists : requires flights ||--o{ cargo_manifests : loads flight_assignments }o--|| profiles : copilot cargo_manifests ||--o{ cargo_items : contains aircrafts }o--|| profiles : registered_by aircrafts }o--|| aircraft_catalog : type_of freight_leads }o--|| profiles : owned_by freight_leads ||--o{ lead_conversions : converts match_results }o--|| transport_jobs : matches match_results }o--|| profiles : matched_carrier geofence_zones }o--|| profiles : monitors marketplace_alerts }o--|| profiles : alerts experiments ||--o{ experiment_assignments : assigns feature_trials }o--|| profiles : trials

flowchart LR FREE["FREE\n0 kr\n5 features\n0 credits"] --> STARTER["STARTER\n379 kr/md\n18 features\n50 credits\n5% fee"] STARTER --> PRO["PRO\n1,129 kr/md\n29 features\n500 credits\n2.5% fee"] PRO --> ENTERPRISE["ENTERPRISE\nKontakt os\n41 features\n9,999 credits\n1% fee"] ENTERPRISE --> ADMIN["ADMIN\nSystem\nAlle features\n999,999 credits"] style FREE fill:#334155,stroke:#64748B,color:#CBD5E1 style STARTER fill:#064E3B,stroke:#10B981,color:#A7F3D0 style PRO fill:#1E3A5F,stroke:#3B82F6,color:#93C5FD style ENTERPRISE fill:#312E81,stroke:#8B5CF6,color:#C4B5FD style ADMIN fill:#7F1D1D,stroke:#EF4444,color:#FCA5A5