cmautobuy/admin/handler/web/shopee.go

package web

import (
	"net/http"

	"github.com/gin-gonic/gin"
)

// ShopeeList 渲染蝦皮数据列表页。
//
// 表格按 SKU 展开显示，数据来自 shopee_products 和 shopee_skus 联查。
// 列定义见 docs/admin/05-ui-specification.md §4.2。
func (h *Handler) ShopeeList(c *gin.Context) {
	keyword := c.Query("goods_id")

	// TODO(骨架): 调 service 查列表
	//   rows, err := service.ListShopeeSKUs(h.db, keyword, page, size)
	// 注意：搜索要走数据库查询，不要一次查全量再在内存里过滤。
	var rows []gin.H

	c.HTML(http.StatusOK, "shopee/list", page(c, "shopee", "蝦皮数据", gin.H{
		"Keyword": keyword,
		"Rows":    rows,
		"Status":  "尚未实现：导入后这里显示商品和规格",
	}))
}

// ShopeeImport 处理 Excel 上传导入。
//
// 关键规则（写错会丢数据，见 docs/admin/03-data-model.md §3.3）：
//   - 商品汇总行（商品規格ID 为 "-"）进 shopee_products，
//     SKU 行进 shopee_skus，两者要分开处理；
//   - 按列名找索引，不要写死列号；
//   - 规格原文两种格式各占一半，解析失败留空并把 parse_ok 置 0，不要猜；
//   - **只能 upsert，绝不允许先清空再导入**，
//     否则人工填的 PDD 链接会被洗掉；
//   - upsert 的 DO UPDATE SET 里不得出现 pdd_goods_url / pdd_data / collect_status。
func (h *Handler) ShopeeImport(c *gin.Context) {
	file, err := c.FormFile("file")
	if err != nil {
		fail(c, http.StatusBadRequest, "没有收到文件，请重新选择 Excel 后再提交。")
		return
	}

	// TODO(骨架): 校验大小和扩展名（只允许 .xlsx），
	//   落盘到 data/uploads/ 时用自己生成的文件名，
	//   不要直接用 file.Filename 拼路径（路径穿越）。
	_ = file

	// TODO(骨架): 调 service.ImportShopeeExcel(path)，
	//   返回 {商品数, SKU数, 解析失败行号列表} 并显示出来。
	//   失败行不要静默跳过。

	fail(c, http.StatusNotImplemented,
		"导入功能尚未实现。已保留你选择的文件，未写入数据库。")
}

// ShopeeSave 保存编辑弹窗里的内容（PDD 链接、颜色、尺码、建议）。
//
// 这是**从蝦皮商品出发**录入 PDD 链接的入口，
// 见 docs/admin/05-ui-specification.md §4.3。PDD 商品页（§5）也能录入，
// 两处并存；本页这个目前还是骨架，合并与否由「蝦皮↔PDD 关联入口」工单决定。
func (h *Handler) ShopeeSave(c *gin.Context) {
	// TODO(骨架): 保存 PDD 链接时调 repository.EnsurePddProduct，
	//   由它去建 / 复用 / 复活 pdd_products 那一行。
	//
	//   **采集状态不在蝦皮这边**：它属于 PDD 商品（pdd_products.collect_status）。
	//   "还没填链接"由 shopee_products.pdd_goods_id IS NULL 表达——
	//   没填链接时 pdd_products 里根本不会有那一行。
	//   不要写 no_link，那个值在 #16 已从 CHECK 约束里删掉了，写了会直接撞约束。
	fail(c, http.StatusNotImplemented, "保存功能尚未实现。")
}

// ShopeeDelete 批量删除勾选的行。
func (h *Handler) ShopeeDelete(c *gin.Context) {
	// TODO(骨架): 取 ids，二次确认已在前端做过，这里直接删
	fail(c, http.StatusNotImplemented, "删除功能尚未实现。")
}

// ShopeeCollect 发起采集任务。
//
// 入口在编辑弹窗里，紧挨 PDD 链接输入框——不要放到表格每一行，
// 一个商品有 N 个 SKU 行，放行上就是 N 个按钮干同一件事。
//
// 规则：
//   - PDD 链接为空不允许发起；
//   - collect_status 已经是 collecting 的跳过并说明跳过了几个；
//   - 批量采集要**按商品去重**后再建任务。
func (h *Handler) ShopeeCollect(c *gin.Context) {
	// TODO(骨架): 调 service.CreateCollectTasks(goodsIDs, clientID)
	fail(c, http.StatusNotImplemented, "采集功能尚未实现。")
}