From 5e10cbe7901843c125ad93521fd01c9ef14b4003 Mon Sep 17 00:00:00 2001
From: openclaw <asskicker0214@outlook.com>
Date: Sat, 25 Jul 2026 22:37:39 +0800
Subject: [PATCH] chore: add legacy excel import script

---
 README.md | 12 ++++++++++++
 1 file changed, 12 insertions(+)

diff --git a/README.md b/README.md
index efdd96d..3704758 100644
--- a/README.md
+++ b/README.md
@@ -83,6 +83,18 @@ docker compose --env-file .env -f compose.pro.yaml exec api \
 
 用户与唯一的“个人账本”会在同一个数据库事务内创建。
 
+## 导入旧版 Excel 账本
+
+`backup/import-legacy-excel.sql` 是根据 `backup/excel` 中的百事 AA 记账导出文件生成的可重复执行脚本。它会创建 `QHB` 和 `WHR` 用户（新用户的密码为 `12345678`）、个人账本、5 个共享账本及 252 笔有效流水；其中 EUR 流水会先标记为待换算。金额为 0 的旧记录会被跳过，因为 Cents 不允许保存 0 金额流水。
+
+生产环境执行：
+
+```bash
+docker compose --env-file .env -f compose.pro.yaml exec -T db \
+  psql -U "${POSTGRES_USER:-cents}" -d "${POSTGRES_DB:-cents}" \
+  < backup/import-legacy-excel.sql
+```
+
 ## 生产数据库备份
 
 `backup` 容器每天北京时间 `03:00` 将 PostgreSQL 备份到生产 clone 目录下的 `./backups`。备份采用 PostgreSQL custom format，并在写入后校验；超过 30 天的备份会自动删除。