Archived
xcsandClaude Fable 5
bd86dd6088
活动包 views/target-style.ts / report.ts 与两份 W05 文档都指着 docs/SS02-ACT-WORK-05-html —— 模版「逐字节搬自目标件」的那份目标件此前没入库。docs/img/cy 三张 png 现无引用,随批入库。 Co-Authored-By: Claude Fable 5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_0167qWjeyBwvfdGovd7FWbCu
47 lines
5.3 KiB
Markdown
47 lines
5.3 KiB
Markdown
# ACT-WORK-05 差异评估 — 一键启动入参说明（运营端）
|
||
|
||
> 本文档与《SS02-SS03-SS04_Demo台账字段细化与统一方案》字段口径一致（统一字段名、编号归并、主记录/子表结构均按该方案 4.2 节与第五节执行）。
|
||
|
||
## 一、背景
|
||
|
||
ACT-WORK-05 差异评估平时由上游触发：ACT-WORK-03 检索调用，或 ACT-GATE-02 路径判定后进入。
|
||
|
||
**本文档是运营端一键启动功能的入参规格**：表单在独立运营端完成，参数在启动时填好传入，系统据此直接启动活动（人工扮演上游，把进入条件变成表单）。
|
||
|
||
**极简原则（2026-08-26 定）**：一键启动只收 **4 个参数** —— 客户、客户需求、原 PN、替代 PN（数组）。**启动不等资料**：应用场景、BOM 位、替代类型、datasheet、需求版本调整等一切其余信息，都在活动启动后、执行过程中由工作台的数据工单逐项补齐（数据工单一单一类可多条，确认即入库，活动从断点续跑）。
|
||
|
||
**渠道无感知原则**：活动与工单对触发渠道无感知——上游触发（ACT-WORK-03 / ACT-GATE-02）传入的字段集与本规格完全一致（同样 4 项）。运营端按本规格传参，活动按进入条件消费，不记录渠道；仅 `source_type=手动启动` 在运营端留痕，供 ACT-GATE-03 评审放行时追溯。
|
||
|
||
## 二、入参总表
|
||
|
||
一键启动的全部参数，就这四行：
|
||
|
||
| 中文字段 | 统一字段名 | 必填性 | 输入方式 | 默认值 | 说明 |
|
||
|---|---|---|---|---|---|
|
||
| 客户 | customer_id | 必填 | L-02 选择器 | — | 新建 P-01 需求时挂客户 ID；决定通知对象与默认负责人线。 |
|
||
| 客户需求 | request_description | 必填 | 文本 | — | 保留原始需求语义；据此新建 P-01 需求主记录（版本 V1）。 |
|
||
| 原内部料号 | original_internal_pn | 必填 | P-08 选择器 | — | 差异评估基准，引用 P-08.internal_pn。 |
|
||
| 候选内部料号 | candidate_internal_pn[] | 必填（**数组，≥1**） | P-08 选择器（**多选**） | — | 被评估物料，**一次可传多个**，逐个评估、逐个做存在性检查；P-08 无记录不拦启动——启动后按存在性检查逐个派数据工单创建（候选 ≥2 也可选择放弃，记录放弃原因）。 |
|
||
|
||
**系统带出 / 默认值**（不在表单上出现，启动时自动落）：需求版本 V1、替代类型 Pin-to-Pin、规则版本当前发布版 R-2026.07（as_of 锁定，随结论落账）、期限 1 个工作日、负责人（PW）与审核（FAE）按客户线默认、`source_type=手动启动`。以上任何一项要改，都在启动后的工单里改，不回表单。
|
||
|
||
## 三、点击启动后系统行为
|
||
|
||
1. 生成任务号（如 TASK-BT02-20260818-007）；
|
||
2. 新建 P-01 需求主记录（V1）：客户 ID + 需求描述落账，绑定原 PN 与候选 PN 数组；
|
||
3. **存在性检查**（按 internal_pn 查 P-08 等台账，候选数组逐个查）：原 PN 无数据 → 硬阻塞，派数据工单，活动停「等待数据」；候选 PN 无数据 → 候选 ≥2 可放弃【记录放弃原因】或派数据工单创建，候选 =1 必须创建；数据工单**确认即入库**（确认人=责任人留痕）后活动自动唤醒。**启动时的存在性检查只是惰性触发的第一次**——活动执行中每次读台账仍可能派发新数据工单（一单一类可多条，D02、D03…，全部确认后从断点续跑）；
|
||
4. 生成输入快照 input_snapshot_ref（活动自持中间产物，支持版本回溯）；
|
||
5. 进入步骤 1 · 建立评估上下文，派执行工单 01——启动传入的 4 项只读核对，**未齐资料全部在工单里补**：应用场景、BOM 位、替代类型确认、需求版本调整等缺口字段，PW 在工作台逐项填写，不回流表单。
|
||
|
||
## 四、极简参数集
|
||
|
||
手工必给的只有 4 个：**客户、客户需求、原 PN、候选 PN（数组）** —— 这就是一键启动的全部入参，没有第二张表。
|
||
|
||
设计意图：**启动的门槛越低，活动跑得越早**；资料不齐不该拦启动，缺口在执行中由数据工单追着人补，而不是在表单里追着人填。数据工单里 datasheet 选填（传了 AI 预填，没传全手填），同样不拦流程。
|
||
|
||
## 五、与现有工单的衔接
|
||
|
||
执行工单 01 的「评估输入清单」（`in.evaluation_inputs`）中，启动传入的 4 项回显为「已绑定 / 已锁定」的灰底只读行：客户、客户需求（及其新建的 P-01 需求与版本 V1）、原 PN、候选 PN（数组逐行）；其余行（应用场景、BOM 位、替代类型、规则版本确认、负责人/期限调整等）为 PW 补缺口的可编辑行。**启动参数如有误，须退回启动人在运营端修订后重新启动，工单内不可改**。工单不展示、也不区分触发渠道——上游触发传入同一字段集时，呈现与本表单回显完全相同。
|
||
|
||
PN 不在库时派发的**数据工单**（`in.create_p08_fields` / `in.create_p08_params`）：datasheet 在**数据工单里**上传（选填）——传了则 AI 预填字段与参数集（示例 8 项字段 + 7 行参数），没传则人全填；人在对话区【数据卡】确认即正式入库，确认人=数据责任人并留痕，入库后活动自动唤醒进步骤 1。
|