# mmuzammilumarsiddiqui-svg/jetstream-app architecture

> Architecture diagram of the GitHub repository mmuzammilumarsiddiqui-svg/jetstream-app, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-09-29). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/mmuzammilumarsiddiqui-svg/jetstream-app
- Repository: https://github.com/mmuzammilumarsiddiqui-svg/jetstream-app

## Overview

This appears to be a role-based vehicle trading and logistics application built on Laravel with an Inertia/Vue interface. Its central customer journey is vehicle discovery and reservation, checkout and payment, followed by document release and shipment operations; sellers and administrators handle remittances, approvals, and inventory. The tree also shows auction intake, vehicle catalog administration, and scoped access control. The README is the generic Laravel README, not product documentation; workflow links below are limited to the supplied excerpts and clearly named modules.

Main entry points: [`app/Http/Controllers/Customer/CheckoutController.php`](https://github.com/mmuzammilumarsiddiqui-svg/jetstream-app/blob/main/app/Http/Controllers/Customer/CheckoutController.php) (Checkout handler), [`app/Http/Controllers/Api/ShippingCalculationController.php`](https://github.com/mmuzammilumarsiddiqui-svg/jetstream-app/blob/main/app/Http/Controllers/Api/ShippingCalculationController.php) (Shipping quote API), [`app/Http/Controllers/Seller/RemittanceController.php`](https://github.com/mmuzammilumarsiddiqui-svg/jetstream-app/blob/main/app/Http/Controllers/Seller/RemittanceController.php) (Seller remittances), [`app/Http/Controllers/ShippingAgent/DocumentReleaseDhlController.php`](https://github.com/mmuzammilumarsiddiqui-svg/jetstream-app/blob/main/app/Http/Controllers/ShippingAgent/DocumentReleaseDhlController.php) (DHL operations)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_commerce["Vehicle commerce"]
  node_checkout_ui["Customer checkout"]
  node_checkout_controller["Checkout handler"]
  node_purchase_service["Purchase service"]
  node_reservation_service["Reservation lifecycle"]
  node_auction_intake["Auction intake"]
end

subgraph group_finance["Payments and remittance"]
  node_pricing_service["Purchase pricing<br/>[PricingService.php]"]
  node_payment_service["Payment handling<br/>[PaymentService.php]"]
  node_remittance_controller["Seller remittances"]
  node_remittance_workflow["Remittance workflow"]
end

subgraph group_operations["Release and shipping"]
  node_shipping_calc["Shipping quote API"]
  node_shipping_service["Shipping pricing"]
  node_release_review["Release approvals"]
  node_release_service["Reservation release"]
  node_dhl_controller["DHL operations"]
  node_dhl_workflow["DHL workflow"]
  node_shipment_workflow["Shipment operations"]
end

subgraph group_platform["Catalog and access"]
  node_vehicle_catalog["Vehicle catalog"]
  node_access_control["Scoped access<br/>[AccessResolver.php]"]
end

node_customer(("Customer"))
node_seller(("Seller"))
node_shipping_agent(("Shipping agent"))
node_admin(("Administrator"))
node_store[("Application database")]

node_customer -->|"uses"| node_checkout_ui
node_checkout_ui -->|"submits checkout"| node_checkout_controller
node_checkout_controller -->|"requests purchase"| node_purchase_service
node_checkout_controller -->|"resolves reservation"| node_reservation_service
node_checkout_controller -->|"reads reservation and order"| node_store
node_purchase_service -->|"persists purchase"| node_store
node_auction_intake -->|"creates intake reservations"| node_store
node_shipping_calc -->|"calculates quote"| node_shipping_service
node_shipping_calc -->|"calculates total"| node_pricing_service
node_shipping_calc -->|"reads vehicle"| node_store
node_seller -->|"manages remittances"| node_remittance_controller
node_remittance_controller -->|"tracks remittance"| node_remittance_workflow
node_remittance_controller -->|"reads and updates remittances"| node_store
node_admin -->|"reviews release"| node_release_review
node_release_review -->|"approves or declines"| node_release_service
node_release_service -->|"updates request and reservation"| node_store
node_shipping_agent -->|"operates DHL release"| node_dhl_controller
node_dhl_controller -->|"checks assignment"| node_dhl_workflow
node_dhl_controller -->|"reads release details"| node_store
node_shipping_agent -->|"manages shipment"| node_shipment_workflow
node_vehicle_catalog -->|"reads catalog data"| node_store
node_access_control -->|"resolves grants"| node_store

click node_checkout_ui "https://github.com/mmuzammilumarsiddiqui-svg/jetstream-app/tree/main/resources/js"
click node_checkout_controller "https://github.com/mmuzammilumarsiddiqui-svg/jetstream-app/blob/main/app/Http/Controllers/Customer/CheckoutController.php"
click node_purchase_service "https://github.com/mmuzammilumarsiddiqui-svg/jetstream-app/blob/main/app/Services/CustomerPurchaseService.php"
click node_reservation_service "https://github.com/mmuzammilumarsiddiqui-svg/jetstream-app/blob/main/app/Services/VehicleReservationService.php"
click node_auction_intake "https://github.com/mmuzammilumarsiddiqui-svg/jetstream-app/blob/main/app/Services/AdminAuctionIntakeReservationService.php"
click node_vehicle_catalog "https://github.com/mmuzammilumarsiddiqui-svg/jetstream-app/blob/main/app/Services/VehicleCatalogAttributeService.php"
click node_shipping_calc "https://github.com/mmuzammilumarsiddiqui-svg/jetstream-app/blob/main/app/Http/Controllers/Api/ShippingCalculationController.php"
click node_shipping_service "https://github.com/mmuzammilumarsiddiqui-svg/jetstream-app/blob/main/app/Services/ShippingService.php"
click node_pricing_service "https://github.com/mmuzammilumarsiddiqui-svg/jetstream-app/blob/main/app/Services/PricingService.php"
click node_payment_service "https://github.com/mmuzammilumarsiddiqui-svg/jetstream-app/blob/main/app/Services/PaymentService.php"
click node_remittance_controller "https://github.com/mmuzammilumarsiddiqui-svg/jetstream-app/blob/main/app/Http/Controllers/Seller/RemittanceController.php"
click node_remittance_workflow "https://github.com/mmuzammilumarsiddiqui-svg/jetstream-app/blob/main/app/Services/RemittanceTrackingWorkflowService.php"
click node_release_review "https://github.com/mmuzammilumarsiddiqui-svg/jetstream-app/blob/main/app/Http/Controllers/Admin/ReservationReleaseReviewController.php"
click node_release_service "https://github.com/mmuzammilumarsiddiqui-svg/jetstream-app/blob/main/app/Services/ReservationReleaseService.php"
click node_dhl_controller "https://github.com/mmuzammilumarsiddiqui-svg/jetstream-app/blob/main/app/Http/Controllers/ShippingAgent/DocumentReleaseDhlController.php"
click node_dhl_workflow "https://github.com/mmuzammilumarsiddiqui-svg/jetstream-app/blob/main/app/Services/DhlWorkflowService.php"
click node_shipment_workflow "https://github.com/mmuzammilumarsiddiqui-svg/jetstream-app/blob/main/app/Services/NewShipmentWorkflowService.php"
click node_access_control "https://github.com/mmuzammilumarsiddiqui-svg/jetstream-app/blob/main/app/Services/AccessResolver.php"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_checkout_ui,node_checkout_controller,node_purchase_service,node_reservation_service,node_auction_intake toneBlue
class node_pricing_service,node_payment_service,node_remittance_controller,node_remittance_workflow,node_store toneAmber
class node_shipping_calc,node_shipping_service,node_release_review,node_release_service,node_dhl_controller,node_dhl_workflow,node_shipment_workflow toneMint
class node_vehicle_catalog,node_access_control toneRose
class node_customer,node_seller,node_shipping_agent,node_admin toneIndigo
```

## Components

### Vehicle commerce

- [Customer checkout](https://github.com/mmuzammilumarsiddiqui-svg/jetstream-app/tree/main/resources/js): `resources/js`
- [Checkout handler](https://github.com/mmuzammilumarsiddiqui-svg/jetstream-app/blob/main/app/Http/Controllers/Customer/CheckoutController.php): `app/Http/Controllers/Customer/CheckoutController.php`
- [Purchase service](https://github.com/mmuzammilumarsiddiqui-svg/jetstream-app/blob/main/app/Services/CustomerPurchaseService.php): `app/Services/CustomerPurchaseService.php`
- [Reservation lifecycle](https://github.com/mmuzammilumarsiddiqui-svg/jetstream-app/blob/main/app/Services/VehicleReservationService.php): `app/Services/VehicleReservationService.php`
- [Auction intake](https://github.com/mmuzammilumarsiddiqui-svg/jetstream-app/blob/main/app/Services/AdminAuctionIntakeReservationService.php): `app/Services/AdminAuctionIntakeReservationService.php`

### Payments and remittance

- [Purchase pricing](https://github.com/mmuzammilumarsiddiqui-svg/jetstream-app/blob/main/app/Services/PricingService.php): `app/Services/PricingService.php`
- [Payment handling](https://github.com/mmuzammilumarsiddiqui-svg/jetstream-app/blob/main/app/Services/PaymentService.php): `app/Services/PaymentService.php`
- [Seller remittances](https://github.com/mmuzammilumarsiddiqui-svg/jetstream-app/blob/main/app/Http/Controllers/Seller/RemittanceController.php): `app/Http/Controllers/Seller/RemittanceController.php`
- [Remittance workflow](https://github.com/mmuzammilumarsiddiqui-svg/jetstream-app/blob/main/app/Services/RemittanceTrackingWorkflowService.php): `app/Services/RemittanceTrackingWorkflowService.php`

### Release and shipping

- [Shipping quote API](https://github.com/mmuzammilumarsiddiqui-svg/jetstream-app/blob/main/app/Http/Controllers/Api/ShippingCalculationController.php): `app/Http/Controllers/Api/ShippingCalculationController.php`
- [Shipping pricing](https://github.com/mmuzammilumarsiddiqui-svg/jetstream-app/blob/main/app/Services/ShippingService.php): `app/Services/ShippingService.php`
- [Release approvals](https://github.com/mmuzammilumarsiddiqui-svg/jetstream-app/blob/main/app/Http/Controllers/Admin/ReservationReleaseReviewController.php): `app/Http/Controllers/Admin/ReservationReleaseReviewController.php`
- [Reservation release](https://github.com/mmuzammilumarsiddiqui-svg/jetstream-app/blob/main/app/Services/ReservationReleaseService.php): `app/Services/ReservationReleaseService.php`
- [DHL operations](https://github.com/mmuzammilumarsiddiqui-svg/jetstream-app/blob/main/app/Http/Controllers/ShippingAgent/DocumentReleaseDhlController.php): `app/Http/Controllers/ShippingAgent/DocumentReleaseDhlController.php`
- [DHL workflow](https://github.com/mmuzammilumarsiddiqui-svg/jetstream-app/blob/main/app/Services/DhlWorkflowService.php): `app/Services/DhlWorkflowService.php`
- [Shipment operations](https://github.com/mmuzammilumarsiddiqui-svg/jetstream-app/blob/main/app/Services/NewShipmentWorkflowService.php): `app/Services/NewShipmentWorkflowService.php`

### Catalog and access

- [Vehicle catalog](https://github.com/mmuzammilumarsiddiqui-svg/jetstream-app/blob/main/app/Services/VehicleCatalogAttributeService.php): `app/Services/VehicleCatalogAttributeService.php`
- [Scoped access](https://github.com/mmuzammilumarsiddiqui-svg/jetstream-app/blob/main/app/Services/AccessResolver.php): `app/Services/AccessResolver.php`

### Other components

- **Customer**
- **Seller**
- **Shipping agent**
- **Administrator**
- **Application database**

## Connections

- Customer → Customer checkout: uses
- Customer checkout → Checkout handler: submits checkout
- Checkout handler → Purchase service: requests purchase
- Checkout handler → Reservation lifecycle: resolves reservation
- Checkout handler → Application database: reads reservation and order
- Purchase service → Application database: persists purchase
- Auction intake → Application database: creates intake reservations
- Shipping quote API → Shipping pricing: calculates quote
- Shipping quote API → Purchase pricing: calculates total
- Shipping quote API → Application database: reads vehicle
- Seller → Seller remittances: manages remittances
- Seller remittances → Remittance workflow: tracks remittance
- Seller remittances → Application database: reads and updates remittances
- Administrator → Release approvals: reviews release
- Release approvals → Reservation release: approves or declines
- Reservation release → Application database: updates request and reservation
- Shipping agent → DHL operations: operates DHL release
- DHL operations → DHL workflow: checks assignment
- DHL operations → Application database: reads release details
- Shipping agent → Shipment operations: manages shipment
- Vehicle catalog → Application database: reads catalog data
- Scoped access → Application database: resolves grants