迪诺学堂标识

06-智能考勤设备中心详细PRD

FAC · 打通人脸识别考勤机，实现人员下发、识别回传、自动签到、自动消课和异常队列。

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

01 · 模块定位

智能考勤设备中心

智能考勤设备中心负责设备档案、教室绑定、证件照更新同步、目标设备自动解析、人员照片下发、识别流水、离线打卡补传、权益课时校验、课时耗尽人脸清除、异常队列和隐私审计。学员证件照一经在教师端、家长端或学员端更新，系统可自动推导目标设备并完成新增/更新下发；不建设家长手动人脸撤回，但课时耗尽、合同到期或权益终止时必须自动清除设备侧人脸信息。

业务目标

打通人脸识别考勤机，实现人员下发、识别回传、自动签到、自动消课和异常队列。

使用终端

PC Web 设备管理端、人脸考勤机 API、教师端/家长端/学员端证件照上传入口；智能考勤设备必须绑定指定校区的指定教室。

验收主线

智能考勤设备中心负责设备档案、教室绑定、证件照更新同步、目标设备自动解析、人员照片下发、识别流水、离线打卡补传、权益课时校验、课时耗尽人脸清除、异常队列和隐私审计。学员证件照一经在教师端、家长端或学员端更新，系统可自动推导目标设备并完成新增/更新下发；不建设家长手动人脸撤回，但课时耗尽、合同到期或权益终止时必须自动清除设备侧人脸信息。

02 · 范围边界

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

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

模块内范围

  • 设备档案
  • 人员下发
  • 识别流水
  • 异常队列
  • 证件照更新自动下发
  • 设备日志
  • 隐私审计
  • 考勤设备教室绑定
  • 设备绑定异常队列
  • 证件照来源管理
  • 证件照更新同步队列
  • 目标设备自动解析
  • 离线打卡补传
  • 权益课时校验
  • 课时耗尽人脸清除

上游依赖

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

下游输出

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

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

智能考勤设备中心必须承接的已确认规则

本章节来自待决策与澄清清单的收口结果，已经转为本模块 PRD 的正式需求、配置项或默认实施规则。
分类事项本模块落地要求责任方
默认实施规则接口设计说明书组织方式采用单独 HTML 文件集中管理接口协议；模块 PRD 保留模块级接口摘要，避免每个模块重复写通用协议。产品/研发
默认实施规则接口错误码与重试中间件所有外部接口和内部异步任务统一错误码、幂等键、重试次数、告警阈值和回执归档策略。后端/测试/运维

04 · 业务流程

智能考勤设备中心主流程

流程用于指导原型图的页面顺序、按钮状态和异常分支。
01设备档案

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

02人员下发

人员下发包含学员、教师、员工、证件照/人脸照片、有效期和校区权限

03识别流水

人脸识别事件匹配课次后必须校验合同权益、课程有效期和剩余课时；无有效权益、合同到期或剩余课时为 0 时，不允许自动课消，识别流水进入异常队列并返回不可课消错误码与提示文案。

04异常队列

设备识别事件自动匹配课次时，优先按设备绑定教室、当前时间、班级课表和学员名单匹配，跨校区或未绑定教室的事件进入异常队列。

05证件照更新自动下发

证件照更新自动下发需覆盖入口、字段、状态、权限、审批/消息、异常处理、审计和指标统计，并与上下游模块保持数据一致。

06设备日志

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

07隐私审计

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

08考勤设备教室绑定

考勤设备教室绑定需覆盖入口、字段、状态、权限、审批/消息、异常处理、审计和指标统计，并与上下游模块保持数据一致。

05 · 功能清单

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

每一行功能都需要在原型中体现入口、状态、按钮、字段和反馈。
一级功能二级功能功能说明规则/验收
设备档案基础维护设备档案支持新增、编辑、启用/停用、查询、导入导出和操作审计。编码唯一、数据范围过滤、逻辑删除和审计留痕
设备档案业务处理设备档案需覆盖入口、字段、状态、权限、审批/消息、异常处理、审计和指标统计，并与上下游模块保持数据一致。必须联动状态、权限、消息、审批和指标
设备档案异常闭环低置信度处理失败原因可见、可重试、可转人工、可追溯
人员下发基础维护人员下发支持新增、编辑、启用/停用、查询、导入导出和操作审计。编码唯一、数据范围过滤、逻辑删除和审计留痕
人员下发业务处理人员下发包含学员、教师、员工、证件照/人脸照片、有效期和校区权限必须联动状态、权限、消息、审批和指标
人员下发异常闭环设备离线处理失败原因可见、可重试、可转人工、可追溯
识别流水基础维护识别流水支持新增、编辑、启用/停用、查询、导入导出和操作审计。编码唯一、数据范围过滤、逻辑删除和审计留痕
识别流水业务处理人脸识别事件匹配课次后必须校验合同权益、课程有效期和剩余课时；无有效权益、合同到期或剩余课时为 0 时，不允许自动课消，识别流水进入异常队列并返回不可课消错误码与提示文案。必须联动状态、权限、消息、审批和指标
识别流水异常闭环跨校区识别处理失败原因可见、可重试、可转人工、可追溯
异常队列基础维护异常队列支持新增、编辑、启用/停用、查询、导入导出和操作审计。编码唯一、数据范围过滤、逻辑删除和审计留痕
异常队列业务处理设备识别事件自动匹配课次时，优先按设备绑定教室、当前时间、班级课表和学员名单匹配，跨校区或未绑定教室的事件进入异常队列。必须联动状态、权限、消息、审批和指标
异常队列异常闭环设备未绑定教室处理失败原因可见、可重试、可转人工、可追溯
证件照更新自动下发基础维护证件照更新自动下发支持新增、编辑、启用/停用、查询、导入导出和操作审计。编码唯一、数据范围过滤、逻辑删除和审计留痕
证件照更新自动下发业务处理证件照更新自动下发需覆盖入口、字段、状态、权限、审批/消息、异常处理、审计和指标统计，并与上下游模块保持数据一致。必须联动状态、权限、消息、审批和指标
证件照更新自动下发异常闭环设备跨校区绑定处理失败原因可见、可重试、可转人工、可追溯
设备日志基础维护设备日志支持新增、编辑、启用/停用、查询、导入导出和操作审计。编码唯一、数据范围过滤、逻辑删除和审计留痕
设备日志业务处理设备日志需覆盖入口、字段、状态、权限、审批/消息、异常处理、审计和指标统计，并与上下游模块保持数据一致。必须联动状态、权限、消息、审批和指标
设备日志异常闭环绑定教室已停用处理失败原因可见、可重试、可转人工、可追溯
隐私审计基础维护隐私审计支持新增、编辑、启用/停用、查询、导入导出和操作审计。编码唯一、数据范围过滤、逻辑删除和审计留痕
隐私审计业务处理隐私审计需覆盖入口、字段、状态、权限、审批/消息、异常处理、审计和指标统计，并与上下游模块保持数据一致。必须联动状态、权限、消息、审批和指标
隐私审计异常闭环设备教室与课次不匹配处理失败原因可见、可重试、可转人工、可追溯
考勤设备教室绑定基础维护考勤设备教室绑定支持新增、编辑、启用/停用、查询、导入导出和操作审计。编码唯一、数据范围过滤、逻辑删除和审计留痕
考勤设备教室绑定业务处理考勤设备教室绑定需覆盖入口、字段、状态、权限、审批/消息、异常处理、审计和指标统计，并与上下游模块保持数据一致。必须联动状态、权限、消息、审批和指标
考勤设备教室绑定异常闭环证件照缺失处理失败原因可见、可重试、可转人工、可追溯
设备绑定异常队列基础维护设备绑定异常队列支持新增、编辑、启用/停用、查询、导入导出和操作审计。编码唯一、数据范围过滤、逻辑删除和审计留痕
设备绑定异常队列业务处理设备绑定异常队列需覆盖入口、字段、状态、权限、审批/消息、异常处理、审计和指标统计，并与上下游模块保持数据一致。必须联动状态、权限、消息、审批和指标
设备绑定异常队列异常闭环证件照质量不合格处理失败原因可见、可重试、可转人工、可追溯
证件照来源管理基础维护证件照来源管理支持新增、编辑、启用/停用、查询、导入导出和操作审计。编码唯一、数据范围过滤、逻辑删除和审计留痕
证件照来源管理业务处理证件照来源管理需覆盖入口、字段、状态、权限、审批/消息、异常处理、审计和指标统计，并与上下游模块保持数据一致。必须联动状态、权限、消息、审批和指标
证件照来源管理异常闭环学员课程未关联教室处理失败原因可见、可重试、可转人工、可追溯
证件照更新同步队列基础维护证件照更新同步队列支持新增、编辑、启用/停用、查询、导入导出和操作审计。编码唯一、数据范围过滤、逻辑删除和审计留痕
证件照更新同步队列业务处理证件照更新同步队列需覆盖入口、字段、状态、权限、审批/消息、异常处理、审计和指标统计，并与上下游模块保持数据一致。必须联动状态、权限、消息、审批和指标
证件照更新同步队列异常闭环目标教室无考勤设备处理失败原因可见、可重试、可转人工、可追溯
目标设备自动解析基础维护目标设备自动解析支持新增、编辑、启用/停用、查询、导入导出和操作审计。编码唯一、数据范围过滤、逻辑删除和审计留痕
目标设备自动解析业务处理目标设备自动解析需覆盖入口、字段、状态、权限、审批/消息、异常处理、审计和指标统计，并与上下游模块保持数据一致。必须联动状态、权限、消息、审批和指标
目标设备自动解析异常闭环设备离线待补传处理失败原因可见、可重试、可转人工、可追溯
离线打卡补传基础维护离线打卡补传支持新增、编辑、启用/停用、查询、导入导出和操作审计。编码唯一、数据范围过滤、逻辑删除和审计留痕
离线打卡补传业务处理离线打卡补传需覆盖入口、字段、状态、权限、审批/消息、异常处理、审计和指标统计，并与上下游模块保持数据一致。必须联动状态、权限、消息、审批和指标
离线打卡补传异常闭环离线补传重复事件处理失败原因可见、可重试、可转人工、可追溯
权益课时校验基础维护权益课时校验支持新增、编辑、启用/停用、查询、导入导出和操作审计。编码唯一、数据范围过滤、逻辑删除和审计留痕
权益课时校验业务处理权益课时校验需覆盖入口、字段、状态、权限、审批/消息、异常处理、审计和指标统计，并与上下游模块保持数据一致。必须联动状态、权限、消息、审批和指标
权益课时校验异常闭环无有效权益处理失败原因可见、可重试、可转人工、可追溯
课时耗尽人脸清除基础维护课时耗尽人脸清除支持新增、编辑、启用/停用、查询、导入导出和操作审计。编码唯一、数据范围过滤、逻辑删除和审计留痕
课时耗尽人脸清除业务处理课时耗尽人脸清除需覆盖入口、字段、状态、权限、审批/消息、异常处理、审计和指标统计，并与上下游模块保持数据一致。必须联动状态、权限、消息、审批和指标
课时耗尽人脸清除异常闭环剩余课时不足处理失败原因可见、可重试、可转人工、可追溯

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

功能域承接对象核心表代表接口状态机/状态字段研发落地校验
设备档案FaceDevice、FacePerson、FaceDispatchTask、FacePhotoSyncTaskdev_face_device、dev_face_person、dev_face_dispatch_task、dev_face_photo_sync_task接口资源组 /api/v1/fac/features/01device_status、person_type、sync_status、action_type、task_status新增/编辑/删除/审批/导出/回调均需校验租户、校区、角色、数据范围、逻辑删除、幂等和审计
人员下发FaceDevice、FacePerson、FaceDispatchTask、FacePhotoSyncTaskdev_face_device、dev_face_person、dev_face_dispatch_task、dev_face_photo_sync_taskPATCH /api/v1/face/devices/{id}/classroom-bindingdevice_status、person_type、sync_status、action_type、task_status新增/编辑/删除/审批/导出/回调均需校验租户、校区、角色、数据范围、逻辑删除、幂等和审计
识别流水FaceDevice、FacePerson、FaceDispatchTask、FacePhotoSyncTaskdev_face_device、dev_face_person、dev_face_dispatch_task、dev_face_photo_sync_task接口资源组 /api/v1/fac/features/03device_status、person_type、sync_status、action_type、task_status新增/编辑/删除/审批/导出/回调均需校验租户、校区、角色、数据范围、逻辑删除、幂等和审计
异常队列FaceDevice、FacePerson、FaceDispatchTask、FacePhotoSyncTaskdev_face_device、dev_face_person、dev_face_dispatch_task、dev_face_photo_sync_task接口资源组 /api/v1/fac/features/04device_status、person_type、sync_status、action_type、task_status新增/编辑/删除/审批/导出/回调均需校验租户、校区、角色、数据范围、逻辑删除、幂等和审计
证件照更新自动下发FaceDevice、FacePerson、FaceDispatchTask、FacePhotoSyncTaskdev_face_device、dev_face_person、dev_face_dispatch_task、dev_face_photo_sync_task接口资源组 /api/v1/fac/features/05device_status、person_type、sync_status、action_type、task_status新增/编辑/删除/审批/导出/回调均需校验租户、校区、角色、数据范围、逻辑删除、幂等和审计
设备日志FaceDevice、FacePerson、FaceDispatchTask、FacePhotoSyncTaskdev_face_device、dev_face_person、dev_face_dispatch_task、dev_face_photo_sync_task接口资源组 /api/v1/fac/features/06device_status、person_type、sync_status、action_type、task_status新增/编辑/删除/审批/导出/回调均需校验租户、校区、角色、数据范围、逻辑删除、幂等和审计
隐私审计FaceDevice、FacePerson、FaceDispatchTask、FacePhotoSyncTaskdev_face_device、dev_face_person、dev_face_dispatch_task、dev_face_photo_sync_task接口资源组 /api/v1/fac/features/07device_status、person_type、sync_status、action_type、task_status新增/编辑/删除/审批/导出/回调均需校验租户、校区、角色、数据范围、逻辑删除、幂等和审计
考勤设备教室绑定FaceDevice、FacePerson、FaceDispatchTask、FacePhotoSyncTaskdev_face_device、dev_face_person、dev_face_dispatch_task、dev_face_photo_sync_task接口资源组 /api/v1/fac/features/08device_status、person_type、sync_status、action_type、task_status新增/编辑/删除/审批/导出/回调均需校验租户、校区、角色、数据范围、逻辑删除、幂等和审计
设备绑定异常队列FaceDevice、FacePerson、FaceDispatchTask、FacePhotoSyncTaskdev_face_device、dev_face_person、dev_face_dispatch_task、dev_face_photo_sync_task接口资源组 /api/v1/fac/features/09device_status、person_type、sync_status、action_type、task_status新增/编辑/删除/审批/导出/回调均需校验租户、校区、角色、数据范围、逻辑删除、幂等和审计
证件照来源管理FaceDevice、FacePerson、FaceDispatchTask、FacePhotoSyncTaskdev_face_device、dev_face_person、dev_face_dispatch_task、dev_face_photo_sync_task接口资源组 /api/v1/fac/features/10device_status、person_type、sync_status、action_type、task_status新增/编辑/删除/审批/导出/回调均需校验租户、校区、角色、数据范围、逻辑删除、幂等和审计
证件照更新同步队列FaceDevice、FacePerson、FaceDispatchTask、FacePhotoSyncTaskdev_face_device、dev_face_person、dev_face_dispatch_task、dev_face_photo_sync_task接口资源组 /api/v1/fac/features/11device_status、person_type、sync_status、action_type、task_status新增/编辑/删除/审批/导出/回调均需校验租户、校区、角色、数据范围、逻辑删除、幂等和审计
目标设备自动解析FaceDevice、FacePerson、FaceDispatchTask、FacePhotoSyncTaskdev_face_device、dev_face_person、dev_face_dispatch_task、dev_face_photo_sync_task接口资源组 /api/v1/fac/features/12device_status、person_type、sync_status、action_type、task_status新增/编辑/删除/审批/导出/回调均需校验租户、校区、角色、数据范围、逻辑删除、幂等和审计
离线打卡补传FaceDevice、FacePerson、FaceDispatchTask、FacePhotoSyncTaskdev_face_device、dev_face_person、dev_face_dispatch_task、dev_face_photo_sync_task接口资源组 /api/v1/fac/features/13device_status、person_type、sync_status、action_type、task_status新增/编辑/删除/审批/导出/回调均需校验租户、校区、角色、数据范围、逻辑删除、幂等和审计
权益课时校验FaceDevice、FacePerson、FaceDispatchTask、FacePhotoSyncTaskdev_face_device、dev_face_person、dev_face_dispatch_task、dev_face_photo_sync_task接口资源组 /api/v1/fac/features/14device_status、person_type、sync_status、action_type、task_status新增/编辑/删除/审批/导出/回调均需校验租户、校区、角色、数据范围、逻辑删除、幂等和审计
课时耗尽人脸清除FaceClearanceTaskdev_face_clearance_task接口资源组 /api/v1/fac/features/15trigger_type、clearance_status新增/编辑/删除/审批/导出/回调均需校验租户、校区、角色、数据范围、逻辑删除、幂等和审计

06 · 原子级功能需求

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

