makemd/docs/README.md

# 🤖 Crawlful Hub - AI开发入口

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

---

## 📊 当前状态

> **数据来源**: [TASKS/P2_enhancement.md](TASKS/P2_enhancement.md) | **最后更新**: 2026-03-23

| 指标 | 值 | 说明 |
|------|-----|------|
| P0 阻塞性任务 | 100% (1/1) | 核心基础功能已完成 |
| P1 高优先级任务 | 100% (2/2) | 重要业务功能已完成 |
| P2 优化类任务 | 0% (0/101) | 待开发优化任务 |
| **总体完成率** | **2.9% (3/104)** | 仅统计当前活跃任务 |

### 历史完成统计（已归档）
- 前期开发阶段已完成 127/132 任务（96.2%）
- 详细历史记录见 [TASKS/completed.md](TASKS/completed.md)

---

## 🚀 快速导航

| 我要做什么 | 去哪里 |
|-----------|--------|
| **领取任务** | [TASKS/_index.md](TASKS/_index.md) |
| **待开发任务** | [TASKS/P3_development.md](TASKS/P3_development.md) |
| **任务与代码映射** | [TASKS/code_mapping.md](TASKS/code_mapping.md) |
| **已完成任务** | [TASKS/completed.md](TASKS/completed.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/             # 业务闭环
├── api/               # API文档
└── archive/           # 历史归档
```

---

## 🔗 外部资源

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

---

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