📄 Documentazione Tecnica

Tutto ciò che serve al tuo reparto IT

Architettura, API, sicurezza, requisiti e guide di integrazione. Documentazione completa per decisori tecnici, sviluppatori e system administrator.

Architettura

Single-tenant, modulare, aggiornabile

Medaid adotta un modello single-tenant: ogni cliente ha la propria installazione isolata con dati separati, massima personalizzazione e controllo completo.

Modello di distribuzione

Ogni installazione Medaid è dedicata al singolo cliente. Non si tratta di un SaaS multi-tenant condiviso, ma di una piattaforma isolata che garantisce:

Isolamento completo dei dati — nessuna condivisione tra clienti
Personalizzazione illimitata — campi, form, workflow, terminologia
Aggiornamenti centralizzati — il core si aggiorna senza intaccare le personalizzazioni
Compliance semplificata — DPA dedicato, residenza dati controllata

Struttura del plugin

medaid/
├── includes/
│   ├── core/          # 24 classi core (router, DB, API, PDF...)
│   └── modules/       # 15+ moduli attivabili
│       ├── calendario/
│       ├── fatturazione/
│       ├── mappatura-denti/
│       ├── mappatura-nei/
│       ├── medicina-lavoro/
│       ├── multi-sedi/
│       └── ...
├── templates/         # 129 template UI
├── migrations/        # Schema versioning
└── assets/            # CSS, JS, icone

Plugin WordPress unico con architettura a moduli interni. Caricamento condizionale: solo i moduli attivi vengono eseguiti.

Stack tecnologico

Tecnologie consolidate e affidabili

Backend

PHP 8.x, WordPress 6.x, MySQL/MariaDB, API REST custom

Frontend

HTML5, CSS3, JavaScript ES6+, Cuba UI Framework

Infrastruttura

Linux, Nginx/Apache, Let's Encrypt, CDN

Sicurezza

AES-256, TLS 1.3, OAuth 2.0, 2FA TOTP, WAF

Modello di sicurezza

Privacy by design, sicurezza by default

Ruoli e permessi

Medaid implementa un sistema RBAC (Role-Based Access Control) con 5 ruoli preconfigurati:

Sanitario — accesso completo ai dati clinici, inserimento e modifica visite, generazione referti

Segreteria — anagrafiche, appuntamenti, documenti amministrativi. Nessun accesso a dati clinici sensibili

Auditor — statistiche aggregate, log attività, checklist conformita. Nessun dato nominativo

Cliente — vista azienda per medicina del lavoro: idoneità e scadenze, zero dati clinici

Paziente — accesso ai propri dati, referti, appuntamenti. Solo lettura dei propri record

Misure di sicurezza

Crittografia AES-256 per dati a riposo (database e file)
TLS 1.3 per tutte le comunicazioni in transito
2FA TOTP con Google Authenticator / Authy
Audit trail completo su ogni azione (chi, cosa, quando)
Password policy con forzatura cambio al primo accesso
Session management con timeout e revoca remota
WAF (Web Application Firewall) integrato
Scansione malware automatica quotidiana
Backup cifrati con retention 30 giorni e DR

Requisiti di sistema

Cosa serve per eseguire Medaid

Requisiti server (self-hosted)

PHP 8.0 o superiore (8.2 consigliato)
MySQL 8.0 o MariaDB 10.6+
WordPress 6.0 o superiore
Memoria PHP: minimo 256MB (512MB consigliato)
Spazio disco: minimo 1GB
Certificato SSL/TLS valido
HTTPS obbligatorio

Requisiti client (utente finale)

Browser moderno (Chrome, Firefox, Safari, Edge)
JavaScript abilitato
Connessione internet stabile
Risoluzione minima: 1024x768
Responsive: funziona su tablet e smartphone