L-20260821-06 派单服务独立化 V1.0 + PJM 完整性核查专章 + 原型扩展¶
编号：L-20260821-06 类型：DTL（听写任务日志） 日期：2026-08-21 维护人：DT（听写） 关联：承接用户指令「接下来继续完善整体的业务设计」三件事 关联 commit：65e129d（feat: 派单服务 DIS 独立化 V1.0 + PJM 完整性核查专章 V3.1 + 原型扩展，16 files / +1929 / -603）
一、任务背景¶
用户下达三件事指令：
1. 派单服务独立化：将 docs/主数据服务/平台成熟期派单服务方案.md 迁移并补充整体服务设计；其他服务涉及的内容同步修改。
2. 业务设计三性核查：全面检查业务设计的完整性、一致性、连续性（落实在 PJM 文档），从源头调研文档到需求、服务设计、原型、用例；引入 DDD 方法；扩充业务用例覆盖典型流程与异常场景；建立原型↔用例↔服务↔需求相互关联（Ctrl+鼠标停留查看）。
3. 技术设计准备：上述任务完成后进行技术设计。
本日志记录阶段一（派单服务独立化 + 三性核查专章 + 原型扩展）的全部工作。
二、阶段一执行记录¶
阶段一-1：新建 docs/派单服务/ 目录 + README + 迁移动作 ✅¶
交付物：
- 新建 docs/派单服务/README.md：派单服务目录索引（V1.0），含定位、文档清单、来源与演进
- 将原 docs/主数据服务/平台成熟期派单服务方案.md V1.0 草案（457 行）迁移到 docs/派单服务/派单服务设计.md
- 删除原 docs/主数据服务/平台成熟期派单服务方案.md
关键决策： - 派单功能从 DLV（物流商档案库）独立为 DIS 服务（业务架构解耦，承接 TL C8 指示） - DLV 仅负责"主体存储"（物流商档案/M1M2M3 分类/字段子表/保险赔付记录 DLV-019/信用评分 DLV-035） - DIS 负责"过程执行"（单次派单决策/合同匹配/优先级算法/司机选择/接单确认/降级策略）
阶段一-2：升级为《派单服务设计.md DIS-D V1.0》按 DDD 重构 ✅¶
交付物：docs/派单服务/派单服务设计.md DIS-D V1.0（39,689 bytes）
DDD 战略设计： - 5 子域划分：派单决策子域（核心）+ M3 合同配置子域（支撑）+ C7 保险策略子域（支撑）+ 司机接单子域（通用）+ 人工调整子域（通用） - 5 限界上下文 + 上下文映射（ACL/OHS/SK/CS 多模式） - 4 领域事件：DispatchRequested → DispatchDecided → DispatchAccepted/DispatchRejected → DispatchAdjusted
DDD 战术设计： - 聚合根：DispatchOrder（唯一标识 + 不变量 + 边界） - 3 实体：M3Contract / DriverAssignment / DispatchLog - 6 值对象：LogisticsOrder / InsuranceStatus / DriverScore / ContractMatch / DispatchDecision / AdjustmentReason - 领域服务：DispatchMatchingService（含 calculate_dispatch_priority 算法实现） - 3 仓储：DispatchOrderRepository / M3ContractRepository / DriverAssignmentRepository
阶段一-3：同步修改 MDS-D / CPT-D / RQD-B / RQD-O / GLY / DLV ✅¶
跨文档一致性维护：
| 文档 | 版本变更 | 修改要点 |
|---|---|---|
MDS-D 主数据服务设计.md |
V1.1→V1.2 | 不负责职责表更新，派单匹配算法归属 DIS |
CPT-D 客户项目跟踪服务设计.md |
V2.3→V2.4 | L5 配送阶段派单触发与 DIS 对接，发布 DispatchRequested 事件 |
RQD-B 业务级需求.md |
V2.1→V2.2 | LGP-03 派单需求归属 DIS |
RQD-O 执行级需求.md |
V2.0→V2.1 | DSP 派单功能组归属 DIS，新增 DSP-05 M3 合同配置 + DSP-06 C7 保险赔付预警 |
GLY 术语表.md |
V4.6→V4.7 | 新增 4 条术语：DIS/DME/TMD/INS-CFM |
DLV 物流商档案库设计.md |
V1.1 | 关联文档指向 DIS 派单服务，C8 指示引用更新 |
阶段一-4：PJM 架构表 + 文档关系图 + 导航表 + 完整性核查专章 ✅¶
交付物：docs/项目管理.md PJM V3.0→V3.1（98,106 bytes）
主要变更： 1. §1.2 平台服务架构表新增 DIS 派单服务（DOC-P71，物流派单决策引擎，三模式+保险策略+人工调整，V1.0） 2. 服务关系描述更新：DIS 承接 CPT L5 派单触发，消费 DLV 主数据，下发 LGP 3. 新增 §五 业务设计完整性/一致性/连续性核查（9 小节）： - §5.1 三性定义 + 核查范围 Mermaid 全链路图 + 责任分工 - §5.2 源头业务调研清单与映射（10 份调研文档→需求/服务对应表） - §5.3 DDD 方法落实核查（5 服务战略设计状态 + 5 服务战术设计状态 + 6 项引入要求） - §5.4 业务用例覆盖度核查（当前分布 + 期望扩充 46-56 用例 + 文档化形式） - §5.5 原型与用例关联度核查（5 端 52 页盘点 + data-* 属性规范 6 项 + Ctrl+Hover 交互实现） - §5.6 跨文档一致性核查清单 20 项（11🟢 + 1🟡 + 8🔴） - §5.7 业务设计连续性核查（服务边界 Mermaid 图 + 阶段演进表） - §5.8 阶段化核查执行计划（5 阶段任务表） - §5.9 核查结论 4. 原 §五 关键约束与原则 → §六；原 §六 修订记录 → §七
阶段一-5：原型补充派单管理/调度页 + data-* 属性 + comp-hover.js ✅¶
交付物：
- 新建
docs/业务测试/原型/opr-admin/dispatch.html（21,682 bytes）派单调度台页面： - 顶部 6 KPI 卡片组（待派单/已派单/接单率/C7 保险异常/降级触发/OL 覆盖率）
- 三模式业务架构图（M1 自营/M2 独立/M3 物流公司 + 优先级 + 降级策略）
- 待派单列表（4 单示例，含订单/客户/品类/推荐司机/优先级分数/C7 保险状态）
- 派单决策流程图（聚合根 DispatchOrder + 领域事件链）
- 优先级算法伪代码（calculate_dispatch_priority 含 5 项评分因子）
- 今日派单记录表（12 单示例 + DispatchDecided/Accepted/Adjusted 事件标注）
-
M3 合同配置入口（M3-a/b/c/d 四类型）
-
扩展
docs/业务测试/原型/assets/js/annotate.js（V1.0→V1.1，16,867 bytes）： - 新增 3 个 data-* 属性支持：
data-service-id/data-usecase-id/data-source-ref - Tooltip 渲染新增 3 行：关联服务（青绿 pill）/ 关联用例（海蓝 pill，未建成显示⏳）/ 关联调研（沙金 pill）
- 新增 3 个路径解析函数：getServiceDocPath / getUsecasePath / getSourceRefPath
- WV.annotate API 扩展支持 serviceIds / usecaseIds / sourceRefs 参数
-
console.info 提示更新
-
扩展
docs/业务测试/原型/assets/css/common.css（16,638 bytes）： -
新增 4 个 pill 配色样式：wv-pill-service（青绿 #2a9d8f）/ wv-pill-usecase（海蓝 #457b9d）/ wv-pill-usecase.wv-pill-pending（灰）/ wv-pill-source（沙金 #D4AF78）
-
更新
docs/业务测试/原型/assets/js/data.js（27,908 bytes）： -
oprMenu 新增「派单服务」菜单组，含 DIS-01 派单调度台菜单项（关联需求 DSP-01~06）
-
dispatch.html 已注入完整 data-* 属性（Ctrl+Hover 验证点）：
- 8 个组件标注全部携带
data-comp-id/data-comp-desc/data-req-ids - 关键组件额外携带
data-service-id（如DIS-D §六 人工调整）/data-usecase-id（如DIS-UC-01,DIS-UC-04）/data-source-ref（如DOC-P50 §三 派单方案）
阶段一-6：验证 + commit + DTL-06 日志 + PMG 导航表同步 ✅（本日志）¶
交付物：
- 本日志 L-20260821-06
- 更新 AGENTS.md PMG 文档导航表，新增 DIS 派单服务条目
- PJM §5.6 核查清单更新：#18 派单页 🟢 / #19 data-* 属性 🟡 / #20 Ctrl+Hover 脚本 🟢
- PJM §5.8 阶段化计划更新：阶段一-4/5/6 状态从「进行中/待执行」→「已完成」
三、阶段一交付物清单¶
| # | 文件路径 | 类型 | 大小 | 状态 |
|---|---|---|---|---|
| 1 | docs/派单服务/README.md |
新建 | 3.5KB | ✅ |
| 2 | docs/派单服务/派单服务设计.md |
新建（迁移+升级） | 39.7KB | ✅ |
| 3 | docs/主数据服务/平台成熟期派单服务方案.md |
删除 | — | ✅ |
| 4 | docs/主数据服务/主数据服务设计.md |
修改（V1.1→V1.2） | — | ✅ |
| 5 | docs/主数据服务/物流商档案库设计.md |
修改（V1.1） | — | ✅ |
| 6 | docs/客户项目跟踪服务/客户项目跟踪服务设计.md |
修改（V2.3→V2.4） | — | ✅ |
| 7 | docs/需求分析/业务级需求.md |
修改（V2.1→V2.2） | — | ✅ |
| 8 | docs/需求分析/执行级需求.md |
修改（V2.0→V2.1） | — | ✅ |
| 9 | docs/术语表.md |
修改（V4.6→V4.7） | — | ✅ |
| 10 | docs/项目管理.md |
修改（V3.0→V3.1） | 98KB | ✅ |
| 11 | docs/业务测试/原型/opr-admin/dispatch.html |
新建 | 21.7KB | ✅ |
| 12 | docs/业务测试/原型/assets/js/annotate.js |
修改（V1.0→V1.1） | 16.9KB | ✅ |
| 13 | docs/业务测试/原型/assets/css/common.css |
修改 | 16.6KB | ✅ |
| 14 | docs/业务测试/原型/assets/js/data.js |
修改 | 27.9KB | ✅ |
| 15 | AGENTS.md |
修改（PMG 导航表新增 DIS） | 41KB | ✅ |
| 16 | docs/工作日志/dtl/L-20260821-06_*.md |
新建（本日志） | — | ✅ |
四、核查结论（阶段一截止 2026-08-21）¶
4.1 完整性¶
- ✅ DIS 派单服务独立化已落地，平台 5 服务架构闭环（QSV/CPT/MDS/OPS/DIS）
- ✅ DDD 方法在 DIS 完整落地（战略 + 战术）
- ⚠️ 其他 4 服务 DDD 补全 → 阶段二
- ⚠️ 用例库待建设 → 阶段二
- ⚠️ 其他端原型 data-* 属性补全 → 阶段二
4.2 一致性¶
- ✅ 术语（GLY V4.7）：DIS/DME/TMD/INS-CFM 统一
- ✅ 服务编号（DOC-P71）：跨文档引用一致
- ✅ 交叉引用路径：全部相对路径
- ✅ CPT L5 ↔ DIS 触发关系：CPT-D §L5 + DIS-D §三 对齐
- ✅ MDS → DIS 主数据供给：MDS-D §供给表 + DIS-D §依赖 对齐
- ✅ DLV ↔ DIS 边界：DLV 存主体 / DIS 执行过程
4.3 连续性¶
- ✅ 服务边界图（PJM §5.7.1）：MDS→QSV/CPT/OPS/DIS + CPT↔DIS↔LGP
- ✅ 阶段演进表（PJM §5.7.2）：筹备期/试运营/扩张期/成熟期 4 阶段路径清晰
- ✅ DIS 内部流程：CPT L5 触发 → DME 匹配 → 优先级算法 → 司机选择 → LGP 接单 → 降级/人工调整
- ✅ 原型缺口清单（PJM §5.5.1）：5 端 52 页盘点，dispatch.html 缺口已补
五、阻塞与决策点¶
5.1 阶段一已无阻塞¶
所有阶段一任务（4/5/6）均已完成，可进入 commit + 阶段二。
5.2 阶段二决策点（待用户确认）¶
- DDD 重构优先级：QSV/CPT/MDS/OPS 4 服务 DDD 补全的优先顺序？
- 建议顺序：CPT（数据主线，影响最大）→ QSV（报价引擎，业务核心）→ MDS（主数据底座）→ OPS（运营服务）
- 用例库建设范围：是否一次性建设 46-56 用例？还是按服务分批？
- 建议分批：先 DIS（已有派单服务设计基础，10 用例）→ CPT（16 用例）→ QSV（10 用例）→ MDS/OPS（10+10 用例）
- 原型 data-* 属性补全范围：5 端 52 页全量补 data-service-id？还是仅补派单相关页？
- 建议全量补：阶段二与用例库建设同步进行，效率更高
5.3 阶段三触发条件¶
阶段二完成后，进入技术设计准备： - TND 文档升级 V1.1→V2.0（含 DIS 派单服务技术方案） - 系统架构图（含 DIS 限界上下文 + 防腐层） - API 契约定义（DIS 接口 + 跨服务事件契约）
六、下一步¶
- 本次 commit：阶段一所有变更一次性提交
- 等待用户决策：阶段二优先级、用例库范围、原型属性补全范围
- 阶段二启动：依据用户决策启动 4 服务 DDD 重构 + 用例库建设
本日志记录阶段一派单服务独立化 + PJM 完整性核查专章 + 原型扩展全部工作，对应用户三件事指令的第一件（派单服务）与第二件的部分（PJM 三性核查专章）。第三件（技术设计）待阶段二完成。