CrossBorder_OS/backend/CrossBorder_OS_PRD.md

CrossBorder OS（跨境运营中台）产品需求文档（PRD）

字段	内容
产品名称	CrossBorder OS（跨境运营中台）
文档版本	V1.0
创建日期	2026-04-19
文档状态	Draft
文档作者	产品团队
适用范围	首期（PIM / OMS / SRM / 渠道适配）

---

修订记录

版本	日期	修改人	修改内容
V1.0	2026-04-19	产品团队	初始版本创建

---

一、产品概述

1.1 产品定位

CrossBorder OS 是一套面向跨境电商企业的运营中台系统，核心目标为打通商品、订单、供应商三大业务域，统一接入 Shopify 与 TikTok Shop 两大销售渠道，形成完整的业务闭环：

商品 → 上架 → 下单 → 履约 → 回传 → 复盘

1.2 项目背景与意义

1.2.1 行业痛点

跨境电商企业日常运营面临以下核心问题：

痛点	具体表现
重复劳动	同一商品需在 Shopify、TikTok Shop 分别手动上架、改价、管理库存
数据割裂	订单散落在各平台后台，无法统一查看和处理
库存超卖	多渠道卖同一个 SKU，无统一库存锁定机制，极易超卖
采购盲目	库存预警靠人工盯，补货靠经验判断，容易断货或积压
财务糊涂	采购成本、物流成本、平台佣金分散在各个系统，利润算不清

1.2.2 项目价值

维度	没有这套系统	有了这套系统
上架效率	一个商品在两个平台各录一次	录一次，一键发布到多渠道
订单处理	登录多个平台后台分别发货	一个看板处理所有渠道订单
库存管理	Excel 记账，手动同步各平台库存	系统自动锁库存、同步、预警
补货决策	靠经验，容易断货或压货	安全库存预警 → 自动触发采购流程
数据复盘	各平台数据导出 Excel 手动汇总	统一报表，按渠道/SKU/国家多维分析
人力成本	运营、采购、仓库各干各的，信息滞后	全链路打通，减少沟通成本与出错率

1.2.3 核心理念

这是一套让跨境卖家从"多平台手动搬砖"升级为"中台自动化运营"的基础设施。

把分散在 Shopify、TikTok Shop 等平台的商品、订单、库存、采购数据统一收敛到一个中台，用标准化流程替代人工操作，让企业可以规模化地多渠道经营而不会被人效拖垮。

1.2.4 商业价值

• 小团队做大生意 — 用系统替代人力，3-5 人团队也能管理多渠道、多国家的业务
• 从卖货到做品牌 — 系统兜底运营效率，团队精力释放到品牌建设和产品开发上
• 数据资产沉淀 — 全链路数字化意味着数据可追溯、业务可审计，为融资/并购提供数据基础

1.3 产品目标

目标维度	描述
统一管理	一套商品数据驱动多渠道上架，避免多平台重复维护
流程闭环	从采购补货到订单履约全链路数字化，降低人工干预
数据驱动	通过核心指标与报表辅助运营决策，提升库存周转与发货时效
可扩展性	架构层面预留渠道扩展能力，后续可快速接入新平台

1.4 用户角色

角色	职责描述	核心使用场景
运营	负责商品上架、价格调整、活动管理	商品发布、渠道映射、定价管理
采购	负责供应商对接、下单补货	采购单管理、到货确认、成本记录
仓库	负责拣货、打包、发货	发货单处理、运单录入、库存盘点
客服	负责订单查询、售后处理	订单状态查询、退款/退货/换货处理
管理者	负责全盘数据监控与决策	报表查看、指标分析

---

二、范围定义

2.1 In Scope（首期交付）

模块	说明
PIM（商品中台）	SPU/SKU 建模、多语言、渠道映射、定价
OMS（订单中台）	多渠道订单接入、拆合单、状态机、售后
SRM（供应商中心）	供应商档案、采购单、供货能力管理
Channel Adapter	Shopify / TikTok Shop 商品与订单双向同步
基础 WMS 对接	库存读写、库存锁定与释放
发货回传	发货状态与物流单号回传至销售平台

2.2 Out of Scope（后续迭代）

• 财务结算（ERP 对接）
• 广告投放管理
• 全量海外仓系统（首期仅对接国内仓）

---

三、功能模块总览

CrossBorder OS
├── 1. 商品中心（PIM）
│   ├── 1.1 商品建模
│   ├── 1.2 商品管理
│   ├── 1.3 渠道映射
│   └── 1.4 定价与库存
├── 2. 订单中心（OMS）
│   ├── 2.1 订单接入
│   ├── 2.2 订单处理
│   ├── 2.3 订单状态机
│   └── 2.4 售后管理
├── 3. 供应商中心（SRM）
│   ├── 3.1 供应商管理
│   ├── 3.2 采购管理
│   └── 3.3 供货能力
├── 4. 渠道中心（Adapter）
│   ├── 4.1 Shopify Adapter
│   └── 4.2 TikTok Shop Adapter
├── 5. 库存与履约
│   ├── 5.1 库存管理
│   └── 5.2 发货管理
├── 6. 数据与报表
│   ├── 6.1 核心指标
│   └── 6.2 报表中心
└── 7. 系统与权限
    ├── 7.1 RBAC 权限
    ├── 7.2 操作日志
    └── 7.3 API Key 管理

3.1 页面拆分说明

为避免“功能模块”与“实际界面”之间的理解偏差，首期产品建议按页面级进行拆分。
基于当前 In Scope 范围，本系统首期建议设计为 18 个界面，其中：

• 15 个业务操作界面
• 3 个系统管理界面

页面拆分的原则如下：

• 一个模块可以对应多个界面，例如“订单中心”会拆分为订单列表、订单详情/处理、售后处理等界面
• 技术能力型模块不强制独立成界面，例如状态机、Webhook、库存锁定更适合作为后台能力体现
• 页面设计优先围绕用户任务展开，确保运营、采购、仓库、客服、管理者都能按流程完成工作

