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

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

1. 产品定位

产教融智不是单一数据看板，而是面向职业院校的供需分析与产教协同工作平台。产品将外部产业信号、学校培养事实和企业确认需求分层治理，并把分析结论转化为可执行、可验收、可复核的改进任务。

核心闭环：

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

2. 角色、职责与入口

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

2.1 职责分离

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

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%。

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

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、EvidenceReference;
• 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. 产品验收基线

• 七种角色默认入口和菜单范围正确；
• 闭环工作台按企业导师、校级技术管理员、专业负责人、学院负责人、校级管理者和就业老师显示可执行动作与禁用原因，厂商超级管理员只读；
• 闭环状态、审批历史和审计事件刷新后保留，重置后恢复 Schema V2 种子；
• 技术接收后当前企业需求版本锁定，报告生成后当前任务证据冻结；
• 损坏的 V2 深层实体或历史数组不会导致页面崩溃，而是按安全策略重建并记录 SECURITY_SCHEMA_RESET；
• 租户、包号、版本、交付记录数或 SHA-256 任一错误时，技术接收和分析快照均保持原状态；
• 阶段进度未达到 100% 时不能企业评价，企业评价缺失或为“需整改”时任务不能校级验收；
• 报告提交人与审批人必须分离，非校级管理者不能审批发布；报告未批准时不能发布，未正式发布时反馈阻断且下载明确标识非正式版；
• 专业四个标签页均有完整内容和证据入口；
• 数据源可查看更新日期、更新内容、数据要求、版本任务和授权审计；
• 新建任务、项目和需求后立即进入对应列表；
• 报告建议加入任务后可在任务中心追踪；
• 报告生成后新增可审核版本；
• 报告包含八类图表、学校事实、四类证据源和七章正文；
• ECharts 不可用时显示静态 SVG；
• 离线报告无外部依赖；
• 桌面 1440 × 900 和移动 390 × 844 无页面级横向溢出；
• 可见业务文字不小于13px，重点证据不小于14px；
• 所有用户可见文案按企业产品口径表达。

9. 推荐客户展示路径

1. 产品导览说明“看得清、落得下、讲得明”；
2. 决策总览展示可信数据和本期关键变化；
3. 专业洞察展示岗位、薪资、课程和技能证据；
4. 校企协同展示企业需求到项目验收；
5. 闭环工作台依次切换企业导师、技术管理员、专业负责人、校级管理者和就业老师验证状态流；
6. 改进任务展示负责人、进度和验收证据；
7. 切换校级技术管理员，展示数据导入、更新、质量、接收反馈和审计；
8. 打开全校报告和供需会展示大屏完成交付说明。