# 考勤打卡系统 — 产品需求文档（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 开始，跑通最小闭环，再逐步叠加功能，学习的正反馈会很足。