diff --git a/plans/BIZ-89/淘宝聚水潭自动化运营方案.md b/plans/BIZ-89/淘宝聚水潭自动化运营方案.md new file mode 100644 index 0000000..e1829f6 --- /dev/null +++ b/plans/BIZ-89/淘宝聚水潭自动化运营方案.md @@ -0,0 +1,168 @@ +# 淘宝 + 聚水潭自动化运营方案设计 + +## 1. 方案思路 + +### 1.1 整体架构 + +``` +┌─────────────────┐ ┌──────────────────┐ ┌─────────────────┐ +│ 淘宝千牛平台 │ ←─→ │ 自动化中间层 │ ←─→ │ 聚水潭 ERP │ +│ - 商品管理 │ │ - API 适配层 │ │ - 订单管理 │ +│ - 订单管理 │ │ - 数据同步引擎 │ │ - 库存管理 │ +│ - 库存管理 │ │ - 任务调度器 │ │ - 采购管理 │ +│ - 客服消息 │ │ - 监控告警 │ │ - 财务报表 │ +└─────────────────┘ └──────────────────┘ └─────────────────┘ + ↓ + ┌──────────────────┐ + │ 数据存储层 │ + │ - SQLite/MySQL │ + │ - Redis 缓存 │ + │ - 日志系统 │ + └──────────────────┘ +``` + +### 1.2 数据采集方式 + +| 数据源 | 推荐方式 | 理由 | +|--------|----------|------| +| 淘宝千牛 | **浏览器自动化 (opencli)** | 千牛工作台无开放 API，需模拟登录操作 | +| 聚水潭 | **API 对接优先** | 聚水潭提供开放 API，稳定可靠 | +| 备用方案 | 浏览器自动化 | API 受限时的降级方案 | + +### 1.3 自动化流程设计 + +**核心流程**： +1. **订单同步**：淘宝订单 → 聚水潭（实时/定时） +2. **库存同步**：聚水潭库存 → 淘宝（避免超卖） +3. **商品管理**：批量上下架、价格调整 +4. **数据报表**：销售分析、库存周转、利润核算 + +--- + +## 2. 实现路径 + +### 阶段 1：前期调研（1-2 周） + +| 任务 | 负责人 | 交付物 | +|------|--------|--------| +| 淘宝 opencli adapter 开发 | costcodev | `taobao-qiniu-adapter.ts` | +| 聚水潭 API 能力评估 | architect | 《聚水潭 API 调研报告》 | +| 反爬策略分析 | costcodev | 风险评估文档 | +| 技术选型确认 | architect | 架构决策记录 ADR | + +### 阶段 2：系统对接（2-3 周） + +| 任务 | 负责人 | 交付物 | +|------|--------|--------| +| 淘宝千牛数据读取模块 | costcodev | 可运行脚本 | +| 聚水潭 API 封装库 | costcodev | `jushuitan-sdk` | +| 数据同步中间件 | costcodev | 核心同步引擎 | +| 数据库 schema 设计 | architect | ER 图 + 建表脚本 | + +### 阶段 3：核心功能开发（3-4 周） + +| 任务 | 负责人 | 交付物 | +|------|--------|--------| +| 订单自动同步 | costcodev | 订单同步模块 | +| 库存自动同步 | costcodev | 库存同步模块 | +| 商品批量管理 | costcodev | 商品管理模块 | +| 报表生成引擎 | costcodev | 数据报表模块 | +| Web 控制台 | designer + costcodev | 管理后台 UI | + +### 阶段 4：测试验证（1-2 周） + +| 任务 | 负责人 | 交付物 | +|------|--------|--------| +| 功能测试 | coo + taobaospecialist | 测试报告 | +| 稳定性测试 | opengineer | 压力测试报告 | +| 数据一致性校验 | coo | 校验脚本 + 报告 | +| 安全审计 | opengineer | 安全评估报告 | + +### 阶段 5：部署上线（1 周） + +| 任务 | 负责人 | 交付物 | +|------|--------|--------| +| 生产环境部署 | opengineer | 部署文档 | +| 监控告警配置 | opengineer | Grafana 面板 | +| 运维交接 | opengineer | 运维 SOP | +| 用户培训 | coo | 使用手册 | + +--- + +## 3. 团队资源需求 + +| 角色 | 工时估算 | 职责 | +|------|----------|------| +| **architect 梁思筑** | 20h | 架构设计、技术选型、ADR 撰写 | +| **costcodev 徐聪** | 120h | 核心开发（API 对接、同步引擎、Web 后台） | +| **designer 苏绘锦** | 16h | Web 控制台 UI 设计 | +| **opengineer 严维序** | 24h | 部署、监控、运维 SOP | +| **taobaospecialist 陆云帆** | 16h | 业务需求输入、流程验证、UAT 测试 | +| **coo 陆怀瑾** | 24h | 项目管理、风险评估、进度跟进 | + +**总工时**：约 220 小时（约 5.5 人周） + +--- + +## 4. 风险与约束 + +### 4.1 接口限制 + +| 风险 | 影响 | 应对措施 | +|------|------|----------| +| 淘宝 API 调用频率限制 | 数据同步延迟 | 请求队列 + 令牌桶限流 | +| 聚水潭 API 权限不足 | 部分功能无法实现 | 申请高级权限或改用浏览器自动化 | + +### 4.2 反爬机制 + +| 风险 | 影响 | 应对措施 | +|------|------|----------| +| 淘宝风控检测 | 账号被封禁 | 1. 使用真实 Cookie 2. 限制操作频率 3. 添加人工操作混淆 | +| 登录态失效 | 自动化中断 | Token 自动刷新 + 失效告警 | + +### 4.3 数据安全 + +| 风险 | 影响 | 应对措施 | +|------|------|----------| +| 账号密码泄露 | 严重安全事故 | 1. 使用密钥管理服务 2. 环境变量存储 3. 权限隔离 | +| 数据传输未加密 | 中间人攻击 | HTTPS + 数据加密传输 | + +### 4.4 平台稳定性 + +| 风险 | 影响 | 应对措施 | +|------|------|----------| +| 聚水潭接口变更 | 功能失效 | 1. 接口版本监控 2. 快速适配机制 | +| 淘宝页面结构变更 | 选择器失效 | 1. 多选择器备用 2. 定期巡检更新 | + +### 4.5 合规风险 + +| 风险 | 影响 | 应对措施 | +|------|------|----------| +| 违反淘宝服务条款 | 店铺处罚 | 1. 评估自动化操作合规性 2. 控制操作频率在合理范围 3. 保留人工审核环节 | + +--- + +## 5. 下一步行动 + +1. **立即启动**：architect 开始聚水潭 API 调研 +2. **并行推进**：costcodev 开发淘宝 opencli adapter +3. **周会同步**：每周五同步进展，识别阻塞点 +4. **里程碑**：阶段 1 结束后进行方案复审 + +--- + +## ⚠️ 安全提示 + +**严禁在代码/配置文件中明文存储账号密码！** + +正确做法： +```bash +# 使用环境变量 +export TAOBAO_ACCOUNT=$(vault read -field=value secret/taobao/account) +export TAOBAO_PASSWORD=$(vault read -field=value secret/taobao/password) +``` + +或使用密钥管理服务（如 HashiCorp Vault、AWS Secrets Manager）。 + +--- +提交人：陆怀瑾（COO）| 提交时间：2026-07-11 | 关联 issue：BIZ-89