lcbp3/docs/Markdown/LCBP3-DMS_V1_2_0_Data_Dictionary.ิbak

# **สรุปตารางฐานข้อมูล (Data Dictionary) \- LCBP3-DMS**

เอกสารนี้สรุปโครงสร้างตาราง, Foreign Keys (FK), และ Constraints ที่สำคัญทั้งหมดในฐานข้อมูล LCBP3-DMS (v1.1.1) เพื่อใช้เป็นเอกสารอ้างอิงสำหรับทีมพัฒนา Backend (NestJS) และ Frontend (Next.js)

## **1\. 🏢 Core & Master Data (องค์กร, โครงการ, สัญญา)**

#### **1.1. organization\_roles**

ตาราง Master เก็บประเภทบทบาทขององค์กร (เช่น OWNER, CONTRACTOR)

| Column | Type | Key | Description |
| :---- | :---- | :---- | :---- |
| id | INT | **PK** | ID ของตาราง |
| role\_name | VARCHAR(20) | UK | ชื่อบทบาท (OWNER, DESIGNER, CONSULTANT, CONTRACTOR, THIRD PARTY) |

* **Unique Keys (UK):** ux\_roles\_name (role\_name)

#### **1.2. organizations**

ตาราง Master เก็บข้อมูลองค์กรทั้งหมดที่เกี่ยวข้องในระบบ

| Column | Type | Key | Description |
| :---- | :---- | :---- | :---- |
| id | INT | **PK** | ID ของตาราง |
| organization\_code | VARCHAR(20) | UK | รหัสองค์กร |
| organization\_name | VARCHAR(255) |  | ชื่อองค์กร |
| role\_id | INT | FK | บทบาทขององค์กร (FK \-\> organization\_roles(id)) |
| is\_active | BOOLEAN |  | สถานะการใช้งาน |

* **Foreign Keys (FK):**  
  * role\_id \-\> organization\_roles(id) (ON DELETE SET NULL)  
* **Unique Keys (UK):** ux\_organizations\_code (organization\_code)

#### **1.3. projects**

ตาราง Master เก็บข้อมูลโครงการ (เช่น LCBP3C1, LCBP3C2)

| Column | Type | Key | Description |
| :---- | :---- | :---- | :---- |
| id | INT | **PK** | ID ของตาราง |
| project\_code | VARCHAR(50) | UK | รหัสโครงการ |
| project\_name | VARCHAR(255) |  | ชื่อโครงการ |
| parent\_project\_id | INT | FK | รหัสโครงการหลัก (ถ้ามี) (FK \-\> projects(id)) |
| contractor\_organization\_id | INT | FK | รหัสองค์กรผู้รับเหมา (ถ้ามี) (FK \-\> organizations(id)) |
| is\_active | TINYINT(1) |  | สถานะการใช้งาน |

* **Foreign Keys (FK):**  
  * parent\_project\_id \-\> projects(id) (ON DELETE SET NULL)  
  * contractor\_organization\_id \-\> organizations(id) (ON DELETE SET NULL)  
* **Unique Keys (UK):** uq\_pro\_code (project\_code)

#### **1.4. contracts**

ตาราง Master เก็บข้อมูลสัญญา

| Column | Type | Key | Description |
| :---- | :---- | :---- | :---- |
| id | INT | **PK** | ID ของตาราง |
| contract\_code | VARCHAR(50) | UK | รหัสสัญญา |
| contract\_name | VARCHAR(255) |  | ชื่อสัญญา |
| description | TEXT |  | คำอธิบายสัญญา |

* **Unique Keys (UK):** ux\_contracts\_code (contract\_code)

#### **1.5. project\_parties (ตารางเชื่อม)**

ตารางเชื่อมความสัมพันธ์ระหว่าง โครงการ, องค์กร, และบทบาท (M:N)

| Column | Type | Key | Description |
| :---- | :---- | :---- | :---- |
| project\_id | INT | **PK**, FK | ID ของโครงการ (FK \-\> projects(id)) |
| organization\_id | INT | **PK**, FK | ID ขององค์กร (FK \-\> organizations(id)) |
| role | ENUM(...) | **PK** | บทบาทในโครงการ (OWNER, DESIGNER, CONSULTANT, CONTRACTOR, THIRD\_PARTY) |
| is\_contractor | TINYINT(1) | UK | (Generated) \= 1 ถ้า role \= 'CONTRACTOR' |

* **Foreign Keys (FK):**  
  * project\_id \-\> projects(id) (ON DELETE CASCADE)  
  * organization\_id \-\> organizations(id) (ON DELETE RESTRICT)  
* **Unique Keys (UK):**  
  * uq\_project\_parties\_contractor (project\_id, is\_contractor) \- **(Constraint สำคัญ)** บังคับว่า 1 โครงการมี CONTRACTOR ได้เพียง 1 องค์กร (ตาม Req 3.1.3)

#### **1.6. contract\_parties (ตารางเชื่อม)**

ตารางเชื่อมความสัมพันธ์ระหว่าง สัญญา, โครงการ, และองค์กร (M:N)

| Column | Type | Key | Description |
| :---- | :---- | :---- | :---- |
| contract\_id | INT | **PK**, FK | ID ของสัญญา (FK \-\> contracts(id)) |
| project\_id | INT | **PK**, FK | ID ของโครงการ (FK \-\> projects(id)) |
| organization\_id | INT | **PK**, FK | ID ขององค์กร (FK \-\> organizations(id)) |