需求编号可直接进入项目管理工具。
编号需求描述入口页面关键动作输入校验输出结果异常处理验收标准
FR-FAC-001设备需支持 API 二次开发、人员照片下发、识别事件回传和心跳设备档案设备建档校验租户、校区、角色、数据范围、状态前置、必填、唯一和敏感操作授权生成业务记录、状态流转、消息通知、审计日志、指标快照和必要的第三方任务低置信度主流程、异常流、权限流、接口失败和数据一致性均可通过测试
FR-FAC-002人员下发包含学员、教师、员工、证件照/人脸照片、有效期和校区权限证件照更新同步队列证件照更新、目标设备解析、人员照片下发或离线打卡补传校验租户、校区、角色、数据范围、状态前置、必填、唯一和敏感操作授权生成业务记录、状态流转、消息通知、审计日志、指标快照和必要的第三方任务证件照质量不合格、课程教室设备关系缺失、设备离线或补传重复事件主流程、异常流、权限流、接口失败和数据一致性均可通过测试
FR-FAC-003识别事件按学生、校区、课表、时间窗口、班级和课程匹配课次考勤设备绑定教室换绑教室校验租户、校区、角色、数据范围、状态前置、必填、唯一和敏感操作授权生成业务记录、状态流转、消息通知、审计日志、指标快照和必要的第三方任务跨校区识别主流程、异常流、权限流、接口失败和数据一致性均可通过测试
FR-FAC-004低置信度、未匹配、重复识别、跨校识别进入人工确认学员证件照上传证件照更新校验租户、校区、角色、数据范围、状态前置、必填、唯一和敏感操作授权生成业务记录、状态流转、消息通知、审计日志、指标快照和必要的第三方任务设备未绑定教室主流程、异常流、权限流、接口失败和数据一致性均可通过测试
FR-FAC-005人脸识别考勤设备必须绑定到指定校区的指定教室，设备创建、编辑、启用和人员下发前必须校验 campusId、classroomId、教室启用状态和设备归属一致性。证件照更新同步队列证件照更新、目标设备解析、人员照片下发或离线打卡补传校验租户、校区、角色、数据范围、状态前置、必填、唯一和敏感操作授权生成业务记录、状态流转、消息通知、审计日志、指标快照和必要的第三方任务证件照质量不合格、课程教室设备关系缺失、设备离线或补传重复事件主流程、异常流、权限流、接口失败和数据一致性均可通过测试
FR-FAC-006设备识别事件自动匹配课次时，优先按设备绑定教室、当前时间、班级课表和学员名单匹配，跨校区或未绑定教室的事件进入异常队列。指标异常处理异常订阅、责任人处理或口径审批校验租户、校区、角色、数据范围、状态前置、必填、唯一和敏感操作授权生成业务记录、状态流转、消息通知、审计日志、指标快照和必要的第三方任务指标延迟、责任人缺失或口径版本不一致主流程、异常流、权限流、接口失败和数据一致性均可通过测试
FR-FAC-007教师端、家长端、学员端均可按权限手动上传或更新学员证件照，系统保留照片版本、上传来源、上传人和审核/质量校验结果。证件照更新同步队列证件照更新、目标设备解析、人员照片下发或离线打卡补传校验租户、校区、角色、数据范围、状态前置、必填、唯一和敏感操作授权生成业务记录、状态流转、消息通知、审计日志、指标快照和必要的第三方任务证件照质量不合格、课程教室设备关系缺失、设备离线或补传重复事件主流程、异常流、权限流、接口失败和数据一致性均可通过测试
FR-FAC-008学员关联课程，课程关联教室，教室关联人脸识别考勤设备；学员证件照更新后，系统自动解析该学员当前有效课程、班级、教室和目标设备范围，生成新增或更新下发任务。证件照更新同步队列证件照更新、目标设备解析、人员照片下发或离线打卡补传校验租户、校区、角色、数据范围、状态前置、必填、唯一和敏感操作授权生成业务记录、状态流转、消息通知、审计日志、指标快照和必要的第三方任务证件照质量不合格、课程教室设备关系缺失、设备离线或补传重复事件主流程、异常流、权限流、接口失败和数据一致性均可通过测试
FR-FAC-009人脸信息不设置撤回流程，只支持更新；新照片下发成功后覆盖设备侧旧照片或旧特征值，所有更新、失败、重试和人工处理必须留痕。证件照更新同步队列证件照更新、目标设备解析、人员照片下发或离线打卡补传校验租户、校区、角色、数据范围、状态前置、必填、唯一和敏感操作授权生成业务记录、状态流转、消息通知、审计日志、指标快照和必要的第三方任务证件照质量不合格、课程教室设备关系缺失、设备离线或补传重复事件主流程、异常流、权限流、接口失败和数据一致性均可通过测试
FR-FAC-010设备离线时产生的打卡记录由设备本地缓存，联网恢复后自动补传；系统按 deviceId + deviceEventId 去重，补传成功后继续匹配课次、签到和课消。权益课时校验异常人脸自动清除校验租户、校区、角色、数据范围、状态前置、必填、唯一和敏感操作授权生成业务记录、状态流转、消息通知、审计日志、指标快照和必要的第三方任务学员课程未关联教室主流程、异常流、权限流、接口失败和数据一致性均可通过测试
FR-FAC-011人脸识别事件匹配课次后必须校验合同权益、课程有效期和剩余课时；无有效权益、合同到期或剩余课时为 0 时，不允许自动课消，识别流水进入异常队列并返回不可课消错误码与提示文案。指标异常处理异常订阅、责任人处理或口径审批校验租户、校区、角色、数据范围、状态前置、必填、唯一和敏感操作授权生成业务记录、状态流转、消息通知、审计日志、指标快照和必要的第三方任务指标延迟、责任人缺失或口径版本不一致主流程、异常流、权限流、接口失败和数据一致性均可通过测试
FR-FAC-012每次成功课消后必须触发权益余额复核；当学员在对应课程、班级或合同下的课时全部消耗完成后，系统自动解析关联教室设备并生成设备侧人脸清除任务，清除成功后该学员不再参与对应设备识别匹配。证件照更新同步队列证件照更新、目标设备解析、人员照片下发或离线打卡补传校验租户、校区、角色、数据范围、状态前置、必填、唯一和敏感操作授权生成业务记录、状态流转、消息通知、审计日志、指标快照和必要的第三方任务证件照质量不合格、课程教室设备关系缺失、设备离线或补传重复事件主流程、异常流、权限流、接口失败和数据一致性均可通过测试
FR-FAC-013课时耗尽触发的设备侧人脸清除属于权益生命周期自动动作，不属于家长手动撤回；清除任务需要保留触发原因、剩余课时快照、目标设备、回执、失败重试和人工处理记录。活动大屏配置/实时战报配置模板、数据源、指标口径、战区 PK、投屏发布或实时刷新校验租户、校区、角色、数据范围、状态前置、必填、唯一和敏感操作授权生成业务记录、状态流转、消息通知、审计日志、指标快照和必要的第三方任务数据源缺失、指标口径校验失败、公开访问令牌过期或实时刷新断连主流程、异常流、权限流、接口失败和数据一致性均可通过测试

07 · 关联闭环补充需求

智能考勤设备中心在跨模块闭环中的责任边界

本章节承接最终闭环核对清单，明确本模块需要补齐的页面、接口对象、异常兜底和验收口径。
闭环项本模块责任关键场景页面/功能补充关联对象/接口验收口径
考勤设备绑定教室负责人脸考勤设备与指定校区、指定教室的绑定校验、换绑审计和识别事件课次匹配设备扫脸签到必须知道发生在哪个校区和教室，才能匹配课次并自动签到课消设备建档、绑定教室、换绑审计、识别流水、异常队列FaceDevice、Classroom、FaceAttendanceEvent、/api/v1/face/devices设备必须绑定同校区启用教室；未绑定或跨校区事件不得自动签到课消
设备维修工单考勤机离线、识别异常或照片下发失败时生成设备异常线索人脸考勤设备故障影响签到、课消和到访接待设备状态、识别事件、异常上报、维修工单入口Device/FaceAttendanceEvent、AssetLifecycle/Maintenance设备异常必须能转维修工单并回写处理结果

08 · 页面与原型设计说明

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

原型图设计需要覆盖列表、详情、表单、弹窗、空状态、异常状态和权限状态。
终端页面用户页面目标布局结构关键按钮关键字段异常状态原型备注
PC Web设备档案设备管理员维护设备、校区、在线状态、心跳设备页按校区、设备、人员、事件四层组织，识别流水支持照片、置信度、课次匹配和异常处理入口。新增设备、证件照更新、目标设备解析、人员照片下发、查看心跳、确认异常、重试下发、查看回执设备编号、设备品牌、所属校区、绑定教室、人员编号、人脸照片、照片版本、来源终端、置信度、匹配课次设备离线、证件照质量不合格、学员课程未关联教室、目标教室无考勤设备、人员下发失败、低置信度、跨校区识别、离线补传重复事件需覆盖教师端/家长端/学员端证件照上传、课程教室设备自动解析、人员照片新增/更新下发、识别异常确认、设备离线打卡联网后自动补传和隐私审计。 建议 Figma Frame：FAC-设备档案；需补齐正常、空态、加载、无权限、处理中、成功和失败状态。
PC Web识别流水教务/设备管理员查看扫脸事件、匹配课次、异常确认设备页按校区、设备、人员、事件四层组织，识别流水支持照片、置信度、课次匹配和异常处理入口。新增设备、证件照更新、目标设备解析、人员照片下发、查看心跳、确认异常、重试下发、查看回执设备编号、设备品牌、所属校区、绑定教室、人员编号、人脸照片、照片版本、来源终端、置信度、匹配课次设备离线、证件照质量不合格、学员课程未关联教室、目标教室无考勤设备、人员下发失败、低置信度、跨校区识别、离线补传重复事件需覆盖教师端/家长端/学员端证件照上传、课程教室设备自动解析、人员照片新增/更新下发、识别异常确认、设备离线打卡联网后自动补传和隐私审计。 建议 Figma Frame：FAC-识别流水；需补齐正常、空态、加载、无权限、处理中、成功和失败状态。
PC Web考勤设备绑定教室设备管理员/教务创建或编辑考勤设备时必须选择校区和教室，系统校验教室存在、未停用、未逻辑删除且归属同校区PC 端采用顶部筛选、左侧列表或导航、中部主工作区、右侧详情抽屉，复杂操作进入弹窗或步骤条。查询、新增、编辑、提交、导出、查看日志、设备建档、绑定教室设备编号、设备品牌、所属校区、绑定教室、教室状态、在线状态、照片来源终端、照片版本、剩余课时、权益校验状态空数据、无权限、加载失败、保存失败、审批驳回、批量部分失败管理员端沿用统一框架，原型重点标注信息架构、表单弹窗、状态流和异常处理。 建议 Figma Frame：FAC-考勤设备绑定教室；需补齐正常、空态、加载、无权限、处理中、成功和失败状态。
教师端 App/小程序学员证件照上传教师/班主任/学管师按权限为本人负责班级或学员上传证件照，提交后进入照片质量校验和人脸下发同步队列设备页按校区、设备、人员、事件四层组织，识别流水支持照片、置信度、课次匹配和异常处理入口。新增设备、证件照更新、目标设备解析、人员照片下发、查看心跳、确认异常、重试下发、查看回执设备编号、设备品牌、所属校区、绑定教室、人员编号、人脸照片、照片版本、来源终端、置信度、匹配课次设备离线、证件照质量不合格、学员课程未关联教室、目标教室无考勤设备、人员下发失败、低置信度、跨校区识别、离线补传重复事件需覆盖教师端/家长端/学员端证件照上传、课程教室设备自动解析、人员照片新增/更新下发、识别异常确认、设备离线打卡联网后自动补传和隐私审计。 建议 Figma Frame：FAC-学员证件照上传；需补齐正常、空态、加载、无权限、处理中、成功和失败状态。
家长端小程序/H5学员证件照上传家长为绑定学员上传或更新证件照，系统记录家长来源、照片版本和隐私授权确认信息家长端使用移动端卡片流和底部主按钮，重要操作采用二次确认弹窗并展示处理进度。绑定学员、查看课表、提交请假、确认补课、改期取消、缴费、签署合同、提交工单绑定学员、课程、合同、应缴金额、请假课次、补课候选、服务工单、服务消息、设备编号、设备品牌绑定关系异常、补课候选过期、支付失败、合同签署失败、工单已关闭、消息发送失败需覆盖微信小程序/H5 状态、合同缴费、补课候选确认、服务通知、工单进度和异常联系入口。 建议 Figma Frame：FAC-学员证件照上传；需补齐正常、空态、加载、无权限、处理中、成功和失败状态。
学员端小程序/App学员证件照上传学员学员可按学校开放范围上传或更新本人证件照，提交后由系统进入质量校验与设备同步移动端采用顶部标题/状态区、内容卡片流和底部主按钮；平板端需要分栏布局和横屏适配。查看、提交、保存、取消、确认、联系客服、设备建档、绑定教室设备编号、设备品牌、所属校区、绑定教室、教室状态、在线状态、照片来源终端、照片版本、剩余课时、权益校验状态网络异常、权限不足、提交失败、状态已变化需分别标注小程序、App、H5、平板和桌面壳的适配差异。 建议 Figma Frame：FAC-学员证件照上传；需补齐正常、空态、加载、无权限、处理中、成功和失败状态。
PC Web证件照更新同步队列设备管理员/教务/安全管理员查看照片来源、照片版本、目标课程、目标教室、目标设备、下发状态、失败原因和重试入口PC 端采用顶部筛选、左侧列表或导航、中部主工作区、右侧详情抽屉，复杂操作进入弹窗或步骤条。查询、新增、编辑、提交、导出、查看日志、设备建档、绑定教室设备编号、设备品牌、所属校区、绑定教室、教室状态、在线状态、照片来源终端、照片版本、剩余课时、权益校验状态空数据、无权限、加载失败、保存失败、审批驳回、批量部分失败管理员端沿用统一框架，原型重点标注信息架构、表单弹窗、状态流和异常处理。 建议 Figma Frame：FAC-证件照更新同步队列；需补齐正常、空态、加载、无权限、处理中、成功和失败状态。
PC Web目标设备自动解析设备管理员/教务根据学员有效课程、班级、教室与教室绑定设备自动生成目标设备清单，缺失关系进入异常队列PC 端采用顶部筛选、左侧列表或导航、中部主工作区、右侧详情抽屉，复杂操作进入弹窗或步骤条。查询、新增、编辑、提交、导出、查看日志、设备建档、绑定教室设备编号、设备品牌、所属校区、绑定教室、教室状态、在线状态、照片来源终端、照片版本、剩余课时、权益校验状态空数据、无权限、加载失败、保存失败、审批驳回、批量部分失败管理员端沿用统一框架，原型重点标注信息架构、表单弹窗、状态流和异常处理。 建议 Figma Frame：FAC-目标设备自动解析；需补齐正常、空态、加载、无权限、处理中、成功和失败状态。
PC Web设备离线打卡补传设备管理员/教务查看设备离线期间缓存的打卡记录，联网后按事件号自动补传、去重、匹配课次并回写考勤课消PC 端采用顶部筛选、左侧列表或导航、中部主工作区、右侧详情抽屉，复杂操作进入弹窗或步骤条。查询、新增、编辑、提交、导出、查看日志、设备建档、绑定教室设备编号、设备品牌、所属校区、绑定教室、教室状态、在线状态、照片来源终端、照片版本、剩余课时、权益校验状态空数据、无权限、加载失败、保存失败、审批驳回、批量部分失败管理员端沿用统一框架，原型重点标注信息架构、表单弹窗、状态流和异常处理。 建议 Figma Frame：FAC-设备离线打卡补传；需补齐正常、空态、加载、无权限、处理中、成功和失败状态。
PC Web权益课时校验异常教务/设备管理员/校区前台查看无有效权益、合同到期、剩余课时为 0 等打卡异常，确认不可课消原因、设备提示结果和后续续费/人工处理入口合同页采用左侧学员与课程信息，中部报价/协议/退款主流程，右侧展示优惠分摊、审批流、签署和监管回执。优惠试算、生成报价、发起审批、生成合同、发起签署、收款、监管备案、作废重签学员、课程组合、原合同、优惠规则、应收/应退、补差退差、签署状态、监管状态、设备编号、设备品牌优惠冲突、班级容量不足、补差未支付、签署失败、监管备案失败、权益重算失败需覆盖多科联报、组合缴费、优惠互斥、补充协议、转班转课权益测算、退款冲销和监管回执。 建议 Figma Frame：FAC-权益课时校验异常；需补齐正常、空态、加载、无权限、处理中、成功和失败状态。
PC Web课时耗尽人脸清除队列设备管理员/教务/安全管理员查看课时耗尽或权益终止触发的人脸清除任务，包含剩余课时快照、目标设备、清除状态、失败原因和重试入口设备页按校区、设备、人员、事件四层组织，识别流水支持照片、置信度、课次匹配和异常处理入口。新增设备、证件照更新、目标设备解析、人员照片下发、查看心跳、确认异常、重试下发、查看回执设备编号、设备品牌、所属校区、绑定教室、人员编号、人脸照片、照片版本、来源终端、置信度、匹配课次设备离线、证件照质量不合格、学员课程未关联教室、目标教室无考勤设备、人员下发失败、低置信度、跨校区识别、离线补传重复事件需覆盖教师端/家长端/学员端证件照上传、课程教室设备自动解析、人员照片新增/更新下发、识别异常确认、设备离线打卡联网后自动补传和隐私审计。 建议 Figma Frame：FAC-课时耗尽人脸清除队列；需补齐正常、空态、加载、无权限、处理中、成功和失败状态。
PC Web设备列表授权用户围绕设备闭环完善设备列表的入口、字段、状态、异常提示、处理进度和验收反馈PC 端采用顶部筛选、左侧列表或导航、中部主工作区、右侧详情抽屉，复杂操作进入弹窗或步骤条。查询、新增、编辑、提交、导出、查看日志、设备建档、绑定教室设备编号、设备品牌、所属校区、绑定教室、教室状态、在线状态、照片来源终端、照片版本、剩余课时、权益校验状态空数据、无权限、加载失败、保存失败、审批驳回、批量部分失败管理员端沿用统一框架，原型重点标注信息架构、表单弹窗、状态流和异常处理。 建议 Figma Frame：FAC-设备列表；需补齐正常、空态、加载、无权限、处理中、成功和失败状态。
PC Web人员下发授权用户围绕设备闭环完善人员下发的入口、字段、状态、异常提示、处理进度和验收反馈PC 端采用顶部筛选、左侧列表或导航、中部主工作区、右侧详情抽屉，复杂操作进入弹窗或步骤条。查询、新增、编辑、提交、导出、查看日志、设备建档、绑定教室设备编号、设备品牌、所属校区、绑定教室、教室状态、在线状态、照片来源终端、照片版本、剩余课时、权益校验状态空数据、无权限、加载失败、保存失败、审批驳回、批量部分失败管理员端沿用统一框架，原型重点标注信息架构、表单弹窗、状态流和异常处理。 建议 Figma Frame：FAC-人员下发；需补齐正常、空态、加载、无权限、处理中、成功和失败状态。
PC Web考勤异常授权用户围绕设备闭环完善考勤异常的入口、字段、状态、异常提示、处理进度和验收反馈PC 端采用顶部筛选、左侧列表或导航、中部主工作区、右侧详情抽屉，复杂操作进入弹窗或步骤条。查询、新增、编辑、提交、导出、查看日志、设备建档、绑定教室设备编号、设备品牌、所属校区、绑定教室、教室状态、在线状态、照片来源终端、照片版本、剩余课时、权益校验状态空数据、无权限、加载失败、保存失败、审批驳回、批量部分失败管理员端沿用统一框架，原型重点标注信息架构、表单弹窗、状态流和异常处理。 建议 Figma Frame：FAC-考勤异常；需补齐正常、空态、加载、无权限、处理中、成功和失败状态。
PC Web设备回执授权用户围绕证件照更新同步完善设备回执的入口、字段、状态、异常提示、处理进度和验收反馈PC 端采用顶部筛选、左侧列表或导航、中部主工作区、右侧详情抽屉，复杂操作进入弹窗或步骤条。查询、新增、编辑、提交、导出、查看日志、设备建档、绑定教室设备编号、设备品牌、所属校区、绑定教室、教室状态、在线状态、照片来源终端、照片版本、剩余课时、权益校验状态空数据、无权限、加载失败、保存失败、审批驳回、批量部分失败管理员端沿用统一框架，原型重点标注信息架构、表单弹窗、状态流和异常处理。 建议 Figma Frame：FAC-设备回执；需补齐正常、空态、加载、无权限、处理中、成功和失败状态。
PC Web考勤异常授权用户围绕离线补传联动完善考勤异常的入口、字段、状态、异常提示、处理进度和验收反馈PC 端采用顶部筛选、左侧列表或导航、中部主工作区、右侧详情抽屉，复杂操作进入弹窗或步骤条。查询、新增、编辑、提交、导出、查看日志、设备建档、绑定教室设备编号、设备品牌、所属校区、绑定教室、教室状态、在线状态、照片来源终端、照片版本、剩余课时、权益校验状态空数据、无权限、加载失败、保存失败、审批驳回、批量部分失败管理员端沿用统一框架，原型重点标注信息架构、表单弹窗、状态流和异常处理。 建议 Figma Frame：FAC-考勤异常；需补齐正常、空态、加载、无权限、处理中、成功和失败状态。
PC Web考勤异常授权用户围绕权益课时校验完善考勤异常的入口、字段、状态、异常提示、处理进度和验收反馈PC 端采用顶部筛选、左侧列表或导航、中部主工作区、右侧详情抽屉，复杂操作进入弹窗或步骤条。查询、新增、编辑、提交、导出、查看日志、设备建档、绑定教室设备编号、设备品牌、所属校区、绑定教室、教室状态、在线状态、照片来源终端、照片版本、剩余课时、权益校验状态空数据、无权限、加载失败、保存失败、审批驳回、批量部分失败管理员端沿用统一框架，原型重点标注信息架构、表单弹窗、状态流和异常处理。 建议 Figma Frame：FAC-考勤异常；需补齐正常、空态、加载、无权限、处理中、成功和失败状态。
PC Web人员下发授权用户围绕课时耗尽人脸清除完善人员下发的入口、字段、状态、异常提示、处理进度和验收反馈设备页按校区、设备、人员、事件四层组织，识别流水支持照片、置信度、课次匹配和异常处理入口。新增设备、证件照更新、目标设备解析、人员照片下发、查看心跳、确认异常、重试下发、查看回执设备编号、设备品牌、所属校区、绑定教室、人员编号、人脸照片、照片版本、来源终端、置信度、匹配课次设备离线、证件照质量不合格、学员课程未关联教室、目标教室无考勤设备、人员下发失败、低置信度、跨校区识别、离线补传重复事件需覆盖教师端/家长端/学员端证件照上传、课程教室设备自动解析、人员照片新增/更新下发、识别异常确认、设备离线打卡联网后自动补传和隐私审计。 建议 Figma Frame：FAC-人员下发；需补齐正常、空态、加载、无权限、处理中、成功和失败状态。
PC Web设备回执授权用户围绕课时耗尽人脸清除完善设备回执的入口、字段、状态、异常提示、处理进度和验收反馈设备页按校区、设备、人员、事件四层组织，识别流水支持照片、置信度、课次匹配和异常处理入口。新增设备、证件照更新、目标设备解析、人员照片下发、查看心跳、确认异常、重试下发、查看回执设备编号、设备品牌、所属校区、绑定教室、人员编号、人脸照片、照片版本、来源终端、置信度、匹配课次设备离线、证件照质量不合格、学员课程未关联教室、目标教室无考勤设备、人员下发失败、低置信度、跨校区识别、离线补传重复事件需覆盖教师端/家长端/学员端证件照上传、课程教室设备自动解析、人员照片新增/更新下发、识别异常确认、设备离线打卡联网后自动补传和隐私审计。 建议 Figma Frame：FAC-设备回执；需补齐正常、空态、加载、无权限、处理中、成功和失败状态。
PC Web设备告警授权用户围绕运维联动完善设备告警的入口、字段、状态、异常提示、处理进度和验收反馈PC 端采用顶部筛选、左侧列表或导航、中部主工作区、右侧详情抽屉，复杂操作进入弹窗或步骤条。查询、新增、编辑、提交、导出、查看日志、设备建档、绑定教室设备编号、设备品牌、所属校区、绑定教室、教室状态、在线状态、照片来源终端、照片版本、剩余课时、权益校验状态空数据、无权限、加载失败、保存失败、审批驳回、批量部分失败管理员端沿用统一框架，原型重点标注信息架构、表单弹窗、状态流和异常处理。 建议 Figma Frame：FAC-设备告警；需补齐正常、空态、加载、无权限、处理中、成功和失败状态。
PC Web维修工单授权用户围绕运维联动完善维修工单的入口、字段、状态、异常提示、处理进度和验收反馈PC 端采用顶部筛选、左侧列表或导航、中部主工作区、右侧详情抽屉，复杂操作进入弹窗或步骤条。查询、新增、编辑、提交、导出、查看日志、设备建档、绑定教室设备编号、设备品牌、所属校区、绑定教室、教室状态、在线状态、照片来源终端、照片版本、剩余课时、权益校验状态空数据、无权限、加载失败、保存失败、审批驳回、批量部分失败管理员端沿用统一框架，原型重点标注信息架构、表单弹窗、状态流和异常处理。 建议 Figma Frame：FAC-维修工单；需补齐正常、空态、加载、无权限、处理中、成功和失败状态。
PC Web资产详情授权用户围绕运维联动完善资产详情的入口、字段、状态、异常提示、处理进度和验收反馈资产库存页采用左侧分类树、顶部仓库/校区筛选、中部台账表格，详情抽屉展示流水、成本、责任人和审计。新增 SKU、采购申请、验收入库、领用出库、调拨、盘点、报损报废、维修派工物料编码、分类、仓库/校区、库存数量、批次成本、供应商、责任人、盘点差异、设备编号、设备品牌库存不足、编码重复、入库差异、责任人缺失、维修超期、成本调整失败需覆盖图书仅进销存、固定资产责任人变更、维修工单、礼品库存、成本策略和财务凭证联动。 建议 Figma Frame：FAC-资产详情；需补齐正常、空态、加载、无权限、处理中、成功和失败状态。
PC Web设备事件类型区分：学生上课考勤授权用户围绕人力 Excel 反补：设备事件类型区分：学生上课考勤、员工上下班考勤。完善设备事件类型区分：学生上课考勤的入口、字段、状态、异常提示、处理进度和验收反馈PC 端采用顶部筛选、左侧列表或导航、中部主工作区、右侧详情抽屉，复杂操作进入弹窗或步骤条。查询、新增、编辑、提交、导出、查看日志、设备建档、绑定教室设备编号、设备品牌、所属校区、绑定教室、教室状态、在线状态、照片来源终端、照片版本、剩余课时、权益校验状态空数据、无权限、加载失败、保存失败、审批驳回、批量部分失败管理员端沿用统一框架，原型重点标注信息架构、表单弹窗、状态流和异常处理。 建议 Figma Frame：FAC-设备事件类型区分_学生上课考勤；需补齐正常、空态、加载、无权限、处理中、成功和失败状态。

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

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

