#
สรุปตารางฐานข้อมูล (Data Dictionary) - LCBP3-DMS (V1.2.1)
เอกสารนี้สรุปโครงสร้างตาราง, Foreign Keys (FK), และ Constraints ที่สำคัญทั้งหมดในฐานข้อมูล LCBP3-DMS (v1.2.0) เพื่อใช้เป็นเอกสารอ้างอิงสำหรับทีมพัฒนา 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' |
| deleted_at | DATETIME | | สำหรับ Soft Delete |
*
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 องค์กร
####
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)
| 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) (ปรับปรุง V1.2.0)
| 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 |
|
วันที่ลงรับ |
| description |
TEXT |
|
(ใหม่) คำอธิบายการแก้ไขใน Revision นี้ |
| details |
JSON |
|
ข้อมูลเฉพาะ (เช่น RFI details) |
| created_at |
DATETIME |
|
(ใหม่) วันที่สร้างเอกสาร |
| created_by |
INT |
FK |
ผู้สร้าง (FK -> users(user_id)) |
| updated_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)
- updated_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)
| 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)
- 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) (ปรับปรุง V1.2.0)
| 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...) |
| revision_label |
VARCHAR(10) |
|
(ใหม่) Revision ที่แสดง (เช่น A, B, 1.1) |
| 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) |
|
เรื่อง |
| document_date |
DATE |
|
(ใหม่) วันที่ในเอกสาร |
| issued_date |
DATE |
|
(ใหม่) วันที่ส่งขออนุมัติ |
| received_date |
DATETIME |
|
(ใหม่) วันที่ลงรับเอกสาร |
| approved_date |
DATE |
|
(ใหม่) วันที่อนุมัติ |
| description |
TEXT |
|
(ใหม่) คำอธิบายการแก้ไขใน Revision นี้ |
| created_at |
DATETIME |
|
(ใหม่) วันที่สร้างเอกสาร |
| created_by |
INT |
FK |
ผู้สร้าง (FK -> users(user_id)) |
| updated_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)
- updated_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)
| 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
- 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
ตาราง Master สำหรับ "แบบคู่สัญญา" (Contract Drawings)
- contract_drawing_volumes: เก็บ "เล่ม" ของแบบ
- contract_drawing_cats: เก็บ "หมวดหมู่หลัก" ของแบบ
- contract_drawing_sub_cats: เก็บ "หมวดหมู่ย่อย" ของแบบ
5.2. contract_drawing_subcat_cat_maps (ตารางเชื่อม - ใหม่)
(ใหม่) ตารางเชื่อมระหว่าง หมวดหมู่หลัก-ย่อย (M:N)
| Column |
Type |
Key |
Description |
| project_id |
INT |
PK, FK |
ID ของโครงการ |
| sub_cat_id |
INT |
PK, FK |
ID ของหมวดหมู่ย่อย |
| cat_id |
INT |
PK, FK |
ID ของหมวดหมู่หลัก |
- Foreign Keys (FK) (ตามเจตนา):
- (project_id, sub_cat_id) -> contract_drawing_sub_cats(project_id, id)
- (project_id, cat_id) -> contract_drawing_cats(project_id, id)
- Unique Keys (UK):
- ux_map_unique (project_id, sub_cat_id, cat_id)
- ข้อสังเกตจาก DBA: สคริปต์ SQL (1.3.6) มีการอ้างอิง FK ไปยังตารางและคอลัมน์ (
contract_dwg_sub_cat(project_id, sub_cat_id)) ที่ไม่มีอยู่จริง ตารางนี้แสดงตามเจตนาที่ถูกต้อง
5.3. contract_drawings (Master)
ตาราง Master เก็บข้อมูล "แบบคู่สัญญา"
| 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.4. shop_drawing_main_categories / ..._sub_categories
ตาราง Master สำหรับ "แบบก่อสร้าง" (Shop Drawings)
- shop_drawing_main_categories: เก็บ "หมวดหมู่หลัก" (เช่น ARCH, STR)
- shop_drawing_sub_categories: เก็บ "หมวดหมู่ย่อย" (เช่น STR-COLUMN)
5.5. shop_drawings (Master)
ตาราง Master เก็บข้อมูล "แบบก่อสร้าง"
| 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.6. shop_drawing_revisions (Revisions)
ตาราง "ลูก" เก็บประวัติ (Revisions) ของ shop_drawings (1:N)
| 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.7. shop_drawing_revision_contract_refs (ตารางเชื่อม)
ตารางเชื่อมระหว่าง shop_drawing_revisions กับ contract_drawings (M:N)
| 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)
ตาราง "แม่" ของใบเวียนเอกสารภายใน
| 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) และเก็บ deadline
- 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)
| 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 และเอกสารที่นำส่ง (M:N) (ปรับปรุง V1.2.0)
| Column |
Type |
Key |
Description |
| id |
INT |
PK |
(ใหม่) ID ของรายการ |
| transmittal_id |
INT |
FK, UK |
ID ของ Transmittal (FK -> transmittals(correspondence_id)) |
| item_correspondence_id |
INT |
FK, UK |
(เปลี่ยน) ID ของเอกสารที่แนบไป (FK -> correspondences(id)) |
| quantity |
INT |
|
(ใหม่) จำนวน |
| remarks |
VARCHAR(255) |
|
(ใหม่) หมายเหตุสำหรับรายการนี้ |
- Foreign Keys (FK):
- transmittal_id -> transmittals(correspondence_id) (ON DELETE CASCADE)
- item_correspondence_id -> correspondences(id) (ON DELETE CASCADE)
- Unique Keys (UK): ux_transmittal_item (transmittal_id, item_correspondence_id)
8. 📎 File Management (ไฟล์แนบ)
8.1. attachments (Master)
ตาราง "กลาง" เก็บไฟล์แนบทั้งหมดของระบบ
| 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 = ไฟล์หลัก) |
- 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) (ปรับปรุง V1.2.0)
| 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) |
| is_main_document |
BOOLEAN |
|
(ใหม่) (1 = ไฟล์หลัก) |
- Foreign Keys (FK): shop_drawing_revision_id, attachment_id
8.5. contract_drawing_attachments (ตารางเชื่อม - ใหม่)
(ใหม่) ตารางเชื่อม contract_drawings กับ attachments (M:N)
| Column |
Type |
Key |
Description |
| contract_drawing_id |
INT |
PK, FK |
ID ของ Contract Drawing (FK -> contract_drawings(id)) |
| attachment_id |
INT |
PK, FK |
ID ของไฟล์แนบ (FK -> attachments(id)) |
| file_type |
ENUM(...) |
|
ประเภทไฟล์ (PDF, DWG, SOURCE, OTHER) |
| is_main_document |
BOOLEAN |
|
(1 = ไฟล์หลัก) |
- Foreign Keys (FK):
- contract_drawing_id -> contract_drawings(id) (ON DELETE CASCADE)
- attachment_id -> attachments(id) (ON DELETE CASCADE)
9. 🔢 Document Numbering (การสร้างเลขที่เอกสาร)
9.1. document_number_formats (ตารางตั้งค่า - ใหม่)
ตาราง Master เก็บ "รูปแบบ" Template ของเลขที่เอกสาร
| 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) ล่าสุด
| 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 ทั้งหมดที่ใช้ในระบบ
| 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)
| 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
ตารางเก็บบันทึกการกระทำของผู้ใช้
| 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)
10.4. global_default_roles (ใหม่)
ตารางเก็บค่าเริ่มต้นของบทบาทองค์กร (เช่น OWNER, DESIGNER)
| Column |
Type |
Key |
Description |
| id |
TINYINT |
PK |
ID คงที่ ( = 1) |
| role |
ENUM(...) |
PK |
บทบาท (OWNER, DESIGNER, CONSULTANT) |
| position |
TINYINT |
PK |
ลำดับที่ในบทบาท (1..n) |
| organization_id |
INT |
FK, UK |
ID องค์กร (FK -> organizations(id)) |
- Foreign Keys (FK): organization_id -> organizations(id) (ON DELETE RESTRICT)
- Unique Keys (UK): ux_gdr_unique_org_per_role (id, role, organization_id)
10.5. Workflow Transition Rules (ใหม่)
ตารางกำหนด Business Rules สำหรับการเปลี่ยนสถานะ
- correspondence_status_transitions: (ใหม่) กฎการเปลี่ยนสถานะของ Correspondences (ทั่วไป)
- rfa_status_transitions: (ใหม่) กฎการเปลี่ยนสถานะของ RFA
- circulation_status_transitions: (ใหม่) กฎการเปลี่ยนสถานะของ Circulations (ใบเวียน)
11. 📋 Views & Procedures (วิว และ โปรซีเดอร์)
11.1. sp_get_next_document_number (Procedure)
(ใหม่) Stored Procedure เดียวที่ใช้ในระบบ
- หน้าที่: ดึงเลขที่เอกสารถัดไป (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_contract_parties_all (View)
- หน้าที่: แสดงความสัมพันธ์ทั้งหมดระหว่าง Contract, Project, และ Organization
11.5. v_user_tasks (View)
(ใหม่)
- หน้าที่: แสดงรายการ "งานของฉัน" (My Tasks) ที่ยังไม่เสร็จ
- ตรรกะ: JOIN ตาราง circulations กับ circulation_assignees (ที่ is_completed = FALSE)
11.6. v_audit_log_details (View)
(ใหม่)
- หน้าที่: แสดง audit_logs พร้อมข้อมูล username และ email ของผู้กระทำ
11.7. v_user_all_permissions (View)
(ใหม่)
- หน้าที่: รวมสิทธิ์ทั้งหมด (Global + Project) ของผู้ใช้ทุกคน เพื่อให้ Backend ตรวจสอบสิทธิ์ได้ง่าย
- ตรรกะ: UNION ข้อมูลจาก user_roles และ user_project_roles
