690525:1720 ADR-028-228-migration-OCR #06 dynamic prompt

2026-05-25 17:20:48 +07:00
parent d315488d83
commit 1139e54086
15 changed files with 1679 additions and 60 deletions
@@ -0,0 +1,73 @@
+-- Delta: สร้างตาราง ai_prompts สำหรับ Dynamic Prompt Management
+-- Date: 2026-05-25
+-- Related ADR: ADR-029
+-- Applied in: v1.9.0 -> v1.9.6
+-- ------------------------------------------------------------
+-- การเปลี่ยนแปลงโครงสร้างฐานข้อมูล (Schema changes)
+-- ------------------------------------------------------------
+CREATE TABLE IF NOT EXISTS ai_prompts (
+  id INT PRIMARY KEY AUTO_INCREMENT COMMENT 'ID ภายใน (ไม่ expose ใน API)',
+  prompt_type VARCHAR(50) NOT NULL COMMENT 'ประเภท prompt เช่น ocr_extraction',
+  version_number INT NOT NULL COMMENT 'เลข version ต่อเนื่องต่อ prompt_type (1, 2, 3...)',
+  template TEXT NOT NULL COMMENT 'prompt template ที่มี {{ocr_text}} placeholder บังคับ',
+  field_schema JSON NULL COMMENT 'definition ของ fields ที่คาดหวังในผลลัพธ์ JSON',
+  is_active TINYINT(1) NOT NULL DEFAULT 0 COMMENT '1 = version นี้ใช้งานจริงทั้ง sandbox และ migrate-document (1 per prompt_type)',
+  test_result_json JSON NULL COMMENT 'ผลลัพธ์ JSON จาก sandbox run ล่าสุด (auto-save โดย processor)',
+  manual_note TEXT NULL COMMENT 'หมายเหตุ/annotation จาก admin (manual input)',
+  last_tested_at TIMESTAMP NULL COMMENT 'เวลาที่ sandbox รันครั้งล่าสุดสำหรับ version นี้',
+  activated_at TIMESTAMP NULL COMMENT 'เวลาที่ version นี้ถูก activate เป็น active',
+  created_by INT NOT NULL COMMENT 'user_id ของผู้สร้าง version นี้',
+  created_at TIMESTAMP NOT NULL DEFAULT CURRENT_TIMESTAMP,
+  UNIQUE KEY uk_type_version (prompt_type, version_number),
+  INDEX idx_prompt_type_active (prompt_type, is_active),
+  FOREIGN KEY (created_by) REFERENCES users(user_id)
+) ENGINE = InnoDB DEFAULT CHARSET = utf8mb4 COLLATE = utf8mb4_unicode_ci COMMENT = 'ตาราง versioned prompt templates สำหรับ OCR extraction (ADR-029)';
+
+-- ------------------------------------------------------------
+-- Seed: migrate hardcoded prompt เป็น active version 1
+-- (8 fields รวม category, tags, summary — ใช้ร่วมกันทั้ง sandbox และ migrate-document)
+-- ------------------------------------------------------------
+INSERT INTO ai_prompts (
+    prompt_type,
+    version_number,
+    template,
+    field_schema,
+    is_active,
+    manual_note,
+    activated_at,
+    created_by
+  )
+VALUES (
+    'ocr_extraction',
+    1,
+    'You are a professional document intelligence engine.\nAnalyze the following OCR text extracted from a project document and extract the metadata fields.\n\nOCR TEXT:\n{{ocr_text}}\n\nExtract these fields:\n1. documentNumber: The official document number or code. If not found, return null.\n2. subject: The main subject, title, or topic of the document. If not found, return null.\n3. discipline: Must be exactly one of: "Civil", "Mechanical", "Electrical", "Architectural", or null if not specified.\n4. category: Must be exactly one of: "Correspondence", "Transmittal", "Circulation", "RFA", "Shop Drawing", "Contract Drawing", or null if not specified.\n5. date: The issue/document date in YYYY-MM-DD format. If not found, return null.\n6. confidence: A float between 0.0 and 1.0 indicating your confidence in this extraction.\n7. tags: An array of tags/keywords (strings) that describe the document.\n8. summary: A short 1-2 sentence summary of the document contents.\nReturn ONLY a valid JSON object matching this schema. Do NOT include markdown code blocks, HTML, or any conversational text. Example:\n{\n  "documentNumber": "LCBP3-CIV-001",\n  "subject": "Foundation Inspection Report",\n  "discipline": "Civil",\n  "category": "Correspondence",\n  "date": "2026-05-20",\n  "confidence": 0.95,\n  "tags": ["foundation", "inspection", "concrete"],\n  "summary": "This document is a foundation inspection report for the LCBP3 project, confirming concrete strength."\n}',
+    JSON_OBJECT(
+      'documentNumber',
+      'string|null',
+      'subject',
+      'string|null',
+      'discipline',
+      'enum:Civil,Mechanical,Electrical,Architectural|null',
+      'category',
+      'enum:Correspondence,Transmittal,Circulation,RFA,Shop Drawing,Contract Drawing|null',
+      'date',
+      'date:YYYY-MM-DD|null',
+      'confidence',
+      'float:0-1',
+      'tags',
+      'string[]',
+      'summary',
+      'string|null'
+    ),
+    1,
+    'Migrated from hardcoded prompt in processSandboxExtract / processMigrateDocument (ADR-029)',
+    CURRENT_TIMESTAMP,
+    (
+      SELECT user_id
+      FROM users
+      WHERE username = 'superadmin'
+      LIMIT 1
+    ) -- PREREQUISITE: user seed (user.seed.ts) MUST run before this delta;
+    -- 'superadmin' is always the first user inserted per standard deployment order
+  ) ON DUPLICATE KEY
+UPDATE prompt_type = prompt_type;