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

CONTEXT.md

@@ -88,6 +88,18 @@ _Avoid_: Semantic search (overloaded), Vector search (incomplete)
 Container สำเร็จรูป (opaque black box) เปิด HTTP API ให้ NestJS เรียก — ไม่มีโค้ด Python ใน repo, ทีมไม่ maintain runtime ภายใน
 _Avoid_: Python sidecar, OCR microservice (ที่เรา maintain เอง)
 
+**Prompt Version**:
+Immutable snapshot ของ prompt template ใน `ai_prompts` table — ทุกครั้งที่ admin กด "บันทึก" จะสร้าง version ใหม่ (version*number เพิ่มทีละ 1) version เก่ายังอยู่ใน history ลบได้ยกเว้น active version (ADR-029)
+\_Avoid*: Prompt config, Prompt setting, Editable prompt
+
+**Active Prompt**:
+Prompt Version ที่มี `is_active = 1` ต่อ `prompt_type` — ใช้โดยทั้ง OCR Sandbox และ `processMigrateDocument` พร้อมกัน, cached ใน Redis TTL 60s; invalidated เมื่อ admin activate version อื่น (ADR-029)
+_Avoid_: Production prompt (ทั้ง sandbox และ migrate-document ใช้อันเดียวกัน)
+
+**Prompt Template**:
+String ที่มี `{{ocr_text}}` placeholder บังคับ — backend validate ก่อน save; processor แทนที่ด้วย OCR output ก่อนส่งเข้า Ollama (ADR-029)
+_Avoid_: Prompt string, Prompt text (ambiguous — อาจหมายถึง resolved prompt ที่มี OCR text แล้ว)
+
 **Human-in-the-loop**:
 ทุก AI suggestion ต้องผ่านการ accept/reject โดย user ก่อนกลายเป็น state change — บันทึกใน `ai_audit_logs`
 _Avoid_: Auto-apply, AI auto-execute
@@ -113,6 +125,7 @@ _Avoid_: Throw exception from tool, Untyped error
 - A **Correspondence** has a 1:1 specialization to **RFA** / **Transmittal** / etc. (table inheritance)
 - A **RFA** has 1:N **RFA Revisions**, each linking to one or more **Shop Drawing Revisions** via `rfa_items`
 - A **Workflow Instance** governs exactly one **Correspondence**; its current state is projected into entity columns (e.g. `rfa_revisions.rfa_status_code_id`) but **`workflow_instances` is the source of truth**
+- A **Prompt Version** lives in `ai_prompts`; exactly one per `prompt_type` has `is_active = 1` — this is the **Active Prompt** consumed by both OCR Sandbox and `processMigrateDocument`; cached in Redis TTL 60s
 - A **Document Chunk** (MariaDB) has a 1:1 **Vector Point** in Qdrant via shared `chunk_public_id` (UUIDv7)
 - An **AI Document Assistant** suggestion produces an `ai_audit_logs` row; if user accepts, it triggers a normal **Workflow Transition** (AI never writes the transition itself)
 - **Qdrant queries MUST be filtered by `project_public_id`** — enforced at compile time by `QdrantService` signature
@@ -198,16 +211,17 @@ User Chat → Intent Router (ยังไม่มี) → Server-side Intent
 
 ## System readiness summary (resolved)
 
