chore: 初始化文档站仓库

guide/bills/cmb.md

@@ -0,0 +1,81 @@
+# 招商银行账单
+
+招商银行支持导出「交易流水」，系统以 **CSV**、**PDF** 或 **zip** 形式导入。
+
+## 如何获取
+
+招商银行提供多种导出渠道，格式与可查询时间范围各不相同，可按需选择。
+
+### 手机 App（个人，常用）
+
+- 打开招商银行 App，在首页搜索「**流水打印**」或「**打印流水**」，或在 **我的 → 全部** 中找到「流水打印」。
+- 选择账户与时间范围，输入接收邮箱提交。
+- **通过 App 导出的通常是带电子印章的 PDF**，适用于个人对账或证明材料。
+- App 可查询较长时间范围（最长近 5 年），但**单次申请跨度一般不超过 1 年**，更早记录需分次申请。
+- 导出的文件为加密压缩包，解压密码在 App 的「**申请记录**」页查看。
+
+### 个人网银专业版 / 个人银行 PC 版（可导出 Excel）
+
+- 登录个人银行 PC 版（专业版），进入 **账户管理 → 活期交易查询**。
+- 选择时间段查询后点击「保存」，文件类型选择 **Excel(.xls)**。
+- **仅支持查询近 13 个月**的交易记录，且仅支持中文活期交易记录；更早的流水需改用 App 或前往网点。
+
+### 营业网点
+
+- 携带有效身份证件与一卡通，可打印**开户至今**的流水；13 个月以内通常免费，13 个月以上部分网点可能收费。
+- 如需要更早时间且为 Excel 格式，可向柜员明确提出「定制导出电子表格」的需求。
+
+### 企业网银 / 企业手机 App
+
+- 企业网银：**账务管理 → 账务查询 → 交易查询 → 导出 → Excel 快速导出**（可查近 5 年，单次跨度不超过 366 天）。
+- 企业手机 App：首页 → 收支明细 → 右上角下载 → 选择账号与起止日期 → 输入邮箱接收 Excel。
+
+## 导入
+
+在[账单导入](/guide/transactions)页选择账单类型「招商银行」，上传 CSV、PDF 或 zip 文件。
+
+- 支持格式：`.csv`、`.pdf`、`.zip`
+- CSV 与 PDF 使用同一套去重键，两种格式可以混用而不重复导入。
+
+## 字段映射
+
+### CSV
+
+| 源字段（CSV 列） | 落库字段 | 处理说明 |
+|---|---|---|
+| 交易日期 | `transaction_time` | 与交易时间组合为完整时间 |
+| 交易时间 | `transaction_time` | 同上 |
+| 交易备注 | `remark` | 作为备注 |
+| 交易类型 | `remark` / 预览 | 作为商品名称或交易状态 |
+| 收入金额 | `amount` + `type` | 有值时 type=INCOME |
+| 支出金额 | `amount` + `type` | 有值时 type=EXPENSE |
+| 余额 | 生成去重键 | 参与 `CMB_日期_类型_金额_余额` |
+| — | `channel` | 固定为 `CMB` |
+| — | `category_id` | 取导入面板默认分类；未选为 NULL |
+
+`#` 开头的行视为元信息/合计并结束解析。
+
+### PDF
+
+PDF 为文本型「交易流水」，系统按字符坐标还原表格，读取列：
+
+| 源字段 | 落库字段 | 处理说明 |
+|---|---|---|
+| 记账日期 | `transaction_time` | 取零点 |
+| 交易金额 | `amount` + `type` | 带符号单列：负数为支出、正数为收入 |
+| 联机余额 | 生成去重键 + 校验 | 参与去重键；按余额连续性校验（误差 0.005），不连续则标记为不可导入 |
+| 交易摘要 / 对手信息 | `remark` | 作为备注 |
+| — | `channel` | 固定为 `CMB` |
+| — | `category_id` | 取导入面板默认分类；未选为 NULL |
+
+## 去重
+
+银行流水通常没有交易号，系统会以「日期 + 类型 + 金额 + 余额」生成稳定的去重键（如 `CMB_20260916_支出_3406.50_43233.20`），因此重复导入同一账单不会产生重复记录。
+
+## 注意事项
+
+- 系统支持导入招商银行的 **CSV** 与 **PDF**（文本型），优先推荐 CSV。
+- 若导出为加密压缩包，导入时需输入密码（密码见 App「申请记录」页）。
+- PDF 账单请使用招商银行 App 导出的文本型 PDF，扫描件无法解析。
+- **个人网银专业版导出的 `.xls` 暂不支持直接导入**：可在 Excel 中另存为 CSV 后再导入，或改用 App 导出 PDF。
+- 招行 CSV 与 PDF 使用同一套去重键，两种格式可混用而不重复导入。