# talalalha/vehicfinder-cpit305-project architecture

> Architecture diagram of the GitHub repository talalalha/vehicfinder-cpit305-project, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2025-07-24). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/talalalha/vehicfinder-cpit305-project
- Repository: https://github.com/talalalha/vehicfinder-cpit305-project

## Overview

##### Project type and purpose
- VehicFinder is a Java-based, console-driven car-search application with two operating modes:
- Local mode: reads car data from a CSV file (or local database) and filters results in-process.
- Server/Client mode: runs a server that holds the data and business logic, and one or more clients that connect over TCP to request filtered results.
- It uses Maven for build, JDK 11+, optional MySQL (or other JDBC) database, and simple socket networking.

##### File structure
- Top-level artifacts:
- pom.xml – Maven build, dependencies, packaging.
- CleanedCarData.csv – source of car data for local mode.
- src/main/java/IO/CSVReader.java – CSV file parsing.
- src/main/java/db/… – domain model (Cars), persistence (DatabaseConnection), controller (CarsController), Main launcher.
- src/main/java/Networking/Server.java & Client.java – TCP server and client entry points.
- src/main/java/org/example/App.java – console UI/menu logic.
- Tests mirror each package under src/test/java.
- No external microservice definitions, so it’s a single monolithic codebase with two run profiles.

##### README for additional insights
- Confirms two modes: local and server/client.
- Workflow: user inputs filters → application reads data → applies filters → presents results.
- In server/client: the client shows the same prompts but forwards them to the server over port 9000.

3. Split beneath into two paths:
– Server/Client path:

## Diagram (Mermaid)

```mermaid
flowchart TB
    %% Local Mode
    subgraph "Local Mode"
        UI["Console UI\n(org.example.App)"]:::ui
        Controller["CarsController\n(db.CarsController)"]:::service
        CSV["CSVReader\n(IO.CSVReader)"]:::data
        DBConn["DatabaseConnection\n(db.DatabaseConnection)"]:::data
        CarModel["Car Entity\n(db.Cars)"]:::service

        UI -->|"filterBy(...) "| Controller
        Controller -->|reads from| CSV
        Controller -->|queries| DBConn
        CSV -->|parses to| CarModel
        DBConn -->|maps to| CarModel
        CarModel -->|returns Car objects| Controller
    end

    %% Server/Client Mode
    subgraph "Server/Client Mode"
        UI -->|"remote filterBy(...) "| NetworkClient["Network Client\n(Networking.Client)"]:::network
        NetworkClient -->|"send filter request"| NetworkServer["Network Server\n(Networking.Server)"]:::network
        NetworkServer -->|invoke| Controller
        Controller -->|reads from| CSV
        Controller -->|queries| DBConn
        NetworkServer -->|"send filtered results"| NetworkClient
        NetworkClient -->|display results| UI
    end

    %% External Data Sources
    CSVFile["CleanedCarData.csv"]:::external
    MySQL["MySQL"]:::external
    Pom["pom.xml"]:::external

    CSVFile -.->|local CSV| CSV
    MySQL -.->|JDBC| DBConn

    %% Click Events
    click UI "https://github.com/talalalha/vehicfinder-cpit305-project/blob/master/src/main/java/org/example/App.java"
    click Controller "https://github.com/talalalha/vehicfinder-cpit305-project/blob/master/src/main/java/db/CarsController.java"
    click CSV "https://github.com/talalalha/vehicfinder-cpit305-project/blob/master/src/main/java/IO/CSVReader.java"
    click DBConn "https://github.com/talalalha/vehicfinder-cpit305-project/blob/master/src/main/java/db/DatabaseConnection.java"
    click CarModel "https://github.com/talalalha/vehicfinder-cpit305-project/blob/master/src/main/java/db/Cars.java"
    click NetworkServer "https://github.com/talalalha/vehicfinder-cpit305-project/blob/master/src/main/java/Networking/Server.java"
    click NetworkClient "https://github.com/talalalha/vehicfinder-cpit305-project/blob/master/src/main/java/Networking/Client.java"
    click CSVFile "https://github.com/talalalha/vehicfinder-cpit305-project/blob/master/CleanedCarData.csv"
    click Pom "https://github.com/talalalha/vehicfinder-cpit305-project/blob/master/pom.xml"

    %% Styles
    classDef ui fill:#D6EAF8,stroke:#1B4F72,color:#1B2631;
    classDef service fill:#D5F5E3,stroke:#196F3D,color:#145A32;
    classDef data fill:#FCF3CF,stroke:#B7950B,color:#7D6608;
    classDef network fill:#FAD7A0,stroke:#BA4A00,color:#78281F;
    classDef external fill:#E5E7E9,stroke:#7B7D7D,color:#424949;
```
