这个品类的数据长什么样
本页面向学校德育与班主任工作场景,覆盖主题班会方案、学生综合素质记录、家访记录三类材料。这些材料通常由班主任或德育处起草,经年级组与德育处两级复核后归档,更新节奏以学期为周期,遇评优、检查或学生转学等节点需临时修订。字段特征集中在日期、数量与签字三类:班会方案含召开日期、活动项目数、班主任签字;综合素质记录含评价日期、获奖或活动条数、学生与家长签字;家访记录含家访日期、受访次数、教师与家长签字。材料进入对话日志与审计功能时,各自角色不同:班会方案作为对话中生成或修订的引用来源,综合素质记录作为需与对话内容比对的证据材料,家访记录作为带签字回执的原始凭证。对话记录接口只负责按应用与会话维度拉取消息,不承担业务台账的登记与版本判定。
配置怎么定
这一环由对话记录接口(按应用与会话维度)执行,输出会话消息列表与记录总数,含角色与引用信息。「版本台账与变更记录」由人工或外部系统接着完成。
| 对象 | 判断 | 核验动作 |
|---|---|---|
| 主题班会方案 | 同一方案在两份材料里的名称、项目数量、召开日期对不上;现行版本唯一、旧版可追 | 按 chatId 拉取会话消息,核对方案名称与日期字段是否与台账一致;翻页取全后比对记录总数 total 与响应 code 为200 |
| 学生综合素质记录 | 同一记录在两份材料里的获奖或活动条数、评价日期对不上;缺学生或家长签字 | 抽一条记录核对角色、引用信息与时间;用 dataId 定位单条消息,检查引用条数与引用文本 tokens 分别记录 |
| 家访记录 | 同一家访在两份材料里的受访次数、家访日期对不上;缺教师或家长签字与回执 | 按 value 查看单条记录详情,核对家访日期与次数;连拉两页比对偏移与记录总数 total |
| 会话消息列表 | 提问与回答两类消息主体可辨识出现,单条记录带引用与耗时 | 打开一条记录核对引用与耗时字段;确认消息条数与记录总数 total 不是同一量 |
容易做错的三处
- 现象:同一份主题班会方案在两份材料里的名称、项目数量与召开日期对不上。原因:版本未同步,旧版仍在被引用,未按现行版本唯一、旧版可追的要求做变更记录。
- 现象:学生综合素质记录里缺学生或家长签字,家访记录缺教师签字与回执。原因:签字与回执未纳入材料归档字段,复核环节只看内容不看签字栏。
- 现象:接口返回为空但界面上有会话,或只取到第一页,导出的记录缺少引用。原因:应用与会话标识来源不一致,分页参数未连拉两页比对记录总数 total 与偏移。
怎么确认配好了
本功能验收:按记录总数 total 翻页取全,抽一条核对角色、引用信息与时间;确认响应 code 为200,并用 _id、dataId、value 定位会话、单条消息与详情。
业务测试:改一处内容,看版本号与引用是否同步更新;确认现行版本唯一、旧版可追、引用同步。
- 按应用与会话维度分页拉取,连拉两页比对偏移与记录总数 total,确认记录条数与总数对得上
- 打开一条记录核对角色、引用与耗时字段,并用
dataId、value定位单条消息与详情