# Future Code财务系统

**Repository Path**: ggbond_X/FutureCode-financial-system

## Basic Information

- **Project Name**: Future Code财务系统
- **Description**: Future Code工作室财务系统
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-09-09
- **Last Updated**: 2025-09-09

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Future Code工作室 - 财务系统

## 系统简介

这是一个基于Python和Tkinter开发的顾客下单进销存管理系统，专为Future Code工作室工作室设计，用于管理顾客订单信息、跟踪订单进度、统计业务数据。

## 功能特性

### 📝 订单管理
- **新增订单**：录入顾客姓名、联系方式、选题名称、订单类型等完整信息
- **订单查询**：支持按顾客姓名、订单类型、进度状态、时间范围等多条件查询
- **订单更新**：更新订单进度、付款状态等信息
- **订单删除**：支持删除不需要的订单记录

### 💰 财务管理
- **定金管理**：记录定金支付状态和金额
- **进度跟踪**：三阶段进度管理（交定金→付款80%→尾款结清交付）
- **付款记录**：完整的付款历史记录

### 📊 统计报表
- **基础统计**：总订单数、订单金额、已收定金、完成率等
- **分类统计**：按订单类型、进度状态分类统计
- **财务概况**：应收余款、定金收款率分析

### 📤 数据导出
- **Excel导出**：支持导出订单数据到Excel文件
- **CSV导出**：支持导出为CSV格式，便于其他系统使用

### 📋 进度日志
- **完整历史**：记录每次订单状态变更的时间和详情
- **备注功能**：支持为每次状态变更添加备注说明

### 🔧 程序部署
- **一键打包**：支持打包成独立exe程序，无需Python环境
- **自动化构建**：提供自动化构建脚本，简化打包流程
- **跨平台兼容**：支持Windows 7/8/10/11系统
- **便携部署**：整个程序文件夹可直接复制到其他电脑使用

## 系统要求

### 开发环境版本
- Windows 10/11
- Python 3.7+
- 所需依赖包（见requirements.txt）

### 打包版本（推荐）
- Windows 7/8/10/11 (64位)
- 无需安装Python或其他依赖
- 建议可用内存：4GB以上
- 建议磁盘空间：200MB以上

## 安装和启动

### 方法一：使用打包版本（推荐）
1. **下载exe程序包**
   - 获取 `JXC_System` 文件夹（包含完整程序）
   
2. **运行程序**
   - 双击 `JXC_System.exe` 启动
   - 首次运行可能需要较长时间加载
   - 程序会自动创建数据库文件

3. **部署到其他电脑**
   - 直接复制整个 `JXC_System` 文件夹
   - 无需安装Python环境

### 方法二：开发环境运行
1. **安装依赖**
```bash
pip install -r requirements.txt
```

2. **启动程序**
```bash
python main.py
```

### 方法三：自行打包
1. **安装打包依赖**
```bash
pip install -r requirements.txt
```

2. **运行打包脚本**
```bash
python build.py
# 或者双击运行 build.bat（Windows）
```

3. **获取打包结果**
   - 输出目录：`dist/JXC_System/`
   - 可执行文件：`dist/JXC_System/JXC_System.exe`

## 使用指南

### 新增订单
1. 点击"新增订单"选项卡
2. 填写所有必填字段（顾客姓名、选题名称、下单金额等）
3. 选择订单类型（毕设-全包/半包、课设、期末大作业、商单）
4. 设置定金信息和当前进度
5. 点击"提交订单"

### 查询和管理订单
1. 点击"订单管理"选项卡
2. 使用顶部搜索条件筛选订单
3. 在订单列表中选择订单进行操作：
   - 查看详情：查看完整订单信息和进度历史
   - 更新进度：修改订单当前进度状态
   - 更新付款：修改定金支付状态和金额
   - 删除订单：删除不需要的订单

### 统计报表
1. 点击"统计报表"选项卡
2. 可选择性设置统计时间范围
3. 点击"生成统计"查看详细报表

### 数据导出
- 文件菜单 → 导出Excel：导出当前显示的订单到Excel文件
- 文件菜单 → 导出CSV：导出当前显示的订单到CSV文件

## 订单类型说明

- **毕设-全包**：包含完整毕业设计服务
- **毕设-半包**：部分毕业设计服务
- **课设**：课程设计项目
- **期末大作业**：期末课业项目
- **商单**：商业合作项目

## 进度阶段说明

