# 日常生活记账小程序

**Repository Path**: 07fly/bookkeep

## Basic Information

- **Project Name**: 日常生活记账小程序
- **Description**: 一个功能完善的个人记账应用，支持多平台使用，帮助用户轻松管理个人财务，包含前端小程序和后端管理系统两大部分。该系统基于uni-app开发前端小程序，采用ThinkPHP框架构建后端服务，实现了账本管理、收支记录、预算跟踪、统计分析等核心功能，支持多平台使用，包括微信小程序和H5网页端。
- **Primary Language**: PHP
- **License**: Apache-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 6
- **Forks**: 1
- **Created**: 2025-11-03
- **Last Updated**: 2025-12-10

## Categories & Tags

**Categories**: Uncategorized

**Tags**: 记账, 记账app, 账单管理

## README

## 项目概述

07FLY-Bookkeep 记账系统是一套完整的个人财务管理解决方案，包含前端小程序和后端管理系统两大部分。该系统基于uni-app开发前端小程序，采用ThinkPHP框架构建后端服务，实现了账本管理、收支记录、预算跟踪、统计分析等核心功能，支持多平台使用，包括微信小程序和H5网页端。

## 项目结构

```
base-bookkeep/
├── bookkeep-uniapp/           # 前端uni-app小程序项目
│   ├── api/                  # API接口封装
│   ├── pages/                # 页面组件
│   ├── components/           # 公共组件
│   ├── store/                # 状态管理
│   ├── static/               # 静态资源
│   └── common/               # 公共工具
└── bookkeep-webadmin/        # 后端ThinkPHP管理系统
    ├── app/                  # 应用目录
    │   ├── admin/           # 后台管理核心模块
    │   ├── member/          # 会员管理模块
    │   ├── portalmember/    # 前台会员中心模块
    │   └── bookkeep/        # 记账核心业务模块
    ├── core/                # 框架核心
    ├── extend/              # 扩展类库
    └── public/              # 公共资源目录
```

## 技术架构

### 前端技术栈

- **框架**: uni-app + Vue.js 2.7
- **UI组件库**: @dcloudio/uni-ui
- **构建工具**: Vue CLI 4.5
- **支持平台**: 微信小程序、H5网页

### 后端技术栈

- **框架**: ThinkPHP 5.0
- **数据库**: MySQL
- **Web服务器**: Apache/Nginx

## 功能模块

### 1. 核心功能模块

#### 账本管理 (Books)
- 多账本支持，可设置默认账本
- 账本切换自动同步数据
- 支持不同币种的账本管理

#### 收支记录 (Record)
- 支持收入、支出分类记录
- 自定义分类标签，关联时间、金额、备注信息
- 记录的增删改查操作

#### 预算管理 (Budget)
- 月度/年度预算设置
- 实时进度跟踪
- 剩余预算及日均消费计算

#### 统计分析 (Statistics)
- 收支趋势图表展示
- 分类占比分析
- 月度/年度数据对比

#### 资产管理 (Assets)
- 多账户资产整合与管理
- 账户明细查看

### 2. 辅助工具模块

#### 房贷计算器
- 支持贷款金额、还款期限、利率参数计算
- 生成详细还款计划

#### 汇率换算
- 多币种实时汇率获取与转换

#### 税费计算
- 个人所得税精准计算

#### 存储计划
- 定期存款收益测算

### 3. 用户系统模块

#### 注册登录
- 支持账号密码登录
- 微信授权登录（计划中）

#### 个人中心
- 头像修改、密码重置
- 消息通知管理
- 个人资料维护

#### 数据同步
- 云端数据存储与多端同步

## 目录结构详解

### 前端项目 (bookkeep-uniapp)

```
bookkeep-uniapp/
├── api/                    # API接口模块
│   ├── user.js            # 用户相关API（登录、注册、个人信息）
│   ├── books.js           # 账本管理API
│   ├── record.js          # 收支记录API
│   ├── budget.js          # 预算管理API
│   └── ...                # 其他功能模块API
├── pages/                  # 页面组件
│   ├── dashboard/         # 首页仪表板（数据概览）
│   ├── record/            # 账单管理（收支记录增删改查）
│   ├── statistics/        # 统计分析（图表展示、数据筛选）
│   ├── member/            # 会员中心（个人信息、设置）
│   ├── books/             # 账本管理（账本创建、切换）
│   ├── budget/            # 预算管理（预算设置、进度查看）
│   ├── assets/            # 资产管理（账户管理、资产统计）
│   └── tools/             # 工具页面（计算器、换算器合集）
├── components/            # 公共组件（复用UI组件、功能组件）
├── store/                 # 状态管理（全局数据存储、状态共享）
├── static/                # 静态资源（图片、图标、静态配置）
└── common/                # 公共工具（工具函数、常量定义、全局配置）
```

