Tour Mate 搭子出行项目实战
这是一个基于 Spring Boot + DDD + 六边形架构 的搭子出行(Tour Mate)项目从 0 到 1 的完整学习记录。从最初的充血模型设计,到引入领域事件、Saga,再到 Specification 与防腐层,以及最终的 BFF 与前后端联调,整套笔记按主题串成一条学习路径。
主题地图
按下面这张图的顺序阅读最顺:先用 00 建立方法论 → 架构搭骨架 → 用领域事件解耦 → 引入 Specification 处理复杂业务规则 → 把数据与缓存沉到底层 → 上层做 BFF 与前端联通 → 部署与踩坑 → 最后用 08 把方法论闭环。
注:这张 mermaid 图是唯一手工维护的部分,因为节点之间的箭头关系有业务含义(不是单纯的线性顺序)。新增章节如果需要在图里体现关系,请来这里手动连一条线。下方的「主题速览」表是自动收录的,不用动。
主题速览
| 主题 | 解决的问题 | 入口 |
|---|---|---|
| 00 AI 开发工作流-软件开发篇 | 一个人 + AI 做项目的角色拆分、接口契约、协作节奏 | 进入 |
| 01 架构演进 | 充血模型、CQRS、多端接入、调用链分层 | 进入 |
| 02 领域事件与 Saga | 用事件解耦活动领域、Saga 编排长事务 | 进入 |
| 03 Specification 与防腐层 | 业务规则下沉、Repository 防腐、JPA Spec 与 DDD Spec 区别 | 进入 |
| 04 持久化与缓存 | JPA + MyBatis 双引擎、缓存机制、SQL 建表 | 进入 |
| 05 BFF 与前后端对接 | BFF 模式、Mock 真实化、缺失接口梳理 | 进入 |
| 06 部署与运维 | Docker、阶段性部署、env 密码 | 进入 |
| 07 踩坑与杂记 | 配置注入坑、Maven 插件、commit 规范 | 进入 |
| 08 AI 协作工作流的感悟与 SOP | 从传统团队到 AI 多角色协作的流程演化、踩坑反思,以及一份可落地的 SOP | 进入 |
这张表由
import.meta.glob自动扫描生成。新增章节只要在对应index.md(或根级.md文件)头部写好title和description,本表会自动多出一行。详见根目录 README.md 的「Tour Mate 章节自动收录机制」。
推荐阅读路径
- 第一次做这个项目:先看
00 AI 开发工作流-软件开发篇,建立一个人 + AI 推进项目的整体方法论和角色分工 - 第一次接触本项目代码:再看
01 架构演进的「充血模型设计」「服务职责划分指南」,建立对项目分层的基本认知 - 关心 DDD 落地:沿
01 → 02 → 03顺序读,能看到从「贫血/充血」到「事件驱动」再到「Specification 模式」的演进脉络 - 只想跑起来:直接看
06 部署与运维,配合07 踩坑与杂记兜底 - 关心前后端联调:
05 BFF 与前后端对接单独成章