# 小老板财务管家

**Repository Path**: robin2024/finance-miniprogram

## Basic Information

- **Project Name**: 小老板财务管家
- **Description**: “小老板财务管家”是一款专门针对个体经营者、家庭经营者和小型企业设计的财务管理软件。它主要面向没有独立财务岗位、且不方便使用复杂财务软件的经营者，采用简单的收支记录方式来管理账务。核心是移动办公，如合同盖章、发票登记，付款登记等，
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-05-21
- **Last Updated**: 2026-08-10

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 财务记账微信小程序

一个专为个人/个体户设计的轻量级财务记账微信小程序。

## 功能特性

### 🏠 首页 (Dashboard)
- 本月收支概览与利润统计
- 今日待办提醒（应收/应付）
- 快捷功能入口（8个核心功能）
- 最近交易记录展示

### 💰 付款记录
- 收入/支出分类记账
- 自定义数字键盘输入
- 日期、时间、付款方式选择
- 备注添加
- 按类型/时间/关键词筛选
- 左滑删除操作

### 📥 应收对账
- 应收列表展示（客户、金额、状态）
- 状态管理（待收款、部分收款、已结清、已逾期）
- 收款记录添加
- 到期日提醒

### 📤 应付对账
- 应付列表展示（供应商、金额、状态）
- 与应收对账功能类似

### 🔍 发票管理 (开发中)
- 发票查验（跳转国税总局）
- 发票记录管理
- 开票管理

### ⚙️ 设置
- 单位信息配置
- 分类管理
- 客户/供应商管理
- 数据导出（JSON格式）
- 数据清空

## 技术架构

### 前端技术栈
- 微信小程序原生开发
- 本地存储 (wx.setStorageSync)
- 自定义组件化开发

### 数据存储
- 所有数据存储在微信小程序本地
- 支持数据导出备份
- 数据结构：
  - transactions: 交易记录
  - receivables: 应收记录
  - payables: 应付记录
  - invoices: 发票记录
  - categories: 分类配置

## 项目结构

```
finance-miniprogram/
├── app.js                 # 小程序入口
├── app.json              # 全局配置
├── app.wxss              # 全局样式
├── sitemap.json          # 站点地图
├── pages/
│   ├── home/             # 首页
│   ├── payment/          # 交易记录（列表/表单）
│   ├── receivable/       # 应收对账
│   ├── payable/          # 应付对账
│   ├── invoice/          # 发票管理
│   ├── settings/         # 设置
│   └── report/           # 报表
├── utils/
│   ├── storage.js        # 存储工具类
│   └── util.js           # 通用工具类
└── images/               # 图片资源
```

## 快速开始

### 环境要求
- 微信开发者工具
- 微信小程序账号

### 开发步骤
1. 打开微信开发者工具
2. 导入项目，选择 `finance-miniprogram` 目录
3. 填入你的小程序 AppID（或选择测试号）
4. 开始开发调试

### 目录说明
- `utils/storage.js` - 封装了所有数据操作，包括增删改查、导出导入
- `utils/util.js` - 通用工具函数（格式化、Toast、防抖等）
- `pages/home/` - 首页Dashboard，数据统计入口
- `pages/payment/` - 核心记账功能

## 数据结构

### 交易记录 (Transaction)
```javascript
{
  id: "唯一标识",
  type: "income" | "expense",      // 收入/支出
  amount: 100.00,                  // 金额
  category: "餐饮",                 // 分类名称
  categoryIcon: "food",             // 分类图标
  date: "2024-05-21",              // 日期
  time: "14:30",                    // 时间
  paymentMethod: "wechat",          // 付款方式
  remark: "备注",                    // 备注
  createdAt: timestamp
}
```

### 应收记录 (Receivable)
```javascript
{
  id: "唯一标识",
  customerName: "客户名称",
  totalAmount: 5000.00,            // 应收总额
  receivedAmount: 2000.00,         // 已收金额
  remainingAmount: 3000.00,        // 待收金额
  dueDate: "2024-06-30",           // 到期日
  status: "pending" | "partial" | "completed" | "overdue",
  payments: [ ...收款记录... ]
}
```

## 开发路线图

### Phase 1 ✅ 已完成
- [x] 项目基础架构
- [x] 本地存储工具类
- [x] 首页Dashboard
- [x] 付款记录（新增/编辑/列表）
- [x] 应收对账基础功能

### Phase 2 进行中
- [ ] 应付对账详情页
- [ ] 发票查验功能
- [ ] 开票管理
- [ ] 分类管理页面
- [ ] 客户/供应商管理

### Phase 3 规划中
- [ ] 数据报表（图表可视化）
- [ ] Excel导入导出
- [ ] 云同步功能
- [ ] 数据备份与恢复
- [ ] 提醒通知

## 自定义配置

### 添加新分类
在 `app.js` 的 `initDefaultData` 方法中修改默认分类，或在设置页面的分类管理中添加。

### 修改主题色
修改 `app.wxss` 中的颜色变量，或各页面的渐变色值。

## 注意事项

1. **数据安全**：所有数据存储在本地，卸载小程序会丢失数据，请定期导出备份
2. **存储限制**：微信小程序本地存储上限约为 10MB
3. **图片存储**：凭证图片建议压缩后存储，或使用云存储

## 许可证

MIT License