⏰

方兴智印考勤系统

Fangxing Zhiyin Attendance System

📌 V1.0 · 旗舰版
📅 发布日期：2026年8月26日 🎁 免费试用：支持 90 天免费试用 🏢 适用场景：50人以下中小微企业考勤管理 🔒 权限模型：两级权限（管理员/普通用户） 📶 打卡方式：手机/电脑连接公司WiFi即打即走（免硬件）

1. 系统简介 概述

方兴智印考勤系统 是一款面向 50人以下中小微企业 的 轻量级、可私有化部署 的局域网Web考勤管理平台。 系统支持上下班打卡、迟到/早退/加班自动判定、多套考勤规则灵活切换、考勤统计报表、 Excel数据导入导出、操作日志审计等核心功能，能够完全满足中小企业的日常考勤管理需求。

🎯 核心特性

💻 技术架构

后端框架Python 3 + Flask
数据库SQLite（轻量级，无需额外部署）
前端框架Bootstrap 5 + Jinja2 模板引擎
部署方式局域网Web应用（支持 Windows / Linux / macOS）
并发支持30~50人同时使用（基于 SQLite 性能）
💡
适用场景 适合办公室坐班、门店、工厂等各类中小微企业的日常上下班打卡、考勤统计与工资核算依据生成。 员工手机连接公司WiFi即可打卡，无需打卡机硬件，天然防止远程代打卡。

2. 快速开始 入门

🚀 启动系统（Windows）

  1. 将程序文件夹复制到服务器电脑（任意一台不关机的电脑）
  2. 双击运行 1-启动服务.bat
  3. 看到"✅ 服务已启动"提示即表示部署完成
  4. 浏览器访问：http://127.0.0.1:5001

🚀 启动系统（Mac / Linux）

  1. 打开终端，进入程序文件夹
  2. 执行命令：python3 app.py
  3. 浏览器访问：http://127.0.0.1:5001

📶 员工手机打卡

  1. 员工手机连接 公司WiFi
  2. 用浏览器访问 http://服务器IP:5001（服务器IP为运行系统那台电脑的局域网IP）
  3. 输入账号密码即可打卡，无需安装任何APP、无需打卡机硬件
✅
天然防作弊 打卡页面只有连接公司WiFi（公司内网）才能打开——打不了卡，说明人不在公司。

🔑 默认登录账号

用户名密码角色
admin123456管理员
⚠️
安全提示 首次登录后，请立即让管理员在「用户管理」中修改管理员密码。 生产环境建议不要将服务器暴露到公网。

3. 登录与角色 权限

系统采用 两级权限模型，不同角色拥有不同的操作权限。

角色权限说明
管理员 拥有全部权限：打卡、用户管理、部门管理、考勤规则设置、考勤记录/统计查看、操作日志查看、数据导入导出、数据备份
普通用户 可上班/下班打卡，查看自己的考勤记录与考勤统计，查看当前生效的考勤规则

🔐 登录流程

  1. 在浏览器中打开系统首页，自动跳转到登录页面
  2. 输入 用户名 和 密码
  3. 点击 「登录」 按钮，进入系统
💡
权限隔离说明 普通用户登录后只能看到自己的打卡记录和个人考勤统计； 管理员可以看到全公司所有人员的考勤数据。

4. 首页看板 概览

登录成功后进入 首页看板，提供今日考勤概览和快捷入口。

📊 今日出勤概览

📌 当前考勤规则

看板会显示当前 生效中的考勤规则（上班时间、下班时间、迟到阈值等），员工可据此安排打卡时间。

📋 最近考勤记录

看板下方显示 最近10条考勤记录，方便快速查看。

✅
权限隔离 普通用户只能看到自己的今日出勤情况与个人记录； 管理员可以看到全公司汇总数据。

5. 日常打卡 核心

打卡是考勤系统的核心功能，操作简单：每天 上班打卡一次、下班打卡一次。

🕐 上班打卡

  1. 登录系统，进入 「打卡」 页面
  2. 点击 「上班打卡」 按钮
  3. 系统自动记录当前时间，并根据生效规则判定是否迟到

🕑 下班打卡

  1. 进入 「打卡」 页面
  2. 点击 「下班打卡」 按钮
  3. 系统自动判定早退/加班情况

📶 手机WiFi打卡说明

系统为纯局域网部署，打卡页面只有 连接到公司WiFi（公司内网） 的设备才能访问：

✅
天然防作弊原理 不需要任何定位或WiFi校验代码——系统架构本身就决定了：能打卡的人，肉身一定在公司网络范围内。

⚖️ 自动判定规则

