From 57a6484fd5195c7a65a53a5483fc4bd7d0a13893 Mon Sep 17 00:00:00 2001 From: chengma Date: Sun, 9 Aug 2026 22:34:22 +0800 Subject: [PATCH] =?UTF-8?q?docs:=20=E6=BE=84=E6=B8=85=E9=A1=BA=E8=BF=90?= =?UTF-8?q?=E5=AE=9D=E8=A7=84=E6=A0=BC=E7=8A=B6=E6=80=81=E8=AF=AD=E4=B9=89?= =?UTF-8?q?=20(#67)?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- admin/model/model.go | 5 +++-- admin/service/syb.go | 6 +++--- 2 files changed, 6 insertions(+), 5 deletions(-) diff --git a/admin/model/model.go b/admin/model/model.go index d83dee4..e07d322 100644 --- a/admin/model/model.go +++ b/admin/model/model.go @@ -201,7 +201,8 @@ type ShopeeSKU struct { // PriceTwdCent 是**台币分**，跟采购任务的人民币价格上限没有换算关系， // 不要互相赋值，见 docs/admin/01-requirements.md §7。 // -// `[必须]` ShopeeSKUID 是规格匹配的结果（人工确认或自动匹配产生）， +// `[必须]` ShopeeSKUID 是蝦皮规格识别结果（人工确认或自动识别产生）， +// 它不代表已经完成蝦皮 SKU 到 PDD SKU 的采购规格映射。 // 顺运宝同步**绝不能覆盖它**——顺运宝根本没有这个值，见工单 #46、 // docs/admin/08-顺运宝接口.md §6.2。 type SybOrder struct { @@ -210,7 +211,7 @@ type SybOrder struct { Title string ProductSpec string // 规格原文，顺运宝 productSpec，原样保留，对应 shopee_skus.spec_raw ShopeeGoodsID string - ShopeeSKUID string // 匹配结果；顺运宝同步永远不写这一列，见上面的注释 + ShopeeSKUID string // 蝦皮规格识别结果；顺运宝同步永远不覆盖这一列，见上面的注释 Quantity int PriceTwdCent int64 ImageURL string diff --git a/admin/service/syb.go b/admin/service/syb.go index d93048a..9851c3f 100644 --- a/admin/service/syb.go +++ b/admin/service/syb.go @@ -1016,9 +1016,9 @@ type SybListResult struct { // ListSybOrdersView 按筛选条件分页查货运单明细列表，翻成界面文字。 // -// `[必须]` 匹配状态是**算出来的**（shopee_sku_id 是否非空）， -// 不是存的字段，见工单 #46——本工单不做规格匹配，这里只负责如实 -// 显示"有没有"。 +// `[必须]` 处理阶段由顺运宝明细、蝦皮 SKU、PDD 关联和采集状态实时推导， +// 不额外保存一份容易过期的状态字段。shopee_sku_id 只表示已经确认了 +// 顺运宝规格对应的蝦皮 SKU，不代表已经完成 PDD 规格映射。 func ListSybOrdersView(db *sql.DB, keyword, stage string, page int) (*SybListResult, error) { stage = ParseSybStage(stage) filter := repository.SybOrderFilter{Keyword: keyword, Stage: stage}