# 产教融智企业版产品与数据运维基线

## 1. 产品定位

产教融智供职业院校查看岗位变化和专业差距，安排企业合作，跟进改进任务并出具报告。数据分为外部岗位数据、学校业务数据和企业确认需求三类。

主要流程：

1. 数据接入与版本验收；
2. 产业岗位、技能和企业需求分析；
3. 学校、学院、专业多层诊断；
4. 课程、项目、企业合作和实习就业改进；
5. 任务责任、进度和验收证据管理；
6. 校级、学院、专业及专题报告交付；
7. 下一分析周期进行效果复核。

## 2. 角色、职责与入口

| 角色 | 默认入口 | 核心职责 | 数据边界 |
|---|---|---|---|
| 校级管理者 | 决策总览 | 查看全校供需态势、批准重点行动、协调学院与企业资源 | 可查看全校汇总和授权范围内明细 |
| 校级技术管理员 | 学校数据运维中心 | 接入学校数据源、执行更新、处理质量问题、管理版本与审计 | 可维护学校租户数据，不默认拥有业务审批权 |
| 学院负责人 | 专业分析 | 复核本院专业差距、推进课程和项目调整、提交阶段证据 | 仅本学院及所属专业 |
| 专业负责人 | 业务流程 | 决策专业建议、推进关联任务与项目、提交证据、完成下一周期复核 | 仅负责专业及其关联需求、项目和任务 |
| 就业老师 | 业务流程 | 确认就业侧数据可用性、记录使用反馈和下一周期关注项 | 就业业务域及授权汇总，不拥有校级报告审批权 |
| 企业导师 | 企业合作工作台 | 提交企业需求、参与项目和课程共建、确认企业评价 | 仅本企业授权及参与项目 |
| 厂商超级管理员 | 平台运营中心 | 维护基础数据包、租户、平台账号、备份、服务和平台审计 | 默认不可读取学校明文业务数据 |

### 2.1 职责分离

- 厂商负责公共基础数据包的采集、检查、Schema、版本、订阅授权和平台运行。
- 学校信息中心负责校内接口、文件接入、技术校验、调度、隔离区和版本发布。
- 教务处、就业处、产教融合中心等业务部门负责字段含义、数据正确性和发布审批。
- 企业联系人负责企业身份、需求内容、授权用途和有效期确认。
- 技术管理员可以执行更新，但不应代替业务责任人批准有争议的数据。
- 校级管理者负责任务校级验收以及业务报告的批准、退回和正式发布；校级技术管理员不得以数据质量职责代替业务审批。
- 专业负责人保存建议“采纳/暂缓/驳回”的理由、操作者和时间；企业导师只能评价本企业对象；就业老师只能记录就业侧使用反馈。

### 2.2 可交互业务流程图

校园端“业务流程”必须用节点和有向边表达业务办理顺序，而不是把状态平铺成卡片：

1. 企业需求；
2. 接收与分析快照；
3. 专业建议决策；
4. 改进任务；
5. 关联共育项目；
6. 执行证据；
7. 企业评价；
8. 校级验收；
9. 报告审批发布；
10. 业务使用反馈；
11. 成效复核。

节点必须直接读取正式业务实体和状态机，不得另建仅供可视化的第二套状态。每个节点至少展示状态、责任角色、输入、输出、关键字段和关联实体；点击节点可查看详情，在角色授权和前置条件均满足时可直接办理。

流程至少包含以下回流关系：

- 企业评价“需整改”回到执行证据；
- 校级验收“退回整改”回到执行证据，并要求企业重新评价；
- 成效复核“进入下一周期”回到新的企业需求版本。

桌面端展示完整拓扑与分支连线；移动端转换为保持顺序和状态的纵向节点流程，并以可点击关系卡保留三类回流，不得因隐藏 SVG 丢失分支语义。选择“进入下一周期”时必须完整归档上一周期报告实体及其证据、审批历史和关联 ID，按持久化周期序列生成不重复的新需求、新快照、新回执及下游实体 ID，并清空新周期尚未产生的任务、证据、评价、报告、反馈和复核。就业侧最新反馈为“需补充”时不得进入复核，周期关闭后不得追加反馈或重复复核。流程图中的按钮只是交互入口，正式权限仍必须由服务端逐对象校验。

