bookkeeping/README.md

# 轻记账 (Lightweight Bookkeeping)

一个轻量级的个人记账应用，专注于隐私和离线使用。

## 🌟 特点

- 🔒 完全离线运行，无需网络连接
- 📱 极简权限要求，仅使用必要的系统权限
- 💰 支持收入和支出记录
- 👥 支持多人记账
- 📊 按日期和类别统计
- 🎨 Material You 设计风格

## 🛠 技术栈

- 语言：Kotlin
- UI框架：Jetpack Compose
- 数据库：Room
- 架构：MVVM

## 📱 功能

### 记账管理
- 收入和支出记录
- 自定义分类管理
- 日期和时间选择
- 备注说明

### 成员管理
- 多人记账支持
- 成员关联记录
- 按成员筛选统计

### 数据统计
- 月度收支统计
- 分类统计
- 每日收支明细

## 🔒 隐私保护

- 完全离线运行，数据存储在本地
- 无需任何网络权限
- 最小化系统权限要求

## 📝 系统要求

- Android 5.0 (API 21) 或更高版本
- 存储权限（用于数据备份，可选）

## 🔜 未来计划

- [ ] 数据导出和备份
- [ ] 预算管理
- [ ] 更多统计图表
- [ ] 自定义主题

## 📄 许可证

[MIT License](LICENSE)

## 开发计划

### 1. 基础功能 (已完成)
- [x] 收入/支出记录管理
- [x] 分类管理系统
  - [x] 默认分类
  - [x] 自定义分类
  - [x] 分类编辑/删除
- [x] 自定义日期选择器
- [x] Material 3 设计界面
- [x] 深色/浅色主题切换
- [x] 主题色自定义

### 2. 成员管理功能 (已完成)
- [x] 成员添加/编辑/删除
- [x] 记账时选择相关成员
- [x] 成员消费统计
- [x] 成员间账单分摊

### 3. 数据统计与可视化 (feature/statistics)
- [ ] 支出/收入趋势图表
- [ ] 分类占比饼图
- [ ] 月度/年度报表
- [ ] 成员消费分析
- [ ] 自定义统计周期

### 4. 数据导出与备份 (feature/backup)
- [ ] 导出 CSV/Excel 功能
- [ ] 云端备份支持
- [ ] 数据迁移工具
- [ ] 定期自动备份
- [ ] 备份加密功能

### 5. 预算管理 (feature/budget)
- [ ] 月度预算设置
- [ ] 预算超支提醒
- [ ] 分类预算管理
- [ ] 成员预算管理
- [ ] 预算分析报告

### 6. 用户体验优化 (feature/ux-enhancement)
- [x] 深色模式支持
- [ ] 手势操作优化
- [ ] 快速记账小组件
- [ ] 多语言支持
- [ ] 自定义主题

### 7. 性能优化 (feature/performance)
- [ ] 大数据量处理优化
- [ ] 启动速度优化
- [ ] 内存使用优化
- [ ] 缓存策略优化
- [ ] 数据库查询优化

## 分支管理

- `master`: 稳定主分支
- `develop`: 主开发分支
- `feature/*`: 功能开发分支
- `release/*`: 版本发布分支
- `hotfix/*`: 紧急修复分支

## 版本历史

### v1.1.0 (2024-01-10)
- ✨ 成员管理功能
  - 成员添加/编辑/删除
  - 记账时关联成员
  - 成员消费统计
- 🎨 UI/UX 优化
  - 记录展示优化
  - 月度统计界面
  - 分组展示优化
- 📊 数据管理
  - 记录筛选增强
  - 数据库性能优化
  - 状态管理重构

### v1.0.0 (2024-01-05)
- ✨ 基础记账功能
  - 收入/支出记录
  - 金额、日期、分类、备注管理
- 🎨 Material 3 设计界面
  - 深色/浅色主题切换
  - 主题色自定义
- 📊 分类管理
  - 默认分类预设
  - 自定义分类支持
  - 分类编辑与删除
- 📅 月度统计
  - 月度收支总览
  - 月份快速切换
- 🗓️ 自定义日期选择器

## 贡献指南

1. Fork 项目
2. 创建功能分支 (`git checkout -b feature/AmazingFeature`)
3. 提交更改 (`git commit -m 'feat: Add some AmazingFeature'`)
4. 推送到分支 (`git push origin feature/AmazingFeature`)
5. 提交 Pull Request

## 联系方式

- 作者：YovinChen
- 邮箱：gzh298255@gmail.com
- 博客：[blog.hhdxw.top](https://blog.hhdxw.top)

## 致谢

感谢所有为这个项目做出贡献的开发者！