690519:1631 224 to 226 AI #01

2026-05-19 16:31:50 +07:00
parent 3e25097470
commit ea5499123e
127 changed files with 12387 additions and 42 deletions
@@ -0,0 +1,59 @@
+// File: src/modules/ai/intent-classifier/interfaces/classification-result.interface.ts
+// Change Log
+// - 2026-05-19: สร้าง interfaces สำหรับ Intent Classification System (ADR-024).
+
+/** วิธีที่ใช้ในการจำแนก Intent */
+export type ClassificationMethod =
+  | 'pattern'
+  | 'llm_fallback'
+  | 'semaphore_overflow'
+  | 'llm_error';
+
+/**
+ * ผลลัพธ์การจำแนก Intent
+ * method: วิธีที่ใช้จำแนก (pattern match หรือ LLM fallback)
+ */
+export interface ClassificationResult {
+  /** Intent code ที่จำแนกได้ เช่น 'SUMMARIZE_DOCUMENT', 'GET_RFA' */
+  intentCode: string;
+  /** ความมั่นใจ 0.0-1.0 (1.0 = pattern match, < 1.0 = LLM) */
+  confidence: number;
+  /** วิธีที่ใช้จำแนก */
+  method: ClassificationMethod;
+  /** Parameters ที่สกัดได้จาก query (optional) */
+  params?: Record<string, unknown>;
+  /** เวลาที่ใช้ทั้งหมด (milliseconds) */
+  latencyMs: number;
+}
+
+/**
+ * Input สำหรับการจำแนก Intent
+ */
+export interface ClassificationInput {
+  /** คำถามจาก user (trim แล้ว, max 200 chars) */
+  query: string;
+  /** Context project UUID (optional) */
+  projectPublicId?: string;
+  /** Context user UUID (optional) */
+  userPublicId?: string;
+  /** Document ที่เปิดอยู่ UUID (optional) */
+  currentDocumentId?: string;
+}
+
+/**
+ * ข้อมูล Pattern ที่ใช้ใน matching (flatten จาก DB สำหรับ cache)
+ */
+export interface CachedPattern {
+  /** Public UUID ของ pattern */
+  publicId: string;
+  /** Intent code ที่ pattern นี้เป็นของ */
+  intentCode: string;
+  /** ภาษา: th, en, any */
+  language: 'th' | 'en' | 'any';
+  /** ชนิด pattern */
+  patternType: 'keyword' | 'regex';
+  /** ค่า pattern (keyword string หรือ regex string) */
+  patternValue: string;
+  /** ลำดับการตรวจสอบ (ต่ำ = สำคัญกว่า) */
+  priority: number;
+}