## 3. 三类数据资产

### 3.1 厂商基础数据包

包括区域招聘岗位、薪资与企业画像、产业政策与趋势等公共数据产品。数据按学校订阅协议授权，平台统一维护版本和质量。

### 3.2 学校自有数据

包括专业、课程、学生、教师、实习、就业、校企合作项目等学校业务数据。数据权属归学校，厂商只按合同约定处理。

### 3.3 企业授权数据

包括岗位需求、技能要求、计划人数、企业评价、项目任务书和合作意向。必须绑定企业身份、授权编号、用途、可见范围和有效期。

## 4. 初次导入与更新契约

| 数据来源 | 初次导入内容 | 推荐格式/连接 | 主键 | 后续更新 | 业务责任人 | 技术责任人 |
|---|---|---|---|---|---|---|
| 区域招聘岗位基础包 | 当前服务区域内有效岗位、企业、地区、时间、薪资与来源 | Parquet / CSV UTF-8 | `package_id + source_record_id` | 月度增量，季度全量复核 | 厂商数据产品部 | 厂商数据运维组 |
| 薪资与企业画像基础包 | 岗位薪资区间、企业行业、规模和统计周期 | Parquet / CSV UTF-8 | `package_id + enterprise_id + position_code` | 月度增量 | 厂商数据产品部 | 厂商数据运维组 |
| 专业与课程数据 | 有效专业、课程、课程标准、教学班、学时、技能标签和版本 | XLSX / CSV / API | `tenant_id + course_code + curriculum_version` | 学期快照，变更事件增量 | 教务处 | 学校信息中心 |
| 实习数据 | 学生、专业、企业、岗位、起止日期、状态和评价 | API JSON / 数据库视图 | `tenant_id + internship_id` | 每日增量 | 就业处或实习管理部门 | 学校信息中心 |
| 就业数据 | 毕业届次、就业状态、岗位、企业、薪资和更新时间 | API JSON / 数据库视图 | `tenant_id + student_id + cohort` | 每日增量，关键统计期内快照不再修改 | 就业处 | 学校信息中心 |
| 企业确认需求 | 企业身份、岗位、人数、技能、有效期、提交人、确认时间和授权编号 | 工作台表单 / API / XLSX | `tenant_id + enterprise_credit_code + demand_id` | 企业提交后事件增量 | 产教融合中心与企业联系人 | 学校信息中心 |

### 4.1 所有来源必须提供

- 数据名称、业务说明、覆盖范围和业务截止日期；
- 数据提供方、业务责任人和技术责任人；
- 文件编码、字段类型、日期格式和枚举字典；
- 主键、增量水位字段、幂等键和删除标识；
- 必填字段、敏感字段、脱敏规则和授权范围；
- Schema 版本、数据版本、变更说明和样例数据；
- 质量阈值、失败处理、回滚要求和留存期限。

### 4.2 建议的最低质量要求

- 主键唯一率：100%；
- 核心代码合法率：100%；
- 必填完整率：不低于95%；
- 关键跨表关联率：不低于98%；
- 日期、地区、薪资等业务规则合法率：不低于98%；
- 厂商基础数据包综合质量评分：不低于90；
- 企业身份与授权关联率：100%。

未达到阻断阈值的数据不得进入生产分析快照。

### 4.3 数据与报告双向依赖

每个报告模板必须登记版本化的数据依赖，不能只把依赖写在报告生成代码中。依赖至少包含：

- 报告模板、报告类型和适用组织范围；
- 数据源、数据契约和最低版本；
- `required`（必需）或 `optional`（可选增强）关系；
- 使用该数据的指标或分析主题；
- 最低完整率、质量阈值、时效与授权要求；
- 缺失字段、降权或阻断策略；
- 业务索取人、技术接口人、要求完成日期和处理状态。

