refactor: simplify product copy

Co-authored-by: factory-droid[bot] <138933559+factory-droid[bot]@users.noreply.github.com>
This commit is contained in:
lofyer
2026-08-25 11:37:59 +08:00
co-authored by factory-droid[bot] <138933559+factory-droid[bot]@users.noreply.github.com>
parent 248078113c
commit b9fbd4c6af
22 changed files with 364 additions and 362 deletions
+11 -11
View File
@@ -1,8 +1,8 @@
# 厂商数据中台与校园平台闭环基线
# 厂商数据中台与校园平台对接说明
## 1. 目标
两端产品使用同一组业务标识展示完整证据链,但职责和数据边界保持分离:
两端产品使用同一组业务标识核对记录,但各自负责不同的工作和数据:
- 厂商端负责数据源、采集、质量、数据产品发布、学校交付和交付回执;
- 校园端负责学校接收、校内验收、分析快照、专业诊断、改进执行、报告审批和使用反馈;
@@ -24,7 +24,7 @@
| 企业需求 | `DEM-HKVS-20260823-01` | 校园端/企业 |
| 专业建议 | `REC-SOFTWARE-20260823-01` | 校园端 |
| 改进任务 | `TSK-SOFTWARE-20260823-01` | 校园端 |
| 协同项目 | `PRJ-HKVS-20260823-01` | 校园端 |
| 合作项目 | `PRJ-HKVS-20260823-01` | 校园端 |
| 执行证据 | `EVD-HKVS-01…` | 校园端 |
| 企业评价 | `EVL-HKVS-20260823-01` | 企业 |
| 报告版本 | `RPT-HZVTC-20260823-01` | 校园端 |
@@ -48,11 +48,11 @@ PENDING → SENDING → DELIVERED
ACKNOWLEDGED → ROLLED_BACK
```
“数据包已发布”只表示厂商稳定版本已生成,不能直接显示“学校已收到”。厂商端只有 `FIX_REPLAY` 的记录数、规则结果和独立复核签名全部通过后才可解除质量门禁;`WAIVE`、`DISCARD` 保持阻断。学校回执中的租户、包号、版本、记录数、完整 SHA-256 和授权范围全部通过后,交付才能进入 `ACKNOWLEDGED`。
“数据包已发布”只表示厂商稳定版本已生成,不能直接显示“学校已收到”。厂商端只有 `FIX_REPLAY` 的记录数、规则结果和独立复核签名全部通过检查后才可继续发布;`WAIVE`、`DISCARD` 仍不能发布。学校回执中的租户、包号、版本、记录数、完整 SHA-256 和授权范围全部通过后,交付才能进入 `ACKNOWLEDGED`。
交付记录数和学校分析快照样本量是不同口径:样板杭州租户文件为 `2,846,320` 条,校园端验收后生成 `128,642` 条有效分析快照,不能互相覆盖。
### 校园业务闭环
### 校园业务流程
```text
DeliveryReceipt
@@ -78,7 +78,7 @@ BASELINE → FOLLOW_UP → IMPROVED | UNCHANGED | WORSENED
每次状态迁移都必须产生不可变审计事件,包含操作者、前后状态、时间、意见、证据和 `trace_id`。
## 4. 静态原型的可信边界
## 4. 静态原型能做什么
两个静态页面分别使用自己的浏览器本地状态,只用于刷新后继续当前页面的演示:
@@ -87,7 +87,7 @@ BASELINE → FOLLOW_UP → IMPROVED | UNCHANGED | WORSENED
- 页面必须明确“未连接后端,不代表另一端已实时收到”;
- 两端相同的固定 ID 只用于人工核对业务链,不等于网络同步。
需要展示真实跨页面交接时,使用可下载、可导入的文件:
需要展示两个页面之间的数据交接时,使用可下载、可导入的文件:
1. 厂商导出 Manifest 和交付信封 JSON;
2. 学校导入后校验文件哈希与租户授权;
@@ -100,19 +100,19 @@ BASELINE → FOLLOW_UP → IMPROVED | UNCHANGED | WORSENED
| 服务 | 关键职责 |
|---|---|
| Data Product API | 数据包构建、质量门禁、审批、发布和回滚 |
| Data Product API | 数据包生成、质量检查、审批、发布和回滚 |
| Entitlement & Delivery API | 租户授权、逐学校交付、重试、撤回 |
| Receipt API | 幂等接收回执、记录数和哈希校验 |
| Campus Ingestion API | 学校暂存、质量校验、业务审批、激活和回滚 |
| Analysis API | 基于不可变数据版本生成分析快照 |
| Analysis API | 使用不可修改的数据版本生成分析快照 |
| Collaboration API | 需求、建议、项目、任务、证据、评价和验收 |
| Report API | 报告版本、审批、发布、下载和证据引用 |
| Feedback API | 学校反馈、厂商处置、学校复验和关闭 |
| Audit & Notification | 统一追踪、不可篡改审计、通知和超时升级 |
大文件只通过对象存储短期签名地址传递,业务 API 不直接承载数据包或附件正文。
大文件只通过对象存储短期签名地址传递,业务 API 不直接传输数据包或附件正文。
## 6. 验收黄金路径
## 6. 验收顺序
1. 厂商完成质量处置并创建 `REL-20260823-01`;
2. 独立审批人批准后发布 `EDU-PKG-20260823-01`;