* **Foreign Keys (FK):**  
  * contract\_id \-\> contracts(id) (ON DELETE CASCADE)  
  * project\_id \-\> projects(id) (ON DELETE CASCADE)  
  * organization\_id \-\> organizations(id) (ON DELETE CASCADE)

## **2\. 👥 Users & RBAC (ผู้ใช้, สิทธิ์, บทบาท)**

#### **2.1. users**

ตาราง Master เก็บข้อมูลผู้ใช้งาน (User)

| Column | Type | Key | Description |
| :---- | :---- | :---- | :---- |
| user\_id | INT | **PK** | ID ของตาราง |
| username | VARCHAR(50) | UK | ชื่อผู้ใช้งาน |
| password\_hash | VARCHAR(255) |  | รหัสผ่าน (Hashed) |
| first\_name | VARCHAR(50) |  | ชื่อจริง |
| last\_name | VARCHAR(50) |  | นามสกุล |
| email | VARCHAR(100) | UK | อีเมล |
| organization\_id | INT | FK | สังกัดองค์กร (FK \-\> organizations(id)) |
| is\_active | TINYINT(1) |  | สถานะการใช้งาน |

* **Foreign Keys (FK):**  
  * organization\_id \-\> organizations(id) (ON DELETE SET NULL)  
* **Unique Keys (UK):** ux\_users\_username (username), ux\_users\_email (email)

#### **2.2. roles**

ตาราง Master เก็บ "บทบาท" ของผู้ใช้ในระบบ (เช่น SUPER\_ADMIN, ADMIN, EDITOR)

| Column | Type | Key | Description |
| :---- | :---- | :---- | :---- |
| role\_id | INT | **PK** | ID ของตาราง |
| role\_code | VARCHAR(50) | UK | รหัสบทบาท (เช่น SUPER\_ADMIN, ADMIN, EDITOR, VIEWER) |
| role\_name | VARCHAR(100) |  | ชื่อบทบาท |
| is\_system | BOOLEAN |  | (1 \= บทบาทของระบบ ลบไม่ได้) |

* **Unique Keys (UK):** role\_code

#### **2.3. permissions**

ตาราง Master เก็บ "สิทธิ์" (Permission) หรือ "การกระทำ" ทั้งหมดในระบบ

| Column | Type | Key | Description |
| :---- | :---- | :---- | :---- |
| permission\_id | INT | **PK** | ID ของตาราง |
| permission\_code | VARCHAR(100) | UK | รหัสสิทธิ์ (เช่น rfas.create, rfas.view) |
| module | VARCHAR(50) |  | โมดูลที่เกี่ยวข้อง |
| scope\_level | ENUM(...) |  | ระดับของสิทธิ์ (GLOBAL, ORG, PROJECT) |

* **Unique Keys (UK):** ux\_permissions\_code (permission\_code)

#### **2.4. role\_permissions (ตารางเชื่อม)**

ตารางเชื่อมระหว่าง roles และ permissions (M:N)

| Column | Type | Key | Description |
| :---- | :---- | :---- | :---- |
| role\_id | INT | **PK**, FK | ID ของบทบาท (FK \-\> roles(role\_id)) |
| permission\_id | INT | **PK**, FK | ID ของสิทธิ์ (FK \-\> permissions(permission\_id)) |

* **Foreign Keys (FK):**  
  * role\_id \-\> roles(role\_id) (ON DELETE CASCADE)  
  * permission\_id \-\> permissions(permission\_id) (ON DELETE CASCADE)

#### **2.5. user\_roles (ตารางเชื่อม)**

ตารางเชื่อมผู้ใช้ (users) กับบทบาท (roles) ในระดับ **Global** (M:N)

| Column | Type | Key | Description |
| :---- | :---- | :---- | :---- |
| user\_id | INT | **PK**, FK | ID ของผู้ใช้ (FK \-\> users(user\_id)) |
| role\_id | INT | **PK**, FK | ID ของบทบาท (FK \-\> roles(role\_id)) |

* **Foreign Keys (FK):**  
  * user\_id \-\> users(user\_id) (ON DELETE CASCADE)  
  * role\_id \-\> roles(role\_id) (ON DELETE CASCADE)

#### **2.6. user\_project\_roles (ตารางเชื่อม)**

ตารางเชื่อมผู้ใช้ (users) กับบทบาท (roles) ในระดับ **Project-Specific** (M:N) (Req 4.2)

| Column | Type | Key | Description |
| :---- | :---- | :---- | :---- |
| user\_id | INT | **PK**, FK | ID ของผู้ใช้ (FK \-\> users(user\_id)) |
| project\_id | INT | **PK**, FK | ID ของโครงการ (FK \-\> projects(id)) |
| role\_id | INT | **PK**, FK | ID ของบทบาท (FK \-\> roles(role\_id)) |

* **Foreign Keys (FK):**  
  * user\_id \-\> users(user\_id) (ON DELETE CASCADE)  
  * project\_id \-\> projects(id) (ON DELETE CASCADE)  
  * role\_id \-\> roles(role\_id) (ON DELETE CASCADE)

## **3\. ✉️ Correspondences (เอกสารหลัก, Revisions)**

