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, "采集功能尚未实现。") }