feat: 蝦皮 Excel 报表导入 (#38)
蝦皮数据模块此前整个是骨架,四个入口全返回 501,excelize 连依赖都没装。 本工单做导入和列表,Save/Delete/Collect 保持 501。 真实样本实测:5195 个商品 / 6092 个 SKU,23 行解析失败。 upsert 白名单式,pdd_goods_url / pdd_goods_id 既不在 INSERT 列清单里 也不在 DO UPDATE SET 里。报表没有这两列,写进去就是写空值——操作员 攒几周的 PDD 链接会被一次导入洗光,而且不报错,等到建采购任务才发现。 有独立测试守着:往 DO UPDATE SET 里加回这一行,测试立刻变红。 按 sheet 名字取「最佳表現商品」,不用第 0 个。工作簿有 5 个 sheet, 另外 4 个是广告报表,连 商品規格ID 列都没有;蝦皮调顺序时按下标 会静默导入一张完全不相干的表。 按列名找索引。40 列里 32 列是统计指标,蝦皮加一列所有列号就错位, 而且不报错——会把「點擊率」当成「商品規格」存进去。 规格解析三种格式:含【】53.4%、逗号+空格 26.4%、只有逗号 20.2%, 只认【】会漏掉 46.6%。括号不配对(21 行)和右半整个被【】包住(2 行) 一律判整体失败,不逐段硬凑——错法不统一,针对每种错法写规则等于在猜, 而且没有人工核对过的正确答案可验证。失败时 color/size/advice 必须全空, 原文存进 spec_raw 交人工补。 不写 DELETE + INSERT 的全量替换,将来手动新增的 SKU 会被删掉。 excelize v2.9.1 的 go 指令正好是 1.23.0,与项目固定版本一致。 Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
This commit is contained in:
@@ -21,45 +21,9 @@ import (
|
||||
var ErrNotImplemented = errors.New("功能尚未实现")
|
||||
|
||||
// ---------- 蝦皮 Excel 导入 ----------
|
||||
|
||||
// ImportResult 是一次导入的统计结果,要显示给操作员看。
|
||||
type ImportResult struct {
|
||||
ProductCount int // 写入的商品数,样本应为 5195
|
||||
SKUCount int // 写入的 SKU 数,样本应为 6092
|
||||
FailedRows []int // 解析失败的行号,**不要静默跳过**
|
||||
}
|
||||
|
||||
// ImportShopeeExcel 解析蝦皮报表并 upsert 进库。
|
||||
//
|
||||
// 实现要点见 docs/admin/03-data-model.md §3.3,五步缺一不可:
|
||||
// 1. 分行:商品規格ID 为 "-" 的是商品汇总行,其余是 SKU 行;
|
||||
// 2. 按列名找索引,不要写死列号(报表 40 列,蝦皮改格式列号就变);
|
||||
// 3. 解析规格原文:先按第一个逗号切开,右边再提取建议。
|
||||
// 实测两种格式各占 53.4% / 46.6%,只认【】会漏掉一半。
|
||||
// **任何一步失败都不要猜**,parse_ok 置 0,颜色尺码留空,原文照存;
|
||||
// 4. upsert,**绝不清空**。DO UPDATE SET 里不得出现
|
||||
// pdd_goods_url / pdd_data / collect_status——报表里没这些列,
|
||||
// 写进去会把人工填的洗成空;
|
||||
// 5. 返回统计。
|
||||
func ImportShopeeExcel(db *sql.DB, path string) (*ImportResult, error) {
|
||||
// TODO(骨架): 用 github.com/xuri/excelize/v2 流式读行
|
||||
return nil, ErrNotImplemented
|
||||
}
|
||||
|
||||
// ParseSpec 把蝦皮的规格原文拆成颜色、尺码、建议。
|
||||
//
|
||||
// 输入样例(两种格式各占一半):
|
||||
//
|
||||
// "黑色,M【建議40-50公斤】" -> 黑色 / M / 40-50公斤 / true
|
||||
// "卡其色拼黑色,L 建議50-57.5kg" -> 卡其色拼黑色 / L / 50-57.5kg / true
|
||||
// "莫名其妙的格式" -> "" / "" / "" / false
|
||||
//
|
||||
// 最后一个返回值是 ok;false 时前三个必须为空,**不要猜**。
|
||||
// 调用方要把 parse_ok 存进库,界面上把这些行标出来让人工补。
|
||||
func ParseSpec(raw string) (color, size, advice string, ok bool) {
|
||||
// TODO(骨架): 按第一个逗号切开;右边先找【建議...】,再找空格后的 建議...
|
||||
return "", "", "", false
|
||||
}
|
||||
// ImportResult / ImportShopeeExcel / ParseSpec 的实现见 shopee_import.go,
|
||||
// 那个文件还负责上传文件的安全校验(大小、扩展名、内容魔数)。
|
||||
|
||||
// ---------- 采集 ----------
|
||||
|
||||
|
||||
Reference in New Issue
Block a user