lofyerandfactory-droid[bot] <138933559+factory-droid[bot]@users.noreply.github.com>
8dff9847e3
- add authorized nine-source crawler connectors with security controls and packaged schemas - add the school internship contract to the vendor data standard center - add bidirectional campus data-to-report lineage with gap ownership and remediation Co-authored-by: factory-droid[bot] <138933559+factory-droid[bot]@users.noreply.github.com>
122 lines
9.6 KiB
Markdown
122 lines
9.6 KiB
Markdown
# 产教融智企业版前端
|
||
|
||
产教融智面向职业院校构建“产业信号、专业诊断、校企协同、改进任务、正式报告”一体化工作闭环。本目录是企业版产品前端基线，所有核心场景均可深入点击并形成可追踪的业务结果。
|
||
|
||
## 运行
|
||
|
||
直接双击 `index.html` 即可使用。为避免浏览器对本地文件的限制，也可以在本目录启动静态服务：
|
||
|
||
```bash
|
||
python3 -m http.server 8080
|
||
```
|
||
|
||
然后访问 <http://localhost:8080>。
|
||
|
||
## 核心产品能力
|
||
|
||
- 校级供需决策总览、周期切换、专业搜索和七步产品导览
|
||
- “企业需求 → 学校接收/分析快照 → 专业建议决策 → 任务/项目 → 执行证据 → 企业评价 → 校级验收 → 报告审批发布 → 数据使用反馈 → 下一周期复核”校园业务闭环
|
||
- 闭环实体、角色动作、审批历史与审计事件使用 `localStorage` 持久化，支持刷新续办、Schema 迁移和样板重置
|
||
- 技术接收同时强校验租户、包号、版本、交付记录数和完整 64 位 SHA-256；任一不一致只写失败审计，不推进回执或分析快照
|
||
- 交付包记录数与分析样本量分开保存：样板包回执为 `2,846,320` 条，生成的校园分析快照为 `128,642` 条
|
||
- 专业技能供需、岗位流向、薪资对标、课程技能映射与专业对比
|
||
- 企业需求响应、潜力伙伴对接、协同项目里程碑和验收证据
|
||
- 改进任务筛选、搜索、创建、阶段进展和报告建议转任务
|
||
- 数据源初次导入、增量更新、质量处置、版本管理、授权与审计
|
||
- 厂商基础数据包、校级数据、企业数据分类及授权状态筛选
|
||
- 覆盖 6 个数据源和 42 份报告的“数据 → 指标/分析主题 → 报告”双向依赖图谱，支持只看缺口
|
||
- 报告缺失字段、当前完整率、影响范围、业务索取人、技术接口人和要求完成日期一体化追踪
|
||
- 校级管理者、校级技术管理员、学院负责人、专业负责人、就业老师、企业导师、厂商超级管理员七种差异化工作台
|
||
- 厂商平台级数据包导入、学校租户、账号权限、备份恢复和审计管理
|
||
- 校级、学院、专业、产业专题与数据质量报告中心
|
||
- 在线报告正文：封面、摘要、发现、供需分析、数据证据、指标口径和行动建议
|
||
- 报告内置 ECharts / ECharts-GL 可视化：仪表盘、三基准柱状图、雷达图、趋势面积图、热力图、环图、象限气泡图和立体证据矩阵
|
||
- 学校事实画像：在校生、毕业生、专业、教师、课程、合作企业、就业与实习指标均附证据编号、来源、更新时间、责任部门和计算口径
|
||
- 结论证据链：学校值、区域均值、同类院校均值、排名、样本量、数据权属、置信度和已知限制
|
||
- 报告类型、周期、关键词筛选、目录跳转、建议转任务、打印与离线 HTML 下载
|
||
- 本期分析生成与供需会材料包生成
|
||
- 供需会展示大屏及桌面端、平板、移动端自适应
|
||
|
||
## 数据资产分类
|
||
|
||
- **互联网基础数据包**：由平台厂商合规归集、治理并按服务期导入，属于付费订阅数据。
|
||
- **校级数据**：来自学校实习、就业、教务等业务系统，数据权属归学校。
|
||
- **企业数据**：由合作企业确认提交，按照合作协议限定使用范围。
|
||
|
||
## 数据与报告依赖图谱
|
||
|
||
“数据资产”页提供两种追溯方向：
|
||
|
||
- **从报告看数据**：选择任一校级、学院、专业、产业专题或数据质量报告，查看必需数据、可选增强数据、分析主题、当前完备度和缺口。
|
||
- **从数据看报告**：选择任一数据源，查看可形成的分析主题、支撑的报告类型和具体报告数量。
|
||
- **只看缺口**：仅保留存在质量或字段问题的依赖关系，快速定位不能稳定支撑报告的数据。
|
||
|
||
当前样板将 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-closed-loop.png`
|
||
- `preview-campus-closed-loop-mobile.png`
|
||
|
||
数据依赖图谱预览：
|
||
|
||
- `preview-data-report-lineage.png`
|