edu-industry/docs/enterprise-product-baseline.md

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

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. 打开全校报告和供需会展示大屏完成交付说明。