Files
wecom_it_smart_desk/docs/02-技术文档/技术架构/技术架构优化建议-v1.0.md
T
Simon 44e77dcb0e chore(docs): docs/ 目录全面重新编号 + 重组
**重构前**(旧编号 02-11):
- docs/02-产品需求/      → 00 产品规划/PRD
- docs/03-技术架构/      → 01-05 子目录散落
- docs/04-原型设计/      → 01-02 产品设计(HTML 原型)
- docs/05-原型设计/      → screens/
- docs/06-测试素材/      → 02-E2E / 03-功能 / 04-版本测试
- docs/07-项目管理/      → 任务说明书/日报/计划
- docs/08-安全审计/      → 审计报告
- docs/09-堡垒运维/      → toolbox / deploy
- docs/10-项目管理/      → 任务说明书(重复)
- docs/11-历史归档/      → deploy-nas-archived

**重构后**(新编号 00-07,语义化):
- docs/00-产品开发流程与文档管理规范.md
- docs/00-版本迭代总览.md
- docs/01-产品文档/      (PRD/原型/认证/会话/AI 服务/坐席/集成)
- docs/02-技术文档/      (技术方案/架构图/重构记录/前端改造/实现配置)
- docs/03-测试文档/      (E2E/功能用例/版本报告/缺陷单)
- docs/04-运维文档/      (部署运维/运维指南)
- docs/05-运营文档/      (品牌推广/用户手册)
- docs/06-安全审计/      (审计报告)
- docs/07-项目管理/      (任务说明书/日报/计划/看板)

**净收益**:
- 目录编号与产品文档管理规范对齐(按文档阶段 01-07 编号)
- 消除 02-产品需求 与 10-项目管理 的编号重叠
- 子目录按文档类型分组(如 01-产品文档/00-产品规划、01-产品文档/01-认证与登录)
- 把运维/安全/项目管理从 0X 散落改为 04/06/07

合计 494 文件 + 78495 行 / - 14076 行
2026-08-03 18:46:55 +08:00

54 lines
2.2 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# IT智能服务台 — 技术架构优化建议
> **版本**: v1.0
> **日期**: 2026-07-10
> **作者**: 宋献
> **类型**: 技术 - 架构优化
> **源自**: 方案-全套改造建议与推广-v1.0.md
---
## 一、后端架构优化
| 改造项 | 现状 | 建议 |
|--------|------|------|
| **WS断连体验** | 断连后3秒轮询降级,但用户无感知 | 增加"网络重连中"toast提示,重连成功后自动恢复 |
| **消息缓存策略** | `h5_messages_cache` 7天/100条 | 增加缓存命中率监控,按会话热度动态调整上限 |
| **头像代理** | `/api/avatar/proxy` 解决COEP/CSP | 增加缓存层,避免每次请求都代理 |
| **审批意图识别** | Dify API Key已配置 | 增加fallback策略,Dify不可用时降级为关键词匹配 |
| **历史消息共享** | P1-20 待开发 | 邀请时支持选择共享范围(全部/最近N条/从某条开始) |
---
## 二、日志与监控优化
| 建议 | 理由 |
|------|------|
| **日志结构化** | 后端日志增加结构化字段(会话ID/坐席ID/操作类型),便于审计分析 |
| **性能监控** | 接入前端性能监控(首屏时间、WS连接稳定性),量化体验提升 |
---
## 三、技术债务与重构
| 改造项 | 价值 | 关键动作 |
|--------|------|---------|
| **知识库真可用** | 知识建议→训练师审批→入库→AI引用,全闭环 | 1. 取消注释 `knowledge_iteration_router` 2. 挂载API 3. Neo4j图存储写入 4. 审批流打通 |
| **置信门控** | 低置信度问题自动转人工 | Dify 返回 confidence score → 阈值判断 → 自动转人工 |
---
## 四、技术层面其他建议
| 建议 | 理由 |
|------|------|
| **A/B测试框架** | AI回复策略、置信度阈值等可A/B测试,数据驱动调优 |
| **灰度发布机制** | 前端改造分批灰度,降低全量发布风险 |
| **性能监控** | 接入前端性能监控(首屏时间、WS连接稳定性),量化体验提升 |
---
> **关联文档**
> - 产品功能层面: `01-产品文档/00-产品规划/全套改造建议-产品功能层面-v1.0.md`
> - 前端改造建议: `02-技术文档/前端改造/前端改造建议-v1.0.md`