wurenzhi
cd55097dbf
删除旧的docs11目录及其所有内容，包括： - 业务蓝图文档(business-blueprint.md) - 数据API规范(data-api-specs.md) - 系统架构文档(system-architecture.md) - 模块蓝图文档(module-blueprints.md) - 治理标准文档(governance-standards.md) - 质量标准文档(quality-optimization.md) - 任务总览文档(Crawlful_Hub_Task_Overview_Full_v1.md) - README.md等文件 同时更新了docs目录下的现有文档： - 更新SERVICE_MAP.md强化服务层职责和调用规范 - 更新Service_Design.md明确服务层设计规范和边界 - 更新项目规则文档加入逻辑集中化原则 - 统一调整了文档表格格式和结构
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