# M6 交付项目管理 — 逻辑设计文档（LDD · How）

| 项 | 值 |
|---|---|
| 模块 | M6 交付项目管理 |
| 类型 | 逻辑设计文档（LDD） |
| 对应需求 | [requirements/M6](../requirements/M6-交付项目管理.md) |
| 上级 | [需求分析总纲](../需求分析总纲.md) |

> 本文档描述**实现方式（How）**；"做什么/为什么/验收"见对应需求文档。

## 1. 数据模型
```
Contract(PS_Service) 1──* Project(service_package, mode)   （1 合同 : N 项目，各绑该合同 Quota；mode: project | continuous=绑既有 retainer 合同）
Project 1──* Milestone 1──* Task 1──* Sub-task     （严格三层）
Milestone ──▶ {doc_template, signoff_config, entry/exit}   （关卡三要素）
Project 1──* Deliverable 1──* DeliverableVersion   （客户签署，M8）
Project 1──* RAID(type, owner, status)
Project ── Baseline(schedule/effort) ；Project ── EAC(derived)
Project ── RAGStatus(schedule/scope/budget/risk)
Project 1──* StatusUpdate(period, rag, progress, next, risks, ask)   （周期状态更新/Check-in，每周期一条）
Customer(retainer) 1──* EngagementRequest ──▶ triage(TAM/PS Leader) ──▶ Project   （持续型需求驱动立项）
```
**Project 字段**：`id, customer_id, contract_id, service_package, mode(project/continuous), name, code, timeline, status, product, version`；责任人 `PS_Leader, PM, PSE[], TAM, secondary_owner(备份负责人)`。
**StatusUpdate 字段**：`id, project_id, period(week/起止日), rag, progress(本周进展), next(下周计划), risk_refs[](关联 RAID), ask(需支持), auto{mandays_week, burn, milestone_changes}(只读带出), submitted_by, submitted_at`。
**EngagementRequest 字段**：`id, customer_id, contract_id(retainer), source(客户/TAM/Support), summary, type(运维型/交付型), triage_by, decision(立项/并入通用桶), project_id?`。
**Milestone 字段**：`id, project_id, name, seq, doc_template_id, signoff_config, entry_cond, exit_cond, status`。
**Task 字段**：`id, milestone_id, parent_task_id, title, owner, reviewer, est_mandays, actual_mandays(derived), due_date, status, depends_on[]`。

## 2. 状态机（项目型）
`Draft → Kickoff Scheduled → In Progress → Deliverable Review → Customer Sign-off → Closed`
- 状态机**按 Service Package 绑定**、引擎可配（不 hard-code）。
- 状态推进由 **Milestone 关卡** 门控：关卡 Signoff 通过才允许进入下一状态；驳回则回退。
- 挂起（Pause）为叠加态，记归因（客户/内部），可停 SLA 计时。

## 3. Milestone 关卡链引擎
- 关卡 = `{关联文档(模板生成) + Signoff(签署人=内审/客户，串/并) + 进入/退出条件}`。
- **驳回返工**：Signoff 驳回 → 关卡回退 → 生成返工任务 → 修订后重提；驳回意见与轮次留痕。
- **两种模式**：
  - **项目型**：线性关卡链（见状态机）。
  - **持续型（Assurance/驻场/Dedicated）**：retainer + **事件工单**（on-call/S1/演练）+ **周期服务报告**；无线性关卡；持续型即 **Dedicated 项目**（mode=continuous），**有 Quota（source=Dedicated、amount=unlimited）**，**工时照常 draw-down 到该 unlimited 池——照记 used、remaining=∞、不耗尽、不预警超支**（利用率/成本照记）；同一 retainer 下可派生多个 Service Package 跟踪项目。