判定项规则状态
迟到上班打卡时间晚于规则上班时间，且超出部分大于迟到阈值（默认10分钟）🔴 迟到
早退下班打卡时间早于规则下班时间，且提前部分大于早退阈值（默认10分钟）🟠 早退
加班下班打卡时间晚于规则下班时间，自动累计加班分钟数🟢 正常（加班分钟单独记录）
未打卡当天没有上班打卡记录⚪ 缺勤
⚠️
注意事项
  • 每个用户每天只能打 一次 上班卡、一次 下班卡，重复打卡会被拒绝。
  • 必须先打上班卡，才能打下班卡。
  • 当前版本不支持补卡/改卡，如打卡异常请线下联系管理员处理。

6. 考勤记录 查询

考勤记录模块用于 查询和导出 每日打卡明细，是考勤管理的基础数据。

📋 记录内容

🔍 查询方式

📤 导出Excel

点击 「导出Excel」 按钮，将筛选后的记录导出为 Excel 文件，方便存档或交给财务核算。

💡
提示 导出前请先设置好日期范围，导出的数据与页面筛选结果一致。

7. 考勤统计 报表

考勤统计模块自动汇总 月度考勤报表，默认统计本月数据，可作为工资核算依据。

📊 统计指标

指标说明
总天数统计周期内的打卡总天数
正常天数状态为「正常」的天数
迟到天数 / 迟到总分钟迟到次数与累计迟到分钟数
早退天数 / 早退总分钟早退次数与累计早退分钟数
缺勤天数未打卡的天数
加班总分钟累计加班分钟数

👥 统计范围

📤 导出Excel

管理员可将全公司统计报表一键导出为 Excel，直接用于 工资核算、绩效考核。

8. 考勤规则 配置

考勤规则是系统自动判定迟到/早退/加班的依据，支持 多条规则并存、随时切换，非常适合冬夏令时等场景。

📋 规则字段

字段说明
规则名称如：冬季作息、夏季作息、弹性作息
上班时间规则规定的上班时间（如 09:00）
下班时间规则规定的下班时间（如 18:00）
迟到阈值超过上班时间多少分钟算迟到（默认10分钟）
工作日规则生效的星期（周一~周日，可多选）

🔄 启用规则（互斥逻辑）

系统同一时间 只有一条规则处于启用状态。点击某条规则的 「启用」 按钮后：

📝 规则操作

✅
预置规则 系统首次启动时已预置一条「默认考勤规则」（09:00-18:00，周一至周五），并处于启用状态，开箱即用。
⚠️
注意事项
  • 切换规则会影响之后所有员工的迟到/早退判定，建议在下班后或休息日切换。
  • 删除已启用的规则后，将没有生效规则，打卡将不做迟到/早退判定，请谨慎操作。

9. 用户管理 账号

用户管理是管理员的核心功能，用于管理所有员工账号。

➕ 添加用户

  1. 点击 「添加用户」 按钮
  2. 填写 用户名（唯一，登录时使用）
  3. 填写 密码（初始密码，默认123456）
  4. 选择 角色（管理员/普通用户）
  5. 填写 真实姓名（打卡记录中显示）
  6. 选择 部门
  7. 点击 「保存」

✏️ 编辑用户 / 重置密码

🗑️ 删除用户

📥 Excel批量导入

  1. 点击 「下载模板」 获取导入模板
  2. 按模板格式填写：用户名（必填）、真实姓名（必填）、部门、密码、角色
  3. 上传Excel文件，系统自动校验并导入，导入结果会显示成功/失败明细
⚠️
重要提示 用户被删除后，其历史考勤记录和操作日志不会被删除。 导入时部门必须已存在（可先通过部门管理导入或添加）。

10. 部门管理 组织

部门是用户管理的基础，用于区分员工的所属组织，考勤记录与统计均按部门展示。

🏢 部门操作

💡
使用建议 建议先建立好部门（如：总经办、技术部、销售部、财务部、人事部），再通过用户导入批量创建员工账号。

11. 操作日志 审计

操作日志是系统的 审计基石，记录所有关键操作，确保可追溯、可审计。

📋 日志记录内容

🔍 日志搜索

📊 日志导出

支持将筛选后的日志导出为 Excel 文件，方便存档或审计。

12. 数据备份 安全

考勤数据是企业的重要资产，系统内置了 三重自动备份机制，确保数据安全。

🛡️ 备份方式

备份方式触发时机说明
启动备份每次启动系统时自动执行一次备份，无需任何操作
每日备份系统运行期间后台自动每天备份一次（同一天不重复）
手动备份管理员需要时调用备份接口立即备份（见下方说明）

