这个品类的数据长什么样
区县教研活动与听评课的材料，主要来自教研活动通知、听课记录、评课纪要三类，按周次或活动批次更新，字段包含活动名称、日期、授课或听课人员、签字与回执。进入进度记录与统计核对功能时，通知承担活动立项与日期来源，听课记录承担节次与人员明细，评课纪要承担评议结论与签字凭据。三者按同一活动编号归集，进度表据此汇总记录数，统计口径说明写在表头，注明纳入范围、例外情形与签字要求。材料在部署环境中由业务侧整理后进入库，功能侧只负责连接与读写通道是否可用，不替业务判断两份材料里的名称、数量、日期是否对得上。
配置怎么定
这一环由部署环境的连接配置（服务端）执行，输出连接是否可用（服务启动结果与连接日志）。「进度表与统计口径说明」由部署交接与后续业务处理接着完成。主业务库、日志库、缓存与向量库可以分别指向不同实例，日志库不单独配置时复用主库。
| 对象 | 判断 | 核验动作 |
|---|---|---|
| 教研活动通知 | 字段含活动名称、日期、批次编号与落款；与听课记录、评课纪要的名称、日期须一致 | 在部署环境里核对该变量取值与库地址一致，确认通知记录写入主业务库 |
| 听课记录 | 字段含节次、授课人员、听课人员与签字；记录数与统计数须对得上 | 用客户端连一次缓存实例，核对返回；对照部署说明核对所选向量库与地址 |
| 评课纪要 | 字段含评议结论、签字与回执；版本须与通知、听课记录同步 | 查看日志库变量是否设置，核对日志写入的库；不单独配置时复用主库 |
| 进度表与统计口径说明 | 表头写明纳入范围、例外与签字要求；合计与一周记录逐条核得上 | 核对主业务库连接变量指向实际使用的主业务库且可连通 |
容易做错的三处
- 现象：同一活动在通知与听课记录里的名称、日期对不上。原因：两份材料各自录入，未按活动编号归集，版本未同步。
- 现象：评课纪要缺签字或回执，统计仍计入合计。原因：口径未在表头写明例外情形，核对时未逐条看签字栏。
- 现象：启动后日志持续报连接超时，检索报向量库错误。原因：连接地址与实际实例不一致，或日志库与主库混在同一处。
怎么确认配好了
本功能验收：逐项连一次主业务库、日志库、缓存与向量库，核启动日志里的连接结果，核对 MONGODB_URI、REDIS_URL、PG_URL 的取值与库地址一致。
业务测试：用一周记录核对合计，看口径与例外是否写清，并逐条核对通知、听课记录、评课纪要的名称、数量、日期与签字。
- 对照部署说明核对所选向量库与地址，确认连接变量指向实际使用的实例
- 查看日志库变量是否设置，核对日志写入的库，不单独配置时按说明复用主库