Update backend TODO with prioritized implementation plan

backend/TODO.md

@@ -1,812 +1,152 @@
-# CrossBorder OS 前端实施计划
-
-## 现状总结
-
-### 已完成的基础设施（100%）
-- Vue 3 + TS + Vite + Element Plus + Pinia + Vue Router
-- 中后台布局（侧边栏、顶栏、角色菜单过滤）
-- Mock API 系统（完整的 mock 数据 + API 路由）
-- 登录认证 + RBAC 权限控制
-- API 请求封装层（request.ts + services.ts）
-- TypeScript 类型定义（page.ts）
-- 全局样式系统
-
-### 各页面实现程度
-
-| 页面 | 实现度 | 说明 |
-|------|--------|------|
-| 登录页 | 100% | 完整的登录 + 角色切换 |
-| 运营看板 | 100% | 指标卡片 + 告警 + 工作提示 |
-| 订单列表页 | 70% | 筛选、批量操作、常用视图 |
-| 订单详情页 | 60% | 摘要、操作区、时间线、拆合单弹窗 |
-| 售后处理页 | 50% | 审核、退款、退货、换货流程 |
-| 商品列表页 | 70% | 筛选、批量上下架、导入、复制 |
-| 商品编辑页 | 50% | 5步表单、SKU生成、多语言 |
-| 渠道映射页 | 40% | 映射配置、校验、发布 |
-| 定价规则页 | 40% | 规则列表、调价弹窗 |
-| 供应商管理页 | 40% | 基础列表、编辑抽屉 |
-| 采购单管理页 | 40% | 基础列表、创建弹窗 |
-| 供货能力配置页 | 40% | 基础列表、配置弹窗 |
-| 渠道配置页 | 40% | 基础卡片、授权配置 |
-| 库存总览页 | 40% | 基础列表、预警展示 |
-| 发货作业页 | 40% | 基础列表、发货流程 |
-| 报表中心页 | 40% | 基础报表类型切换 |
-| 角色权限页 | 40% | 基础角色管理 |
-| 操作日志页 | 40% | 基础日志列表 |
-| API Key管理页 | 40% | 基础Key管理 |
+# OMS 后端实施计划
 
----
+## 优先级说明
 
-## 欠缺模块分析
-
-### 模块完整度评估
-
-| 模块 | 当前状态 | 欠缺程度 | 说明 |
-|------|---------|---------|------|
-| **商品中心** | 有基础框架 | ⭐⭐⭐ 中等 | 需增强分组/标签/评价 |
-| **订单中心** | 有基础框架 | ⭐⭐⭐ 中等 | 需完善全流程操作 |
-| **售后中心** | 有基础框架 | ⭐⭐⭐ 中等 | 需增强自动化 |
-| **供应商中心** | 有基础框架 | ⭐⭐⭐ 中等 | 需完善采购流程 |
-| **渠道中心** | 有基础框架 | ⭐⭐⭐ 中等 | 需完善配置 |
-| **库存中心** | 只有总览和发货 | ⭐⭐⭐⭐⭐ 严重欠缺 | 缺仓库/调拨/盘点 |
-| **财务中心** | ❌ 完全缺失 | ⭐⭐⭐⭐⭐ 严重欠缺 | 收款/退款/结算/发票 |
-| **营销中心** | ❌ 完全缺失 | ⭐⭐⭐⭐⭐ 严重欠缺 | 促销/优惠券/价格预警 |
-| **客服中心** | 只有售后 | ⭐⭐⭐⭐ 较大欠缺 | 缺工单/模板/评价 |
-| **数据报表** | 只有基础看板 | ⭐⭐⭐⭐ 较大欠缺 | 缺销售/库存/利润分析 |
-| **系统配置** | 只有角色日志 | ⭐⭐⭐⭐ 较大欠缺 | 缺员工/部门/消息 |
-| **仓库物流** | 只有发货 | ⭐⭐⭐⭐⭐ 严重欠缺 | 缺物流商/面单/退件 |
-
-### 模块依赖关系图
-
-```
-                    ┌─────────────┐
-                    │   营销中心  │ ←──── 促销活动、优惠券
-                    └──────┬──────┘
-                           ↓
-┌──────────┐     ┌─────────────┐     ┌──────────────┐
-│ 供应商   │ ──→ │   采购中心  │ ──→ │   仓库中心   │
-└──────────┘     └─────────────┘     └──────┬───────┘
-                           │                   │
-                           ↓                   ↓
-┌──────────┐     ┌─────────────┐     ┌──────────────┐
-│ 商品中心 │ ←── │   订单中心  │ ←── │   库存中心   │
-└──────────┘     └──────┬──────┘     └──────────────┘
-                          │
-                          ↓
-                   ┌─────────────┐
-                   │   财务中心  │ ←──── 收款、退款、结算
-                   └─────────────┘
-                          │
-                          ↓
-┌──────────┐     ┌─────────────┐     ┌──────────────┐
-│ 客服中心 │ ←── │   数据中心  │ ──→ │  系统配置   │
-└──────────┘     └─────────────┘     └──────────────┘
-```
+**P0 = 主干必通**（其他模块都依赖的链路）
+**P1 = 业务闭环**（完成核心业务流程）
+**P2 = 完善功能**（提升体验/效率）
 
 ---
 
