Skip to content
Menu

Architecture

Comment ça marche

Architecture

Un monorepo TypeScript avec un cœur neutre vis-à-vis des protocoles. Simple à faire tourner, facile à lire.

Principes

Cœur neutre

Le domaine connaît les publications et les personnes, pas les protocoles.

La vie privée d'abord

La visibilité est une donnée de chaque objet, vérifiée en un seul endroit.

Facile à héberger

Node, PostgreSQL, Redis. Un petit VPS suffit.

Portabilité

Export, import et déménagement de compte.

Modération dès le premier jour

Signalements, blocages, limites de débit, journal d'audit.

Typé de bout en bout

Le serveur et l'appli web partagent types et schémas.

La stack

Serveur

  • Node.js 22 LTS
  • Fastify + Zod
  • Drizzle ORM + PostgreSQL 16+
  • Redis + BullMQ
  • Fedify (ActivityPub)
  • Notre propre bibliothèque diaspora*

Web

  • React 19 + Vite
  • TanStack Router & Query
  • Tailwind CSS v4
  • i18next (en, it, es)
  • PWA + Web Push
  • API compatible Mastodon pour les applis

Qualité

  • TypeScript strict
  • Vitest: 450+ tests
  • fixtures diaspora* issues de la gem officielle
  • Biome
  • Turborepo
  • Intégration continue

Le monorepo

apps/server      REST API, inbox/outbox, WebSocket
apps/worker BullMQ jobs: federated delivery
apps/web React single-page app
packages/core domain: posts, people, canView()
packages/db Drizzle schema and migrations
packages/activitypub ActivityPub adapter (Fedify)
packages/diaspora diaspora* protocol and bridge
packages/diaspora-import in-place pod migration
packages/shared shared types and Zod schemas
packages/config typed configuration

Chaque objet fédérable a à la fois une URI ActivityPub et un GUID diaspora*. Les choix de conception sont consignés dans docs/decisions.md.

Couches

Web et applis

L'appli React et les applis Mastodon parlent à la même /api/v1.

API

Les routes Fastify valident les entrées avec Zod et appellent le cœur.

Cœur

Règles sociales, visibilité et événements, sans aucun protocole à l'intérieur.

Adaptateurs

ActivityPub et diaspora* traduisent les événements en messages, et inversement.