lofyerandfactory-droid[bot] <138933559+factory-droid[bot]@users.noreply.github.com>
b9fbd4c6af
Co-authored-by: factory-droid[bot] <138933559+factory-droid[bot]@users.noreply.github.com>
139 lines
11 KiB
Markdown
139 lines
11 KiB
Markdown
# 产教融智企业版前端
|
||
|
||
产教融智供职业院校查看岗位变化、分析专业差距、安排企业合作、跟进改进任务并出具正式报告。本目录保存企业版产品前端样例。
|
||
|
||
## 运行
|
||
|
||
直接双击 `index.html` 即可使用。为避免浏览器对本地文件的限制，也可以在本目录启动静态服务：
|
||
|
||
```bash
|
||
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`](../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`
|