考勤记录 JSON 字段
考勤记录 JSON 使用包结构：
- version：数字，当前为 3
- exportedAt：ISO 时间戳
- session：考勤记录对象
考勤记录对象字段
Section titled “考勤记录对象字段”| 字段 | 类型 | 必需 | 说明 |
|---|---|---|---|
| id | number | 否 | 本地数据库键。 |
| sessionId | string | 是 | 载荷中的唯一记录 ID。 |
| originSessionKey | string | 是 | 跨运行环境逻辑身份键。 |
| sessionRevision | number | 是 | 单调递增值。 |
| recordSource | string | 是 | meeting_live、main_import 或 main_restore。 |
| startedAt | string | 是 | 追踪开始的 ISO 时间戳。 |
| endedAt | string | 否 | 追踪结束的 ISO 时间戳。 |
| isActive | boolean | 是 | 追踪进行中时为 true。 |
| needsExport | boolean | 是 | 待导出时为 true。 |
| mode | string | 是 | generic 或 roster。 |
| meetingUUID | string | 否 | Zoom 会议 UUID。 |
| meetingId | string | 否 | Zoom 会议 ID。 |
| meetingTopic | string | 否 | 会议主题文本。 |
| privilegeAcquiredAt | string | 是 | 角色权限确认的 ISO 时间戳。 |
| guessedProfileId | string | 否 | 自动选择的考勤配置提示。 |
| selectedProfileId | string | 否 | 显式使用的考勤配置。 |
| selectedIncludedSubgroups | string[] | 是 | 从选中配置捕获的子组范围。 |
| selectedGroupSortOrder | string[] | 否 | 从选中配置捕获的分组排序。 |
| movementEvents | array | 是 | 参与者移动事件时间线。 |
| sessionParticipants | array | 是 | 身份关联的参与者实体。 |
| rosterObservations | array | 是 | 会议期间捕获的轮询人员名单。 |
| nameChangeEvents | array | 是 | 显示名称变更时间线条目。 |
| latestRoster | array | 是 | 运行时最新实时花名册人员名单。 |
| manualSnapshots | array | 是 | 手动现场人员名单条目。 |
| reconciliationDecisions | array | 是 | 匹配后操作员决策列表。 |
| derivedRows | array | 是 | 为 UI 和导出计算的考勤行。 |
| exportedAt | string | 否 | 最新导出操作的 ISO 时间戳。 |
| raiseHandEntries | array | 是 | 举手/放下事件时间线条目。 |
| raiseHandCaptures | array | 是 | 举手捕获汇总人员名单。 |
| lastSubmittedAt | string | 否 | 最后同步提交的 ISO 时间戳。 |
| lateThresholdMinutes | number | 是 | 此记录使用的活跃迟到阈值。 |
| returnWindowMinutes | number | 是 | 此记录使用的活跃返回窗口。 |
必需的导入校验
Section titled “必需的导入校验”当任何必需字段校验失败时，导入拒绝载荷：
- sessionId 缺失
- originSessionKey 缺失
- startedAt 缺失
- mode 不是 generic 或 roster
- movementEvents 不是数组
- sessionParticipants 不是数组
- rosterObservations 不是数组
- nameChangeEvents 不是数组
- manualSnapshots 不是数组
- reconciliationDecisions 不是数组