https://github.com/atorber/wangcai

一款数据完全可控的个人记账手机APP
https://github.com/atorber/wangcai

Last synced: about 2 months ago
JSON representation

一款数据完全可控的个人记账手机APP

• Host: GitHub
• URL: https://github.com/atorber/wangcai
• Owner: atorber
• Created: 2026-04-23T03:24:48.000Z (about 2 months ago)
• Default Branch: main
• Last Pushed: 2026-04-24T13:04:27.000Z (about 2 months ago)
• Last Synced: 2026-04-24T14:28:08.211Z (about 2 months ago)
• Language: Dart
• Homepage:
• Size: 1.08 MB
• Stars: 0
• Watchers: 0
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md

Awesome Lists containing this project

README

          
# 旺财 (WangCai)

**旺财** 取“兴旺发财”之意，是一款以**本地优先、数据自主可控**为核心理念的个人记账应用。项目基于 Flutter 构建，目标是让用户在不依赖平台会员体系的前提下，也能完整、长期、安全地管理自己的财务数据。

## 项目缘起：为什么会有旺财

这个项目并非从“做一个新 App”出发，而是来自一个长期存在的真实痛点：

- 长期使用的记账软件在**非会员**情况下大量核心功能受限，连最基础的导出与统计能力都无法正常使用，严重影响日常记账体验和数据可用性。

- 个人财务数据本质上属于高敏感信息。随着对数据安全认知的提升，我们越来越意识到：频繁接到诈骗、贷款推销电话等现象，背后可能与平台侧的数据泄露或滥用风险有关。

基于上述问题，旺财选择了明确方向：  

**把财务数据控制权交还给用户自己**。

- 账本数据默认保留在本地设备，降低对第三方平台的被动依赖；

- 可通过 WebDAV 协议备份到自有网盘/服务器，实现可追溯、可迁移、可长期保存的数据资产；

- 功能设计以“可用、可导出、可统计”为基础能力，而不是被会员体系绑定的特权。

得益于当下 AI 编程工具的成熟，个人开发者可以更高效地打造真正贴合自身需求的记账产品。旺财也是这一实践：  

**我们可以自由定义自己的记账软件，而不是被动适应平台规则。**

## 使用说明 (User Guide)

以下是“旺财”App 的核心使用指南，帮助您快速上手：

### 1. 记一笔 (添加账单)

*   **入口**: 在应用底部的导航栏中，点击中间醒目的 **“添加” (+号)** 按钮。

*   **操作**:

    *   在弹出的面板顶部选择类型：`支出`、`收入`、`转账`、`借出` 或 `借入`。

    *   输入金额。

    *   在下方的分类网格中选择对应的消费类别（如：餐饮、交通、购物等）。

    *   可选：修改日期和添加备注（例如：“和朋友聚餐”）。

    *   点击底部的 **“保存”**。

### 2. 查看资产与账户

*   **入口**: 底部导航栏点击 **“首页”**。

*   **操作**:

    *   **资产概览**: 页面顶部会显示您的【总资产】、【净资产】和【总负债】。

    *   **我的账户**: 向下滚动可以查看所有已绑定的账户列表（包含储蓄卡、信用卡、支付宝、微信等）。点击卡片可以查看详细余额或信用卡本期应还金额。

    *   **添加新账户**: 点击列表底部的 **“添加账户”** 按钮，输入初始余额、账户名称并选择类型即可新增账户。

### 3. 查看财务统计

*   **入口**: 底部导航栏点击 **“统计”**。

*   **操作**:

    *   **时间维度**: 顶部可切换【周】、【月】、【年】视图，对应统计范围会自动更新。

    *   **本期概览**: 顶部卡片展示本期的收入、支出与结余，并注明时间区间。

    *   **支出分布**: 环形图根据真实账单按分类聚合，展示各分类占比与金额。

    *   **支出趋势**: 柱状图按日 / 按月还原本期每一格的支出，当前格高亮；右上角显示与上一周期的同比变化。

    *   **财务洞察**: 基于真实账单自动计算，例如“相比上一周期节省 / 多花 ¥X”以及当前最多的支出分类。

### 4. 设置与数据安全 (WebDAV 备份)

*   **入口**: 底部导航栏点击 **“设置”**。

*   **操作**:

    *   **个性化**: 调整应用主题（深色/浅色模式），管理分类等。

    *   **安全**: 开启面容ID/指纹保护。

    *   **数据云备份（WebDAV）**:

        1. 在设置中点击 **“WebDAV 云备份”**。

        2. 按照向导填写 **WebDAV 服务地址**、**用户名** 与 **密码 / App Password**。

        3. 配置远端备份文件路径（例如：`/wangcai/records.json`）。

        4. 配置完成后可在状态页执行“立即备份”或“恢复覆盖本地”，您的记账数据将备份至自有 WebDAV 存储中。

---

## 功能特性

