功能简介

科学城出勤统计用于科学城出勤补贴相关数据的收集、核对、统计与导出。它把「考勤表 → 出勤记录 → 补贴统计表」串成一条链路：综合办管理员导入考勤表确定每期需采集的人员与可申报日期，可选导入全院教师课表让系统按课表自动回填上课日的出勤记录与备注；教师（被采集人）在「我的填报」里核对并补全本人每一条出勤记录的备注；最后管理员按人员类别 / 提交状态 / 关键字筛选核对，一键导出「科学城出勤补贴统计.xlsx」。模块入口统一叫「科学城出勤统计」，但导出表单中仍保留考勤表、出勤记录表、工作补贴表等具体名称。

入口与权限

顶部导航 科学城出勤统计（图标为城市），仅在当前学院已开通本模块、且账号有对应权限时显示：

• 我的填报 科学城出勤统计 → 我的填报（/science_city_attendance/mine）——教师 / 被采集人及以上均可，维护本人出勤。
• 管理台 科学城出勤统计 → 管理台（/science_city_attendance/admin）——仅学院管理员 / 超级管理员（具备本模块管理权限）可见；普通教师看不到此项。
• 模块根路径 /science_city_attendance 是分发入口：有管理权限的账号自动跳「管理台」，其余跳「我的填报」。
• 学生不可见本模块。可见前提：当前学院已开通「科学城出勤统计」模块（学院级或校级组织开通），且账号具备访问 / 管理权限。校级（如综合办 / 质量科等组织角色）按已授权可见学院范围进入。

管理台内部以 Tab 组织：报表总览 (overview)、导入考勤表 (import)、导入全院教师课表 (course_import)、模块设置 (settings)。模块设置也有独立入口 /science_city_attendance/settings，内容与管理台「模块设置」Tab 一致。

操作步骤（分角色）

教师 / 被采集人：我的填报

1. 进入「我的填报」，系统按当前已发布批次显示本人记录。系统通过你的一卡通号（登录用户名）或真实姓名自动匹配到考勤表中的人员行——若管理员导入的考勤表里没有你，或姓名 / 一卡通对不上，列表会为空，需联系综合办管理员。
2. 列表只列出本报送周期内有出勤日期的记录。点开某条进入填报页。
3. 逐条核对出勤日期，并为每一条记录填写备注：先选「教学 / 非教学」类别，再填具体事由（备注下拉给出常用项：上课、监考、巡考、值班、新生报到、开会、其他等，也可手填）。
4. 保存草稿随时暂存；提交前系统强制校验——每一条出勤记录都必须有备注，否则提交被拦下。
5. 若本批次已关闭填报（管理员手动关闭或到达自动关闭日期），页面转为只读，不能再保存 / 提交，顶部会提示关闭原因。

教师只能看到、编辑属于自己且属于当前已发布批次的记录；越权访问他人记录或未发布批次会被拒绝（403）。

管理员：管理台标准流程

推荐顺序：模块设置 →（可选）导入课表 → 导入考勤表 → 发布 →（自动 / 手动）生成出勤记录 → 核对 → 导出 →（到期）关闭。

0. 选定报送周期（顶部公共区）

• 顶部公共区设「年份 + 报送周期 + 报送单位」。报送周期是固定的 8 档：1-3月(Q1)、4月、5月、6月、7-9月(Q3)、10月、11月、12月。后续导入 / 发布 / 导出都以此处选定的「年份 + 周期」为基准；切换会切到对应批次。

1. 模块设置（settings Tab）

• 课表自动生成开关：打开时走「设置学期首周周一 → 导入课表 → 自动生成上课记录」完整流程；关闭时无需上传课表，只激活考勤表导入，老师直接手填备注（此时课表相关设置项隐藏 / 禁用，报表页跳过课表前置检查）。
• 学期首周周一日期：课表「第 N 周星期 X」换算成真实日期的锚点，是自动生成出勤记录的必填前提。学院级未填时回退到中央库的全校默认值。
• 上课前 / 后一天有效：分别勾选后，系统在每个上课日的前一天 / 后一天也补一条出勤记录（备注标注「上课前一天到达有效 / 上课后一天离校有效」），用于覆盖到达 / 离校当天。
• 科学城课表筛选设置（排除教学楼）：选择视为「非科学城」的教学楼（默认排除第二、第三教学楼），课表里这些楼栋的课不计入科学城上课记录。
• 非教学人员名单：以本学院教师名单为候选（支持输入联想，chip 标签管理），列入者其出勤按「非教学」口径处理。
• 备注选项：维护填报页备注下拉的可选项。
• 填报截止日（fill_deadline_day, 1-31）+ 自动关闭开关：开启自动关闭后，到达「批次月份 + 截止日」当天起，老师端自动转只读。
• 默认报送人 / 审核人 / 公示通知 / 公示地点：写入导出表抬头的默认值。

