Aller au contenu
yutho

É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.

Notes : une base « Révisions » en kanban, avec des notions à revoir, en cours et maîtrisées.

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

  1. 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.

  2. Écrire à plusieurs

    L’éditeur par blocs (BlockNote, sur ProseMirror) se synchronise avec Yjs à travers Hocuspocus. Commentaires, mentions et annotations dessinées.

  3. 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.

  4. 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.

  5. 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

  1. Clients

    • Navigateur

      Site et app installable

    • Bureau

      Tauri

    • IA

      Claude, ChatGPT par MCP

  2. HTTPS + WebSocket via Caddy
  3. Un seul processus Node

    • Next.js

      Pages, Server Actions, API

    • /collab

      WebSocket · Hocuspocus · Yjs

    • /api/mcp

      OAuth 2.1, droits de l’utilisateur

  4. Mêmes services, mêmes droits
  5. Stockage

    • PostgreSQL 18

      Drizzle ORM

    • Fichiers

      Disque local, prêt pour S3

Pages, actions, routes et WebSocket passent par les mêmes services : une seule logique de droits pour tout le produit.

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.