CrossBorder_OS/backend/TODO.md

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：商品中心 ✅

• Product 实体（SPU）+ ProductController + ProductService
• ProductSku 实体（SKU）+ ProductSkuController + ProductSkuService
• ProductCategory 类目实体 + 类目管理
• 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 字段）