-## 实施任务
-
-### 一、商品中心（4 页）
-
-#### 商品列表页（ProductListView.vue）— 实现度 70%
-**已有功能：**
-- ✅ 筛选区（关键词、类目、渠道、状态、品牌）
-- ✅ 表格（主图、标题、SPU、SKU数、库存、价格、状态）
-- ✅ 行内操作（编辑、映射、复制、上下架、删除）
-- ✅ 批量上下架、批量导入弹窗
-- ✅ 发布日志弹窗
-
-**待完善任务：**
-- [ ] 补充 SKU 编号筛选字段
-- [ ] 补充更新时间筛选（时间范围选择器）
-- [ ] 补充负责人筛选字段
-- [ ] 批量导出功能（CSV/Excel）
-- [ ] 批量导入结果展示（成功/失败明细弹窗）
-- [ ] 低库存预警标识和跳转
-
-**可扩展功能（推理）：**
-- [ ] 商品分组管理：品牌分组、类目分组、自定义分组
-- [ ] 商品标签系统：自定义标签、批量打标、标签筛选
-- [ ] 价格区间筛选：最低价～最高价范围筛选
-- [ ] 批量编辑：勾选后批量修改负责人、标签、状态
-- [ ] 商品比较：勾选2-3个商品对比SKU、价格、库存
-- [ ] 查看渠道评价入口
-- [ ] 商品评价展示抽屉
-
-#### 商品编辑页（ProductEditorView.vue）— 实现度 50%
-**已有功能：**
-- ✅ 5步表单（基础信息→SKU规格→媒体素材→多语言→预览）
-- ✅ 基础信息（标题、副标题、类目、品牌、标签、简介）
-- ✅ 属性模板自动带出
-- ✅ SKU规格组合自动生成
-- ✅ 图片/视频上传区
-- ✅ 中英日多语言配置
-- ✅ 翻译完整度展示
-- ✅ 草稿保存、离开确认
-
-**待完善任务：**
-- [ ] 规格项自定义：除颜色/尺寸外，支持添加材质、风格等规格
-- [ ] SKU编码规则配置：自定义前缀、类别、流水号规则
-- [ ] 图片管理：裁剪、水印、压缩、批量上传
-- [ ] 详情富文本编辑器：支持图文混排
-- [ ] 属性必填校验：提交时校验属性是否填写完整
-- [ ] 编辑回显：已有数据回填到表单
-
-**可扩展功能（推理）：**
-- [ ] 规格组合预览图：不同规格显示对应主图
-- [ ] 商品视频介绍上传
-- [ ] 商品版本历史：每次修改记录和回滚
-- [ ] 组合商品（套装）支持：一个SPU包含多个子SKU
-- [ ] 多仓库库存分开管理
-- [ ] 体积重/实际重计算
-- [ ] AI翻译集成：调用翻译API自动翻译
-
-#### 渠道映射页（ProductMappingView.vue）— 实现度 40%
-**已有功能：**
-- ✅ 映射列表（内部SKU、渠道SKU、类目、店铺、状态）
-- ✅ 筛选区（关键词、渠道、映射状态、校验状态）
-- ✅ 新增/编辑映射弹窗
-- ✅ 渠道切换动态刷新
-- ✅ 自动映射、校验、发布操作
-
-**待完善任务：**
-- [ ] 店铺筛选字段
-- [ ] 内部SKU下拉选择（而非手动输入）
-- [ ] 属性映射配置：内部属性→渠道属性的映射关系
-- [ ] 批量映射：勾选多个SKU批量配置
-- [ ] 映射模板：保存/复用映射规则
-
-**可扩展功能（推理）：**
-- [ ] 映射规则自动化：基于类目自动推荐映射配置
-- [ ] 渠道价格自动计算：基于成本和汇率自动定价
-- [ ] 多渠道同步发布：一个内部SKU同时发布到多个渠道
-- [ ] 定时发布：设置发布时间自动执行
-- [ ] 批量导入映射：支持CSV批量配置映射关系
-
-#### 定价与库存规则页（ProductPricingView.vue）— 实现度 40%
-**已有功能：**
-- ✅ 规则列表（SKU、币种、价格、安全库存、状态）
-- ✅ 筛选区（SKU、渠道、币种、仓库、规则状态）
-- ✅ 新增/编辑规则弹窗
-- ✅ 批量调价（按百分比或固定金额）
-
-**待完善任务：**
-- [ ] 促销价不可高于渠道售价校验
-- [ ] 启用/停用规则切换
-- [ ] 每次保存生成变更记录
-- [ ] 规则生效时间配置（支持定时生效）
-- [ ] 阶梯价格配置界面
-
-**可扩展功能（推理）：**
-- [ ] 价格公式配置：成本价 × 系数 + 固定值 = 售价
-- [ ] 促销活动联动：与大促活动自动关联
-- [ ] 区域定价：不同国家/地区不同价格
-- [ ] 历史价格记录和对比
+## P0 主干链路（按依赖顺序）
 
----
+### 阶段1：基础设施
 
