feat: initialize Xiaobai Bookkeeping 0.9

docs/MAINTENANCE_GUIDE.md

@@ -0,0 +1,24 @@
+# 人工维护指南
+
+## 日常修改从哪里开始
+
+- 界面与交互：`src/App.tsx`，视觉令牌与布局：`src/styles.css`。
+- 金额汇总规则：`src/domain/transactions.ts`，修改时先补对应测试。
+- 本地数据库、命令、迁移、备份和导出：`src-tauri/src/lib.rs`。
+- 产品边界和架构决定：`docs/`，发布前同步更新版本说明。
+
+## 不破坏旧数据的规则
+
+1. 不直接改写已经发布的迁移；新增表或字段使用新的迁移版本。
+2. 原始流水、确认和纠错分开保存；展示层读取最新有效值。
+3. 涉及数据库格式时，必须测试旧库升级、失败回退、备份与恢复。
+4. 金额始终用整数分保存和计算，禁止浮点数入库。
+5. 外部 OCR、AI、税务规则和申报通道必须放在适配层，核心账本不依赖供应商格式。
+
+## 每次发布的固定检查
+
+运行 `scripts/verify.ps1`，确认前端测试、生产构建和 Rust 测试通过；随后人工检查建档、记一笔、CSV 重复导入、确认、修改、搜索、账簿导出、备份和恢复。安装升级测试不得删除应用数据目录。
+
+## 故障定位顺序
+
+先记录用户看到的中文错误和触发步骤，再判断属于界面、命令、数据库迁移还是文件系统。修复后必须增加能复现问题的自动测试。不要让用户手工编辑数据库或密钥文件。