设计原型时，每个关键页面必须能解释前端展示什么、后端提交什么、状态怎么变、异常怎么处理。
原型页面关键接口关联对象状态流审批/权限触发消息/待办触达原型验收要求
设备档案PATCH /api/v1/face/devices/{id}/classroom-bindingFaceDevice未绑定 -> 待校验 -> 已绑定 -> 绑定失败 -> 跨校区拦截 -> 教室停用拦截 -> 换绑中 -> 已停用无审批时仍需写操作审计，敏感操作按安全中心规则触发审批处理完成、失败和异常转人工均需触发站内通知或待办原型需展示入口、主按钮、禁用原因、提交中、成功、失败、无权限、空状态和异常转人工入口
识别流水PATCH /api/v1/face/devices/{id}/classroom-bindingFacePerson未绑定 -> 待校验 -> 已绑定 -> 绑定失败 -> 跨校区拦截 -> 教室停用拦截 -> 换绑中 -> 已停用无审批时仍需写操作审计，敏感操作按安全中心规则触发审批处理完成、失败和异常转人工均需触发站内通知或待办原型需展示入口、主按钮、禁用原因、提交中、成功、失败、无权限、空状态和异常转人工入口
考勤设备绑定教室PATCH /api/v1/face/devices/{id}/classroom-bindingFaceDispatchTask未绑定 -> 待校验 -> 已绑定 -> 绑定失败 -> 跨校区拦截 -> 教室停用拦截 -> 换绑中 -> 已停用无审批时仍需写操作审计，敏感操作按安全中心规则触发审批处理完成、失败和异常转人工均需触发站内通知或待办原型需展示入口、主按钮、禁用原因、提交中、成功、失败、无权限、空状态和异常转人工入口
学员证件照上传PATCH /api/v1/face/devices/{id}/classroom-bindingFacePhotoSyncTask未绑定 -> 待校验 -> 已绑定 -> 绑定失败 -> 跨校区拦截 -> 教室停用拦截 -> 换绑中 -> 已停用无审批时仍需写操作审计，敏感操作按安全中心规则触发审批处理完成、失败和异常转人工均需触发站内通知或待办原型需展示入口、主按钮、禁用原因、提交中、成功、失败、无权限、空状态和异常转人工入口
学员证件照上传PATCH /api/v1/face/devices/{id}/classroom-bindingFaceClearanceTask未绑定 -> 待校验 -> 已绑定 -> 绑定失败 -> 跨校区拦截 -> 教室停用拦截 -> 换绑中 -> 已停用无审批时仍需写操作审计，敏感操作按安全中心规则触发审批处理完成、失败和异常转人工均需触发站内通知或待办原型需展示入口、主按钮、禁用原因、提交中、成功、失败、无权限、空状态和异常转人工入口
学员证件照上传PATCH /api/v1/face/devices/{id}/classroom-bindingFaceAttendanceEvent未绑定 -> 待校验 -> 已绑定 -> 绑定失败 -> 跨校区拦截 -> 教室停用拦截 -> 换绑中 -> 已停用无审批时仍需写操作审计，敏感操作按安全中心规则触发审批处理完成、失败和异常转人工均需触发站内通知或待办原型需展示入口、主按钮、禁用原因、提交中、成功、失败、无权限、空状态和异常转人工入口
证件照更新同步队列PATCH /api/v1/face/devices/{id}/classroom-bindingFaceDevice未绑定 -> 待校验 -> 已绑定 -> 绑定失败 -> 跨校区拦截 -> 教室停用拦截 -> 换绑中 -> 已停用无审批时仍需写操作审计，敏感操作按安全中心规则触发审批处理完成、失败和异常转人工均需触发站内通知或待办原型需展示入口、主按钮、禁用原因、提交中、成功、失败、无权限、空状态和异常转人工入口
目标设备自动解析PATCH /api/v1/face/devices/{id}/classroom-bindingFacePerson未绑定 -> 待校验 -> 已绑定 -> 绑定失败 -> 跨校区拦截 -> 教室停用拦截 -> 换绑中 -> 已停用无审批时仍需写操作审计，敏感操作按安全中心规则触发审批处理完成、失败和异常转人工均需触发站内通知或待办原型需展示入口、主按钮、禁用原因、提交中、成功、失败、无权限、空状态和异常转人工入口
设备离线打卡补传PATCH /api/v1/face/devices/{id}/classroom-bindingFaceDispatchTask未绑定 -> 待校验 -> 已绑定 -> 绑定失败 -> 跨校区拦截 -> 教室停用拦截 -> 换绑中 -> 已停用无审批时仍需写操作审计，敏感操作按安全中心规则触发审批处理完成、失败和异常转人工均需触发站内通知或待办原型需展示入口、主按钮、禁用原因、提交中、成功、失败、无权限、空状态和异常转人工入口
权益课时校验异常PATCH /api/v1/face/devices/{id}/classroom-bindingFacePhotoSyncTask未绑定 -> 待校验 -> 已绑定 -> 绑定失败 -> 跨校区拦截 -> 教室停用拦截 -> 换绑中 -> 已停用无审批时仍需写操作审计，敏感操作按安全中心规则触发审批处理完成、失败和异常转人工均需触发站内通知或待办原型需展示入口、主按钮、禁用原因、提交中、成功、失败、无权限、空状态和异常转人工入口
课时耗尽人脸清除队列PATCH /api/v1/face/devices/{id}/classroom-bindingFaceClearanceTask未绑定 -> 待校验 -> 已绑定 -> 绑定失败 -> 跨校区拦截 -> 教室停用拦截 -> 换绑中 -> 已停用无审批时仍需写操作审计，敏感操作按安全中心规则触发审批处理完成、失败和异常转人工均需触发站内通知或待办原型需展示入口、主按钮、禁用原因、提交中、成功、失败、无权限、空状态和异常转人工入口
设备列表PATCH /api/v1/face/devices/{id}/classroom-bindingFaceAttendanceEvent未绑定 -> 待校验 -> 已绑定 -> 绑定失败 -> 跨校区拦截 -> 教室停用拦截 -> 换绑中 -> 已停用无审批时仍需写操作审计，敏感操作按安全中心规则触发审批处理完成、失败和异常转人工均需触发站内通知或待办原型需展示入口、主按钮、禁用原因、提交中、成功、失败、无权限、空状态和异常转人工入口

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

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

本章节为正式 PRD 的交付要求，面向原型图、UI、开发、联调和测试分工。
能力域功能补充要求原型交付要求UI 交互要求研发实现要求测试验收要求
设备闭环补齐设备下发回执、低置信度识别、重复识别、人工复核、自动签到和课消联动。设备列表、人员下发、识别流水、考勤异常 需要在原型中拆到列表、详情、表单、弹窗、空状态、失败态、无权限态和处理进度。UI 需清晰呈现状态标签、流程节点、主次按钮、危险操作确认、移动/平板/TV 适配和错误提示；PC 管理端遵循统一框架，仅输出信息架构和交互说明。后端需提供接口幂等、权限校验、状态机、审计日志、消息/审批触发、异步补偿和跨模块数据一致性保障。测试需覆盖主流程、异常流、权限流、重复提交、批量部分失败和数据一致性；识别异常可人工确认，确认后同步教务考勤和课消状态。
证件照更新同步补齐照片来源、照片版本、质量校验、课程教室设备解析、目标设备清单、下发任务、失败重试和审计。证件照更新同步队列、目标设备自动解析、设备回执 需要在原型中拆到列表、详情、表单、弹窗、空状态、失败态、无权限态和处理进度。UI 需清晰呈现状态标签、流程节点、主次按钮、危险操作确认、移动/平板/TV 适配和错误提示；PC 管理端遵循统一框架，仅输出信息架构和交互说明。后端需提供接口幂等、权限校验、状态机、审计日志、消息/审批触发、异步补偿和跨模块数据一致性保障。测试需覆盖主流程、异常流、权限流、重复提交、批量部分失败和数据一致性；学员照片更新后可自动推导目标设备并完成新增或更新下发；不提供家长手动撤回入口，设备侧清除仅由课时耗尽、合同到期或权益终止规则触发。
离线补传联动补齐离线缓存、联网补传、事件去重、课次匹配、异常队列、自动签到和自动课消。设备离线打卡补传、识别流水、考勤异常 需要在原型中拆到列表、详情、表单、弹窗、空状态、失败态、无权限态和处理进度。UI 需清晰呈现状态标签、流程节点、主次按钮、危险操作确认、移动/平板/TV 适配和错误提示；PC 管理端遵循统一框架，仅输出信息架构和交互说明。后端需提供接口幂等、权限校验、状态机、审计日志、消息/审批触发、异步补偿和跨模块数据一致性保障。测试需覆盖主流程、异常流、权限流、重复提交、批量部分失败和数据一致性；设备恢复联网后离线记录可自动补传，重复事件不会重复签到或重复课消。
权益课时校验补齐合同权益、剩余课时、课程有效期、可课消状态、错误码、设备提示、异常队列和消息通知。权益课时校验异常、识别流水、考勤异常 需要在原型中拆到列表、详情、表单、弹窗、空状态、失败态、无权限态和处理进度。UI 需清晰呈现状态标签、流程节点、主次按钮、危险操作确认、移动/平板/TV 适配和错误提示；PC 管理端遵循统一框架，仅输出信息架构和交互说明。后端需提供接口幂等、权限校验、状态机、审计日志、消息/审批触发、异步补偿和跨模块数据一致性保障。测试需覆盖主流程、异常流、权限流、重复提交、批量部分失败和数据一致性；课时不足时打卡记录可追踪但不生成课消，设备或后台能明确提示不可课消原因。
课时耗尽人脸清除补齐课消后余额复核、课时耗尽触发、人脸清除任务、设备回执、离线重试和人工处理。课时耗尽人脸清除队列、人员下发、设备回执 需要在原型中拆到列表、详情、表单、弹窗、空状态、失败态、无权限态和处理进度。UI 需清晰呈现状态标签、流程节点、主次按钮、危险操作确认、移动/平板/TV 适配和错误提示；PC 管理端遵循统一框架，仅输出信息架构和交互说明。后端需提供接口幂等、权限校验、状态机、审计日志、消息/审批触发、异步补偿和跨模块数据一致性保障。测试需覆盖主流程、异常流、权限流、重复提交、批量部分失败和数据一致性；最后一次课消完成后自动清除目标设备上的学员人脸信息，并保留触发原因和回执。
运维联动补齐离线告警、维修工单、资产状态、恢复校验和影响课次范围。设备告警、维修工单、资产详情 需要在原型中拆到列表、详情、表单、弹窗、空状态、失败态、无权限态和处理进度。UI 需清晰呈现状态标签、流程节点、主次按钮、危险操作确认、移动/平板/TV 适配和错误提示；PC 管理端遵循统一框架，仅输出信息架构和交互说明。后端需提供接口幂等、权限校验、状态机、审计日志、消息/审批触发、异步补偿和跨模块数据一致性保障。测试需覆盖主流程、异常流、权限流、重复提交、批量部分失败和数据一致性；设备恢复后可自动回测签到、直播或录像相关能力。
人力 Excel 反补：设备事件类型区分：学生上课考勤、员工上下班考勤。按《系统功能-人力-PRD完善方案》补齐设备事件类型区分：学生上课考勤、员工上下班考勤。相关功能、流程、角色终端、数据对象、接口、异常状态和验收口径。设备事件类型区分：学生上课考勤、员工上下班考勤。相关列表、详情、表单、审批、消息、异常、审计和报表页面 需要在原型中拆到列表、详情、表单、弹窗、空状态、失败态、无权限态和处理进度。UI 需清晰呈现状态标签、流程节点、主次按钮、危险操作确认、移动/平板/TV 适配和错误提示；PC 管理端遵循统一框架，仅输出信息架构和交互说明。后端需提供接口幂等、权限校验、状态机、审计日志、消息/审批触发、异步补偿和跨模块数据一致性保障。测试需覆盖主流程、异常流、权限流、重复提交、批量部分失败和数据一致性；对应模块 PRD 的“人力 Excel 反补”章节、数据字段、接口技术、测试用例和初始化项均可追溯。
人力 Excel 反补：设备离线缓存。按《系统功能-人力-PRD完善方案》补齐设备离线缓存。相关功能、流程、角色终端、数据对象、接口、异常状态和验收口径。设备离线缓存。相关列表、详情、表单、审批、消息、异常、审计和报表页面 需要在原型中拆到列表、详情、表单、弹窗、空状态、失败态、无权限态和处理进度。UI 需清晰呈现状态标签、流程节点、主次按钮、危险操作确认、移动/平板/TV 适配和错误提示；PC 管理端遵循统一框架，仅输出信息架构和交互说明。后端需提供接口幂等、权限校验、状态机、审计日志、消息/审批触发、异步补偿和跨模块数据一致性保障。测试需覆盖主流程、异常流、权限流、重复提交、批量部分失败和数据一致性；对应模块 PRD 的“人力 Excel 反补”章节、数据字段、接口技术、测试用例和初始化项均可追溯。
人力 Excel 反补：恢复联网后批量补传。按《系统功能-人力-PRD完善方案》补齐恢复联网后批量补传。相关功能、流程、角色终端、数据对象、接口、异常状态和验收口径。恢复联网后批量补传。相关列表、详情、表单、审批、消息、异常、审计和报表页面 需要在原型中拆到列表、详情、表单、弹窗、空状态、失败态、无权限态和处理进度。UI 需清晰呈现状态标签、流程节点、主次按钮、危险操作确认、移动/平板/TV 适配和错误提示；PC 管理端遵循统一框架，仅输出信息架构和交互说明。后端需提供接口幂等、权限校验、状态机、审计日志、消息/审批触发、异步补偿和跨模块数据一致性保障。测试需覆盖主流程、异常流、权限流、重复提交、批量部分失败和数据一致性；对应模块 PRD 的“人力 Excel 反补”章节、数据字段、接口技术、测试用例和初始化项均可追溯。
人力 Excel 反补：同步失败日志。按《系统功能-人力-PRD完善方案》补齐同步失败日志。相关功能、流程、角色终端、数据对象、接口、异常状态和验收口径。同步失败日志。相关列表、详情、表单、审批、消息、异常、审计和报表页面 需要在原型中拆到列表、详情、表单、弹窗、空状态、失败态、无权限态和处理进度。UI 需清晰呈现状态标签、流程节点、主次按钮、危险操作确认、移动/平板/TV 适配和错误提示；PC 管理端遵循统一框架，仅输出信息架构和交互说明。后端需提供接口幂等、权限校验、状态机、审计日志、消息/审批触发、异步补偿和跨模块数据一致性保障。测试需覆盖主流程、异常流、权限流、重复提交、批量部分失败和数据一致性；对应模块 PRD 的“人力 Excel 反补”章节、数据字段、接口技术、测试用例和初始化项均可追溯。
人力 Excel 反补：设备事件去重。按《系统功能-人力-PRD完善方案》补齐设备事件去重。相关功能、流程、角色终端、数据对象、接口、异常状态和验收口径。设备事件去重。相关列表、详情、表单、审批、消息、异常、审计和报表页面 需要在原型中拆到列表、详情、表单、弹窗、空状态、失败态、无权限态和处理进度。UI 需清晰呈现状态标签、流程节点、主次按钮、危险操作确认、移动/平板/TV 适配和错误提示；PC 管理端遵循统一框架，仅输出信息架构和交互说明。后端需提供接口幂等、权限校验、状态机、审计日志、消息/审批触发、异步补偿和跨模块数据一致性保障。测试需覆盖主流程、异常流、权限流、重复提交、批量部分失败和数据一致性；对应模块 PRD 的“人力 Excel 反补”章节、数据字段、接口技术、测试用例和初始化项均可追溯。
人力 Excel 反补：员工打卡设备采集打卡事件。按《系统功能-人力-PRD完善方案》补齐员工打卡设备采集打卡事件。相关功能、流程、角色终端、数据对象、接口、异常状态和验收口径。员工打卡设备采集打卡事件。相关列表、详情、表单、审批、消息、异常、审计和报表页面 需要在原型中拆到列表、详情、表单、弹窗、空状态、失败态、无权限态和处理进度。UI 需清晰呈现状态标签、流程节点、主次按钮、危险操作确认、移动/平板/TV 适配和错误提示；PC 管理端遵循统一框架，仅输出信息架构和交互说明。后端需提供接口幂等、权限校验、状态机、审计日志、消息/审批触发、异步补偿和跨模块数据一致性保障。测试需覆盖主流程、异常流、权限流、重复提交、批量部分失败和数据一致性；对应模块 PRD 的“人力 Excel 反补”章节、数据字段、接口技术、测试用例和初始化项均可追溯。
人力 Excel 反补：离线时本地缓存。按《系统功能-人力-PRD完善方案》补齐离线时本地缓存。相关功能、流程、角色终端、数据对象、接口、异常状态和验收口径。离线时本地缓存。相关列表、详情、表单、审批、消息、异常、审计和报表页面 需要在原型中拆到列表、详情、表单、弹窗、空状态、失败态、无权限态和处理进度。UI 需清晰呈现状态标签、流程节点、主次按钮、危险操作确认、移动/平板/TV 适配和错误提示；PC 管理端遵循统一框架，仅输出信息架构和交互说明。后端需提供接口幂等、权限校验、状态机、审计日志、消息/审批触发、异步补偿和跨模块数据一致性保障。测试需覆盖主流程、异常流、权限流、重复提交、批量部分失败和数据一致性；对应模块 PRD 的“人力 Excel 反补”章节、数据字段、接口技术、测试用例和初始化项均可追溯。
人力 Excel 反补：联网后推送到设备中心。按《系统功能-人力-PRD完善方案》补齐联网后推送到设备中心。相关功能、流程、角色终端、数据对象、接口、异常状态和验收口径。联网后推送到设备中心。相关列表、详情、表单、审批、消息、异常、审计和报表页面 需要在原型中拆到列表、详情、表单、弹窗、空状态、失败态、无权限态和处理进度。UI 需清晰呈现状态标签、流程节点、主次按钮、危险操作确认、移动/平板/TV 适配和错误提示；PC 管理端遵循统一框架，仅输出信息架构和交互说明。后端需提供接口幂等、权限校验、状态机、审计日志、消息/审批触发、异步补偿和跨模块数据一致性保障。测试需覆盖主流程、异常流、权限流、重复提交、批量部分失败和数据一致性；对应模块 PRD 的“人力 Excel 反补”章节、数据字段、接口技术、测试用例和初始化项均可追溯。

