Home Explore Help
Sign In
newpoint
/
CrossBorder_OS
1
0
Fork 0
Files Issues 0 Pull Requests 0 Wiki
Tree: d9f8763777
Branches Tags
CrossBorder_OS
/
backend
/
TODO.md

TODO.md 4.1 KB
History Raw

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）