# 智能IT支持服务台 — 项目开发任务调整建议

> **文档版本**: V1.0
> **创建日期**: 2026-06-11
> **作者**: 宋献 + WorkBuddy
> **状态**: 待确认

---

## 一、项目当前状态总览

| 维度 | 状态 | 备注 |
|------|------|------|
| PRD | ✅ v1.1 完成 | 邀请功能已纳入，阶段一细化至1A/1B/1C |
| 架构文档 | ✅ v0.11 完成 | WebSocket评估已完成 |
| 坐席工作台 | ✅ 代码已写 | 前端 50+ 文件，含 WebSocket/快速回复/邀请等 |
| H5用户端 | ✅ 代码已写 | 15 个组件，含聊天/AI面板/排查流程 |
| 管理后台 | ✅ 代码已写 | 10 页面 + 16 API端点 |
| 后端 | ✅ 代码已写 | 60+ Python文件，完整模型/服务/API |
| 原型 | ✅ v5.3 锁定 | 7个HTML原型 + 数据文件 |
| 外部系统集成分析 | ✅ 3份完成 | 火绒/联软/aTrust 各一份详细报告 |
| 映射架构 | ✅ 四系统确认 | 企微设备管理已排除（付费功能，公司未购买） |
| 部署 | 🔄 预生产已部署 | NAS生产+新服务器方案已备 |
| **端到端验证（1C）** | ❌ 未完成 | **当前最大瓶颈** |
| **H5登录Bug** | ❌ OPEN | 阻断性 |
| **管理后台代码修复** | 🔄 3个问题已派发 | 待验证 |

---

## 二、核心问题识别

### 问题1：阶段一"最后一公里"卡住了

代码已写完但端到端验证未跑通，存在集成层面Gap。当前H5登录Bug + 管理后台类型问题，导致1C无法闭环。

### 问题2：外部系统对接全是"待对接"状态

4个外部系统（联软/火绒/aTrust/eHR）的分析文档已完成，但没有任何一个系统完成了实际API联调。这是阶段二及后续的关键路径依赖。

### 问题3：WebSocket安全债务积压

WS-01（认证缺失）是P0级安全问题，当前生产环境WebSocket无任何认证，阶段二实时推送上线前必须修复。

### 问题4：邀请功能设计完成，编码状态不明

PRD §21 已确认邀请功能纳入1A，技术方案和原型已完成，但代码层面是否有完整的后端API + 前端交互闭环需要验证。

---

## 三、调整建议

### 🔴 P0 — 立即推进（1~2周内）

| # | 任务 | 原排期 | 调整 | 原因 |
|---|------|--------|------|------|
| 1 | H5登录Bug修复 | 1C | 不变，优先级提升为最高 | 端到端验证的前置条件 |
| 2 | 管理后台3个代码问题修复 | 1B | 不变，优先级提升 | system_alerts类型不匹配是阻断性的 |
| 3 | 端到端验证(1C) | 1C | 不变 | 阶段一交付的唯一标准 |
| 4 | 邀请功能端到端验证 | 1A | 确认编码完整性 | 设计+原型+技术方案都有，需确认代码是否可跑通 |

**建议做法**：集中1周时间，先修Bug → 跑通1C → 邀请功能验证。阶段一的目标是可演示的MVP，不追求完美。

### 🟡 P1 — 阶段二前置工作（2~4周内）

| # | 任务 | 原排期 | 调整 | 原因 |
|---|------|--------|------|------|
| 5 | WebSocket P0修复（WS-01认证+WS-06去重） | 2A | 提前至1C之后立即做 | 安全是不可妥协的，阶段二实时推送上线前必须完成 |
| 6 | 联软API对接 | 无明确排期 | **新增为阶段二首个外部集成** | strusername是映射的金钥匙，联软是四系统架构的主源(P0) |
| 7 | 外部系统抽象层设计 | 无 | **新增** | 后端需设计统一的ExternalSystemAdapter抽象层，联软/火绒/aTrust/eHR统一接口，解耦具体实现 |

**联软对接建议**：
- 本周内：联系终端安全团队，申请API测试账户
- 同时：后端先基于文档Mock数据开发抽象层
- 获取账户后：立即联调验证

### 🟢 P2 — 中期推进（1~2月内）

| # | 任务 | 原排期 | 调整 | 原因 |
|---|------|--------|------|------|
| 8 | 火绒API对接 | 无明确排期 | 阶段二期间推进 | 火绒=安全源（杀毒+漏洞+隔离），与联软互补，但非映射关键路径 |
| 9 | aTrust API对接 | 无明确排期 | 阶段二期间推进 | aTrust=VPN源，覆盖远程场景，需找信息安全团队获取API ID/密钥 |
| 10 | eHR对接 | 无明确排期 | 阶段二后期 | eHR=辅助/静态数据，优先级最低 |
| 11 | OAuth2登录切换 | 2D | 不变，等公司域名审批 | 1A~2C继续使用Mock登录，不影响功能开发 |

