打通 Client↔Admin 闭环的一环:录入 PDD 链接 → 创建采集任务 → 客户端领走去采 → 规格和价格显示在页面上。#16 写的 MarkCollecting 和 SoftDeletePddProduct 至此才有生产调用方。 链接解析严格、不做容错兜底:goods_id 上有 UNIQUE 约束,防重全靠它。 猜一个的话同一商品会存成好几行、采好几遍,规格映射还说不清指向哪一行。 短链一律拒绝,卡域名是为了拦"粘了淘宝链接"这种失误。 创建采集任务先占状态再建任务:MarkCollecting 只在 pending/failed 时成功, 同时充当"有没有人已经在采"的判断,与建任务在同一事务里, 所以并发点多次只会建出一个任务(实测 4 并发 → 1 条)。 submit.go 的 collectedData 增加 Dimensions —— 没有它就只能按 Go 的 map 遍历,而 map 无序,同一商品每次刷新"颜色/尺码"的先后都可能变。 顺带修 #16 一处缺陷:EnsurePddProduct 复活分支清空了 skus_json 却漏了 title,导致复活后状态显示"未采集"但标题还留着旧值。 审查打回一次:清理"PDD 链接唯一的录入口"这一过期说法(全库 5 处), 以及 shopee.go 里"空 → no_link"的过期 TODO —— no_link 已在 #16 从 CHECK 约束删除,照写会直接撞约束。 Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
93 lines
3.8 KiB
Go
93 lines
3.8 KiB
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, "采集功能尚未实现。")
|
||
}
|