# pikolosan/car-rental-website---college-project- architecture

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

- Interactive diagram: https://gitdiagram.com/pikolosan/car-rental-website---college-project-
- Repository: https://github.com/pikolosan/car-rental-website---college-project-

## Overview

##### Project type and purpose
- Project Type: Full-stack monolithic web application
- Purpose: A car rental management system (“RentACar”) that lets customers browse and book vehicles, and allows administrators to manage inventory, bookings, and users.

##### File structure
- Top-level files
- app.js – main Express application entry point
- cloudConfig.js – cloud service configuration (e.g., image uploads)
- schema.js – database connection and schema initialization
- deletedata.js / loadData.js / init/… – data seeding and initialization
- middleware.js – global middleware (e.g., authentication, error handling)
- Directories
- controllers/ – business logic for listings, reviews, users
- routes/ – Express routing modules matching controllers
- models/ – Mongoose models (Booking, Listing, Review, User)
- views/ – EJS templates, organized by feature (layouts, includes, listings, users)
- public/ – Static assets (CSS, JS, images)
- utils/ – helper classes (ExpressError, wrapAsync)
- Configuration files
- package.json / package-lock.json – dependencies
- .gitignore

##### Main components
a. Client (Browser)
- Requests HTML, CSS, JavaScript
- Sends form submissions / AJAX to server
b. Web Server (Express.js)
- app.js
- Routes layer → Controllers → Models
- Middleware (authentication, error handling)
c. Database (MongoDB / MySQL)
- Collections / tables: Users, Listings, Reviews, Bookings
d. Cloud Service (e.g., Cloudinary)
- Image upload & storage via cloudConfig.js
e. Initialization & Admin CLI
- Scripts: init/index.js, loadData.js, deletedata.js

##### Relationships and interactions
- Client → HTTP Request → Express Routes
- Route Handler → Controller Function
- Controller → Model CRUD → Database
- Controller → Renders EJS views + data → Client
- Client → Static Assets served from /public
- Image uploads flow: Client → Express → Cloud Service → URL stored in DB
- Admin scripts → Direct DB connection to seed or delete data

##### Architectural patterns and design principles
- MVC (Model-View-Controller):
- Model: Mongoose schemas (models/)
- View: EJS templates (views/)
- Controller: controllers/
- Layered architecture: routing → business logic → data access
- Modularization: one route/controller per feature (users, listings, bookings, reviews)
- Separation of concerns:
- utils for shared helpers
- middleware for cross-cutting concerns
- init scripts for one-time tasks

##### Key technologies and frameworks
- Node.js, Express.js
- MongoDB (via Mongoose) or MySQL
- EJS templating
- Client-side JS & CSS in public/
- JWT (authentication – in middleware.js)
- Cloudinary/S3 (cloudConfig.js) for image storage

- Rectangle: Client Browser
- Rounded rectangle: Express App
- Frontend/UI (light blue)
- Backend/API (light green)
- Data layer (light orange)
- External services (light gray)
- HTTP/HTTPS
- JSON (API responses)
- EJS rendering

## Diagram (Mermaid)

```mermaid
flowchart TD
    subgraph "Client"
        Browser["Browser"]:::frontend
        StaticAssets[/"Static Assets (public/)"/]:::frontend
        Views["Dynamic Views (views/)"]:::frontend
    end

    subgraph "Server (Express App)"
        App["app.js"]:::backend
        Middleware["middleware.js"]:::backend
        Routes["Routes (routes/)"]:::backend
        Controllers["Controllers (controllers/)"]:::backend
        Models["Models (models/)"]:::data
        Schema["schema.js"]:::data
        CloudConfig["cloudConfig.js"]:::external
        Utils["Utils (utils/)"]:::backend
    end

    Database[(Database)]:::data
    CloudService((Cloud Storage)):::external

    subgraph "Admin CLI"
        InitIndex["init/index.js"]:::backend
        InitData["init/data.js"]:::backend
        LoadData["loadData.js"]:::backend
        DeleteData["deletedata.js"]:::backend
    end

    subgraph "Configuration"
        Package["package.json / package-lock.json"]:::backend
        GitIgnore[".gitignore"]:::backend
        README["README.md"]:::backend
    end

    Browser -->|HTTP/HTTPS| App
    Browser -->|requests| StaticAssets
    Browser -->|requests| Views
    App -->|uses| Middleware
    App -->|routes| Routes
    Middleware -->|auth/error| App
    Routes -->|calls| Controllers
    Controllers -->|CRUD| Models
    Models -->|connect| Database
    Controllers -->|renders EJS| Views
    Controllers -->|serve static| StaticAssets
    Controllers -->|upload images| CloudConfig
    CloudConfig -->|stores| CloudService
    InitIndex -->|seed/delete| Database
    InitData -->|seed| Database
    LoadData -->|load data| Database
    DeleteData -->|delete data| Database
    Schema -->|init| Database
    App -->|require| Schema
    App -->|uses| CloudConfig
    App -->|uses| Utils

    click Browser "https://github.com/pikolosan/car-rental-website---college-project-/tree/main/public/"
    click StaticAssets "https://github.com/pikolosan/car-rental-website---college-project-/tree/main/public/"
    click Views "https://github.com/pikolosan/car-rental-website---college-project-/tree/main/views/"
    click App "https://github.com/pikolosan/car-rental-website---college-project-/blob/main/app.js"
    click Middleware "https://github.com/pikolosan/car-rental-website---college-project-/blob/main/middleware.js"
    click Routes "https://github.com/pikolosan/car-rental-website---college-project-/tree/main/routes/"
    click Controllers "https://github.com/pikolosan/car-rental-website---college-project-/tree/main/controllers/"
    click Models "https://github.com/pikolosan/car-rental-website---college-project-/tree/main/models/"
    click Schema "https://github.com/pikolosan/car-rental-website---college-project-/blob/main/schema.js"
    click CloudConfig "https://github.com/pikolosan/car-rental-website---college-project-/blob/main/cloudConfig.js"
    click Utils "https://github.com/pikolosan/car-rental-website---college-project-/tree/main/utils/"
    click InitIndex "https://github.com/pikolosan/car-rental-website---college-project-/blob/main/init/index.js"
    click InitData "https://github.com/pikolosan/car-rental-website---college-project-/blob/main/init/data.js"
    click LoadData "https://github.com/pikolosan/car-rental-website---college-project-/blob/main/loadData.js"
    click DeleteData "https://github.com/pikolosan/car-rental-website---college-project-/blob/main/deletedata.js"
    click Package "https://github.com/pikolosan/car-rental-website---college-project-/blob/main/package.json"
    click GitIgnore "https://github.com/pikolosan/car-rental-website---college-project-/blob/main/.gitignore"
    click README "https://github.com/pikolosan/car-rental-website---college-project-/blob/main/README.md"

    classDef frontend fill:#cce5ff,stroke:#333,stroke-width:1px
    classDef backend fill:#d4edda,stroke:#333,stroke-width:1px
    classDef data fill:#fff3cd,stroke:#333,stroke-width:1px
    classDef external fill:#e2e3e5,stroke:#333,stroke-width:1px
```
