# 客户商务与交付管理平台 — 业务流程设计与版本迭代排期

> **文档角色**：资深产品经理视角的 **全业务 BPM 走查**、**版本迭代计划** 与 **排期框架**（可与研发 Sprint 对齐后填入具体日历）。  
> **计划基准日**：2026-04-06（相对排期以 **T0** 表示立项/开工周）。  
> **关联文档**：[功能模块与功能点](chuangfei-platform-product-modules.md) · [平台与比特对接总览](chuangfei-bitanswer-integration-platform.md) · [回调与地址评估](bitanswer-callbacks-endpoints-assessment.md) · [授权制度与规则](bitanswer-licensing-design-and-rules.md) · [工作区工程划分](engineering/WORKSPACE_ENGINEERING_LAYOUT.md)

---

## 1. 工作区文档走查结论（摘要）


| 文档                                                 | 已覆盖内容                                                 | 本文补足内容                                 |
| -------------------------------------------------- | ----------------------------------------------------- | -------------------------------------- |
| `chuangfei-platform-product-modules.md`            | M1–M11 模块、功能点 ID、P0/P1/P2、角色权限矩阵                      | **跨模块泳道流程**、**状态机与异常分支**、**发布列车与周次排期** |
| `chuangfei-bitanswer-integration-platform.md`      | 对接边界、技术架构、Spring Boot 4.0. + Vue 分档、产品使用 MVP/Mid/Full | 将上述档位 **映射为可发布版本号与迭代切片**               |
| `bitanswer-licensing-design-and-rules.md`          | 产品/模版/业务/授权、特征项、规则 Callback 事件                        | Callback 在 BPM 中的 **触发点与系统边界**         |
| `bitanswer-callbacks-endpoints-assessment.md`      | URL 类型、Webhook 与 SDK 分工                               | 在排期中固定 **Webhook 工程与联调节点**             |
| `craftlabs-auth-config` Schema / `examples/config` | 客户端配置形态                                               | 在 **BP-10** 与 **V1.0** 中体现配置发布依赖       |


**排期假设（可调整）**：每迭代 **2 周**；团队为 **1 个全栈小队**（可并行时压缩总周数）；**UAT 每大版本末预留 1 迭代**。

---

## 2. 业务流程总览索引


| 流程编号      | 流程名称                | 主价值        | 涉及模块        | 主责角色        |
| --------- | ------------------- | ---------- | ----------- | ----------- |
| **BP-01** | 客户与项目准入             | 主数据干净、可挂合同 | M1、M11      | 商务、管理员      |
| **BP-02** | 合同起草、审批与生效          | 「卖什么」入台账   | M2、M10      | 商务、订单支持     |
| **BP-03** | 交付计划与交付完成           | 「可激活」前置    | M3、M2       | 交付          |
| **BP-04** | 授权需求与 SN 发放         | 合同→许可载体    | M4、M2、M3、M6 | License Ops |
| **BP-05** | 现场激活与状态回写           | 闭环到台账      | M4、比特、现场客户端 | 交付、Ops      |
| **BP-06** | 许可事件（Callback）入站与处置 | 不断链、可审计    | M5、M4、M8    | Ops、研发支撑    |
| **BP-07** | 合同变更与授权差异对齐         | 卖授一致       | M2、M4、M6、M9 | 商务、Ops      |
| **BP-08** | 设备登记、换机与重激活         | 终端合规       | M7、M5、M4    | 交付、Ops      |
| **BP-09** | 对账、异常工单与举证          | 管理降险       | M9、M8、M10   | 管理层、财务、合规   |
| **BP-10** | 授权集成配置发布            | 客户端可连比特    | M6、研发       | 架构、Ops      |
| **BP-11** | 账户开通、登录与权限变更        | 安全访问       | M11、M10     | 管理员、安全      |


---

## 3. 业务流程设计（详述）

### 3.1 BP-01 客户与项目准入

**目标**：任何合同必须挂在已存在且已校验的客户/项目下。

