// 蝦皮数据列表页的查询和界面文字组装。 // // 分成单独文件是因为它和 shopee_import.go 职责不同:这里只读,不写库。 package service import ( "database/sql" "cmautobuy/admin/model" "cmautobuy/admin/repository" ) // ShopeeProductView 是列表页一行要显示的全部内容,全部已经是字符串, // 模板里不做判断和格式化。 // // 一行对应一个**商品**,不是一个 SKU——见工单 #41。 type ShopeeProductView struct { GoodsID string Title string // ColorCount / SizeCount 只统计 parse_ok = 1 的 SKU(`[必须]`,见 #41)。 ColorCount int SizeCount int // SKUCount 是这个商品报表里实际出现过的 SKU 数(不管解析成功与否)。 // `[必须]` 必须单独展示:蝦皮报表只含有销售成绩的 SKU, // 颜色数 × 尺码数经常大于 SKUCount,只显示前两者会严重误导操作员, // 让人以为要匹配的规格比实际多得多(实测最悬殊相差 2.7 倍,见 #41)。 SKUCount int // PendingCount 是 parse_ok = 0 的 SKU 数,即"待补"。 // `[必须]` > 0 时整行标黄(沿用 .row-warn)——聚合成商品级之后, // "部分失败"的商品数字看起来完全正常,坏数据会被吃掉,见 #41。 PendingCount int // PddURL 为空且 PddMissing 为 true 时,模板显示"未填写"并标红—— // 这是最需要操作员注意的状态,见 §4.2。 PddURL string PddMissing bool StatusText string UpdatedAt string } // ShopeeListResult 是列表页要的全部数据。 type ShopeeListResult struct { Rows []ShopeeProductView Total int // shopee_products 的总商品数(不受筛选影响),用于判断"是否已导入过" IsFiltered bool } // ListShopeeProducts 查蝦皮商品列表(商品级一行)并把每一行翻成界面文字。 // // 采集状态来自 pdd_products(联查得到),不是蝦皮自己的字段, // 见 docs/admin/01-requirements.md §6.1: // // shopee_products.pdd_goods_id 为空 -> "未填链接" // pdd_products.collect_status -> 未采集 / 采集中 / 已采集 / 采集失败 func ListShopeeProducts(db *sql.DB, keyword string) (*ShopeeListResult, error) { rows, err := repository.ListShopeeProducts(db, keyword) if err != nil { return nil, err } total, err := repository.CountShopeeProducts(db) if err != nil { return nil, err } result := &ShopeeListResult{ Rows: make([]ShopeeProductView, 0, len(rows)), Total: total, IsFiltered: keyword != "", } for _, r := range rows { v := ShopeeProductView{ GoodsID: r.GoodsID, Title: r.Title, ColorCount: r.ColorCount, SizeCount: r.SizeCount, SKUCount: r.SKUCount, PendingCount: r.PendingCount, UpdatedAt: formatLocalTime(r.UpdatedAt), } if r.PddGoodsID == "" { v.PddMissing = true v.PddURL = "未填写" v.StatusText = "未填链接" } else { v.PddURL = r.PddGoodsURL if r.CollectStatus.Valid { v.StatusText = collectStatusText(model.CollectStatus(r.CollectStatus.String)) } else { // pdd_goods_id 有值但 pdd_products 里查不到对应行 // (比如那条 PDD 商品被软删除了),如实说明,不要装作"未采集"。 v.StatusText = "PDD 商品缺失" } } result.Rows = append(result.Rows, v) } return result, nil } // ---------- 弹窗 ---------- // ShopeeSpecView 是弹窗规格表的一行。 type ShopeeSpecView struct { SKUID string Color string Size string Advice string // StatusText 是"✓"或"待补",`[必须]` 要有文字,不能只靠颜色区分(见 #41)。 StatusText string // Pending 为 true 时模板整行标黄,并在下面加一行显示 SpecRaw 原文。 Pending bool // SpecRaw 只在 Pending 为 true 时才有意义。 // `[必须]` 待补的行必须显示规格原文——不显示的话人工不知道该填什么, // 这正是保留 spec_raw 这个设计的全部意义,见 #41。 SpecRaw string } // ShopeeProductDetail 是双击弹窗要显示的全部内容。 // // `[必须]` 这个弹窗只读,不含可提交的表单——本工单不实现保存, // ShopeeSave 仍是 501,见 #41。 type ShopeeProductDetail struct { GoodsID string Title string ShopeeStatus string MainSKUCode string PddURL string PddMissing bool StatusText string SKUs []ShopeeSpecView PendingCount int } // GetShopeeProductDetail 读一个蝦皮商品的详情(商品信息 + 完整规格表)。 // 商品不存在返回 (nil, nil)。 func GetShopeeProductDetail(db *sql.DB, goodsID string) (*ShopeeProductDetail, error) { p, err := repository.GetShopeeProductByGoodsID(db, goodsID) if err != nil || p == nil { return nil, err } d := &ShopeeProductDetail{ GoodsID: p.GoodsID, Title: p.Title, ShopeeStatus: p.ShopeeStatus, MainSKUCode: p.MainSKUCode, } if d.Title == "" { d.Title = placeholder } if d.ShopeeStatus == "" { d.ShopeeStatus = placeholder } if d.MainSKUCode == "" { d.MainSKUCode = placeholder } if p.PddGoodsID == "" { d.PddMissing = true d.PddURL = "未填写" d.StatusText = "未填链接" } else { d.PddURL = p.PddGoodsURL status, _, err := repository.GetShopeeCollectStatus(db, p.PddGoodsID) if err != nil { return nil, err } if status.Valid { d.StatusText = collectStatusText(model.CollectStatus(status.String)) } else { d.StatusText = "PDD 商品缺失" } } skus, err := repository.ListShopeeSKUsByGoodsID(db, goodsID) if err != nil { return nil, err } d.SKUs = make([]ShopeeSpecView, 0, len(skus)) for _, sk := range skus { row := ShopeeSpecView{SKUID: sk.SKUID} if sk.ParseOK { row.Color, row.Size, row.Advice = sk.Color, sk.Size, sk.Advice if row.Advice == "" { row.Advice = placeholder } row.StatusText = "✓" } else { row.Color, row.Size, row.Advice = placeholder, placeholder, placeholder row.StatusText = "待补" row.Pending = true row.SpecRaw = sk.SpecRaw d.PendingCount++ } d.SKUs = append(d.SKUs, row) } return d, nil }