📁 备份内容与位置

🔧 手动备份

管理员登录系统后，在浏览器开发者控制台执行（或由技术人员代为执行）：

fetch('/api/backup/database', { method: 'POST' }) // 返回备份文件夹路径

♻️ 数据恢复

  1. 先停止系统（双击 2-停止服务.bat）
  2. 进入 data/backups/，选择需要的备份文件夹
  3. 将里面的 attendance.db 复制回 data/ 目录，覆盖原文件
  4. 重新启动系统（双击 1-启动服务.bat），数据即恢复
✅
建议 备份文件与数据库在同一磁盘上，建议定期将整个 data 文件夹（含 backups） 复制到U盘或网盘一份，做到双保险。

13. 系统激活指南 授权

方兴智印考勤系统采用 机器码绑定激活 机制，一个授权码对应一台服务器。

🎁
先免费试用，再决定购买 系统支持 90 天免费试用，无需授权码即可体验全部功能。 试用期内可正常打卡、管理、导出数据；试用期结束后，购买并授权激活即可永久使用。 详细说明见 第14章「免费试用说明」。

🔑 激活流程

第1步 启动系统
→
第2步 复制机器码
→
第3步 发给客服
获取授权码
→
第4步 粘贴授权码
点击激活
→
✅ 激活成功
永久使用

📋 详细操作步骤

  1. 启动系统后，新用户可直接登录使用，系统自动开启 90 天免费试用，无需激活
  2. 需要正式激活时，打开系统 激活页面（地址为 /activate，试用到期后系统也会自动跳转到此页）
  3. 激活页面显示一串 机器码，点击「复制」按钮复制
  4. 将机器码发送给客服（微信/QQ/邮箱），客服生成授权码
  5. 将收到的授权码粘贴到激活页面的输入框中
  6. 点击 「激活系统」 按钮
  7. 看到「✅ 系统激活成功！」提示，即可正常使用、永久有效
✅
激活说明
  • 在 90 天免费试用期内无需激活，可直接使用全部功能
  • 一个授权码只能激活 一台服务器电脑
  • 激活后 永久有效，无需续费
  • 激活后其他电脑通过浏览器访问，不需要激活
  • 如果服务器重装系统，联系客服免费重新激活
⚠️
重要提示 请妥善保管您的授权码，一个授权码对应一台服务器。 如需更换服务器，请联系客服处理。

📞 获取授权码

14. 免费试用说明 免费体验

为了让客户在购买前充分体验系统，方兴智印考勤系统 提供 90 天免费试用 功能。 试用期内可 完整使用全部功能，无需任何授权码即可上手。

🎁 试用规则

项目说明
试用周期自首次使用之日起 90 天
试用范围全部功能均可使用：日常打卡、考勤记录/统计、考勤规则、用户/部门管理、数据导入导出、操作日志、数据备份等
是否需要授权码不需要，打开即用
试用到期后系统自动锁定，跳转到激活页面，需购买授权激活后才能继续使用

🚀 如何开始试用

  1. 启动系统，浏览器打开 http://127.0.0.1:5001
  2. 若尚未激活，页面会自动跳转到 激活页面
  3. 点击激活页面上的 「开始免费试用 90 天」 按钮，即可开启试用并进入系统首页
  4. 也可以直接使用默认账号（admin / 123456）登录系统，首次进入受保护页面时会自动开启试用

📅 如何查看剩余试用天数

🔒 试用到期后的处理

90 天免费试用 到期后：

✅
试用与购买的关系 无论试用期内还是试用到期后，购买并激活授权，系统即转为 永久有效， 免费试用提醒横幅自动消失，此后不再受试用期限制。
⚠️
重要提示 试用起算时间在系统 首次使用时自动记录，保存在 data/trial_start.txt， 之后不会被清除或重置。请勿通过删除该文件来试图重新试用——系统会据此文件判断是否已经试用过。

15. 常见问题 FAQ

❓
Q1：忘记密码了怎么办？

A：请管理员在「用户管理」中找到该用户，点击「重置密码」输入新密码即可。

❓
Q2：打卡后如何判定迟到？

A：系统按当前「启用」的考勤规则判定：打卡时间超过规则上班时间，且超出部分大于迟到阈值（默认10分钟），即记为迟到。

❓
Q3：一天可以打几次卡？

A：每天只能打 一次上班卡 和 一次下班卡，重复打卡会被系统拒绝。

❓
Q4：打错卡 / 漏打卡了能改吗？

