wurenzhi/makemd
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

chore: 清理归档文件和文档模板

Browse Source 
删除不再需要的归档文件和过时的文档模板，包括多个README、安全策略、前端集成蓝图等文件，同时移除了未使用的业务文档和项目结构文件。

优化项目结构，移除冗余文件，保持代码库整洁。主要删除archive/handover目录下的多个文件及doc目录下的部分文档模板。
This commit is contained in:
wurenzhi
2026-03-18 01:21:15 +08:00
parent 56b8a2e2f8
commit 72cd7f6f45
147 changed files with 5982 additions and 16716 deletions
Download Patch File Download Diff File Expand all files Collapse all files

84
docs/00_Business/Task_Overview.md
View File

@@ -1,6 +1,6 @@
# 🗂 Crawlful Hub AI开发任务总览（Task Overview）
> **说明**：本任务表基于30个业务闭环拆解，专为100% AI开发设计，包含完整的任务依赖、数据流、触发条件和状态管理。
> **说明**：本任务表基于35个业务闭环拆解，专为100% AI开发设计，包含完整的任务依赖、数据流、触发条件和状态管理。
---
@@ -33,13 +33,13 @@
| 模块 | 总任务数 | 已完成 | 进行中 | 待处理 | 失败 | 完成率 |
|------|----------|--------|--------|--------|------|--------|
| 前端模块 | 20 | 2 | 1 | 17 | 0 | 10% |
| 后端模块 | 33 | 15 | 2 | 16 | 0 | 45% |
| 插件模块 | 14 | 1 | 1 | 12 | 0 | 7% |
| AI模块 | 15 | 2 | 0 | 13 | 0 | 13% |
| 前端模块 | 30 | 2 | 0 | 28 | 0 | 7% |
| 后端模块 | 53 | 23 | 0 | 30 | 0 | 43% |
| 插件模块 | 14 | 1 | 0 | 13 | 0 | 7% |
| AI模块 | 17 | 3 | 0 | 14 | 0 | 18% |
| 数据模块 | 10 | 2 | 0 | 8 | 0 | 20% |
| 运维模块 | 3 | 2 | 0 | 1 | 0 | 67% |
| **总计** | **95** | **24** | **4** | **67** | **0** | **25%** |
| **总计** | **127** | **33** | **0** | **94** | **0** | **26%** |
---
@@ -58,7 +58,7 @@
| Task ID | 闭环关联 | 任务描述 | 输入 | 输出 | 触发条件 | 状态 | 优先级 | 依赖 | 预计耗时 | 负责人 |
|---------|----------|----------|------|------|----------|------|--------|------|----------|--------|
| FE-O001 | 订单履约闭环 | 渲染订单列表页面 | 用户ID, 筛选条件 | 订单列表数据 | 页面加载 | 🟡 in_progress | P0 | - | 3h | AI-Frontend-1 |
| FE-O001 | 订单履约闭环 | 渲染订单列表页面 | 用户ID, 筛选条件 | 订单列表数据 | 页面加载 | ⏳ pending | P0 | - | 3h | AI-Frontend-1 |
| FE-O002 | 订单履约闭环 | 渲染订单详情页面 | 订单ID | 订单详情数据 | 点击订单 | ⏳ pending | P1 | FE-O001 | 2.5h | AI-Frontend-2 |
| FE-O003 | 订单集中管理闭环 | 多平台订单聚合展示 | 平台ID, 时间范围 | 聚合订单数据 | 页面加载 | ⏳ pending | P1 | FE-O001 | 2h | AI-Frontend-3 |
| FE-O004 | 异常订单处理闭环 | 异常订单处理界面 | 订单ID | 处理结果 | 点击处理 | ⏳ pending | P1 | FE-O002 | 2h | AI-Frontend-3 |
@@ -138,6 +138,10 @@
| BE-P002 | SKU变体与结构闭环 | SKU变体管理接口 | 商品ID, 变体属性 | SKU ID, 库存 | 前端提交 | ✅ completed | P1 | BE-P001 | 1.5h | AI-Backend-1 |
| BE-P003 | 商品刊登闭环 | 商品刊登接口 | 商品ID, 平台ID | 刊登结果 | 前端提交 | ✅ completed | P0 | BE-P001 | 2h | AI-Backend-2 |
| BE-P004 | 定价与利润决策闭环 | 动态定价计算接口 | 商品ID, 市场数据 | 建议售价 | 定时触发 | ✅ completed | P1 | BE-P001 | 2.5h | AI-Backend-2 |
| BE-P005 | 数据采集与清洗闭环 | 平台API对接服务(Amazon MWS) | API凭证, 商品ASIN | 商品数据 | 定时任务 | ✅ completed | P0 | BE-P001 | 8h | AI-Backend-2 |
| BE-P006 | 数据采集与清洗闭环 | 平台API对接服务(eBay API) | OAuth令牌, 商品ID | 商品数据 | 定时任务 | ⏳ pending | P0 | BE-P001 | 8h | AI-Backend-2 |
| BE-P007 | 数据采集与清洗闭环 | 平台API对接服务(Shopee API) | API密钥, 商品ID | 商品数据 | 定时任务 | ⏳ pending | P0 | BE-P001 | 8h | AI-Backend-3 |
| BE-P008 | 数据采集与清洗闭环 | 平台同步Worker(BullMQ) | 同步任务, 五元组 | 同步结果 | 队列触发 | ✅ completed | P0 | BE-P005 | 4h | AI-Backend-2 |
### 2.2 订单管理后端
@@ -243,25 +247,65 @@
| BE-AUTH002 | 认证服务 | 权限管理 | 用户ID, 权限 | 权限列表 | 前端请求 | ⏳ pending | P2 | BE-AUTH001 | 8h | AI-Backend-11 |
| BE-AUTH003 | 认证服务 | 会话管理 | 用户ID, 令牌 | 会话信息 | 请求验证 | ⏳ pending | P2 | BE-AUTH001 | 8h | AI-Backend-11 |
### 2.15 多商户功能收费后端【P1 高优先级 - 新增】
| Task ID | 闭环关联 | 任务描述 | 输入 | 输出 | 触发条件 | 状态 | 优先级 | 依赖 | 预计耗时 | 负责人 |
|---------|----------|----------|------|------|----------|------|--------|------|----------|--------|
| BE-MV001 | 多商户入驻闭环 | 商户注册与认证接口 | 商户信息, 资质文件 | 商户ID, 状态 | 前端提交 | ⏳ pending | P1 | - | 12h | AI-Backend-12 |
| BE-MV002 | 多商户入驻闭环 | 商户店铺管理 | 商户ID, 店铺信息 | 店铺ID | 前端提交 | ⏳ pending | P1 | BE-MV001 | 10h | AI-Backend-12 |
| BE-MV003 | 功能模块化闭环 | 功能模块管理 | 模块ID, 配置 | 模块状态 | 系统配置 | ⏳ pending | P1 | BE-MV001 | 8h | AI-Backend-12 |
| BE-MV004 | 功能开通与支付闭环 | 功能开通接口 | 商户ID, 模块ID | 开通记录 | 前端提交 | ⏳ pending | P1 | BE-MV003 | 10h | AI-Backend-12 |
| BE-MV005 | 功能开通与支付闭环 | 功能费用计算 | 商户ID, 使用数据 | 费用明细 | 定时任务 | ⏳ pending | P1 | BE-MV004 | 8h | AI-Backend-12 |
| BE-MV006 | 多商户结算闭环 | 商户结算引擎 | 商户ID, 结算周期 | 结算单 | 定时任务 | ⏳ pending | P1 | BE-MV005 | 12h | AI-Backend-12 |
| BE-MV007 | 多商户订单闭环 | 多商户订单拆分 | 订单ID, 商户列表 | 子订单列表 | 订单创建 | ⏳ pending | P1 | BE-MV002 | 10h | AI-Backend-12 |
| BE-MV008 | 多商户库存闭环 | 多商户库存同步 | 商户ID, 库存数据 | 同步状态 | 库存变化 | ⏳ pending | P1 | BE-MV002 | 8h | AI-Backend-12 |
---
## 🔌 3️⃣ 插件模块（外部平台操作 / 调度）
### 3.1 平台采集插件
**对应业务闭环**: [1️⃣ 数据采集与清洗闭环](./Business_ClosedLoops.md#1️⃣-数据采集与清洗闭环product-data-collection--cleansing)
**采集策略**: 仅处理无API平台（TikTok Shop, Temu, 1688部分页面），有API平台由后端处理
| Task ID | 闭环关联 | 任务描述 | 输入 | 输出 | 触发条件 | 状态 | 优先级 | 依赖 | 预计耗时 | 负责人 |
|---------|----------|----------|------|------|----------|------|--------|------|----------|--------|
| PL-C001 | 数据采集与清洗闭环 | 多平台商品采集 | 平台账号, 采集配置 | 原始商品数据 | 定时任务 | ✅ completed | P0 | - | 3h | AI-Plugin-1 |
| PL-C002 | 数据采集与清洗闭环 | DOM解析逻辑 | HTML内容 | 结构化数据 | 采集完成 | <EFBFBD> in_progress | P1 | PL-C001 | 2h | AI-Plugin-2 |
| PL-C003 | 订单集中管理闭环 | 多平台订单采集 | 平台账号, 时间范围 | 订单数据 | 定时任务 | ⏳ pending | P0 | PL-C001 | 3h | AI-Plugin-1 |
| PL-C001 | 数据采集与清洗闭环 | 无API平台商品采集引擎 | 店铺ID, 平台类型, 采集配置, 指纹配置, 代理IP | 原始商品数据(JSON) | 定时任务/后端指令 | ✅ completed | P0 | - | 3h | AI-Plugin-1 |
| PL-C002 | 数据采集与清洗闭环 | DOM解析与数据提取 | HTML内容, CSS选择器配置 | 结构化商品数据 | 采集完成 | ⏳ pending | P1 | PL-C001 | 2h | AI-Plugin-2 |
| PL-C003 | 订单集中管理闭环 | 无API平台订单采集 | 店铺ID, 平台账号, 时间范围, 登录状态 | 订单数据(JSON) | 定时任务/后端指令 | ⏳ pending | P0 | PL-C001 | 3h | AI-Plugin-1 |
**技术约束**:
- 必须通过店铺隔离环境执行（独立指纹+代理IP）
- 采集频率受平台反爬限制，需实现自适应频率控制
- 数据通过HTTP POST上报后端，携带traceId和shopId
### 3.2 自动化操作插件
**对应业务闭环**: [1️⃣7️⃣ 店铺隔离与自动化闭环](./Business_ClosedLoops.md#1️⃣7️⃣-店铺隔离与自动化闭环shop-isolation--automation-loop)
**核心功能**: 店铺环境隔离 + 无API平台自动化操作
| Task ID | 闭环关联 | 任务描述 | 输入 | 输出 | 触发条件 | 状态 | 优先级 | 依赖 | 预计耗时 | 负责人 |
|---------|----------|----------|------|------|----------|------|--------|------|----------|--------|
| PL-A001 | 店铺隔离与自动化闭环 | 自动化登录与操作 | 店铺ID, 操作类型 | 操作结果 | 任务触发 | ⏳ pending | P1 | PL-C001 | 2.5h | AI-Plugin-2 |
| PL-A002 | 商家选择发货闭环 | 商家发货操作 | 订单ID, 发货信息 | 发货状态 | 商家操作 | ⏳ pending | P1 | PL-C003 | 2h | AI-Plugin-3 |
| PL-A003 | 物流策略与渠道选择闭环 | 物流状态同步 | 订单ID | 物流信息 | 定时任务 | ⏳ pending | P2 | PL-A002 | 1.5h | AI-Plugin-3 |
| PL-A001 | 店铺隔离与自动化闭环 | 浏览器指纹与代理管理 | 店铺ID, 指纹配置, 代理IP | 隔离环境上下文 | 店铺初始化 | ⏳ pending | P1 | PL-C001 | 2.5h | AI-Plugin-2 |
| PL-A002 | 商家选择发货闭环 | 无API平台自动化发货 | 订单ID, 发货信息, 店铺凭证 | 发货状态, 物流单号 | 后端指令 | ⏳ pending | P1 | PL-C003 | 2h | AI-Plugin-3 |
| PL-A003 | 物流策略与渠道选择闭环 | 物流状态同步 | 订单ID, 物流单号, 平台类型 | 物流轨迹数据 | 定时任务 | ⏳ pending | P2 | PL-A002 | 1.5h | AI-Plugin-3 |
**插件管理架构**:
```
后端(TaskScheduler) ──WebSocket──► 插件(Background) ──Chrome Message──► 内容脚本(Content)
▲ │
└────────────────── HTTP POST ─────────────────────────────────┘
```
**通讯协议**:
| 方向 | 协议 | 消息类型 | 用途 |
|------|------|----------|------|
| 后端→插件 | WebSocket | `TASK_ASSIGN` | 任务下发 |
| 插件→后端 | HTTP POST | `TASK_COMPLETE` | 结果上报 |
| 插件→后端 | HTTP POST | `HEARTBEAT` | 心跳保活 |
### 3.3 售后逆向插件【P0 阻塞核心业务】
@@ -409,10 +453,10 @@
|----------|------|----------|----------|----------|------|
| createProduct | 后端 | 商品基础信息 | 商品ID, 状态 | 用户提交 | ✅ completed |
| getProductList | 后端 | 筛选条件, 分页 | 商品列表 | 页面加载 | ✅ completed |
| createOrder | 后端 | 用户ID, 商品ID, 数量 | 订单ID, 状态 | 用户提交 | 🟡 in_progress |
| getOrderList | 后端 | 用户ID, 筛选条件 | 订单列表 | 页面加载 | 🟡 in_progress |
| createOrder | 后端 | 用户ID, 商品ID, 数量 | 订单ID, 状态 | 用户提交 | ✅ completed |
| getOrderList | 后端 | 用户ID, 筛选条件 | 订单列表 | 页面加载 | ✅ completed |
| syncInventory | 后端 | 商品ID, 库存变化 | 库存状态 | 库存变化 | ✅ completed |
| reconcileFinance | 后端 | 时间范围, 平台ID | 对账结果 | 定时任务 | 🟡 in_progress |
| reconcileFinance | 后端 | 时间范围, 平台ID | 对账结果 | 定时任务 | ✅ completed |
| fetchPlatformData | 插件 | 平台账号, 配置 | 原始数据 | 定时任务 | ✅ completed |
| analyzeArbitrage | AI | 商品价格, 成本 | 套利建议 | 数据更新 | ⏳ pending |
| createAdPlan | 后端 | 广告参数 | 广告ID | 前端提交 | ⏳ pending |
@@ -470,13 +514,19 @@
- ⏳ 测试用例与质量保证【P3】
- ⏳ 系统监控与告警优化
### Phase 5: 多商户功能收费（Week 9-10）【新增】
- ⏳ 商户注册与入驻闭环
- ⏳ 功能模块化与权限控制
- ⏳ 功能开通与支付闭环
- ⏳ 多商户结算与财务闭环
---
## 🎯 质量指标
| 指标 | 目标值 | 当前值 | 状态 |
|------|--------|--------|------|
| 任务完成率 | 100% | 25% | 🟡 需提升 |
| 任务完成率 | 100% | 21% | 🟡 需提升 |
| 代码测试覆盖率 | 80% | 30% | 🟡 需提升 |
| 接口响应时间 | <200ms | - | ⏳ 待测试 |
| 系统可用性 | 99.9% | - | ⏳ 待监控 |