edu-industry/demo/README.md

产教融智企业版前端

产教融智面向职业院校构建“产业信号、专业诊断、校企协同、改进任务、正式报告”一体化工作闭环。本目录是企业版产品前端基线，所有核心场景均可深入点击并形成可追踪的业务结果。

运行

直接双击 index.html 即可使用。为避免浏览器对本地文件的限制，也可以在本目录启动静态服务：

python3 -m http.server 8080

然后访问 http://localhost:8080。

核心产品能力

• 校级供需决策总览、周期切换、专业搜索和七步产品导览
• “企业需求 → 学校接收/分析快照 → 专业建议决策 → 任务/项目 → 执行证据 → 企业评价 → 校级验收 → 报告审批发布 → 数据使用反馈 → 下一周期复核”校园业务闭环
• 闭环实体、角色动作、审批历史与审计事件使用 localStorage 持久化，支持刷新续办、Schema 迁移和样板重置
• 技术接收同时强校验租户、包号、版本、交付记录数和完整 64 位 SHA-256；任一不一致只写失败审计，不推进回执或分析快照
• 交付包记录数与分析样本量分开保存：样板包回执为 2,846,320 条，生成的校园分析快照为 128,642 条
• 专业技能供需、岗位流向、薪资对标、课程技能映射与专业对比
• 企业需求响应、潜力伙伴对接、协同项目里程碑和验收证据
• 改进任务筛选、搜索、创建、阶段进展和报告建议转任务
• 数据源初次导入、增量更新、质量处置、版本管理、授权与审计
• 厂商基础数据包、校级数据、企业数据分类及授权状态筛选
• 校级管理者、校级技术管理员、学院负责人、专业负责人、就业老师、企业导师、厂商超级管理员七种差异化工作台
• 厂商平台级数据包导入、学校租户、账号权限、备份恢复和审计管理
• 校级、学院、专业、产业专题与数据质量报告中心
• 在线报告正文：封面、摘要、发现、供需分析、数据证据、指标口径和行动建议
• 报告内置 ECharts / ECharts-GL 可视化：仪表盘、三基准柱状图、雷达图、趋势面积图、热力图、环图、象限气泡图和立体证据矩阵
• 学校事实画像：在校生、毕业生、专业、教师、课程、合作企业、就业与实习指标均附证据编号、来源、更新时间、责任部门和计算口径
• 结论证据链：学校值、区域均值、同类院校均值、排名、样本量、数据权属、置信度和已知限制
• 报告类型、周期、关键词筛选、目录跳转、建议转任务、打印与离线 HTML 下载
• 本期分析生成与供需会材料包生成
• 供需会展示大屏及桌面端、平板、移动端自适应

数据资产分类

• 互联网基础数据包：由平台厂商合规归集、治理并按服务期导入，属于付费订阅数据。
• 校级数据：来自学校实习、就业、教务等业务系统，数据权属归学校。
• 企业数据：由合作企业确认提交，按照合作协议限定使用范围。

角色视角

• 校级管理者：全校决策总览、专业对比、校企协同、改进任务、数据资产与报告。
• 校级技术管理员：学校数据源、初次导入、更新任务、字段契约、质量问题、版本、授权与审计。
• 学院负责人：本院专业洞察、校企协同、改进任务与学院报告。
• 专业负责人：专业建议决策、关联任务与项目推进、执行证据和下一周期复核。
• 就业老师：就业侧数据使用确认和下一周期反馈；不能审批校级业务报告。
• 企业导师：企业人才需求、共建项目、学生参与和协同任务。
• 厂商超级管理员：平台数据包、学校租户、账号权限、备份恢复、服务监控与审计。

关键职责分离：

• 技术接收成功后当前企业需求版本锁定；后续变更必须创建新版本并重新接收；
• 当前报告一经生成，支撑该版本的任务证据冻结；新增证据必须进入下一周期或重开新版本；
• 阶段进度必须达到 100%，企业导师才能提交通过或整改评价；
• 企业评价为“需整改”时，校级验收继续阻断，补充证据并重新评价后才可进入验收；
• 报告提交人不能批准或退回自己的提交，非校级管理者不显示报告审批与发布动作；
• 报告正式发布前，就业老师不能登记使用反馈，下载和打印均明确标识非正式版。

界面正文基准字号为 14px，表格、按钮、业务标签和辅助信息不低于 13px，适合会议投屏和客户现场展示。

数据运维入口

• 厂商超级管理员在“平台运营中心 → 数据包管理”完成基础数据包导入、Schema 与质量校验、租户授权和版本发布。
• 校级技术管理员登录后默认进入“学校数据运维中心”，管理学校自有数据和企业授权数据。
• 每个数据源的“资产详情”包含业务截止日期、入库日期、下次更新、更新内容、主键、必填字段、格式、Schema、质量阈值、责任人与审计事件。
• “接收与使用反馈”展示租户、包号、版本、完整 SHA、交付包记录数、独立分析快照、支撑报告/项目/任务、业务可用确认和下一周期反馈。
• 更新采用“暂存 → 校验 → 审批 → 发布”流程。失败数据进入隔离区，不覆盖当前稳定版本。

详细角色权限、数据契约、初次导入要求、更新机制和未来后端实体设计见 ../docs/enterprise-product-baseline.md。

报告与离线运行

报告中心内置42份独立报告，包括32份专业人才需求报告、5份学院报告，以及校级、产业专题和数据质量报告。在线阅读支持章节目录、八类交互图表、学校事实证据、来源台账和行动建议；下载功能生成可独立归档、打开和打印的完整 HTML 报告。

在线图表使用 vendor/ 中本地化的 ECharts 5.6 与 ECharts-GL 2.0，无需 CDN。浏览器不支持图表运行时时自动显示静态 SVG 降级视图；下载报告直接内嵌全部图形和样式，不依赖外部脚本或网络。Apache-2.0、NOTICE 和 BSD-3-Clause 文件随库保存在 vendor/。

开发与验收说明

• 闭环样板使用命名空间 eduIndustry.campusClosedLoop.TENANT-HZVTC.v1，当前 schemaVersion=2。页面“重置样板”会恢复种子；旧 V1 或不满足深层实体/历史数组不变量的损坏 V2 状态，均按安全策略失效并重建 V2 种子。
• 为避免静态原型长期演示导致浏览器存储无界增长，审计、证据、反馈、自定义集合和实体历史采用明确保留上限；正式系统应改用服务端分页、归档和不可变审计存储。
• 共享样板标识为租户 TENANT-HZVTC、厂商包 EDU-PKG-20260823-01、版本 V2026.08.23、学校回执 RCT-HZVTC-20260823-01。这些标识只用于本静态原型的业务链对照，不表示厂商端和校园端页面实时同步。
• 当前前端不向外部服务发送请求，可直接在隔离网络运行。
• 仓库内数据用于本地产品验收，不包含任何真实学校、学生或企业敏感信息。
• localStorage 只用于原型演示，不是正式数据库、鉴权或审计设施。正式接入必须由后端 API 执行租户隔离、身份认证、逐对象授权、并发控制、不可抵赖审计、文件安全存储、字段脱敏、授权台账和备份恢复；前端按钮隐藏或禁用不能作为权限控制。
• JavaScript 语法检查：node --check app.js && node --check report-visuals.js
• 推荐桌面验收视口为 1440 × 900，移动验收视口为 390 × 844。

新增闭环预览：

• preview-campus-closed-loop.png
• preview-campus-closed-loop-mobile.png