-### 二、订单中心（3 页）
-
-#### 订单列表页（OrderListView.vue）— 实现度 70%
-**已有功能：**
-- ✅ 筛选区（订单号、渠道、订单状态、异常标签）
-- ✅ 表格（订单号、渠道、买家、金额、件数、状态、仓库、异常标签）
-- ✅ 行内操作（详情、售后、分配处理人、添加标签）
-- ✅ 批量标记、导出、常用视图
-- ✅ 刷新同步提示
-
-**待完善任务：**
-- [ ] 补充渠道订单号筛选
-- [ ] 补充支付状态筛选（下拉：已支付/未支付/部分支付）
-- [ ] 补充发货状态筛选（下拉：待发货/已发货/部分发货）
-- [ ] 补充下单时间范围筛选（日期范围选择器）
-- [ ] 补充仓库筛选
-- [ ] 批量导出功能（CSV/Excel）
-
-**可扩展功能（推理）：**
-- [ ] 订单来源追踪：标记订单来源（自然搜索/广告/活动）
-- [ ] 订单优先级标记：高优先级订单特殊处理
-- [ ] 订单标签管理：自定义标签、批量打标
-- [ ] 订单推荐处理人：基于订单类型智能分配
-- [ ] 订单自动分类：按金额/地区/商品自动打标
-
-#### 订单详情页（OrderDetailView.vue）— 实现度 60%
-**已有功能：**
-- ✅ 订单摘要（状态、金额、发货状态、异常标签）
-- ✅ 收货 & 支付信息展示
-- ✅ 操作区（提交仓库、锁定库存、拆单、合单、取消）
-- ✅ 商品明细表（SKU、商品、数量、单价）
-- ✅ 订单轨迹时间线
-- ✅ 备注编辑功能
-
-**待完善任务：**
-- [ ] 发票信息展示（开票状态、发票号、抬头）
-- [ ] 完整物流跟踪（物流轨迹地图、每站状态）
-- [ ] 支付信息完善（支付渠道、交易流水号）
-- [ ] 拆单确认后生成新发货单
-- [ ] 合单确认后合并订单逻辑
-
-**可扩展功能（推理）：**
-- [ ] 订单包装清单打印
-- [ ] 订单国际快递单打印（DHL/FedEx）
-- [ ] 海关申报信息管理（品类/价值/原产国）
-- [ ] 买家购买历史展示
-- [ ] 订单延误预警（超时未发货提醒）
-
-#### 售后处理页（OrderAfterSaleView.vue）— 实现度 50%
-**已有功能：**
-- ✅ 售后单列表（单号、订单号、买家、类型、金额、状态）
-- ✅ 筛选区（单号、订单号、类型、审核状态）
-- ✅ 审核通过/拒绝功能
-- ✅ 退款发起、退货物流录入、确认入库
-- ✅ 补发单生成、详情抽屉
-
-**待完善任务：**
-- [ ] 部分退款功能：输入退款金额、剩余可退额度展示
-- [ ] 责任归属配置：供应商/平台/物流/买家责任划分
-- [ ] 退款流水记录：完整的退款历史追踪
-- [ ] 自动审核规则：低金额自动通过配置
-
-**可扩展功能（推理）：**
-- [ ] 退换货原因统计分析：按原因分类汇总
-- [ ] 退款时效监控：超时未处理预警
-- [ ] 批量退款处理：勾选多个批量退款
-- [ ] 退货运费险对接
-- [ ] 差评自动触发售后工单
+- [ ] `pom.xml` 补充 JWT / Redis / Security 依赖
+- [ ] `SecurityConfig` - JWT 过滤器链
+- [ ] `JwtTokenProvider` - Token 生成/校验
+- [ ] `LoginController` - 登录/登出/刷新Token
+- [ ] `AuthService` - 认证逻辑
 
----
+### 阶段2：商品中心
 
-### 三、供应商中心（3 页）
-
-#### 供应商管理页（SupplierListView.vue）— 实现度 40%
-**待完善任务：**
-- [ ] 完整列表：供应商名称、联系人、手机号、合作状态、结算方式、评级、关联 SKU 数、最后更新时间
-- [ ] 新建/编辑抽屉：供应商名称、公司名称、联系人、电话、邮箱、地址、开户信息、税号、合同编号、结算方式、备注
-- [ ] 名称不可重复校验
-- [ ] 手机号和邮箱格式校验
-- [ ] 启用/停用（停用前检查未完成采购单）
-- [ ] 合同附件上传
-
-**可扩展功能（推理）：**
-- [ ] 供应商评分系统：质量/交期/价格多维度评分
-- [ ] 供应商等级管理：ABC等级对应不同采购政策
-- [ ] 供应商联系人管理：多联系人、交接记录
-- [ ] 供应商对账周期配置
-
-#### 采购单管理页（PurchaseOrderView.vue）— 实现度 40%
-**待完善任务：**
-- [ ] 采购单列表：采购单号、供应商、SKU 数、采购总额、预计交期、到货进度、采购状态、创建人
-- [ ] 创建采购单弹窗：供应商（带出默认交期和 MOQ）、仓库、采购 SKU、数量、单价、币种、税费、运费、预计交期、备注
-- [ ] 低于 MOQ 提示但允许提交
-- [ ] 到货确认弹窗：实到数量、良品数量、差异、原因、入库时间
-- [ ] 到货后自动更新库存
-- [ ] 状态流转：草稿 → 待审批 → 已审批 → 部分到货 → 已完成 → 已关闭
-
-**可扩展功能（推理）：**
-- [ ] 采购合同管理：合同模板、合同审批流程
-- [ ] 采购合并发货：多个采购单合并发货
-- [ ] 采购退换货：向供应商退货处理
-- [ ] 采购报表：采购汇总、退货统计
-
-#### 供货能力配置页（SupplyCapabilityView.vue）— 实现度 40%
-**待完善任务：**
-- [ ] 列表：供应商、SKU、标准交期、MOQ、采购单位、阶梯价格、默认供货标记、状态
-- [ ] 新增/编辑配置弹窗：标准交期、MOQ、阶梯价格（起始数量 + 价格，支持多档）、结算币种、采购单位、备注
-- [ ] 设置默认供货后取消其他默认项
-- [ ] 交期和 MOQ 不可小于 0
-
-**可扩展功能（推理）：**
-- [ ] 供货能力预警：交期延长自动预警
-- [ ] 批量导入供货能力
-- [ ] 供货能力报表：按供应商统计
+- [ ] `Product` / `ProductSku` 实体 + 仓库
+- [ ] `ProductController` / `ProductSkuController`
+- [ ] `ProductService` - CRUD + 分页查询
+- [ ] `ChannelMapping` 实体 + 渠道SKU映射
 
----
+### 阶段3：渠道中心
 