旺财当前已实现以下核心功能：

1.  **资产概览 (`AssetOverviewScreen`)**: 全面掌握您的财务状况。

2.  **便捷记账 (`AddTransactionScreen`)**: 随时随地记录收支，便捷的模态弹出设计。

3.  **财务统计 (`FinancialStatsScreen`)**: 基于真实账单数据，支持周 / 月 / 年维度的支出分布、趋势和同比洞察。

4.  **账户管理 (`AddAccountScreen`)**: 轻松添加和管理各类财务账户。

5.  **个性化设置 (`SettingsScreen`)**: 定制应用体验及安全选项。

6.  **数据云备份 (WebDAV Backup)**: 完整的 WebDAV 备份与恢复设置流程。

## 技术栈

*   **跨平台框架:** Flutter

*   **字体设计:** `google_fonts` (采用现代化无衬线字体 Inter)

*   **数据可视化:** `fl_chart` (用于生成精美的统计图表)

*   **图标库:** `material_symbols_icons`

*   **状态管理:** `provider` (为后续业务逻辑处理和数据状态管理提供基础)

## 快速开始 (供开发者体验)

如果您希望在本地运行并体验“旺财”应用：

1.  **准备工作:** 确保您的计算机上已安装并配置好 Flutter SDK 开发环境。

2.  **克隆仓库:**

    ```bash

    git clone 

    cd wangcai

    ```

3.  **获取依赖:**

    ```bash

    flutter pub get

    ```

4.  **运行应用:**

    ```bash

    flutter run

    ```

## 下载与发布版本

如果您希望直接下载已打包版本（如 APK / AAB），请前往 GitHub Release 页面：

- [WangCai Releases](https://github.com/atorber/wangcai/releases)

- 当前版本：[`v0.1.0`](https://github.com/atorber/wangcai/releases/tag/v0.1.0)

发布建议使用 GitHub Actions 的 `Create Release (Auto Bump Patch)` 工作流。  

该流程会读取 `pubspec.yaml` 中的版本号作为基准；若同名版本已发布，则自动将补丁位（最后一位）递增后再创建 Release（例如 `v0.1.0` 已存在时自动发布 `v0.1.1`）。

## 项目阶段总结

截至当前阶段，旺财已完成从“可用原型”到“可日常使用”的核心能力建设，主要体现在：

- **记账闭环已打通**：覆盖支出、收入、转账、借出、借入等主要交易类型，满足日常高频记录场景。

- **资产视图已成体系**：可从账户与总览两个维度查看资产、负债与净值变化，支持用户快速了解当下财务状态。

- **统计分析具备基础决策价值**：基于真实账单构建了周 / 月 / 年维度的分类占比、趋势观察与同比洞察，能够支撑基础的消费管理与自我优化。

- **数据主权路线已落地**：本地优先 + WebDAV 自有存储备份方案已具备完整配置流程，强化数据可控与可迁移能力。

- **产品风格与品牌正在统一**：界面结构、交互风格与图标视觉持续收敛，逐步形成“旺财”独立产品识别度。

整体来看，旺财已具备持续迭代的产品基础；下一阶段重点将从“功能可用”转向“稳定性、自动化与长期体验”。

## 下一步迭代路线

### P0（优先推进：稳定性与数据安全）

1. **数据可靠性增强**

   - 增加关键写入路径的异常恢复与失败重试策略。

   - 完善同步冲突处理机制（本地与远端版本差异、覆盖策略、回滚策略）。

2. **备份可验证性**

   - 增加“最近一次成功备份时间”“备份结果校验”等可视反馈。

   - 提供一键导出/导入演练流程，验证迁移可用性。

3. **基础质量保障**

   - 以“核心流程回归”为主建立最小测试集合（记账、账户、统计、同步），确保迭代不回退核心能力。

### P1（体验升级：效率与可读性）

1. **记账效率优化**

   - 增加常用分类/账户智能置顶、最近输入记忆、快捷金额模板。

   - 优化添加流程中的键盘与焦点交互，减少多步操作成本。

2. **统计与洞察增强**

   - 增加预算执行、环比/同比、异常波动提醒等实用洞察。

   - 统一图表交互与说明文案，提高可解释性。

3. **信息架构打磨**

   - 统一列表页、详情页、设置页的视觉与交互规范，持续提升一致性与学习成本友好度。

### P2（能力扩展：长期可持续）

1. **多账本与场景化**

   - 支持个人/家庭/项目等账本隔离与切换。

2. **规则自动化**

   - 支持自动分类规则、周期性账单、固定收支模板。

3. **生态与开放能力**

   - 探索与更多云端存储或自托管后端的兼容方案，提升可扩展性与长期自治能力。

---

欢迎通过 Issue 或 PR 参与共建。  

如果你也认同“财务数据应由自己掌控”，旺财会持续沿着“本地优先、可迁移、可验证”的路线长期迭代。