RustLoom 开发手册

本手册是 RustLoom 开发规范的单一事实来源，面向参与设计、开发、测试和 发布的贡献者。README 只提供项目入口，具体规则应在本手册中维护。

RustLoom 当前已经具备：

• Axum HTTP 服务和 Tokio 运行时；
• PostgreSQL 连接池；
• 由 SQLx 管理的可逆数据库迁移；
• 进程存活与数据库就绪检查；
• 邮箱注册、密码登录、当前设备退出和只读 Profile；
• PostgreSQL 服务端 Session 与安全 Cookie；
• 自动化代码检查和文档构建。

身份能力仍是安全 MVP，不包含邮箱验证、密码找回、限流、权限或公网生产加固。

设计原则

• 先交付可验证的最小能力，再增加抽象。
• 所有数据库结构变化必须进入版本化 migration。
• 对外接口和错误码必须稳定、可测试、可记录。
• 文档与代码在同一 PR 中同步更新。
• 开发环境可以便利，生产默认必须安全。