# mistercioffi/artemiscartesio architecture

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

- Interactive diagram: https://gitdiagram.com/mistercioffi/artemiscartesio
- Repository: https://github.com/mistercioffi/artemiscartesio

## Overview

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.

## Diagram (Mermaid)

```mermaid
flowchart TD
    %% Presentation Layer
    subgraph "Presentation Layer"
        APEX["Oracle APEX"]:::presentation
    end

    %% Security Layer
    subgraph "Security and Roles"
        Roles["Ruoli e Permessi"]:::security
    end

    %% Logic Layer
    subgraph "Logic Layer (PL/SQL)"
        Procedures["Procedure/PLSQL"]:::logic
        Triggers["Trigger"]:::logic
    end

    %% Reporting Layer
    subgraph "Reporting Layer"
        Views["Viste"]:::reporting
        Queries["Query di Report"]:::reporting
    end

    %% Data Layer
    subgraph "Data Layer"
        Tables["Tabelle"]:::data
        Constraints["Constraint"]:::data
        Indices["Indici"]:::data
    end

    %% Data Seeding
    subgraph "Data Seeding"
        Popolamento["Script di Popolamento"]:::data
    end

    %% Documentation and Assets
    subgraph "Documentation and Assets"
        DocER["Modello ER e Specifiche (PDF)"]:::docs
        Static["Asset Statici"]:::docs
        Guidelines["File di Progetto e Linee Guida"]:::docs
    end

    %% Connections
    APEX -->|"SELECT FROM Viste"| Views
    APEX -->|"INSERT/UPDATE"| Tables
    APEX -->|"CALL PROC()"| Procedures

    Roles -->|"READ/WRITE"| Tables
    Roles -->|"EXECUTE"| Procedures
    Roles -->|"ACCESS"| APEX

    Procedures -->|"CALLS / DML"| Tables
    Triggers -->|"ON DML"| Tables

    Views -->|"SELECT FROM Tables"| Tables
    Queries -->|"SELECT FROM Views"| Views
    Queries -->|"SELECT FROM Tables"| Tables

    Popolamento -->|"INSERT"| Tables

    Constraints -->|"APPLY"| Tables
    Indices -->|"APPLY"| Tables

    DocER --- Guidelines
    DocER --- Static
    Guidelines --- Static

    %% Click Events
    click Tables "https://github.com/mistercioffi/artemiscartesio/blob/main/Progettazione_Fisica/create_table.sql"
    click Constraints "https://github.com/mistercioffi/artemiscartesio/blob/main/Progettazione_Fisica/constraint.sql"
    click Indices "https://github.com/mistercioffi/artemiscartesio/blob/main/Indici/indici.sql"
    click Triggers "https://github.com/mistercioffi/artemiscartesio/blob/main/Trigger/triggers.sql"
    click Procedures "https://github.com/mistercioffi/artemiscartesio/blob/main/Procedure/procedure.sql"
    click Views "https://github.com/mistercioffi/artemiscartesio/blob/main/Viste/views.sql"
    click Popolamento "https://github.com/mistercioffi/artemiscartesio/blob/main/Popolamento/popolamento.sql"
    click Queries "https://github.com/mistercioffi/artemiscartesio/blob/main/Query/query.sql"
    click Roles "https://github.com/mistercioffi/artemiscartesio/blob/main/Ruoli/roles.sql"
    click DocER "https://github.com/mistercioffi/artemiscartesio/blob/main/ArtemisCartesio_Cioffi_Cirino.pdf"
    click Static "https://github.com/mistercioffi/artemiscartesio/tree/main/Media/Screenshot_App"
    click Guidelines "https://github.com/mistercioffi/artemiscartesio/blob/main/Traccia Basi di Dati 2024-2025.pdf"

    %% Styles
    classDef presentation fill:#D8BFD8,stroke:#9370DB,color:#4B0082
    classDef logic fill:#98FB98,stroke:#2E8B57,color:#006400
    classDef data fill:#ADD8E6,stroke:#4169E1,color:#00008B
    classDef reporting fill:#FFA500,stroke:#FF8C00,color:#8B4500
    classDef security fill:#FFC0CB,stroke:#FF69B4,color:#C71585
    classDef docs fill:#D3D3D3,stroke:#A9A9A9,color:#2F4F4F
```