10A · 人力 Excel 反补

系统功能-人力 Excel 缺失项落地要求

本章节从完善方案自动生成，作为各模块 PRD 的正式补充范围，后续原型、接口、数据库和测试均需按此执行。

06-智能考勤设备中心详细 PRD

需要补齐的功能

学生人脸考勤设备逻辑已经比较明确，但员工考勤 Excel 中出现了“接口断开、设备离线、本地缓存、恢复同步”等逻辑。该能力需要在设备中心补充为通用设备能力，避免只服务学生消课场景。

需要补充：

  • 设备事件类型区分：学生上课考勤、员工上下班考勤。
  • 设备心跳。
  • 设备离线缓存。
  • 恢复联网后批量补传。
  • 同步失败日志。
  • 人工重试。
  • 设备事件去重。

需要补齐的闭环

  • 员工打卡设备采集打卡事件。
  • 离线时本地缓存。
  • 联网后推送到设备中心。
  • 设备中心区分员工考勤事件。
  • HR 考勤模块生成员工考勤结果。
  • 考勤结果进入薪酬工资因子。

技术方案

补充对象：

  • DeviceAttendanceEvent
  • DeviceOfflineCacheBatch
  • DeviceSyncRetryTask

补充字段：

  • attendance_subject_type：student、employee
  • device_event_id
  • device_local_time
  • sync_status
  • retry_count

补充接口：

  • POST /api/v1/devices/attendance-events
  • POST /api/v1/devices/offline-batches
  • POST /api/v1/devices/sync-retry

本模块缺失项覆盖矩阵

缺失清单来源缺失逻辑已补入模块/章节覆盖状态
考勤 R135设备离线、本地缓存、恢复同步、失败重试06 智能考勤设备、13 考勤规则已覆盖
考勤 R142打卡区域白名单、区域外异常13 考勤规则、06 设备事件已覆盖

11 · 数据对象与字段字典

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

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

核心对象

对象说明
FaceDevice人脸识别考勤设备；落地表：dev_face_device
FacePerson人脸人员库；落地表：dev_face_person
FaceDispatchTask人脸下发任务；落地表：dev_face_dispatch_task
FacePhotoSyncTask证件照更新同步任务；落地表：dev_face_photo_sync_task
FaceClearanceTask课时耗尽人脸清除任务；落地表：dev_face_clearance_task
FaceAttendanceEvent人脸识别回传事件；落地表：dev_face_event

关联引用对象

对象说明
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
Student学员基础档案；引用来源：CRM / stu_student
Classroom校区教室档案与教学空间资源；引用来源：EDU / edu_classroom
Schedule/Lesson课次和排课；引用来源：EDU / edu_lesson
Attendance上课签到记录；引用来源：EDU / edu_attendance
Consumption课消记录；引用来源：EDU / edu_consumption
Asset固定资产台账；引用来源：MAT / mat_asset
AssetLifecycle/Maintenance资产维修与生命周期；引用来源：MAT / mat_maintenance_order

完整字段字典

对象字段类型必填规则数据级别
FaceDeviceidBIGINT是主键，雪花或号段生成，禁止复用普通
FaceDevicetenant_idBIGINT是集团/租户隔离字段，所有查询必须带租户上下文普通
FaceDeviceorg_idBIGINT否所属组织，集团级或公共配置为空普通
FaceDevicecampus_idBIGINT是所属校区，跨校区或总部级数据为空；本表业务要求必填普通
FaceDevicecreated_byBIGINT是创建人账号 ID普通
FaceDevicecreated_atDATETIME是创建时间普通
FaceDeviceupdated_byBIGINT否最后更新人账号 ID普通
FaceDeviceupdated_atDATETIME否最后更新时间普通
FaceDeviceis_deletedTINYINT是是否已删除，0 未删除，1 已删除普通
FaceDevicedeleted_atDATETIME否删除时间，未删除为空普通
FaceDevicedeleted_byBIGINT否删除人账号 ID，未删除为空普通
FaceDeviceversionINT是乐观锁版本号，写操作必须校验普通
FaceDevicedevice_codeVARCHAR(64)是设备编码，唯一普通
FaceDevicevendor_codeVARCHAR(32)是设备品牌/厂商普通
FaceDevicedevice_nameVARCHAR(128)是设备名称普通
FaceDeviceclassroom_idBIGINT是绑定教室 ID，必须属于同一校区且教室未逻辑删除普通
FaceDeviceapi_endpointVARCHAR(512)否设备或平台 API 地址普通
FaceDevicedevice_statusVARCHAR(32)是在线/离线/停用/异常普通
FacePersonidBIGINT是主键，雪花或号段生成，禁止复用普通
FacePersontenant_idBIGINT是集团/租户隔离字段，所有查询必须带租户上下文普通
FacePersonorg_idBIGINT否所属组织，集团级或公共配置为空普通
FacePersoncampus_idBIGINT否所属校区，跨校区或总部级数据为空普通
FacePersoncreated_byBIGINT是创建人账号 ID普通
FacePersoncreated_atDATETIME是创建时间普通
FacePersonupdated_byBIGINT否最后更新人账号 ID普通
FacePersonupdated_atDATETIME否最后更新时间普通
FacePersonis_deletedTINYINT是是否已删除，0 未删除，1 已删除普通
FacePersondeleted_atDATETIME否删除时间，未删除为空普通
FacePersondeleted_byBIGINT否删除人账号 ID，未删除为空普通
FacePersonversionINT是乐观锁版本号，写操作必须校验普通
FacePersonperson_noVARCHAR(64)是人员编号，唯一普通
FacePersonperson_typeVARCHAR(32)是学员/教师/员工普通
FacePersonperson_idBIGINT是业务人员 ID普通
FacePersonphoto_file_idBIGINT是人脸照片文件 ID高敏
FacePersonphoto_versionINT是证件照版本号，照片更新后递增普通
FacePersonsource_terminalVARCHAR(32)是照片来源终端：教师端/家长端/学员端/后台普通
FacePersonsource_uploaded_atDATETIME是来源照片上传时间普通
FacePersonvalid_untilDATETIME否设备侧人员照片业务有效期普通
FacePersonsync_statusVARCHAR(32)是未同步/待下发/已下发/待更新/待清除/已清除/失败普通
FaceDispatchTaskidBIGINT是主键，雪花或号段生成，禁止复用普通
FaceDispatchTasktenant_idBIGINT是集团/租户隔离字段，所有查询必须带租户上下文普通
FaceDispatchTaskorg_idBIGINT否所属组织，集团级或公共配置为空普通
FaceDispatchTaskcampus_idBIGINT否所属校区，跨校区或总部级数据为空普通
FaceDispatchTaskcreated_byBIGINT是创建人账号 ID普通
FaceDispatchTaskcreated_atDATETIME是创建时间普通
FaceDispatchTaskupdated_byBIGINT否最后更新人账号 ID普通
FaceDispatchTaskupdated_atDATETIME否最后更新时间普通
FaceDispatchTaskis_deletedTINYINT是是否已删除，0 未删除，1 已删除普通
FaceDispatchTaskdeleted_atDATETIME否删除时间，未删除为空普通
FaceDispatchTaskdeleted_byBIGINT否删除人账号 ID，未删除为空普通
FaceDispatchTaskversionINT是乐观锁版本号，写操作必须校验普通
FaceDispatchTasktask_noVARCHAR(64)是任务编号，唯一普通
FaceDispatchTaskdevice_idBIGINT是设备 ID普通
FaceDispatchTaskperson_idBIGINT是人员库 ID普通
FaceDispatchTaskaction_typeVARCHAR(32)是新增/更新/清除/重试普通
FaceDispatchTaskrequest_payloadJSON是下发请求普通
FaceDispatchTaskresponse_payloadJSON否设备响应普通
FaceDispatchTasktask_statusVARCHAR(32)是待执行/成功/失败/重试中/设备离线待重试普通
FacePhotoSyncTaskidBIGINT是主键，雪花或号段生成，禁止复用普通
FacePhotoSyncTasktenant_idBIGINT是集团/租户隔离字段，所有查询必须带租户上下文普通
FacePhotoSyncTaskorg_idBIGINT否所属组织，集团级或公共配置为空普通
FacePhotoSyncTaskcampus_idBIGINT否所属校区，跨校区或总部级数据为空普通
FacePhotoSyncTaskcreated_byBIGINT是创建人账号 ID普通
FacePhotoSyncTaskcreated_atDATETIME是创建时间普通
FacePhotoSyncTaskupdated_byBIGINT否最后更新人账号 ID普通
FacePhotoSyncTaskupdated_atDATETIME否最后更新时间普通
FacePhotoSyncTaskis_deletedTINYINT是是否已删除，0 未删除，1 已删除普通
FacePhotoSyncTaskdeleted_atDATETIME否删除时间，未删除为空普通
FacePhotoSyncTaskdeleted_byBIGINT否删除人账号 ID，未删除为空普通
FacePhotoSyncTaskversionINT是乐观锁版本号，写操作必须校验普通
FacePhotoSyncTasksync_noVARCHAR(64)是同步任务编号，唯一普通
FacePhotoSyncTaskstudent_idBIGINT是学员 ID普通
FacePhotoSyncTaskphoto_file_idBIGINT是最新证件照文件 ID高敏
FacePhotoSyncTaskphoto_versionINT是照片版本号普通
FacePhotoSyncTasksource_terminalVARCHAR(32)是教师端/家长端/学员端/后台普通
FacePhotoSyncTaskcourse_scopeJSON是学员关联课程与班级范围快照普通
FacePhotoSyncTasktarget_device_scopeJSON是由课程教室推导出的人脸设备范围普通
FacePhotoSyncTasksync_statusVARCHAR(32)是待解析/待下发/部分成功/成功/失败/设备离线待重试普通
FaceClearanceTaskidBIGINT是主键，雪花或号段生成，禁止复用普通
FaceClearanceTasktenant_idBIGINT是集团/租户隔离字段，所有查询必须带租户上下文普通
FaceClearanceTaskorg_idBIGINT否所属组织，集团级或公共配置为空普通
FaceClearanceTaskcampus_idBIGINT否所属校区，跨校区或总部级数据为空普通
FaceClearanceTaskcreated_byBIGINT是创建人账号 ID普通
FaceClearanceTaskcreated_atDATETIME是创建时间普通
FaceClearanceTaskupdated_byBIGINT否最后更新人账号 ID普通
FaceClearanceTaskupdated_atDATETIME否最后更新时间普通
FaceClearanceTaskis_deletedTINYINT是是否已删除，0 未删除，1 已删除普通
FaceClearanceTaskdeleted_atDATETIME否删除时间，未删除为空普通
FaceClearanceTaskdeleted_byBIGINT否删除人账号 ID，未删除为空普通
FaceClearanceTaskversionINT是乐观锁版本号，写操作必须校验普通
FaceClearanceTaskclearance_noVARCHAR(64)是清除任务编号，唯一普通
FaceClearanceTaskstudent_idBIGINT是学员 ID普通
FaceClearanceTaskperson_idBIGINT是人员库 ID普通
FaceClearanceTasktrigger_typeVARCHAR(32)是课时耗尽/合同到期/权益终止/人工重算普通
FaceClearanceTaskremaining_hours_snapshotDECIMAL(8,2)是触发时剩余课时快照普通
FaceClearanceTasktarget_device_scopeJSON是需要清除的人脸设备范围普通
FaceClearanceTaskclearance_statusVARCHAR(32)是待清除/清除中/部分成功/成功/失败/设备离线待重试普通
FaceClearanceTasktriggered_atDATETIME是触发时间普通
FaceAttendanceEventidBIGINT是主键，雪花或号段生成，禁止复用普通
FaceAttendanceEventtenant_idBIGINT是集团/租户隔离字段，所有查询必须带租户上下文普通
FaceAttendanceEventorg_idBIGINT否所属组织，集团级或公共配置为空普通
FaceAttendanceEventcampus_idBIGINT否所属校区，跨校区或总部级数据为空普通
FaceAttendanceEventcreated_byBIGINT是创建人账号 ID普通
FaceAttendanceEventcreated_atDATETIME是创建时间普通
FaceAttendanceEventupdated_byBIGINT否最后更新人账号 ID普通
FaceAttendanceEventupdated_atDATETIME否最后更新时间普通
FaceAttendanceEventis_deletedTINYINT是是否已删除，0 未删除，1 已删除普通
FaceAttendanceEventdeleted_atDATETIME否删除时间，未删除为空普通
FaceAttendanceEventdeleted_byBIGINT否删除人账号 ID，未删除为空普通
FaceAttendanceEventversionINT是乐观锁版本号，写操作必须校验普通
FaceAttendanceEventdevice_idBIGINT是设备 ID普通
FaceAttendanceEventdevice_event_idVARCHAR(128)是设备侧事件号普通
FaceAttendanceEventperson_idBIGINT否匹配人员 ID普通
FaceAttendanceEventlesson_idBIGINT否匹配课次 ID普通
FaceAttendanceEventevent_timeDATETIME是识别时间普通
FaceAttendanceEventconfidenceDECIMAL(8,4)是识别置信度普通
FaceAttendanceEventmatch_statusVARCHAR(32)是已匹配/低置信/未匹配/重复普通
FaceAttendanceEventrights_check_statusVARCHAR(32)是通过/无有效权益/课时不足/合同到期普通
FaceAttendanceEventconsume_resultVARCHAR(32)是未处理/已课消/不可课消/待人工确认普通
FaceAttendanceEventerror_codeVARCHAR(64)否不可课消错误码普通
FaceAttendanceEventerror_messageVARCHAR(255)否不可课消提示文案普通
FaceAttendanceEventupload_modeVARCHAR(32)是实时上传/离线补传普通
FaceAttendanceEventdevice_cached_atDATETIME否设备离线缓存时间普通
FaceAttendanceEventraw_payloadJSON是设备原始报文敏感

引用对象字段字典

引用表对象字段类型必填规则数据级别
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是是否加水印普通
stu_studentStudentidBIGINT是主键，雪花或号段生成，禁止复用普通
stu_studentStudenttenant_idBIGINT是集团/租户隔离字段，所有查询必须带租户上下文普通
stu_studentStudentorg_idBIGINT否所属组织，集团级或公共配置为空普通
stu_studentStudentcampus_idBIGINT否所属校区，跨校区或总部级数据为空普通
stu_studentStudentcreated_byBIGINT是创建人账号 ID普通
stu_studentStudentcreated_atDATETIME是创建时间普通
stu_studentStudentupdated_byBIGINT否最后更新人账号 ID普通
stu_studentStudentupdated_atDATETIME否最后更新时间普通
stu_studentStudentis_deletedTINYINT是是否已删除，0 未删除，1 已删除普通
stu_studentStudentdeleted_atDATETIME否删除时间，未删除为空普通
stu_studentStudentdeleted_byBIGINT否删除人账号 ID，未删除为空普通
stu_studentStudentversionINT是乐观锁版本号，写操作必须校验普通
stu_studentStudentstudent_noVARCHAR(64)是学员编号，唯一普通
stu_studentStudentfamily_idBIGINT否家庭 ID普通
stu_studentStudentstudent_nameVARCHAR(64)是学员姓名普通
stu_studentStudentgenderVARCHAR(16)否性别普通
stu_studentStudentbirthdayDATE否出生日期普通
stu_studentStudentgradeVARCHAR(32)否年级普通
stu_studentStudentschool_nameVARCHAR(128)否学校名称普通
stu_studentStudentbiz_statusVARCHAR(32)是业务状态，取值来自状态机字典普通
stu_studentStudentremarkVARCHAR(512)否业务备注，敏感内容按权限脱敏普通
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)是待上课/上课中/已下课/已取消/需补课普通
edu_attendanceAttendanceidBIGINT是主键，雪花或号段生成，禁止复用普通
edu_attendanceAttendancetenant_idBIGINT是集团/租户隔离字段，所有查询必须带租户上下文普通
edu_attendanceAttendanceorg_idBIGINT否所属组织，集团级或公共配置为空普通
edu_attendanceAttendancecampus_idBIGINT否所属校区，跨校区或总部级数据为空普通
edu_attendanceAttendancecreated_byBIGINT是创建人账号 ID普通
edu_attendanceAttendancecreated_atDATETIME是创建时间普通
edu_attendanceAttendanceupdated_byBIGINT否最后更新人账号 ID普通
edu_attendanceAttendanceupdated_atDATETIME否最后更新时间普通
edu_attendanceAttendanceis_deletedTINYINT是是否已删除，0 未删除，1 已删除普通
edu_attendanceAttendancedeleted_atDATETIME否删除时间，未删除为空普通
edu_attendanceAttendancedeleted_byBIGINT否删除人账号 ID，未删除为空普通
edu_attendanceAttendanceversionINT是乐观锁版本号，写操作必须校验普通
edu_attendanceAttendancelesson_idBIGINT是课次 ID普通
edu_attendanceAttendancestudent_idBIGINT是学员 ID普通
edu_attendanceAttendancecheckin_typeVARCHAR(32)是人工/人脸/补签/家长确认普通
edu_attendanceAttendancecheckin_atDATETIME否签到时间普通
edu_attendanceAttendanceattendance_statusVARCHAR(32)是到课/请假/旷课/迟到/待确认普通
edu_attendanceAttendancesource_event_idBIGINT否来源设备或操作事件普通
edu_consumptionConsumptionidBIGINT是主键，雪花或号段生成，禁止复用普通
edu_consumptionConsumptiontenant_idBIGINT是集团/租户隔离字段，所有查询必须带租户上下文普通
edu_consumptionConsumptionorg_idBIGINT否所属组织，集团级或公共配置为空普通
edu_consumptionConsumptioncampus_idBIGINT否所属校区，跨校区或总部级数据为空普通
edu_consumptionConsumptioncreated_byBIGINT是创建人账号 ID普通
edu_consumptionConsumptioncreated_atDATETIME是创建时间普通
edu_consumptionConsumptionupdated_byBIGINT否最后更新人账号 ID普通
edu_consumptionConsumptionupdated_atDATETIME否最后更新时间普通
edu_consumptionConsumptionis_deletedTINYINT是是否已删除，0 未删除，1 已删除普通
edu_consumptionConsumptiondeleted_atDATETIME否删除时间，未删除为空普通
edu_consumptionConsumptiondeleted_byBIGINT否删除人账号 ID，未删除为空普通
edu_consumptionConsumptionversionINT是乐观锁版本号，写操作必须校验普通
edu_consumptionConsumptionlesson_idBIGINT是课次 ID普通
edu_consumptionConsumptionstudent_idBIGINT是学员 ID普通
edu_consumptionConsumptioncontract_idBIGINT是合同 ID普通
edu_consumptionConsumptionconsumed_hoursDECIMAL(8,2)是消耗课时普通
edu_consumptionConsumptionconsume_amountDECIMAL(18,2)否课消金额普通
edu_consumptionConsumptionconsume_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)是待维修/维修中/已完成/已报废普通