-### 四、库存中心（需扩展）
-
-#### 库存总览页（InventoryOverviewView.vue）— 实现度 40%
-**待完善任务：**
-- [ ] 完整列表：SKU、商品标题、仓库、可用库存、锁定库存、在途库存、安全库存、预警状态、最近变动时间
-- [ ] 低于安全库存红色预警高亮
-- [ ] 点击库存数字进入变动明细抽屉
-- [ ] 手动调整库存弹窗（必须填写原因）
-- [ ] 创建补货建议
-
-**可扩展功能（推理）：**
-- [ ] 库存分布地图：可视化库存分布
-- [ ] 库存成本计算：加权平均成本
-- [ ] 库存冻结/解冻管理
-
-#### 发货作业页（ShippingWorkView.vue）— 实现度 40%
-**待完善任务：**
-- [ ] 发货单列表：发货单号、订单号、仓库、SKU 数、应发件数、实发件数、物流公司、运单号、发货状态、回传状态
-- [ ] 拣货/打包/录入运单号流程
-- [ ] 确认发货前必须填写物流公司和运单号
-- [ ] 实发和应发不一致时差异提示
-- [ ] 回传失败支持重试
-
-**可扩展功能（推理）：**
-- [ ] 面单批量打印
-- [ ] 批量发货确认
-- [ ] 发货异常处理
-
-#### 【新增】仓库管理页（WarehouseView.vue）
-**待实现功能：**
-- [ ] 仓库列表：仓库名称、仓库类型（自有/第三方）、地址、联系人、电话、状态
-- [ ] 新建/编辑仓库：仓库名称、类型、地址、联系人、联系方式、备注
-- [ ] 启用/停用仓库（停用前检查未处理订单）
-- [ ] 仓库详情：仓库面积、负责人、运营时间
-
-**可扩展功能（推理）：**
-- [ ] 仓库调拨单：调出仓库、调入仓库、SKU、数量、调拨时间、操作人
-- [ ] 调拨审批流程
-- [ ] 库位管理：库区、库位编码、库位类型（存储/拣货/退货）、容量
-- [ ] 库存盘点：定期盘点/抽检计划、盘点差异处理
-
-#### 【新增】库存变动记录页（InventoryLogView.vue）
-**待实现功能：**
-- [ ] 变动明细列表：SKU、仓库、变动类型（入库/出库/调拨/盘点）、变动数量、变动后库存、操作人、时间
-- [ ] 筛选区：SKU、仓库、变动类型、时间范围
-- [ ] 导出变动记录
-
-**可扩展功能（推理）：**
-- [ ] 库存快照：每日/每周/每月库存快照
-- [ ] 变动趋势图
-- [ ] 异常变动预警
+- [ ] `Channel` 实体 + 仓库
+- [ ] `ChannelController` / `ChannelService`
+- [ ] 渠道授权 Token 管理
 
----
+### 阶段4：仓库物流
 
-### 五、物流中心（需新增）
-
-#### 【新增】物流商配置页（LogisticsProviderView.vue）
-**待实现功能：**
-- [ ] 物流商列表：物流商名称、承运渠道、运费结算方式、状态
-- [ ] 新建/编辑物流商：物流商名称、承运渠道、时效配置、追踪URL模板
-- [ ] 启用/停用物流商
-
-**可扩展功能（推理）：**
-- [ ] 物流商分级：按服务质量评分
-- [ ] 物流商合同管理
-- [ ] 物流商绩效统计
-
-#### 【新增】运费模板页（ShippingTemplateView.vue）
-**待实现功能：**
-- [ ] 运费模板列表：模板名称、计费方式（按重量/按件数）、物流商、状态
-- [ ] 新建/编辑模板：模板名称、物流商、计费方式、首重/续重费用、偏远地区附加费
-- [ ] 地区分组配置：不同地区不同运费
-
-**可扩展功能（推理）：**
-- [ ] 运费模板复制
-- [ ] 批量应用模板到商品
-- [ ] 运费试算工具
-
-#### 【新增】退件管理页（ReturnPackageView.vue）
-**待实现功能：**
-- [ ] 退件列表：退件单号、原运单号、退件原因、退件状态、仓库、创建时间
-- [ ] 退件认领：扫描运单号、选择退件原因、录入包裹状态
-- [ ] 退件处理：可售/不可售、重新上架/销毁、质检结果
-
-**可扩展功能（推理）：**
-- [ ] 退件率统计：按渠道/商品/时间段统计
-- [ ] 退件原因分析
-- [ ] 退件处理时效监控
+- [ ] `Warehouse` 实体
+- [ ] `WarehouseController` / `WarehouseService`
+- [ ] `LogisticsProvider` 实体 + 物流商管理
+- [ ] `ShippingTemplate` 实体 + 运费模板
 
----
+### 阶段5：库存中心
 
