这个品类的数据长什么样
本页面向区县教研活动与听评课场景的部署运维与应用交接,材料来自教研活动通知、听课记录、评课纪要三类,字段含活动名称、授课教师、听课日期、评课意见、参与人签字与回执。通知按周更新,听课记录按课次生成,评课纪要按活动归档,三者日期与签字需互相咬合。材料进入对话日志与审计功能时,通知与纪要作为会话证据被拉取,听课记录作为待核对条目挂接在应用与会话维度下。对话记录接口只取会话证据,不写业务台账,业务成品由人工或外部系统据此登记、导出与复核,形成可交接的部署状态与操作记录。
配置怎么定
这一环由对话记录接口(按应用与会话维度)执行,输出会话消息列表与记录总数,含角色与引用信息。可交接的部署状态与操作记录由人工或外部系统接着完成,按交接单逐项核对版本、连接与任务记录三者是否一致。
| 对象 | 判断 | 核验动作 |
|---|---|---|
| 应用与会话标识 | 与实际应用、实际会话一致 | 在请求参数里核对两个标识的来源,确认chatId与dataId归属同一会话 |
| 分页参数 | 记录条数与总数对得上 | 连拉两页比对偏移与记录总数 total,响应 code 为200 时列表条数应等于 total |
| 角色字段 | 消息角色与原会话对应 | 看返回列表里两类角色的顺序,抽一条核对value中的引用与耗时字段 |
| 听课记录与评课纪要 | 活动名称、听课日期、参与人签字三者与通知对得上 | 按交接单逐项核对日期与签字,缺签字或回执的条目单独标出 |
容易做错的三处
- 现象:接口返回为空但界面上有会话。原因:应用与会话标识来源不一致,实际会话未落在该应用维度下。
- 现象:只取到第一页,导出记录缺引用。原因:分页偏移未翻到底,引用条数与引用内容预算未分开记录。
- 现象:通知、听课记录、评课纪要名称与日期对不上。原因:版本未同步,缺签字或回执,三者未按同一活动归档。
怎么确认配好了
本功能验收:按记录总数 total 翻页取全,抽一条核对角色、引用信息与时间,确认响应 code 为200 且列表条数与 total 一致。
业务测试:按交接单逐项核对一次,看缺哪一项记录,重点核对通知、听课记录、评课纪要的日期与签字。
- 按应用与会话维度拉取记录,连拉两页比对偏移与 total,记录缺失的引用条数。
- 打开一条记录核对角色字段与引用耗时,把听课记录、评课纪要的日期与签字逐项对照通知。