#26 feat: supporto provider SPID Poste Italiane (PosteID) oltre a Sielte

[Anonymous]

Originally created by: zornade

Contesto

Oggi utils.py:login() supporta solo il provider SPID Sielte ID. Diversi utenti professionali italiani usano PosteID come provider SPID principale; senza un dispatch interno, il servizio è inutilizzabile per loro a meno di crearsi un account Sielte secondario.

Proposta

Importare il refactor già implementato in pietromalerba/visura-api@aebaa53 (AGPL-3.0, compatibile upstream, autore @pietromalerba):

1. Refactor neutro: estrarre la logica Sielte attuale in _login_sielte(page, logger, username, password) senza cambi funzionali.
2. Nuova _login_poste(page, logger, username, password): clicca il provider PosteID nella pagina SPID, inserisce email + password, attende l'approvazione tramite app PosteID (notifica push, redirect a agenziaentrate.gov.it, timeout 120s).
3. Dispatch via env var SPID_PROVIDER: default "sielte" (retrocompatibile). Valori validi: "sielte", "poste". Credenziali separate:
4. ADE_USERNAME / ADE_PASSWORD per Sielte (invariato)
5. POSTE_USERNAME / POSTE_PASSWORD per PosteID

Compatibilità

Pienamente retrocompatibile: chi non setta SPID_PROVIDER continua a usare Sielte come ora.

Lavoro a monte

Patch già pronta nel fork sopra. Da rebasare sul main corrente (23 commit behind; conflitti probabili su utils.py per via dell'hardening license recente, da risolvere manualmente).

Test

• aggiungere test che verifichi che SPID_PROVIDER=sielte (e default) chiami il flusso Sielte
• aggiungere test che verifichi che SPID_PROVIDER=poste senza POSTE_USERNAME/PASSWORD sollevi ValueError
• aggiungere test che verifichi che SPID_PROVIDER=foo sollevi ValueError con messaggio "Valori validi: 'sielte', 'poste'"

Note di scope

• Non include il login diretto SISTER (credenziali professionista) presente nello stesso fork: è una feature separata che apre questioni di ToS e va valutata in una issue dedicata.

Riferimenti

• pietromalerba fork branch: feature/spid-poste HEAD aebaa53
• Roadmap parente: [#15]

[Anonymous]

Ticket changed by: zornade

• status: open --> closed