3.2 页面清单与功能说明

序号	界面名称	所属模块	主要功能说明
1	商品列表页	商品中心（PIM）	查看商品列表，按类目、状态、渠道筛选，支持批量上下架、批量导入、快速进入编辑页
2	商品新建/编辑页	商品中心（PIM）	创建 SPU/SKU，维护标题、属性、图片、视频、多语言信息，配置规格组合
3	渠道映射页	商品中心（PIM）	将内部 SKU 映射到 Shopify/TikTok 渠道 SKU，配置类目映射、属性映射，执行发布前校验
4	定价与库存规则页	商品中心（PIM）	配置多币种价格、渠道价、安全库存阈值，维护商品维度的价格与库存规则
5	订单列表页	订单中心（OMS）	汇总查看所有渠道订单，按订单状态、渠道、异常标记筛选，支持进入订单处理
6	订单详情/处理页	订单中心（OMS）	查看订单明细、商品、收货信息、支付信息，支持拆单、合单、备注、手动处理异常订单
7	售后处理页	订单中心（OMS）	处理退款、退货、换货申请，记录审核结果，并联动渠道退款或补发流程
8	供应商管理页	供应商中心（SRM）	维护供应商档案、联系人、合作状态、合同信息、评级信息
9	采购单管理页	供应商中心（SRM）	创建采购单（PO），关联供应商与 SKU，管理采购状态、到货确认、差异记录、采购成本
10	供货能力配置页	供应商中心（SRM）	维护供应商对 SKU 的交期、MOQ、阶梯价格，为补货与成本分析提供依据
11	渠道接入配置页	渠道中心（Adapter）	配置 Shopify、TikTok Shop 店铺授权、API 参数、Webhook、同步状态与异常提示
12	库存总览页	库存与履约	查看可用库存、锁定库存、安全库存、预警状态，支持按仓库、SKU、渠道维度查询
13	发货作业页	库存与履约	生成和查看发货单，支持仓库拣货、打包、录入物流单号与物流公司，并触发发货回传
14	运营看板页	数据与报表	查看 GMV、订单量、库存周转、发货时效等核心经营指标，供管理层和运营快速复盘
15	报表中心页	数据与报表	按渠道、SKU、国家、时间范围查看和导出报表，用于经营分析与复盘
16	角色权限页	系统与权限	按角色配置模块权限和操作权限，控制不同岗位可见范围与可操作能力
17	操作日志页	系统与权限	查询系统内关键操作记录，按模块、操作人、时间范围进行追溯
18	API Key 管理页	系统与权限	管理系统对接所需的 API Key，支持创建、停用、轮换与权限范围控制

3.3 页面之间的衔接关系

为了让模块衔接更清楚，可以把核心业务理解为以下三条页面链路：

1. 商品上架链路

供货能力配置页/供应商管理页 → 商品新建/编辑页 → 渠道映射页 → 渠道接入配置页 → 商品列表页（查看发布结果）

说明：

• 采购先维护供应商与 SKU 供货条件
• 运营创建商品并完善商品资料
• 运营完成渠道映射并执行平台校验
• 系统通过渠道接入配置完成发布
• 发布后可回到商品列表页查看上架状态

2. 订单履约链路

渠道接入配置页 → 订单列表页 → 订单详情/处理页 → 库存总览页 → 发货作业页 → 订单列表页/订单详情页

说明：

• 订单先通过渠道接入能力进入系统
• 运营或客服在订单列表中识别待处理订单
• 在订单详情页完成异常处理、拆单、合单等动作
• 系统联动库存能力锁定或释放库存
• 仓库在发货作业页完成发货并录入运单
• 发货结果回写后，订单状态在订单列表和详情页可继续跟踪

3. 补货链路

库存总览页（预警） → 采购单管理页 → 供应商管理页/供货能力配置页 → 到货入库 → 库存总览页

说明：

• 系统在库存总览页中呈现低库存预警
• 采购根据预警创建采购单
• 采购过程中需要结合供应商信息与供货能力参数决策
• 到货确认后库存更新，回到库存总览页查看预警是否解除

3.4 页面结构建议

从导航设计角度，建议左侧一级菜单直接按页面聚合为以下结构：

• 商品中心：商品列表、商品新建/编辑、渠道映射、定价与库存规则
• 订单中心：订单列表、订单详情/处理、售后处理
• 供应商中心：供应商管理、采购单管理、供货能力配置
• 渠道中心：渠道接入配置
• 库存与履约：库存总览、发货作业
• 数据与报表：运营看板、报表中心
• 系统与权限：角色权限、操作日志、API Key 管理

以上拆分可作为后续原型、菜单结构、权限点设计和开发任务拆分的直接依据。

3.5 页面级功能明细

以下内容用于把“页面”进一步细化到原型和开发可执行层面。每个页面至少需要明确页面目标、核心区域、关键字段和主要操作按钮。

3.5.1 商品中心（PIM）

界面 1：商品列表页

• 页面目标：集中查看商品状态，并作为商品编辑、上下架、导入、发布的统一入口
• 核心区域：顶部筛选区、商品列表区、批量操作区、快捷统计区
• 关键字段：SPU 编号、SKU 编号、商品标题、类目、渠道状态、上架状态、价格、库存、更新时间
• 主要按钮：新建商品、批量导入、批量上架、批量下架、导出、查看详情、编辑、进入渠道映射

界面 2：商品新建/编辑页

• 页面目标：完成商品主数据录入，生成可用于渠道发布的标准化 SPU/SKU 数据
• 核心区域：基础信息区、规格组合区、图片视频区、多语言区、物流属性区、保存发布区
• 关键字段：商品标题、商品副标题、类目、品牌、属性模板、规格项、SKU 编码、条码、重量、尺寸、主图、详情图、视频、多语言文案
• 主要按钮：保存草稿、保存并继续编辑、新增 SKU、删除 SKU、上传图片、上传视频、预览、提交校验

界面 3：渠道映射页

