# OMS 后端实施计划

## 优先级说明

**P0 = 主干必通**（其他模块都依赖的链路）
**P1 = 业务闭环**（完成核心业务流程）
**P2 = 完善功能**（提升体验/效率）

---

## P0 主干链路（按依赖顺序）

### 阶段1：基础设施

- [ ] `pom.xml` 补充 JWT / Redis / Security 依赖
- [ ] `SecurityConfig` - JWT 过滤器链
- [ ] `JwtTokenProvider` - Token 生成/校验
- [ ] `LoginController` - 登录/登出/刷新Token
- [ ] `AuthService` - 认证逻辑

### 阶段2：商品中心

- [ ] `Product` / `ProductSku` 实体 + 仓库
- [ ] `ProductController` / `ProductSkuController`
- [ ] `ProductService` - CRUD + 分页查询
- [ ] `ChannelMapping` 实体 + 渠道SKU映射

### 阶段3：渠道中心

- [ ] `Channel` 实体 + 仓库
- [ ] `ChannelController` / `ChannelService`
- [ ] 渠道授权 Token 管理

### 阶段4：仓库物流

- [ ] `Warehouse` 实体
- [ ] `WarehouseController` / `WarehouseService`
- [ ] `LogisticsProvider` 实体 + 物流商管理
- [ ] `ShippingTemplate` 实体 + 运费模板

### 阶段5：库存中心

- [ ] `Inventory` 实体（available/locked/in_transit）
- [ ] `InventoryController` / `InventoryService`
- [ ] `InventoryLog` 实体（库存流水）
- [ ] 库存锁定/解锁接口（给订单用）
- [ ] 库存变动事务保证

### 阶段6：供应商采购

- [ ] `Supplier` 实体 + 供应商管理
- [ ] `SupplyCapability` 实体（供货能力/MOQ/阶梯价）
- [ ] `PurchaseOrder` 实体 + 采购单 CRUD
- [ ] `PurchaseOrderItem` 采购单明细
- [ ] 采购单状态流转（DRAFT→APPROVED→PARTIAL_ARRIVAL→COMPLETED）
- [ ] 到货确认接口（含库存增加+库存流水）

### 阶段7：订单中心 ⭐核心

- [ ] `Orders` 实体（60+字段全量）
- [ ] `OrderItem` 订单明细
- [ ] `OrderController` / `OrderService`
- [ ] 订单状态流转（CREATED→PAID→ALLOCATED→SHIPPED→DELIVERED→COMPLETED）
- [ ] **支付确认 → 订单状态更新**
- [ ] **仓库分配 → 库存锁定**
- [ ] **发货确认 → 库存变动+物流信息**
- [ ] `ShippingOrder` 发货单
- [ ] `OrderStatusEvent` 订单状态事件记录

### 阶段8：售后中心

- [ ] `AfterSale` 实体
- [ ] `AfterSaleController` / `AfterSaleService`
- [ ] 售后审核通过/拒绝
- [ ] **退款执行 → 订单退款状态更新**
- [ ] **补发单生成 → 创建新订单（含original_order_id）**

### 阶段9：财务中心

- [ ] `FinancePayment` 收款记录
- [ ] `FinanceRefund` 退款记录
- [ ] `FinanceController` / `FinanceService`
- [ ] **对账确认 → 订单支付状态更新**
- [ ] **退款执行 → 订单退款状态+金额更新**
- [ ] `SupplierSettlement` 供应商结算

---

## P1 业务闭环

### 客服中心

- [ ] `Ticket` 工单实体 + CRUD
- [ ] 工单分配 / 回复 / 关闭
- [ ] `Satisfaction` 满意度评价

### 报表基础

- [ ] 订单统计接口（按时段/渠道/国家）
- [ ] 库存预警接口（低于安全库存）
- [ ] 采购汇总接口

---

## P2 完善功能

### 营销中心

- [ ] `Promotion` 促销活动
- [ ] `Coupon` 优惠券
- [ ] `PriceWatch` 价格监控

### 系统配置

- [ ] `SysUser` / `SysRole` / `SysDepartment` 用户部门角色
- [ ] `SysApiKey` API Key 管理
- [ ] `SysOperationLog` 操作日志
- [ ] `SysNotification` 消息通知
- [ ] `SysApprovalFlow` 审批流程

### AI客服

- [ ] `AiChannel` AI渠道配置
- [ ] `KnowledgeBase` 知识库
- [ ] `AutoReplyRule` 自动回复规则
- [ ] `ChatSession` / `ChatMessage` 会话消息
- [ ] `ServicePerformance` 客服绩效

### 高级报表

- [ ] 销售分析（GMV/转化率/客单价）
- [ ] 库存周转分析
- [ ] 供应商绩效

---

## 数据库初始化

- [ ] 创建 `oms` 数据库
- [ ] 执行 `docs/OMS后端完整设计文档.md` 中的建表SQL
- [ ] 初始化管理员账号（admin/admin123）

---

## 技术债务

- [ ] 统一异常处理（`GlobalExceptionHandler`）
- [ ] 统一响应包装（`ApiResponse` 已是）
- [ ] 请求日志拦截器
- [ ] 接口限流配置
- [ ] 数据权限注解（租户隔离）
- [ ] 审计字段自动填充（`CreatedBy` / `UpdatedBy`）