JSON 字段结构与校验

表名对象字段结构编码结构定义校验规则示例
dev_face_dispatch_taskFaceDispatchTaskrequest_payloadSUPERVISION_PAYLOAD{bizType:string, contractNo:string, amount:number, student:object, attachments:number[]}报送字段必须满足教育局/监管账户配置的必填规则{"bizType":"CONTRACT","contractNo":"DNC20260628001","amount":6800}
dev_face_dispatch_taskFaceDispatchTaskresponse_payloadSUPERVISION_PAYLOAD{bizType:string, contractNo:string, amount:number, student:object, attachments:number[]}报送字段必须满足教育局/监管账户配置的必填规则{"bizType":"CONTRACT","contractNo":"DNC20260628001","amount":6800}
dev_face_photo_sync_taskFacePhotoSyncTaskcourse_scopeGENERICobject | array必须符合字段说明中的业务结构；保存前进行 JSON Schema 校验并记录版本{"version":1,"items":[]}
dev_face_photo_sync_taskFacePhotoSyncTasktarget_device_scopeORG_SCOPE{scopeType:string, orgIds:number[], campusIds:number[], includeChildren:boolean}组织和校区必须在当前租户授权范围内{"scopeType":"CAMPUS","campusIds":[101,102],"includeChildren":false}
dev_face_clearance_taskFaceClearanceTasktarget_device_scopeORG_SCOPE{scopeType:string, orgIds:number[], campusIds:number[], includeChildren:boolean}组织和校区必须在当前租户授权范围内{"scopeType":"CAMPUS","campusIds":[101,102],"includeChildren":false}
dev_face_eventFaceAttendanceEventraw_payloadSUPERVISION_PAYLOAD{bizType:string, contractNo:string, amount:number, student:object, attachments:number[]}报送字段必须满足教育局/监管账户配置的必填规则{"bizType":"CONTRACT","contractNo":"DNC20260628001","amount":6800}

状态/枚举标准字典

表名对象字段枚举编码取值终态/流转规则字段说明
dev_face_deviceFaceDevicetenant_idTENANT_ID集团、租户隔离字段非终态，可按状态机或字典规则流转集团/租户隔离字段，所有查询必须带租户上下文
dev_face_deviceFaceDeviceis_deletedBOOL_DELETED0 未删除、1 已删除非终态，可按状态机或字典规则流转是否已删除，0 未删除，1 已删除
dev_face_deviceFaceDevicevendor_codeVENDOR_CODE设备品牌、厂商非终态，可按状态机或字典规则流转设备品牌/厂商
dev_face_deviceFaceDevicedevice_statusDEVICE_STATUSONLINE 在线、OFFLINE 离线、DISABLED 停用、ABNORMAL 异常包含终态，终态禁止直接编辑，需走变更/红冲/撤回流程在线/离线/停用/异常
dev_face_personFacePersontenant_idTENANT_ID集团、租户隔离字段非终态，可按状态机或字典规则流转集团/租户隔离字段，所有查询必须带租户上下文
dev_face_personFacePersonis_deletedBOOL_DELETED0 未删除、1 已删除非终态，可按状态机或字典规则流转是否已删除，0 未删除，1 已删除
dev_face_personFacePersonperson_typePERSON_TYPE学员、教师、员工非终态，可按状态机或字典规则流转学员/教师/员工
dev_face_personFacePersonsource_terminalSOURCE_TERMINAL教师端、家长端、学员端、后台非终态，可按状态机或字典规则流转照片来源终端：教师端/家长端/学员端/后台
dev_face_personFacePersonsync_statusSYNC_STATUS未同步、待下发、已下发、待更新、待清除、已清除、失败包含终态，终态禁止直接编辑，需走变更/红冲/撤回流程未同步/待下发/已下发/待更新/待清除/已清除/失败
dev_face_dispatch_taskFaceDispatchTasktenant_idTENANT_ID集团、租户隔离字段非终态，可按状态机或字典规则流转集团/租户隔离字段，所有查询必须带租户上下文
dev_face_dispatch_taskFaceDispatchTaskis_deletedBOOL_DELETED0 未删除、1 已删除非终态，可按状态机或字典规则流转是否已删除，0 未删除，1 已删除
dev_face_dispatch_taskFaceDispatchTaskaction_typeACTION_TYPE新增、更新、清除、重试非终态，可按状态机或字典规则流转新增/更新/清除/重试
dev_face_dispatch_taskFaceDispatchTasktask_statusTASK_STATUS待执行、成功、失败、重试中、设备离线待重试包含终态，终态禁止直接编辑，需走变更/红冲/撤回流程待执行/成功/失败/重试中/设备离线待重试
dev_face_photo_sync_taskFacePhotoSyncTasktenant_idTENANT_ID集团、租户隔离字段非终态，可按状态机或字典规则流转集团/租户隔离字段，所有查询必须带租户上下文
dev_face_photo_sync_taskFacePhotoSyncTaskis_deletedBOOL_DELETED0 未删除、1 已删除非终态，可按状态机或字典规则流转是否已删除，0 未删除，1 已删除
dev_face_photo_sync_taskFacePhotoSyncTasksource_terminalSOURCE_TERMINAL教师端、家长端、学员端、后台非终态，可按状态机或字典规则流转教师端/家长端/学员端/后台
dev_face_photo_sync_taskFacePhotoSyncTaskcourse_scopeCOURSE_SCOPE按业务字典配置，需在字典中心维护编码、名称、排序、启停和终态标识非终态，可按状态机或字典规则流转学员关联课程与班级范围快照
dev_face_photo_sync_taskFacePhotoSyncTasktarget_device_scopeTARGET_DEVICE_SCOPE按业务字典配置，需在字典中心维护编码、名称、排序、启停和终态标识非终态，可按状态机或字典规则流转由课程教室推导出的人脸设备范围
dev_face_photo_sync_taskFacePhotoSyncTasksync_statusSYNC_STATUS待解析、待下发、部分成功、成功、失败、设备离线待重试包含终态，终态禁止直接编辑，需走变更/红冲/撤回流程待解析/待下发/部分成功/成功/失败/设备离线待重试
dev_face_clearance_taskFaceClearanceTasktenant_idTENANT_ID集团、租户隔离字段非终态，可按状态机或字典规则流转集团/租户隔离字段，所有查询必须带租户上下文
dev_face_clearance_taskFaceClearanceTaskis_deletedBOOL_DELETED0 未删除、1 已删除非终态，可按状态机或字典规则流转是否已删除，0 未删除，1 已删除
dev_face_clearance_taskFaceClearanceTasktrigger_typeTRIGGER_TYPE课时耗尽、合同到期、权益终止、人工重算非终态，可按状态机或字典规则流转课时耗尽/合同到期/权益终止/人工重算
dev_face_clearance_taskFaceClearanceTasktarget_device_scopeTARGET_DEVICE_SCOPE按业务字典配置，需在字典中心维护编码、名称、排序、启停和终态标识非终态，可按状态机或字典规则流转需要清除的人脸设备范围
dev_face_clearance_taskFaceClearanceTaskclearance_statusCLEARANCE_STATUS待清除、清除中、部分成功、成功、失败、设备离线待重试包含终态，终态禁止直接编辑，需走变更/红冲/撤回流程待清除/清除中/部分成功/成功/失败/设备离线待重试
dev_face_eventFaceAttendanceEventtenant_idTENANT_ID集团、租户隔离字段非终态，可按状态机或字典规则流转集团/租户隔离字段，所有查询必须带租户上下文
dev_face_eventFaceAttendanceEventis_deletedBOOL_DELETED0 未删除、1 已删除非终态，可按状态机或字典规则流转是否已删除，0 未删除，1 已删除
dev_face_eventFaceAttendanceEventmatch_statusMATCH_STATUS已匹配、低置信、未匹配、重复非终态，可按状态机或字典规则流转已匹配/低置信/未匹配/重复
dev_face_eventFaceAttendanceEventrights_check_statusRIGHTS_CHECK_STATUS通过、无有效权益、课时不足、合同到期非终态，可按状态机或字典规则流转通过/无有效权益/课时不足/合同到期
dev_face_eventFaceAttendanceEventconsume_resultCONSUME_RESULT未处理、已课消、不可课消、待人工确认非终态，可按状态机或字典规则流转未处理/已课消/不可课消/待人工确认
dev_face_eventFaceAttendanceEventupload_modeUPLOAD_MODE实时上传、离线补传非终态，可按状态机或字典规则流转实时上传/离线补传

敏感字段与数据安全策略

来源表名对象字段数据级别脱敏/返回策略明文查看条件导出策略审计要求端侧展示规则
本模块对象dev_face_personFacePersonphoto_file_id高敏FACE_IMAGE_PROTECTED默认只返回受控文件 ID/缩略图；证件照上传、查看、更新和设备下发需授权和审计禁止常规导出；仅证件照更新、设备下发和合规取证场景允许证件照上传、更新、下发、识别、失败重试全链路留痕未授权端不展示原图；设备端按任务有效期拉取
本模块对象dev_face_personFacePersonphoto_version普通FACE_IMAGE_PROTECTED默认只返回受控文件 ID/缩略图；证件照上传、查看、更新和设备下发需授权和审计禁止常规导出；仅证件照更新、设备下发和合规取证场景允许证件照上传、更新、下发、识别、失败重试全链路留痕未授权端不展示原图；设备端按任务有效期拉取
本模块对象dev_face_personFacePersonsource_terminal普通FACE_IMAGE_PROTECTED默认只返回受控文件 ID/缩略图；证件照上传、查看、更新和设备下发需授权和审计禁止常规导出；仅证件照更新、设备下发和合规取证场景允许证件照上传、更新、下发、识别、失败重试全链路留痕未授权端不展示原图；设备端按任务有效期拉取
本模块对象dev_face_personFacePersonsource_uploaded_at普通FACE_IMAGE_PROTECTED默认只返回受控文件 ID/缩略图；证件照上传、查看、更新和设备下发需授权和审计禁止常规导出；仅证件照更新、设备下发和合规取证场景允许证件照上传、更新、下发、识别、失败重试全链路留痕未授权端不展示原图；设备端按任务有效期拉取
本模块对象dev_face_personFacePersonvalid_until普通FACE_IMAGE_PROTECTED默认只返回受控文件 ID/缩略图；证件照上传、查看、更新和设备下发需授权和审计禁止常规导出；仅证件照更新、设备下发和合规取证场景允许证件照上传、更新、下发、识别、失败重试全链路留痕未授权端不展示原图；设备端按任务有效期拉取
本模块对象dev_face_dispatch_taskFaceDispatchTaskrequest_payload普通PAYLOAD_DESENSITIZE接口报文、快照和文件地址默认脱敏；排障查看需运维/安全授权导出日志或报文时自动清理手机号、证件号、密钥、票据和人脸字段查看报文、下载附件、失败重放和人工补偿均记录审计业务端展示摘要和状态，完整报文仅运维/安全后台查看
本模块对象dev_face_dispatch_taskFaceDispatchTaskresponse_payload普通PAYLOAD_DESENSITIZE接口报文、快照和文件地址默认脱敏；排障查看需运维/安全授权导出日志或报文时自动清理手机号、证件号、密钥、票据和人脸字段查看报文、下载附件、失败重放和人工补偿均记录审计业务端展示摘要和状态，完整报文仅运维/安全后台查看
本模块对象dev_face_photo_sync_taskFacePhotoSyncTaskphoto_file_id高敏FACE_IMAGE_PROTECTED默认只返回受控文件 ID/缩略图；证件照上传、查看、更新和设备下发需授权和审计禁止常规导出；仅证件照更新、设备下发和合规取证场景允许证件照上传、更新、下发、识别、失败重试全链路留痕未授权端不展示原图；设备端按任务有效期拉取
本模块对象dev_face_photo_sync_taskFacePhotoSyncTaskphoto_version普通FACE_IMAGE_PROTECTED默认只返回受控文件 ID/缩略图；证件照上传、查看、更新和设备下发需授权和审计禁止常规导出；仅证件照更新、设备下发和合规取证场景允许证件照上传、更新、下发、识别、失败重试全链路留痕未授权端不展示原图；设备端按任务有效期拉取
本模块对象dev_face_photo_sync_taskFacePhotoSyncTasktarget_device_scope普通FACE_IMAGE_PROTECTED默认只返回受控文件 ID/缩略图；证件照上传、查看、更新和设备下发需授权和审计禁止常规导出；仅证件照更新、设备下发和合规取证场景允许证件照上传、更新、下发、识别、失败重试全链路留痕未授权端不展示原图；设备端按任务有效期拉取
本模块对象dev_face_clearance_taskFaceClearanceTasktarget_device_scope普通FACE_IMAGE_PROTECTED默认只返回受控文件 ID/缩略图；证件照上传、查看、更新和设备下发需授权和审计禁止常规导出；仅证件照更新、设备下发和合规取证场景允许证件照上传、更新、下发、识别、失败重试全链路留痕未授权端不展示原图；设备端按任务有效期拉取
本模块对象dev_face_eventFaceAttendanceEventraw_payload敏感PAYLOAD_DESENSITIZE接口报文、快照和文件地址默认脱敏；排障查看需运维/安全授权导出日志或报文时自动清理手机号、证件号、密钥、票据和人脸字段查看报文、下载附件、失败重放和人工补偿均记录审计业务端展示摘要和状态，完整报文仅运维/安全后台查看
引用对象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按字段权限、数据范围和业务角色展示；明文查看按敏感字段审批规则执行导出时按数据级别触发审批、水印、下载有效期和日志查看、修改、删除、导出、下载和审批均记录操作审计默认遵循总部、区域、校区、团队、本人数据范围和端侧最小可见原则
引用对象stu_studentStudentremark普通BIZ_FIELD_MASK按字段权限、数据范围和业务角色展示；明文查看按敏感字段审批规则执行导出时按数据级别触发审批、水印、下载有效期和日志查看、修改、删除、导出、下载和审批均记录操作审计默认遵循总部、区域、校区、团队、本人数据范围和端侧最小可见原则
引用对象edu_attendanceAttendancecheckin_type普通FACE_IMAGE_PROTECTED默认只返回受控文件 ID/缩略图；证件照上传、查看、更新和设备下发需授权和审计禁止常规导出；仅证件照更新、设备下发和合规取证场景允许证件照上传、更新、下发、识别、失败重试全链路留痕未授权端不展示原图；设备端按任务有效期拉取

核心数据表完整字段

