# 小白记账

小白记账是面向零会计基础个体工商户的本地优先 Windows AI 记账与申报协作软件。

当前版本为 `0.9.0` 本地内测版，包含：

- 产品章程、架构、设计系统和质量维护规范
- 可交互的经营首页、待确认、票据、流水、账簿和报税日历界面
- 整数金额领域模型与第一组自动化测试
- Tauri 桌面容器与 SQLite 本地账本
- UTF-8 CSV 流水导入、整批校验、文件去重和交易去重
- 经营/个人收支确认、追加式审计历史和幂等保存
- 个人收支自动排除在经营收入、经营支出与利润汇总之外
- 经营主体名称、主体类型和地区的本地建档、修改与重启恢复
- 建档字段的前后端双重校验，以及单一主体约束
- SQLite 在线备份、结构校验与 SHA-256 完整性校验
- 恢复前自动安全快照、损坏备份拒绝和失败回退
- SQLCipher 账本与备份加密，密钥由当前 Windows 用户的 DPAPI 保护
- 旧版明文账本与可用备份在首次启动时自动迁移为加密格式
- 手工记账、流水搜索与筛选，以及保留原始记录的追加式纠错
- 基于当前有效流水的确定性账簿汇总，自动排除个人收支
- Excel 可直接打开的 UTF-8 CSV 账簿导出与独立 SHA-256 校验文件

## 本地运行

```powershell
npm install
npm run dev
```

## 质量检查

```powershell
npm test
npm run build
```

Windows 发布构建需要 Rust 和 Visual C++ Build Tools。当前开发环境的 Build Tools 位于 `C:\VSBuildTools2022`，可运行 `scripts\verify.ps1` 做完整检查。

## 当前边界

首次启动时界面展示明确标记的演示数据。Windows 客户端可完成经营主体建档、手工记账、CSV 导入、确认与纠错、账簿导出、加密备份和恢复。票据识别、AI 与真实申报尚未接入，相应页面仅说明开放条件，产品不会计算或提交任何真实税务数据。

可使用 [流水导入示例.csv](samples/流水导入示例.csv) 验收导入与重复导入，使用 [待确认流水示例.csv](samples/待确认流水示例.csv) 验收确认保存。

详细约定见 `docs/`。