产品提供两个方向的查询：

1. 从报告反查必需和可选数据，计算当前完备度并列出缺口；
2. 从数据反查可做的分析、使用该数据的报告类型、具体报告和影响范围。

依赖信息供数据检查和跨部门补数据时使用，可向有数据运维权限的角色开放；报告正文、明细指标和样本仍按组织、角色与数据范围单独授权。查看依赖关系不会自动获得报告阅读权限。

## 5. 导入与发布流程

### 5.1 初次导入

1. 创建数据源并选择文件、API、数据库视图或SFTP；
2. 上传数据说明、Schema、代码字典和样例；
3. 完成字段映射、主键和敏感字段确认；
4. 在暂存区执行结构、完整性、唯一性、关联性和业务规则校验；
5. 生成质量报告和错误明细；
6. 技术管理员修复或隔离异常，业务责任人复核；
7. 审批通过后发布首个稳定版本；
8. 保存文件哈希、操作者、审批人、发布时间和追踪编号。

### 5.2 后续更新

- 每次任务记录上次成功水位、本次截止日期、版本和变更摘要；
- 增量数据必须支持幂等写入，不因重试产生重复记录；
- 删除采用失效标识或版本化软删除，避免历史报告失去证据；
- 单一来源失败时可隔离该来源，其他来源按策略继续；
- 新版本未验收前，线上分析继续引用当前稳定版本；
- 发布后生成统一分析快照，报告和大屏只引用快照，不直接读取变化中的源表。

## 6. 版本、证据与审计

每个分析结论至少关联：

- 数据快照编号；
- 来源数据版本；
- 指标定义与计算规则版本；
- 样本量、过滤规则和缺失处理；
- 学校值、区域均值、同类院校均值和可比排名；
- 数据权属、授权范围和置信度；
- 已知限制与业务复核状态。

导入、导出、报告下载、授权变更、质量放行和版本发布必须记录操作者、时间戳、对象、前后版本哈希、结果和追踪编号。

## 7. 正式开发核心实体

建议后端至少包含以下实体：

- `Tenant`、`Organization`、`User`、`Role`、`DataScope`;
- `DataSource`、`DataContract`、`SchemaVersion`、`ImportJob`;
- `DataVersion`、`QualityRule`、`QualityIssue`、`Authorization`;
- `AnalysisSnapshot`、`MetricDefinition`、`AnalysisTopic`、`EvidenceReference`;
- `ReportDataDependency`、`DataRequest`、`DataRequestAssignment`;
- `Program`、`Course`、`Skill`、`JobSignal`、`EnterpriseDemand`;
- `CollaborationProject`、`ImprovementTask`、`Milestone`、`AcceptanceEvidence`;
- `ReportTemplate`、`ReportVersion`、`AuditEvent`.
- `EnterpriseEvaluation`、`SchoolAcceptance`、`DataUsageFeedback`、`CycleReview`.

所有业务实体应包含 `tenant_id`、创建/更新时间、创建/修改人和版本字段。涉及学校明细数据的查询必须同时校验租户、角色和数据范围。

### 7.1 静态原型持久化与正式 API 边界

校园业务流程静态原型采用 `localStorage` 命名空间 `eduIndustry.campusClosedLoop.TENANT-HZVTC.v1`，当前 `schemaVersion=2`，包含安全迁移、可重置种子、流程实体和 `auditEvents`。共享样板标识固定为：

- 租户：`TENANT-HZVTC`；
- 厂商包：`EDU-PKG-20260823-01`；
- 包版本：`V2026.08.23`；
- 杭州租户交付记录数：`2,846,320`；
- 杭州租户数据文件 SHA-256：`4f8d91a47e2b6d82b2aaad136d344d61c83f9cd472185d2543725c91870e9e32`；
- 学校回执：`RCT-HZVTC-20260823-01`；
- 分析快照：`SNP-HZVTC-20260824-01`，分析有效样本 `128,642` 条。