-### 六、财务中心（需新增）
-
-#### 【新增】收款管理页（PaymentView.vue）
-**待实现功能：**
-- [ ] 收款列表：收款单号、渠道订单号、收款金额、币种、收款时间、渠道、店铺、对账状态
-- [ ] 筛选区：订单号、渠道、收款时间、对账状态、店铺
-- [ ] 对账确认：对账单下载、确认/驳回、差异说明
-- [ ] 收款汇总：按渠道/店铺/时间维度汇总
-
-**可扩展功能（推理）：**
-- [ ] 自动对账：系统自动匹配收款与订单
-- [ ] 收款差异处理
-- [ ] 跨境收款手续费配置
-
-#### 【新增】退款管理页（RefundView.vue）
-**待实现功能：**
-- [ ] 退款流水：退款单号、原订单号、退款金额、退款方式、退款时间、退款状态、渠道
-- [ ] 退款原因分析：退款原因分类统计、退款率趋势
-- [ ] 异常退款处理：退款失败重试、渠道回调异常
-
-**可扩展功能（推理）：**
-- [ ] 退款自动审批：低金额自动退款
-- [ ] 退款退回库存处理
-- [ ] 退款报表导出
-
-#### 【新增】供应商结算页（SupplierSettlementView.vue）
-**待实现功能：**
-- [ ] 结算单列表：结算单号、供应商、结算周期、应付金额、已付金额、状态
-- [ ] 创建结算单：选择供应商、采购单、付款条件
-- [ ] 应付账款：未结清账单、付款计划、付款凭证上传
-- [ ] 结算确认：核对金额、确认付款
-
-**可扩展功能（推理）：**
-- [ ] 自动结算：按账期自动生成结算单
-- [ ] 供应商预付款管理
-- [ ] 供应商对账差异处理
-
-#### 【新增】成本分析页（CostAnalysisView.vue）
-**待实现功能：**
-- [ ] SKU成本追踪：SKU、成本价、历史价格、成本趋势图
-- [ ] 利润分析：销售额、成本、毛利、利润率、按渠道/SPU/供应商维度
-- [ ] 成本异常预警：成本波动超过阈值自动预警
-
-**可扩展功能（推理）：**
-- [ ] 成本分摊：头程运费/平台费分摊到商品
-- [ ] 竞品价格监控
-- [ ] 利润目标设置与达成率
-
-#### 【新增】发票管理页（InvoiceView.vue）
-**待实现功能：**
-- [ ] 发票列表：发票号、发票类型（增票/普票）、购买方、销售方、金额、税率、状态
-- [ ] 开票申请：关联订单/采购单、选择开票类型、填写抬头信息
-- [ ] 发票抬头管理：企业信息维护、税号、开户行、账号
-
-**可扩展功能（推理）：**
-- [ ] 发票开具状态跟踪
-- [ ] 发票真伪验证
-- [ ] 发票电子化归档
-
-#### 【新增】资金流水页（FundFlowView.vue）
-**待实现功能：**
-- [ ] 资金流水列表：流水号、类型（收入/支出）、金额、账户、关联单据、时间、备注
-- [ ] 筛选区：类型、时间范围、账户、关联单据类型
-- [ ] 账户余额展示
-
-**可扩展功能（推理）：**
-- [ ] 资金预测：基于订单和退款预测未来资金
-- [ ] 账户冻结/解冻
-- [ ] 资金对账
+- [ ] `Inventory` 实体（available/locked/in_transit）
+- [ ] `InventoryController` / `InventoryService`
+- [ ] `InventoryLog` 实体（库存流水）
+- [ ] 库存锁定/解锁接口（给订单用）
+- [ ] 库存变动事务保证
 
----
+### 阶段6：供应商采购
 
-### 七、营销中心（需新增）
-
-#### 【新增】促销活动配置页（PromotionView.vue）
-**待实现功能：**
-- [ ] 促销活动列表：活动名称、活动类型（折扣/满减/买赠）、渠道、店铺、时间范围、状态
-- [ ] 创建活动：活动名称、类型、时间、适用商品/类目/渠道、优惠规则
-- [ ] 折扣叠加规则：与优惠券/会员价等的叠加逻辑
-
-**可扩展功能（推理）：**
-- [ ] 活动效果分析：参与率、销售额提升、ROI
-- [ ] 活动预热配置
-- [ ] 活动库存限制
-
-#### 【新增】优惠券管理页（CouponView.vue）
-**待实现功能：**
-- [ ] 优惠券列表：优惠券名称、类型（满减/折扣）、面值、发行量、核销量、有效时间、状态
-- [ ] 创建优惠券：名称、类型、面值/折扣率、使用条件、发放数量、领取方式
-- [ ] 优惠券发放：指定用户/用户等级、渠道/商品限制
-
-**可扩展功能（推理）：**
-- [ ] 优惠券核销统计：核销率、核销金额、来源渠道分析
-- [ ] 优惠券自动发放规则
-- [ ] 优惠券分享海报生成
-
-#### 【新增】价格预警页（PriceWatchView.vue）
-**待实现功能：**
-- [ ] 价格监控列表：SKU、商品标题、渠道、店铺、本系统价格、竞品价格、差价、预警状态
-- [ ] 竞品价格源配置：渠道平台URL、爬虫规则、刷新频率
-- [ ] 预警规则：差价阈值、降幅阈值、通知方式
-
-**可扩展功能（推理）：**
-- [ ] 价格调整建议：根据竞品自动计算建议售价
-- [ ] 价格历史记录
-- [ ] 批量价格调整
+- [ ] `Supplier` 实体 + 供应商管理
+- [ ] `SupplyCapability` 实体（供货能力/MOQ/阶梯价）
+- [ ] `PurchaseOrder` 实体 + 采购单 CRUD
+- [ ] `PurchaseOrderItem` 采购单明细
+- [ ] 采购单状态流转（DRAFT→APPROVED→PARTIAL_ARRIVAL→COMPLETED）
+- [ ] 到货确认接口（含库存增加+库存流水）
 
----
+### 阶段7：订单中心 ⭐核心
 
