Files
edu-industry/demo
lofyerandfactory-droid[bot] <138933559+factory-droid[bot]@users.noreply.github.com> 248078113c feat: add interactive campus workflow graph
Co-authored-by: factory-droid[bot] <138933559+factory-droid[bot]@users.noreply.github.com>
2026-08-24 20:15:38 +08:00
..

产教融智企业版前端

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

运行

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

python3 -m http.server 8080

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

核心产品能力

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

数据资产分类

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

可交互业务流程图

“业务流程”不是状态卡片列表,而是由节点和有向边构成的可操作流程:

  • 11 个节点分别对应企业需求、分析快照、专业建议、任务、项目、证据、企业评价、校级验收、报告、使用反馈和成效复核;
  • 节点状态分为已完成、当前待办、退回/整改和前置未满足,流程完成度与当前责任角色实时计算;
  • 点击任一节点可查看节点输入、节点输出、关键字段、责任角色和关联实体;
  • 当前角色具备权限且前置条件满足时,可在节点详情直接办理;无权限时显示责任边界而非伪造可用按钮;
  • 企业评价需整改、校级验收退回和进入下一周期均使用独立回流边表达;
  • 桌面端显示完整流程拓扑,移动端转换为带连接线的纵向节点流程,并用三张可点击关系卡保留整改、退回与下一周期回流;
  • “进入下一周期”会归档上一周期报告,创建带 previousVersionId 的新需求、快照和回执版本,并清空新周期尚未产生的下游实体。

流程图只负责展示并调用现有状态机,不维护第二套演示状态。因此原有租户、SHA、记录数、证据冻结、独立审批和角色授权规则继续生效。

数据与报告依赖图谱

“数据资产”页提供两种追溯方向:

  • 从报告看数据:选择任一校级、学院、专业、产业专题或数据质量报告,查看必需数据、可选增强数据、分析主题、当前完备度和缺口。
  • 从数据看报告:选择任一数据源,查看可形成的分析主题、支撑的报告类型和具体报告数量。
  • 只看缺口:仅保留存在质量或字段问题的依赖关系,快速定位不能稳定支撑报告的数据。

当前样板将 42 份报告映射到 6 个数据源,并以版本化依赖模板区分必需与可选关系。每个缺口展示:

  • 缺失或待核验字段;
  • 当前记录影响量、完整率和处理状态;
  • 业务索取人及所属部门;
  • 技术接口人及所属技术部门;
  • 要求完成日期和受影响报告数;
  • 可直接进入现有质量处置抽屉的操作入口。

依赖元数据用于跨部门补数协同,可以在数据运维角色下查看;报告正文仍按现有角色与数据范围授权,查看依赖关系不自动获得报告阅读权限。静态样板中的依赖、完整率和责任状态均为演示数据,正式系统应将 ReportDataDependency、AnalysisTopic 和 DataRequest 作为租户隔离、版本化、可审计的后端实体。

角色视角

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

关键职责分离:

  • 技术接收成功后当前企业需求版本锁定;后续变更必须创建新版本并重新接收;
  • 当前报告一经生成,支撑该版本的任务证据冻结;新增证据必须进入下一周期或重开新版本;
  • 阶段进度必须达到 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-workflow.png
  • preview-campus-workflow-mobile.png

数据依赖图谱预览:

  • preview-data-report-lineage.png