feat: add edu-industry platform demos

Co-authored-by: factory-droid[bot] <138933559+factory-droid[bot]@users.noreply.github.com>

docs/cross-platform-closed-loop.md

@@ -0,0 +1,126 @@
+# 厂商数据中台与校园平台闭环基线
+
+## 1. 目标
+
+两端产品使用同一组业务标识展示完整证据链，但职责和数据边界保持分离：
+
+- 厂商端负责数据源、采集、质量、数据产品发布、学校交付和交付回执；
+- 校园端负责学校接收、校内验收、分析快照、专业诊断、改进执行、报告审批和使用反馈；
+- 厂商默认不能读取学校明文业务数据，学校反馈只提交明确授权的汇总影响和脱敏证据。
+
+## 2. 共享样板场景
+
+| 实体 | 样板标识 | 主责端 |
+|---|---|---|
+| 演示场景 | `SCN-CLOSED-LOOP-001` | 两端 |
+| 学校租户 | `TENANT-HZVTC` | 平台租户服务 |
+| 数据产品版本 | `V2026.08.23` | 厂商端 |
+| 数据包 | `EDU-PKG-20260823-01` | 厂商端 |
+| 发布候选 | `REL-20260823-01` | 厂商端 |
+| 杭州租户数据文件 | `2,846,320` 条 / SHA-256 `4f8d91a47e2b6d82b2aaad136d344d61c83f9cd472185d2543725c91870e9e32` | 厂商端 |
+| 学校交付 | `DELIVERY-HZVTC-20260823-01` | 厂商端 |
+| 学校接收回执 | `RCT-HZVTC-20260823-01` | 校园端 |
+| 分析快照 | `SNP-HZVTC-20260824-01` | 校园端 |
+| 企业需求 | `DEM-HKVS-20260823-01` | 校园端/企业 |
+| 专业建议 | `REC-SOFTWARE-20260823-01` | 校园端 |
+| 改进任务 | `TSK-SOFTWARE-20260823-01` | 校园端 |
+| 协同项目 | `PRJ-HKVS-20260823-01` | 校园端 |
+| 执行证据 | `EVD-HKVS-01…` | 校园端 |
+| 企业评价 | `EVL-HKVS-20260823-01` | 企业 |
+| 报告版本 | `RPT-HZVTC-20260823-01` | 校园端 |
+| 使用反馈 | `FBK-EMP-01` | 校园端 |
+| 下一周期复核 | `RVW-SOFTWARE-2027C1-01` | 校园端 |
+
+每个共享对象必须携带 `tenant_id`、`trace_id`、状态、创建/更新时间、创建/修改人和关联对象标识。
+
+## 3. 状态边界
+
+### 厂商发布和学校接收必须分开
+
+```text
+ReleaseCandidate
+DRAFT → QUALITY_PASSED → AWAITING_APPROVAL
+→ APPROVED → PUBLISHED → ROLLED_BACK
+
+Delivery（每所学校独立）
+PENDING → SENDING → DELIVERED
+→ ACKNOWLEDGED | FAILED → RETRYING
+ACKNOWLEDGED → ROLLED_BACK
+```
+
+“数据包已发布”只表示厂商稳定版本已生成，不能直接显示“学校已收到”。厂商端只有 `FIX_REPLAY` 的记录数、规则结果和独立复核签名全部通过后才可解除质量门禁；`WAIVE`、`DISCARD` 保持阻断。学校回执中的租户、包号、版本、记录数、完整 SHA-256 和授权范围全部通过后，交付才能进入 `ACKNOWLEDGED`。
+
+交付记录数和学校分析快照样本量是不同口径：样板杭州租户文件为 `2,846,320` 条，校园端验收后生成 `128,642` 条有效分析快照，不能互相覆盖。
+
+### 校园业务闭环
+
+```text
+DeliveryReceipt
+PENDING → VERIFIED → ACCEPTED → ACTIVATED
+
+EnterpriseDemand
+SUBMITTED → RECEIVED → ANALYZED → RESPONDED → CLOSED
+
+Recommendation
+PENDING → ACCEPTED | DEFERRED | REJECTED
+
+ImprovementTask
+TODO → IN_PROGRESS → READY_FOR_REVIEW
+→ ACCEPTED | RETURNED → CLOSED
+
+ReportVersion
+DRAFT → REVIEWING → APPROVED | RETURNED
+APPROVED → PUBLISHED
+
+UsageReview
+BASELINE → FOLLOW_UP → IMPROVED | UNCHANGED | WORSENED
+```
+
+每次状态迁移都必须产生不可变审计事件，包含操作者、前后状态、时间、意见、证据和 `trace_id`。
+
+## 4. 静态原型的可信边界
+
+两个静态页面分别使用自己的浏览器本地状态，只用于刷新后继续当前页面的演示：
+
+- 厂商端本地状态不能让校园端自动变化；
+- 校园端本地状态不能让厂商端自动变化；
+- 页面必须明确“未连接后端，不代表另一端已实时收到”；
+- 两端相同的固定 ID 只用于人工核对业务链，不等于网络同步。
+
+需要展示真实跨页面交接时，使用可下载、可导入的文件：
+
+1. 厂商导出 Manifest 和交付信封 JSON；
+2. 学校导入后校验文件哈希与租户授权；
+3. 学校导出接收回执或脱敏反馈 JSON；
+4. 厂商导入回执/反馈后更新对应交付或处置状态。
+
+正式系统由 API、消息和 Outbox/Webhook 完成幂等交接，不使用浏览器本地存储同步业务状态。
+
+## 5. 正式服务边界
+
+| 服务 | 关键职责 |
+|---|---|
+| Data Product API | 数据包构建、质量门禁、审批、发布和回滚 |
+| Entitlement & Delivery API | 租户授权、逐学校交付、重试、撤回 |
+| Receipt API | 幂等接收回执、记录数和哈希校验 |
+| Campus Ingestion API | 学校暂存、质量校验、业务审批、激活和回滚 |
+| Analysis API | 基于不可变数据版本生成分析快照 |
+| Collaboration API | 需求、建议、项目、任务、证据、评价和验收 |
+| Report API | 报告版本、审批、发布、下载和证据引用 |
+| Feedback API | 学校反馈、厂商处置、学校复验和关闭 |
+| Audit & Notification | 统一追踪、不可篡改审计、通知和超时升级 |
+
+大文件只通过对象存储短期签名地址传递，业务 API 不直接承载数据包或附件正文。
+
+## 6. 验收黄金路径
+
+1. 厂商完成质量处置并创建 `REL-20260823-01`；
+2. 独立审批人批准后发布 `EDU-PKG-20260823-01`；
+3. 为三所学校创建彼此隔离的租户交付，重点核对 `TENANT-HZVTC` 的 `DELIVERY-HZVTC-20260823-01`；
+4. 学校校验租户、包号、版本、Manifest、记录数与完整 SHA-256，生成 `RCT-HZVTC-20260823-01`；
+5. 学校激活版本并生成 `SNP-HZVTC-20260824-01`；
+6. 企业需求进入专业诊断，建议被采纳并产生关联任务和项目；
+7. 执行人员提交证据，企业导师评价，校级管理者完成验收；
+8. 报告由不同于提交人的校级管理者审批并发布，所有结论反查同一快照和证据；
+9. 就业或业务部门记录使用反馈和下一周期指标；
+10. 两端以共享 ID 核对发布、交付、接收、使用和反馈链，正式环境再通过 API 自动同步。