表名对象字段类型必填规则数据级别
dev_face_deviceFaceDeviceidBIGINT是主键，雪花或号段生成，禁止复用普通
dev_face_deviceFaceDevicetenant_idBIGINT是集团/租户隔离字段，所有查询必须带租户上下文普通
dev_face_deviceFaceDeviceorg_idBIGINT否所属组织，集团级或公共配置为空普通
dev_face_deviceFaceDevicecampus_idBIGINT是所属校区，跨校区或总部级数据为空；本表业务要求必填普通
dev_face_deviceFaceDevicecreated_byBIGINT是创建人账号 ID普通
dev_face_deviceFaceDevicecreated_atDATETIME是创建时间普通
dev_face_deviceFaceDeviceupdated_byBIGINT否最后更新人账号 ID普通
dev_face_deviceFaceDeviceupdated_atDATETIME否最后更新时间普通
dev_face_deviceFaceDeviceis_deletedTINYINT是是否已删除，0 未删除，1 已删除普通
dev_face_deviceFaceDevicedeleted_atDATETIME否删除时间，未删除为空普通
dev_face_deviceFaceDevicedeleted_byBIGINT否删除人账号 ID，未删除为空普通
dev_face_deviceFaceDeviceversionINT是乐观锁版本号，写操作必须校验普通
dev_face_deviceFaceDevicedevice_codeVARCHAR(64)是设备编码，唯一普通
dev_face_deviceFaceDevicevendor_codeVARCHAR(32)是设备品牌/厂商普通
dev_face_deviceFaceDevicedevice_nameVARCHAR(128)是设备名称普通
dev_face_deviceFaceDeviceclassroom_idBIGINT是绑定教室 ID，必须属于同一校区且教室未逻辑删除普通
dev_face_deviceFaceDeviceapi_endpointVARCHAR(512)否设备或平台 API 地址普通
dev_face_deviceFaceDevicedevice_statusVARCHAR(32)是在线/离线/停用/异常普通
dev_face_personFacePersonidBIGINT是主键，雪花或号段生成，禁止复用普通
dev_face_personFacePersontenant_idBIGINT是集团/租户隔离字段，所有查询必须带租户上下文普通
dev_face_personFacePersonorg_idBIGINT否所属组织，集团级或公共配置为空普通
dev_face_personFacePersoncampus_idBIGINT否所属校区，跨校区或总部级数据为空普通
dev_face_personFacePersoncreated_byBIGINT是创建人账号 ID普通
dev_face_personFacePersoncreated_atDATETIME是创建时间普通
dev_face_personFacePersonupdated_byBIGINT否最后更新人账号 ID普通
dev_face_personFacePersonupdated_atDATETIME否最后更新时间普通
dev_face_personFacePersonis_deletedTINYINT是是否已删除，0 未删除，1 已删除普通
dev_face_personFacePersondeleted_atDATETIME否删除时间，未删除为空普通
dev_face_personFacePersondeleted_byBIGINT否删除人账号 ID，未删除为空普通
dev_face_personFacePersonversionINT是乐观锁版本号，写操作必须校验普通
dev_face_personFacePersonperson_noVARCHAR(64)是人员编号，唯一普通
dev_face_personFacePersonperson_typeVARCHAR(32)是学员/教师/员工普通
dev_face_personFacePersonperson_idBIGINT是业务人员 ID普通
dev_face_personFacePersonphoto_file_idBIGINT是人脸照片文件 ID高敏
dev_face_personFacePersonphoto_versionINT是证件照版本号，照片更新后递增普通
dev_face_personFacePersonsource_terminalVARCHAR(32)是照片来源终端：教师端/家长端/学员端/后台普通
dev_face_personFacePersonsource_uploaded_atDATETIME是来源照片上传时间普通
dev_face_personFacePersonvalid_untilDATETIME否设备侧人员照片业务有效期普通
dev_face_personFacePersonsync_statusVARCHAR(32)是未同步/待下发/已下发/待更新/待清除/已清除/失败普通
dev_face_dispatch_taskFaceDispatchTaskidBIGINT是主键，雪花或号段生成，禁止复用普通
dev_face_dispatch_taskFaceDispatchTasktenant_idBIGINT是集团/租户隔离字段，所有查询必须带租户上下文普通
dev_face_dispatch_taskFaceDispatchTaskorg_idBIGINT否所属组织，集团级或公共配置为空普通
dev_face_dispatch_taskFaceDispatchTaskcampus_idBIGINT否所属校区，跨校区或总部级数据为空普通
dev_face_dispatch_taskFaceDispatchTaskcreated_byBIGINT是创建人账号 ID普通
dev_face_dispatch_taskFaceDispatchTaskcreated_atDATETIME是创建时间普通
dev_face_dispatch_taskFaceDispatchTaskupdated_byBIGINT否最后更新人账号 ID普通
dev_face_dispatch_taskFaceDispatchTaskupdated_atDATETIME否最后更新时间普通
dev_face_dispatch_taskFaceDispatchTaskis_deletedTINYINT是是否已删除，0 未删除，1 已删除普通
dev_face_dispatch_taskFaceDispatchTaskdeleted_atDATETIME否删除时间，未删除为空普通
dev_face_dispatch_taskFaceDispatchTaskdeleted_byBIGINT否删除人账号 ID，未删除为空普通
dev_face_dispatch_taskFaceDispatchTaskversionINT是乐观锁版本号，写操作必须校验普通
dev_face_dispatch_taskFaceDispatchTasktask_noVARCHAR(64)是任务编号，唯一普通
dev_face_dispatch_taskFaceDispatchTaskdevice_idBIGINT是设备 ID普通
dev_face_dispatch_taskFaceDispatchTaskperson_idBIGINT是人员库 ID普通
dev_face_dispatch_taskFaceDispatchTaskaction_typeVARCHAR(32)是新增/更新/清除/重试普通
dev_face_dispatch_taskFaceDispatchTaskrequest_payloadJSON是下发请求普通
dev_face_dispatch_taskFaceDispatchTaskresponse_payloadJSON否设备响应普通
dev_face_dispatch_taskFaceDispatchTasktask_statusVARCHAR(32)是待执行/成功/失败/重试中/设备离线待重试普通
dev_face_photo_sync_taskFacePhotoSyncTaskidBIGINT是主键，雪花或号段生成，禁止复用普通
dev_face_photo_sync_taskFacePhotoSyncTasktenant_idBIGINT是集团/租户隔离字段，所有查询必须带租户上下文普通
dev_face_photo_sync_taskFacePhotoSyncTaskorg_idBIGINT否所属组织，集团级或公共配置为空普通
dev_face_photo_sync_taskFacePhotoSyncTaskcampus_idBIGINT否所属校区，跨校区或总部级数据为空普通
dev_face_photo_sync_taskFacePhotoSyncTaskcreated_byBIGINT是创建人账号 ID普通
dev_face_photo_sync_taskFacePhotoSyncTaskcreated_atDATETIME是创建时间普通
dev_face_photo_sync_taskFacePhotoSyncTaskupdated_byBIGINT否最后更新人账号 ID普通
dev_face_photo_sync_taskFacePhotoSyncTaskupdated_atDATETIME否最后更新时间普通
dev_face_photo_sync_taskFacePhotoSyncTaskis_deletedTINYINT是是否已删除，0 未删除，1 已删除普通
dev_face_photo_sync_taskFacePhotoSyncTaskdeleted_atDATETIME否删除时间，未删除为空普通
dev_face_photo_sync_taskFacePhotoSyncTaskdeleted_byBIGINT否删除人账号 ID，未删除为空普通
dev_face_photo_sync_taskFacePhotoSyncTaskversionINT是乐观锁版本号，写操作必须校验普通
dev_face_photo_sync_taskFacePhotoSyncTasksync_noVARCHAR(64)是同步任务编号，唯一普通
dev_face_photo_sync_taskFacePhotoSyncTaskstudent_idBIGINT是学员 ID普通
dev_face_photo_sync_taskFacePhotoSyncTaskphoto_file_idBIGINT是最新证件照文件 ID高敏
dev_face_photo_sync_taskFacePhotoSyncTaskphoto_versionINT是照片版本号普通
dev_face_photo_sync_taskFacePhotoSyncTasksource_terminalVARCHAR(32)是教师端/家长端/学员端/后台普通
dev_face_photo_sync_taskFacePhotoSyncTaskcourse_scopeJSON是学员关联课程与班级范围快照普通
dev_face_photo_sync_taskFacePhotoSyncTasktarget_device_scopeJSON是由课程教室推导出的人脸设备范围普通
dev_face_photo_sync_taskFacePhotoSyncTasksync_statusVARCHAR(32)是待解析/待下发/部分成功/成功/失败/设备离线待重试普通
dev_face_clearance_taskFaceClearanceTaskidBIGINT是主键，雪花或号段生成，禁止复用普通
dev_face_clearance_taskFaceClearanceTasktenant_idBIGINT是集团/租户隔离字段，所有查询必须带租户上下文普通
dev_face_clearance_taskFaceClearanceTaskorg_idBIGINT否所属组织，集团级或公共配置为空普通
dev_face_clearance_taskFaceClearanceTaskcampus_idBIGINT否所属校区，跨校区或总部级数据为空普通
dev_face_clearance_taskFaceClearanceTaskcreated_byBIGINT是创建人账号 ID普通
dev_face_clearance_taskFaceClearanceTaskcreated_atDATETIME是创建时间普通
dev_face_clearance_taskFaceClearanceTaskupdated_byBIGINT否最后更新人账号 ID普通
dev_face_clearance_taskFaceClearanceTaskupdated_atDATETIME否最后更新时间普通
dev_face_clearance_taskFaceClearanceTaskis_deletedTINYINT是是否已删除，0 未删除，1 已删除普通
dev_face_clearance_taskFaceClearanceTaskdeleted_atDATETIME否删除时间，未删除为空普通
dev_face_clearance_taskFaceClearanceTaskdeleted_byBIGINT否删除人账号 ID，未删除为空普通
dev_face_clearance_taskFaceClearanceTaskversionINT是乐观锁版本号，写操作必须校验普通
dev_face_clearance_taskFaceClearanceTaskclearance_noVARCHAR(64)是清除任务编号，唯一普通
dev_face_clearance_taskFaceClearanceTaskstudent_idBIGINT是学员 ID普通
dev_face_clearance_taskFaceClearanceTaskperson_idBIGINT是人员库 ID普通
dev_face_clearance_taskFaceClearanceTasktrigger_typeVARCHAR(32)是课时耗尽/合同到期/权益终止/人工重算普通
dev_face_clearance_taskFaceClearanceTaskremaining_hours_snapshotDECIMAL(8,2)是触发时剩余课时快照普通
dev_face_clearance_taskFaceClearanceTasktarget_device_scopeJSON是需要清除的人脸设备范围普通
dev_face_clearance_taskFaceClearanceTaskclearance_statusVARCHAR(32)是待清除/清除中/部分成功/成功/失败/设备离线待重试普通
dev_face_clearance_taskFaceClearanceTasktriggered_atDATETIME是触发时间普通
dev_face_eventFaceAttendanceEventidBIGINT是主键，雪花或号段生成，禁止复用普通
dev_face_eventFaceAttendanceEventtenant_idBIGINT是集团/租户隔离字段，所有查询必须带租户上下文普通
dev_face_eventFaceAttendanceEventorg_idBIGINT否所属组织，集团级或公共配置为空普通
dev_face_eventFaceAttendanceEventcampus_idBIGINT否所属校区，跨校区或总部级数据为空普通
dev_face_eventFaceAttendanceEventcreated_byBIGINT是创建人账号 ID普通
dev_face_eventFaceAttendanceEventcreated_atDATETIME是创建时间普通
dev_face_eventFaceAttendanceEventupdated_byBIGINT否最后更新人账号 ID普通
dev_face_eventFaceAttendanceEventupdated_atDATETIME否最后更新时间普通
dev_face_eventFaceAttendanceEventis_deletedTINYINT是是否已删除，0 未删除，1 已删除普通
dev_face_eventFaceAttendanceEventdeleted_atDATETIME否删除时间，未删除为空普通
dev_face_eventFaceAttendanceEventdeleted_byBIGINT否删除人账号 ID，未删除为空普通
dev_face_eventFaceAttendanceEventversionINT是乐观锁版本号，写操作必须校验普通
dev_face_eventFaceAttendanceEventdevice_idBIGINT是设备 ID普通
dev_face_eventFaceAttendanceEventdevice_event_idVARCHAR(128)是设备侧事件号普通
dev_face_eventFaceAttendanceEventperson_idBIGINT否匹配人员 ID普通
dev_face_eventFaceAttendanceEventlesson_idBIGINT否匹配课次 ID普通
dev_face_eventFaceAttendanceEventevent_timeDATETIME是识别时间普通
dev_face_eventFaceAttendanceEventconfidenceDECIMAL(8,4)是识别置信度普通
dev_face_eventFaceAttendanceEventmatch_statusVARCHAR(32)是已匹配/低置信/未匹配/重复普通
dev_face_eventFaceAttendanceEventrights_check_statusVARCHAR(32)是通过/无有效权益/课时不足/合同到期普通
dev_face_eventFaceAttendanceEventconsume_resultVARCHAR(32)是未处理/已课消/不可课消/待人工确认普通
dev_face_eventFaceAttendanceEventerror_codeVARCHAR(64)否不可课消错误码普通
dev_face_eventFaceAttendanceEventerror_messageVARCHAR(255)否不可课消提示文案普通
dev_face_eventFaceAttendanceEventupload_modeVARCHAR(32)是实时上传/离线补传普通
dev_face_eventFaceAttendanceEventdevice_cached_atDATETIME否设备离线缓存时间普通
dev_face_eventFaceAttendanceEventraw_payloadJSON是设备原始报文敏感

数据表与对象映射

表名对象用途完整字段索引建议
dev_face_deviceFaceDevice人脸识别考勤设备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,必填)、device_code(VARCHAR(64),必填)、vendor_code(VARCHAR(32),必填)、device_name(VARCHAR(128),必填)、classroom_id(BIGINT,必填)、api_endpoint(VARCHAR(512))、device_status(VARCHAR(32),必填)uk_device_code、idx_campus_classroom_status
dev_face_personFacePerson人脸人员库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,必填)、person_no(VARCHAR(64),必填)、person_type(VARCHAR(32),必填)、person_id(BIGINT,必填)、photo_file_id(BIGINT,必填)、photo_version(INT,必填)、source_terminal(VARCHAR(32),必填)、source_uploaded_at(DATETIME,必填)、valid_until(DATETIME)、sync_status(VARCHAR(32),必填)uk_person_type_id、idx_sync
dev_face_dispatch_taskFaceDispatchTask人脸下发任务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),必填)、device_id(BIGINT,必填)、person_id(BIGINT,必填)、action_type(VARCHAR(32),必填)、request_payload(JSON,必填)、response_payload(JSON)、task_status(VARCHAR(32),必填)uk_task_no、idx_device_status
dev_face_photo_sync_taskFacePhotoSyncTask证件照更新同步任务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,必填)、sync_no(VARCHAR(64),必填)、student_id(BIGINT,必填)、photo_file_id(BIGINT,必填)、photo_version(INT,必填)、source_terminal(VARCHAR(32),必填)、course_scope(JSON,必填)、target_device_scope(JSON,必填)、sync_status(VARCHAR(32),必填)uk_sync_no、idx_student_status、idx_photo_version
dev_face_clearance_taskFaceClearanceTask课时耗尽人脸清除任务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,必填)、clearance_no(VARCHAR(64),必填)、student_id(BIGINT,必填)、person_id(BIGINT,必填)、trigger_type(VARCHAR(32),必填)、remaining_hours_snapshot(DECIMAL(8,2),必填)、target_device_scope(JSON,必填)、clearance_status(VARCHAR(32),必填)、triggered_at(DATETIME,必填)uk_clearance_no、idx_student_status、idx_person_status
dev_face_eventFaceAttendanceEvent人脸识别回传事件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,必填)、device_id(BIGINT,必填)、device_event_id(VARCHAR(128),必填)、person_id(BIGINT)、lesson_id(BIGINT)、event_time(DATETIME,必填)、confidence(DECIMAL(8,4),必填)、match_status(VARCHAR(32),必填)、rights_check_status(VARCHAR(32),必填)、consume_result(VARCHAR(32),必填)、error_code(VARCHAR(64))、error_message(VARCHAR(255))、upload_mode(VARCHAR(32),必填)、device_cached_at(DATETIME)、raw_payload(JSON,必填)uk_device_event、idx_lesson_person、idx_event_time

12 · 状态机与业务规则

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

原型需要把状态标签、可操作按钮和禁用原因展示清楚。
对象状态触发与说明
督课评分待评分 -> 系统初评 -> 待复核 -> 已确认 -> 申诉中 -> 已调整 -> 已归档学生数据采集、教师数据采集、系统评分、督课复核、校长确认和申诉处理
监管报送待生成 -> 待报送 -> 报送中 -> 成功 -> 失败 -> 待重报 -> 人工处理合同备案、收款、课消、退费报送与回执
退费单草稿 -> 待学管确认 -> 待校长审批 -> 待财务复核 -> 监管退款中 -> 已退款 -> 已驳回 -> 已取消退费测算、审批、退款回执和凭证冲销
报销单草稿 -> 待 OCR -> 待核验 -> 待审批 -> 已通过 -> 待付款 -> 已付款 -> 已驳回 -> 已作废员工填单、票据识别、发票核验、查重、审批、付款归档
工单新建 -> 已分派 -> 处理中 -> 待家长确认 -> 已关闭 -> 已升级 -> 已驳回投诉建议、服务请求、教学反馈和退费咨询
学习任务未开始 -> 学习中 -> 已提交 -> 已批改 -> 需订正 -> 已完成 -> 已过期资源学习、作业提交、教师批改和进度归档
员工培训未分配 -> 待学习 -> 学习中 -> 待考试 -> 已通过 -> 未通过 -> 补训中 -> 已逾期培训计划发布、学习进度、考试成绩、补考复训和学习档案归档
直播房间草稿 -> 待开播 -> 直播中 -> 已结束 -> 回放生成中 -> 可回放 -> 异常 -> 已关闭创建房间、供应商资源申请、教师开播、下课、录制转码、回放发布和异常关闭
直播录制未录制 -> 录制中 -> 转码中 -> 可回放 -> 转码失败 -> 已过期 -> 已归档供应商录制回调、转码任务、回放发布、留存过期和资料归档
活动落地页草稿 -> 编辑中 -> 待发布 -> 发布中 -> 已发布 -> 发布失败 -> 已停用选择模板、编辑、发布、生成链接/活码、停用和复盘
作业草稿无草稿 -> 编辑中 -> 自动保存中 -> 已保存 -> 待提交 -> 已提交 -> 已删除 -> 已过期 -> 冲突待恢复学员进入作业后可自动或手动保存草稿，提交成功后关闭草稿；删除、过期和多端冲突必须可提示、可审计、可恢复到安全状态
直播连麦请求未举手 -> 已举手排队 -> 教师邀请中 -> 连接中 -> 上麦中 -> 已下麦 -> 已拒绝 -> 已取消 -> 已超时 -> 连接失败学员举手进入队列，教师处理后进入邀请和连接；取消、拒绝、超时、失败、下麦均写入互动事件和连麦请求记录
直播连麦座席空闲 -> 占用中 -> 静音 -> 下麦中 -> 已释放 -> 异常教师端按座席管理当前上麦人员，人数达到上限后新请求继续排队或提示人数已满
请假补课草稿 -> 待审批 -> 已同意 -> 已驳回 -> 已取消 -> 补课待安排 -> 补课待确认 -> 补课已预约 -> 已补课 -> 已关闭家长请假、教务审批、课消冻结或回滚、补课安排、家长确认和补课完成
转班转课待测算 -> 待确认 -> 审批中 -> 补差待收 -> 退差待退 -> 已生效 -> 已驳回 -> 已取消顾问或教务发起，完成权益重算、家长确认、审批、收退差和课表变更
试听课已预约 -> 已提醒 -> 已到访 -> 已试听 -> 待反馈 -> 已反馈 -> 已转化 -> 未到访 -> 已关闭预约、提醒、到访签到、教师反馈、家长评价、未到访唤醒和转化
积分兑换售后待处理 -> 积分退回中 -> 库存释放中 -> 已完成 -> 失败待人工 -> 已关闭兑换取消、过期未核销、核销撤销和库存回滚
电子工资条待生成 -> 待审核 -> 待发布 -> 已发布 -> 员工已查看 -> 异议中 -> 已确认 -> 已归档薪资核算、审批、发布、员工查看确认、异议处理和归档
补课改期取消已确认 -> 改期申请中 -> 取消申请中 -> 教务处理中 -> 已重新安排 -> 已拒绝 -> 已关闭 -> 待冲正 -> 已冲正家长发起改期或取消，教务处理候选课次和课消冲正，最终回到补课安排或关闭
回放补传替换录制失败 -> 待补传 -> 审核中 -> 已发布 -> 替换中 -> 已替换 -> 已通知 -> 已驳回 -> 已下架录制失败或回放损坏后人工补传、审核、版本替换、通知和学习记录处理
工资条撤回重发已发布 -> 撤回中 -> 已撤回 -> 重发待审核 -> 已重发 -> 待重新确认 -> 已确认 -> 已归档工资条发布错误后撤回、重发、员工重新确认和版本留痕
国税核验配置草稿 -> 启用中 -> 频控中 -> 异常 -> 已停用 -> 已过期校区税务主体、官方接口凭证、额度、启用状态和调用日志
付款失败补偿付款失败 -> 待重试 -> 重试中 -> 换账户中 -> 撤销审批中 -> 线下付款登记 -> 已补偿 -> 人工关闭报销、采购、退款、工资付款失败后的统一补偿
课堂端会话待绑定 -> 已绑定 -> 待开课 -> 授课中 -> 暂停中 -> 已结束 -> 异常断开教师或教室设备创建课堂会话，TV 与教师端完成绑定后同步课件、互动和课堂状态；断开后可重连，结束后归档审计。
TV 课件播放未加载 -> 加载中 -> 播放中 -> 暂停 -> 互动展示中 -> 播放失败 -> 已退出TV 端接收课堂联动指令，按课件类型播放或展示，失败时回传错误码并提示教师端重试。
教师端工作台任务待处理 -> 处理中 -> 已完成 -> 已驳回 -> 已超时 -> 已取消课程、批改、审批、培训、报销、工资条和直播任务统一进入工作台待办，并按业务模块回写处理状态。
员工推广资产待生成 -> 已生成 -> 分享中 -> 已停用 -> 已失效 -> 生成失败员工在教师端领取活动后生成专属短链、二维码和海报，活动停用或超期后资产失效
员工分享记录已分享 -> 已访问 -> 已扫码 -> 已留资 -> 已生成线索 -> 已预约试听 -> 已签约 -> 已流失外部访问、扫码、留资和转化阶段均回写员工分享记录
活动大屏指标未配置 -> 已配置 -> 口径校验中 -> 校验通过 -> 校验失败 -> 刷新中 -> 已刷新 -> 部分失败指标按系统实时数据优先刷新，退费、作废和补录撤销需回滚
大屏补录流水有效 -> 已撤回 -> 已作废 -> 重算中 -> 重算失败补录和撤回均触发指标重算，最近20条流水在后台可快捷查看
大屏展示组件未配置 -> 已配置 -> 校验通过 -> 校验失败 -> 已停用组件配置控制战区/校区切换、排名维度、显示全部老师、语数英分组和空状态
片段录制任务待处理 -> 录制中 -> 可下载 -> 失败 -> 已过期 -> 已取消宇视回放下载必须先生成片段录制任务，任务完成后才提供片段回放和下载地址
拼团活动草稿 -> 待审核 -> 进行中 -> 已成团 -> 成团失败 -> 退款处理中 -> 已结束 -> 已关闭拼团发布、成团、失败退款和线索归因
快速点名待点名 -> 点名中 -> 已点名 -> 待课消 -> 已课消 -> 课消失败 -> 待人工确认快速点名与考勤课消联动
课堂报告待生成 -> 生成中 -> 已生成 -> 待发送 -> 已发送 -> 家长已读 -> 已评价 -> 生成失败课后报告生成、触达和评价老师
相册作品内容草稿 -> 待审核 -> 已发布 -> 已下架 -> 已举报 -> 整改中 -> 已归档班级相册、成长相册、作品展和在校生活内容管理
总账账套草稿 -> 待初始化 -> 初始化中 -> 已启用 -> 结账中 -> 已停用 -> 异常法人、校区、会计政策、会计日历、账簿和科目体系启停审计
财务事件待生成 -> 待制证 -> 制证中 -> 已生成凭证 -> 制证失败 -> 待冲正 -> 已冲正 -> 已关闭业务单据生成财务事件、凭证生成、失败重试、冲正和关闭
网银付款指令待提交 -> 提交中 -> 银行受理 -> 付款成功 -> 付款失败 -> 结果未知 -> 已撤销网上银行和开放银行付款指令、回单归档和失败补偿
阿米巴报表待取数 -> 计算中 -> 待复核 -> 已发布 -> 规则异常 -> 已归档校区、课程、项目和团队阿米巴经营损益核算
成本结转待归集 -> 归集中 -> 待分摊 -> 待结转 -> 已结转 -> 结转失败物料、图书、资产、课酬、活动和公共费用成本归集、分摊和结转
自定义报表草稿 -> 待校验 -> 已发布 -> 刷新中 -> 刷新成功 -> 刷新失败 -> 导出审批中 -> 已停用自定义报表配置、刷新和导出审批
AI 助手任务待执行 -> 执行中 -> 待人工确认 -> 已采纳 -> 已驳回 -> 执行失败 -> 已关闭AI 问查做评结果必须支持人工确认和审计
考勤设备教室绑定未绑定 -> 待校验 -> 已绑定 -> 绑定失败 -> 跨校区拦截 -> 教室停用拦截 -> 换绑中 -> 已停用考勤设备必须绑定指定校区的指定教室，启用前校验教室存在、启用且未逻辑删除
考勤事件课次匹配待匹配 -> 按教室匹配成功 -> 低置信度 -> 未匹配 -> 跨校区异常 -> 重复事件 -> 人工复核中 -> 已回写考勤识别事件按设备绑定教室、课表时间和学员名单匹配课次
唯一性校验