1. **第一阶段-交定金**：客户下单，等待定金支付
2. **第二阶段-付款80%**：定金已收，等待进度款
3. **第三阶段-尾款结清-交付**：项目完成，尾款结清

## 数据存储

- 使用SQLite内置数据库存储数据
- 数据库文件：`orders.db`（自动创建）
- 支持完整的CRUD操作和事务管理

## 技术架构

- **界面框架**：Tkinter（Python内置GUI库）
- **数据库**：SQLite3
- **数据处理**：pandas
- **Excel支持**：openpyxl
- **图表支持**：matplotlib（统计图表）
- **日期选择**：tkcalendar（可选）
- **程序打包**：PyInstaller

## 项目文件说明

### 核心文件
- `main.py` - 主程序文件
- `database.py` - 数据库管理模块
- `orders.db` - SQLite数据库文件（运行时自动创建）
- `requirements.txt` - Python依赖包列表

### 打包相关文件
- `JXC_System.spec` - PyInstaller配置文件
- `build.py` - 自动化构建脚本
- `test_spec.py` - 打包配置测试脚本

### 文档文件
- `doc/` - 文档目录
  - `程序打包说明.md` - 详细打包说明
  - `功能使用说明.md` - 功能使用指南
  - `开发文档.md` - 开发相关文档

### 输出文件（打包后生成）
- `dist/JXC_System/` - 打包输出目录
- `build/` - 打包临时文件目录

## 注意事项

### 通用注意事项
1. 首次运行会自动创建数据库文件
2. 删除订单操作不可恢复，请谨慎操作
3. 建议定期备份`orders.db`数据库文件
4. 日期格式请使用：YYYY-MM-DD（如：2024-01-15）

### 打包版本注意事项
1. **首次启动较慢**：exe程序首次运行需要解压临时文件，属正常现象
2. **防病毒软件**：部分杀毒软件可能误报，请添加到白名单
3. **数据文件位置**：数据库文件会在exe程序所在目录创建
4. **程序更新**：更新时替换整个程序文件夹，数据库文件会自动保留

### 开发版本注意事项
1. **Python版本**：建议使用Python 3.9或更高版本
2. **依赖包冲突**：建议使用虚拟环境避免包冲突
3. **字体问题**：matplotlib图表需要中文字体支持

## 故障排除

### 常见问题

#### 打包版本问题
1. **程序无法启动**
   - 检查Windows版本兼容性（需要64位系统）
   - 确保有足够的磁盘空间和内存
   - 尝试以管理员身份运行

2. **启动速度慢**
   - 首次运行需要解压文件，请耐心等待
   - 后续启动会快很多
   - 建议将程序放在SSD硬盘上

3. **杀毒软件误报**
   - 将程序文件夹添加到杀毒软件白名单
   - 或暂时关闭实时保护后运行

#### 开发版本问题
1. **程序无法启动**：检查Python版本和依赖包安装
2. **数据导出失败**：确保有写入权限，pandas和openpyxl包已安装
3. **中文乱码**：确保系统支持UTF-8编码
4. **matplotlib图表显示异常**：检查中文字体安装

#### 通用问题
1. **数据丢失**：检查数据库文件是否存在和完整
2. **功能异常**：重启程序或检查错误日志
3. **导出文件损坏**：确保有足够的磁盘空间和写入权限

### 性能优化建议
1. **程序存储位置**：建议将程序安装在SSD硬盘上
2. **内存管理**：处理大量数据时建议关闭其他程序
3. **定期维护**：定期清理临时文件和备份数据库

## 版本信息

### 当前版本：v1.0
- 完整的订单管理功能
- 统计报表和数据导出
- 进度跟踪和财务管理
- 自动化程序打包支持

### 更新历史
- **v1.0** (2024-12-19)
  - 首个正式版本发布
  - 基础订单管理功能完成
  - 添加统计报表功能
  - 支持Excel/CSV数据导出
  - 完成程序打包配置

### 后续规划
- 数据备份和恢复功能
- 更多统计图表类型
- 客户信息管理模块
- 系统权限管理

## 许可证

本软件为Future Code工作室内部使用软件，版权归Future Code工作室所有。

## 联系支持

如有技术问题，请联系未来工作室技术支持。

**开发团队：** Future Code工作室  
**技术支持：** Future Code技术部  
**文档更新：** 2025-9-9

---

© 2025 Future Code工作室 - 版权所有