-### 八、采购中心（需扩展）
-
-#### 【新增】备货计划页（ReplenishmentPlanView.vue）
-**待实现功能：**
-- [ ] 备货建议列表：SKU、日均销量、安全库存、当前库存、在途量、建议补货量、建议供应商
-- [ ] 智能补货计算：基于销售预测、历史数据、季节性因素、交期
-- [ ] 一键生成采购单：选中SKU、确认数量、选择供应商
-
-**可扩展功能（推理）：**
-- [ ] 备货趋势图：库存覆盖率预测
-- [ ] 季节性备货建议
-- [ ] 大促期间备货预案
-
-#### 【新增】采购需求申请页（PurchaseRequestView.vue）
-**待实现功能：**
-- [ ] 需求申请列表：申请单号、申请人、SKU、数量、原因、状态、申请时间
-- [ ] 提交采购需求：SKU、数量、期望交期、紧急程度、原因
-- [ ] 审批流程：申请人提交 → 主管审批 → 采购执行
-
-**可扩展功能（推理）：**
-- [ ] 需求变更/撤销
-- [ ] 需求自动分配
-- [ ] 需求采购进度跟踪
-
-#### 【新增】来料质检页（IQCView.vue）
-**待实现功能：**
-- [ ] 质检单列表：质检单号、供应商、到货单号、质检标准、合格数、不合格数、质检结果
-- [ ] 质检标准配置：检验项目、检验方法、判定标准（AQL）
-- [ ] 质检执行：录入检验数据、自动判定合格/不合格
-
-**可扩展功能（推理）：**
-- [ ] 不良品处理：退货、降价接收、报废
-- [ ] 质检图片上传
-- [ ] 供应商质量评分
+- [ ] `Orders` 实体（60+字段全量）
+- [ ] `OrderItem` 订单明细
+- [ ] `OrderController` / `OrderService`
+- [ ] 订单状态流转（CREATED→PAID→ALLOCATED→SHIPPED→DELIVERED→COMPLETED）
+- [ ] **支付确认 → 订单状态更新**
+- [ ] **仓库分配 → 库存锁定**
+- [ ] **发货确认 → 库存变动+物流信息**
+- [ ] `ShippingOrder` 发货单
+- [ ] `OrderStatusEvent` 订单状态事件记录
 
----
+### 阶段8：售后中心
 
-### 九、客服中心（需扩展）
-
-#### 【新增】工单管理页（TicketView.vue）
-**待实现功能：**
-- [ ] 工单列表：工单号、标题、类型（咨询/投诉/售后/其他）、状态、优先级、创建人、创建时间
-- [ ] 创建工单：选择关联订单/售后单、填写问题描述、上传附件
-- [ ] 工单分配：按类型/渠道/优先级自动或手动分配
-- [ ] 工单处理：回复买家、处理记录、提交解决方案
-
-**可扩展功能（推理）：**
-- [ ] 工单质检：抽检已完结工单
-- [ ] 工单升级机制
-- [ ] 工单SLA监控
-
-#### 【新增】消息模板页（MessageTemplateView.vue）
-**待实现功能：**
-- [ ] 模板列表：模板名称、类型（邮件/短信/站内信）、渠道、状态
-- [ ] 创建模板：模板名称、类型、渠道、内容（支持变量占位符）
-- [ ] 变量配置：系统变量（订单号/买家名等）、自定义变量
-
-**可扩展功能（推理）：**
-- [ ] 自动回复规则：触发条件、回复模板、延迟设置
-- [ ] 模板使用统计
-- [ ] 多语言模板
-
-#### 【新增】满意度评价页（SatisfactionView.vue）
-**待实现功能：**
-- [ ] 评价列表：评价来源、订单号、买家、评分、评价内容、评价时间、客服
-- [ ] 评价分析：好评率、差评原因分类、评价趋势
-- [ ] 差评跟进：差评标记、处理状态、跟进记录
-
-**可扩展功能（推理）：**
-- [ ] 评价来源配置：渠道平台、评价链接
-- [ ] 评价自动回复
-- [ ] 评价奖励机制
+- [ ] `AfterSale` 实体
+- [ ] `AfterSaleController` / `AfterSaleService`
+- [ ] 售后审核通过/拒绝
+- [ ] **退款执行 → 订单退款状态更新**
+- [ ] **补发单生成 → 创建新订单（含original_order_id）**
 
----
+### 阶段9：财务中心
 
-### 十、数据中心（需扩展）
-
-#### 运营看板页（ReportDashboardView.vue）— 实现度 40%
-**待完善任务：**
-- [ ] 补充趋势图（引入 ECharts）：GMV、订单量趋势
-- [ ] 7 天 / 30 天切换
-- [ ] 指标卡点击下钻
-- [ ] 异常指标高亮
-
-**可扩展功能（推理）：**
-- [ ] 自定义看板配置
-- [ ] 目标达成率展示
-- [ ] 竞争对手对比
-
-#### 报表中心页（ReportCenterView.vue）— 实现度 40%
-**待完善任务：**
-- [ ] 报表类型选择（销售、库存、采购、售后等）
-- [ ] 切换报表类型时动态加载筛选项
-- [ ] 结果表格：指标名称、指标值、环比、同比、维度分组值
-- [ ] 导出 Excel / CSV
-
-**可扩展功能（推理）：**
-- [ ] 自定义报表配置
-- [ ] 报表订阅定时发送
-- [ ] 报表数据钻取
-
-#### 【新增】销售分析页（SalesAnalysisView.vue）
-**待实现功能：**
-- [ ] 核心指标：GMV、订单数、客单价、转化率、同比环比
-- [ ] 多维度分析：按渠道/国家/店铺/类目/品牌/SKU/时间段
-- [ ] 趋势分析：销售趋势、价格分布、销量排行
-
-**可扩展功能（推理）：**
-- [ ] 异常分析：销量突变、异常订单、趋势异常
-- [ ] 销售预测
-- [ ] 复购率分析
-
-#### 【新增】库存周转分析页（InventoryTurnoverView.vue）
-**待实现功能：**
-- [ ] 库存周转指标：周转天数、呆滞库存、动销率、库存覆盖天数
-- [ ] 滞销预警：设置滞销天数阈值、自动预警
-- [ ] 库龄分析：库存库龄分布、老库存预警
-
-**可扩展功能（推理）：**
-- [ ] 优化建议：基于数据分析给出清仓/补货建议
-- [ ] 库存预警规则配置
-- [ ] 库存快照对比
-
-#### 【新增】供应商绩效报表页（SupplierPerformanceView.vue）
-**待实现功能：**
-- [ ] 绩效指标：交期率、合格率、响应时效、退货率、价格竞争力
-- [ ] 综合评分：多维度加权计算供应商评分
-- [ ] 绩效趋势：历史绩效对比分析
-
-**可扩展功能（推理）：**
-- [ ] 供应商排名：按指标分类排名
-- [ ] 供应商分级应用
-- [ ] 供应商优化建议
+- [ ] `FinancePayment` 收款记录
+- [ ] `FinanceRefund` 退款记录
+- [ ] `FinanceController` / `FinanceService`
+- [ ] **对账确认 → 订单支付状态更新**
+- [ ] **退款执行 → 订单退款状态+金额更新**
+- [ ] `SupplierSettlement` 供应商结算
 
 ---
 
