一、系统概述

本系统用于公司员工加班记录的填报、审批、统计与导出。

四种用户类型：

类型	权限概要
员工	提交加班记录、查看自己的记录与审批状态、重新编辑打回记录、查看统计
负责人	包含员工全部功能 + 项目管理、审批管理、导出加班数据
管理员	包含负责人全部功能 + 用户管理、注册审批
超级管理员	包含管理员全部功能 + 上报规则管理（控制截止日、封禁日期等）

访问地址：打开 https://zzwlzn.pages.dev/ 即可使用，需联网。

二、注册与登录

2.1 注册账号

1. 在登录页点击「没有账号？立即注册」
2. 填写用户名、密码（至少6位）、确认密码，选择角色（员工/负责人）
3. 点击「提交申请」
4. 等待管理员审核批准后方可登录

注意：注册申请需管理员在「用户管理」中批准后才能生效。

2.2 登录

1. 输入用户名和密码
2. 点击「登录」
3. 登录成功后进入主界面，左侧显示导航菜单

2.3 自动登录

系统会记住登录状态。关闭页面后重新打开，若密码未变更则自动登录。

2.4 退出登录

点击左侧导航栏底部的「退出登录」按钮。

三、员工功能

3.1 加班上报

进入「加班上报」页面：

手动上报：

1. 在「项目名称」下拉框中选择加班所属项目
2. 设置加班时间段：点击「+ 添加时间段」增加一个时间段，选择开始时间和结束时间（支持跨天，每段不超过24小时），系统会自动校验时间合法性
3. 点击「提交记录」确认并上传

快捷上报：以当日 17:30 为起始时间，点击对应按钮快速生成记录。可选按钮：18:00 ~ 23:30（每半小时一档）+ 00:00（跨天）。

节假日快捷上报：以当日 8:00 为起始时间，自动避开午休（12:00-13:30）。上午按钮（≤12:00）计入 8:00 到选定时间；下午按钮（≥13:30）自动拆为 8:00-12:00 + 13:30 到选定时间。

时间校验规则：

• 结束时间必须晚于开始时间
• 单个时间段不超过 24 小时
• 不得覆盖午休时间（12:00 - 13:30）
• 工作日不得覆盖正常工作时间（8:00-12:00, 13:30-17:30）
• 不得与已有记录的时间段重叠
• 受管理员配置的上报截止日规则约束（详见第六节）

提交失败处理：若因网络问题提交失败，记录会自动保存到待重传列表。可点击「🔄 重新上报」单独重传，或点击「清除失败记录」清空所有待重传记录。

3.2 查看加班记录与审批状态

进入「加班统计」页面，上方显示加班时长汇总。页面默认只显示当月的记录（含待审批），要看其他月份请选择月份后点「🔍 查询」。每条记录显示审批状态：⏳ 待审批、✅ 已审批、↩️ 已打回（含打回原因）。

3.3 重新编辑打回记录

当记录被负责人打回后：

1. 点击记录旁的「✏️ 重新编辑」
2. 系统自动跳转到加班上报页面，填入原记录的项目和时间段
3. 页面顶部显示黄色提示条
4. 修改后点击「↩️ 重新提交」
5. 提交成功后会删除原打回记录，新记录恢复为「待审批」状态
6. 如需放弃编辑，点击「取消编辑」（会弹出确认框）

3.4 下载 TXT

在加班上报页面点击「下载 TXT」可导出自己的所有加班记录为文本文件。

3.5 加班统计

默认只显示「当月」的加班记录，且不区分审批状态。要把其他月份的数据取下来看，请选择月份后点击「🔍 查询」——首次查询某个月份时会从云端加载，需要稍等几秒；已经加载过的月份会立即显示。

筛选模式（全部月份 / 单月筛选 / 多月筛选）、条形图展示各月加班统计、饼图展示加班项目分布、个人加班统计排行、最近15条加班结束时间趋势。选择「全部月份」后点「查询」会加载全部历史记录，数据量大时耗时较长。

3.6 按姓名 / 项目名称检索（负责人、管理员）

「加班统计」页顶部筛选区下方有一行检索条件：

• 👤 姓名：下拉选择某个人，只看他的加班记录（该下拉对员工隐藏）
• 🏷️ 项目名称：下拉选择某个项目
• 两个条件可叠加（同时满足），并且与上方的月份、审批状态筛选叠加
• 右侧「✖ 清空检索」一键清掉姓名和项目两个条件

检索结果直接显示在页面下方的「📋 加班记录」列表里，列表上方有一行汇总：共 N 条 / 合计 X 小时，并标出当前生效的检索条件与月份范围。若所选月份还没加载过，列表会提示先点「🔍 查询」把该月数据取下来。

3.7 净加班计算

进入「净加班计算」页面时，系统会自动加载所选用户的全部历史记录（净加班的跨月结转必须依赖完整历史），然后显示：本月总加班时长、输入本月请假小时数后保存、自动计算净加班时长 = 总加班 + 上月转入 - 本月请假、应发加班天数和本月剩余转入下月，以及各月历史汇总表格。

