Wow 文档导览

从第一次成功开始，再按当前任务继续。

30 分钟首次成功目标

依次完成以下确认门槛：

1. 从 wow-project-template 创建项目。
2. 确认选定的 Wow 版本。
3. 通过领域测试。
4. 启动服务。
5. 发送一条真实 HTTP 命令并检查命令结果。
6. 读取版本化的事件溯源状态。

完整步骤和完成语义见快速上手。

功能门槛已经验证；由于尚未测量新开发者首次完成的墙钟时间，30 分钟仍是目标时长。

继续构建

从领域模型、命令和事件与协作三个入口继续；再用投影和查询建立读取侧。

准备生产运行

先阅读生产最佳实践，再验证备份、恢复与重放、应用测试、可观测性和故障排查。

精确查阅

需要精确配置、示例或生态资源时，使用配置参考、示例和生态资源；需要 Kotlin 或 Java 符号和签名时，从顶部导航进入 API 文档。

按角色评估或参与

入门导航按贡献者、Staff Engineer、管理者和产品经理的决策分流；具体取舍见文章。

按任务继续

你要完成的任务	先读	然后读	完成标志
判断 Wow 是否适合项目	简介	生产最佳实践	能说明收益、运行成本和不适用场景
运行第一个应用	快速上手	配置	领域测试通过，真实命令到达 SNAPSHOT，状态可读回
接入现有 Spring Boot 服务	接入现有项目	Spring Boot Starter	KSP 元数据、自动路由、命令和快照闭环均通过
学习完整 Kotlin 应用	订单与购物车	应用测试	能追踪命令、事件、状态、Saga、投影和重启恢复
设计聚合和业务约束	领域模型	聚合与不变量	命令产生领域事件，溯源后状态可验证
建立应用发布门禁	应用测试	生产最佳实践	领域、HTTP、真实 Adapter、恢复和安全反例都有证据
演进已持久化事件	事件演进	事件溯源	Upgrader 注册、顺序、历史回放与回滚均有证据
提供写入 API 和完成语义	命令	完成语义	能区分 SENT、PROCESSED、SNAPSHOT 和 PROJECTED
建立查询模型	投影	查询	投影可重试且幂等，查询边界清晰
编排跨聚合流程	事件与协作	Saga	正常、重试、不可恢复路径都有测试
选择存储和消息实现	模块依赖	扩展	只引入实际需要的后端和 Starter capability
准备上生产	生产最佳实践	备份、恢复与重放	幂等、恢复、容量、告警和回滚均有证据
处理异常或卡住	故障排查	对应的核心/扩展页	已定位失败阶段，而不只是扩大超时
迁移旧系统或旧版本	迁移指南	选定的迁移路径	库存、对账、切流、回滚门禁完整

如何使用不同类型的文档

• 指南：解释为什么和怎样完成任务。
• 参考：查找精确配置、示例和生态资源。
• API：从顶部导航进入 Dokka，查找 Kotlin/Java 符号和签名。
• 入门导航：按贡献者、架构师、管理者或产品经理角色阅读。
• 文章：从具体问题理解设计取舍，不代替 API 与配置参考。
• 文档治理：定义规范目录、生命周期、证据与清理规则。

版本和事实来源

文档解释仓库，但不代替仓库。当文字与当前 tag 的公开契约、配置类、测试或发布说明不一致时，以选定版本的源码为准。