# Kylin Holiday - 法律合规文档

> **版本**: 1.0  
> **最后更新**: 2026-06-19  
> **适用范围**: 所有使用 kylin/holiday 扩展包的系统  

---

## 一、适用法律法规

### 1.1 《全国年节及纪念日放假办法》(2024.11.10 修订)

| 条款 | 要求 | 合规要点 |
|------|------|----------|
| 第二条 | 全体公民放假的节日：元旦（1天）、春节（4天）、清明节（1天）、劳动节（2天）、端午节（1天）、中秋节（1天）、国庆节（3天） | 法定节假日数据需与国务院通知一致 |
| 第四条 | 少数民族习惯的节日，由各少数民族聚居地区的地方人民政府规定 | 少数民族地区节假日需单独配置 |
| 第六条 | 全体公民放假的假日，如果适逢星期六、星期日，应当在工作日补假 | 节假日包含调休日期 |
| 第七条 | 部分公民放假的假日，如果适逢星期六、星期日，则不补假 | 妇女节、青年节等不补假 |

### 1.2 《关于进一步严格管理 切实防止未成年人沉迷网络游戏的通知》(国家新闻出版署, 2021.8.30)

| 条款 | 要求 | 合规要点 |
|------|------|----------|
| 第一条 | 未成年人仅限周五、周六、周日及法定节假日 20:00-21:00 提供 1 小时服务 | 节假日判断是防沉迷时段计算的基础 |
| 第二条 | 严格落实网络游戏用户账号实名注册和登录要求 | 节假日判断需精确到日期 |

### 1.3 《中华人民共和国未成年人保护法》(2021.6.1)

| 条款 | 要求 | 合规要点 |
|------|------|----------|
| 第七十五条 | 网络游戏服务提供者不得在每日二十二时至次日八时向未成年人提供网络游戏服务 | 节假日判断需精确到日期 |
| 第七十四条 | 网络产品和服务提供者不得向未成年人提供诱导其沉迷的产品和服务 | 节假日时段计算需与防沉迷联动 |

### 1.4 《中华人民共和国劳动法》(2018.12.29 修订)

| 条款 | 要求 | 合规要点 |
|------|------|----------|
| 第四十条 | 用人单位在法定休假日期间应当依法安排劳动者休假 | 法定节假日数据需准确用于薪酬计算 |
| 第四十四条 | 法定休假日安排劳动者工作的，支付不低于工资的 300% 的工资报酬 | 节假日三倍工资计算 |

### 1.5 《职工带薪年休假条例》(2008.1.1)

| 条款 | 要求 | 合规要点 |
|------|------|----------|
| 第三条 | 职工累计工作满 1 年不满 10 年，年休假 5 天；满 10 年不满 20 年，年休假 10 天；满 20 年，年休假 15 天 | 国家法定休假日、休息日不计入年休假假期 |

---

## 二、行业规范

### 2.1 防沉迷系统

- 法定节假日数据需每年更新，与国务院放假通知保持一致
- 节假日包含调休日期（如周六日调休为工作日不算节假日）
- 时区统一使用 Asia/Shanghai
- 节假日数据缓存 1 天（`cache_ttl = 86400`），防止频繁查询影响性能

### 2.2 数据更新规范

- 每年需根据国务院发布的最新放假通知更新种子数据
- 支持 API 自动获取节假日数据
- 支持本地文件导入节假日数据
- 更新后需清除缓存，确保数据一致性

---

## 三、合规检查清单

### 3.1 数据准确性

- [x] 法定节假日数据准确（与国务院通知一致）
- [x] 包含调休日期（补班日不视为节假日）
- [x] 时区统一为 Asia/Shanghai
- [x] 年度数据更新机制（`UpdateHolidayCommand`）

### 3.2 系统集成

- [x] 缓存机制（`cache_ttl = 86400`，1 天）
- [x] 数据种子（`Holiday2026Seeder.php`）
- [x] 与防沉迷系统联动（节假日判断）

---

## 四、代码检测报告

### 4.1 检测结果

| 检测项 | 状态 | 说明 |
|------|------|------|
| 时区配置 | ✅ 已通过 | `timezone = Asia/Shanghai` |
| 缓存机制 | ✅ 已通过 | `cache_ttl = 86400`（1天），节假日数据不频繁变化 |
| 数据种子 | ✅ 已通过 | `Holiday2026Seeder.php` 提供年度节假日数据 |
| 数据更新 | ✅ 已修复 | `UpdateHolidayCommand` 支持 API 自动获取 / 本地文件导入 |
| 调休处理 | ✅ 已通过 | 调休日期不视为节假日 |
| 防沉迷集成 | ✅ 已通过 | 节假日判断精度到日 |

### 4.2 审查结论

本包为节假日数据管理包，服务于防沉迷系统和薪酬计算。核心功能合规，数据更新自动化。所有合规项均已通过检测，无需代码修复。

---

## 五、免责声明

本扩展包在配置层面实现了节假日数据管理的合规基础能力，但不构成法律建议。使用方应：

1. 每年根据国务院最新放假通知更新节假日数据
2. 确保节假日数据与防沉迷系统、薪酬系统的联动准确
3. 少数民族地区需单独配置地方性节假日
4. 咨询专业法律顾问，确保系统整体合规