RFC: PoC di layer di orchestrazione PA su design-react-kit — feedback sulla direzione

[sephmartin]

Esiste già una discussione sul tema che ti interessa, o su un tema simile?

• Ho verificato e non esiste

---

Versione della libreria

5.x (usata come riferimento per i token e i componenti, non come dipendenza diretta nel PoC)

---

Cosa

Ho costruito un PoC chiamato Portale Italia — un layer di orchestrazione che aggrega i servizi PA più utilizzati dai cittadini (INPS, Agenzia Entrate, PagoPA, ANPR, Fascicolo Sanitario) in un unico punto di accesso con autenticazione SPID/CIE unificata.

L'idea è nata da un problema personale: ore perse a saltare tra portali diversi, ognuno con la sua interfaccia e il suo login. Ho iniziato a costruire un prototipo, e durante lo sviluppo ho scoperto design-react-kit e l'ecosistema italia su GitHub: ho integrato i token ufficiali e allineato la spec API all'api-oas-checker.

La scelta dei servizi è pragmatica, non definitiva: l'architettura è pensata per essere estesa.

• 🔗 Repo: https://github.com/sephmartin/portale-italia
• 🌐 Demo: https://portale-italia.online
• 📄 Brief: BRIEF.md nel repo

Stack e compliance:

• design-react-kit + design-tokens-italia come base UI
• OpenAPI 3.0, compatibile con italia/api-oas-checker
• Riferimento concettuale alle API PA Digitale 2026
• IT Wallet / EUDI Wallet come layer di autenticazione complementare

---

Perché

Questo PoC vuole verificare se un layer di orchestrazione costruito sopra l'infrastruttura esistente — e allineato agli standard ufficiali del Design System Italia — sia tecnicamente fattibile e abbia senso architetturalmente.

Portare questa discussione qui ha senso perché design-react-kit è il kit che ho usato come base, e questa community è la più qualificata per valutare la direzione.

---

Architettura proposta

flowchart LR
    A[Cittadino] --> B[Portale Italia]
    B --> C[SPID / CIE]
    C --> D[PDND]
    D --> E[INPS]
    D --> F[Agenzia Entrate]
    D --> G[PagoPA]
    D --> H[ANPR]

Loading

---

Contesto

Questo non è un progetto finito: è una direzione da valutare.

• C'è interesse in questa community a definire pattern standard per l'orchestrazione multi-servizio PA?
• Ci sono vincoli architetturali nell'uso attuale di design-react-kit che limiterebbero questo tipo di integrazione?
• C'è un modo per contribuire concretamente all'ecosistema partendo da questo lavoro?

Aperto a qualsiasi feedback, comprese le ragioni per cui questa direzione non ha senso.

---

Altro

• Modello di contribuzione del Design System Italia
• italia/api-oas-checker
• italia/api-padigitale2026-misura1.3.1-uni-afam