迪诺学堂标识

07-远程巡课中心详细PRD

PAT · 接入存量千台级教室摄像头,支持海康威视、宇视两类已有视频平台设备,支撑地图监控、在线巡课、录像回放、督课任务、教学质量评分和课堂质检闭环。

系统 迪诺学堂
版本 v1.0
日期 2026-06-23
阶段 模块详细 PRD

01 · 模块定位

远程巡课中心

总部可在地图中定位校区和教室摄像头,打开直播或回放,完成督课记录、教学质量评分并生成整改任务。 每个摄像头均可追溯到校区、教室、视频平台、网关和录像策略,地图监控可从校区下钻到教室设备。 回放下载能力需区分供应商:海康支持原生回放查看与录播下载;宇视需先拖动到指定时间戳并录制片段,片段完成后才可回放和下载。

业务目标

接入存量千台级教室摄像头,支持海康威视、宇视两类已有视频平台设备,支撑地图监控、在线巡课、录像回放、督课任务、教学质量评分和课堂质检闭环。

使用终端

PC Web 地图监控、直播墙、录像回放和督课评分工作台;教室摄像头必须绑定指定校区的指定教室。

验收主线

总部可在地图中定位校区和教室摄像头,打开直播或回放,完成督课记录、教学质量评分并生成整改任务。 每个摄像头均可追溯到校区、教室、视频平台、网关和录像策略,地图监控可从校区下钻到教室设备。 回放下载能力需区分供应商:海康支持原生回放查看与录播下载;宇视需先拖动到指定时间戳并录制片段,片段完成后才可回放和下载。

02 · 范围边界

明确本模块负责什么、依赖什么、不负责什么

边界清晰后,原型、接口和数据库设计才能避免重复建设。

模块内范围

  • 摄像头台账
  • 地图监控
  • 视频直播墙
  • 录像回放
  • 督课任务
  • 课堂评价
  • 教学质量评分
  • 异常整改
  • 设备维修工单
  • 设备恢复校验
  • 督课评分规则版本
  • 摄像头教室绑定
  • 按教室下钻监控
  • 教室设备清单
  • 回放能力策略配置
  • 海康回放下载
  • 宇视时间戳录制下载
  • 片段录制任务队列

上游依赖

  • 组织校区与账号权限
  • 课程/客户/合同等主数据
  • 审批流、消息模板、文件中心
  • 必要的第三方接口密钥

下游输出

  • 业务状态和待办
  • 消息通知和审批记录
  • 报表指标和数据快照
  • 审计日志和接口回执

03 · 确认口径、后台配置与默认实施规则

远程巡课中心必须承接的已确认规则

本章节来自待决策与澄清清单的收口结果,已经转为本模块 PRD 的正式需求、配置项或默认实施规则。
分类事项本模块落地要求责任方
已确认口径视频平台范围远程巡课和督课支持海康威视、宇视两类已有视频平台;其他平台地址、账号、协议参数、门店网关、集中机房存储、录像保留 90 天循环覆盖均做后台配置。产品/技术/信息化
已确认口径校区地图点位与设备清单校区经纬度、校区大头钉、摄像头编码、品牌、教室、平台/网关关系、在线状态、设备总数均由后台动态维护,不作为静态初始化一次性数据。产品/运营/信息化
后台配置项视频平台配置配置 vendorCode=HIKVISION/UNIVIEW、platformCode、apiEndpoint、authConfig、storageCenter、retentionDays、gatewayCode、accessMode 和同步计划。信息化/运维
后台配置项校区点位与设备台账配置 campusLatitude、campusLongitude、campusPinName、cameraCode、classroomId、brand、onlineStatusMapping、streamPolicy、recordSearchPolicy。运营/信息化/校区
默认实施规则录像并发容量本阶段容量口径聚焦权限访问、播放鉴权、访问留痕、90 天留存提示和异常提示;大规模并发压测作为专项容量评估独立输出。产品/技术
默认实施规则接口设计说明书组织方式采用单独 HTML 文件集中管理接口协议;模块 PRD 保留模块级接口摘要,避免每个模块重复写通用协议。产品/研发
默认实施规则数据库分区与归档策略设备事件、直播互动、接口日志、视频会话、操作审计按时间分区和归档,交易主表保留业务索引和审计快照。DBA/后端
默认实施规则接口错误码与重试中间件所有外部接口和内部异步任务统一错误码、幂等键、重试次数、告警阈值和回执归档策略。后端/测试/运维

04 · 业务流程

远程巡课中心主流程

流程用于指导原型图的页面顺序、按钮状态和异常分支。
01摄像头台账

摄像头台账需覆盖入口、字段、状态、权限、审批/消息、异常处理、审计和指标统计,并与上下游模块保持数据一致。

02地图监控

地图监控展示区域、校区、教室点位、在线离线和异常状态

03视频直播墙

视频直播墙需覆盖入口、字段、状态、权限、审批/消息、异常处理、审计和指标统计,并与上下游模块保持数据一致。

04录像回放

录像回放按校区、教室、课次、班级、教师和时间检索

05督课任务

督课任务需覆盖入口、字段、状态、权限、审批/消息、异常处理、审计和指标统计,并与上下游模块保持数据一致。

06课堂评价

课堂评价需覆盖入口、字段、状态、权限、审批/消息、异常处理、审计和指标统计,并与上下游模块保持数据一致。

07教学质量评分

教学质量评分需覆盖入口、字段、状态、权限、审批/消息、异常处理、审计和指标统计,并与上下游模块保持数据一致。

08异常整改

异常整改需覆盖入口、字段、状态、权限、审批/消息、异常处理、审计和指标统计,并与上下游模块保持数据一致。

05 · 功能清单

按子模块拆到可设计、可开发、可测试的颗粒度

每一行功能都需要在原型中体现入口、状态、按钮、字段和反馈。
一级功能二级功能功能说明规则/验收
摄像头台账基础维护摄像头台账支持新增、编辑、启用/停用、查询、导入导出和操作审计。编码唯一、数据范围过滤、逻辑删除和审计留痕
摄像头台账业务处理摄像头台账需覆盖入口、字段、状态、权限、审批/消息、异常处理、审计和指标统计,并与上下游模块保持数据一致。必须联动状态、权限、消息、审批和指标
摄像头台账异常闭环摄像头离线处理失败原因可见、可重试、可转人工、可追溯
地图监控基础维护地图监控支持新增、编辑、启用/停用、查询、导入导出和操作审计。编码唯一、数据范围过滤、逻辑删除和审计留痕
地图监控业务处理地图监控展示区域、校区、教室点位、在线离线和异常状态必须联动状态、权限、消息、审批和指标
地图监控异常闭环直播拉流失败处理失败原因可见、可重试、可转人工、可追溯
视频直播墙基础维护视频直播墙支持新增、编辑、启用/停用、查询、导入导出和操作审计。编码唯一、数据范围过滤、逻辑删除和审计留痕
视频直播墙业务处理视频直播墙需覆盖入口、字段、状态、权限、审批/消息、异常处理、审计和指标统计,并与上下游模块保持数据一致。必须联动状态、权限、消息、审批和指标
视频直播墙异常闭环录像缺失处理失败原因可见、可重试、可转人工、可追溯
录像回放基础维护录像回放支持新增、编辑、启用/停用、查询、导入导出和操作审计。编码唯一、数据范围过滤、逻辑删除和审计留痕
录像回放业务处理录像回放按校区、教室、课次、班级、教师和时间检索必须联动状态、权限、消息、审批和指标
录像回放异常闭环评分数据不足处理失败原因可见、可重试、可转人工、可追溯
督课任务基础维护督课任务支持新增、编辑、启用/停用、查询、导入导出和操作审计。编码唯一、数据范围过滤、逻辑删除和审计留痕
督课任务业务处理督课任务需覆盖入口、字段、状态、权限、审批/消息、异常处理、审计和指标统计,并与上下游模块保持数据一致。必须联动状态、权限、消息、审批和指标
督课任务异常闭环门店网关离线处理失败原因可见、可重试、可转人工、可追溯
课堂评价基础维护课堂评价支持新增、编辑、启用/停用、查询、导入导出和操作审计。编码唯一、数据范围过滤、逻辑删除和审计留痕
课堂评价业务处理课堂评价需覆盖入口、字段、状态、权限、审批/消息、异常处理、审计和指标统计,并与上下游模块保持数据一致。必须联动状态、权限、消息、审批和指标
课堂评价异常闭环摄像头恢复失败处理失败原因可见、可重试、可转人工、可追溯
教学质量评分基础维护教学质量评分支持新增、编辑、启用/停用、查询、导入导出和操作审计。编码唯一、数据范围过滤、逻辑删除和审计留痕
教学质量评分业务处理教学质量评分需覆盖入口、字段、状态、权限、审批/消息、异常处理、审计和指标统计,并与上下游模块保持数据一致。必须联动状态、权限、消息、审批和指标
教学质量评分异常闭环评分规则版本失效处理失败原因可见、可重试、可转人工、可追溯
异常整改基础维护异常整改支持新增、编辑、启用/停用、查询、导入导出和操作审计。编码唯一、数据范围过滤、逻辑删除和审计留痕
异常整改业务处理异常整改需覆盖入口、字段、状态、权限、审批/消息、异常处理、审计和指标统计,并与上下游模块保持数据一致。必须联动状态、权限、消息、审批和指标
异常整改异常闭环摄像头未绑定教室处理失败原因可见、可重试、可转人工、可追溯
设备维修工单基础维护设备维修工单支持新增、编辑、启用/停用、查询、导入导出和操作审计。编码唯一、数据范围过滤、逻辑删除和审计留痕
设备维修工单业务处理设备维修工单需覆盖入口、字段、状态、权限、审批/消息、异常处理、审计和指标统计,并与上下游模块保持数据一致。必须联动状态、权限、消息、审批和指标
设备维修工单异常闭环摄像头跨校区绑定处理失败原因可见、可重试、可转人工、可追溯
设备恢复校验基础维护设备恢复校验支持新增、编辑、启用/停用、查询、导入导出和操作审计。编码唯一、数据范围过滤、逻辑删除和审计留痕
设备恢复校验业务处理设备恢复校验需覆盖入口、字段、状态、权限、审批/消息、异常处理、审计和指标统计,并与上下游模块保持数据一致。必须联动状态、权限、消息、审批和指标
设备恢复校验异常闭环绑定教室已停用处理失败原因可见、可重试、可转人工、可追溯
督课评分规则版本基础维护督课评分规则版本支持新增、编辑、启用/停用、查询、导入导出和操作审计。编码唯一、数据范围过滤、逻辑删除和审计留痕
督课评分规则版本业务处理督课评分规则版本需覆盖入口、字段、状态、权限、审批/消息、异常处理、审计和指标统计,并与上下游模块保持数据一致。必须联动状态、权限、消息、审批和指标
督课评分规则版本异常闭环摄像头教室与巡课课次不匹配处理失败原因可见、可重试、可转人工、可追溯
摄像头教室绑定基础维护摄像头教室绑定支持新增、编辑、启用/停用、查询、导入导出和操作审计。编码唯一、数据范围过滤、逻辑删除和审计留痕
摄像头教室绑定业务处理摄像头教室绑定需覆盖入口、字段、状态、权限、审批/消息、异常处理、审计和指标统计,并与上下游模块保持数据一致。必须联动状态、权限、消息、审批和指标
摄像头教室绑定异常闭环供应商回放能力不支持处理失败原因可见、可重试、可转人工、可追溯
按教室下钻监控基础维护按教室下钻监控支持新增、编辑、启用/停用、查询、导入导出和操作审计。编码唯一、数据范围过滤、逻辑删除和审计留痕
按教室下钻监控业务处理按教室下钻监控需覆盖入口、字段、状态、权限、审批/消息、异常处理、审计和指标统计,并与上下游模块保持数据一致。必须联动状态、权限、消息、审批和指标
按教室下钻监控异常闭环宇视片段录制失败处理失败原因可见、可重试、可转人工、可追溯
教室设备清单基础维护教室设备清单支持新增、编辑、启用/停用、查询、导入导出和操作审计。编码唯一、数据范围过滤、逻辑删除和审计留痕
教室设备清单业务处理教室设备清单需覆盖入口、字段、状态、权限、审批/消息、异常处理、审计和指标统计,并与上下游模块保持数据一致。必须联动状态、权限、消息、审批和指标
教室设备清单异常闭环片段录制超时处理失败原因可见、可重试、可转人工、可追溯
回放能力策略配置基础维护回放能力策略配置支持新增、编辑、启用/停用、查询、导入导出和操作审计。编码唯一、数据范围过滤、逻辑删除和审计留痕
回放能力策略配置业务处理回放能力策略配置需覆盖入口、字段、状态、权限、审批/消息、异常处理、审计和指标统计,并与上下游模块保持数据一致。必须联动状态、权限、消息、审批和指标
回放能力策略配置异常闭环下载链接过期处理失败原因可见、可重试、可转人工、可追溯
海康回放下载基础维护海康回放下载支持新增、编辑、启用/停用、查询、导入导出和操作审计。编码唯一、数据范围过滤、逻辑删除和审计留痕
海康回放下载业务处理海康回放下载需覆盖入口、字段、状态、权限、审批/消息、异常处理、审计和指标统计,并与上下游模块保持数据一致。必须联动状态、权限、消息、审批和指标
海康回放下载异常闭环时间戳无录像处理失败原因可见、可重试、可转人工、可追溯
宇视时间戳录制下载基础维护宇视时间戳录制下载支持新增、编辑、启用/停用、查询、导入导出和操作审计。编码唯一、数据范围过滤、逻辑删除和审计留痕
宇视时间戳录制下载业务处理宇视时间戳录制下载需覆盖入口、字段、状态、权限、审批/消息、异常处理、审计和指标统计,并与上下游模块保持数据一致。必须联动状态、权限、消息、审批和指标
宇视时间戳录制下载异常闭环摄像头离线处理失败原因可见、可重试、可转人工、可追溯
片段录制任务队列基础维护片段录制任务队列支持新增、编辑、启用/停用、查询、导入导出和操作审计。编码唯一、数据范围过滤、逻辑删除和审计留痕
片段录制任务队列业务处理片段录制任务队列需覆盖入口、字段、状态、权限、审批/消息、异常处理、审计和指标统计,并与上下游模块保持数据一致。必须联动状态、权限、消息、审批和指标
片段录制任务队列异常闭环直播拉流失败处理失败原因可见、可重试、可转人工、可追溯

功能到数据对象/接口/表映射

功能域承接对象核心表代表接口状态机/状态字段研发落地校验
摄像头台账VideoPlatformConfig、VideoGatewayConfig、ClassroomCamera、PatrolRecordingClipTaskvideo_platform_config、video_gateway_config、video_classroom_camera、video_recording_clip_task接口资源组 /api/v1/pat/features/01network_status、camera_status、task_status新增/编辑/删除/审批/导出/回调均需校验租户、校区、角色、数据范围、逻辑删除、幂等和审计
地图监控VideoPlatformConfig、VideoGatewayConfig、ClassroomCamera、PatrolRecordingClipTaskvideo_platform_config、video_gateway_config、video_classroom_camera、video_recording_clip_task接口资源组 /api/v1/pat/features/02network_status、camera_status、task_status新增/编辑/删除/审批/导出/回调均需校验租户、校区、角色、数据范围、逻辑删除、幂等和审计
视频直播墙VideoPlatformConfig、VideoGatewayConfig、ClassroomCamera、PatrolRecordingClipTaskvideo_platform_config、video_gateway_config、video_classroom_camera、video_recording_clip_task接口资源组 /api/v1/pat/features/03network_status、camera_status、task_status新增/编辑/删除/审批/导出/回调均需校验租户、校区、角色、数据范围、逻辑删除、幂等和审计
录像回放VideoPlatformConfig、VideoGatewayConfig、ClassroomCamera、PatrolRecordingClipTaskvideo_platform_config、video_gateway_config、video_classroom_camera、video_recording_clip_task接口资源组 /api/v1/pat/features/04network_status、camera_status、task_status新增/编辑/删除/审批/导出/回调均需校验租户、校区、角色、数据范围、逻辑删除、幂等和审计
督课任务VideoPlatformConfig、VideoGatewayConfig、ClassroomCamera、PatrolRecordingClipTaskvideo_platform_config、video_gateway_config、video_classroom_camera、video_recording_clip_task接口资源组 /api/v1/pat/features/05network_status、camera_status、task_status新增/编辑/删除/审批/导出/回调均需校验租户、校区、角色、数据范围、逻辑删除、幂等和审计
课堂评价VideoPlatformConfig、VideoGatewayConfig、ClassroomCamera、PatrolRecordingClipTaskvideo_platform_config、video_gateway_config、video_classroom_camera、video_recording_clip_task接口资源组 /api/v1/pat/features/06network_status、camera_status、task_status新增/编辑/删除/审批/导出/回调均需校验租户、校区、角色、数据范围、逻辑删除、幂等和审计
教学质量评分TeachingQualityScorepatrol_quality_score接口资源组 /api/v1/pat/features/07score_status新增/编辑/删除/审批/导出/回调均需校验租户、校区、角色、数据范围、逻辑删除、幂等和审计
异常整改VideoPlatformConfig、VideoGatewayConfig、ClassroomCamera、PatrolRecordingClipTaskvideo_platform_config、video_gateway_config、video_classroom_camera、video_recording_clip_task接口资源组 /api/v1/pat/features/08network_status、camera_status、task_status新增/编辑/删除/审批/导出/回调均需校验租户、校区、角色、数据范围、逻辑删除、幂等和审计
设备维修工单VideoPlatformConfig、VideoGatewayConfig、ClassroomCamera、PatrolRecordingClipTaskvideo_platform_config、video_gateway_config、video_classroom_camera、video_recording_clip_task接口资源组 /api/v1/pat/features/09network_status、camera_status、task_status新增/编辑/删除/审批/导出/回调均需校验租户、校区、角色、数据范围、逻辑删除、幂等和审计
设备恢复校验VideoPlatformConfig、VideoGatewayConfig、ClassroomCamera、PatrolRecordingClipTaskvideo_platform_config、video_gateway_config、video_classroom_camera、video_recording_clip_task接口资源组 /api/v1/pat/features/10network_status、camera_status、task_status新增/编辑/删除/审批/导出/回调均需校验租户、校区、角色、数据范围、逻辑删除、幂等和审计
督课评分规则版本VideoPlatformConfig、VideoGatewayConfig、ClassroomCamera、PatrolRecordingClipTaskvideo_platform_config、video_gateway_config、video_classroom_camera、video_recording_clip_task接口资源组 /api/v1/pat/features/11network_status、camera_status、task_status新增/编辑/删除/审批/导出/回调均需校验租户、校区、角色、数据范围、逻辑删除、幂等和审计
摄像头教室绑定VideoPlatformConfig、VideoGatewayConfig、ClassroomCamera、PatrolRecordingClipTaskvideo_platform_config、video_gateway_config、video_classroom_camera、video_recording_clip_task接口资源组 /api/v1/pat/features/12network_status、camera_status、task_status新增/编辑/删除/审批/导出/回调均需校验租户、校区、角色、数据范围、逻辑删除、幂等和审计
按教室下钻监控VideoPlatformConfig、VideoGatewayConfig、ClassroomCamera、PatrolRecordingClipTaskvideo_platform_config、video_gateway_config、video_classroom_camera、video_recording_clip_task接口资源组 /api/v1/pat/features/13network_status、camera_status、task_status新增/编辑/删除/审批/导出/回调均需校验租户、校区、角色、数据范围、逻辑删除、幂等和审计
教室设备清单VideoPlatformConfig、VideoGatewayConfig、ClassroomCamera、PatrolRecordingClipTaskvideo_platform_config、video_gateway_config、video_classroom_camera、video_recording_clip_task接口资源组 /api/v1/pat/features/14network_status、camera_status、task_status新增/编辑/删除/审批/导出/回调均需校验租户、校区、角色、数据范围、逻辑删除、幂等和审计
回放能力策略配置VideoPlatformConfig、VideoGatewayConfig、ClassroomCamera、PatrolRecordingClipTaskvideo_platform_config、video_gateway_config、video_classroom_camera、video_recording_clip_task接口资源组 /api/v1/pat/features/15network_status、camera_status、task_status新增/编辑/删除/审批/导出/回调均需校验租户、校区、角色、数据范围、逻辑删除、幂等和审计
海康回放下载VideoPlatformConfig、VideoGatewayConfig、ClassroomCamera、PatrolRecordingClipTaskvideo_platform_config、video_gateway_config、video_classroom_camera、video_recording_clip_task接口资源组 /api/v1/pat/features/16network_status、camera_status、task_status新增/编辑/删除/审批/导出/回调均需校验租户、校区、角色、数据范围、逻辑删除、幂等和审计
宇视时间戳录制下载VideoPlatformConfig、VideoGatewayConfig、ClassroomCamera、PatrolRecordingClipTaskvideo_platform_config、video_gateway_config、video_classroom_camera、video_recording_clip_task接口资源组 /api/v1/pat/features/17network_status、camera_status、task_status新增/编辑/删除/审批/导出/回调均需校验租户、校区、角色、数据范围、逻辑删除、幂等和审计
片段录制任务队列VideoPlatformConfig、VideoGatewayConfig、ClassroomCamera、PatrolRecordingClipTaskvideo_platform_config、video_gateway_config、video_classroom_camera、video_recording_clip_task接口资源组 /api/v1/pat/features/18network_status、camera_status、task_status新增/编辑/删除/审批/导出/回调均需校验租户、校区、角色、数据范围、逻辑删除、幂等和审计

06 · 原子级功能需求

用于研发任务拆分和测试用例追踪