• 页面目标：建立内部商品与外部渠道商品的映射关系，并在发布前完成类目和属性校验
• 核心区域：商品选择区、渠道选择区、类目映射区、属性映射区、校验结果区、发布记录区
• 关键字段：内部 SKU、目标渠道、渠道店铺、渠道类目、渠道属性、渠道标题、渠道图片、渠道 SKU 编码、映射状态、校验结果
• 主要按钮：新增映射、自动映射、保存映射、执行校验、发布到渠道、同步更新、查看失败原因

界面 4：定价与库存规则页

• 页面目标：维护商品在不同渠道和币种下的价格规则，以及安全库存和预警参数
• 核心区域：价格规则区、渠道定价区、汇率参考区、安全库存区、规则变更记录区
• 关键字段：SKU、币种、基准售价、渠道售价、折扣价、汇率、仓库、安全库存阈值、预警开关、生效时间
• 主要按钮：新增价格规则、批量调价、保存规则、启用、停用、导入规则、查看变更记录

3.5.2 订单中心（OMS）

界面 5：订单列表页

• 页面目标：统一查看各渠道订单，并识别待处理、异常、待发货等重点订单
• 核心区域：筛选检索区、订单列表区、异常标记区、批量操作区
• 关键字段：订单号、渠道订单号、渠道来源、买家信息、订单状态、支付状态、发货状态、金额、下单时间、异常标签
• 主要按钮：查看详情、批量标记、导出订单、刷新同步、分配处理人、进入售后

界面 6：订单详情/处理页

• 页面目标：处理单笔订单的履约动作和异常动作，沉淀订单全生命周期信息
• 核心区域：订单摘要区、商品明细区、收货信息区、支付信息区、状态流转区、操作记录区、备注区
• 关键字段：订单状态、订单商品、SKU、数量、收货人、地址、联系方式、支付方式、支付时间、仓库、运费、备注、风险标识
• 主要按钮：拆单、合单、锁定库存、释放库存、修改备注、取消订单、提交仓库、查看日志

界面 7：售后处理页

• 页面目标：统一处理退款、退货、换货请求，并联动订单和渠道状态
• 核心区域：售后单列表区、申请信息区、审核处理区、退款信息区、物流跟踪区
• 关键字段：售后单号、关联订单号、售后类型、申请原因、申请金额、审核状态、退款方式、退货物流单号、入库状态
• 主要按钮：审核通过、审核拒绝、发起退款、确认收货、生成补发单、关闭售后、查看原订单

3.5.3 供应商中心（SRM）

界面 8：供应商管理页

• 页面目标：维护供应商基础档案，作为采购、补货、成本核算的基础数据入口
• 核心区域：供应商列表区、基础信息区、联系人区、合同信息区、评级记录区
• 关键字段：供应商名称、联系人、联系方式、地址、合作状态、结算方式、合同编号、合同有效期、评级结果
• 主要按钮：新建供应商、编辑、启用、停用、上传合同、更新评级、查看关联采购单

界面 9：采购单管理页

• 页面目标：完成采购单创建、跟进、到货确认和采购成本记录
• 核心区域：采购单列表区、采购单表头区、SKU 明细区、到货确认区、成本记录区、状态流转区
• 关键字段：采购单号、供应商、采购 SKU、采购数量、采购单价、预计交期、实到数量、差异数量、运费、关税、采购状态
• 主要按钮：创建采购单、提交审批、通知供应商、确认到货、录入差异、关闭采购单、导出采购单

界面 10：供货能力配置页

• 页面目标：维护供应商对商品的供货约束条件，为补货决策提供参数支持
• 核心区域：供应商选择区、SKU 供货能力列表区、交期配置区、MOQ 配置区、阶梯价格区
• 关键字段：供应商、SKU、标准交期、最小起订量、价格区间、采购单位、默认供货标记、最近更新时间
• 主要按钮：新增配置、批量导入、保存、设为默认供应商、停用配置、查看历史报价

3.5.4 渠道中心（Adapter）

界面 11：渠道接入配置页

• 页面目标：管理外部渠道授权、接口配置、Webhook 状态和同步任务状态
• 核心区域：渠道账户列表区、授权信息区、接口配置区、Webhook 配置区、同步状态区、异常提示区
• 关键字段：渠道名称、店铺名称、授权状态、API Key、Webhook 地址、最后同步时间、同步结果、错误信息
• 主要按钮：新增店铺授权、重新授权、保存配置、测试连接、启用同步、停用同步、查看同步日志

3.5.5 库存与履约

界面 12：库存总览页

• 页面目标：统一查看库存分布、锁定情况和预警情况，作为补货和履约判断依据
• 核心区域：库存筛选区、库存列表区、预警区、库存变动记录区
• 关键字段：SKU、仓库、可用库存、锁定库存、在途库存、安全库存、预警状态、最近出入库时间
• 主要按钮：查看明细、手动调整、导出库存、创建补货建议、查看库存日志

界面 13：发货作业页

• 页面目标：让仓库完成发货单处理，并把物流结果回传至订单和渠道
• 核心区域：待发货列表区、发货单详情区、拣货信息区、打包信息区、物流录入区、回传结果区
• 关键字段：发货单号、关联订单号、仓库、SKU、应发数量、实发数量、物流公司、运单号、发货状态、回传状态
• 主要按钮：生成发货单、开始拣货、确认打包、录入运单号、确认发货、回传平台、打印面单

3.5.6 数据与报表

界面 14：运营看板页

• 页面目标：给运营和管理层提供经营总览，快速识别订单、库存、履约等关键异常
• 核心区域：指标卡片区、趋势图区、渠道对比区、预警提示区、快捷入口区
• 关键字段：GMV、订单量、支付转化、发货时效、退款率、库存周转天数、低库存商品数、异常订单数
• 主要按钮：切换时间范围、切换渠道、查看明细报表、导出截图、跳转订单列表、跳转库存页

界面 15：报表中心页