智能考勤设备中心涉及该规则时，必须在前端提示、后端校验、审计日志和测试用例中同时覆盖。

跨校区数据隔离

智能考勤设备中心涉及该规则时，必须在前端提示、后端校验、审计日志和测试用例中同时覆盖。

敏感操作留痕

智能考勤设备中心涉及该规则时，必须在前端提示、后端校验、审计日志和测试用例中同时覆盖。

外部接口幂等

智能考勤设备中心涉及该规则时，必须在前端提示、后端校验、审计日志和测试用例中同时覆盖。

批量失败明细

智能考勤设备中心涉及该规则时，必须在前端提示、后端校验、审计日志和测试用例中同时覆盖。

状态回退审批

智能考勤设备中心涉及该规则时，必须在前端提示、后端校验、审计日志和测试用例中同时覆盖。

13 · 权限、审批与消息

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

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

动作权限

  • 设备建档：需映射菜单、按钮、接口和字段权限
  • 绑定教室：需映射菜单、按钮、接口和字段权限
  • 换绑教室：需映射菜单、按钮、接口和字段权限
  • 证件照更新：需映射菜单、按钮、接口和字段权限
  • 目标设备解析：需映射菜单、按钮、接口和字段权限
  • 人员照片下发：需映射菜单、按钮、接口和字段权限
  • 事件回传：需映射菜单、按钮、接口和字段权限
  • 权益校验：需映射菜单、按钮、接口和字段权限
  • 课消阻断：需映射菜单、按钮、接口和字段权限
  • 人脸自动清除：需映射菜单、按钮、接口和字段权限
  • 离线补传：需映射菜单、按钮、接口和字段权限
  • 异常确认：需映射菜单、按钮、接口和字段权限
  • 设备巡检：需映射菜单、按钮、接口和字段权限

数据范围

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

审批配置

审批名称触发条件流程结果留痕
退费审批任意退费或转课产生金额冲减学管师确认 -> 校长审批 -> 财务复核通过后进入监管退款，驳回后关闭退费单保留测算明细、附件和退款回执
报销审批员工提交费用报销或发票查重命中风险员工提交 -> 部门主管 -> 校长/预算负责人 -> 财务复核通过后进入付款，驳回后返回报销人修改保留票据影像、OCR 结果、核验结果、查重结果和审批意见
账套反结账审批已结账期间需要反结账或更正税务资料校区财务提交 -> 总部财务复核 -> 财务负责人终审通过后解锁期间并记录调整原因保留反结账前后凭证、税表和审批说明
物料采购审批采购金额超过阈值、跨校区采购或固定资产采购申请人 -> 校区负责人 -> 采购/财务 -> 总部审批通过后生成采购订单和到货验收任务保留预算、供应商、报价和采购合同附件
固定资产报废审批固定资产、图书或高价值物料需要报废责任人提交 -> 校区负责人 -> 资产管理员 -> 财务复核通过后出库、报废并生成财务核销记录保留照片、盘点记录、处置说明和残值
转校审批学员权益跨校区转移原校区校长 -> 目标校区校长 -> 财务确认权益和服务归属迁移记录转出转入校区和余额
督课评分复核教学质量分低于阈值、教师提出申诉或总部抽检命中教研督导 -> 校长/区域教学负责人 -> 总部教研维持评分、调整评分或生成整改复训任务保留评分明细、回放片段、调整原因和复核人
培训课程发布审批面向全员、跨校区或涉及制度类培训内容人事/教研提交 -> 部门负责人 -> 总部审核发布培训计划或退回修改记录适用岗位、资料版本和考试规则

消息模板

消息接收人触发渠道变量
新线索分配提醒课程顾问线索分配成功站内信、App、企微学员姓名、来源渠道、校区、保护期
试听预约通知家长/教师/顾问试听课预约成功或变更小程序、短信、App上课时间、校区、教室、教师
电子合同待签署家长合同生成后短信、小程序、H5合同名称、金额、签署链接、有效期
收款成功通知家长/顾问/财务支付成功小程序、站内信订单金额、课程、支付时间
库存预警库管/校区负责人物料或礼品低于安全库存站内信、App、企微SKU、校区、当前库存、安全库存、补货建议
积分兑换核销通知学员/家长/校区前台兑换成功、即将过期或核销完成小程序、App、站内信礼品名称、兑换码、核销校区、有效期
到校签到通知家长人脸或人工签到成功小程序、App学员姓名、签到时间、校区、课程
签到异常提醒教务/前台识别未匹配或低置信度站内信、App设备、时间、候选学员、置信度

14 · 接口与技术细节

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

每个写接口必须有 requestId 或业务幂等键，外部回调必须验签和去重。
接口方法方向请求字段响应字段幂等/权限
/api/v1/face/devicesPOST/GETPC Web 到设备中心deviceCode, vendorCode, deviceName, campusId, classroomId, apiEndpoint, requestIddeviceId, deviceStatus, bindStatus, classroomNamecampusId 与 classroomId 必填且必须一致；绑定教室停用或逻辑删除时不可启用
/api/v1/face/devices/{id}/classroom-bindingPATCHPC Web 到设备中心deviceId, campusId, classroomId, bindReason, requestIdbindStatus, oldClassroomId, newClassroomId, auditId换绑需校验同校区启用教室；换绑后人员下发范围和课次匹配规则同步刷新
/api/v1/face/student-photosPOST教师端/家长端/学员端到设备中心studentId, photoFileId, sourceTerminal, uploaderId, requestIdphotoVersion, qualityStatus, syncTaskId, nextActionstudentId + photoVersion 幂等；照片更新后自动解析课程、教室和目标设备
/api/v1/face/photo-sync-tasksGET/POST平台到设备中心studentId, photoVersion, courseScope, targetDeviceScope, requestIdsyncTaskId, targetDevices, dispatchSummary, syncStatus按学员有效课程、课程教室、教室设备自动生成目标设备清单
/api/v1/face/personsPOST/PATCH平台到设备网关personId, studentId, name, photoFileId, photoVersion, campusId, targetDeviceIdsdeviceTaskId, dispatchStatus, failedItemspersonId + deviceId + photoVersion 幂等；用于新增或更新照片
/api/v1/face/person-clearance-tasksPOST/GET平台到设备中心studentId, personId, triggerType, remainingHoursSnapshot, targetDeviceScope, requestIdclearanceTaskId, clearanceStatus, targetDevices, dispatchSummary课时耗尽/合同到期/权益终止触发；studentId + triggerType + targetDeviceScope 幂等
/api/v1/face/persons/{personId}/clearPOST平台到设备网关personId, studentId, deviceIds, clearanceTaskId, reason, requestIddeviceTaskId, clearanceStatus, failedItems仅由课时耗尽、合同到期或权益终止任务触发；设备离线进入待重试
/api/v1/face/eventsPOST设备到平台deviceId, deviceEventId, personId, eventTime, confidence, photoId, uploadMode, deviceCachedAtattendanceId, matchStatus, rightsCheckStatus, consumeResult, errorCode, errorMessage, matchedClassroomIddeviceId + deviceEventId 去重；先按设备绑定教室匹配课次，再校验权益与剩余课时，课时不足不生成课消
/api/v1/face/devices/{id}/heartbeatPOST设备到平台deviceId, appVersion, onlineStatus, metricsserverTime, commands设备签名校验
/api/v1/face/offline-events/syncPOST设备到平台deviceId, offlineBatchNo, events, firstCachedAt, lastCachedAtacceptedCount, duplicateCount, failedItems, lessonMatchSummary离线补传批次幂等；重复事件不重复签到或课消

前端约束

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

后端约束

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

集成约束

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

15 · 数据库与存储设计

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

详细 DDL 已在平台技术设计文档中统一展开，本处保留模块核心表、关键字段和索引方向。
表名用途核心字段索引建议
dev_face_device人脸识别考勤设备id、tenant_id、org_id、campus_id、created_by、created_at、updated_by、updated_at、is_deleted、deleted_at、deleted_by、version、device_code、vendor_code、device_name、classroom_id、api_endpoint、device_statusuk_device_code、idx_campus_classroom_status
dev_face_person人脸人员库id、tenant_id、org_id、campus_id、created_by、created_at、updated_by、updated_at、is_deleted、deleted_at、deleted_by、version、person_no、person_type、person_id、photo_file_id、photo_version、source_terminal、source_uploaded_at、valid_until、sync_statusuk_person_type_id、idx_sync
dev_face_dispatch_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、device_id、person_id、action_type、request_payload、response_payload、task_statusuk_task_no、idx_device_status
dev_face_photo_sync_task证件照更新同步任务id、tenant_id、org_id、campus_id、created_by、created_at、updated_by、updated_at、is_deleted、deleted_at、deleted_by、version、sync_no、student_id、photo_file_id、photo_version、source_terminal、course_scope、target_device_scope、sync_statusuk_sync_no、idx_student_status、idx_photo_version
dev_face_clearance_task课时耗尽人脸清除任务id、tenant_id、org_id、campus_id、created_by、created_at、updated_by、updated_at、is_deleted、deleted_at、deleted_by、version、clearance_no、student_id、person_id、trigger_type、remaining_hours_snapshot、target_device_scope、clearance_status、triggered_atuk_clearance_no、idx_student_status、idx_person_status
dev_face_event人脸识别回传事件id、tenant_id、org_id、campus_id、created_by、created_at、updated_by、updated_at、is_deleted、deleted_at、deleted_by、version、device_id、device_event_id、person_id、lesson_id、event_time、confidence、match_status、rights_check_status、consume_result、error_code、error_message、upload_mode、device_cached_at、raw_payloaduk_device_event、idx_lesson_person、idx_event_time

DDL 草案