需求编号可直接进入项目管理工具。
编号需求描述入口页面关键动作输入校验输出结果异常处理验收标准
FR-PAT-001支持一千多台存量教室摄像头批量导入、校区教室绑定和在线状态巡检摄像头台账导入摄像头校验租户、校区、角色、数据范围、状态前置、必填、唯一和敏感操作授权生成业务记录、状态流转、消息通知、审计日志、指标快照和必要的第三方任务摄像头离线主流程、异常流、权限流、接口失败和数据一致性均可通过测试
FR-PAT-002支持海康威视、宇视两类摄像头统一纳管和品牌型号字段管理地图监控绑定教室校验租户、校区、角色、数据范围、状态前置、必填、唯一和敏感操作授权生成业务记录、状态流转、消息通知、审计日志、指标快照和必要的第三方任务直播拉流失败主流程、异常流、权限流、接口失败和数据一致性均可通过测试
FR-PAT-003地图监控展示区域、校区、教室点位、在线离线和异常状态指标异常处理异常订阅、责任人处理或口径审批校验租户、校区、角色、数据范围、状态前置、必填、唯一和敏感操作授权生成业务记录、状态流转、消息通知、审计日志、指标快照和必要的第三方任务指标延迟、责任人缺失或口径版本不一致主流程、异常流、权限流、接口失败和数据一致性均可通过测试
FR-PAT-004在线巡课支持单画面、多画面、轮巡、重点课堂置顶和权限控制录像回放地图巡课校验租户、校区、角色、数据范围、状态前置、必填、唯一和敏感操作授权生成业务记录、状态流转、消息通知、审计日志、指标快照和必要的第三方任务评分数据不足主流程、异常流、权限流、接口失败和数据一致性均可通过测试
FR-PAT-005录像回放按校区、教室、课次、班级、教师和时间检索回放发布与访问回放发布、下架、过期或权限校验校验租户、校区、角色、数据范围、状态前置、必填、唯一和敏感操作授权生成业务记录、状态流转、消息通知、审计日志、指标快照和必要的第三方任务回放已下架、已过期或权限不足主流程、异常流、权限流、接口失败和数据一致性均可通过测试
FR-PAT-006督课评分需融合学生出勤、课堂参与、作业完成、测评提升、学习进度、教师点评、教师教态、课堂节奏、教学目标达成和课堂纪律作业草稿箱/作业提交保存草稿、恢复草稿或提交作业校验租户、校区、角色、数据范围、状态前置、必填、唯一和敏感操作授权生成业务记录、状态流转、消息通知、审计日志、指标快照和必要的第三方任务草稿冲突、附件失败或作业已关闭主流程、异常流、权限流、接口失败和数据一致性均可通过测试
FR-PAT-007系统自动生成质量初评分,督课老师可复核评分,校长或总部可抽检确认督课评分规则版本海康直接下载校验租户、校区、角色、数据范围、状态前置、必填、唯一和敏感操作授权生成业务记录、状态流转、消息通知、审计日志、指标快照和必要的第三方任务评分规则版本失效主流程、异常流、权限流、接口失败和数据一致性均可通过测试
FR-PAT-008评分结果联动教师考核、教研复盘、培训计划、优秀案例库、问题整改和校区教学质量排行摄像头绑定教室宇视拖动时间戳校验租户、校区、角色、数据范围、状态前置、必填、唯一和敏感操作授权生成业务记录、状态流转、消息通知、审计日志、指标快照和必要的第三方任务摄像头未绑定教室主流程、异常流、权限流、接口失败和数据一致性均可通过测试
FR-PAT-009远程巡课设备离线需从告警转入维修工单,支持按摄像头、门店网关、电源、网络、平台账号分类排查,恢复后自动回测直播、回放和录像索引。资产生命周期/图书进销存领用、维修、责任人变更、盘点或图书出入库校验租户、校区、角色、数据范围、状态前置、必填、唯一和敏感操作授权生成业务记录、状态流转、消息通知、审计日志、指标快照和必要的第三方任务责任人缺失、维修超期或库存不足主流程、异常流、权限流、接口失败和数据一致性均可通过测试
FR-PAT-010督课评分规则需支持版本管理、权重配置、生效范围、审批发布、历史追溯和教师申诉时的规则版本锁定。回放能力策略配置下载片段校验租户、校区、角色、数据范围、状态前置、必填、唯一和敏感操作授权生成业务记录、状态流转、消息通知、审计日志、指标快照和必要的第三方任务绑定教室已停用主流程、异常流、权限流、接口失败和数据一致性均可通过测试
FR-PAT-011远程巡课系统的每一路教室摄像头必须绑定到指定校区的指定教室,摄像头创建、编辑、启用、直播和回放查询均需校验 campusId 与 classroomId 一致。回放发布与访问回放发布、下架、过期或权限校验校验租户、校区、角色、数据范围、状态前置、必填、唯一和敏感操作授权生成业务记录、状态流转、消息通知、审计日志、指标快照和必要的第三方任务回放已下架、已过期或权限不足主流程、异常流、权限流、接口失败和数据一致性均可通过测试
FR-PAT-012校区地图大头钉展示校区设备总数,点击后按教室展开摄像头列表、在线状态、直播入口、回放入口和设备异常。回放发布与访问回放发布、下架、过期或权限校验校验租户、校区、角色、数据范围、状态前置、必填、唯一和敏感操作授权生成业务记录、状态流转、消息通知、审计日志、指标快照和必要的第三方任务回放已下架、已过期或权限不足主流程、异常流、权限流、接口失败和数据一致性均可通过测试
FR-PAT-013海康威视摄像头支持原生录像回放检索、回放查看和录播文件下载;回放页可直接展示下载入口,下载需校验权限、记录审计并控制链接有效期。回放发布与访问回放发布、下架、过期或权限校验校验租户、校区、角色、数据范围、状态前置、必填、唯一和敏感操作授权生成业务记录、状态流转、消息通知、审计日志、指标快照和必要的第三方任务回放已下架、已过期或权限不足主流程、异常流、权限流、接口失败和数据一致性均可通过测试
FR-PAT-014宇视摄像头当前不按原生录播文件直接下载处理;督导需要在回放页拖动时间轴定位到指定时间戳,选择片段开始/结束时间并发起录制,录制完成后才允许查看片段回放和下载。回放发布与访问回放发布、下架、过期或权限校验校验租户、校区、角色、数据范围、状态前置、必填、唯一和敏感操作授权生成业务记录、状态流转、消息通知、审计日志、指标快照和必要的第三方任务回放已下架、已过期或权限不足主流程、异常流、权限流、接口失败和数据一致性均可通过测试
FR-PAT-015视频平台与摄像头通道必须维护 playback_capability/playback_mode,PC Web 根据设备品牌、平台能力和通道覆盖策略动态展示直接下载、片段录制、录制中、可下载、失败和过期状态。网关配置地图教室下钻校验租户、校区、角色、数据范围、状态前置、必填、唯一和敏感操作授权生成业务记录、状态流转、消息通知、审计日志、指标快照和必要的第三方任务下载链接过期主流程、异常流、权限流、接口失败和数据一致性均可通过测试
FR-PAT-016同一回放时间段如来自海康平台,默认走原生回放文件;如来自宇视平台,默认走时间戳定位录制任务,禁止在 UI 上展示不可用的直接下载按钮。回放发布与访问回放发布、下架、过期或权限校验校验租户、校区、角色、数据范围、状态前置、必填、唯一和敏感操作授权生成业务记录、状态流转、消息通知、审计日志、指标快照和必要的第三方任务回放已下架、已过期或权限不足主流程、异常流、权限流、接口失败和数据一致性均可通过测试

07 · 关联闭环补充需求

远程巡课中心在跨模块闭环中的责任边界

本章节承接最终闭环核对清单,明确本模块需要补齐的页面、接口对象、异常兜底和验收口径。
闭环项本模块责任关键场景页面/功能补充关联对象/接口验收口径
摄像头绑定教室负责远程巡课摄像头与指定校区、指定教室的绑定校验、换绑审计、地图下钻和直播/回放权限校验巡课直播、回放和督课评分必须明确对应校区、教室和课次摄像头绑定、地图教室下钻、直播入口、回放入口、设备异常ClassroomCamera、Classroom、PatrolRecord、/api/v1/patrol/cameras摄像头必须绑定同校区启用教室;历史巡课记录保留当时教室快照
回放下载供应商差异负责按海康威视、宇视两类平台能力控制回放查看、下载和片段录制任务海康可原生查看回放并下载录播文件;宇视需拖动到指定时间戳后录制片段,片段完成后才可回放和下载回放能力策略配置、海康录像回放下载、宇视时间戳片段录制、片段录制任务队列VideoPlatformConfig、ClassroomCamera、PatrolRecordingClipTask、/api/v1/patrol/recordsPC Web 必须按 vendorCode/playbackMode 展示不同动作,宇视不得显示直接下载按钮,海康不得要求先创建片段录制任务
设备维修工单负责巡课摄像头、门店侧网关、视频平台通道异常的发现和派单海康/宇视设备离线、直播断流、回放缺失、存储异常地图监控、设备列表、异常详情、维修派单、处理复核ClassroomCamera/PatrolRecord/TeachingQualityScore、AssetLifecycle/Maintenance设备异常关闭前必须有处理记录、复核结果和恢复时间
督课评分规则版本负责评分维度、权重、扣分项、证据类型和版本生效范围不同区域、课程、教师类型采用不同评分规则或规则升级评分规则配置、在线巡课评分、证据截图、整改复核、历史版本TeachingQualityScore、MetricSnapshot、/api/v1/patrol/quality-scores评分结果必须绑定规则版本、评分人、证据和复核状态

08 · 页面与原型设计说明

页面清单、布局要求、按钮字段和状态

原型图设计需要覆盖列表、详情、表单、弹窗、空状态、异常状态和权限状态。
终端页面用户页面目标布局结构关键按钮关键字段异常状态原型备注
PC Web摄像头台账设备管理员/教务督导维护摄像头品牌、型号、序列号、校区教室绑定和在线状态巡课页以地图/视频墙/回放检索/评分面板切换,设备异常和整改任务通过右侧抽屉闭环处理。查看地图、展开校区设备、打开直播、检索回放、海康直接下载、拖动宇视时间戳、创建片段录制任务、截图取证校区经纬度、设备品牌、设备总数、在线状态、录像时间、回放能力、时间戳、片段起止时间、片段任务状态、下载链接有效期设备离线、网关离线、直播断流、录像缺失、存储异常、宇视片段录制失败、下载链接过期、评分规则未发布需画校区地图大头钉、设备列表展开、海康/宇视配置、海康直接下载、宇视时间轴拖动与片段录制任务、回放片段标记、评分规则版本和整改复核。 建议 Figma Frame:PAT-摄像头台账;需补齐正常、空态、加载、无权限、处理中、成功和失败状态。
PC Web地图监控总部/区域/校长按地图、区域、校区、楼层和教室查看摄像头分布与异常巡课页以地图/视频墙/回放检索/评分面板切换,设备异常和整改任务通过右侧抽屉闭环处理。查看地图、展开校区设备、打开直播、检索回放、海康直接下载、拖动宇视时间戳、创建片段录制任务、截图取证校区经纬度、设备品牌、设备总数、在线状态、录像时间、回放能力、时间戳、片段起止时间、片段任务状态、下载链接有效期设备离线、网关离线、直播断流、录像缺失、存储异常、宇视片段录制失败、下载链接过期、评分规则未发布需画校区地图大头钉、设备列表展开、海康/宇视配置、海康直接下载、宇视时间轴拖动与片段录制任务、回放片段标记、评分规则版本和整改复核。 建议 Figma Frame:PAT-地图监控;需补齐正常、空态、加载、无权限、处理中、成功和失败状态。
PC Web视频直播墙总部/教研督导单画面、多画面、轮巡、重点课堂置顶和直播巡课记录巡课页以地图/视频墙/回放检索/评分面板切换,设备异常和整改任务通过右侧抽屉闭环处理。查看地图、展开校区设备、打开直播、检索回放、海康直接下载、拖动宇视时间戳、创建片段录制任务、截图取证校区经纬度、设备品牌、设备总数、在线状态、录像时间、回放能力、时间戳、片段起止时间、片段任务状态、下载链接有效期设备离线、网关离线、直播断流、录像缺失、存储异常、宇视片段录制失败、下载链接过期、评分规则未发布需画校区地图大头钉、设备列表展开、海康/宇视配置、海康直接下载、宇视时间轴拖动与片段录制任务、回放片段标记、评分规则版本和整改复核。 建议 Figma Frame:PAT-视频直播墙;需补齐正常、空态、加载、无权限、处理中、成功和失败状态。
PC Web录像回放教研督导/校长按校区、教室、课次、教师和时间检索录像并标记片段巡课页以地图/视频墙/回放检索/评分面板切换,设备异常和整改任务通过右侧抽屉闭环处理。查看地图、展开校区设备、打开直播、检索回放、海康直接下载、拖动宇视时间戳、创建片段录制任务、截图取证校区经纬度、设备品牌、设备总数、在线状态、录像时间、回放能力、时间戳、片段起止时间、片段任务状态、下载链接有效期设备离线、网关离线、直播断流、录像缺失、存储异常、宇视片段录制失败、下载链接过期、评分规则未发布需画校区地图大头钉、设备列表展开、海康/宇视配置、海康直接下载、宇视时间轴拖动与片段录制任务、回放片段标记、评分规则版本和整改复核。 建议 Figma Frame:PAT-录像回放;需补齐正常、空态、加载、无权限、处理中、成功和失败状态。
PC Web教学质量评分教研督导/校长/总部教学管理基于学生、教师、课堂过程和学习结果生成教学质量分并复核巡课页以地图/视频墙/回放检索/评分面板切换,设备异常和整改任务通过右侧抽屉闭环处理。查看地图、展开校区设备、打开直播、检索回放、海康直接下载、拖动宇视时间戳、创建片段录制任务、截图取证校区经纬度、设备品牌、设备总数、在线状态、录像时间、回放能力、时间戳、片段起止时间、片段任务状态、下载链接有效期设备离线、网关离线、直播断流、录像缺失、存储异常、宇视片段录制失败、下载链接过期、评分规则未发布需画校区地图大头钉、设备列表展开、海康/宇视配置、海康直接下载、宇视时间轴拖动与片段录制任务、回放片段标记、评分规则版本和整改复核。 建议 Figma Frame:PAT-教学质量评分;需补齐正常、空态、加载、无权限、处理中、成功和失败状态。
设备/巡课运维端设备维修工单技术运营/校区摄像头或网关离线后派单、接单、排查、恢复校验、关闭和升级巡课页以地图/视频墙/回放检索/评分面板切换,设备异常和整改任务通过右侧抽屉闭环处理。查看地图、展开校区设备、打开直播、检索回放、海康直接下载、拖动宇视时间戳、创建片段录制任务、截图取证校区经纬度、设备品牌、设备总数、在线状态、录像时间、回放能力、时间戳、片段起止时间、片段任务状态、下载链接有效期设备离线、网关离线、直播断流、录像缺失、存储异常、宇视片段录制失败、下载链接过期、评分规则未发布需画校区地图大头钉、设备列表展开、海康/宇视配置、海康直接下载、宇视时间轴拖动与片段录制任务、回放片段标记、评分规则版本和整改复核。 建议 Figma Frame:PAT-设备维修工单;需补齐正常、空态、加载、无权限、处理中、成功和失败状态。
PC Web督课评分规则版本教研督导/总部教研配置评分维度、权重、版本、生效范围、审批发布和历史追溯巡课页以地图/视频墙/回放检索/评分面板切换,设备异常和整改任务通过右侧抽屉闭环处理。查看地图、展开校区设备、打开直播、检索回放、海康直接下载、拖动宇视时间戳、创建片段录制任务、截图取证校区经纬度、设备品牌、设备总数、在线状态、录像时间、回放能力、时间戳、片段起止时间、片段任务状态、下载链接有效期设备离线、网关离线、直播断流、录像缺失、存储异常、宇视片段录制失败、下载链接过期、评分规则未发布需画校区地图大头钉、设备列表展开、海康/宇视配置、海康直接下载、宇视时间轴拖动与片段录制任务、回放片段标记、评分规则版本和整改复核。 建议 Figma Frame:PAT-督课评分规则版本;需补齐正常、空态、加载、无权限、处理中、成功和失败状态。
PC Web摄像头绑定教室设备管理员/督导创建或编辑教室摄像头时必须选择校区和教室,系统校验教室存在、未停用、未逻辑删除且归属同校区PC 端采用顶部筛选、左侧列表或导航、中部主工作区、右侧详情抽屉,复杂操作进入弹窗或步骤条。查询、新增、编辑、提交、导出、查看日志、导入摄像头、绑定教室校区、教室、摄像头品牌、设备在线状态、直播状态、录像时间、回放能力、时间戳、片段任务状态、下载链接有效期空数据、无权限、加载失败、保存失败、审批驳回、批量部分失败管理员端沿用统一框架,原型重点标注信息架构、表单弹窗、状态流和异常处理。 建议 Figma Frame:PAT-摄像头绑定教室;需补齐正常、空态、加载、无权限、处理中、成功和失败状态。
PC Web校区地图教室下钻总部督导/区域督导/校区管理地图大头钉显示校区设备总数,点击后按教室分组展开摄像头列表、直播、回放和异常处理入口PC 端采用顶部筛选、左侧列表或导航、中部主工作区、右侧详情抽屉,复杂操作进入弹窗或步骤条。查询、新增、编辑、提交、导出、查看日志、导入摄像头、绑定教室校区、教室、摄像头品牌、设备在线状态、直播状态、录像时间、回放能力、时间戳、片段任务状态、下载链接有效期空数据、无权限、加载失败、保存失败、审批驳回、批量部分失败管理员端沿用统一框架,原型重点标注信息架构、表单弹窗、状态流和异常处理。 建议 Figma Frame:PAT-校区地图教室下钻;需补齐正常、空态、加载、无权限、处理中、成功和失败状态。
PC Web回放能力策略配置总部督导/设备管理员/系统管理员按视频平台和摄像头通道维护回放能力,海康配置为原生回放下载,宇视配置为时间戳定位录制后下载PC 端采用顶部筛选、左侧列表或导航、中部主工作区、右侧详情抽屉,复杂操作进入弹窗或步骤条。查询、新增、编辑、提交、导出、查看日志、导入摄像头、绑定教室校区、教室、摄像头品牌、设备在线状态、直播状态、录像时间、回放能力、时间戳、片段任务状态、下载链接有效期空数据、无权限、加载失败、保存失败、审批驳回、批量部分失败管理员端沿用统一框架,原型重点标注信息架构、表单弹窗、状态流和异常处理。 建议 Figma Frame:PAT-回放能力策略配置;需补齐正常、空态、加载、无权限、处理中、成功和失败状态。
PC Web海康录像回放下载总部督导/区域督导/校区管理选择海康摄像头和时间范围后直接检索录像、在线播放回放、下载录播文件并记录下载审计巡课页以地图/视频墙/回放检索/评分面板切换,设备异常和整改任务通过右侧抽屉闭环处理。查看地图、展开校区设备、打开直播、检索回放、海康直接下载、拖动宇视时间戳、创建片段录制任务、截图取证校区经纬度、设备品牌、设备总数、在线状态、录像时间、回放能力、时间戳、片段起止时间、片段任务状态、下载链接有效期设备离线、网关离线、直播断流、录像缺失、存储异常、宇视片段录制失败、下载链接过期、评分规则未发布需画校区地图大头钉、设备列表展开、海康/宇视配置、海康直接下载、宇视时间轴拖动与片段录制任务、回放片段标记、评分规则版本和整改复核。 建议 Figma Frame:PAT-海康录像回放下载;需补齐正常、空态、加载、无权限、处理中、成功和失败状态。
PC Web宇视时间戳片段录制总部督导/区域督导/校区管理选择宇视摄像头后拖动时间轴到指定时间戳,设置片段起止时间,提交录制任务,完成后查看片段回放和下载PC 端采用顶部筛选、左侧列表或导航、中部主工作区、右侧详情抽屉,复杂操作进入弹窗或步骤条。查询、新增、编辑、提交、导出、查看日志、导入摄像头、绑定教室校区、教室、摄像头品牌、设备在线状态、直播状态、录像时间、回放能力、时间戳、片段任务状态、下载链接有效期空数据、无权限、加载失败、保存失败、审批驳回、批量部分失败管理员端沿用统一框架,原型重点标注信息架构、表单弹窗、状态流和异常处理。 建议 Figma Frame:PAT-宇视时间戳片段录制;需补齐正常、空态、加载、无权限、处理中、成功和失败状态。
PC Web片段录制任务队列督导/设备管理员查看宇视片段录制任务的待处理、录制中、可下载、失败、已过期状态,支持失败重试和审计追踪PC 端采用顶部筛选、左侧列表或导航、中部主工作区、右侧详情抽屉,复杂操作进入弹窗或步骤条。查询、新增、编辑、提交、导出、查看日志、导入摄像头、绑定教室校区、教室、摄像头品牌、设备在线状态、直播状态、录像时间、回放能力、时间戳、片段任务状态、下载链接有效期空数据、无权限、加载失败、保存失败、审批驳回、批量部分失败管理员端沿用统一框架,原型重点标注信息架构、表单弹窗、状态流和异常处理。 建议 Figma Frame:PAT-片段录制任务队列;需补齐正常、空态、加载、无权限、处理中、成功和失败状态。
PC Web/视频大屏视频平台配置督导/校长/运维围绕视频接入完善视频平台配置的入口、字段、状态、异常提示、处理进度和验收反馈PC 端采用顶部筛选、左侧列表或导航、中部主工作区、右侧详情抽屉,复杂操作进入弹窗或步骤条。查询、新增、编辑、提交、导出、查看日志、导入摄像头、绑定教室校区、教室、摄像头品牌、设备在线状态、直播状态、录像时间、回放能力、时间戳、片段任务状态、下载链接有效期空数据、无权限、加载失败、保存失败、审批驳回、批量部分失败管理员端沿用统一框架,原型重点标注信息架构、表单弹窗、状态流和异常处理。 建议 Figma Frame:PAT-视频平台配置;需补齐正常、空态、加载、无权限、处理中、成功和失败状态。
PC Web/视频大屏网关配置督导/校长/运维围绕视频接入完善网关配置的入口、字段、状态、异常提示、处理进度和验收反馈PC 端采用顶部筛选、左侧列表或导航、中部主工作区、右侧详情抽屉,复杂操作进入弹窗或步骤条。查询、新增、编辑、提交、导出、查看日志、导入摄像头、绑定教室校区、教室、摄像头品牌、设备在线状态、直播状态、录像时间、回放能力、时间戳、片段任务状态、下载链接有效期空数据、无权限、加载失败、保存失败、审批驳回、批量部分失败管理员端沿用统一框架,原型重点标注信息架构、表单弹窗、状态流和异常处理。 建议 Figma Frame:PAT-网关配置;需补齐正常、空态、加载、无权限、处理中、成功和失败状态。
PC Web/视频大屏存储策略督导/校长/运维围绕视频接入完善存储策略的入口、字段、状态、异常提示、处理进度和验收反馈PC 端采用顶部筛选、左侧列表或导航、中部主工作区、右侧详情抽屉,复杂操作进入弹窗或步骤条。查询、新增、编辑、提交、导出、查看日志、导入摄像头、绑定教室校区、教室、摄像头品牌、设备在线状态、直播状态、录像时间、回放能力、时间戳、片段任务状态、下载链接有效期空数据、无权限、加载失败、保存失败、审批驳回、批量部分失败管理员端沿用统一框架,原型重点标注信息架构、表单弹窗、状态流和异常处理。 建议 Figma Frame:PAT-存储策略;需补齐正常、空态、加载、无权限、处理中、成功和失败状态。
PC Web/视频大屏校区地图督导/校长/运维围绕地图巡课完善校区地图的入口、字段、状态、异常提示、处理进度和验收反馈PC 端采用顶部筛选、左侧列表或导航、中部主工作区、右侧详情抽屉,复杂操作进入弹窗或步骤条。查询、新增、编辑、提交、导出、查看日志、导入摄像头、绑定教室校区、教室、摄像头品牌、设备在线状态、直播状态、录像时间、回放能力、时间戳、片段任务状态、下载链接有效期空数据、无权限、加载失败、保存失败、审批驳回、批量部分失败管理员端沿用统一框架,原型重点标注信息架构、表单弹窗、状态流和异常处理。 建议 Figma Frame:PAT-校区地图;需补齐正常、空态、加载、无权限、处理中、成功和失败状态。
PC Web/视频大屏设备详情督导/校长/运维围绕地图巡课完善设备详情的入口、字段、状态、异常提示、处理进度和验收反馈PC 端采用顶部筛选、左侧列表或导航、中部主工作区、右侧详情抽屉,复杂操作进入弹窗或步骤条。查询、新增、编辑、提交、导出、查看日志、导入摄像头、绑定教室校区、教室、摄像头品牌、设备在线状态、直播状态、录像时间、回放能力、时间戳、片段任务状态、下载链接有效期空数据、无权限、加载失败、保存失败、审批驳回、批量部分失败管理员端沿用统一框架,原型重点标注信息架构、表单弹窗、状态流和异常处理。 建议 Figma Frame:PAT-设备详情;需补齐正常、空态、加载、无权限、处理中、成功和失败状态。
PC Web/视频大屏直播页督导/校长/运维围绕地图巡课完善直播页的入口、字段、状态、异常提示、处理进度和验收反馈PC 端采用顶部筛选、左侧列表或导航、中部主工作区、右侧详情抽屉,复杂操作进入弹窗或步骤条。查询、新增、编辑、提交、导出、查看日志、导入摄像头、绑定教室校区、教室、摄像头品牌、设备在线状态、直播状态、录像时间、回放能力、时间戳、片段任务状态、下载链接有效期空数据、无权限、加载失败、保存失败、审批驳回、批量部分失败管理员端沿用统一框架,原型重点标注信息架构、表单弹窗、状态流和异常处理。 建议 Figma Frame:PAT-直播页;需补齐正常、空态、加载、无权限、处理中、成功和失败状态。
PC Web/视频大屏回放页督导/校长/运维围绕地图巡课完善回放页的入口、字段、状态、异常提示、处理进度和验收反馈PC 端采用顶部筛选、左侧列表或导航、中部主工作区、右侧详情抽屉,复杂操作进入弹窗或步骤条。查询、新增、编辑、提交、导出、查看日志、导入摄像头、绑定教室校区、教室、摄像头品牌、设备在线状态、直播状态、录像时间、回放能力、时间戳、片段任务状态、下载链接有效期空数据、无权限、加载失败、保存失败、审批驳回、批量部分失败管理员端沿用统一框架,原型重点标注信息架构、表单弹窗、状态流和异常处理。 建议 Figma Frame:PAT-回放页;需补齐正常、空态、加载、无权限、处理中、成功和失败状态。
PC Web/视频大屏督课任务督导/校长/运维围绕督课评分完善督课任务的入口、字段、状态、异常提示、处理进度和验收反馈巡课页以地图/视频墙/回放检索/评分面板切换,设备异常和整改任务通过右侧抽屉闭环处理。查看地图、展开校区设备、打开直播、检索回放、海康直接下载、拖动宇视时间戳、创建片段录制任务、截图取证校区经纬度、设备品牌、设备总数、在线状态、录像时间、回放能力、时间戳、片段起止时间、片段任务状态、下载链接有效期设备离线、网关离线、直播断流、录像缺失、存储异常、宇视片段录制失败、下载链接过期、评分规则未发布需画校区地图大头钉、设备列表展开、海康/宇视配置、海康直接下载、宇视时间轴拖动与片段录制任务、回放片段标记、评分规则版本和整改复核。 建议 Figma Frame:PAT-督课任务;需补齐正常、空态、加载、无权限、处理中、成功和失败状态。
PC Web/视频大屏评分表督导/校长/运维围绕督课评分完善评分表的入口、字段、状态、异常提示、处理进度和验收反馈巡课页以地图/视频墙/回放检索/评分面板切换,设备异常和整改任务通过右侧抽屉闭环处理。查看地图、展开校区设备、打开直播、检索回放、海康直接下载、拖动宇视时间戳、创建片段录制任务、截图取证校区经纬度、设备品牌、设备总数、在线状态、录像时间、回放能力、时间戳、片段起止时间、片段任务状态、下载链接有效期设备离线、网关离线、直播断流、录像缺失、存储异常、宇视片段录制失败、下载链接过期、评分规则未发布需画校区地图大头钉、设备列表展开、海康/宇视配置、海康直接下载、宇视时间轴拖动与片段录制任务、回放片段标记、评分规则版本和整改复核。 建议 Figma Frame:PAT-评分表;需补齐正常、空态、加载、无权限、处理中、成功和失败状态。
PC Web/视频大屏整改复核督导/校长/运维围绕督课评分完善整改复核的入口、字段、状态、异常提示、处理进度和验收反馈巡课页以地图/视频墙/回放检索/评分面板切换,设备异常和整改任务通过右侧抽屉闭环处理。查看地图、展开校区设备、打开直播、检索回放、海康直接下载、拖动宇视时间戳、创建片段录制任务、截图取证校区经纬度、设备品牌、设备总数、在线状态、录像时间、回放能力、时间戳、片段起止时间、片段任务状态、下载链接有效期设备离线、网关离线、直播断流、录像缺失、存储异常、宇视片段录制失败、下载链接过期、评分规则未发布需画校区地图大头钉、设备列表展开、海康/宇视配置、海康直接下载、宇视时间轴拖动与片段录制任务、回放片段标记、评分规则版本和整改复核。 建议 Figma Frame:PAT-整改复核;需补齐正常、空态、加载、无权限、处理中、成功和失败状态。