• 页面目标：支持经营数据按不同维度分析、筛选、导出
• 核心区域：报表目录区、查询条件区、结果表格区、图表区、导出区
• 关键字段：报表类型、时间范围、渠道、国家、SKU、供应商、仓库、指标项、汇总口径
• 主要按钮：生成报表、保存筛选条件、导出 Excel、导出 CSV、订阅报表

3.5.7 系统与权限

界面 16：角色权限页

• 页面目标：按角色控制用户可访问页面和可执行操作，保障岗位分工和操作安全
• 核心区域：角色列表区、权限矩阵区、用户绑定区、变更记录区
• 关键字段：角色名称、角色描述、模块权限、操作权限、绑定用户数、启用状态
• 主要按钮：新建角色、编辑权限、复制角色、启用、停用、绑定用户、保存权限

界面 17：操作日志页

• 页面目标：追溯关键业务和系统操作，满足审计与问题定位需求
• 核心区域：筛选区、日志列表区、日志详情侧栏
• 关键字段：操作时间、操作人、所属模块、操作类型、对象 ID、变更前内容、变更后内容、来源 IP
• 主要按钮：查询、重置筛选、导出日志、查看详情

界面 18：API Key 管理页

• 页面目标：统一管理内部或外部系统调用所需的 API Key，并控制安全策略
• 核心区域：Key 列表区、Key 详情区、权限范围区、调用记录区
• 关键字段：Key 名称、所属系统、权限范围、状态、创建时间、过期时间、最近调用时间
• 主要按钮：创建 Key、复制 Key、停用、启用、轮换 Key、删除、查看调用记录

3.6 原型输出建议

为了便于后续推进，建议原型阶段至少对以下内容逐页产出：

• 页面名称与页面目标
• 页面布局草图
• 筛选区字段
• 列表区字段
• 详情区字段
• 主要按钮与操作说明
• 页面跳转关系
• 异常状态与空状态说明

如需进一步细化，下一版可继续补充每个页面的字段校验规则、按钮权限规则和状态变化规则。

3.7 页面字段级交互说明

本节用于补充页面原型设计时的字段级交互要求。字段级说明重点覆盖 4 类内容：

• 筛选字段：用户如何查找目标数据
• 列表字段：用户在列表页最需要快速判断的信息
• 表单字段：用户录入或修改信息时的输入项
• 交互规则：按钮触发、字段联动、校验提示、状态反馈

3.7.1 商品列表页

• 筛选字段：商品标题/关键词、SPU 编号、SKU 编号、类目、品牌、渠道、上架状态、创建时间、更新时间
• 列表字段：主图、商品标题、SPU、SKU 数量、类目、渠道发布状态、总库存、价格区间、负责人、更新时间
• 行内操作：查看、编辑、复制商品、上下架、进入映射、查看发布日志
• 交互规则：选择类目后保留其他筛选条件；批量上架/下架仅对勾选数据生效；存在未完善字段的商品显示“待完善”标签；导入完成后展示成功/失败数量并支持下载失败明细

3.7.2 商品新建/编辑页

• 基础字段：商品标题、商品副标题、类目、品牌、商品标签、属性模板、商品简介
• SKU 字段：SKU 编码、规格值、条码、成本价、建议售价、重量、尺寸、包装尺寸
• 媒体字段：主图、附图、详情图、视频、图片排序、图片 alt 文案
• 多语言字段：语言版本、标题翻译、卖点翻译、详情翻译
• 交互规则：选择类目后自动带出属性模板；新增规格后自动生成 SKU 组合；删除规格值时提示影响的 SKU 数量；主图必填；保存草稿允许缺少非必填字段，提交校验必须通过必填校验；离开未保存页面时弹出确认提示

3.7.3 渠道映射页

• 筛选字段：商品标题、内部 SKU、渠道、店铺、映射状态、校验状态
• 列表字段：内部 SKU、渠道 SKU、渠道类目、店铺、映射状态、最近同步时间、最近校验结果
• 表单字段：目标渠道、目标店铺、渠道类目、渠道属性映射、渠道标题、渠道描述、渠道主图、渠道价格
• 交互规则：切换渠道后动态刷新类目和属性模板；未完成类目映射前不可提交发布；校验失败字段需在字段旁展示错误原因；支持“自动映射后人工修正”；发布成功后记录平台返回 ID

3.7.4 定价与库存规则页

• 筛选字段：SKU、渠道、币种、仓库、规则状态
• 列表字段：SKU、币种、基准售价、渠道售价、折扣价、生效时间、安全库存、规则状态、最近修改人
• 表单字段：币种、基础售价、渠道加价/减价规则、促销价、汇率来源、仓库、安全库存阈值、预警接收人、生效时间、失效时间
• 交互规则：选择渠道后展示该渠道专属价格字段；促销价不得高于渠道售价；生效时间晚于当前时间时进入“待生效”状态；保存时生成变更记录；批量调价支持按百分比或固定金额调整

3.7.5 订单列表页

• 筛选字段：订单号、渠道订单号、渠道、买家姓名、订单状态、支付状态、发货状态、异常标签、下单时间、仓库
• 列表字段：订单号、渠道、买家、订单金额、商品件数、支付状态、订单状态、发货状态、仓库、异常标签、下单时间
• 行内操作：查看详情、分配处理人、添加标签、导出、进入售后
• 交互规则：异常订单高亮显示；筛选条件支持保存为常用视图；刷新同步后提示新增/更新订单数；勾选多条订单后才显示批量操作栏

3.7.6 订单详情/处理页

• 展示字段：订单基础信息、支付信息、商品清单、仓库分配、收货地址、物流信息、订单备注、操作日志
• 操作字段：取消原因、异常标签、人工备注、仓库选择、拆单方案、合单目标订单、客服备注
• 交互规则：订单状态不同，按钮权限不同；取消订单需二次确认并填写原因；拆单时必须明确 SKU 与数量归属；修改地址后需记录修改前后值；锁定库存成功后状态更新为 allocated；所有人工处理动作写入日志

3.7.7 售后处理页