#### **3.1. correspondence\_types**

ตาราง Master เก็บประเภทเอกสารโต้ตอบ (เช่น RFA, RFI, LETTER, MOM)

| Column | Type | Key | Description |
| :---- | :---- | :---- | :---- |
| id | INT | **PK** | ID ของตาราง |
| type\_code | VARCHAR(50) | UK | รหัสประเภท (เช่น RFA, RFI) |
| type\_name | VARCHAR(255) |  | ชื่อประเภท |

* **Unique Keys (UK):** type\_code

#### **3.2. correspondence\_status**

ตาราง Master เก็บสถานะของเอกสาร (เช่น DRAFT, SUBMITTED, CLOSED)

| Column | Type | Key | Description |
| :---- | :---- | :---- | :---- |
| id | INT | **PK** | ID ของตาราง |
| status\_code | VARCHAR(50) | UK | รหัสสถานะ (เช่น DRAFT, SUBOWN) |
| status\_name | VARCHAR(255) |  | ชื่อสถานะ |

* **Unique Keys (UK):** status\_code

#### **3.3. correspondences (Master)**

ตาราง "แม่" ของเอกสารโต้ตอบ เก็บข้อมูลที่ไม่เปลี่ยนแปลงตาม Revision (เช่น เลขที่เอกสาร)

| Column | Type | Key | Description |
| :---- | :---- | :---- | :---- |
| id | INT | **PK** | ID ของตาราง (นี่คือ "Master ID" ที่ใช้เชื่อมโยง) |
| correspondence\_number | VARCHAR(100) | UK | เลขที่เอกสาร (สร้างจาก DocumentNumberingModule) |
| correspondence\_type\_id | INT | FK | ประเภทเอกสาร (FK \-\> correspondence\_types(id)) |
| is\_internal\_communication | TINYINT(1) |  | (1 \= ภายใน, 0 \= ภายนอก) |
| project\_id | INT | FK | อยู่ในโครงการ (FK \-\> projects(id)) |
| originator\_id | INT | FK | องค์กรผู้ส่ง (FK \-\> organizations(id)) |
| recipient\_id | INT | FK | องค์กรผู้รับ (FK \-\> organizations(id)) |
| created\_by | INT | FK | ผู้สร้าง (FK \-\> users(user\_id)) |
| deleted\_at | DATETIME |  | สำหรับ Soft Delete |

* **Foreign Keys (FK):**  
  * correspondence\_type\_id \-\> correspondence\_types(id) (ON DELETE RESTRICT)  
  * project\_id \-\> projects(id) (ON DELETE CASCADE)  
  * originator\_id \-\> organizations(id) (ON DELETE SET NULL)  
  * recipient\_id \-\> organizations(id) (ON DELETE SET NULL)  
  * created\_by \-\> users(user\_id) (ON DELETE SET NULL)  
* **Unique Keys (UK):** uq\_corr\_no\_per\_project (project\_id, correspondence\_number)

#### **3.4. correspondence\_revisions (Revisions)**

ตาราง "ลูก" เก็บประวัติการแก้ไข (Revisions) ของ correspondences (1:N) **(ปรับปรุง)** id เป็น PK ใหม่ เพื่อรองรับ 1:N

| Column | Type | Key | Description |
| :---- | :---- | :---- | :---- |
| id | INT | **PK** | **ID ของ Revision** |
| correspondence\_id | INT | FK, UK | Master ID (FK \-\> correspondences(id)) |
| revision\_number | INT | UK | หมายเลข Revision (0, 1, 2...) |
| revision\_label | VARCHAR(10) |  | Revision ที่แสดง (เช่น A, B, 1.1) |
| is\_current | BOOLEAN | UK | (1 \= Revision ปัจจุบัน) |
| correspondence\_status\_id | INT | FK | สถานะของ Revision นี้ (FK \-\> correspondence\_status(id)) |
| title | VARCHAR(255) |  | เรื่อง |
| document\_date | DATE |  | วันที่ในเอกสาร |
| issued\_date | DATETIME |  | วันที่ออกเอกสาร |
| received\_date | DATETIME |  | วันที่ลงรับ |
| due\_date | DATETIME |  | **(ไม่สอดคล้องกับ Req 3.2.5)** วันที่ครบกำหนด (ควรย้ายไป correspondence\_recipients) |
| details | JSON |  | ข้อมูลเฉพาะ (เช่น RFI details) |
| created\_by | INT | FK | ผู้สร้าง (FK \-\> users(user\_id)) |

* **Foreign Keys (FK):**  
  * correspondence\_id \-\> correspondences(id) (ON DELETE CASCADE)  
  * correspondence\_status\_id \-\> correspondence\_status(id) (ON DELETE RESTRICT)  
  * created\_by \-\> users(user\_id) (ON DELETE SET NULL)  
* **Unique Keys (UK):**  
  * uq\_master\_revision\_number (correspondence\_id, revision\_number) (ป้องกัน Rev ซ้ำใน Master เดียว)  
  * uq\_master\_current (correspondence\_id, is\_current) (ป้องกันการมี is\_current \= TRUE ซ้ำใน Master เดียว)  
* **Check Constraints (CHK):** chk\_rev\_format (ตรวจสอบรูปแบบ revision\_label)

#### **3.5. correspondence\_recipients (ตารางเชื่อม)**

