# money_manage_app

**Repository Path**: isme/money_manage_app

## Basic Information

- **Project Name**: money_manage_app
- **Description**: No description available
- **Primary Language**: Dart
- **License**: AGPL-3.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-11-23
- **Last Updated**: 2025-11-28

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 家账通 APP V1.0

家庭财务管理专家 - 让家庭收支管理更简单

## 项目简介

家账通是一款专为家庭用户设计的记账应用，支持个人记账和家庭共享账单功能。应用界面简洁美观，操作简单易用，适合各年龄段用户使用。

## 主要功能

### 1. 用户管理
- ✅ 用户注册与登录
- ✅ 用户信息管理
- ✅ 安全退出登录

### 2. 收支记录
- ✅ 快速记录收入/支出
- ✅ 多种分类选择（餐饮、交通、购物等）
- ✅ 自定义分类管理
- ✅ 添加备注信息
- ✅ 选择账单日期
- ✅ 离线记账支持

### 3. 账单管理
- ✅ 账单列表展示（按日期分组）
- ✅ 当月收支概览
- ✅ 收支统计分析
- ✅ 账单详情查看（NEW v1.0.1）
- ✅ 账单编辑功能（NEW v1.0.1）
- ✅ 账单删除功能（NEW v1.0.1）

### 4. 数据统计
- ✅ 月度收支汇总
- ✅ 分类统计图表
- ✅ 收支趋势分析
- ✅ 饼图可视化展示
- ✅ 分类占比统计

### 5. 家庭共享
- ✅ 创建家庭空间
- ✅ 添加家庭成员
- ✅ 家庭成员管理
- ✅ 家庭账单共享
- ✅ 权限管理（管理员/普通成员）

### 6. 系统设置
- ✅ 个人信息展示
- ✅ 收支分类管理
- ✅ 关于应用
- ✅ 退出登录

## 技术栈

- **框架**: Flutter 3.8+
- **状态管理**: Provider
- **本地数据库**: SQLite (sqflite)
- **本地存储**: SharedPreferences
- **图表展示**: fl_chart
- **日期处理**: intl

## 项目结构

```
lib/
├── constants/          # 常量定义
│   ├── app_constants.dart    # 应用常量
│   ├── app_colors.dart       # 颜色定义
│   └── category_data.dart    # 分类数据
├── models/            # 数据模型
│   ├── user_model.dart       # 用户模型
│   ├── bill_model.dart       # 账单模型
│   ├── category_model.dart   # 分类模型
│   └── family_model.dart     # 家庭模型
├── services/          # 服务层
│   ├── database_service.dart # 数据库服务
│   └── auth_service.dart     # 认证服务
├── providers/         # 状态管理
│   ├── auth_provider.dart    # 认证状态
│   ├── bill_provider.dart    # 账单状态
│   ├── category_provider.dart # 分类状态
│   └── family_provider.dart  # 家庭状态
├── screens/           # 页面
│   ├── login_screen.dart     # 登录页面
│   ├── register_screen.dart  # 注册页面
│   ├── home_screen.dart      # 首页
│   ├── add_bill_screen.dart  # 添加账单
│   ├── statistics_screen.dart # 统计页面
│   ├── family_screen.dart    # 家庭管理
│   ├── settings_screen.dart  # 设置页面
│   └── category_management_screen.dart # 分类管理
├── widgets/           # 组件
│   └── bill_list_item.dart   # 账单列表项
├── utils/             # 工具类
│   ├── date_utils.dart       # 日期工具
│   └── money_utils.dart      # 金额工具
└── main.dart          # 应用入口
```

## 安装与运行

### 环境要求

- Flutter SDK 3.8.1 或更高版本
- Dart SDK 3.0.0 或更高版本
- Android Studio / VS Code
- Android 设备或模拟器（API 21+）
- iOS 设备或模拟器（iOS 12.0+）

### 安装步骤

1. **克隆项目**
```bash
git clone <repository-url>
cd money_manager
```

2. **安装依赖**
```bash
flutter pub get
```

3. **运行应用**
```bash
# Android
flutter run

# iOS
flutter run -d ios

# Web
flutter run -d chrome
```

### 构建应用

```bash
# Android APK
flutter build apk --release

# Android App Bundle
flutter build appbundle --release

# iOS
flutter build ios --release
```

## 数据库设计

### 用户表 (users)
- id: 用户ID
- username: 用户名
- password: 密码
- nickname: 昵称
- avatar: 头像
- created_at: 创建时间
- updated_at: 更新时间

### 账单表 (bills)
- id: 账单ID
- user_id: 用户ID
- family_id: 家庭ID（可选）
- type: 类型（expense/income）
- amount: 金额（分为单位）
- category_id: 分类ID
- category_name: 分类名称
- remark: 备注
- bill_date: 账单日期
- created_at: 创建时间
- updated_at: 更新时间
- is_synced: 是否已同步

