lami-base-v1/backend/src/apps/pc/risk/models/risk.model.ts

/**
 * 群风控与异常干预模块 — 数据模型定义
 *
 * 对应规范文档 §八「模块 5：群风控与异常干预模块」
 *
 * 核心表：
 *   - risk_keyword    ：风险关键词库
 *   - alert           ：预警记录（命中敏感词、阈值异常等）
 *   - work_order      ：干预工单（预警自动生成）
 *   - kb_case         ：异常处理案例知识库（二期）
 */

/** 风险关键词 */
export interface RiskKeyword {
  /** 主键 */
  id: number;
  /** 关键词 */
  keyword: string;
  /** 分类：price=价格敏感, competitor=竞品, complaint=投诉, custom=自定义 */
  category: 'price' | 'competitor' | 'complaint' | 'custom';
  /** 严重程度：1=低, 2=中, 3=高 */
  severity: 1 | 2 | 3;
  /** 状态：1=启用, 0=停用 */
  enabled: number;
  /** 备注 */
  remark: string;
  /** 创建时间 */
  createdAt: string;
}

/** 预警类型 */
export type AlertType = 'keyword' | 'threshold' | 'abnormal';

/** 预警记录 */
export interface Alert {
  /** 主键 */
  id: number;
  /** 群 ID */
  roomId: string;
  /** 预警类型 */
  type: AlertType;
  /** 预警等级：1=信息, 2=警告, 3=严重 */
  level: 1 | 2 | 3;
  /** 预警标题 */
  title: string;
  /** 详细描述 */
  description: string;
  /** 匹配到的关键词（keyword 类型时） */
  matchedKeyword: string;
  /** 关联的消息 ID */
  messageId: number;
  /** 状态：open=待处理, handled=已处理, ignored=已忽略 */
  status: 'open' | 'handled' | 'ignored';
  /** 处理人 ID */
  handlerId: number;
  /** 处理备注 */
  handleNote: string;
  /** 关联的工单 ID */
  workOrderId: number;
  /** 创建时间 */
  createdAt: string;
  /** 处理时间 */
  handledAt: string;
}

/** 工单状态 */
export type WorkOrderStatus = 'pending' | 'in_progress' | 'completed' | 'cancelled';

/** 干预工单 */
export interface WorkOrder {
  /** 主键 */
  id: number;
  /** 关联预警 ID */
  alertId: number;
  /** 工单标题 */
  title: string;
  /** 工单描述 */
  description: string;
  /** 指派负责人 ID */
  assigneeId: number;
  /** 截止时间 */
  deadline: string;
  /** 状态 */
  status: WorkOrderStatus;
  /** 处理记录 */
  handleRecord: string;
  /** 创建时间 */
  createdAt: string;
  /** 完成时间 */
  completedAt: string;
}