```

docs: 添加考勤打卡系统产品需求文档

添加完整的PRD文档，包含以下内容：
- 用户画像与使用场景
- 产品架构总览和技术选型
- 详细功能模块说明（打卡、考勤统计、排班、请假等）
- 数据模型概览和表结构设计
- 版本迭代路线图（V1.0/V1.5/V2.0）
- UI/UX设计要点
- 技术栈选型建议
```

练手项目/考勤打卡系统-产品需求文档.md

@@ -0,0 +1,544 @@
+# 考勤打卡系统 — 产品需求文档（PRD）
+
+> **产品定位**：面向中小团队（5～100人）的桌面端考勤打卡工具，基于 Tauri 构建，轻量、离线可用、数据本地化。
+> **版本**：V1.0 MVP → V1.5 增强 → V2.0 联网协作
+> **作者**：产品经理 · Yuhang Wu
+> **日期**：2026-07-02
+
+---
+
+## 目录
+
+1. [用户画像与场景](#1-用户画像与场景)
+2. [产品架构总览](#2-产品架构总览)
+3. [功能模块详述](#3-功能模块详述)
+   - [3.1 打卡模块](#31-打卡模块)
+   - [3.2 考勤统计与看板](#32-考勤统计与看板)
+   - [3.3 排班管理](#33-排班管理)
+   - [3.4 请假管理](#34-请假管理)
+   - [3.5 补卡与申诉](#35-补卡与申诉)
+   - [3.6 报表导出](#36-报表导出)
+   - [3.7 系统设置](#37-系统设置)
+4. [数据模型概览](#4-数据模型概览)
+5. [版本迭代路线图](#5-版本迭代路线图)
+6. [UI/UX 设计要点](#6-uiux-设计要点)
+7. [技术选型建议](#7-技术选型建议)
+
+---
+
+## 1. 用户画像与场景
+
+| 角色 | 核心诉求 | 使用频率 |
+|---|---|---|
+| **员工** | 一键打卡、查看自己出勤记录、请假/补卡申请 | 每天 2～4 次 |
+| **团队组长** | 查看组员出勤、审批请假/补卡、关注异常考勤 | 每天 1～2 次 |
+| **HR/管理员** | 排班配置、月考勤汇总、导出报表、全局设置 | 每周 2～3 次，月末高频 |
+
+**典型场景**：
+
+- 🏢 **固定办公**：早 9 点到公司 → 打开 App → 点击「上班打卡」→ 晚 6 点点击「下班打卡」
+- 🏠 **远程办公**：在家打开电脑 → 点击「远程打卡」→ 系统自动记录 IP/位置备注
+- 🚗 **外勤拜访**：到达客户公司 → 点击「外勤打卡」→ 拍照上传 / 填写备注
+- 📅 **月末结算**：HR 打开 App → 进入「考勤统计」→ 查看部门月度汇总 → 导出 Excel → 发给财务算工资
+- 😷 **早上起晚了**：员工 10 点到公司 → 发现已迟到 → 在 App 内发起「补卡申请」→ 组长审批
+
+---
+
+## 2. 产品架构总览
+
+```
+┌─────────────────────────────────────────────────┐
+│                 考勤打卡系统                      │
+├─────────────────────────────────────────────────┤
+│  前端 (React / Vue / Svelte + TailwindCSS)       │
+│  ├─ 首页看板 (Dashboard)                         │
+│  ├─ 打卡页 (Punch)                               │
+│  ├─ 考勤统计 (Statistics)                        │
+│  ├─ 排班管理 (Schedule)                          │
+│  ├─ 请假管理 (Leave)                             │
+│  ├─ 审批中心 (Approval)                          │
+│  ├─ 报表导出 (Report)                            │
+│  └─ 系统设置 (Settings)                          │
+├─────────────────────────────────────────────────┤
+│  Tauri Bridge (IPC)                              │
+├─────────────────────────────────────────────────┤
+│  Rust 后端                                        │
+│  ├─ 打卡业务逻辑                                  │
+│  ├─ 考勤计算引擎                                  │
+│  ├─ 数据持久化 (SQLite)                           │
+│  ├─ 定时任务 (自动打卡提醒)                        │
+│  └─ 导出引擎 (xlsx/csv)                           │
+└─────────────────────────────────────────────────┘
+```
+
+**设计原则**：
+1. **离线优先** — 所有核心功能无网络时也能使用，数据存在本地 SQLite
+2. **隐私安全** — 数据归用户所有，不上传任何云端服务器（V1.0）
+3. **简单直接** — 打卡不超过 2 步操作，核心路径最短
+4. **渐进增强** — V1.0 单机版 → V2.0 局域网同步 → V3.0 云端协作
+
+---
+
+## 3. 功能模块详述
+
+### 3.1 打卡模块
+
+#### 3.1.1 快速打卡（核心功能）
+
+**描述**：应用首页最核心区域，提供一键打卡能力。
+
+| 特性 | 说明 |
+|---|---|
+| 上班打卡 | 点击「上班打卡」按钮，记录打卡时间；按钮在打卡后变为禁用灰态并显示已打卡时间 |
+| 下班打卡 | 同上，区分上班/下班两个按钮 |
+| 打卡时间显示 | 实时显示当前时间（精确到秒），让用户确认打卡时刻 |
+| 打卡确认动画 | 打卡成功后播放 0.5s 动画反馈（✅ + 时间戳） |
+| 今日状态条 | 顶部显示"今日已打卡：上班 09:02 | 下班 —"等状态信息 |
+| 连续打卡天数 | 显示"已连续打卡 X 天"的激励提示 |
+
+**打卡规则**（可配置）：
+- 上班打卡有效时间窗口：如 "06:00～12:00"
+- 下班打卡有效时间窗口：如 "16:00～23:59"
+- 最早/最晚打卡限制
+- 重复打卡提示："你今天已经在 09:02 打卡上班，确定重新打卡？"
+
+#### 3.1.2 打卡方式
+
+| 方式 | 描述 | 优先级 |
+|---|---|---|
+| **手动点击打卡** | 打开应用 → 点击按钮 | MVP |
+| **快捷键打卡** | 系统全局快捷键 `Ctrl+Shift+I/O` 快速打卡 | V1.0 |
+| **系统托盘打卡** | 右键托盘图标 → 选择打卡类型 | V1.0 |
+| **开机自启自动提醒** | 开机后弹窗提醒打卡 | V1.5 |
+
+#### 3.1.3 打卡类型
+
+| 类型 | 图标 | 说明 |
+|---|---|---|
+| 🏢 正常打卡 | 办公 | 默认类型 |
+| 🏠 远程打卡 | 居家 | 标记为远程办公，可选填备注 |
+| 🚗 外勤打卡 | 出行 | 标记外勤，支持拍照附件（V1.5） |
+| ⏰ 加班打卡 | 时钟 | 超出正常工作时间后的打卡，自动算加班 |
+
+#### 3.1.4 打卡记录列表
+
+- 列表页展示历史打卡记录，按日期倒序
+- 每条记录显示：日期、上班时间、下班时间、类型标签、工时
+- 异常标记：红色标记迟到/早退/缺卡
+- 支持按日期范围筛选
+- 点击某天可查看详情
+
+---
+
+### 3.2 考勤统计与看板
+
+#### 3.2.1 个人考勤看板
+
+```
+┌────────────────────────────────────────┐
+│  📊 我的考勤 — 2026年7月              │
+├────────────────────────────────────────┤
+│  ┌──────┐ ┌──────┐ ┌──────┐ ┌──────┐ │
+│  │ 应出勤 │ │ 实际出勤│ │ 迟到  │ │ 早退  │ │
+│  │ 22天  │ │ 20天  │ │ 2次  │ │ 0次  │ │
+│  └──────┘ └──────┘ └──────┘ └──────┘ │
+│  ┌──────┐ ┌──────┐ ┌──────┐ ┌──────┐ │
+│  │ 缺卡  │ │ 加班  │ │ 请假  │ │ 外勤  │ │
+│  │ 0次   │ │ 8.5h  │ │ 2天  │ │ 3次  │ │
+│  └──────┘ └──────┘ └──────┘ └──────┘ │
+├────────────────────────────────────────┤
+│  本月趋势图 (折线图: 每日工时走势)      │
+│  ▓▂▃▅▇▆▄▂▁▃▅▇█▆▄▃▂▁▂▄▆▇█▆▄▃▂      │
+├────────────────────────────────────────┤
+│  日历视图 (绿色=正常, 黄=迟到, 红=缺卡) │
+│  一  二  三  四  五  六  日           │
+│  🟢 🟢 🟡 🟢 🟢  —  —              │
+│  🟢 🟢 🟢 🟢 🟢  —  —              │
+│  ...                                  │
+└────────────────────────────────────────┘
+```
+
+#### 3.2.2 管理端考勤总览
+
+- 管理员/组长可查看团队所有成员的考勤汇总
+- 异常考勤高亮：迟到、早退、缺卡、未打卡人员
+- 支持按部门/人员筛选
+- 实时统计：今日已打卡人数/总人数
+
+#### 3.2.3 工时计算规则
+
+| 规则项 | 说明 |
+|---|---|
+| 标准工时 | 可配置，默认 8h/天 |
+| 迟到扣减 | 迟到 N 分钟，扣减 N 分钟工时（可配置宽限时间） |
+| 早退扣减 | 早退 N 分钟，扣减 N 分钟工时 |
+| 加班计算 | 超出标准工时的部分自动计为加班 |
+| 午休扣除 | 可配置是否自动扣除午休时间 |
+
+---
+
+### 3.3 排班管理
+
+#### 3.3.1 排班模板
+
+| 模板 | 描述 |
+|---|---|
+| **固定班制** | 周一至周五 09:00-18:00，周末双休 |
+| **大小周** | 单周 6 天、双周 5 天 |
+| **弹性工作制** | 核心在岗时间（如 10:00-16:00），其余时间弹性 |
+| **轮班制** | 早/中/晚三班倒，支持自定义轮换规则 |
+| **自定义** | 完全自定义每天的工作时段 |
+
+#### 3.3.2 排班功能
+
+- 为每位员工分配排班模板
+- 支持临时调班：拖拽日历调整某天的班次
+- 批量排班：为部门/团队统一设置排班
+- 排班日历视图：可预览任意月份的排班情况
+
+#### 3.3.3 节假日管理
+
+- 内置中国法定节假日（2026年起）
+- 支持手动添加/修改节假日
+- 调休日自动标注（如周六上班补五一假期）
+- 节假日不计入缺勤
+
+---
+
+### 3.4 请假管理
+
+#### 3.4.1 请假类型
+
+| 类型 | 带薪 | 说明 |
+|---|---|---|
+| 年假 | ✅ | 按工龄阶梯增加，可配置年假天数 |
+| 事假 | ❌ | 扣薪，无额度限制 |
+| 病假 | ✅/❌ | 可配置带薪天数上限 |
+| 婚假 | ✅ | 默认 3 天，可配置 |
+| 产假/陪产假 | ✅ | 默认 98/15 天，可配置 |
+| 丧假 | ✅ | 默认 3 天，可配置 |
+| 调休 | ✅ | 用加班时长兑换 |
+| 其他 | 自定义 | HR 可自定义假期类型 |
+
+#### 3.4.2 请假流程
+
+```
+发起请假 ──→ 选择请假类型 ──→ 选择日期范围 ──→ 填写原因
+    │
+    ▼
+提交申请 ──→ 推送审批通知 ──→ 审批人（组长/HR）
+    │                        │
+    ├── 通过 ──→ 回写考勤记录，标记"已请假"
+    │
+    └── 驳回 ──→ 通知申请人 + 驳回原因
+```
+
+#### 3.4.3 假期余额
+
+- 每位员工的各类假期余额管理
+- 年假自动按规则发放（如入职满 1 年发放 5 天）
+- 假期余额不足时提示
+- 调休余额 = 已加班小时数 ÷ 8（转换为天数）
+
+---
+
+### 3.5 补卡与申诉
+
+#### 3.5.1 补卡
+
+- 忘记打卡的次日可发起补卡申请
+- 补卡次数限制（如每月最多 3 次）
+- 需填写补卡原因 + 实际到岗/离岗时间
+- 审批通过后修正考勤记录
+
+#### 3.5.2 考勤异常申诉
+
+- 迟到/早退/缺卡 → 员工可在异常发生后发起申诉
+- 申诉类型：
+  - "系统/设备故障导致无法打卡"
+  - "临时外出公干"
+  - "身体不适延迟但未请病假"
+  - "其他原因（需详细说明）"
+- 管理员审核后修正考勤状态
+
+---
+
+### 3.6 报表导出
+
+#### 3.6.1 支持的报表类型
+
+| 报表 | 内容 | 格式 |
+|---|---|---|
+| 月度考勤汇总表 | 每人：应出勤、实际出勤、迟到、早退、缺卡、请假、加班 | Excel |
+| 日打卡明细表 | 每人每天：上班时间、下班时间、工时、异常标记 | Excel/CSV |
+| 请假统计表 | 每人：各类假期已用/剩余 | Excel |
+| 加班统计表 | 每人：加班日期、时长、原因 | Excel |
+| 月度工资考勤底表 | 汇总所有与薪资相关考勤数据 | Excel |
+
+#### 3.6.2 导出功能
+
+- 选择日期范围（月/自定义）
+- 选择人员范围（个人/部门/全员）
+- 选择导出字段
+- 预览后导出
+- 导出历史记录
+
+---
+
+### 3.7 系统设置
+
+#### 3.7.1 考勤规则配置
+
+| 配置项 | 默认值 | 说明 |
+|---|---|---|
+| 上班时间 | 09:00 | — |
+| 下班时间 | 18:00 | — |
+| 迟到宽限 | 5 分钟 | 9:05 之前不算迟到 |
+| 早退宽限 | 5 分钟 | 17:55 之后不算早退 |
+| 午休时间 | 12:00-13:00 | 自动扣除 |
+| 半天请假判定 | 4 小时 | 当天工时 < 4h 算半天缺勤 |
+| 加班起算 | 超出标准工时 30 分钟 | 避免误计加班 |
+| 每月补卡上限 | 3 次 | — |
+| 工作日设置 | 周一至周五 | — |
+
+#### 3.7.2 通用设置
+
+- 公司名称/Logo 设置
+- 数据存储路径
+- 数据备份与恢复
+  - 手动备份（导出 .db 文件）
+  - 自动备份（每周/每月定时备份）
+  - 从备份恢复
+- 主题切换（亮色/暗色）
+- 语言（中文/英文）
+- 开机自启动
+- 最小化到系统托盘
+- 打卡提醒时间（如 08:55 弹窗提醒）
+
+#### 3.7.3 用户与权限
+
+| 角色 | 权限范围 |
+|---|---|
+| **超级管理员** | 所有权限：系统配置、用户管理、全部数据查看 |
+| **HR** | 排班配置、请假审批、报表导出、查看全员考勤 |
+| **组长** | 查看组员考勤、审批组员请假/补卡、组员异常提醒 |
+| **员工** | 个人打卡、个人考勤查看、请假/补卡申请、个人设置 |
+
+---
+
+## 4. 数据模型概览
+
+### 核心实体关系
+
+```
+User (用户)
+  ├─ 1:N → PunchRecord (打卡记录)
+  ├─ 1:N → LeaveRequest (请假申请)
+  ├─ 1:N → PatchRequest (补卡申请)
+  ├─ 1:N → Appeal (考勤申诉)
+  ├─ 1:1 → UserSchedule (用户排班)
+  └─ 1:1 → LeaveBalance (假期余额)
+
+Schedule (排班模板)
+  └─ 1:N → UserSchedule (用户排班)
+
+Holiday (节假日)
+  └─ 全局
+
+SystemConfig (系统配置)
+  └─ 单例
+```
+
+### 核心表结构（伪代码）
+
+```sql
+-- 用户表
+User {
+    id, name, department, role, email, phone,
+    hire_date, created_at, updated_at
+}
+
+-- 打卡记录表
+PunchRecord {
+    id, user_id, date, punch_in_time, punch_out_time,
+    punch_in_type, punch_out_type,  -- normal/remote/field/overtime
+    work_hours, status,              -- normal/late/early/missing/leave
+    remark, created_at
+}
+
+-- 排班模板表
+ScheduleTemplate {
+    id, name, type,  -- fixed/flexible/shift/custom
+    work_days,        -- JSON: [1,2,3,4,5] 表示周一到周五
+    start_time, end_time,
+    core_start, core_end,  -- 弹性工作制核心时段
+    is_active
+}
+
+-- 用户排班表
+UserSchedule {
+    id, user_id, template_id,
+    effective_from, effective_to,  -- 排班有效期
+    overrides                     -- JSON: 特殊日期调整
+}
+
+-- 请假申请表
+LeaveRequest {
+    id, user_id, leave_type,      -- annual/sick/personal/marriage/...
+    start_date, end_date, duration_days,
+    reason, status,               -- pending/approved/rejected
+    approver_id, approved_at, remark
+}
+
+-- 假期余额表
+LeaveBalance {
+    id, user_id, leave_type, total_days, used_days, remaining_days, year
+}
+
+-- 节假日表
+Holiday {
+    id, name, date, is_workday,   -- true=调休上班日
+    description
+}
+
+-- 补卡申请表
+PatchRequest {
+    id, user_id, target_date,
+    actual_in_time, actual_out_time,
+    reason, status, approver_id, created_at
+}
+
+-- 考勤申诉表
+Appeal {
+    id, user_id, punch_record_id,
+    appeal_type, reason, evidence,  -- evidence: 附件路径
+    status, handler_id, handled_at, result_remark
+}
+```
+
+---
+
+## 5. 版本迭代路线图
+
+### V1.0 — MVP 最小可用版本（单人单机）
+
+> **目标**：一个人能用，覆盖最基本的打卡+查看+导出。
+
+| 功能 | 说明 |
+|---|---|
+| ✅ 上班/下班打卡 | 手动点击打卡，区分上下班 |
+| ✅ 打卡历史列表 | 按日期查看自己的打卡记录 |
+| ✅ 个人月考勤统计 | 出勤天数、迟到、早退、缺卡计数 |
+| ✅ 固定排班规则 | 硬编码：周一至周五 9:00-18:00 |
+| ✅ 基本设置 | 公司名、上班时间、下班时间 |
+| ✅ SQLite 本地存储 | 所有数据存在本地 |
+| ✅ 系统托盘 | 最小化到托盘 + 右键菜单打卡 |
+| ✅ 暗色/亮色主题 | 基础主题切换 |
+| ✅ 月度 Excel 导出 | 导出个人月度考勤汇总 |
+
+### V1.5 — 功能增强（单机多用户）
+
+> **目标**：支持多个用户在同一个应用内管理，模拟真实团队场景。
+
+| 功能 | 说明 |
+|---|---|
+| ✅ 多用户管理 | 添加/编辑/删除用户，角色区分 |
+| ✅ 排班模板 | 固定/弹性/大小周 至少 3 种模板 |
+| ✅ 请假申请与审批 | 完整流程：申请→审批→回写考勤 |
+| ✅ 补卡申请与审批 | — |
+| ✅ 假期余额管理 | — |
+| ✅ 节假日管理 | 内置中国法定节假日 |
+| ✅ 管理端考勤总览 | 团队考勤看板 |
+| ✅ 考勤异常申诉 | — |
+| ✅ 数据备份恢复 | 手动备份 + 自动备份 |
+| ✅ 多格式导出 | Excel 多报表类型 |
+| ✅ 打卡提醒 | 定时弹窗提醒 |
+
+### V2.0 — 联网协作
+
+> **目标**：局域网/服务器部署后端，多设备协同。
+
+| 功能 | 说明 |
+|---|---|
+| ✅ C/S 架构 | Tauri 客户端 + Rust 后端服务（Axum/Actix） |
+| ✅ 用户登录系统 | JWT 认证 |
+| ✅ 数据实时同步 | WebSocket 推送打卡状态 |
+| ✅ 审批通知 | 实时推送审批提醒 |
+| ✅ 多设备登录 | 同一账号可在多设备打卡 |
+| ✅ 管理后台 Web 端 | 独立 Web 管理后台 |
+
+### V3.0 — 企业级增强（远期规划）
+
+- 对接企业微信/钉钉/飞书
+- 人脸/指纹打卡（调用系统生物识别）
+- GPS 围栏打卡（外勤地理校验）
+- 考勤数据大屏
+- 薪资计算联动
+
+---
+
+## 6. UI/UX 设计要点
+
+### 6.1 信息架构
+
+```
+侧边栏导航
+├── 🏠 首页看板     ← 默认页，今日状态 + 快速打卡
+├── 📋 打卡记录     ← 历史打卡列表
+├── 📊 考勤统计     ← 个人/团队统计
+├── 📅 排班管理     ← 排班模板 + 人员排班（管理员）
+├── 🏖️ 请假管理     ← 请假申请 + 我的假期
+├── ✍️ 审批中心     ← 待审批列表（管理员/组长）
+└── ⚙️ 设置         ← 系统配置
+```
+
+### 6.2 关键交互规范
+
+- **打卡按钮**：大尺寸、醒目颜色（上班绿色/下班橙色）、点击即完成
+- **状态反馈**：打卡成功 → 动画 + 振动（可选）+ 声音（可选）
+- **异常提示**：迟到/缺卡 → 红色标记 + 悬浮提示原因
+- **表格交互**：考勤记录支持排序/筛选/列显隐
+- **日历组件**：考勤日历支持月份切换、点击日期查看详情
+- **响应式**：窗口最小尺寸 900×600，适配不同分辨率
+
+### 6.3 视觉风格
+
+- 现代简洁风格，专业但不冰冷
+- 主色调：蓝色系（#2563EB 为主色），传达专业可信赖感
+- 功能色：绿色=正常打卡，橙色=迟到，红色=缺卡/异常
+- 圆角卡片布局，适度的阴影层次
+
+---
+
+## 7. 技术选型建议
+
+| 层 | 技术 | 理由 |
+|---|---|---|
+| **桌面框架** | Tauri 2.x | 轻量（相比 Electron）、Rust 后端、Web 前端 |
+| **前端框架** | React + TypeScript | 生态丰富、适合中大型应用 |
+| **UI 组件库** | Ant Design / shadcn/ui | 前者功能全、后者定制性好 |
+| **CSS** | TailwindCSS | 快速开发、与 shadcn/ui 配合良好 |
+| **状态管理** | Zustand / Jotai | 轻量，适合 Tauri 单窗口场景 |
+| **图表** | Recharts / ECharts | 考勤趋势图、统计饼图 |
+| **数据库** | SQLite (via rusqlite) | 轻量、无需安装、Tauri 原生支持 |
+| **导出** | rust_xlsxwriter | Rust 原生 Excel 写入 |
+| **后端 (V2.0+)** | Axum + SQLx | Rust 异步 HTTP 框架 + 类型安全 SQL |
+| **打包** | Tauri Bundle (msi/dmg/deb) | 跨平台分发 |
+
+---
+
+## 附录：MVP 第一周开发计划（参考）
+
+| 天 | 任务 |
+|---|---|
+| Day 1 | 初始化 Tauri + React 项目，配置 SQLite，实现用户表 CRUD |
+| Day 2 | 打卡核心功能：上下班按钮 + 时间记录 + 今日状态 |
+| Day 3 | 打卡记录列表页 + 基本筛选 |
+| Day 4 | 考勤统计页：统计卡片 + 日历视图 |
+| Day 5 | 系统设置页 + Excel 导出 |
+| Day 6 | 系统托盘 + 快捷键打卡 + 打包测试 |
+| Day 7 | Bug 修复 + UI 打磨 + 文档 |
+
+---
+
+> **小结**：这个考勤打卡系统作为 Rust + Tauri 的练手项目非常合适——它功能层次分明、数据模型清晰、从简单到复杂可逐步迭代，能覆盖 Tauri 开发的核心知识点：Rust 后端逻辑、SQLite 操作、IPC 通信、系统托盘、文件导出、前端组件化等。从 MVP 开始，跑通最小闭环，再逐步叠加功能，学习的正反馈会很足。