ตารางเชื่อมผู้รับ (TO/CC) สำหรับเอกสารแต่ละฉบับ (M:N)

| Column | Type | Key | Description |
| :---- | :---- | :---- | :---- |
| correspondence\_id | INT | **PK**, FK | ID ของเอกสาร (FK \-\> correspondence\_revisions(correspondence\_id)) |
| recipient\_organization\_id | INT | **PK**, FK | ID องค์กรผู้รับ (FK \-\> organizations(id)) |
| recipient\_type | ENUM('TO', 'CC') | **PK** | ประเภทผู้รับ (TO หรือ CC) |

* **Foreign Keys (FK):**  
  * correspondence\_id \-\> correspondence\_revisions(correspondence\_id) (ON DELETE CASCADE)  
  * recipient\_organization\_id \-\> organizations(id) (ON DELETE RESTRICT)

#### **3.6. correspondence\_references (ตารางเชื่อม)**

ตารางเชื่อมการอ้างอิงระหว่างเอกสาร (M:N) (Req 3.2.4)

| Column | Type | Key | Description |
| :---- | :---- | :---- | :---- |
| src\_correspondence\_id | INT | **PK**, FK | ID เอกสารต้นทาง (FK \-\> correspondences(id)) |
| tgt\_correspondence\_id | INT | **PK**, FK | ID เอกสารเป้าหมาย (FK \-\> correspondences(id)) |

* **Foreign Keys (FK):**  
  * src\_correspondence\_id \-\> correspondences(id) (ON DELETE CASCADE)  
  * tgt\_correspondence\_id \-\> correspondences(id) (ON DELETE CASCADE)

#### **3.7. correspondence\_routing\_templates / ...\_steps / ...\_routings**

ตารางที่เกี่ยวข้องกับ Workflow การส่งต่อเอกสาร (Req 3.5.4)

* **correspondence\_routing\_templates:** ตาราง Master เก็บแม่แบบสายงาน (เช่น "ส่งให้ CSC ตรวจสอบ")  
* **correspondence\_routing\_template\_steps:** ตารางลูก เก็บขั้นตอนในแม่แบบ (เช่น Step 1: ส่งไป Org A, Step 2: ส่งไป Org B)  
* **correspondence\_routings:** ตารางประวัติ (Log) การส่งต่อของเอกสารจริงตาม Workflow

## **4\. approval: RFA (เอกสารขออนุมัติ, Workflows)**

#### **4.1. rfa\_types / ...\_status\_codes / ...\_approve\_codes**

ตาราง Master สำหรับ RFA

* **rfa\_types:** ประเภท RFA (เช่น DWG, DOC, MAT) (Req 3.5.2)  
* **rfa\_status\_codes:** สถานะ RFA (เช่น DFT \- Draft, FAP \- For Approve)  
* **rfa\_approve\_codes:** รหัสผลการอนุมัติ (เช่น 1A \- Approved, 3R \- Revise and Resubmit)

#### **4.2. rfas (Master)**

ตาราง "แม่" ของ RFA (มีความสัมพันธ์ 1:N กับ rfa\_revisions)

| Column | Type | Key | Description |
| :---- | :---- | :---- | :---- |
| id | INT | **PK** | ID ของตาราง (RFA Master ID) |
| rfa\_type\_id | INT | FK | ประเภท RFA (FK \-\> rfa\_types(id)) |
| revision\_number | INT |  | หมายเลข Revision ล่าสุด (ควรย้ายไป rfa\_revisions) |
| created\_by | INT | FK | ผู้สร้าง (FK \-\> users(user\_id)) |
| deleted\_at | DATETIME |  | สำหรับ Soft Delete |

* **Foreign Keys (FK):**  
  * rfa\_type\_id \-\> rfa\_types(id)  
  * created\_by \-\> users(user\_id) (ON DELETE SET NULL)

#### **4.3. rfa\_revisions (Revisions)**

ตาราง "ลูก" เก็บประวัติ (Revisions) ของ rfas (1:N) **(ปรับปรุง)** id เป็น PK ใหม่ เพื่อรองรับ 1:N

| Column | Type | Key | Description |
| :---- | :---- | :---- | :---- |
| id | INT | **PK** | **ID ของ Revision** |
| correspondence\_id | INT | FK | Master ID ของ Correspondence (FK \-\> correspondences(id)) |
| rfa\_id | INT | FK, UK | Master ID ของ RFA (FK \-\> rfas(id)) |
| revision\_number | INT | UK | หมายเลข Revision (0, 1, 2...) |
| is\_current | BOOLEAN | UK | (1 \= Revision ปัจจุบัน) |
| rfa\_status\_code\_id | INT | FK | สถานะ RFA (FK \-\> rfa\_status\_codes(id)) |
| rfa\_approve\_code\_id | INT | FK | ผลการอนุมัติ (FK \-\> rfa\_approve\_codes(id)) |
| title | VARCHAR(255) |  | เรื่อง |
| due\_date | DATETIME |  | **(ไม่สอดคล้องกับ Req 3.6.6)** วันที่ครบกำหนด (ควรย้ายไป rfa\_workflows) |
| created\_by | INT | FK | ผู้สร้าง (FK \-\> users(user\_id)) |

