145 lines
2.6 KiB
Markdown
145 lines
2.6 KiB
Markdown
|
# Crawlful Hub
|
|||
|
|
|
|||
|
|
## 📋 项目简介
|
|||
|
|
|
|||
|
|
Crawlful Hub 是一个全自动化的跨境电商运营平台，集成了商品管理、订单处理、物流策略、广告营销、B2B贸易等核心功能，通过AI技术实现智能决策和自动化运营。
|
|||
|
|
|
|||
|
|
## 🚀 核心功能
|
|||
|
|
|
|||
|
|
### 1. 商品管理
|
|||
|
|
- 商品刊登与管理
|
|||
|
|
- 库存同步与管理
|
|||
|
|
- 商品健康度监控
|
|||
|
|
|
|||
|
|
### 2. 订单管理
|
|||
|
|
- 多平台订单集中管理
|
|||
|
|
- 订单履约与异常处理
|
|||
|
|
- 批量订单处理
|
|||
|
|
|
|||
|
|
### 3. 物流策略
|
|||
|
|
- 智能物流渠道选择
|
|||
|
|
- 运费计算与优化
|
|||
|
|
- 物流轨迹跟踪
|
|||
|
|
|
|||
|
|
### 4. 广告营销
|
|||
|
|
- 广告计划创建与管理
|
|||
|
|
- 投放效果分析
|
|||
|
|
- ROI优化
|
|||
|
|
|
|||
|
|
### 5. B2B贸易
|
|||
|
|
- 企业报价管理
|
|||
|
|
- 批量订单处理
|
|||
|
|
- 合同管理
|
|||
|
|
|
|||
|
|
### 6. 售后逆向
|
|||
|
|
- 退货申请处理
|
|||
|
|
- 退款流程管理
|
|||
|
|
- 客户服务
|
|||
|
|
|
|||
|
|
### 7. 合规与证书管理
|
|||
|
|
- 证书管理与过期提醒
|
|||
|
|
- 合规检查
|
|||
|
|
|
|||
|
|
### 8. 用户资产
|
|||
|
|
- 资产概览
|
|||
|
|
- 积分管理
|
|||
|
|
- 会员等级
|
|||
|
|
|
|||
|
|
### 9. A/B测试与策略优化
|
|||
|
|
- 测试策略推荐
|
|||
|
|
- 自动优化算法
|
|||
|
|
|
|||
|
|
## 🏗 项目架构
|
|||
|
|
|
|||
|
|
### 技术栈
|
|||
|
|
- **前端**: React, TypeScript, UmiJS, Tailwind CSS
|
|||
|
|
- **后端**: Node.js, Express, TypeScript
|
|||
|
|
- **数据库**: MySQL
|
|||
|
|
- **缓存**: Redis
|
|||
|
|
- **消息队列**: BullMQ
|
|||
|
|
- **AI**: 集成多种AI服务
|
|||
|
|
|
|||
|
|
### 模块结构
|
|||
|
|
- **dashboard**: 前端管理控制台
|
|||
|
|
- **server**: 后端服务
|
|||
|
|
- **extension**: 浏览器扩展
|
|||
|
|
- **node-agent**: 节点代理
|
|||
|
|
- **scripts**: 脚本工具
|
|||
|
|
- **docs**: 项目文档
|
|||
|
|
|
|||
|
|
## 📦 快速开始
|
|||
|
|
|
|||
|
|
### 环境要求
|
|||
|
|
- Node.js 16+
|
|||
|
|
- MySQL 8.0+
|
|||
|
|
- Redis 6.0+
|
|||
|
|
|
|||
|
|
### 安装依赖
|
|||
|
|
|
|||
|
|
```bash
|
|||
|
|
# 后端依赖
|
|||
|
|
cd server
|
|||
|
|
npm install
|
|||
|
|
|
|||
|
|
# 前端依赖
|
|||
|
|
cd ../dashboard
|
|||
|
|
npm install
|
|||
|
|
|
|||
|
|
# 扩展依赖
|
|||
|
|
cd ../extension
|
|||
|
|
npm install
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
### 数据库初始化
|
|||
|
|
|
|||
|
|
```bash
|
|||
|
|
# 执行数据库初始化脚本
|
|||
|
|
mysql -u root -p < scripts/db-init.sql
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
### 启动服务
|
|||
|
|
|
|||
|
|
```bash
|
|||
|
|
# 启动后端服务
|
|||
|
|
cd server
|
|||
|
|
npm run dev
|
|||
|
|
|
|||
|
|
# 启动前端服务
|
|||
|
|
cd ../dashboard
|
|||
|
|
npm run dev
|
|||
|
|
|
|||
|
|
# 构建扩展
|
|||
|
|
cd ../extension
|
|||
|
|
npm run build
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
## 📚 文档
|
|||
|
|
|
|||
|
|
- **业务蓝图**: `docs/00_Business/`
|
|||
|
|
- **架构设计**: `docs/01_Architecture/`
|
|||
|
|
- **后端文档**: `docs/02_Backend/`
|
|||
|
|
- **前端文档**: `docs/03_Frontend/`
|
|||
|
|
- **插件文档**: `docs/04_Plugin/`
|
|||
|
|
- **AI策略**: `docs/05_AI/`
|
|||
|
|
- **测试文档**: `docs/07_Testing/`
|
|||
|
|
|
|||
|
|
## 🔧 开发规范
|
|||
|
|
|
|||
|
|
### 代码规范
|
|||
|
|
- 遵循 TypeScript 最佳实践
|
|||
|
|
- 使用 ESLint 进行代码检查
|
|||
|
|
- 提交代码前运行 `npm run check` 进行类型检查
|
|||
|
|
|
|||
|
|
### 提交规范
|
|||
|
|
- 提交信息使用中文描述
|
|||
|
|
- 提交前确保代码通过测试
|
|||
|
|
- 大型功能提交前创建分支
|
|||
|
|
|
|||
|
|
## 🤝 贡献
|
|||
|
|
|
|||
|
|
欢迎贡献代码和提出建议！请先阅读项目文档，然后提交 Pull Request。
|
|||
|
|
|
|||
|
|
## 📄 许可证
|
|||
|
|
|
|||
|
|
MIT License
|