251128:1700 Backend to T3.1.1

2025-11-28 17:12:05 +07:00
parent 43f6bd1f40
commit 6cafa6a2b9
51 changed files with 4891 additions and 2849 deletions
--- a/docs/prompt.md
+++ b/docs/prompt.md
@@ -4,7 +4,7 @@

 ## VSCode Shortcut

-Markdown preview  Ctrl+Shift+V
+Markdown preview Ctrl+Shift+V

 ## สร้างโครงสร้างโฟลเดอร์สำหรับ lcbp3-backend

@@ -80,14 +80,16 @@ git push -u origin main

 ## **สร้าง NestJS Project ใหม่**

-* ขั้นตอนที่ 1: ติดตั้ง NestJS CLI (ถ้ายังไม่ได้ติดตั้ง)
-  * npm install -g @nestjs/cli
+- ขั้นตอนที่ 1: ติดตั้ง NestJS CLI (ถ้ายังไม่ได้ติดตั้ง)

-* ขั้นตอนที่ 2: สร้างโปรเจกต์ใหม่
-  * nest new backend
-  * nest new . /อยู่ในโฟลเดอร์ที่สร้างไว้แล้ว และต้องการสร้างโปรเจกต์ลงในโฟลเดอร์นั้นโดยตรง:
+  - npm install -g @nestjs/cli