* **Foreign Keys (FK):**  
  * correspondence\_id \-\> correspondences(id) (ON DELETE CASCADE)  
  * rfa\_id \-\> rfas(id) (ON DELETE CASCADE)  
  * rfa\_status\_code\_id \-\> rfa\_status\_codes(id)  
  * rfa\_approve\_code\_id \-\> rfa\_approve\_codes(id) (ON DELETE SET NULL)  
  * created\_by \-\> users(user\_id) (ON DELETE SET NULL)  
* **Unique Keys (UK):**  
  * uq\_rr\_rev\_number (rfa\_id, revision\_number) (ป้องกัน Rev ซ้ำใน Master เดียว)  
  * uq\_rr\_current (rfa\_id, is\_current) (ป้องกัน is\_current=TRUE ซ้ำใน Master เดียว)

#### **4.4. rfa\_items (ตารางเชื่อม)**

ตารางเชื่อมระหว่าง rfa\_revisions (ที่เป็นประเภท DWG) กับ shop\_drawing\_revisions (M:N) (Req 3.5.4)

| Column | Type | Key | Description |
| :---- | :---- | :---- | :---- |
| rfarev\_correspondence\_id | INT | **PK**, FK | ID ของ RFA Revision (FK \-\> rfa\_revisions(correspondence\_id)) |
| shop\_drawing\_revision\_id | INT | **PK**, UK, FK | ID ของ Shop Drawing Revision (FK \-\> shop\_drawing\_revisions(id)) |

* **Foreign Keys (FK):**  
  * rfarev\_correspondence\_id \-\> rfa\_revisions(correspondence\_id) (ON DELETE CASCADE)  
  * shop\_drawing\_revision\_id \-\> shop\_drawing\_revisions(id) (ON DELETE CASCADE)

#### **4.5. rfa\_workflow\_templates / ...\_steps / ...\_workflows**

ตารางที่เกี่ยวข้องกับ Workflow การอนุมัติ RFA (Req 3.6.5)

* **rfa\_workflow\_templates:** ตาราง Master เก็บแม่แบบสายอนุมัติ (เช่น "สายอนุมัติ 3 ขั้นตอน")  
* **rfa\_workflow\_template\_steps:** ตารางลูก เก็บขั้นตอนในแม่แบบ (เช่น Step 1: Org A (Review), Step 2: Org B (Approve))  
* **rfa\_workflows:** ตารางประวัติ (Log) การอนุมัติของ RFA จริงตามสายงาน

## **5\. 📐 Drawings (แบบ, หมวดหมู่)**

#### **5.1. contract\_drawing\_volumes / ...\_cats / ...\_sub\_cats / ...\_subcat\_cat\_maps**

ตาราง Master สำหรับ "แบบคู่สัญญา" (Contract Drawings) (Req 3.3)

* **contract\_drawing\_volumes:** เก็บ "เล่ม" ของแบบ  
* **contract\_drawing\_cats:** เก็บ "หมวดหมู่หลัก" ของแบบ  
* **contract\_drawing\_sub\_cats:** เก็บ "หมวดหมู่ย่อย" ของแบบ  
* **contract\_drawing\_subcat\_cat\_maps:** ตารางเชื่อมระหว่าง หมวดหมู่หลัก-ย่อย (M:N)

#### **5.2. contract\_drawings (Master)**

ตาราง Master เก็บข้อมูล "แบบคู่สัญญา" (Req 3.3.4)

| Column | Type | Key | Description |
| :---- | :---- | :---- | :---- |
| id | INT | **PK** | ID ของตาราง |
| project\_id | INT | FK, UK | โครงการ (FK \-\> projects(id)) |
| condwg\_no | VARCHAR(255) | UK | เลขที่แบบสัญญา |
| title | VARCHAR(255) |  | ชื่อแบบ |
| sub\_cat\_id | INT | FK | หมวดหมู่ย่อย (FK \-\> contract\_drawing\_sub\_cats(id)) |
| volume\_id | INT | FK | เล่ม (FK \-\> contract\_drawing\_volumes(id)) |

* **Foreign Keys (FK):**  
  * fk\_condwg\_project (project\_id) \-\> projects(id) (ON DELETE CASCADE)  
  * fk\_condwg\_subcat\_same\_project (project\_id, sub\_cat\_id) \-\> contract\_drawing\_sub\_cats(project\_id, id)  
  * fk\_condwg\_volume\_same\_project (project\_id, volume\_id) \-\> contract\_drawing\_volumes(project\_id, id)  
* **Unique Keys (UK):** ux\_condwg\_no\_project (project\_id, condwg\_no)

#### **5.3. shop\_drawing\_main\_categories / ...\_sub\_categories**

ตาราง Master สำหรับ "แบบก่อสร้าง" (Shop Drawings) (Req 3.4)

* **shop\_drawing\_main\_categories:** เก็บ "หมวดหมู่หลัก" (เช่น ARCH, STR)  
* **shop\_drawing\_sub\_categories:** เก็บ "หมวดหมู่ย่อย" (เช่น STR-COLUMN)

#### **5.4. shop\_drawings (Master)**

ตาราง Master เก็บข้อมูล "แบบก่อสร้าง" (Req 3.4.4)

