How zsr22/pes_project works
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.