-| Component            | สถานะ           | หมายเหตุ                                                                      |
-| -------------------- | --------------- | ----------------------------------------------------------------------------- |
-| **Infrastructure**   | ✅ พร้อม        | NestJS + Next.js + MariaDB + Redis + Elasticsearch                            |
-| **Workflow Engine**  | ✅ พร้อม        | DSL-based, ADR-001/021                                                        |
-| **AI Boundary**      | ✅ พร้อม        | ADR-023A — Ollama isolation, no direct DB access                              |
-| **RAG Pipeline**     | 🟡 บางส่วน      | Qdrant service มีใน code, ต้องตรวจสอบ deployment                              |
-| **Intent Router**    | 🟡 ADR Accepted | ADR-024 Accepted — Intent Classifier (Pattern→LLM Fallback) รอ implementation |
-| **AI Tool Layer**    | 🟡 ADR Accepted | ADR-025 Accepted — Tool Layer Architecture รอ implementation                  |
-| **Document Chat UI** | 🟡 ADR Accepted | ADR-026 Accepted — Side-panel Chat UI รอ implementation                       |
-| **AI Admin Console** | 🟡 ADR Accepted | ADR-027 Accepted — Dynamic Control Panel รอ implementation                    |
+| Component               | สถานะ           | หมายเหตุ                                                                                  |
+| ----------------------- | --------------- | ----------------------------------------------------------------------------------------- |
+| **Infrastructure**      | ✅ พร้อม        | NestJS + Next.js + MariaDB + Redis + Elasticsearch                                        |
+| **Workflow Engine**     | ✅ พร้อม        | DSL-based, ADR-001/021                                                                    |
+| **AI Boundary**         | ✅ พร้อม        | ADR-023A — Ollama isolation, no direct DB access                                          |
+| **RAG Pipeline**        | 🟡 บางส่วน      | Qdrant service มีใน code, ต้องตรวจสอบ deployment                                          |
+| **Intent Router**       | 🟡 ADR Accepted | ADR-024 Accepted — Intent Classifier (Pattern→LLM Fallback) รอ implementation             |
+| **AI Tool Layer**       | 🟡 ADR Accepted | ADR-025 Accepted — Tool Layer Architecture รอ implementation                              |
+| **Document Chat UI**    | 🟡 ADR Accepted | ADR-026 Accepted — Side-panel Chat UI รอ implementation                                   |
+| **AI Admin Console**    | 🟡 ADR Accepted | ADR-027 Accepted — Dynamic Control Panel รอ implementation                                |
+| **Dynamic Prompt Mgmt** | 🟡 Spec Ready   | ADR-029 Active — speckit.prepare เสร็จแล้ว (spec/plan/tasks/contracts); รอ implementation |
 
 ## Flagged ambiguities
 
@@ -289,12 +303,13 @@ User Chat → Intent Router (ยังไม่มี) → Server-side Intent
 
 ## ADRs ที่เกี่ยวข้องกับ AI Runtime Layer
 
-| ADR     | หัวข้อ                             | ตัดสินใจอะไร                                      | สถานะ       |
-| ------- | ---------------------------------- | ------------------------------------------------- | ----------- |
-| ADR-024 | Intent Classification Strategy     | Hybrid: Pattern First → LLM Fallback              | ✅ Accepted |
-| ADR-025 | AI Tool Layer Architecture         | Bridge pattern, CASL enforcement, response shape  | ✅ Accepted |
-| ADR-026 | Document Chat UI Pattern           | Side-panel vs modal vs separate page              | ✅ Accepted |
-| ADR-027 | AI Admin Console & Dynamic Control | Admin Panel + dynamic model/prompt/intent control | ✅ Accepted |
-| ADR-028 | Migration Architecture Refactor    | Staging Queue & post-migration cleanup            | ✅ Active   |
+| ADR     | หัวข้อ                             | ตัดสินใจอะไร                                                                             | สถานะ       |
+| ------- | ---------------------------------- | ---------------------------------------------------------------------------------------- | ----------- |
+| ADR-024 | Intent Classification Strategy     | Hybrid: Pattern First → LLM Fallback                                                     | ✅ Accepted |
+| ADR-025 | AI Tool Layer Architecture         | Bridge pattern, CASL enforcement, response shape                                         | ✅ Accepted |
+| ADR-026 | Document Chat UI Pattern           | Side-panel vs modal vs separate page                                                     | ✅ Accepted |
+| ADR-027 | AI Admin Console & Dynamic Control | Admin Panel + dynamic model/prompt/intent control                                        | ✅ Accepted |
+| ADR-028 | Migration Architecture Refactor    | Staging Queue & post-migration cleanup                                                   | ✅ Active   |
+| ADR-029 | Dynamic Prompt Management          | `ai_prompts` table, versioned OCR extraction prompt shared by sandbox + migrate-document | ✅ Active   |
 
 **หมายเหตุ**: ADR-023A ยังคงเป็น canonical สำหรับ infrastructure — ADR-024/025/026/027 เพิ่ม runtime layer; ADR-028 ปรับ Migration Pipeline