# OMS 后端实施计划

## 优先级说明

**P0 = 基础平台**（其他所有模块依赖）
**P1 = 业务主干**（核心链路必须跑通）
**P2 = 业务闭环**（完成核心业务流程）

---

## P0 基础平台（最先做）

### 阶段1：系统管理基础设施

- [ ] `pom.xml` 补充 JWT / Redis / Security / Knife4j 依赖
- [ ] `SecurityConfig` - JWT 过滤器链 + 公开路径配置
- [ ] `JwtTokenProvider` - Token 生成/校验/刷新
- [ ] `JwtAuthenticationFilter` - 请求拦截校验
- [ ] `GlobalExceptionHandler` - 统一异常处理
- [ ] `LoginController` - 登录/登出/刷新Token
- [ ] `AuthService` - 认证逻辑（密码校验/Token签发）

### 阶段2：组织架构

- [ ] `SysDepartment` 实体 + `DepartmentController` + `DepartmentService`
- [ ] 部门CRUD + 树形结构 + 负责人配置
- [ ] `SysEmployee` 实体（员工档案） + `EmployeeController` + `EmployeeService`
- [ ] 员工CRUD + 部门归属 + 状态管理（在职/离职）

### 阶段3：用户权限

- [ ] `SysUser` 实体 + `SysUserController` + `SysUserService`
- [ ] 用户CRUD + 密码加密（BCrypt）+ 登录日志
- [ ] `SysRole` 实体 + `RoleController` + `RoleService`
- [ ] 角色CRUD + 权限树配置（菜单权限 + 操作权限）
- [ ] 用户-角色关联分配
- [ ] `SysApiKey` 实体 + `ApiKeyController` + `ApiKeyService`
- [ ] API Key CRUD + 权限范围 + 状态管理

### 阶段4：审计与通知

- [ ] `SysOperationLog` 实体 + `OperationLogService`
- [ ] AOP切面自动记录操作日志（模块/操作人/对象/结果）
- [ ] `SysNotification` 实体 + `NotificationService`
- [ ] 消息通知CRUD + 已读未读状态

---

## P1 业务主干（按依赖顺序）

### 阶段5：商品中心 ✅

- [x] `Product` 实体（SPU）+ `ProductController` + `ProductService`
- [x] `ProductSku` 实体（SKU）+ `ProductSkuController` + `ProductSkuService`
- [x] `ProductCategory` 类目实体 + 类目管理
- [x] `ChannelMapping` 渠道映射实体 + 映射管理

### 阶段6：渠道中心

- [ ] `Channel` 实体 + `ChannelController` + `ChannelService`
- [ ] 渠道CRUD + Token管理 + 同步状态
- [ ] 渠道配置（Webhook / AppKey / AppSecret）

### 阶段7：仓库物流

- [ ] `Warehouse` 实体 + `WarehouseController` + `WarehouseService`
- [ ] 仓库CRUD + 启用/停用
- [ ] `LogisticsProvider` 实体 + `LogisticsProviderController` + `LogisticsProviderService`
- [ ] 物流商CRUD + 计费方式
- [ ] `ShippingTemplate` 实体 + `ShippingTemplateController` + `ShippingTemplateService`
- [ ] 运费模板CRUD（首重/续重/偏远附加费）

### 阶段8：库存中心

- [ ] `Inventory` 实体（available/locked/in_transit/safe_stock）
- [ ] `InventoryController` + `InventoryService`
- [ ] `InventoryLog` 实体（库存流水）
- [ ] **库存锁定接口**（订单分配仓库时调用）
- [ ] **库存解锁接口**（取消订单/退款时调用）
- [ ] **库存变动事务**（入库/出库/调拨 保证原子性）
- [ ] `ReturnPackage` 退件实体 + 退件处理流程

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

