# 考勤规则

## 资料来源

每月 `~/Downloads/大梦N月账务处理/考勤表/` 下会有：

| 文件 | 覆盖人员 | 形式 |
|---|---|---|
| `厨师考勤.jpg` | 西湖店厨房（秦天/何简）+ 滨江店全员（除王瑛胤）| 手写图片 |
| `06f16921...jpg` 等 | 西湖店白班（小宋=宋群喜、小儒=郭思儒、保洁阿姨）| 手写图片 |
| `李想N月考勤.xlsx` | 李想 | 月度档案 xlsx |
| `秋风N月考勤(N).xlsx` | 朱秋风（"秋风"）| 月度档案 xlsx |
| `评估N月-白班店长-王瑛胤 月度评估.xls` | 王瑛胤 | xls（旧版，要 xlrd 读取）|
| 腾讯文档「大梦西湖店夜班员工考勤」 `file_id=IEqftKNqdqKa` | 西湖店夜班（胡舒=小胡、蔡逸丰=丰丰、小亮、凯南等）| 在线表格 |

## 昵称映射

| 称呼 | V2 姓名 |
|---|---|
| 小胡 | 胡舒 |
| 丰丰 | 蔡逸丰 |
| 小宋 | 宋群喜 |
| 小儒 | 郭思儒 |
| 秋风 | 朱秋风 |
| 保洁曾阿姨 | （**兼职，不写入 V2**）|

## 出勤天数定义（5月已确认口径）

```
出勤天数 = 当月天数 − 正常休息天数        （年假天数 计入出勤/带薪，不扣）
```

- **年假 = 带薪出勤**：休年假的那天算出勤、照发工资。
- 例：何简 5月 休 11,12,13,14,19,25（其中 14/19/25 是年假）→ 正常休 3 天 → **出勤 = 31 − 3 = 28**（3 个年假日计入出勤）。用户已确认"何简就算出勤28天"。
- 例：郭思儒 5月 休 3,14,20,27（4正常）+ 28年假 → 出勤 = 31 − 4 = **27**。

> ⚠️ 4月时曾用"年假不计入出勤"（宋群喜26），**5月起统一改为年假计入出勤**。各手写考勤表通常会**直接写明出勤数**——以写明的为准；未写明的按上式算。
> **以本月各考勤表写明的出勤数为最高优先**，公式仅用于未写明者。

## 加班小时数

- 备注里写「**加班X小时存**」→ 暂存（不发钱），加班工资 = 0
  - V2 仍把 X 写入 `加班小时数`（col 24），方便后续核算
  - HTML 工资单会自动隐藏这种情况的加班小时显示
- 备注里写「**加班X小时换钱**」→ 当月发，加班工资 = (X/9) × 底薪/26.08
- 没写明 → 默认发钱

## 法定假期天数（4 月示例）

| 月 | 节日 | 天数 |
|---|---|---|
| 1 | 元旦 | 1 |
| 2 | 春节 | 3（实际放 7 但只算 3）|
| 4 | 清明 | 1 |
| 5 | 劳动节 | **2**（5月按 2 天法定假，5月用户确认）|
| 6 | 端午 | 1 |
| 9-10 | 中秋+国庆 | 3-4 |

> **5月口径（用户确认）**：五一 2 天法定假期，**全员**法定假期天数 = 2、全员给 2 天双倍工资（不论是否实际在岗）。即 `法定假期天数` 列对所有人填 2。
> 一般原则：以用户每月的明确指示为准；若用户说"全员给N天双倍"，则全员 `法定假期天数=N`。

## 各类休假在备注里的标记

```
休1,10,15,23                    ← 正常休息日期
29号年假1天                      ← 用了 1 天年假
剩余年假5天                      ← HR 库存
请假合计3天                      ← xls 文件汇总
调休4天                          ← 王瑛胤 月度评估口径
加班3小时存                      ← 存调休时间
加班2小时换钱                    ← 当月发钱
滨江店X天                        ← 串店帮忙（可能涉及交通补贴）
```