# IntermediateService

**Repository Path**: cysygzs/intermediate-service

## Basic Information

- **Project Name**: IntermediateService
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-03-27
- **Last Updated**: 2026-08-06

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README



# 中间服务平台 (Intermediate Service)

## 项目简介

中间服务平台是一个基于 Spring Boot 构建的企业级中间服务系统，主要用于与企业 ERP 系统进行数据交互，实现采购订单、库存管理、物资退货等业务数据的同步与处理。系统采用微服务架构设计，支持 RocketMQ 消息队列进行异步数据处理。

## 技术栈

- **框架**: Spring Boot 2.x
- **持久层**: MyBatis + MySQL
- **缓存**: Redis
- **消息队列**: RocketMQ
- **构建工具**: Maven

## 项目结构

```
├── admin/                    # 主服务模块
│   ├── src/main/java/
│   │   └── com/example/interservice/
│   │       ├── common/       # 公共工具类
│   │       ├── config/       # 配置类
│   │       ├── controller/   # 控制器
│   │       ├── entity/       # 实体类
│   │       │   ├── inter/    # 基础数据实体
│   │       │   ├── inventory/# 库存实体
│   │       │   ├── material/ # 物料实体
│   │       │   ├── purchase/ # 采购实体
│   │       │   └── stock/    # 库存订单实体
│   │       ├── job/          # 定时任务
│   │       ├── mapper/       # 数据访问层
│   │       ├── mq/           # 消息队列
│   │       │   ├── consumer/ # 消费者
│   │       │   └── producer/ # 生产者
│   │       ├── service/      # 业务服务层
│   │       └── util/         # 工具类
│   └── src/main/resources/
│       ├── mapper/           # MyBatis XML 映射文件
│       └── application.yml   # 应用配置
│
└── mq/                      # MQ 模块
    └── src/main/java/com/example/mq/
        ├── controller/       # 控制器
        └── mq/              # 消息处理
```

## 核心功能

### 1. 数据同步服务
- 库存数据同步 (Stock)
- 供应商数据同步 (Vendor)
- 单位数据同步 (UOM)
- 产品数据同步 (Product)
- 采购订单同步 (PurchaseOrder)
- 库存订单同步 (StockOrder)

### 2. 业务处理
- **采购订单退货**: 处理采购订单的退货业务
- **库存订单退货**: 处理库存订单的退货业务
- **物资退货**: 处理物资退货单
- **物理库存**: 处理物理库存盘点数据

### 3. 消息队列集成
- RocketMQ 消息生产者与消费者
- 异步数据处理
- 定时拉取 ERP 数据

## API 接口

| 路径 | 方法 | 说明 |
|------|------|------|
| `/stock/abcde` | GET | 库存测试接口 |
| `/stock/add` | POST | 新增库存 |
| `/stock/update` | POST | 更新库存 |
| `/purchaseOrderReturn/add` | POST | 新增采购退货单 |
| `/stockOrderReturn/add` | POST | 新增库存退货单 |
| `/stockOrderReturn/select` | POST | 查询库存退货单 |
| `/materialReturnedOrderReturn/add` | POST | 新增物资退货单 |
| `/physicalInventoryReturn/add` | POST | 新增物理库存盘点 |
| `/vPurchaseOrderLotApplyList/add` | POST | 新增采购订单批次申请 |
| `/init/topic` | POST | 初始化MQ主题 |

## 快速开始

### 环境要求
- JDK 1.8+
- Maven 3.0+
- MySQL 5.7+
- Redis
- RocketMQ

### 构建运行

```bash
# 克隆项目
git clone https://gitee.com/cysygzs/intermediate-service.git

# 进入项目目录
cd intermediate-service

# 编译项目
mvn clean install

# 运行主服务
cd admin
mvn spring-boot:run
```

### 配置说明

在 `admin/src/main/resources/application.yml` 中配置数据库、Redis 和 RocketMQ 连接信息：

```yaml
spring:
  datasource:
    url: jdbc:mysql://localhost:3306/dbname
    username: username
    password: password
  redis:
    host: localhost
    port: 6379
  rocketmq:
    name-server: localhost:9876
```

## 实体模型

系统包含以下核心实体：
- **Product**: 产品信息
- **Stock**: 库存信息
- **UOM**: 单位信息
- **Vendor**: 供应商信息
- **PurchaseOrder**: 采购订单
- **PurchaseOrderDetail**: 采购订单明细
- **StockOrder**: 库存订单
- **StockOrderDetail**: 库存订单明细

## 消息主题

| 主题 | 说明 |
|------|------|
| `jy-stock-result-topic` | 库存结果主题 |
| `jy-vendor-result-topic` | 供应商结果主题 |
| `jy-product-result-topic` | 产品结果主题 |
| `jy-purchaseOrder-result-topic` | 采购订单结果主题 |
| `jy-stockOrder-result-topic` | 库存订单结果主题 |

## 许可证

本项目仅供学习交流使用。