# pritam-karmakar/b2b-logistics-management-software architecture

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

- Interactive diagram: https://gitdiagram.com/pritam-karmakar/b2b-logistics-management-software
- Repository: https://github.com/pritam-karmakar/b2b-logistics-management-software

## Overview

This repository appears to be a courier and cargo operations platform with public information pages, customer and branch portals, and an employee/admin console. The main customer journey is booking a shipment, arranging pickup, and checking shipment status; related capabilities include rates, serviceability, documents, billing, and operational reporting. The tree supports these subsystem boundaries, but README and most PHP implementations were not provided, so links between stages are limited to relationships visible in the excerpts.

Main entry points: [`user/serviceability.php`](https://github.com/pritam-karmakar/b2b-logistics-management-software/blob/master/user/serviceability.php) (Portal serviceability), [`website/index.php`](https://github.com/pritam-karmakar/b2b-logistics-management-software/blob/master/website/index.php) (Public site), [`website/track-shipment.php`](https://github.com/pritam-karmakar/b2b-logistics-management-software/blob/master/website/track-shipment.php) (Track shipment), [`website/serviceability.php`](https://github.com/pritam-karmakar/b2b-logistics-management-software/blob/master/website/serviceability.php) (Public serviceability)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_public["Public Website"]
  node_website["Public site<br/>[index.php]"]
  node_public_tracking["Track shipment<br/>[track-shipment.php]"]
  node_public_serviceability["Public serviceability<br/>[serviceability.php]"]
end

subgraph group_portals["Customer Portals"]
  node_customer_portal["Customer portal<br/>[index.php]"]
  node_branch_portal["Branch portal<br/>[index.php]"]
end

subgraph group_operations["Shipment Operations"]
  node_customer_booking["Create order<br/>[create_order.php]"]
  node_branch_booking["Branch order entry<br/>[create_order.php]"]
  node_bulk_booking["Bulk orders<br/>[bulk_orders.php]"]
  node_pickup["Pickup requests<br/>[pickup_request.php]"]
  node_shipment_tracking["Portal tracking<br/>[track.php]"]
  node_serviceability["Portal serviceability<br/>[serviceability.php]"]
  node_labels["Labels and waybills<br/>[A4.php]"]
  node_freight["Freight calculation"]
end

subgraph group_finance["Finance And Reports"]
  node_admin["Employee console<br/>[index.php]"]
  node_billing["Billing<br/>[billing.php]"]
  node_ledger["Ledger and cashbook<br/>[ledger.php]"]
  node_booking_reports["Booking reports<br/>[booking-report.php]"]
end

subgraph group_shared["Shared Runtime"]
  node_shared_functions["Application functions<br/>[all-functions.php]"]
  node_database_config["Database connection<br/>[db.php]"]
  node_tracking_queue["Tracking queue<br/>[tracking-queue.php]"]
end

node_visitor(("Website visitor"))
node_customer(("Portal customer"))
node_branch_staff(("Branch staff"))
node_employee(("Employee"))
node_external_carrier["Carrier service"]

node_visitor -->|"visits"| node_website
node_visitor -->|"checks status"| node_public_tracking
node_visitor -->|"checks coverage"| node_public_serviceability
node_customer -->|"uses"| node_customer_portal
node_branch_staff -->|"uses"| node_branch_portal
node_employee -->|"uses"| node_admin
node_customer -->|"books shipment"| node_customer_booking
node_branch_staff -->|"enters order"| node_branch_booking
node_customer -->|"submits orders"| node_bulk_booking
node_customer -->|"requests pickup"| node_pickup
node_customer -->|"checks status"| node_shipment_tracking
node_customer -->|"checks coverage"| node_serviceability
node_serviceability -->|"queries PIN data"| node_external_carrier

click node_website "https://github.com/pritam-karmakar/b2b-logistics-management-software/blob/master/website/index.php"
click node_public_tracking "https://github.com/pritam-karmakar/b2b-logistics-management-software/blob/master/website/track-shipment.php"
click node_public_serviceability "https://github.com/pritam-karmakar/b2b-logistics-management-software/blob/master/website/serviceability.php"
click node_customer_portal "https://github.com/pritam-karmakar/b2b-logistics-management-software/blob/master/user/index.php"
click node_branch_portal "https://github.com/pritam-karmakar/b2b-logistics-management-software/blob/master/branch/index.php"
click node_customer_booking "https://github.com/pritam-karmakar/b2b-logistics-management-software/blob/master/user/create_order.php"
click node_branch_booking "https://github.com/pritam-karmakar/b2b-logistics-management-software/blob/master/branch/create_order.php"
click node_bulk_booking "https://github.com/pritam-karmakar/b2b-logistics-management-software/blob/master/user/bulk_orders.php"
click node_pickup "https://github.com/pritam-karmakar/b2b-logistics-management-software/blob/master/user/pickup_request.php"
click node_shipment_tracking "https://github.com/pritam-karmakar/b2b-logistics-management-software/blob/master/user/track.php"
click node_serviceability "https://github.com/pritam-karmakar/b2b-logistics-management-software/blob/master/user/serviceability.php"
click node_labels "https://github.com/pritam-karmakar/b2b-logistics-management-software/blob/master/user/label/A4.php"
click node_freight "https://github.com/pritam-karmakar/b2b-logistics-management-software/blob/master/functions/freight-Calculation-Functions.php"
click node_admin "https://github.com/pritam-karmakar/b2b-logistics-management-software/blob/master/emps/index.php"
click node_billing "https://github.com/pritam-karmakar/b2b-logistics-management-software/blob/master/emps/billing.php"
click node_ledger "https://github.com/pritam-karmakar/b2b-logistics-management-software/blob/master/emps/ledger.php"
click node_booking_reports "https://github.com/pritam-karmakar/b2b-logistics-management-software/blob/master/emps/booking-report.php"
click node_shared_functions "https://github.com/pritam-karmakar/b2b-logistics-management-software/blob/master/functions/all-functions.php"
click node_database_config "https://github.com/pritam-karmakar/b2b-logistics-management-software/blob/master/database/db.php"
click node_tracking_queue "https://github.com/pritam-karmakar/b2b-logistics-management-software/blob/master/tracking-queue.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_website,node_public_tracking,node_public_serviceability toneBlue
class node_customer_portal,node_branch_portal toneAmber
class node_customer_booking,node_branch_booking,node_bulk_booking,node_pickup,node_shipment_tracking,node_serviceability,node_labels,node_freight toneMint
class node_admin,node_billing,node_ledger,node_booking_reports toneRose
class node_shared_functions,node_database_config,node_tracking_queue,node_visitor,node_customer,node_branch_staff,node_employee,node_external_carrier toneIndigo
```

## Components

### Public Website

- [Public site](https://github.com/pritam-karmakar/b2b-logistics-management-software/blob/master/website/index.php): `website/index.php`
- [Track shipment](https://github.com/pritam-karmakar/b2b-logistics-management-software/blob/master/website/track-shipment.php): `website/track-shipment.php`
- [Public serviceability](https://github.com/pritam-karmakar/b2b-logistics-management-software/blob/master/website/serviceability.php): `website/serviceability.php`

### Customer Portals

- [Customer portal](https://github.com/pritam-karmakar/b2b-logistics-management-software/blob/master/user/index.php): `user/index.php`
- [Branch portal](https://github.com/pritam-karmakar/b2b-logistics-management-software/blob/master/branch/index.php): `branch/index.php`

### Shipment Operations

- [Create order](https://github.com/pritam-karmakar/b2b-logistics-management-software/blob/master/user/create_order.php): `user/create_order.php`
- [Branch order entry](https://github.com/pritam-karmakar/b2b-logistics-management-software/blob/master/branch/create_order.php): `branch/create_order.php`
- [Bulk orders](https://github.com/pritam-karmakar/b2b-logistics-management-software/blob/master/user/bulk_orders.php): `user/bulk_orders.php`
- [Pickup requests](https://github.com/pritam-karmakar/b2b-logistics-management-software/blob/master/user/pickup_request.php): `user/pickup_request.php`
- [Portal tracking](https://github.com/pritam-karmakar/b2b-logistics-management-software/blob/master/user/track.php): `user/track.php`
- [Portal serviceability](https://github.com/pritam-karmakar/b2b-logistics-management-software/blob/master/user/serviceability.php): `user/serviceability.php`
- [Labels and waybills](https://github.com/pritam-karmakar/b2b-logistics-management-software/blob/master/user/label/A4.php): `user/label/A4.php`
- [Freight calculation](https://github.com/pritam-karmakar/b2b-logistics-management-software/blob/master/functions/freight-Calculation-Functions.php): `functions/freight-Calculation-Functions.php`

### Finance And Reports

- [Employee console](https://github.com/pritam-karmakar/b2b-logistics-management-software/blob/master/emps/index.php): `emps/index.php`
- [Billing](https://github.com/pritam-karmakar/b2b-logistics-management-software/blob/master/emps/billing.php): `emps/billing.php`
- [Ledger and cashbook](https://github.com/pritam-karmakar/b2b-logistics-management-software/blob/master/emps/ledger.php): `emps/ledger.php`
- [Booking reports](https://github.com/pritam-karmakar/b2b-logistics-management-software/blob/master/emps/booking-report.php): `emps/booking-report.php`

### Shared Runtime

- [Application functions](https://github.com/pritam-karmakar/b2b-logistics-management-software/blob/master/functions/all-functions.php): `functions/all-functions.php`
- [Database connection](https://github.com/pritam-karmakar/b2b-logistics-management-software/blob/master/database/db.php): `database/db.php`
- [Tracking queue](https://github.com/pritam-karmakar/b2b-logistics-management-software/blob/master/tracking-queue.php): `tracking-queue.php`

### Other components

- **Website visitor**
- **Portal customer**
- **Branch staff**
- **Employee**
- **Carrier service**

## Connections

- Website visitor → Public site: visits
- Website visitor → Track shipment: checks status
- Website visitor → Public serviceability: checks coverage
- Portal customer → Customer portal: uses
- Branch staff → Branch portal: uses
- Employee → Employee console: uses
- Portal customer → Create order: books shipment
- Branch staff → Branch order entry: enters order
- Portal customer → Bulk orders: submits orders
- Portal customer → Pickup requests: requests pickup
- Portal customer → Portal tracking: checks status
- Portal customer → Portal serviceability: checks coverage
- Portal serviceability → Carrier service: queries PIN data