makemd/docs

Crawlful Hub 文档中心

定位：Crawlful Hub 项目完整文档库 - 涵盖业务、架构、技术实现及运维指南。
最后更新：2026-03-21

---

📊 项目状态看板

模块	完成度	状态
业务层	100%	✅ 完成
架构层	100%	✅ 完成
后端	100%	✅ 完成
前端	100%	✅ 完成
插件	100%	✅ 完成
AI	100%	✅ 完成
测试	100%	✅ 完成
文档	100%	✅ 完成

任务统计：126个任务 | 31已完成 | 0进行中 | 95待处理 | 完成率25%

---

📁 文档目录结构

docs/
├── 00_Business/              # 业务层文档
│   ├── Business_ClosedLoops.md
│   ├── Business_Blueprint.md
│   ├── Governance_Standards.md
│   ├── Task_Overview.md
│   ├── Task_Completion_Time_Spec.md
│   ├── Business_ClosedLoops/ # 业务闭环子目录
│   └── tasks/                # 任务子文档
│       ├── frontend/         # 前端任务（12个）
│       ├── backend/          # 后端任务（24个）
│       └── shared/           # 共享任务（13个）
├── 01_Architecture/          # 架构层文档
│   ├── 00_Architecture_Index.md
│   ├── 01_System.md ~ 12_Operation_Agent.md
│   └── frontend/             # 前端架构子目录
├── 02_Backend/               # 后端文档
│   ├── 00_Backend_Index.md
│   ├── 01_Design.md ~ 07_RBAC_Design.md
│   └── api/                  # API规范子目录
├── 03_Frontend/              # 前端文档
│   ├── 00_Frontend_Index.md
│   └── 01_Design.md ~ 06_Pages_Flow.md
├── 04_Plugin/                # 插件文档
│   ├── 00_Plugin_Index.md
│   └── 01_Plugin_Design.md ~ 02_DOM_Interaction.md
├── 05_AI/                    # AI文档
│   ├── 00_AI_Index.md
│   └── 01_Strategy.md ~ 03_Module_List.md
├── 06_Reports/               # 报告文档（新增）
│   ├── 00_Reports_Index.md
│   └── 01_Business_ClosedLoop.md ~ 04_Temporary.md
├── 07_Testing/               # 测试文档
│   ├── 00_Testing_Index.md
│   └── 01_Test_Spec.md ~ 02_Quality_Optimization.md
├── 08_Analysis/              # 分析文档（新增）
│   ├── 00_Analysis_Index.md
│   └── 01_Business_Service_Mapping.md ~ 06_Runtime_Architecture.md
└── 10_Documents_Global/      # 全局文档
    ├── DOC_INDEX.md
    └── PROJECT_MAP.md

---

📋 核心文档（必读）

文档	路径	说明
📋 业务闭环	00_Business/Business_ClosedLoops.md	69个完整业务闭环流程
🏗️ 业务蓝图	00_Business/Business_Blueprint.md	功能规格与行业标杆
📋 任务总览	00_Business/Task_Overview.md	任务追踪（唯一任务源）
🏛️ 架构索引	01_Architecture/00_Architecture_Index.md	架构文档总览
📐 模块蓝图	01_Architecture/05_Module_Blueprints.md	各模块详细设计

---

🚀 快速开始

新人入门

1. 了解业务：阅读 Business_ClosedLoops.md 了解69个业务闭环
2. 理解架构：阅读 01_Architecture_Index.md 了解系统架构
3. 查看任务：阅读 Task_Overview.md 了解当前任务状态
4. 熟悉规范：阅读 Governance_Standards.md 了解开发规范

开发人员

角色	必读文档
后端开发	00_Backend_Index.md + api/
前端开发	00_Frontend_Index.md + UI_Components.md
插件开发	00_Plugin_Index.md + 02_DOM_Interaction.md
AI开发	00_AI_Index.md + Task_Overview.md

---

📋 文档规范

命名规范

• 索引文件：00_Module_Index.md
• 主文档：XX_Name.md（两位数字前缀 + 帕斯卡命名）
• 子目录：小写复数形式，如 api/、frontend/

内容规范

• 使用 Markdown 格式
• 包含清晰的标题层级
• 适当使用表格、代码块、流程图等
• 标注文档最后更新时间

优先级标注

• 最高优先级参考：Business_ClosedLoops.md - 所有技术实现必须基于业务闭环
• 冲突情况下，优先保留业务闭环文档的内容

---

🔗 相关资源

• 项目根目录：d:\trae_projects\makemd\makemd
• 项目规则：.trae/rules/project-specific-rules.md
• 文档索引：10_Documents_Global/DOC_INDEX.md