| Column | Type | Key | Description |
| :---- | :---- | :---- | :---- |
| id | INT | **PK** | ID ของตาราง |
| project\_id | INT | FK | โครงการ (FK \-\> projects(id)) |
| drawing\_number | VARCHAR(100) | UK | เลขที่ Shop Drawing |
| title | VARCHAR(500) |  | ชื่อแบบ |
| main\_category\_id | INT | FK | หมวดหมู่หลัก (FK \-\> shop\_drawing\_main\_categories(id)) |
| sub\_category\_id | INT | FK | หมวดหมู่ย่อย (FK \-\> shop\_drawing\_sub\_categories(id)) |

* **Foreign Keys (FK):** project\_id, main\_category\_id, sub\_category\_id  
* **Unique Keys (UK):** ux\_sd\_drawing\_number (drawing\_number)

#### **5.5. shop\_drawing\_revisions (Revisions)**

ตาราง "ลูก" เก็บประวัติ (Revisions) ของ shop\_drawings (1:N) **(ปรับปรุง)** ลบ file\_path ออกแล้ว

| Column | Type | Key | Description |
| :---- | :---- | :---- | :---- |
| id | INT | **PK** | ID ของ Revision |
| shop\_drawing\_id | INT | FK, UK | Master ID (FK \-\> shop\_drawings(id)) |
| revision\_number | VARCHAR(10) | UK | หมายเลข Revision (เช่น A, B, 0, 1\) |
| revision\_date | DATE |  | วันที่ของ Revision |
| description | TEXT |  | คำอธิบายการแก้ไข |

* **Foreign Keys (FK):**  
  * shop\_drawing\_id \-\> shop\_drawings(id) (ON DELETE CASCADE)  
* **Unique Keys (UK):** ux\_sd\_rev\_drawing\_revision (shop\_drawing\_id, revision\_number)

#### **5.6. shop\_drawing\_revision\_contract\_refs (ตารางเชื่อม)**

ตารางเชื่อมระหว่าง shop\_drawing\_revisions กับ contract\_drawings (M:N) (Req 3.5.4)

| Column | Type | Key | Description |
| :---- | :---- | :---- | :---- |
| shop\_drawing\_revision\_id | INT | FK | ID ของ Shop Drawing Revision (FK \-\> shop\_drawing\_revisions(id)) |
| contract\_drawing\_id | INT | FK | ID ของ Contract Drawing (FK \-\> contract\_drawings(id)) |

* **Foreign Keys (FK):** shop\_drawing\_revision\_id, contract\_drawing\_id

## **6\. 🔄 Circulations (ใบเวียนภายใน)**

#### **6.1. circulation\_status\_codes**

ตาราง Master เก็บสถานะใบเวียน (เช่น OPEN, IN\_REVIEW, COMPLETED)

#### **6.2. circulations (Master)**

ตาราง "แม่" ของใบเวียนเอกสารภายใน (Req 3.7)

| Column | Type | Key | Description |
| :---- | :---- | :---- | :---- |
| id | INT | **PK** | ID ของตาราง |
| correspondence\_id | INT | UK, FK | เอกสารที่ใช้อ้างอิง (FK \-\> correspondences(id)) |
| organization\_id | INT | FK, UK | องค์กรเจ้าของใบเวียน (FK \-\> organizations(id)) |
| circulation\_no | VARCHAR(100) | UK | เลขที่ใบเวียน |
| circulation\_subject | VARCHAR(500) |  | เรื่อง |
| circulation\_status\_code | VARCHAR(20) | FK | สถานะใบเวียน (FK \-\> circulation\_status\_codes(code)) |
| created\_by\_user\_id | INT | FK | ผู้สร้าง (FK \-\> users(user\_id)) |

* **Foreign Keys (FK):** correspondence\_id, organization\_id, circulation\_status\_code, created\_by\_user\_id  
* **Unique Keys (UK):**  
  * correspondence\_id (1 ใบเวียน ต่อ 1 เอกสาร)  
  * uq\_cir\_org\_no (organization\_id, circulation\_no) (เลขที่ใบเวียนห้ามซ้ำในองค์กร)

#### **6.3. circulation\_recipients / ...\_assignees / ...\_actions**

ตาราง "ลูก" ของ circulations

* **circulation\_recipients:** รายชื่อผู้รับ (TO/CC) ภายในองค์กร  
* **circulation\_assignees:** รายชื่อผู้รับผิดชอบ (MAIN, ACTION, INFO) (Req 3.7.4) และเก็บ deadline (Req 3.7.5)  
* **circulation\_actions:** ประวัติการดำเนินการ (เช่น Comment, Forward, Close)  
* **circulation\_action\_documents:** ตารางเชื่อม circulation\_actions กับ attachments (ไฟล์แนบระหว่างดำเนินการ)

#### **6.4. circulation\_templates / ...\_assignees**

ตารางสำหรับแม่แบบใบเวียน (Templates)

* **circulation\_templates:** ตาราง Master เก็บแม่แบบใบเวียน  
* **circulation\_template\_assignees:** ตารางลูก เก็บผู้รับผิดชอบที่กำหนดไว้ล่วงหน้าในแม่แบบ

## **7\. 📤 Transmittals (เอกสารนำส่ง)**

#### **7.1. transmittals**

ตารางข้อมูลเฉพาะของเอกสารนำส่ง (เป็นตารางลูก 1:1 ของ correspondences) (Req 3.6)

