makemd/docs/README.md

# 🤖 Crawlful Hub - AI开发入口

> **唯一入口**: 所有AI开发工作从这里开始

---

## 📊 当前状态

| 指标 | 值 |
|------|-----|
| 总体完成率 | 96.2% (127/132) |
| 后端服务 | 87.5% (42/48) |
| 前端页面 | 100% (35/35) |
| 插件适配器 | 100% (13/13) |
| AI分析 | 100% (7/7) |
| 前端优化 | 100% (6/6) |

---

## 🚀 快速导航

| 我要做什么 | 去哪里 |
|-----------|--------|
| **领取任务** | [TASKS/_index.md](TASKS/_index.md) |
| **查看规则** | [RULES/_index.md](RULES/_index.md) |
| **理解架构** | [ARCH/_index.md](ARCH/_index.md) |
| **开发服务** | [SERVICES/_index.md](SERVICES/_index.md) |
| **查看闭环** | [LOOPS/_index.md](LOOPS/_index.md) |

---

## ⚠️ 硬性约束速查

```typescript
// 数据库
表前缀: 'cf_'           // 如 cf_product, cf_order
金额类型: decimal(10,2)  // 禁止 float/double

// 业务类型
TOC: 零售/C端
TOB: 企业/B端
// 禁止使用 B2C/B2B

// 架构
禁止: Controller 写业务逻辑
必须: Service 层处理所有业务逻辑
必须: 使用 authorize() 中间件校验权限

// 利润红线
B2B利润率 < 15%: 禁止报价
B2C利润率 < 20%: 触发风控预警
```

---

## <20> 文档结构

```
docs/
├── README.md          ← 你在这里
├── RULES/             # 硬性规则
├── TASKS/             # 任务中心
├── ARCH/              # 系统架构
├── SERVICES/          # 服务地图
├── LOOPS/             # 业务闭环
└── ARCHIVE/           # 历史归档
```

---

## 🔗 外部资源

- **项目规则**: `.trae/rules/project-specific-rules.md`
- **代码库**: `server/src/`, `dashboard/src/`, `node-agent/src/`

---

*最后更新: 2026-03-23*