这些标识用于静态页面之间核对同一业务样板，不代表厂商端与校园端实时同步。`localStorage` 也不具备正式数据一致性、安全存储、多人协作或不可抵赖审计能力。

技术接收必须对租户、包号、版本、记录数和完整 SHA-256 执行强一致性校验。任一失败时回执、分析快照和业务状态均不得前进，只能追加失败审计。交付包记录数不能覆盖分析快照样本量，两者必须作为不同口径分别保存。

正式系统必须将状态流转放在后端事务/API 中：服务端依据租户、组织、角色、数据范围、对象所属企业和当前状态校验每个命令；采用幂等键和版本号校验防止重复或越序流转；证据文件保存到限制访问的对象存储，并进行病毒扫描、哈希校验和访问授权；审计日志只允许追加，不可由业务用户修改。前端菜单、按钮隐藏和 `disabled` 仅用于交互提示，不能替代服务端鉴权。

## 8. 产品验收基线

- 七种角色默认入口和菜单范围正确；
- 业务流程图完整显示 11 个节点、主路径和三类回流边，节点选择会联动输入、输出、责任角色、关键字段和关联实体；
- 业务流程按企业导师、校级技术管理员、专业负责人、学院负责人、校级管理者和就业老师显示可办理节点与禁用原因，厂商超级管理员只读；
- 当前角色可从满足条件的节点直接打开原有业务表单，节点状态推进后流程图、详情、角色待办和审计同步更新；
- 流程状态、审批历史和审计事件刷新后保留，重置后恢复 Schema V2 种子；
- 技术接收后不能修改当前企业需求，报告生成后不能再给当前任务追加证据；
- 损坏的 V2 深层实体或历史数组不会导致页面崩溃，而是按安全策略重建并记录 `SECURITY_SCHEMA_RESET`；
- 租户、包号、版本、交付记录数或 SHA-256 任一错误时，技术接收和分析快照均保持原状态；
- 阶段进度未达到 100% 时不能企业评价，企业评价缺失或为“需整改”时任务不能校级验收；
- 报告提交人与审批人必须分离，非校级管理者不能审批发布；报告未批准时不能发布，未正式发布时反馈阻断且下载明确标识非正式版；
- 专业四个标签页均有完整内容和证据入口；
- 数据源可查看更新日期、更新内容、数据要求、版本任务和授权审计；
- 42 份报告均可反查必需和可选数据，6 个数据源均可反查相关分析主题与使用它的报告；
- 缺口视图展示缺失字段、完整率、影响报告、业务索取人、技术接口人、完成日期与状态，并可进入质量处置；
- 依赖元数据可见性与报告正文权限分离，未授权角色不能从图谱绕过报告阅读权限；
- 新建任务、项目和需求后立即进入对应列表；
- 报告建议加入任务后可在任务中心追踪；
- 报告生成后新增可审核版本；
- 报告包含八类图表、学校数据、四类数据来源和七章正文；
- ECharts 不可用时显示静态 SVG；
- 离线报告无外部依赖；
- 桌面 `1440 × 900` 和移动 `390 × 844` 无页面级横向溢出；
- 可见业务文字不小于13px，重点证据不小于14px；
- 所有用户可见文案按企业产品口径表达。

## 9. 推荐客户展示路径

1. 产品导览说明“看得清、落得下、讲得明”；
2. 决策总览展示数据来源和本期变化；
3. 专业分析展示岗位、薪资、课程和技能证据；
4. 校企合作展示企业需求到项目验收；
5. 在业务流程图依次点击需求、快照、建议、任务、项目、证据、评价、验收、报告、反馈和复核节点，并切换角色验证办理与回流；
6. 改进任务展示负责人、进度和验收证据；
7. 在数据资产页双向演示“报告需要哪些数据”和“哪些报告使用这些数据”，切换只看缺口并进入补数责任处置；
8. 切换校级技术管理员，展示数据导入、更新、质量、接收反馈和审计；
9. 打开全校报告和供需会展示大屏完成交付说明。