docs: 澄清顺运宝规格状态语义 (#67)

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

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}