09 · 页面到接口的前后端闭环矩阵

把原型页面、后端接口、数据对象、状态和消息审批绑定到一起

设计原型时,每个关键页面必须能解释前端展示什么、后端提交什么、状态怎么变、异常怎么处理。
原型页面关键接口关联对象状态流审批/权限触发消息/待办触达原型验收要求
摄像头台账POST/GET /api/v1/patrol/camerasVideoPlatformConfig未开始 -> 巡课中 -> 已记录 -> 待评分 -> 待整改 -> 整改中 -> 已复盘 -> 已关闭无审批时仍需写操作审计,敏感操作按安全中心规则触发审批巡课整改通知 -> 校长/教师/教研督导原型需展示入口、主按钮、禁用原因、提交中、成功、失败、无权限、空状态和异常转人工入口
地图监控PATCH /api/v1/patrol/cameras/{id}/classroom-bindingVideoGatewayConfig待派单 -> 已派单 -> 已接单 -> 排查中 -> 待恢复校验 -> 已恢复 -> 已关闭 -> 已升级无审批时仍需写操作审计,敏感操作按安全中心规则触发审批教学质量评分通知 -> 教师/校长/教研督导原型需展示入口、主按钮、禁用原因、提交中、成功、失败、无权限、空状态和异常转人工入口
视频直播墙GET /api/v1/patrol/mapClassroomCamera草稿 -> 待审核 -> 已发布 -> 已生效 -> 已停用 -> 已归档无审批时仍需写操作审计,敏感操作按安全中心规则触发审批巡课整改通知 -> 校长/教师/教研督导原型需展示入口、主按钮、禁用原因、提交中、成功、失败、无权限、空状态和异常转人工入口
录像回放GET /api/v1/patrol/map/{campusId}/classroomsPatrolRecordingClipTask海康原生回放下载 -> 宇视时间戳录制下载 -> 能力未配置 -> 通道覆盖 -> 能力禁用无审批时仍需写操作审计,敏感操作按安全中心规则触发审批教学质量评分通知 -> 教师/校长/教研督导原型需展示入口、主按钮、禁用原因、提交中、成功、失败、无权限、空状态和异常转人工入口
教学质量评分POST /api/v1/patrol/live-streamsCampusMapPoint未绑定 -> 待校验 -> 已绑定 -> 绑定失败 -> 跨校区拦截 -> 教室停用拦截 -> 换绑中 -> 已停用无审批时仍需写操作审计,敏感操作按安全中心规则触发审批巡课整改通知 -> 校长/教师/教研督导原型需展示入口、主按钮、禁用原因、提交中、成功、失败、无权限、空状态和异常转人工入口
设备维修工单GET /api/v1/patrol/recordsPatrolRecord未开始 -> 巡课中 -> 已记录 -> 待评分 -> 待整改 -> 整改中 -> 已复盘 -> 已关闭无审批时仍需写操作审计,敏感操作按安全中心规则触发审批教学质量评分通知 -> 教师/校长/教研督导原型需展示入口、主按钮、禁用原因、提交中、成功、失败、无权限、空状态和异常转人工入口
督课评分规则版本POST /api/v1/patrol/records/download-urlTeachingQualityScore待派单 -> 已派单 -> 已接单 -> 排查中 -> 待恢复校验 -> 已恢复 -> 已关闭 -> 已升级无审批时仍需写操作审计,敏感操作按安全中心规则触发审批巡课整改通知 -> 校长/教师/教研督导原型需展示入口、主按钮、禁用原因、提交中、成功、失败、无权限、空状态和异常转人工入口
摄像头绑定教室POST/GET /api/v1/patrol/recording-clip-tasksRectificationTask草稿 -> 待审核 -> 已发布 -> 已生效 -> 已停用 -> 已归档无审批时仍需写操作审计,敏感操作按安全中心规则触发审批教学质量评分通知 -> 教师/校长/教研督导原型需展示入口、主按钮、禁用原因、提交中、成功、失败、无权限、空状态和异常转人工入口
校区地图教室下钻POST /api/v1/patrol/recording-clip-tasks/{id}/retrySnapshotEvidence海康原生回放下载 -> 宇视时间戳录制下载 -> 能力未配置 -> 通道覆盖 -> 能力禁用无审批时仍需写操作审计,敏感操作按安全中心规则触发审批巡课整改通知 -> 校长/教师/教研督导原型需展示入口、主按钮、禁用原因、提交中、成功、失败、无权限、空状态和异常转人工入口
回放能力策略配置POST /api/v1/patrol/quality-scoresVideoPlatformConfig未绑定 -> 待校验 -> 已绑定 -> 绑定失败 -> 跨校区拦截 -> 教室停用拦截 -> 换绑中 -> 已停用无审批时仍需写操作审计,敏感操作按安全中心规则触发审批教学质量评分通知 -> 教师/校长/教研督导原型需展示入口、主按钮、禁用原因、提交中、成功、失败、无权限、空状态和异常转人工入口
海康录像回放下载POST/GET /api/v1/patrol/camerasVideoGatewayConfig未开始 -> 巡课中 -> 已记录 -> 待评分 -> 待整改 -> 整改中 -> 已复盘 -> 已关闭无审批时仍需写操作审计,敏感操作按安全中心规则触发审批巡课整改通知 -> 校长/教师/教研督导原型需展示入口、主按钮、禁用原因、提交中、成功、失败、无权限、空状态和异常转人工入口
宇视时间戳片段录制PATCH /api/v1/patrol/cameras/{id}/classroom-bindingClassroomCamera待派单 -> 已派单 -> 已接单 -> 排查中 -> 待恢复校验 -> 已恢复 -> 已关闭 -> 已升级无审批时仍需写操作审计,敏感操作按安全中心规则触发审批教学质量评分通知 -> 教师/校长/教研督导原型需展示入口、主按钮、禁用原因、提交中、成功、失败、无权限、空状态和异常转人工入口

10 · 原型、UI、研发、测试交付补充

把关键闭环补强为下一阶段可执行任务

本章节为正式 PRD 的交付要求,面向原型图、UI、开发、联调和测试分工。
能力域功能补充要求原型交付要求UI 交互要求研发实现要求测试验收要求
视频接入明确品牌、平台地址、鉴权参数、公网直连、网关、集中机房录像存储和 90 天循环覆盖配置。视频平台配置、网关配置、存储策略 需要在原型中拆到列表、详情、表单、弹窗、空状态、失败态、无权限态和处理进度。UI 需清晰呈现状态标签、流程节点、主次按钮、危险操作确认、移动/平板/TV 适配和错误提示;PC 管理端遵循统一框架,仅输出信息架构和交互说明。后端需提供接口幂等、权限校验、状态机、审计日志、消息/审批触发、异步补偿和跨模块数据一致性保障。测试需覆盖主流程、异常流、权限流、重复提交、批量部分失败和数据一致性;新增校区或设备无需改代码,通过后台配置即可接入。
地图巡课补齐地图监控、点位详情、设备列表、直播播放器、回放时间轴、录像缺失和存储异常提示。校区地图、设备详情、直播页、回放页 需要在原型中拆到列表、详情、表单、弹窗、空状态、失败态、无权限态和处理进度。UI 需清晰呈现状态标签、流程节点、主次按钮、危险操作确认、移动/平板/TV 适配和错误提示;PC 管理端遵循统一框架,仅输出信息架构和交互说明。后端需提供接口幂等、权限校验、状态机、审计日志、消息/审批触发、异步补偿和跨模块数据一致性保障。测试需覆盖主流程、异常流、权限流、重复提交、批量部分失败和数据一致性;点击校区点位可看到设备总数、在线离线数并进入直播/回放。
督课评分补齐评分规则版本、评分维度、截图/片段证据、整改任务、教师反馈和复核关闭。督课任务、评分表、整改复核 需要在原型中拆到列表、详情、表单、弹窗、空状态、失败态、无权限态和处理进度。UI 需清晰呈现状态标签、流程节点、主次按钮、危险操作确认、移动/平板/TV 适配和错误提示;PC 管理端遵循统一框架,仅输出信息架构和交互说明。后端需提供接口幂等、权限校验、状态机、审计日志、消息/审批触发、异步补偿和跨模块数据一致性保障。测试需覆盖主流程、异常流、权限流、重复提交、批量部分失败和数据一致性;每次评分都能追溯规则版本、证据、责任人和整改结果。

11 · 数据对象与字段字典

明确页面、接口、数据库共同使用的数据语言

字段涉及敏感、人脸、财务、绩效时,原型需体现脱敏、授权和审计。

核心对象

对象说明
VideoPlatformConfig海康威视/宇视视频平台配置;落地表:video_platform_config
VideoGatewayConfig门店侧网关与公网直连配置;落地表:video_gateway_config
ClassroomCamera教室摄像头设备清单;落地表:video_classroom_camera
PatrolRecordingClipTask回放片段录制和下载任务;落地表:video_recording_clip_task
CampusMapPoint校区地图点位和设备汇总;落地表:video_campus_map_point
PatrolRecord在线巡课记录;落地表:patrol_record
TeachingQualityScore教学质量评分;落地表:patrol_quality_score
RectificationTask督课整改与复核;落地表:patrol_rectification_task
SnapshotEvidence巡课截图和证据归档;落地表:patrol_snapshot_evidence

关联引用对象

对象说明
Organization集团、区域、校区、部门组织树;引用来源:FND / sys_organization
User/Employee统一登录账号;引用来源:FND / sys_user
Employee员工基础档案;引用来源:FND / sys_employee
Role角色定义;引用来源:FND / sys_role
ApprovalFlow审批流配置;引用来源:FND / sys_approval_flow
MessageTemplate消息模板与多端触达配置;引用来源:FND / sys_message_template
AuditLog全平台操作审计日志;引用来源:FND / sys_audit_log
IntegrationLog接口调用日志;引用来源:OPEN / int_integration_log
SensitiveFieldPolicy敏感字段脱敏策略;引用来源:SEC / sec_sensitive_field_policy
CampusProfile校区档案、经纬度和监管基础信息;引用来源:FND / sys_campus_profile
Classroom校区教室档案与教学空间资源;引用来源:EDU / edu_classroom
Schedule/Lesson课次和排课;引用来源:EDU / edu_lesson
Asset固定资产台账;引用来源:MAT / mat_asset
AssetLifecycle/Maintenance资产维修与生命周期;引用来源:MAT / mat_maintenance_order
LiveRoom直播间;引用来源:LIVE / live_room
MetricSnapshot指标快照;引用来源:BI / bi_metric_snapshot

完整字段字典

对象字段类型必填规则数据级别
VideoPlatformConfigidBIGINT主键,雪花或号段生成,禁止复用普通
VideoPlatformConfigtenant_idBIGINT集团/租户隔离字段,所有查询必须带租户上下文普通
VideoPlatformConfigorg_idBIGINT所属组织,集团级或公共配置为空普通
VideoPlatformConfigcampus_idBIGINT所属校区,跨校区或总部级数据为空普通
VideoPlatformConfigcreated_byBIGINT创建人账号 ID普通
VideoPlatformConfigcreated_atDATETIME创建时间普通
VideoPlatformConfigupdated_byBIGINT最后更新人账号 ID普通
VideoPlatformConfigupdated_atDATETIME最后更新时间普通
VideoPlatformConfigis_deletedTINYINT是否已删除,0 未删除,1 已删除普通
VideoPlatformConfigdeleted_atDATETIME删除时间,未删除为空普通
VideoPlatformConfigdeleted_byBIGINT删除人账号 ID,未删除为空普通
VideoPlatformConfigversionINT乐观锁版本号,写操作必须校验普通
VideoPlatformConfigplatform_codeVARCHAR(64)平台编码,唯一普通
VideoPlatformConfigvendor_codeVARCHAR(32)HIKVISION/UNIVIEW普通
VideoPlatformConfigplatform_nameVARCHAR(128)平台名称普通
VideoPlatformConfigapi_base_urlVARCHAR(512)接口地址普通
VideoPlatformConfigauth_configJSON鉴权参数,密钥加密存储高敏
VideoPlatformConfigrecord_retention_daysINT录像保留天数,默认 90普通
VideoPlatformConfigplayback_capabilityVARCHAR(64)DIRECT_REPLAY_DOWNLOAD/TIMESTAMP_CAPTURE_DOWNLOAD普通
VideoPlatformConfigplayback_policyJSON供应商回放下载策略,海康支持原生回放与录播下载,宇视需拖动到指定时间戳后录制片段再下载普通
VideoPlatformConfigenabledTINYINT是否启用普通
VideoGatewayConfigidBIGINT主键,雪花或号段生成,禁止复用普通
VideoGatewayConfigtenant_idBIGINT集团/租户隔离字段,所有查询必须带租户上下文普通
VideoGatewayConfigorg_idBIGINT所属组织,集团级或公共配置为空普通
VideoGatewayConfigcampus_idBIGINT所属校区,跨校区或总部级数据为空普通
VideoGatewayConfigcreated_byBIGINT创建人账号 ID普通
VideoGatewayConfigcreated_atDATETIME创建时间普通
VideoGatewayConfigupdated_byBIGINT最后更新人账号 ID普通
VideoGatewayConfigupdated_atDATETIME最后更新时间普通
VideoGatewayConfigis_deletedTINYINT是否已删除,0 未删除,1 已删除普通
VideoGatewayConfigdeleted_atDATETIME删除时间,未删除为空普通
VideoGatewayConfigdeleted_byBIGINT删除人账号 ID,未删除为空普通
VideoGatewayConfigversionINT乐观锁版本号,写操作必须校验普通
VideoGatewayConfiggateway_codeVARCHAR(64)网关编码,唯一普通
VideoGatewayConfigplatform_idBIGINT视频平台 ID普通
VideoGatewayConfigaccess_modeVARCHAR(32)公网直连/门店侧网关普通
VideoGatewayConfiggateway_addressVARCHAR(512)网关地址普通
VideoGatewayConfignetwork_statusVARCHAR(32)在线/离线/异常普通
VideoGatewayConfigheartbeat_atDATETIME最近心跳普通
ClassroomCameraidBIGINT主键,雪花或号段生成,禁止复用普通
ClassroomCameratenant_idBIGINT集团/租户隔离字段,所有查询必须带租户上下文普通
ClassroomCameraorg_idBIGINT所属组织,集团级或公共配置为空普通
ClassroomCameracampus_idBIGINT所属校区,跨校区或总部级数据为空;本表业务要求必填普通
ClassroomCameracreated_byBIGINT创建人账号 ID普通
ClassroomCameracreated_atDATETIME创建时间普通
ClassroomCameraupdated_byBIGINT最后更新人账号 ID普通
ClassroomCameraupdated_atDATETIME最后更新时间普通
ClassroomCamerais_deletedTINYINT是否已删除,0 未删除,1 已删除普通
ClassroomCameradeleted_atDATETIME删除时间,未删除为空普通
ClassroomCameradeleted_byBIGINT删除人账号 ID,未删除为空普通
ClassroomCameraversionINT乐观锁版本号,写操作必须校验普通
ClassroomCameracamera_codeVARCHAR(64)摄像头编码,唯一普通
ClassroomCameracamera_nameVARCHAR(128)摄像头名称普通
ClassroomCameraplatform_idBIGINT所属视频平台普通
ClassroomCameragateway_idBIGINT门店网关 ID普通
ClassroomCameraclassroom_idBIGINT绑定教室 ID,必须属于同一校区且教室未逻辑删除普通
ClassroomCamerastream_addressVARCHAR(512)直播流地址普通
ClassroomCameraplayback_modeVARCHAR(64)DIRECT_REPLAY_DOWNLOAD/TIMESTAMP_CAPTURE_DOWNLOAD,继承平台能力且可按通道覆盖普通
ClassroomCamerarecord_channel_noVARCHAR(64)供应商录像通道号普通
ClassroomCameracamera_statusVARCHAR(32)在线/离线/停用/异常普通
PatrolRecordingClipTaskidBIGINT主键,雪花或号段生成,禁止复用普通
PatrolRecordingClipTasktenant_idBIGINT集团/租户隔离字段,所有查询必须带租户上下文普通
PatrolRecordingClipTaskorg_idBIGINT所属组织,集团级或公共配置为空普通
PatrolRecordingClipTaskcampus_idBIGINT所属校区,跨校区或总部级数据为空;本表业务要求必填普通
PatrolRecordingClipTaskcreated_byBIGINT创建人账号 ID普通
PatrolRecordingClipTaskcreated_atDATETIME创建时间普通
PatrolRecordingClipTaskupdated_byBIGINT最后更新人账号 ID普通
PatrolRecordingClipTaskupdated_atDATETIME最后更新时间普通
PatrolRecordingClipTaskis_deletedTINYINT是否已删除,0 未删除,1 已删除普通
PatrolRecordingClipTaskdeleted_atDATETIME删除时间,未删除为空普通
PatrolRecordingClipTaskdeleted_byBIGINT删除人账号 ID,未删除为空普通
PatrolRecordingClipTaskversionINT乐观锁版本号,写操作必须校验普通
PatrolRecordingClipTaskclip_task_noVARCHAR(64)片段任务编号,唯一普通
PatrolRecordingClipTaskcamera_idBIGINT摄像头 ID普通
PatrolRecordingClipTaskvendor_codeVARCHAR(32)HIKVISION/UNIVIEW普通
PatrolRecordingClipTaskrecord_start_atDATETIME片段开始时间普通
PatrolRecordingClipTaskrecord_end_atDATETIME片段结束时间普通
PatrolRecordingClipTaskanchor_timestampDATETIME宇视拖动定位时间戳普通
PatrolRecordingClipTasktask_modeVARCHAR(64)原生下载/时间戳定位录制/手动补录普通
PatrolRecordingClipTasktask_statusVARCHAR(32)待处理/录制中/可下载/失败/已过期普通
PatrolRecordingClipTaskdownload_urlVARCHAR(512)下载地址普通
PatrolRecordingClipTaskexpire_atDATETIME下载链接过期时间普通
PatrolRecordingClipTaskfailure_reasonVARCHAR(512)失败原因普通
CampusMapPointidBIGINT主键,雪花或号段生成,禁止复用普通
CampusMapPointtenant_idBIGINT集团/租户隔离字段,所有查询必须带租户上下文普通
CampusMapPointorg_idBIGINT所属组织,集团级或公共配置为空普通
CampusMapPointcampus_idBIGINT所属校区,跨校区或总部级数据为空;本表业务要求必填普通
CampusMapPointcreated_byBIGINT创建人账号 ID普通
CampusMapPointcreated_atDATETIME创建时间普通
CampusMapPointupdated_byBIGINT最后更新人账号 ID普通
CampusMapPointupdated_atDATETIME最后更新时间普通
CampusMapPointis_deletedTINYINT是否已删除,0 未删除,1 已删除普通
CampusMapPointdeleted_atDATETIME删除时间,未删除为空普通
CampusMapPointdeleted_byBIGINT删除人账号 ID,未删除为空普通
CampusMapPointversionINT乐观锁版本号,写操作必须校验普通
CampusMapPointlongitudeDECIMAL(12,8)经度,后台动态配置普通
CampusMapPointlatitudeDECIMAL(12,8)纬度,后台动态配置普通
CampusMapPointdevice_totalINT地图大头钉展示设备总数普通
CampusMapPointonline_totalINT在线设备数普通
CampusMapPointpoint_statusVARCHAR(32)正常/异常/未配置普通
PatrolRecordidBIGINT主键,雪花或号段生成,禁止复用普通
PatrolRecordtenant_idBIGINT集团/租户隔离字段,所有查询必须带租户上下文普通
PatrolRecordorg_idBIGINT所属组织,集团级或公共配置为空普通
PatrolRecordcampus_idBIGINT所属校区,跨校区或总部级数据为空普通
PatrolRecordcreated_byBIGINT创建人账号 ID普通
PatrolRecordcreated_atDATETIME创建时间普通
PatrolRecordupdated_byBIGINT最后更新人账号 ID普通
PatrolRecordupdated_atDATETIME最后更新时间普通
PatrolRecordis_deletedTINYINT是否已删除,0 未删除,1 已删除普通
PatrolRecorddeleted_atDATETIME删除时间,未删除为空普通
PatrolRecorddeleted_byBIGINT删除人账号 ID,未删除为空普通
PatrolRecordversionINT乐观锁版本号,写操作必须校验普通
PatrolRecordpatrol_noVARCHAR(64)巡课编号,唯一普通
PatrolRecordcamera_idBIGINT摄像头 ID普通
PatrolRecordlesson_idBIGINT课次 ID普通
PatrolRecordpatrol_user_idBIGINT巡课人员 ID普通
PatrolRecordstart_atDATETIME巡课开始时间普通
PatrolRecordend_atDATETIME巡课结束时间普通
PatrolRecordpatrol_statusVARCHAR(32)进行中/已完成/异常中断普通
TeachingQualityScoreidBIGINT主键,雪花或号段生成,禁止复用普通
TeachingQualityScoretenant_idBIGINT集团/租户隔离字段,所有查询必须带租户上下文普通
TeachingQualityScoreorg_idBIGINT所属组织,集团级或公共配置为空普通
TeachingQualityScorecampus_idBIGINT所属校区,跨校区或总部级数据为空普通
TeachingQualityScorecreated_byBIGINT创建人账号 ID普通
TeachingQualityScorecreated_atDATETIME创建时间普通
TeachingQualityScoreupdated_byBIGINT最后更新人账号 ID普通
TeachingQualityScoreupdated_atDATETIME最后更新时间普通
TeachingQualityScoreis_deletedTINYINT是否已删除,0 未删除,1 已删除普通
TeachingQualityScoredeleted_atDATETIME删除时间,未删除为空普通
TeachingQualityScoredeleted_byBIGINT删除人账号 ID,未删除为空普通
TeachingQualityScoreversionINT乐观锁版本号,写操作必须校验普通
TeachingQualityScorescore_noVARCHAR(64)评分编号,唯一普通
TeachingQualityScorepatrol_record_idBIGINT巡课记录 ID普通
TeachingQualityScoreteacher_idBIGINT教师 ID普通
TeachingQualityScorestudent_dimension_jsonJSON学生维度评分普通
TeachingQualityScoreteacher_dimension_jsonJSON教师维度评分普通
TeachingQualityScoretotal_scoreDECIMAL(6,2)综合得分普通
TeachingQualityScorescore_statusVARCHAR(32)草稿/已提交/已复核/已驳回普通
RectificationTaskidBIGINT主键,雪花或号段生成,禁止复用普通
RectificationTasktenant_idBIGINT集团/租户隔离字段,所有查询必须带租户上下文普通
RectificationTaskorg_idBIGINT所属组织,集团级或公共配置为空普通
RectificationTaskcampus_idBIGINT所属校区,跨校区或总部级数据为空普通
RectificationTaskcreated_byBIGINT创建人账号 ID普通
RectificationTaskcreated_atDATETIME创建时间普通
RectificationTaskupdated_byBIGINT最后更新人账号 ID普通
RectificationTaskupdated_atDATETIME最后更新时间普通
RectificationTaskis_deletedTINYINT是否已删除,0 未删除,1 已删除普通
RectificationTaskdeleted_atDATETIME删除时间,未删除为空普通
RectificationTaskdeleted_byBIGINT删除人账号 ID,未删除为空普通
RectificationTaskversionINT乐观锁版本号,写操作必须校验普通
RectificationTasktask_noVARCHAR(64)整改任务编号,唯一普通
RectificationTaskscore_idBIGINT评分 ID普通
RectificationTaskowner_idBIGINT责任人 ID普通
RectificationTaskrectify_requirementTEXT整改要求普通
RectificationTaskdeadline_atDATETIME整改截止时间普通
RectificationTaskverify_resultVARCHAR(32)复核结果普通
RectificationTasktask_statusVARCHAR(32)待整改/待复核/已关闭/逾期普通
SnapshotEvidenceidBIGINT主键,雪花或号段生成,禁止复用普通
SnapshotEvidencetenant_idBIGINT集团/租户隔离字段,所有查询必须带租户上下文普通
SnapshotEvidenceorg_idBIGINT所属组织,集团级或公共配置为空普通
SnapshotEvidencecampus_idBIGINT所属校区,跨校区或总部级数据为空普通
SnapshotEvidencecreated_byBIGINT创建人账号 ID普通
SnapshotEvidencecreated_atDATETIME创建时间普通
SnapshotEvidenceupdated_byBIGINT最后更新人账号 ID普通
SnapshotEvidenceupdated_atDATETIME最后更新时间普通
SnapshotEvidenceis_deletedTINYINT是否已删除,0 未删除,1 已删除普通
SnapshotEvidencedeleted_atDATETIME删除时间,未删除为空普通
SnapshotEvidencedeleted_byBIGINT删除人账号 ID,未删除为空普通
SnapshotEvidenceversionINT乐观锁版本号,写操作必须校验普通
SnapshotEvidencepatrol_record_idBIGINT巡课记录 ID普通
SnapshotEvidencecapture_atDATETIME截图时间普通
SnapshotEvidencefile_idBIGINT图片或视频文件 ID普通
SnapshotEvidenceevidence_typeVARCHAR(32)截图/片段/备注/异常普通
SnapshotEvidenceevidence_descVARCHAR(512)证据说明普通
SnapshotEvidencevisible_scopeVARCHAR(32)总部/校区/责任人/审计普通

