Skip to content
Draft
Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
23 commits
Select commit Hold shift + click to select a range
20212d1
docs: add PRD and feature/roadmap report
viganogabriele Aug 19, 2026
16877a9
modified document
viganogabriele Aug 19, 2026
24334c5
docs: add admin dashboard PRD and feature roadmap
viganogabriele Aug 19, 2026
d2f0cda
docs: apply Team IT corrections to admin dashboard PRD
viganogabriele Aug 29, 2026
143f3e8
docs: remove superseded PRD and roadmap report
viganogabriele Aug 29, 2026
093d507
docs: streamline PRD into a plain feature spec
viganogabriele Aug 29, 2026
cabd036
docs: add feature classification and identity provider design
viganogabriele Aug 30, 2026
f9525e5
docs: add dashboard roles and permissions design
viganogabriele Aug 30, 2026
f19093e
aggiornato sezioni
viganogabriele Sep 7, 2026
3e88259
docs: align roadmap documents with current identity and RBAC design
viganogabriele Sep 30, 2026
340f2f9
docs(prd): align roadmap with integrated IdP and dashboard state
viganogabriele Oct 12, 2026
d5f263a
docs(people): specify people, volunteer census and member register se…
viganogabriele Oct 14, 2026
3174edc
docs(prd): prioritize a readable administrative change log
viganogabriele Oct 14, 2026
13c796f
docs: add website launch checklist
viganogabriele Oct 17, 2026
1fe8a25
Merge branch 'main' into report/new-feature-roadmap
viganogabriele Oct 17, 2026
f635329
docs: update feature classification to 17 October and assign the webs…
viganogabriele Oct 17, 2026
6acc74a
docs: link the website checklist items to the quick fixes PR
viganogabriele Oct 17, 2026
66ca609
Update Checklist_Sito_Web.md
viganogabriele Oct 17, 2026
71053dd
fix: MVP
toto04 Oct 17, 2026
138b683
chore: sync roadmap branch with current main
viganogabriele Oct 30, 2026
b8f6f45
docs: refresh dashboard PRDs and roadmap for current platform
viganogabriele Oct 30, 2026
3da3162
Merge remote-tracking branch 'origin/main' into HEAD
viganogabriele Nov 16, 2026
c04c9b2
docs: refresh PRDs against November repository state
viganogabriele Nov 16, 2026
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
92 changes: 92 additions & 0 deletions Checklist_Sito_Web.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,92 @@
# Checklist lancio sito PoliNetwork

