Étude de cas / Application web collaborative
En ligne
Notes
Des notes à plusieurs, en temps réel, inspirées de Notion.
- Rôle
- Conception, code et hébergement
- Année
- 2026
- Statut
- En ligne
Couches touchées : Interface, API et logique, Données, Infrastructure, Réseau.

Contexte
Réviser à plusieurs demande un outil gratuit, sans quota, où l’on écrit en même temps. Notes est un espace de type Notion, auto-hébergé : pages imbriquées, bases de données, édition en temps réel, espaces de groupe et partage.
Le service est en ligne sur notes.yutho.fr. Il tourne sur un VPS avec Docker Compose, derrière Caddy, avec des sauvegardes nocturnes.
Ce que j’ai construit
Un seul processus, une seule origine
Un serveur Node sert les pages Next.js, les Server Actions, l’API et le WebSocket temps réel. Le cookie de session suit partout, sans CORS ni jeton côté client.
Écrire à plusieurs
L’éditeur par blocs (BlockNote, sur ProseMirror) se synchronise avec Yjs à travers Hocuspocus. Commentaires, mentions et annotations dessinées.
Des bases de données façon Notion
Vues tableau, kanban et calendrier écrites sur mesure, glisser-déposer avec dnd-kit, modèles prêts à remplir et publication en lien public.
Les IA branchées avec des droits
Claude, ChatGPT ou Claude Code se connectent par MCP à travers un serveur OAuth 2.1 : une IA n’a que les droits de la personne qui l’a autorisée.
Le bureau et la voix
Une application de bureau Tauri, et une dictée commune au site et au bureau qui distingue les personnes qui parlent.
Architecture
Clients
Navigateur
Site et app installable
Bureau
Tauri
IA
Claude, ChatGPT par MCP
- HTTPS + WebSocket via Caddy
Un seul processus Node
Next.js
Pages, Server Actions, API
/collab
WebSocket · Hocuspocus · Yjs
/api/mcp
OAuth 2.1, droits de l’utilisateur
- Mêmes services, mêmes droits
Stockage
PostgreSQL 18
Drizzle ORM
Fichiers
Disque local, prêt pour S3
Choix techniques
Une seule logique de droits
Pages, actions, routes et WebSocket passent par les mêmes services et le même code d’accès à la base : une règle de partage ne peut pas être oubliée sur un chemin.
Connexion par code e-mail, sans mot de passe
Un code à six chiffres envoyé par e-mail (Better Auth) : aucun mot de passe à stocker ni à faire fuiter.
Aucun cookie non essentiel
Pas de traceur, donc pas de bandeau de consentement : on arrive et on écrit.
Un arrêt propre
Sur SIGTERM, le serveur cesse d’accepter des connexions, sauvegarde les documents temps réel, termine les e-mails en cours, puis ferme la base.
La pile
- InterfaceCe qu’on voit et ce qu’on touche
- Next.js 16Éditeur BlockNoteApp de bureau Tauri
- API et logiqueLes règles, les droits, les échanges
- Server ActionszodMCP · OAuth 2.1
- DonnéesCe qui est stocké, et comment
- PostgreSQL 18Drizzle
- InfrastructureBuild, déploiement, serveurs
- Docker ComposeCaddyGitHub Actions
- RéseauCe qui circule entre les machines
- WebSocketYjs (CRDT)Hocuspocus
Qualité
- Biome, Vitest et Playwright ; TypeScript strict partout, schémas zod partagés entre front et back.
- Images publiées sur GHCR par GitHub Actions, déploiement Docker Compose et sauvegardes nocturnes.