# andry018/car_sharing architecture

> Architecture diagram of the GitHub repository andry018/car_sharing, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2025-05-17). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/andry018/car_sharing
- Repository: https://github.com/andry018/car_sharing

## Overview

##### Project Type and Purpose
- This is a monolithic, command-line “full-stack” application (no network) for managing users, vehicles, bookings, time slots and tariffs entirely in C.
- Persistence is file-based; roles (admin / standard user) drive access to features.

##### File Structure
- Top-level directories:
– `/src`: C modules (business logic, interface & data access)
– `/data`: plain-text persistence files (`utenti.txt`, `veicoli.txt`, `prenotazioni.txt`, `fasceorarie.txt`)
– `/docs`: user/technical guides, API descriptions, project structure docs
- Key modules in `/src`:
– main.c → Menu / Interface Layer
– utenti.{c,h} → User Manager + Hash Table ADT
– vehicle.{c,h} → Vehicle Manager + Linked-List ADT
– prenotazioni.{c,h} → Booking Manager + Priority Queue (Binary Heap)
– fasceorarie.{c,h} → Time-Slot / Availability Manager
– tariffe.{c,h} → Tariff Manager
– data_sistema.{c,h} → Data-Access Layer (file I/O)
– hash.{c,h} → Hash Table implementation

##### README for Architecture Insights
- The README (and docs) already outline a 3-layer architecture:
Interface → Business Logic → Data Access → File System
- It details the use of specific ADTs (heap, linked list, hash table) and describes module interactions (e.g., Booking Manager calls Vehicle Manager, then writes to file).

##### Main Components & Their Interactions
a. Components:
1. Interface Layer
- Menu System (main.c)
2. Business Logic Layer
- User Manager (utenti)
- Vehicle Manager (vehicle)
- Booking Manager (prenotazioni)
- Time-Slot Manager (fasceorarie)
- Tariff Manager (tariffe)
3. Data Access Layer
- File Operations / Persistence (data_sistema)
- Input Validation & Error Handling
4. File System
- Data files in `/data`
- Backup & file locking
b. Interactions:
- UI → calls Business Logic APIs
- Booking Manager ↔ Vehicle Manager (check availability)
- Booking Manager → Data Access (save booking)
- User Manager ↔ Hash ADT for login/registration
- Vehicle Manager ↔ List ADT for add/remove vehicles
- Data Access → File System (reads/writes `.txt`)
c. Architectural Patterns:
- Layered architecture (clear separation)
- Modular C with well-defined ADTs: priority queue, linked list, hash table
- Single-threaded; file locking for atomic I/O
- Menu-driven CLI
d. Technologies & Frameworks:
- C (GCC / MinGW)
- Makefile build system
- Standard C file I/O

## Diagram (Mermaid)

```mermaid
flowchart TD
    %% Interface Layer
    subgraph "Interface Layer"
        Menu["Menu System (main.c)"]:::ui
    end

    %% Business Logic Layer
    subgraph "Business Logic Layer"
        Utenti["User Manager (utenti.c)"]:::logic
        Vehicle["Vehicle Manager (vehicle.c)"]:::logic
        Pren["Booking Manager (prenotazioni.c)"]:::logic
        Fascia["Time-Slot Manager (fasceorarie.c)"]:::logic
        Tariff["Tariff Manager (tariffe.c)"]:::logic
    end

    %% ADT Components
    subgraph "ADT Layer"
        HashADT["Hash Table ADT (hash.c)"]:::adt
        ListADT["Linked-List ADT"]:::adt
        HeapADT["Heap ADT"]:::adt
    end

    %% Data Access Layer
    subgraph "Data Access Layer"
        DataAccess["File Ops / Persistence (data_sistema.c)"]:::dataaccess
    end

    %% File System
    subgraph "File System"
        UtTxt["utenti.txt"]:::files
        VeTxt["veicoli.txt"]:::files
        PrTxt["prenotazioni.txt"]:::files
        FsTxt["fasceorarie.txt"]:::files
    end

    %% Connections
    Menu -->|"invokes"| Utenti
    Menu -->|"invokes"| Vehicle
    Menu -->|"invokes"| Pren
    Menu -->|"invokes"| Fascia
    Menu -->|"invokes"| Tariff

    Utenti <-->|"uses"| HashADT
    Vehicle <-->|"uses"| ListADT
    Pren <-->|"uses"| HeapADT

    Pren -->|"checks availability"| Vehicle
    Pren -->|"saves booking"| DataAccess

    DataAccess -->|"writes/reads"| UtTxt
    DataAccess -->|"writes/reads"| VeTxt
    DataAccess -->|"writes/reads"| PrTxt
    DataAccess -->|"writes/reads"| FsTxt

    %% Click Events
    click Menu "https://github.com/andry018/car_sharing/blob/main/src/main.c"
    click Utenti "https://github.com/andry018/car_sharing/blob/main/src/utenti.c"
    click Vehicle "https://github.com/andry018/car_sharing/blob/main/src/vehicle.c"
    click Pren "https://github.com/andry018/car_sharing/blob/main/src/prenotazioni.c"
    click Fascia "https://github.com/andry018/car_sharing/blob/main/src/fasceorarie.c"
    click Tariff "https://github.com/andry018/car_sharing/blob/main/src/tariffe.c"
    click DataAccess "https://github.com/andry018/car_sharing/blob/main/src/data_sistema.c"
    click HashADT "https://github.com/andry018/car_sharing/blob/main/src/hash.c"
    click UtTxt "https://github.com/andry018/car_sharing/blob/main/data/utenti.txt"
    click VeTxt "https://github.com/andry018/car_sharing/blob/main/data/veicoli.txt"
    click PrTxt "https://github.com/andry018/car_sharing/blob/main/data/prenotazioni.txt"
    click FsTxt "https://github.com/andry018/car_sharing/blob/main/data/fasceorarie.txt"

    %% Styles
    classDef ui fill:#D0E8F2,stroke:#036280,color:#036280,stroke-width:1px;
    classDef logic fill:#DFF2BF,stroke:#4F8A10,color:#4F8A10,stroke-width:1px,stroke-dasharray: 5 5;
    classDef adt fill:#FFF2CC,stroke:#BF9000,color:#BF9000,stroke-width:1px,stroke-dasharray: 2 2;
    classDef dataaccess fill:#FDEBD0,stroke:#D35400,color:#D35400,stroke-width:1px,stroke-dasharray: 3 3;
    classDef files fill:#E8E8E8,stroke:#888888,color:#555555,stroke-width:1px;
```