引用对象字段字典

引用表对象字段类型必填规则数据级别
sys_organizationOrganizationidBIGINT主键,雪花或号段生成,禁止复用普通
sys_organizationOrganizationtenant_idBIGINT集团/租户隔离字段,所有查询必须带租户上下文普通
sys_organizationOrganizationorg_idBIGINT所属组织,集团级或公共配置为空普通
sys_organizationOrganizationcampus_idBIGINT所属校区,跨校区或总部级数据为空普通
sys_organizationOrganizationcreated_byBIGINT创建人账号 ID普通
sys_organizationOrganizationcreated_atDATETIME创建时间普通
sys_organizationOrganizationupdated_byBIGINT最后更新人账号 ID普通
sys_organizationOrganizationupdated_atDATETIME最后更新时间普通
sys_organizationOrganizationis_deletedTINYINT是否已删除,0 未删除,1 已删除普通
sys_organizationOrganizationdeleted_atDATETIME删除时间,未删除为空普通
sys_organizationOrganizationdeleted_byBIGINT删除人账号 ID,未删除为空普通
sys_organizationOrganizationversionINT乐观锁版本号,写操作必须校验普通
sys_organizationOrganizationorg_codeVARCHAR(64)组织编码,租户内唯一普通
sys_organizationOrganizationorg_nameVARCHAR(128)组织名称普通
sys_organizationOrganizationorg_typeVARCHAR(32)集团/区域/校区/部门/法人主体普通
sys_organizationOrganizationparent_idBIGINT上级组织 ID,根节点为空普通
sys_organizationOrganizationsort_noINT同级排序普通
sys_organizationOrganizationenabledTINYINT是否启用普通
sys_userUser/EmployeeidBIGINT主键,雪花或号段生成,禁止复用普通
sys_userUser/Employeetenant_idBIGINT集团/租户隔离字段,所有查询必须带租户上下文普通
sys_userUser/Employeeorg_idBIGINT所属组织,集团级或公共配置为空普通
sys_userUser/Employeecampus_idBIGINT所属校区,跨校区或总部级数据为空普通
sys_userUser/Employeecreated_byBIGINT创建人账号 ID普通
sys_userUser/Employeecreated_atDATETIME创建时间普通
sys_userUser/Employeeupdated_byBIGINT最后更新人账号 ID普通
sys_userUser/Employeeupdated_atDATETIME最后更新时间普通
sys_userUser/Employeeis_deletedTINYINT是否已删除,0 未删除,1 已删除普通
sys_userUser/Employeedeleted_atDATETIME删除时间,未删除为空普通
sys_userUser/Employeedeleted_byBIGINT删除人账号 ID,未删除为空普通
sys_userUser/EmployeeversionINT乐观锁版本号,写操作必须校验普通
sys_userUser/Employeeuser_noVARCHAR(64)账号编号,唯一普通
sys_userUser/Employeelogin_nameVARCHAR(64)登录名,唯一普通
sys_userUser/EmployeemobileVARCHAR(32)手机号,敏感脱敏展示敏感
sys_userUser/Employeepassword_hashVARCHAR(255)密码哈希,禁止前端返回高敏
sys_userUser/Employeeuser_typeVARCHAR(32)员工/学员/家长/外部账号普通
sys_userUser/Employeelogin_statusVARCHAR(32)正常/锁定/停用/待激活普通
sys_employeeEmployeeidBIGINT主键,雪花或号段生成,禁止复用普通
sys_employeeEmployeetenant_idBIGINT集团/租户隔离字段,所有查询必须带租户上下文普通
sys_employeeEmployeeorg_idBIGINT所属组织,集团级或公共配置为空普通
sys_employeeEmployeecampus_idBIGINT所属校区,跨校区或总部级数据为空普通
sys_employeeEmployeecreated_byBIGINT创建人账号 ID普通
sys_employeeEmployeecreated_atDATETIME创建时间普通
sys_employeeEmployeeupdated_byBIGINT最后更新人账号 ID普通
sys_employeeEmployeeupdated_atDATETIME最后更新时间普通
sys_employeeEmployeeis_deletedTINYINT是否已删除,0 未删除,1 已删除普通
sys_employeeEmployeedeleted_atDATETIME删除时间,未删除为空普通
sys_employeeEmployeedeleted_byBIGINT删除人账号 ID,未删除为空普通
sys_employeeEmployeeversionINT乐观锁版本号,写操作必须校验普通
sys_employeeEmployeeemployee_noVARCHAR(64)工号,唯一普通
sys_employeeEmployeeuser_idBIGINT关联账号 ID普通
sys_employeeEmployeeemployee_nameVARCHAR(64)员工姓名普通
sys_employeeEmployeeprimary_campus_idBIGINT主校区 ID普通
sys_employeeEmployeejob_titleVARCHAR(64)岗位名称普通
sys_employeeEmployeehire_statusVARCHAR(32)在职/试用/离职/停用普通
sys_roleRoleidBIGINT主键,雪花或号段生成,禁止复用普通
sys_roleRoletenant_idBIGINT集团/租户隔离字段,所有查询必须带租户上下文普通
sys_roleRoleorg_idBIGINT所属组织,集团级或公共配置为空普通
sys_roleRolecampus_idBIGINT所属校区,跨校区或总部级数据为空普通
sys_roleRolecreated_byBIGINT创建人账号 ID普通
sys_roleRolecreated_atDATETIME创建时间普通
sys_roleRoleupdated_byBIGINT最后更新人账号 ID普通
sys_roleRoleupdated_atDATETIME最后更新时间普通
sys_roleRoleis_deletedTINYINT是否已删除,0 未删除,1 已删除普通
sys_roleRoledeleted_atDATETIME删除时间,未删除为空普通
sys_roleRoledeleted_byBIGINT删除人账号 ID,未删除为空普通
sys_roleRoleversionINT乐观锁版本号,写操作必须校验普通
sys_roleRolerole_codeVARCHAR(64)角色编码,唯一普通
sys_roleRolerole_nameVARCHAR(128)角色名称普通
sys_roleRolerole_levelVARCHAR(32)总部/区域/校区/个人普通
sys_roleRoledata_scope_typeVARCHAR(32)数据范围类型普通
sys_roleRoleenabledTINYINT是否启用普通
sys_approval_flowApprovalFlowidBIGINT主键,雪花或号段生成,禁止复用普通
sys_approval_flowApprovalFlowtenant_idBIGINT集团/租户隔离字段,所有查询必须带租户上下文普通
sys_approval_flowApprovalFloworg_idBIGINT所属组织,集团级或公共配置为空普通
sys_approval_flowApprovalFlowcampus_idBIGINT所属校区,跨校区或总部级数据为空普通
sys_approval_flowApprovalFlowcreated_byBIGINT创建人账号 ID普通
sys_approval_flowApprovalFlowcreated_atDATETIME创建时间普通
sys_approval_flowApprovalFlowupdated_byBIGINT最后更新人账号 ID普通
sys_approval_flowApprovalFlowupdated_atDATETIME最后更新时间普通
sys_approval_flowApprovalFlowis_deletedTINYINT是否已删除,0 未删除,1 已删除普通
sys_approval_flowApprovalFlowdeleted_atDATETIME删除时间,未删除为空普通
sys_approval_flowApprovalFlowdeleted_byBIGINT删除人账号 ID,未删除为空普通
sys_approval_flowApprovalFlowversionINT乐观锁版本号,写操作必须校验普通
sys_approval_flowApprovalFlowflow_codeVARCHAR(64)审批流编码,唯一普通
sys_approval_flowApprovalFlowbiz_typeVARCHAR(64)业务类型普通
sys_approval_flowApprovalFlowflow_nameVARCHAR(128)审批流名称普通
sys_approval_flowApprovalFlowcondition_jsonJSON触发条件普通
sys_approval_flowApprovalFlownode_jsonJSON节点、审批人和超时规则普通
sys_approval_flowApprovalFlowversion_noINT审批流版本号普通
sys_approval_flowApprovalFlowenabledTINYINT是否启用普通
sys_message_templateMessageTemplateidBIGINT主键,雪花或号段生成,禁止复用普通
sys_message_templateMessageTemplatetenant_idBIGINT集团/租户隔离字段,所有查询必须带租户上下文普通
sys_message_templateMessageTemplateorg_idBIGINT所属组织,集团级或公共配置为空普通
sys_message_templateMessageTemplatecampus_idBIGINT所属校区,跨校区或总部级数据为空普通
sys_message_templateMessageTemplatecreated_byBIGINT创建人账号 ID普通
sys_message_templateMessageTemplatecreated_atDATETIME创建时间普通
sys_message_templateMessageTemplateupdated_byBIGINT最后更新人账号 ID普通
sys_message_templateMessageTemplateupdated_atDATETIME最后更新时间普通
sys_message_templateMessageTemplateis_deletedTINYINT是否已删除,0 未删除,1 已删除普通
sys_message_templateMessageTemplatedeleted_atDATETIME删除时间,未删除为空普通
sys_message_templateMessageTemplatedeleted_byBIGINT删除人账号 ID,未删除为空普通
sys_message_templateMessageTemplateversionINT乐观锁版本号,写操作必须校验普通
sys_message_templateMessageTemplatetemplate_codeVARCHAR(64)模板编码,唯一普通
sys_message_templateMessageTemplatetemplate_nameVARCHAR(128)模板名称普通
sys_message_templateMessageTemplatechannelVARCHAR(32)站内信/短信/微信小程序/企微/Push普通
sys_message_templateMessageTemplatereceiver_ruleJSON接收人规则普通
sys_message_templateMessageTemplatecontent_templateTEXT模板内容普通
sys_message_templateMessageTemplateenabledTINYINT是否启用普通
sys_audit_logAuditLogidBIGINT主键,雪花或号段生成,禁止复用普通
sys_audit_logAuditLogtenant_idBIGINT集团/租户隔离字段,所有查询必须带租户上下文普通
sys_audit_logAuditLogorg_idBIGINT所属组织,集团级或公共配置为空普通
sys_audit_logAuditLogcampus_idBIGINT所属校区,跨校区或总部级数据为空普通
sys_audit_logAuditLogcreated_byBIGINT创建人账号 ID普通
sys_audit_logAuditLogcreated_atDATETIME创建时间普通
sys_audit_logAuditLogupdated_byBIGINT最后更新人账号 ID普通
sys_audit_logAuditLogupdated_atDATETIME最后更新时间普通
sys_audit_logAuditLogis_deletedTINYINT是否已删除,0 未删除,1 已删除普通
sys_audit_logAuditLogdeleted_atDATETIME删除时间,未删除为空普通
sys_audit_logAuditLogdeleted_byBIGINT删除人账号 ID,未删除为空普通
sys_audit_logAuditLogversionINT乐观锁版本号,写操作必须校验普通
sys_audit_logAuditLogoperator_idBIGINT操作人 ID普通
sys_audit_logAuditLogbiz_typeVARCHAR(64)业务类型普通
sys_audit_logAuditLogbiz_idBIGINT业务主键 ID普通
sys_audit_logAuditLogaction_codeVARCHAR(64)操作编码普通
sys_audit_logAuditLogbefore_snapshotJSON变更前快照普通
sys_audit_logAuditLogafter_snapshotJSON变更后快照普通
sys_audit_logAuditLogip_addressVARCHAR(64)操作 IP普通
int_integration_logIntegrationLogidBIGINT主键,雪花或号段生成,禁止复用普通
int_integration_logIntegrationLogtenant_idBIGINT集团/租户隔离字段,所有查询必须带租户上下文普通
int_integration_logIntegrationLogorg_idBIGINT所属组织,集团级或公共配置为空普通
int_integration_logIntegrationLogcampus_idBIGINT所属校区,跨校区或总部级数据为空普通
int_integration_logIntegrationLogcreated_byBIGINT创建人账号 ID普通
int_integration_logIntegrationLogcreated_atDATETIME创建时间普通
int_integration_logIntegrationLogupdated_byBIGINT最后更新人账号 ID普通
int_integration_logIntegrationLogupdated_atDATETIME最后更新时间普通
int_integration_logIntegrationLogis_deletedTINYINT是否已删除,0 未删除,1 已删除普通
int_integration_logIntegrationLogdeleted_atDATETIME删除时间,未删除为空普通
int_integration_logIntegrationLogdeleted_byBIGINT删除人账号 ID,未删除为空普通
int_integration_logIntegrationLogversionINT乐观锁版本号,写操作必须校验普通
int_integration_logIntegrationLogrequest_idVARCHAR(128)请求 ID,幂等键普通
int_integration_logIntegrationLogsystem_codeVARCHAR(64)外部系统编码普通
int_integration_logIntegrationLogapi_pathVARCHAR(512)接口路径普通
int_integration_logIntegrationLogbiz_typeVARCHAR(64)业务类型普通
int_integration_logIntegrationLogbiz_idBIGINT业务 ID普通
int_integration_logIntegrationLogrequest_payloadJSON请求报文,敏感字段脱敏敏感
int_integration_logIntegrationLogresponse_payloadJSON响应报文普通
int_integration_logIntegrationLogcall_statusVARCHAR(32)成功/失败/超时/重试中普通
sec_sensitive_field_policySensitiveFieldPolicyidBIGINT主键,雪花或号段生成,禁止复用普通
sec_sensitive_field_policySensitiveFieldPolicytenant_idBIGINT集团/租户隔离字段,所有查询必须带租户上下文普通
sec_sensitive_field_policySensitiveFieldPolicyorg_idBIGINT所属组织,集团级或公共配置为空普通
sec_sensitive_field_policySensitiveFieldPolicycampus_idBIGINT所属校区,跨校区或总部级数据为空普通
sec_sensitive_field_policySensitiveFieldPolicycreated_byBIGINT创建人账号 ID普通
sec_sensitive_field_policySensitiveFieldPolicycreated_atDATETIME创建时间普通
sec_sensitive_field_policySensitiveFieldPolicyupdated_byBIGINT最后更新人账号 ID普通
sec_sensitive_field_policySensitiveFieldPolicyupdated_atDATETIME最后更新时间普通
sec_sensitive_field_policySensitiveFieldPolicyis_deletedTINYINT是否已删除,0 未删除,1 已删除普通
sec_sensitive_field_policySensitiveFieldPolicydeleted_atDATETIME删除时间,未删除为空普通
sec_sensitive_field_policySensitiveFieldPolicydeleted_byBIGINT删除人账号 ID,未删除为空普通
sec_sensitive_field_policySensitiveFieldPolicyversionINT乐观锁版本号,写操作必须校验普通
sec_sensitive_field_policySensitiveFieldPolicyfield_codeVARCHAR(128)字段编码,唯一普通
sec_sensitive_field_policySensitiveFieldPolicybiz_typeVARCHAR(64)业务类型普通
sec_sensitive_field_policySensitiveFieldPolicymask_ruleVARCHAR(64)脱敏规则普通
sec_sensitive_field_policySensitiveFieldPolicyview_requires_approvalTINYINT明文查看是否需审批普通
sec_sensitive_field_policySensitiveFieldPolicywatermark_requiredTINYINT是否加水印普通
sys_campus_profileCampusProfileidBIGINT主键,雪花或号段生成,禁止复用普通
sys_campus_profileCampusProfiletenant_idBIGINT集团/租户隔离字段,所有查询必须带租户上下文普通
sys_campus_profileCampusProfileorg_idBIGINT所属组织,集团级或公共配置为空普通
sys_campus_profileCampusProfilecampus_idBIGINT所属校区,跨校区或总部级数据为空普通
sys_campus_profileCampusProfilecreated_byBIGINT创建人账号 ID普通
sys_campus_profileCampusProfilecreated_atDATETIME创建时间普通
sys_campus_profileCampusProfileupdated_byBIGINT最后更新人账号 ID普通
sys_campus_profileCampusProfileupdated_atDATETIME最后更新时间普通
sys_campus_profileCampusProfileis_deletedTINYINT是否已删除,0 未删除,1 已删除普通
sys_campus_profileCampusProfiledeleted_atDATETIME删除时间,未删除为空普通
sys_campus_profileCampusProfiledeleted_byBIGINT删除人账号 ID,未删除为空普通
sys_campus_profileCampusProfileversionINT乐观锁版本号,写操作必须校验普通
sys_campus_profileCampusProfilecampus_codeVARCHAR(64)校区编码,唯一普通
sys_campus_profileCampusProfilecampus_nameVARCHAR(128)校区名称普通
sys_campus_profileCampusProfilelegal_entity_idBIGINT所属法人主体普通
sys_campus_profileCampusProfileaddressVARCHAR(255)校区地址普通
sys_campus_profileCampusProfilelongitudeDECIMAL(12,8)地图经度,后台动态配置普通
sys_campus_profileCampusProfilelatitudeDECIMAL(12,8)地图纬度,后台动态配置普通
sys_campus_profileCampusProfilebusiness_hoursJSON营业时间配置普通
edu_classroomClassroomidBIGINT主键,雪花或号段生成,禁止复用普通
edu_classroomClassroomtenant_idBIGINT集团/租户隔离字段,所有查询必须带租户上下文普通
edu_classroomClassroomorg_idBIGINT所属组织,集团级或公共配置为空普通
edu_classroomClassroomcampus_idBIGINT所属校区,跨校区或总部级数据为空;本表业务要求必填普通
edu_classroomClassroomcreated_byBIGINT创建人账号 ID普通
edu_classroomClassroomcreated_atDATETIME创建时间普通
edu_classroomClassroomupdated_byBIGINT最后更新人账号 ID普通
edu_classroomClassroomupdated_atDATETIME最后更新时间普通
edu_classroomClassroomis_deletedTINYINT是否已删除,0 未删除,1 已删除普通
edu_classroomClassroomdeleted_atDATETIME删除时间,未删除为空普通
edu_classroomClassroomdeleted_byBIGINT删除人账号 ID,未删除为空普通
edu_classroomClassroomversionINT乐观锁版本号,写操作必须校验普通
edu_classroomClassroomclassroom_codeVARCHAR(64)教室编码,同一校区内唯一普通
edu_classroomClassroomclassroom_nameVARCHAR(128)教室名称普通
edu_classroomClassroomclassroom_typeVARCHAR(32)普通教室/多媒体教室/直播教室/一对一教室/活动教室普通
edu_classroomClassroombuilding_nameVARCHAR(128)楼栋或校区内部区域普通
edu_classroomClassroomfloor_noVARCHAR(32)楼层或楼层描述普通
edu_classroomClassroomcapacityINT教室容量,必须大于 0普通
edu_classroomClassroomequipment_profileJSON教室内 TV、摄像头、考勤机、音响、白板等设备能力摘要普通
edu_classroomClassroomclassroom_statusVARCHAR(32)可用/停用/维修中/装修中/已关闭普通
edu_classroomClassroomenabledTINYINT是否启用,停用后禁止新排课普通
edu_lessonSchedule/LessonidBIGINT主键,雪花或号段生成,禁止复用普通
edu_lessonSchedule/Lessontenant_idBIGINT集团/租户隔离字段,所有查询必须带租户上下文普通
edu_lessonSchedule/Lessonorg_idBIGINT所属组织,集团级或公共配置为空普通
edu_lessonSchedule/Lessoncampus_idBIGINT所属校区,跨校区或总部级数据为空普通
edu_lessonSchedule/Lessoncreated_byBIGINT创建人账号 ID普通
edu_lessonSchedule/Lessoncreated_atDATETIME创建时间普通
edu_lessonSchedule/Lessonupdated_byBIGINT最后更新人账号 ID普通
edu_lessonSchedule/Lessonupdated_atDATETIME最后更新时间普通
edu_lessonSchedule/Lessonis_deletedTINYINT是否已删除,0 未删除,1 已删除普通
edu_lessonSchedule/Lessondeleted_atDATETIME删除时间,未删除为空普通
edu_lessonSchedule/Lessondeleted_byBIGINT删除人账号 ID,未删除为空普通
edu_lessonSchedule/LessonversionINT乐观锁版本号,写操作必须校验普通
edu_lessonSchedule/Lessonlesson_noVARCHAR(64)课次编号,唯一普通
edu_lessonSchedule/Lessonclass_idBIGINT班级 ID普通
edu_lessonSchedule/Lessonteacher_idBIGINT授课教师 ID普通
edu_lessonSchedule/Lessonclassroom_idBIGINT教室 ID普通
edu_lessonSchedule/Lessonstart_atDATETIME上课开始时间普通
edu_lessonSchedule/Lessonend_atDATETIME上课结束时间普通
edu_lessonSchedule/Lessonlesson_statusVARCHAR(32)待上课/上课中/已下课/已取消/需补课普通
mat_assetAssetidBIGINT主键,雪花或号段生成,禁止复用普通
mat_assetAssettenant_idBIGINT集团/租户隔离字段,所有查询必须带租户上下文普通
mat_assetAssetorg_idBIGINT所属组织,集团级或公共配置为空普通
mat_assetAssetcampus_idBIGINT所属校区,跨校区或总部级数据为空普通
mat_assetAssetcreated_byBIGINT创建人账号 ID普通
mat_assetAssetcreated_atDATETIME创建时间普通
mat_assetAssetupdated_byBIGINT最后更新人账号 ID普通
mat_assetAssetupdated_atDATETIME最后更新时间普通
mat_assetAssetis_deletedTINYINT是否已删除,0 未删除,1 已删除普通
mat_assetAssetdeleted_atDATETIME删除时间,未删除为空普通
mat_assetAssetdeleted_byBIGINT删除人账号 ID,未删除为空普通
mat_assetAssetversionINT乐观锁版本号,写操作必须校验普通
mat_assetAssetasset_noVARCHAR(64)资产编号,唯一普通
mat_assetAssetsku_idBIGINT资产 SKU普通
mat_assetAssetowner_org_idBIGINT归属组织普通
mat_assetAssetkeeper_idBIGINT保管人普通
mat_assetAssetpurchase_dateDATE购置日期普通
mat_assetAssetasset_statusVARCHAR(32)在用/闲置/维修/报废/调拨中普通
mat_maintenance_orderAssetLifecycle/MaintenanceidBIGINT主键,雪花或号段生成,禁止复用普通
mat_maintenance_orderAssetLifecycle/Maintenancetenant_idBIGINT集团/租户隔离字段,所有查询必须带租户上下文普通
mat_maintenance_orderAssetLifecycle/Maintenanceorg_idBIGINT所属组织,集团级或公共配置为空普通
mat_maintenance_orderAssetLifecycle/Maintenancecampus_idBIGINT所属校区,跨校区或总部级数据为空普通
mat_maintenance_orderAssetLifecycle/Maintenancecreated_byBIGINT创建人账号 ID普通
mat_maintenance_orderAssetLifecycle/Maintenancecreated_atDATETIME创建时间普通
mat_maintenance_orderAssetLifecycle/Maintenanceupdated_byBIGINT最后更新人账号 ID普通
mat_maintenance_orderAssetLifecycle/Maintenanceupdated_atDATETIME最后更新时间普通
mat_maintenance_orderAssetLifecycle/Maintenanceis_deletedTINYINT是否已删除,0 未删除,1 已删除普通
mat_maintenance_orderAssetLifecycle/Maintenancedeleted_atDATETIME删除时间,未删除为空普通
mat_maintenance_orderAssetLifecycle/Maintenancedeleted_byBIGINT删除人账号 ID,未删除为空普通
mat_maintenance_orderAssetLifecycle/MaintenanceversionINT乐观锁版本号,写操作必须校验普通
mat_maintenance_orderAssetLifecycle/Maintenancemaintenance_noVARCHAR(64)维修单编号,唯一普通
mat_maintenance_orderAssetLifecycle/Maintenanceasset_idBIGINT资产 ID普通
mat_maintenance_orderAssetLifecycle/Maintenancefault_descVARCHAR(512)故障描述普通
mat_maintenance_orderAssetLifecycle/Maintenancerepair_vendor_idBIGINT维修供应商普通
mat_maintenance_orderAssetLifecycle/Maintenancerepair_amountDECIMAL(18,2)维修金额普通
mat_maintenance_orderAssetLifecycle/Maintenancemaintenance_statusVARCHAR(32)待维修/维修中/已完成/已报废普通
live_roomLiveRoomidBIGINT主键,雪花或号段生成,禁止复用普通
live_roomLiveRoomtenant_idBIGINT集团/租户隔离字段,所有查询必须带租户上下文普通
live_roomLiveRoomorg_idBIGINT所属组织,集团级或公共配置为空普通
live_roomLiveRoomcampus_idBIGINT所属校区,跨校区或总部级数据为空普通
live_roomLiveRoomcreated_byBIGINT创建人账号 ID普通
live_roomLiveRoomcreated_atDATETIME创建时间普通
live_roomLiveRoomupdated_byBIGINT最后更新人账号 ID普通
live_roomLiveRoomupdated_atDATETIME最后更新时间普通
live_roomLiveRoomis_deletedTINYINT是否已删除,0 未删除,1 已删除普通
live_roomLiveRoomdeleted_atDATETIME删除时间,未删除为空普通
live_roomLiveRoomdeleted_byBIGINT删除人账号 ID,未删除为空普通
live_roomLiveRoomversionINT乐观锁版本号,写操作必须校验普通
live_roomLiveRoomroom_noVARCHAR(64)直播间编号,唯一普通
live_roomLiveRoomlive_typeVARCHAR(32)教学直播/活动直播/集团会议直播普通
live_roomLiveRoomprovider_codeVARCHAR(32)启用供应商普通
live_roomLiveRoombiz_typeVARCHAR(64)绑定业务类型普通
live_roomLiveRoombiz_idBIGINT绑定业务 ID普通
live_roomLiveRoomstart_atDATETIME计划开始时间普通
live_roomLiveRoomend_atDATETIME计划结束时间普通
live_roomLiveRoomroom_statusVARCHAR(32)待开播/直播中/已结束/异常普通
bi_metric_snapshotMetricSnapshotidBIGINT主键,雪花或号段生成,禁止复用普通
bi_metric_snapshotMetricSnapshottenant_idBIGINT集团/租户隔离字段,所有查询必须带租户上下文普通
bi_metric_snapshotMetricSnapshotorg_idBIGINT所属组织,集团级或公共配置为空普通
bi_metric_snapshotMetricSnapshotcampus_idBIGINT所属校区,跨校区或总部级数据为空普通
bi_metric_snapshotMetricSnapshotcreated_byBIGINT创建人账号 ID普通
bi_metric_snapshotMetricSnapshotcreated_atDATETIME创建时间普通
bi_metric_snapshotMetricSnapshotupdated_byBIGINT最后更新人账号 ID普通
bi_metric_snapshotMetricSnapshotupdated_atDATETIME最后更新时间普通
bi_metric_snapshotMetricSnapshotis_deletedTINYINT是否已删除,0 未删除,1 已删除普通
bi_metric_snapshotMetricSnapshotdeleted_atDATETIME删除时间,未删除为空普通
bi_metric_snapshotMetricSnapshotdeleted_byBIGINT删除人账号 ID,未删除为空普通
bi_metric_snapshotMetricSnapshotversionINT乐观锁版本号,写操作必须校验普通
bi_metric_snapshotMetricSnapshotmetric_codeVARCHAR(64)指标编码普通
bi_metric_snapshotMetricSnapshotstat_dateDATE统计日期普通
bi_metric_snapshotMetricSnapshotdimension_jsonJSON维度值普通
bi_metric_snapshotMetricSnapshotmetric_valueDECIMAL(18,4)指标值普通