• 筛选字段：售后单号、订单号、售后类型、审核状态、退款状态、申请时间
• 列表字段：售后单号、订单号、买家、售后类型、申请金额、审核状态、退款状态、最近更新时间
• 表单字段：售后原因、责任归属、退款金额、退款方式、退货物流单号、补发仓库、补发 SKU、审核备注
• 交互规则：退款金额不得超过实付金额；部分退款需显示剩余可退额度；退货入库后才可完结“退货退款”类售后；换货通过后自动生成补发任务；拒绝售后必须填写原因

3.7.8 供应商管理页

• 筛选字段：供应商名称、联系人、合作状态、评级、创建时间
• 列表字段：供应商名称、联系人、手机号、合作状态、结算方式、评级、关联 SKU 数、最后更新时间
• 表单字段：供应商名称、公司名称、联系人、电话、邮箱、地址、开户信息、税号、合同编号、合同附件、结算方式、备注
• 交互规则：供应商名称不可重复；手机号和邮箱需格式校验；停用供应商前需检查是否存在未完成采购单；上传合同后保留版本记录

3.7.9 采购单管理页

• 筛选字段：采购单号、供应商、采购状态、SKU、创建时间、预计交期
• 列表字段：采购单号、供应商、SKU 数、采购总额、预计交期、到货进度、采购状态、创建人
• 表单字段：供应商、仓库、采购 SKU、采购数量、采购单价、币种、税费、运费、预计交期、备注
• 到货字段：实到数量、良品数量、差异数量、差异原因、入库时间、签收人
• 交互规则：选定供应商后带出默认交期和 MOQ；采购数量低于 MOQ 时提示但允许提交审批；确认到货后自动更新库存；关闭采购单需校验未完成到货记录

3.7.10 供货能力配置页

• 筛选字段：供应商、SKU、默认供货标记、状态
• 列表字段：供应商、SKU、标准交期、MOQ、采购单位、阶梯价格、默认供货标记、状态
• 表单字段：标准交期、MOQ、阶梯价格起始数量、阶梯价格、结算币种、采购单位、备注
• 交互规则：同一供应商同一 SKU 允许存在多档阶梯价格；设置默认供货后需取消其他默认项；交期和 MOQ 不可小于 0；保存后同步用于补货建议计算

3.7.11 渠道接入配置页

• 列表字段：渠道名称、店铺名称、授权状态、同步状态、最近同步时间、异常状态
• 表单字段：店铺名称、App Key、App Secret、Access Token、Webhook 地址、Webhook Secret、同步开关、默认仓库、备注
• 交互规则：测试连接成功后才允许启用同步；重新授权前保留旧配置快照；Webhook 地址支持一键复制；接口报错需展示最近一次错误信息和发生时间

3.7.12 库存总览页

• 筛选字段：SKU、仓库、渠道、预警状态、库存状态
• 列表字段：SKU、商品标题、仓库、可用库存、锁定库存、在途库存、安全库存、预警状态、最近变动时间
• 详情字段：出入库来源、关联订单/采购单、操作人、变动数量、变动后库存
• 交互规则：低于安全库存时显示红色预警；点击库存数字进入变动明细；手动调整库存需填写原因；创建补货建议时自动带入默认供应商与建议数量

3.7.13 发货作业页

• 筛选字段：发货单号、订单号、仓库、发货状态、回传状态、创建时间
• 列表字段：发货单号、订单号、仓库、SKU 数、应发件数、实发件数、物流公司、运单号、发货状态、回传状态
• 表单字段：拣货人、打包人、物流公司、运单号、包裹重量、包裹尺寸、备注
• 交互规则：确认发货前必须填写物流公司和运单号；实发数量与应发数量不一致时需给出差异提示；回传失败支持重试；打印面单前校验地址完整性

3.7.14 运营看板页

• 过滤字段：时间范围、渠道、国家、店铺、仓库
• 展示字段：GMV、支付订单数、客单价、退款率、发货及时率、低库存商品数、异常订单数
• 交互规则：指标卡支持点击下钻；趋势图默认展示近 7 天，可切换近 30 天；异常指标高亮；点击低库存商品数跳转库存总览页并自动带入筛选

3.7.15 报表中心页

• 查询字段：报表类型、统计口径、时间范围、渠道、店铺、SKU、供应商、仓库、国家
• 结果字段：指标名称、指标值、环比、同比、维度分组值
• 交互规则：切换报表类型时动态加载对应筛选项；导出前保留当前筛选条件；超大报表使用异步导出并在完成后通知用户；支持保存个人常用报表视图

3.7.16 角色权限页

• 列表字段：角色名称、角色描述、用户数、启用状态、更新时间
• 权限字段：页面访问权限、按钮权限、数据范围权限、特殊操作权限
• 交互规则：复制角色时带出原权限配置；停用角色前校验是否仍绑定用户；保存权限后实时生效或提示重新登录策略；高风险权限需二次确认

3.7.17 操作日志页

• 筛选字段：操作人、模块、操作类型、时间范围、对象 ID
• 列表字段：操作时间、操作人、模块、操作动作、对象 ID、结果状态、来源 IP
• 详情字段：变更前值、变更后值、请求来源、备注
• 交互规则：支持按对象 ID 快速定位单据全链路日志；删除、取消、退款类操作应标红显示；日志详情优先展示关键变更字段

3.7.18 API Key 管理页

• 列表字段：Key 名称、所属系统、权限范围、状态、创建时间、过期时间、最近调用时间
• 表单字段：Key 名称、所属系统、权限范围、IP 白名单、过期时间、备注
• 交互规则：Key 明文仅在创建成功时展示一次；复制 Key 需再次身份确认；轮换 Key 后旧 Key 可设置过渡失效时间；停用/删除操作需二次确认

3.8 通用交互与状态说明

为保证所有界面体验一致，建议全系统遵循以下通用交互规则：

