wurenzhi
6d0d2b6157
refactor(server): 重构服务层代码结构 feat(server): 添加基础设施、跨境电商、AI决策等核心服务 docs: 完善前端业务说明书和开发进度文档 style: 格式化代码和文档
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+
安装依赖
# 后端依赖
cd server
npm install
# 前端依赖
cd ../dashboard
npm install
# 扩展依赖
cd ../extension
npm install
数据库初始化
# 执行数据库初始化脚本
mysql -u root -p < scripts/db-init.sql
启动服务
# 启动后端服务
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