# 报销单管理系统

**Repository Path**: dantevassage/expense-system

## Basic Information

- **Project Name**: 报销单管理系统
- **Description**: 报销单管理系统
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 1
- **Created**: 2026-07-02
- **Last Updated**: 2026-07-16

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 报销单管理系统

> 多用户版智能报销系统，打通"发票采集 → OCR 识别 → 快捷填报 → 自动拆分 → 一键打印"全链路。

## 技术栈

| 模块 | 技术 |
|------|------|
| 后端主服务 | JDK 1.8 + Spring Boot 2.3.3.RELEASE |
| AI 引擎 | Python 3.9+ + FastAPI |
| 前端 | Vue 3 + Vite + Tailwind CSS |
| 数据库 | MySQL 8.0（本地开发） |

## 项目结构

```
expense_system/
├── web/                     # 前端 Vue 3
│   ├── src/views/           # 页面视图（按模块分组）
│   ├── src/router/          # 路由配置
│   ├── src/stores/          # Pinia 状态管理
│   └── src/utils/           # Axios 封装
├── server/                  # Spring Boot 主服务
│   ├── src/main/java/com/expense/
│   │   ├── entity/          # 19 个 JPA 实体类
│   │   ├── repository/      # JPA 仓库接口
│   │   ├── service/         # 业务服务
│   │   ├── controller/      # REST 控制器
│   │   ├── config/          # 安全/CORS 配置
│   │   └── client/          # Feign 客户端
│   └── src/main/resources/  # application.yml
├── ai-engine/               # Python FastAPI 引擎
│   ├── app.py               # 应用入口
│   ├── ocr_invoice.py       # 发票 OCR 识别
│   ├── ocr_template.py      # 模板 OCR（预留）
│   └── email_sync.py        # 邮箱自动抓取
├── sql/                     # 数据库建表脚本
│   └── init.sql             # 19 张表 + 初始化数据
├── docs/                    # 设计文档
│   ├── 需求规格说明书.md
│   ├── 概要设计.md
│   └── 详细设计.md
└── README.md
```

## 快速启动

### 1. 数据库

```bash
mysql -u root -p < sql/init.sql
```

### 2. Python AI 引擎

```bash
cd ai-engine
pip install -r requirements.txt
python app.py              # 启动在 http://localhost:5000
```

### 3. Spring Boot 主服务

```bash
cd server
mvn clean install
mvn spring-boot:run        # 启动在 http://localhost:8080
```

### 4. 前端

```bash
cd web
npm install
npm run dev                # 启动在 http://localhost:5173
```

## 功能模块

- **发票采集**：拍照/相册/批量上传 + 邮箱自动抓取
- **OCR 识别**：百度 OCR API + 图片压缩预处理
- **发票池管理**：多维筛选 + 自定义分类 + 校对日志
- **一般报销**：勾选发票 → 创建报销单 → 自动拆分
- **出行报销**：行程单 + 高德地图 + 发票关联
- **差旅报销**：多步向导 + 智能填充 + 汇总预览
- **一键打印**：PDF 生成 + ZIP 打包 + 打印脚本
- **撤销报销**：用户申请 → 管理员审核 → 发票释放
- **系统管理**：密钥配置 / 用户管理 / 撤销审核

## 设计文档

参见 `docs/` 目录：
- [需求规格说明书](docs/需求规格说明书.md)
- [概要设计](docs/概要设计.md)
- [详细设计](docs/详细设计.md)

## 仓库

- Gitee：https://gitee.com/dantevassage/expense-system.git