feat: initialize Xiaobai Bookkeeping 0.9

README.md

@@ -0,0 +1,46 @@
+# 小白记账
+
+小白记账是面向零会计基础个体工商户的本地优先 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/`。