• 必填字段使用统一标识，失焦后即时校验，提交时再次统一校验
• 列表页筛选条件在用户返回页面时默认保留
• 所有批量操作必须显示影响条数和结果反馈
• 高风险操作如删除、取消、退款、停用必须二次确认
• 异步任务如导入、导出、发布、同步需提供处理状态和失败原因
• 空状态页面应提供下一步建议，例如“去创建商品”“去配置店铺授权”
• 权限不足时按钮置灰，并提示无权限原因
• 关键业务动作写入操作日志，便于追溯
• 表格列支持基础排序与自定义显示/隐藏
• 重要状态使用统一颜色语义：成功、进行中、警告、失败

以上字段级说明可作为低保真原型、UI 设计稿、接口设计和测试用例编写的共同基线。

---

四、详细功能设计

4.1 商品中心（PIM）

4.1.1 商品建模

功能点	说明	优先级
SPU/SKU 结构	SPU 为商品聚合层，SKU 为最小售卖单元（颜色+尺码等维度组合）	P0
属性模型	基于类目模板定义通用属性与特有属性，支持自定义属性扩展	P0
多语言支持	商品信息支持 EN / JP / EU 多语言，按渠道/地区下发对应语言	P1

数据模型（简化）：

SPU
├── spu_id           (SPU唯一标识)
├── title            (多语言)
├── category_id      (类目)
├── attributes       (通用属性集合)
└── sku_list[]
    ├── sku_id       (SKU唯一标识)
    ├── spec_values  (规格值，如 color=Red, size=M)
    ├── barcode      (条形码)
    ├── weight       (重量)
    └── dimensions   (尺寸)

4.1.2 商品管理

功能点	说明	优先级
创建/编辑	支持新建商品、编辑商品信息、修改 SKU 规格	P0
上下架	支持商品级别的上下架操作，可批量处理	P0
图片/视频	支持上传多张图片与视频，按顺序排列，支持设置主图	P0
批量导入	支持通过 CSV 文件批量导入商品数据，提供标准模板下载	P1

4.1.3 渠道映射

功能点	说明	优先级
SKU → Shopify 映射	将内部 SKU 映射为 Shopify Product Variant，同步标题/图片/价格/库存	P0
SKU → TikTok 映射	将内部 SKU 映射为 TikTok SKU，同步商品属性	P0
类目映射	内部类目与平台类目映射，TikTok 需强校验类目合规性	P0

映射规则说明：

• 一个内部 SKU 可映射到多个渠道 SKU
• 映射关系建立后，商品信息的变更（标题/图片/价格）可自动或手动同步至对应渠道
• TikTok Shop 对类目与属性有严格校验，映射前需完成合规检查

4.1.4 定价与库存

功能点	说明	优先级
多币种价格	SKU 支持设置多币种售价（USD / EUR / JPY 等），基于汇率换算	P0
渠道价	同一 SKU 可按渠道设置不同售价，支持独立定价策略	P1
安全库存	每个仓库/SKU 可设置安全库存阈值，低于阈值触发补货预警	P1

---

4.2 订单中心（OMS）

4.2.1 订单接入

功能点	说明	优先级
Shopify Webhook	接收 Shopify 订单创建/更新/取消 Webhook，自动同步至 OMS	P0
TikTok Webhook/API	通过 TikTok Shop API 拉取订单，支持 Webhook 实时推送	P0
幂等处理	基于 Order ID + Channel 做幂等校验，防止重复订单	P0

4.2.2 订单处理

功能点	说明	优先级
拆单	一个订单中包含多个仓库的 SKU 时，自动拆分为多个发货单	P0
合单	同一用户、同一收货地址的多个订单可合并发货，降低物流成本	P1
风控标记	系统自动标记异常订单（地址异常、金额异常、高频下单等）	P1
手动处理	运营/客服可手动介入处理异常订单，添加备注与标签	P0

4.2.3 订单状态机（核心）

订单状态流转是 OMS 的核心逻辑，定义如下：

                        ┌──────────┐
                        │ cancelled│
                        └────▲─────┘
                             │ (任意阶段可取消)
┌─────────┐    ┌──────┐    ┌┴────────┐    ┌────────┐    ┌──────────┐    ┌──────────┐
│ created │───▶│ paid │───▶│allocated│───▶│shipped │───▶│ delivered│───▶│completed │
└─────────┘    └──────┘    └─────────┘    └────────┘    └──────────┘    └──────────┘
                               │                                              │
                               │         ┌───────────┐                        │
                               └────────▶│ refunded  │◀───────────────────────┘
                                         └───────────┘

状态	触发条件	说明
created	接收到渠道订单	订单创建，待支付
paid	支付回调确认	支付完成
allocated	库存锁定成功	已分配库存
shipped	物流单号录入并发货	已发货
delivered	物流状态更新为已签收	已签收
completed	签收后超时无售后请求或手动确认	订单完结
cancelled	取消操作（任意阶段）	已取消
refunded	退款/退货审核通过	已退款

状态流转规则：

• 状态只能按定义路径单向流转（cancelled/refunded 除外）
• 任意状态均可流转至 cancelled（需权限校验）
• completed 状态可流转至 refunded（售后场景）
• 每次状态变更需记录操作人、时间、来源

4.2.4 售后管理

功能点	说明	优先级
退款	支持全额/部分退款，审核通过后调用渠道退款 API	P0
退货	支持退货申请、退货物流跟踪、入库确认	P1
换货	支持换货申请，生成新发货单，关联原订单	P1

---

4.3 供应商中心（SRM）

4.3.1 供应商管理

功能点	说明	优先级
基本信息	供应商名称、联系人、联系方式、地址、合作状态等	P0
合同管理	合同编号、有效期、结算条款、附件存储	P1
评级	基于交期准时率、质量合格率、响应速度等维度评级（A/B/C/D）	P1

4.3.2 采购管理

功能点	说明	优先级
采购单（PO）	创建采购单，关联供应商与 SKU，记录采购数量、单价、交期	P0
到货确认	采购到货后确认入库数量，记录差异（短交/多交）	P0
成本记录	记录采购成本（含运费、关税等），为利润分析提供数据支撑	P1

