# 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 配置 ```yaml 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 数据库连接池 ```yaml 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 健康检查配置 ```yaml 探针配置: 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 服务间认证 ```java // 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 地址 |