-### 十一、系统配置（需扩展）
-
-#### 角色权限页（RolePermissionView.vue）— 实现度 40%
-**待完善任务：**
-- [ ] 角色列表：角色名称、角色描述、用户数、启用状态、更新时间
-- [ ] 新建角色 / 编辑权限弹窗
-- [ ] 权限矩阵树：页面访问权限、按钮权限、数据范围权限、特殊操作权限
-- [ ] 复制角色（带出原权限配置）
-
-**可扩展功能（推理）：**
-- [ ] 权限审批流程
-- [ ] 批量角色分配
-- [ ] 角色使用统计
-
-#### 操作日志页（OperationLogView.vue）— 实现度 40%
-**待完善任务：**
-- [ ] 完整列表：操作时间、操作人、模块、操作动作、对象 ID、结果状态、来源 IP
-- [ ] 日志详情侧栏：变更前值、变更后值
-- [ ] 删除/取消/退款类操作标红
-
-**可扩展功能（推理）：**
-- [ ] 日志归档配置
-- [ ] 日志统计报表
-- [ ] 异常操作预警
-
-#### API Key管理页（ApiKeyView.vue）— 实现度 40%
-**待完善任务：**
-- [ ] Key 列表：Key 名称、所属系统、权限范围、状态、创建时间、过期时间、最近调用时间
-- [ ] 创建 Key 弹窗：Key 名称、所属系统、权限范围、IP 白名单、过期时间
-- [ ] 明文 Key 仅创建成功时展示一次
-
-**可扩展功能（推理）：**
-- [ ] Key使用统计
-- [ ] Key异常调用预警
-- [ ] 批量Key管理
-
-#### 【新增】员工管理页（EmployeeView.vue）
-**待实现功能：**
-- [ ] 员工列表：工号、姓名、部门、岗位、角色、手机号、状态、入职时间
-- [ ] 新建/编辑员工：基本信息、岗位、角色、汇报线
-- [ ] 员工档案：教育背景、工作经历、绩效记录
-
-**可扩展功能（推理）：**
-- [ ] 离职/转正/调动管理
-- [ ] 员工考勤集成
-- [ ] 员工绩效管理
-
-#### 【新增】部门管理页（DepartmentView.vue）
-**待实现功能：**
-- [ ] 组织架构图：树形展示部门层级
-- [ ] 部门管理：新建/编辑/删除部门、部门负责人
-- [ ] 部门权限：数据范围权限、部门内角色配置
-
-**可扩展功能（推理）：**
-- [ ] 部门成本统计
-- [ ] 部门人员分布
-- [ ] 部门KPI配置
-
-#### 【新增】消息中心页（NotificationView.vue）
-**待实现功能：**
-- [ ] 消息列表：消息类型（系统/业务/待办）、标题、内容、时间、状态（已读/未读）
-- [ ] 消息分类：系统通知、待办事项、站内信、公告
-- [ ] 消息订阅：按模块/类型订阅消息
-
-**可扩展功能（推理）：**
-- [ ] 提醒设置：邮件提醒、短信提醒、站内信提醒
-- [ ] 消息模板配置
-- [ ] 消息推送记录
-
-#### 【新增】审批流程配置页（ApprovalFlowView.vue）
-**待实现功能：**
-- [ ] 审批流程列表：流程名称、类型、审批节点数、状态
-- [ ] 新建/编辑流程：流程名称、类型、审批节点配置（审批人/审批方式/通过条件）
-- [ ] 审批节点配置：节点名称、审批人（指定人/角色/部门负责人）、审批方式（单人/会签/或签）
-
-**可扩展功能（推理）：**
-- [ ] 审批历史记录
-- [ ] 审批催办/撤回
-- [ ] 审批时效统计
-
-#### 【新增】数据字典配置页（DataDictionaryView.vue）
-**待实现功能：**
-- [ ] 字典分类列表：分类名称、分类编码、字典项数量
-- [ ] 字典项管理：字典码、字典值、排序、状态
-- [ ] 通用状态配置：订单状态、售后类型、退款原因等
-
-**可扩展功能（推理）：**
-- [ ] 字典导入导出
-- [ ] 字典使用统计
-- [ ] 字典联动配置
+## P1 业务闭环
 
----
+### 客服中心
+
+- [ ] `Ticket` 工单实体 + CRUD
+- [ ] 工单分配 / 回复 / 关闭
+- [ ] `Satisfaction` 满意度评价
 
-## 跨页面通用工作
+### 报表基础
 
-- [x] **补充 Mock API 路由** — 为所有 CRUD 操作补充 POST/PUT/DELETE 路由（在 mock/routes.ts 中）
-- [x] **补充 API Services** — 在 api/services.ts 中补充所有新增的接口调用方法
-- [x] **补充 TypeScript 类型** — 在 types/page.ts 中补充缺失的类型定义
-- [x] **引入 ECharts** — 为运营看板和报表中心添加图表支持（已在ReportDashboardView和ReportCenterView中集成）
-- [x] **新增页面注册路由** — 在 router/routes.ts 中注册新建的页面路由
-- [x] **更新菜单配置** — 在 router/menu.ts 中添加新页面的菜单项
-- [x] **移除 SpecPageRenderer** — 所有页面完成后移除 SpecPageRenderer 组件及相关引用（已废弃，不再需要）
+- [ ] 订单统计接口（按时段/渠道/国家）
+- [ ] 库存预警接口（低于安全库存）
+- [ ] 采购汇总接口
 
 ---
 