4.3.3 供货能力

功能点	说明	优先级
交期（Lead Time）	记录供应商每个 SKU 的标准交货周期（天），用于补货计算	P0
最小起订量（MOQ）	记录每个 SKU 的最小采购数量	P0
价格梯度	按采购量区间设定阶梯价格（如 100-500: $5, 500-1000: $4.5）	P1

---

4.4 渠道中心（Adapter）

4.4.1 Shopify Adapter

功能点	方向	说明	优先级
商品同步	PIM → Shopify	调用 Shopify Product API 创建/更新商品（Product + Variant）	P0
订单接入	Shopify → OMS	监听 Shopify Webhook，接收订单创建/更新/取消事件	P0
发货回传	OMS → Shopify	调用 Shopify Fulfillment API 回传发货状态与物流单号	P0
库存同步	双向	Shopify 库存变更同步至中台，中台库存变更同步至 Shopify	P0

接口映射：

业务操作	Shopify API
创建商品	POST /admin/api/products.json
更新商品	PUT /admin/api/products/{id}.json
创建履约	POST /admin/api/fulfillments.json
订单回调	Webhook: orders/create

4.4.2 TikTok Shop Adapter

功能点	方向	说明	优先级
商品同步	PIM → TikTok	调用 TikTok Shop Product API 发布商品，需通过类目与属性强校验	P0
订单接入	TikTok → OMS	通过 TikTok Shop API 拉取订单，支持 Webhook 实时通知	P0
发货回传	OMS → TikTok	回传发货信息，需满足 SLA 时效要求，面单需符合平台规范	P0
类目校验	上架前	商品发布前自动校验 TikTok 类目合规性、必填属性完整性	P0
属性校验	上架前	校验商品属性是否符合 TikTok Shop 要求（标题长度、图片尺寸等）	P0

TikTok Shop 特殊要求：

• 发货 SLA：订单支付后需在规定时间内发货（通常 48h-72h），超时将影响店铺评分
• 面单规范：物流面单需包含 TikTok 规定的必填信息
• 类目强校验：商品必须匹配 TikTok 官方类目树，属性需满足必填要求

---

4.5 库存与履约

4.5.1 库存管理

功能点	说明	优先级
实时库存	展示每个仓库/SKU 的当前可用库存、锁定库存、在途库存	P0
锁库存	订单支付后锁定对应 SKU 库存，防止超卖	P0
释放库存	订单取消/超时未支付时释放已锁定库存	P0
库存预警	库存低于安全阈值时自动触发预警通知，联动采购模块	P1

库存数据模型：

Inventory
├── warehouse_id      (仓库标识)
├── sku_id            (SKU标识)
├── available_qty     (可用库存)
├── locked_qty        (锁定库存)
├── in_transit_qty    (在途库存)
├── safety_stock      (安全库存阈值)
└── updated_at        (最后更新时间)

4.5.2 发货管理

功能点	说明	优先级
发货单	根据订单自动生成发货单，包含 SKU 明细、收货地址、物流要求	P0
运单号	录入物流运单号，关联发货单与订单	P0
物流公司	支持对接主流跨境物流（DHL、FedEx 等），获取物流轨迹	P1
批量发货	支持批量录入运单号并批量回传至销售渠道	P1

---

4.6 数据与报表

4.6.1 核心指标

指标	计算方式	维度
GMV	订单金额总和（含退款扣减）	日/周/月、渠道、SKU
订单量	有效订单数量	日/周/月、渠道、国家
发货时效	支付时间 → 发货时间的平均耗时	渠道、仓库
库存周转	销售成本 / 平均库存价值	SKU、类目
退款率	退款订单数 / 总订单数	渠道、SKU

4.6.2 报表中心

报表类型	说明	优先级
渠道报表	按 Shopify / TikTok 分别统计销售额、订单量、利润	P1
SKU 报表	按单品维度统计销量、库存、周转率	P1
国家报表	按收货国家统计订单分布、物流时效	P1
自定义报表	支持自定义维度与指标组合，支持导出 CSV	P2

---

4.7 系统与权限

4.7.1 RBAC 权限

功能点	说明	优先级
角色管理	预设角色（运营/采购/仓库/客服/管理者），支持自定义角色	P0
权限控制	基于功能模块 + 操作类型（查看/编辑/删除）进行细粒度权限控制	P0
数据权限	按渠道、仓库等维度控制数据可见范围	P1

预设角色权限矩阵：

功能模块	运营	采购	仓库	客服	管理者
商品中心	读写	读	-	读	读
订单中心	读	-	读写	读写	读
供应商中心	-	读写	-	-	读
渠道中心	读写	-	-	读	读
库存与履约	读	读	读写	读	读
数据报表	读	-	-	-	读写
系统权限	-	-	-	-	读写

4.7.2 操作日志

功能点	说明	优先级
日志记录	记录所有关键操作（创建/修改/删除/状态变更），含操作人、时间、内容	P0
日志查询	支持按模块、操作人、时间范围查询操作日志	P1
日志导出	支持导出操作日志，便于审计	P2

4.7.3 API Key 管理

功能点	说明	优先级
Key 管理	统一管理各渠道 API Key（Shopify AccessToken、TikTok AccessToken）	P0
Key 轮换	支持 API Key 的更新与轮换，不影响在线服务	P1
权限绑定	API Key 与系统账号绑定，操作通过 Key 执行时可追溯至具体人员	P1

---

五、关键业务流程

5.1 流程一：商品上架

┌──────────┐     ┌──────────┐     ┌──────────┐     ┌──────────┐     ┌──────────┐
│ SRM 供货价│────▶│ PIM 建 SKU│────▶│ 渠道映射  │────▶│ 合规校验  │────▶│ 发布到渠道│
└──────────┘     └──────────┘     └──────────┘     └──────────┘     └──────────┘
                                                         │
                                                         ▼
                                               ┌──────────────────┐
                                               │ Shopify Product   │
                                               │ TikTok Product    │
                                               └──────────────────┘

