WIP EUPL-1.2Healthcare

FSE Viewer

Viewer e simulator open-source per Fascicolo Sanitario Elettronico 2.0 italiano

Stato
WIP
Licenza
EUPL-1.2
Categoria
Healthcare
Aggiornato
Source GitHub

Stato del progetto

Descrizione

FSE Viewer è un tool open-source per sviluppatori, system integrator e PA locali che lavorano con il Fascicolo Sanitario Elettronico 2.0 italiano. Risolve un problema concreto: testare integrazioni con il Gateway Nazionale FSE è complicato perché serve un ambiente di staging, credenziali SPID/CIE valide, e documenti FSE conformi (CDA2 R2, HL7 FHIR R4, profili nazionali AgID). FSE Viewer offre un simulator local-first che permette di (1) caricare documenti FSE (referti, lettere di dimissione, prescrizioni elettroniche, vaccinazioni, taccuino paziente) in CDA2 R2 o FHIR R4, (2) validarli contro gli schema XSD ufficiali AgID e gli Implementation Guide nazionali, (3) visualizzarli in una UI Angular 21 leggibile per medico/operatore (non solo XML/JSON raw), (4) esportarli in PDF strutturato (HL7 IHE-IT), (5) generare documenti FSE finti per test, partendo da template predefiniti (referto laboratorio, referto radiologico, lettera dimissione, ePrescription, vaccinazione COVID-19). Il modello dati segue le specifiche AgID 2.0 (post-31/3/2026) con mapping nominato per ogni sezione CDA (anamnesi, esame obiettivo, diagnosi, terapia, follow-up). La validazione usa HAPI FHIR Validator per FHIR R4 e Saxon XSLT per CDA2. Il frontend Angular 21 SSR offre rendering server-side per accessibilità (screen reader friendly su XML/JSON raw è impossibile, su HTML strutturato sì). License EUPL-1.2 per allineamento EU public sector e compatibilità con riuso PA. La filosofia è 'dev tool first': non sostituisce un EHR né un sistema PA, ma riduce il time-to-integration per chi sviluppa connettori FSE da settimane a giorni.

Funzionalità chiave

  • Validatore CDA2 R2 + FHIR R4

    HAPI FHIR Validator per R4, Saxon XSLT per CDA2, check Implementation Guide AgID nazionali (referto laboratorio, lettera dimissione, ePrescription).

  • Visualizzazione human-readable

    UI Angular per medico: sezioni anamnesi/esame/diagnosi/terapia/follow-up navigabili, tabelle leggibili, no XML/JSON raw a video.

  • Generatore documenti test

    Template predefiniti per 5+ tipi documento FSE (referto laboratorio, radiologico, lettera dimissione, ePrescription, vaccinazione), seed data realistici.

  • Export PDF IHE-IT

    Conversion CDA2 → PDF strutturato secondo profili IHE-IT, mantenimento layout e header AgID, no PDF generico.

  • Mapping FHIR R4 ↔ CDA2

    Bidirezionale FHIR Bundle ↔ CDA2 R2 per scenari ibridi (sistemi nazionali su CDA2, ecosistema EU su FHIR R4), documentazione mappings.

  • Frontend Angular 21 SSR

    Standalone components, signals, OnPush, prerender per pagine pubbliche (about, docs), WCAG 2.1 AA verificato.

  • Conformità AgID 2.0

    Schema XSD AgID 2026 caricati, check obbligatorietà sezioni, alert su elementi opzionali non popolati, report di conformità.

Tech stack

  • Angular 21
  • TypeScript 5.9
  • FHIR R4
  • HL7 CDA2 R2
  • HAPI FHIR Validator
  • Saxon XSLT
  • Italian FSE 2.0 specs

Casi d'uso

  • Sviluppatori system integrator che lavorano su connettori FSE 2.0 per regioni o aziende sanitarie
  • Sviluppatori EHR (es. MedBook, OpenEMR fork IT) che devono testare export FSE conforme
  • Consulenti AgID che validano documenti FSE forniti da terzi prima dell'ingestion nazionale
  • Sviluppatori telemedicina che generano DiagnosticReport e devono esportarli in CDA2 per FSE

Roadmap

  1. v0.1.0 Pianificata

    Viewer base + Validator FHIR R4

    • UI Angular drag&drop file upload
    • HAPI FHIR Validator integration
    • Rendering FHIR Bundle human-readable
    • Report validazione PASS/FAIL con dettaglio errori
  2. v0.5.0 Pianificata

    CDA2 R2 + Mapping + Templates

    • Saxon XSLT per CDA2 R2 validation
    • Mapping FHIR ↔ CDA2 base (Patient, Encounter)
    • Generator template referto laboratorio + lettera dimissione
    • Export PDF IHE-IT base
  3. v1.0.0 Pianificata

    AgID 2.0 + ePrescription + Vaccinazioni

    • Schema XSD AgID 2.0 completo
    • Template ePrescription + vaccinazione COVID-19
    • Conformity report dettagliato
    • Documentazione MkDocs + esempi end-to-end

A chi è rivolto

  • Pro Dev junior-mid
  • Pro Dev senior

Quick Start

Avvia il progetto localmente in pochi comandi. 

# Quick start (work-in-progress, repo non ancora pubblicato)
# git clone https://github.com/<tba>/fse-viewer.git
# cd fse-viewer
# npm install
# npm start  # apre http://localhost:4200
# Carica un file CDA2 o FHIR R4 via UI drag&drop

Contribuisci al progetto

FSE Viewer è open source. Apri una issue, proponi una pull request o lascia una stella su GitHub: ogni contributo, anche piccolo, è benvenuto.

  • ⭐ Lascia una stella se ti è utile
  • 🐛 Segnala bug o proponi feature via issue
  • 🔧 Invia pull request con fix o miglioramenti
  • 📣 Condividi il progetto se lo trovi interessante
Star su GitHubApri una issuePull request
← ⭐ Vedi su GitHub