-## 实施优先级建议
+## P2 完善功能
+
+### 营销中心
 
-### 🔴 高优先级（第1阶段 - 核心链路必须先跑通）
+- [ ] `Promotion` 促销活动
+- [ ] `Coupon` 优惠券
+- [ ] `PriceWatch` 价格监控
 
-| 序号 | 模块 | 功能 | 原因 |
-|------|------|------|------|
-| 1 | 仓库管理 | 仓库档案、调拨单 | 库存模块基础，其他模块依赖 |
-| 2 | 物流商配置 | 物流商管理、运费模板 | 发货作业依赖 |
-| 3 | 收款管理 | 渠道收款对账 | 财务基础，业务闭环 |
-| 4 | 备货计划 | 智能补货建议 | 采购核心，降低库存成本 |
-| 5 | 工单管理 | 客服工单全流程 | 提升客户服务质量 |
+### 系统配置
 
-### 🟡 中优先级（第2阶段 - 业务效率提升）
+- [ ] `SysUser` / `SysRole` / `SysDepartment` 用户部门角色
+- [ ] `SysApiKey` API Key 管理
+- [ ] `SysOperationLog` 操作日志
+- [ ] `SysNotification` 消息通知
+- [ ] `SysApprovalFlow` 审批流程
 
-| 序号 | 模块 | 功能 | 原因 |
-|------|------|------|------|
-| 6 | 退件管理 | 退件处理流程 | 降低损失 |
-| 7 | 成本分析 | SKU成本追踪、利润分析 | 定价决策依据 |
-| 8 | 促销活动 | 活动配置和效果分析 | 提升销售额 |
-| 9 | 消息中心 | 系统通知和待办 | 提升协作效率 |
-| 10 | 库存周转 | 滞销预警、库龄分析 | 优化库存结构 |
+### AI客服
 
-### 🟢 低优先级（第3阶段 - 精细化运营）
+- [ ] `AiChannel` AI渠道配置
+- [ ] `KnowledgeBase` 知识库
+- [ ] `AutoReplyRule` 自动回复规则
+- [ ] `ChatSession` / `ChatMessage` 会话消息
+- [ ] `ServicePerformance` 客服绩效
 
-| 序号 | 模块 | 功能 | 原因 |
-|------|------|------|------|
-| 11 | 发票管理 | 发票开具和管理 | 合规需求 |
-| 12 | 员工管理 | 员工档案和绩效 | HR基础 |
-| 13 | 满意度评价 | 评价管理和分析 | 客户满意度 |
-| 14 | 优惠券管理 | 优惠券发放和核销 | 营销工具 |
-| 15 | 价格预警 | 竞品价格监控 | 竞争策略 |
+### 高级报表
+
+- [ ] 销售分析（GMV/转化率/客单价）
+- [ ] 库存周转分析
+- [ ] 供应商绩效
 
 ---
 
-## 总计待实现页面清单
-
-| 序号 | 页面名称 | 文件路径 | 优先级 |
-|------|---------|---------|--------|
-| 1 | 仓库管理 | WarehouseView.vue | P0 |
-| 2 | 库存变动记录 | InventoryLogView.vue | P0 |
-| 3 | 物流商配置 | LogisticsProviderView.vue | P0 |
-| 4 | 运费模板 | ShippingTemplateView.vue | P0 |
-| 5 | 退件管理 | ReturnPackageView.vue | P1 |
-| 6 | 收款管理 | PaymentView.vue | P0 |
-| 7 | 退款管理 | RefundView.vue | P1 |
-| 8 | 供应商结算 | SupplierSettlementView.vue | P1 |
-| 9 | 成本分析 | CostAnalysisView.vue | P1 |
-| 10 | 发票管理 | InvoiceView.vue | P2 |
-| 11 | 资金流水 | FundFlowView.vue | P1 |
-| 12 | 促销活动 | PromotionView.vue | P1 |
-| 13 | 优惠券管理 | CouponView.vue | P2 |
-| 14 | 价格预警 | PriceWatchView.vue | P2 |
-| 15 | 备货计划 | ReplenishmentPlanView.vue | P0 |
-| 16 | 采购需求申请 | PurchaseRequestView.vue | P1 |
-| 17 | 来料质检 | IQCView.vue | P1 |
-| 18 | 工单管理 | TicketView.vue | P0 |
-| 19 | 消息模板 | MessageTemplateView.vue | P1 |
-| 20 | 满意度评价 | SatisfactionView.vue | P2 |
-| 21 | 销售分析 | SalesAnalysisView.vue | P1 |
-| 22 | 库存周转分析 | InventoryTurnoverView.vue | P1 |
-| 23 | 供应商绩效 | SupplierPerformanceView.vue | P2 |
-| 24 | 员工管理 | EmployeeView.vue | P2 |
-| 25 | 部门管理 | DepartmentView.vue | P2 |
-| 26 | 消息中心 | NotificationView.vue | P1 |
-| 27 | 审批流程配置 | ApprovalFlowView.vue | P1 |
-| 28 | 数据字典配置 | DataDictionaryView.vue | P1 |
+## 数据库初始化
+
+- [ ] 创建 `oms` 数据库
+- [ ] 执行 `docs/OMS后端完整设计文档.md` 中的建表SQL
+- [ ] 初始化管理员账号（admin/admin123）
+
+---
+
+## 技术债务
+
+- [ ] 统一异常处理（`GlobalExceptionHandler`）
+- [ ] 统一响应包装（`ApiResponse` 已是）
+- [ ] 请求日志拦截器
+- [ ] 接口限流配置
+- [ ] 数据权限注解（租户隔离）
+- [ ] 审计字段自动填充（`CreatedBy` / `UpdatedBy`）