Skip to content
Menu

Architektur

So funktioniert's

Architektur

Ein TypeScript-Monorepo mit protokollneutralem Kern. Einfach zu betreiben, leicht zu lesen.

Prinzipien

Protokollneutraler Kern

Die Domäne kennt Beiträge und Menschen, keine Protokolle.

Privatsphäre zuerst

Sichtbarkeit ist eine Eigenschaft jedes Objekts, geprüft an einer Stelle.

Leicht zu hosten

Node, PostgreSQL, Redis. Ein kleiner VPS reicht.

Portabilität

Export, Import und Kontoumzug.

Moderation vom ersten Tag an

Meldungen, Blockierungen, Rate-Limits, Audit-Log.

Durchgängig typisiert

Server und Web-App teilen Typen und Schemas.

Der Stack

Server

  • Node.js 22 LTS
  • Fastify + Zod
  • Drizzle ORM + PostgreSQL 16+
  • Redis + BullMQ
  • Fedify (ActivityPub)
  • Unsere eigene diaspora*-Bibliothek

Web

  • React 19 + Vite
  • TanStack Router & Query
  • Tailwind CSS v4
  • i18next (en, it, es)
  • PWA + Web Push
  • Mastodon-kompatible API für Apps

Qualität

  • TypeScript strict
  • Vitest: 450+ Tests
  • diaspora*-Fixtures aus dem offiziellen Gem
  • Biome
  • Turborepo
  • Continuous Integration

Das 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

Jedes föderierbare Objekt hat sowohl eine ActivityPub-URI als auch eine diaspora*-GUID. Designentscheidungen sind in docs/decisions.md festgehalten.

Schichten

Web & Apps

Die React-App und Mastodon-Apps sprechen mit derselben /api/v1.

API

Fastify-Routen validieren Eingaben mit Zod und rufen den Kern auf.

Kern

Soziale Regeln, Sichtbarkeit und Events, ohne Protokoll darin.

Adapter

ActivityPub und diaspora* übersetzen Events in Nachrichten und zurück.