**步骤**：① 管理员维护字典（行业、区域等）→ ② 商务创建客户档案（必填项校验）→ ③ 创建项目并关联客户、干系人 → ④（可选）客户/项目冻结策略生效。

**输出物**：客户 ID、项目 ID；审计记录（M10-F01）。

**异常**：重复客户 → P2 合并流程（M1-F08）；权限不足 → M11 拦截。

---

### 3.2 BP-02 合同起草、审批与生效

**目标**：合同状态合法迁移，行项可支撑后续交付与 SN 绑定。

**状态机（逻辑）**：`草稿` → `待生效` → `生效`；`生效` → `变更中` → `生效（新版本）`；`生效` → `终止/到期`。

**步骤**：① 选客户与项目 → ② 录入合同头与 **合同行项**（SKU/数量/期限）→ ③（P1）附件上传 → ④ 商务/订单支持核对订单号关联（M2-F06）→ ⑤ 状态置为生效。

**输出物**：合同 ID、行项 ID；变更时版本号（M2-F07）。

**异常**：行项为空或金额/数量口径冲突 → 阻断生效；越权编辑 → 审计告警。

---

### 3.3 BP-03 交付计划与交付完成

**目标**：交付批次与清单与 **合同行** 对齐，标记「已交付」作为 SN 发放门禁（可配置）。

**步骤**：① 基于项目/合同创建交付批次 → ② 维护交付清单（产品实例、环境说明 P1）→ ③ 关联合同行项 → ④ 交付工程师确认完成（M3-F05）→ ⑤ 状态变为已交付。

**输出物**：交付批次 ID、完成时间。

**异常**：未关联合同行的交付项 → 警告或阻断（系统参数 M11-F20）。

---

### 3.4 BP-04 授权需求与 SN 发放

**目标**：从「生效合同 +（建议）已交付」生成许可需求，SN 绑定合同行/项目/客户。

**步骤**：① License Ops 查看授权需求清单（M4-F08，可与合同行汇总）→ ② 在比特控制台完成 SN/许可包操作（系统外）→ ③ 平台 **录入或导入 SN**（M4-F01）→ ④ **绑定** 合同行与客户/项目（M4-F02）→ ⑤ 状态：已发放 → 通知客户/交付（可手工，Mid 接 M8）。

**输出物**：SN 记录、绑定关系、发放时间。

**异常**：孤儿 SN（无绑定）→ 警告列表；与合同数量超额 → 规则校验（P1 增强）。

---

### 3.5 BP-05 现场激活与状态回写

**目标**：客户端经 **craftlabs-authorization-sdk** 与比特交互后，平台侧可见激活结果。

**步骤**：① 交付将 SN 与环境说明交付客户 → ② 现场部署并配置 `bitanswer.url` 等（BP-10 已发布配置）→ ③ 客户端激活 → ④ Ops **回写** 激活成功/失败及原因码（M4-F05）或接口同步（若建设）→ ⑤ 更新 SN 状态。

**输出物**：激活时间、状态、备注。

**异常**：长期未激活 → Mid 纳入报表 M9-F02；失败原因字典维护（M11-F19）。

---

### 3.6 BP-06 许可事件（Callback）入站与处置

**目标**：比特规则触发后 **HTTPS Callback** 不丢、可关联、可关闭。

**步骤**：① Webhook Ingress 验签/token → 快速 2xx → ② 落库事件（M5-F01～F04）→ ③ 解析 `sn` 尝试关联 SN/合同 → ④ Ops 处置（认领、备注、更新业务状态或建待办 M8）→ ⑤ 失败进重试/DLQ（Mid）。

**事件类型对齐**（参见 [bitanswer-licensing-design-and-rules.md](./bitanswer-licensing-design-and-rules.md)）：`sn:pre_activate` / `post_activate`、`device:pre_activate` / `post_activate`、`yunbaobao:session_logout` 等。