A：当前版本不支持补卡和改卡。如确属系统或操作问题，请线下联系管理员说明情况处理。

❓
Q5：为什么我看不到其他同事的考勤记录？

A：系统实行权限隔离，普通用户只能查看自己的记录和统计，管理员可以查看全部。

❓
Q6：启用考勤规则后，退出再登录会不会变回停用？

A：不会。启用状态已持久化保存（V1.0已修复），退出系统、重启服务器后依然保留上次的设置。

❓
Q7：最多支持多少用户同时使用？

A：30-50人同时使用完全没问题。超过50人建议升级到更大型的数据库版本。

❓
Q8：需要连接互联网吗？

A：不需要！系统完全在局域网内运行，即使公司断网，内部打卡依然正常使用。

❓
Q9：数据安全吗？会不会泄露？

A：非常安全！数据完全保存在您公司的电脑里，不经过任何第三方服务器，外部无法访问。

❓
Q10：换电脑 / 重装系统后怎么办？

A：联系客服免费重新生成授权码。数据可通过 data/backups 中的备份恢复。

❓
Q11：为什么必须连接公司WiFi才能打卡？

A：系统是纯局域网部署，打卡页面只有公司内网（WiFi）能访问。连不上公司WiFi就打不开打卡页面，从架构上杜绝了远程打卡——打了卡，人一定在公司。

❓
Q12：员工在家 / 出差时能打卡吗？

A：不能。不在公司就连接不上公司WiFi，无法访问打卡页面。如有外勤/出差打卡需求，可联系客服了解扩展方案。

❓
Q13：不购买能先用起来吗？

A：可以。系统支持 90 天免费试用，首次使用时自动开启，试用期内可完整使用全部功能，无需授权码；到期后需购买授权激活才能继续使用。详细说明见第14章。

❓
Q14：试用到期后，里面的考勤数据会丢失吗？

A：不会。试用期内录入的考勤数据、员工信息等都会完整保留。购买并激活授权后即可继续使用这些数据，无需重新录入。

16. 系统维护 运维

💾 数据备份

系统已内置 启动自动备份 + 每日自动备份，备份保存在 data/backups/ 目录，无需人工干预。

✅
重要文件说明
  • data/attendance.db：考勤数据库（用户、记录、规则、日志等全部数据）
  • data/device_id.txt：授权机器码（丢失会导致授权失效，请随备份保存）
  • data/trial_start.txt：90天免费试用的起算时间记录（用于判断是否处于试用期，请勿删除）
  • data/backups/：自动备份目录

⚙️ 性能优化

🔄 版本升级

📞 技术支持

17. 防火墙配置指南 网络

🛡️ 为什么需要配置防火墙？

其他电脑要访问考勤系统，必须让防火墙允许 5001 端口 通过。

📋 Windows 防火墙配置步骤

方法一：一键自动配置（最简单，强烈推荐）

双击运行 0-一键配置防火墙.bat，以管理员身份运行 即可自动完成配置。

✅
操作步骤
  1. 找到 0-一键配置防火墙.bat 文件
  2. 右键点击该文件，选择 「以管理员身份运行」
  3. 等待提示「防火墙配置成功！」
  4. 完成！

方法二：手动配置

  1. 打开「控制面板」→「Windows Defender 防火墙」
  2. 点击「高级设置」
  3. 点击「入站规则」→「新建规则」
  4. 选择「端口」→ 下一步
  5. 选择「TCP」→「特定本地端口」输入 5001
  6. 选择「允许连接」→ 下一步
  7. 全部勾选 → 下一步
  8. 输入名称「方兴智印考勤系统」→ 完成

方法三：命令行配置

以管理员身份运行 PowerShell 或 CMD，执行以下命令：

netsh advfirewall firewall add rule name="方兴智印考勤系统" dir=in action=allow protocol=TCP localport=5001

方法四：关闭防火墙（不推荐）

⚠️
警告 仅在测试环境使用，生产环境请勿关闭防火墙！

✅ 如何验证配置成功？

  1. 在另一台电脑上打开浏览器
  2. 输入 http://服务器IP:5001
  3. 如果看到登录页面 → 配置成功！

📶 手机WiFi打卡的网络要求

❓ 常见问题

💡
Q：配置后仍无法访问？

A：检查是否启用了「专用网络」防火墙，部分公司网络需要联系IT。

💡
Q：服务器换了IP怎么办？

A：在客户端浏览器中输入新的IP地址即可，无需重新配置。

💡
Q：Mac/Linux 需要配置防火墙吗？

A：一般不需要。如果无法访问，检查系统防火墙设置，开放 5001 端口即可。