用途:在 Cloudflare Workers 上构建整洁后端,保持依赖向内流动、边界清晰、可测试,并设唯一组合根。可用 DDD 或六边形架构,但需先检测并遵循现有架构,不强行套用 DDD 术语;标有 [detect: …] 的小节要求编辑前先读证据。
主要能力与结构:后端位于 apps/<app>/src/server/,分 entrypoints(server 函数、queue、scheduled、middleware,仅做传输)、application(消息总线、处理器、注册表)、domain(messages、models、services、errors,纯净无框架依赖)、infrastructure(app-deps.ts、persistence、auth、resilience、外部客户端)。另有入口点识别、依赖引导、AppDeps 组合根、错误处理与传输契约、消息总线、工作单元、发件箱中继、幂等、仓储等规则。
使用方式:入口点做校验—授权—分发—转换;消息总线只路由不开事务;命令处理器打开 UoW(deps.uow.run(messageId, (repos, emit) => …)),先认领 receipt,再写库并持久化事件到 message_outbox,最后提交;事件订阅分 state(各自 UoW)与 effect(无事务,幂等交给目标系统);查询绕过 UoW,可内联 Drizzle 查询返回 DTO;发件箱由 cron 或 relay DO alarm 投递。
适用场景:使用 Cloudflare Workers、D1、Postgres、Queues、Workflows、Durable Objects 的 DDD/CQRS 后端项目。
限制:具体版本、命令与配置示例以资料为准;未提供的信息暂未说明,需结合项目现状判断。