**异常**：无法解析关联 → 人工挂接；重复投递 → 幂等不重复改状态。

---

### 3.7 BP-07 合同变更与授权差异对齐

**目标**：合同变更后，**应授 vs 实授** 可对比、可出待办。

**步骤**：① 发起合同变更（M2-F07）→ ② 系统生成 **授权差异提示**（行项增减/延期）→ ③ Ops 在比特控制台调整并更新平台 SN/状态 → ④ 关闭变更单。

**输出物**：变更版本、操作记录（M10）。

**依赖**：Mid 报表 M9、映射 M2-F08 / M6。

---

### 3.8 BP-08 设备登记、换机与重激活

**目标**：`mid` 与 SN 关系清晰，换机与 `device:`* Callback 一致。

**步骤（Mid+）**：① 登记设备（M7-F01）→ ② 绑定 SN 历史（M7-F02）→ ③ 换机申请与记录（M7-F03）→ ④ 重激活后 Callback 更新台账。

**异常**：终端数超限 → 提示对齐比特策略（不替代控制台规则）。

---

### 3.9 BP-09 对账、异常工单与举证

**目标**：管理层/财务/合规可拉通 **合同—交付—SN—激活—Callback**。

**步骤（Mid+）**：① 打开对账视图（M9-F01～F03）→ ② 导出（权限控制 M9-F04）→ ③ 异常项生成待办（M8）→ ④ 合规按 M10 导出审计包（Full）。

---

### 3.10 BP-10 授权集成配置发布

**目标**：产品线、环境、`bitanswer.url`、特征映射与 JSON 模板 **版本化发布** 到现场可安装包或配置中心。

**步骤**：① M6 维护映射与模板 → ② Schema 校验（可与 CI 联动）→ ③ 发布记录（M6-F06）→ ④ 随产品发版或运维下发。

**依赖**：本仓库 `[schemas/craftlabs-auth-config.schema.json](../schemas/craftlabs-auth-config.schema.json)`。

---

### 3.11 BP-11 账户开通、登录与权限变更

**目标**：最小权限、会话可追溯、敏感操作可审计。

**步骤**：① 管理员创建用户并分配角色（M11-F14～F16）→ ② 用户登录/改密/登出（§12.1）→ ③ 角色变更写 M10/M11-F21。

**异常**：暴力破解 → 锁定（M11-F05）；人员离职 → 禁用与会话失效（M11-F12）。

---

## 4. 端到端泳道流程（主链路）

```mermaid
flowchart TB
  subgraph SALES[商务 / 订单支持]
    A1[BP-01 客户/项目]
    A2[BP-02 合同与行项]
  end

  subgraph DEL[交付]
    B1[BP-03 交付完成]
  end

  subgraph OPS[License Ops]
    C1[BP-04 SN 发放与绑定]
    C2[BP-06 Callback 处置]
    C3[BP-05 激活回写]
  end

  subgraph DEVOPS[架构 / 研发]
    D1[BP-10 配置发布]
    D2[Webhook 服务运维]
  end

  subgraph EDGE[客户现场 + 比特]
    E1[客户端 SDK 激活]
    E2[比特控制台 / 规则]
  end

  A1 --> A2 --> B1 --> C1
  D1 --> E1
  C1 --> E1
  E1 --> E2
  E2 -->|Callback| C2
  C2 --> C3
  B1 -.->|门禁| C1
```



---

## 5. 关键状态机汇总（产品规则）


| 对象          | 状态（节选）                    | 允许迁移（示例）                |
| ----------- | ------------------------- | ----------------------- |
| 合同          | 草稿 / 待生效 / 生效 / 变更中 / 终止  | 草稿→待生效→生效；生效→变更中→生效（新版） |
| 交付批次        | 未交付 / 部分 / 已交付            | 未交付→已交付（或经部分）           |
| SN          | 未发放 / 已发放 / 已激活 / 冻结 / 异常 | 未发放→已发放→已激活；任意→冻结（授权）   |
| Callback 事件 | 待处理 / 已处理 / 失败 / 忽略       | 待处理→已处理或失败→（重试）已处理      |
| 用户账号        | 启用 / 禁用                   | 启用↔禁用；禁用强制会话失效          |