JSON 字段结构与校验

表名对象字段结构编码结构定义校验规则示例
video_platform_configVideoPlatformConfigauth_configVIDEO_AUTH{appKeyRef:string, secretRef:string, tokenUrl?:string, expireSeconds:number}密钥只保存密钥中心引用;禁止明文落库{"appKeyRef":"secret://video/appKey","expireSeconds":7200}
video_platform_configVideoPlatformConfigplayback_policyGENERICobject | array必须符合字段说明中的业务结构;保存前进行 JSON Schema 校验并记录版本{"version":1,"items":[]}
patrol_quality_scoreTeachingQualityScorestudent_dimension_jsonMETRIC_DIMENSION{dimensions:[{code:string,name:string,type:string,refTable?:string}], filters:object}维度编码必须来自指标口径配置{"dimensions":[{"code":"campusId","type":"BIGINT","refTable":"sys_campus_profile"}]}
patrol_quality_scoreTeachingQualityScoreteacher_dimension_jsonMETRIC_DIMENSION{dimensions:[{code:string,name:string,type:string,refTable?:string}], filters:object}维度编码必须来自指标口径配置{"dimensions":[{"code":"campusId","type":"BIGINT","refTable":"sys_campus_profile"}]}

状态/枚举标准字典

表名对象字段枚举编码取值终态/流转规则字段说明
video_platform_configVideoPlatformConfigtenant_idTENANT_ID集团、租户隔离字段非终态,可按状态机或字典规则流转集团/租户隔离字段,所有查询必须带租户上下文
video_platform_configVideoPlatformConfigis_deletedBOOL_DELETED0 未删除、1 已删除非终态,可按状态机或字典规则流转是否已删除,0 未删除,1 已删除
video_platform_configVideoPlatformConfigvendor_codeVENDOR_CODEHIKVISION、UNIVIEW非终态,可按状态机或字典规则流转HIKVISION/UNIVIEW
video_platform_configVideoPlatformConfigplayback_capabilityPLAYBACK_CAPABILITYDIRECT_REPLAY_DOWNLOAD、TIMESTAMP_CAPTURE_DOWNLOAD非终态,可按状态机或字典规则流转DIRECT_REPLAY_DOWNLOAD/TIMESTAMP_CAPTURE_DOWNLOAD
video_platform_configVideoPlatformConfigenabledENABLED_STATUS0 停用、1 启用非终态,可按状态机或字典规则流转是否启用
video_gateway_configVideoGatewayConfigtenant_idTENANT_ID集团、租户隔离字段非终态,可按状态机或字典规则流转集团/租户隔离字段,所有查询必须带租户上下文
video_gateway_configVideoGatewayConfigis_deletedBOOL_DELETED0 未删除、1 已删除非终态,可按状态机或字典规则流转是否已删除,0 未删除,1 已删除
video_gateway_configVideoGatewayConfigaccess_modeACCESS_MODE公网直连、门店侧网关非终态,可按状态机或字典规则流转公网直连/门店侧网关
video_gateway_configVideoGatewayConfignetwork_statusDEVICE_STATUSONLINE 在线、OFFLINE 离线、DISABLED 停用、ABNORMAL 异常包含终态,终态禁止直接编辑,需走变更/红冲/撤回流程在线/离线/异常
video_classroom_cameraClassroomCameratenant_idTENANT_ID集团、租户隔离字段非终态,可按状态机或字典规则流转集团/租户隔离字段,所有查询必须带租户上下文
video_classroom_cameraClassroomCamerais_deletedBOOL_DELETED0 未删除、1 已删除非终态,可按状态机或字典规则流转是否已删除,0 未删除,1 已删除
video_classroom_cameraClassroomCameraplayback_modePLAYBACK_MODEDIRECT_REPLAY_DOWNLOAD、TIMESTAMP_CAPTURE_DOWNLOAD非终态,可按状态机或字典规则流转DIRECT_REPLAY_DOWNLOAD/TIMESTAMP_CAPTURE_DOWNLOAD,继承平台能力且可按通道覆盖
video_classroom_cameraClassroomCameracamera_statusDEVICE_STATUSONLINE 在线、OFFLINE 离线、DISABLED 停用、ABNORMAL 异常包含终态,终态禁止直接编辑,需走变更/红冲/撤回流程在线/离线/停用/异常
video_recording_clip_taskPatrolRecordingClipTasktenant_idTENANT_ID集团、租户隔离字段非终态,可按状态机或字典规则流转集团/租户隔离字段,所有查询必须带租户上下文
video_recording_clip_taskPatrolRecordingClipTaskis_deletedBOOL_DELETED0 未删除、1 已删除非终态,可按状态机或字典规则流转是否已删除,0 未删除,1 已删除
video_recording_clip_taskPatrolRecordingClipTaskvendor_codeVENDOR_CODEHIKVISION、UNIVIEW非终态,可按状态机或字典规则流转HIKVISION/UNIVIEW
video_recording_clip_taskPatrolRecordingClipTasktask_modeTASK_MODE原生下载、时间戳定位录制、手动补录非终态,可按状态机或字典规则流转原生下载/时间戳定位录制/手动补录
video_recording_clip_taskPatrolRecordingClipTasktask_statusTASK_STATUS待处理、录制中、可下载、失败、已过期包含终态,终态禁止直接编辑,需走变更/红冲/撤回流程待处理/录制中/可下载/失败/已过期
video_campus_map_pointCampusMapPointtenant_idTENANT_ID集团、租户隔离字段非终态,可按状态机或字典规则流转集团/租户隔离字段,所有查询必须带租户上下文
video_campus_map_pointCampusMapPointis_deletedBOOL_DELETED0 未删除、1 已删除非终态,可按状态机或字典规则流转是否已删除,0 未删除,1 已删除
video_campus_map_pointCampusMapPointpoint_statusPOINT_STATUS正常、异常、未配置非终态,可按状态机或字典规则流转正常/异常/未配置
patrol_recordPatrolRecordtenant_idTENANT_ID集团、租户隔离字段非终态,可按状态机或字典规则流转集团/租户隔离字段,所有查询必须带租户上下文
patrol_recordPatrolRecordis_deletedBOOL_DELETED0 未删除、1 已删除非终态,可按状态机或字典规则流转是否已删除,0 未删除,1 已删除
patrol_recordPatrolRecordpatrol_statusPATROL_STATUS进行中、已完成、异常中断非终态,可按状态机或字典规则流转进行中/已完成/异常中断
patrol_quality_scoreTeachingQualityScoretenant_idTENANT_ID集团、租户隔离字段非终态,可按状态机或字典规则流转集团/租户隔离字段,所有查询必须带租户上下文
patrol_quality_scoreTeachingQualityScoreis_deletedBOOL_DELETED0 未删除、1 已删除非终态,可按状态机或字典规则流转是否已删除,0 未删除,1 已删除
patrol_quality_scoreTeachingQualityScorescore_statusSCORE_STATUS草稿、已提交、已复核、已驳回非终态,可按状态机或字典规则流转草稿/已提交/已复核/已驳回
patrol_rectification_taskRectificationTasktenant_idTENANT_ID集团、租户隔离字段非终态,可按状态机或字典规则流转集团/租户隔离字段,所有查询必须带租户上下文
patrol_rectification_taskRectificationTaskis_deletedBOOL_DELETED0 未删除、1 已删除非终态,可按状态机或字典规则流转是否已删除,0 未删除,1 已删除
patrol_rectification_taskRectificationTasktask_statusTASK_STATUS待整改、待复核、已关闭、逾期包含终态,终态禁止直接编辑,需走变更/红冲/撤回流程待整改/待复核/已关闭/逾期
patrol_snapshot_evidenceSnapshotEvidencetenant_idTENANT_ID集团、租户隔离字段非终态,可按状态机或字典规则流转集团/租户隔离字段,所有查询必须带租户上下文
patrol_snapshot_evidenceSnapshotEvidenceis_deletedBOOL_DELETED0 未删除、1 已删除非终态,可按状态机或字典规则流转是否已删除,0 未删除,1 已删除
patrol_snapshot_evidenceSnapshotEvidenceevidence_typeEVIDENCE_TYPE截图、片段、备注、异常非终态,可按状态机或字典规则流转截图/片段/备注/异常
patrol_snapshot_evidenceSnapshotEvidencevisible_scopeVISIBLE_SCOPE总部、校区、责任人、审计非终态,可按状态机或字典规则流转总部/校区/责任人/审计

敏感字段与数据安全策略

来源表名对象字段数据级别脱敏/返回策略明文查看条件导出策略审计要求端侧展示规则
本模块对象video_platform_configVideoPlatformConfigauth_config高敏NEVER_RETURN禁止接口返回明文;仅密钥中心/鉴权服务按服务身份读取密钥引用禁止导出;配置导出只允许导出脱敏引用和启停状态配置新增、修改、启停、轮换和失败读取均记录安全审计前端只展示已配置/未配置、到期时间和连通性状态,不展示密钥值
引用对象sys_userUser/Employeemobile敏感MOBILE_MASK默认展示 138****0000;明文查看需字段权限或敏感字段查看审批导出手机号必须触发导出审批、下载水印和有效期控制明文查看、复制、导出和批量下载均写入 SensitiveAccessLogPC 管理端按字段权限展示;移动端仅展示本人授权范围内脱敏信息
引用对象sys_userUser/Employeepassword_hash高敏NEVER_RETURN禁止接口返回明文;仅密钥中心/鉴权服务按服务身份读取密钥引用禁止导出;配置导出只允许导出脱敏引用和启停状态配置新增、修改、启停、轮换和失败读取均记录安全审计前端只展示已配置/未配置、到期时间和连通性状态,不展示密钥值
引用对象int_integration_logIntegrationLogrequest_payload敏感PAYLOAD_DESENSITIZE接口报文、快照和文件地址默认脱敏;排障查看需运维/安全授权导出日志或报文时自动清理手机号、证件号、密钥、票据和人脸字段查看报文、下载附件、失败重放和人工补偿均记录审计业务端展示摘要和状态,完整报文仅运维/安全后台查看
引用对象int_integration_logIntegrationLogresponse_payload普通PAYLOAD_DESENSITIZE接口报文、快照和文件地址默认脱敏;排障查看需运维/安全授权导出日志或报文时自动清理手机号、证件号、密钥、票据和人脸字段查看报文、下载附件、失败重放和人工补偿均记录审计业务端展示摘要和状态,完整报文仅运维/安全后台查看
引用对象sec_sensitive_field_policySensitiveFieldPolicymask_rule普通BIZ_FIELD_MASK按字段权限、数据范围和业务角色展示;明文查看按敏感字段审批规则执行导出时按数据级别触发审批、水印、下载有效期和日志查看、修改、删除、导出、下载和审批均记录操作审计默认遵循总部、区域、校区、团队、本人数据范围和端侧最小可见原则

核心数据表完整字段