3.8 修改密码

进入「修改密码」页面：输入当前密码 → 输入新密码（至少6位）并确认 → 点击「修改密码」。

四、负责人功能

负责人拥有员工的所有功能，并额外具备以下功能。

4.1 审批管理

进入「审批管理」页面：

• 顶部统计栏：总记录数、已审批、待审批、已打回（全局真实数量）
• 筛选按钮：全部 / 待审批 / 已审批 / 已打回（默认停在「⏳ 待审批」）
• 月份筛选下拉框（选到尚未加载的月份会自动从云端拉取）
• 操作按钮：批量审批通过、导出审批记录

默认行为：打开本页时会自动把所有待审批的加班记录加载出来（不分月份），方便直接开始审批；如果没有待审批的记录，则不会进行任何加载，页面直接提示「当前没有待审批的加班记录」。判断"有没有待审批"只需列目录 + 读审批状态，不会下载记录内容。

关于其它状态：已审批 / 已打回的历史明细默认不加载。切到「全部」标签时顶部会出现提示，点击「加载全部历史记录」可拉取全部月份（数据量大时需等待）。批量审批只作用于已加载范围内的记录。

审批操作：查看每条记录详细信息 → 勾选记录（支持多选）→ 点击「审批通过」或「打回」（可填写打回原因）。已审批/已打回的记录可「取消审批」/「取消打回」恢复为待审批。

导出审批记录：按人员分组导出已审批记录，含每人小计和统计汇总。

4.2 项目管理

进入「项目管理」页面：

• 添加项目：输入项目名称，多个项目用 # 分隔，点击「发布项目」
• 删除项目：勾选要删除的项目 → 点击「删除选中」并确认
• 导出加班数据：选择年份 → 选择月份（可多选）→「导出记录(TXT)」或「导出统计(Excel)」（含三个工作表：加班记录明细、个人加班统计、项目加班统计）

五、管理员功能

管理员拥有负责人的所有功能，并额外具备以下功能。

5.1 用户管理

进入「用户管理」页面：

• 待审批注册申请：查看申请 → 点击「批准」或「拒绝」
• 用户管理：查看已注册用户列表、更改用户角色、修改用户密码、启用/禁用用户、删除用户（超级管理员不可删除）

5.2 管理员代报

管理员在加班上报页面顶部可选择用户，代替任意用户提交加班记录。

5.3 操作日志

进入「操作日志」页面，可查看谁在什么时候做了什么操作。默认显示最近 30 条，并且跨月：会载入最近两个月份的数据，每月各取一部分（两个月时各 15 条）合计 30 条，所以列表里一定看得到不止一个月；某个月条数不足时用相邻月份的记录补足。

• 「查看范围」下拉框：最近30条（跨月）/ 具体某个月 / 全部日志（加载全部）。选到某个月份时才去云端拉取那个月的数据，不会一次性下载全部历史。
• 「筛选用户」「筛选操作类型」只作用于已加载的范围；筛选后找不到记录时，请先把「查看范围」切到对应月份或「全部日志」。
• 列表底部显示「已显示 X / 共 Y 条」，可点「显示更多」逐步展开，或「全部显示」。
• 若顶部出现「⚠️ 检测到旧版日志文件尚未按月拆分」提示，点其中的「迁移历史日志」按钮拆分一次即可（原文件会改名备份，不会删数据，重复执行也不会重复）。

六、超级管理员功能（上报规则管理）

超级管理员（账号 Administrators）拥有管理员的所有功能，并额外拥有上报规则管理权限。

6.1 每月截止日规则

• 启用/禁用开关：控制是否启用"每月N号后禁止上报上月加班"规则
• 截止日设置：修改每月几号后禁止上报上月加班（默认 5 号，可设为 1~28 之间）

例：设为 10 → 每月 10 号后不可再提交上月时间段的加班记录。

6.2 逐月自定义截止日

可为特定月份单独设置不同的截止日，优先级高于全局截止日。

例：全局截止日为 5 号，但 2026 年 6 月单独设为 15 号 → 6 月 15 号后才不可上报 5 月加班。

6.3 自定义封禁日期

设置一个起始日期，该日期及之后的所有日期均不可上报加班（不受截止日规则影响）。

例：封禁 2026-07-01 → 7 月 1 日起的任何加班记录都无法提交。

6.4 指定日期规则（优先级最高）

对某个特定日期单独设置禁止或允许上报，将覆盖所有其他规则。

• 禁止上报：该日期不可提交加班
• 允许上报：该日期明确允许上报（即使被其他规则限制也会放行）

规则优先级（从高到低）：

优先级	规则类型	说明
🔴 最高	指定日期规则	精确到天，禁止则拒绝，允许则跳过后续检查
🟠 次高	自定义封禁日期	从某天起全部禁止
🟡 第三	每月截止日	每月N号后禁止上报上月

七、常见问题

文档版本：V1.2 · 最后更新：2026年6月