## 4. 预设 Milestone 链（默认配置，待各 Package Owner 共创）
| Service Package | 预设 Milestone 链（每关卡出文档 + 签署） |
|---|---|
| 1 Foundation & Onboarding | Kickoff → 需求/环境调研 → 部署方案设计 → 搭建与配置 → 基线验证 → 验收 → 结项 |
| 2 Migration & Upgrade | Kickoff → 现状评估&兼容性 → 迁移/升级方案(含回滚) → 演练/预迁移 → 割接执行 → 割接验证 → 验收 → 结项 |
| 3 Performance Optimization | Kickoff → 负载/瓶颈诊断 → 优化方案 → 实施调优 → 效果验证(基线对比) → 验收 → 结项 |
| 4 Health, Monitoring & Resilience | Kickoff → 健康检查 → 监控&HA/DR 方案 → 实施 → 演练验证 → 运维就绪报告 → 结项 |
| 5 Customer Enablement & Training | Kickoff → 培训需求&大纲 → 材料准备 → 交付培训/workshop → 评估反馈 → 结项 |
| 6 Assurance & Resident Engineering | （持续型）服务启动 → 周期性保障(on-call/演练/S1) → 周期报告 → 期末总结/续期 |

## 5. 关键机制
- **立项自动化**：监听合同生效事件 → 按 SOW 中每个 Service Package 创建对应 Project（1 合同 : N 项目）、各绑该合同 Quota → 按 Package 模板实例化 Milestone/Task 骨架 → 通知 PS Leader。
- **文档生成**：进入关卡时按 `doc_template_id` 生成文档（变量自动填充：客户名/产品/版本），走 M8 版本与签署。
- **EAC/ETC 计算**：EAC = 已耗人天 + 剩余估算（ETC）；对比合同/SOW 的 Man-days，超阈值预警。
- **进度基线**：立项时固化 schedule/effort 基线；变更(CR)批准后 re-baseline；实际 vs 基线算偏差。
- **RAG 汇总**：按 进度/范围/预算/风险 各维度规则汇总为项目 RAG，驱动状态报告。
- **周期状态更新（Check-in）**：cadence 引擎按周期（默认每周、对齐周会日，可配）为每个在办项目生成一条 StatusUpdate 待办派给 PM/负责人；到期前提醒、逾期升级 PS Leader（M9 Automations）。每周期独立成条（非单字段累积），`mandays_week/burn/milestone_changes` 自动带出；提供当周速览卡 + 历史更新流（时间线，可导出周期报告）；聚合至 M10 周会看板（全项目本周 RAG + 进展 + 提交合规）。
- **持续型立项 triage**：Dedicated/retainer 客户需求经 EngagementRequest 入口 → TAM/PS Leader triage 判 `运维型/交付型`：交付型 → 立项（挂既有 retainer，一键轻量）；运维型 → 并入通用桶。**工时活动分流见 M7 FR-RES-10**；通用桶异常占比/关键词由 Automations 告警 PS Leader 兜底。
- **Secondary 保温与交接**：立项须填 `secondary_owner`（缺则派单阻断/告警）；Secondary 自动加入项目群、订阅通知与每周 Check-in、获项目读权限（M2），保持热备。缺席交接：主负责人设 `coverage(start,end,delegate=secondary)` + 交接便签 → 期内其待办/审批经 **M9 缺席委托（FR-APR-06）** 自动转 Secondary、到期回退；计划外由 PS Leader 改派 owner。

## 6. 端到端流程图
```
合同生效 ─▶ 立项(按 SOW 每个 Service Package 自动建项目+骨架) ─▶ 派单/Kickoff ─▶ [关卡1]调研/评估 ─签署─▶ [关卡2]方案/计划 ─签署─▶ [关卡3..n]执行/交付(每关卡:交付物+客户签署)
              每个[关卡]:模板文档 + Signoff(内审/客户) + 进出条件；驳回 ◀──返工回退                                                     │
执行期贯穿：活动化工时 · 变更控制(CR) · RAID · 停滞告警                                                                                  ▼
                                                     全部完成 ─▶ Completion(完成报告+客户签署) ─▶ 关闭CLOSED(结项+额度结算) ─▶ 移交回TAM(复盘入库)
```

## 7. 集成点
- **合同来源**：Nexus 同步 Contract / 审批生成 Virtual Contract（M1 D-C11）。
- **签署/文档**：M8（模板/版本/e-Signature）。
- **审批**：M9（立项、变更 CR、超支）。
- **工时/额度**：M7（活动化工时、burn、EAC 输入）。
- **交付后 CSAT**：M11。
- **移交**：M3（关闭后交接回 TAM）。