# zsr22/pes_project architecture

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

- Interactive diagram: https://gitdiagram.com/zsr22/pes_project
- Repository: https://github.com/zsr22/pes_project

## Overview

Per disegnare un diagramma di sistema chiaro e dettagliato per il progetto SGP – Sistema di Gestione Palestra (C, CLI), segui questi passi:

##### Individua il tipo di progetto e lo scopo
- È un’applicazione monolitica a riga di comando in C, pensata per gestire clienti, abbonamenti, prenotazioni e generare report JSON.
- Non ci sono microservizi né UI web; l’interfaccia è esclusivamente CLI.

##### Analizza la struttura del progetto
- Root: makefile, main.c, moduli C/H separati per ciascuna responsabilità
- Lezioni.\* → gestione lezioni
- abbonamenti.\* → gestione abbonamenti
- Prenotazione.\*, Lista_Prenotazioni.\* → gestione prenotazioni
- Persistenza_Dati.\* → I/O su file JSON (cartella persistente persistena_dati/)
- report.\* → generazione report mensile JSON (cartella archivio_report/)
- Utilities.\* → funzioni ausiliarie generali
- Libreria esterna: cjson/ (cJSON.c, cJSON.h, Utils) per parsing/generazione JSON.
- Dati su filesystem: persistena_dati/*.json

##### Sviluppa lo schema dei componenti principali
Raggruppali in tre layer logici:

A. Presentation Layer (CLI)
- Componente: main.c
- Responsabilità: menu, parsing input utente, routing delle chiamate ai moduli di business.

B. Business Logic Layer
- Moduli:
- Gestione Clienti & Abbonamenti (abbonamenti.c/h + eventuali funzioni in Utilities)
- Gestione Lezioni (Lezioni.c/h)
- Gestione Prenotazioni (Prenotazione.c/h + Lista_Prenotazioni.c/h)
- Generazione Report (report.c/h)
- Ogni modulo implementa le regole di dominio (controllo duplicati, capienza lezioni, validità abbonamenti).

C. Data Access Layer
- Persistenza_Dati.c/h: responsabilità CRUD sul filesystem.
- Internamente usa cJSON per leggere/scrivere file JSON (Clienti.json, Lezioni.json, Prenotazioni.json).
- I file JSON risiedono in persistena_dati/.

D. Libreria Esterna
- cJSON: parser/generator JSON.

##### Definisci relazioni e flussi
- Frecce dal CLI (main.c) verso i moduli di business quando l’utente invoca un comando.
- Frecce dai moduli di business al Data Access Layer per leggere/scrivere dati.
- Frecce dal Data Access Layer alla libreria cJSON (dipendenza) e dal filesystem (file JSON).
- Frecce di ritorno con i risultati (es. struttura dati in memoria) verso il CLI per stampa su schermo.
- Freccia separata dalla business logic al modulo report per generare e salvare report in archivio_report/.

##### Evidenzia pattern e principi
- Modularità: separazione per responsabilità in file .c/.h
- Layered architecture (Presentation, Business, Data)
- Inversion of control minima: il CLI dirige il flusso
- Uso di libreria esterna (cJSON) per non reinventare il parser JSON.

##### Aggiungi tecnologie e artefatti
- Makefile: build script, target “SGP” e “SGP_TEST” (branch test)
- Cartella doc/: report di progetto (docx, pdf) – può essere annotata come “documentazione esterna”
- persistena_dati/ e archivio_report/: “storage” a livello di file system

##### Linee guida per il diagramma
- Usa riquadri rettangolari per ogni componente/layer.
- Colori diversi:
- Blu per Presentation,
- Verde per Business Logic,
- Arancione per Data Access,
- Viola per librerie esterne,
- Grigio per file system.
- Etichetta chiaramente ogni blocco con nome modulo e responsabilità.
- Frecce direzionali per flusso dati/controllo (annota “invoca”, “legge/scrive JSON”, “parsing/generazione JSON”).

##### Elementi obbligatori nel diagramma
- Legenda colori e forme
- Blocchi distinti per main.c, ciascun modulo .c/.h, Persistenza_Dati, cJSON, filesystem
- Frecce con descrizioni brevi (es. “readClients()”, “cJSON_Parse()”, “print_menu()”)

Con questo approccio otterrai un diagramma di sistema fedele all’architettura del progetto, in cui ogni file e directory trova una collocazione logica e ogni dipendenza è tracciata.

## Diagram (Mermaid)

```mermaid
graph TB

  subgraph "Presentation Layer"
    Main["main.c\nCLI interface"]:::presentation
  end

  subgraph "Business Logic Layer"
    ABM["abbonamenti.c/h\nGestione clienti & abbonamenti"]:::business
    UT["Utilities.c/h\nFunzioni ausiliarie"]:::business
    LES["Lezioni.c/h\nGestione lezioni"]:::business
    PRE["Prenotazione.c/h\nGestione prenotazioni"]:::business
    LP["Lista_Prenotazioni.c/h\nGestione lista prenotazioni"]:::business
    REP["report.c/h\nGenerazione report"]:::business
  end

  subgraph "Data Access Layer"
    PDS["Persistenza_Dati.c/h\nCRUD su filesystem"]:::data
  end

  subgraph "External Library"
    CJ1["cJSON.c/h\nParser/Generator JSON"]:::external
    CJ2["cJSON_Utils.c/h\nUtility JSON"]:::external
  end

  subgraph "Filesystem"
    FS1["Clienti.json"]:::fs
    FS2["Lezioni.json"]:::fs
    FS3["Prenotazioni.json"]:::fs
    ARCH["archivio_report/"]:::fs
  end

  subgraph "Build & Documentation"
    MF["makefile"]:::build
    RD["README.md"]:::build
    DOC1["Report.docx/pdf"]:::build
  end

  %% Flussi
  Main -->|"invoca"| ABM
  Main -->|"invoca"| LES
  Main -->|"invoca"| PRE
  Main -->|"invoca"| REP

  ABM -->|"read/write JSON"| PDS
  LES -->|"read/write JSON"| PDS
  PRE -->|"read/write JSON"| PDS
  REP -->|"read/write JSON"| PDS

  PDS -->|"parsing/generazione JSON"| CJ1
  PDS -->|"utilizza funzioni JSON"| CJ2

  PDS -->|"legge/scrive"| FS1
  PDS -->|"legge/scrive"| FS2
  PDS -->|"legge/scrive"| FS3

  REP -->|"salva report"| ARCH

  %% Click Events
  click Main "https://github.com/zsr22/pes_project/blob/main/./main.c"
  click ABM "https://github.com/zsr22/pes_project/blob/main/./abbonamenti.c"
  click UT "https://github.com/zsr22/pes_project/blob/main/./Utilities.c"
  click LES "https://github.com/zsr22/pes_project/blob/main/./Lezioni.c"
  click PRE "https://github.com/zsr22/pes_project/blob/main/./Prenotazione.c"
  click LP "https://github.com/zsr22/pes_project/blob/main/./Lista_Prenotazioni.c"
  click REP "https://github.com/zsr22/pes_project/blob/main/./report.c"
  click PDS "https://github.com/zsr22/pes_project/blob/main/./Persistenza_Dati.c"
  click FS1 "https://github.com/zsr22/pes_project/blob/main/./persistenza_dati/Clienti.json"
  click FS2 "https://github.com/zsr22/pes_project/blob/main/./persistenza_dati/Lezioni.json"
  click FS3 "https://github.com/zsr22/pes_project/blob/main/./persistenza_dati/Prenotazioni.json"
  click CJ1 "https://github.com/zsr22/pes_project/blob/main/./cjson/cJSON.c"
  click CJ2 "https://github.com/zsr22/pes_project/blob/main/./cjson/cJSON_Utils.c"
  click MF "https://github.com/zsr22/pes_project/tree/main/./makefile"
  click RD "https://github.com/zsr22/pes_project/blob/main/./README.md"
  click DOC1 "https://github.com/zsr22/pes_project/blob/main/./doc/Report.docx"

  %% Styles
  classDef presentation fill:#ADD8E6,stroke:#000,stroke-width:1px;
  classDef business fill:#90EE90,stroke:#000,stroke-width:1px;
  classDef data fill:#FFA500,stroke:#000,stroke-width:1px;
  classDef external fill:#DDA0DD,stroke:#000,stroke-width:1px;
  classDef fs fill:#D3D3D3,stroke:#000,stroke-width:1px;
  classDef build fill:#F5F5F5,stroke:#000,stroke-width:1px;
```
