这个品类的数据长什么样
本页面向外籍教师聘任与课程安排这一品类，材料来自聘任合同、工作许可材料、课程安排表三类文档，更新节奏为每批次聘任与排课完成后同步一次，字段特征包含教师姓名、证件号码、合同起止日期、许可编号、课程名称、课时数量、签字与回执。进入进度记录与统计核对功能时，聘任合同提供人员与期限字段，工作许可材料提供合规编号与有效期，课程安排表提供课程与课时字段，三者共同支撑进度表与统计口径说明的生成。材料在库内以记录形式存放，进度表按周或月汇总，统计口径需在表头写明计数规则与例外处理，确保记录数与统计数对得上。
配置怎么定
这一环由部署环境的连接配置（服务端）执行，输出连接是否可用（服务启动结果与连接日志）。「进度表与统计口径说明」由部署交接与后续业务处理接着完成。
| 对象 | 判断 | 核验动作 |
|---|---|---|
| 聘任合同 | 核对字段、日期与签字是否齐全，教师姓名与证件号码是否与工作许可材料一致 | 逐份比对合同起止日期与签字栏，核对姓名与证件号码，引用 MONGODB_URI 确认主业务库记录 |
| 工作许可材料 | 核对许可编号、有效期与回执是否与合同期限衔接 | 对照许可编号与有效期，检查回执是否缺失，引用 PG_URL 确认向量库检索结果 |
| 课程安排表 | 核对课程名称、课时数量与日期是否与合同及许可材料对应 | 逐条比对课程名称与课时数量，检查日期是否落在合同期内，引用 REDIS_URL 确认缓存连接 |
| 进度表与统计口径说明 | 核对记录数与统计数是否对得上，口径是否写到表头 | 用一周记录核对合计，检查例外是否写清，确认表头包含计数规则 |
容易做错的三处
- 现象：同一教师姓名在合同与许可材料中写法不一致。原因：录入时未统一字段格式，两份材料版本未同步。
- 现象：课程安排表课时数量与合同约定数量对不上。原因：排课调整后未回写合同字段，缺签字或回执确认。
- 现象：启动后日志持续报连接超时。原因：主业务库或缓存连接地址配置有误，服务无法建立连接。
怎么确认配好了
本功能验收：逐项连一次主业务库、日志库、缓存与向量库，核启动日志里的连接结果，确认 MONGODB_URI、PG_URL、REDIS_URL 对应实例可连通。
业务测试：用一周记录核对合计，看口径与例外是否写清，确认记录数与统计数对得上。
- 在部署环境里核对该变量取值与库地址一致，查看日志写入的库是否单独配置或复用主库。
- 用客户端连一次缓存实例，核对返回，对照部署说明核对所选向量库与地址。