流程说明：

1. 采购在 SRM 中录入供应商供货价格
2. 运营在 PIM 中创建 SPU/SKU，完善商品信息（标题、图片、属性、多语言）
3. 在渠道映射模块中，将 SKU 映射到 Shopify Variant / TikTok SKU
4. 系统执行合规校验（TikTok 类目校验、属性校验等）
5. 校验通过后，发布至对应渠道

5.2 流程二：订单履约

┌──────────┐     ┌──────────┐     ┌──────────┐     ┌──────────┐     ┌──────────┐
│ 用户下单  │────▶│ Webhook   │────▶│ OMS 接单  │────▶│ 锁定库存  │────▶│ 生成发货单│
└──────────┘     │ 推送      │     └──────────┘     └──────────┘     └──────────┘
                 └──────────┘                                           │
                                                                        ▼
                                                                 ┌──────────┐
                              ┌──────────┐    ┌──────────┐       │ 仓库拣货  │
                              │回传平台   │◀───│录入运单号 │◀──────│ 打包发货  │
                              └──────────┘    └──────────┘       └──────────┘
                                   │
                                   ▼
                          ┌──────────────────┐
                          │ Shopify Fulfillment│
                          │ TikTok Shipment   │
                          └──────────────────┘

流程说明：

1. 用户在 Shopify/TikTok 下单
2. 渠道通过 Webhook 推送订单至 OMS
3. OMS 接收订单，创建订单记录（状态：created → paid）
4. 系统自动锁定对应 SKU 库存（allocated）
5. 生成发货单，仓库进行拣货、打包、发货
6. 仓库录入运单号与物流公司
7. 系统自动回传发货状态至对应渠道（shipped）
8. 物流签收后更新为 delivered，超时确认后 completed

5.3 流程三：补货

┌──────────┐     ┌──────────┐     ┌──────────┐     ┌──────────┐     ┌──────────┐
│ 库存预警  │────▶│ 生成采购单│────▶│ SRM 确认  │────▶│ 供应商发货│────▶│ 到货入库  │
└──────────┘     └──────────┘     └──────────┘     └──────────┘     └──────────┘
     │                                                                   │
     ▼                                                                   ▼
┌──────────────────┐                                          ┌──────────────┐
│ 触发条件：        │                                          │ 库存更新       │
│ 可用库存 < 安全库存│                                          │ 预警解除       │
└──────────────────┘                                          └──────────────┘

流程说明：

1. 系统监测到 SKU 可用库存低于安全库存阈值，触发预警
2. 采购根据预警信息创建采购单（PO），关联供应商与 SKU
3. 采购单确认后通知供应商
4. 供应商按交期发货
5. 到货后仓库确认入库，系统更新库存，预警解除

---

六、非功能性需求

6.1 性能要求

指标	要求
页面响应时间	≤ 2s（常规操作）
API 响应时间	≤ 500ms
Webhook 处理延迟	≤ 3s
并发订单处理	支持 100+ TPS

6.2 可用性要求

指标	要求
系统可用性	≥ 99.9%
数据备份	每日全量备份 + 实时增量
故障恢复	RTO ≤ 1h, RPO ≤ 5min

6.3 安全要求

• 所有 API 通信强制 HTTPS
• API Key 加密存储，不可明文展示
• 敏感操作（删除/取消/退款）需二次确认
• 操作日志不可篡改，保留至少 180 天

---

七、集成接口清单

7.1 外部接口

渠道	接口类型	用途	优先级
Shopify	REST API	商品 CRUD	P0
Shopify	Webhook	订单事件通知	P0
Shopify	REST API	履约回传	P0
TikTok Shop	REST API	商品发布与管理	P0
TikTok Shop	Webhook	订单事件通知	P0
TikTok Shop	REST API	发货回传	P0
DHL	REST API	物流轨迹查询	P1
FedEx	REST API	物流轨迹查询	P1

7.2 内部模块间接口

源模块	目标模块	接口用途
PIM	Adapter	商品数据同步
Adapter	OMS	订单数据写入
OMS	Inventory	库存锁定/释放
OMS	Adapter	发货状态回传
Inventory	SRM	库存预警触发采购
SRM	Inventory	采购入库更新库存

---

八、优先级与里程碑

阶段	交付内容	优先级覆盖
Phase 1	PIM 核心 + Shopify Adapter + OMS 基础 + 库存管理	P0 核心功能
Phase 2	TikTok Adapter + 售后 + SRM 采购流程	P0 + P1
Phase 3	报表中心 + 批量操作 + 合单/拆单优化	P1
Phase 4	自定义报表 + API Key 轮换 + 高级风控	P2

---

九、风险与假设

9.1 假设

• Shopify 与 TikTok Shop API 稳定可用，无重大 Breaking Change
• 客户已拥有 Shopify 店铺与 TikTok Shop 卖家账号
• 首期对接国内单一仓库，后续扩展海外仓

9.2 风险

风险	影响	缓解措施
TikTok Shop API 频繁变动	高	封装 Adapter 层，变更隔离在 Adapter 内部
跨渠道库存超卖	高	下单即时锁库存，库存扣减采用乐观锁/分布式锁
TikTok 类目审核不通过	中	上架前强校验，预审核机制
大促期间订单量激增	中	消息队列削峰，Webhook 异步处理

---

附录

A. 术语表

术语	全称	说明
PIM	Product Information Management	商品信息管理
OMS	Order Management System	订单管理系统
SRM	Supplier Relationship Management	供应商关系管理
SPU	Standard Product Unit	标准产品单元
SKU	Stock Keeping Unit	最小库存单元
PO	Purchase Order	采购订单
MOQ	Minimum Order Quantity	最小起订量
GMV	Gross Merchandise Volume	成交总额
RBAC	Role-Based Access Control	基于角色的访问控制
SLA	Service Level Agreement	服务等级协议
TPS	Transactions Per Second	每秒事务数
RTO	Recovery Time Objective	恢复时间目标
RPO	Recovery Point Objective	恢复点目标