• 演示环境：https://auth.fornetcode.com（admin@fornetcode.com / Herald@2026Admin）
• 项目地址：https://github.com/timzaak/herald

背景

做 SaaS 经常要重复造轮子：认证、OAuth、计费、积分、发票。现有方案要么不完整（Keycloak 不管计费），要么绑云服务按人头收费（Auth0）。Herald 把这些整合到一个自部署系统里。

功能概览

• 多租户认证：Realm 隔离，OAuth 2.0（Google / GitHub / 微信），TOTP 2FA，RBAC
• 订阅计费：Stripe、微信支付、Creem、Shopify
• 积分系统：双余额、过期管理、按量计费
• 发票管理：全生命周期，PDF 生成

框架选的 Axum ，存储层 PostgreSQL + Redis。架构上走了六边形架构，领域层不依赖 Axum 和 SeaORM 的具体类型。这个约束在 Rust 里天然好做——模块的可见性和 trait 边界本身就鼓励你把依赖关系理清楚。 enum + pattern matching 处理领域事件和状态机也很舒服，订阅状态流转、发票生命周期这些用枚举表达比用字符串常量安全得多。

##AI 辅助编程

这个项目从第一行代码就是 AI 辅助完成的，Claude Code + GLM 模型混合开发。最终产出的是生产级代码，不是 demo。 AI编程对Rust 项目工程化的要求比较高，对机器的要求也高，笔记本风扇一直呼呼的转。 我已经将开发 Herald 过程中积累的工作流已经抽取成 Claude Code 插件 web-dev-skills，把 PRD、设计、任务拆解、开发、验收串成结构化流程，每个阶段有质量门禁。有兴趣的可以看看。