refactor: 优化代码结构并修复类型问题

- 移除未使用的TabPane组件 - 修复类型定义和导入方式 - 优化mock数据源的环境变量判断逻辑 - 更新文档结构并归档旧文件 - 添加新的UI组件和Memo组件 - 调整API路径和响应处理
2026-03-23 12:41:35 +08:00
parent a037843851
commit 2b86715c09
363 changed files with 39305 additions and 40622 deletions
--- a/docs/README.md
+++ b/docs/README.md
@@ -1,128 +1,78 @@
-# Crawlful Hub 文档中心
+# 🤖 Crawlful Hub - AI开发入口

-> **定位**：Crawlful Hub 项目完整文档库 - 涵盖业务、架构、技术实现及运维指南。  
-> **最后更新**：2026-03-21
+> **唯一入口**: 所有AI开发工作从这里开始

 ---

-## 📊 项目状态看板
+## 📊 当前状态

-| 模块 | 完成度 | 状态 |
-|------|--------|------|
-| 业务层 | 100% | ✅ 完成 |
-| 架构层 | 100% | ✅ 完成 |
-| 后端 | 100% | ✅ 完成 |
-| 前端 | 100% | ✅ 完成 |
-| 插件 | 100% | ✅ 完成 |
-| AI | 100% | ✅ 完成 |
-| 测试 | 100% | ✅ 完成 |
-| 文档 | 100% | ✅ 完成 |
-
-**任务统计**：126个任务 | 31已完成 | 0进行中 | 95待处理 | 完成率25%
+| 指标 | 值 |
+|------|-----|
+| 总体完成率 | 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/
-├── 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
+├── README.md          ← 你在这里
+├── RULES/             # 硬性规则
+├── TASKS/             # 任务中心
+├── ARCH/              # 系统架构
+├── SERVICES/          # 服务地图
+├── LOOPS/             # 业务闭环
+└── ARCHIVE/           # 历史归档
 ```

 ---

-## 📋 核心文档（必读）
+## 🔗 外部资源

-| 文档 | 路径 | 说明 |
-|------|------|------|
-| 📋 业务闭环 | [00_Business/Business_ClosedLoops.md](./00_Business/Business_ClosedLoops.md) | 69个完整业务闭环流程 |
-| 🏗️ 业务蓝图 | [00_Business/Business_Blueprint.md](./00_Business/Business_Blueprint.md) | 功能规格与行业标杆 |
-| 📋 任务总览 | [00_Business/Task_Overview.md](./00_Business/Task_Overview.md) | 任务追踪（唯一任务源） |
-| 🏛️ 架构索引 | [01_Architecture/00_Architecture_Index.md](./01_Architecture/00_Architecture_Index.md) | 架构文档总览 |
-| 📐 模块蓝图 | [01_Architecture/05_Module_Blueprints.md](./01_Architecture/05_Module_Blueprints.md) | 各模块详细设计 |
+- **项目规则**: `.trae/rules/project-specific-rules.md`
+- **代码库**: `server/src/`, `dashboard/src/`, `node-agent/src/`

 ---

-## 🚀 快速开始
-
-### 新人入门
-
-1. **了解业务**：阅读 [Business_ClosedLoops.md](./00_Business/Business_ClosedLoops.md) 了解69个业务闭环
-2. **理解架构**：阅读 [01_Architecture_Index.md](./01_Architecture/00_Architecture_Index.md) 了解系统架构
-3. **查看任务**：阅读 [Task_Overview.md](./00_Business/Task_Overview.md) 了解当前任务状态
-4. **熟悉规范**：阅读 [Governance_Standards.md](./00_Business/Governance_Standards.md) 了解开发规范
-
-### 开发人员
-
-| 角色 | 必读文档 |
-|------|----------|
-| **后端开发** | [00_Backend_Index.md](./02_Backend/00_Backend_Index.md) + [api/](./02_Backend/api/) |
-| **前端开发** | [00_Frontend_Index.md](./03_Frontend/00_Frontend_Index.md) + [UI_Components.md](./03_Frontend/05_UI_Components.md) |
-| **插件开发** | [00_Plugin_Index.md](./04_Plugin/00_Plugin_Index.md) + [02_DOM_Interaction.md](./04_Plugin/02_DOM_Interaction.md) |
-| **AI开发** | [00_AI_Index.md](./05_AI/00_AI_Index.md) + [Task_Overview.md](./00_Business/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](./10_Documents_Global/DOC_INDEX.md)
+*最后更新: 2026-03-23*