# mini-accounting

**Repository Path**: chanchaw/mini-accounting

## Basic Information

- **Project Name**: mini-accounting
- **Description**: 小程序余额式记账
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 1
- **Forks**: 0
- **Created**: 2026-06-01
- **Last Updated**: 2026-06-13

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 公司日常支出记录小程序（ExpenseTrackerMini）

## 项目介绍

公司日常支出记录小程序是一个用于公司内部使用的微信小程序，用于每日记录员工支出并实时跟踪账套余额。初始化期初余额后，每笔支出自动扣减余额，用户可立即看到最新余额。

## 技术栈

- **前端**：微信小程序原生框架
- **后端**：Spring Boot 2.6.13
- **ORM**：MyBatis
- **数据库**：MySQL 5.7
- **后端端口**：8080

## 启动步骤

### 1. 启动MySQL

确保MySQL 5.7服务已启动，并且可以使用以下账号登录：
- 用户名：root
- 密码：chanchaw

### 2. 执行数据库初始化脚本

在项目根目录执行以下命令：

```bash
mysql -u root -pchanchaw < init.sql
```

### 3. 启动Spring Boot应用

在项目根目录执行以下命令：

```bash
mvn spring-boot:run
```

应用将在 http://localhost:8080 启动。

### 4. 配置小程序请求域名

在微信开发者工具中，进入项目设置，修改"合法域名"配置，添加：

```
http://localhost:8080
```

### 5. 打开小程序

使用微信开发者工具打开项目目录，即可运行小程序。

## 功能说明

### 首页
- 显示当前余额
- 提供"新增支出"按钮
- 显示最近5笔支出记录
- 提供"查看全部支出"入口

### 新增支出页面
- 支付日期选择（默认当天）
- 员工选择（带头像）
- 支出项目选择（7个固定项目）
- 金额输入（仅允许正数，保留两位小数）
- 备注输入（最大200字）

### 支出列表页面
- 显示所有支出记录（倒序）
- 支持按支付日期筛选
- 每条记录显示：日期、员工头像+姓名、项目、金额、备注

### 设置页面
- 账套初始化（设置期初余额）
- 员工头像管理（从20个小动物头像中选择）

## API接口说明

### 员工相关
- **GET /api/employees**：返回员工列表（含头像索引）
- **POST /api/employees/avatar/{id}**：更新员工头像

### 分类相关
- **GET /api/categories**：返回支出类别列表

### 支出相关
- **POST /api/expenses**：添加支出记录
- **GET /api/expenses**：获取支出记录（支持日期和员工筛选）
- **GET /api/expenses/recent**：获取最近5笔支出记录

### 余额相关
- **GET /api/balance**：获取当前余额
- **POST /api/balance/init**：初始化账套余额

## 数据库设计

### 表结构
- **employees**：员工表（固定6名员工）
- **categories**：支出类别表（固定7个项目）
- **expenses**：支出记录表
- **account_balance**：账套余额表（单行记录）

### 初始数据
- 员工：居健朴、陈超、高松、武留柱、李林源、高伟涛

- 支出类别：中饭、加班晚饭、油费、过路费、公车维修保养保险、弱电工程材料、其他

- 初始余额：0.00（需要通过接口初始化）

- 清除所有员工、支出明细

  ```sql
  ```

  

## 注意事项

- 所有日期时间使用 Asia/Shanghai 时区
- 金额必须大于0
- 备注非必填
- 小程序启动时会检查余额是否已初始化，若未初始化则跳转设置页提示初始化