Piattaforma di web services per l'Azienda Sanitaria Provinciale di Messina. Il sistema fornisce API REST per la gestione dell'anagrafica assistiti, Master Patient Index, dati clinici HL7, assistenza domiciliare SIAD, form dinamici, app containerizzate e funzionalita amministrative.

• Node.js: ^22.13
• MySQL: 3 istanze separate (anagrafica, auth, log)
• Meilisearch: Motore di ricerca full-text
• Docker: Per gestione app containerizzate (opzionale)

• Sails.js 1.5.14: Framework MVC
• JWT + Argon2 + OTP: Autenticazione e sicurezza
• aziendasanitaria-utils: Libreria utilities interna
• Swagger/OpenAPI: Documentazione API
• Docsify: Knowledge Base
• @turf/turf: Operazioni geospaziali
• Dockerode: Gestione container Docker
• Alpine.js + Tailwind CSS: Frontend form dinamici

git clone <repository-url>
cd asp-ws
npm install

# Configura i file privati
cp config/custom/private_example.json config/custom/private.json
# Modifica config/custom/private_jwt.json, private_ui_users.json, ecc.

# Avvia in sviluppo
sails lift

Registro centrale pazienti (~500k record) con ricerca avanzata, integrazione SistemaTS (MEF) per codici STP/ENI, geolocalizzazione automatica indirizzi.

Sistema per collegare record da applicazioni esterne (PS, CUP, sistemi dipartimentali) ai pazienti del registro centrale. Supporta:

• Registrazione applicazioni esterne
• Creazione record con dati parziali
• Collegamento (link) a un assistito tramite codice fiscale
• Ricerca cross-applicazione
• Rilevamento collisioni (duplicati potenziali)
• Audit trail completo

Sistema flessibile di dati aggiuntivi strutturati per categoria:

• Schema di validazione JSON per campo
• Versionamento e audit trail di ogni modifica
• Controllo accessi granulare per categoria (scope read/write)
• Supporto wildcard scope (anagrafica-hl7_*-read)
• Disponibile sia per assistiti che per record MPI

Categorie extra data ispirate allo standard HL7 v2.5:

Categorie extra data ispirate al flusso SIAD v7.4 del Ministero della Salute:

Form serverless definiti tramite file JSON in /api/data/forms/:

• Multi-pagina con progress bar
• Validazioni (required, email, telefono, regex)
• Tipi campo: text, textarea, radio, checkbox, select
• reCAPTCHA v3 integrato
• 2 temi UI (Modern, Healthcare)
• Submission salvate nel database

Deploy e gestione applicazioni containerizzate:

• Clone da GitHub o upload ZIP
• Start/stop/restart container
• Reverse proxy su /apps/<app-id>/
• Log container in tempo reale
• Aggiornamento da GitHub (git pull)

• JWT con livelli (guest, user, admin, superAdmin)
• Scope granulari con supporto wildcard (*)
• Domini (api, asp.messina.it, globale)
• OTP via email o TOTP (Google Authenticator)
• Active Directory/LDAP per dominio asp.messina.it
• Password hashing con Argon2

Le migrazioni SQL in migrations/ vengono eseguite automaticamente al sails lift. Ogni file deve avere l'header -- database: anagrafica|auth|log. Convenzione nomi: YYYYMMDD_NNN_descrizione.sql.

asp-ws/
├── api/
│   ├── controllers/
│   │   ├── anagrafica/        # Ricerca e extra data assistiti
│   │   ├── anagrafica/extra-data/  # CRUD extra data
│   │   ├── mpi/               # Master Patient Index
│   │   ├── mpi/extra-data/    # Extra data su record MPI
│   │   ├── login/             # Autenticazione
│   │   ├── admin/             # Gestione utenti, categorie
│   │   ├── admin/mpi/         # Admin MPI
│   │   ├── admin/apps/        # Admin Docker apps
│   │   ├── forms/             # Form dinamici
│   │   ├── cambio-medico/     # Cambio medico
│   │   └── stats/             # Statistiche
│   ├── models/                # Modelli (Waterline ORM)
│   ├── helpers/               # Helper riutilizzabili
│   ├── services/              # Business logic
│   ├── policies/              # Policy auth
│   ├── responses/             # Response handler (ApiResponse)
│   ├── hooks/                 # Hook (apps-proxy)
│   └── data/forms/            # Definizioni form JSON
├── config/
│   ├── routes.js              # Definizione rotte + auth
│   ├── policies.js            # Mapping policy
│   ├── datastores.js          # Connessioni database
│   ├── bootstrap.js           # Init + migrazioni
│   └── custom/                # File privati (git-ignored)
├── migrations/                # Migrazioni SQL
├── docs/                      # Knowledge Base (Docsify)
├── views/                     # Template EJS
├── assets/                    # Asset statici
└── .apps/                     # App Docker (git-ignored)

sails lift              # Sviluppo
npm start               # Produzione
npm run lint            # Linter
npm test                # Test
sails console           # REPL con accesso ai modelli

export NODE_ENV=production
node app.js
# oppure
pm2 start app.js --name asp-ws

Dettagli nella Knowledge Base.

ASP5 Messina - SIA Area Progettazione e Sviluppo - Ing. Roberto De Domenico