Shopee Listing 管理一期 · 产品 PRD

产品 PRD 版本：1.2

当前变更：CR-20260823-001（按既有 PRD 补齐更新时间筛选，并重做 UI 候选实现）

状态：ready-for-prototype

确认依据：既有 Shopee Listing 一期 PRD 的已确认功能范围；Freddy 要求用新的 Ant Design Pro 设计流程生成一个可对比候选，不构成视觉验收或发布授权。

背景与目标

运营需要在 ERP 内分开管理 Global Product 和站点 Listing：查询发布关系、查看站点状态及规格价格库存，并以轻量入口修改价格/库存或进入完整编辑。

一期目标是让运营能在同一站点 Listing 列表完成定位和高频维护，同时保留完整编辑页承载内容、属性、规格、图片、包裹物流和详细描述。

用户	场景	成功标准
Shopee 运营	查询某店铺/站点 Listing，并按状态或更新时间缩小结果	能识别对象、当前售价、库存和可执行操作
Shopee 运营	快速改价或改库存	不进入长表单即可编辑规格级值并得到提交反馈
Shopee 运营	完整修改 Listing	长表单完成内容、规格、图片、包裹物流和描述的修改
运营主管	判断对客价格和库存风险	同时看到原价、折扣价、当前售价、Shopee 库存与 ERP 库存

信息架构保持为两个独立对象入口：全球商品（Global Item）和站点商品（店铺 + 站点 + Item ID）。站点 Listing 列表提供状态 Tab、查询、结果表和行内高频操作；完整编辑采用独立长表单。

当前候选只重做 UI 表达，不删除已确认功能。原型使用本地示例数据，不调用生产 Shopee API。

一期包含：

全球商品列表：关键词、SPU、SKU、发布状态查询；查看并进入发布站点 Mapping。
站点 Listing 列表：关键词、Seller/ERP SKU、SPU、店铺、站点、规格结构、更新时间范围查询；状态 Tab；规格、三层价格、双库存和行操作。
Listing 编辑：基本信息、商品属性、销售信息、商品图片、包裹与物流、商品描述；规格批量设置、属性图绑定和分域提交反馈。
快速价格/库存编辑：中央 Modal；单规格窄表，多规格宽表；当前售价只读。

一期不包含：店铺折扣活动管理、折扣商品对象、秒杀/优惠券/活动报名、批量创建或删除 Listing、真实凭据和生产写入。

Global Product 以 Global Item ID 为主键，站点 Listing 以 platform + site + shop_id + item_id 为主键；不得共用一个数据表。点击发布关系展示店铺、站点、Item ID 和状态，进入目标 Listing 时携带对象上下文。

平台状态以结果区 Tab 过滤：全部、在线、已售完、审核中、未上架、违规、疑似删除；不与查询表单重复。查询支持普通更新时间范围，包含今天、昨天、近 7 天、近 30 天、本月、上月和自定义范围；本页没有数据对比语义，不出现对比模式。

结果表按商品信息、价格信息、库存信息、更新时间、操作分组。单属性直接展示唯一属性值；多属性展示 Model 数并进入明细。改价、改库存为高频行操作；完整编辑收入“更多”。

当前售价不得在列表、完整编辑页或快速修改 Modal 中直接覆盖。Shopee 和 ERP 库存必须并列；ERP SKU 未映射显示“未匹配”，不伪造为 0。平台返回仓库时才展示仓库。

编辑页的六个业务分区为：基本信息、商品属性、销售信息、商品图片、包裹与物流、商品描述。规格表可勾选 Model 后批量设置原价、折扣价或库存；无选择时按钮禁用，确认前显示受影响 Model 数。

商品图片支持增加和属性图绑定；原型只模拟选择、替换和删除，不上传外部文件。包裹字段保持 Listing 级和“待联调核验”，不复制到 Model 行。提交按内容、原价、折扣价、库存分域执行；部分成功保留成功结果，失败领域可独立重试。

价格按站点币种展示；库存的未映射、未回读与真实 0 必须区分。