### 分类表 (categories)
- id: 分类ID
- name: 分类名称
- type: 类型（expense/income）
- icon_code: 图标代码
- color_value: 颜色值
- is_custom: 是否自定义
- user_id: 用户ID（自定义分类）
- sort_order: 排序顺序
- created_at: 创建时间

### 家庭表 (families)
- id: 家庭ID
- name: 家庭名称
- admin_user_id: 管理员ID
- created_at: 创建时间
- updated_at: 更新时间

### 家庭成员表 (family_members)
- id: 成员ID
- family_id: 家庭ID
- user_id: 用户ID
- username: 用户名
- nickname: 昵称
- role: 角色（admin/member）
- joined_at: 加入时间

## 使用说明

### 首次使用

1. 启动应用后，进入注册页面
2. 输入用户名（至少3个字符）
3. 输入密码（至少6个字符）
4. 可选输入昵称
5. 点击"注册"完成注册
6. 自动登录进入首页

### 记录账单

1. 在首页点击右下角"+"按钮
2. 选择"记录支出"或"记录收入"
3. 输入金额
4. 选择分类
5. 选择日期（默认今天）
6. 可选添加备注
7. 向下滚动到页面底部
8. 点击大号"保存账单"按钮（80px 高度，全屏宽度）

### 查看和编辑账单（NEW v1.0.1）

1. 在首页点击任意账单项
2. 进入详情页查看完整信息
3. 点击右上角编辑图标或底部"编辑"按钮
4. 修改金额、分类、日期或备注
5. 点击底部"保存修改"按钮

### 删除账单（NEW v1.0.1）

1. 在首页点击要删除的账单
2. 进入详情页
3. 点击右上角删除图标或底部"删除"按钮
4. 确认删除操作
5. 账单被永久删除（不可恢复）

### 查看统计

1. 点击底部导航栏"统计"
2. 查看当月收支汇总
3. 使用左右箭头切换月份
4. 查看分类统计图表和占比

### 管理家庭

1. 点击底部导航栏"家庭"
2. 首次使用点击"创建家庭"
3. 输入家庭名称
4. 邀请成员加入（输入用户名）
5. 管理员可删除成员

### 自定义分类

1. 点击底部导航栏"我的"
2. 选择"收支分类管理"
3. 切换"支出分类"或"收入分类"标签
4. 点击"添加自定义分类"
5. 输入分类名称
6. 保存后即可在记账时使用

## 🆕 最新更新（v1.0.1）

### 新增功能

1. **账单详情页面**
   - 查看账单完整信息
   - 大字号金额展示
   - 支持快速编辑/删除

2. **编辑账单功能**
   - 支持修改金额、分类、日期、备注
   - 自动填充现有数据
   - 保存后自动刷新

3. **删除账单功能**
   - 二次确认防止误删
   - 删除后自动更新统计

4. **记账页面优化**
   - 保存按钮移至底部
   - 按钮高度增加至 80px
   - 全屏宽度，更易点击

详细说明请查看 [NEW_FEATURES.md](NEW_FEATURES.md) 和 [CHANGELOG.md](CHANGELOG.md)

## 注意事项

1. **数据安全**: 当前版本数据存储在本地，请定期备份重要数据
2. **密码安全**: 建议使用强密码，当前版本密码未加密存储
3. **家庭功能**: 添加成员功能需要后端支持，当前版本为演示功能
4. **离线使用**: 应用支持离线记账，所有功能均可离线使用

## 产品特色

- 🎨 **现代化UI设计**: 简洁美观，符合Material Design规范
- 📱 **响应式布局**: 适配各种屏幕尺寸
- 🚀 **流畅体验**: 优化的性能，快速响应
- 💾 **本地存储**: 无需联网，数据存储在本地
- 📊 **数据可视化**: 直观的图表展示收支情况
- 👨‍👩‍👧‍👦 **家庭共享**: 与家人共同管理财务

## 开发计划

### V1.1（计划中）
- [ ] 云端数据同步
- [ ] 数据导出（Excel/PDF）
- [ ] 账单附件（拍照/图片）
- [ ] 预算管理
- [ ] 账单提醒
- [ ] 数据备份与恢复

### V2.0（规划中）
- [ ] 多账户管理
- [ ] 债务管理
- [ ] 资产管理
- [ ] 月度报告
- [ ] AI智能分类
- [ ] 语音记账

## 许可证

本项目仅供学习和参考使用。

## 联系方式

如有问题或建议，欢迎反馈。

---

**家账通** - 让家庭财务管理更简单 ❤️