# manveenkaur21/aerobagtrack architecture

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

- Interactive diagram: https://gitdiagram.com/manveenkaur21/aerobagtrack
- Repository: https://github.com/manveenkaur21/aerobagtrack

## Overview

AeroBagTrack is a Java console application for baggage registration, status tracking, complaints, and lost/found recovery. Its main workflow starts in the menu: register and validate baggage, update its status and tracking history, or record complaints and found items and search for matches. It keeps operational records in memory and offers text/CSV export; JDBC is optional. The graph reflects calls visible in Main and sampled services; the additional service utilities are indexed but not inspected, so their internal relationships are omitted.

Main entry points: [`src/Main.java`](https://github.com/manveenkaur21/aerobagtrack/blob/main/src/Main.java) (Menu and workflows), [`src/model/Baggage.java`](https://github.com/manveenkaur21/aerobagtrack/blob/main/src/model/Baggage.java) (Baggage record), [`src/service/MatchingService.java`](https://github.com/manveenkaur21/aerobagtrack/blob/main/src/service/MatchingService.java) (Lost-found matching), [`src/model/FoundBaggage.java`](https://github.com/manveenkaur21/aerobagtrack/blob/main/src/model/FoundBaggage.java) (Found baggage record)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_console["Console workflow"]
  node_main["Menu and workflows<br/>[Main.java]"]
end

subgraph group_operations["Baggage operations"]
  node_validation["Baggage validation"]
  node_baggage_service["Baggage registry"]
  node_tracking["Tracking history"]
  node_service_tools["Baggage tools"]
end

subgraph group_recovery["Complaints and recovery"]
  node_complaints["Complaint handling"]
  node_found_service["Found baggage registry"]
  node_matching["Lost-found matching"]
end

subgraph group_data["Models and persistence"]
  node_baggage["Baggage record<br/>[Baggage.java]"]
  node_complaint_model["Complaint record<br/>[Complaint.java]"]
  node_found_model["Found baggage record<br/>[FoundBaggage.java]"]
  node_user_models["User and passenger<br/>[User.java]"]
  node_staff["Staff<br/>[Staff.java]"]
  node_text_file["Text file storage<br/>[FileHandler.java]"]
  node_csv["CSV storage<br/>[CSVHandler.java]"]
  node_dao["Baggage DAO<br/>[BaggageDAO.java]"]
  node_db_connection["JDBC connection"]
end

node_passenger(("Passenger"))

node_passenger -->|"uses console"| node_main
node_main -->|"validates"| node_validation
node_main -->|"registers and updates"| node_baggage_service
node_main -->|"initializes and updates"| node_tracking
node_main -->|"registers and displays"| node_complaints
node_main -->|"registers and lists"| node_found_service
node_main -->|"finds and displays matches"| node_matching
node_main -->|"saves and reads"| node_text_file
node_main -->|"exports"| node_csv
node_main -->|"constructs"| node_baggage
node_main -->|"constructs"| node_complaint_model
node_main -->|"constructs"| node_found_model
node_baggage_service -->|"stores and updates"| node_baggage
node_tracking -->|"tracks by ID"| node_baggage
node_complaints -->|"manages"| node_complaint_model
node_found_service -->|"manages"| node_found_model
node_matching -->|"compares lost item"| node_baggage
node_matching -->|"compares found items"| node_found_model
node_text_file -->|"serializes"| node_baggage
node_csv -->|"exports fields"| node_baggage
node_dao -->|"persists records"| node_baggage
node_dao -.->|"obtains connection"| node_db_connection
node_user_models -->|"base type"| node_passenger
node_user_models -->|"base type"| node_staff

click node_main "https://github.com/manveenkaur21/aerobagtrack/blob/main/src/Main.java"
click node_validation "https://github.com/manveenkaur21/aerobagtrack/blob/main/src/service/BaggageValidator.java"
click node_baggage_service "https://github.com/manveenkaur21/aerobagtrack/blob/main/src/service/BaggageService.java"
click node_tracking "https://github.com/manveenkaur21/aerobagtrack/blob/main/src/service/TrackingService.java"
click node_service_tools "https://github.com/manveenkaur21/aerobagtrack/tree/main/src/service"
click node_complaints "https://github.com/manveenkaur21/aerobagtrack/blob/main/src/service/ComplaintService.java"
click node_found_service "https://github.com/manveenkaur21/aerobagtrack/blob/main/src/service/FoundBaggageService.java"
click node_matching "https://github.com/manveenkaur21/aerobagtrack/blob/main/src/service/MatchingService.java"
click node_baggage "https://github.com/manveenkaur21/aerobagtrack/blob/main/src/model/Baggage.java"
click node_complaint_model "https://github.com/manveenkaur21/aerobagtrack/blob/main/src/model/Complaint.java"
click node_found_model "https://github.com/manveenkaur21/aerobagtrack/blob/main/src/model/FoundBaggage.java"
click node_user_models "https://github.com/manveenkaur21/aerobagtrack/blob/main/src/model/User.java"
click node_staff "https://github.com/manveenkaur21/aerobagtrack/blob/main/src/model/Staff.java"
click node_text_file "https://github.com/manveenkaur21/aerobagtrack/blob/main/src/util/FileHandler.java"
click node_csv "https://github.com/manveenkaur21/aerobagtrack/blob/main/src/util/CSVHandler.java"
click node_dao "https://github.com/manveenkaur21/aerobagtrack/blob/main/src/dao/BaggageDAO.java"
click node_db_connection "https://github.com/manveenkaur21/aerobagtrack/blob/main/src/util/DatabaseConnection.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_main toneBlue
class node_validation,node_baggage_service,node_tracking,node_service_tools toneAmber
class node_complaints,node_found_service,node_matching toneMint
class node_baggage,node_complaint_model,node_found_model,node_user_models,node_staff,node_text_file,node_csv,node_dao,node_db_connection toneRose
class node_passenger toneIndigo
```

## Components

### Console workflow

- [Menu and workflows](https://github.com/manveenkaur21/aerobagtrack/blob/main/src/Main.java): `src/Main.java`

### Baggage operations

- [Baggage validation](https://github.com/manveenkaur21/aerobagtrack/blob/main/src/service/BaggageValidator.java): `src/service/BaggageValidator.java`
- [Baggage registry](https://github.com/manveenkaur21/aerobagtrack/blob/main/src/service/BaggageService.java): `src/service/BaggageService.java`
- [Tracking history](https://github.com/manveenkaur21/aerobagtrack/blob/main/src/service/TrackingService.java): `src/service/TrackingService.java`
- [Baggage tools](https://github.com/manveenkaur21/aerobagtrack/tree/main/src/service): `src/service`

### Complaints and recovery

- [Complaint handling](https://github.com/manveenkaur21/aerobagtrack/blob/main/src/service/ComplaintService.java): `src/service/ComplaintService.java`
- [Found baggage registry](https://github.com/manveenkaur21/aerobagtrack/blob/main/src/service/FoundBaggageService.java): `src/service/FoundBaggageService.java`
- [Lost-found matching](https://github.com/manveenkaur21/aerobagtrack/blob/main/src/service/MatchingService.java): `src/service/MatchingService.java`

### Models and persistence

- [Baggage record](https://github.com/manveenkaur21/aerobagtrack/blob/main/src/model/Baggage.java): `src/model/Baggage.java`
- [Complaint record](https://github.com/manveenkaur21/aerobagtrack/blob/main/src/model/Complaint.java): `src/model/Complaint.java`
- [Found baggage record](https://github.com/manveenkaur21/aerobagtrack/blob/main/src/model/FoundBaggage.java): `src/model/FoundBaggage.java`
- [User and passenger](https://github.com/manveenkaur21/aerobagtrack/blob/main/src/model/User.java): `src/model/User.java`
- [Staff](https://github.com/manveenkaur21/aerobagtrack/blob/main/src/model/Staff.java): `src/model/Staff.java`
- [Text file storage](https://github.com/manveenkaur21/aerobagtrack/blob/main/src/util/FileHandler.java): `src/util/FileHandler.java`
- [CSV storage](https://github.com/manveenkaur21/aerobagtrack/blob/main/src/util/CSVHandler.java): `src/util/CSVHandler.java`
- [Baggage DAO](https://github.com/manveenkaur21/aerobagtrack/blob/main/src/dao/BaggageDAO.java): `src/dao/BaggageDAO.java`
- [JDBC connection](https://github.com/manveenkaur21/aerobagtrack/blob/main/src/util/DatabaseConnection.java): `src/util/DatabaseConnection.java`

### Other components

- **Passenger**

## Connections

- Passenger → Menu and workflows: uses console (evidence: `src/Main.java`)
- Menu and workflows → Baggage validation: validates (evidence: `src/Main.java`)
- Menu and workflows → Baggage registry: registers and updates (evidence: `src/Main.java`)
- Menu and workflows → Tracking history: initializes and updates (evidence: `src/Main.java`)
- Menu and workflows → Complaint handling: registers and displays (evidence: `src/Main.java`)
- Menu and workflows → Found baggage registry: registers and lists (evidence: `src/Main.java`)
- Menu and workflows → Lost-found matching: finds and displays matches (evidence: `src/Main.java`)
- Menu and workflows → Text file storage: saves and reads (evidence: `src/Main.java`)
- Menu and workflows → CSV storage: exports (evidence: `src/Main.java`)
- Menu and workflows → Baggage record: constructs (evidence: `src/Main.java`)
- Menu and workflows → Complaint record: constructs (evidence: `src/Main.java`)
- Menu and workflows → Found baggage record: constructs (evidence: `src/Main.java`)
- Baggage registry → Baggage record: stores and updates (evidence: `src/service/BaggageService.java`)
- Tracking history → Baggage record: tracks by ID (evidence: `src/Main.java`)
- Complaint handling → Complaint record: manages (evidence: `src/Main.java`)
- Found baggage registry → Found baggage record: manages (evidence: `src/service/FoundBaggageService.java`)
- Lost-found matching → Baggage record: compares lost item (evidence: `src/service/MatchingService.java`)
- Lost-found matching → Found baggage record: compares found items (evidence: `src/service/MatchingService.java`)
- Text file storage → Baggage record: serializes (evidence: `src/util/FileHandler.java`)
- CSV storage → Baggage record: exports fields (evidence: `src/util/CSVHandler.java`)
- Baggage DAO → Baggage record: persists records (evidence: `src/dao/BaggageDAO.java`)
- Baggage DAO → JDBC connection: obtains connection (evidence: `src/dao/BaggageDAO.java`)
- User and passenger → Passenger: base type
- User and passenger → Staff: base type (evidence: `src/model/Staff.java`)
