Files
wecom_it_smart_desk/docs/02-技术文档/前端改造/前端改造建议-v1.0.md
T

133 lines
5.2 KiB
Markdown
Raw Normal View History

# IT智能服务台 — 前端改造建议
> **版本**: v1.1
> **日期**: 2026-07-10
> **作者**: 宋献
> **类型**: 技术 - 前端改造
> **源自**:
> - 方案-全套改造建议与推广-v1.0.md
> - 方案-前端评价与推广-v1.0.md
> **合并说明**: 本文档整合了两个方案文档中的前端改造建议内容
---
## 一、当前问题诊断
| 端 | 技术栈 | 主要问题 |
|----|--------|---------|
| H5端 | Vue3 + Vant4 | 功能完善但视觉老旧,参与者列表占空间大,缺少引导动画 |
| 坐席端 | Vue3 + Element Plus | 三栏工作台信息密度高但层次不清,组件风格不统一 |
| 管理后台 | Vue3 + Element + Tailwind | 功能齐全但数据可视化弱,仪表盘缺乏设计感 |
---
## 二、改造方案:统一设计系统
### 2.1 核心原则
一套设计令牌,三端共享,各自适配。
### 2.2 设计令牌层(Design Tokens
```
设计令牌层(Design Tokens
├── 色彩系统
│ ├── 主色 #07C160(企微绿,已在用)
│ ├── 辅助色 #3b82f6(坐席蓝)/ #FF9800(发起人橙)
│ ├── 语义色 success/warning/danger/info
│ └── 中性色 9级灰阶
├── 排版系统
│ ├── 字体:PingFang SC / Microsoft YaHei
│ ├── 字号:12/13/14/15/16/20/24/30
│ └── 行高:1.4/1.5/1.6
├── 间距系统
│ ├── 基准 4px,刻度 4/8/12/16/20/24/32/48
│ └── 组件内 padding12/16,卡片 padding16/20
├── 圆角系统
│ ├── sm 6px / md 8px / lg 12px / xl 16px / full 999px
│ └── 按钮用 md,卡片用 lg,弹窗用 xl
├── 阴影系统(克制使用)
│ ├── sm 0 1px 2px rgba(0,0,0,0.04)
│ ├── md 0 2px 8px rgba(0,0,0,0.06)
│ └── lg 0 4px 16px rgba(0,0,0,0.08)
└── 动效系统
├── 快速 150mshover/press
├── 标准 200ms(展开/收起)
└── 慢速 300ms(弹窗/页面过渡)
```
---
## 三、三端改造重点
| 端 | 改造重点 | 预期效果 |
|----|---------|---------|
| H5端 | 1. 群聊双模式落地 2. 首屏加载骨架屏 3. 消息发送动画 4. 空状态插画 5. 下拉刷新体验 | 聊天区域空间释放40%,视觉年轻化 |
| 坐席端 | 1. 三栏布局优化(可拖拽分栏) 2. 会话列表卡片重设计 3. 排查流程图可视化 4. 快捷键体系 5. 暗色模式 | 信息层次清晰,坐席效率提升 |
| 管理后台 | 1. 仪表盘数据可视化升级 2. 图表组件统一 3. 表格密度可调 4. 筛选器重设计 | 管理层数据一目了然 |
---
## 四、改造执行路径
```
Phase 1: 设计系统建立(2周)
→ 产出 design-tokens.css + 组件规范文档
→ 由设计原型专家团执行(design-system-expert + prototype-builder
Phase 2: H5端改造(3周)
→ 群聊双模式 + 视觉升级 + 动效
→ 逐页面替换旧样式
Phase 3: 坐席端改造(3周)
→ 布局优化 + 组件升级 + 排查流程图
→ 与H5端并行,互不阻塞
Phase 4: 管理后台改造(2周)
→ 仪表盘 + 图表 + 表格
→ 最后做,依赖前两端的组件沉淀
Phase 5: 联调与验收(1周)
→ 三端视觉一致性检查
→ 性能回归测试
```
---
## 五、知识图谱可视化(配合 Slogan)
为了让"7 次选择找到答案"有直观表达,建议新增:
| 端 | 改造内容 | 预期效果 |
|----|---------|---------|
| **H5 端** | 当 AI 给出答案时,在答案顶部显示一条「知识路径」:问题 → 网络 → VPN → 零信任 → 密码 → 账户锁定 → 解锁步骤,用横向节点图表示,最多 7 个节点,当前节点高亮 | 用户直观理解AI推理过程 |
| **坐席端** | 知识库引用面板增加「知识图谱」Tab,展示问题关联的知识点网络 | 坐席快速定位相关知识 |
| **管理后台** | 增加「知识图谱健康度」看板,展示知识节点覆盖率、关联度、7跳可达率 | 管理层掌握知识库质量 |
## 六、技术层面建议
| 建议 | 理由 |
|------|------|
| **A/B测试框架** | AI回复策略、置信度阈值等可A/B测试,数据驱动调优 |
| **灰度发布机制** | 前端改造分批灰度,降低全量发布风险 |
| **性能监控** | 接入前端性能监控(首屏时间、WS连接稳定性),量化体验提升 |
---
## 七、改造优先级总览
| 阶段 | 时间 | 内容 | 影响 |
|------|------|------|------|
| 近期(1-2 周) | 设计系统 v1.0 | 统一色彩、字体、圆角、图标 | 三端开始像一套产品 |
| 近期(3-4 周) | H5 结构优化 | 底部导航、浮层、空状态 | 员工体验提升最明显 |
| 中期(5-8 周) | 坐席端重构 | 三栏降噪、AI 面板合并、专注模式 | 坐席效率提升 |
| 中期(9-12 周) | 管理后台精调 | 深色模式对比度、数据可视化 | 运维体验提升 |
| 远期 | 知识图谱可视化 | H5/坐席/后台三端知识路径展示 | 支撑 Slogan 心智 |
---
> **关联文档**
> - 产品功能层面: `01-产品文档/00-产品规划/全套改造建议-产品功能层面-v1.0.md`
> - 技术架构优化: `02-技术文档/技术架构/技术架构优化建议-v1.0.md`
> - 前端视觉评价: `02-技术文档/前端改造/前端视觉评价-v1.0.md`