### 后端项目 (bookkeep-webadmin)

```
bookkeep-webadmin/
├── app/                    # 应用目录
│   ├── admin/             # 后台管理核心模块
│   │   ├── controller/    # 控制器
│   │   ├── model/         # 数据模型
│   │   ├── view/          # 视图模板
│   │   └── ...            # 其他组件
│   ├── member/            # 会员管理模块
│   ├── portalmember/      # 前台会员中心模块
│   └── bookkeep/          # 记账核心业务模块
├── core/                  # 框架核心
├── extend/                # 扩展类库
└── public/                # 公共资源目录
```

## 核心业务流程

### 用户访问流程
1. 用户通过微信小程序或H5网页访问系统
2. 新用户进行注册，老用户直接登录
3. 登录后进入首页仪表板，查看账本概览
4. 可以创建新账本或切换已有账本
5. 进行收支记录、预算设置等操作
6. 查看统计分析报告，了解财务状况

### 数据处理流程
1. 前端通过API接口与后端通信
2. 后端控制器接收请求并处理业务逻辑
3. 调用模型层进行数据操作
4. 返回处理结果给前端展示

## 部署说明

### 前端部署
1. 安装依赖：`npm install`
2. 开发运行：
   - 微信小程序：`npm run dev:mp-weixin`
   - H5网页：`npm run dev:h5`
3. 生产构建：
   - 微信小程序：`npm run build:mp-weixin`
   - H5网页：`npm run build:h5`

### 后端部署
1. 配置Web服务器（Apache/Nginx）
2. 配置数据库连接信息
3. 导入数据库结构（data-20251016.sql）
4. 配置域名和目录权限

## 项目特点

1. **多端支持**: 同时支持微信小程序和H5网页，满足不同用户需求
2. **模块化设计**: 功能模块划分清晰，便于维护和扩展
3. **数据安全**: 用户数据云端存储，保证数据安全可靠
4. **界面友好**: 简洁直观的操作界面，提升用户体验
5. **功能完善**: 涵盖个人财务管理的各个方面，满足日常使用需求

## 开发注意事项

1. 前后端分离架构，需注意API接口规范
2. 数据库设计遵循第三范式，保证数据一致性
3. 代码遵循统一的编码规范，便于团队协作
4. 定期备份数据库，防止数据丢失
5. 关注系统性能优化，提升用户体验


# 界面演示

PC后台管理中心

![输入图片说明](pc-demo/%E9%A6%96%E9%A1%B5.png)

![输入图片说明](pc-demo/%E4%BC%9A%E5%91%98%E4%B8%AD%E5%BF%83.png)

![输入图片说明](pc-demo/%E7%BB%9F%E8%AE%A1-%E6%94%B6%E6%94%AF%E5%88%86%E7%B1%BB.png)

![输入图片说明](pc-demo/%E7%BB%9F%E8%AE%A1-%E6%94%B6%E6%94%AF%E8%B6%8B%E5%8A%BF.png)

![输入图片说明](pc-demo/%E8%AE%BE%E7%BD%AE-%E8%B5%84%E4%BA%A7%E8%B4%A6%E6%88%B7.png)

![输入图片说明](pc-demo/%E8%AE%BE%E7%BD%AE-%E9%A2%84%E7%AE%97%E7%AE%A1%E7%90%86.png)


小程序界面：

![输入图片说明](wap-demo/%E9%A6%96%E9%A1%B5.png)

![输入图片说明](wap-demo/%E7%BB%9F%E8%AE%A1.png)

![输入图片说明](wap-demo/%E6%88%91%E7%9A%84.png)

![输入图片说明](wap-demo/%E6%88%91%E7%9A%84.png)


 **最后，附上二维码，有兴趣的朋友扫码看看。目前小程序在认证阶段，还不能通过分享和搜索，只能通过二维码分享了。** 


![输入图片说明](wap-demo/qrcode.jpg)