# 自动记账APP

**Repository Path**: shen-cairen/BillCatch

## Basic Information

- **Project Name**: 自动记账APP
- **Description**: 自动帮忙记账，自己使用
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-06-16
- **Last Updated**: 2026-06-16

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# BillCatch - 自动记账 APP

一款完全免费的安卓自动记账应用，通过多种渠道自动抓取消费记录，帮助用户轻松管理个人财务。

## ✨ 核心特性

### 🔄 多通道自动抓取
- **无障碍服务** - 实时抓取微信/支付宝支付成功页面
- **通知监听** - 自动解析支付通知
- **短信监听** - 银行消费短信识别（P1阶段）
- **账单导入** - CSV文件批量导入（P1阶段）

### 📊 智能统计报表
- 日报/周报/月报自动汇总
- 分类占比饼图
- 消费趋势分析
- 高频商户排行

### 🔒 隐私优先
- 全程本地处理，不上传财务数据
- AES-256加密存储
- 无云端依赖

### 🎨 现代化UI
- Material Design 3
- 支持暗色模式
- 简洁清爽的界面

## 🛠️ 技术栈

- **开发语言:** Kotlin
- **UI框架:** Jetpack Compose
- **架构模式:** MVVM + Clean Architecture
- **数据库:** Room + SQLCipher
- **依赖注入:** Hilt
- **图表库:** Vico
- **最低版本:** Android 8.0 (API 26)

## 📁 项目结构

```
app/
├── di/                          # 依赖注入
├── data/                        # 数据层
│   ├── local/database/          # 本地数据库
│   ├── repository/              # 仓库实现
│   └── mapper/                  # 数据映射
├── domain/                      # 领域层
│   ├── model/                   # 领域模型
│   ├── repository/              # 仓库接口
│   └── usecase/                 # 用例
├── presentation/                # 表现层
│   ├── home/                    # 首页
│   ├── record/                  # 记录列表
│   ├── statistics/              # 统计报表
│   ├── settings/                # 设置
│   └── recycle/                 # 回收站
├── service/                     # 服务层
│   ├── accessibility/           # 无障碍服务
│   ├── notification/            # 通知监听
│   └── foreground/              # 前台服务
└── util/                        # 工具类
```

## 🚀 快速开始

### 环境要求
- Android Studio Hedgehog | 2023.1.1
- JDK 17
- Android SDK 34

### 运行步骤
1. 克隆项目
2. 使用 Android Studio 打开项目
3. 同步 Gradle 依赖
4. 连接设备或启动模拟器
5. 运行应用

### 权限配置
应用需要以下权限才能正常工作：
- **无障碍权限** - 用于自动抓取支付页面
- **通知监听权限** - 用于解析支付通知
- **前台服务权限** - 用于保持后台运行

首次运行时，应用会引导用户开启必要权限。

## 📋 功能路线图

### MVP (P0) ✅
- [x] 无障碍服务自动抓取
- [x] 通知栏监听自动抓取
- [x] 基础分类自动识别
- [x] 手动记账功能
- [x] 日报/周报/月报统计
- [x] 本地加密存储
- [x] 回收站功能
- [x] 前台服务保活

### 增强功能 (P1)
- [ ] 短信监听自动抓取
- [ ] 账单文件导入
- [ ] 高级统计报表
- [ ] 数据导出功能
- [ ] 自定义分类

### 远期功能 (P2)
- [ ] 智能分类优化
- [ ] 多账本支持
- [ ] 预算管理
- [ ] 家庭共享账本
- [ ] WebDAV云同步

## 📄 文档

- [需求概述](docs/issues/20260616_185854_自动记账APP需求概述.md)
- [正式需求文档](docs/requirements/20260616_190542_自动记账APP需求v1.0.md)
- [技术架构决策](docs/decisions/20260616_191500_技术架构决策.md)
- [项目日志](logs/project_log.md)

## 🤝 贡献

欢迎提交 Issue 和 Pull Request！

## 📝 许可证

本项目采用 MIT 许可证 - 详见 [LICENSE](LICENSE) 文件

## 🙏 致谢

感谢以下开源项目：
- [Vico](https://github.com/patrykandpatrick/vico) - 图表库
- [SQLCipher](https://github.com/nicjansma/sqlcipher-android) - 数据库加密
- [Hilt](https://dagger.dev/hilt/) - 依赖注入

---

**BillCatch** - 让每一笔消费都有迹可循 💰