chore: 初始化文档站仓库

guide/bills/alipay.md

@@ -0,0 +1,63 @@
+# 支付宝账单
+
+支付宝支持导出「交易记录明细」，系统以 **CSV** 或 **zip** 形式导入。
+
+## 如何获取
+
+### 手机 App（推荐）
+
+1. 打开支付宝 App，进入 **我的 → 账单**。
+2. 点击账单页面右上角的「**…**」，选择「**开具交易流水证明**」（部分版本显示为「开具银行流水证明」）。
+3. 选择证明用途（如「用于材料证明」），点击「申请」，输入支付密码完成验证。
+4. 设置交易流水范围（全部 / 收入 / 支出）与时间范围：可选 1 个月、3 个月或自定义，**最长支持 1 年**，跨年度需分多次申请。
+5. 填写接收账单的**电子邮箱**并确认发送，账单会以压缩包形式发送到邮箱。
+
+### 电脑网页版
+
+访问支付宝官网（www.alipay.com）→ 服务大厅 → 自助服务 → 应用服务 → 收支明细证明，按提示申请。
+
+> 支付宝导出的压缩包通常未加密，可直接交给系统解析；若设置了密码，在导入时输入。
+
+## 导入
+
+在[账单导入](/guide/transactions)页选择账单类型「支付宝」，上传 CSV 或 zip 文件。
+
+- 支持格式：`.csv`、`.zip`
+- 编码：自动识别 UTF-8 / UTF-8 BOM / GBK
+
+## 字段映射
+
+解析器以「交易号」开头的表头行定位数据区，读取以下关键字段：
+
+| 源字段（CSV 列） | 落库字段 | 处理说明 |
+|---|---|---|
+| 交易号 | `external_no` | 导入去重键（`uk_user_external`） |
+| 付款时间 | `transaction_time` | 交易时间；为空时回退「交易创建时间」 |
+| 交易创建时间 | `transaction_time` | 仅作付款时间缺失时的兜底 |
+| 金额（元） | `amount` | 去除千分位逗号后解析 |
+| 收/支 | `type` | 支出→EXPENSE，收入→INCOME |
+| 交易对方 | `remark` | 与商品名称拼接为「交易对方 · 商品名称」，截断至 255 字符 |
+| 商品名称 | `remark` | 同上 |
+| 交易状态 | 仅推断/预览 | 参与类型推断与预览展示，不落库 |
+| 资金状态 | 仅推断 | 用于「不计收支」行的类型推断 |
+| 收/支=不计收支 | `include_in_stats` | 默认不计入统计 |
+| — | `channel` | 固定为 `ALIPAY` |
+| — | `category_id` | 取导入面板默认分类；未选为 NULL |
+
+以下列**完全丢弃**：商家订单号、最近修改时间、交易来源地、类型、服务费（元）、成功退款（元）、备注（支付宝自带备注）。
+
+### 类型推断
+
+| 收/支 | 交易状态 / 资金状态 | 推断类型 |
+|---|---|---|
+| 支出 | — | EXPENSE |
+| 收入 | — | INCOME |
+| 不计收支 | 含「退款」 | INCOME |
+| 不计收支 | 资金状态为「已收入」 | INCOME |
+| 不计收支 | 其他（如交易关闭） | EXPENSE |
+
+## 注意事项
+
+- 支付宝 CSV 中自带的「备注」列不会被导入，系统备注由「交易对方 · 商品名称」拼接生成。
+- 建议按年或按季度导出，避免单文件过大。
+- 重复导入同一文件时，相同交易号的记录会被跳过。