L-20260821-07 阶段二-0~4：BAS 业务架构说明 + CPT/QSV DDD 重构 + 用例库首批¶
编号：L-20260821-07 类型：DTL（听写任务日志） 日期：2026-08-21 维护人：DT（听写） 关联：承接用户指令「进入阶段二，按优先级推进 DDD 重构，编写业务架构说明文档」 关联 commit：6898ab0（feat: 阶段二-0~4 BAS 业务架构基线 + CPT/QSV DDD 重构 + 用例库首批，9 files / +1812 / -35）
一、任务背景¶
用户确认进入阶段二，按建议优先级（CPT → QSV → MDS → OPS）推进 DDD 重构与用例库建设。同时强调： - DDD 方法贯彻注重实用性、业务解耦、业务协作边界清晰 - 确保业务各领域在后续运营过程中更好的深入演进迭代 - 专门编写业务架构解释说明文档，帮助后续团队讨论和 AI 深化设计保持领域架构和协作边界稳定性
本日志记录阶段二前半部分（阶段二-0~4）的工作。
二、阶段二-0~4 执行记录¶
阶段二-0：新建《业务架构说明.md》BAS V1.0 ✅¶
交付物：docs/业务架构说明.md（DOC-A07 V1.0）
8 章内容： 1. 文档定位与目标（适用对象 + 稳定性原则） 2. 平台业务领域全景（Mermaid 全景图 + 子域分类表） 3. 5 服务限界上下文总图（C4 Context View + 映射模式 + 各服务 BC 清单） 4. 服务协作边界与契约（协作矩阵 RACI + 边界约束 + 契约演进规则） 5. 数据流与领域事件总线（事件总线图 + 事件清单 12 事件 + 数据流闭环） 6. DDD 实施规范（子域划分原则 + 限界上下文划分原则 + 聚合根设计原则 + 领域事件设计原则 + 服务设计文档 DDD 章节模板） 7. 演进路径与稳定性保障（4 阶段演进表 + 变更治理流程 Mermaid + 稳定性检查清单） 8. 附录（术语速查 + 关联文档 + 修订记录）
关键决策： - BAS 作为业务架构稳定基线，子域边界在成熟期前不轻易变更 - 变更须经 TL 审批并升级 BAS 版本 - 提供 DDD 章节模板，统一后续 4 服务的 DDD 重构规范
关联文档同步： - AGENTS.md PMG 导航表新增 BAS 条目（优先级 1.5） - GLY V4.7 新增 BAS 术语
阶段二-1：CPT-D DDD 重构 V2.4→V2.5 ✅¶
交付物：docs/客户项目跟踪服务/客户项目跟踪服务设计.md CPT-D V2.5
DDD 战略设计（§二）： - §2.1 子域定位：客户项目跟踪（核心）+ 跟踪池（通用）+ 异常处理（通用） - §2.2 限界上下文 Mermaid 图：3 BC + 7 外部 BC 映射 - §2.3 上下文映射模式表：OPS（CS）/ QSV（CS）/ DIS（OHS）/ MDS（OHS+ACL）/ WKR（CS）/ LGP（CS）/ CST（OHS） - §2.4 防腐层 ACL 设计表：6 个外部模型 → 内部 VO 转换规则
DDD 战术设计（§三）： - §3.1 聚合根 CustomerProject（唯一标识 + 4 不变量 + 边界 + 生命周期） - §3.2 实体清单：StageRecord / ExceptionCase / TrackingPoolAssignment / ActualDataFeedback - §3.3 值对象清单：10 VO（CustomerRef/WorkerRef/BuildingRef/CatalogRef/QuoteSnapshot/DispatchSnapshot/StageStatus/ExceptionAction/NPSFeedback/AcceptanceResult） - §3.4 领域服务：6 服务（StageTransitionService/ExceptionHandlingService/TrackingPoolService/DataFeedbackService/LeadIntakeService/QuoteOrchestrationService） - §3.5 领域事件清单：10 事件（CustomerProjectCreated/StageCompleted/QuoteRequested/DispatchRequested/InstallationCompleted/AcceptanceConfirmed/NPSFeedback/ActualDataFeedback/TrackingPoolAssigned/ExceptionEscalated） - §3.6 仓储与工厂：3 仓储 + 2 工厂 - §3.7 CPT 状态机 Mermaid（L1-L8 + 异常池回流）
章节编号调整：原 §二~§七 顺延为 §四~§九
阶段二-2：CPT 用例库建设 16 用例 ✅¶
交付物：
- docs/业务测试/用例/README.md（UCL DOC-A08 V1.0 用例库总索引）
- docs/业务测试/用例/CPT-UC-用例库.md（CPT-UC V1.0，16 用例）
16 用例分布： - 4 典型：UC-01 标准家具全流程 / UC-02 灯具楼宇系数 / UC-03 跨境配送+卫浴 / UC-04 B 端 MFR 委托 - 12 异常：UC-05 L2 流失唤醒 / UC-06 L3 拒绝换品 / UC-07 议价封顶价 / UC-08 L4 取消退款 / UC-09 L5 延误 / UC-10 L5 损坏 / UC-11 L6 换师傅 / UC-12 L6 增项 / UC-13 L7 整改 / UC-14 L7 客诉 / UC-15 L8 推荐裂变 / UC-16 L8 低分挽回
每用例含：编号 + 分类 + 触发条件 + 主流程步骤（含数据样例）+ 异常分支 + 关联原型 + 关联服务 + 关联需求
阶段二-3：QSV-D DDD 重构 V1.1→V1.2 ✅¶
交付物：docs/报价服务/报价服务设计.md QSV-D V1.2
DDD 战略设计（§三）： - §3.1 子域定位：报价决策（核心）+ 报价模型（支撑） - §3.2 限界上下文 Mermaid 图：2 BC + 4 外部 BC - §3.3 上下文映射模式表：MDS（OHS）/ CPT（CS）/ OPS（CS）/ MFR（OHS）/ QMD（SK） - §3.4 防腐层 ACL 设计表：5 个外部模型 → 内部 VO
DDD 战术设计（§四）： - §4.1 聚合根 Quote（4 不变量） - §4.2 实体清单：QuoteItem / FlexiblePart / QuoteVersion - §4.3 值对象清单：8 VO（QuoteRequest/QuoteBreakdown/PriceCap/PricingFactor/FactorWeight/CatalogFactor/BuildingFactor/WorkerFactor） - §4.4 领域服务：3 服务（PricingEngine/CapPriceService/QuoteCalibrationService）+ PricingEngine 算法伪代码（9 步骤完整实现） - §4.5 领域事件清单：6 事件（QuoteGenerated/QuoteAccepted/QuoteRejected/QuoteCalibrated/CapPriceTriggered/FlexiblePartConfirmed） - §4.6 仓储与工厂：2 仓储 + 2 工厂 - §4.7 报价状态机 Mermaid（Draft→Generated→Accepted/Rejected/Revised→Archived + CapTriggered）
章节编号调整：原 §三~§五 顺延为 §五~§七
阶段二-4：QSV 用例库建设 10 用例 ✅¶
交付物：docs/业务测试/用例/QSV-UC-用例库.md（QSV-UC V1.0，10 用例）
10 用例分布： - 5 典型：UC-01 标准家具 / UC-02 灯具楼宇系数 / UC-03 卫浴拆旧 / UC-04 家电系数 / UC-05 智能家居技能等级 - 5 异常：UC-06 加价险触发 / UC-07 封顶价触发 / UC-08 师傅超能力拒绝 / UC-09 增项报价 / UC-10 MFR 开放报价
覆盖货品类型：家具、灯具、卫浴、家电、智能家居（5 大品类，符合用户"3-5 个典型的不同类型货品"要求）
三、本轮交付物清单¶
| # | 文件路径 | 类型 | 状态 |
|---|---|---|---|
| 1 | docs/业务架构说明.md |
新建 BAS V1.0 | ✅ |
| 2 | docs/客户项目跟踪服务/客户项目跟踪服务设计.md |
修改 CPT-D V2.5 | ✅ |
| 3 | docs/报价服务/报价服务设计.md |
修改 QSV-D V1.2 | ✅ |
| 4 | docs/业务测试/用例/README.md |
新建 UCL V1.0 | ✅ |
| 5 | docs/业务测试/用例/CPT-UC-用例库.md |
新建 CPT-UC V1.0 | ✅ |
| 6 | docs/业务测试/用例/QSV-UC-用例库.md |
新建 QSV-UC V1.0 | ✅ |
| 7 | AGENTS.md |
修改 PMG 导航表（+BAS） | ✅ |
| 8 | docs/术语表.md |
修改 GLY V4.7（+BAS 术语） | ✅ |
四、核查状态（阶段二-0~4 截止）¶
4.1 BAS 稳定性基线已建立¶
- 业务领域全景 + 5 服务限界上下文 + 协作契约 + 领域事件总线 + DDD 实施规范 + 演进路径全部落地
- 后续 MDS/OPS DDD 重构可直接遵循 BAS §六 DDD 实施规范
4.2 CPT/QSV DDD 完成度¶
| 服务 | 战略设计 | 战术设计 | 状态 |
|---|---|---|---|
| CPT | ✅ 3 BC | ✅ 聚合根+4 实体+10 VO+6 服务+10 事件 | 🟢 完成 |
| QSV | ✅ 2 BC | ✅ 聚合根+3 实体+8 VO+3 服务+6 事件+算法 | 🟢 完成 |
| MDS | 🟡 待补 | 🟡 待补 | 🔴 阶段二-5 |
| OPS | 🟡 待补 | 🟡 待补 | 🔴 阶段二-7 |
| DIS | ✅ 5 BC | ✅ 完整 | 🟢 V1.0 已完成 |
4.3 用例库覆盖度¶
| 服务 | 期望用例数 | 已完成 | 状态 |
|---|---|---|---|
| CPT | 16 | 16 | 🟢 完成 |
| QSV | 10 | 10 | 🟢 完成 |
| MDS | 10 | 0 | 🔴 阶段二-6 |
| OPS | 10 | 0 | 🔴 阶段二-8 |
| DIS | 10 | 0 | 🔴 阶段二-8 |
| 合计 | 56 | 26 | 🟡 46% |
五、阻塞与下一步¶
5.1 无阻塞¶
阶段二-0~4 全部按计划完成，可进入阶段二-5~10。
5.2 下一轮任务（阶段二-5~10）¶
- 阶段二-5：MDS-D DDD 重构（六库主数据子域：SCL/BPL/WPL/CPL/PPL/DLV）
- 阶段二-6：MDS 用例库建设（10 用例）
- 阶段二-7：OPS-D DDD 重构（获客/物料/口碑子域）
- 阶段二-8：OPS 用例库（10 用例）+ DIS-UC 用例库（10 用例）
- 阶段二-9：5 端 52 页原型 data-* 属性全量补全（与用例库同步）
- 阶段二-10：PJM §5.6 核查清单更新 + commit + DTL-08
5.3 阶段三触发条件¶
阶段二全部完成后，进入技术设计准备（TND V2.0 + 系统架构图 + API 契约）。
六、关键决策记录¶
- BAS 作为稳定基线：子域边界在成熟期前不轻易变更，变更须 TL 审批
- DDD 章节统一模板：所有服务设计文档遵循 BAS §6.5 模板（战略设计 + 战术设计）
- 用例库形式：每服务一份用例库文档（而非每用例独立文件），便于维护与查阅
- 章节编号顺延：DDD 章节插入后，原章节编号顺延，修订记录中明确说明
- PricingEngine 算法伪代码：QSV-D 首次落地完整报价算法（9 步骤），作为后续技术设计的依据
本日志记录阶段二前半部分（BAS + CPT/QSV DDD + 用例库首批）全部工作，对应用户指令的"阶段二 + 业务架构说明文档"。