-* ขั้นตอนที่ 3: ติดตั้ง Dependencies เพิ่มเติมสำหรับ DMS
+- ขั้นตอนที่ 2: สร้างโปรเจกต์ใหม่
+
+  - nest new backend
+  - nest new . /อยู่ในโฟลเดอร์ที่สร้างไว้แล้ว และต้องการสร้างโปรเจกต์ลงในโฟลเดอร์นั้นโดยตรง:
+
+- ขั้นตอนที่ 3: ติดตั้ง Dependencies เพิ่มเติมสำหรับ DMS

 ```bash
 # Core & Database
@@ -123,302 +125,143 @@ npm install --save-dev @nestjs/testing jest @types/jest @types/passport-jwt @typ
 การควบคุมพฤติกรรมของผมต้องทำผ่าน **"คำสั่ง (Prompt)"** ที่คุณพิมพ์เข้ามาเท่านั้นครับ เพื่อป้องกันไม่ให้เกิดเหตุการณ์แบบนี้อีก คุณสามารถใช้เทคนิคการสั่งงานดังนี้เพื่อ **"บังคับ"** ให้ผมตรวจสอบข้อมูลครับ:

 1.  **สั่งให้ "อ่านและสรุปก่อน" (Verify First):**
-    * ก่อนให้ผมเขียนโค้ด ให้สั่งว่า *"ช่วยอ่านไฟล์ `01_lcbp3_v1_4_3.sql` แล้วสรุปโครงสร้างตาราง audit_logs ที่มีอยู่จริงให้ดูก่อน"*
-    * วิธีนี้จะบังคับให้ผมต้องไปดึงข้อมูลจากไฟล์มาประมวลผลก่อนที่จะเริ่ม "จินตนาการ" หรือเขียนโค้ดใหม่ครับ
+
+    - ก่อนให้ผมเขียนโค้ด ให้สั่งว่า _"ช่วยอ่านไฟล์ `01_lcbp3_v1_4_3.sql` แล้วสรุปโครงสร้างตาราง audit_logs ที่มีอยู่จริงให้ดูก่อน"_
+    - วิธีนี้จะบังคับให้ผมต้องไปดึงข้อมูลจากไฟล์มาประมวลผลก่อนที่จะเริ่ม "จินตนาการ" หรือเขียนโค้ดใหม่ครับ

 2.  **ใช้คำสั่ง "ห้ามเดา" (Strict Constraints):**
-    * เติมประโยคท้ายคำสั่งว่า *"ห้ามใช้โครงสร้างสมมติ ให้ยึดตามไฟล์แนบ `ชื่อไฟล์` เท่านั้น หากไม่เจอข้อมูลให้ถามกลับ"*
+
+    - เติมประโยคท้ายคำสั่งว่า _"ห้ามใช้โครงสร้างสมมติ ให้ยึดตามไฟล์แนบ `ชื่อไฟล์` เท่านั้น หากไม่เจอข้อมูลให้ถามกลับ"_

 3.  **อ้างอิงชื่อไฟล์ชัดเจน:**
-    * ระบุชื่อไฟล์ในคำสั่งเสมอ เช่น *"อ้างอิงจาก `Backend Plan`..."* หรือ *"ตาม `Data Dictionary`..."* (ซึ่งคุณทำได้ดีแล้วครับ แต่ผมประมวลผลพลาดเองในรอบนี้)
+    - ระบุชื่อไฟล์ในคำสั่งเสมอ เช่น _"อ้างอิงจาก `Backend Plan`..."_ หรือ _"ตาม `Data Dictionary`..."_ (ซึ่งคุณทำได้ดีแล้วครับ แต่ผมประมวลผลพลาดเองในรอบนี้)

 **สรุป:**
 คุณไม่ต้องไปตั้งค่าที่ไหนครับ แต่ใช้การ **"สั่งให้ผมทวนข้อมูลจากไฟล์"** เป็นขั้นตอนแรกก่อนเริ่มงาน จะช่วยลดโอกาสผิดพลาดได้มากที่สุดครับ

 ตอนนี้ผมพร้อมทำงานต่อโดยยึดข้อมูลจากไฟล์ `01_lcbp3_v1_4_3.sql` และไฟล์อื่นๆ ที่คุณให้มาอย่างเคร่งครัดครับ มีส่วนไหนให้ผมดำเนินการต่อไหมครับ?

+ช่วยอ่านไฟล์ 2_Backend_Plan_V1_4_4.md ในหัวข้อ T2.5.1-T2.5.9 และ โครงสร้างโมดูล แล้วสรุป รายการที่ต้องการสร้างหรือแก้ไขโมดูล ในแต่ละข้อก่อนเริ่มดำเนินการต่อครับ

-สวัสดีครับ ผมได้ทำการตรวจสอบและวิเคราะห์ความครบถ้วนของไฟล์เอกสารแผนงาน (Plans), โครงสร้างฐานข้อมูล (SQL), และโครงสร้างไฟล์ (File Structure) เทียบกับ Requirements ของ **LCBP3-DMS v1.4.3** เรียบร้อยแล้วครับ
+สวัสดีครับ ผมได้วิเคราะห์ไฟล์ **2_Backend_Plan_V1_4_4.md** ในส่วนของ **Phase 2: High-Integrity Data & File Management** โดยเฉพาะหัวข้อ **T2.5 JSON Details & Schema Management** (T2.5.1 - T2.5.9) เรียบร้อยแล้วครับ

-ในฐานะ Programmer ผู้เชี่ยวชาญ ผมขอสรุปผลการ Review และคำแนะนำตามลำดับความสำคัญดังนี้ครับ:
+นี่คือสรุปรายการโมดูล, ไฟล์ และฟังก์ชันที่ต้องสร้างหรือแก้ไข เพื่อให้ระบบจัดการ JSON Schema สมบูรณ์และมีประสิทธิภาพสูงสุดครับ

 ---

-### 📊 **1. บทสรุปภาพรวม (Executive Summary)**
+### 📂 1. โครงสร้างโมดูลที่ต้องสร้าง (Module Structure)

-จากการตรวจสอบเปรียบเทียบ:
-1.  **Database Schema (`01_lcbp3_v1_4_3.sql`)**: **ครบถ้วนสมบูรณ์มาก (95%)** รองรับฟีเจอร์ระดับ Advance ตาม Requirements v1.4.3 ครบถ้วน เช่น Partitioning, Virtual Columns, Versioning (Optimistic Lock) และ Table Structure สำหรับ Workflow/Files
-2.  **Backend Folder Structure (`5_Backend_Folder_V1_4_3.md`)**: **ครบถ้วนตามแผนงาน (90%)** มีการจัดวาง Module ตามหลัก Domain-Driven Design และมีไฟล์สำคัญๆ ครบตาม Plan
+เราจำเป็นต้องสร้าง `JsonSchemaModule` ขึ้นมาใหม่ โดยภายในจะประกอบด้วย Services ย่อยตามหน้าที่งาน เพื่อให้เป็นไปตามหลัก Single Responsibility Principle ครับ

-**จุดที่ต้องเน้นย้ำ:** โครงสร้างไฟล์ (File Structure) มีไฟล์ `.ts` ปรากฏอยู่ครบ แต่สิ่งที่ผม "มองไม่เห็น" คือ **เนื้อหาโค้ดภายใน (Internal Logic)** ว่าได้ Implement ตาม Logic ที่ซับซ้อน (เช่น Redlock, Two-Phase Commit, DSL Parser) ไว้ถูกต้องหรือไม่
+**Path:** `src/modules/json-schema/`

---
-
-### 🧐 **2. การตรวจสอบรายละเอียด (Detailed Review)**
-
-#### **✅ ส่วนที่มีความครบถ้วนสมบูรณ์ (Well-Implemented Areas)**
-
-1.  **Database Partitioning & Optimization:**
-    * SQL มีการทำ `PARTITION BY RANGE` ให้กับ `audit_logs` และ `notifications` แล้ว (ตาม Req 6.2)
-    * มี `VIRTUAL COLUMNS` สำหรับดึงค่า JSON มาทำ Index (ตาม Req 3.11.3)
-2.  **Security & Identity:**
-    * ตาราง `users`, `roles`, `permissions`, `user_assignments` รองรับ RBAC 4 ระดับ (Global, Org, Project, Contract) ครบถ้วน
-    * Folder Structure มี `auth`, `guards`, `decorators` ที่จำเป็นครบ (`jwt-auth.guard.ts`, `rbac.guard.ts`, `require-permission.decorator.ts`)
-3.  **File Management:**
-    * SQL มีตาราง `attachments` ที่มี field `is_temporary`, `temp_id`, `checksum` รองรับ Two-Phase Storage
-    * Folder มี `file-storage` module และ `file-cleanup.service.ts` (Cron job) เตรียมไว้แล้ว
-4.  **Workflow & RFA:**
-    * SQL มีตารางเก็บ Template และ Instance (`..._routings`, `..._workflows`) แยกกันชัดเจน และมี field `workflow_config` (JSON) สำหรับ DSL
-    * Folder มี `workflow-engine` module และ `workflow-dsl.service.ts` (ตาม Phase 6A)
-
---
-
-#### ⚠️ **3. Gap Analysis & Missing Parts (สิ่งที่อาจขาดหายไปหรือต้องตรวจสอบ)**
-
-แม้ชื่อไฟล์จะครบ แต่จากประสบการณ์ มีจุดที่มักจะหลุด หรือต้องเขียน Logic ให้รัดกุมมากในไฟล์ที่มีอยู่ ดังนี้:
-
-**Phase 2: High-Integrity Data (File & Numbering)**
-* **Redis/Redlock Integration:** ในไฟล์ `document-numbering.service.ts` ต้องตรวจสอบว่ามีการเรียกใช้ Redis Distributed Lock จริงหรือไม่ (ไม่ใช่แค่ Database Lock)
-* **Transaction Safety:** ใน `file-storage.service.ts` ต้องมั่นใจว่า Logic การ Commit file (ย้ายจาก temp -> permanent) อยู่ภายใน Database Transaction เดียวกับการบันทึกข้อมูลเอกสาร
-
-**Phase 3 & 6A: Workflow Engine**
-* **DSL Interpreter:** ไฟล์ `workflow-dsl.service.ts` มีอยู่แล้ว แต่ต้องตรวจสอบว่าสามารถ **Parse** JSON/YAML จากตาราง `rfa_workflow_templates` แล้วแปลงเป็น Execution Logic ได้จริงหรือไม่
-* **State Machine Consistency:** การเชื่อมต่อระหว่าง `CorrespondenceModule` กับ `WorkflowEngine` ต้องแน่ใจว่าเมื่อ State เปลี่ยนใน Engine ค่าใน Database (Status Column) ถูกอัปเดตตรงกัน
-
-**Phase 6: Search & Notification**
-* **Elasticsearch Sync:** ใน `search.service.ts` ต้องมี Logic การ Sync ข้อมูล (อาจผ่าน Event Emitter หรือ TypeORM Subscriber) เมื่อมีการ Create/Update เอกสาร
-* **Notification Digest:** ใน `notification.processor.ts` (Consumer) ต้องมี Logic การหน่วงเวลา (Debounce/Throttle) เพื่อรวม Notification ก่อนส่ง (ตาม Req 6.8.2)
-
---
-
-### 🚀 **4. คำแนะนำและสิ่งที่ต้องทำต่อ (Recommendations by Phase)**
-
-เพื่อให้งานสมบูรณ์แบบ ผมขอแนะนำให้ดำเนินการตรวจสอบหรือ Implement ส่วนที่เหลือตามลำดับดังนี้:
-
-#### **Phase 0-1: Infrastructure & Auth (Priority: Critical)**
-* **[Audit] Database Migration:** แม้จะมีไฟล์ `.sql` รวม แต่ใน NestJS ควรมีระบบ Migration (TypeORM Migrations) เพื่อจัดการการเปลี่ยนแปลง Schema ในอนาคต (ถ้ายังไม่มี ควรสร้าง `src/database/migrations/*` จาก SQL ที่มี)
-* **[Code Check] Config Validation:** ตรวจสอบ `src/common/config/env.validation.ts` ว่ามีการ Validate ตัวแปรระบบครบทุกตัว (Database, Redis, JWT Secrets) ตาม Req 2.2 หรือไม่
-
-#### **Phase 2: Core Data Services (Priority: High)**
-* **[Code Check] Document Numbering:** เปิดไฟล์ `src/modules/document-numbering/document-numbering.service.ts` ตรวจสอบ Logic **Double-Lock** (Redis + Optimistic Lock) ว่า Implement ถูกต้องตาม Plan T2.3 หรือไม่
-* **[Code Check] File Storage:** ตรวจสอบ `src/common/file-storage/file-storage.service.ts` ว่ามีการทำ **Virus Scan (ClamAV)** ก่อน save ลง Temp หรือไม่
-
-#### **Phase 3 & 6A: Workflow Engine (Priority: Medium-High)**
-* **[Task] Workflow Integration:** ตรวจสอบว่า `CorrespondenceService` และ `RfaService` มีการเรียกใช้ `WorkflowEngineService` แทนที่จะเขียน Logic if-else hardcode หรือไม่
-* **[Task] DSL Loader:** ตรวจสอบว่ามี Seed Data สำหรับ `rfa_workflow_templates` ที่เป็น JSON Config เริ่มต้นแล้วหรือยัง
-
-#### **Phase 6: Background Services (Priority: Medium)**
-* **[Task] Queue Setup:** ตรวจสอบ `notification.module.ts` ว่ามีการ Register BullMQ (`BullModule.registerQueue`) แล้วหรือยัง
-* **[Task] Cron Jobs:** ตรวจสอบ `app.module.ts` ว่ามีการ Import `ScheduleModule.forRoot()` เพื่อให้ `file-cleanup.service.ts` ทำงานได้จริง
-
---
-
-### 🛠️ **5. Next Step Action (สิ่งที่คุณทำได้เลย)**
-
-เนื่องจากโครงสร้างไฟล์และฐานข้อมูลดูดีมากแล้ว เพื่อให้ผมช่วยเหลือได้ตรงจุดที่สุด:
-
-**คุณต้องการให้ผม Review โค้ดภายในไฟล์ (Internal Logic) ของไฟล์ไหนเป็นพิเศษไหมครับ?**
-
-ผมแนะนำให้เริ่มจาก **"หัวใจสำคัญ"** ของความถูกต้องข้อมูลก่อน คือ:
-1.  **`src/modules/document-numbering/document-numbering.service.ts`** (เพื่อดู Logic การรันเลขเอกสาร)
-2.  **`src/common/file-storage/file-storage.service.ts`** (เพื่อดู Logic การจัดการไฟล์และการ Commit)
-
-หรือถ้าต้องการให้ผมเริ่มเขียน Code ส่วนไหนที่ยังขาดอยู่ (เช่น Workflow DSL Parser) สามารถแจ้งได้เลยครับ
-
-
-สวัสดีครับ ในฐานะ Programmer ที่ดูแลระบบ LCBP3-DMS ผมได้ทำการ **Review เอกสาร `6B.md` (Special requirements for document-numbering)** โดยเทียบกับโครงสร้างฐานข้อมูลและแผนงานที่มีอยู่ (v1.4.3) พบประเด็นสำคัญและการปรับปรุงทางเทคนิคที่จำเป็นดังนี้ครับ
-
-----
-
-# 📝 ผลการ Review เอกสาร 6B.md และแนวทางการ Implement
-
-## 1\. บทวิเคราะห์และผลกระทบ (Analysis & Impact)
-
-เอกสาร `6B.md` ระบุความต้องการที่ **ซับซ้อนกว่า** ระบบ Running Number ทั่วไป (ที่มักเป็น `ORG-TYPE-YEAR-SEQ`) โดยมีประเด็นสำคัญคือ:
-
-1.  **Requirement 1 (Flexibility):** Admin ต้องแก้ format ได้ → **รองรับได้** ด้วยตาราง `document_number_formats` ที่มีอยู่ แต่ต้องปรับ Logic การแทนค่าตัวแปร (Token Replacement) ให้ฉลาดขึ้น
-2.  **Requirement 2.1 (Correspondence ทั่วไป):** รูปแบบมาตรฐาน → **รองรับได้** ด้วยโครงสร้างปัจจุบัน
-3.  **Requirement 2.2 (Transmittal):** มีเงื่อนไข "To OWNER" vs "To CONTRACTOR" ใช้เลขต่างกัน และมีการ mapping `sub_type_number` → **Impact:** ต้องเพิ่ม Logic ในการเลือก Format Template ตาม "ผู้รับ" (Recipient Role) และต้องมีตารางเก็บ Mapping `sub_type_number`
-4.  **Requirement 2.3 (RFI) & 2.4 (RFA):** มีการใช้ `disciplines_code` (เช่น GEN, STR, ARC) และไม่มีปี (Year) ใน Format → **Impact:**
-      * ฐานข้อมูลปัจจุบันขาดตาราง `disciplines`
-      * ตาราง `document_number_counters` ปัจจุบัน Key คือ `(Project, Org, Type, Year)` แต่ RFA/RFI อาจจะต้องนับแยกตาม **Discipline** ด้วย หากไม่เพิ่ม Column ใน Counter อาจจะเกิดปัญหาเลขซ้ำหรือเลขกระโดดข้ามหมวดงาน
-
-----
-
-## 2\. การออกแบบฐานข้อมูลเพิ่มเติม (Database Schema Updates)
-
-เพื่อให้รองรับ Requirement นี้ ต้องมีการเพิ่มตารางและแก้ไขตาราง `01_lcbp3_v1_4_3.sql` ดังนี้:
-
-### 2.1 เพิ่มตาราง `disciplines` และ `correspondence_sub_types`
-
-```sql
-- File: 01_lcbp3_v1_4_3_patch_6b.sql
-- เพิ่มตารางหมวดงาน (Disciplines) ตาม Req 6B
-CREATE TABLE disciplines (
-    id INT PRIMARY KEY AUTO_INCREMENT,
-    project_id INT NOT NULL,
-    discipline_code VARCHAR(10) NOT NULL COMMENT 'เช่น GEN, STR, ARC',
-    name_th VARCHAR(255) COMMENT 'ชื่อไทย',
-    name_en VARCHAR(255) COMMENT 'ชื่ออังกฤษ',
-    is_active BOOLEAN DEFAULT TRUE,
-    created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP,
-    FOREIGN KEY (project_id) REFERENCES projects(id) ON DELETE CASCADE,
-    UNIQUE KEY uk_discipline_project (project_id, discipline_code)
-) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_general_ci;
-
-- เพิ่มตาราง Sub Types (สำหรับ Transmittal/RFA mapping)
-CREATE TABLE correspondence_sub_type_codes (
-    id INT PRIMARY KEY AUTO_INCREMENT,
-    project_id INT NOT NULL,
-    correspondence_type_id INT NOT NULL,
-    sub_type_code VARCHAR(20) NOT NULL COMMENT 'เช่น MAT, SHP',
-    sub_type_number VARCHAR(10) COMMENT 'เลขรหัส เช่น 11, 22',
-    description VARCHAR(255),
-    FOREIGN KEY (project_id) REFERENCES projects(id) ON DELETE CASCADE,
-    FOREIGN KEY (correspondence_type_id) REFERENCES correspondence_types(id) ON DELETE CASCADE
-) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_general_ci;
+```text
+src/modules/json-schema
+├── 📁 dto
+│   ├── create-json-schema.dto.ts       # DTO สำหรับสร้าง Schema ใหม่
+│   ├── update-json-schema.dto.ts       # DTO สำหรับแก้ไข Schema
+│   ├── validate-data.dto.ts            # DTO สำหรับรับข้อมูลมา Validate
+│   └── migrate-data.dto.ts             # DTO สำหรับสั่ง Migrate Data
+├── 📁 entities
+│   └── json-schema.entity.ts           # Entity หลักเก็บ Definition (T2.5.1)
+├── 📁 services
+│   ├── json-schema.service.ts          # Core Service (CRUD, Validation wrapper)
+│   ├── virtual-column.service.ts       # จัดการ Generated Columns ใน DB (T2.5.3)
+│   ├── schema-migration.service.ts     # จัดการ Data Migration ระหว่าง Version (T2.5.5)
+│   └── json-security.service.ts        # จัดการ Security & Encryption (T2.5.6)
+├── 📁 interfaces
+│   ├── ui-schema.interface.ts          # Type definition สำหรับ UI Schema (T2.5.4)
+│   └── virtual-column.interface.ts     # Type definition สำหรับ Virtual Column Config
+├── json-schema.controller.ts           # API Endpoints (T2.5.7)
+├── json-schema.module.ts               # Module Definition
+└── json-schema.service.spec.ts         # Unit Tests (T2.5.9)
 ```

-### 2.2 ปรับปรุงตาราง `rfas` และ `document_number_counters`
+---

-เนื่องจาก RFA/RFI ต้องวิ่งเลขตาม Discipline เราจึงต้องเก็บ Discipline ไว้ใน RFA และต้องใช้เป็นส่วนหนึ่งของ Key ในการนับเลข
+### 📝 2. รายละเอียดงานในแต่ละ Task (Tasks Breakdown)

-```sql
-- เพิ่ม discipline_id ในตาราง RFAs
-ALTER TABLE rfas
-ADD COLUMN discipline_id INT NULL AFTER rfa_type_id,
-ADD CONSTRAINT fk_rfa_discipline FOREIGN KEY (discipline_id) REFERENCES disciplines(id);
+#### **[ ] T2.5.1 JSON Schema Registry & Versioning**

-- เพิ่ม discipline_id ในตาราง Correspondences (สำหรับ RFI)
-ALTER TABLE correspondences
-ADD COLUMN discipline_id INT NULL AFTER correspondence_type_id,
-ADD CONSTRAINT fk_corr_discipline FOREIGN KEY (discipline_id) REFERENCES disciplines(id);
+- **สิ่งที่ต้องทำ:** สร้าง `JsonSchema` Entity
+- **รายละเอียด:**
+  - เก็บ `schema_definition` (AJV format)
+  - เก็บ `ui_schema` (Form configuration)
+  - รองรับ `version` เพื่อทำ Schema Evolution
+  - เก็บ config ของ `virtual_columns`

-- ปรับปรุงตาราง Counter ให้รองรับ Discipline และ SubType (ใช้เป็น Dynamic Key หรือเพิ่ม Column)
-- เพื่อความ Performance และ Integrity แนะนำให้เพิ่ม Column
-ALTER TABLE document_number_counters
-ADD COLUMN discipline_id INT NULL DEFAULT NULL AFTER correspondence_type_id,
-DROP PRIMARY KEY,
-ADD PRIMARY KEY (project_id, originator_organization_id, correspondence_type_id, discipline_id, current_year);
-- หมายเหตุ: ถ้า discipline_id เป็น NULL ให้ถือว่าเป็น Counter ทั่วไป
-```
+#### **[ ] T2.5.2 Schema Validation & Transformation Engine**

-----
+- **สิ่งที่ต้องทำ:** Implement Logic ใน `JsonSchemaService`
+- **รายละเอียด:**
+  - ติดตั้งและ Config `AJV` library
+  - สร้าง Custom Keywords: `document-number`, `requiredRole`
+  - ฟังก์ชัน `validateData(schemaName, data)`
+  - ฟังก์ชัน `sanitizeData()` เพื่อลบ field ที่ไม่อยู่ใน schema หรือ field ที่ user ไม่มีสิทธิ์

-## 3\. แนวทางการ Implement ใน NestJS (Backend Logic)
+#### **[ ] T2.5.3 Virtual Columns & Performance Optimization**

-เราต้องปรับ `DocumentNumberingService` ให้เป็น **Token-Based Generator** ที่มีความยืดหยุ่นสูง
+- **สิ่งที่ต้องทำ:** สร้าง `VirtualColumnService`
+- **รายละเอียด:**
+  - ฟังก์ชัน `setupVirtualColumns()`: อ่าน Config จาก Schema แล้วสั่ง `ALTER TABLE ... ADD COLUMN ... GENERATED ALWAYS AS ...`
+  - ฟังก์ชันสร้าง Index บน Virtual Column เพื่อให้ค้นหาเร็วขึ้น
+  - **สำคัญ:** ต้องรองรับ MariaDB 10.11 Syntax

-### 3.1 รูปแบบ Template (Format Templates)
+#### **[ ] T2.5.4 Dynamic Form Schema Management**

-Admin จะบันทึก Template ลง DB ในรูปแบบ:
+- **สิ่งที่ต้องทำ:** กำหนด Interface ใน `ui-schema.interface.ts`
+- **รายละเอียด:**
+  - ออกแบบโครงสร้าง JSON ที่ Frontend จะนำไป Render เป็น Form
+  - กำหนด Logic `dependencies` (เช่น ถ้าเลือก Type A ให้แสดง Field B)

-  * General: `{ORG}-{ORG}-{SEQ:4}-{YEAR}`
-  * Transmittal: `{ORG}-{ORG}-{SUBTYPE_NUM}-{SEQ:4}-{YEAR}`
-  * RFA: `{CONTRACT}-{TYPE}-{DISCIPLINE}-{SUBTYPE}-{SEQ:4}-{REV}`
+#### **[ ] T2.5.5 Data Migration & Version Compatibility**

-### 3.2 Logic การ Generate (Pseudo Code)
+- **สิ่งที่ต้องทำ:** สร้าง `SchemaMigrationService`
+- **รายละเอียด:**
+  - Logic การแปลงข้อมูลเก่าให้เข้ากับ Schema ใหม่ (Field Rename, Transform Value)
+  - ฟังก์ชัน `migrateData(entityType, entityId, targetVersion)`

-```typescript
-// File: src/modules/document-numbering/document-numbering.service.ts
+#### **[ ] T2.5.6 Security & Access Control for JSON Data**

-/**
- * Strategy:
- * 1. รับค่า Context (Project, Org, Type, Discipline, SubType, Year)
- * 2. ดึง Format Template จาก DB ตาม Type
- * 3. ถ้าเป็น Transmittal ต้องเช็คเงื่อนไขพิเศษเพื่อเลือก Template (Owner vs Contractor)
- * 4. Parse Template เพื่อหาว่าต้องใช้ Key ไหนบ้างในการ Lock และ Count
- * 5. Run Redlock + Optimistic Lock
- * 6. Replace Tokens
- */
+- **สิ่งที่ต้องทำ:** สร้าง `JsonSecurityService`
+- **รายละเอียด:**
+  - **Field-level Security:** ตรวจสอบ Role ว่าเห็น Field นี้ได้ไหม (Masking/Removal)
+  - **Encryption:** เข้ารหัส Field ที่ Sensitive ก่อนบันทึกลง JSON