dev_face_deviceFaceDevice 
CREATE TABLE `dev_face_device` (
  `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 '乐观锁版本号，写操作必须校验；数据级别：普通',
  `device_code` VARCHAR(64) NOT NULL COMMENT '设备编码，唯一；数据级别：普通',
  `vendor_code` VARCHAR(32) NOT NULL COMMENT '设备品牌/厂商；数据级别：普通',
  `device_name` VARCHAR(128) NOT NULL COMMENT '设备名称；数据级别：普通',
  `classroom_id` BIGINT NOT NULL COMMENT '绑定教室 ID，必须属于同一校区且教室未逻辑删除；数据级别：普通',
  `api_endpoint` VARCHAR(512) NULL COMMENT '设备或平台 API 地址；数据级别：普通',
  `device_status` VARCHAR(32) NOT NULL COMMENT '在线/离线/停用/异常；数据级别：普通',
  PRIMARY KEY (`id`),
  UNIQUE KEY `uk_device_code` (`device_code`),
  KEY `idx_campus_classroom_status` (`campus_id`, `classroom_id`, `device_status`),
  KEY `idx_tenant_deleted` (`tenant_id`, `is_deleted`)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_0900_ai_ci COMMENT='FaceDevice：人脸识别考勤设备';
dev_face_personFacePerson 
CREATE TABLE `dev_face_person` (
  `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 '乐观锁版本号，写操作必须校验；数据级别：普通',
  `person_no` VARCHAR(64) NOT NULL COMMENT '人员编号，唯一；数据级别：普通',
  `person_type` VARCHAR(32) NOT NULL COMMENT '学员/教师/员工；数据级别：普通',
  `person_id` BIGINT NOT NULL COMMENT '业务人员 ID；数据级别：普通',
  `photo_file_id` BIGINT NOT NULL COMMENT '人脸照片文件 ID；数据级别：高敏',
  `photo_version` INT NOT NULL COMMENT '证件照版本号，照片更新后递增；数据级别：普通',
  `source_terminal` VARCHAR(32) NOT NULL COMMENT '照片来源终端：教师端/家长端/学员端/后台；数据级别：普通',
  `source_uploaded_at` DATETIME NOT NULL COMMENT '来源照片上传时间；数据级别：普通',
  `valid_until` DATETIME NULL COMMENT '设备侧人员照片业务有效期；数据级别：普通',
  `sync_status` VARCHAR(32) NOT NULL COMMENT '未同步/待下发/已下发/待更新/待清除/已清除/失败；数据级别：普通',
  PRIMARY KEY (`id`),
  UNIQUE KEY `uk_person_type_id` (`person_no`, `person_type`, `id`),
  KEY `idx_sync` (`sync_status`),
  KEY `idx_tenant_deleted` (`tenant_id`, `is_deleted`)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_0900_ai_ci COMMENT='FacePerson：人脸人员库';
dev_face_dispatch_taskFaceDispatchTask 
CREATE TABLE `dev_face_dispatch_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 '任务编号，唯一；数据级别：普通',
  `device_id` BIGINT NOT NULL COMMENT '设备 ID；数据级别：普通',
  `person_id` BIGINT NOT NULL COMMENT '人员库 ID；数据级别：普通',
  `action_type` VARCHAR(32) NOT NULL COMMENT '新增/更新/清除/重试；数据级别：普通',
  `request_payload` JSON NOT NULL COMMENT '下发请求；数据级别：普通',
  `response_payload` JSON NULL COMMENT '设备响应；数据级别：普通',
  `task_status` VARCHAR(32) NOT NULL COMMENT '待执行/成功/失败/重试中/设备离线待重试；数据级别：普通',
  PRIMARY KEY (`id`),
  UNIQUE KEY `uk_task_no` (`task_no`),
  KEY `idx_device_status` (`device_id`, `task_status`),
  KEY `idx_tenant_deleted` (`tenant_id`, `is_deleted`)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_0900_ai_ci COMMENT='FaceDispatchTask：人脸下发任务';
dev_face_photo_sync_taskFacePhotoSyncTask 
CREATE TABLE `dev_face_photo_sync_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 '乐观锁版本号，写操作必须校验；数据级别：普通',
  `sync_no` VARCHAR(64) NOT NULL COMMENT '同步任务编号，唯一；数据级别：普通',
  `student_id` BIGINT NOT NULL COMMENT '学员 ID；数据级别：普通',
  `photo_file_id` BIGINT NOT NULL COMMENT '最新证件照文件 ID；数据级别：高敏',
  `photo_version` INT NOT NULL COMMENT '照片版本号；数据级别：普通',
  `source_terminal` VARCHAR(32) NOT NULL COMMENT '教师端/家长端/学员端/后台；数据级别：普通',
  `course_scope` JSON NOT NULL COMMENT '学员关联课程与班级范围快照；数据级别：普通',
  `target_device_scope` JSON NOT NULL COMMENT '由课程教室推导出的人脸设备范围；数据级别：普通',
  `sync_status` VARCHAR(32) NOT NULL COMMENT '待解析/待下发/部分成功/成功/失败/设备离线待重试；数据级别：普通',
  PRIMARY KEY (`id`),
  UNIQUE KEY `uk_sync_no` (`sync_no`),
  KEY `idx_student_status` (`student_id`, `sync_status`),
  KEY `idx_photo_version` (`photo_version`),
  KEY `idx_tenant_deleted` (`tenant_id`, `is_deleted`)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_0900_ai_ci COMMENT='FacePhotoSyncTask：证件照更新同步任务';
dev_face_clearance_taskFaceClearanceTask 
CREATE TABLE `dev_face_clearance_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 '乐观锁版本号，写操作必须校验；数据级别：普通',
  `clearance_no` VARCHAR(64) NOT NULL COMMENT '清除任务编号，唯一；数据级别：普通',
  `student_id` BIGINT NOT NULL COMMENT '学员 ID；数据级别：普通',
  `person_id` BIGINT NOT NULL COMMENT '人员库 ID；数据级别：普通',
  `trigger_type` VARCHAR(32) NOT NULL COMMENT '课时耗尽/合同到期/权益终止/人工重算；数据级别：普通',
  `remaining_hours_snapshot` DECIMAL(8,2) NOT NULL COMMENT '触发时剩余课时快照；数据级别：普通',
  `target_device_scope` JSON NOT NULL COMMENT '需要清除的人脸设备范围；数据级别：普通',
  `clearance_status` VARCHAR(32) NOT NULL COMMENT '待清除/清除中/部分成功/成功/失败/设备离线待重试；数据级别：普通',
  `triggered_at` DATETIME NOT NULL COMMENT '触发时间；数据级别：普通',
  PRIMARY KEY (`id`),
  UNIQUE KEY `uk_clearance_no` (`clearance_no`),
  KEY `idx_student_status` (`student_id`, `clearance_status`),
  KEY `idx_person_status` (`person_id`, `clearance_status`),
  KEY `idx_tenant_deleted` (`tenant_id`, `is_deleted`)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_0900_ai_ci COMMENT='FaceClearanceTask：课时耗尽人脸清除任务';
dev_face_eventFaceAttendanceEvent 
CREATE TABLE `dev_face_event` (
  `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 '乐观锁版本号，写操作必须校验；数据级别：普通',
  `device_id` BIGINT NOT NULL COMMENT '设备 ID；数据级别：普通',
  `device_event_id` VARCHAR(128) NOT NULL COMMENT '设备侧事件号；数据级别：普通',
  `person_id` BIGINT NULL COMMENT '匹配人员 ID；数据级别：普通',
  `lesson_id` BIGINT NULL COMMENT '匹配课次 ID；数据级别：普通',
  `event_time` DATETIME NOT NULL COMMENT '识别时间；数据级别：普通',
  `confidence` DECIMAL(8,4) NOT NULL COMMENT '识别置信度；数据级别：普通',
  `match_status` VARCHAR(32) NOT NULL COMMENT '已匹配/低置信/未匹配/重复；数据级别：普通',
  `rights_check_status` VARCHAR(32) NOT NULL COMMENT '通过/无有效权益/课时不足/合同到期；数据级别：普通',
  `consume_result` VARCHAR(32) NOT NULL COMMENT '未处理/已课消/不可课消/待人工确认；数据级别：普通',
  `error_code` VARCHAR(64) NULL COMMENT '不可课消错误码；数据级别：普通',
  `error_message` VARCHAR(255) NULL COMMENT '不可课消提示文案；数据级别：普通',
  `upload_mode` VARCHAR(32) NOT NULL COMMENT '实时上传/离线补传；数据级别：普通',
  `device_cached_at` DATETIME NULL COMMENT '设备离线缓存时间；数据级别：普通',
  `raw_payload` JSON NOT NULL COMMENT '设备原始报文；数据级别：敏感',
  PRIMARY KEY (`id`),
  UNIQUE KEY `uk_device_event` (`device_id`, `device_event_id`),
  KEY `idx_lesson_person` (`lesson_id`, `person_id`),
  KEY `idx_event_time` (`event_time`),
  KEY `idx_tenant_deleted` (`tenant_id`, `is_deleted`)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_0900_ai_ci COMMENT='FaceAttendanceEvent：人脸识别回传事件';

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

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

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

异常状态

低置信度设备离线跨校区识别设备未绑定教室设备跨校区绑定绑定教室已停用设备教室与课次不匹配证件照缺失证件照质量不合格学员课程未关联教室目标教室无考勤设备设备离线待补传离线补传重复事件无有效权益剩余课时不足课时耗尽待清除人脸清除设备离线

指标埋点

考勤设备教室绑定完整率设备在线率人员下发成功率识别成功率自动签到率课时不足打卡拦截率课时耗尽人脸清除成功率异常处理时长

测试用例

编号场景前置步骤预期优先级
TC-FAC-ROOM-001考勤设备必须绑定指定教室校区下已有启用教室新增人脸考勤设备时不选教室、选择停用教室、选择其他校区教室、选择同校区启用教室分别提交前三种被拦截并给出原因；同校区启用教室可保存并生成设备绑定审计高
TC-FAC-ROOM-002考勤事件按设备教室匹配课次考勤设备已绑定教室且该教室当前有课次模拟设备识别事件回调系统按设备绑定教室、时间窗口、学员名单匹配课次；未匹配或跨校区进入异常队列，不自动课消高
TC-003试听预约和反馈线索已分配并选择体验课预约试听、教师填写反馈客户状态更新，生成报价任务高
TC-005电子合同签署和收款合同模板启用生成合同、家长签署、支付合同已签署、订单已收款、权益生效高
TC-006合同监管备案失败重报监管接口模拟字段失败提交备案后修复字段重报失败回执保留，重报成功高
TC-007入班排课冲突校验教师同时间已有课程为同教师同时间排课系统拦截并提示冲突对象高
TC-008人脸签到自动课消学员已上传证件照、照片已下发到教室考勤设备且课次待签到模拟设备回传识别事件签到成功、课消成功、家长收到通知高
TC-009人脸未匹配异常设备回传未绑定人员提交识别事件进入异常队列，可人工确认或忽略高
TC-011学员端访问授权资源合同权益生效学员登录微信小程序或 App 打开课程资源资源可访问并记录学习进度，家长端仅查看学习报告摘要高
TC-013教师发布作业并批改课次已完成教师发布作业，学员提交，教师批改学员端展示批改结果和成长档案中
TC-015退费审批和监管退款合同有剩余权益提交退费、审批、模拟退款回执退款完成、课时冻结、收入和提成冲回高
TC-016内置凭证入账失败重推科目映射缺失生成凭证失败后补充科目并重推凭证编号回写，失败记录关闭高
TC-FAC-ENH-001设备闭环交付闭环验收设备列表、人员下发、识别流水、考勤异常相关基础数据、权限、审批流、消息模板和接口配置已初始化按补齐设备下发回执、低置信度识别、重复识别、人工复核、自动签到和课消联动。执行前端提交、后端处理、状态流转、异常重试和消息触达识别异常可人工确认，确认后同步教务考勤和课消状态。；同时产生审计日志、指标埋点和必要的补偿任务高
TC-FAC-ENH-002证件照更新同步交付闭环验收证件照更新同步队列、目标设备自动解析、设备回执相关基础数据、权限、审批流、消息模板和接口配置已初始化按补齐照片来源、照片版本、质量校验、课程教室设备解析、目标设备清单、下发任务、失败重试和审计。执行前端提交、后端处理、状态流转、异常重试和消息触达学员照片更新后可自动推导目标设备并完成新增或更新下发；不提供家长手动撤回入口，设备侧清除仅由课时耗尽、合同到期或权益终止规则触发。；同时产生审计日志、指标埋点和必要的补偿任务高
TC-FAC-ENH-003离线补传联动交付闭环验收设备离线打卡补传、识别流水、考勤异常相关基础数据、权限、审批流、消息模板和接口配置已初始化按补齐离线缓存、联网补传、事件去重、课次匹配、异常队列、自动签到和自动课消。执行前端提交、后端处理、状态流转、异常重试和消息触达设备恢复联网后离线记录可自动补传，重复事件不会重复签到或重复课消。；同时产生审计日志、指标埋点和必要的补偿任务高
TC-FAC-ENH-004权益课时校验交付闭环验收权益课时校验异常、识别流水、考勤异常相关基础数据、权限、审批流、消息模板和接口配置已初始化按补齐合同权益、剩余课时、课程有效期、可课消状态、错误码、设备提示、异常队列和消息通知。执行前端提交、后端处理、状态流转、异常重试和消息触达课时不足时打卡记录可追踪但不生成课消，设备或后台能明确提示不可课消原因。；同时产生审计日志、指标埋点和必要的补偿任务高
TC-FAC-ENH-005课时耗尽人脸清除交付闭环验收课时耗尽人脸清除队列、人员下发、设备回执相关基础数据、权限、审批流、消息模板和接口配置已初始化按补齐课消后余额复核、课时耗尽触发、人脸清除任务、设备回执、离线重试和人工处理。执行前端提交、后端处理、状态流转、异常重试和消息触达最后一次课消完成后自动清除目标设备上的学员人脸信息，并保留触发原因和回执。；同时产生审计日志、指标埋点和必要的补偿任务高
TC-FAC-ENH-006运维联动交付闭环验收设备告警、维修工单、资产详情相关基础数据、权限、审批流、消息模板和接口配置已初始化按补齐离线告警、维修工单、资产状态、恢复校验和影响课次范围。执行前端提交、后端处理、状态流转、异常重试和消息触达设备恢复后可自动回测签到、直播或录像相关能力。；同时产生审计日志、指标埋点和必要的补偿任务高
TC-FAC-ENH-007人力 Excel 反补：设备事件类型区分：学生上课考勤、员工上下班考勤。交付闭环验收设备事件类型区分：学生上课考勤、员工上下班考勤。相关列表、详情、表单、审批、消息、异常、审计和报表页面相关基础数据、权限、审批流、消息模板和接口配置已初始化按按《系统功能-人力-PRD完善方案》补齐设备事件类型区分：学生上课考勤、员工上下班考勤。相关功能、流程、角色终端、数据对象、接口、异常状态和验收口径。执行前端提交、后端处理、状态流转、异常重试和消息触达对应模块 PRD 的“人力 Excel 反补”章节、数据字段、接口技术、测试用例和初始化项均可追溯。；同时产生审计日志、指标埋点和必要的补偿任务高
TC-FAC-ENH-008人力 Excel 反补：设备离线缓存。交付闭环验收设备离线缓存。相关列表、详情、表单、审批、消息、异常、审计和报表页面相关基础数据、权限、审批流、消息模板和接口配置已初始化按按《系统功能-人力-PRD完善方案》补齐设备离线缓存。相关功能、流程、角色终端、数据对象、接口、异常状态和验收口径。执行前端提交、后端处理、状态流转、异常重试和消息触达对应模块 PRD 的“人力 Excel 反补”章节、数据字段、接口技术、测试用例和初始化项均可追溯。；同时产生审计日志、指标埋点和必要的补偿任务高
TC-FAC-ENH-009人力 Excel 反补：恢复联网后批量补传。交付闭环验收恢复联网后批量补传。相关列表、详情、表单、审批、消息、异常、审计和报表页面相关基础数据、权限、审批流、消息模板和接口配置已初始化按按《系统功能-人力-PRD完善方案》补齐恢复联网后批量补传。相关功能、流程、角色终端、数据对象、接口、异常状态和验收口径。执行前端提交、后端处理、状态流转、异常重试和消息触达对应模块 PRD 的“人力 Excel 反补”章节、数据字段、接口技术、测试用例和初始化项均可追溯。；同时产生审计日志、指标埋点和必要的补偿任务高
TC-FAC-ENH-010人力 Excel 反补：同步失败日志。交付闭环验收同步失败日志。相关列表、详情、表单、审批、消息、异常、审计和报表页面相关基础数据、权限、审批流、消息模板和接口配置已初始化按按《系统功能-人力-PRD完善方案》补齐同步失败日志。相关功能、流程、角色终端、数据对象、接口、异常状态和验收口径。执行前端提交、后端处理、状态流转、异常重试和消息触达对应模块 PRD 的“人力 Excel 反补”章节、数据字段、接口技术、测试用例和初始化项均可追溯。；同时产生审计日志、指标埋点和必要的补偿任务高
TC-FAC-ENH-011人力 Excel 反补：设备事件去重。交付闭环验收设备事件去重。相关列表、详情、表单、审批、消息、异常、审计和报表页面相关基础数据、权限、审批流、消息模板和接口配置已初始化按按《系统功能-人力-PRD完善方案》补齐设备事件去重。相关功能、流程、角色终端、数据对象、接口、异常状态和验收口径。执行前端提交、后端处理、状态流转、异常重试和消息触达对应模块 PRD 的“人力 Excel 反补”章节、数据字段、接口技术、测试用例和初始化项均可追溯。；同时产生审计日志、指标埋点和必要的补偿任务高
TC-FAC-ENH-012人力 Excel 反补：员工打卡设备采集打卡事件。交付闭环验收员工打卡设备采集打卡事件。相关列表、详情、表单、审批、消息、异常、审计和报表页面相关基础数据、权限、审批流、消息模板和接口配置已初始化按按《系统功能-人力-PRD完善方案》补齐员工打卡设备采集打卡事件。相关功能、流程、角色终端、数据对象、接口、异常状态和验收口径。执行前端提交、后端处理、状态流转、异常重试和消息触达对应模块 PRD 的“人力 Excel 反补”章节、数据字段、接口技术、测试用例和初始化项均可追溯。；同时产生审计日志、指标埋点和必要的补偿任务高
TC-FAC-ENH-013人力 Excel 反补：离线时本地缓存。交付闭环验收离线时本地缓存。相关列表、详情、表单、审批、消息、异常、审计和报表页面相关基础数据、权限、审批流、消息模板和接口配置已初始化按按《系统功能-人力-PRD完善方案》补齐离线时本地缓存。相关功能、流程、角色终端、数据对象、接口、异常状态和验收口径。执行前端提交、后端处理、状态流转、异常重试和消息触达对应模块 PRD 的“人力 Excel 反补”章节、数据字段、接口技术、测试用例和初始化项均可追溯。；同时产生审计日志、指标埋点和必要的补偿任务高
TC-FAC-ENH-014人力 Excel 反补：联网后推送到设备中心。交付闭环验收联网后推送到设备中心。相关列表、详情、表单、审批、消息、异常、审计和报表页面相关基础数据、权限、审批流、消息模板和接口配置已初始化按按《系统功能-人力-PRD完善方案》补齐联网后推送到设备中心。相关功能、流程、角色终端、数据对象、接口、异常状态和验收口径。执行前端提交、后端处理、状态流转、异常重试和消息触达对应模块 PRD 的“人力 Excel 反补”章节、数据字段、接口技术、测试用例和初始化项均可追溯。；同时产生审计日志、指标埋点和必要的补偿任务高

上线初始化

初始化项动作数据验收
设备参数登记人脸考勤机设备和校区绑定设备编号、位置、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排课和补课安排可准确拦截教室冲突、停用和容量不足
组织与校区导入集团、品牌、法人主体、区域、校区、部门、岗位总部组织树、校区编码、法人关系、营业时间组织层级正确且权限可继承
账号与权限初始化总部、区域、校区、顾问、教务、教师、财务、家长、学员角色账号、角色、菜单、按钮、字段、数据范围测试账号可按角色访问指定页面
课程与价格导入课程、班型、课包、课时、价格、适用校区课程编码、班型、价格表、有效期、赠课规则报价和合同可正确引用价格
优惠规则初始化折扣、满减、优惠券、老带新、多科联报和组合包规则规则编码、叠加互斥、适用课程、校区、有效期、审批阈值报价单可正确计算并生成分摊明细
财务科目配置收款、预收、课消收入、退费、薪资、报销和内置科目映射科目、辅助核算、校区、项目、部门凭证可生成并写入测试账套
多账套会计按校区初始化独立账套、会计期间、凭证字、科目和税务参数账套编码、法人主体、校区、期间、税种、申报模板校区账套可独立记账，总部可汇总和复核
监管账户维护资金监管账户和教育局监管平台参数账户编号、校区映射、接口地址、证书、回调合同、收款、课消、退费可报送测试
设备闭环交付配置初始化补齐设备下发回执、低置信度识别、重复识别、人工复核、自动签到和课消联动。所需的页面入口、功能开关、审批流、消息模板、状态枚举、异常原因和角色权限设备列表、人员下发、识别流水、考勤异常识别异常可人工确认，确认后同步教务考勤和课消状态。
证件照更新同步交付配置初始化补齐照片来源、照片版本、质量校验、课程教室设备解析、目标设备清单、下发任务、失败重试和审计。所需的页面入口、功能开关、审批流、消息模板、状态枚举、异常原因和角色权限证件照更新同步队列、目标设备自动解析、设备回执学员照片更新后可自动推导目标设备并完成新增或更新下发；不提供家长手动撤回入口，设备侧清除仅由课时耗尽、合同到期或权益终止规则触发。
离线补传联动交付配置初始化补齐离线缓存、联网补传、事件去重、课次匹配、异常队列、自动签到和自动课消。所需的页面入口、功能开关、审批流、消息模板、状态枚举、异常原因和角色权限设备离线打卡补传、识别流水、考勤异常设备恢复联网后离线记录可自动补传，重复事件不会重复签到或重复课消。
权益课时校验交付配置初始化补齐合同权益、剩余课时、课程有效期、可课消状态、错误码、设备提示、异常队列和消息通知。所需的页面入口、功能开关、审批流、消息模板、状态枚举、异常原因和角色权限权益课时校验异常、识别流水、考勤异常课时不足时打卡记录可追踪但不生成课消，设备或后台能明确提示不可课消原因。
课时耗尽人脸清除交付配置初始化补齐课消后余额复核、课时耗尽触发、人脸清除任务、设备回执、离线重试和人工处理。所需的页面入口、功能开关、审批流、消息模板、状态枚举、异常原因和角色权限课时耗尽人脸清除队列、人员下发、设备回执最后一次课消完成后自动清除目标设备上的学员人脸信息，并保留触发原因和回执。
运维联动交付配置初始化补齐离线告警、维修工单、资产状态、恢复校验和影响课次范围。所需的页面入口、功能开关、审批流、消息模板、状态枚举、异常原因和角色权限设备告警、维修工单、资产详情设备恢复后可自动回测签到、直播或录像相关能力。
人力 Excel 反补：设备事件类型区分：学生上课考勤、员工上下班考勤。交付配置初始化按《系统功能-人力-PRD完善方案》补齐设备事件类型区分：学生上课考勤、员工上下班考勤。相关功能、流程、角色终端、数据对象、接口、异常状态和验收口径。所需的页面入口、功能开关、审批流、消息模板、状态枚举、异常原因和角色权限设备事件类型区分：学生上课考勤、员工上下班考勤。相关列表、详情、表单、审批、消息、异常、审计和报表页面对应模块 PRD 的“人力 Excel 反补”章节、数据字段、接口技术、测试用例和初始化项均可追溯。
人力 Excel 反补：设备离线缓存。交付配置初始化按《系统功能-人力-PRD完善方案》补齐设备离线缓存。相关功能、流程、角色终端、数据对象、接口、异常状态和验收口径。所需的页面入口、功能开关、审批流、消息模板、状态枚举、异常原因和角色权限设备离线缓存。相关列表、详情、表单、审批、消息、异常、审计和报表页面对应模块 PRD 的“人力 Excel 反补”章节、数据字段、接口技术、测试用例和初始化项均可追溯。
人力 Excel 反补：恢复联网后批量补传。交付配置初始化按《系统功能-人力-PRD完善方案》补齐恢复联网后批量补传。相关功能、流程、角色终端、数据对象、接口、异常状态和验收口径。所需的页面入口、功能开关、审批流、消息模板、状态枚举、异常原因和角色权限恢复联网后批量补传。相关列表、详情、表单、审批、消息、异常、审计和报表页面对应模块 PRD 的“人力 Excel 反补”章节、数据字段、接口技术、测试用例和初始化项均可追溯。
人力 Excel 反补：同步失败日志。交付配置初始化按《系统功能-人力-PRD完善方案》补齐同步失败日志。相关功能、流程、角色终端、数据对象、接口、异常状态和验收口径。所需的页面入口、功能开关、审批流、消息模板、状态枚举、异常原因和角色权限同步失败日志。相关列表、详情、表单、审批、消息、异常、审计和报表页面对应模块 PRD 的“人力 Excel 反补”章节、数据字段、接口技术、测试用例和初始化项均可追溯。
人力 Excel 反补：设备事件去重。交付配置初始化按《系统功能-人力-PRD完善方案》补齐设备事件去重。相关功能、流程、角色终端、数据对象、接口、异常状态和验收口径。所需的页面入口、功能开关、审批流、消息模板、状态枚举、异常原因和角色权限设备事件去重。相关列表、详情、表单、审批、消息、异常、审计和报表页面对应模块 PRD 的“人力 Excel 反补”章节、数据字段、接口技术、测试用例和初始化项均可追溯。
人力 Excel 反补：员工打卡设备采集打卡事件。交付配置初始化按《系统功能-人力-PRD完善方案》补齐员工打卡设备采集打卡事件。相关功能、流程、角色终端、数据对象、接口、异常状态和验收口径。所需的页面入口、功能开关、审批流、消息模板、状态枚举、异常原因和角色权限员工打卡设备采集打卡事件。相关列表、详情、表单、审批、消息、异常、审计和报表页面对应模块 PRD 的“人力 Excel 反补”章节、数据字段、接口技术、测试用例和初始化项均可追溯。
人力 Excel 反补：离线时本地缓存。交付配置初始化按《系统功能-人力-PRD完善方案》补齐离线时本地缓存。相关功能、流程、角色终端、数据对象、接口、异常状态和验收口径。所需的页面入口、功能开关、审批流、消息模板、状态枚举、异常原因和角色权限离线时本地缓存。相关列表、详情、表单、审批、消息、异常、审计和报表页面对应模块 PRD 的“人力 Excel 反补”章节、数据字段、接口技术、测试用例和初始化项均可追溯。
人力 Excel 反补：联网后推送到设备中心。交付配置初始化按《系统功能-人力-PRD完善方案》补齐联网后推送到设备中心。相关功能、流程、角色终端、数据对象、接口、异常状态和验收口径。所需的页面入口、功能开关、审批流、消息模板、状态枚举、异常原因和角色权限联网后推送到设备中心。相关列表、详情、表单、审批、消息、异常、审计和报表页面对应模块 PRD 的“人力 Excel 反补”章节、数据字段、接口技术、测试用例和初始化项均可追溯。