Reorder TODO: base platform (employee/dept/role/permission) first, then business modules

backend/TODO.md

@@ -2,151 +2,181 @@
 
 ## 优先级说明
 
-**P0 = 主干必通**（其他模块都依赖的链路）
-**P1 = 业务闭环**（完成核心业务流程）
-**P2 = 完善功能**（提升体验/效率）
+**P0 = 基础平台**（其他所有模块依赖）
+**P1 = 业务主干**（核心链路必须跑通）
+**P2 = 业务闭环**（完成核心业务流程）
 
 ---
 
-## P0 主干链路（按依赖顺序）
+## P0 基础平台（最先做）
 
-### 阶段1：基础设施
+### 阶段1：系统管理基础设施
 
-- [ ] `pom.xml` 补充 JWT / Redis / Security 依赖
-- [ ] `SecurityConfig` - JWT 过滤器链
-- [ ] `JwtTokenProvider` - Token 生成/校验
+- [ ] `pom.xml` 补充 JWT / Redis / Security / Knife4j 依赖
+- [ ] `SecurityConfig` - JWT 过滤器链 + 公开路径配置
+- [ ] `JwtTokenProvider` - Token 生成/校验/刷新
+- [ ] `JwtAuthenticationFilter` - 请求拦截校验
+- [ ] `GlobalExceptionHandler` - 统一异常处理
 - [ ] `LoginController` - 登录/登出/刷新Token
-- [ ] `AuthService` - 认证逻辑
+- [ ] `AuthService` - 认证逻辑（密码校验/Token签发）
 
-### 阶段2：商品中心
+### 阶段2：组织架构
 
-- [ ] `Product` / `ProductSku` 实体 + 仓库
-- [ ] `ProductController` / `ProductSkuController`
-- [ ] `ProductService` - CRUD + 分页查询
-- [ ] `ChannelMapping` 实体 + 渠道SKU映射
+- [ ] `SysDepartment` 实体 + `DepartmentController` + `DepartmentService`
+- [ ] 部门CRUD + 树形结构 + 负责人配置
+- [ ] `SysEmployee` 实体（员工档案） + `EmployeeController` + `EmployeeService`
+- [ ] 员工CRUD + 部门归属 + 状态管理（在职/离职）
 
-### 阶段3：渠道中心
+### 阶段3：用户权限
 
-- [ ] `Channel` 实体 + 仓库
-- [ ] `ChannelController` / `ChannelService`
-- [ ] 渠道授权 Token 管理
+- [ ] `SysUser` 实体 + `SysUserController` + `SysUserService`
+- [ ] 用户CRUD + 密码加密（BCrypt）+ 登录日志
+- [ ] `SysRole` 实体 + `RoleController` + `RoleService`
+- [ ] 角色CRUD + 权限树配置（菜单权限 + 操作权限）
+- [ ] 用户-角色关联分配
+- [ ] `SysApiKey` 实体 + `ApiKeyController` + `ApiKeyService`
+- [ ] API Key CRUD + 权限范围 + 状态管理
 
-### 阶段4：仓库物流
+### 阶段4：审计与通知
 
-- [ ] `Warehouse` 实体
-- [ ] `WarehouseController` / `WarehouseService`
-- [ ] `LogisticsProvider` 实体 + 物流商管理
-- [ ] `ShippingTemplate` 实体 + 运费模板
+- [ ] `SysOperationLog` 实体 + `OperationLogService`
+- [ ] AOP切面自动记录操作日志（模块/操作人/对象/结果）
+- [ ] `SysNotification` 实体 + `NotificationService`
+- [ ] 消息通知CRUD + 已读未读状态
 
-### 阶段5：库存中心
+---
 