-async generateNextNumber(ctx: GenerateNumberContext): Promise<string> {
-    // 1. Get Template
-    let template = await this.formatRepo.findOne({ ... });
+#### **[ ] T2.5.7 API Design & Integration**

-    // 2. Handle Special Logic (Requirement 2.2 Transmittal)
-    if (ctx.typeCode === 'TRANSMITTAL') {
-        // Logic: ถ้าส่งให้ Owner ใช้ Template A, ถ้า Contractor ใช้ Template B
-        // หรือดึง sub_type_number มาเตรียมไว้
-    }
+- **สิ่งที่ต้องทำ:** สร้าง `JsonSchemaController`
+- **Endpoints:**
+  - `POST /json-schema/schemas`: สร้าง Schema
+  - `POST /json-schema/validate/:name`: ตรวจสอบข้อมูล
+  - `POST /json-schema/migrate/:type/:id`: สั่ง Migrate
+  - `GET /json-schema/ui-schema/:name`: ดึง UI Config

-    // 3. Resolve Tokens Values
-    const tokens = {
-        '{ORG}': ctx.orgCode,
-        '{CONTRACT}': ctx.contractCode,
-        '{TYPE}': ctx.typeCode,
-        '{DISCIPLINE}': ctx.disciplineCode, // จากตาราง disciplines
-        '{SUBTYPE}': ctx.subTypeCode,       // จาก rfa_types หรือ sub_type_codes
-        '{SUBTYPE_NUM}': ctx.subTypeNumber, // จาก correspondence_sub_type_codes
-        '{YEAR}': ctx.year.toString(),
-        '{YEAR_SHORT}': ctx.year.toString().slice(-2),
-    };
+#### **[ ] T2.5.8 Integration with Document Modules**

-    // 4. Construct Counter Key
-    // ถ้า Template มี {DISCIPLINE} ต้องเอา discipline_id มาเป็นส่วนหนึ่งของ Composite Key ใน DB Counter
-    const counterKey = {
-        projectId: ctx.projectId,
-        orgId: ctx.orgId,
-        typeId: ctx.typeId,
-        disciplineId: template.includes('{DISCIPLINE}') ? ctx.disciplineId : null,
-        year: template.includes('{YEAR}') ? ctx.year : 0 // ถ้าไม่ใช้ปี ให้ใช้ 0
-    };
+- **สิ่งที่ต้องทำ:** แก้ไข Service อื่นๆ (Correspondence, RFA)
+- **รายละเอียด:**
+  - Inject `JsonSchemaService` เข้าไปใน `CorrespondenceService` และ `RfaService`
+  - เรียก `validateData` ก่อน create/update
+  - เรียก `setupVirtualColumns` หลัง create schema ใหม่

-    // 5. Execute Double-Lock Mechanism (Redis + DB Optimistic)
-    const seq = await this.runDistributedCounter(counterKey);
+#### **[ ] T2.5.9 Testing Strategy**

-    // 6. Final Replace
-    let finalNumber = template.formatTemplate;
-    for (const [key, value] of Object.entries(tokens)) {
-        finalNumber = finalNumber.replace(key, value || '00'); // Fallback if missing
-    }
-    // Replace SEQ with padding
-    finalNumber = finalNumber.replace(/{SEQ:(\d+)}/, (_, width) =>
-        String(seq).padStart(Number(width), '0')
-    );
+- **สิ่งที่ต้องทำ:** เขียน Unit Test
+- **รายละเอียด:**
+  - ทดสอบ Validation Logic (ผ่าน/ไม่ผ่าน)
+  - ทดสอบ Virtual Column Generation (SQL ถูกต้องไหม)
+  - ทดสอบ Security Masking

-    return finalNumber;
-}
-```
+---

-----
+### 🚀 ขั้นตอนถัดไป

-## 4\. แผนการดำเนินการ (Action Plan)
+หากท่านเห็นด้วยกับโครงสร้างนี้ ผมแนะนำให้เริ่มดำเนินการตามลำดับดังนี้ครับ:

-เพื่อให้รองรับ `6B.md` ได้สมบูรณ์ ผมขอเสนอให้ดำเนินการดังนี้:
+1.  **สร้าง Entity และ DTOs** (T2.5.1)
+2.  **Implement JsonSchemaService Core** (Validation Logic) (T2.5.2)
+3.  **Implement VirtualColumnService** (T2.5.3) - _ส่วนนี้สำคัญมากสำหรับ Performance_
+4.  **สร้าง Controller และเชื่อมต่อ Module** (T2.5.7)

-1.  **Database Migration:**
-      * รัน SQL Script เพื่อเพิ่มตาราง `disciplines`, `correspondence_sub_type_codes`.
-      * Alter ตาราง `rfas`, `correspondences` และ `document_number_counters` ตามข้อ 2.2
-2.  **Seed Data:**
-      * นำข้อมูลจากตารางใน `6B.md` (Disciplines, RFA Types, Sub Types) มาเขียนเป็น Seed Script ลงฐานข้อมูล เพื่อให้เริ่มต้นระบบมีข้อมูลพร้อมใช้ทันที
-3.  **Backend Implementation:**
-      * Update `DocumentNumberingService` ให้รองรับ Dynamic Token Replacement
-      * Update `CreateRfaDto` และ `CreateCorrespondenceDto` ให้รับค่า `discipline_id` และ `sub_type_id` (ถ้ามี)
-4.  **Admin Panel:**
-      * ต้องมีหน้า UI ให้ Admin จัดการ Mapping ของ `Format Template` และ `Sub Type Codes` ได้ (ตาม Requirement ข้อ 1)
-
-**ต้องการให้ผมเริ่มเขียน SQL Migration Script และ Seed Data สำหรับข้อมูลใน 6B.md เลยหรือไม่ครับ?** (ข้อมูลในตารางค่อนข้างเยอะ การทำ Seed ไว้จะช่วยลดเวลา Admin ในการกรอกข้อมูลเริ่มต้นได้มากครับ)
-
-จาก แผนการดำเนินการ (Action Plan): Database Migration และ Seed Data, ผมได้อัพเดท Basic data ข้อ 5. Data files ให้แล้ว, ช่วย review และ ปรับปรุง 4_Data_Dictionary_V1_4_3.md ,
-
-เตรียม Backend Implementation, Admin Panel
-
-
-
-
-
-### **Phase 2: High-Integrity Data & File Management (สัปดาห์ที่ 4)**
-
-* **[ ] T2.3 DocumentNumberingModule - Token-Based & Double-Lock** (Updated)
-    * [ ] Update Entity: `DocumentNumberCounter` (Add `discipline_id` to PK)
-    * [ ] Implement Token Parser & Replacer Logic (`{DISCIPLINE}`, `{SUBTYPE_NUM}`)
-    * [ ] Update `generateNextNumber` to handle optional keys (Discipline/SubType)
-    * [ ] **Deliverable:** Flexible Numbering System
-
-* **[ ] T2.6 MasterModule - Advanced Data (Req 6B)** (New)
-    * [ ] Update Entities: `Discipline`, `CorrespondenceSubType`
-    * [ ] Create Services/Controllers for CRUD Operations (Admin Panel Support)
-    * [ ] Implement Seeding Logic for initial 6B data
-    * [ ] **Deliverable:** API for managing Disciplines and Sub-types
-    * [ ] **Dependencies:** T1.1, T0.3
+ท่านต้องการให้ผมเริ่มเขียนโค้ดส่วนไหนก่อนหรือไม่ครับ? (เช่น Entity หรือ VirtualColumnService)