wurenzhi/makemd

Files

Ansonai 6759d47de4 docs: 新增V30.0版本相关设计文档与指南

新增服务器启动文档、设计说明书、风险清单等核心文档
补充前端集成蓝图、多租户实施清单、上线红线检查清单
添加质量保障文档与早期业务规格书

2026-03-16 01:31:26 +08:00

2.0 KiB

Raw Blame History

前端高完成度保障机制 (V30.0)

1. 交付标准

1.1 UI 一致性

对标 Ant Design 5.0：组件使用、色彩体系、间距规范
响应式适配：桌面端 (≥1200px) / 平板端 (768-1199px) / 移动端 (<768px)
主题配置：支持亮色/暗色主题切换，CSS 变量统一管理
图标规范：使用统一图标库 (Ant Design Icons)

1.2 UX 透明度

AGI 决策因果链路可视化：每个 AI 建议必须展示决策原因
加载状态全覆盖：骨架屏 / Loading 动画 / 进度条
错误处理：统一的错误提示组件，支持重试机制
空状态：友好的空数据展示与引导操作

2. 评分维度

维度	权重	评分细则
代码质量	30%	TypeScript 类型完整、无 any、单元测试覆盖率 >80%
交互体验	30%	响应速度 <200ms、动画流畅、Accessibility 合规
AGI 透明度	40%	因果链完整、可解释性高、人工可干预

3. 交付检查清单

3.1 代码层面

TypeScript strict 模式无报错
ESLint/Prettier 检查通过
组件 Props 定义完整，附带 JSDoc
无 hardcoded 字符串 (使用 i18n)

3.2 交互层面

所有按钮有点击反馈 (Hover/Active)
表单提交有 Loading 状态
键盘导航完整 (Tab / Enter / Escape)
移动端 touch 事件适配

3.3 AGI 透明度层面

AI 建议展示 "为何建议" 展开项
置信度/信心指数可视化
支持人工 override 并记录原因
决策日志可追溯

4. AGI 透明度评估标准

等级	描述	要求
L1	基础展示	仅展示 AI 建议结果
L2	因果展示	展示决策原因 (因果链)
L3	可干预	支持人工修改建议参数
L4	可追溯	完整决策日志与审计

标准制定: AI-2 (Internal) 更新日志: [AI-3 @ 2026-03-15] 补充评分细则与交付检查清单