# jcbdigitalhub/cargonext architecture

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

- Interactive diagram: https://gitdiagram.com/jcbdigitalhub/cargonext
- Repository: https://github.com/jcbdigitalhub/cargonext

## Overview

Cargonext is an ERPNext/Frappe cargo-management app, with visible modules for freight, transport, warehouse operations, and reference data. The tree suggests users maintain operational records and configure supporting masters, but the README is minimal and sampled Python classes are mostly plain Frappe documents. The diagram therefore shows product areas rather than asserting an end-to-end processing sequence; relationships between records are not established by the available source excerpts.

Main entry points: [`cargonext/config/cms_master.py`](https://github.com/jcbdigitalhub/cargonext/blob/develop/cargonext/config/cms_master.py) (Master navigation), [`cargonext/cms_master/doctype`](https://github.com/jcbdigitalhub/cargonext/tree/develop/cargonext/cms_master/doctype) (Cargo reference data), [`cargonext/cargonext/doctype/container_type/container_type.py`](https://github.com/jcbdigitalhub/cargonext/blob/develop/cargonext/cargonext/doctype/container_type/container_type.py) (Container types), [`cargonext/transport/doctype`](https://github.com/jcbdigitalhub/cargonext/tree/develop/cargonext/transport/doctype) (Transport reference data)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_masters["Cargo Masters"]
  node_master_records[("Cargo reference data")]
  node_container_type[("Container types<br/>[container_type.py]")]
  node_transport_master[("Transport reference data")]
  node_master_menu["Master navigation<br/>[cms_master.py]"]
end

subgraph group_freight["Freight Operations"]
  node_flight_schedule[("Flight schedules<br/>[flight_schedule.py]")]
  node_vessel[("Vessels<br/>[vessel.py]")]
end

subgraph group_transport["Transport Operations"]
  node_transport_order[("Transport orders<br/>[transport_order.py]")]
  node_transport_job[("Transport jobs<br/>[transport_job.py]")]
  node_job_service[("Job services")]
  node_trip_ticket[("Trip tickets<br/>[trip_ticket.py]")]
  node_linehaul_manifest[("Linehaul manifests")]
  node_transport_instruction[("Transport instructions")]
end

subgraph group_warehouse["Warehouse Operations"]
  node_warehouse_order[("Warehouse orders<br/>[warehouse_order.py]")]
  node_warehouse_settings[("Warehouse settings")]
  node_warehouse_layout[("Warehouse reference data")]
end

node_user(("ERPNext user"))

node_user -->|"opens"| node_master_menu
node_master_menu -->|"lists masters"| node_master_records
node_user -->|"maintains"| node_container_type
node_user -->|"maintains"| node_transport_master
node_user -->|"maintains"| node_flight_schedule
node_user -->|"maintains"| node_vessel
node_user -->|"maintains"| node_transport_order
node_user -->|"maintains"| node_transport_job
node_user -->|"maintains"| node_job_service
node_user -->|"maintains"| node_trip_ticket
node_user -->|"maintains"| node_linehaul_manifest
node_user -->|"maintains"| node_transport_instruction
node_user -->|"maintains"| node_warehouse_order
node_user -->|"maintains"| node_warehouse_settings
node_user -->|"maintains"| node_warehouse_layout

click node_master_records "https://github.com/jcbdigitalhub/cargonext/tree/develop/cargonext/cms_master/doctype"
click node_container_type "https://github.com/jcbdigitalhub/cargonext/blob/develop/cargonext/cargonext/doctype/container_type/container_type.py"
click node_transport_master "https://github.com/jcbdigitalhub/cargonext/tree/develop/cargonext/transport/doctype"
click node_flight_schedule "https://github.com/jcbdigitalhub/cargonext/blob/develop/cargonext/air_freight/doctype/flight_schedule/flight_schedule.py"
click node_vessel "https://github.com/jcbdigitalhub/cargonext/blob/develop/cargonext/sea_freight/doctype/vessel/vessel.py"
click node_transport_order "https://github.com/jcbdigitalhub/cargonext/blob/develop/cargonext/transport/doctype/transport_order/transport_order.py"
click node_transport_job "https://github.com/jcbdigitalhub/cargonext/blob/develop/cargonext/transport/doctype/transport_job/transport_job.py"
click node_job_service "https://github.com/jcbdigitalhub/cargonext/blob/develop/cargonext/transport/doctype/transport_job_service/transport_job_service.py"
click node_trip_ticket "https://github.com/jcbdigitalhub/cargonext/blob/develop/cargonext/transport/doctype/trip_ticket/trip_ticket.py"
click node_linehaul_manifest "https://github.com/jcbdigitalhub/cargonext/blob/develop/cargonext/transport/doctype/linehaul_manifest/linehaul_manifest.py"
click node_transport_instruction "https://github.com/jcbdigitalhub/cargonext/blob/develop/cargonext/transport/doctype/transport_instruction/transport_instruction.py"
click node_warehouse_order "https://github.com/jcbdigitalhub/cargonext/blob/develop/cargonext/warehouse/doctype/warehouse_order/warehouse_order.py"
click node_warehouse_settings "https://github.com/jcbdigitalhub/cargonext/blob/develop/cargonext/warehouse/doctype/warehouse_settings/warehouse_settings.py"
click node_warehouse_layout "https://github.com/jcbdigitalhub/cargonext/tree/develop/cargonext/warehouse/doctype"
click node_master_menu "https://github.com/jcbdigitalhub/cargonext/blob/develop/cargonext/config/cms_master.py"

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_master_records,node_container_type,node_transport_master,node_master_menu,node_user toneBlue
class node_flight_schedule,node_vessel toneAmber
class node_transport_order,node_transport_job,node_job_service,node_trip_ticket,node_linehaul_manifest,node_transport_instruction toneMint
class node_warehouse_order,node_warehouse_settings,node_warehouse_layout toneRose
```

## Components

### Cargo Masters

- [Cargo reference data](https://github.com/jcbdigitalhub/cargonext/tree/develop/cargonext/cms_master/doctype): `cargonext/cms_master/doctype`
- [Container types](https://github.com/jcbdigitalhub/cargonext/blob/develop/cargonext/cargonext/doctype/container_type/container_type.py): `cargonext/cargonext/doctype/container_type/container_type.py`
- [Transport reference data](https://github.com/jcbdigitalhub/cargonext/tree/develop/cargonext/transport/doctype): `cargonext/transport/doctype`
- [Master navigation](https://github.com/jcbdigitalhub/cargonext/blob/develop/cargonext/config/cms_master.py): `cargonext/config/cms_master.py`

### Freight Operations

- [Flight schedules](https://github.com/jcbdigitalhub/cargonext/blob/develop/cargonext/air_freight/doctype/flight_schedule/flight_schedule.py): `cargonext/air_freight/doctype/flight_schedule/flight_schedule.py`
- [Vessels](https://github.com/jcbdigitalhub/cargonext/blob/develop/cargonext/sea_freight/doctype/vessel/vessel.py): `cargonext/sea_freight/doctype/vessel/vessel.py`

### Transport Operations

- [Transport orders](https://github.com/jcbdigitalhub/cargonext/blob/develop/cargonext/transport/doctype/transport_order/transport_order.py): `cargonext/transport/doctype/transport_order/transport_order.py`
- [Transport jobs](https://github.com/jcbdigitalhub/cargonext/blob/develop/cargonext/transport/doctype/transport_job/transport_job.py): `cargonext/transport/doctype/transport_job/transport_job.py`
- [Job services](https://github.com/jcbdigitalhub/cargonext/blob/develop/cargonext/transport/doctype/transport_job_service/transport_job_service.py): `cargonext/transport/doctype/transport_job_service/transport_job_service.py`
- [Trip tickets](https://github.com/jcbdigitalhub/cargonext/blob/develop/cargonext/transport/doctype/trip_ticket/trip_ticket.py): `cargonext/transport/doctype/trip_ticket/trip_ticket.py`
- [Linehaul manifests](https://github.com/jcbdigitalhub/cargonext/blob/develop/cargonext/transport/doctype/linehaul_manifest/linehaul_manifest.py): `cargonext/transport/doctype/linehaul_manifest/linehaul_manifest.py`
- [Transport instructions](https://github.com/jcbdigitalhub/cargonext/blob/develop/cargonext/transport/doctype/transport_instruction/transport_instruction.py): `cargonext/transport/doctype/transport_instruction/transport_instruction.py`

### Warehouse Operations

- [Warehouse orders](https://github.com/jcbdigitalhub/cargonext/blob/develop/cargonext/warehouse/doctype/warehouse_order/warehouse_order.py): `cargonext/warehouse/doctype/warehouse_order/warehouse_order.py`
- [Warehouse settings](https://github.com/jcbdigitalhub/cargonext/blob/develop/cargonext/warehouse/doctype/warehouse_settings/warehouse_settings.py): `cargonext/warehouse/doctype/warehouse_settings/warehouse_settings.py`
- [Warehouse reference data](https://github.com/jcbdigitalhub/cargonext/tree/develop/cargonext/warehouse/doctype): `cargonext/warehouse/doctype`

### Other components

- **ERPNext user**

## Connections

- ERPNext user → Master navigation: opens
- Master navigation → Cargo reference data: lists masters
- ERPNext user → Container types: maintains
- ERPNext user → Transport reference data: maintains
- ERPNext user → Flight schedules: maintains
- ERPNext user → Vessels: maintains
- ERPNext user → Transport orders: maintains
- ERPNext user → Transport jobs: maintains
- ERPNext user → Job services: maintains
- ERPNext user → Trip tickets: maintains
- ERPNext user → Linehaul manifests: maintains
- ERPNext user → Transport instructions: maintains
- ERPNext user → Warehouse orders: maintains
- ERPNext user → Warehouse settings: maintains
- ERPNext user → Warehouse reference data: maintains