# 人工维护指南

## 日常修改从哪里开始

- 界面与交互：`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 重复导入、确认、修改、搜索、账簿导出、备份和恢复。安装升级测试不得删除应用数据目录。

## 故障定位顺序

先记录用户看到的中文错误和触发步骤，再判断属于界面、命令、数据库迁移还是文件系统。修复后必须增加能复现问题的自动测试。不要让用户手工编辑数据库或密钥文件。