# bwillou1/williamguindon architecture

> Architecture diagram of the GitHub repository bwillou1/williamguindon, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-01). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/bwillou1/williamguindon
- Repository: https://github.com/bwillou1/williamguindon

## Overview

Le dépôt combine le site officiel et registre public de William Guindon avec une expérience visuelle cosmique autonome. Le parcours principal conduit les visiteurs vers les informations publiques, le suivi CCE et les pièces documentaires; des surfaces distinctes exposent les ressources IA et l’API. Le README établit ces capacités, mais les extraits ne montrent pas le câblage de la plupart des pages. Les relations entre modules cosmiques, elles, sont visibles dans les imports et appels échantillonnés.

Main entry points: [`index.html`](https://github.com/bwillou1/williamguindon/blob/main/index.html) (Site officiel), [`cosmic-space-background/src/App.tsx`](https://github.com/bwillou1/williamguindon/blob/main/cosmic-space-background/src/App.tsx) (Application cosmique), [`ai.html`](https://github.com/bwillou1/williamguindon/blob/main/ai.html) (Espace IA), [`cosmic-space-background/src/components/CosmicCanvas.tsx`](https://github.com/bwillou1/williamguindon/blob/main/cosmic-space-background/src/components/CosmicCanvas.tsx) (Rendu WebGL)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_public["Site public"]
  node_official_site["Site officiel<br/>[index.html]"]
  node_live["Suivi en direct<br/>[live.html]"]
  node_secure_contact["Contact sécurisé<br/>[messagerie.html]"]
  node_news["Actualités<br/>[communiques.html]"]
end

subgraph group_dossier["Dossier public"]
  node_cec_register["Registre CCE<br/>[registre.html]"]
  node_cec_status["Dossier CCE<br/>[cce.html]"]
  node_legal_docs["Pièces juridiques"]
  node_pdf_viewer["Lecteur PDF<br/>[viewer.html]"]
end

subgraph group_ai_api["Services numériques"]
  node_ai_space["Espace IA<br/>[ai.html]"]
  node_llm_resources["Ressources LLM<br/>[llms.txt]"]
  node_chat_worker["Assistant documentaire<br/>[groq-chat.js]"]
  node_public_api["API du corpus<br/>[corpus.json]"]
  node_api_documents["Documents API<br/>[documents.json]"]
end

subgraph group_cosmic["Expérience cosmique"]
  node_cosmic_app["Application cosmique<br/>[App.tsx]"]
  node_cosmic_canvas["Rendu WebGL<br/>[CosmicCanvas.tsx]"]
  node_controls["Commandes visuelles<br/>[ControlsDock.tsx]"]
  node_shader["Shader nébuleuse<br/>[nebulaShader.ts]"]
  node_audio["Audio ambiant<br/>[ambientAudio.ts]"]
  node_themes["Thèmes<br/>[themes.ts]"]
end

node_visitors(("Visiteurs"))
node_groq["API Groq"]

node_visitors -->|"consultent"| node_official_site
node_official_site -->|"propose le suivi"| node_live
node_official_site -->|"oriente vers"| node_cec_register
node_visitors -->|"consultent"| node_cec_register
node_cec_register -->|"publie des pièces"| node_legal_docs
node_visitors -->|"consultent"| node_legal_docs
node_legal_docs -->|"s’affiche dans"| node_pdf_viewer
node_official_site -.->|"présente l’actualité"| node_news
node_visitors -->|"contactent"| node_secure_contact
node_official_site -->|"propose l’espace IA"| node_ai_space
node_ai_space -->|"oriente vers"| node_llm_resources
node_ai_space -.->|"interroge"| node_chat_worker
node_chat_worker -->|"appelle"| node_groq
node_visitors -.->|"consultent"| node_public_api
node_public_api -.->|"expose aussi"| node_api_documents
node_cosmic_app -->|"rend"| node_cosmic_canvas
node_cosmic_app -->|"affiche"| node_controls
node_cosmic_app -->|"charge"| node_themes
node_cosmic_app -->|"commande"| node_audio
node_cosmic_canvas -->|"compile"| node_shader
node_cosmic_canvas -->|"déclenche le son"| node_audio

click node_official_site "https://github.com/bwillou1/williamguindon/blob/main/index.html"
click node_live "https://github.com/bwillou1/williamguindon/blob/main/live.html"
click node_secure_contact "https://github.com/bwillou1/williamguindon/blob/main/messagerie.html"
click node_ai_space "https://github.com/bwillou1/williamguindon/blob/main/ai.html"
click node_llm_resources "https://github.com/bwillou1/williamguindon/blob/main/llms.txt"
click node_chat_worker "https://github.com/bwillou1/williamguindon/blob/main/workers/groq-chat.js"
click node_public_api "https://github.com/bwillou1/williamguindon/blob/main/api/v1/corpus.json"
click node_api_documents "https://github.com/bwillou1/williamguindon/blob/main/api/v1/documents.json"
click node_cec_register "https://github.com/bwillou1/williamguindon/blob/main/registre.html"
click node_cec_status "https://github.com/bwillou1/williamguindon/blob/main/cce.html"
click node_legal_docs "https://github.com/bwillou1/williamguindon/tree/main/assets/docs"
click node_pdf_viewer "https://github.com/bwillou1/williamguindon/blob/main/viewer.html"
click node_news "https://github.com/bwillou1/williamguindon/blob/main/communiques.html"
click node_cosmic_app "https://github.com/bwillou1/williamguindon/blob/main/cosmic-space-background/src/App.tsx"
click node_cosmic_canvas "https://github.com/bwillou1/williamguindon/blob/main/cosmic-space-background/src/components/CosmicCanvas.tsx"
click node_controls "https://github.com/bwillou1/williamguindon/blob/main/cosmic-space-background/src/components/ControlsDock.tsx"
click node_shader "https://github.com/bwillou1/williamguindon/blob/main/cosmic-space-background/src/shaders/nebulaShader.ts"
click node_audio "https://github.com/bwillou1/williamguindon/blob/main/cosmic-space-background/src/utils/ambientAudio.ts"
click node_themes "https://github.com/bwillou1/williamguindon/blob/main/cosmic-space-background/src/utils/themes.ts"

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_official_site,node_live,node_secure_contact,node_news toneBlue
class node_cec_register,node_cec_status,node_legal_docs,node_pdf_viewer toneAmber
class node_ai_space,node_llm_resources,node_chat_worker,node_public_api,node_api_documents,node_groq toneMint
class node_cosmic_app,node_cosmic_canvas,node_controls,node_shader,node_audio,node_themes toneRose
class node_visitors toneIndigo
```

## Components

### Site public

- [Site officiel](https://github.com/bwillou1/williamguindon/blob/main/index.html): `index.html`
- [Suivi en direct](https://github.com/bwillou1/williamguindon/blob/main/live.html): `live.html`
- [Contact sécurisé](https://github.com/bwillou1/williamguindon/blob/main/messagerie.html): `messagerie.html`
- [Actualités](https://github.com/bwillou1/williamguindon/blob/main/communiques.html): `communiques.html`

### Dossier public

- [Registre CCE](https://github.com/bwillou1/williamguindon/blob/main/registre.html): `registre.html`
- [Dossier CCE](https://github.com/bwillou1/williamguindon/blob/main/cce.html): `cce.html`
- [Pièces juridiques](https://github.com/bwillou1/williamguindon/tree/main/assets/docs): `assets/docs`
- [Lecteur PDF](https://github.com/bwillou1/williamguindon/blob/main/viewer.html): `viewer.html`

### Services numériques

- [Espace IA](https://github.com/bwillou1/williamguindon/blob/main/ai.html): `ai.html`
- [Ressources LLM](https://github.com/bwillou1/williamguindon/blob/main/llms.txt): `llms.txt`
- [Assistant documentaire](https://github.com/bwillou1/williamguindon/blob/main/workers/groq-chat.js): `workers/groq-chat.js`
- [API du corpus](https://github.com/bwillou1/williamguindon/blob/main/api/v1/corpus.json): `api/v1/corpus.json`
- [Documents API](https://github.com/bwillou1/williamguindon/blob/main/api/v1/documents.json): `api/v1/documents.json`

### Expérience cosmique

- [Application cosmique](https://github.com/bwillou1/williamguindon/blob/main/cosmic-space-background/src/App.tsx): `cosmic-space-background/src/App.tsx`
- [Rendu WebGL](https://github.com/bwillou1/williamguindon/blob/main/cosmic-space-background/src/components/CosmicCanvas.tsx): `cosmic-space-background/src/components/CosmicCanvas.tsx`
- [Commandes visuelles](https://github.com/bwillou1/williamguindon/blob/main/cosmic-space-background/src/components/ControlsDock.tsx): `cosmic-space-background/src/components/ControlsDock.tsx`
- [Shader nébuleuse](https://github.com/bwillou1/williamguindon/blob/main/cosmic-space-background/src/shaders/nebulaShader.ts): `cosmic-space-background/src/shaders/nebulaShader.ts`
- [Audio ambiant](https://github.com/bwillou1/williamguindon/blob/main/cosmic-space-background/src/utils/ambientAudio.ts): `cosmic-space-background/src/utils/ambientAudio.ts`
- [Thèmes](https://github.com/bwillou1/williamguindon/blob/main/cosmic-space-background/src/utils/themes.ts): `cosmic-space-background/src/utils/themes.ts`

### Other components

- **Visiteurs**
- **API Groq**

## Connections

- Visiteurs → Site officiel: consultent (evidence: `README.md`)
- Site officiel → Suivi en direct: propose le suivi (evidence: `README.md`)
- Site officiel → Registre CCE: oriente vers (evidence: `README.md`)
- Visiteurs → Registre CCE: consultent (evidence: `README.md`)
- Registre CCE → Pièces juridiques: publie des pièces (evidence: `README.md`)
- Visiteurs → Pièces juridiques: consultent (evidence: `README.md`)
- Pièces juridiques → Lecteur PDF: s’affiche dans (evidence: `README.md`)
- Site officiel → Actualités: présente l’actualité
- Visiteurs → Contact sécurisé: contactent (evidence: `README.md`)
- Site officiel → Espace IA: propose l’espace IA (evidence: `README.md`)
- Espace IA → Ressources LLM: oriente vers (evidence: `README.md`)
- Espace IA → Assistant documentaire: interroge
- Assistant documentaire → API Groq: appelle (evidence: `workers/groq-chat.js`)
- Visiteurs → API du corpus: consultent
- API du corpus → Documents API: expose aussi
- Application cosmique → Rendu WebGL: rend (evidence: `cosmic-space-background/src/App.tsx`)
- Application cosmique → Commandes visuelles: affiche (evidence: `cosmic-space-background/src/App.tsx`)
- Application cosmique → Thèmes: charge (evidence: `cosmic-space-background/src/App.tsx`)
- Application cosmique → Audio ambiant: commande (evidence: `cosmic-space-background/src/App.tsx`)
- Rendu WebGL → Shader nébuleuse: compile (evidence: `cosmic-space-background/src/components/CosmicCanvas.tsx`)
- Rendu WebGL → Audio ambiant: déclenche le son (evidence: `cosmic-space-background/src/components/CosmicCanvas.tsx`)
