How mistercioffi/artemiscartesio works
Per realizzare un diagramma di sistema che rifletta accuratamente l’architettura del progetto ArtemisCartesio, segui questi passi, adattando l’approccio alla natura “pura” di un progetto di database relazionale in Oracle APEX:
Identificazione del tipo di progetto e scopo
• Progetto: Database relazionale per il monitoraggio e il controllo di missioni spaziali.
• Scopo: gestire entità quali missioni, equipaggio, robot, sensori, anomalie, interventi e report, garantendo integrità, performance e usabilità via Oracle APEX.
Analisi della struttura dei file
• Cartelle di Progettazione_Fisica: definizione delle tabelle (create_table.sql) e dei constraint (constraint.sql).
• Popolamento e Indici: script SQL per data seeding (popolamento.sql) e creazione indici (indici.sql).
• Procedure, Trigger, Viste: logica applicativa in PL/SQL (procedure funzionamento, trigger di auditing o business logic, viste per reporting).
• Query: esempi di interrogazioni finali.
• Ruoli: definizione di permessi/grant per gli utenti APEX e DB.
• Asset statici: documenti PDF con modello ER e specifiche, immagini e Banner.
Informazioni dal README
• DBMS: Oracle APEX 22.2.0.
• Linguaggi: SQL e PL/SQL.
• Focus sul modello ER, integrità dei dati, performance delle query.
Componenti principali da includere nel diagramma
a. Frontend APEX
• Ambiente Oracle APEX dove gli utenti interagiscono con form, report e dashboard.
b. Motore DB Oracle
• Schema “ArtemisCartesio” con:
• TABELLE (Missioni, Membri, Robot, Sensori, Anomalie, Interventi, …)
• INDICI per ottimizzazione
• CONSTRAINT (PK, FK, unique, check)
• TRIGGER (es. auditing, calcoli automatici)
• PROCEDURE/PLSQL (logica di business batch o on-demand)
• VISTE (level reporting)
c. Script di Popolamento e Query
• Processi di caricamento dati iniziali e reportistica.
d. Sicurezza e Ruoli
• Utenti APEX, profili, grant definiti in roles.sql.
e. Documentazione Esterna
• PDF con modello ER e specifiche (utile come legenda o livello descrittivo).
Relazioni e interazioni
• Frecce bidirezionali tra APEX e il motore DB per indicare:
• Richieste di lettura (SELECT dalle viste)
• Operazioni di scrittura (INSERT/UPDATE sulle tabelle)
• Flussi interni al DB:
• Esecuzione di TRIGGER a seguito di DML
• Chiamate a PROCEDURE da interfaccia utente o schedule
• Elementi di reporting (query → output APEX o esportazione).
Pattern architetturali e principi
• Layered Architecture: separazione tra Presentation (APEX), Logic (PL/SQL), Data (tabelle).
• Uso di Views per astrarre join complessi e mascherare la complessità.
• Stored Procedures per incapsulare logica di business e garantire atomicità/transazionalità.
• Trigger per enforcement di regole non catturate dai constraint standard.
Linee guida per il diagramma
• Blu = tabelle (Data Layer)
• Verde = logica PL/SQL (Procedure/Trigger)
• Arancio = viste e query (Reporting Layer)
• Viola = presentazione APEX
• Frecce con direzione chiara e annotazioni brevi: “INSERT”, “CALL PROC_MISSIONI”, “SELECT FROM V_REPORT”, ecc.
• Etichette per ogni elemento (es. “TABELLA: MISSIONI”, “TRIGGER: ANOMALIA_AFTER_INSERT”).
• Legenda per colori e simboli (rombi per viste, cilindri per tabelle, cilindri con ruota dentata per procedure).
Raccomandazioni finali
• Includi nel diagramma anche i file folder principali del progetto come layer concettuale, per collegare rapidamente script a componenti DB.
• Non tralasciare i ruoli di sicurezza: mostrali come componenti esterni che si collegano alle tabelle e procedure con permessi READ/WRITE/EXECUTE.
• Assicurati che il modello ER (presente nel PDF) coincida con la struttura delle tabelle nel diagramma.
Seguendo questi passaggi otterrai un diagramma di sistema esauriente per il team, che mette in evidenza ogni elemento architetturale del database, i flussi di dati e le dipendenze tra componenti. Questo facilita manutenzione, estensioni future e permette di condividere il progetto con stakeholder tecnici e non.