Skip to content
Menu

架构

工作原理

架构

一个 TypeScript monorepo,核心与协议无关。运行简单,代码易读。

原则

与协议无关的核心

领域层只认识帖子和人,不认识协议。

隐私优先

可见性是每个对象上的数据,并在同一处检查。

易于自建

Node、PostgreSQL、Redis。一台小型 VPS 就够了。

可迁移

导出、导入和账号迁移。

从第一天起就有审核

举报、屏蔽、频率限制、审计日志。

端到端类型化

服务器和 Web 应用共享类型和模式。

技术栈

服务器

  • Node.js 22 LTS
  • Fastify + Zod
  • Drizzle ORM + PostgreSQL 16+
  • Redis + BullMQ
  • Fedify (ActivityPub)
  • 我们自己的 diaspora* 库

Web

  • React 19 + Vite
  • TanStack Router & Query
  • Tailwind CSS v4
  • i18next (en, it, es)
  • PWA + Web Push
  • 供应用使用的 Mastodon 兼容 API

质量

  • TypeScript strict
  • Vitest: 450+ 测试
  • 来自官方 gem 的 diaspora* 测试样例
  • Biome
  • Turborepo
  • 持续集成

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

每个可联邦的对象都同时拥有 ActivityPub URI 和 diaspora* GUID。设计决策记录在 docs/decisions.md 中。

分层

Web 与应用

React 应用和 Mastodon 应用都与同一个 /api/v1 通信。

API

Fastify 路由用 Zod 校验输入,然后调用核心。

核心

社交规则、可见性和事件,内部不含任何协议。

适配器

ActivityPub 和 diaspora* 适配器把事件翻译成消息,也把消息翻译回事件。