# 💎 Quality & Optimization (Crawlful Hub)

> **定位**：Crawlful Hub 质量保障与内容优化 - 包含前端交付标准、UX 检查清单及文档内容分析报告。
> **更新日期**: 2026-03-17

---

## 1. 前端交付质量标准 (Frontend Delivery)

### 1.1 UI/UX 规范
- **框架**: UmiJS 4.x, Ant Design 5.x.
- **交互模式**: 业务审核工作流 (Business-Review-Workflow).
- **Red Lines (严禁事项)**: 严禁 Mock 数据、严禁越权修改、严禁敏感数据暴露。

### 1.2 性能优化
- **加载**: Code Splitting, Lazy Loading.
- **请求**: TanStack Query 缓存, 减少重渲染.

---

## 2. 用户体验检查清单 (UX Checklist)

### 2.1 加载与响应
- [ ] 异步操作展示 Loading 状态。
- [ ] 长时操作展示进度。
- [ ] 按钮点击反馈即时。

### 2.2 错误与异常
- [ ] 4xx 错误展示具体根因分析，而非模糊的“系统错误”。
- [ ] 5xx 错误展示友好提示并记录 `traceId`。

---

## 3. 文档内容分析报告 (Document Review)

### 3.1 质量与优化
- **命名规范**: 文件名必须使用小写短横线 (kebab-case)。
- **分类存放**: `docs/blueprints/`, `docs/quality/` 等。
- **引用闭环**: 文档内引用必须使用完整 Markdown 链接。
- **原子化更新**: 每次功能变更必须同步更新对应蓝图。

### 3.2 文档地图
- 建议维护 `doc-index.md` 索引，确保全量文档导航。
- 定期审查文档结构，确保与物理文件系统保持一致。