-- [ ] `Inventory` 实体（available/locked/in_transit）
-- [ ] `InventoryController` / `InventoryService`
-- [ ] `InventoryLog` 实体（库存流水）
-- [ ] 库存锁定/解锁接口（给订单用）
-- [ ] 库存变动事务保证
+## P1 业务主干（按依赖顺序）
+
+### 阶段5：商品中心
+
+- [ ] `Product` 实体（SPU）+ `ProductController` + `ProductService`
+- [ ] `ProductSku` 实体（SKU）+ `ProductSkuController` + `ProductSkuService`
+- [ ] `ProductCategory` 类目实体 + 类目管理
+- [ ] `ChannelMapping` 渠道映射实体 + 映射管理
+
+### 阶段6：渠道中心
+
+- [ ] `Channel` 实体 + `ChannelController` + `ChannelService`
+- [ ] 渠道CRUD + Token管理 + 同步状态
+- [ ] 渠道配置（Webhook / AppKey / AppSecret）
 
-### 阶段6：供应商采购
+### 阶段7：仓库物流
 
-- [ ] `Supplier` 实体 + 供应商管理
-- [ ] `SupplyCapability` 实体（供货能力/MOQ/阶梯价）
-- [ ] `PurchaseOrder` 实体 + 采购单 CRUD
-- [ ] `PurchaseOrderItem` 采购单明细
-- [ ] 采购单状态流转（DRAFT→APPROVED→PARTIAL_ARRIVAL→COMPLETED）
-- [ ] 到货确认接口（含库存增加+库存流水）
+- [ ] `Warehouse` 实体 + `WarehouseController` + `WarehouseService`
+- [ ] 仓库CRUD + 启用/停用
+- [ ] `LogisticsProvider` 实体 + `LogisticsProviderController` + `LogisticsProviderService`
+- [ ] 物流商CRUD + 计费方式
+- [ ] `ShippingTemplate` 实体 + `ShippingTemplateController` + `ShippingTemplateService`
+- [ ] 运费模板CRUD（首重/续重/偏远附加费）
 
-### 阶段7：订单中心 ⭐核心
+### 阶段8：库存中心
 
-- [ ] `Orders` 实体（60+字段全量）
+- [ ] `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`
+- [ ] `OrderController` + `OrderService`
+- [ ] 订单CRUD + 分页查询 + 多条件筛选
 - [ ] 订单状态流转（CREATED→PAID→ALLOCATED→SHIPPED→DELIVERED→COMPLETED）
-- [ ] **支付确认 → 订单状态更新**
+- [ ] **支付确认 → 订单状态+支付信息更新**
 - [ ] **仓库分配 → 库存锁定**
 - [ ] **发货确认 → 库存变动+物流信息**
-- [ ] `ShippingOrder` 发货单
-- [ ] `OrderStatusEvent` 订单状态事件记录
+- [ ] `ShippingOrder` 发货单 + 发货状态管理
+- [ ] `OrderStatusEvent` 状态事件记录（时间线）
+- [ ] `OrderOperationLog` 操作日志
 
-### 阶段8：售后中心
+### 阶段11：售后中心
 
-- [ ] `AfterSale` 实体
-- [ ] `AfterSaleController` / `AfterSaleService`
-- [ ] 售后审核通过/拒绝
-- [ ] **退款执行 → 订单退款状态更新**
-- [ ] **补发单生成 → 创建新订单（含original_order_id）**
+- [ ] `AfterSale` 实体 + `AfterSaleController` + `AfterSaleService`
+- [ ] 售后CRUD + 状态流转
+- [ ] **审核通过/拒绝**
+- [ ] **退款执行 → 订单refund_status更新 + 库存回退**
+- [ ] **补发单生成 → 创建新订单（original_order_id关联）**
+- [ ] 退货入库确认
 
-### 阶段9：财务中心
+### 阶段12：财务中心
 
-- [ ] `FinancePayment` 收款记录
+- [ ] `FinancePayment` 收款记录 + `FinanceController` + `FinanceService`
+- [ ] 收款CRUD + 对账确认
+- [ ] **对账确认 → 订单payment_status更新**
 - [ ] `FinanceRefund` 退款记录
