# adityagujjar2001-ui/parcel-management-system architecture

> Architecture diagram of the GitHub repository adityagujjar2001-ui/parcel-management-system, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-19). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/adityagujjar2001-ui/parcel-management-system
- Repository: https://github.com/adityagujjar2001-ui/parcel-management-system

## Overview

This is a browser-based parcel booking and management application. Customers register or log in, create bookings, view dashboard/invoice information, and track parcels; officers can update pickup windows and parcel status. The browser serves static pages and submits API requests to the Java HTTP server, which delegates business rules to AppService and persistence to DAOs backed by MySQL. The README documents the complete request flow; sampled code confirms representative service, DAO, and database behavior. Some endpoint details and page-to-feature wiring are documented but not fully excerpted.

Main entry points: [`projectBL/src/projectBL/WebServer.java`](https://github.com/adityagujjar2001-ui/parcel-management-system/blob/main/projectBL/src/projectBL/WebServer.java) (HTTP server), [`projectBL/src/projectBL/dao/BookingDao.java`](https://github.com/adityagujjar2001-ui/parcel-management-system/blob/main/projectBL/src/projectBL/dao/BookingDao.java) (Booking records), [`projectBL/src/projectBL/dao/UserDao.java`](https://github.com/adityagujjar2001-ui/parcel-management-system/blob/main/projectBL/src/projectBL/dao/UserDao.java) (User records), [`projectBL/src/projectBL/service/AppService.java`](https://github.com/adityagujjar2001-ui/parcel-management-system/blob/main/projectBL/src/projectBL/service/AppService.java) (Accounts)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_browser["Browser UI"]
  node_webpages["UI pages"]
  node_webapp["UI interactions<br/>[app.js]"]
end

subgraph group_http["HTTP API"]
  node_server["HTTP server<br/>[WebServer.java]"]
end

subgraph group_workflows["Parcel Workflows"]
  node_accounts["Accounts<br/>[AppService.java]"]
  node_booking["Parcel booking<br/>[AppService.java]"]
  node_tracking["Tracking and dashboard<br/>[AppService.java]"]
  node_invoice["Invoice lookup<br/>[AppService.java]"]
  node_officer["Officer updates<br/>[AppService.java]"]
  node_user_model["User model<br/>[User.java]"]
  node_booking_model["Booking model<br/>[Booking.java]"]
  node_result_model["Service results<br/>[Result.java]"]
end

subgraph group_storage["Persistence"]
  node_users["User records<br/>[UserDao.java]"]
  node_bookings["Booking records<br/>[BookingDao.java]"]
  node_database["JDBC setup<br/>[Database.java]"]
  node_mysql[("MySQL addydb")]
end

node_customer(("Customer or officer"))

node_customer -->|"uses"| node_webpages
node_webpages -->|"loads scripts"| node_webapp
node_webapp -->|"sends API requests"| node_server
node_server -->|"delegates requests"| node_accounts
node_server -->|"delegates requests"| node_booking
node_server -->|"delegates requests"| node_tracking
node_server -->|"delegates requests"| node_invoice
node_server -->|"delegates requests"| node_officer
node_accounts -->|"reads and writes"| node_users
node_booking -->|"saves booking"| node_bookings
node_tracking -->|"reads bookings"| node_bookings
node_invoice -->|"looks up booking"| node_bookings
node_invoice -->|"looks up owner"| node_users
node_officer -->|"updates booking"| node_bookings
node_users -->|"gets connections"| node_database
node_bookings -->|"gets connections"| node_database
node_database -->|"initializes schema"| node_mysql
node_users -->|"constructs and persists"| node_user_model
node_bookings -->|"constructs and persists"| node_booking_model
node_booking -->|"creates booking"| node_booking_model
node_server -->|"formats service results"| node_result_model
node_accounts -->|"returns results"| node_result_model

click node_webpages "https://github.com/adityagujjar2001-ui/parcel-management-system/tree/main/projectBL/web"
click node_webapp "https://github.com/adityagujjar2001-ui/parcel-management-system/blob/main/projectBL/web/app.js"
click node_server "https://github.com/adityagujjar2001-ui/parcel-management-system/blob/main/projectBL/src/projectBL/WebServer.java"
click node_accounts "https://github.com/adityagujjar2001-ui/parcel-management-system/blob/main/projectBL/src/projectBL/service/AppService.java"
click node_booking "https://github.com/adityagujjar2001-ui/parcel-management-system/blob/main/projectBL/src/projectBL/service/AppService.java"
click node_tracking "https://github.com/adityagujjar2001-ui/parcel-management-system/blob/main/projectBL/src/projectBL/service/AppService.java"
click node_invoice "https://github.com/adityagujjar2001-ui/parcel-management-system/blob/main/projectBL/src/projectBL/service/AppService.java"
click node_officer "https://github.com/adityagujjar2001-ui/parcel-management-system/blob/main/projectBL/src/projectBL/service/AppService.java"
click node_users "https://github.com/adityagujjar2001-ui/parcel-management-system/blob/main/projectBL/src/projectBL/dao/UserDao.java"
click node_bookings "https://github.com/adityagujjar2001-ui/parcel-management-system/blob/main/projectBL/src/projectBL/dao/BookingDao.java"
click node_database "https://github.com/adityagujjar2001-ui/parcel-management-system/blob/main/projectBL/src/projectBL/dao/Database.java"
click node_user_model "https://github.com/adityagujjar2001-ui/parcel-management-system/blob/main/projectBL/src/projectBL/model/User.java"
click node_booking_model "https://github.com/adityagujjar2001-ui/parcel-management-system/blob/main/projectBL/src/projectBL/model/Booking.java"
click node_result_model "https://github.com/adityagujjar2001-ui/parcel-management-system/blob/main/projectBL/src/projectBL/model/Result.java"

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_webpages,node_webapp toneBlue
class node_server toneAmber
class node_accounts,node_booking,node_tracking,node_invoice,node_officer,node_user_model,node_booking_model,node_result_model toneMint
class node_users,node_bookings,node_database,node_mysql toneRose
class node_customer toneIndigo
```

## Components

### Browser UI

- [UI pages](https://github.com/adityagujjar2001-ui/parcel-management-system/tree/main/projectBL/web): `projectBL/web`
- [UI interactions](https://github.com/adityagujjar2001-ui/parcel-management-system/blob/main/projectBL/web/app.js): `projectBL/web/app.js`

### HTTP API

- [HTTP server](https://github.com/adityagujjar2001-ui/parcel-management-system/blob/main/projectBL/src/projectBL/WebServer.java): `projectBL/src/projectBL/WebServer.java`

### Parcel Workflows

- [Accounts](https://github.com/adityagujjar2001-ui/parcel-management-system/blob/main/projectBL/src/projectBL/service/AppService.java): `projectBL/src/projectBL/service/AppService.java`
- [Parcel booking](https://github.com/adityagujjar2001-ui/parcel-management-system/blob/main/projectBL/src/projectBL/service/AppService.java): `projectBL/src/projectBL/service/AppService.java`
- [Tracking and dashboard](https://github.com/adityagujjar2001-ui/parcel-management-system/blob/main/projectBL/src/projectBL/service/AppService.java): `projectBL/src/projectBL/service/AppService.java`
- [Invoice lookup](https://github.com/adityagujjar2001-ui/parcel-management-system/blob/main/projectBL/src/projectBL/service/AppService.java): `projectBL/src/projectBL/service/AppService.java`
- [Officer updates](https://github.com/adityagujjar2001-ui/parcel-management-system/blob/main/projectBL/src/projectBL/service/AppService.java): `projectBL/src/projectBL/service/AppService.java`
- [User model](https://github.com/adityagujjar2001-ui/parcel-management-system/blob/main/projectBL/src/projectBL/model/User.java): `projectBL/src/projectBL/model/User.java`
- [Booking model](https://github.com/adityagujjar2001-ui/parcel-management-system/blob/main/projectBL/src/projectBL/model/Booking.java): `projectBL/src/projectBL/model/Booking.java`
- [Service results](https://github.com/adityagujjar2001-ui/parcel-management-system/blob/main/projectBL/src/projectBL/model/Result.java): `projectBL/src/projectBL/model/Result.java`

### Persistence

- [User records](https://github.com/adityagujjar2001-ui/parcel-management-system/blob/main/projectBL/src/projectBL/dao/UserDao.java): `projectBL/src/projectBL/dao/UserDao.java`
- [Booking records](https://github.com/adityagujjar2001-ui/parcel-management-system/blob/main/projectBL/src/projectBL/dao/BookingDao.java): `projectBL/src/projectBL/dao/BookingDao.java`
- [JDBC setup](https://github.com/adityagujjar2001-ui/parcel-management-system/blob/main/projectBL/src/projectBL/dao/Database.java): `projectBL/src/projectBL/dao/Database.java`
- **MySQL addydb**

### Other components

- **Customer or officer**

## Connections

- Customer or officer → UI pages: uses (evidence: `README.md`)
- UI pages → UI interactions: loads scripts (evidence: `README.md`)
- UI interactions → HTTP server: sends API requests (evidence: `README.md`)
- HTTP server → Accounts: delegates requests (evidence: `README.md`)
- HTTP server → Parcel booking: delegates requests (evidence: `README.md`)
- HTTP server → Tracking and dashboard: delegates requests (evidence: `README.md`)
- HTTP server → Invoice lookup: delegates requests (evidence: `README.md`)
- HTTP server → Officer updates: delegates requests (evidence: `README.md`)
- Accounts → User records: reads and writes (evidence: `projectBL/src/projectBL/service/AppService.java`)
- Parcel booking → Booking records: saves booking (evidence: `projectBL/src/projectBL/service/AppService.java`)
- Tracking and dashboard → Booking records: reads bookings (evidence: `projectBL/src/projectBL/service/AppService.java`)
- Invoice lookup → Booking records: looks up booking (evidence: `projectBL/src/projectBL/service/AppService.java`)
- Invoice lookup → User records: looks up owner (evidence: `projectBL/src/projectBL/service/AppService.java`)
- Officer updates → Booking records: updates booking (evidence: `projectBL/src/projectBL/service/AppService.java`)
- User records → JDBC setup: gets connections (evidence: `projectBL/src/projectBL/dao/UserDao.java`)
- Booking records → JDBC setup: gets connections (evidence: `projectBL/src/projectBL/dao/BookingDao.java`)
- JDBC setup → MySQL addydb: initializes schema (evidence: `projectBL/src/projectBL/dao/Database.java`)
- User records → User model: constructs and persists (evidence: `projectBL/src/projectBL/dao/UserDao.java`)
- Booking records → Booking model: constructs and persists (evidence: `projectBL/src/projectBL/dao/BookingDao.java`)
- Parcel booking → Booking model: creates booking (evidence: `projectBL/src/projectBL/service/AppService.java`)
- HTTP server → Service results: formats service results (evidence: `projectBL/src/projectBL/WebServer.java`)
- Accounts → Service results: returns results (evidence: `projectBL/src/projectBL/service/AppService.java`)
