CrossBorder_OS/backend/TODO.md

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）