| Column | Type | Key | Description |
| :---- | :---- | :---- | :---- |
| correspondence\_id | INT | **PK**, FK | ID ของเอกสาร (FK \-\> correspondences(id)) |
| purpose | ENUM(...) |  | วัตถุประสงค์ (FOR\_APPROVAL, FOR\_INFORMATION, ...) |
| remarks | TEXT |  | หมายเหตุ |

* **Foreign Keys (FK):** correspondence\_id \-\> correspondences(id) (ON DELETE CASCADE)

#### **7.2. transmittal\_items (ตารางเชื่อม)**

ตารางเชื่อมระหว่าง transmittals และ rfa\_revisions (M:N) (Req 3.6.1)

| Column | Type | Key | Description |
| :---- | :---- | :---- | :---- |
| transmittal\_id | INT | **PK**, FK | ID ของ Transmittal (FK \-\> transmittals(correspondence\_id)) |
| rfarev\_id | INT | **PK**, FK | ID ของ RFA Revision (FK \-\> rfa\_revisions(correspondence\_id)) |

* **Foreign Keys (FK):**  
  * transmittal\_id \-\> transmittals(correspondence\_id) (ON DELETE CASCADE)  
  * rfarev\_id \-\> rfa\_revisions(correspondence\_id) (ON DELETE CASCADE)  
* **Unique Keys (UK):** ux\_transmittal\_item (transmittal\_id, rfarev\_id)

## **8\. 📎 File Management (ไฟล์แนบ)**

#### **8.1. attachments (Master)**

ตาราง "กลาง" เก็บไฟล์แนบทั้งหมดของระบบ **(ปรับปรุง)** เป็นตารางกลาง ไม่มี FK ไปยังตารางอื่น

| Column | Type | Key | Description |
| :---- | :---- | :---- | :---- |
| id | INT | **PK** | ID ของไฟล์แนบ |
| original\_filename | VARCHAR(255) |  | ชื่อไฟล์ดั้งเดิม |
| stored\_filename | VARCHAR(255) |  | ชื่อไฟล์ที่เก็บจริง (ป้องกันซ้ำ) |
| file\_path | VARCHAR(500) |  | Path ที่เก็บไฟล์ (บน QNAP /share/dms-data/) |
| mime\_type | VARCHAR(100) |  | ประเภทไฟล์ (เช่น application/pdf) |
| file\_size | INT |  | ขนาดไฟล์ (bytes) |
| uploaded\_by\_user\_id | INT | FK | ผู้อัปโหลด (FK \-\> users(user\_id)) |

* **Foreign Keys (FK):** uploaded\_by\_user\_id \-\> users(user\_id) (ON DELETE CASCADE)

#### **8.2. correspondence\_attachments (ตารางเชื่อม \- ใหม่)**

ตารางเชื่อม correspondences กับ attachments (M:N)

| Column | Type | Key | Description |
| :---- | :---- | :---- | :---- |
| correspondence\_id | INT | **PK**, FK | ID ของเอกสาร (FK \-\> correspondences(id)) |
| attachment\_id | INT | **PK**, FK | ID ของไฟล์แนบ (FK \-\> attachments(id)) |
| is\_main\_document | BOOLEAN |  | (1 \= ไฟล์หลัก) (Req 5.7) |

* **Foreign Keys (FK):** correspondence\_id, attachment\_id

#### **8.3. circulation\_attachments (ตารางเชื่อม \- ใหม่)**

ตารางเชื่อม circulations กับ attachments (M:N)

| Column | Type | Key | Description |
| :---- | :---- | :---- | :---- |
| circulation\_id | INT | **PK**, FK | ID ของใบเวียน (FK \-\> circulations(id)) |
| attachment\_id | INT | **PK**, FK | ID ของไฟล์แนบ (FK \-\> attachments(id)) |
| is\_main\_document | BOOLEAN |  | (1 \= ไฟล์หลัก) |

* **Foreign Keys (FK):** circulation\_id, attachment\_id

#### **8.4. shop\_drawing\_revision\_attachments (ตารางเชื่อม \- ใหม่)**

ตารางเชื่อม shop\_drawing\_revisions กับ attachments (M:N)

| Column | Type | Key | Description |
| :---- | :---- | :---- | :---- |
| shop\_drawing\_revision\_id | INT | **PK**, FK | ID ของ Drawing Revision (FK \-\> shop\_drawing\_revisions(id)) |
| attachment\_id | INT | **PK**, FK | ID ของไฟล์แนบ (FK \-\> attachments(id)) |
| file\_type | ENUM(...) |  | ประเภทไฟล์ (PDF, DWG, SOURCE, OTHER) (Req 5.7) |

* **Foreign Keys (FK):** shop\_drawing\_revision\_id, attachment\_id

## **9\. 🔢 Document Numbering (การสร้างเลขที่เอกสาร)**

#### **9.1. document\_number\_formats (ตารางตั้งค่า \- ใหม่)**

ตาราง Master เก็บ "รูปแบบ" Template ของเลขที่เอกสาร (Req 3.10)

| Column | Type | Key | Description |
| :---- | :---- | :---- | :---- |
| id | INT | **PK** | ID ของตาราง |
| project\_id | INT | FK, UK | โครงการ (FK \-\> projects(id)) |
| correspondence\_type\_id | INT | FK, UK | ประเภทเอกสาร (FK \-\> correspondence\_types(id)) |
| format\_template | VARCHAR(255) |  | รูปแบบ Template (เช่น {ORG\_CODE}-{TYPE\_CODE}-{SEQ:4}) |

