# salahyusuf/salahparceltracker architecture

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

- Interactive diagram: https://gitdiagram.com/salahyusuf/salahparceltracker
- Repository: https://github.com/salahyusuf/salahparceltracker

## Overview

Salah Parcel Tracker is a small interactive Python parcel tracker. The user starts the command-line app, selects the customer or courier workflow, and both operate on the shared in-memory parcel list. Customers look up a tracking ID to view receiver, destination, and status; couriers can inspect dashboard counts and parcel listings, or update a parcel’s status. The source shows the menu dispatches and shared-list passing. No persistence or external integrations are shown, so parcel data is volatile.

Main entry points: [`main.py`](https://github.com/salahyusuf/salahparceltracker/blob/main/main.py) (Main Menu), [`courier.py`](https://github.com/salahyusuf/salahparceltracker/blob/main/courier.py) (Courier Menu), [`customer.py`](https://github.com/salahyusuf/salahparceltracker/blob/main/customer.py) (Customer Menu)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_entry["Application Entry"]
  node_main_menu["Main Menu<br/>[main.py]"]
  node_parcel_data["Parcel Data<br/>[main.py]"]
end

subgraph group_customer["Customer Tracking"]
  node_customer_menu["Customer Menu<br/>[customer.py]"]
  node_tracking["Parcel Tracking<br/>[customer.py]"]
end

subgraph group_courier["Courier Operations"]
  node_courier_menu["Courier Menu<br/>[courier.py]"]
  node_dashboard["Dashboard Counts<br/>[courier.py]"]
  node_parcel_list["Parcel List<br/>[courier.py]"]
  node_status_update["Status Update<br/>[courier.py]"]
end

node_user(("User"))

node_user -->|"starts app"| node_main_menu
node_main_menu -->|"initializes"| node_parcel_data
node_main_menu -->|"dispatches"| node_customer_menu
node_main_menu -->|"dispatches"| node_courier_menu
node_main_menu -->|"passes parcels"| node_customer_menu
node_main_menu -->|"passes parcels"| node_courier_menu
node_customer_menu -->|"calls"| node_tracking
node_courier_menu -->|"calls"| node_dashboard
node_courier_menu -->|"calls"| node_parcel_list
node_courier_menu -->|"calls"| node_status_update
node_tracking -->|"reads parcels"| node_parcel_data
node_dashboard -->|"counts parcels"| node_parcel_data
node_parcel_list -->|"reads parcels"| node_parcel_data
node_status_update -->|"updates status"| node_parcel_data

click node_main_menu "https://github.com/salahyusuf/salahparceltracker/blob/main/main.py"
click node_parcel_data "https://github.com/salahyusuf/salahparceltracker/blob/main/main.py"
click node_customer_menu "https://github.com/salahyusuf/salahparceltracker/blob/main/customer.py"
click node_tracking "https://github.com/salahyusuf/salahparceltracker/blob/main/customer.py"
click node_courier_menu "https://github.com/salahyusuf/salahparceltracker/blob/main/courier.py"
click node_dashboard "https://github.com/salahyusuf/salahparceltracker/blob/main/courier.py"
click node_parcel_list "https://github.com/salahyusuf/salahparceltracker/blob/main/courier.py"
click node_status_update "https://github.com/salahyusuf/salahparceltracker/blob/main/courier.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_main_menu,node_parcel_data,node_user toneBlue
class node_customer_menu,node_tracking toneAmber
class node_courier_menu,node_dashboard,node_parcel_list,node_status_update toneMint
```

## Components

### Application Entry

- [Main Menu](https://github.com/salahyusuf/salahparceltracker/blob/main/main.py): `main.py`
- [Parcel Data](https://github.com/salahyusuf/salahparceltracker/blob/main/main.py): `main.py`

### Customer Tracking

- [Customer Menu](https://github.com/salahyusuf/salahparceltracker/blob/main/customer.py): `customer.py`
- [Parcel Tracking](https://github.com/salahyusuf/salahparceltracker/blob/main/customer.py): `customer.py`

### Courier Operations

- [Courier Menu](https://github.com/salahyusuf/salahparceltracker/blob/main/courier.py): `courier.py`
- [Dashboard Counts](https://github.com/salahyusuf/salahparceltracker/blob/main/courier.py): `courier.py`
- [Parcel List](https://github.com/salahyusuf/salahparceltracker/blob/main/courier.py): `courier.py`
- [Status Update](https://github.com/salahyusuf/salahparceltracker/blob/main/courier.py): `courier.py`

### Other components

- **User**

## Connections

- User → Main Menu: starts app (evidence: `README.md`)
- Main Menu → Parcel Data: initializes (evidence: `main.py`)
- Main Menu → Customer Menu: dispatches (evidence: `main.py`)
- Main Menu → Courier Menu: dispatches (evidence: `main.py`)
- Main Menu → Customer Menu: passes parcels (evidence: `main.py`)
- Main Menu → Courier Menu: passes parcels (evidence: `main.py`)
- Customer Menu → Parcel Tracking: calls (evidence: `customer.py`)
- Courier Menu → Dashboard Counts: calls (evidence: `courier.py`)
- Courier Menu → Parcel List: calls (evidence: `courier.py`)
- Courier Menu → Status Update: calls (evidence: `courier.py`)
- Parcel Tracking → Parcel Data: reads parcels (evidence: `customer.py`)
- Dashboard Counts → Parcel Data: counts parcels (evidence: `courier.py`)
- Parcel List → Parcel Data: reads parcels (evidence: `courier.py`)
- Status Update → Parcel Data: updates status (evidence: `courier.py`)
