erp-java/services/warehouse-service/README.md

88 lines
3.8 KiB
Markdown

# Warehouse Service
云仓服务 - 仓库管理、云仓集成、库存同步
## 基本信息
- **服务端口**: 8084
- **服务名称**: warehouse-service
- **模块分支**: 业务域/功能模块
- **数据库**: erp_db
## 功能清单
1. 仓库管理
2. 库存管理
3. 入库出库
## API接口
| 方法 | 路径 | 描述 |
|------|------|------|
| GET | /api/stock/list | StockController接口 |
| GET | /api/stock/detail | StockController接口 |
| GET | /api/stock/logs | StockController接口 |
| POST | /api/stock/inbound | StockController接口 |
| POST | /api/stock/outbound | StockController接口 |
| POST | /api/stock/defective | StockController接口 |
| POST | /api/stock/adjust | StockController接口 |
| POST | /api/stock/lock | StockController接口 |
| POST | /api/stock/unlock | StockController接口 |
| POST | /api/stock/reserve | StockController接口 |
| POST | /api/stock/confirm-reserve | StockController接口 |
| POST | /api/stock/cancel-reserve | StockController接口 |
| POST | /api/stock/ship | StockController接口 |
| PUT | /api/stock/threshold | StockController接口 |
| GET | /api/stock-alert/list | StockAlertController接口 |
| GET | /api/stock-alert/summary | StockAlertController接口 |
| GET | /api/stock-alert/settings | StockAlertController接口 |
| GET | /api/stock-alert/notifications | StockAlertController接口 |
| POST | /api/stock-alert/trigger | StockAlertController接口 |
| PUT | /api/stock-alert/settings | StockAlertController接口 |
| PUT | /api/stock-alert/notifications | StockAlertController接口 |
| GET | /api/inbound/list | InboundController接口 |
| GET | /api/inbound/{id} | InboundController接口 |
| POST | /api/inbound/{id}/confirm | InboundController接口 |
| DELETE | /api/inbound/{id} | InboundController接口 |
| GET | /api/outbound/list | OutboundController接口 |
| GET | /api/outbound/{id} | OutboundController接口 |
| POST | /api/outbound/{id}/ship | OutboundController接口 |
| DELETE | /api/outbound/{id} | OutboundController接口 |
| GET | /api/warehouse/list | WarehouseController接口 |
| GET | /api/warehouse/{id} | WarehouseController接口 |
| GET | /api/warehouse/{id}/stock | WarehouseController接口 |
| GET | /api/warehouse/{id}/stock/list | WarehouseController接口 |
| GET | /api/warehouse/{id}/goods | WarehouseController接口 |
| GET | /api/warehouse/{id}/goods/{itemId} | WarehouseController接口 |
| GET | /api/warehouse/{id}/logistics/{logisticsNo} | WarehouseController接口 |
| GET | /api/warehouse/{id}/cloud-warehouses | WarehouseController接口 |
| GET | /api/warehouse/{id}/bindings | WarehouseController接口 |
| GET | /api/warehouse/{id}/test-connection | WarehouseController接口 |
| POST | /api/warehouse/{id}/purchase-order | WarehouseController接口 |
| POST | /api/warehouse/{id}/purchase-order/confirm | WarehouseController接口 |
| POST | /api/warehouse/{id}/sale-order | WarehouseController接口 |
| POST | /api/warehouse/{id}/stock/adjust | WarehouseController接口 |
| POST | /api/warehouse/{id}/bindings | WarehouseController接口 |
| PUT | /api/warehouse/{id} | WarehouseController接口 |
| PUT | /api/warehouse/bindings/{bindingId} | WarehouseController接口 |
| DELETE | /api/warehouse/{id} | WarehouseController接口 |
| DELETE | /api/warehouse/bindings/{bindingId} | WarehouseController接口 |
## 数据库表
| 表名 | 说明 |
|------|------|
| inbound_order | InboundOrder |
| stock_alert_notification | StockAlertNotification |
| stock | Stock |
| warehouse_template_binding | WarehouseTemplateBinding |
| stock_log | StockLog |
| transfer_order | TransferOrder |
| outbound_order | OutboundOrder |
| warehouse | Warehouse |
| stock_alert_config | StockAlertConfig |
## 配置文件
- application.yml: 应用配置
## 启动方式
```bash
mvn clean package
java -jar target/warehouse-service.jar
```