wurenzhi/makemd

Files

wurenzhi 56b8a2e2f8 docs: 新增业务闭环文档并重构文档结构

新增业务闭环文档，包含商品主数据、SKU变体、订单拆分等关键闭环
重构文档目录结构，迁移旧文档至新路径
补充业务功能说明文档内容
更新全局文档索引和项目地图

2026-03-18 00:35:00 +08:00

1.5 KiB

Raw Blame History

💎 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 索引，确保全量文档导航。
定期审查文档结构，确保与物理文件系统保持一致。