详细字段级规则在 PRD/配置表（M11-F20）中展开。

---

## 6. 版本迭代总体规划（Roadmap）


| 版本       | 定位      | 对应产品包  | 目标上线（相对 T0）      | 核心验收                         |
| -------- | ------- | ------ | ---------------- | ---------------------------- |
| **V1.0** | MVP 可投产 | MVP    | **T0 + 10～12 周** | 主链路 BP-01～06、11 + 一条真实项目 UAT |
| **V1.1** | MVP 加固  | MVP+   | T0 + 14～16 周     | 性能、权限细项、生产监控                 |
| **V1.5** | Mid 第一波 | Mid 核心 | T0 + 18～22 周     | M7、M8、M9 主干 + BP-08 雏形       |
| **V1.6** | Mid 完成  | Mid    | T0 + 24～28 周     | 对账报表、Callback 运营台、SSO        |
| **V2.0** | Full 基线 | Full   | T0 + 34～42 周     | 变更治理、审计导出、MFA/数据范围等 P2       |


**说明**：若 **双迭代并行**（后端 Webhook 与业务 API 分队），V1.0 可压至 **8～10 周**，但需明确接口契约负责人。

---

## 7. 分迭代排期（Release Backlog）

> **三轨并行执行包**（后端双 JAR + 前端 Vue + 本仓 SDK）：见 [engineering/PARALLEL_ITERATION_INDEX.md](./engineering/PARALLEL_ITERATION_INDEX.md) 与 [tracks/01](./engineering/tracks/01-backend-platform-webhook.md)、[02](./engineering/tracks/02-frontend-platform-ui.md)、[03](./engineering/tracks/03-client-sdk.md)。

### 7.1 V1.0 MVP（建议 5～6 个迭代 × 2 周）


| 迭代     | 周期（相对）    | 目标产出                                             | 覆盖流程/模块                 |
| ------ | --------- | ------------------------------------------------ | ----------------------- |
| **I1** | T0～T0+2W  | 工程脚手架、CI、环境；M11 登录/登出/会话/审计登录；用户角色粗矩阵            | BP-11                   |
| **I2** | +2W～+4W   | M1 客户/项目全 P0；M11 字典、用户角色分配                       | BP-01                   |
| **I3** | +4W～+6W   | M2 合同与行项 P0 + 状态机；M10-F01                        | BP-02                   |
| **I4** | +6W～+8W   | M3 交付 P0；M4 SN P0（录入/绑定/状态/回写）                   | BP-03、BP-04、BP-05（手工回写） |
| **I5** | +8W～+10W  | M5 Callback 收件箱 P0；M6 环境与产品线 P0；**Webhook 服务联调** | BP-06、BP-10 最小          |
| **I6** | +10W～+12W | E2E 缺陷收敛；**UAT**；操作手册 v1；生产配置检查清单                | BP-01～06、11 全链路         |


**V1.0 必须验收用例**：任选 1 条真实或准生产项目，完成 **客户→合同→交付→SN→（模拟）激活→Callback 可见→台账一致**。

---

### 7.2 V1.1 加固（建议 2 迭代）


| 迭代     | 目标                          |
| ------ | --------------------------- |
| **I7** | 权限码拆到按钮级；导出与脱敏；接口限流与安全头     |
| **I8** | 生产观测仪表盘；备份恢复演练；SN/合同批量导入稳定性 |


---

### 7.3 V1.5～V1.6 Mid（建议 4～5 迭代）