表名对象字段类型必填规则数据级别
video_platform_configVideoPlatformConfigidBIGINT主键,雪花或号段生成,禁止复用普通
video_platform_configVideoPlatformConfigtenant_idBIGINT集团/租户隔离字段,所有查询必须带租户上下文普通
video_platform_configVideoPlatformConfigorg_idBIGINT所属组织,集团级或公共配置为空普通
video_platform_configVideoPlatformConfigcampus_idBIGINT所属校区,跨校区或总部级数据为空普通
video_platform_configVideoPlatformConfigcreated_byBIGINT创建人账号 ID普通
video_platform_configVideoPlatformConfigcreated_atDATETIME创建时间普通
video_platform_configVideoPlatformConfigupdated_byBIGINT最后更新人账号 ID普通
video_platform_configVideoPlatformConfigupdated_atDATETIME最后更新时间普通
video_platform_configVideoPlatformConfigis_deletedTINYINT是否已删除,0 未删除,1 已删除普通
video_platform_configVideoPlatformConfigdeleted_atDATETIME删除时间,未删除为空普通
video_platform_configVideoPlatformConfigdeleted_byBIGINT删除人账号 ID,未删除为空普通
video_platform_configVideoPlatformConfigversionINT乐观锁版本号,写操作必须校验普通
video_platform_configVideoPlatformConfigplatform_codeVARCHAR(64)平台编码,唯一普通
video_platform_configVideoPlatformConfigvendor_codeVARCHAR(32)HIKVISION/UNIVIEW普通
video_platform_configVideoPlatformConfigplatform_nameVARCHAR(128)平台名称普通
video_platform_configVideoPlatformConfigapi_base_urlVARCHAR(512)接口地址普通
video_platform_configVideoPlatformConfigauth_configJSON鉴权参数,密钥加密存储高敏
video_platform_configVideoPlatformConfigrecord_retention_daysINT录像保留天数,默认 90普通
video_platform_configVideoPlatformConfigplayback_capabilityVARCHAR(64)DIRECT_REPLAY_DOWNLOAD/TIMESTAMP_CAPTURE_DOWNLOAD普通
video_platform_configVideoPlatformConfigplayback_policyJSON供应商回放下载策略,海康支持原生回放与录播下载,宇视需拖动到指定时间戳后录制片段再下载普通
video_platform_configVideoPlatformConfigenabledTINYINT是否启用普通
video_gateway_configVideoGatewayConfigidBIGINT主键,雪花或号段生成,禁止复用普通
video_gateway_configVideoGatewayConfigtenant_idBIGINT集团/租户隔离字段,所有查询必须带租户上下文普通
video_gateway_configVideoGatewayConfigorg_idBIGINT所属组织,集团级或公共配置为空普通
video_gateway_configVideoGatewayConfigcampus_idBIGINT所属校区,跨校区或总部级数据为空普通
video_gateway_configVideoGatewayConfigcreated_byBIGINT创建人账号 ID普通
video_gateway_configVideoGatewayConfigcreated_atDATETIME创建时间普通
video_gateway_configVideoGatewayConfigupdated_byBIGINT最后更新人账号 ID普通
video_gateway_configVideoGatewayConfigupdated_atDATETIME最后更新时间普通
video_gateway_configVideoGatewayConfigis_deletedTINYINT是否已删除,0 未删除,1 已删除普通
video_gateway_configVideoGatewayConfigdeleted_atDATETIME删除时间,未删除为空普通
video_gateway_configVideoGatewayConfigdeleted_byBIGINT删除人账号 ID,未删除为空普通
video_gateway_configVideoGatewayConfigversionINT乐观锁版本号,写操作必须校验普通
video_gateway_configVideoGatewayConfiggateway_codeVARCHAR(64)网关编码,唯一普通
video_gateway_configVideoGatewayConfigplatform_idBIGINT视频平台 ID普通
video_gateway_configVideoGatewayConfigaccess_modeVARCHAR(32)公网直连/门店侧网关普通
video_gateway_configVideoGatewayConfiggateway_addressVARCHAR(512)网关地址普通
video_gateway_configVideoGatewayConfignetwork_statusVARCHAR(32)在线/离线/异常普通
video_gateway_configVideoGatewayConfigheartbeat_atDATETIME最近心跳普通
video_classroom_cameraClassroomCameraidBIGINT主键,雪花或号段生成,禁止复用普通
video_classroom_cameraClassroomCameratenant_idBIGINT集团/租户隔离字段,所有查询必须带租户上下文普通
video_classroom_cameraClassroomCameraorg_idBIGINT所属组织,集团级或公共配置为空普通
video_classroom_cameraClassroomCameracampus_idBIGINT所属校区,跨校区或总部级数据为空;本表业务要求必填普通
video_classroom_cameraClassroomCameracreated_byBIGINT创建人账号 ID普通
video_classroom_cameraClassroomCameracreated_atDATETIME创建时间普通
video_classroom_cameraClassroomCameraupdated_byBIGINT最后更新人账号 ID普通
video_classroom_cameraClassroomCameraupdated_atDATETIME最后更新时间普通
video_classroom_cameraClassroomCamerais_deletedTINYINT是否已删除,0 未删除,1 已删除普通
video_classroom_cameraClassroomCameradeleted_atDATETIME删除时间,未删除为空普通
video_classroom_cameraClassroomCameradeleted_byBIGINT删除人账号 ID,未删除为空普通
video_classroom_cameraClassroomCameraversionINT乐观锁版本号,写操作必须校验普通
video_classroom_cameraClassroomCameracamera_codeVARCHAR(64)摄像头编码,唯一普通
video_classroom_cameraClassroomCameracamera_nameVARCHAR(128)摄像头名称普通
video_classroom_cameraClassroomCameraplatform_idBIGINT所属视频平台普通
video_classroom_cameraClassroomCameragateway_idBIGINT门店网关 ID普通
video_classroom_cameraClassroomCameraclassroom_idBIGINT绑定教室 ID,必须属于同一校区且教室未逻辑删除普通
video_classroom_cameraClassroomCamerastream_addressVARCHAR(512)直播流地址普通
video_classroom_cameraClassroomCameraplayback_modeVARCHAR(64)DIRECT_REPLAY_DOWNLOAD/TIMESTAMP_CAPTURE_DOWNLOAD,继承平台能力且可按通道覆盖普通
video_classroom_cameraClassroomCamerarecord_channel_noVARCHAR(64)供应商录像通道号普通
video_classroom_cameraClassroomCameracamera_statusVARCHAR(32)在线/离线/停用/异常普通
video_recording_clip_taskPatrolRecordingClipTaskidBIGINT主键,雪花或号段生成,禁止复用普通
video_recording_clip_taskPatrolRecordingClipTasktenant_idBIGINT集团/租户隔离字段,所有查询必须带租户上下文普通
video_recording_clip_taskPatrolRecordingClipTaskorg_idBIGINT所属组织,集团级或公共配置为空普通
video_recording_clip_taskPatrolRecordingClipTaskcampus_idBIGINT所属校区,跨校区或总部级数据为空;本表业务要求必填普通
video_recording_clip_taskPatrolRecordingClipTaskcreated_byBIGINT创建人账号 ID普通
video_recording_clip_taskPatrolRecordingClipTaskcreated_atDATETIME创建时间普通
video_recording_clip_taskPatrolRecordingClipTaskupdated_byBIGINT最后更新人账号 ID普通
video_recording_clip_taskPatrolRecordingClipTaskupdated_atDATETIME最后更新时间普通
video_recording_clip_taskPatrolRecordingClipTaskis_deletedTINYINT是否已删除,0 未删除,1 已删除普通
video_recording_clip_taskPatrolRecordingClipTaskdeleted_atDATETIME删除时间,未删除为空普通
video_recording_clip_taskPatrolRecordingClipTaskdeleted_byBIGINT删除人账号 ID,未删除为空普通
video_recording_clip_taskPatrolRecordingClipTaskversionINT乐观锁版本号,写操作必须校验普通
video_recording_clip_taskPatrolRecordingClipTaskclip_task_noVARCHAR(64)片段任务编号,唯一普通
video_recording_clip_taskPatrolRecordingClipTaskcamera_idBIGINT摄像头 ID普通
video_recording_clip_taskPatrolRecordingClipTaskvendor_codeVARCHAR(32)HIKVISION/UNIVIEW普通
video_recording_clip_taskPatrolRecordingClipTaskrecord_start_atDATETIME片段开始时间普通
video_recording_clip_taskPatrolRecordingClipTaskrecord_end_atDATETIME片段结束时间普通
video_recording_clip_taskPatrolRecordingClipTaskanchor_timestampDATETIME宇视拖动定位时间戳普通
video_recording_clip_taskPatrolRecordingClipTasktask_modeVARCHAR(64)原生下载/时间戳定位录制/手动补录普通
video_recording_clip_taskPatrolRecordingClipTasktask_statusVARCHAR(32)待处理/录制中/可下载/失败/已过期普通
video_recording_clip_taskPatrolRecordingClipTaskdownload_urlVARCHAR(512)下载地址普通
video_recording_clip_taskPatrolRecordingClipTaskexpire_atDATETIME下载链接过期时间普通
video_recording_clip_taskPatrolRecordingClipTaskfailure_reasonVARCHAR(512)失败原因普通
video_campus_map_pointCampusMapPointidBIGINT主键,雪花或号段生成,禁止复用普通
video_campus_map_pointCampusMapPointtenant_idBIGINT集团/租户隔离字段,所有查询必须带租户上下文普通
video_campus_map_pointCampusMapPointorg_idBIGINT所属组织,集团级或公共配置为空普通
video_campus_map_pointCampusMapPointcampus_idBIGINT所属校区,跨校区或总部级数据为空;本表业务要求必填普通
video_campus_map_pointCampusMapPointcreated_byBIGINT创建人账号 ID普通
video_campus_map_pointCampusMapPointcreated_atDATETIME创建时间普通
video_campus_map_pointCampusMapPointupdated_byBIGINT最后更新人账号 ID普通
video_campus_map_pointCampusMapPointupdated_atDATETIME最后更新时间普通
video_campus_map_pointCampusMapPointis_deletedTINYINT是否已删除,0 未删除,1 已删除普通
video_campus_map_pointCampusMapPointdeleted_atDATETIME删除时间,未删除为空普通
video_campus_map_pointCampusMapPointdeleted_byBIGINT删除人账号 ID,未删除为空普通
video_campus_map_pointCampusMapPointversionINT乐观锁版本号,写操作必须校验普通
video_campus_map_pointCampusMapPointlongitudeDECIMAL(12,8)经度,后台动态配置普通
video_campus_map_pointCampusMapPointlatitudeDECIMAL(12,8)纬度,后台动态配置普通
video_campus_map_pointCampusMapPointdevice_totalINT地图大头钉展示设备总数普通
video_campus_map_pointCampusMapPointonline_totalINT在线设备数普通
video_campus_map_pointCampusMapPointpoint_statusVARCHAR(32)正常/异常/未配置普通
patrol_recordPatrolRecordidBIGINT主键,雪花或号段生成,禁止复用普通
patrol_recordPatrolRecordtenant_idBIGINT集团/租户隔离字段,所有查询必须带租户上下文普通
patrol_recordPatrolRecordorg_idBIGINT所属组织,集团级或公共配置为空普通
patrol_recordPatrolRecordcampus_idBIGINT所属校区,跨校区或总部级数据为空普通
patrol_recordPatrolRecordcreated_byBIGINT创建人账号 ID普通
patrol_recordPatrolRecordcreated_atDATETIME创建时间普通
patrol_recordPatrolRecordupdated_byBIGINT最后更新人账号 ID普通
patrol_recordPatrolRecordupdated_atDATETIME最后更新时间普通
patrol_recordPatrolRecordis_deletedTINYINT是否已删除,0 未删除,1 已删除普通
patrol_recordPatrolRecorddeleted_atDATETIME删除时间,未删除为空普通
patrol_recordPatrolRecorddeleted_byBIGINT删除人账号 ID,未删除为空普通
patrol_recordPatrolRecordversionINT乐观锁版本号,写操作必须校验普通
patrol_recordPatrolRecordpatrol_noVARCHAR(64)巡课编号,唯一普通
patrol_recordPatrolRecordcamera_idBIGINT摄像头 ID普通
patrol_recordPatrolRecordlesson_idBIGINT课次 ID普通
patrol_recordPatrolRecordpatrol_user_idBIGINT巡课人员 ID普通
patrol_recordPatrolRecordstart_atDATETIME巡课开始时间普通
patrol_recordPatrolRecordend_atDATETIME巡课结束时间普通
patrol_recordPatrolRecordpatrol_statusVARCHAR(32)进行中/已完成/异常中断普通
patrol_quality_scoreTeachingQualityScoreidBIGINT主键,雪花或号段生成,禁止复用普通
patrol_quality_scoreTeachingQualityScoretenant_idBIGINT集团/租户隔离字段,所有查询必须带租户上下文普通
patrol_quality_scoreTeachingQualityScoreorg_idBIGINT所属组织,集团级或公共配置为空普通
patrol_quality_scoreTeachingQualityScorecampus_idBIGINT所属校区,跨校区或总部级数据为空普通
patrol_quality_scoreTeachingQualityScorecreated_byBIGINT创建人账号 ID普通
patrol_quality_scoreTeachingQualityScorecreated_atDATETIME创建时间普通
patrol_quality_scoreTeachingQualityScoreupdated_byBIGINT最后更新人账号 ID普通
patrol_quality_scoreTeachingQualityScoreupdated_atDATETIME最后更新时间普通
patrol_quality_scoreTeachingQualityScoreis_deletedTINYINT是否已删除,0 未删除,1 已删除普通
patrol_quality_scoreTeachingQualityScoredeleted_atDATETIME删除时间,未删除为空普通
patrol_quality_scoreTeachingQualityScoredeleted_byBIGINT删除人账号 ID,未删除为空普通
patrol_quality_scoreTeachingQualityScoreversionINT乐观锁版本号,写操作必须校验普通
patrol_quality_scoreTeachingQualityScorescore_noVARCHAR(64)评分编号,唯一普通
patrol_quality_scoreTeachingQualityScorepatrol_record_idBIGINT巡课记录 ID普通
patrol_quality_scoreTeachingQualityScoreteacher_idBIGINT教师 ID普通
patrol_quality_scoreTeachingQualityScorestudent_dimension_jsonJSON学生维度评分普通
patrol_quality_scoreTeachingQualityScoreteacher_dimension_jsonJSON教师维度评分普通
patrol_quality_scoreTeachingQualityScoretotal_scoreDECIMAL(6,2)综合得分普通
patrol_quality_scoreTeachingQualityScorescore_statusVARCHAR(32)草稿/已提交/已复核/已驳回普通
patrol_rectification_taskRectificationTaskidBIGINT主键,雪花或号段生成,禁止复用普通
patrol_rectification_taskRectificationTasktenant_idBIGINT集团/租户隔离字段,所有查询必须带租户上下文普通
patrol_rectification_taskRectificationTaskorg_idBIGINT所属组织,集团级或公共配置为空普通
patrol_rectification_taskRectificationTaskcampus_idBIGINT所属校区,跨校区或总部级数据为空普通
patrol_rectification_taskRectificationTaskcreated_byBIGINT创建人账号 ID普通
patrol_rectification_taskRectificationTaskcreated_atDATETIME创建时间普通
patrol_rectification_taskRectificationTaskupdated_byBIGINT最后更新人账号 ID普通
patrol_rectification_taskRectificationTaskupdated_atDATETIME最后更新时间普通
patrol_rectification_taskRectificationTaskis_deletedTINYINT是否已删除,0 未删除,1 已删除普通
patrol_rectification_taskRectificationTaskdeleted_atDATETIME删除时间,未删除为空普通
patrol_rectification_taskRectificationTaskdeleted_byBIGINT删除人账号 ID,未删除为空普通
patrol_rectification_taskRectificationTaskversionINT乐观锁版本号,写操作必须校验普通
patrol_rectification_taskRectificationTasktask_noVARCHAR(64)整改任务编号,唯一普通
patrol_rectification_taskRectificationTaskscore_idBIGINT评分 ID普通
patrol_rectification_taskRectificationTaskowner_idBIGINT责任人 ID普通
patrol_rectification_taskRectificationTaskrectify_requirementTEXT整改要求普通
patrol_rectification_taskRectificationTaskdeadline_atDATETIME整改截止时间普通
patrol_rectification_taskRectificationTaskverify_resultVARCHAR(32)复核结果普通
patrol_rectification_taskRectificationTasktask_statusVARCHAR(32)待整改/待复核/已关闭/逾期普通
patrol_snapshot_evidenceSnapshotEvidenceidBIGINT主键,雪花或号段生成,禁止复用普通
patrol_snapshot_evidenceSnapshotEvidencetenant_idBIGINT集团/租户隔离字段,所有查询必须带租户上下文普通
patrol_snapshot_evidenceSnapshotEvidenceorg_idBIGINT所属组织,集团级或公共配置为空普通
patrol_snapshot_evidenceSnapshotEvidencecampus_idBIGINT所属校区,跨校区或总部级数据为空普通
patrol_snapshot_evidenceSnapshotEvidencecreated_byBIGINT创建人账号 ID普通
patrol_snapshot_evidenceSnapshotEvidencecreated_atDATETIME创建时间普通
patrol_snapshot_evidenceSnapshotEvidenceupdated_byBIGINT最后更新人账号 ID普通
patrol_snapshot_evidenceSnapshotEvidenceupdated_atDATETIME最后更新时间普通
patrol_snapshot_evidenceSnapshotEvidenceis_deletedTINYINT是否已删除,0 未删除,1 已删除普通
patrol_snapshot_evidenceSnapshotEvidencedeleted_atDATETIME删除时间,未删除为空普通
patrol_snapshot_evidenceSnapshotEvidencedeleted_byBIGINT删除人账号 ID,未删除为空普通
patrol_snapshot_evidenceSnapshotEvidenceversionINT乐观锁版本号,写操作必须校验普通
patrol_snapshot_evidenceSnapshotEvidencepatrol_record_idBIGINT巡课记录 ID普通
patrol_snapshot_evidenceSnapshotEvidencecapture_atDATETIME截图时间普通
patrol_snapshot_evidenceSnapshotEvidencefile_idBIGINT图片或视频文件 ID普通
patrol_snapshot_evidenceSnapshotEvidenceevidence_typeVARCHAR(32)截图/片段/备注/异常普通
patrol_snapshot_evidenceSnapshotEvidenceevidence_descVARCHAR(512)证据说明普通
patrol_snapshot_evidenceSnapshotEvidencevisible_scopeVARCHAR(32)总部/校区/责任人/审计普通

数据表与对象映射

表名对象用途完整字段索引建议
video_platform_configVideoPlatformConfig海康威视/宇视视频平台配置id(BIGINT,必填)、tenant_id(BIGINT,必填)、org_id(BIGINT)、campus_id(BIGINT)、created_by(BIGINT,必填)、created_at(DATETIME,必填)、updated_by(BIGINT)、updated_at(DATETIME)、is_deleted(TINYINT,必填)、deleted_at(DATETIME)、deleted_by(BIGINT)、version(INT,必填)、platform_code(VARCHAR(64),必填)、vendor_code(VARCHAR(32),必填)、platform_name(VARCHAR(128),必填)、api_base_url(VARCHAR(512),必填)、auth_config(JSON,必填)、record_retention_days(INT,必填)、playback_capability(VARCHAR(64),必填)、playback_policy(JSON)、enabled(TINYINT,必填)uk_platform_code、idx_vendor_enabled
video_gateway_configVideoGatewayConfig门店侧网关与公网直连配置id(BIGINT,必填)、tenant_id(BIGINT,必填)、org_id(BIGINT)、campus_id(BIGINT)、created_by(BIGINT,必填)、created_at(DATETIME,必填)、updated_by(BIGINT)、updated_at(DATETIME)、is_deleted(TINYINT,必填)、deleted_at(DATETIME)、deleted_by(BIGINT)、version(INT,必填)、gateway_code(VARCHAR(64),必填)、platform_id(BIGINT,必填)、access_mode(VARCHAR(32),必填)、gateway_address(VARCHAR(512))、network_status(VARCHAR(32),必填)、heartbeat_at(DATETIME)uk_gateway_code、idx_platform_status
video_classroom_cameraClassroomCamera教室摄像头设备清单id(BIGINT,必填)、tenant_id(BIGINT,必填)、org_id(BIGINT)、campus_id(BIGINT,必填)、created_by(BIGINT,必填)、created_at(DATETIME,必填)、updated_by(BIGINT)、updated_at(DATETIME)、is_deleted(TINYINT,必填)、deleted_at(DATETIME)、deleted_by(BIGINT)、version(INT,必填)、camera_code(VARCHAR(64),必填)、camera_name(VARCHAR(128),必填)、platform_id(BIGINT,必填)、gateway_id(BIGINT)、classroom_id(BIGINT,必填)、stream_address(VARCHAR(512))、playback_mode(VARCHAR(64),必填)、record_channel_no(VARCHAR(64))、camera_status(VARCHAR(32),必填)uk_camera_code、idx_campus_classroom_status
video_recording_clip_taskPatrolRecordingClipTask回放片段录制和下载任务id(BIGINT,必填)、tenant_id(BIGINT,必填)、org_id(BIGINT)、campus_id(BIGINT,必填)、created_by(BIGINT,必填)、created_at(DATETIME,必填)、updated_by(BIGINT)、updated_at(DATETIME)、is_deleted(TINYINT,必填)、deleted_at(DATETIME)、deleted_by(BIGINT)、version(INT,必填)、clip_task_no(VARCHAR(64),必填)、camera_id(BIGINT,必填)、vendor_code(VARCHAR(32),必填)、record_start_at(DATETIME,必填)、record_end_at(DATETIME,必填)、anchor_timestamp(DATETIME)、task_mode(VARCHAR(64),必填)、task_status(VARCHAR(32),必填)、download_url(VARCHAR(512))、expire_at(DATETIME)、failure_reason(VARCHAR(512))uk_clip_task_no、idx_camera_time、idx_vendor_status
video_campus_map_pointCampusMapPoint校区地图点位和设备汇总id(BIGINT,必填)、tenant_id(BIGINT,必填)、org_id(BIGINT)、campus_id(BIGINT,必填)、created_by(BIGINT,必填)、created_at(DATETIME,必填)、updated_by(BIGINT)、updated_at(DATETIME)、is_deleted(TINYINT,必填)、deleted_at(DATETIME)、deleted_by(BIGINT)、version(INT,必填)、longitude(DECIMAL(12,8),必填)、latitude(DECIMAL(12,8),必填)、device_total(INT,必填)、online_total(INT,必填)、point_status(VARCHAR(32),必填)uk_campus、idx_geo
patrol_recordPatrolRecord在线巡课记录id(BIGINT,必填)、tenant_id(BIGINT,必填)、org_id(BIGINT)、campus_id(BIGINT)、created_by(BIGINT,必填)、created_at(DATETIME,必填)、updated_by(BIGINT)、updated_at(DATETIME)、is_deleted(TINYINT,必填)、deleted_at(DATETIME)、deleted_by(BIGINT)、version(INT,必填)、patrol_no(VARCHAR(64),必填)、camera_id(BIGINT,必填)、lesson_id(BIGINT)、patrol_user_id(BIGINT,必填)、start_at(DATETIME,必填)、end_at(DATETIME)、patrol_status(VARCHAR(32),必填)uk_patrol_no、idx_camera_time
patrol_quality_scoreTeachingQualityScore教学质量评分id(BIGINT,必填)、tenant_id(BIGINT,必填)、org_id(BIGINT)、campus_id(BIGINT)、created_by(BIGINT,必填)、created_at(DATETIME,必填)、updated_by(BIGINT)、updated_at(DATETIME)、is_deleted(TINYINT,必填)、deleted_at(DATETIME)、deleted_by(BIGINT)、version(INT,必填)、score_no(VARCHAR(64),必填)、patrol_record_id(BIGINT,必填)、teacher_id(BIGINT)、student_dimension_json(JSON)、teacher_dimension_json(JSON)、total_score(DECIMAL(6,2),必填)、score_status(VARCHAR(32),必填)uk_score_no、idx_teacher_status
patrol_rectification_taskRectificationTask督课整改与复核id(BIGINT,必填)、tenant_id(BIGINT,必填)、org_id(BIGINT)、campus_id(BIGINT)、created_by(BIGINT,必填)、created_at(DATETIME,必填)、updated_by(BIGINT)、updated_at(DATETIME)、is_deleted(TINYINT,必填)、deleted_at(DATETIME)、deleted_by(BIGINT)、version(INT,必填)、task_no(VARCHAR(64),必填)、score_id(BIGINT,必填)、owner_id(BIGINT,必填)、rectify_requirement(TEXT,必填)、deadline_at(DATETIME,必填)、verify_result(VARCHAR(32))、task_status(VARCHAR(32),必填)uk_task_no、idx_owner_status
patrol_snapshot_evidenceSnapshotEvidence巡课截图和证据归档id(BIGINT,必填)、tenant_id(BIGINT,必填)、org_id(BIGINT)、campus_id(BIGINT)、created_by(BIGINT,必填)、created_at(DATETIME,必填)、updated_by(BIGINT)、updated_at(DATETIME)、is_deleted(TINYINT,必填)、deleted_at(DATETIME)、deleted_by(BIGINT)、version(INT,必填)、patrol_record_id(BIGINT,必填)、capture_at(DATETIME,必填)、file_id(BIGINT,必填)、evidence_type(VARCHAR(32),必填)、evidence_desc(VARCHAR(512))、visible_scope(VARCHAR(32),必填)idx_patrol_time、idx_type

12 · 状态机与业务规则

约束业务对象如何流转、何时可编辑、何时触发审批

