# 微信记账小程序

**Repository Path**: wanghtzf/wechat-accounting-mini-program

## Basic Information

- **Project Name**: 微信记账小程序
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-01-22
- **Last Updated**: 2026-03-11

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 家庭记账小程序

基于 UniApp + Vue2 + 微信云开发的家庭记账小程序，支持多人协作记账。

## 技术栈

### 前端
- UniApp
- Vue 2.6.11
- 微信小程序
- 微信云开发（CloudBase）

### 云函数
- Node.js 云函数
- 微信云数据库

## 项目结构

```
Acount/
├── frontend/                    # 前端项目（UniApp）
│   ├── api/                     # API 接口封装（云函数调用）
│   ├── pages/                   # 主包页面
│   │   ├── index/               # 首页（账单列表）
│   │   ├── statistics/          # 统计页面
│   │   ├── family/              # 家庭页面
│   │   ├── mine/                # 我的页面
│   │   └── login/               # 登录页面（H5/调试用）
│   ├── pages_sub/               # 分包页面（小程序）
│   │   ├── login/               # 登录（微信授权）
│   │   ├── add/                 # 记账页面
│   │   ├── detail/              # 账单详情
│   │   └── settings/            # 设置页面
│   ├── cloudfunctions/          # 云函数
│   │   ├── user/                # 用户管理
│   │   ├── family/              # 家庭管理
│   │   ├── category/            # 分类管理
│   │   └── transaction/         # 交易管理
│   ├── static/                  # 静态资源
│   ├── App.vue                  # 应用入口（云开发初始化）
│   ├── main.js                  # 主文件
│   ├── manifest.json            # 应用配置
│   └── pages.json               # 页面配置
├── categories.json              # 分类初始化数据（JSON）
├── categories.csv               # 分类初始化数据（CSV）
├── CLOUD_DEPLOY.md              # 云开发部署说明
├── ui-design.html               # UI 设计原型
└── README.md                    # 项目说明
```

## 快速开始

### 环境准备

1. 安装 HBuilderX（推荐）
2. 安装微信开发者工具
3. 注册微信小程序并获取 AppID

### 配置微信小程序 AppID

编辑 [frontend/manifest.json](frontend/manifest.json)，填入你的微信小程序 AppID：
```json
{
  "mp-weixin": {
    "appid": "your_wechat_mini_program_appid"
  }
}
```

### 配置云开发环境

编辑 [frontend/App.vue](frontend/App.vue)，配置云开发环境 ID：
```javascript
wx.cloud.init({
    env: 'your_cloud_env_id',
    traceUser: true
})
```

### 云开发部署

1. 在微信开发者工具中打开小程序项目
2. 开通云开发服务
3. 创建数据库并初始化集合
4. 上传并部署云函数

详细部署步骤请参考 [CLOUD_DEPLOY.md](CLOUD_DEPLOY.md)

### 运行项目

1. 使用 HBuilderX 打开 `frontend` 目录
2. 运行到微信开发者工具：点击 `运行` -> `运行到小程序模拟器` -> `微信开发者工具`

## 功能特性

### 用户功能
- 微信授权登录
- 用户信息管理
- 个人资料编辑

### 记账功能
- 收支记录（收入/支出）
- 分类管理（餐饮、交通、购物等）
- 金额输入
- 备注说明
- 日期选择

### 家庭功能
- 创建家庭
- 加入家庭（通过邀请码）
- 家庭成员管理
- 家庭成员权限管理

### 统计功能
- 个人收支统计
- 家庭总收支统计
- 月度/年度报表
- 分类统计

## 云函数接口

### 用户云函数
- `login` - 用户登录
- `getInfo` - 获取用户信息
- `updateInfo` - 更新用户信息

### 家庭云函数
- `create` - 创建家庭
- `join` - 加入家庭
- `getInfo` - 获取家庭信息
- `getMembers` - 获取家庭成员列表
- `generateInviteCode` - 生成邀请码

### 交易云函数
- `add` - 添加交易记录
- `delete` - 删除交易记录
- `list` - 获取交易列表
- `recent` - 获取最近交易
- `statistics` - 获取统计数据

### 分类云函数
- `list` - 获取分类列表
- `init` - 初始化分类数据

## 数据库设计

### users（用户表）
- _id: 用户ID
- openid: 微信openid
- nickname: 昵称
- avatar: 头像
- phone: 手机号
- family_id: 所属家庭ID
- create_time: 创建时间

### families（家庭表）
- _id: 家庭ID
- name: 家庭名称
- creator_id: 创建者ID
- invite_code: 邀请码
- create_time: 创建时间

### family_members（家庭成员表）
- _id: 成员ID
- family_id: 家庭ID
- user_id: 用户ID
- role: 角色（ADMIN/MEMBER）
- create_time: 加入时间

### categories（分类表）
- _id: 分类ID
- name: 分类名称
- icon: 分类图标
- type: 类型（0-支出 1-收入）
- sort: 排序

### transactions（交易记录表）
- _id: 交易ID
- user_id: 用户ID
- family_id: 家庭ID
- type: 类型（0-支出 1-收入）
- amount: 金额
- category_id: 分类ID
- category_name: 分类名称
- remark: 备注
- images: 图片
- transaction_date: 交易日期
- create_time: 创建时间

## 注意事项

1. 微信小程序 AppID 需要在微信公众平台获取
2. 云开发环境需要在微信开发者工具中开通
3. 数据库需要手动创建集合
4. 云函数需要部署到云环境
5. 小程序需要开通云开发权限

## 开发计划

- [ ] 支持图片上传
- [ ] 支持数据导出
- [ ] 支持预算管理
- [ ] 支持账单提醒
- [ ] 支持多账本管理
- [ ] 支持 H5 版本

## 许可证

MIT License