WIP EUPL-1.2Healthcare Services

FSE Viewer

Viewer and simulator open-source for Electronic Health Record 2.0 Italian

Status
WIP
License
EUPL-1.2
Category
Healthcare Services
Updated
GitHub is not a UI string to be translated from Italian into English.

Project status

Description

FSE Viewer is an open-source tool for developers, system integrators, and local public administrations working with the Italian Electronic Health Record (FSE) 2.0. It solves a concrete problem: testing integrations with the National FSE Gateway is complicated because it requires a staging environment, valid SPID/CIE credentials, and compliant FSE documents (CDA2 R2, HL7 FHIR R4, national AgID profiles). FSE Viewer offers a local-first simulator that lets you (1) load FSE documents (reports, discharge letters, electronic prescriptions, vaccinations, patient diary) in CDA2 R2 or FHIR R4, (2) validate them against official AgID XSD schemas and national Implementation Guides, (3) view them in a readable Angular 21 UI for doctors/operators (not just raw XML/JSON), (4) export them to structured PDF (HL7 IHE-IT), (5) generate mock FSE documents for testing, starting from predefined templates (lab report, radiology report, discharge letter, ePrescription, COVID-19 vaccination). The data model follows AgID 2.0 specifications (post-31/3/2026) with named mapping for each CDA section (history, physical exam, diagnosis, therapy, follow-up). Validation uses HAPI FHIR Validator for FHIR R4 and Saxon XSLT for CDA2. The Angular 21 SSR frontend provides server-side rendering for accessibility (screen readers can't handle raw XML/JSON, but they can handle structured HTML). EUPL-1.2 license for EU public sector alignment and compatibility with PA reuse. The philosophy is 'dev tool first': it doesn't replace an EHR or a PA system, but reduces time-to-integration for those building FSE connectors from weeks to days.

Key Features

  • Validator CDA2 R2 + FHIR R4

    HAPI FHIR Validator for R4, Saxon XSLT for CDA2, Check National Agreement Implementation Guides (lab report, dismissal letter, and Prescription).

  • Human-readable view

    UI for doctors: sections of history/examination/diagnosis/treatment/follow-up navigable, readable tables, no raw XML/JSON to video.

  • Document Generator for Tests

    Template presets for 5+ document types FSE (lab report, radiology report, resignation letter, prescription, vaccination), realistic seed data.

  • Generate PDF for ITI Integration Profiles

    Conversion CDA2 to structured PDF according to IHE-IT profiles, maintaining layout and header AgID, no generic PDF.

  • Mapping FHIR R4 to CDA2

    Bilateral FHIR Bundle vs. CDA2 R2 for hybrid scenarios (national systems on CDA2, EU ecosystem on FHIR R4), documentation mappings.

  • Frontend Angular 21 Server-Side Rendering

    Standalone components, signals, OnPush, prerender for public pages (about, docs), WCAG 2.1 AA verified.

  • Conformity with AGID 2.0

    Schema XSD AgID 2026 loaded, check section obligations, alerts on optional elements not populated, compliance report.

Angular + Spring Boot on top of a PostgreSQL database hosted in the cloud via AWS or Google Cloud Platform

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

Use cases

  • System integrators and developers working on FSE 2.0 connectors for healthcare regions or organizations.
  • Developers of EHRs (e.g. MedBook, OpenEMR fork IT) who must test FSE exports accordingly
  • Consultants from AgID who validate third-party provided FSE documents before national ingestion
  • Telemedicine developers who generate Diagnostic Reports and must export them to CDA 2 for FSE.

Road Map

  1. v0.1.0Scheduled

    Viewer Base + FHIR R4 Validator

    • Drag and Drop File Upload
    • HAPI FHIR Validator Integration
    • Rendering FHIR Bundle in Human-Readable Format
    • Report validation PASS/FAIL with detailed errors.
  2. v0.5.0Scheduled

    Data to Relationship 2: Plus mapping and templates

    • Saxon XSLT for CDA 2.0 R2 Validation
    • Mapping FHIR to CDA2 Base (Patient, Encounter)
    • Lab report template and dismissal letter
    • Export PDF IHE-IT Base
  3. v1.0.0Scheduled

    Vaccination and Prescription Management System (Version 2.0)

    • Full XSD schema for AgID 2.0
    • Template and COVID-19 vaccination prescription
    • Detailed conformity report
    • Documentation for MkDocs and End-to-End Examples

Who is it for

  • Junior/ Mid-Level Developer
  • For Developers - Senior

Quick start

Start the project locally with four commands, requires Docker and GitHub Desktop is not required but a git client like SourceTree or Visual Studio Code's built-in one will do just fine though. 

# 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

Contribute to the project

FSE Viewer is open source. Open an issue, propose a pull request or leave a star on GitHub: every contribution, no matter how small, is welcome.

  • ⭐ Leave a star if it's useful
  • 🐛 Report bugs or suggest features via issue
  • 🔧 Send a pull request with fixes or improvements
  • 📣 Share the project if you find it interesting
Star on GitHubOpen an issuePull request
← Back to list⭐ View on GitHub