### 📋 备忘 — 条件触发

| 条件 | 触发动作 |
|------|---------|
| 公司购买了企微设备管理 | 接入为第五映射源（MAC→火绒交叉匹配桥） |
| 坐席扩至3人以上 | 启用轮询/最少活跃分配模式（管理后台已预留） |
| Dify Agent2创建完成 | 启动3A（AI Wingman验证） |

---

## 四、外部系统集成排程调整

原五阶段路线图未细化外部系统集成的具体排期。基于分析结果，建议如下：

```
阶段一收尾（当前）
  └─ 1C端到端验证
  └─ 邀请功能闭环

阶段二（H5全流程+实时推送）
  ├─ 2A WebSocket修复+实时推送
  │    └─ WS-01认证、WS-06去重（P0安全）
  ├─ 2B 联软集成（映射主源）      ← 🆕 新增
  │    └─ queryDevByParams → 员工↔终端映射
  │    └─ 抽象层 ExternalSystemAdapter
  ├─ 2C 火绒集成（安全源）         ← 🆕 新增
  │    └─ 终端列表+详情+漏洞+隔离
  ├─ 2D 接单优化+满意度
  └─ 2E OAuth2（待域名审批）

阶段三（AI Wingman）
  ├─ 3A AI Wingman验证
  ├─ 3B 排查流程图+AI混合
  │    └─ aTrust集成（VPN源）   ← 🆕 移入3B
  │    └─ VPN会话+踢出+授信状态
  ├─ 3C 标注体系
  └─ eHR对接（辅助源）           ← 🆕 移入3C后
```

**调整逻辑**：
- 联软提前到2B：映射是后续所有功能（终端信息面板、一键隔离、VPN状态）的基础设施，越早接入越好
- 火绒紧跟联软2C：联软提供映射后，火绒的安全数据才有锚点（通过MAC/pc_name交叉匹配）
- aTrust移到3B：VPN场景相对独立，不阻塞核心流程，与排查流程图结合更有价值
- eHR放到3C后：静态数据同步，优先级最低，联软已经覆盖了映射需求

---

## 五、映射架构（已确认）

### 四系统联合架构

```
联软 LV7000（主源 P0）
  └─ strusername → 精确员工账号→终端映射
  └─ 覆盖：总部办公员工（强制安装联软安全助手）

aTrust（VPN源）
  └─ name / bindUsers / vips（待实测）→ VPN终端映射
  └─ 覆盖：远程接入员工

eHR（辅助源）
  └─ 静态数据：部门/岗位/联系方式
  └─ 覆盖：人员基础信息补全

火绒（安全源，不参与映射）
  └─ 终端安全状态：杀毒/漏洞/隔离
  └─ 与联软通过MAC/pc_name交叉匹配
```

### ❌ 已排除：企微设备管理

- 原因：企微"设备管理"为安全高级功能，需付费购买，公司未购买
- API验证：errcode 48002（应用无调用权限）
- 潜在价值：如未来购买，可作为交叉验证源
- 企微仍作为通信平台（H5宿主+消息推送+用户身份认证），不参与终端映射

---

## 六、风险提示

| 风险 | 影响 | 缓解措施 |
|------|------|---------|
| 外部团队对接响应慢 | 联软/火绒/aTrust都是跨团队协作，API账户审批可能耗时2-4周 | 本周立即启动联系，同时用Mock数据开发 |
| aTrust `vips`字段实测可能不存在 | VPN虚拟IP交叉匹配方案失效 | 联软的映射为主源，aTrust的vips仅为辅助验证 |
| OAuth2域名审批延期 | H5必须继续用Mock登录，影响真实用户体验 | Mock登录已够用，阶段二功能不受影响 |
| WebSocket认证修复涉及现有连接 | 修复后坐席端需同步升级 | 先在预生产环境验证，再灰度发布 |

---

## 七、建议的下一步行动

| 优先级 | 行动 | 负责人 | 时间 |
|--------|------|--------|------|
| 🔴 | 修复H5登录Bug | 开发 | 本周 |
| 🔴 | 修复管理后台3个代码问题 | 开发 | 本周 |
| 🔴 | 端到端验证(1C)跑通 | 开发 | 本周~下周 |
| 🟡 | 联系终端安全团队（联软API账户） | 宋献 | 本周 |
| 🟡 | 联系信息安全团队（火绒AccessKey + aTrust API ID） | 宋献 | 本周 |
| 🟡 | 设计ExternalSystemAdapter抽象层 | 开发 | 下周 |
| 🟢 | WebSocket P0安全修复 | 开发 | 1C完成后1周内 |
