# Kylin Region - 法律合规文档

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

---

## 一、适用法律法规

### 1.1 《中华人民共和国数据安全法》(2021.9.1)

| 条款 | 要求 | 合规要点 |
|------|------|----------|
| 第六条 | 各地区对本地区数据安全负责 | 行政区划数据来源为国家统计局官方数据 |
| 第二十一条 | 国家建立数据分类分级保护制度 | 地区数据为公开基础数据，无敏感信息 |
| 第二十七条 | 开展数据处理活动应当依照法律、法规的规定 | 数据仅用于地址选择、归属地判断等合法用途 |

### 1.2 《中华人民共和国网络安全法》(2017.6.1)

| 条款 | 要求 | 合规要点 |
|------|------|----------|
| 第二十一条 | 采取数据分类、重要数据备份和加密等措施 | 地区数据缓存机制 |
| 第四十二条 | 网络运营者不得泄露、篡改、毁损其收集的个人信息 | 地区数据不含个人信息 |

### 1.3 《中华人民共和国个人信息保护法》(2021.11.1)

| 条款 | 要求 | 合规要点 |
|------|------|----------|
| 第六条 | 最小必要原则 | 地区数据仅包含行政区划代码和名称，不涉及个人信息 |

### 1.4 《中华人民共和国测绘法》(2017.7.1)

| 条款 | 要求 | 合规要点 |
|------|------|----------|
| 第三十四条 | 县级以上人民政府测绘地理信息主管部门应当向社会公布公益性地图 | 行政区划数据为公开数据，合规使用 |
| 第四十七条 | 地图的编制、出版、展示、登载应当符合国家有关规定 | 如涉及地图展示，需使用合规地图 |

### 1.5 《地图管理条例》(2016.1.1)

| 条款 | 要求 | 合规要点 |
|------|------|----------|
| 第八条 | 互联网地图服务单位应当使用依法审核批准的地图 | 如展示地图需使用审图号地图 |
| 第十四条 | 国家实行地图审核制度 | 公开地图需送审 |

---

## 二、行业规范

### 2.1 GB/T 2260-2007《中华人民共和国行政区划代码》

| 条款 | 要求 | 合规要点 |
|------|------|----------|
| 第 4 条 | 行政区划代码采用 6 位数字 | 三级联动数据遵循 6 位编码规则 |
| 第 5 条 | 代码结构：省 2 位 + 市 2 位 + 县 2 位 | 数据表结构与此对应 |
| 第 6 条 | 代码应保持稳定，行政区划变更时同步更新 | 跟随国家统计局发布版本更新 |

### 2.2 GB/T 10114-2003《县以下行政区划代码编制规则》

| 条款 | 要求 | 合规要点 |
|------|------|----------|
| 第 3 条 | 街道/镇/乡使用 9 位编码 | 扩展支持乡镇级数据 |

### 2.3 数据来源合规

- 数据来源：国家统计局公开发布的行政区划数据
- 数据更新：跟随国家统计局最新发布版本更新
- 数据使用：仅用于地址选择、归属地判断、统计分析等合法用途
- 数据完整性：不对原始数据进行篡改

### 2.4 数据缓存规范

- 地区数据为低频变化数据，适合缓存
- 缓存策略：内存缓存 + 数据库持久化
- 缓存失效：跟随国家统计局数据更新同步更新
- 缓存 TTL：省份/树形 86400 秒（24 小时），搜索 3600 秒（1 小时）

---

## 三、合规检查清单

### 3.1 数据合规

- [x] 数据来源为国家统计局官方发布
- [x] 不包含个人信息
- [x] 编码遵循 GB/T 2260 标准
- [x] 数据仅用于合法用途

### 3.2 数据安全

- [x] 数据缓存机制（24 小时 TTL）
- [x] 数据完整性保护
- [x] 数据更新机制（`RegionImportCommand`）

### 3.3 数据使用

- [x] 地址选择级联（`cities()`、`districts()`）
- [x] 归属地判断（`byCode()`、`byName()`）
- [x] 统计分析（`search()`）
- [x] 树形结构（`getTree()`）

### 3.4 API 接口

- [x] 省份列表 API
- [x] 子地区 API
- [x] 树形结构 API

---

## 四、代码检测报告

### 4.1 检测结果

| 检测项 | 状态 | 说明 |
|------|------|------|
| 数据来源合规 | ✅ 已通过 | 国家统计局官方数据 |
| 个人信息保护 | ✅ 已通过 | 不含个人信息，仅行政区划数据 |
| 数据缓存 | ✅ 已通过 | 省份/树形 24h，搜索 1h |
| 编码规范 | ✅ 已通过 | 遵循 GB/T 2260 6 位编码 |
| 数据完整性 | ✅ 已通过 | 不对原始数据篡改 |
| 数据安全 | ✅ 已通过 | 公开基础数据，无敏感信息 |
| Facade 方法完整性 | ✅ 已修复 | 新增 `cities()`、`districts()`、`search()`、`byCode()`、`byName()`、`clearCache()` |
| 缓存清除 | ✅ 已修复 | 新增 `clearCache()` 方法 |

### 4.2 审查结论

本包为行政区划数据包，数据来源为国家统计局公开发布数据，不涉及个人信息，遵循 GB/T 2260 编码规范。所有合规项均已通过检测。本次新增 `cities()`、`districts()`、`search()`、`byCode()`、`byName()`、`clearCache()` 方法，补全 Facade 功能。

---

## 五、免责声明

本扩展包在代码层面实现了行政区划数据的合规管理，但不构成法律建议。使用方应：

1. 确保使用国家统计局最新发布的行政区划数据
2. 不得将地区数据用于非法用途
3. 如涉及地图展示，需符合《测绘法》和《地图管理条例》相关规定，使用审图号地图
4. 咨询专业法律顾问，确保系统整体合规