-- [ ] `FinanceController` / `FinanceService`
-- [ ] **对账确认 → 订单支付状态更新**
-- [ ] **退款执行 → 订单退款状态+金额更新**
-- [ ] `SupplierSettlement` 供应商结算
-
----
-
-## P1 业务闭环
-
-### 客服中心
-
-- [ ] `Ticket` 工单实体 + CRUD
-- [ ] 工单分配 / 回复 / 关闭
-- [ ] `Satisfaction` 满意度评价
-
-### 报表基础
-
-- [ ] 订单统计接口（按时段/渠道/国家）
-- [ ] 库存预警接口（低于安全库存）
-- [ ] 采购汇总接口
+- [ ] **退款执行 → 订单refund_status+refund_amount更新**
+- [ ] `SupplierSettlement` 供应商结算 + 结算单生成
+- [ ] `Invoice` 发票管理
 
 ---
 
-## P2 完善功能
-
-### 营销中心
+## P2 业务扩展
 
-- [ ] `Promotion` 促销活动
-- [ ] `Coupon` 优惠券
-- [ ] `PriceWatch` 价格监控
+### 阶段13：营销中心
 
-### 系统配置
+- [ ] `Promotion` 促销活动 + 活动效果分析
+- [ ] `Coupon` 优惠券 + 发放/核销
+- [ ] `PriceWatch` 价格监控 + 竞品价格抓取
 
-- [ ] `SysUser` / `SysRole` / `SysDepartment` 用户部门角色
-- [ ] `SysApiKey` API Key 管理
-- [ ] `SysOperationLog` 操作日志
-- [ ] `SysNotification` 消息通知
-- [ ] `SysApprovalFlow` 审批流程
-
-### AI客服
+### 阶段14：AI客服
 
 - [ ] `AiChannel` AI渠道配置
-- [ ] `KnowledgeBase` 知识库
+- [ ] `KnowledgeBase` 知识库 + `KnowledgeCategory`
 - [ ] `AutoReplyRule` 自动回复规则
-- [ ] `ChatSession` / `ChatMessage` 会话消息
-- [ ] `ServicePerformance` 客服绩效
+- [ ] `ChatSession` 会话 + `ChatMessage` 消息
+- [ ] `ServicePerformance` 客服绩效统计
+
+### 阶段15：报表中心
+
+- [ ] 销售统计接口（GMV/订单量/客单价/转化率）
+- [ ] 库存预警接口（低于安全库存）
+- [ ] 采购汇总接口
+- [ ] 库存周转分析（周转天数/呆滞库存）
+- [ ] 供应商绩效报表
 
-### 高级报表
+### 阶段16：审批与消息
 
-- [ ] 销售分析（GMV/转化率/客单价）
-- [ ] 库存周转分析
-- [ ] 供应商绩效
+- [ ] `SysApprovalFlow` 审批流程配置 + 审批节点
+- [ ] `SysMessageTemplate` 消息模板 + 变量占位符
+- [ ] 消息订阅与推送
 
 ---
 
 ## 数据库初始化
 
 - [ ] 创建 `oms` 数据库
-- [ ] 执行 `docs/OMS后端完整设计文档.md` 中的建表SQL
-- [ ] 初始化管理员账号（admin/admin123）
+- [ ] 执行 `docs/OMS后端完整设计文档.md` 建表SQL
+- [ ] 初始化超级管理员（admin / admin123）
+- [ ] 初始化默认角色（ADMIN / MANAGER / OPERATOR / WAREHOUSE / FINANCE / CS）
 
 ---
 
-## 技术债务
+## 技术规范
 
-- [ ] 统一异常处理（`GlobalExceptionHandler`）
-- [ ] 统一响应包装（`ApiResponse` 已是）
-- [ ] 请求日志拦截器
-- [ ] 接口限流配置
-- [ ] 数据权限注解（租户隔离）
-- [ ] 审计字段自动填充（`CreatedBy` / `UpdatedBy`）
+- [ ] 统一响应格式 `ApiResponse<T>`
+- [ ] 分页统一 `PageResult<T>`
+- [ ] 请求日志拦截器（打印入参/出参/耗时）
+- [ ] 接口限流（Redis + Lua）
+- [ ] 数据权限注解（租户隔离 `tenant_id`）
+- [ ] 审计字段自动填充（`created_by` / `updated_by` / `created_at` / `updated_at`）
+- [ ] 逻辑删除（`deleted` 字段）