这个品类的数据长什么样
本页面向幼儿园家园共育沟通场景,材料来自日常对话记录、通知与反馈。品类核对维度包括承诺事项与回应时间、幼儿表现描述、家长诉求分类、通知送达。这些材料进入对话记录接口时,各自承担不同角色:承诺事项与回应时间用于核对是否闭环,幼儿表现描述用于比对观察记录,家长诉求分类用于判断反馈是否归类,通知送达用于确认触达。更新节奏按班级与时段滚动,字段特征含应用与会话标识、角色字段、引用与耗时字段。对话记录按应用与会话维度分页拉取,返回提问与回答两类角色,并带引用与耗时。材料进入该功能后,先形成会话证据,再由人工或外部系统登记为可交接的部署状态与操作记录。
配置怎么定
这一环由对话记录接口(按应用与会话维度)执行,输出会话消息列表与记录总数,含角色与引用信息。「可交接的部署状态与操作记录」由人工或外部系统接着完成。该接口只取会话证据,不写业务台账。
| 对象 | 判断 | 核验动作 |
|---|---|---|
| 应用与会话标识 | 与实际应用、实际会话一致,承诺事项与回应时间可回溯 | 在请求参数里核对 chatId 与 value 的来源,确认与当前应用、当前会话对应 |
| 分页参数 | 记录条数与记录总数对得上,家长诉求分类不遗漏 | 连拉两页比对记录总数 total 与偏移,确认响应 code 为200 且无重复 |
| 角色字段 | 消息角色与原会话对应,幼儿表现描述可定位 | 看返回列表里两类角色的顺序,抽一条核对角色与引用信息 |
| 引用与耗时字段 | 单条记录能看到引用与耗时,通知送达可核对 | 打开一条记录核对引用与耗时,引用条数按数组长度单独记录 |
容易做错的三处
- 现象:承诺事项在对话里出现但后续没有回应记录。原因:只取到第一页,后续页未拉取,导致记录总数与界面会话不一致。
- 现象:幼儿表现描述与观察记录不符。原因:消息列表被当作业务资料版本台账,未按角色与引用信息逐条比对。
- 现象:家长诉求分类缺失或反馈未归类。原因:接口返回为空但界面上有会话,未核对应用与会话标识来源。
怎么确认配好了
本功能验收:按记录总数 total 翻页取全,抽一条核对角色、引用信息与时间,确认响应 code 为200,并核对 _id、dataId、value 消息标识与内容字段。
业务测试:按交接单逐项核对一次,看缺哪一项记录,确认版本、连接、任务记录三者一致。
- 连拉两页比对记录总数 total 与偏移,确认无重复且响应
code为200。 - 打开一条记录核对角色、引用与耗时,引用条数按数组长度单独记录,引用上限核引用文本的 tokens。