italia / italia/design-react-kit
RFC: PoC di layer di orchestrazione PA su design-react-kit — feedback sulla direzione
- Dominant language
- TypeScript
- Stars
- 179
- Forks
- 89
- PR merge metrics
- No merged PRs in 30d
Description
### Esiste già una discussione sul tema che ti interessa, o su un tema simile?
- [x] 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](https://github.com/sephmartin/portale-italia/blob/main/BRIEF.md)
**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
```mermaid
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]
```
---
### 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](https://designers.italia.it/design-system/come-contribuire/modello-di-contribuzione/)
- [italia/api-oas-checker](https://github.com/italia/api-oas-checker)
- [italia/api-padigitale2026-misura1.3.1-uni-afam](https://github.com/italia/api-padigitale2026-misura1.3.1-uni-afam)
Contributor guide
Assessment
This issue has not been assessed yet.