cmautobuy/admin/service/shopee_list.go

// 蝦皮数据列表页的查询和界面文字组装。
//
// 分成单独文件是因为它和 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
}