- [ ] `Supplier` 实体 + `SupplierController` + `SupplierService`
- [ ] 供应商CRUD + 评级 + 结算方式
- [ ] `SupplyCapability` 实体（MOQ/阶梯价/交期）
- [ ] 供货能力配置
- [ ] `PurchaseOrder` 实体 + `PurchaseOrderController` + `PurchaseOrderService`
- [ ] 采购单CRUD + 状态流转（DRAFT→APPROVED→PARTIAL_ARRIVAL→COMPLETED）
- [ ] `PurchaseOrderItem` 采购明细
- [ ] `PurchaseArrival` 到货确认 + `PurchaseArrivalItem` 到货明细
- [ ] **到货确认 → 库存增加 + 库存流水记录**
- [ ] `Iqc` 来料质检 + 质检结果处理
- [ ] `ReplenishmentPlan` 备货计划 + 智能补货建议
- [ ] `PurchaseRequest` 采购需求申请 + 审批流程

### 阶段10：订单中心 ⭐

- [ ] `Orders` 实体（全量60+字段）
- [ ] `OrderItem` 订单明细
- [ ] `OrderController` + `OrderService`
- [ ] 订单CRUD + 分页查询 + 多条件筛选
- [ ] 订单状态流转（CREATED→PAID→ALLOCATED→SHIPPED→DELIVERED→COMPLETED）
- [ ] **支付确认 → 订单状态+支付信息更新**
- [ ] **仓库分配 → 库存锁定**
- [ ] **发货确认 → 库存变动+物流信息**
- [ ] `ShippingOrder` 发货单 + 发货状态管理
- [ ] `OrderStatusEvent` 状态事件记录（时间线）
- [ ] `OrderOperationLog` 操作日志

### 阶段11：售后中心

- [ ] `AfterSale` 实体 + `AfterSaleController` + `AfterSaleService`
- [ ] 售后CRUD + 状态流转
- [ ] **审核通过/拒绝**
- [ ] **退款执行 → 订单refund_status更新 + 库存回退**
- [ ] **补发单生成 → 创建新订单（original_order_id关联）**
- [ ] 退货入库确认

### 阶段12：财务中心

- [ ] `FinancePayment` 收款记录 + `FinanceController` + `FinanceService`
- [ ] 收款CRUD + 对账确认
- [ ] **对账确认 → 订单payment_status更新**
- [ ] `FinanceRefund` 退款记录
- [ ] **退款执行 → 订单refund_status+refund_amount更新**
- [ ] `SupplierSettlement` 供应商结算 + 结算单生成
- [ ] `Invoice` 发票管理

---

## P2 业务扩展

### 阶段13：营销中心

- [ ] `Promotion` 促销活动 + 活动效果分析
- [ ] `Coupon` 优惠券 + 发放/核销
- [ ] `PriceWatch` 价格监控 + 竞品价格抓取

### 阶段14：AI客服

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

### 阶段15：报表中心

- [ ] 销售统计接口（GMV/订单量/客单价/转化率）
- [ ] 库存预警接口（低于安全库存）
- [ ] 采购汇总接口
- [ ] 库存周转分析（周转天数/呆滞库存）
- [ ] 供应商绩效报表

### 阶段16：审批与消息

- [ ] `SysApprovalFlow` 审批流程配置 + 审批节点
- [ ] `SysMessageTemplate` 消息模板 + 变量占位符
- [ ] 消息订阅与推送

---

## 数据库初始化

- [ ] 创建 `oms` 数据库
- [ ] 执行 `docs/OMS后端完整设计文档.md` 建表SQL
- [ ] 初始化超级管理员（admin / admin123）
- [ ] 初始化默认角色（ADMIN / MANAGER / OPERATOR / WAREHOUSE / FINANCE / CS）

---

## 技术规范

- [ ] 统一响应格式 `ApiResponse<T>`
- [ ] 分页统一 `PageResult<T>`
- [ ] 请求日志拦截器（打印入参/出参/耗时）
- [ ] 接口限流（Redis + Lua）
- [ ] 数据权限注解（租户隔离 `tenant_id`）
- [ ] 审计字段自动填充（`created_by` / `updated_by` / `created_at` / `updated_at`）
- [ ] 逻辑删除（`deleted` 字段）