原型需要把状态标签、可操作按钮和禁用原因展示清楚。
对象状态触发与说明
课次未开始 -> 待签到 -> 已签到 -> 已课消 -> 请假 -> 补课 -> 旷课 -> 异常待确认排课发布、签到、课消、请假、补课和人工确认
巡课任务未开始 -> 巡课中 -> 已记录 -> 待评分 -> 待整改 -> 整改中 -> 已复盘 -> 已关闭巡课计划、在线巡课、录像标记、课堂评价、教学质量评分、整改复盘
员工培训未分配 -> 待学习 -> 学习中 -> 待考试 -> 已通过 -> 未通过 -> 补训中 -> 已逾期培训计划发布、学习进度、考试成绩、补考复训和学习档案归档
直播录制未录制 -> 录制中 -> 转码中 -> 可回放 -> 转码失败 -> 已过期 -> 已归档供应商录制回调、转码任务、回放发布、留存过期和资料归档
活动落地页草稿 -> 编辑中 -> 待发布 -> 发布中 -> 已发布 -> 发布失败 -> 已停用选择模板、编辑、发布、生成链接/活码、停用和复盘
作业草稿无草稿 -> 编辑中 -> 自动保存中 -> 已保存 -> 待提交 -> 已提交 -> 已删除 -> 已过期 -> 冲突待恢复学员进入作业后可自动或手动保存草稿,提交成功后关闭草稿;删除、过期和多端冲突必须可提示、可审计、可恢复到安全状态
补课改期取消已确认 -> 改期申请中 -> 取消申请中 -> 教务处理中 -> 已重新安排 -> 已拒绝 -> 已关闭 -> 待冲正 -> 已冲正家长发起改期或取消,教务处理候选课次和课消冲正,最终回到补课安排或关闭
库存成本策略草稿 -> 待审核 -> 已启用 -> 已停用 -> 待重算 -> 重算中 -> 已归档成本计价规则配置、审批、生效、停用和历史成本处理
设备维修工单待派单 -> 已派单 -> 已接单 -> 排查中 -> 待恢复校验 -> 已恢复 -> 已关闭 -> 已升级视频设备离线告警生成维修工单,恢复后回测直播、回放、录像索引
督课评分规则版本草稿 -> 待审核 -> 已发布 -> 已生效 -> 已停用 -> 已归档评分维度、权重和生效范围配置后审批发布,历史评分按版本追溯
活码访问安全启用中 -> 限频中 -> 黑名单命中 -> 目标下架 -> 已停用 -> 已过期 -> 异常告警短链访问、防刷、失效页、黑名单和异常渠道告警
国税核验配置草稿 -> 启用中 -> 频控中 -> 异常 -> 已停用 -> 已过期校区税务主体、官方接口凭证、额度、启用状态和调用日志
课堂端会话待绑定 -> 已绑定 -> 待开课 -> 授课中 -> 暂停中 -> 已结束 -> 异常断开教师或教室设备创建课堂会话,TV 与教师端完成绑定后同步课件、互动和课堂状态;断开后可重连,结束后归档审计。
大屏展示组件未配置 -> 已配置 -> 校验通过 -> 校验失败 -> 已停用组件配置控制战区/校区切换、排名维度、显示全部老师、语数英分组和空状态
回放供应商能力海康原生回放下载 -> 宇视时间戳录制下载 -> 能力未配置 -> 通道覆盖 -> 能力禁用按 video_platform_config.playback_capability 和 video_classroom_camera.playback_mode 决定回放页可用动作
片段录制任务待处理 -> 录制中 -> 可下载 -> 失败 -> 已过期 -> 已取消宇视回放下载必须先生成片段录制任务,任务完成后才提供片段回放和下载地址
分销活动未启用 -> 已启用 -> 推广中 -> 待结算 -> 结算审批中 -> 已结算 -> 已冻结 -> 已关闭分销推广、佣金核算、审批和付款
相册作品内容草稿 -> 待审核 -> 已发布 -> 已下架 -> 已举报 -> 整改中 -> 已归档班级相册、成长相册、作品展和在校生活内容管理
总账账套草稿 -> 待初始化 -> 初始化中 -> 已启用 -> 结账中 -> 已停用 -> 异常法人、校区、会计政策、会计日历、账簿和科目体系启停审计
阿米巴报表待取数 -> 计算中 -> 待复核 -> 已发布 -> 规则异常 -> 已归档校区、课程、项目和团队阿米巴经营损益核算
摄像头教室绑定未绑定 -> 待校验 -> 已绑定 -> 绑定失败 -> 跨校区拦截 -> 教室停用拦截 -> 换绑中 -> 已停用摄像头必须绑定指定校区的指定教室,巡课、直播和回放均按教室归属校验权限
地图教室下钻待加载 -> 已加载 -> 部分离线 -> 全部离线 -> 无摄像头 -> 无权限 -> 加载失败校区地图大头钉可下钻到教室设备列表,展示设备总数、在线数、直播和回放入口
唯一性校验

远程巡课中心涉及该规则时,必须在前端提示、后端校验、审计日志和测试用例中同时覆盖。

跨校区数据隔离

远程巡课中心涉及该规则时,必须在前端提示、后端校验、审计日志和测试用例中同时覆盖。

敏感操作留痕

远程巡课中心涉及该规则时,必须在前端提示、后端校验、审计日志和测试用例中同时覆盖。

外部接口幂等

远程巡课中心涉及该规则时,必须在前端提示、后端校验、审计日志和测试用例中同时覆盖。

批量失败明细

远程巡课中心涉及该规则时,必须在前端提示、后端校验、审计日志和测试用例中同时覆盖。

状态回退审批

远程巡课中心涉及该规则时,必须在前端提示、后端校验、审计日志和测试用例中同时覆盖。

13 · 权限、审批与消息

动作权限、数据范围、审批触发和消息触达必须闭环

权限需要覆盖菜单、按钮、字段、接口和导出。

动作权限

  • 导入摄像头:需映射菜单、按钮、接口和字段权限
  • 绑定教室:需映射菜单、按钮、接口和字段权限
  • 地图教室下钻:需映射菜单、按钮、接口和字段权限
  • 地图巡课:需映射菜单、按钮、接口和字段权限
  • 打开直播:需映射菜单、按钮、接口和字段权限
  • 检索回放:需映射菜单、按钮、接口和字段权限
  • 海康直接下载:需映射菜单、按钮、接口和字段权限
  • 宇视拖动时间戳:需映射菜单、按钮、接口和字段权限
  • 宇视录制片段:需映射菜单、按钮、接口和字段权限
  • 下载片段:需映射菜单、按钮、接口和字段权限
  • 质量评分:需映射菜单、按钮、接口和字段权限
  • 整改复盘:需映射菜单、按钮、接口和字段权限

数据范围

  • 总部全量
  • 区域辖区
  • 校区本地
  • 部门/岗位
  • 本人负责
  • 授权班级/学员

审批配置

审批名称触发条件流程结果留痕
账套反结账审批已结账期间需要反结账或更正税务资料校区财务提交 -> 总部财务复核 -> 财务负责人终审通过后解锁期间并记录调整原因保留反结账前后凭证、税表和审批说明
物料采购审批采购金额超过阈值、跨校区采购或固定资产采购申请人 -> 校区负责人 -> 采购/财务 -> 总部审批通过后生成采购订单和到货验收任务保留预算、供应商、报价和采购合同附件
固定资产报废审批固定资产、图书或高价值物料需要报废责任人提交 -> 校区负责人 -> 资产管理员 -> 财务复核通过后出库、报废并生成财务核销记录保留照片、盘点记录、处置说明和残值
转校审批学员权益跨校区转移原校区校长 -> 目标校区校长 -> 财务确认权益和服务归属迁移记录转出转入校区和余额
课消撤销审批已确认收入的课消记录撤销教务提交 -> 校长 -> 财务撤销课消、恢复课时、冲回收入记录原课次和撤销原因
培训课程发布审批面向全员、跨校区或涉及制度类培训内容人事/教研提交 -> 部门负责人 -> 总部审核发布培训计划或退回修改记录适用岗位、资料版本和考试规则
直播供应商配置审批新增或变更直播供应商密钥、回调地址、录制存储、转码模板和域名配置技术运维 -> 系统管理员 -> 安全管理员通过后配置生效并触发连通性校验,同一租户仅保留一个启用供应商保留配置前后快照和验签结果
活动页面转模板审批校区或区域自建活动页面申请沉淀为可复用模板申请人 -> 区域市场 -> 总部品牌审核通过后进入模板库并按授权范围开放使用保留页面快照、素材、表单、埋点和审核意见

消息模板

消息接收人触发渠道变量
新线索分配提醒课程顾问线索分配成功站内信、App、企微学员姓名、来源渠道、校区、保护期
试听预约通知家长/教师/顾问试听课预约成功或变更小程序、短信、App上课时间、校区、教室、教师
库存预警库管/校区负责人物料或礼品低于安全库存站内信、App、企微SKU、校区、当前库存、安全库存、补货建议
积分兑换核销通知学员/家长/校区前台兑换成功、即将过期或核销完成小程序、App、站内信礼品名称、兑换码、核销校区、有效期
到校签到通知家长人脸或人工签到成功小程序、App学员姓名、签到时间、校区、课程
摄像头离线告警设备管理员/校区前台摄像头心跳超时或拉流失败站内信、App校区、教室、摄像头编号、品牌、异常时间
巡课整改通知校长/教师/教研督导督课记录生成整改项站内信、App、企微督课任务、问题等级、整改期限、回放片段
教学质量评分通知教师/校长/教研督导督课评分生成、低分预警或申诉复核站内信、App、企微课次、教师、综合分、低分维度、复核入口

14 · 接口与技术细节

接口需支持幂等、权限、审计、重试和回执

每个写接口必须有 requestId 或业务幂等键,外部回调必须验签和去重。
接口方法方向请求字段响应字段幂等/权限
/api/v1/patrol/camerasPOST/GETPC Web 到视频网关brand, deviceCode, campusId, classroomId, streamConfigcameraId, onlineStatus, bindStatus, classroomNamedeviceCode 唯一;campusId 与 classroomId 必填且必须一致
/api/v1/patrol/cameras/{id}/classroom-bindingPATCHPC Web 到视频网关cameraId, campusId, classroomId, bindReason, requestIdbindStatus, oldClassroomId, newClassroomId, auditId换绑需校验同校区启用教室;历史巡课记录保留原教室快照
/api/v1/patrol/mapGETPC Web 到平台regionId, campusId, onlineStatusmapPoints, alertCount, cameraSummary按数据范围过滤
/api/v1/patrol/map/{campusId}/classroomsGETPC Web 到平台campusId, onlineStatus, cameraStatusclassroomGroups, deviceTotal, onlineTotal, offlineTotal校区大头钉下钻到教室;仅返回授权校区设备
/api/v1/patrol/live-streamsPOSTPC Web 到视频网关cameraId, protocol, quality, requestIdplayUrl, token, expireAtrequestId 幂等
/api/v1/patrol/recordsGETPC Web 到视频网关cameraId, timeRange, lessonIdrecordings, timeline, marks, vendorCode, playbackMode, availableActions视频权限校验;海康返回原生回放与直接下载动作,宇视返回时间戳片段录制动作
/api/v1/patrol/records/download-urlPOSTPC Web 到视频网关cameraId, recordingId, timeRange, vendorCode, requestIddownloadUrl, expireAt, auditId仅海康 DIRECT_REPLAY_DOWNLOAD 可直接生成下载地址;宇视调用时返回能力不支持
/api/v1/patrol/recording-clip-tasksPOST/GETPC Web 到视频网关cameraId, anchorTimestamp, recordStartAt, recordEndAt, vendorCode, requestIdclipTaskId, taskStatus, replayUrl, downloadUrl, expireAt宇视 TIMESTAMP_CAPTURE_DOWNLOAD 必须先拖动时间轴定位时间戳并创建片段录制任务;requestId 幂等
/api/v1/patrol/recording-clip-tasks/{id}/retryPOSTPC Web 到视频网关clipTaskId, retryReason, requestIdtaskStatus, nextRetryAt, failureReason仅失败或超时任务可重试,重试保留原 anchorTimestamp 和起止时间
/api/v1/patrol/quality-scoresPOST督导到平台lessonId, teacherId, scoreItems, evidenceIdsscoreId, scoreLevel, rectifyTaskId评分规则版本锁定

前端约束

  • 统一登录态和租户校区上下文
  • 列表分页、筛选、排序、列显隐
  • 表单本地校验与服务端错误映射
  • 移动/平板/TV 按终端适配交互

后端约束

  • 领域服务封装业务规则
  • 写操作事务一致性
  • 关键操作审计快照
  • 异步任务失败重试和告警

集成约束

  • 第三方接口统一走开放集成中心
  • 回执文件归档
  • 接口日志可按业务单号追踪
  • 密钥和回调地址按环境隔离

15 · 数据库与存储设计

核心表建议、关键字段和索引方向

详细 DDL 已在平台技术设计文档中统一展开,本处保留模块核心表、关键字段和索引方向。
表名用途核心字段索引建议
video_platform_config海康威视/宇视视频平台配置id、tenant_id、org_id、campus_id、created_by、created_at、updated_by、updated_at、is_deleted、deleted_at、deleted_by、version、platform_code、vendor_code、platform_name、api_base_url、auth_config、record_retention_days、playback_capability、playback_policy、enableduk_platform_code、idx_vendor_enabled
video_gateway_config门店侧网关与公网直连配置id、tenant_id、org_id、campus_id、created_by、created_at、updated_by、updated_at、is_deleted、deleted_at、deleted_by、version、gateway_code、platform_id、access_mode、gateway_address、network_status、heartbeat_atuk_gateway_code、idx_platform_status
video_classroom_camera教室摄像头设备清单id、tenant_id、org_id、campus_id、created_by、created_at、updated_by、updated_at、is_deleted、deleted_at、deleted_by、version、camera_code、camera_name、platform_id、gateway_id、classroom_id、stream_address、playback_mode、record_channel_no、camera_statusuk_camera_code、idx_campus_classroom_status
video_recording_clip_task回放片段录制和下载任务id、tenant_id、org_id、campus_id、created_by、created_at、updated_by、updated_at、is_deleted、deleted_at、deleted_by、version、clip_task_no、camera_id、vendor_code、record_start_at、record_end_at、anchor_timestamp、task_mode、task_status、download_url、expire_at、failure_reasonuk_clip_task_no、idx_camera_time、idx_vendor_status
video_campus_map_point校区地图点位和设备汇总id、tenant_id、org_id、campus_id、created_by、created_at、updated_by、updated_at、is_deleted、deleted_at、deleted_by、version、longitude、latitude、device_total、online_total、point_statusuk_campus、idx_geo
patrol_record在线巡课记录id、tenant_id、org_id、campus_id、created_by、created_at、updated_by、updated_at、is_deleted、deleted_at、deleted_by、version、patrol_no、camera_id、lesson_id、patrol_user_id、start_at、end_at、patrol_statusuk_patrol_no、idx_camera_time
patrol_quality_score教学质量评分id、tenant_id、org_id、campus_id、created_by、created_at、updated_by、updated_at、is_deleted、deleted_at、deleted_by、version、score_no、patrol_record_id、teacher_id、student_dimension_json、teacher_dimension_json、total_score、score_statusuk_score_no、idx_teacher_status
patrol_rectification_task督课整改与复核id、tenant_id、org_id、campus_id、created_by、created_at、updated_by、updated_at、is_deleted、deleted_at、deleted_by、version、task_no、score_id、owner_id、rectify_requirement、deadline_at、verify_result、task_statusuk_task_no、idx_owner_status
patrol_snapshot_evidence巡课截图和证据归档id、tenant_id、org_id、campus_id、created_by、created_at、updated_by、updated_at、is_deleted、deleted_at、deleted_by、version、patrol_record_id、capture_at、file_id、evidence_type、evidence_desc、visible_scopeidx_patrol_time、idx_type

DDL 草案

