# pause-ia/fresque-des-risques-de-ia architecture

> Architecture diagram of the GitHub repository pause-ia/fresque-des-risques-de-ia, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-18). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/pause-ia/fresque-des-risques-de-ia
- Repository: https://github.com/pause-ia/fresque-des-risques-de-ia

## Overview

La Fresque des risques de l’IA est un site statique et un ensemble de services pour programmer des ateliers collaboratifs, gérer les inscriptions et animer une fresque en ligne. Le parcours principal va de la découverte du site à la réservation d’un atelier ou à la participation au tableau partagé ; l’équipe dispose aussi d’outils d’administration, de suivi et d’alertes. Les fonctions Netlify portent la persistance et les échanges externes, tandis que des modules serveur isolent les règles métier. Les relations du relais de curseurs et les capacités non échantillonnées sont représentées uniquement lorsque le README les documente.

Main entry points: [`netlify/functions/ateliers.js`](https://github.com/pause-ia/fresque-des-risques-de-ia/blob/main/netlify/functions/ateliers.js) (Programmation et inscriptions), [`netlify/functions/lib/mail.js`](https://github.com/pause-ia/fresque-des-risques-de-ia/blob/main/netlify/functions/lib/mail.js) (E-mails transactionnels), [`netlify/functions/admin.js`](https://github.com/pause-ia/fresque-des-risques-de-ia/blob/main/netlify/functions/admin.js) (Espace administration), [`netlify/functions/alertes-envoi.js`](https://github.com/pause-ia/fresque-des-risques-de-ia/blob/main/netlify/functions/alertes-envoi.js) (Envoi hebdomadaire)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_site["Site et participation"]
  node_static_site["Site vitrine"]
  node_facilitator_tools["Outils animateur·ice<br/>[animateurs.js]"]
  node_workshop_user(("Participant atelier"))
  node_feedback_forms["Retours et témoignages<br/>[formulaire.js]"]
end

subgraph group_workshops["Ateliers et alertes"]
  node_workshop_functions["Programmation et inscriptions<br/>[ateliers.js]"]
  node_workshop_rules["Règles ateliers<br/>[ateliers.js]"]
  node_agenda["Agenda<br/>[agenda.js]"]
  node_alerts_api["Abonnements alertes<br/>[alertes.js]"]
  node_alerts_rules["Règles alertes<br/>[alertes.js]"]
  node_alerts_sender["Envoi hebdomadaire<br/>[alertes-envoi.js]"]
  node_communes["Communes et distances<br/>[communes.js]"]
end

subgraph group_online["Fresque en ligne"]
  node_online_session["Tableau collaboratif<br/>[session.js]"]
  node_fresque_api["Service fresque<br/>[fresque.js]"]
  node_fresque_rules["Règles du tableau<br/>[regles.js]"]
  node_drafts_api["Brouillons fresque<br/>[brouillons.js]"]
  node_cursor_relay["Relais curseurs<br/>[server.js]"]
end

subgraph group_operations["Administration et suivi"]
  node_admin["Espace administration<br/>[admin.js]"]
  node_contact_registry[("Registre contacts<br/>[contacts.js]")]
  node_followup["Suivi participants<br/>[suivi.js]"]
  node_feedback_api["Traitement retours<br/>[retour.js]"]
end

subgraph group_services["Services partagés"]
  node_mail_service["E-mails transactionnels<br/>[mail.js]"]
  node_blob_store[("Netlify Blobs")]
end

node_visitor(("Visiteur"))
node_resend["Resend"]
node_jitsi["Visioconférence Jitsi"]
node_civicrm["CiviCRM"]

node_visitor -->|"visite"| node_static_site
node_static_site -->|"oriente vers"| node_workshop_user
node_workshop_user -->|"réserve et s’inscrit"| node_workshop_functions
node_workshop_functions -->|"applique règles"| node_workshop_rules
node_workshop_functions -->|"persiste ateliers"| node_blob_store
node_workshop_functions -->|"déclenche courriels"| node_mail_service
node_workshop_rules -->|"utilise communes"| node_communes
node_static_site -->|"propose alertes"| node_alerts_api
node_alerts_api -->|"valide abonnements"| node_alerts_rules
node_alerts_api -->|"stocke abonnements"| node_blob_store
node_alerts_api -->|"valide codes"| node_communes
node_alerts_sender -->|"sélectionne ateliers"| node_alerts_rules
node_alerts_sender -->|"filtre ateliers"| node_workshop_rules
node_alerts_sender -->|"lit abonnements"| node_blob_store
node_alerts_sender -->|"envoie annonces"| node_mail_service
node_workshop_user -->|"rejoint une fresque"| node_online_session
node_online_session -->|"synchronise tableau"| node_fresque_api
node_fresque_api -->|"applique règles"| node_fresque_rules
node_fresque_api -->|"persiste tableau"| node_blob_store
node_online_session -.->|"pousse curseurs"| node_cursor_relay
node_online_session -.->|"rejoint visioconférence"| node_jitsi
node_admin -->|"lit et modifie"| node_blob_store
node_admin -->|"gère contacts"| node_contact_registry
node_admin -->|"annule ateliers"| node_workshop_functions
node_admin -->|"déclenche relances"| node_mail_service
node_facilitator_tools -.->|"gère ateliers"| node_workshop_functions
node_feedback_forms -.->|"soumet retours"| node_feedback_api
node_feedback_api -.->|"rend retours consultables"| node_admin
node_followup -->|"lit données"| node_blob_store
node_followup -->|"envoie suivi"| node_mail_service
node_workshop_functions -.->|"enregistre contacts"| node_contact_registry
node_mail_service -->|"journalise envois"| node_blob_store
node_mail_service -->|"transmet courriels"| node_resend
node_static_site -.->|"propose newsletter"| node_civicrm

click node_static_site "https://github.com/pause-ia/fresque-des-risques-de-ia/tree/main/site"
click node_facilitator_tools "https://github.com/pause-ia/fresque-des-risques-de-ia/blob/main/site/animateurs/animateurs.js"
click node_feedback_forms "https://github.com/pause-ia/fresque-des-risques-de-ia/blob/main/site/retour/formulaire.js"
click node_workshop_functions "https://github.com/pause-ia/fresque-des-risques-de-ia/blob/main/netlify/functions/ateliers.js"
click node_workshop_rules "https://github.com/pause-ia/fresque-des-risques-de-ia/blob/main/serveur/src/ateliers.js"
click node_agenda "https://github.com/pause-ia/fresque-des-risques-de-ia/blob/main/serveur/src/agenda.js"
click node_alerts_api "https://github.com/pause-ia/fresque-des-risques-de-ia/blob/main/netlify/functions/alertes.js"
click node_alerts_rules "https://github.com/pause-ia/fresque-des-risques-de-ia/blob/main/serveur/src/alertes.js"
click node_alerts_sender "https://github.com/pause-ia/fresque-des-risques-de-ia/blob/main/netlify/functions/alertes-envoi.js"
click node_communes "https://github.com/pause-ia/fresque-des-risques-de-ia/blob/main/serveur/src/communes.js"
click node_online_session "https://github.com/pause-ia/fresque-des-risques-de-ia/blob/main/site/en-ligne/session/session.js"
click node_fresque_api "https://github.com/pause-ia/fresque-des-risques-de-ia/blob/main/netlify/functions/fresque.js"
click node_fresque_rules "https://github.com/pause-ia/fresque-des-risques-de-ia/blob/main/serveur/src/regles.js"
click node_drafts_api "https://github.com/pause-ia/fresque-des-risques-de-ia/blob/main/netlify/functions/brouillons.js"
click node_cursor_relay "https://github.com/pause-ia/fresque-des-risques-de-ia/blob/main/infra/curseurs/server.js"
click node_admin "https://github.com/pause-ia/fresque-des-risques-de-ia/blob/main/netlify/functions/admin.js"
click node_contact_registry "https://github.com/pause-ia/fresque-des-risques-de-ia/blob/main/netlify/functions/lib/contacts.js"
click node_followup "https://github.com/pause-ia/fresque-des-risques-de-ia/blob/main/netlify/functions/suivi.js"
click node_feedback_api "https://github.com/pause-ia/fresque-des-risques-de-ia/blob/main/netlify/functions/retour.js"
click node_mail_service "https://github.com/pause-ia/fresque-des-risques-de-ia/blob/main/netlify/functions/lib/mail.js"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_static_site,node_facilitator_tools,node_workshop_user,node_feedback_forms toneBlue
class node_workshop_functions,node_workshop_rules,node_agenda,node_alerts_api,node_alerts_rules,node_alerts_sender,node_communes toneAmber
class node_online_session,node_fresque_api,node_fresque_rules,node_drafts_api,node_cursor_relay toneMint
class node_admin,node_contact_registry,node_followup,node_feedback_api toneRose
class node_mail_service,node_blob_store,node_visitor,node_resend,node_jitsi,node_civicrm toneIndigo
```

## Components

### Site et participation

- [Site vitrine](https://github.com/pause-ia/fresque-des-risques-de-ia/tree/main/site): `site`
- [Outils animateur·ice](https://github.com/pause-ia/fresque-des-risques-de-ia/blob/main/site/animateurs/animateurs.js): `site/animateurs/animateurs.js`
- **Participant atelier**
- [Retours et témoignages](https://github.com/pause-ia/fresque-des-risques-de-ia/blob/main/site/retour/formulaire.js): `site/retour/formulaire.js`

### Ateliers et alertes

- [Programmation et inscriptions](https://github.com/pause-ia/fresque-des-risques-de-ia/blob/main/netlify/functions/ateliers.js): `netlify/functions/ateliers.js`
- [Règles ateliers](https://github.com/pause-ia/fresque-des-risques-de-ia/blob/main/serveur/src/ateliers.js): `serveur/src/ateliers.js`
- [Agenda](https://github.com/pause-ia/fresque-des-risques-de-ia/blob/main/serveur/src/agenda.js): `serveur/src/agenda.js`
- [Abonnements alertes](https://github.com/pause-ia/fresque-des-risques-de-ia/blob/main/netlify/functions/alertes.js): `netlify/functions/alertes.js`
- [Règles alertes](https://github.com/pause-ia/fresque-des-risques-de-ia/blob/main/serveur/src/alertes.js): `serveur/src/alertes.js`
- [Envoi hebdomadaire](https://github.com/pause-ia/fresque-des-risques-de-ia/blob/main/netlify/functions/alertes-envoi.js): `netlify/functions/alertes-envoi.js`
- [Communes et distances](https://github.com/pause-ia/fresque-des-risques-de-ia/blob/main/serveur/src/communes.js): `serveur/src/communes.js`

### Fresque en ligne

- [Tableau collaboratif](https://github.com/pause-ia/fresque-des-risques-de-ia/blob/main/site/en-ligne/session/session.js): `site/en-ligne/session/session.js`
- [Service fresque](https://github.com/pause-ia/fresque-des-risques-de-ia/blob/main/netlify/functions/fresque.js): `netlify/functions/fresque.js`
- [Règles du tableau](https://github.com/pause-ia/fresque-des-risques-de-ia/blob/main/serveur/src/regles.js): `serveur/src/regles.js`
- [Brouillons fresque](https://github.com/pause-ia/fresque-des-risques-de-ia/blob/main/netlify/functions/brouillons.js): `netlify/functions/brouillons.js`
- [Relais curseurs](https://github.com/pause-ia/fresque-des-risques-de-ia/blob/main/infra/curseurs/server.js): `infra/curseurs/server.js`

### Administration et suivi

- [Espace administration](https://github.com/pause-ia/fresque-des-risques-de-ia/blob/main/netlify/functions/admin.js): `netlify/functions/admin.js`
- [Registre contacts](https://github.com/pause-ia/fresque-des-risques-de-ia/blob/main/netlify/functions/lib/contacts.js): `netlify/functions/lib/contacts.js`
- [Suivi participants](https://github.com/pause-ia/fresque-des-risques-de-ia/blob/main/netlify/functions/suivi.js): `netlify/functions/suivi.js`
- [Traitement retours](https://github.com/pause-ia/fresque-des-risques-de-ia/blob/main/netlify/functions/retour.js): `netlify/functions/retour.js`

### Services partagés

- [E-mails transactionnels](https://github.com/pause-ia/fresque-des-risques-de-ia/blob/main/netlify/functions/lib/mail.js): `netlify/functions/lib/mail.js`
- **Netlify Blobs**

### Other components

- **Visiteur**
- **Resend**
- **Visioconférence Jitsi**
- **CiviCRM**

## Connections

- Visiteur → Site vitrine: visite (evidence: `README.md`)
- Site vitrine → Participant atelier: oriente vers (evidence: `README.md`)
- Participant atelier → Programmation et inscriptions: réserve et s’inscrit (evidence: `README.md`)
- Programmation et inscriptions → Règles ateliers: applique règles (evidence: `netlify/functions/ateliers.js`)
- Programmation et inscriptions → Netlify Blobs: persiste ateliers (evidence: `netlify/functions/ateliers.js`)
- Programmation et inscriptions → E-mails transactionnels: déclenche courriels (evidence: `netlify/functions/ateliers.js`)
- Règles ateliers → Communes et distances: utilise communes (evidence: `serveur/src/ateliers.js`)
- Site vitrine → Abonnements alertes: propose alertes (evidence: `README.md`)
- Abonnements alertes → Règles alertes: valide abonnements (evidence: `netlify/functions/alertes.js`)
- Abonnements alertes → Netlify Blobs: stocke abonnements (evidence: `netlify/functions/alertes.js`)
- Abonnements alertes → Communes et distances: valide codes (evidence: `netlify/functions/alertes.js`)
- Envoi hebdomadaire → Règles alertes: sélectionne ateliers (evidence: `netlify/functions/alertes-envoi.js`)
- Envoi hebdomadaire → Règles ateliers: filtre ateliers (evidence: `netlify/functions/alertes-envoi.js`)
- Envoi hebdomadaire → Netlify Blobs: lit abonnements (evidence: `netlify/functions/alertes-envoi.js`)
- Envoi hebdomadaire → E-mails transactionnels: envoie annonces (evidence: `netlify/functions/alertes-envoi.js`)
- Participant atelier → Tableau collaboratif: rejoint une fresque (evidence: `README.md`)
- Tableau collaboratif → Service fresque: synchronise tableau (evidence: `README.md`)
- Service fresque → Règles du tableau: applique règles (evidence: `netlify/functions/fresque.js`)
- Service fresque → Netlify Blobs: persiste tableau (evidence: `README.md`)
- Tableau collaboratif → Relais curseurs: pousse curseurs (evidence: `README.md`)
- Tableau collaboratif → Visioconférence Jitsi: rejoint visioconférence (evidence: `README.md`)
- Espace administration → Netlify Blobs: lit et modifie (evidence: `netlify/functions/admin.js`)
- Espace administration → Registre contacts: gère contacts (evidence: `netlify/functions/admin.js`)
- Espace administration → Programmation et inscriptions: annule ateliers (evidence: `netlify/functions/admin.js`)
- Espace administration → E-mails transactionnels: déclenche relances (evidence: `netlify/functions/admin.js`)
- Outils animateur·ice → Programmation et inscriptions: gère ateliers (evidence: `README.md`)
- Retours et témoignages → Traitement retours: soumet retours (evidence: `README.md`)
- Traitement retours → Espace administration: rend retours consultables (evidence: `README.md`)
- Suivi participants → Netlify Blobs: lit données (evidence: `netlify/functions/suivi.js`)
- Suivi participants → E-mails transactionnels: envoie suivi (evidence: `netlify/functions/suivi.js`)
- Programmation et inscriptions → Registre contacts: enregistre contacts (evidence: `netlify/functions/ateliers.js`)
- E-mails transactionnels → Netlify Blobs: journalise envois (evidence: `netlify/functions/lib/mail.js`)
- E-mails transactionnels → Resend: transmet courriels (evidence: `netlify/functions/lib/mail.js`)
- Site vitrine → CiviCRM: propose newsletter (evidence: `README.md`)