**Aggiornamento:** 16 novembre 2026.
Fonte codice: [web main 17f8c5b](https://github.com/PoliNetworkOrg/web/tree/17f8c5bb10dc9452d9dc6fee49af870c6408c7a3).
[PRD admin](PRD_Admin_Dashboard_PoliNetwork.md), [roadmap](PRD_Classificazione_Feature.md).

`[x]` codice integrato verificato; `[ ]` lavoro o verifica da completare. Non certifica il deploy né la qualità
dei dati di produzione. Responsabili personali sotto riportati ereditati dalla checklist, da riconfermare.
MVP.md contiene il MVP interno admin: questa è l'unica checklist per il lancio pubblico.

## Base già integrata

- [x] Correzioni rapide [web#192](https://github.com/PoliNetworkOrg/web/pull/192): link Appunti nel sito,
contatti progetto ripuliti, Team, immagine Unisciti compressa e link Collabora corretto.
- [x] Sfondo procedurale [web#183](https://github.com/PoliNetworkOrg/web/pull/183): non è più una PR da aggiornare.
- [x] Pagine Su di noi [#188](https://github.com/PoliNetworkOrg/web/pull/188), dettaglio progetto
[#189](https://github.com/PoliNetworkOrg/web/pull/189), Storia [#190](https://github.com/PoliNetworkOrg/web/pull/190)
e Struttura [#186](https://github.com/PoliNetworkOrg/web/pull/186).
L'alternativa [#191](https://github.com/PoliNetworkOrg/web/pull/191) è chiusa senza merge: non scegliere più tra due PR aperte.
- [x] Matricole legge risorse, hub Telegram e FAQ da `web.freshman`; admin #124 permette modifica e riordino
degli slot previsti e scelta FAQ, oltre alla gestione PDF Guida.
- [x] Web #198 rende obbligatorio il token IdP di servizio per tutte le chiamate backend.

## Raffinamento visuale: integrato e residuo

- [x] Lo stack #199–#216 è confluito nel branch Home e poi in main tramite
[#199](https://github.com/PoliNetworkOrg/web/pull/199) (130 file): Home, Storia, Su di noi, Struttura,
Team, Unisciti, Collabora, Contatti, Progetti, Gruppi, Matricole, Associazioni, FAQ, Guide, header/footer e 404.
#218/#219 sono state integrate sullo stesso branch prima di #199; #217 è chiusa senza merge.
Non assegnare una nuova sequenza di merge #200–#216 sulla base della vecchia checklist.
- [x] [#221](https://github.com/PoliNetworkOrg/web/pull/221): posizione della navbar mobile.
- [ ] [#222](https://github.com/PoliNetworkOrg/web/pull/222): ulteriori correzioni Su di noi/Storia/Unisciti e caroselli mobile.
- [ ] [#223](https://github.com/PoliNetworkOrg/web/pull/223): audit sito, hydration/404, SEO, risorse mobile,
accessibilità, copy e immagini. È aperta: risultati e screenshot della PR non sono baseline main.
- [ ] [#179](https://github.com/PoliNetworkOrg/web/pull/179): confrontare la spaziatura proposta con lo stack già integrato.
- [ ] Verificare desktop/mobile, tastiera e movimento ridotto sul risultato finale.
- [ ] #163 (easter egg), #145 (gioco CFU) e #197 (dipendenza Zod) sono aperte, non traguardi del lancio.

#223 segnala inoltre attività esterne al codice: Email Obfuscation Cloudflare con hydration su alcune pagine,
contenuti backend mancanti/di prova e decisioni sul copy inglese. Verificare nell'ambiente target e assegnare ai
responsabili; questa revisione non modifica Cloudflare o dati di produzione.

## Contenuti e gestione admin

- [ ] **Gruppi:** verificare nomi, piattaforma e anno (es. Informatica WhatsApp 26/27), il generale Telegram assente
dalla ricerca e i link reali. Prima distinguere errore di dati/etichette da errore della ricerca.
- [ ] **Matricole:** aggiornare card senza destinazione e link vecchi. Provare modifica admin → ricaricamento web
senza fallback statico, errori backend e FAQ selezionate. Struttura e titoli restano fissi.
- [ ] **FAQ:** popolare catalogo da gruppi/vecchio sito e definire import da file; riferimento precedente @L3ox64.
Non confondere CRUD admin esistente con import ancora mancante.
- [ ] **Guide:** decidere quali contenuti conservare e migrare. La gestione PDF Matricole non è un CMS generico
delle guide; #212 sistema il sito ma non completa produzione/migrazione dei testi.
- [ ] **Progetti:** rivedere elenco, archiviare contenuti vecchi e aggiungere nuovi progetti tramite le funzioni esistenti.
Verificare riferimenti pubblici a `info@polinetwork.org` invece di contatti personali.
- [ ] **Link progetto per piattaforma:** [backend#72](https://github.com/PoliNetworkOrg/backend/pull/72) ancora aperta;
poi pubblicare i tipi, implementare editor admin e visualizzazione web. La pagina dettaglio già integrata non basta.
- [ ] **Associazioni:** verificare campi richiesti dal vecchio sito (Twitch, più canali Telegram). Richieste di aggiunta,
modifica e approvazione da esterni sono un nuovo workflow, non il CRUD interno attuale.
- [ ] **Storia/Su di noi/Team:** dati direttivi passati, ringraziamenti, numeri coerenti e testi approvati.
#202 condivide l'organigramma nel codice; non dedurre aggiornamento dei dati da quel refactor.
- [ ] **Home:** numeri derivati da dati attivi o contenuti editoriali verificati, senza contatori dimostrativi.
- [ ] **Appunti:** verificare tutti i link alla destinazione attuale; valutare link GitLab. Upload/archivio sul nuovo sito
e dashboard personale sono backlog separati, da definire prima di sviluppo.

## Documenti e processi esterni

- [x] Backend#132: catalogo Documenti con categorie e storico versioni.
- [ ] Integrare [admin#162](https://github.com/PoliNetworkOrg/admin/pull/162) e
[web#220](https://github.com/PoliNetworkOrg/web/pull/220): gestione CMS, catalogo pubblico e viewer PDF.
- [ ] Popolare statuto, regolamenti, privacy/cookie, bilanci e collegare il footer alle versioni approvate.
Non confondere questo catalogo con l’editor collaborativo RRI già presente in admin. Donazioni/5x1000 da valutare.
- [ ] Definire referenti, ownership e moderazione di richieste associazioni/progetti; non assegnare ownership
trasferendo account personali. È backlog esterno del PRD, non gate del MVP People.
- [ ] Valutare il Figma della dashboard utente (riferimento precedente Enrico) e il bisogno di login personale.
Il token di servizio del sito non offre già quel login.

## Verifiche prima del lancio

- [ ] Inventario URL vecchi e redirect `/it/…`, `/en/…`, graduatorie, eventi; verificare destinazione e codici HTTP.
- [ ] Piano passaggio beta → dominio principale, DNS, certificati e rollback del sito.
- [ ] Google Search Console, sitemap, robots, canonical e anteprime social sui nuovi URL.
- [ ] Italiano coerente; decidere scope e responsabilità dell'eventuale versione inglese.
- [ ] Backend non disponibile: messaggi e retry comprensibili sulle pagine, senza cataloghi finti.
- [ ] Configurare client web, chiave e risorsa `backend:public:read`; senza token il backend rifiuta la richiesta.
- [ ] Allineare tipi e versione distribuita del backend. La vecchia nota README sul pacchetto 1.4.0 non è
prova di un blocco attuale: admin risolve 4.0.0; verificare separatamente il lockfile web.
- [ ] Controllare con i responsabili i contenuti di produzione e gli eventuali dati di prova.
Non eliminare righe in massa durante il controllo.
- [ ] Smoke test pubblico: ricerca gruppi, Appunti, FAQ, Matricole/PDF, progetto e link, contatti e Documenti;
ripetere su telefono e verificare i failure del backend.

Nessuna casella operativa viene spuntata da questa revisione senza evidenza dell'ambiente di destinazione.
88 changes: 88 additions & 0 deletions IdentityProvider_DataModel.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,88 @@
# Modello dati e contratti — Auth, backend e admin

**Versione:** 4.0 · **Aggiornamento:** 16 novembre 2026.
[Design IdP](IdentityProvider_Design.md), [People](Persone_Volontari_Soci.md),
[RBAC](RBAC_Ruoli_Permessi.md), [fonti/SHA](PRD_Admin_Dashboard_PoliNetwork.md#20-fonti-della-revisione).

Questo documento distingue lo schema presente dai contratti in lavorazione. Non è una migrazione SQL né
un'autorizzazione a modificare dati. Non creare tabelle usando i nomi delle vecchie proposte.

## 1. Auth main

Fonte: `src/db/auth-schema.ts`, `src/db/evidence.ts`, `src/db/rbac.ts` nel repository Auth.

| Blocco | Responsabilità |
| ---------------------------------------- | --------------------------------------------------------------------------------------- |
| Utente / account / sessione / passkey | Identità login e provider verificati, con vincoli di ownership |
| `identity_evidence` | Evidenze per issuer/subject, ID esterni verificati, Telegram e stati |
| `student_verification_challenge` | Verifica mail Polimi con hash, scadenza, tentativi e cooldown |
| `permission`, `permission_implication` | Chiavi stabili e implicazioni transitive senza cicli |
| `role`, `role_parent`, `role_permission` | Ruoli, ereditarietà e permessi |
| `user_role` | Assegnazioni manuali con attore/data; ruoli gestiti derivati da evidenze/configurazione |
| `rbac_audit_event` | Audit append-only con attore, operazione, target, prima/dopo e data |
| OAuth / snapshot / outbox | Client e risorse, proiezioni accesso e aggiornamenti verso consumer |

Username/email di contatto non sono chiavi di autorizzazione. Il modello globale non contiene un sistema
`capability_grant` con livelli e scope corso/team: quella proposta non è stata adottata.
Schema Auth main contiene `role.peopleBinding` e il supporto comandi People di #73; nessun utente preliminare.
Auth#86 espone `entraObjectId` nello snapshot e #87 il claim array `polinetwork_permission_list`.
Gli override di permessi ereditati sono in Auth#68, ancora aperta: non sono una proprietà verificata di main.

## 2. Backend e BFF main

- Il backend richiede token IdP: attore dal token, scope e tipo attore verificati, permessi correnti da snapshot.
`me.access` è la fonte della dashboard. Nessun percorso anonimo o login legacy nella baseline #97.
- I grant correnti sono in `tg_grants` con soggetto IdP del grantor. Non descrivere più una convivenza
operativa `tg_grants_v2`/legacy o chiedere nuovi `admin_id` Telegram per l'audit.
- Contenuti conservano autori `*_by_sub`; i riferimenti storici Telegram non equivalgono all'audit prima/dopo.
- People main espone `persons`, `admins`, `capos`, `teams`, `linking`, `capo`, `me`; schema relazionale,
incarichi e comandi Auth sono in `src/db/schema/people/index.ts`. Nessun router quote/censimento sotto People.
- Soci separato espone `members`, `fees`, `me`: registro, prove bonifico, revisione e self-service.
- Regolamenti ha schema/contratto propri e collaborazione Yjs; Documenti pubblici è un catalogo CMS distinto.
- Admin usa Redis dedicato per token/sessioni e cookie opaco nel browser. Il contesto route non contiene token.
- Microsoft 365: Entra object ID per l'utente, `employeeId` per numero socio, gruppo Soci per appartenenza.
Microsoft 365 è in sola lettura; il nuovo socio è ammesso tramite il workflow `soci.members.admit`.

La dipendenza admin/lockfile è `@polinetwork/backend` 4.0.0, con `web.freshman` presente. Versione del pacchetto,
versione dell'app backend e contratto realmente distribuito sono evidenze diverse: controllarle separatamente.

## 3. Cleanup e contratti integrati

Admin#147 e backend#104 hanno rimosso il vecchio dominio unificato. Backend#105/#106/#109 e admin#148/#149
realizzano record, incarichi, inviti, link e unlink. Non ripristinare tabelle, matching e ponte ricevute/eSign rimossi.
Solo Censimento resta mockup: Soci usa il contratto reale separato.

Auth#73 applica binding `admin`, `capo`, `team:<key>:member`, `team:<key>:lead`, con `idp:people:bind` e scope
interno `idp:people:roles`. I comandi sono idempotenti, attribuiti all'attore e controllati per delega/autoassegnazione.
Incarichi `pending`/`sent`/`applied`/`refused`; account collegato univoco, contatti non usati per matching.
Inviti monouso con hash, scadenza e revoca; landing `/people/invite` senza gate dashboard.
Unlink revoca i ruoli prima di scollegare. Schema e wire effettivi: [contratto People](docs/people/contract.md).
L'import CSV generale non è nel router corrente; seed admin#153 è un altro flusso, ancora in PR.

## 4. Soci e Regolamenti: contratti presenti e limiti

Soci usa `soci_members`, `soci_fees`, `soci_files`, `soci_activity`, `soci_mail`, collegati all'object ID Entra.
Numeri non riutilizzabili, quota di 500 centesimi e annualità settembre–agosto; file PDF/PNG/JPEG fino a 10 MB.
Review riferita al file caricato; outbox email idempotente. `me.completeDetails` compila soltanto campi vuoti.
Il router corrente non espone ancora `members.end`/`restore`, `accounts.delete` o `lapse.preview`, benché presenti
nel [design](docs/people/soci.md). Non generare client per quei requisiti come se fossero API già distribuite.

Regolamenti usa `regulations.*`, accessi per bozza e deleghe backend, ticket monouso per il servizio collaborativo,
worker LaTeX isolato, GitHub App per emanare e outbox notifiche. Vedere [contratto](src/features/regulations/regulations.contract.ts).
Documenti pubblici: backend#132 integrata, consumer admin#162/web#220 in PR; non coincide con l'editor RRI.

## 5. Proposte ritirate e modelli da progettare

- Ritirati: `capability_grant`, utenti preliminari, matching/merge di record, `membership_claim` e claim del socio
mediante codice, join gruppi Telegram come fonte degli incarichi, registro socio People indipendente da Entra.
- Soci fase 2 #144: completare fine appartenenza/decadenza/cancellazione sul design del 9 novembre; quote già integrate.
- Censimento fase 3 #145: collegato alla fase 1; uscita tramite stesso comando di revoca ruolo Auth.
- Informative, prove di consenso, retention ed export: definire policy prima del nuovo schema.
- Audit unico: backend#90 propone `common_audit_events`/`audit.list`; auth#76 e admin#123 completano il filone.
Non dedurre che l'audit RBAC sia già federato dal solo fatto che entrambe le tabelle esistano.

## 6. Criteri di compatibilità

Documentare ordine deploy e differenze wire in ogni PR; nessun silenziamento dei tipi per superare un disallineamento.
Testare righe fuori ambito, token mancanti, delega, revoche, attori, retry, outage e vecchio/nuovo payload nella
transizione. Agent mode usa il fake People; non dimostra schema PostgreSQL, OAuth o consegna dei comandi Auth.
Loading
Loading