video_platform_configVideoPlatformConfig
CREATE TABLE `video_platform_config` (
  `id` BIGINT NOT NULL COMMENT '主键,雪花或号段生成,禁止复用;数据级别:普通',
  `tenant_id` BIGINT NOT NULL COMMENT '集团/租户隔离字段,所有查询必须带租户上下文;数据级别:普通',
  `org_id` BIGINT NULL COMMENT '所属组织,集团级或公共配置为空;数据级别:普通',
  `campus_id` BIGINT NULL COMMENT '所属校区,跨校区或总部级数据为空;数据级别:普通',
  `created_by` BIGINT NOT NULL COMMENT '创建人账号 ID;数据级别:普通',
  `created_at` DATETIME NOT NULL COMMENT '创建时间;数据级别:普通',
  `updated_by` BIGINT NULL COMMENT '最后更新人账号 ID;数据级别:普通',
  `updated_at` DATETIME NULL COMMENT '最后更新时间;数据级别:普通',
  `is_deleted` TINYINT NOT NULL DEFAULT 0 COMMENT '是否已删除,0 未删除,1 已删除;数据级别:普通',
  `deleted_at` DATETIME NULL COMMENT '删除时间,未删除为空;数据级别:普通',
  `deleted_by` BIGINT NULL COMMENT '删除人账号 ID,未删除为空;数据级别:普通',
  `version` INT NOT NULL DEFAULT 1 COMMENT '乐观锁版本号,写操作必须校验;数据级别:普通',
  `platform_code` VARCHAR(64) NOT NULL COMMENT '平台编码,唯一;数据级别:普通',
  `vendor_code` VARCHAR(32) NOT NULL COMMENT 'HIKVISION/UNIVIEW;数据级别:普通',
  `platform_name` VARCHAR(128) NOT NULL COMMENT '平台名称;数据级别:普通',
  `api_base_url` VARCHAR(512) NOT NULL COMMENT '接口地址;数据级别:普通',
  `auth_config` JSON NOT NULL COMMENT '鉴权参数,密钥加密存储;数据级别:高敏',
  `record_retention_days` INT NOT NULL COMMENT '录像保留天数,默认 90;数据级别:普通',
  `playback_capability` VARCHAR(64) NOT NULL COMMENT 'DIRECT_REPLAY_DOWNLOAD/TIMESTAMP_CAPTURE_DOWNLOAD;数据级别:普通',
  `playback_policy` JSON NULL COMMENT '供应商回放下载策略,海康支持原生回放与录播下载,宇视需拖动到指定时间戳后录制片段再下载;数据级别:普通',
  `enabled` TINYINT NOT NULL COMMENT '是否启用;数据级别:普通',
  PRIMARY KEY (`id`),
  UNIQUE KEY `uk_platform_code` (`platform_code`),
  KEY `idx_vendor_enabled` (`vendor_code`, `enabled`),
  KEY `idx_tenant_deleted` (`tenant_id`, `is_deleted`)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_0900_ai_ci COMMENT='VideoPlatformConfig:海康威视/宇视视频平台配置';
video_gateway_configVideoGatewayConfig
CREATE TABLE `video_gateway_config` (
  `id` BIGINT NOT NULL COMMENT '主键,雪花或号段生成,禁止复用;数据级别:普通',
  `tenant_id` BIGINT NOT NULL COMMENT '集团/租户隔离字段,所有查询必须带租户上下文;数据级别:普通',
  `org_id` BIGINT NULL COMMENT '所属组织,集团级或公共配置为空;数据级别:普通',
  `campus_id` BIGINT NULL COMMENT '所属校区,跨校区或总部级数据为空;数据级别:普通',
  `created_by` BIGINT NOT NULL COMMENT '创建人账号 ID;数据级别:普通',
  `created_at` DATETIME NOT NULL COMMENT '创建时间;数据级别:普通',
  `updated_by` BIGINT NULL COMMENT '最后更新人账号 ID;数据级别:普通',
  `updated_at` DATETIME NULL COMMENT '最后更新时间;数据级别:普通',
  `is_deleted` TINYINT NOT NULL DEFAULT 0 COMMENT '是否已删除,0 未删除,1 已删除;数据级别:普通',
  `deleted_at` DATETIME NULL COMMENT '删除时间,未删除为空;数据级别:普通',
  `deleted_by` BIGINT NULL COMMENT '删除人账号 ID,未删除为空;数据级别:普通',
  `version` INT NOT NULL DEFAULT 1 COMMENT '乐观锁版本号,写操作必须校验;数据级别:普通',
  `gateway_code` VARCHAR(64) NOT NULL COMMENT '网关编码,唯一;数据级别:普通',
  `platform_id` BIGINT NOT NULL COMMENT '视频平台 ID;数据级别:普通',
  `access_mode` VARCHAR(32) NOT NULL COMMENT '公网直连/门店侧网关;数据级别:普通',
  `gateway_address` VARCHAR(512) NULL COMMENT '网关地址;数据级别:普通',
  `network_status` VARCHAR(32) NOT NULL COMMENT '在线/离线/异常;数据级别:普通',
  `heartbeat_at` DATETIME NULL COMMENT '最近心跳;数据级别:普通',
  PRIMARY KEY (`id`),
  UNIQUE KEY `uk_gateway_code` (`gateway_code`),
  KEY `idx_platform_status` (`platform_id`, `network_status`),
  KEY `idx_tenant_deleted` (`tenant_id`, `is_deleted`)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_0900_ai_ci COMMENT='VideoGatewayConfig:门店侧网关与公网直连配置';
video_classroom_cameraClassroomCamera
CREATE TABLE `video_classroom_camera` (
  `id` BIGINT NOT NULL COMMENT '主键,雪花或号段生成,禁止复用;数据级别:普通',
  `tenant_id` BIGINT NOT NULL COMMENT '集团/租户隔离字段,所有查询必须带租户上下文;数据级别:普通',
  `org_id` BIGINT NULL COMMENT '所属组织,集团级或公共配置为空;数据级别:普通',
  `campus_id` BIGINT NOT NULL COMMENT '所属校区,跨校区或总部级数据为空;本表业务要求必填;数据级别:普通',
  `created_by` BIGINT NOT NULL COMMENT '创建人账号 ID;数据级别:普通',
  `created_at` DATETIME NOT NULL COMMENT '创建时间;数据级别:普通',
  `updated_by` BIGINT NULL COMMENT '最后更新人账号 ID;数据级别:普通',
  `updated_at` DATETIME NULL COMMENT '最后更新时间;数据级别:普通',
  `is_deleted` TINYINT NOT NULL DEFAULT 0 COMMENT '是否已删除,0 未删除,1 已删除;数据级别:普通',
  `deleted_at` DATETIME NULL COMMENT '删除时间,未删除为空;数据级别:普通',
  `deleted_by` BIGINT NULL COMMENT '删除人账号 ID,未删除为空;数据级别:普通',
  `version` INT NOT NULL DEFAULT 1 COMMENT '乐观锁版本号,写操作必须校验;数据级别:普通',
  `camera_code` VARCHAR(64) NOT NULL COMMENT '摄像头编码,唯一;数据级别:普通',
  `camera_name` VARCHAR(128) NOT NULL COMMENT '摄像头名称;数据级别:普通',
  `platform_id` BIGINT NOT NULL COMMENT '所属视频平台;数据级别:普通',
  `gateway_id` BIGINT NULL COMMENT '门店网关 ID;数据级别:普通',
  `classroom_id` BIGINT NOT NULL COMMENT '绑定教室 ID,必须属于同一校区且教室未逻辑删除;数据级别:普通',
  `stream_address` VARCHAR(512) NULL COMMENT '直播流地址;数据级别:普通',
  `playback_mode` VARCHAR(64) NOT NULL COMMENT 'DIRECT_REPLAY_DOWNLOAD/TIMESTAMP_CAPTURE_DOWNLOAD,继承平台能力且可按通道覆盖;数据级别:普通',
  `record_channel_no` VARCHAR(64) NULL COMMENT '供应商录像通道号;数据级别:普通',
  `camera_status` VARCHAR(32) NOT NULL COMMENT '在线/离线/停用/异常;数据级别:普通',
  PRIMARY KEY (`id`),
  UNIQUE KEY `uk_camera_code` (`camera_code`),
  KEY `idx_campus_classroom_status` (`campus_id`, `classroom_id`, `camera_status`),
  KEY `idx_tenant_deleted` (`tenant_id`, `is_deleted`)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_0900_ai_ci COMMENT='ClassroomCamera:教室摄像头设备清单';
video_recording_clip_taskPatrolRecordingClipTask
CREATE TABLE `video_recording_clip_task` (
  `id` BIGINT NOT NULL COMMENT '主键,雪花或号段生成,禁止复用;数据级别:普通',
  `tenant_id` BIGINT NOT NULL COMMENT '集团/租户隔离字段,所有查询必须带租户上下文;数据级别:普通',
  `org_id` BIGINT NULL COMMENT '所属组织,集团级或公共配置为空;数据级别:普通',
  `campus_id` BIGINT NOT NULL COMMENT '所属校区,跨校区或总部级数据为空;本表业务要求必填;数据级别:普通',
  `created_by` BIGINT NOT NULL COMMENT '创建人账号 ID;数据级别:普通',
  `created_at` DATETIME NOT NULL COMMENT '创建时间;数据级别:普通',
  `updated_by` BIGINT NULL COMMENT '最后更新人账号 ID;数据级别:普通',
  `updated_at` DATETIME NULL COMMENT '最后更新时间;数据级别:普通',
  `is_deleted` TINYINT NOT NULL DEFAULT 0 COMMENT '是否已删除,0 未删除,1 已删除;数据级别:普通',
  `deleted_at` DATETIME NULL COMMENT '删除时间,未删除为空;数据级别:普通',
  `deleted_by` BIGINT NULL COMMENT '删除人账号 ID,未删除为空;数据级别:普通',
  `version` INT NOT NULL DEFAULT 1 COMMENT '乐观锁版本号,写操作必须校验;数据级别:普通',
  `clip_task_no` VARCHAR(64) NOT NULL COMMENT '片段任务编号,唯一;数据级别:普通',
  `camera_id` BIGINT NOT NULL COMMENT '摄像头 ID;数据级别:普通',
  `vendor_code` VARCHAR(32) NOT NULL COMMENT 'HIKVISION/UNIVIEW;数据级别:普通',
  `record_start_at` DATETIME NOT NULL COMMENT '片段开始时间;数据级别:普通',
  `record_end_at` DATETIME NOT NULL COMMENT '片段结束时间;数据级别:普通',
  `anchor_timestamp` DATETIME NULL COMMENT '宇视拖动定位时间戳;数据级别:普通',
  `task_mode` VARCHAR(64) NOT NULL COMMENT '原生下载/时间戳定位录制/手动补录;数据级别:普通',
  `task_status` VARCHAR(32) NOT NULL COMMENT '待处理/录制中/可下载/失败/已过期;数据级别:普通',
  `download_url` VARCHAR(512) NULL COMMENT '下载地址;数据级别:普通',
  `expire_at` DATETIME NULL COMMENT '下载链接过期时间;数据级别:普通',
  `failure_reason` VARCHAR(512) NULL COMMENT '失败原因;数据级别:普通',
  PRIMARY KEY (`id`),
  UNIQUE KEY `uk_clip_task_no` (`clip_task_no`),
  KEY `idx_camera_time` (`camera_id`),
  KEY `idx_vendor_status` (`vendor_code`, `task_status`),
  KEY `idx_tenant_deleted` (`tenant_id`, `is_deleted`)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_0900_ai_ci COMMENT='PatrolRecordingClipTask:回放片段录制和下载任务';
video_campus_map_pointCampusMapPoint
CREATE TABLE `video_campus_map_point` (
  `id` BIGINT NOT NULL COMMENT '主键,雪花或号段生成,禁止复用;数据级别:普通',
  `tenant_id` BIGINT NOT NULL COMMENT '集团/租户隔离字段,所有查询必须带租户上下文;数据级别:普通',
  `org_id` BIGINT NULL COMMENT '所属组织,集团级或公共配置为空;数据级别:普通',
  `campus_id` BIGINT NOT NULL COMMENT '所属校区,跨校区或总部级数据为空;本表业务要求必填;数据级别:普通',
  `created_by` BIGINT NOT NULL COMMENT '创建人账号 ID;数据级别:普通',
  `created_at` DATETIME NOT NULL COMMENT '创建时间;数据级别:普通',
  `updated_by` BIGINT NULL COMMENT '最后更新人账号 ID;数据级别:普通',
  `updated_at` DATETIME NULL COMMENT '最后更新时间;数据级别:普通',
  `is_deleted` TINYINT NOT NULL DEFAULT 0 COMMENT '是否已删除,0 未删除,1 已删除;数据级别:普通',
  `deleted_at` DATETIME NULL COMMENT '删除时间,未删除为空;数据级别:普通',
  `deleted_by` BIGINT NULL COMMENT '删除人账号 ID,未删除为空;数据级别:普通',
  `version` INT NOT NULL DEFAULT 1 COMMENT '乐观锁版本号,写操作必须校验;数据级别:普通',
  `longitude` DECIMAL(12,8) NOT NULL COMMENT '经度,后台动态配置;数据级别:普通',
  `latitude` DECIMAL(12,8) NOT NULL COMMENT '纬度,后台动态配置;数据级别:普通',
  `device_total` INT NOT NULL COMMENT '地图大头钉展示设备总数;数据级别:普通',
  `online_total` INT NOT NULL COMMENT '在线设备数;数据级别:普通',
  `point_status` VARCHAR(32) NOT NULL COMMENT '正常/异常/未配置;数据级别:普通',
  PRIMARY KEY (`id`),
  UNIQUE KEY `uk_campus` (`campus_id`),
  KEY `idx_geo` (`tenant_id`),
  KEY `idx_tenant_deleted` (`tenant_id`, `is_deleted`)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_0900_ai_ci COMMENT='CampusMapPoint:校区地图点位和设备汇总';
patrol_recordPatrolRecord
CREATE TABLE `patrol_record` (
  `id` BIGINT NOT NULL COMMENT '主键,雪花或号段生成,禁止复用;数据级别:普通',
  `tenant_id` BIGINT NOT NULL COMMENT '集团/租户隔离字段,所有查询必须带租户上下文;数据级别:普通',
  `org_id` BIGINT NULL COMMENT '所属组织,集团级或公共配置为空;数据级别:普通',
  `campus_id` BIGINT NULL COMMENT '所属校区,跨校区或总部级数据为空;数据级别:普通',
  `created_by` BIGINT NOT NULL COMMENT '创建人账号 ID;数据级别:普通',
  `created_at` DATETIME NOT NULL COMMENT '创建时间;数据级别:普通',
  `updated_by` BIGINT NULL COMMENT '最后更新人账号 ID;数据级别:普通',
  `updated_at` DATETIME NULL COMMENT '最后更新时间;数据级别:普通',
  `is_deleted` TINYINT NOT NULL DEFAULT 0 COMMENT '是否已删除,0 未删除,1 已删除;数据级别:普通',
  `deleted_at` DATETIME NULL COMMENT '删除时间,未删除为空;数据级别:普通',
  `deleted_by` BIGINT NULL COMMENT '删除人账号 ID,未删除为空;数据级别:普通',
  `version` INT NOT NULL DEFAULT 1 COMMENT '乐观锁版本号,写操作必须校验;数据级别:普通',
  `patrol_no` VARCHAR(64) NOT NULL COMMENT '巡课编号,唯一;数据级别:普通',
  `camera_id` BIGINT NOT NULL COMMENT '摄像头 ID;数据级别:普通',
  `lesson_id` BIGINT NULL COMMENT '课次 ID;数据级别:普通',
  `patrol_user_id` BIGINT NOT NULL COMMENT '巡课人员 ID;数据级别:普通',
  `start_at` DATETIME NOT NULL COMMENT '巡课开始时间;数据级别:普通',
  `end_at` DATETIME NULL COMMENT '巡课结束时间;数据级别:普通',
  `patrol_status` VARCHAR(32) NOT NULL COMMENT '进行中/已完成/异常中断;数据级别:普通',
  PRIMARY KEY (`id`),
  UNIQUE KEY `uk_patrol_no` (`patrol_no`),
  KEY `idx_camera_time` (`camera_id`),
  KEY `idx_tenant_deleted` (`tenant_id`, `is_deleted`)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_0900_ai_ci COMMENT='PatrolRecord:在线巡课记录';
patrol_quality_scoreTeachingQualityScore
CREATE TABLE `patrol_quality_score` (
  `id` BIGINT NOT NULL COMMENT '主键,雪花或号段生成,禁止复用;数据级别:普通',
  `tenant_id` BIGINT NOT NULL COMMENT '集团/租户隔离字段,所有查询必须带租户上下文;数据级别:普通',
  `org_id` BIGINT NULL COMMENT '所属组织,集团级或公共配置为空;数据级别:普通',
  `campus_id` BIGINT NULL COMMENT '所属校区,跨校区或总部级数据为空;数据级别:普通',
  `created_by` BIGINT NOT NULL COMMENT '创建人账号 ID;数据级别:普通',
  `created_at` DATETIME NOT NULL COMMENT '创建时间;数据级别:普通',
  `updated_by` BIGINT NULL COMMENT '最后更新人账号 ID;数据级别:普通',
  `updated_at` DATETIME NULL COMMENT '最后更新时间;数据级别:普通',
  `is_deleted` TINYINT NOT NULL DEFAULT 0 COMMENT '是否已删除,0 未删除,1 已删除;数据级别:普通',
  `deleted_at` DATETIME NULL COMMENT '删除时间,未删除为空;数据级别:普通',
  `deleted_by` BIGINT NULL COMMENT '删除人账号 ID,未删除为空;数据级别:普通',
  `version` INT NOT NULL DEFAULT 1 COMMENT '乐观锁版本号,写操作必须校验;数据级别:普通',
  `score_no` VARCHAR(64) NOT NULL COMMENT '评分编号,唯一;数据级别:普通',
  `patrol_record_id` BIGINT NOT NULL COMMENT '巡课记录 ID;数据级别:普通',
  `teacher_id` BIGINT NULL COMMENT '教师 ID;数据级别:普通',
  `student_dimension_json` JSON NULL COMMENT '学生维度评分;数据级别:普通',
  `teacher_dimension_json` JSON NULL COMMENT '教师维度评分;数据级别:普通',
  `total_score` DECIMAL(6,2) NOT NULL COMMENT '综合得分;数据级别:普通',
  `score_status` VARCHAR(32) NOT NULL COMMENT '草稿/已提交/已复核/已驳回;数据级别:普通',
  PRIMARY KEY (`id`),
  UNIQUE KEY `uk_score_no` (`score_no`),
  KEY `idx_teacher_status` (`teacher_id`, `score_status`),
  KEY `idx_tenant_deleted` (`tenant_id`, `is_deleted`)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_0900_ai_ci COMMENT='TeachingQualityScore:教学质量评分';
patrol_rectification_taskRectificationTask
CREATE TABLE `patrol_rectification_task` (
  `id` BIGINT NOT NULL COMMENT '主键,雪花或号段生成,禁止复用;数据级别:普通',
  `tenant_id` BIGINT NOT NULL COMMENT '集团/租户隔离字段,所有查询必须带租户上下文;数据级别:普通',
  `org_id` BIGINT NULL COMMENT '所属组织,集团级或公共配置为空;数据级别:普通',
  `campus_id` BIGINT NULL COMMENT '所属校区,跨校区或总部级数据为空;数据级别:普通',
  `created_by` BIGINT NOT NULL COMMENT '创建人账号 ID;数据级别:普通',
  `created_at` DATETIME NOT NULL COMMENT '创建时间;数据级别:普通',
  `updated_by` BIGINT NULL COMMENT '最后更新人账号 ID;数据级别:普通',
  `updated_at` DATETIME NULL COMMENT '最后更新时间;数据级别:普通',
  `is_deleted` TINYINT NOT NULL DEFAULT 0 COMMENT '是否已删除,0 未删除,1 已删除;数据级别:普通',
  `deleted_at` DATETIME NULL COMMENT '删除时间,未删除为空;数据级别:普通',
  `deleted_by` BIGINT NULL COMMENT '删除人账号 ID,未删除为空;数据级别:普通',
  `version` INT NOT NULL DEFAULT 1 COMMENT '乐观锁版本号,写操作必须校验;数据级别:普通',
  `task_no` VARCHAR(64) NOT NULL COMMENT '整改任务编号,唯一;数据级别:普通',
  `score_id` BIGINT NOT NULL COMMENT '评分 ID;数据级别:普通',
  `owner_id` BIGINT NOT NULL COMMENT '责任人 ID;数据级别:普通',
  `rectify_requirement` TEXT NOT NULL COMMENT '整改要求;数据级别:普通',
  `deadline_at` DATETIME NOT NULL COMMENT '整改截止时间;数据级别:普通',
  `verify_result` VARCHAR(32) NULL COMMENT '复核结果;数据级别:普通',
  `task_status` VARCHAR(32) NOT NULL COMMENT '待整改/待复核/已关闭/逾期;数据级别:普通',
  PRIMARY KEY (`id`),
  UNIQUE KEY `uk_task_no` (`task_no`),
  KEY `idx_owner_status` (`owner_id`, `task_status`),
  KEY `idx_tenant_deleted` (`tenant_id`, `is_deleted`)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_0900_ai_ci COMMENT='RectificationTask:督课整改与复核';
patrol_snapshot_evidenceSnapshotEvidence
CREATE TABLE `patrol_snapshot_evidence` (
  `id` BIGINT NOT NULL COMMENT '主键,雪花或号段生成,禁止复用;数据级别:普通',
  `tenant_id` BIGINT NOT NULL COMMENT '集团/租户隔离字段,所有查询必须带租户上下文;数据级别:普通',
  `org_id` BIGINT NULL COMMENT '所属组织,集团级或公共配置为空;数据级别:普通',
  `campus_id` BIGINT NULL COMMENT '所属校区,跨校区或总部级数据为空;数据级别:普通',
  `created_by` BIGINT NOT NULL COMMENT '创建人账号 ID;数据级别:普通',
  `created_at` DATETIME NOT NULL COMMENT '创建时间;数据级别:普通',
  `updated_by` BIGINT NULL COMMENT '最后更新人账号 ID;数据级别:普通',
  `updated_at` DATETIME NULL COMMENT '最后更新时间;数据级别:普通',
  `is_deleted` TINYINT NOT NULL DEFAULT 0 COMMENT '是否已删除,0 未删除,1 已删除;数据级别:普通',
  `deleted_at` DATETIME NULL COMMENT '删除时间,未删除为空;数据级别:普通',
  `deleted_by` BIGINT NULL COMMENT '删除人账号 ID,未删除为空;数据级别:普通',
  `version` INT NOT NULL DEFAULT 1 COMMENT '乐观锁版本号,写操作必须校验;数据级别:普通',
  `patrol_record_id` BIGINT NOT NULL COMMENT '巡课记录 ID;数据级别:普通',
  `capture_at` DATETIME NOT NULL COMMENT '截图时间;数据级别:普通',
  `file_id` BIGINT NOT NULL COMMENT '图片或视频文件 ID;数据级别:普通',
  `evidence_type` VARCHAR(32) NOT NULL COMMENT '截图/片段/备注/异常;数据级别:普通',
  `evidence_desc` VARCHAR(512) NULL COMMENT '证据说明;数据级别:普通',
  `visible_scope` VARCHAR(32) NOT NULL COMMENT '总部/校区/责任人/审计;数据级别:普通',
  PRIMARY KEY (`id`),
  KEY `idx_patrol_time` (`patrol_record_id`),
  KEY `idx_type` (`evidence_type`),
  KEY `idx_tenant_deleted` (`tenant_id`, `is_deleted`)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_0900_ai_ci COMMENT='SnapshotEvidence:巡课截图和证据归档';

16 · 异常、指标、测试与初始化

保证模块上线后可运营、可追踪、可验收

测试要覆盖主流程、异常流、权限流、接口失败和数据一致性。

异常状态

摄像头离线直播拉流失败录像缺失评分数据不足门店网关离线摄像头恢复失败评分规则版本失效摄像头未绑定教室摄像头跨校区绑定绑定教室已停用摄像头教室与巡课课次不匹配供应商回放能力不支持宇视片段录制失败片段录制超时下载链接过期时间戳无录像

指标埋点

摄像头教室绑定完整率地图教室下钻覆盖率摄像头在线率巡课覆盖率回放检索成功率海康录播下载成功率宇视片段录制成功率回放能力策略配置完整率督课评分完成率整改闭环率

测试用例

编号场景前置步骤预期优先级
TC-PAT-ROOM-001巡课摄像头必须绑定指定教室海康/宇视平台配置可用且教室已建档新增摄像头时分别提交空教室、跨校区教室、停用教室和同校区启用教室前三种被拦截;同校区启用教室可启用直播/回放并在教室设备绑定视图可见
TC-PAT-ROOM-002地图按校区教室下钻设备多个校区存在不同教室和摄像头在线离线状态打开远程巡课地图,点击校区大头钉并展开教室列表大头钉显示设备总数;下钻列表按教室展示摄像头、在线状态、直播入口、回放入口和异常处理入口
TC-PAT-PLAYBACK-001海康摄像头支持直接回放下载海康平台配置 playback_capability=DIRECT_REPLAY_DOWNLOAD,摄像头在线且 90 天内存在录像在回放页选择海康摄像头和时间范围,点击检索、播放回放并下载录播文件页面展示直接下载按钮;下载链接生成成功并记录下载人、下载时间、摄像头、时间范围和有效期;不要求先创建片段录制任务
TC-PAT-PLAYBACK-002宇视摄像头需时间戳录制后下载宇视平台配置 playback_capability=TIMESTAMP_CAPTURE_DOWNLOAD,摄像头在线且指定时间戳存在录像在回放页选择宇视摄像头,拖动时间轴到指定时间戳,设置片段起止时间并提交录制任务页面不展示直接下载按钮;提交后进入录制中,任务完成后展示片段回放和下载入口,记录 anchorTimestamp、起止时间、操作人和下载审计
TC-PAT-PLAYBACK-003宇视时间戳无录像或录制失败宇视摄像头在目标时间戳无录像或供应商返回录制失败拖动到无录像时间戳并提交片段录制任务系统提示时间戳无录像或录制失败,任务状态为失败,可查看供应商错误码、失败原因和重试入口,不生成可下载链接
TC-PAT-PLAYBACK-004回放能力未配置时动作降级摄像头未配置 playback_mode 或平台能力禁用进入回放页并尝试播放或下载页面显示能力未配置提示,只允许查看设备信息和发起配置修复;接口层拒绝下载/录制并记录审计
TC-005电子合同签署和收款合同模板启用生成合同、家长签署、支付合同已签署、订单已收款、权益生效
TC-008人脸签到自动课消学员已上传证件照、照片已下发到教室考勤设备且课次待签到模拟设备回传识别事件签到成功、课消成功、家长收到通知
TC-011学员端访问授权资源合同权益生效学员登录微信小程序或 App 打开课程资源资源可访问并记录学习进度,家长端仅查看学习报告摘要
TC-013教师发布作业并批改课次已完成教师发布作业,学员提交,教师批改学员端展示批改结果和成长档案
TC-018活码动态内容切换同一二维码配置不同班级资源不同学员扫码返回对应授权资源并记录扫码数据
TC-021跨校区数据隔离创建两个校区和不同校区账号校区 A 账号访问校区 B 客户无法查看或仅显示授权范围数据
TC-027设备离线补传设备离线后产生识别记录恢复网络并补传事件流水去重后生成签到或异常
TC-029课消撤销审批课次已课消并确认收入发起撤销课消审批后恢复课时并冲回收入
TC-038员工培训计划学习闭环培训计划已发布并分配员工员工打开培训、完成资料学习、提交考试学习进度、考试成绩和员工培训档案完整
TC-040千台级摄像头台账导入准备海康威视、宇视摄像头清单批量导入摄像头并绑定校区、教室和楼层点位导入成功、重复和错误明细清晰,摄像头状态可校验
TC-PAT-ENH-001视频接入交付闭环验收视频平台配置、网关配置、存储策略相关基础数据、权限、审批流、消息模板和接口配置已初始化按明确品牌、平台地址、鉴权参数、公网直连、网关、集中机房录像存储和 90 天循环覆盖配置。执行前端提交、后端处理、状态流转、异常重试和消息触达新增校区或设备无需改代码,通过后台配置即可接入。;同时产生审计日志、指标埋点和必要的补偿任务
TC-PAT-ENH-002地图巡课交付闭环验收校区地图、设备详情、直播页、回放页相关基础数据、权限、审批流、消息模板和接口配置已初始化按补齐地图监控、点位详情、设备列表、直播播放器、回放时间轴、录像缺失和存储异常提示。执行前端提交、后端处理、状态流转、异常重试和消息触达点击校区点位可看到设备总数、在线离线数并进入直播/回放。;同时产生审计日志、指标埋点和必要的补偿任务
TC-PAT-ENH-003督课评分交付闭环验收督课任务、评分表、整改复核相关基础数据、权限、审批流、消息模板和接口配置已初始化按补齐评分规则版本、评分维度、截图/片段证据、整改任务、教师反馈和复核关闭。执行前端提交、后端处理、状态流转、异常重试和消息触达每次评分都能追溯规则版本、证据、责任人和整改结果。;同时产生审计日志、指标埋点和必要的补偿任务

上线初始化

初始化项动作数据验收
设备参数登记人脸考勤机设备和校区绑定设备编号、位置、API 密钥、心跳阈值、识别阈值设备心跳正常且可接收人员下发
巡课设备维修工单规则初始化设备离线告警、派单规则、SLA、恢复校验、升级规则和责任角色issueType、ownerRule、sla、recheckRule、escalationRule设备离线可形成维修闭环
教室主数据初始化初始化各校区教室档案、容量、教室类型、楼栋楼层、启用状态和历史教室编码映射campusId、classroomCode、classroomName、classroomType、capacity、buildingName、floorNo、classroomStatus排课、班级、考勤设备、巡课摄像头和 TV 设备均可引用统一教室主数据
教室设备绑定初始化梳理一千多台教室摄像头、智能考勤设备、教学 TV 与校区教室的绑定关系deviceCode、cameraCode、tvDeviceCode、campusId、classroomId、vendorCode、onlineStatusMapping所有设备均能下钻到指定校区和指定教室,未绑定设备进入异常清单
教室占用规则初始化初始化教室可排课状态、维修不可用时段、冲突校验规则和容量校验规则classroomStatusRule、maintenanceWindow、conflictRule、capacityRule排课和补课安排可准确拦截教室冲突、停用和容量不足
巡课回放供应商能力初始化初始化海康威视与宇视视频平台回放能力策略,海康为原生回放下载,宇视为时间戳定位录制后下载vendorCode、playbackCapability、playbackPolicy、downloadExpireMinutes、clipMaxDurationMinutes回放页可按供应商动态展示正确动作
摄像头通道回放模式初始化按存量摄像头通道继承平台能力,并允许特殊通道覆盖 playback_modecameraId、platformId、vendorCode、recordChannelNo、playbackMode每个摄像头都能明确使用直接下载或片段录制下载
宇视片段录制任务规则初始化初始化宇视频道拖动时间戳、片段起止时间、录制任务超时、失败重试、下载过期和审计规则anchorTimestampRule、clipDurationLimit、taskTimeoutSeconds、retryPolicy、downloadExpireAt、auditRule宇视回放下载可形成任务闭环
组织与校区导入集团、品牌、法人主体、区域、校区、部门、岗位总部组织树、校区编码、法人关系、营业时间组织层级正确且权限可继承
账号与权限初始化总部、区域、校区、顾问、教务、教师、财务、家长、学员角色账号、角色、菜单、按钮、字段、数据范围测试账号可按角色访问指定页面
课程与价格导入课程、班型、课包、课时、价格、适用校区课程编码、班型、价格表、有效期、赠课规则报价和合同可正确引用价格
优惠规则初始化折扣、满减、优惠券、老带新、多科联报和组合包规则规则编码、叠加互斥、适用课程、校区、有效期、审批阈值报价单可正确计算并生成分摊明细
财务科目配置收款、预收、课消收入、退费、薪资、报销和内置科目映射科目、辅助核算、校区、项目、部门凭证可生成并写入测试账套
多账套会计按校区初始化独立账套、会计期间、凭证字、科目和税务参数账套编码、法人主体、校区、期间、税种、申报模板校区账套可独立记账,总部可汇总和复核
监管账户维护资金监管账户和教育局监管平台参数账户编号、校区映射、接口地址、证书、回调合同、收款、课消、退费可报送测试
视频接入交付配置初始化明确品牌、平台地址、鉴权参数、公网直连、网关、集中机房录像存储和 90 天循环覆盖配置。所需的页面入口、功能开关、审批流、消息模板、状态枚举、异常原因和角色权限视频平台配置、网关配置、存储策略新增校区或设备无需改代码,通过后台配置即可接入。
地图巡课交付配置初始化补齐地图监控、点位详情、设备列表、直播播放器、回放时间轴、录像缺失和存储异常提示。所需的页面入口、功能开关、审批流、消息模板、状态枚举、异常原因和角色权限校区地图、设备详情、直播页、回放页点击校区点位可看到设备总数、在线离线数并进入直播/回放。
督课评分交付配置初始化补齐评分规则版本、评分维度、截图/片段证据、整改任务、教师反馈和复核关闭。所需的页面入口、功能开关、审批流、消息模板、状态枚举、异常原因和角色权限督课任务、评分表、整改复核每次评分都能追溯规则版本、证据、责任人和整改结果。