refactor: 切换蝦皮数据到目录接口 (#135)

This commit is contained in:
chengma
2026-08-11 10:16:48 +08:00
parent 8f68845dfd
commit 0588ef18c8
20 changed files with 84 additions and 1043 deletions
+4 -4
View File
@@ -26,7 +26,7 @@ Admin 的职责是把这三方的数据串起来,最终产出 Client 能执行
- **管理员:**首次初始化 Admin,执行全部业务操作,并创建、禁用或重置采购员账号。
- **采购员:**登录后执行现有业务操作,但不能管理用户。
- **Client:**领取任务、在安卓设备上执行、提交结果。契约见 [Client 侧文档](../client/04-admin-api-contract.md)。
- **蝦皮:**只提供 Excel 报表导出,**没有接口对接**。
- **蝦皮:**不同来源文件由第三方脚本归一化,再提交到 Admin 商品目录接口。
- **顺运宝:**提供货运单,`[待定]` 同步方式待确认,MVP 先做占位按钮。
- **拼多多:**由 Client 操作,Admin 不直接接触。
@@ -35,7 +35,7 @@ Admin 的职责是把这三方的数据串起来,最终产出 Client 能执行
这条链路是理解全部五个模块的关键,先看懂它:
```text
蝦皮报表 ──导入──→ 商品表 + SKU 表
第三方商品目录脚本 ──批量接口──→ 商品表 + SKU 表
│
编辑弹窗:人工填 PDD 链接
│
@@ -453,7 +453,7 @@ MVP 包含:
- 五模块页面框架和统一的三段式布局;
- MySQL 8.4 建库与追加式迁移;SQLite 仅作为一次性历史数据迁移来源;
- 蝦皮 Excel 导入(upsert)、搜索、批量删除、手动新增、编辑弹窗;
- 商品目录批量接口(蝦皮/PDD/关联 upsert)、导入记录、蝦皮搜索、批量删除、手动新增、编辑弹窗;
- PDD 链接录入与发起采集;
- 顺运宝数据的**手工录入或造数**(同步按钮占位);
- 规格匹配弹窗与可复用映射;
@@ -485,7 +485,7 @@ MVP 之后:
- 集中部署,操作人员规模是个位数;不追求大规模并发,但任务领取必须保证并发唯一。
- 页面在 1366×768 上可正常使用。
- 导入 1 万行 Excel 应在可接受时间内完成,并显示进度或结果统计。
- 商品目录批次和 PDD Excel 导入应在可接受时间内完成,并显示结果统计。
- 所有写操作有 CSRF 防护,所有 SQL 参数化。
- 密码只保存成熟算法生成的哈希;Session 有过期、退出和账号禁用失效机制。
- 首次管理员、采购员初始密码和重置密码统一要求至少 6 个字符,最多 72 个字节;