chore: 初始化文档站仓库

2026-09-21 13:38:20 +08:00
commit a4ae7ac979
58 changed files with 4622 additions and 0 deletions
@@ -0,0 +1,51 @@
+# 交通银行账单
+
+交通银行支持导出「交易明细列表」，系统以 **xls** 或 **zip** 形式导入。
+
+## 如何获取
+
+### 手机 App（个人）
+
+1. 打开交通银行 App，在首页点击「**我的账户**」。
+2. 选择需要导出的银行卡，点击「**明细清单**」。
+3. 点击「**发送至邮箱**」，选择时间范围后，交易明细会以电子版发送到指定邮箱。
+4. 导出文件通常为 **Excel（xls）**，并可能以加密压缩包形式发送，解压密码以银行提示为准。
+
+时间范围最长可选 1 年，数据量较大时建议分批次导出。
+
+### 电脑端
+
+登录交通银行个人网银，在账户明细查询中导出交易明细；企业网银可通过「对账单管理」下载。
+
+## 导入
+
+在[账单导入](/guide/transactions)页选择账单类型「交通银行」，上传 xls 或 zip 文件。
+
+- 支持格式：`.xls`、`.zip`
+
+## 字段映射
+
+系统以「记账日期」定位表头，读取以下列：
+
+| 源字段（xls 列） | 落库字段 | 处理说明 |
+|---|---|---|
+| 交易时间 | `transaction_time` | 缺失时回退记账日期 |
+| 记账日期 | `transaction_time` | 仅作兜底 |
+| 对方户名 | `remark` | 作为备注 |
+| 摘要 | `remark` | 与对方户名拼接/作为商品名称 |
+| 支出金额 | `amount` + `type` | 支出列有值时 type=EXPENSE |
+| 收入金额 | `amount` + `type` | 收入列有值时 type=INCOME |
+| 余额 | 仅生成去重键 | 参与 `BOCOM_日期_时分秒_类型_金额` 去重键 |
+| — | `channel` | 固定为 `BOCOM` |
+| — | `category_id` | 取导入面板默认分类；未选为 NULL |
+
+「--」等占位符会被视为空值。
+
+## 去重
+
+交通银行流水没有交易号，系统会以「日期 + 时分秒 + 类型 + 金额」生成稳定的去重键（如 `BOCOM_20260916_082932_收入_3406.50`）。
+
+## 注意事项
+
+- 导出时请选择系统支持的日期范围，单次导出过大时可分多次。
+- 若导出为加密压缩包，导入时需输入密码。