* **Foreign Keys (FK):** project\_id, correspondence\_type\_id  
* **Unique Keys (UK):** uk\_project\_type (project\_id, correspondence\_type\_id)

#### **9.2. document\_number\_counters (ตารางตัวนับ \- ใหม่)**

ตารางเก็บ "ตัวนับ" (Running Number) ล่าสุด (Req 3.10.2)

| Column | Type | Key | Description |
| :---- | :---- | :---- | :---- |
| project\_id | INT | **PK**, FK | โครงการ (FK \-\> projects(id)) |
| originator\_organization\_id | INT | **PK**, FK | องค์กรผู้ส่ง (FK \-\> organizations(id)) |
| correspondence\_type\_id | INT | **PK**, FK | ประเภทเอกสาร (FK \-\> correspondence\_types(id)) |
| current\_year | INT | **PK** | ปี ค.ศ. ของตัวนับ |
| last\_number | INT |  | เลขที่ล่าสุดที่ใช้ไป |

* **Foreign Keys (FK):** project\_id, originator\_organization\_id, correspondence\_type\_id

## **10\. ⚙️ System & Logs (ระบบและ Log)**

#### **10.1. tags**

ตาราง Master เก็บ Tags ทั้งหมดที่ใช้ในระบบ (Req 6.2)

| Column | Type | Key | Description |
| :---- | :---- | :---- | :---- |
| id | INT | **PK** | ID ของตาราง |
| tag\_name | VARCHAR(100) | UK | ชื่อ Tag |

* **Unique Keys (UK):** ux\_tag\_name (tag\_name)

#### **10.2. correspondence\_tags (ตารางเชื่อม)**

ตารางเชื่อมระหว่าง correspondences และ tags (M:N) (Req 3.2.4)

| Column | Type | Key | Description |
| :---- | :---- | :---- | :---- |
| correspondence\_id | INT | **PK**, FK | ID ของเอกสาร (FK \-\> correspondences(id)) |
| tag\_id | INT | **PK**, FK | ID ของ Tag (FK \-\> tags(id)) |

* **Foreign Keys (FK):** correspondence\_id, tag\_id

#### **10.3. audit\_logs**

ตารางเก็บบันทึกการกระทำของผู้ใช้ (Req 6.1)

| Column | Type | Key | Description |
| :---- | :---- | :---- | :---- |
| audit\_id | BIGINT | **PK** | ID ของ Log |
| user\_id | INT | FK | ผู้กระทำ (FK \-\> users(user\_id)) |
| action | VARCHAR(100) |  | การกระทำ (เช่น rfa.create) |
| entity\_type | VARCHAR(50) |  | ตาราง/โมดูล (เช่น rfas) |
| entity\_id | VARCHAR(50) |  | ID ของสิ่งที่ถูกกระทำ |
| details\_json | JSON |  | ข้อมูลเพิ่มเติม |
| ip\_address | VARCHAR(45) |  | IP Address |
| created\_at | TIMESTAMP |  | เวลาที่กระทำ |

* **Foreign Keys (FK):** user\_id \-\> users(user\_id) (ON DELETE SET NULL)

## **11\. 📋 Views & Procedures (วิว และ โปรซีเดอร์)**

#### **11.1. sp\_get\_next\_document\_number (Procedure)**

**(ใหม่)** Stored Procedure เดียวที่ใช้ในระบบ (Req 2.9.3)

* **หน้าที่:** ดึงเลขที่เอกสารถัดไป (Next Running Number) จากตาราง document\_number\_counters  
* **ตรรกะ:** ใช้ SELECT ... FOR UPDATE เพื่อ "ล็อก" แถว ป้องกัน Race Condition (การที่ผู้ใช้ 2 คนได้เลขที่ซ้ำกัน)

#### **11.2. v\_current\_correspondences (View)**

* **หน้าที่:** แสดง Revision "ปัจจุบัน" (is\_current \= TRUE) ของ correspondences ทั้งหมด (ที่ไม่ใช่ RFA)

#### **11.3. v\_current\_rfas (View)**

* **หน้าที่:** แสดง Revision "ปัจจุบัน" (is\_current \= TRUE) ของ rfa\_revisions ทั้งหมด

#### **11.4. v\_user\_tasks (View)**

**(ใหม่)**

* **หน้าที่:** แสดงรายการ "งานของฉัน" (My Tasks) ที่ยังไม่เสร็จ (Req 5.3)  
* **ตรรกะ:** JOIN ตาราง circulations กับ circulation\_assignees (ที่ is\_completed \= FALSE)

#### **11.5. v\_audit\_log\_details (View)**

**(ใหม่)**

* **หน้าที่:** แสดง audit\_logs พร้อมข้อมูล username และ email ของผู้กระทำ (Req 6.1)

#### **11.6. v\_user\_all\_permissions (View)**

**(ใหม่)**

* **หน้าที่:** รวมสิทธิ์ทั้งหมด (Global \+ Project) ของผู้ใช้ทุกคน เพื่อให้ Backend ตรวจสอบสิทธิ์ได้ง่าย (Req 4.2)  
* **ตรรกะ:** UNION ข้อมูลจาก user\_roles และ user\_project\_roles