# taxx-spring

**Repository Path**: bdwl/taxx-spring

## Basic Information

- **Project Name**: taxx-spring
- **Description**: 税务数据报送系统是一个基于Spring Boot + MyBatis Plus + Vue3的B/S架构系统，用于处理平台内的经营者和从业人员税务数据报送。

- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 2
- **Forks**: 0
- **Created**: 2025-08-26
- **Last Updated**: 2026-01-22

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 税务数据报送系统

## 项目简介

税务数据报送系统是一个基于Spring Boot + MyBatis Plus + Vue3的B/S架构系统，用于处理平台内的经营者和从业人员税务数据报送。

## 技术架构

### 后端技术栈
- **Spring Boot 2.7.18** - 主框架
- **MyBatis Plus 3.5.3.1** - ORM框架
- **MySQL** - 数据库
- **Redis** - 缓存
- **EasyExcel 3.3.2** - Excel处理
- **Druid** - 数据库连接池
- **JWT** - 身份认证

### 前端技术栈
- **Vue 3** - 前端框架
- **Element Plus** - UI组件库
- **Axios** - HTTP客户端

## 系统功能

### 1. 用户管理
- 用户登录/登出
- 角色权限管理
- 用户信息管理

### 2. Excel数据导入
- 支持三种类型的数据导入：
  - 平台内的经营者和从业人员收入信息报送表
  - 平台内的经营者和从业人员身份信息报送表
  - 平台内的平台企业身份信息报送表
- 使用EasyExcel进行高效的数据解析
- 数据验证和错误处理
- 导入进度跟踪

### 3. 税务数据报送
- 自动批量报送数据到税务系统
- 支持手动报送和定时自动报送
- 报送状态跟踪
- 失败重试机制
- 完整的报送日志记录

### 4. 系统监控
- 数据导入记录
- 税务报送接口调用日志
- 系统操作日志
- 数据统计报表

## 数据库设计

### 主要数据表
1. **sys_user** - 系统用户表
2. **sys_role** - 系统角色表
3. **tax_income_report** - 收入信息报送表
4. **tax_identity_report** - 身份信息报送表
5. **tax_platform_report** - 平台信息报送表
6. **data_upload_record** - 数据上传记录表
7. **tax_api_log** - 税务API调用日志表
8. **sys_operation_log** - 系统操作日志表

## 快速开始

### 环境要求
- JDK 8+
- Maven 3.6+
- MySQL 5.7+
- Redis 5.0+

### 安装步骤

1. **克隆项目**
```bash
git clone [项目地址]
cd taxx_spring
```

2. **配置数据库**
```bash
# 创建数据库
CREATE DATABASE taxx_system DEFAULT CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;

# 执行初始化脚本
mysql -u root -p taxx_system < src/main/resources/sql/init.sql
```

3. **修改配置文件**
编辑 `src/main/resources/application.yml`，修改数据库连接信息：
```yaml
spring:
  datasource:
    url: jdbc:mysql://localhost:3306/taxx_system?useUnicode=true&characterEncoding=utf8&useSSL=false&serverTimezone=Asia/Shanghai
    username: your_username
    password: your_password
```

4. **启动应用**
```bash
mvn spring-boot:run
```

5. **访问系统**
- 后端API: http://localhost:8080/api
- 数据库监控: http://localhost:8080/api/druid

## API接口

### Excel导入接口
- `POST /api/excel/import/income` - 导入收入信息
- `POST /api/excel/import/identity` - 导入身份信息
- `POST /api/excel/import/platform` - 导入平台信息

### 税务报送接口
- `POST /api/tax/report/income` - 报送收入信息
- `POST /api/tax/report/identity` - 报送身份信息
- `POST /api/tax/report/platform` - 报送平台信息
- `POST /api/tax/report/retry` - 重试失败报送

## 定时任务

系统配置了以下定时任务：
- **收入信息报送**: 每天凌晨2点执行
- **身份信息报送**: 每天凌晨3点执行
- **平台信息报送**: 每天凌晨4点执行
- **失败重试**: 每小时执行一次

## 日志配置

系统日志配置在 `application.yml` 中：
- 控制台日志：实时输出
- 文件日志：保存到 `logs/taxx-spring.log`
- 日志级别：DEBUG（开发环境）

## 部署说明

### 打包部署
```bash
# 打包
mvn clean package

# 运行
java -jar target/taxx-spring-1.0.0.jar
```

### Docker部署
```bash
# 构建镜像
docker build -t taxx-spring .

# 运行容器
docker run -d -p 8080:8080 --name taxx-spring taxx-spring
```

## 注意事项

1. **文件上传**: 确保 `uploads` 目录有写入权限
2. **数据库**: 建议使用InnoDB引擎，支持事务
3. **内存配置**: 生产环境建议配置JVM内存参数
4. **安全配置**: 生产环境请修改默认密码和JWT密钥

## 联系方式

如有问题，请联系开发团队。

## 许可证

本项目采用 MIT 许可证。