01 · 模块定位
智能考勤设备中心
测试学员扫脸后系统生成签到记录、自动扣课时；异常识别进入待处理队列。业务目标
打通人脸识别考勤机，实现人员下发、识别回传、自动签到、自动消课和异常队列。
使用终端
PC Web 设备管理端、人脸考勤机 API、家长端授权入口。
验收主线
测试学员扫脸后系统生成签到记录、自动扣课时；异常识别进入待处理队列。
02 · 范围边界
明确本模块负责什么、依赖什么、不负责什么
边界清晰后，原型、接口和数据库设计才能避免重复建设。模块内范围
- 设备档案
- 人员下发
- 识别流水
- 异常队列
- 人脸授权
- 设备日志
- 人脸授权撤回确认
- 设备模板删除任务
- 撤回失败重试
- 隐私审计
上游依赖
- 组织校区与账号权限
- 课程/客户/合同等主数据
- 审批流、消息模板、文件中心
- 必要的第三方接口密钥
下游输出
- 业务状态和待办
- 消息通知和审批记录
- 报表指标和数据快照
- 审计日志和接口回执
03 · 确认口径、后台配置与默认实施规则
智能考勤设备中心必须承接的已确认规则
本章节来自待决策与澄清清单的收口结果，已经转为本模块 PRD 的正式需求、配置项或默认实施规则。| 分类 | 事项 | 本模块落地要求 | 责任方 |
|---|---|---|---|
| 默认实施规则 | 接口设计说明书组织方式 | 采用单独 HTML 文件集中管理接口协议；模块 PRD 保留模块级接口摘要，避免每个模块重复写通用协议。 | 产品/研发 |
| 默认实施规则 | 接口错误码与重试中间件 | 所有外部接口和内部异步任务统一错误码、幂等键、重试次数、告警阈值和回执归档策略。 | 后端/测试/运维 |
04 · 业务流程
智能考勤设备中心主流程
流程用于指导原型图的页面顺序、按钮状态和异常分支。01设备档案
设备档案需覆盖入口、字段、状态、权限、审批/消息、异常处理、审计和指标统计，并与上下游模块保持数据一致。
02人员下发
人员下发包含学员、教师、员工、人脸照片、有效期和校区权限
03识别流水
识别流水需覆盖入口、字段、状态、权限、审批/消息、异常处理、审计和指标统计，并与上下游模块保持数据一致。
04异常队列
异常队列需覆盖入口、字段、状态、权限、审批/消息、异常处理、审计和指标统计，并与上下游模块保持数据一致。
05人脸授权
人脸授权撤回需由家长确认后生成设备侧模板删除任务，设备离线时进入延迟删除队列，删除回执、失败重试和人工处理必须留痕。
06设备日志
设备日志需覆盖入口、字段、状态、权限、审批/消息、异常处理、审计和指标统计，并与上下游模块保持数据一致。
07人脸授权撤回确认
人脸授权撤回确认需覆盖入口、字段、状态、权限、审批/消息、异常处理、审计和指标统计，并与上下游模块保持数据一致。
08设备模板删除任务
设备模板删除任务需覆盖入口、字段、状态、权限、审批/消息、异常处理、审计和指标统计，并与上下游模块保持数据一致。
05 · 功能清单
按子模块拆到可设计、可开发、可测试的颗粒度
每一行功能都需要在原型中体现入口、状态、按钮、字段和反馈。| 一级功能 | 二级功能 | 功能说明 | 规则/验收 |
|---|---|---|---|
| 设备档案 | 基础维护 | 设备档案支持新增、编辑、启用/停用、查询、导入导出和操作审计。 | 编码唯一、数据范围过滤、逻辑删除和审计留痕 |
| 设备档案 | 业务处理 | 设备档案需覆盖入口、字段、状态、权限、审批/消息、异常处理、审计和指标统计，并与上下游模块保持数据一致。 | 必须联动状态、权限、消息、审批和指标 |
| 设备档案 | 异常闭环 | 低置信度处理 | 失败原因可见、可重试、可转人工、可追溯 |
| 人员下发 | 基础维护 | 人员下发支持新增、编辑、启用/停用、查询、导入导出和操作审计。 | 编码唯一、数据范围过滤、逻辑删除和审计留痕 |
| 人员下发 | 业务处理 | 人员下发包含学员、教师、员工、人脸照片、有效期和校区权限 | 必须联动状态、权限、消息、审批和指标 |
| 人员下发 | 异常闭环 | 设备离线处理 | 失败原因可见、可重试、可转人工、可追溯 |
| 识别流水 | 基础维护 | 识别流水支持新增、编辑、启用/停用、查询、导入导出和操作审计。 | 编码唯一、数据范围过滤、逻辑删除和审计留痕 |
| 识别流水 | 业务处理 | 识别流水需覆盖入口、字段、状态、权限、审批/消息、异常处理、审计和指标统计，并与上下游模块保持数据一致。 | 必须联动状态、权限、消息、审批和指标 |
| 识别流水 | 异常闭环 | 跨校区识别处理 | 失败原因可见、可重试、可转人工、可追溯 |
| 异常队列 | 基础维护 | 异常队列支持新增、编辑、启用/停用、查询、导入导出和操作审计。 | 编码唯一、数据范围过滤、逻辑删除和审计留痕 |
| 异常队列 | 业务处理 | 异常队列需覆盖入口、字段、状态、权限、审批/消息、异常处理、审计和指标统计，并与上下游模块保持数据一致。 | 必须联动状态、权限、消息、审批和指标 |
| 异常队列 | 异常闭环 | 设备离线延迟删除处理 | 失败原因可见、可重试、可转人工、可追溯 |
| 人脸授权 | 基础维护 | 人脸授权支持新增、编辑、启用/停用、查询、导入导出和操作审计。 | 编码唯一、数据范围过滤、逻辑删除和审计留痕 |
| 人脸授权 | 业务处理 | 人脸授权撤回需由家长确认后生成设备侧模板删除任务，设备离线时进入延迟删除队列，删除回执、失败重试和人工处理必须留痕。 | 必须联动状态、权限、消息、审批和指标 |
| 人脸授权 | 异常闭环 | 模板删除失败处理 | 失败原因可见、可重试、可转人工、可追溯 |
| 设备日志 | 基础维护 | 设备日志支持新增、编辑、启用/停用、查询、导入导出和操作审计。 | 编码唯一、数据范围过滤、逻辑删除和审计留痕 |
| 设备日志 | 业务处理 | 设备日志需覆盖入口、字段、状态、权限、审批/消息、异常处理、审计和指标统计，并与上下游模块保持数据一致。 | 必须联动状态、权限、消息、审批和指标 |
| 设备日志 | 异常闭环 | 撤回回执缺失处理 | 失败原因可见、可重试、可转人工、可追溯 |
| 人脸授权撤回确认 | 基础维护 | 人脸授权撤回确认支持新增、编辑、启用/停用、查询、导入导出和操作审计。 | 编码唯一、数据范围过滤、逻辑删除和审计留痕 |
| 人脸授权撤回确认 | 业务处理 | 人脸授权撤回确认需覆盖入口、字段、状态、权限、审批/消息、异常处理、审计和指标统计，并与上下游模块保持数据一致。 | 必须联动状态、权限、消息、审批和指标 |
| 人脸授权撤回确认 | 异常闭环 | 家长确认超时处理 | 失败原因可见、可重试、可转人工、可追溯 |
| 设备模板删除任务 | 基础维护 | 设备模板删除任务支持新增、编辑、启用/停用、查询、导入导出和操作审计。 | 编码唯一、数据范围过滤、逻辑删除和审计留痕 |
| 设备模板删除任务 | 业务处理 | 设备模板删除任务需覆盖入口、字段、状态、权限、审批/消息、异常处理、审计和指标统计，并与上下游模块保持数据一致。 | 必须联动状态、权限、消息、审批和指标 |
| 设备模板删除任务 | 异常闭环 | 低置信度处理 | 失败原因可见、可重试、可转人工、可追溯 |
| 撤回失败重试 | 基础维护 | 撤回失败重试支持新增、编辑、启用/停用、查询、导入导出和操作审计。 | 编码唯一、数据范围过滤、逻辑删除和审计留痕 |
| 撤回失败重试 | 业务处理 | 撤回失败重试需覆盖入口、字段、状态、权限、审批/消息、异常处理、审计和指标统计，并与上下游模块保持数据一致。 | 必须联动状态、权限、消息、审批和指标 |
| 撤回失败重试 | 异常闭环 | 设备离线处理 | 失败原因可见、可重试、可转人工、可追溯 |
| 隐私审计 | 基础维护 | 隐私审计支持新增、编辑、启用/停用、查询、导入导出和操作审计。 | 编码唯一、数据范围过滤、逻辑删除和审计留痕 |
| 隐私审计 | 业务处理 | 隐私审计需覆盖入口、字段、状态、权限、审批/消息、异常处理、审计和指标统计，并与上下游模块保持数据一致。 | 必须联动状态、权限、消息、审批和指标 |
| 隐私审计 | 异常闭环 | 跨校区识别处理 | 失败原因可见、可重试、可转人工、可追溯 |
功能到数据对象/接口/表映射
| 功能域 | 承接对象 | 核心表 | 代表接口 | 状态机/状态字段 | 研发落地校验 |
|---|---|---|---|---|---|
| 设备档案 | FaceDevice、FacePerson、FaceDispatchTask、FaceAttendanceEvent | dev_face_device、dev_face_person、dev_face_dispatch_task、dev_face_event | 接口资源组 /api/v1/fac/features/01 | device_status、person_type、sync_status、action_type、task_status、match_status | 新增/编辑/删除/审批/导出/回调均需校验租户、校区、角色、数据范围、逻辑删除、幂等和审计 |
| 人员下发 | FaceDevice、FacePerson、FaceDispatchTask、FaceAttendanceEvent | dev_face_device、dev_face_person、dev_face_dispatch_task、dev_face_event | 接口资源组 /api/v1/fac/features/02 | device_status、person_type、sync_status、action_type、task_status、match_status | 新增/编辑/删除/审批/导出/回调均需校验租户、校区、角色、数据范围、逻辑删除、幂等和审计 |
| 识别流水 | FaceDevice、FacePerson、FaceDispatchTask、FaceAttendanceEvent | dev_face_device、dev_face_person、dev_face_dispatch_task、dev_face_event | 接口资源组 /api/v1/fac/features/03 | device_status、person_type、sync_status、action_type、task_status、match_status | 新增/编辑/删除/审批/导出/回调均需校验租户、校区、角色、数据范围、逻辑删除、幂等和审计 |
| 异常队列 | FaceDevice、FacePerson、FaceDispatchTask、FaceAttendanceEvent | dev_face_device、dev_face_person、dev_face_dispatch_task、dev_face_event | 接口资源组 /api/v1/fac/features/04 | device_status、person_type、sync_status、action_type、task_status、match_status | 新增/编辑/删除/审批/导出/回调均需校验租户、校区、角色、数据范围、逻辑删除、幂等和审计 |
| 人脸授权 | FaceAuthorizationRevokeTask | dev_face_revoke_task | 接口资源组 /api/v1/fac/features/05 | revoke_status | 新增/编辑/删除/审批/导出/回调均需校验租户、校区、角色、数据范围、逻辑删除、幂等和审计 |
| 设备日志 | FaceDevice、FacePerson、FaceDispatchTask、FaceAttendanceEvent | dev_face_device、dev_face_person、dev_face_dispatch_task、dev_face_event | 接口资源组 /api/v1/fac/features/06 | device_status、person_type、sync_status、action_type、task_status、match_status | 新增/编辑/删除/审批/导出/回调均需校验租户、校区、角色、数据范围、逻辑删除、幂等和审计 |
| 人脸授权撤回确认 | FaceDevice、FacePerson、FaceDispatchTask、FaceAttendanceEvent | dev_face_device、dev_face_person、dev_face_dispatch_task、dev_face_event | 接口资源组 /api/v1/fac/features/07 | device_status、person_type、sync_status、action_type、task_status、match_status | 新增/编辑/删除/审批/导出/回调均需校验租户、校区、角色、数据范围、逻辑删除、幂等和审计 |
| 设备模板删除任务 | FaceDevice、FacePerson、FaceDispatchTask、FaceAttendanceEvent | dev_face_device、dev_face_person、dev_face_dispatch_task、dev_face_event | 接口资源组 /api/v1/fac/features/08 | device_status、person_type、sync_status、action_type、task_status、match_status | 新增/编辑/删除/审批/导出/回调均需校验租户、校区、角色、数据范围、逻辑删除、幂等和审计 |
| 撤回失败重试 | FaceDevice、FacePerson、FaceDispatchTask、FaceAttendanceEvent | dev_face_device、dev_face_person、dev_face_dispatch_task、dev_face_event | 接口资源组 /api/v1/fac/features/09 | device_status、person_type、sync_status、action_type、task_status、match_status | 新增/编辑/删除/审批/导出/回调均需校验租户、校区、角色、数据范围、逻辑删除、幂等和审计 |
| 隐私审计 | FaceDevice、FacePerson、FaceDispatchTask、FaceAttendanceEvent | dev_face_device、dev_face_person、dev_face_dispatch_task、dev_face_event | 接口资源组 /api/v1/fac/features/10 | device_status、person_type、sync_status、action_type、task_status、match_status | 新增/编辑/删除/审批/导出/回调均需校验租户、校区、角色、数据范围、逻辑删除、幂等和审计 |
06 · 原子级功能需求
用于研发任务拆分和测试用例追踪
需求编号可直接进入项目管理工具。| 编号 | 需求描述 | 入口页面 | 关键动作 | 输入校验 | 输出结果 | 异常处理 | 验收标准 |
|---|---|---|---|---|---|---|---|
| FR-FAC-001 | 设备需支持 API 二次开发、人员照片下发、识别事件回传和心跳 | 设备档案 | 设备建档 | 校验租户、校区、角色、数据范围、状态前置、必填、唯一和敏感操作授权 | 生成业务记录、状态流转、消息通知、审计日志、指标快照和必要的第三方任务 | 低置信度 | 主流程、异常流、权限流、接口失败和数据一致性均可通过测试 |
| FR-FAC-002 | 人员下发包含学员、教师、员工、人脸照片、有效期和校区权限 | 人脸授权撤回任务 | 授权撤回、模板删除或失败重试 | 校验租户、校区、角色、数据范围、状态前置、必填、唯一和敏感操作授权 | 生成业务记录、状态流转、消息通知、审计日志、指标快照和必要的第三方任务 | 设备离线、删除回执缺失或模板删除失败 | 主流程、异常流、权限流、接口失败和数据一致性均可通过测试 |
| FR-FAC-003 | 识别事件按学生、校区、课表、时间窗口、班级和课程匹配课次 | 人脸授权撤回任务 | 事件回传 | 校验租户、校区、角色、数据范围、状态前置、必填、唯一和敏感操作授权 | 生成业务记录、状态流转、消息通知、审计日志、指标快照和必要的第三方任务 | 跨校区识别 | 主流程、异常流、权限流、接口失败和数据一致性均可通过测试 |
| FR-FAC-004 | 低置信度、未匹配、重复识别、跨校识别进入人工确认 | 设备列表 | 异常确认 | 校验租户、校区、角色、数据范围、状态前置、必填、唯一和敏感操作授权 | 生成业务记录、状态流转、消息通知、审计日志、指标快照和必要的第三方任务 | 设备离线延迟删除 | 主流程、异常流、权限流、接口失败和数据一致性均可通过测试 |
| FR-FAC-005 | 家长授权、撤回授权、删除人脸和操作审计完整留痕 | 敏感字段查看审批 | 明文查看申请、临时授权或过期回收 | 校验租户、校区、角色、数据范围、状态前置、必填、唯一和敏感操作授权 | 生成业务记录、状态流转、消息通知、审计日志、指标快照和必要的第三方任务 | 审批原因缺失、越权查看或水印生成失败 | 主流程、异常流、权限流、接口失败和数据一致性均可通过测试 |
| FR-FAC-006 | 人脸授权撤回需由家长确认后生成设备侧模板删除任务，设备离线时进入延迟删除队列，删除回执、失败重试和人工处理必须留痕。 | 敏感字段查看审批 | 明文查看申请、临时授权或过期回收 | 校验租户、校区、角色、数据范围、状态前置、必填、唯一和敏感操作授权 | 生成业务记录、状态流转、消息通知、审计日志、指标快照和必要的第三方任务 | 审批原因缺失、越权查看或水印生成失败 | 主流程、异常流、权限流、接口失败和数据一致性均可通过测试 |
| FR-FAC-007 | 人脸授权撤回后需同步停止人脸签到匹配，保留隐私授权审计和设备删除回执。 | 敏感字段查看审批 | 明文查看申请、临时授权或过期回收 | 校验租户、校区、角色、数据范围、状态前置、必填、唯一和敏感操作授权 | 生成业务记录、状态流转、消息通知、审计日志、指标快照和必要的第三方任务 | 审批原因缺失、越权查看或水印生成失败 | 主流程、异常流、权限流、接口失败和数据一致性均可通过测试 |
07 · 关联闭环补充需求
智能考勤设备中心在跨模块闭环中的责任边界
本章节承接最终闭环核对清单，明确本模块需要补齐的页面、接口对象、异常兜底和验收口径。| 闭环项 | 本模块责任 | 关键场景 | 页面/功能补充 | 关联对象/接口 | 验收口径 |
|---|---|---|---|---|---|
| 设备维修工单 | 考勤机离线、识别异常或模板下发失败时生成设备异常线索 | 人脸考勤设备故障影响签到、课消和到访接待 | 设备状态、识别事件、异常上报、维修工单入口 | Device/FaceAttendanceEvent、AssetLifecycle/Maintenance | 设备异常必须能转维修工单并回写处理结果 |
08 · 页面与原型设计说明
页面清单、布局要求、按钮字段和状态
原型图设计需要覆盖列表、详情、表单、弹窗、空状态、异常状态和权限状态。| 终端 | 页面 | 用户 | 页面目标 | 布局结构 | 关键按钮 | 关键字段 | 异常状态 | 原型备注 |
|---|---|---|---|---|---|---|---|---|
| PC Web | 设备档案 | 设备管理员 | 维护设备、校区、在线状态、心跳 | 设备页按校区、设备、人员、事件四层组织，识别流水支持照片、置信度、课次匹配和异常处理入口。 | 新增设备、人员下发、查看心跳、确认异常、撤回授权、重试下发、查看回执 | 设备编号、设备品牌、所属校区、人员编号、人脸照片、置信度、匹配课次、删除回执、绑定教室、在线状态 | 设备离线、人员下发失败、低置信度、跨校区识别、模板删除失败、回执缺失 | 需覆盖设备在线/离线、人员模板下发、识别异常确认、家长撤回授权、设备离线延迟删除和隐私审计。 建议 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 | 考勤异常 | 授权用户 | 围绕设备闭环完善考勤异常的入口、字段、状态、异常提示、处理进度和验收反馈 | PC 端采用顶部筛选、左侧列表或导航、中部主工作区、右侧详情抽屉，复杂操作进入弹窗或步骤条。 | 查询、新增、编辑、提交、导出、查看日志、设备建档、人员下发 | 设备编号、设备品牌、所属校区、绑定教室、在线状态、人员下发状态、识别置信度、回执状态 | 空数据、无权限、加载失败、保存失败、审批驳回、批量部分失败 | 管理员端沿用统一框架，原型重点标注信息架构、表单弹窗、状态流和异常处理。 建议 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 | 资产详情 | 授权用户 | 围绕运维联动完善资产详情的入口、字段、状态、异常提示、处理进度和验收反馈 | 资产库存页采用左侧分类树、顶部仓库/校区筛选、中部台账表格，详情抽屉展示流水、成本、责任人和审计。 | 新增 SKU、采购申请、验收入库、领用出库、调拨、盘点、报损报废、维修派工 | 物料编码、分类、仓库/校区、库存数量、批次成本、供应商、责任人、盘点差异、设备编号、设备品牌 | 库存不足、编码重复、入库差异、责任人缺失、维修超期、成本调整失败 | 需覆盖图书仅进销存、固定资产责任人变更、维修工单、礼品库存、成本策略和财务凭证联动。 建议 Figma Frame：FAC-资产详情；需补齐正常、空态、加载、无权限、处理中、成功和失败状态。 |
09 · 页面到接口的前后端闭环矩阵
把原型页面、后端接口、数据对象、状态和消息审批绑定到一起
设计原型时，每个关键页面必须能解释前端展示什么、后端提交什么、状态怎么变、异常怎么处理。| 原型页面 | 关键接口 | 关联对象 | 状态流 | 审批/权限触发 | 消息/待办触达 | 原型验收要求 |
|---|---|---|---|---|---|---|
| 设备档案 | POST /api/v1/face/persons | FaceDevice | 未授权 -> 待采集 -> 已授权 -> 已下发 -> 撤回中 -> 已撤回 -> 已删除 | 人脸授权撤回处理：家长撤回人脸授权 | 处理完成、失败和异常转人工均需触发站内通知或待办 | 原型需展示入口、主按钮、禁用原因、提交中、成功、失败、无权限、空状态和异常转人工入口 |
| 识别流水 | POST /api/v1/face/events | FacePerson | 已提交 -> 家长已确认 -> 设备删除中 -> 部分失败 -> 已删除 -> 人工处理 -> 已关闭 | 人脸授权撤回处理：家长撤回人脸授权 | 处理完成、失败和异常转人工均需触发站内通知或待办 | 原型需展示入口、主按钮、禁用原因、提交中、成功、失败、无权限、空状态和异常转人工入口 |
| 人脸授权撤回任务 | POST /api/v1/face/devices/{id}/heartbeat | FaceDispatchTask | 未授权 -> 待采集 -> 已授权 -> 已下发 -> 撤回中 -> 已撤回 -> 已删除 | 人脸授权撤回处理：家长撤回人脸授权 | 处理完成、失败和异常转人工均需触发站内通知或待办 | 原型需展示入口、主按钮、禁用原因、提交中、成功、失败、无权限、空状态和异常转人工入口 |
| 设备列表 | POST /api/v1/face/authorizations/{id}/revoke | FaceAttendanceEvent | 已提交 -> 家长已确认 -> 设备删除中 -> 部分失败 -> 已删除 -> 人工处理 -> 已关闭 | 人脸授权撤回处理：家长撤回人脸授权 | 处理完成、失败和异常转人工均需触发站内通知或待办 | 原型需展示入口、主按钮、禁用原因、提交中、成功、失败、无权限、空状态和异常转人工入口 |
| 人员下发 | POST /api/v1/face/persons | FaceAuthorizationRevokeTask | 未授权 -> 待采集 -> 已授权 -> 已下发 -> 撤回中 -> 已撤回 -> 已删除 | 人脸授权撤回处理：家长撤回人脸授权 | 处理完成、失败和异常转人工均需触发站内通知或待办 | 原型需展示入口、主按钮、禁用原因、提交中、成功、失败、无权限、空状态和异常转人工入口 |
| 考勤异常 | POST /api/v1/face/events | FaceDevice | 已提交 -> 家长已确认 -> 设备删除中 -> 部分失败 -> 已删除 -> 人工处理 -> 已关闭 | 人脸授权撤回处理：家长撤回人脸授权 | 处理完成、失败和异常转人工均需触发站内通知或待办 | 原型需展示入口、主按钮、禁用原因、提交中、成功、失败、无权限、空状态和异常转人工入口 |
| 人脸授权详情 | POST /api/v1/face/devices/{id}/heartbeat | FacePerson | 未授权 -> 待采集 -> 已授权 -> 已下发 -> 撤回中 -> 已撤回 -> 已删除 | 人脸授权撤回处理：家长撤回人脸授权 | 处理完成、失败和异常转人工均需触发站内通知或待办 | 原型需展示入口、主按钮、禁用原因、提交中、成功、失败、无权限、空状态和异常转人工入口 |
| 撤回任务 | POST /api/v1/face/authorizations/{id}/revoke | FaceDispatchTask | 已提交 -> 家长已确认 -> 设备删除中 -> 部分失败 -> 已删除 -> 人工处理 -> 已关闭 | 人脸授权撤回处理：家长撤回人脸授权 | 处理完成、失败和异常转人工均需触发站内通知或待办 | 原型需展示入口、主按钮、禁用原因、提交中、成功、失败、无权限、空状态和异常转人工入口 |
| 设备回执 | POST /api/v1/face/persons | FaceAttendanceEvent | 未授权 -> 待采集 -> 已授权 -> 已下发 -> 撤回中 -> 已撤回 -> 已删除 | 人脸授权撤回处理：家长撤回人脸授权 | 处理完成、失败和异常转人工均需触发站内通知或待办 | 原型需展示入口、主按钮、禁用原因、提交中、成功、失败、无权限、空状态和异常转人工入口 |
| 设备告警 | POST /api/v1/face/events | FaceAuthorizationRevokeTask | 已提交 -> 家长已确认 -> 设备删除中 -> 部分失败 -> 已删除 -> 人工处理 -> 已关闭 | 人脸授权撤回处理：家长撤回人脸授权 | 处理完成、失败和异常转人工均需触发站内通知或待办 | 原型需展示入口、主按钮、禁用原因、提交中、成功、失败、无权限、空状态和异常转人工入口 |
| 维修工单 | POST /api/v1/face/devices/{id}/heartbeat | FaceDevice | 未授权 -> 待采集 -> 已授权 -> 已下发 -> 撤回中 -> 已撤回 -> 已删除 | 人脸授权撤回处理：家长撤回人脸授权 | 处理完成、失败和异常转人工均需触发站内通知或待办 | 原型需展示入口、主按钮、禁用原因、提交中、成功、失败、无权限、空状态和异常转人工入口 |
| 资产详情 | POST /api/v1/face/authorizations/{id}/revoke | FacePerson | 已提交 -> 家长已确认 -> 设备删除中 -> 部分失败 -> 已删除 -> 人工处理 -> 已关闭 | 人脸授权撤回处理：家长撤回人脸授权 | 处理完成、失败和异常转人工均需触发站内通知或待办 | 原型需展示入口、主按钮、禁用原因、提交中、成功、失败、无权限、空状态和异常转人工入口 |
10 · 原型、UI、研发、测试交付补充
把关键闭环补强为下一阶段可执行任务
本章节为正式 PRD 的交付要求，面向原型图、UI、开发、联调和测试分工。| 能力域 | 功能补充要求 | 原型交付要求 | UI 交互要求 | 研发实现要求 | 测试验收要求 |
|---|---|---|---|---|---|
| 设备闭环 | 补齐设备下发回执、低置信度识别、重复识别、人工复核、自动签到和课消联动。 | 设备列表、人员下发、识别流水、考勤异常 需要在原型中拆到列表、详情、表单、弹窗、空状态、失败态、无权限态和处理进度。 | UI 需清晰呈现状态标签、流程节点、主次按钮、危险操作确认、移动/平板/TV 适配和错误提示；PC 管理端遵循统一框架，仅输出信息架构和交互说明。 | 后端需提供接口幂等、权限校验、状态机、审计日志、消息/审批触发、异步补偿和跨模块数据一致性保障。 | 测试需覆盖主流程、异常流、权限流、重复提交、批量部分失败和数据一致性；识别异常可人工确认，确认后同步教务考勤和课消状态。 |
| 隐私撤回 | 补齐撤回申请、家长确认、设备删除任务、失败重试、离线延迟删除和审计记录。 | 人脸授权详情、撤回任务、设备回执 需要在原型中拆到列表、详情、表单、弹窗、空状态、失败态、无权限态和处理进度。 | UI 需清晰呈现状态标签、流程节点、主次按钮、危险操作确认、移动/平板/TV 适配和错误提示；PC 管理端遵循统一框架，仅输出信息架构和交互说明。 | 后端需提供接口幂等、权限校验、状态机、审计日志、消息/审批触发、异步补偿和跨模块数据一致性保障。 | 测试需覆盖主流程、异常流、权限流、重复提交、批量部分失败和数据一致性；撤回后所有关联设备都有删除结果或人工处理记录。 |
| 运维联动 | 补齐离线告警、维修工单、资产状态、恢复校验和影响课次范围。 | 设备告警、维修工单、资产详情 需要在原型中拆到列表、详情、表单、弹窗、空状态、失败态、无权限态和处理进度。 | UI 需清晰呈现状态标签、流程节点、主次按钮、危险操作确认、移动/平板/TV 适配和错误提示；PC 管理端遵循统一框架，仅输出信息架构和交互说明。 | 后端需提供接口幂等、权限校验、状态机、审计日志、消息/审批触发、异步补偿和跨模块数据一致性保障。 | 测试需覆盖主流程、异常流、权限流、重复提交、批量部分失败和数据一致性；设备恢复后可自动回测签到、直播或录像相关能力。 |
11 · 数据对象与字段字典
明确页面、接口、数据库共同使用的数据语言
字段涉及敏感、人脸、财务、绩效时，原型需体现脱敏、授权和审计。核心对象
| 对象 | 说明 |
|---|---|
| FaceDevice | 人脸识别考勤设备；落地表：dev_face_device |
| FacePerson | 人脸人员库；落地表：dev_face_person |
| FaceDispatchTask | 人脸下发任务；落地表：dev_face_dispatch_task |
| FaceAttendanceEvent | 人脸识别回传事件；落地表：dev_face_event |
| FaceAuthorizationRevokeTask | 人脸授权撤销任务；落地表：dev_face_revoke_task |
关联引用对象
| 对象 | 说明 |
|---|---|
| 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 |
| Schedule/Lesson | 课次和排课；引用来源：EDU / edu_lesson |
| Attendance | 上课签到记录；引用来源：EDU / edu_attendance |
| Consumption | 课消记录；引用来源：EDU / edu_consumption |
| Asset | 固定资产台账；引用来源：MAT / mat_asset |
| AssetLifecycle/Maintenance | 资产维修与生命周期；引用来源：MAT / mat_maintenance_order |
完整字段字典
| 对象 | 字段 | 类型 | 必填 | 规则 | 数据级别 |
|---|---|---|---|---|---|
| FaceDevice | id | BIGINT | 是 | 主键，雪花或号段生成，禁止复用 | 普通 |
| FaceDevice | tenant_id | BIGINT | 是 | 集团/租户隔离字段，所有查询必须带租户上下文 | 普通 |
| FaceDevice | org_id | BIGINT | 否 | 所属组织，集团级或公共配置为空 | 普通 |
| FaceDevice | campus_id | BIGINT | 否 | 所属校区，跨校区或总部级数据为空 | 普通 |
| FaceDevice | created_by | BIGINT | 是 | 创建人账号 ID | 普通 |
| FaceDevice | created_at | DATETIME | 是 | 创建时间 | 普通 |
| FaceDevice | updated_by | BIGINT | 否 | 最后更新人账号 ID | 普通 |
| FaceDevice | updated_at | DATETIME | 否 | 最后更新时间 | 普通 |
| FaceDevice | is_deleted | TINYINT | 是 | 是否已删除，0 未删除，1 已删除 | 普通 |
| FaceDevice | deleted_at | DATETIME | 否 | 删除时间，未删除为空 | 普通 |
| FaceDevice | deleted_by | BIGINT | 否 | 删除人账号 ID，未删除为空 | 普通 |
| FaceDevice | version | INT | 是 | 乐观锁版本号，写操作必须校验 | 普通 |
| FaceDevice | device_code | VARCHAR(64) | 是 | 设备编码，唯一 | 普通 |
| FaceDevice | vendor_code | VARCHAR(32) | 是 | 设备品牌/厂商 | 普通 |
| FaceDevice | device_name | VARCHAR(128) | 是 | 设备名称 | 普通 |
| FaceDevice | classroom_id | BIGINT | 否 | 绑定教室 ID | 普通 |
| FaceDevice | api_endpoint | VARCHAR(512) | 否 | 设备或平台 API 地址 | 普通 |
| FaceDevice | device_status | VARCHAR(32) | 是 | 在线/离线/停用/异常 | 普通 |
| FacePerson | id | BIGINT | 是 | 主键，雪花或号段生成，禁止复用 | 普通 |
| FacePerson | tenant_id | BIGINT | 是 | 集团/租户隔离字段，所有查询必须带租户上下文 | 普通 |
| FacePerson | org_id | BIGINT | 否 | 所属组织，集团级或公共配置为空 | 普通 |
| FacePerson | campus_id | BIGINT | 否 | 所属校区，跨校区或总部级数据为空 | 普通 |
| FacePerson | created_by | BIGINT | 是 | 创建人账号 ID | 普通 |
| FacePerson | created_at | DATETIME | 是 | 创建时间 | 普通 |
| FacePerson | updated_by | BIGINT | 否 | 最后更新人账号 ID | 普通 |
| FacePerson | updated_at | DATETIME | 否 | 最后更新时间 | 普通 |
| FacePerson | is_deleted | TINYINT | 是 | 是否已删除，0 未删除，1 已删除 | 普通 |
| FacePerson | deleted_at | DATETIME | 否 | 删除时间，未删除为空 | 普通 |
| FacePerson | deleted_by | BIGINT | 否 | 删除人账号 ID，未删除为空 | 普通 |
| FacePerson | version | INT | 是 | 乐观锁版本号，写操作必须校验 | 普通 |
| FacePerson | person_no | VARCHAR(64) | 是 | 人员编号，唯一 | 普通 |
| FacePerson | person_type | VARCHAR(32) | 是 | 学员/教师/员工 | 普通 |
| FacePerson | person_id | BIGINT | 是 | 业务人员 ID | 普通 |
| FacePerson | photo_file_id | BIGINT | 是 | 人脸照片文件 ID | 高敏 |
| FacePerson | valid_until | DATETIME | 否 | 授权有效期 | 普通 |
| FacePerson | sync_status | VARCHAR(32) | 是 | 待下发/已下发/失败/已撤销 | 普通 |
| FaceDispatchTask | id | BIGINT | 是 | 主键，雪花或号段生成，禁止复用 | 普通 |
| FaceDispatchTask | tenant_id | BIGINT | 是 | 集团/租户隔离字段，所有查询必须带租户上下文 | 普通 |
| FaceDispatchTask | org_id | BIGINT | 否 | 所属组织，集团级或公共配置为空 | 普通 |
| FaceDispatchTask | campus_id | BIGINT | 否 | 所属校区，跨校区或总部级数据为空 | 普通 |
| FaceDispatchTask | created_by | BIGINT | 是 | 创建人账号 ID | 普通 |
| FaceDispatchTask | created_at | DATETIME | 是 | 创建时间 | 普通 |
| FaceDispatchTask | updated_by | BIGINT | 否 | 最后更新人账号 ID | 普通 |
| FaceDispatchTask | updated_at | DATETIME | 否 | 最后更新时间 | 普通 |
| FaceDispatchTask | is_deleted | TINYINT | 是 | 是否已删除，0 未删除，1 已删除 | 普通 |
| FaceDispatchTask | deleted_at | DATETIME | 否 | 删除时间，未删除为空 | 普通 |
| FaceDispatchTask | deleted_by | BIGINT | 否 | 删除人账号 ID，未删除为空 | 普通 |
| FaceDispatchTask | version | INT | 是 | 乐观锁版本号，写操作必须校验 | 普通 |
| FaceDispatchTask | task_no | VARCHAR(64) | 是 | 任务编号，唯一 | 普通 |
| FaceDispatchTask | device_id | BIGINT | 是 | 设备 ID | 普通 |
| FaceDispatchTask | person_id | BIGINT | 是 | 人员库 ID | 普通 |
| FaceDispatchTask | action_type | VARCHAR(32) | 是 | 新增/更新/删除/重试 | 普通 |
| FaceDispatchTask | request_payload | JSON | 是 | 下发请求 | 普通 |
| FaceDispatchTask | response_payload | JSON | 否 | 设备响应 | 普通 |
| FaceDispatchTask | task_status | VARCHAR(32) | 是 | 待执行/成功/失败/重试中 | 普通 |
| FaceAttendanceEvent | id | BIGINT | 是 | 主键，雪花或号段生成，禁止复用 | 普通 |
| FaceAttendanceEvent | tenant_id | BIGINT | 是 | 集团/租户隔离字段，所有查询必须带租户上下文 | 普通 |
| FaceAttendanceEvent | org_id | BIGINT | 否 | 所属组织，集团级或公共配置为空 | 普通 |
| FaceAttendanceEvent | campus_id | BIGINT | 否 | 所属校区，跨校区或总部级数据为空 | 普通 |
| FaceAttendanceEvent | created_by | BIGINT | 是 | 创建人账号 ID | 普通 |
| FaceAttendanceEvent | created_at | DATETIME | 是 | 创建时间 | 普通 |
| FaceAttendanceEvent | updated_by | BIGINT | 否 | 最后更新人账号 ID | 普通 |
| FaceAttendanceEvent | updated_at | DATETIME | 否 | 最后更新时间 | 普通 |
| FaceAttendanceEvent | is_deleted | TINYINT | 是 | 是否已删除，0 未删除，1 已删除 | 普通 |
| FaceAttendanceEvent | deleted_at | DATETIME | 否 | 删除时间，未删除为空 | 普通 |
| FaceAttendanceEvent | deleted_by | BIGINT | 否 | 删除人账号 ID，未删除为空 | 普通 |
| FaceAttendanceEvent | version | INT | 是 | 乐观锁版本号，写操作必须校验 | 普通 |
| FaceAttendanceEvent | device_id | BIGINT | 是 | 设备 ID | 普通 |
| FaceAttendanceEvent | device_event_id | VARCHAR(128) | 是 | 设备侧事件号 | 普通 |
| FaceAttendanceEvent | person_id | BIGINT | 否 | 匹配人员 ID | 普通 |
| FaceAttendanceEvent | lesson_id | BIGINT | 否 | 匹配课次 ID | 普通 |
| FaceAttendanceEvent | event_time | DATETIME | 是 | 识别时间 | 普通 |
| FaceAttendanceEvent | confidence | DECIMAL(8,4) | 是 | 识别置信度 | 普通 |
| FaceAttendanceEvent | match_status | VARCHAR(32) | 是 | 已匹配/低置信/未匹配/重复 | 普通 |
| FaceAttendanceEvent | raw_payload | JSON | 是 | 设备原始报文 | 敏感 |
| FaceAuthorizationRevokeTask | id | BIGINT | 是 | 主键，雪花或号段生成，禁止复用 | 普通 |
| FaceAuthorizationRevokeTask | tenant_id | BIGINT | 是 | 集团/租户隔离字段，所有查询必须带租户上下文 | 普通 |
| FaceAuthorizationRevokeTask | org_id | BIGINT | 否 | 所属组织，集团级或公共配置为空 | 普通 |
| FaceAuthorizationRevokeTask | campus_id | BIGINT | 否 | 所属校区，跨校区或总部级数据为空 | 普通 |
| FaceAuthorizationRevokeTask | created_by | BIGINT | 是 | 创建人账号 ID | 普通 |
| FaceAuthorizationRevokeTask | created_at | DATETIME | 是 | 创建时间 | 普通 |
| FaceAuthorizationRevokeTask | updated_by | BIGINT | 否 | 最后更新人账号 ID | 普通 |
| FaceAuthorizationRevokeTask | updated_at | DATETIME | 否 | 最后更新时间 | 普通 |
| FaceAuthorizationRevokeTask | is_deleted | TINYINT | 是 | 是否已删除，0 未删除，1 已删除 | 普通 |
| FaceAuthorizationRevokeTask | deleted_at | DATETIME | 否 | 删除时间，未删除为空 | 普通 |
| FaceAuthorizationRevokeTask | deleted_by | BIGINT | 否 | 删除人账号 ID，未删除为空 | 普通 |
| FaceAuthorizationRevokeTask | version | INT | 是 | 乐观锁版本号，写操作必须校验 | 普通 |
| FaceAuthorizationRevokeTask | revoke_no | VARCHAR(64) | 是 | 撤销编号，唯一 | 普通 |
| FaceAuthorizationRevokeTask | person_id | BIGINT | 是 | 人员库 ID | 普通 |
| FaceAuthorizationRevokeTask | revoke_reason | VARCHAR(255) | 是 | 撤销原因 | 普通 |
| FaceAuthorizationRevokeTask | device_scope | JSON | 是 | 撤销设备范围 | 普通 |
| FaceAuthorizationRevokeTask | revoke_status | VARCHAR(32) | 是 | 待撤销/部分成功/成功/失败 | 普通 |
引用对象字段字典
| 引用表 | 对象 | 字段 | 类型 | 必填 | 规则 | 数据级别 |
|---|---|---|---|---|---|---|
| sys_organization | Organization | id | BIGINT | 是 | 主键，雪花或号段生成，禁止复用 | 普通 |
| sys_organization | Organization | tenant_id | BIGINT | 是 | 集团/租户隔离字段，所有查询必须带租户上下文 | 普通 |
| sys_organization | Organization | org_id | BIGINT | 否 | 所属组织，集团级或公共配置为空 | 普通 |
| sys_organization | Organization | campus_id | BIGINT | 否 | 所属校区，跨校区或总部级数据为空 | 普通 |
| sys_organization | Organization | created_by | BIGINT | 是 | 创建人账号 ID | 普通 |
| sys_organization | Organization | created_at | DATETIME | 是 | 创建时间 | 普通 |
| sys_organization | Organization | updated_by | BIGINT | 否 | 最后更新人账号 ID | 普通 |
| sys_organization | Organization | updated_at | DATETIME | 否 | 最后更新时间 | 普通 |
| sys_organization | Organization | is_deleted | TINYINT | 是 | 是否已删除，0 未删除，1 已删除 | 普通 |
| sys_organization | Organization | deleted_at | DATETIME | 否 | 删除时间，未删除为空 | 普通 |
| sys_organization | Organization | deleted_by | BIGINT | 否 | 删除人账号 ID，未删除为空 | 普通 |
| sys_organization | Organization | version | INT | 是 | 乐观锁版本号，写操作必须校验 | 普通 |
| sys_organization | Organization | org_code | VARCHAR(64) | 是 | 组织编码，租户内唯一 | 普通 |
| sys_organization | Organization | org_name | VARCHAR(128) | 是 | 组织名称 | 普通 |
| sys_organization | Organization | org_type | VARCHAR(32) | 是 | 集团/区域/校区/部门/法人主体 | 普通 |
| sys_organization | Organization | parent_id | BIGINT | 否 | 上级组织 ID，根节点为空 | 普通 |
| sys_organization | Organization | sort_no | INT | 否 | 同级排序 | 普通 |
| sys_organization | Organization | enabled | TINYINT | 是 | 是否启用 | 普通 |
| sys_user | User/Employee | id | BIGINT | 是 | 主键，雪花或号段生成，禁止复用 | 普通 |
| sys_user | User/Employee | tenant_id | BIGINT | 是 | 集团/租户隔离字段，所有查询必须带租户上下文 | 普通 |
| sys_user | User/Employee | org_id | BIGINT | 否 | 所属组织，集团级或公共配置为空 | 普通 |
| sys_user | User/Employee | campus_id | BIGINT | 否 | 所属校区，跨校区或总部级数据为空 | 普通 |
| sys_user | User/Employee | created_by | BIGINT | 是 | 创建人账号 ID | 普通 |
| sys_user | User/Employee | created_at | DATETIME | 是 | 创建时间 | 普通 |
| sys_user | User/Employee | updated_by | BIGINT | 否 | 最后更新人账号 ID | 普通 |
| sys_user | User/Employee | updated_at | DATETIME | 否 | 最后更新时间 | 普通 |
| sys_user | User/Employee | is_deleted | TINYINT | 是 | 是否已删除，0 未删除，1 已删除 | 普通 |
| sys_user | User/Employee | deleted_at | DATETIME | 否 | 删除时间，未删除为空 | 普通 |
| sys_user | User/Employee | deleted_by | BIGINT | 否 | 删除人账号 ID，未删除为空 | 普通 |
| sys_user | User/Employee | version | INT | 是 | 乐观锁版本号，写操作必须校验 | 普通 |
| sys_user | User/Employee | user_no | VARCHAR(64) | 是 | 账号编号，唯一 | 普通 |
| sys_user | User/Employee | login_name | VARCHAR(64) | 是 | 登录名，唯一 | 普通 |
| sys_user | User/Employee | mobile | VARCHAR(32) | 否 | 手机号，敏感脱敏展示 | 敏感 |
| sys_user | User/Employee | password_hash | VARCHAR(255) | 否 | 密码哈希，禁止前端返回 | 高敏 |
| sys_user | User/Employee | user_type | VARCHAR(32) | 是 | 员工/学员/家长/外部账号 | 普通 |
| sys_user | User/Employee | login_status | VARCHAR(32) | 是 | 正常/锁定/停用/待激活 | 普通 |
| sys_employee | Employee | id | BIGINT | 是 | 主键，雪花或号段生成，禁止复用 | 普通 |
| sys_employee | Employee | tenant_id | BIGINT | 是 | 集团/租户隔离字段，所有查询必须带租户上下文 | 普通 |
| sys_employee | Employee | org_id | BIGINT | 否 | 所属组织，集团级或公共配置为空 | 普通 |
| sys_employee | Employee | campus_id | BIGINT | 否 | 所属校区，跨校区或总部级数据为空 | 普通 |
| sys_employee | Employee | created_by | BIGINT | 是 | 创建人账号 ID | 普通 |
| sys_employee | Employee | created_at | DATETIME | 是 | 创建时间 | 普通 |
| sys_employee | Employee | updated_by | BIGINT | 否 | 最后更新人账号 ID | 普通 |
| sys_employee | Employee | updated_at | DATETIME | 否 | 最后更新时间 | 普通 |
| sys_employee | Employee | is_deleted | TINYINT | 是 | 是否已删除，0 未删除，1 已删除 | 普通 |
| sys_employee | Employee | deleted_at | DATETIME | 否 | 删除时间，未删除为空 | 普通 |
| sys_employee | Employee | deleted_by | BIGINT | 否 | 删除人账号 ID，未删除为空 | 普通 |
| sys_employee | Employee | version | INT | 是 | 乐观锁版本号，写操作必须校验 | 普通 |
| sys_employee | Employee | employee_no | VARCHAR(64) | 是 | 工号，唯一 | 普通 |
| sys_employee | Employee | user_id | BIGINT | 否 | 关联账号 ID | 普通 |
| sys_employee | Employee | employee_name | VARCHAR(64) | 是 | 员工姓名 | 普通 |
| sys_employee | Employee | primary_campus_id | BIGINT | 否 | 主校区 ID | 普通 |
| sys_employee | Employee | job_title | VARCHAR(64) | 否 | 岗位名称 | 普通 |
| sys_employee | Employee | hire_status | VARCHAR(32) | 是 | 在职/试用/离职/停用 | 普通 |
| sys_role | Role | id | BIGINT | 是 | 主键，雪花或号段生成，禁止复用 | 普通 |
| sys_role | Role | tenant_id | BIGINT | 是 | 集团/租户隔离字段，所有查询必须带租户上下文 | 普通 |
| sys_role | Role | org_id | BIGINT | 否 | 所属组织，集团级或公共配置为空 | 普通 |
| sys_role | Role | campus_id | BIGINT | 否 | 所属校区，跨校区或总部级数据为空 | 普通 |
| sys_role | Role | created_by | BIGINT | 是 | 创建人账号 ID | 普通 |
| sys_role | Role | created_at | DATETIME | 是 | 创建时间 | 普通 |
| sys_role | Role | updated_by | BIGINT | 否 | 最后更新人账号 ID | 普通 |
| sys_role | Role | updated_at | DATETIME | 否 | 最后更新时间 | 普通 |
| sys_role | Role | is_deleted | TINYINT | 是 | 是否已删除，0 未删除，1 已删除 | 普通 |
| sys_role | Role | deleted_at | DATETIME | 否 | 删除时间，未删除为空 | 普通 |
| sys_role | Role | deleted_by | BIGINT | 否 | 删除人账号 ID，未删除为空 | 普通 |
| sys_role | Role | version | INT | 是 | 乐观锁版本号，写操作必须校验 | 普通 |
| sys_role | Role | role_code | VARCHAR(64) | 是 | 角色编码，唯一 | 普通 |
| sys_role | Role | role_name | VARCHAR(128) | 是 | 角色名称 | 普通 |
| sys_role | Role | role_level | VARCHAR(32) | 是 | 总部/区域/校区/个人 | 普通 |
| sys_role | Role | data_scope_type | VARCHAR(32) | 是 | 数据范围类型 | 普通 |
| sys_role | Role | enabled | TINYINT | 是 | 是否启用 | 普通 |
| sys_approval_flow | ApprovalFlow | id | BIGINT | 是 | 主键，雪花或号段生成，禁止复用 | 普通 |
| sys_approval_flow | ApprovalFlow | tenant_id | BIGINT | 是 | 集团/租户隔离字段，所有查询必须带租户上下文 | 普通 |
| sys_approval_flow | ApprovalFlow | org_id | BIGINT | 否 | 所属组织，集团级或公共配置为空 | 普通 |
| sys_approval_flow | ApprovalFlow | campus_id | BIGINT | 否 | 所属校区，跨校区或总部级数据为空 | 普通 |
| sys_approval_flow | ApprovalFlow | created_by | BIGINT | 是 | 创建人账号 ID | 普通 |
| sys_approval_flow | ApprovalFlow | created_at | DATETIME | 是 | 创建时间 | 普通 |
| sys_approval_flow | ApprovalFlow | updated_by | BIGINT | 否 | 最后更新人账号 ID | 普通 |
| sys_approval_flow | ApprovalFlow | updated_at | DATETIME | 否 | 最后更新时间 | 普通 |
| sys_approval_flow | ApprovalFlow | is_deleted | TINYINT | 是 | 是否已删除，0 未删除，1 已删除 | 普通 |
| sys_approval_flow | ApprovalFlow | deleted_at | DATETIME | 否 | 删除时间，未删除为空 | 普通 |
| sys_approval_flow | ApprovalFlow | deleted_by | BIGINT | 否 | 删除人账号 ID，未删除为空 | 普通 |
| sys_approval_flow | ApprovalFlow | version | INT | 是 | 乐观锁版本号，写操作必须校验 | 普通 |
| sys_approval_flow | ApprovalFlow | flow_code | VARCHAR(64) | 是 | 审批流编码，唯一 | 普通 |
| sys_approval_flow | ApprovalFlow | biz_type | VARCHAR(64) | 是 | 业务类型 | 普通 |
| sys_approval_flow | ApprovalFlow | flow_name | VARCHAR(128) | 是 | 审批流名称 | 普通 |
| sys_approval_flow | ApprovalFlow | condition_json | JSON | 否 | 触发条件 | 普通 |
| sys_approval_flow | ApprovalFlow | node_json | JSON | 是 | 节点、审批人和超时规则 | 普通 |
| sys_approval_flow | ApprovalFlow | version_no | INT | 是 | 审批流版本号 | 普通 |
| sys_approval_flow | ApprovalFlow | enabled | TINYINT | 是 | 是否启用 | 普通 |
| sys_message_template | MessageTemplate | id | BIGINT | 是 | 主键，雪花或号段生成，禁止复用 | 普通 |
| sys_message_template | MessageTemplate | tenant_id | BIGINT | 是 | 集团/租户隔离字段，所有查询必须带租户上下文 | 普通 |
| sys_message_template | MessageTemplate | org_id | BIGINT | 否 | 所属组织，集团级或公共配置为空 | 普通 |
| sys_message_template | MessageTemplate | campus_id | BIGINT | 否 | 所属校区，跨校区或总部级数据为空 | 普通 |
| sys_message_template | MessageTemplate | created_by | BIGINT | 是 | 创建人账号 ID | 普通 |
| sys_message_template | MessageTemplate | created_at | DATETIME | 是 | 创建时间 | 普通 |
| sys_message_template | MessageTemplate | updated_by | BIGINT | 否 | 最后更新人账号 ID | 普通 |
| sys_message_template | MessageTemplate | updated_at | DATETIME | 否 | 最后更新时间 | 普通 |
| sys_message_template | MessageTemplate | is_deleted | TINYINT | 是 | 是否已删除，0 未删除，1 已删除 | 普通 |
| sys_message_template | MessageTemplate | deleted_at | DATETIME | 否 | 删除时间，未删除为空 | 普通 |
| sys_message_template | MessageTemplate | deleted_by | BIGINT | 否 | 删除人账号 ID，未删除为空 | 普通 |
| sys_message_template | MessageTemplate | version | INT | 是 | 乐观锁版本号，写操作必须校验 | 普通 |
| sys_message_template | MessageTemplate | template_code | VARCHAR(64) | 是 | 模板编码，唯一 | 普通 |
| sys_message_template | MessageTemplate | template_name | VARCHAR(128) | 是 | 模板名称 | 普通 |
| sys_message_template | MessageTemplate | channel | VARCHAR(32) | 是 | 站内信/短信/微信小程序/企微/Push | 普通 |
| sys_message_template | MessageTemplate | receiver_rule | JSON | 是 | 接收人规则 | 普通 |
| sys_message_template | MessageTemplate | content_template | TEXT | 是 | 模板内容 | 普通 |
| sys_message_template | MessageTemplate | enabled | TINYINT | 是 | 是否启用 | 普通 |
| sys_audit_log | AuditLog | id | BIGINT | 是 | 主键，雪花或号段生成，禁止复用 | 普通 |
| sys_audit_log | AuditLog | tenant_id | BIGINT | 是 | 集团/租户隔离字段，所有查询必须带租户上下文 | 普通 |
| sys_audit_log | AuditLog | org_id | BIGINT | 否 | 所属组织，集团级或公共配置为空 | 普通 |
| sys_audit_log | AuditLog | campus_id | BIGINT | 否 | 所属校区，跨校区或总部级数据为空 | 普通 |
| sys_audit_log | AuditLog | created_by | BIGINT | 是 | 创建人账号 ID | 普通 |
| sys_audit_log | AuditLog | created_at | DATETIME | 是 | 创建时间 | 普通 |
| sys_audit_log | AuditLog | updated_by | BIGINT | 否 | 最后更新人账号 ID | 普通 |
| sys_audit_log | AuditLog | updated_at | DATETIME | 否 | 最后更新时间 | 普通 |
| sys_audit_log | AuditLog | is_deleted | TINYINT | 是 | 是否已删除，0 未删除，1 已删除 | 普通 |
| sys_audit_log | AuditLog | deleted_at | DATETIME | 否 | 删除时间，未删除为空 | 普通 |
| sys_audit_log | AuditLog | deleted_by | BIGINT | 否 | 删除人账号 ID，未删除为空 | 普通 |
| sys_audit_log | AuditLog | version | INT | 是 | 乐观锁版本号，写操作必须校验 | 普通 |
| sys_audit_log | AuditLog | operator_id | BIGINT | 是 | 操作人 ID | 普通 |
| sys_audit_log | AuditLog | biz_type | VARCHAR(64) | 是 | 业务类型 | 普通 |
| sys_audit_log | AuditLog | biz_id | BIGINT | 否 | 业务主键 ID | 普通 |
| sys_audit_log | AuditLog | action_code | VARCHAR(64) | 是 | 操作编码 | 普通 |
| sys_audit_log | AuditLog | before_snapshot | JSON | 否 | 变更前快照 | 普通 |
| sys_audit_log | AuditLog | after_snapshot | JSON | 否 | 变更后快照 | 普通 |
| sys_audit_log | AuditLog | ip_address | VARCHAR(64) | 否 | 操作 IP | 普通 |
| int_integration_log | IntegrationLog | id | BIGINT | 是 | 主键，雪花或号段生成，禁止复用 | 普通 |
| int_integration_log | IntegrationLog | tenant_id | BIGINT | 是 | 集团/租户隔离字段，所有查询必须带租户上下文 | 普通 |
| int_integration_log | IntegrationLog | org_id | BIGINT | 否 | 所属组织，集团级或公共配置为空 | 普通 |
| int_integration_log | IntegrationLog | campus_id | BIGINT | 否 | 所属校区，跨校区或总部级数据为空 | 普通 |
| int_integration_log | IntegrationLog | created_by | BIGINT | 是 | 创建人账号 ID | 普通 |
| int_integration_log | IntegrationLog | created_at | DATETIME | 是 | 创建时间 | 普通 |
| int_integration_log | IntegrationLog | updated_by | BIGINT | 否 | 最后更新人账号 ID | 普通 |
| int_integration_log | IntegrationLog | updated_at | DATETIME | 否 | 最后更新时间 | 普通 |
| int_integration_log | IntegrationLog | is_deleted | TINYINT | 是 | 是否已删除，0 未删除，1 已删除 | 普通 |
| int_integration_log | IntegrationLog | deleted_at | DATETIME | 否 | 删除时间，未删除为空 | 普通 |
| int_integration_log | IntegrationLog | deleted_by | BIGINT | 否 | 删除人账号 ID，未删除为空 | 普通 |
| int_integration_log | IntegrationLog | version | INT | 是 | 乐观锁版本号，写操作必须校验 | 普通 |
| int_integration_log | IntegrationLog | request_id | VARCHAR(128) | 是 | 请求 ID，幂等键 | 普通 |
| int_integration_log | IntegrationLog | system_code | VARCHAR(64) | 是 | 外部系统编码 | 普通 |
| int_integration_log | IntegrationLog | api_path | VARCHAR(512) | 是 | 接口路径 | 普通 |
| int_integration_log | IntegrationLog | biz_type | VARCHAR(64) | 否 | 业务类型 | 普通 |
| int_integration_log | IntegrationLog | biz_id | BIGINT | 否 | 业务 ID | 普通 |
| int_integration_log | IntegrationLog | request_payload | JSON | 否 | 请求报文，敏感字段脱敏 | 敏感 |
| int_integration_log | IntegrationLog | response_payload | JSON | 否 | 响应报文 | 普通 |
| int_integration_log | IntegrationLog | call_status | VARCHAR(32) | 是 | 成功/失败/超时/重试中 | 普通 |
| sec_sensitive_field_policy | SensitiveFieldPolicy | id | BIGINT | 是 | 主键，雪花或号段生成，禁止复用 | 普通 |
| sec_sensitive_field_policy | SensitiveFieldPolicy | tenant_id | BIGINT | 是 | 集团/租户隔离字段，所有查询必须带租户上下文 | 普通 |
| sec_sensitive_field_policy | SensitiveFieldPolicy | org_id | BIGINT | 否 | 所属组织，集团级或公共配置为空 | 普通 |
| sec_sensitive_field_policy | SensitiveFieldPolicy | campus_id | BIGINT | 否 | 所属校区，跨校区或总部级数据为空 | 普通 |
| sec_sensitive_field_policy | SensitiveFieldPolicy | created_by | BIGINT | 是 | 创建人账号 ID | 普通 |
| sec_sensitive_field_policy | SensitiveFieldPolicy | created_at | DATETIME | 是 | 创建时间 | 普通 |
| sec_sensitive_field_policy | SensitiveFieldPolicy | updated_by | BIGINT | 否 | 最后更新人账号 ID | 普通 |
| sec_sensitive_field_policy | SensitiveFieldPolicy | updated_at | DATETIME | 否 | 最后更新时间 | 普通 |
| sec_sensitive_field_policy | SensitiveFieldPolicy | is_deleted | TINYINT | 是 | 是否已删除，0 未删除，1 已删除 | 普通 |
| sec_sensitive_field_policy | SensitiveFieldPolicy | deleted_at | DATETIME | 否 | 删除时间，未删除为空 | 普通 |
| sec_sensitive_field_policy | SensitiveFieldPolicy | deleted_by | BIGINT | 否 | 删除人账号 ID，未删除为空 | 普通 |
| sec_sensitive_field_policy | SensitiveFieldPolicy | version | INT | 是 | 乐观锁版本号，写操作必须校验 | 普通 |
| sec_sensitive_field_policy | SensitiveFieldPolicy | field_code | VARCHAR(128) | 是 | 字段编码，唯一 | 普通 |
| sec_sensitive_field_policy | SensitiveFieldPolicy | biz_type | VARCHAR(64) | 是 | 业务类型 | 普通 |
| sec_sensitive_field_policy | SensitiveFieldPolicy | mask_rule | VARCHAR(64) | 是 | 脱敏规则 | 普通 |
| sec_sensitive_field_policy | SensitiveFieldPolicy | view_requires_approval | TINYINT | 是 | 明文查看是否需审批 | 普通 |
| sec_sensitive_field_policy | SensitiveFieldPolicy | watermark_required | TINYINT | 是 | 是否加水印 | 普通 |
| stu_student | Student | id | BIGINT | 是 | 主键，雪花或号段生成，禁止复用 | 普通 |
| stu_student | Student | tenant_id | BIGINT | 是 | 集团/租户隔离字段，所有查询必须带租户上下文 | 普通 |
| stu_student | Student | org_id | BIGINT | 否 | 所属组织，集团级或公共配置为空 | 普通 |
| stu_student | Student | campus_id | BIGINT | 否 | 所属校区，跨校区或总部级数据为空 | 普通 |
| stu_student | Student | created_by | BIGINT | 是 | 创建人账号 ID | 普通 |
| stu_student | Student | created_at | DATETIME | 是 | 创建时间 | 普通 |
| stu_student | Student | updated_by | BIGINT | 否 | 最后更新人账号 ID | 普通 |
| stu_student | Student | updated_at | DATETIME | 否 | 最后更新时间 | 普通 |
| stu_student | Student | is_deleted | TINYINT | 是 | 是否已删除，0 未删除，1 已删除 | 普通 |
| stu_student | Student | deleted_at | DATETIME | 否 | 删除时间，未删除为空 | 普通 |
| stu_student | Student | deleted_by | BIGINT | 否 | 删除人账号 ID，未删除为空 | 普通 |
| stu_student | Student | version | INT | 是 | 乐观锁版本号，写操作必须校验 | 普通 |
| stu_student | Student | student_no | VARCHAR(64) | 是 | 学员编号，唯一 | 普通 |
| stu_student | Student | family_id | BIGINT | 否 | 家庭 ID | 普通 |
| stu_student | Student | student_name | VARCHAR(64) | 是 | 学员姓名 | 普通 |
| stu_student | Student | gender | VARCHAR(16) | 否 | 性别 | 普通 |
| stu_student | Student | birthday | DATE | 否 | 出生日期 | 普通 |
| stu_student | Student | grade | VARCHAR(32) | 否 | 年级 | 普通 |
| stu_student | Student | school_name | VARCHAR(128) | 否 | 学校名称 | 普通 |
| stu_student | Student | biz_status | VARCHAR(32) | 是 | 业务状态，取值来自状态机字典 | 普通 |
| stu_student | Student | remark | VARCHAR(512) | 否 | 业务备注，敏感内容按权限脱敏 | 普通 |
| edu_lesson | Schedule/Lesson | id | BIGINT | 是 | 主键，雪花或号段生成，禁止复用 | 普通 |
| edu_lesson | Schedule/Lesson | tenant_id | BIGINT | 是 | 集团/租户隔离字段，所有查询必须带租户上下文 | 普通 |
| edu_lesson | Schedule/Lesson | org_id | BIGINT | 否 | 所属组织，集团级或公共配置为空 | 普通 |
| edu_lesson | Schedule/Lesson | campus_id | BIGINT | 否 | 所属校区，跨校区或总部级数据为空 | 普通 |
| edu_lesson | Schedule/Lesson | created_by | BIGINT | 是 | 创建人账号 ID | 普通 |
| edu_lesson | Schedule/Lesson | created_at | DATETIME | 是 | 创建时间 | 普通 |
| edu_lesson | Schedule/Lesson | updated_by | BIGINT | 否 | 最后更新人账号 ID | 普通 |
| edu_lesson | Schedule/Lesson | updated_at | DATETIME | 否 | 最后更新时间 | 普通 |
| edu_lesson | Schedule/Lesson | is_deleted | TINYINT | 是 | 是否已删除，0 未删除，1 已删除 | 普通 |
| edu_lesson | Schedule/Lesson | deleted_at | DATETIME | 否 | 删除时间，未删除为空 | 普通 |
| edu_lesson | Schedule/Lesson | deleted_by | BIGINT | 否 | 删除人账号 ID，未删除为空 | 普通 |
| edu_lesson | Schedule/Lesson | version | INT | 是 | 乐观锁版本号，写操作必须校验 | 普通 |
| edu_lesson | Schedule/Lesson | lesson_no | VARCHAR(64) | 是 | 课次编号，唯一 | 普通 |
| edu_lesson | Schedule/Lesson | class_id | BIGINT | 是 | 班级 ID | 普通 |
| edu_lesson | Schedule/Lesson | teacher_id | BIGINT | 是 | 授课教师 ID | 普通 |
| edu_lesson | Schedule/Lesson | classroom_id | BIGINT | 否 | 教室 ID | 普通 |
| edu_lesson | Schedule/Lesson | start_at | DATETIME | 是 | 上课开始时间 | 普通 |
| edu_lesson | Schedule/Lesson | end_at | DATETIME | 是 | 上课结束时间 | 普通 |
| edu_lesson | Schedule/Lesson | lesson_status | VARCHAR(32) | 是 | 待上课/上课中/已下课/已取消/需补课 | 普通 |
| edu_attendance | Attendance | id | BIGINT | 是 | 主键，雪花或号段生成，禁止复用 | 普通 |
| edu_attendance | Attendance | tenant_id | BIGINT | 是 | 集团/租户隔离字段，所有查询必须带租户上下文 | 普通 |
| edu_attendance | Attendance | org_id | BIGINT | 否 | 所属组织，集团级或公共配置为空 | 普通 |
| edu_attendance | Attendance | campus_id | BIGINT | 否 | 所属校区，跨校区或总部级数据为空 | 普通 |
| edu_attendance | Attendance | created_by | BIGINT | 是 | 创建人账号 ID | 普通 |
| edu_attendance | Attendance | created_at | DATETIME | 是 | 创建时间 | 普通 |
| edu_attendance | Attendance | updated_by | BIGINT | 否 | 最后更新人账号 ID | 普通 |
| edu_attendance | Attendance | updated_at | DATETIME | 否 | 最后更新时间 | 普通 |
| edu_attendance | Attendance | is_deleted | TINYINT | 是 | 是否已删除，0 未删除，1 已删除 | 普通 |
| edu_attendance | Attendance | deleted_at | DATETIME | 否 | 删除时间，未删除为空 | 普通 |
| edu_attendance | Attendance | deleted_by | BIGINT | 否 | 删除人账号 ID，未删除为空 | 普通 |
| edu_attendance | Attendance | version | INT | 是 | 乐观锁版本号，写操作必须校验 | 普通 |
| edu_attendance | Attendance | lesson_id | BIGINT | 是 | 课次 ID | 普通 |
| edu_attendance | Attendance | student_id | BIGINT | 是 | 学员 ID | 普通 |
| edu_attendance | Attendance | checkin_type | VARCHAR(32) | 是 | 人工/人脸/补签/家长确认 | 普通 |
| edu_attendance | Attendance | checkin_at | DATETIME | 否 | 签到时间 | 普通 |
| edu_attendance | Attendance | attendance_status | VARCHAR(32) | 是 | 到课/请假/旷课/迟到/待确认 | 普通 |
| edu_attendance | Attendance | source_event_id | BIGINT | 否 | 来源设备或操作事件 | 普通 |
| edu_consumption | Consumption | id | BIGINT | 是 | 主键，雪花或号段生成，禁止复用 | 普通 |
| edu_consumption | Consumption | tenant_id | BIGINT | 是 | 集团/租户隔离字段，所有查询必须带租户上下文 | 普通 |
| edu_consumption | Consumption | org_id | BIGINT | 否 | 所属组织，集团级或公共配置为空 | 普通 |
| edu_consumption | Consumption | campus_id | BIGINT | 否 | 所属校区，跨校区或总部级数据为空 | 普通 |
| edu_consumption | Consumption | created_by | BIGINT | 是 | 创建人账号 ID | 普通 |
| edu_consumption | Consumption | created_at | DATETIME | 是 | 创建时间 | 普通 |
| edu_consumption | Consumption | updated_by | BIGINT | 否 | 最后更新人账号 ID | 普通 |
| edu_consumption | Consumption | updated_at | DATETIME | 否 | 最后更新时间 | 普通 |
| edu_consumption | Consumption | is_deleted | TINYINT | 是 | 是否已删除，0 未删除，1 已删除 | 普通 |
| edu_consumption | Consumption | deleted_at | DATETIME | 否 | 删除时间，未删除为空 | 普通 |
| edu_consumption | Consumption | deleted_by | BIGINT | 否 | 删除人账号 ID，未删除为空 | 普通 |
| edu_consumption | Consumption | version | INT | 是 | 乐观锁版本号，写操作必须校验 | 普通 |
| edu_consumption | Consumption | lesson_id | BIGINT | 是 | 课次 ID | 普通 |
| edu_consumption | Consumption | student_id | BIGINT | 是 | 学员 ID | 普通 |
| edu_consumption | Consumption | contract_id | BIGINT | 是 | 合同 ID | 普通 |
| edu_consumption | Consumption | consumed_hours | DECIMAL(8,2) | 是 | 消耗课时 | 普通 |
| edu_consumption | Consumption | consume_amount | DECIMAL(18,2) | 否 | 课消金额 | 普通 |
| edu_consumption | Consumption | consume_status | VARCHAR(32) | 是 | 待确认/已课消/已冲销/异常 | 普通 |
| mat_asset | Asset | id | BIGINT | 是 | 主键，雪花或号段生成，禁止复用 | 普通 |
| mat_asset | Asset | tenant_id | BIGINT | 是 | 集团/租户隔离字段，所有查询必须带租户上下文 | 普通 |
| mat_asset | Asset | org_id | BIGINT | 否 | 所属组织，集团级或公共配置为空 | 普通 |
| mat_asset | Asset | campus_id | BIGINT | 否 | 所属校区，跨校区或总部级数据为空 | 普通 |
| mat_asset | Asset | created_by | BIGINT | 是 | 创建人账号 ID | 普通 |
| mat_asset | Asset | created_at | DATETIME | 是 | 创建时间 | 普通 |
| mat_asset | Asset | updated_by | BIGINT | 否 | 最后更新人账号 ID | 普通 |
| mat_asset | Asset | updated_at | DATETIME | 否 | 最后更新时间 | 普通 |
| mat_asset | Asset | is_deleted | TINYINT | 是 | 是否已删除，0 未删除，1 已删除 | 普通 |
| mat_asset | Asset | deleted_at | DATETIME | 否 | 删除时间，未删除为空 | 普通 |
| mat_asset | Asset | deleted_by | BIGINT | 否 | 删除人账号 ID，未删除为空 | 普通 |
| mat_asset | Asset | version | INT | 是 | 乐观锁版本号，写操作必须校验 | 普通 |
| mat_asset | Asset | asset_no | VARCHAR(64) | 是 | 资产编号，唯一 | 普通 |
| mat_asset | Asset | sku_id | BIGINT | 是 | 资产 SKU | 普通 |
| mat_asset | Asset | owner_org_id | BIGINT | 否 | 归属组织 | 普通 |
| mat_asset | Asset | keeper_id | BIGINT | 否 | 保管人 | 普通 |
| mat_asset | Asset | purchase_date | DATE | 否 | 购置日期 | 普通 |
| mat_asset | Asset | asset_status | VARCHAR(32) | 是 | 在用/闲置/维修/报废/调拨中 | 普通 |
| mat_maintenance_order | AssetLifecycle/Maintenance | id | BIGINT | 是 | 主键，雪花或号段生成，禁止复用 | 普通 |
| mat_maintenance_order | AssetLifecycle/Maintenance | tenant_id | BIGINT | 是 | 集团/租户隔离字段，所有查询必须带租户上下文 | 普通 |
| mat_maintenance_order | AssetLifecycle/Maintenance | org_id | BIGINT | 否 | 所属组织，集团级或公共配置为空 | 普通 |
| mat_maintenance_order | AssetLifecycle/Maintenance | campus_id | BIGINT | 否 | 所属校区，跨校区或总部级数据为空 | 普通 |
| mat_maintenance_order | AssetLifecycle/Maintenance | created_by | BIGINT | 是 | 创建人账号 ID | 普通 |
| mat_maintenance_order | AssetLifecycle/Maintenance | created_at | DATETIME | 是 | 创建时间 | 普通 |
| mat_maintenance_order | AssetLifecycle/Maintenance | updated_by | BIGINT | 否 | 最后更新人账号 ID | 普通 |
| mat_maintenance_order | AssetLifecycle/Maintenance | updated_at | DATETIME | 否 | 最后更新时间 | 普通 |
| mat_maintenance_order | AssetLifecycle/Maintenance | is_deleted | TINYINT | 是 | 是否已删除，0 未删除，1 已删除 | 普通 |
| mat_maintenance_order | AssetLifecycle/Maintenance | deleted_at | DATETIME | 否 | 删除时间，未删除为空 | 普通 |
| mat_maintenance_order | AssetLifecycle/Maintenance | deleted_by | BIGINT | 否 | 删除人账号 ID，未删除为空 | 普通 |
| mat_maintenance_order | AssetLifecycle/Maintenance | version | INT | 是 | 乐观锁版本号，写操作必须校验 | 普通 |
| mat_maintenance_order | AssetLifecycle/Maintenance | maintenance_no | VARCHAR(64) | 是 | 维修单编号，唯一 | 普通 |
| mat_maintenance_order | AssetLifecycle/Maintenance | asset_id | BIGINT | 是 | 资产 ID | 普通 |
| mat_maintenance_order | AssetLifecycle/Maintenance | fault_desc | VARCHAR(512) | 是 | 故障描述 | 普通 |
| mat_maintenance_order | AssetLifecycle/Maintenance | repair_vendor_id | BIGINT | 否 | 维修供应商 | 普通 |
| mat_maintenance_order | AssetLifecycle/Maintenance | repair_amount | DECIMAL(18,2) | 否 | 维修金额 | 普通 |
| mat_maintenance_order | AssetLifecycle/Maintenance | maintenance_status | VARCHAR(32) | 是 | 待维修/维修中/已完成/已报废 | 普通 |
JSON 字段结构与校验
| 表名 | 对象 | 字段 | 结构编码 | 结构定义 | 校验规则 | 示例 |
|---|---|---|---|---|---|---|
| dev_face_dispatch_task | FaceDispatchTask | request_payload | SUPERVISION_PAYLOAD | {bizType:string, contractNo:string, amount:number, student:object, attachments:number[]} | 报送字段必须满足教育局/监管账户配置的必填规则 | {"bizType":"CONTRACT","contractNo":"DNC20260628001","amount":6800} |
| dev_face_dispatch_task | FaceDispatchTask | response_payload | SUPERVISION_PAYLOAD | {bizType:string, contractNo:string, amount:number, student:object, attachments:number[]} | 报送字段必须满足教育局/监管账户配置的必填规则 | {"bizType":"CONTRACT","contractNo":"DNC20260628001","amount":6800} |
| dev_face_event | FaceAttendanceEvent | raw_payload | SUPERVISION_PAYLOAD | {bizType:string, contractNo:string, amount:number, student:object, attachments:number[]} | 报送字段必须满足教育局/监管账户配置的必填规则 | {"bizType":"CONTRACT","contractNo":"DNC20260628001","amount":6800} |
| dev_face_revoke_task | FaceAuthorizationRevokeTask | device_scope | ORG_SCOPE | {scopeType:string, orgIds:number[], campusIds:number[], includeChildren:boolean} | 组织和校区必须在当前租户授权范围内 | {"scopeType":"CAMPUS","campusIds":[101,102],"includeChildren":false} |
状态/枚举标准字典
| 表名 | 对象 | 字段 | 枚举编码 | 取值 | 终态/流转规则 | 字段说明 |
|---|---|---|---|---|---|---|
| dev_face_device | FaceDevice | tenant_id | TENANT_ID | 集团、租户隔离字段 | 非终态，可按状态机或字典规则流转 | 集团/租户隔离字段，所有查询必须带租户上下文 |
| dev_face_device | FaceDevice | is_deleted | BOOL_DELETED | 0 未删除、1 已删除 | 非终态，可按状态机或字典规则流转 | 是否已删除，0 未删除，1 已删除 |
| dev_face_device | FaceDevice | vendor_code | VENDOR_CODE | 设备品牌、厂商 | 非终态，可按状态机或字典规则流转 | 设备品牌/厂商 |
| dev_face_device | FaceDevice | device_status | DEVICE_STATUS | ONLINE 在线、OFFLINE 离线、DISABLED 停用、ABNORMAL 异常 | 包含终态，终态禁止直接编辑，需走变更/红冲/撤回流程 | 在线/离线/停用/异常 |
| dev_face_person | FacePerson | tenant_id | TENANT_ID | 集团、租户隔离字段 | 非终态，可按状态机或字典规则流转 | 集团/租户隔离字段，所有查询必须带租户上下文 |
| dev_face_person | FacePerson | is_deleted | BOOL_DELETED | 0 未删除、1 已删除 | 非终态，可按状态机或字典规则流转 | 是否已删除，0 未删除，1 已删除 |
| dev_face_person | FacePerson | person_type | PERSON_TYPE | 学员、教师、员工 | 非终态，可按状态机或字典规则流转 | 学员/教师/员工 |
| dev_face_person | FacePerson | sync_status | SYNC_STATUS | 待下发、已下发、失败、已撤销 | 包含终态，终态禁止直接编辑，需走变更/红冲/撤回流程 | 待下发/已下发/失败/已撤销 |
| dev_face_dispatch_task | FaceDispatchTask | tenant_id | TENANT_ID | 集团、租户隔离字段 | 非终态，可按状态机或字典规则流转 | 集团/租户隔离字段，所有查询必须带租户上下文 |
| dev_face_dispatch_task | FaceDispatchTask | is_deleted | BOOL_DELETED | 0 未删除、1 已删除 | 非终态，可按状态机或字典规则流转 | 是否已删除，0 未删除，1 已删除 |
| dev_face_dispatch_task | FaceDispatchTask | action_type | ACTION_TYPE | 新增、更新、删除、重试 | 非终态，可按状态机或字典规则流转 | 新增/更新/删除/重试 |
| dev_face_dispatch_task | FaceDispatchTask | task_status | TASK_STATUS | 待执行、成功、失败、重试中 | 包含终态，终态禁止直接编辑，需走变更/红冲/撤回流程 | 待执行/成功/失败/重试中 |
| dev_face_event | FaceAttendanceEvent | tenant_id | TENANT_ID | 集团、租户隔离字段 | 非终态，可按状态机或字典规则流转 | 集团/租户隔离字段，所有查询必须带租户上下文 |
| dev_face_event | FaceAttendanceEvent | is_deleted | BOOL_DELETED | 0 未删除、1 已删除 | 非终态，可按状态机或字典规则流转 | 是否已删除，0 未删除，1 已删除 |
| dev_face_event | FaceAttendanceEvent | match_status | MATCH_STATUS | 已匹配、低置信、未匹配、重复 | 非终态，可按状态机或字典规则流转 | 已匹配/低置信/未匹配/重复 |
| dev_face_revoke_task | FaceAuthorizationRevokeTask | tenant_id | TENANT_ID | 集团、租户隔离字段 | 非终态，可按状态机或字典规则流转 | 集团/租户隔离字段，所有查询必须带租户上下文 |
| dev_face_revoke_task | FaceAuthorizationRevokeTask | is_deleted | BOOL_DELETED | 0 未删除、1 已删除 | 非终态，可按状态机或字典规则流转 | 是否已删除，0 未删除，1 已删除 |
| dev_face_revoke_task | FaceAuthorizationRevokeTask | device_scope | DEVICE_SCOPE | ALL_DEVICE 全部设备、CAMPUS_DEVICE 校区设备、CLASSROOM_DEVICE 教室设备、SELECTED_DEVICE 指定设备 | 非终态，可按状态机或字典规则流转 | 撤销设备范围 |
| dev_face_revoke_task | FaceAuthorizationRevokeTask | revoke_status | REVOKE_STATUS | 待撤销、部分成功、成功、失败 | 包含终态，终态禁止直接编辑，需走变更/红冲/撤回流程 | 待撤销/部分成功/成功/失败 |
敏感字段与数据安全策略
| 来源 | 表名 | 对象 | 字段 | 数据级别 | 脱敏/返回策略 | 明文查看条件 | 导出策略 | 审计要求 | 端侧展示规则 |
|---|---|---|---|---|---|---|---|---|---|
| 本模块对象 | dev_face_person | FacePerson | photo_file_id | 高敏 | FACE_IMAGE_PROTECTED | 默认只返回受控文件 ID/缩略图；人脸照片查看、下发、删除需授权和审计 | 禁止常规导出；仅设备下发、授权撤回和合规取证场景允许 | 人脸采集、下发、识别、撤回、删除、失败重试全链路留痕 | 未授权端不展示原图；设备端按任务有效期拉取 |
| 本模块对象 | dev_face_person | FacePerson | valid_until | 普通 | BIZ_FIELD_MASK | 按字段权限、数据范围和业务角色展示；明文查看按敏感字段审批规则执行 | 导出时按数据级别触发审批、水印、下载有效期和日志 | 查看、修改、删除、导出、下载和审批均记录操作审计 | 默认遵循总部、区域、校区、团队、本人数据范围和端侧最小可见原则 |
| 本模块对象 | dev_face_dispatch_task | FaceDispatchTask | request_payload | 普通 | PAYLOAD_DESENSITIZE | 接口报文、快照和文件地址默认脱敏；排障查看需运维/安全授权 | 导出日志或报文时自动清理手机号、证件号、密钥、票据和人脸字段 | 查看报文、下载附件、失败重放和人工补偿均记录审计 | 业务端展示摘要和状态，完整报文仅运维/安全后台查看 |
| 本模块对象 | dev_face_dispatch_task | FaceDispatchTask | response_payload | 普通 | PAYLOAD_DESENSITIZE | 接口报文、快照和文件地址默认脱敏；排障查看需运维/安全授权 | 导出日志或报文时自动清理手机号、证件号、密钥、票据和人脸字段 | 查看报文、下载附件、失败重放和人工补偿均记录审计 | 业务端展示摘要和状态，完整报文仅运维/安全后台查看 |
| 本模块对象 | dev_face_event | FaceAttendanceEvent | raw_payload | 敏感 | PAYLOAD_DESENSITIZE | 接口报文、快照和文件地址默认脱敏；排障查看需运维/安全授权 | 导出日志或报文时自动清理手机号、证件号、密钥、票据和人脸字段 | 查看报文、下载附件、失败重放和人工补偿均记录审计 | 业务端展示摘要和状态，完整报文仅运维/安全后台查看 |
| 引用对象 | sys_user | User/Employee | mobile | 敏感 | MOBILE_MASK | 默认展示 138****0000；明文查看需字段权限或敏感字段查看审批 | 导出手机号必须触发导出审批、下载水印和有效期控制 | 明文查看、复制、导出和批量下载均写入 SensitiveAccessLog | PC 管理端按字段权限展示；移动端仅展示本人授权范围内脱敏信息 |
| 引用对象 | sys_user | User/Employee | password_hash | 高敏 | NEVER_RETURN | 禁止接口返回明文；仅密钥中心/鉴权服务按服务身份读取密钥引用 | 禁止导出；配置导出只允许导出脱敏引用和启停状态 | 配置新增、修改、启停、轮换和失败读取均记录安全审计 | 前端只展示已配置/未配置、到期时间和连通性状态，不展示密钥值 |
| 引用对象 | int_integration_log | IntegrationLog | request_payload | 敏感 | PAYLOAD_DESENSITIZE | 接口报文、快照和文件地址默认脱敏；排障查看需运维/安全授权 | 导出日志或报文时自动清理手机号、证件号、密钥、票据和人脸字段 | 查看报文、下载附件、失败重放和人工补偿均记录审计 | 业务端展示摘要和状态，完整报文仅运维/安全后台查看 |
| 引用对象 | int_integration_log | IntegrationLog | response_payload | 普通 | PAYLOAD_DESENSITIZE | 接口报文、快照和文件地址默认脱敏；排障查看需运维/安全授权 | 导出日志或报文时自动清理手机号、证件号、密钥、票据和人脸字段 | 查看报文、下载附件、失败重放和人工补偿均记录审计 | 业务端展示摘要和状态，完整报文仅运维/安全后台查看 |
| 引用对象 | sec_sensitive_field_policy | SensitiveFieldPolicy | mask_rule | 普通 | BIZ_FIELD_MASK | 按字段权限、数据范围和业务角色展示；明文查看按敏感字段审批规则执行 | 导出时按数据级别触发审批、水印、下载有效期和日志 | 查看、修改、删除、导出、下载和审批均记录操作审计 | 默认遵循总部、区域、校区、团队、本人数据范围和端侧最小可见原则 |
| 引用对象 | stu_student | Student | remark | 普通 | BIZ_FIELD_MASK | 按字段权限、数据范围和业务角色展示；明文查看按敏感字段审批规则执行 | 导出时按数据级别触发审批、水印、下载有效期和日志 | 查看、修改、删除、导出、下载和审批均记录操作审计 | 默认遵循总部、区域、校区、团队、本人数据范围和端侧最小可见原则 |
| 引用对象 | edu_attendance | Attendance | checkin_type | 普通 | FACE_IMAGE_PROTECTED | 默认只返回受控文件 ID/缩略图；人脸照片查看、下发、删除需授权和审计 | 禁止常规导出；仅设备下发、授权撤回和合规取证场景允许 | 人脸采集、下发、识别、撤回、删除、失败重试全链路留痕 | 未授权端不展示原图；设备端按任务有效期拉取 |
核心数据表完整字段
| 表名 | 对象 | 字段 | 类型 | 必填 | 规则 | 数据级别 |
|---|---|---|---|---|---|---|
| dev_face_device | FaceDevice | id | BIGINT | 是 | 主键，雪花或号段生成，禁止复用 | 普通 |
| dev_face_device | FaceDevice | tenant_id | BIGINT | 是 | 集团/租户隔离字段，所有查询必须带租户上下文 | 普通 |
| dev_face_device | FaceDevice | org_id | BIGINT | 否 | 所属组织，集团级或公共配置为空 | 普通 |
| dev_face_device | FaceDevice | campus_id | BIGINT | 否 | 所属校区，跨校区或总部级数据为空 | 普通 |
| dev_face_device | FaceDevice | created_by | BIGINT | 是 | 创建人账号 ID | 普通 |
| dev_face_device | FaceDevice | created_at | DATETIME | 是 | 创建时间 | 普通 |
| dev_face_device | FaceDevice | updated_by | BIGINT | 否 | 最后更新人账号 ID | 普通 |
| dev_face_device | FaceDevice | updated_at | DATETIME | 否 | 最后更新时间 | 普通 |
| dev_face_device | FaceDevice | is_deleted | TINYINT | 是 | 是否已删除，0 未删除，1 已删除 | 普通 |
| dev_face_device | FaceDevice | deleted_at | DATETIME | 否 | 删除时间，未删除为空 | 普通 |
| dev_face_device | FaceDevice | deleted_by | BIGINT | 否 | 删除人账号 ID，未删除为空 | 普通 |
| dev_face_device | FaceDevice | version | INT | 是 | 乐观锁版本号，写操作必须校验 | 普通 |
| dev_face_device | FaceDevice | device_code | VARCHAR(64) | 是 | 设备编码，唯一 | 普通 |
| dev_face_device | FaceDevice | vendor_code | VARCHAR(32) | 是 | 设备品牌/厂商 | 普通 |
| dev_face_device | FaceDevice | device_name | VARCHAR(128) | 是 | 设备名称 | 普通 |
| dev_face_device | FaceDevice | classroom_id | BIGINT | 否 | 绑定教室 ID | 普通 |
| dev_face_device | FaceDevice | api_endpoint | VARCHAR(512) | 否 | 设备或平台 API 地址 | 普通 |
| dev_face_device | FaceDevice | device_status | VARCHAR(32) | 是 | 在线/离线/停用/异常 | 普通 |
| dev_face_person | FacePerson | id | BIGINT | 是 | 主键，雪花或号段生成，禁止复用 | 普通 |
| dev_face_person | FacePerson | tenant_id | BIGINT | 是 | 集团/租户隔离字段，所有查询必须带租户上下文 | 普通 |
| dev_face_person | FacePerson | org_id | BIGINT | 否 | 所属组织，集团级或公共配置为空 | 普通 |
| dev_face_person | FacePerson | campus_id | BIGINT | 否 | 所属校区，跨校区或总部级数据为空 | 普通 |
| dev_face_person | FacePerson | created_by | BIGINT | 是 | 创建人账号 ID | 普通 |
| dev_face_person | FacePerson | created_at | DATETIME | 是 | 创建时间 | 普通 |
| dev_face_person | FacePerson | updated_by | BIGINT | 否 | 最后更新人账号 ID | 普通 |
| dev_face_person | FacePerson | updated_at | DATETIME | 否 | 最后更新时间 | 普通 |
| dev_face_person | FacePerson | is_deleted | TINYINT | 是 | 是否已删除，0 未删除，1 已删除 | 普通 |
| dev_face_person | FacePerson | deleted_at | DATETIME | 否 | 删除时间，未删除为空 | 普通 |
| dev_face_person | FacePerson | deleted_by | BIGINT | 否 | 删除人账号 ID，未删除为空 | 普通 |
| dev_face_person | FacePerson | version | INT | 是 | 乐观锁版本号，写操作必须校验 | 普通 |
| dev_face_person | FacePerson | person_no | VARCHAR(64) | 是 | 人员编号，唯一 | 普通 |
| dev_face_person | FacePerson | person_type | VARCHAR(32) | 是 | 学员/教师/员工 | 普通 |
| dev_face_person | FacePerson | person_id | BIGINT | 是 | 业务人员 ID | 普通 |
| dev_face_person | FacePerson | photo_file_id | BIGINT | 是 | 人脸照片文件 ID | 高敏 |
| dev_face_person | FacePerson | valid_until | DATETIME | 否 | 授权有效期 | 普通 |
| dev_face_person | FacePerson | sync_status | VARCHAR(32) | 是 | 待下发/已下发/失败/已撤销 | 普通 |
| dev_face_dispatch_task | FaceDispatchTask | id | BIGINT | 是 | 主键，雪花或号段生成，禁止复用 | 普通 |
| dev_face_dispatch_task | FaceDispatchTask | tenant_id | BIGINT | 是 | 集团/租户隔离字段，所有查询必须带租户上下文 | 普通 |
| dev_face_dispatch_task | FaceDispatchTask | org_id | BIGINT | 否 | 所属组织，集团级或公共配置为空 | 普通 |
| dev_face_dispatch_task | FaceDispatchTask | campus_id | BIGINT | 否 | 所属校区，跨校区或总部级数据为空 | 普通 |
| dev_face_dispatch_task | FaceDispatchTask | created_by | BIGINT | 是 | 创建人账号 ID | 普通 |
| dev_face_dispatch_task | FaceDispatchTask | created_at | DATETIME | 是 | 创建时间 | 普通 |
| dev_face_dispatch_task | FaceDispatchTask | updated_by | BIGINT | 否 | 最后更新人账号 ID | 普通 |
| dev_face_dispatch_task | FaceDispatchTask | updated_at | DATETIME | 否 | 最后更新时间 | 普通 |
| dev_face_dispatch_task | FaceDispatchTask | is_deleted | TINYINT | 是 | 是否已删除，0 未删除，1 已删除 | 普通 |
| dev_face_dispatch_task | FaceDispatchTask | deleted_at | DATETIME | 否 | 删除时间，未删除为空 | 普通 |
| dev_face_dispatch_task | FaceDispatchTask | deleted_by | BIGINT | 否 | 删除人账号 ID，未删除为空 | 普通 |
| dev_face_dispatch_task | FaceDispatchTask | version | INT | 是 | 乐观锁版本号，写操作必须校验 | 普通 |
| dev_face_dispatch_task | FaceDispatchTask | task_no | VARCHAR(64) | 是 | 任务编号，唯一 | 普通 |
| dev_face_dispatch_task | FaceDispatchTask | device_id | BIGINT | 是 | 设备 ID | 普通 |
| dev_face_dispatch_task | FaceDispatchTask | person_id | BIGINT | 是 | 人员库 ID | 普通 |
| dev_face_dispatch_task | FaceDispatchTask | action_type | VARCHAR(32) | 是 | 新增/更新/删除/重试 | 普通 |
| dev_face_dispatch_task | FaceDispatchTask | request_payload | JSON | 是 | 下发请求 | 普通 |
| dev_face_dispatch_task | FaceDispatchTask | response_payload | JSON | 否 | 设备响应 | 普通 |
| dev_face_dispatch_task | FaceDispatchTask | task_status | VARCHAR(32) | 是 | 待执行/成功/失败/重试中 | 普通 |
| dev_face_event | FaceAttendanceEvent | id | BIGINT | 是 | 主键，雪花或号段生成，禁止复用 | 普通 |
| dev_face_event | FaceAttendanceEvent | tenant_id | BIGINT | 是 | 集团/租户隔离字段，所有查询必须带租户上下文 | 普通 |
| dev_face_event | FaceAttendanceEvent | org_id | BIGINT | 否 | 所属组织，集团级或公共配置为空 | 普通 |
| dev_face_event | FaceAttendanceEvent | campus_id | BIGINT | 否 | 所属校区，跨校区或总部级数据为空 | 普通 |
| dev_face_event | FaceAttendanceEvent | created_by | BIGINT | 是 | 创建人账号 ID | 普通 |
| dev_face_event | FaceAttendanceEvent | created_at | DATETIME | 是 | 创建时间 | 普通 |
| dev_face_event | FaceAttendanceEvent | updated_by | BIGINT | 否 | 最后更新人账号 ID | 普通 |
| dev_face_event | FaceAttendanceEvent | updated_at | DATETIME | 否 | 最后更新时间 | 普通 |
| dev_face_event | FaceAttendanceEvent | is_deleted | TINYINT | 是 | 是否已删除，0 未删除，1 已删除 | 普通 |
| dev_face_event | FaceAttendanceEvent | deleted_at | DATETIME | 否 | 删除时间，未删除为空 | 普通 |
| dev_face_event | FaceAttendanceEvent | deleted_by | BIGINT | 否 | 删除人账号 ID，未删除为空 | 普通 |
| dev_face_event | FaceAttendanceEvent | version | INT | 是 | 乐观锁版本号，写操作必须校验 | 普通 |
| dev_face_event | FaceAttendanceEvent | device_id | BIGINT | 是 | 设备 ID | 普通 |
| dev_face_event | FaceAttendanceEvent | device_event_id | VARCHAR(128) | 是 | 设备侧事件号 | 普通 |
| dev_face_event | FaceAttendanceEvent | person_id | BIGINT | 否 | 匹配人员 ID | 普通 |
| dev_face_event | FaceAttendanceEvent | lesson_id | BIGINT | 否 | 匹配课次 ID | 普通 |
| dev_face_event | FaceAttendanceEvent | event_time | DATETIME | 是 | 识别时间 | 普通 |
| dev_face_event | FaceAttendanceEvent | confidence | DECIMAL(8,4) | 是 | 识别置信度 | 普通 |
| dev_face_event | FaceAttendanceEvent | match_status | VARCHAR(32) | 是 | 已匹配/低置信/未匹配/重复 | 普通 |
| dev_face_event | FaceAttendanceEvent | raw_payload | JSON | 是 | 设备原始报文 | 敏感 |
| dev_face_revoke_task | FaceAuthorizationRevokeTask | id | BIGINT | 是 | 主键，雪花或号段生成，禁止复用 | 普通 |
| dev_face_revoke_task | FaceAuthorizationRevokeTask | tenant_id | BIGINT | 是 | 集团/租户隔离字段，所有查询必须带租户上下文 | 普通 |
| dev_face_revoke_task | FaceAuthorizationRevokeTask | org_id | BIGINT | 否 | 所属组织，集团级或公共配置为空 | 普通 |
| dev_face_revoke_task | FaceAuthorizationRevokeTask | campus_id | BIGINT | 否 | 所属校区，跨校区或总部级数据为空 | 普通 |
| dev_face_revoke_task | FaceAuthorizationRevokeTask | created_by | BIGINT | 是 | 创建人账号 ID | 普通 |
| dev_face_revoke_task | FaceAuthorizationRevokeTask | created_at | DATETIME | 是 | 创建时间 | 普通 |
| dev_face_revoke_task | FaceAuthorizationRevokeTask | updated_by | BIGINT | 否 | 最后更新人账号 ID | 普通 |
| dev_face_revoke_task | FaceAuthorizationRevokeTask | updated_at | DATETIME | 否 | 最后更新时间 | 普通 |
| dev_face_revoke_task | FaceAuthorizationRevokeTask | is_deleted | TINYINT | 是 | 是否已删除，0 未删除，1 已删除 | 普通 |
| dev_face_revoke_task | FaceAuthorizationRevokeTask | deleted_at | DATETIME | 否 | 删除时间，未删除为空 | 普通 |
| dev_face_revoke_task | FaceAuthorizationRevokeTask | deleted_by | BIGINT | 否 | 删除人账号 ID，未删除为空 | 普通 |
| dev_face_revoke_task | FaceAuthorizationRevokeTask | version | INT | 是 | 乐观锁版本号，写操作必须校验 | 普通 |
| dev_face_revoke_task | FaceAuthorizationRevokeTask | revoke_no | VARCHAR(64) | 是 | 撤销编号，唯一 | 普通 |
| dev_face_revoke_task | FaceAuthorizationRevokeTask | person_id | BIGINT | 是 | 人员库 ID | 普通 |
| dev_face_revoke_task | FaceAuthorizationRevokeTask | revoke_reason | VARCHAR(255) | 是 | 撤销原因 | 普通 |
| dev_face_revoke_task | FaceAuthorizationRevokeTask | device_scope | JSON | 是 | 撤销设备范围 | 普通 |
| dev_face_revoke_task | FaceAuthorizationRevokeTask | revoke_status | VARCHAR(32) | 是 | 待撤销/部分成功/成功/失败 | 普通 |
数据表与对象映射
| 表名 | 对象 | 用途 | 完整字段 | 索引建议 |
|---|---|---|---|---|
| dev_face_device | FaceDevice | 人脸识别考勤设备 | 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_status |
| dev_face_person | FacePerson | 人脸人员库 | 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,必填)、valid_until(DATETIME)、sync_status(VARCHAR(32),必填) | uk_person_type_id、idx_sync |
| dev_face_dispatch_task | FaceDispatchTask | 人脸下发任务 | 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_event | FaceAttendanceEvent | 人脸识别回传事件 | 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),必填)、raw_payload(JSON,必填) | uk_device_event、idx_lesson_person、idx_event_time |
| dev_face_revoke_task | FaceAuthorizationRevokeTask | 人脸授权撤销任务 | 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,必填)、revoke_no(VARCHAR(64),必填)、person_id(BIGINT,必填)、revoke_reason(VARCHAR(255),必填)、device_scope(JSON,必填)、revoke_status(VARCHAR(32),必填) | uk_revoke_no、idx_person_status |
12 · 状态机与业务规则
约束业务对象如何流转、何时可编辑、何时触发审批
原型需要把状态标签、可操作按钮和禁用原因展示清楚。| 对象 | 状态 | 触发与说明 |
|---|---|---|
| 人脸授权 | 未授权 -> 待采集 -> 已授权 -> 已下发 -> 撤回中 -> 已撤回 -> 已删除 | 家长授权、照片采集、设备下发、撤回授权 |
| 督课评分 | 待评分 -> 系统初评 -> 待复核 -> 已确认 -> 申诉中 -> 已调整 -> 已归档 | 学生数据采集、教师数据采集、系统评分、督课复核、校长确认和申诉处理 |
| 报销单 | 草稿 -> 待 OCR -> 待核验 -> 待审批 -> 已通过 -> 待付款 -> 已付款 -> 已驳回 -> 已作废 | 员工填单、票据识别、发票核验、查重、审批、付款归档 |
| 学习任务 | 未开始 -> 学习中 -> 已提交 -> 已批改 -> 需订正 -> 已完成 -> 已过期 | 资源学习、作业提交、教师批改和进度归档 |
| 员工培训 | 未分配 -> 待学习 -> 学习中 -> 待考试 -> 已通过 -> 未通过 -> 补训中 -> 已逾期 | 培训计划发布、学习进度、考试成绩、补考复训和学习档案归档 |
| 直播房间 | 草稿 -> 待开播 -> 直播中 -> 已结束 -> 回放生成中 -> 可回放 -> 异常 -> 已关闭 | 创建房间、供应商资源申请、教师开播、下课、录制转码、回放发布和异常关闭 |
| 直播连麦请求 | 未举手 -> 已举手排队 -> 教师邀请中 -> 连接中 -> 上麦中 -> 已下麦 -> 已拒绝 -> 已取消 -> 已超时 -> 连接失败 | 学员举手进入队列，教师处理后进入邀请和连接；取消、拒绝、超时、失败、下麦均写入互动事件和连麦请求记录 |
| 直播连麦座席 | 空闲 -> 占用中 -> 静音 -> 下麦中 -> 已释放 -> 异常 | 教师端按座席管理当前上麦人员，人数达到上限后新请求继续排队或提示人数已满 |
| 转班转课 | 待测算 -> 待确认 -> 审批中 -> 补差待收 -> 退差待退 -> 已生效 -> 已驳回 -> 已取消 | 顾问或教务发起，完成权益重算、家长确认、审批、收退差和课表变更 |
| 试听课 | 已预约 -> 已提醒 -> 已到访 -> 已试听 -> 待反馈 -> 已反馈 -> 已转化 -> 未到访 -> 已关闭 | 预约、提醒、到访签到、教师反馈、家长评价、未到访唤醒和转化 |
| 电子工资条 | 待生成 -> 待审核 -> 待发布 -> 已发布 -> 员工已查看 -> 异议中 -> 已确认 -> 已归档 | 薪资核算、审批、发布、员工查看确认、异议处理和归档 |
| 人脸授权撤回 | 已提交 -> 家长已确认 -> 设备删除中 -> 部分失败 -> 已删除 -> 人工处理 -> 已关闭 | 家长撤回、人脸模板删除任务、设备回执、失败重试和审计 |
| 工资条撤回重发 | 已发布 -> 撤回中 -> 已撤回 -> 重发待审核 -> 已重发 -> 待重新确认 -> 已确认 -> 已归档 | 工资条发布错误后撤回、重发、员工重新确认和版本留痕 |
| 国税核验配置 | 草稿 -> 启用中 -> 频控中 -> 异常 -> 已停用 -> 已过期 | 校区税务主体、官方接口凭证、额度、启用状态和调用日志 |
| 课堂端会话 | 待绑定 -> 已绑定 -> 待开课 -> 授课中 -> 暂停中 -> 已结束 -> 异常断开 | 教师或教室设备创建课堂会话，TV 与教师端完成绑定后同步课件、互动和课堂状态；断开后可重连，结束后归档审计。 |
| TV 课件播放 | 未加载 -> 加载中 -> 播放中 -> 暂停 -> 互动展示中 -> 播放失败 -> 已退出 | TV 端接收课堂联动指令，按课件类型播放或展示，失败时回传错误码并提示教师端重试。 |
| 教师端工作台任务 | 待处理 -> 处理中 -> 已完成 -> 已驳回 -> 已超时 -> 已取消 | 课程、批改、审批、培训、报销、工资条和直播任务统一进入工作台待办，并按业务模块回写处理状态。 |
| 员工推广资产 | 待生成 -> 已生成 -> 分享中 -> 已停用 -> 已失效 -> 生成失败 | 员工在教师端领取活动后生成专属短链、二维码和海报，活动停用或超期后资产失效 |
| 员工分享记录 | 已分享 -> 已访问 -> 已扫码 -> 已留资 -> 已生成线索 -> 已预约试听 -> 已签约 -> 已流失 | 外部访问、扫码、留资和转化阶段均回写员工分享记录 |
唯一性校验
智能考勤设备中心涉及该规则时，必须在前端提示、后端校验、审计日志和测试用例中同时覆盖。
跨校区数据隔离
智能考勤设备中心涉及该规则时，必须在前端提示、后端校验、审计日志和测试用例中同时覆盖。
敏感操作留痕
智能考勤设备中心涉及该规则时，必须在前端提示、后端校验、审计日志和测试用例中同时覆盖。
外部接口幂等
智能考勤设备中心涉及该规则时，必须在前端提示、后端校验、审计日志和测试用例中同时覆盖。
批量失败明细
智能考勤设备中心涉及该规则时，必须在前端提示、后端校验、审计日志和测试用例中同时覆盖。
状态回退审批
智能考勤设备中心涉及该规则时，必须在前端提示、后端校验、审计日志和测试用例中同时覆盖。
13 · 权限、审批与消息
动作权限、数据范围、审批触发和消息触达必须闭环
权限需要覆盖菜单、按钮、字段、接口和导出。动作权限
- 设备建档：需映射菜单、按钮、接口和字段权限
- 人员下发：需映射菜单、按钮、接口和字段权限
- 事件回传：需映射菜单、按钮、接口和字段权限
- 异常确认：需映射菜单、按钮、接口和字段权限
- 授权撤回：需映射菜单、按钮、接口和字段权限
- 模板删除：需映射菜单、按钮、接口和字段权限
- 设备巡检：需映射菜单、按钮、接口和字段权限
数据范围
- 总部全量
- 区域辖区
- 校区本地
- 部门/岗位
- 本人负责
- 授权班级/学员
审批配置
| 审批名称 | 触发条件 | 流程 | 结果 | 留痕 |
|---|---|---|---|---|
| 报销审批 | 员工提交费用报销或发票查重命中风险 | 员工提交 -> 部门主管 -> 校长/预算负责人 -> 财务复核 | 通过后进入付款，驳回后返回报销人修改 | 保留票据影像、OCR 结果、核验结果、查重结果和审批意见 |
| 账套反结账审批 | 已结账期间需要反结账或更正税务资料 | 校区财务提交 -> 总部财务复核 -> 财务负责人终审 | 通过后解锁期间并记录调整原因 | 保留反结账前后凭证、税表和审批说明 |
| 物料采购审批 | 采购金额超过阈值、跨校区采购或固定资产采购 | 申请人 -> 校区负责人 -> 采购/财务 -> 总部审批 | 通过后生成采购订单和到货验收任务 | 保留预算、供应商、报价和采购合同附件 |
| 固定资产报废审批 | 固定资产、图书或高价值物料需要报废 | 责任人提交 -> 校区负责人 -> 资产管理员 -> 财务复核 | 通过后出库、报废并生成财务核销记录 | 保留照片、盘点记录、处置说明和残值 |
| 转校审批 | 学员权益跨校区转移 | 原校区校长 -> 目标校区校长 -> 财务确认 | 权益和服务归属迁移 | 记录转出转入校区和余额 |
| 人脸授权撤回处理 | 家长撤回人脸授权 | 家长提交 -> 系统确认 -> 设备管理员执行 | 停止识别并下发删除任务 | 保留撤回凭证和删除结果 |
| 督课评分复核 | 教学质量分低于阈值、教师提出申诉或总部抽检命中 | 教研督导 -> 校长/区域教学负责人 -> 总部教研 | 维持评分、调整评分或生成整改复训任务 | 保留评分明细、回放片段、调整原因和复核人 |
| 培训课程发布审批 | 面向全员、跨校区或涉及制度类培训内容 | 人事/教研提交 -> 部门负责人 -> 总部审核 | 发布培训计划或退回修改 | 记录适用岗位、资料版本和考试规则 |
消息模板
| 消息 | 接收人 | 触发 | 渠道 | 变量 |
|---|---|---|---|---|
| 新线索分配提醒 | 课程顾问 | 线索分配成功 | 站内信、App、企微 | 学员姓名、来源渠道、校区、保护期 |
| 试听预约通知 | 家长/教师/顾问 | 试听课预约成功或变更 | 小程序、短信、App | 上课时间、校区、教室、教师 |
| 库存预警 | 库管/校区负责人 | 物料或礼品低于安全库存 | 站内信、App、企微 | SKU、校区、当前库存、安全库存、补货建议 |
| 积分兑换核销通知 | 学员/家长/校区前台 | 兑换成功、即将过期或核销完成 | 小程序、App、站内信 | 礼品名称、兑换码、核销校区、有效期 |
| 到校签到通知 | 家长 | 人脸或人工签到成功 | 小程序、App | 学员姓名、签到时间、校区、课程 |
| 签到异常提醒 | 教务/前台 | 识别未匹配或低置信度 | 站内信、App | 设备、时间、候选学员、置信度 |
| 摄像头离线告警 | 设备管理员/校区前台 | 摄像头心跳超时或拉流失败 | 站内信、App | 校区、教室、摄像头编号、品牌、异常时间 |
| 巡课整改通知 | 校长/教师/教研督导 | 督课记录生成整改项 | 站内信、App、企微 | 督课任务、问题等级、整改期限、回放片段 |
14 · 接口与技术细节
接口需支持幂等、权限、审计、重试和回执
每个写接口必须有 requestId 或业务幂等键，外部回调必须验签和去重。| 接口 | 方法 | 方向 | 请求字段 | 响应字段 | 幂等/权限 |
|---|---|---|---|---|---|
| /api/v1/face/persons | POST | 平台到设备网关 | personId, name, photoUrl, campusId, validUntil | deviceTaskId, dispatchStatus | personId + deviceId 幂等 |
| /api/v1/face/events | POST | 设备到平台 | deviceId, personId, eventTime, confidence, photoId | attendanceId, matchStatus, action | deviceId + eventId 去重 |
| /api/v1/face/devices/{id}/heartbeat | POST | 设备到平台 | deviceId, appVersion, onlineStatus, metrics | serverTime, commands | 设备签名校验 |
| /api/v1/face/authorizations/{id}/revoke | POST | 家长/平台到设备网关 | authorizationId, guardianConfirm, revokeReason, requestId | revokeTaskId, revokeStatus, deviceDeleteStatus | requestId 幂等；设备离线进入延迟删除 |
前端约束
- 统一登录态和租户校区上下文
- 列表分页、筛选、排序、列显隐
- 表单本地校验与服务端错误映射
- 移动/平板/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_status | uk_device_code、idx_campus_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、valid_until、sync_status | uk_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_status | uk_task_no、idx_device_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、raw_payload | uk_device_event、idx_lesson_person、idx_event_time |
| dev_face_revoke_task | 人脸授权撤销任务 | id、tenant_id、org_id、campus_id、created_by、created_at、updated_by、updated_at、is_deleted、deleted_at、deleted_by、version、revoke_no、person_id、revoke_reason、device_scope、revoke_status | uk_revoke_no、idx_person_status |
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 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 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_status` (`campus_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；数据级别：高敏',
`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_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 '已匹配/低置信/未匹配/重复；数据级别：普通',
`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` (`device_event_id`, `event_time`),
KEY `idx_tenant_deleted` (`tenant_id`, `is_deleted`)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_0900_ai_ci COMMENT='FaceAttendanceEvent：人脸识别回传事件';dev_face_revoke_taskFaceAuthorizationRevokeTask
CREATE TABLE `dev_face_revoke_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 '乐观锁版本号，写操作必须校验；数据级别：普通',
`revoke_no` VARCHAR(64) NOT NULL COMMENT '撤销编号，唯一；数据级别：普通',
`person_id` BIGINT NOT NULL COMMENT '人员库 ID；数据级别：普通',
`revoke_reason` VARCHAR(255) NOT NULL COMMENT '撤销原因；数据级别：普通',
`device_scope` JSON NOT NULL COMMENT '撤销设备范围；数据级别：普通',
`revoke_status` VARCHAR(32) NOT NULL COMMENT '待撤销/部分成功/成功/失败；数据级别：普通',
PRIMARY KEY (`id`),
UNIQUE KEY `uk_revoke_no` (`revoke_no`),
KEY `idx_person_status` (`person_id`, `revoke_status`),
KEY `idx_tenant_deleted` (`tenant_id`, `is_deleted`)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_0900_ai_ci COMMENT='FaceAuthorizationRevokeTask：人脸授权撤销任务';16 · 异常、指标、测试与初始化
保证模块上线后可运营、可追踪、可验收
测试要覆盖主流程、异常流、权限流、接口失败和数据一致性。异常状态
低置信度设备离线跨校区识别设备离线延迟删除模板删除失败撤回回执缺失家长确认超时
指标埋点
设备在线率人员下发成功率识别成功率自动签到率异常处理时长
测试用例
| 编号 | 场景 | 前置 | 步骤 | 预期 | 优先级 |
|---|---|---|---|---|---|
| TC-003 | 试听预约和反馈 | 线索已分配并选择体验课 | 预约试听、教师填写反馈 | 客户状态更新，生成报价任务 | 高 |
| TC-007 | 入班排课冲突校验 | 教师同时间已有课程 | 为同教师同时间排课 | 系统拦截并提示冲突对象 | 高 |
| TC-009 | 人脸未匹配异常 | 设备回传未绑定人员 | 提交识别事件 | 进入异常队列，可人工确认或忽略 | 高 |
| TC-010 | 家长撤回人脸授权 | 学员已授权并下发设备 | 家长撤回授权 | 系统停止识别并生成设备删除任务 | 高 |
| TC-013 | 教师发布作业并批改 | 课次已完成 | 教师发布作业，学员提交，教师批改 | 学员端展示批改结果和成长档案 | 中 |
| TC-017 | 薪资课酬核算 | 教师授课和课消数据完整 | 执行月度薪资核算 | 课酬、提成、冲回金额计算正确 | 中 |
| TC-021 | 跨校区数据隔离 | 创建两个校区和不同校区账号 | 校区 A 账号访问校区 B 客户 | 无法查看或仅显示授权范围数据 | 高 |
| TC-028 | 重复识别时间窗 | 同一学员短时间多次扫脸 | 连续提交识别事件 | 仅生成一次有效签到和课消 | 高 |
| TC-030 | 弱网课堂点评暂存 | 教师 App 处于弱网 | 填写课堂点评并提交 | 本地暂存，联网后自动同步 | 中 |
| TC-038 | 员工培训计划学习闭环 | 培训计划已发布并分配员工 | 员工打开培训、完成资料学习、提交考试 | 学习进度、考试成绩和员工培训档案完整 | 高 |
| TC-FAC-ENH-001 | 设备闭环交付闭环验收 | 设备列表、人员下发、识别流水、考勤异常相关基础数据、权限、审批流、消息模板和接口配置已初始化 | 按补齐设备下发回执、低置信度识别、重复识别、人工复核、自动签到和课消联动。执行前端提交、后端处理、状态流转、异常重试和消息触达 | 识别异常可人工确认，确认后同步教务考勤和课消状态。；同时产生审计日志、指标埋点和必要的补偿任务 | 高 |
| TC-FAC-ENH-002 | 隐私撤回交付闭环验收 | 人脸授权详情、撤回任务、设备回执相关基础数据、权限、审批流、消息模板和接口配置已初始化 | 按补齐撤回申请、家长确认、设备删除任务、失败重试、离线延迟删除和审计记录。执行前端提交、后端处理、状态流转、异常重试和消息触达 | 撤回后所有关联设备都有删除结果或人工处理记录。；同时产生审计日志、指标埋点和必要的补偿任务 | 高 |
| TC-FAC-ENH-003 | 运维联动交付闭环验收 | 设备告警、维修工单、资产详情相关基础数据、权限、审批流、消息模板和接口配置已初始化 | 按补齐离线告警、维修工单、资产状态、恢复校验和影响课次范围。执行前端提交、后端处理、状态流转、异常重试和消息触达 | 设备恢复后可自动回测签到、直播或录像相关能力。；同时产生审计日志、指标埋点和必要的补偿任务 | 高 |
上线初始化
| 初始化项 | 动作 | 数据 | 验收 |
|---|---|---|---|
| 组织与校区 | 导入集团、品牌、法人主体、区域、校区、部门、岗位 | 总部组织树、校区编码、法人关系、营业时间 | 组织层级正确且权限可继承 |
| 账号与权限 | 初始化总部、区域、校区、顾问、教务、教师、财务、家长、学员角色 | 账号、角色、菜单、按钮、字段、数据范围 | 测试账号可按角色访问指定页面 |
| 课程与价格 | 导入课程、班型、课包、课时、价格、适用校区 | 课程编码、班型、价格表、有效期、赠课规则 | 报价和合同可正确引用价格 |
| 优惠规则 | 初始化折扣、满减、优惠券、老带新、多科联报和组合包规则 | 规则编码、叠加互斥、适用课程、校区、有效期、审批阈值 | 报价单可正确计算并生成分摊明细 |
| 财务科目 | 配置收款、预收、课消收入、退费、薪资、报销和内置科目映射 | 科目、辅助核算、校区、项目、部门 | 凭证可生成并写入测试账套 |
| 多账套会计 | 按校区初始化独立账套、会计期间、凭证字、科目和税务参数 | 账套编码、法人主体、校区、期间、税种、申报模板 | 校区账套可独立记账，总部可汇总和复核 |
| 监管账户 | 维护资金监管账户和教育局监管平台参数 | 账户编号、校区映射、接口地址、证书、回调 | 合同、收款、课消、退费可报送测试 |
| 设备参数 | 登记人脸考勤机设备和校区绑定 | 设备编号、位置、API 密钥、心跳阈值、识别阈值 | 设备心跳正常且可接收人员下发 |
| 设备闭环交付配置 | 初始化补齐设备下发回执、低置信度识别、重复识别、人工复核、自动签到和课消联动。所需的页面入口、功能开关、审批流、消息模板、状态枚举、异常原因和角色权限 | 设备列表、人员下发、识别流水、考勤异常 | 识别异常可人工确认，确认后同步教务考勤和课消状态。 |
| 隐私撤回交付配置 | 初始化补齐撤回申请、家长确认、设备删除任务、失败重试、离线延迟删除和审计记录。所需的页面入口、功能开关、审批流、消息模板、状态枚举、异常原因和角色权限 | 人脸授权详情、撤回任务、设备回执 | 撤回后所有关联设备都有删除结果或人工处理记录。 |
| 运维联动交付配置 | 初始化补齐离线告警、维修工单、资产状态、恢复校验和影响课次范围。所需的页面入口、功能开关、审批流、消息模板、状态枚举、异常原因和角色权限 | 设备告警、维修工单、资产详情 | 设备恢复后可自动回测签到、直播或录像相关能力。 |