feat(C组): C-T1~T13 AI与数据模块完成

- C-T1 Wingman 辅助面板 - C-T2 Wingman 后端接口 - C-T3 排查流程图编辑器 - C-T4 流程图后端接口 - C-T5 流程图H5端展示 - C-T6 运营数据看板 - C-T7 看板数据接口 - C-T8 全局一致性审查(周2) - C-T9 坐席绩效报表 - C-T10 绩效数据接口+Excel导出 - C-T11 会话智能标注 - C-T12 全局一致性审查(周3) - C-T13 代码评审+PR创建
2026-07-02 19:23:03 +08:00
parent fc22de7f4d
commit 6277db3951
5 changed files with 2207 additions and 18 deletions
@@ -0,0 +1,120 @@
+// =============================================================================
+// 企微IT智能服务台 — H5用户端排查模板 API 调用模块（v5.4 增强）
+// =============================================================================
+// 说明：封装与排查模板相关的所有 HTTP 请求
+// 对应后端 API：/api/troubleshooting-templates
+// 包括：获取模板列表、获取模板详情
+// =============================================================================
+
+import apiClient from './index'
+import type { AxiosResponse } from 'axios'
+
+// --------------------------------------------------------------------------
+// TypeScript 类型定义 — 与后端 Schema 保持一致
+// --------------------------------------------------------------------------
+
+/** 排查步骤路径节点 */
+export interface PathStep {
+  /** 节点唯一标识（用于进度追踪） */
+  nodeId?: string
+  /** 步骤标题 */
+  label: string
+  /** 步骤状态: done / current / pending */
+  status: 'done' | 'current' | 'pending'
+}
+
+/** 决策树递归节点 */
+export interface FlowchartNode {
+  /** 节点唯一标识 */
+  id: string
+  /** 节点类型: step / decision */
+  type: 'step' | 'decision'
+  /** 节点标签文字 */
+  label: string
+  /** 节点状态: done / current / pending */
+  status?: 'done' | 'current' | 'pending'
+  /** 子步骤列表（step 类型的操作明细） */
+  children?: FlowchartNode[]
+  /** "是" 分支（decision 类型）/ 下一步（step 类型） */
+  yes_branch?: FlowchartNode
+  /** "否" 分支（decision 类型） */
+  no_branch?: FlowchartNode
+}
+
+/** 排查模板对象（对应后端 TroubleshootingTemplateResponse） */
+export interface TroubleshootingTemplate {
+  /** 模板唯一标识 */
+  id: string
+  /** 模板名称 */
+  name: string
+  /** 分类: vpn/email/system/account */
+  category: string
+  /** 排障步骤路径 */
+  path_steps: PathStep[]
+  /** 流程图定义 */
+  flowchart: FlowchartNode
+  /** 是否启用 */
+  is_active: boolean
+  /** 创建时间 */
+  created_at: string
+  /** 更新时间 */
+  updated_at: string
+}
+
+/** 排查模板列表响应 */
+export interface TroubleshootingTemplateListData {
+  /** 模板列表 */
+  items: TroubleshootingTemplate[]
+  /** 总数 */
+  total: number
+}
+
+/** 查询参数 */
+export interface TroubleshootingTemplateQuery {
+  /** 按分类过滤（可选） */
+  category?: string
+  /** 页码（从1开始） */
+  page?: number
+  /** 每页数量 */
+  page_size?: number
+}
+
+// --------------------------------------------------------------------------
+// API 函数
+// --------------------------------------------------------------------------
+
+/**
+ * 获取排查模板列表
+ * 支持按分类过滤和分页
+ *
+ * @param params - 查询参数
+ * @param params.category - 按分类过滤（可选）
+ * @param params.page - 页码（可选，默认 1）
+ * @param params.page_size - 每页数量（可选，默认 20）
+ * @returns 排查模板列表数据
+ */
+export async function getTroubleshootingTemplates(
+  params?: TroubleshootingTemplateQuery,
+): Promise<TroubleshootingTemplateListData> {
+  const response: AxiosResponse = await apiClient.get('/troubleshooting-templates', {
+    params: {
+      category: params?.category || undefined,
+      page: params?.page || 1,
+      page_size: params?.page_size || 20,
+    },
+  })
+  return response.data.data
+}
+
+/**
+ * 获取排查模板详情
+ *
+ * @param id - 模板ID
+ * @returns 排查模板详情
+ */
+export async function getTroubleshootingTemplate(
+  id: string,
+): Promise<TroubleshootingTemplate> {
+  const response: AxiosResponse = await apiClient.get(`/troubleshooting-templates/${id}`)
+  return response.data.data
+}