italia / italia/design-react-kit

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

Open
#1,241 0 comments 0 reactions 0 assignees View on GitHub
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

Open the contributing guide

Assessment

This issue has not been assessed yet.

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.