feat: 添加前端页面和业务说明书

refactor(server): 重构服务层代码结构
feat(server): 添加基础设施、跨境电商、AI决策等核心服务
docs: 完善前端业务说明书和开发进度文档
style: 格式化代码和文档
This commit is contained in:
2026-03-18 19:12:38 +08:00
parent c932a67be2
commit 6d0d2b6157
140 changed files with 23859 additions and 5833 deletions

View File

@@ -1,6 +1,6 @@
# 📌 Crawlful Hub 业务闭环TOC + TOB Unified Business Loops
> **说明**:本闭环文档是战略层业务流程,关注"做什么、为什么做、顺序和决策点"为下层模块功能和系统实现提供指引。TOC零售/前端)和 TOBB2B贸易共享通用模块特有流程用 `businessType` 标记。共 **45个业务闭环**。
> **说明**:本闭环文档是战略层业务流程,关注"做什么、为什么做、顺序和决策点"为下层模块功能和系统实现提供指引。TOC零售/前端)和 TOBB2B贸易共享通用模块特有流程用 `businessType` 标记。共 **50个业务闭环**。
## 📑 目录
@@ -49,6 +49,11 @@
43. [商业化与增长闭环](#4⃣3⃣-商业化与增长闭环monetization--growth-loop)
44. [服务编排与执行闭环](#4⃣4⃣-服务编排与执行闭环service-orchestration-loop)
45. [增长飞轮闭环](#4⃣5⃣-增长飞轮闭环growth-flywheel-loop)
46. [技术基础设施闭环](#4⃣6⃣-技术基础设施闭环technical-infrastructure-loop)
47. [客户服务闭环](#4⃣7⃣-客户服务闭环customer-service-loop)
48. [跨境电商闭环](#4⃣8⃣-跨境电商闭环cross-border-e-commerce-loop)
49. [AI驱动智能决策闭环](#4⃣9⃣-ai驱动智能决策闭环ai-driven-smart-decision-loop)
50. [核心服务优先级闭环](#5⃣0⃣-核心服务优先级闭环core-service-priority-loop)
41. [统一闭环依赖](#🔹-统一闭环依赖toc--tob)
42. [闭环依赖关系](#🔗-闭环依赖关系toc--tob)
43. [关键绩效指标](#📊-关键绩效指标kpi)
@@ -107,6 +112,15 @@
| 插件 | 网页采集器 | `crawlerService.ts` | PL-C001, PL-C002 |
| 插件 | DOM解析 | `amazonCrawler.ts`, `tiktokCrawler.ts` | PL-C002 |
| AI | 套利分析 | `ArbitrageService.ts` | AI-A001 |
- **💰 钱流**
- 采集成本API调用费用、代理IP费用、云服务费用
- 利润评估:采购成本 → 平台费用 → 物流费用 → 税费 → 广告费用 → 净利润
- **🔄 状态变化**
- `RAW_DATA``CLEANED``ANALYZED``READY_FOR_LISTING`
- **🔥 触发条件**
- 定时任务:按配置的采集频率自动触发
- 手动触发:用户手动发起采集任务
- 事件触发:商品价格变动、库存变动等事件触发重新采集
***
@@ -129,6 +143,15 @@
- TOB 需遵循阶梯价审批策略
- **输入**:清洗后的可售商品数据
- **输出**:已刊登商品列表 + 平台状态 + 链接
- **💰 钱流**
- 刊登成本:平台费用、图片处理费用、人工费用
- 定价策略:成本价 → 平台费用 → 物流费用 → 预期利润 → 最终售价
- **🔄 状态变化**
- `READY_FOR_LISTING``LISTING_IN_PROGRESS``LISTED``MONITORING``NEED_UPDATE``UPDATED`
- **🔥 触发条件**
- 手动触发:用户手动发起刊登任务
- 事件触发:商品信息更新、价格变动、库存变动
- 定时任务:定期检查商品状态,更新价格和库存
***
@@ -1600,6 +1623,164 @@ Controller
***
## 4⃣6⃣ 技术基础设施闭环Technical Infrastructure Loop
- **目标**:提供稳定、高效、可扩展的技术基础设施,支撑核心业务流程的运行。
- **流程**
1. **服务管理**
- 服务注册与发现
- 服务健康检查与监控
- 服务版本管理与部署
2. **数据管理**
- 缓存策略与优化
- 数据库性能优化
- 数据备份与恢复
3. **消息处理**
- 消息队列管理
- 异步操作处理
- 事件总线管理
4. **安全与合规**
- 数据传输加密
- 访问控制与权限管理
- 日志审计与追踪
- **决策点**
- 服务健康状态评估
- 性能瓶颈识别与优化
- 安全风险评估与应对
- **输入**:系统配置、服务状态数据、性能指标
- **输出**:技术基础设施状态报告、优化建议、安全审计报告
***
## 4⃣7⃣ 客户服务闭环Customer Service Loop
- **目标**:提供高效、专业的客户服务,解决客户问题,提升客户满意度。
- **流程**
1. **客户咨询处理**
- 咨询接收与分类
- 智能客服响应
- 人工客服介入
2. **争议与投诉处理**
- 争议接收与评估
- 证据收集与分析
- 解决方案制定与执行
3. **售后服务**
- 退货退款处理
- 产品质量问题处理
- 售后跟踪与反馈
4. **客户反馈管理**
- 反馈收集与分析
- 改进建议生成
- 服务质量评估
- **决策点**
- 争议类型识别与处理策略
- 退款审批与执行
- 服务质量评估与改进
- **输入**:客户咨询、争议信息、售后请求、客户反馈
- **输出**:服务响应、争议解决方案、售后处理结果、客户满意度报告
***
## 4⃣8⃣ 跨境电商闭环Cross-Border E-Commerce Loop
- **目标**:支持跨境电商全流程,解决清关、物流、支付等痛点。
- **流程**
1. **跨境商品管理**
- 商品合规性检查
- 关税计算与预估
- 商品分类与HS编码管理
2. **清关服务**
- 自动生成清关文件
- 海关申报与追踪
- 关税和税费处理
3. **跨境物流**
- 国际物流渠道选择
- 运费计算与优化
- 物流轨迹追踪
- 跨境仓储管理
4. **跨境支付**
- 多币种支付支持
- 汇率管理与优化
- 跨境支付安全
5. **合规管理**
- 出口/进口法规遵守
- 税务合规与申报
- 产品认证与标准
- **决策点**
- 物流渠道选择成本vs时效
- 清关策略自行清关vs代理清关
- 支付方式选择安全性vs便捷性
- 合规风险评估
- **输入**:商品信息、订单数据、目的地国家/地区、支付信息
- **输出**:清关文件、物流信息、支付状态、合规报告
- **状态机**`PENDING` → `PROCESSING` → `CLEARANCE` → `SHIPPING` → `DELIVERED`
***
## 4⃣9⃣ AI驱动智能决策闭环AI-Driven Smart Decision Loop
- **目标**利用AI技术提升运营效率和决策准确性实现智能化运营。
- **流程**
1. **数据采集与处理**
- 多源数据整合
- 数据清洗与预处理
- 特征工程与选择
2. **AI模型训练与部署**
- 模型选择与训练
- 模型评估与优化
- 模型部署与监控
3. **智能决策应用**
- 智能定价与动态调价
- 智能库存预测与补货
- 智能广告投放与优化
- 智能客户服务与售后
- 智能风控与异常检测
4. **决策执行与反馈**
- 决策执行与监控
- 效果评估与分析
- 模型迭代与优化
- **决策点**
- 模型选择监督学习vs无监督学习
- 预测结果置信度阈值
- 人工干预时机
- 模型更新频率
- **输入**:业务数据、市场数据、用户行为数据
- **输出**:智能决策建议、预测结果、优化方案
- **状态机**`DATA_COLLECTION` → `MODEL_TRAINING` → `DECISION_MAKING` → `EXECUTION` → `FEEDBACK`
***
## 5⃣0⃣ 核心服务优先级闭环Core Service Priority Loop
- **目标**:确定核心业务服务的优先级顺序,确保资源合理分配。
- **流程**
1. **服务评估**
- 业务价值评估
- 技术复杂度评估
- 资源需求评估
- 风险评估
2. **优先级排序**
- 基于业务价值的排序
- 基于依赖关系的排序
- 基于时间窗口的排序
3. **资源分配**
- 人力分配
- 技术资源分配
- 时间规划
4. **执行监控**
- 进度跟踪
- 资源使用监控
- 风险预警
- **决策点**
- 优先级调整时机
- 资源重新分配决策
- 项目范围变更管理
- **输入**:服务需求、业务目标、资源状况
- **输出**:优先级排序结果、资源分配计划、执行进度报告
- **状态机**`ASSESSMENT` → `PRIORITIZATION` → `RESOURCE_ALLOCATION` → `EXECUTION` → `MONITORING`
***
### 📋 业务审核状态机
- **通用审核流程**`SUBMITTED` (提交) → `PENDING_REVIEW` (人工审核) → `EXECUTED` / `REJECTED`