CPTE WMS 微服务架构文档
1. 架构概述
1.1 系统定位
CPTE WMS 是基于 Spring Boot 3.5.5 + Spring Cloud 2025.0.0 构建的仓库管理系统微服务架构，采用 Kubernetes 进行容器编排部署。
1.2 架构风格
- 微服务架构: 业务按领域拆分为独立服务
- 服务网格: 基于 Kubernetes Service 的服务发现
- 事件驱动: Redis 发布订阅实现异步通信
- 容器化部署: Docker + Kubernetes
2. 系统架构图
2.1 整体架构
┌────────────────────────────────────────────────────────────────────────────────┐
│ 外部访问层 │
│ ┌─────────────────────────────────────────────────────────────────────────┐ │
│ │ Nginx Ingress │ │
│ │ (负载均衡 / SSL 终止 / 路由) │ │
│ └─────────────────────────────────────────────────────────────────────────┘ │
└────────────────────────────────────────────────────────────────────────────────┘
│
▼
┌────────────────────────────────────────────────────────────────────────────────┐
│ 应用服务层 │
│ ┌──────────────────────────────────────────────────────────────────────────┐ │
│ │ Namespace: cpte-wms │ │
│ │ │ │
│ │ ┌────────────────┐ ┌────────────────┐ ┌────────────────┐ │ │
│ │ │ Basic Service │ │Inbound Service │ │Outbound Service│ │ │
│ │ │ 基础服务 │ │ 入库服务 │ │ 出库服务 │ │ │
│ │ │ Port: 8001 │ │ Port: 8002 │ │ Port: 8003 │ │ │
│ │ │ /cpte-wms-basic│ │/cpte-wms-inbound│ │/cpte-wms-outbound│ │ │
│ │ └───────┬────────┘ └───────┬────────┘ └───────┬────────┘ │ │
│ │ │ │ │ │ │
│ │ │ ┌──────────────┼───────────────┐ │ │ │
│ │ │ │ │ │ │ │ │
│ │ ▼ ▼ ▼ ▼ ▼ │ │
│ │ ┌────────────────┐ ┌────────────────┐ ┌────────────────┐ │ │
│ │ │Inventory Service│ │Schedule Service│ │ System Service │ │ │
│ │ │ 库存服务 │ │ 调度服务 │ │ 系统服务 │ │ │
│ │ │ Port: 8004 │ │ Port: 8005 │ │ Port: 8000 │ │ │
│ │ │/cpte-wms-inventory│ │/cpte-wms-schedule│ │/cpte-wms │ │ │
│ │ └────────────────┘ └────────────────┘ └────────────────┘ │ │
│ │ │ │
│ │ ┌────────────────────────────────────────────────────────────────────┐ │ │
│ │ │ cpte-wms-api (共享层) │ │ │
│ │ │ ┌─────────────┐ ┌─────────────┐ ┌─────────────┐ ┌─────────────┐ │ │ │
│ │ │ │ Feign Client│ │ DTO │ │ 分布式锁 │ │ 工具类 │ │ │ │
│ │ │ └─────────────┘ └─────────────┘ └─────────────┘ └─────────────┘ │ │ │
│ │ └────────────────────────────────────────────────────────────────────┘ │ │
│ └──────────────────────────────────────────────────────────────────────────┘ │
└────────────────────────────────────────────────────────────────────────────────┘
│
▼
┌────────────────────────────────────────────────────────────────────────────────┐
│ 基础设施层 │
│ ┌──────────────┐ ┌──────────────┐ ┌──────────────┐ ┌──────────────┐ │
│ │ MySQL │ │ Redis │ │ MinIO │ │ Nacos │ │
│ │ 数据持久化 │ │ 缓存/锁/消息 │ │ 文件存储 │ │ 配置中心 │ │
│ │ Port: 53306 │ │ Port: 6379 │ │ │ │ │ │
│ └──────────────┘ └──────────────┘ └──────────────┘ └──────────────┘ │
└────────────────────────────────────────────────────────────────────────────────┘
2.2 服务拓扑图
┌─────────────────┐
│ System Service │
│ 系统服务 │
│ Port: 8000 │
└────────┬────────┘
│
┌───────────────────────────┼───────────────────────────┐
│ │ │
▼ ▼ ▼
┌─────────────────┐ ┌─────────────────┐ ┌─────────────────┐
│ Basic Service │◄───────▶│Inbound Service │◄───────▶│Outbound Service │
│ 基础服务 │ Feign │ 入库服务 │ Feign │ 出库服务 │
│ Port: 8001 │ │ Port: 8002 │ │ Port: 8003 │
└────────┬────────┘ └────────┬────────┘ └────────┬────────┘
│ │ │
│ Feign │ Feign │ Feign
│ │ │
└──────────────┬────────────┴────────────┬──────────────┘
│ │
▼ ▼
┌─────────────────┐ ┌─────────────────┐
│Inventory Service│ │Schedule Service │
│ 库存服务 │ │ 调度服务 │
│ Port: 8004 │ │ Port: 8005 │
└─────────────────┘ └─────────────────┘
3. 服务清单
3.1 核心服务
| 服务名称 |
服务标识 |
端口 |
Context Path |
职责 |
| 基础服务 |
cpte-wms-basic |
8001 |
/cpte-wms-basic |
物料、库区、点位、容器等基础数据管理 |
| 入库服务 |
cpte-wms-inbound |
8002 |
/cpte-wms-inbound |
ASN 管理、收货、上架等入库业务 |
| 出库服务 |
cpte-wms-outbound |
8003 |
/cpte-wms-outbound |
拣货、发货、波次等出库业务 |
| 库存服务 |
cpte-wms-inventory |
8004 |
/cpte-wms-inventory |
库存查询、盘点、移库等库存业务 |
| 调度服务 |
cpte-wms-schedule |
8005 |
/cpte-wms-schedule |
AGV 调度、输送线控制、定时任务 |
| 系统服务 |
cpte-wms |
8000 |
/cpte-wms |
用户、权限、系统管理等 |
3.2 共享模块
| 模块名称 |
Artifact ID |
职责 |
| 公共 API |
cpte-wms-api |
Feign Client、DTO、分布式锁、工具类 |
| 基础核心 |
cpte-boot-base-core |
公共组件、配置、异常处理 |
| 系统业务 |
cpte-system-biz |
用户权限、字典、日志等 |
4. 服务通信架构
4.1 通信方式
┌─────────────────────────────────────────────────────────────────┐
│ 服务通信方式 │
├─────────────────────────────────────────────────────────────────┤
│ │
│ 1. 同步通信 (OpenFeign) │
│ ┌─────────┐ HTTP/REST ┌─────────┐ │
│ │ Service │ ──────────────▶ │ Service │ │
│ │ A │ │ B │ │
│ └─────────┘ └─────────┘ │
│ │
│ 2. 异步通信 (Redis Pub/Sub) │
│ ┌─────────┐ Publish ┌───────┐ Subscribe ┌─────────┐
│ │ Service │ ─────────────▶ │ Redis │ ──────────────▶ │ Service │
│ │ A │ │ │ │ B │
│ └─────────┘ └───────┘ └─────────┘
│ │
│ 3. 分布式锁 (Redisson) │
│ ┌─────────┐ Lock/Unlock ┌───────┐ │
│ │ Service │ ◄────────────────▶ │ Redis │ │
│ │ A │ │ │ │
│ └─────────┘ └───────┘ │
│ │
└─────────────────────────────────────────────────────────────────┘
4.2 OpenFeign 配置
feign:
client:
wms-basic:
url: http://cpte-wms-basic:8001/cpte-wms-basic
config:
default:
connectTimeout: 5000 # 连接超时 5 秒
readTimeout: 10000 # 读取超时 10 秒
loggerLevel: INFO # 日志级别
Feign 核心配置:
- HTTP 客户端: OkHttp
- 连接超时: 5 秒
- 读取超时: 10 秒
- 重试策略: 初始间隔 100ms，最大间隔 1 秒，最多重试 3 次
4.3 服务调用关系
┌─────────────────────────────────────────────────────────────────────────┐
│ 服务调用依赖关系 │
├─────────────────────────────────────────────────────────────────────────┤
│ │
│ Inbound Service (入库服务) │
│ ├── Feign → Basic Service (获取物料、库区信息) │
│ ├── Feign → Inventory Service (更新库存) │
│ └── Feign → Schedule Service (触发 AGV 任务) │
│ │
│ Outbound Service (出库服务) │
│ ├── Feign → Basic Service (获取物料、点位信息) │
│ ├── Feign → Inventory Service (扣减库存、锁定库存) │
│ └── Feign → Schedule Service (触发拣货任务) │
│ │
│ Inventory Service (库存服务) │
│ ├── Feign → Basic Service (获取物料、容器信息) │
│ └── Redisson → 分布式锁 (库存操作锁) │
│ │
│ Schedule Service (调度服务) │
│ ├── Feign → Basic Service (获取点位信息) │
│ ├── Feign → Inventory Service (库存校验) │
│ └── Quartz → 定时任务调度 │
│ │
└─────────────────────────────────────────────────────────────────────────┘
5. 数据架构
5.1 数据存储架构
┌─────────────────────────────────────────────────────────────────────────┐
│ 数据存储架构 │
├─────────────────────────────────────────────────────────────────────────┤
│ │
│ ┌─────────────────────────────────────────────────────────────────┐ │
│ │ MySQL (主数据库) │ │
│ │ cpte-wms 数据库 │ │
│ │ │ │
│ │ ┌─────────────┐ ┌─────────────┐ ┌─────────────┐ │ │
│ │ │ base_item │ │ base_area │ │ base_point │ 基础数据 │ │
│ │ │ 物料表 │ │ 库区表 │ │ 点位表 │ │ │
│ │ └─────────────┘ └─────────────┘ └─────────────┘ │ │
│ │ │ │
│ │ ┌─────────────┐ ┌─────────────┐ ┌─────────────┐ │ │
│ │ │ data_asn │ │asn_detail │ │receive_record│ 入库数据 │ │
│ │ │ 入库单 │ │ 入库明细 │ │ 收货记录 │ │ │
│ │ └─────────────┘ └─────────────┘ └─────────────┘ │ │
│ │ │ │
│ │ ┌─────────────┐ ┌─────────────┐ ┌─────────────┐ │ │
│ │ │ sys_user │ │ sys_role │ │ sys_permission│ 系统数据 │ │
│ │ │ 用户表 │ │ 角色表 │ │ 权限表 │ │ │
│ │ └─────────────┘ └─────────────┘ └─────────────┘ │ │
│ └─────────────────────────────────────────────────────────────────┘ │
│ │
│ ┌─────────────────────────────────────────────────────────────────┐ │
│ │ Redis (缓存/消息) │ │
│ │ │ │
│ │ ┌─────────────┐ ┌─────────────┐ ┌─────────────┐ │ │
│ │ │ Session │ │ 数据缓存 │ │ 分布式锁 │ │ │
│ │ │ 会话存储 │ │ 热点数据 │ │ Redisson │ │ │
│ │ └─────────────┘ └─────────────┘ └─────────────┘ │ │
│ │ │ │
│ │ ┌─────────────┐ ┌─────────────┐ │ │
│ │ │ Pub/Sub │ │ 消息队列 │ │ │
│ │ │ 事件发布 │ │ 异步任务 │ │ │
│ │ └─────────────┘ └─────────────┘ │ │
│ └─────────────────────────────────────────────────────────────────┘ │
│ │
└─────────────────────────────────────────────────────────────────────────┘
5.2 数据库连接池
Druid 连接池配置:
initial-size: 5 # 初始连接数
min-idle: 5 # 最小空闲连接
maxActive: 1000 # 最大活跃连接
maxWait: 60000 # 最大等待时间 60s
validationQuery: SELECT 1 # 验证 SQL
5.3 Redis 部署模式
支持多种部署模式:
- STANDALONE: 单机模式
- MASTER_SLAVE: 主从模式
- SENTINEL: 哨兵模式
- CLUSTER: 集群模式
6. 部署架构
6.1 Kubernetes 部署架构
┌─────────────────────────────────────────────────────────────────────────┐
│ Kubernetes Cluster │
├─────────────────────────────────────────────────────────────────────────┤
│ │
│ ┌───────────────────────────────────────────────────────────────────┐ │
│ │ Namespace: cpte-wms │ │
│ │ │ │
│ │ ┌─────────────────────────────────────────────────────────────┐ │ │
│ │ │ Workload (Deployment) │ │ │
│ │ │ │ │ │
│ │ │ ┌─────────┐ ┌─────────┐ ┌─────────┐ ┌─────────┐ ┌─────────┐│ │ │
│ │ │ │ Pod │ │ Pod │ │ Pod │ │ Pod │ │ Pod ││ │ │
│ │ │ │ Basic │ │ Inbound │ │Outbound │ │Inventory│ │Schedule ││ │ │
│ │ │ │ :8001 │ │ :8002 │ │ :8003 │ │ :8004 │ │ :8005 ││ │ │
│ │ │ └────┬────┘ └────┬────┘ └────┬────┘ └────┬────┘ └────┬────┘│ │ │
│ │ │ │ │ │ │ │ │ │ │
│ │ └───────┼───────────┼───────────┼───────────┼───────────┼──────┘ │ │
│ │ │ │ │ │ │ │ │
│ │ ┌───────┴───────────┴───────────┴───────────┴───────────┴──────┐ │ │
│ │ │ Service (ClusterIP) │ │ │
│ │ │ │ │ │
│ │ │ ┌─────────┐ ┌─────────┐ ┌─────────┐ ┌─────────┐ ┌─────────┐ │ │ │
│ │ │ │cpte-wms │ │cpte-wms │ │cpte-wms │ │inventory│ │schedule │ │ │ │
│ │ │ │ -basic │ │ -inbound│ │ -outbound│ │ -service│ │ -service│ │ │ │
│ │ │ │ :8001 │ │ :8002 │ │ :8003 │ │ :8004 │ │ :8005 │ │ │ │
│ │ │ └─────────┘ └─────────┘ └─────────┘ └─────────┘ └─────────┘ │ │ │
│ │ └───────────────────────────────────────────────────────────────┘ │ │
│ │ │ │
│ │ ┌───────────────────────────────────────────────────────────────┐ │ │
│ │ │ ConfigMap & Secret │ │ │
│ │ │ │ │ │
│ │ │ ConfigMap: application.yml, 环境变量 │ │ │
│ │ │ Secret: DB_PASSWORD, REDIS_PASSWORD, SIGNATURE_SECRET │ │ │
│ │ └───────────────────────────────────────────────────────────────┘ │ │
│ │ │ │
│ │ ┌───────────────────────────────────────────────────────────────┐ │ │
│ │ │ PersistentVolumeClaim │ │ │
│ │ │ │ │ │
│ │ │ cpte-wms-basic-data (10Gi) - 文件上传存储 │ │ │
│ │ │ cpte-wms-inbound-data (10Gi) - 文件上传存储 │ │ │
│ │ └───────────────────────────────────────────────────────────────┘ │ │
│ └────────────────────────────────────────────────────────────────────┘ │
│ │
│ ┌───────────────────────────────────────────────────────────────────┐ │
│ │ 基础设施服务 │ │
│ │ │ │
│ │ ┌──────────┐ ┌──────────┐ ┌──────────┐ ┌──────────┐ │ │
│ │ │ MySQL │ │ Redis │ │ Nginx │ │ MinIO │ │ │
│ │ │ Service │ │ Service │ │ Ingress │ │ OSS │ │ │
│ │ └──────────┘ └──────────┘ └──────────┘ └──────────┘ │ │
│ └───────────────────────────────────────────────────────────────────┘ │
└─────────────────────────────────────────────────────────────────────────┘
6.2 服务资源配置
| 服务 |
CPU Request |
CPU Limit |
Memory Request |
Memory Limit |
副本数 |
| Basic |
500m |
2000m |
1Gi |
2Gi |
1 |
| Inbound |
500m |
2000m |
1Gi |
2Gi |
1 |
| Outbound |
100m |
500m |
256Mi |
1Gi |
1 |
| Inventory |
100m |
500m |
256Mi |
1Gi |
1 |
| Schedule |
100m |
500m |
256Mi |
1Gi |
1 |
6.3 健康检查配置
探针配置:
livenessProbe:
path: /{context}/actuator/health/liveness
initialDelaySeconds: 90-180
periodSeconds: 20
timeoutSeconds: 10
failureThreshold: 3
readinessProbe:
path: /{context}/actuator/health/readiness
initialDelaySeconds: 45-120
periodSeconds: 10-15
timeoutSeconds: 5-10
failureThreshold: 3
startupProbe:
path: /{context}/actuator/health/liveness
initialDelaySeconds: 0-30
periodSeconds: 10
failureThreshold: 30-90
7. 安全架构
7.1 认证授权架构
┌─────────────────────────────────────────────────────────────────────────┐
│ 认证授权架构 │
├─────────────────────────────────────────────────────────────────────────┤
│ │
│ ┌─────────┐ ┌─────────────┐ ┌─────────────┐ │
│ │ Client │─────▶│ Nginx │─────▶│ Service │ │
│ │ │ │ Ingress │ │ Instance │ │
│ └─────────┘ └─────────────┘ └──────┬──────┘ │
│ │ │
│ ▼ │
│ ┌─────────────────────┐ │
│ │ JwtFilter │ │
│ │ - Token 解析 │ │
│ │ - Token 验证 │ │
│ │ - Token 刷新 │ │
│ └──────────┬──────────┘ │
│ │ │
│ ▼ │
│ ┌─────────────────────┐ │
│ │ ShiroRealm │ │
│ │ - 用户认证 │ │
│ │ - 角色校验 │ │
│ │ - 权限校验 │ │
│ └──────────┬──────────┘ │
│ │ │
│ ▼ │
│ ┌─────────────────────┐ │
│ │ Business Logic │ │
│ └─────────────────────┘ │
│ │
└─────────────────────────────────────────────────────────────────────────┘
7.2 敏感信息管理
┌─────────────────────────────────────────────────────────────────────────┐
│ Kubernetes Secret 管理 │
├─────────────────────────────────────────────────────────────────────────┤
│ │
│ Secret 类型: Opaque │
│ │
│ 存储的敏感信息: │
│ ├── MYSQL_HOST # MySQL 主机地址 │
│ ├── MYSQL_PORT # MySQL 端口 │
│ ├── MYSQL_DATABASE # 数据库名称 │
│ ├── MYSQL_USERNAME # 数据库用户名 │
│ ├── MYSQL_PASSWORD # 数据库密码 │
│ ├── REDIS_HOST # Redis 主机地址 │
│ ├── REDIS_PORT # Redis 端口 │
│ ├── REDIS_PASSWORD # Redis 密码 │
│ ├── MAIL_HOST # 邮件服务器地址 │
│ ├── MAIL_USERNAME # 邮件用户名 │
│ ├── MAIL_PASSWORD # 邮件密码 │
│ └── SIGNATURE_SECRET # 接口签名密钥 │
│ │
└─────────────────────────────────────────────────────────────────────────┘
7.3 服务间认证
// Feign Token 拦截器
public class FeignTokenInterceptor implements RequestInterceptor {
@Override
public void apply(RequestTemplate template) {
// 从当前上下文获取 Token 并传递给下游服务
String token = getCurrentToken();
template.header("Authorization", "Bearer " + token);
}
}
8. 可观测性架构
8.1 监控架构
┌─────────────────────────────────────────────────────────────────────────┐
│ 监控架构 │
├─────────────────────────────────────────────────────────────────────────┤
│ │
│ ┌─────────────────────────────────────────────────────────────────┐ │
│ │ Prometheus 采集层 │ │
│ │ │ │
│ │ ┌─────────┐ ┌─────────┐ ┌─────────┐ ┌─────────┐ ┌─────────┐ │ │
│ │ │ Basic │ │ Inbound │ │Outbound │ │Inventory│ │Schedule │ │ │
│ │ │ :8001 │ │ :8002 │ │ :8003 │ │ :8004 │ │ :8005 │ │ │
│ │ └────┬────┘ └────┬────┘ └────┬────┘ └────┬────┘ └────┬────┘ │ │
│ │ │ │ │ │ │ │ │
│ │ └───────────┴───────────┴───────────┴───────────┘ │ │
│ │ │ │ │
│ │ ▼ │ │
│ │ /actuator/prometheus │ │
│ └─────────────────────────────────────────────────────────────────┘ │
│ │ │
│ ▼ │
│ ┌─────────────────────────────────────────────────────────────────┐ │
│ │ Prometheus Server │ │
│ │ - 指标采集 │ │
│ │ - 数据存储 │ │
│ │ - 告警规则 │ │
│ └─────────────────────────────────────────────────────────────────┘ │
│ │ │
│ ▼ │
│ ┌─────────────────────────────────────────────────────────────────┐ │
│ │ Grafana 可视化 │ │
│ │ - 仪表盘展示 │ │
│ │ - 告警通知 │ │
│ └─────────────────────────────────────────────────────────────────┘ │
│ │
└─────────────────────────────────────────────────────────────────────────┘
8.2 Actuator 端点
| 端点 |
路径 |
说明 |
| health |
/actuator/health |
健康状态 |
| info |
/actuator/info |
应用信息 |
| prometheus |
/actuator/prometheus |
Prometheus 指标 |
| metrics |
/actuator/metrics |
JVM 指标 |
8.3 日志架构
┌─────────────────────────────────────────────────────────────────────────┐
│ 日志架构 │
├─────────────────────────────────────────────────────────────────────────┤
│ │
│ ┌─────────┐ ┌─────────┐ ┌─────────┐ ┌─────────┐ ┌─────────┐ │
│ │ Pod │ │ Pod │ │ Pod │ │ Pod │ │ Pod │ │
│ │ stdout │ │ stdout │ │ stdout │ │ stdout │ │ stdout │ │
│ └────┬────┘ └────┬────┘ └────┬────┘ └────┬────┘ └────┬────┘ │
│ │ │ │ │ │ │
│ └───────────┴───────────┴───────────┴───────────┘ │
│ │ │
│ ▼ │
│ ┌─────────────────────────────────────────────────────────────────┐ │
│ │ 日志收集器 (Filebeat/Fluentd) │ │
│ └─────────────────────────────────────────────────────────────────┘ │
│ │ │
│ ▼ │
│ ┌─────────────────────────────────────────────────────────────────┐ │
│ │ Elasticsearch │ │
│ │ - 日志存储 │ │
│ │ - 全文检索 │ │
│ └─────────────────────────────────────────────────────────────────┘ │
│ │ │
│ ▼ │
│ ┌─────────────────────────────────────────────────────────────────┐ │
│ │ Kibana │ │
│ │ - 日志查询 │ │
│ │ - 可视化分析 │ │
│ └─────────────────────────────────────────────────────────────────┘ │
│ │
└─────────────────────────────────────────────────────────────────────────┘
9. 高可用架构
9.1 服务高可用
┌─────────────────────────────────────────────────────────────────────────┐
│ 服务高可用设计 │
├─────────────────────────────────────────────────────────────────────────┤
│ │
│ 1. 多副本部署 │
│ ┌─────────────────────────────────────────────────────────────┐ │
│ │ Deployment (replicas: N) │ │
│ │ ┌─────────┐ ┌─────────┐ ┌─────────┐ │ │
│ │ │ Pod 1 │ │ Pod 2 │ │ Pod N │ │ │
│ │ └─────────┘ └─────────┘ └─────────┘ │ │
│ └─────────────────────────────────────────────────────────────┘ │
│ │
│ 2. 滚动更新 │
│ ┌─────────────────────────────────────────────────────────────┐ │
│ │ strategy: │ │
│ │ type: RollingUpdate │ │
│ │ rollingUpdate: │ │
│ │ maxSurge: 1 # 最多多 1 个 Pod │ │
│ │ maxUnavailable: 0 # 最少可用 Pod 数 │ │
│ └─────────────────────────────────────────────────────────────┘ │
│ │
│ 3. 健康检查 │
│ ┌─────────────────────────────────────────────────────────────┐ │
│ │ livenessProbe → 存活检查 (失败则重启) │ │
│ │ readinessProbe → 就绪检查 (失败则从 Service 移除) │ │
│ │ startupProbe → 启动检查 (慢启动保护) │ │
│ └─────────────────────────────────────────────────────────────┘ │
│ │
│ 4. 服务降级 │
│ ┌─────────────────────────────────────────────────────────────┐ │
│ │ @FeignClient(fallbackFactory = BasicServiceFallbackFactory)│ │
│ │ → 服务不可用时返回默认响应 │ │
│ └─────────────────────────────────────────────────────────────┘ │
│ │
└─────────────────────────────────────────────────────────────────────────┘
9.2 数据高可用
┌─────────────────────────────────────────────────────────────────────────┐
│ 数据高可用设计 │
├─────────────────────────────────────────────────────────────────────────┤
│ │
│ MySQL 高可用: │
│ ┌─────────────────────────────────────────────────────────────────┐ │
│ │ ┌─────────────┐ ┌─────────────┐ │ │
│ │ │ Master │ ───▶ │ Slave │ │ │
│ │ │ (读写) │ │ (只读) │ │ │
│ │ └─────────────┘ └─────────────┘ │ │
│ └─────────────────────────────────────────────────────────────────┘ │
│ │
│ Redis 高可用: │
│ ┌─────────────────────────────────────────────────────────────────┐ │
│ │ ┌─────────────┐ ┌─────────────┐ ┌─────────────┐ │ │
│ │ │ Master │ ───▶ │ Slave │ ◀─── │ Sentinel │ │ │
│ │ └─────────────┘ └─────────────┘ │ (监控) │ │ │
│ │ └─────────────┘ │ │
│ └─────────────────────────────────────────────────────────────────┘ │
│ │
└─────────────────────────────────────────────────────────────────────────┘
10. 技术栈清单
10.1 核心框架
| 组件 |
版本 |
用途 |
| Spring Boot |
3.5.5 |
应用框架 |
| Spring Cloud |
2025.0.0 |
微服务治理 |
| JDK |
17 |
运行环境 |
10.2 数据层
| 组件 |
版本 |
用途 |
| MyBatis Plus |
3.5.12 |
ORM 框架 |
| Druid |
1.2.24 |
连接池 |
| MySQL |
8.0.27 |
关系数据库 |
| Redis |
- |
缓存/分布式锁 |
10.3 服务通信
| 组件 |
版本 |
用途 |
| OpenFeign |
4.2.0 |
服务调用 |
| OkHttp |
- |
HTTP 客户端 |
| Redisson |
3.27.0 |
分布式锁 |
10.4 容器化
| 组件 |
用途 |
| Docker |
容器运行时 |
| Kubernetes |
容器编排 |
| KubeSphere |
容器平台 |
10.5 其他组件
| 组件 |
版本 |
用途 |
| Knife4j |
4.5.0 |
API 文档 |
| Quartz |
- |
定时任务 |
| Shiro |
2.0.4 |
安全框架 |
| JWT |
4.5.0 |
Token 认证 |
11. 服务依赖关系图
┌─────────────────┐
│ System Service │
│ (用户/权限) │
└────────┬────────┘
│
│ 认证
│
┌──────────────────────────────┼──────────────────────────────┐
│ │ │
▼ ▼ ▼
┌─────────────────┐ ┌─────────────────┐ ┌─────────────────┐
│ Basic Service │◄───────────│Inbound Service │───────────▶│Outbound Service │
│ (基础数据) │ Feign │ (入库业务) │ Feign │ (出库业务) │
└────────┬────────┘ └────────┬────────┘ └────────┬────────┘
│ │ │
│ Feign │ Feign │ Feign
│ │ │
│ ┌────────────────────┼────────────────────┐ │
│ │ │ │ │
▼ ▼ ▼ ▼ ▼
┌─────────────────────────┐ ┌─────────────────┐ ┌─────────────────────────┐
│ Inventory Service │◄───│Schedule Service │───▶│ 基础设施 │
│ (库存业务) │ │ (调度任务) │ │ ┌─────┐ ┌─────┐ │
└─────────────────────────┘ └─────────────────┘ │ │MySQL│ │Redis│ │
│ └─────┘ └─────┘ │
└─────────────────────────┘
附录
A. 服务端口汇总
| 服务 |
容器端口 |
Service 端口 |
ClusterIP |
| cpte-wms-basic |
8001 |
8001 |
10.233.42.190 |
| cpte-wms-inbound |
8002 |
8002 |
10.233.51.195 |
| cpte-wms-outbound |
8003 |
8003 |
- |
| inventory-service |
8004 |
8004 |
- |
| outbound-service |
8003 |
8003 |
- |
B. Context Path 汇总
| 服务 |
Context Path |
| Basic |
/cpte-wms-basic |
| Inbound |
/cpte-wms-inbound |
| Outbound |
/cpte-wms-outbound |
| Inventory |
/cpte-wms-inventory |
| Schedule |
/cpte-wms-schedule |
C. 关键配置项
| 配置项 |
说明 |
| spring.application.name |
服务名称 |
| server.port |
服务端口 |
| server.servlet.context-path |
上下文路径 |
| feign.client.wms-basic.url |
基础服务地址 |
| jeecg.redisson.address |
Redis 地址 |