2. 导入全院教师课表（course_import Tab，课表开关打开时）

• 上传课表 Excel，可同表填写 / 确认学期首周周一。系统按表头识别本科 / 研究生两类课表，各保留一份（再导入同类会覆盖旧课表并清理旧自动记录）。
• 导入即解析入库（不再依赖磁盘文件），并立即把课表行同步、按规则回填到当前批次的出勤记录，回显「保存课表 N 条、上课 N 条、前后一天补全 N 条」。

3. 导入考勤表（import Tab）

• 上传考勤表 Excel。系统从日期列识别文件覆盖的月份，并与顶部选定的报送周期做月份一致性校验：文件月份与所选周期无交集时拒绝导入并提示实际识别到的月份，避免「3 月文件导进 4 月周期」。
• 导入会覆盖同「年份 + 周期」的旧批次（提示覆盖了几个），按表中人员逐行建记录、按日期列建出勤条目（标记 import 来源）。若旧批次正是已发布批次，新批次自动接续发布。

4. 发布 / 生成 / 核对

• 发布批次：把当前周期批次设为老师端可见可填；老师端只认已发布批次。
• 生成出勤记录（course_generate）：课表开关开启且已填首周周一时，可按最新设置重新生成上课日及前后一天的出勤记录与备注。自动回填只覆盖自动来源的记录，不覆盖老师 / 管理员手工改过的记录。
• 核对：报表总览按关键字（姓名 / 单位 / 一卡通）、人员类别（教学 / 非教学）、提交状态（已提交 / 草稿）筛选；可代教师进入单人填报页编辑，也可「新增空白记录」补登未在考勤表中的人员。

5. 导出

• 「导出报表」下载 {年份}_{周期标签}_科学城出勤补贴统计.xlsx。工作簿按教职工与科学城常驻辅导员两组分别出汇总页，并按周期内每个月各出一张月度明细页。

6. 关闭填报

• 「关闭填报」把老师端转为只读（管理员仍可查看 / 编辑），用于截止后锁定数据；也可由「自动关闭 + 截止日」到期自动触发。

字段与状态口径

常见问题

• 我的填报是空的 / 点不进去：当前可能尚无已发布批次（联系管理员发布）；或考勤表里没有你这一行、姓名 / 一卡通号对不上（管理员核对考勤表人员，或用「新增空白记录」补登）；列表也只显示本周期内有出勤日期的记录。
• 提交时报「请为每一条记录填写备注」：提交强制每条出勤记录都有备注，逐条选好类别并填事由后再提交；想暂存可先「保存草稿」。
• 页面变只读、不能改：本批次已「关闭填报」或到达自动关闭截止日；如需补改请联系管理员重开或由管理员代改。
• 考勤表导入失败，提示月份不匹配：文件日期列识别到的月份与顶部所选报送周期没有交集。请把顶部周期调到与文件月份一致，或换用对应月份的考勤表。
• 导入课表后出勤记录没自动填上：确认①课表自动生成开关已打开；②已填「学期首周周一日期」；③课表里老师的一卡通 / 姓名能和考勤表人员匹配上（匹配不上算「未匹配教师」）；④上课地点不在被排除的教学楼。改好后可用「生成出勤记录」重算。
• 自动重算会不会冲掉我手填的备注：不会。自动回填只覆盖「自动来源」的记录；标记为 manual（人工改过）的记录保持不动。
• 常驻辅导员补贴天数对不上：常驻辅导员有「单月≥10 天 +4 天」奖励且整期封顶 26 天，与普通教职工「实际出勤天数=补贴天数」口径不同。

相关页面

• 监考安排管理 监考老师「特殊状态」含「常驻科学城」，与本模块的科学城常驻人员、校区出勤口径相关
• 全校课表统一管理 全校课表统一管理；本模块导入 / 生成出勤记录所依赖的本科 / 研究生课表与学期首周周一来源
• 教师信息维护 教师信息维护与一卡通号查询，是人员匹配（姓名 / 一卡通）与非教学人员名单的基础数据来源