| 迭代          | 目标产出                                   | 覆盖                |
| ----------- | -------------------------------------- | ----------------- |
| **I9**      | M7 设备与换机 P1；M5 失败标注与重试入口               | BP-08             |
| **I10**     | M8 待办 + 一种通知通道                         | BP-06、BP-09       |
| **I11**     | M9 对账与 Callback 统计 + 导出                | BP-09             |
| **I12**     | M11 SSO、并发会话、强制下线、密码重置；M2/M4/M6 P1 增强项 | BP-02、BP-04、BP-10 |
| **I13（可选）** | M2 变更版本与差异提示；UAT Mid                   | BP-07             |


---

### 7.4 V2.0 Full（建议 5～7 迭代）


| 主题     | 包含功能域                               |
| ------ | ----------------------------------- |
| 合规与审计  | M10-F03/F04；举证包；留存策略                |
| 安全     | M11 MFA、SECURITY_ADMIN、数据范围 M11-F17 |
| 集成与规模化 | M1 CRM 同步 P2；M6 影响分析；M9 订阅与经营看板     |
| 体验     | M8 模板与静默规则；可选客户只读门户（单独立项时移出）        |


---

## 8. 功能点 × 版本映射矩阵（摘要）

> 完整清单见 [chuangfei-platform-product-modules.md](./chuangfei-platform-product-modules.md) 各表 **优先级** 列；下表按 **版本** 聚合。


| 版本            | P0 全量                                               | P1 主要增量                        | P2 主要增量                       |
| ------------- | --------------------------------------------------- | ------------------------------ | ----------------------------- |
| **V1.0**      | 各模块标注 P0 的功能点 + M11 §12.1 F01～F07、§12.2 F14～F16、F19 | 不强制                            | 不含                            |
| **V1.1**      | —                                                   | 稳定性与权限细化、批量导入                  | —                             |
| **V1.5～V1.6** | —                                                   | 全部模块 P1 为主（M7、M8、M9、M11 SSO 等） | 少量 P2 可提前（按商务压力）              |
| **V2.0**      | —                                                   | 收尾 Mid 缺口                      | P2：MFA、安全管理员、数据范围、CRM、M10 导出等 |


---

## 9. 里程碑与依赖


| 里程碑                | 时间点（相对）   | 依赖                         |
| ------------------ | --------- | -------------------------- |
| M0 立项与范围冻结         | T0        | 本 Roadmap + 模块文档签字         |
| M1 α：可登录 + 主数据     | T0+4W     | 身份设计、测试环境                  |
| M2 β：合同+交付+SN      | T0+8W     | 法务字段定稿                     |
| M3 γ：Callback 联调通过 | T0+10W    | **比特控制台规则 URL**、公网 Ingress |
| M4 UAT 完成          | T0+12W    | 种子用户、脱敏数据                  |
| M5 生产首上            | T0+12～14W | 运维 SLA、密钥 KMS              |
| Mid GA             | T0+24～28W | SSO IdP、通知渠道账号             |
| Full GA            | T0+34～42W | 法务审计字段、财务口径                |


**外部强依赖**：比特安索控制台权限、Callback 出口网络、现场客户端发版窗口（与 BP-10 同步）。

---

## 10. 假设、风险与待办


| 类型     | 内容                                                               |
| ------ | ---------------------------------------------------------------- |
| **假设** | 单团队 2 周迭代；需求变更每周冻结；比特 API/控制台能力不降级                               |
| **风险** | Webhook 延期则 V1.0 砍为「仅收件箱+人工」，激活仍走 BP-05                          |
| **风险** | 合同字段反复 → I3 膨胀；建议首期 **法务一次评审**                                   |
| **待办** | 将本文迭代 **I1～I6** 导入 Jira/飞书 **Epic/Story**；为每条 BP 指定 **流程 Owner** |


---

## 11. 修订记录


| 日期         | 说明                                             |
| ---------- | ---------------------------------------------- |
| 2026-04-06 | 初版：工作区文档走查；BP-01～11 流程；泳道图；V1.0～V2.0 路线图与迭代排期。 |
| 2026-04-06 | §7 增加指向三轨并行执行文档（后端/前端/SDK）。 |