Files
lcbp3/docs/SQL/01_lcbp3_v1_4_0.sql
2025-11-17 16:48:49 +07:00

1923 lines
124 KiB
SQL

-- ==========================================================
-- DMS v1.4.0 Document Management System Database
-- Deploy Script Schema
-- Server: Container Station on QNAPQNAP TS-473A
-- Database service: MariaDB 10.11
-- database web ui: phpmyadmin 5-apache
-- database deelopment ui: DBeaver
-- backend sevice: NestJS
-- frontend sevice: next.js
-- reverse proxy: jc21/nginx-proxy-manager:latest
-- cron service: n8n
-- DMS v1.4.0 Improvements
-- Update: first revise fron v1.3.0
-- ==========================================================
SET NAMES utf8mb4;
SET time_zone = '+07:00';
-- ปิดการตรวจสอบ Foreign Key ชั่วคราวเพื่อให้สามารถลบตารางได้ทั้งหมด
SET FOREIGN_KEY_CHECKS=0;
-- Level 1: ตารางที่มีความสัมพันธ์มากที่สุด (Junction Tables & Detail Tables)
-- 1.27
DROP TABLE IF EXISTS audit_logs;
-- 1.26
DROP TABLE IF EXISTS user_project_roles;
-- 1.25
DROP TABLE IF EXISTS user_roles;
-- 1.24
DROP TABLE IF EXISTS role_permissions;
-- 1.23
DROP TABLE IF EXISTS contract_parties;
-- 1.22
DROP TABLE IF EXISTS project_parties;
-- 1.21.1
DROP TABLE IF EXISTS correspondence_references;
-- 1.20.1
DROP TABLE IF EXISTS correspondence_recipients;
-- 1.19.1
DROP TABLE IF EXISTS correspondence_routings;
-- 1.18.1
DROP TABLE IF EXISTS correspondence_routing_template_steps;
-- 1.17.1
DROP TABLE IF EXISTS correspondence_status_transitions;
-- 1.16.2
DROP TABLE IF EXISTS rfa_workflows;
-- 1.15.2
DROP TABLE IF EXISTS rfa_workflow_template_steps;
-- 1.14.2
DROP TABLE IF EXISTS rfa_status_transitions;
-- 1.13.2
DROP TABLE IF EXISTS rfa_items;
DROP TABLE IF EXISTS circulation_action_documents;
-- 1.11.3
DROP TABLE IF EXISTS circulation_actions;
-- 1.10.3
DROP TABLE IF EXISTS circulation_recipients;
-- 1.9.3
DROP TABLE IF EXISTS circulation_assignees;
-- 1.8.3
DROP TABLE IF EXISTS circulation_template_assignees;
-- 1.7.3
DROP TABLE IF EXISTS circulation_status_transitions;
-- 1.6.4
DROP TABLE IF EXISTS transmittal_items;
-- 1.5.5
DROP TABLE IF EXISTS shop_drawing_revision_contract_refs;
-- 1.4.5
DROP TABLE IF EXISTS shop_drawing_revisions;
-- 1.3.6
DROP TABLE IF EXISTS contract_drawing_subcat_cat_maps;
DROP TABLE IF EXISTS correspondence_attachments;
DROP TABLE IF EXISTS circulation_attachments;
DROP TABLE IF EXISTS shop_drawing_revision_attachments;
DROP TABLE IF EXISTS contract_drawing_attachments;
-- 1.2
DROP TABLE IF EXISTS attachments;
-- 1.1
DROP TABLE IF EXISTS global_default_roles;
-- ---------
DROP TABLE IF EXISTS document_number_counters;
DROP TABLE IF EXISTS document_number_formats;
-- Level 2: ตารางที่ถูกอ้างอิงโดย Level 1
-- 2.12.1
DROP TABLE IF EXISTS correspondence_routing_templates;
-- 2.11.2
DROP TABLE IF EXISTS rfa_workflow_templates;
-- 2.10.3
DROP TABLE IF EXISTS circulation_templates;
-- 2.9.1
DROP TABLE IF EXISTS correspondence_revisions;
-- 2.8.2
DROP TABLE IF EXISTS rfa_revisions;
-- 2.7.5 : n.n.5 for shop_drawing
DROP TABLE IF EXISTS shop_drawings;
-- 2.6.6 : n.n.6 for contract_drawing
DROP TABLE IF EXISTS contract_drawings;
-- 2.5.2 : n.n.2 for rfa
DROP TABLE IF EXISTS rfas;
-- 2.4.4 : n.n.4 for transmittal
DROP TABLE IF EXISTS transmittals;
-- 2.3.3: n.n.3 for circulation
DROP TABLE IF EXISTS circulations;
-- 2.2.1
DROP TABLE IF EXISTS correspondence_tags;
-- 2.1
DROP TABLE IF EXISTS tags;
-- Level 3: ตารางที่ถูกอ้างอิงโดย Level 2
-- 3.9.1 : n.n.1 for correspondence
DROP TABLE IF EXISTS correspondences;
-- 3.8.5
DROP TABLE IF EXISTS shop_drawing_sub_categories;
-- 3.7.5
DROP TABLE IF EXISTS shop_drawing_main_categories;
-- 3.6.6
DROP TABLE IF EXISTS contract_drawing_sub_cats;
-- 3.5.6
DROP TABLE IF EXISTS contract_drawing_cats;
-- 3.4.6
DROP TABLE IF EXISTS contract_drawing_volumes;
-- 3.3.2
DROP TABLE IF EXISTS rfa_approve_codes;
-- 3.2.2
DROP TABLE IF EXISTS rfa_status_codes;
-- 3.1.2
DROP TABLE IF EXISTS rfa_types;
-- Level 4: ตาราง Master Data หลัก และตารางที่ถูกอ้างอิงโดย Level 3
-- 4.8
DROP TABLE IF EXIST notifications;
DROP TABLE IF EXISTS users;
-- 4.7
DROP TABLE IF EXISTS projects;
-- 4.6
DROP TABLE IF EXISTS contracts;
-- 4.5.1
DROP TABLE IF EXISTS correspondence_status;
-- 4.4.1
DROP TABLE IF EXISTS correspondence_types;
-- 4.3.3
DROP TABLE IF EXISTS circulation_status_codes;
-- 4.2
DROP TABLE IF EXISTS permissions;
-- 4.1
DROP TABLE IF EXISTS roles;
-- Level 5: ตารางที่เป็นรากฐานที่สุด
-- 5.2
DROP TABLE IF EXISTS organizations;
-- 5.1
DROP TABLE IF EXISTS organization_roles;
DROP TABLE IF EXISTS search_indices;
DROP TABLE IF EXISTS backup_logs;
-- Views
DROP VIEW IF EXISTS v_current_rfas;
DROP VIEW IF EXISTS v_current_correspondences;
DROP VIEW IF EXISTS v_contract_parties_all;
DROP VIEW IF EXISTS v_user_tasks;
DROP VIEW IF EXISTS v_audit_log_details;
DROP VIEW IF EXISTS v_user_all_permissions;
-- Procedure
DROP PROCEDURE IF EXISTS sp_get_next_document_number;
-- ==========================================================
-- Table Creation
-- ==========================================================
-- Level 5: Organizations
-- ==========================================================
-- ตาม Requirements 6.6 ที่ระบุว่าต้องมีการสำรองข้อมูล
CREATE TABLE backup_logs (
id INT AUTO_INCREMENT PRIMARY KEY,
backup_type ENUM('DATABASE', 'FILES', 'FULL') NOT NULL,
backup_path VARCHAR(500),
file_size BIGINT,
status ENUM('STARTED', 'COMPLETED', 'FAILED') NOT NULL,
started_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP,
completed_at TIMESTAMP NULL,
error_message TEXT
);
-- ตารางสำหรับจัดการดัชนีการค้นหา
CREATE TABLE search_indices (
id INT AUTO_INCREMENT PRIMARY KEY,
entity_type VARCHAR(50) NOT NULL,
entity_id INT NOT NULL,
content TEXT,
indexed_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP,
INDEX idx_entity (entity_type, entity_id),
FULLTEXT INDEX idx_content (content)
);
-- 5.1 Organizations_roles Table
CREATE TABLE organization_roles (
id INT NOT NULL AUTO_INCREMENT PRIMARY KEY COMMENT 'ID ของตาราง',
role_name VARCHAR(20) NOT NULL COMMENT 'ชื่อบทบาทขององค์กรณ์',
UNIQUE KEY ux_roles_name (role_name)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_general_ci COMMENT='Organizations Roles';
-- Seed organization role
INSERT INTO organization_roles (role_name) VALUES
('OWNER'),
('DESIGNER'),
('CONSULTANT'),
('CONTRACTOR'),
('THIRD PARTY');
-- 5.2 Organizations Table
CREATE TABLE organizations (
id INT NOT NULL PRIMARY KEY COMMENT 'ID ของตาราง',
organization_code VARCHAR(20) NOT NULL COMMENT 'รหัสองค์กรณ์',
organization_name VARCHAR(255) NOT NULL COMMENT 'ชื่อองค์กรณ์',
role_id INT NULL COMMENT 'บทบาทขององค์กรณ์ (FK -> organization_roles)',
is_active BOOLEAN NOT NULL DEFAULT TRUE COMMENT 'สถานะการใช้งาน',
created_at TIMESTAMP NOT NULL DEFAULT CURRENT_TIMESTAMP COMMENT 'วันที่สร้าง',
updated_at TIMESTAMP NOT NULL DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP COMMENT 'วันที่แก้ไขล่าสุด',
UNIQUE KEY ux_organizations_code (organization_code),
FOREIGN KEY (role_id) REFERENCES organization_roles(id)
ON DELETE SET NULL
ON UPDATE CASCADE
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_general_ci COMMENT='ตารางองกรณ์';
-- Seed organization
INSERT INTO organizations (id, organization_code, organization_name, role_id) VALUES
(1, 'กทท.', 'การท่าเรือแห่งประเทศไทย', 1),
(10, 'สคฉ.3', 'โครงการพัฒนาท่าเรือแหลมฉบัง ระยะที่ 3', 1),
(11, 'สคฉ.3-01', 'ตรวจรับพัสดุ ที่ปรึกษาควบคุมงาน', 1),
(12, 'สคฉ.3-02', 'ตรวจรับพัสดุ งานทางทะเล', 1),
(13, 'สคฉ.3-03', 'ตรวจรับพัสดุ อาคารและระบบสาธารณูปโภค', 1),
(14, 'สคฉ.3-04', 'ตรวจรับพัสดุ ตรวจสอบผลกระทบสิ่งแวดล้อม', 1),
(15, 'สคฉ.3-05', 'ตรวจรับพัสดุ เยียวยาการประมง', 1),
(16, 'สคฉ.3-06', 'ตรวจรับพัสดุ งานก่อสร้าง ส่วนที่ 3', 1),
(17, 'สคฉ.3-07', 'ตรวจรับพัสดุ งานก่อสร้าง ส่วนที่ 4', 1),
(18, 'สคฉ.3-xx', 'ตรวจรับพัสดุ ที่ปรึกษาออกแบบ ส่วนที่ 4', 1),
(21, 'TEAM', 'Designer Consulting Ltd.', 2),
(22, 'คคง.', 'Construction Supervision Ltd.', 3),
(41, 'ผรม.1', 'Contractor งานทางทะเล', 4),
(42, 'ผรม.2', 'Contractor อาคารและระบบ', 4),
(43, 'ผรม.3', 'Contractor #3 Ltd.', 4),
(44, 'ผรม.4', 'Contractor #4 Ltd.', 4),
(31, 'EN', 'Third Party Environment', 5),
(32, 'CAR', 'Third Party Fishery Care', 5);
-- ==========================================================
-- Level 4: ตาราง Master Data หลัก
-- ==========================================================
-- 4.1 Roles Table (RBAC)
CREATE TABLE roles (
role_id INT AUTO_INCREMENT PRIMARY KEY COMMENT 'ID ของตาราง',
role_code VARCHAR(50) NOT NULL UNIQUE COMMENT 'รหัสบทบาท', -- SUPER_ADMIN / ADMIN / EDITOR / VIEWER
role_name VARCHAR(100) NOT NULL COMMENT 'ชื่อบทบาท',
description TEXT COMMENT 'คำอธิบายบทบาท',
is_system BOOLEAN NOT NULL DEFAULT FALSE COMMENT 'ระบุว่าบทบาทนี้เป็นระบบหรือไม่ (ไม่สามารถลบได้ถ้าเป็นระบบ)'
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_general_ci COMMENT='Roles Table';
-- ==========================================================
-- Seed Roles (บทบาทพื้นฐาน 5 บทบาท ตาม Req 4.3)
-- ==========================================================
TRUNCATE TABLE roles;
INSERT INTO roles (role_code, role_name, description, is_system) VALUES
('SUPER_ADMIN','Super Administrator', 'Full access to entire system, cross-organization' ,1),
('ADMIN', 'Administrator', 'Full access but limited to their own organization',1),
('DOC_CONTROL','Document Control', 'Manages all documents within their organization', 1),
('EDITOR', 'Editor', 'Can create/edit specific documents', 1),
('VIEWER', 'Viewer', 'Read-only access', 1)
ON DUPLICATE KEY UPDATE
role_name=VALUES(role_name),
description=VALUES(description),
is_system=VALUES(is_system);
-- 4.2 Permissions Table (RBAC)
CREATE TABLE permissions (
permission_id INT NOT NULL AUTO_INCREMENT PRIMARY KEY COMMENT 'ID ของตาราง',
permission_code VARCHAR(100) NOT NULL COMMENT 'รหัสสิทธิ์การใช้งาน', -- e.g., drawings.view, drawings.upload, drawings.delete
description TEXT COMMENT 'คำอธิบายสิทธิ์การใช้งาน',
module VARCHAR(50) NULL COMMENT 'โมดูลที่เกี่ยวข้อง',
scope_level ENUM('GLOBAL','ORG','PROJECT') DEFAULT 'GLOBAL' COMMENT 'ระดับขอบเขตของสิทธิ์การใช้งาน',
is_active TINYINT(1) NOT NULL DEFAULT 1 COMMENT 'สถานะการใช้งาน',
UNIQUE KEY ux_permissions_code (permission_code)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_general_ci COMMENT='Permissions Table';
-- ==========================================================
-- 2. Seed Permissions (สิทธิ์การใช้งานทั้งหมด)
-- ==========================================================
TRUNCATE TABLE permissions;
INSERT INTO permissions (permission_code, description, module, scope_level) VALUES
-- System & Admin Panel (Req 4.5, 4.6, 6.1)
('system.superadmin', 'Full access to everything (Bypasses all checks)', 'System', 'GLOBAL'),
('system.admin_panel', 'Access Admin Panel UI', 'System', 'ORG'),
('system.view_audit_logs', 'View audit logs for own organization', 'System', 'ORG'),
('system.view_reports', 'View reports page', 'System', 'ORG'),
-- Admin Panel Actions (Req 4.3, 4.5, 4.6, 3.10.3)
('admin.manage_users', 'Create/Edit/Delete users in own organization', 'Admin', 'ORG'),
('admin.manage_roles', 'Create/Edit/Delete custom roles and assign permissions', 'Admin', 'ORG'),
('admin.manage_master_data','Manage master data (tags, types, categories)', 'Admin', 'ORG'),
('admin.manage_numbering', 'Manage document numbering formats', 'Admin', 'ORG'),
('admin.manage_org_all', '[Superadmin] Manage all organizations', 'Admin', 'GLOBAL'),
('admin.manage_users_all', '[Superadmin] Manage all users in all organizations', 'Admin', 'GLOBAL'),
-- Projects & Contracts (Req 3.1)
('project.view', 'View assigned projects', 'Project', 'PROJECT'),
('project.manage', '[Admin] Create/Edit projects', 'Project', 'GLOBAL'),
('project.manage_parties', '[Admin] Assign organizations to projects', 'Project', 'PROJECT'),
-- Correspondences (Req 3.2)
('corr.view', 'View documents sent to/from own organization', 'Correspondence', 'PROJECT'),
('corr.view_all', '[Admin/Owner] View all documents in a project', 'Correspondence', 'PROJECT'),
('corr.create', 'Create document drafts', 'Correspondence', 'PROJECT'),
('corr.submit', 'Submit a draft document', 'Correspondence', 'PROJECT'),
('corr.manage_submitted', '[Admin] Edit/Cancel/Delete submitted documents', 'Correspondence', 'PROJECT'),
('corr.manage_attachments', 'Add/Remove/Manage attachments', 'Correspondence', 'PROJECT'),
-- RFA (Req 3.5, 5.6)
('rfa.view', 'View RFAs sent to/from own organization', 'RFA', 'PROJECT'),
('rfa.view_all', '[Admin/Owner] View all RFAs in a project', 'RFA', 'PROJECT'),
('rfa.create', 'Create new RFA (all types: DWG, DOC, MAT, MES)', 'RFA', 'PROJECT'),
('rfa.submit', 'Submit RFA draft', 'RFA', 'PROJECT'),
('rfa.respond', 'Respond to an RFA workflow step (Approve/Reject)', 'RFA', 'PROJECT'),
('rfa.override_workflow', '[Admin] Force bypass/return workflow steps', 'RFA', 'PROJECT'),
('rfa.delete', 'Delete RFA drafts', 'RFA', 'PROJECT'),
-- Drawings (Req 3.3, 3.4)
('drawing.contract.view', 'View Contract Drawings', 'Drawing', 'PROJECT'),
('drawing.contract.manage', 'Upload/Edit/Delete Contract Drawings', 'Drawing', 'PROJECT'),
('drawing.shop.view', 'View Shop Drawings', 'Drawing', 'PROJECT'),
('drawing.shop.manage', 'Upload/Edit/Delete Shop Drawing Masters & Revisions', 'Drawing', 'PROJECT'),
-- Transmittals (Req 3.6)
('transmittal.view', 'View Transmittals', 'Transmittal', 'PROJECT'),
('transmittal.create', 'Create new Transmittals', 'Transmittal', 'PROJECT'),
-- Circulations (Req 3.7)
('circulation.view', 'View own organizations circulations', 'Circulation', 'ORG'),
('circulation.create', 'Create new internal circulation sheet', 'Circulation', 'ORG'),
('circulation.respond', 'Action on an assigned task (Comment, Close)', 'Circulation', 'ORG'),
('circulation.close', 'Mark a circulation as completed', 'Circulation', 'ORG'),
('circulation.manage_templates', 'Create/Edit circulation templates for own org', 'Circulation', 'ORG')
ON DUPLICATE KEY UPDATE
description=VALUES(description),
module=VALUES(module),
scope_level=VALUES(scope_level);
-- 4.3.3 circulation_status_codes Table
CREATE TABLE circulation_status_codes (
id INT AUTO_INCREMENT PRIMARY KEY COMMENT 'ID ของตาราง',
code VARCHAR(20) NOT NULL UNIQUE COMMENT 'รหัสสถานะการดำเนินงาน',
description VARCHAR(50) NULL COMMENT 'คำอธิบายสถานะการดำเนินงาน',
sort_order INT DEFAULT 0 COMMENT 'ลำดับการแสดงผล',
is_active TINYINT(1) DEFAULT 1 COMMENT 'สถานะการใช้งาน'
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_general_ci COMMENT='รหัสสถานะการดำเนินงาน';
INSERT INTO circulation_status_codes (code, description, sort_order) VALUES
('OPEN', 'Open', 1),
('IN_REVIEW', 'In Review', 2),
('COMPLETED', 'ปCompleted', 3),
('CANCELLED', 'Cancelled/Withdrawn', 9);
-- 4.4.1 correspondence_types Table
CREATE TABLE correspondence_types (
id INT AUTO_INCREMENT PRIMARY KEY COMMENT 'ID ของตาราง',
type_code VARCHAR(50) UNIQUE COMMENT 'รหัสประเภทหนังสือ',
type_name VARCHAR(255) NOT NULL COMMENT 'ชื่อประเภทหนังสือ',
sort_order INT DEFAULT 0 COMMENT 'ลำดับการแสดงผล',
is_active TINYINT(1) DEFAULT 1 COMMENT 'สถานะการใช้งาน'
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_general_ci COMMENT='ตารางประเภทหนังสือ';
INSERT INTO correspondence_types (type_code, type_name, sort_order, is_active) VALUES
('RFA', 'Request for Approval', 1,1),
('RFI', 'Request for Information', 2,1),
('TRANSMITTAL', 'Transmittal', 3,1),
('EMAIL', 'Email', 4,1),
('INSTRUCTION', 'Instruction', 5,1),
('LETTER', 'Letter', 6,1),
('MEMO', 'Memorandum', 7,1),
('MOM', 'Minutes of Meeting', 8,1),
('NOTICE', 'Notice', 9,1),
('OTHER', 'Other', 10,1);
-- 4.5.1 correspondence_status Table
CREATE TABLE correspondence_status (
id INT AUTO_INCREMENT PRIMARY KEY COMMENT 'ID ของตาราง',
status_code VARCHAR(50) UNIQUE COMMENT 'รหัสสถานะหนังสือ',
status_name VARCHAR(255) NOT NULL COMMENT 'ชื่อสถานะหนังสือ',
sort_order INT DEFAULT 0 COMMENT 'ลำดับการแสดงผล',
is_active TINYINT(1) DEFAULT 1 COMMENT 'สถานะการใช้งาน'
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_general_ci COMMENT='ตารางสถานะหนังสือ';
INSERT INTO correspondence_status (status_code, status_name, sort_order, is_active) VALUES
('DRAFT', 'Draft', 10,1),
('SUBOWN', 'Submitted to Owner', 21,1),
('SUBDSN', 'Submitted to Designer', 22,1),
('SUBCSC', 'Submitted to CSC', 23,1),
('SUBCON', 'Submitted to Contractor', 24,1),
('SUBOTH', 'Submitted to Others', 25,1),
('REPOWN', 'Reply by Owner', 31,1),
('REPDSN', 'Reply by Designer', 32,1),
('REPCSC', 'Reply by CSC', 33,1),
('REPCON', 'Reply by Contractor', 34,1),
('REPOTH', 'Reply by Others', 35,1),
('RSBOWN', 'Resubmited by Owner', 41,1),
('RSBDSN', 'Resubmited by Designer', 42,1),
('RSBCSC', 'Resubmited by CSC', 43,1),
('RSBCON', 'Resubmited by Contractor', 44,1),
('CLBOWN', 'Closed by Owner', 51,1),
('CLBDSN', 'Closed by Designer', 52,1),
('CLBCSC', 'Closed by CSC', 53,1),
('CLBCON', 'Closed by Contractor', 54,1),
('CCBOWN', 'Canceled by Owner', 91,1),
('CCBDSN', 'Canceled by Designer', 92,1),
('CCBCSC', 'Canceled by CSC', 93,1),
('CCBCON', 'Canceled by Contractor', 94,1);
-- 4.6 contracts Table: Stores information about each contract.
CREATE TABLE contracts (
id INT NOT NULL AUTO_INCREMENT PRIMARY KEY COMMENT 'ID ของตาราง',
contract_code VARCHAR(50) NOT NULL COMMENT 'รหัสสัญญา',
contract_name VARCHAR(255) NOT NULL COMMENT 'ชื่อสัญญา',
description TEXT COMMENT 'คำอธิบายสัญญา',
start_date DATE COMMENT 'วันที่เริ่มสัญญา',
end_date DATE COMMENT 'วันที่สิ้นสุดสัญญา',
created_at TIMESTAMP NOT NULL DEFAULT CURRENT_TIMESTAMP COMMENT 'วันที่สร้าง',
updated_at TIMESTAMP NOT NULL DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP COMMENT 'วันที่แก้ไขล่าสุด',
UNIQUE KEY ux_contracts_code (contract_code)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_general_ci COMMENT='ตารางสัญญา';
INSERT INTO contracts (contract_code, contract_name) VALUES
('DSLCBP3', 'งานจ้างที่ปรีกษาออกแบบ โครงการพัฒนาท่าเรือแหลมฉบัง ระยะที่ 3 (ส่วนที่ 1-4)'),
('PSLCBP3', 'งานจ้างที่ปรีกษาควบคุมงาน โครงการพัฒนาท่าเรือแหลมฉบัง ระยะที่ 3 (ส่วนที่ 1-4)'),
('LCBP3-C1', 'งานก่อสร้าง โครงการพัฒนาท่าเรือแหลมฉบัง ระยะที่ 3 (ส่วนที่ 1) งานก่อสร้างงานทางทะเล'),
('LCBP3-C2', 'งานก่อสร้าง โครงการพัฒนาท่าเรือแหลมฉบัง ระยะที่ 3 (ส่วนที่ 2) งานก่อสร้างอาคาร ท่าเทียบเรือ ระบบถนน และระบบสาธารณูปโภค'),
('LCBP3-C3', 'งานก่อสร้าง โครงการพัฒนาท่าเรือแหลมฉบัง ระยะที่ 3 (ส่วนที่ 3) งานก่อสร้าง'),
('LCBP3-C4', 'งานก่อสร้าง โครงการพัฒนาท่าเรือแหลมฉบัง ระยะที่ 3 (ส่วนที่ 4) งานก่อสร้าง'),
('ENLCBP3', 'งานจ้างเหมาตรวจสอบผลกระทบสิ่งแวดล้อมนะหว่างงานก่อสร้างโครงการพัฒนาท่าเรือแหลมฉบัง ระยะที่ 3 (ส่วนที่ 1-4)');
-- 4.7 Projects (contractor optional, FK -> organizations with SET NULL)
CREATE TABLE projects (
id INT AUTO_INCREMENT PRIMARY KEY COMMENT 'ID ของตาราง',
project_code VARCHAR(50) NOT NULL UNIQUE COMMENT 'รหัสโครงการ',
project_name VARCHAR(255) NOT NULL COMMENT 'ชื่อโครงการ',
parent_project_id INT NULL COMMENT 'รหัสโครงการหลัก (ถ้ามี)',
contractor_organization_id INT NULL COMMENT 'รหัสองค์กรณ์ผู้รับเหมา (ถ้ามี)',
is_active TINYINT(1) NOT NULL DEFAULT 0 COMMENT 'สถานะการใช้งาน',
CONSTRAINT uq_pro_code UNIQUE (project_code),
CONSTRAINT fk_pro_parent FOREIGN KEY (parent_project_id) REFERENCES projects(id) ON UPDATE CASCADE ON DELETE SET NULL,
CONSTRAINT fk_proj_contractor FOREIGN KEY (contractor_organization_id) REFERENCES organizations(id) ON UPDATE CASCADE ON DELETE SET NULL
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_general_ci COMMENT='ตารางโครงการ';
CREATE INDEX idx_pp_parent ON projects(parent_project_id);
CREATE INDEX idx_pp_contractor ON projects(contractor_organization_id);
INSERT INTO projects (project_code, project_name, parent_project_id) VALUES
('LCBP3','โครงการพัฒนาท่าเรือแหลมฉบัง ระยะที่ 3 (ส่วนที่ 1-4)', NULL),
('LCBP3C1','โครงการพัฒนาท่าเรือแหลมฉบัง ระยะที่ 3 (ส่วนที่ 1) งานก่อสร้างงานทางทะเล', 1),
('LCBP3C2','โครงการพัฒนาท่าเรือแหลมฉบัง ระยะที่ 3 (ส่วนที่ 2) งานก่อสร้างอาคาร ท่าเทียบเรือ ระบบถนน และระบบสาธารณูปโภค', 1),
('LCBP3C3','โครงการพัฒนาท่าเรือแหลมฉบัง ระยะที่ 3 (ส่วนที่ 3) งานก่อสร้าง', 1),
('LCBP3C4','โครงการพัฒนาท่าเรือแหลมฉบัง ระยะที่ 3 (ส่วนที่ 4) งานก่อสร้าง', 1);
-- 4.10 Users Table (RBAC)
CREATE TABLE users (
user_id INT NOT NULL AUTO_INCREMENT PRIMARY KEY COMMENT 'ID ของตาราง',
username VARCHAR(50) NOT NULL UNIQUE COMMENT 'ชื่อผู้ใช้งาน',
password_hash VARCHAR(255) NOT NULL COMMENT 'รหัสผ่านแบบแฮช',
first_name VARCHAR(50) NULL DEFAULT NULL COMMENT 'ชื่อจริง',
last_name VARCHAR(50) NULL DEFAULT NULL COMMENT 'นามสกุล',
email VARCHAR(100) NULL UNIQUE COMMENT 'อีเมลผู้ใช้งาน',
line_id VARCHAR(100) NULL COMMENT 'LINE ID',
organization_id INT NULL COMMENT 'รหัสองค์กรณ์ (FK -> organizations)', -- link to organizations for ADMIN scope
is_active TINYINT(1) NOT NULL DEFAULT 1 COMMENT 'สถานะการใช้งาน',
failed_attempts INT NOT NULL DEFAULT 0 COMMENT 'จำนวนครั้งที่ล็อกอินล้มเหลว',
locked_until DATETIME NULL COMMENT 'ล็อกอินไม่ได้จนถึงเวลา',
last_login_at TIMESTAMP NULL COMMENT 'วันที่และเวลาที่ล็อกอินล่าสุด',
created_at TIMESTAMP NOT NULL DEFAULT CURRENT_TIMESTAMP COMMENT 'วันที่สร้าง',
updated_at TIMESTAMP NULL DEFAULT NULL ON UPDATE CURRENT_TIMESTAMP COMMENT 'วันที่แก้ไขล่าสุด',
UNIQUE KEY ux_users_username (username),
UNIQUE KEY ux_users_email (email),
CONSTRAINT fk_users_org FOREIGN KEY (organization_id) REFERENCES organizations(id) ON DELETE SET NULL ON UPDATE CASCADE
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_general_ci COMMENT='ตารางผู้ใช้งาน';
-- Initial SUPER_ADMIN user
INSERT INTO users (username, password_hash, email, is_active)
VALUES ('superadmin', '$2y$10$0kjBMxWq7E4G7P.dc8r5i.cjiPBiup553AsFpDfxUt31gKg9h/udq', 'superadmin@example.com', 1)
ON DUPLICATE KEY UPDATE email=VALUES(email), is_active=VALUES(is_active);
-- Create editor01 user
INSERT IGNORE INTO users (username, password_hash, email, is_active)
VALUES ('editor01', '$2y$10$0kjBMxWq7E4G7P.dc8r5i.cjiPBiup553AsFpDfxUt31gKg9h/udq', 'editor01@example.com', 1);
-- Create viewer01 user (password hash placeholder, must change later)
INSERT IGNORE INTO users (username, password_hash, email, is_active)
VALUES ('viewer01', '$2y$10$0kjBMxWq7E4G7P.dc8r5i.cjiPBiup553AsFpDfxUt31gKg9h/udq', 'viewer01@example.com', 1);
CREATE TABLE notifications (
id INT AUTO_INCREMENT PRIMARY KEY,
user_id INT NOT NULL,
title VARCHAR(255) NOT NULL,
message TEXT,
notification_type ENUM('EMAIL', 'LINE', 'SYSTEM') NOT NULL,
is_read BOOLEAN DEFAULT FALSE,
entity_type VARCHAR(50), -- เช่น 'rfa', 'circulation'
entity_id INT,
created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP,
FOREIGN KEY (user_id) REFERENCES users(user_id)
);
-- ==========================================================
-- Level 3: ตารางที่ถูกอ้างอิงโดย Level 2
-- ==========================================================
-- 3.1.2 rfas_types Table
CREATE TABLE rfa_types (
id INT AUTO_INCREMENT PRIMARY KEY COMMENT 'ID ของตาราง',
code VARCHAR(20) NOT NULL UNIQUE COMMENT 'รหัสประเภทเอกสาร',
name VARCHAR(100) NOT NULL COMMENT 'ชื่อประเภทเอกสาร',
sort_order INT DEFAULT 0 COMMENT 'ลำดับการแสดงผล',
is_active TINYINT(1) DEFAULT 1 COMMENT 'สถานะการใช้งาน'
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_general_ci COMMENT='ประเภทเอกสาร';
INSERT INTO rfa_types (code, name, sort_order, is_active) VALUES
('DWG', 'Shop Drawing', 10, 1),
('DOC', 'Document', 20, 1),
('SPC', 'Specification', 21, 1),
('CAL', 'Calculation', 22, 1),
('TRP', 'Test Report', 23, 1),
('SRY', 'Survey Report', 24, 1),
('QAQC', 'QA/QC Document', 25, 1),
('MES', 'Method Statement', 30, 1),
('MAT', 'Material', 40, 1),
('ASB', 'As-Built', 50, 1),
('OTH', 'Other', 99, 1);
-- 3.2.2 rfas_status_codes Table
CREATE TABLE rfa_status_codes (
id INT AUTO_INCREMENT PRIMARY KEY COMMENT 'ID ของตาราง',
code VARCHAR(20) NOT NULL UNIQUE COMMENT 'รหัสสถานะเอกสาร',
description VARCHAR(255) NULL COMMENT 'คำอธิบายสถานะเอกสาร',
sort_order INT DEFAULT 0 COMMENT 'ลำดับการแสดงผล',
is_active TINYINT(1) DEFAULT 1 COMMENT 'สถานะการใช้งาน'
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_general_ci COMMENT='รหัสสถานะเอกสาร';
INSERT INTO rfa_status_codes (code, description, sort_order) VALUES
('DFT', 'Draft', 1),
('FAP', 'For Approve', 11),
('FRE', 'For Review', 12),
('FCO', 'For Construction', 20),
('ASB', 'AS-Built', 30),
('OBS', 'Obsolete', 80),
('CC', 'Canceled', 99);
-- 3.3.2 rfas_approve_codes Table
CREATE TABLE rfa_approve_codes (
id INT AUTO_INCREMENT PRIMARY KEY COMMENT 'ID ของตาราง',
code VARCHAR(20) NOT NULL UNIQUE COMMENT 'รหัสการอนุมัติเอกสาร',
description VARCHAR(255) NULL COMMENT 'คำอธิบายการอนุมัติเอกสาร',
sort_order INT DEFAULT 0 COMMENT 'ลำดับการแสดงผล',
is_active TINYINT(1) DEFAULT 1 COMMENT 'สถานะการใช้งาน'
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_general_ci COMMENT='รหัสการอนุมัติเอกสาร';
INSERT INTO rfa_approve_codes (code, description, sort_order, is_active) VALUES
('1A', 'Approved by Authority', 10, 1),
('1C', 'Approved by CSC', 11, 1),
('1N', 'Approved As Note', 12, 1),
('1R', 'Approved with Remarks', 13, 1),
('3C', 'Consultant Comments', 31, 1),
('3R', 'Revise and Resubmit', 32, 1),
('4X', 'Reject', 40, 1),
('5N', 'No Further Action', 50, 1);
-- 3.4.6 contract_dwg_volume Table
CREATE TABLE contract_drawing_volumes (
id INT AUTO_INCREMENT PRIMARY KEY COMMENT 'ID ของตาราง',
project_id INT NOT NULL COMMENT 'รหัสโครงการ',
volume_code VARCHAR(100) NOT NULL COMMENT 'รหัสเล่ม',
volume_name VARCHAR(255) NULL COMMENT 'ชื่อเล่ม',
description TEXT NULL COMMENT 'คำอธิบายเล่ม',
created_at TIMESTAMP NOT NULL DEFAULT CURRENT_TIMESTAMP COMMENT 'วันที่สร้าง',
updated_at TIMESTAMP NULL DEFAULT NULL ON UPDATE CURRENT_TIMESTAMP COMMENT 'วันที่แก้ไขล่าสุด',
UNIQUE KEY ux_volume_project_code (project_id, volume_code),
UNIQUE KEY ux_volume_project_volid (project_id, id),
CONSTRAINT fk_volume_project FOREIGN KEY (project_id) REFERENCES projects(id) ON UPDATE CASCADE ON DELETE CASCADE
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_general_ci COMMENT='เล่มของ Contract Drawing';
-- 3.5.6 contract_drawing_cat Table
CREATE TABLE contract_drawing_cats (
id INT AUTO_INCREMENT PRIMARY KEY COMMENT 'ID ของตาราง',
project_id INT NOT NULL COMMENT 'รหัสโครงการ',
cat_code VARCHAR(100) NULL COMMENT 'รหัสหมวดหมู่',
cat_name VARCHAR(255) NOT NULL COMMENT 'ชื่อหมวดหมู่',
created_at TIMESTAMP NOT NULL DEFAULT CURRENT_TIMESTAMP COMMENT 'วันที่สร้าง',
updated_at TIMESTAMP NULL DEFAULT NULL ON UPDATE CURRENT_TIMESTAMP COMMENT 'วันที่แก้ไขล่าสุด',
UNIQUE KEY ux_cat_project_name (project_id, cat_name), -- unique: (project_id, cat_name)
UNIQUE KEY ux_cat_project_catid (project_id, id), -- เพิ่ม unique (project_id, cat_id) เพื่อรองรับ composite FK
CONSTRAINT fk_cat_project FOREIGN KEY (project_id) REFERENCES projects(id) ON UPDATE CASCADE ON DELETE CASCADE
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_general_ci COMMENT='ตารางหมวดหมู่ของแบบสัญญา';
-- 3.6.6 contract_drawing_sub_cats Table
CREATE TABLE contract_drawing_sub_cats (
id INT AUTO_INCREMENT PRIMARY KEY COMMENT 'ID ของตาราง',
project_id INT NOT NULL COMMENT 'รหัสโครงการ',
sub_cat_code VARCHAR(100) NULL COMMENT 'รหัสหมวดหมู่ย่อย',
sub_cat_name VARCHAR(255) NOT NULL COMMENT 'ชื่อหมวดหมู่ย่อย',
created_at TIMESTAMP NOT NULL DEFAULT CURRENT_TIMESTAMP COMMENT 'วันที่สร้าง',
updated_at TIMESTAMP NULL DEFAULT NULL ON UPDATE CURRENT_TIMESTAMP COMMENT 'วันที่แก้ไขล่าสุด',
UNIQUE KEY ux_subcat_project_name (project_id, sub_cat_name), -- unique: (project_id, sub_cat_name)
UNIQUE KEY ux_subcat_project_subcatid (project_id, id), -- เพิ่ม unique (project_id, sub_cat_id) เพื่อรองรับ composite FK
CONSTRAINT fk_subcat_project FOREIGN KEY (project_id) REFERENCES projects(id) ON UPDATE CASCADE ON DELETE CASCADE
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_general_ci COMMENT='ตารางหมวดหมู่ย่อยของแบบสัญญา';
-- 3.7.5 shop_drawing_main_categories Table
CREATE TABLE shop_drawing_main_categories (
id INT NOT NULL AUTO_INCREMENT PRIMARY KEY COMMENT 'ID ของตาราง',
code VARCHAR(20) NOT NULL COMMENT 'รหัสหมวดหมู่หลัก',
name VARCHAR(255) NOT NULL COMMENT 'ชื่อหมวดหมู่หลัก',
sort_order INT NOT NULL DEFAULT 0 COMMENT 'ลำดับการแสดงผล',
UNIQUE KEY ux_sd_main_cat_code (code)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_general_ci COMMENT='หมวดหมู่หลักของ Shop Drawing';
-- 3.8.5 shop_drawing_sub_categories Table
CREATE TABLE shop_drawing_sub_categories (
id INT NOT NULL AUTO_INCREMENT PRIMARY KEY COMMENT 'ID ของตาราง',
main_category_id INT NOT NULL COMMENT 'ID ของหมวดหมู่หลัก',
code VARCHAR(20) NOT NULL COMMENT 'รหัสหมวดหมู่ย่อย',
name VARCHAR(255) NOT NULL COMMENT 'ชื่อหมวดหมู่ย่อย',
sort_order INT NOT NULL DEFAULT 0 COMMENT 'ลำดับการแสดงผล',
UNIQUE KEY ux_sd_sub_cat_code (code),
CONSTRAINT fk_sd_sub_cat_main FOREIGN KEY (main_category_id) REFERENCES shop_drawing_main_categories(id) ON DELETE CASCADE
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_general_ci COMMENT='หมวดหมู่ย่อยของ Shop Drawing';
-- 3.9.1 correspondences Table ตารางเก็บข้อมูลการสื่อสาร
CREATE TABLE correspondences (
id INT AUTO_INCREMENT PRIMARY KEY COMMENT 'ID ของตาราง',
correspondence_number VARCHAR(100) NOT NULL COMMENT 'เลขที่หนังสือ',
correspondence_type_id INT NOT NULL COMMENT 'ประเภทหนังสือ',
is_internal_communication TINYINT(1) NOT NULL DEFAULT 0 COMMENT 'ระบุว่าเป็นหนังสือสื่อสารภายใน (1=ใช่,0=ไม่ใช่)',
project_id INT NOT NULL COMMENT 'รหัสโครงการ',
originator_id INT NULL COMMENT 'องกรณ์ที่เป็นผู้ออกเอกสาร', -- organizations.id
-- recipient_id INT NULL COMMENT 'องกรณ์ที่เป็นปู้รับเอกสาร', -- organizations.id -> correspondence_recipients
created_at DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP COMMENT 'วันที่สร้าง',
created_by INT NULL COMMENT 'รหัสผู้สร้าง',
deleted_at DATETIME NULL COMMENT 'วันที่ลบ',
-- Track current/latest revision
-- current_revision_id INT NULL COMMENT 'ระบุ Revision ปัจจุบัน', -- FK -> correspondence_revisions.correspondence_revision_id
-- latest_revision_number INT NOT NULL DEFAULT 0 COMMENT 'หมายเลข Revision ล่าสุด', -- INT เพื่อง่ายต่อการเรียงลำดับ References correspondence_revisions.revision_number
-- CONSTRAINT chk_cor_internal CHECK (is_internal_communication IN (0,1)),
-- correspondences number uniqueness per project
CONSTRAINT uq_corr_no_per_project UNIQUE (project_id, correspondence_number),
-- FKs
CONSTRAINT fk_cor_project FOREIGN KEY (project_id) REFERENCES projects(id) ON UPDATE CASCADE ON DELETE CASCADE,
CONSTRAINT fk_cor_originator FOREIGN KEY (originator_id) REFERENCES organizations(id) ON UPDATE CASCADE ON DELETE SET NULL,
-- CONSTRAINT fk_cor_recipient FOREIGN KEY (recipient_id) REFERENCES organizations(id) ON UPDATE CASCADE ON DELETE SET NULL,
CONSTRAINT fk_cor_created_by FOREIGN KEY (created_by) REFERENCES users(user_id) ON UPDATE CASCADE ON DELETE SET NULL,
CONSTRAINT fk_cor_type FOREIGN KEY (correspondence_type_id) REFERENCES correspondence_types(id) ON UPDATE CASCADE ON DELETE RESTRICT
-- CONSTRAINT fk_cm_current_revision FOREIGN KEY (current_revision_id) REFERENCES correspondence_revisions(id) ON UPDATE CASCADE ON DELETE SET NULL
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_general_ci COMMENT = 'ตารางเอกสารโต้ตอบ';
-- Indexes for correspondences table
CREATE INDEX idx_cor_project ON correspondences(project_id);
CREATE INDEX idx_cor_originator ON correspondences(originator_id);
CREATE INDEX idx_cor_type ON correspondences(correspondence_type_id);
CREATE INDEX idx_cor_deleted_at ON correspondences(deleted_at);
-- CREATE INDEX idx_cor_created_at ON correspondences(created_at);
-- CREATE INDEX idx_cor_current_rev ON correspondences(current_revision_id);
-- ==========================================================
-- Level 2: ตารางที่ถูกอ้างอิงโดย Level 1
-- ==========================================================
-- 2.1 ตารางหลักสำหรับเก็บ Tag ทั้งหมด (Master Data)
CREATE TABLE tags (
id INT NOT NULL AUTO_INCREMENT PRIMARY KEY COMMENT 'ID ของตาราง',
tag_name VARCHAR(100) NOT NULL COMMENT 'ชื่อแท็ก',
description TEXT COMMENT 'คำอธิบายแท็ก',
created_at TIMESTAMP NOT NULL DEFAULT CURRENT_TIMESTAMP COMMENT 'วันที่สร้าง',
updated_at TIMESTAMP NOT NULL DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP COMMENT 'วันที่แก้ไขล่าสุด',
UNIQUE KEY ux_tag_name (tag_name)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_general_ci COMMENT='ตาราง Master Data ของ Tags';
-- 2.2.1 ตารางเชื่อม (Junction Table) ระหว่างเอกสารและ Tag
CREATE TABLE correspondence_tags (
correspondence_id INT NOT NULL COMMENT 'ID ของเอกสาร',
tag_id INT NOT NULL COMMENT 'ID ของ Tag',
-- กำหนดให้ ID ทั้งสองเป็น Primary Key ร่วมกัน เพื่อป้องกันการผูก Tag เดียวกันกับเอกสารเดิมซ้ำ
PRIMARY KEY (correspondence_id, tag_id),
-- Foreign Keys
CONSTRAINT fk_ct_correspondence FOREIGN KEY (correspondence_id) REFERENCES correspondences(id) ON DELETE CASCADE,
CONSTRAINT fk_ct_tag FOREIGN KEY (tag_id) REFERENCES tags(id) ON DELETE CASCADE
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_general_ci COMMENT='ตารางเชื่อมความสัมพันธ์ระหว่างเอกสารและ Tags';
-- 2.3.3 circulations Table:
CREATE TABLE circulations (
id INT NOT NULL AUTO_INCREMENT PRIMARY KEY COMMENT 'ID ของตารางใบเวียน',
correspondence_id INT UNIQUE NOT NULL COMMENT 'ID ของเอกสาร (จากตาราง correspondences)', -- one circulation record per correspondence (optional)
organization_id INT NOT NULL COMMENT 'ID ขององค์กรณ์ที่เป็นเจ้าของใบเวียนนี้', -- องค์กรณ์ที่เป็นเจ้าของใบเวียนนี้
circulation_no VARCHAR(100) NOT NULL COMMENT 'เลขที่ใบเวียน', -- unique per organization
circulation_subject VARCHAR(500) NOT NULL COMMENT 'เรื่องใบเวียน',
circulation_status_code VARCHAR(20) NOT NULL DEFAULT 'DRAFT' COMMENT 'รหัสสถานะใบเวียน',
created_by_user_id INT NOT NULL COMMENT 'ID ของผู้สร้างใบเวียน',
submitted_at TIMESTAMP NULL COMMENT 'วันที่ส่งใบเวียน',
closed_at TIMESTAMP NULL COMMENT 'วันที่ปิดใบเวียน',
created_at TIMESTAMP NOT NULL DEFAULT CURRENT_TIMESTAMP COMMENT 'วันที่สร้าง',
updated_at TIMESTAMP NOT NULL DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP COMMENT 'วันที่แก้ไขล่าสุด',
CONSTRAINT uq_cir_org_no UNIQUE(organization_id, circulation_no),
CONSTRAINT fk_cir_correspondence FOREIGN KEY (correspondence_id) REFERENCES correspondences(id),
CONSTRAINT fk_cir_org FOREIGN KEY (organization_id) REFERENCES organizations(id),
CONSTRAINT fk_cir_status FOREIGN KEY (circulation_status_code) REFERENCES circulation_status_codes(code),
CONSTRAINT fk_cir_user FOREIGN KEY (created_by_user_id) REFERENCES users(user_id)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_general_ci COMMENT='ตารางเก็บข้อมูลใบเวียนเอกสาร';
CREATE INDEX idx_cir_org ON circulations(organization_id);
CREATE INDEX idx_cir_status ON circulations(circulation_status_code);
CREATE INDEX idx_cir_corr ON circulations(correspondence_id);
-- 2.4.4 transmittal Table: ตารางสำหรับเก็บข้อมูลเฉพาะของ Transmittal (เป็นตารางลูกของ correspondences)
CREATE TABLE transmittals (
-- ใช้ correspondence_id เป็นทั้ง Primary Key และ Foreign Key เพื่อสร้างความสัมพันธ์แบบ One-to-One
correspondence_id INT NOT NULL PRIMARY KEY COMMENT 'ID ของเอกสาร (จากตาราง correspondences)',
purpose ENUM('FOR_APPROVAL', 'FOR_INFORMATION', 'FOR_CONSTRUCTION', 'AS_BUILT') NOT NULL DEFAULT 'FOR_INFORMATION' COMMENT 'วัตถุประสงค์ในการส่ง',
remarks TEXT COMMENT 'หมายเหตุเพิ่มเติม',
-- Foreign Key
CONSTRAINT fk_transmittal_correspondence FOREIGN KEY (correspondence_id) REFERENCES correspondences(id) ON DELETE CASCADE
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_general_ci COMMENT='ตารางเก็บข้อมูลเฉพาะของเอกสารนำส่ง (Transmittal)';
-- 2.5.2 rfas Table ตารางเก็บข้อมูลเอกสารขออนุมัติ (Request for Approval): rfas 1 to many rfa_revision
CREATE TABLE rfas (
id INT AUTO_INCREMENT PRIMARY KEY COMMENT 'ID ของตาราง',
-- rfa_number VARCHAR(100) NOT NULL,
rfa_type_id INT NOT NULL COMMENT 'ประเภทเอกสารขออนุมัติ',
-- project_id INT NOT NULL COMMENT 'รหัสโครงการ',
-- original_id INT NOT NULL COMMENT 'รหัสเอกสารต้นฉบับ (สำหรับเชื่อมโยง revision)',
revision_number INT NOT NULL COMMENT 'หมายเลข Revision',
-- title VARCHAR(255) NOT NULL COMMENT 'หัวข้อเอกสาร',
-- status_code_id INT NOT NULL COMMENT 'รหัสสถานะเอกสาร',
-- approve_code_id INT NULL COMMENT 'รหัสการอนุมัติเอกสาร',
created_at DATETIME DEFAULT CURRENT_TIMESTAMP NOT NULL COMMENT 'วันที่สร้าง',
created_by INT NULL COMMENT 'ผู้สร้าง',
-- updated_by INT NULL COMMENT 'ผู้แก้ไขล่าสุด',
deleted_at DATETIME NULL COMMENT 'วันที่ลบ',
-- Track current/latest revision
-- current_revision_id INT NULL COMMENT 'ระบุ Revision ปัจจุบัน', -- FK -> correspondence_revisions.correspondence_revision_id
-- latest_revision_number INT NOT NULL DEFAULT 0 COMMENT 'หมายเลข Revision ล่าสุด', -- INT เพื่อง่ายต่อการเรียงลำดับ References correspondence_revisions.revision_number
CONSTRAINT fk_rfa_created_by FOREIGN KEY (created_by) REFERENCES users(user_id) ON UPDATE CASCADE ON DELETE SET NULL,
CONSTRAINT fk_rfa_type FOREIGN KEY (rfa_type_id) REFERENCES rfa_types(id)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_general_ci COMMENT='ตารางเก็บเอกสารขออนุมัติ';
CREATE INDEX idx_rfa_deleted_at ON rfas(deleted_at);
-- CREATE UNIQUE INDEX idx_unique_techdoc_revision ON rfas (original_id, revision, project_id);
/* ===========================================================
Drawings (ต่อโครงการ)
- 1 drawing ∈ 1 project
- ชี้ 1 sub-category (ในโครงการเดียวกัน)
- ชี้ 1 volume (ในโครงการเดียวกัน)
- unique: (project_id, condwg_no)
=========================================================== */
-- 2.6.6 contract_drawings Table
CREATE TABLE contract_drawings (
id INT AUTO_INCREMENT PRIMARY KEY COMMENT 'ID ของตาราง',
project_id INT NOT NULL COMMENT 'รหัสโครงการ',
condwg_no VARCHAR(255) NOT NULL COMMENT 'เลขที่แบบสัญญา', -- รหัส/เลขดรอว์อิง
title VARCHAR(255) NULL COMMENT 'ชื่อแบบสัญญา', -- ชื่อดรอว์อิง
sub_cat_id INT NOT NULL COMMENT 'รหัสหมวดหมู่ย่อย', -- 1 drawing → 1 sub-category
volume_id INT NOT NULL COMMENT 'รหัสเล่ม', -- 1 drawing → 1 volume
sub_no INT NULL COMMENT 'หมายเลขย่อย', -- หมายเลขย่อย (ถ้ามี)
remark VARCHAR(500) NULL COMMENT 'หมายเหตุ', -- หมายเหตุเพิ่มเติม
created_at TIMESTAMP NOT NULL DEFAULT CURRENT_TIMESTAMP COMMENT 'วันที่สร้าง',
updated_at TIMESTAMP NULL DEFAULT NULL ON UPDATE CURRENT_TIMESTAMP COMMENT 'วันที่แก้ไขล่าสุด',
deleted_at DATETIME NULL COMMENT 'วันที่ลบ';
updated_by INT NULL COMMENT 'ผู้แก้ไขล่าสุด';
UNIQUE KEY ux_condwg_no_project (project_id, condwg_no),
KEY idx_condwg_project (project_id),
KEY idx_condwg_sub_cat (project_id, sub_cat_id),
KEY idx_condwg_volume (project_id, volume_id),
KEY idx_condwg_no (condwg_no),
CONSTRAINT fk_condwg_project FOREIGN KEY (project_id) REFERENCES projects(id) ON UPDATE CASCADE ON DELETE CASCADE,
/* same-project guard ด้วย composite FK */
CONSTRAINT fk_condwg_subcat_same_project FOREIGN KEY (project_id, sub_cat_id) REFERENCES contract_drawing_sub_cats(project_id, id) ON UPDATE CASCADE ON DELETE RESTRICT,
CONSTRAINT fk_condwg_volume_same_project FOREIGN KEY (project_id, volume_id) REFERENCES contract_drawing_volumes(project_id, id) ON UPDATE CASCADE ON DELETE RESTRICT
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_general_ci COMMENT='ตารางเก็บแบบสัญญาต่อโครงการ';
-- 2.7.5 shop_drawings Table
CREATE TABLE shop_drawings (
id INT NOT NULL AUTO_INCREMENT PRIMARY KEY COMMENT 'ID ของตาราง',
project_id INT NOT NULL COMMENT 'รหัสโครงการ',
drawing_number VARCHAR(100) NOT NULL COMMENT 'เลขที่แบบ Shop Drawing',
title VARCHAR(500) NOT NULL COMMENT 'ชื่อแบบ',
main_category_id INT NOT NULL COMMENT 'ID หมวดหมู่หลัก',
sub_category_id INT NOT NULL COMMENT 'ID หมวดหมู่ย่อย',
created_at TIMESTAMP NOT NULL DEFAULT CURRENT_TIMESTAMP COMMENT 'วันที่สร้าง',
updated_at TIMESTAMP NOT NULL DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP COMMENT 'วันที่แก้ไขล่าสุด',
deleted_at DATETIME NULL COMMENT 'วันที่ลบ';
updated_by INT NULL COMMENT 'ผู้แก้ไขล่าสุด';
UNIQUE KEY ux_sd_drawing_number (drawing_number),
KEY idx_sd_project (project_id),
KEY idx_sd_main_category (project_id, main_category_id),
KEY idx_sd_sub_category (project_id,sub_category_id),
KEY idx_sd_drawing_number (drawing_number),
CONSTRAINT fk_sd_project FOREIGN KEY (project_id) REFERENCES projects(id) ON UPDATE CASCADE ON DELETE CASCADE,
CONSTRAINT fk_sd_main_cat FOREIGN KEY (main_category_id) REFERENCES shop_drawing_main_categories(id),
CONSTRAINT fk_sd_sub_cat FOREIGN KEY (sub_category_id) REFERENCES shop_drawing_sub_categories(id)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_general_ci COMMENT='ข้อมูลหลักของ Shop Drawing';
-- 2.8.2 rfa_revision Table ตารางเก็บข้อมูล Revision ของเอกสารขออนุมัติ : rfa_revision many to 1 rfas, rfa_revision 1 to 1 correwpondence
-- (ข้อควรทราบ:
-- 1. Constraint 'fk_rr_correspondence' (FOREIGN KEY) บน 'correspondence_id'
-- ยังคงอยู่ และทำหน้าที่เป็น M:1 อย่างถูกต้อง
-- 2. Constraint 'fk_rr_rfa' (FOREIGN KEY) บน 'rfa_id' ยังคงอยู่
-- 3. UNIQUE KEY 'uq_rr_rev_number' (rfa_id, revision_number) ยังคงอยู่
-- 4. UNIQUE KEY 'uq_rr_current' (rfa_id, is_current) ยังคงอยู่
-- )
CREATE TABLE rfa_revisions (
id INT NOT NULL AUTO_INCREMENT PRIMARY KEY COMMENT 'ID ของตาราง',
correspondence_id INT NOT NULL COMMENT 'Master correspondence ID', -- FK -> correspondences.correspondence_id
-- Relationships
rfa_id INT NOT NULL COMMENT 'ID ของเอกสารขออนุมัติ (จากตาราง rfas)', -- FK -> rfas.rfa_id
revision_number INT NOT NULL COMMENT 'หมายเลข Revision', -- เปลี่ยนเป็น INT เพื่อง่ายต่อการเรียงลำดับ
revision_label VARCHAR(10) NULL COMMENT 'ตัวหนงสือ/ตัวเลข กำกับ Revision', -- e.g., A, A1, B10, 1, 2.1, 10.5 ; NULL for first issue if desired
-- สถานะเฉพาะของ Revision นี้
is_current BOOLEAN NOT NULL DEFAULT FALSE COMMENT 'ระบุว่าเป็น Revision ปัจจุบัน (1=ใช่,0=ไม่ใช่)',
rfa_status_code_id INT NOT NULL COMMENT 'รรหัสสถานะเอกสาร (FK → rfa_status_codes.id)',
rfa_approve_code_id INT NULL COMMENT 'รหัสการอนุมัติเอกสาร (FK → rfa_approve_codes.id)',
-- ข้อมูลที่เปลี่ยนแปลงตาม Revision
title VARCHAR(255) NOT NULL COMMENT 'เรื่อง',
document_date DATE NULL COMMENT 'วันที่ในเอกสาร (อาจแตกต่างจากวันที่สร้าง)',
issued_date DATE NULL COMMENT 'วันที่ส่งขออนุมัติ',
received_date DATETIME NULL COMMENT 'วันที่ลงรับเอกสาร',
-- due_date DATETIME NULL COMMENT 'วันที่ต้องตอบเอกสาร',
approved_date DATE NULL COMMENT 'วันที่อนุมัติ',
-- Metadata
description TEXT NULL COMMENT 'คำอธิบายการแก้ไขใน Revision นี้',
-- Audit
created_at DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP COMMENT 'วันที่สร้างเอกสาร',
created_by INT NULL COMMENT 'ผู้สร้างเอกสาร (FK → users.user_id)',
updated_by INT NULL COMMENT 'ผู้แก้ไขล่าสุด (FK → users.user_id)',
FULLTEXT(title, description);
CONSTRAINT uq_rr_rev_number UNIQUE (rfa_id, revision_number), -- ป้องกันการมี revision_number ซ้ำกันใน rfa_id เดียวกัน
CONSTRAINT uq_rr_current UNIQUE (rfa_id, is_current), -- ใช้ partial unique index ได้ดีกว่า
-- Validation constraints
CONSTRAINT chk_rev_format
CHECK (
revision_label IS NULL
OR revision_label REGEXP '^[A-Z]{1}[0-9]*$'
OR revision_label REGEXP '^[0-9]+(\\.[0-9]+)?$'
),
-- CONSTRAINT chk_due_after_received CHECK (due_date IS NULL OR received_date IS NULL OR due_date >= received_date),
CONSTRAINT chk_approved_after_received CHECK (approved_date IS NULL OR received_date IS NULL OR approved_date >= DATE(received_date)),
-- CONSTRAINT chk_approved_after_due CHECK (approved_date IS NULL OR due_date IS NULL OR approved_date >= DATE(due_date)),
-- Foreign keys
CONSTRAINT fk_rr_correspondence FOREIGN KEY (correspondence_id) REFERENCES correspondences(id) ON DELETE CASCADE,
CONSTRAINT fk_rr_rfa FOREIGN KEY (rfa_id) REFERENCES rfas(id) ON DELETE CASCADE,
CONSTRAINT fk_rr_status FOREIGN KEY (rfa_status_code_id) REFERENCES rfa_status_codes(id),
CONSTRAINT fk_rr_approve FOREIGN KEY (rfa_approve_code_id) REFERENCES rfa_approve_codes(id) ON DELETE SET NULL,
CONSTRAINT fk_rr_created_by FOREIGN KEY (created_by) REFERENCES users(user_id) ON UPDATE CASCADE ON DELETE SET NULL,
CONSTRAINT fk_rr_updated_by FOREIGN KEY (updated_by) REFERENCES users(user_id) ON UPDATE CASCADE ON DELETE SET NULL
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_general_ci COMMENT='ตารางเก็บ Revision ของ RFA';
CREATE INDEX idx_rr_correspondence ON rfa_revisions(correspondence_id);
CREATE INDEX idx_rr_rfa ON rfa_revisions(rfa_id);
CREATE INDEX idx_rr_status ON rfa_revisions(rfa_status_code_id);
CREATE INDEX idx_rr_approve ON rfa_revisions(rfa_approve_code_id);
CREATE INDEX idx_rr_is_current ON rfa_revisions(is_current);
CREATE INDEX idx_rr_created_at ON rfa_revisions(created_at);
-- 2.9.1 correspondence_revisions Table: ตารางสำหรับเก็บประวัติการแก้ไขเอกสาร (Revision History)
-- (ข้อควรทราบ:
-- 1. Constraint 'fk_cr_correspondence' (FOREIGN KEY) บน 'correspondence_id' ยังคงอยู่
-- ซึ่งตอนนี้จะทำหน้าที่เป็น M:1 (Many-to-One) อย่างถูกต้อง
-- 2. UNIQUE KEY 'uq_master_revision_number' (correspondence_id, revision_number)
-- ยังคงอยู่ เพื่อป้องกัน Rev 1, Rev 1 ซ้ำกันใน Master เดียว
-- 3. UNIQUE KEY 'uq_master_current' (correspondence_id, is_current)
-- ยังคงอยู่ เพื่อบังคับให้มี is_current=TRUE ได้เพียงอันเดียวต่อ Master
-- )
CREATE TABLE correspondence_revisions (
id INT AUTO_INCREMENT PRIMARY KEY COMMENT 'ID ของตาราง',
-- ใช้ correspondence_id เป็นทั้ง Primary Key และ Foreign Key เพื่อสร้างความสัมพันธ์แบบ One-to-One
correspondence_id INT NOT NULL COMMENT 'Master correspondence ID',
revision_number INT NOT NULL COMMENT 'หมายเลข Revision', -- เปลี่ยนเป็น INT เพื่อง่ายต่อการเรียงลำดับ
revision_label VARCHAR(10) NULL COMMENT 'ตัวหนงสือ/ตัวเลข กำกับ Revision', -- e.g., A, A1, B10, 1, 2.1, 10.5 ; NULL for first issue if desired
-- สถานะเฉพาะของ Revision นี้
is_current BOOLEAN NOT NULL DEFAULT FALSE COMMENT 'ระบุว่าเป็น Revision ปัจจุบัน (1=ใช่,0=ไม่ใช่)',
correspondence_status_id INT NOT NULL COMMENT 'สถานะหนังสือ',
-- ข้อมูลที่เปลี่ยนแปลงตาม Revision
title VARCHAR(255) NOT NULL COMMENT 'เรื่อง',
document_date DATE NULL COMMENT 'วันที่ในเอกสาร (อาจแตกต่างจากวันที่สร้าง)',
issued_date DATETIME NULL COMMENT 'วันที่ออกเอกสาร',
received_date DATETIME NULL COMMENT 'วันที่ลงรับเอกสาร',
due_date DATETIME NULL COMMENT 'วันที่ต้องตอบเอกสาร',
-- Metadata
description TEXT NULL COMMENT 'คำอธิบายการแก้ไขใน Revision นี้',
-- details [email_details, instruction_details, letter_details, memorandum_details, minutes_of_meeting_details, rfi_details]
details JSON NULL COMMENT 'เก็บข้อมูลเฉพาะของเอกสารแต่ละประเภทในรูปแบบ JSON',
-- Audit
created_at DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP COMMENT 'วันที่สร้างเอกสาร',
created_by INT NULL COMMENT 'ผู้สร้างเอกสาร',
updated_by INT NULL COMMENT 'ผู้แก้ไขล่าสุด',
FULLTEXT(title, description);
CONSTRAINT uq_master_revision_number UNIQUE (correspondence_id, revision_number), -- ป้องกันการมี revision_number ซ้ำกันใน correspondence_id เดียวกัน
CONSTRAINT uq_master_current UNIQUE (correspondence_id, is_current), -- ใช้ partial unique index ได้ดีกว่า
-- รูปแบบ (A-Z?) → ตัวอักษร A-Z ตามด้วยตัวเลข 0 ตัวหรือมากกว่า (เช่น A, A1, B10), ตัวเลขล้วน หรือ ตัวเลขทศนิยม (เช่น 1, 2.1, 10.5)
CONSTRAINT chk_rev_format
CHECK (
revision_label IS NULL
OR revision_label REGEXP '^[A-Z]{1}[0-9]*$'
OR revision_label REGEXP '^[0-9]+(\\.[0-9]+)?$'
),
CONSTRAINT chk_issued_after_document CHECK (document_date IS NULL OR issued_date IS NULL OR issued_date >= document_date),
CONSTRAINT chk_received_after_issued CHECK (received_date IS NULL OR issued_date IS NULL OR received_date >= issued_date),
-- CONSTRAINT chk_due_after_received CHECK (due_date IS NULL OR received_date IS NULL OR due_date >= received_date),
-- FKs
CONSTRAINT fk_cr_correspondence FOREIGN KEY (correspondence_id) REFERENCES correspondences(id) ON UPDATE CASCADE ON DELETE CASCADE,
CONSTRAINT fk_cr_status FOREIGN KEY (correspondence_status_id) REFERENCES correspondence_status(id) ON UPDATE CASCADE ON DELETE RESTRICT,
CONSTRAINT fk_cr_created_by FOREIGN KEY (created_by) REFERENCES users(user_id) ON UPDATE CASCADE ON DELETE SET NULL,
CONSTRAINT fk_cr_updated_by FOREIGN KEY (updated_by) REFERENCES users(user_id) ON UPDATE CASCADE ON DELETE SET NULL
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_general_ci COMMENT = 'ตารางเก็บ Revision ของ correspondenceอ';
CREATE INDEX idx_cr_correspondence ON correspondence_revisions(correspondence_id);
CREATE INDEX idx_cr_revision_number ON correspondence_revisions(correspondence_id, revision_number);
CREATE INDEX idx_cr_is_current ON correspondence_revisions(correspondence_id, is_current);
CREATE INDEX idx_cr_status ON correspondence_revisions(correspondence_status_id);
CREATE INDEX idx_cr_created_at ON correspondence_revisions(created_at);
-- 2.10.3 circulation_templates Table
CREATE TABLE circulation_templates (
id INT NOT NULL AUTO_INCREMENT PRIMARY KEY COMMENT 'ID ของแม่แบบ',
template_name VARCHAR(255) NOT NULL COMMENT 'ชื่อแม่แบบ (เช่น "สำหรับเอกสารการเงิน", "สำหรับ Drawing โครงสร้าง")',
organization_id INT NOT NULL COMMENT 'ID ขององค์กรณ์ที่เป็นเจ้าของแม่แบบนี้ (สำคัญมาก)',
description TEXT COMMENT 'คำอธิบายแม่แบบ',
created_at TIMESTAMP NOT NULL DEFAULT CURRENT_TIMESTAMP COMMENT 'วันที่สร้าง',
updated_at TIMESTAMP NOT NULL DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP COMMENT 'วันที่แก้ไขล่าสุด',
-- ป้องกันการสร้างชื่อแม่แบบซ้ำในองค์กรณ์เดียวกัน
UNIQUE KEY ux_circulation_template_name_org (template_name, organization_id),
-- Foreign Key
CONSTRAINT fk_ct_org FOREIGN KEY (organization_id) REFERENCES organizations(id) ON DELETE CASCADE
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_general_ci COMMENT='แม่แบบสำหรับใบเวียนเอกสารภายในองค์กรณ์';
-- 2.11.2 rfa_workflow_templates Table
CREATE TABLE rfa_workflow_templates (
id INT NOT NULL AUTO_INCREMENT PRIMARY KEY COMMENT 'ID ของแม่แบบ',
template_name VARCHAR(255) NOT NULL COMMENT 'ชื่อแม่แบบ',
description TEXT COMMENT 'คำอธิบาย',
project_id INT NULL COMMENT 'ID โครงการ (ถ้าเป็นแม่แบบเฉพาะโครงการ)', -- NULL = แม่แบบทั่วไป
created_at TIMESTAMP NOT NULL DEFAULT CURRENT_TIMESTAMP COMMENT 'วันที่สร้าง',
updated_at TIMESTAMP NOT NULL DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP COMMENT 'วันที่แก้ไขล่าสุด',
-- ป้องกันการสร้างชื่อแม่แบบซ้ำในองค์กรณ์เดียวกัน
UNIQUE KEY ux_workflow_template_name_project (template_name, project_id),
-- Foreign Key
CONSTRAINT fk_rwt_project FOREIGN KEY (project_id) REFERENCES projects(id) ON DELETE CASCADE
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_general_ci COMMENT='แม่แบบ Workflow การอนุมัติเอกสารทางเทคนิค';
-- 2.12.1 correspondence_routing_templates Table:ตารางหลักสำหรับเก็บชื่อแม่แบบการส่งต่อ
CREATE TABLE correspondence_routing_templates (
id INT NOT NULL PRIMARY KEY AUTO_INCREMENT COMMENT 'ID ของแม่แบบ',
template_name VARCHAR(255) NOT NULL COMMENT 'ชื่อแม่แบบ',
description TEXT COMMENT 'คำอธิบาย',
project_id INT NULL COMMENT 'ID โครงการ (ถ้าเป็นแม่แบบเฉพาะโครงการ)', -- NULL = แม่แบบทั่วไป
created_at TIMESTAMP NOT NULL DEFAULT CURRENT_TIMESTAMP COMMENT 'วันที่สร้าง',
updated_at TIMESTAMP NOT NULL DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP COMMENT 'วันที่แก้ไขล่าสุด',
UNIQUE KEY ux_routing_template_name_project (template_name, project_id),
CONSTRAINT fk_crt_project FOREIGN KEY (project_id) REFERENCES projects(id) ON DELETE CASCADE
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_general_ci COMMENT='แม่แบบสายงานการส่งต่อเอกสารขออนุมัติ';
-- ==========================================================
-- ตารางกำหนด "รูปแบบ" เลขที่เอกสาร (Configuration)
-- ==========================================================
CREATE TABLE document_number_formats (
id INT NOT NULL AUTO_INCREMENT PRIMARY KEY,
project_id INT NOT NULL COMMENT 'FK -> projects.id (กำหนดรูปแบบตามโครงการ)',
correspondence_type_id INT NOT NULL COMMENT 'FK -> correspondence_types.id (กำหนดรูปแบบตามประเภทเอกสาร)',
-- Template สำหรับการสร้างเลขที่
-- เช่น "{ORG_CODE}-{TYPE_CODE}-{YEAR_SHORT}-{SEQ:4}"
-- {PROJECT_CODE}, {ORG_CODE}, {TYPE_CODE}, {YEAR_FULL}, {YEAR_SHORT}, {MONTH}, {DAY}, {SEQ:X}
format_template VARCHAR(255) NOT NULL COMMENT 'รูปแบบ Template ของเลขที่เอกสาร',
description TEXT NULL COMMENT 'คำอธิบายรูปแบบนี้',
UNIQUE KEY uk_project_type (project_id, correspondence_type_id),
CONSTRAINT fk_dnf_project FOREIGN KEY (project_id) REFERENCES projects(id) ON DELETE CASCADE,
CONSTRAINT fk_dnf_corr_type FOREIGN KEY (correspondence_type_id) REFERENCES correspondence_types(id) ON DELETE CASCADE
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_general_ci COMMENT='ตารางเก็บ "รูปแบบ" การสร้างเลขที่เอกสาร';
-- ==========================================================
-- ตาราง "ตัวนับ" เลข Running (Counter)
-- ==========================================================
-- ตารางนี้จะเก็บเลขที่ล่าสุด โดยใช้ Key ที่คุณระบุมา
CREATE TABLE document_number_counters (
-- Key หลักตามข้อกำหนด: Project + Org + Type
project_id INT NOT NULL COMMENT 'FK -> projects.id',
originator_organization_id INT NOT NULL COMMENT 'FK -> organizations.id (ตามข้อกำหนด: องค์กรผู้ส่ง)',
correspondence_type_id INT NOT NULL COMMENT 'FK -> correspondence_types.id (ตามข้อกำหนด: ประเภทเอกสาร)',
-- ตัวนับมักจะ Reset รายปี
current_year INT NOT NULL COMMENT 'ปี ค.ศ. ปัจจุบันของตัวนับนี้',
-- ค่าตัวนับล่าสุด
last_number INT NOT NULL DEFAULT 0 COMMENT 'เลขที่ล่าสุดที่ใช้ไปแล้ว',
-- PK ที่สมบูรณ์
PRIMARY KEY (project_id, originator_organization_id, correspondence_type_id, current_year),
CONSTRAINT fk_dnc_project FOREIGN KEY (project_id) REFERENCES projects(id) ON DELETE CASCADE,
CONSTRAINT fk_dnc_org FOREIGN KEY (originator_organization_id) REFERENCES organizations(id) ON DELETE CASCADE,
CONSTRAINT fk_dnc_corr_type FOREIGN KEY (correspondence_type_id) REFERENCES correspondence_types(id) ON DELETE CASCADE
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_general_ci COMMENT='ตาราง "ตัวนับ" เลขที่เอกสาร (Running Number)';
-- เพิ่ม Index สำหรับการค้นหาที่ใช้บ่อย
CREATE INDEX idx_dnc_project_org ON document_number_counters(project_id, originator_organization_id);
CREATE INDEX idx_dnc_type_year ON document_number_counters(correspondence_type_id, current_year);
-- ==========================================================
-- Level 1: ตารางที่มีความสัมพันธ์มากที่สุด (Junction Tables & Detail Tables)
-- ==========================================================
-- 1.1 global_default_roles Table
CREATE TABLE global_default_roles (
id TINYINT NOT NULL DEFAULT 1 COMMENT 'ID คงที่ = 1',
role ENUM('OWNER','DESIGNER','CONSULTANT') NOT NULL COMMENT 'บทบาท',
position TINYINT NOT NULL COMMENT 'ลำดับที่ในบทบาทนั้นๆ (1..n)',
organization_id INT NOT NULL COMMENT 'ID ขององค์กรณ์ที่ถูกกำหนดเป็นค่าเริ่มต้น',
PRIMARY KEY (id, role, position),
UNIQUE KEY ux_gdr_unique_org_per_role (id, role, organization_id),
CONSTRAINT fk_gdr_org FOREIGN KEY (organization_id) REFERENCES organizations(id) ON UPDATE CASCADE ON DELETE RESTRICT
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_general_ci COMMENT='บทบาทเริ่มต้นทั่วโลกสำหรับองค์กรณ์';
-- global default roles seed: OWNER x7, DESIGNER x1, CONSULTANT x1 (from organizations.primary_role)
-- OWNER
INSERT INTO global_default_roles (id, role, position, organization_id)
SELECT 1, 'OWNER', pos, id
FROM (
SELECT id, ROW_NUMBER() OVER (ORDER BY id) AS pos
FROM organizations
-- WHERE primary_role='OWNER'
WHERE role_id = 1
) t
WHERE t.pos BETWEEN 1 AND 7
ON DUPLICATE KEY UPDATE organization_id = VALUES(organization_id);
-- DESIGNER
INSERT INTO global_default_roles (id, role, position, organization_id)
SELECT 1, 'DESIGNER', 1, id
FROM organizations
-- WHERE primary_role='DESIGNER'
WHERE role_id = 2
ORDER BY id
LIMIT 1
ON DUPLICATE KEY UPDATE organization_id = VALUES(organization_id);
-- CONSULTANT
INSERT INTO global_default_roles (id, role, position, organization_id)
SELECT 1, 'CONSULTANT', 1, id
FROM organizations
-- WHERE primary_role='CONSULTANT'
WHERE role_id = 3
ORDER BY id
LIMIT 1
ON DUPLICATE KEY UPDATE organization_id = VALUES(organization_id);
-- 1.2 attachments Table
CREATE TABLE attachments (
id INT NOT NULL AUTO_INCREMENT PRIMARY KEY COMMENT 'ID ของไฟล์แนบ',
-- correspondence_id INT NOT NULL COMMENT 'ID ของเอกสารหลักที่ไฟล์นี้สังกัด',
original_filename VARCHAR(255) NOT NULL COMMENT 'ชื่อไฟล์ดั้งเดิมตอนอัปโหลด',
stored_filename VARCHAR(255) NOT NULL COMMENT 'ชื่อไฟล์ที่ถูกเก็บจริงบน Server (ป้องกันชื่อซ้ำ)',
file_path VARCHAR(500) NOT NULL COMMENT 'ที่อยู่ (Path) ของไฟล์บน Server',
mime_type VARCHAR(100) NOT NULL COMMENT 'ประเภทของไฟล์ (เช่น application/pdf)',
file_size INT NOT NULL COMMENT 'ขนาดไฟล์ (หน่วยเป็น bytes)',
uploaded_by_user_id INT NOT NULL COMMENT 'ID ของผู้ใช้ที่อัปโหลดไฟล์',
created_at TIMESTAMP NOT NULL DEFAULT CURRENT_TIMESTAMP COMMENT 'เวลาที่อัปโหลด',
-- Foreign Keys
-- CONSTRAINT fk_attach_correspondence FOREIGN KEY (correspondence_id) REFERENCES correspondences(id) ON DELETE CASCADE,
CONSTRAINT fk_attach_user FOREIGN KEY (uploaded_by_user_id) REFERENCES users(user_id) ON DELETE CASCADE
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_general_ci COMMENT='ตารางกลางสำหรับเก็บข้อมูลไฟล์แนบ';
-- ==========================================================
-- การปรับปรุงระบบ Attachments (Refactor) V1.1.1
-- เป้าหมาย: ทำให้ตาราง attachments เป็นศูนย์กลาง (central repository)
-- และอนุญาตให้หลาย entity (correspondences, circulations, drawings)
-- สามารถมีไฟล์แนบได้
-- ==========================================================
-- 2. สร้างตารางเชื่อม (Junction Table) สำหรับ Correspondences (N:N)
-- ----------------------------------------------------------
-- (สร้างขึ้นเพื่อแทนที่คอลัมน์ correspondence_id ที่ลบไป)
CREATE TABLE correspondence_attachments (
correspondence_id INT NOT NULL COMMENT 'ID ของเอกสาร (FK -> correspondences)',
attachment_id INT NOT NULL COMMENT 'ID ของไฟล์แนบ (FK -> attachments)',
is_main_document BOOLEAN NOT NULL DEFAULT FALSE COMMENT 'ระบุว่าเป็นไฟล์เอกสารหลักหรือไม่',
PRIMARY KEY (correspondence_id, attachment_id),
CONSTRAINT fk_corr_attach_corr FOREIGN KEY (correspondence_id) REFERENCES correspondences(id) ON DELETE CASCADE,
CONSTRAINT fk_corr_attach_att FOREIGN KEY (attachment_id) REFERENCES attachments(id) ON DELETE CASCADE
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_general_ci COMMENT='ตารางเชื่อมไฟล์แนบของ Correspondence';
-- 3. สร้างตารางเชื่อมใหม่สำหรับ Circulations (N:N)
-- ----------------------------------------------------------
CREATE TABLE circulation_attachments (
circulation_id INT NOT NULL COMMENT 'ID ของใบเวียน (FK -> circulations)',
attachment_id INT NOT NULL COMMENT 'ID ของไฟล์แนบ (FK -> attachments)',
is_main_document BOOLEAN NOT NULL DEFAULT FALSE COMMENT 'ระบุว่าเป็นไฟล์หลักของใบเวียนหรือไม่',
PRIMARY KEY (circulation_id, attachment_id),
CONSTRAINT fk_circ_attach_circ FOREIGN KEY (circulation_id) REFERENCES circulations(id) ON DELETE CASCADE,
CONSTRAINT fk_circ_attach_att FOREIGN KEY (attachment_id) REFERENCES attachments(id) ON DELETE CASCADE
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_general_ci COMMENT='ตารางเชื่อมไฟล์แนบของ Circulation';
-- หมายเหตุ: ตาราง `circulation_action_documents` เดิม ยังคงใช้งานได้ตามปกติ
-- สำหรับการแนบไฟล์ "ระหว่าง" การดำเนินการเวียนเอกสาร
-- 4. สร้างตารางเชื่อมใหม่สำหรับ Shop Drawing Revisions (N:N)
-- ----------------------------------------------------------
CREATE TABLE shop_drawing_revision_attachments (
shop_drawing_revision_id INT NOT NULL COMMENT 'ID ของ Drawing Revision (FK -> shop_drawing_revisions)',
attachment_id INT NOT NULL COMMENT 'ID ของไฟล์แนบ (FK -> attachments)',
file_type ENUM('PDF', 'DWG', 'SOURCE', 'OTHER') NOT NULL DEFAULT 'PDF' COMMENT 'ประเภทของไฟล์ (เช่น PDF, DWG ต้นฉบับ)',
is_main_document BOOLEAN NOT NULL DEFAULT FALSE COMMENT 'ระบุว่าเป็นไฟล์หลักหรือไม่',
PRIMARY KEY (shop_drawing_revision_id, attachment_id),
CONSTRAINT fk_sdr_attach_sdr FOREIGN KEY (shop_drawing_revision_id) REFERENCES shop_drawing_revisions(id) ON DELETE CASCADE,
CONSTRAINT fk_sdr_attach_att FOREIGN KEY (attachment_id) REFERENCES attachments(id) ON DELETE CASCADE
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_general_ci COMMENT='ตารางเชื่อมไฟล์แนบของ Shop Drawing Revision';
CREATE TABLE contract_drawing_attachments (
contract_drawing_id INT NOT NULL COMMENT 'ID ของ Drawing Revision (FK -> contract_drawings)',
attachment_id INT NOT NULL COMMENT 'ID ของไฟล์แนบ (FK -> attachments)',
file_type ENUM('PDF', 'DWG', 'SOURCE', 'OTHER') NOT NULL DEFAULT 'PDF' COMMENT 'ประเภทของไฟล์ (เช่น PDF, DWG ต้นฉบับ)',
is_main_document BOOLEAN NOT NULL DEFAULT FALSE COMMENT 'ระบุว่าเป็นไฟล์หลักหรือไม่',
PRIMARY KEY (contract_drawing_id, attachment_id),
CONSTRAINT fk_cdr_attach_cdr FOREIGN KEY (contract_drawing_id) REFERENCES contract_drawings(id) ON DELETE CASCADE,
CONSTRAINT fk_cdr_attach_att FOREIGN KEY (attachment_id) REFERENCES attachments(id) ON DELETE CASCADE
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_general_ci COMMENT='ตารางเชื่อมไฟล์แนบของ Contract Drawing';
/* ===========================================================
1.3.6 contract_dwg_subcat_cat_map Table:
Mapping: Sub-Category ↔ Category (Many-to-Many ภายในโครงการ)
- บังคับให้อยู่ project เดียวกัน ผ่าน composite FK
- unique: (project_id, sub_cat_id, cat_id)
=========================================================== */
CREATE TABLE contract_drawing_subcat_cat_maps (
project_id INT NOT NULL COMMENT 'ID ของโครงการ',
sub_cat_id INT NOT NULL COMMENT 'ID ของหมวดหมู่ย่อย',
cat_id INT NOT NULL COMMENT 'ID ของหมวดหมู่หลัก',
UNIQUE KEY ux_map_unique (project_id, sub_cat_id, cat_id),
KEY idx_map_project_subcat (project_id, sub_cat_id),
KEY idx_map_project_cat (project_id, cat_id),
CONSTRAINT fk_map_subcat FOREIGN KEY (project_id, sub_cat_id) REFERENCES contract_drawing_subcats(project_id, sub_cat_id) ON UPDATE CASCADE ON DELETE CASCADE,
CONSTRAINT fk_map_cat FOREIGN KEY (project_id, cat_id) REFERENCES contract_drawing_cats(project_id, cat_id) ON UPDATE CASCADE ON DELETE CASCADE
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_general_ci COMMENT='ตารางเชื่อมระหว่างหมวดหมู่ย่อยและหมวดหมู่หลักของแบบสัญญา';
-- 1.4.5 shop_drawing_revisions Table
CREATE TABLE shop_drawing_revisions (
id INT NOT NULL AUTO_INCREMENT PRIMARY KEY COMMENT 'ID ของตาราง',
shop_drawing_id INT NOT NULL COMMENT 'ID ของ Shop Drawing หลัก',
revision_number INT NOT NULL COMMENT 'หมายเลข Revision (สำหรับเรียงลำดับ)',
revision_label VARCHAR(10) NULL COMMENT 'Revision ที่แสดง (เช่น A, B, หรือ 1, 2)',
revision_date DATE NOT NULL COMMENT 'วันที่ของ Revision',
description TEXT COMMENT 'คำอธิบายการแก้ไขใน Revision นี้',
-- file_path VARCHAR(500) NULL COMMENT 'Path ไปยังไฟล์ Drawing ของ Revision นี้ (ถ้ามี)',
created_at TIMESTAMP NOT NULL DEFAULT CURRENT_TIMESTAMP COMMENT 'วันที่สร้าง',
updated_by INT NULL COMMENT 'ผู้แก้ไขล่าสุด';
UNIQUE KEY ux_sd_rev_drawing_revision (shop_drawing_id, revision_number),
CONSTRAINT fk_sdr_shop_drawing FOREIGN KEY (shop_drawing_id) REFERENCES shop_drawings(id) ON DELETE CASCADE
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_general_ci COMMENT='ตารางสำหรับเก็บ Revision ของ Shop Drawing';
CREATE INDEX idx_sdr_shop_drawing ON shop_drawing_revisions(id);
-- สร้างตารางเชื่อมระหว่าง shop_drawing_revisions (ตารางลูก) กับ contract_drawings (Master)
-- เพื่อรองรับ Requirement 2.5.3 ที่ระบุว่า Shop Drawing "แต่ละ revision" สามารถอ้างอิง Contract Drawing ที่แตกต่างกันได้
-- 1.5.5 hop_drawing_revision_contract_refs Table
CREATE TABLE shop_drawing_revision_contract_refs (
shop_drawing_revision_id INT NOT NULL COMMENT 'ID ของ Shop Drawing Revision (FK -> shop_drawing_revisions.id)',
contract_drawing_id INT NOT NULL COMMENT 'ID ของ Contract Drawing ที่อ้างอิง (FK -> contract_drawings.condwg_id)',
-- PRIMARY KEY (shop_drawing_revision_id, contract_drawing_id),
-- เพิ่ม KEY เพื่อประสิทธิภาพในการค้นหา
KEY idx_sdrcr_rev (shop_drawing_revision_id),
KEY idx_sdrcr_cd (contract_drawing_id),
-- Foreign Keys
-- เชื่อมโยงกับตาราง Revision
CONSTRAINT fk_sdrcr_revision FOREIGN KEY (shop_drawing_revision_id) REFERENCES shop_drawing_revisions(id) ON DELETE CASCADE ON UPDATE CASCADE,
CONSTRAINT fk_sdrcr_contract_drawing FOREIGN KEY (contract_drawing_id) REFERENCES contract_drawings(id) ON DELETE CASCADE ON UPDATE CASCADE
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_general_ci COMMENT='ตารางเชื่อมระหว่าง Shop Drawing Revisions กับ Contract Drawings';
-- 1.6.4 transmittal_items Table
CREATE TABLE transmittal_items (
id INT NOT NULL AUTO_INCREMENT PRIMARY KEY COMMENT 'ID ของรายการ',
transmittal_id INT NOT NULL COMMENT 'ID ของ Transmittal (จากตาราง transmittals)',
item_correspondence_id INT NOT NULL COMMENT 'ID ของเอกสารที่แนบไป (FK -> correspondences.id)',
quantity INT NOT NULL DEFAULT 1 COMMENT 'จำนวน',
remarks VARCHAR(255) COMMENT 'หมายเหตุสำหรับรายการนี้',
-- ป้องกันการเพิ่มเอกสารเดิมซ้ำใน Transmittal ฉบับเดียวกัน
UNIQUE KEY ux_transmittal_item (transmittal_id, item_correspondence_id),
-- Foreign Keys
CONSTRAINT fk_ti_transmittal FOREIGN KEY (transmittal_id) REFERENCES transmittals(correspondence_id) ON DELETE CASCADE,
CONSTRAINT fk_ti_item_correspondence FOREIGN KEY (item_correspondence_id) REFERENCES correspondences(id) ON DELETE CASCADE
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_general_ci COMMENT='รายการเอกสารที่ถูกส่งใน Transmittal แต่ละฉบับ';
-- 1.7.3 circulation_status_transitions Table
CREATE TABLE circulation_status_transitions(
from_status_code VARCHAR(20) NOT NULL COMMENT 'รหัสสถานะต้นทาง',
to_status_code VARCHAR(20) NOT NULL COMMENT 'รหัสสถานะปลายทาง',
PRIMARY KEY (from_status_code, to_status_code),
CONSTRAINT fk_cstt_from FOREIGN KEY (from_status_code) REFERENCES circulation_status_codes(code),
CONSTRAINT fk_cstt_to FOREIGN KEY (to_status_code) REFERENCES circulation_status_codes(code)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_general_ci COMMENT='ตารางสถานะที่อนุญาตให้เปลี่ยนแปลงได้ในใบเวียนเอกสาร';
-- 1.8.3 circulation_template_assignees Table
CREATE TABLE circulation_template_assignees (
id INT NOT NULL AUTO_INCREMENT PRIMARY KEY COMMENT 'ID ของรายการ',
template_id INT NOT NULL COMMENT 'ID ของแม่แบบ',
user_id INT NOT NULL COMMENT 'ID ของผู้ใช้ที่ถูกกำหนดไว้',
assignee_type ENUM('MAIN', 'ACTION', 'INFO') NOT NULL COMMENT 'บทบาทของผู้ใช้ในแม่แบบนี้',
-- ป้องกันการกำหนด User คนเดิมในบทบาทเดิมซ้ำในแม่แบบเดียวกัน
UNIQUE KEY ux_cta_template_user_type (template_id, user_id, assignee_type),
-- Foreign Keys
CONSTRAINT fk_cta_template FOREIGN KEY (template_id) REFERENCES circulation_templates(id) ON DELETE CASCADE,
CONSTRAINT fk_cta_user FOREIGN KEY (user_id) REFERENCES users(user_id) ON DELETE CASCADE
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_general_ci COMMENT='รายชื่อผู้รับผิดชอบในแม่แบบใบเวียน';
-- 1.9.3 circulation_assignees Table
CREATE TABLE circulation_assignees (
id INT NOT NULL AUTO_INCREMENT PRIMARY KEY COMMENT 'ID ของผู้รับผิดชอบ',
circulation_id INT NOT NULL COMMENT 'ID ของใบเวียน (จากตาราง circulations)',
user_id INT NOT NULL COMMENT 'ID ของผู้ใช้ที่รับผิดชอบ',
assignee_type ENUM('MAIN', 'ACTION', 'INFO') NOT NULL COMMENT 'ประเภทผู้รับผิดชอบ (Main, Action, Info)',
deadline DATE NULL COMMENT 'กำหนดวันแล้วเสร็จ (สำหรับ Main/Action)',
action_taken TEXT NULL COMMENT 'หมายเหตุการดำเนินการ',
is_completed BOOLEAN NOT NULL DEFAULT FALSE COMMENT 'สถานะการดำเนินการ (1=เสร็จสิ้น,0=ยังไม่เสร็จ)',
completed_at DATE NULL COMMENT 'เวลาที่ดำเนินการเสร็จสิ้น',
UNIQUE KEY ux_cir_assignee (circulation_id, user_id, assignee_type),
-- Foreign Keys
CONSTRAINT fk_ca_assignee_circulation FOREIGN KEY (circulation_id) REFERENCES circulations(id) ON DELETE CASCADE,
CONSTRAINT fk_ca_user FOREIGN KEY (user_id) REFERENCES users(user_id) ON DELETE CASCADE
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_general_ci COMMENT='ผู้รับผิดชอบในใบเวียนเอกสาร';
-- 1.10.3 cir_recipients Table
CREATE TABLE circulation_recipients (
id INT NOT NULL AUTO_INCREMENT PRIMARY KEY COMMENT 'ID ของรายการ',
circulation_id INT NOT NULL COMMENT 'ID ของใบเวียน (จากตาราง circulations)',
user_id INT NOT NULL COMMENT 'ID ของผู้ใช้ที่เป็นผู้รับ',
recipient_role ENUM('TO', 'CC') NOT NULL DEFAULT 'TO' COMMENT 'บทบาทของผู้รับ (ถึง, สำเนาถึง)',
read_status BOOLEAN NOT NULL DEFAULT FALSE COMMENT 'สถานะการเปิดอ่าน',
read_at TIMESTAMP NULL COMMENT 'เวลาที่เปิดอ่าน',
UNIQUE KEY ux_cir_recipient (circulation_id, user_id, recipient_role),
-- Foreign Keys
CONSTRAINT fk_cir_recipients_circulation FOREIGN KEY (circulation_id) REFERENCES circulations(id) ON DELETE CASCADE,
CONSTRAINT fk_cir_recipients_user FOREIGN KEY (user_id) REFERENCES users(user_id) ON DELETE CASCADE
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_general_ci COMMENT='รายชื่อผู้รับในใบเวียนเอกสาร';
-- 1.11.3 circulation_actions Table
CREATE TABLE circulation_actions (
id INT NOT NULL AUTO_INCREMENT PRIMARY KEY COMMENT 'ID ของการกระทำ',
circulation_id INT NOT NULL COMMENT 'ID ของใบเวียน',
action_by_user_id INT NOT NULL COMMENT 'ID ของผู้ใช้ที่ดำเนินการ',
action_type ENUM('COMMENT', 'FORWARD', 'CLOSE', 'REOPEN') NOT NULL COMMENT 'ประเภทของการกระทำ',
comments TEXT COMMENT 'ความคิดเห็นหรือหมายเหตุประกอบ',
created_at TIMESTAMP NOT NULL DEFAULT CURRENT_TIMESTAMP COMMENT 'เวลาที่ดำเนินการ',
-- Foreign Keys
CONSTRAINT fk_cir_actions_circulation FOREIGN KEY (circulation_id) REFERENCES circulations(id) ON DELETE CASCADE,
CONSTRAINT fk_cir_actions_user FOREIGN KEY (action_by_user_id) REFERENCES users(user_id) ON DELETE CASCADE
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_general_ci COMMENT='ประวัติการดำเนินการในใบเวียนเอกสาร';
-- 1.12.3 cir_action_documents Table
CREATE TABLE circulation_action_documents (
action_id INT NOT NULL COMMENT 'ID ของการกระทำ (จากตาราง cir_actions)',
attachment_id INT NOT NULL COMMENT 'ID ของไฟล์แนบ (จากตาราง attachments)',
PRIMARY KEY (action_id, attachment_id), -- ป้องกันการเชื่อมซ้ำ
-- Foreign Keys
CONSTRAINT fk_cad_action FOREIGN KEY (action_id) REFERENCES circulation_actions(id) ON DELETE CASCADE,
CONSTRAINT fk_cad_attachment FOREIGN KEY (attachment_id) REFERENCES attachments(id) ON DELETE CASCADE
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_general_ci COMMENT='ไฟล์แนบกับการดำเนินการในใบเวียน';
-- 1.13.2 rfa_items Table: rfa_revisions -> rfas.rfa_types.code= 'DWG'
CREATE TABLE rfa_items (
rfarev_correspondence_id INT NOT NULL COMMENT 'ID ของ rfa revison', -- FK to rfa_revisions.correspondence_id rfa.id where rfa_revisions -> rfas.rfa_types.code= 'DWG'
shop_drawing_revision_id INT NOT NULL UNIQUE COMMENT 'ID ของ shop drawing revison', -- one rfa revision appears in at most one RFA
PRIMARY KEY (rfarev_correspondence_id, shop_drawing_revision_id),
CONSTRAINT fk_rfaitm_corr FOREIGN KEY (rfarev_correspondence_id) REFERENCES rfa_revisions(correspondence_id) ON UPDATE CASCADE ON DELETE CASCADE,
CONSTRAINT fk_rfaitm_shop FOREIGN KEY (shop_drawing_revision_id) REFERENCES shop_drawing_revisions(id) ON UPDATE CASCADE ON DELETE CASCADE
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_general_ci COMMENT 'เก็บ shop drawings ใน rfa แต่ละ revision';
CREATE INDEX idx_rfaitems_corr ON rfa_items(rfarev_correspondence_id);
CREATE INDEX idx_rfaitems_shop ON rfa_items(shop_drawing_revision_id);
-- 1.14.2 rfa_status_transitions Table
CREATE TABLE rfa_status_transitions(
type_id INT NOT NULL COMMENT 'ID ของประเภทเอกสารขออนุมัติ',
from_status_id INT NOT NULL COMMENT 'ID ของสถานะต้นทาง',
to_status_id INT NOT NULL COMMENT 'ID ของสถานะปลายทาง',
PRIMARY KEY (type_id, from_status_id, to_status_id),
CONSTRAINT fk_rst_type FOREIGN KEY (type_id) REFERENCES rfa_types(id),
CONSTRAINT fk_rst_from FOREIGN KEY (from_status_id) REFERENCES rfa_status_codes(id),
CONSTRAINT fk_rst_to FOREIGN KEY (to_status_id) REFERENCES rfa_status_codes(id)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_general_ci COMMENT='ตารางสถานะที่อนุญาตให้เปลี่ยนแปลงได้ตามประเภทเอกสารขออนุมัติ';
-- 1.15.2 rfa_workflow_template_steps Table: ตารางสำหรับเก็บขั้นตอนของแต่ละแม่แบบ
CREATE TABLE rfa_workflow_template_steps (
id INT NOT NULL AUTO_INCREMENT PRIMARY KEY COMMENT 'ID ของขั้นตอน',
template_id INT NOT NULL COMMENT 'ID ของแม่แบบ',
sequence INT NOT NULL COMMENT 'ลำดับขั้นตอน',
organization_id INT NOT NULL COMMENT 'ID องค์กรณ์ที่ต้องพิจารณาในขั้นตอนนี้',
step_purpose ENUM('FOR_APPROVAL', 'FOR_REVIEW', 'FOR_INFORMATION') NOT NULL DEFAULT 'FOR_APPROVAL' COMMENT 'วัตถุประสงค์ของขั้นตอนนี้ เช่น เพื่ออนุมัติ, เพื่อตรวจสอบ, หรือเพื่อรับทราบ',
UNIQUE KEY ux_rfa_template_sequence (template_id, sequence),
CONSTRAINT fk_rwts_template FOREIGN KEY (template_id) REFERENCES rfa_workflow_templates(id) ON DELETE CASCADE,
CONSTRAINT fk_rwts_org FOREIGN KEY (organization_id) REFERENCES organizations(id) ON DELETE CASCADE
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_general_ci COMMENT='ขั้นตอนในแม่แบบ Workflow การอนุมัติ RFA';
-- 1.16.2 rfa_workflows Table: ตารางสำหรับติดตามสถานะ Workflow ของเอกสาร Technical (RFA)
CREATE TABLE rfa_workflows (
id INT NOT NULL AUTO_INCREMENT PRIMARY KEY COMMENT 'ID ของ Workflow',
correspondence_id INT NOT NULL COMMENT 'ID ของเอกสาร (FK -> rfa_revisions)',
template_id INT NULL COMMENT 'ID ของแม่แบบที่ใช้ (ถ้ามี)', -- สำหรับอ้างอิงถึงแม่แบบ
sequence INT NOT NULL COMMENT 'ลำดับขั้นตอน',
from_organization_id INT NOT NULL COMMENT 'ID ขององค์กรณ์ผู้ส่ง',
to_organization_id INT NOT NULL COMMENT 'ID ขององค์กรณ์ผู้รับ',
step_purpose ENUM('FOR_APPROVAL', 'FOR_REVIEW', 'FOR_INFORMATION', 'FOR_ACTION') NOT NULL DEFAULT 'FOR_REVIEW' COMMENT 'วัตถุประสงค์ของขั้นตอนนี้ เช่น เพื่ออนุมัติ, เพื่อตรวจสอบ, หรือเพื่อรับทราบ',
status ENUM('PENDING', 'APPROVED', 'APPROVED_WITH_COMMENTS', 'RESUBMIT', 'REJECTED', 'FORWARDED', 'RETURNED') NOT NULL DEFAULT 'PENDING' COMMENT 'สถานะของขั้นตอนนี้',
comments TEXT NULL COMMENT 'ความคิดเห็นหรือหมายเหตุจากองค์กร',
due_date DATETIME NULL COMMENT 'วันที่ต้องตอบเอกสารในขั้นตอนนี้',
processed_by_user_id INT NULL COMMENT 'ID ของผู้ใช้ที่ดำเนินการในขั้นตอนนี้',
processed_at TIMESTAMP NULL COMMENT 'เวลาที่ดำเนินการในขั้นตอนนี้',
created_at TIMESTAMP NOT NULL DEFAULT CURRENT_TIMESTAMP COMMENT 'วันที่สร้าง',
UNIQUE KEY ux_workflow_corr_sequence (correspondence_id, sequence),
-- Foreign Keys
CONSTRAINT fk_rfw_rfa_revision FOREIGN KEY (correspondence_id) REFERENCES rfa_revisions(correspondence_id) ON DELETE CASCADE,
CONSTRAINT fk_rfw_template FOREIGN KEY (template_id) REFERENCES rfa_workflow_templates(id) ON DELETE SET NULL,
CONSTRAINT fk_rfw_from_org FOREIGN KEY (from_organization_id) REFERENCES organizations(id),
CONSTRAINT fk_rfw_to_org FOREIGN KEY (to_organization_id) REFERENCES organizations(id),
CONSTRAINT fk_rfw_processed_by_user FOREIGN KEY (processed_by_user_id) REFERENCES users(user_id) ON DELETE SET NULL
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_general_ci COMMENT='ตารางติดตามสถานะ Workflow การอนุมัติเอกสารทางเทคนิค';
-- 1.17.1 correspondence_status_transitions Table: เพิ่ม “ตาราง/วิว Allowed Status Transition” เพื่อตรวจ business rule บน
-- sp_correspondence_update_status (ยังทำแบบ soft rule ใน proc)
-- NEW: table of allowed transitions (per type)
CREATE TABLE correspondence_status_transitions(
type_id INT NOT NULL COMMENT 'ID ของประเภทหนังสือ',
from_status_id INT NOT NULL COMMENT 'ID ของสถานะต้นทาง',
to_status_id INT NOT NULL COMMENT 'ID ของสถานะปลายทาง',
PRIMARY KEY (type_id, from_status_id, to_status_id),
CONSTRAINT fk_cst_type FOREIGN KEY (type_id) REFERENCES correspondence_types(id),
CONSTRAINT fk_cst_from FOREIGN KEY (from_status_id) REFERENCES correspondence_status(id),
CONSTRAINT fk_cst_to FOREIGN KEY (to_status_id) REFERENCES correspondence_status(id)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_general_ci COMMENT='ตารางสถานะที่อนุญาตให้เปลี่ยนแปลงได้ตามประเภทหนังสือ';
-- 1.18.1 correspondence_routing_template_steps Table
CREATE TABLE correspondence_routing_template_steps (
id INT NOT NULL AUTO_INCREMENT PRIMARY KEY COMMENT 'ID ของขั้นตอน',
template_id INT NOT NULL COMMENT 'ID ของแม่แบบ',
sequence INT NOT NULL COMMENT 'ลำดับขั้นตอน',
to_organization_id INT NOT NULL COMMENT 'ID องค์กรณ์ผู้รับในขั้นตอนนี้',
step_purpose ENUM('FOR_APPROVAL', 'FOR_REVIEW', 'FOR_INFORMATION') NOT NULL DEFAULT 'FOR_REVIEW' COMMENT 'วัตถุประสงค์ของขั้นตอนนี้',
UNIQUE KEY ux_cor_template_sequence (template_id, sequence),
CONSTRAINT fk_cwts_template FOREIGN KEY (template_id) REFERENCES correspondence_routing_templates(id) ON DELETE CASCADE,
CONSTRAINT fk_cwts_org FOREIGN KEY (to_organization_id) REFERENCES organizations(id) ON DELETE CASCADE
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_general_ci COMMENT='ขั้นตอนในแม่แบบ Workflow การส่งต่อเอกสาร';
-- 1.19.1 correspondence_routing_steps Table
CREATE TABLE correspondence_routings (
id INT NOT NULL AUTO_INCREMENT PRIMARY KEY COMMENT 'ID ของขั้นตอน',
correspondence_id INT NOT NULL COMMENT 'ID ของเอกสาร(FK -> correspondence_revisions)',
template_id INT NULL COMMENT 'ID ของแม่แบบที่ใช้ (ถ้ามี)', -- สำหรับอ้างอิงถึงแม่แบบ
sequence INT NOT NULL COMMENT 'ลำดับของขั้นตอนการส่งต่อ',
from_organization_id INT NOT NULL COMMENT 'ID ขององค์กรณ์ผู้ส่ง',
to_organization_id INT NOT NULL COMMENT 'ID ขององค์กรณ์ผู้รับ',
step_purpose ENUM('FOR_APPROVAL', 'FOR_REVIEW', 'FOR_INFORMATION', 'FOR_ACTION') NOT NULL DEFAULT 'FOR_REVIEW' COMMENT 'วัตถุประสงค์ของขั้นตอนนี้ เช่น เพื่ออนุมัติ, เพื่อตรวจสอบ, หรือเพื่อรับทราบ',
status ENUM('SENT', 'RECEIVED', 'ACTIONED', 'FORWARDED', 'REPLIED') NOT NULL DEFAULT 'SENT' COMMENT 'สถานะการดำเนินการของเอกสารในขั้นตอนนี้',
comments TEXT COMMENT 'หมายเหตุ หรือความคิดเห็นในการส่งต่อ',
due_date DATETIME NULL COMMENT 'วันที่ต้องตอบเอกสารในขั้นตอนนี้',
processed_by_user_id INT NULL COMMENT 'ID ของผู้ใช้ที่ดำเนินการในขั้นตอนนี้',
processed_at TIMESTAMP NULL COMMENT 'เวลาที่ดำเนินการ',
created_at TIMESTAMP NOT NULL DEFAULT CURRENT_TIMESTAMP COMMENT 'เวลาที่สร้างขั้นตอนนี้',
UNIQUE KEY ux_cor_routing_sequence (correspondence_id, sequence),
-- Foreign Keys
CONSTRAINT fk_crs_correspondence FOREIGN KEY (correspondence_id) REFERENCES correspondence_revisions(correspondence_id) ON DELETE CASCADE,
CONSTRAINT fk_crs_template FOREIGN KEY (template_id) REFERENCES correspondence_routing_templates(id) ON DELETE SET NULL,
CONSTRAINT fk_crs_from_org FOREIGN KEY (from_organization_id) REFERENCES organizations(id) ON DELETE CASCADE,
CONSTRAINT fk_crs_to_org FOREIGN KEY (to_organization_id) REFERENCES organizations(id) ON DELETE CASCADE,
CONSTRAINT fk_crs_processed_by_user FOREIGN KEY (processed_by_user_id) REFERENCES users(user_id) ON DELETE SET NULL
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_general_ci COMMENT='ตารางติดตาม Workflow การส่งต่อเอกสารทั่วไป';
-- เพิ่ม Index สำหรับคอลัมน์ due_date
CREATE INDEX idx_cr_due_date ON correspondence_revisions(due_date);
-- 1.20.1 Create a new, unified recipients table
CREATE TABLE correspondence_recipients (
correspondence_id INT NOT NULL COMMENT 'ID ของเอกสาร (FK -> correspondences)',
recipient_organization_id INT NOT NULL COMMENT 'ID ขององค์กรณ์ผู้รับ (FK -> organizations)',
recipient_type ENUM('TO', 'CC') NOT NULL COMMENT 'ประเภทผู้รับ (To=หลัก, CC=สำเนา)',
PRIMARY KEY (correspondence_id, recipient_organization_id, recipient_type),
KEY idx_cr_corr (correspondence_id),
KEY idx_cr_org (recipient_organization_id),
CONSTRAINT fk_crrc_correspondence FOREIGN KEY (correspondence_id) REFERENCES correspondence_revisions(correspondence_id) ON DELETE CASCADE ON UPDATE CASCADE,
CONSTRAINT fk_crrc_organization FOREIGN KEY (recipient_organization_id) REFERENCES organizations(id) ON DELETE RESTRICT ON UPDATE CASCADE
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_general_ci COMMENT='ตารางเชื่อมผู้รับเอกสาร (รองรับ To/CC หลายองค์กรณ์)';
-- 1.21.1 correspondence_references Table
CREATE TABLE correspondence_references (
src_correspondence_id INT NOT NULL COMMENT 'Source correspondence ID',
tgt_correspondence_id INT NOT NULL COMMENT 'Target correspondence ID',
PRIMARY KEY (src_correspondence_id, tgt_correspondence_id),
CONSTRAINT fk_ref_src FOREIGN KEY (src_correspondence_id) REFERENCES correspondences(id) ON DELETE CASCADE ON UPDATE CASCADE,
CONSTRAINT fk_ref_tgt FOREIGN KEY (tgt_correspondence_id) REFERENCES correspondences(id) ON UPDATE CASCADE
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_general_ci COMMENT='ตารางเชื่อมโยงความสัมพันธ์ระหว่างหนังสือ';
-- 1.22 project_parties Table: enforce <=1 contractor per project via generated column + unique index
CREATE TABLE project_parties (
project_id INT NOT NULL COMMENT 'ID ของโครงการ',
organization_id INT NOT NULL COMMENT 'ID ขององค์กรณ์',
role ENUM('OWNER','DESIGNER','CONSULTANT','CONTRACTOR','THIRD_PARTY') NOT NULL COMMENT 'บทบาทขององค์กรณ์ในโครงการ',
is_contractor TINYINT(1) GENERATED ALWAYS AS (IF(role = 'CONTRACTOR', 1, NULL)) STORED COMMENT 'คอลัมน์สร้างเพื่อบังคับ unique contractor ต่อโครงการ',
created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP NOT NULL COMMENT 'วันที่สร้าง',
created_by INT NULL COMMENT 'ผู้สร้าง',
updated_by INT NULL COMMENT 'ผู้แก้ไขล่าสุด',
deleted_at DATETIME NULL COMMENT 'วันที่ลบ (สำหรับ soft delete)',
PRIMARY KEY (project_id, organization_id, role),
UNIQUE KEY uq_project_parties_contractor (project_id, is_contractor),
CONSTRAINT fk_pp_project FOREIGN KEY (project_id) REFERENCES projects(id) ON DELETE CASCADE ON UPDATE CASCADE,
CONSTRAINT fk_pp_org FOREIGN KEY (organization_id) REFERENCES organizations(id) ON DELETE RESTRICT ON UPDATE CASCADE
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_general_ci COMMENT='ตารางเชื่อมระหว่างโครงการและองค์กรณ์ที่มีบทบาทต่างๆ';
INSERT INTO project_parties (`project_id`, `organization_id`, `role`) VALUES
-- 1 LCBP3
('1', '1', 'OWNER'), ('1', '10', 'OWNER'), ('1', '11', 'OWNER'), ('1', '12', 'OWNER'), ('1', '13', 'OWNER'), ('1', '14', 'OWNER'), ('1', '15', 'OWNER'), ('1', '16', 'OWNER'), ('1', '17', 'OWNER'), ('1', '18', 'OWNER'), ('1', '21', 'DESIGNER'), ('1', '22', 'CONSULTANT'),
-- 2-5 LCBP3 C1-C4
('2', '1', 'OWNER'), ('2', '10', 'OWNER'), ('2', '11', 'OWNER'), ('2', '12', 'OWNER'), ('2', '13', 'OWNER'), ('2', '14', 'OWNER'), ('2', '15', 'OWNER'), ('2', '16', 'OWNER'), ('2', '17', 'OWNER'), ('2', '18', 'OWNER'), ('2', '21', 'DESIGNER'), ('2', '22', 'CONSULTANT'),
('3', '1', 'OWNER'), ('3', '10', 'OWNER'), ('3', '11', 'OWNER'), ('3', '12', 'OWNER'), ('3', '13', 'OWNER'), ('3', '14', 'OWNER'), ('3', '15', 'OWNER'), ('3', '16', 'OWNER'), ('3', '17', 'OWNER'), ('3', '18', 'OWNER'), ('3', '21', 'DESIGNER'), ('3', '22', 'CONSULTANT'),
('4', '1', 'OWNER'), ('4', '10', 'OWNER'), ('4', '11', 'OWNER'), ('4', '12', 'OWNER'), ('4', '13', 'OWNER'), ('4', '14', 'OWNER'), ('4', '15', 'OWNER'), ('4', '16', 'OWNER'), ('4', '17', 'OWNER'), ('4', '18', 'OWNER'), ('4', '21', 'DESIGNER'), ('4', '22', 'CONSULTANT'),
('5', '1', 'OWNER'), ('5', '10', 'OWNER'), ('5', '11', 'OWNER'), ('5', '12', 'OWNER'), ('5', '13', 'OWNER'), ('5', '14', 'OWNER'), ('5', '15', 'OWNER'), ('5', '16', 'OWNER'), ('5', '17', 'OWNER'), ('5', '18', 'OWNER'), ('5', '21', 'DESIGNER'), ('5', '22', 'CONSULTANT')
;
-- 1.23 contract_parties Table: Links contracts, projects, and organizations together.
CREATE TABLE contract_parties (
contract_id INT NOT NULL COMMENT 'ID ของสัญญา',
project_id INT NOT NULL COMMENT 'ID ของโครงการ',
organization_id INT NOT NULL COMMENT 'ID ขององค์กรณ์',
PRIMARY KEY (contract_id, project_id, organization_id),
CONSTRAINT fk_cp_contract FOREIGN KEY (contract_id) REFERENCES contracts(id) ON DELETE CASCADE ON UPDATE CASCADE,
CONSTRAINT fk_cp_project FOREIGN KEY (project_id) REFERENCES projects(id) ON DELETE CASCADE ON UPDATE CASCADE,
CONSTRAINT fk_cp_org FOREIGN KEY (organization_id) REFERENCES organizations(id) ON DELETE CASCADE ON UPDATE CASCADE
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_general_ci COMMENT='ตารางเชื่อมระหว่างสัญญา โครงการ และองค์กรณ์ที่เกี่ยวข้อง';
INSERT INTO contract_parties (organization_id, project_id, contract_id) VALUES
(1, 1, 1), (1, 1, 2), (1, 1, 7), (1, 2, 1), (1, 2, 2), (1, 2, 7), (1, 2, 3), (1, 3, 1), (1, 3, 2),
(1, 3, 7), (1, 3, 4), (1, 4, 1), (1, 4, 2), (1, 4, 7), (1, 4, 5), (1, 5, 1), (1, 5, 2), (1, 5, 7),
(1, 5, 6), (10, 1, 1), (10, 1, 2), (10, 1, 7), (10, 2, 1), (10, 2, 2), (10, 2, 7), (10, 2, 3), (10, 3, 1),
(10, 3, 2), (10, 3, 7), (10, 3, 4), (10, 4, 1), (10, 4, 2), (10, 4, 7), (10, 4, 5), (10, 5, 1), (10, 5, 2),
(10, 5, 7), (10, 5, 6), (11, 1, 2), (11, 2, 2), (11, 3, 2), (11, 4, 2), (11, 5, 2), (12, 2, 3), (13, 3, 4),
(14, 1, 7), (14, 2, 7), (14, 2, 3), (14, 3, 7), (14, 3, 4), (14, 4, 7), (14, 4, 5), (14, 5, 7), (14, 5, 6),
(15, 2, 3), (15, 3, 4), (15, 4, 5), (15, 5, 6), (16, 4, 5), (17, 5, 6), (18, 1, 1), (18, 2, 1), (18, 2, 3),
(18, 3, 1), (18, 3, 4), (18, 4, 1), (18, 4, 5), (18, 5, 1), (18, 5, 6), (21, 1, 1), (21, 2, 1), (21, 2, 3),
(21, 3, 1), (21, 3, 4), (21, 4, 1), (21, 4, 5), (21, 5, 1), (21, 5, 6), (22, 1, 2), (22, 2, 2), (22, 2, 3),
(22, 3, 2), (22, 3, 4), (22, 4, 2), (22, 4, 5), (22, 5, 2), (22, 5, 6), (31, 1, 7), (31, 2, 7), (31, 2, 3),
(31, 3, 7), (31, 3, 4), (31, 4, 7), (31, 4, 5), (31, 5, 7), (31, 5, 6), (32, 2, 3), (32, 3, 4), (32, 4, 5),
(32, 5, 6), (41, 2, 3), (42, 3, 4), (43, 4, 5), (44, 5, 6);
-- 1.24 role_permissions Table: Role Permissions Junction Table (RBAC) - For global/system-level roles
CREATE TABLE role_permissions (
role_id INT NOT NULL COMMENT 'ID ของบทบาท',
permission_id INT NOT NULL COMMENT 'ID ของสิทธิ์',
PRIMARY KEY (role_id, permission_id),
CONSTRAINT fk_rp_role FOREIGN KEY (role_id) REFERENCES roles(role_id) ON UPDATE CASCADE ON DELETE CASCADE,
CONSTRAINT fk_rp_perm FOREIGN KEY (permission_id) REFERENCES permissions(permission_id) ON UPDATE CASCADE ON DELETE CASCADE
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_general_ci COMMENT='ตารางเชื่อมระหว่างบทบาทและสิทธิ์ (RBAC)';
-- ==========================================================
-- 3. Seed Role-Permissions Mapping (จับคู่สิทธิ์เริ่มต้น)
-- ==========================================================
TRUNCATE TABLE role_permissions;
-- ---------------------------------
-- 3.1 SUPER_ADMIN (สิทธิ์ทั้งหมด)
-- ---------------------------------
INSERT IGNORE INTO role_permissions (role_id, permission_id)
SELECT r.role_id, p.permission_id
FROM roles r
CROSS JOIN permissions p
WHERE r.role_code = 'SUPER_ADMIN';
-- ---------------------------------
-- 3.2 ADMIN (สิทธิ์จัดการองค์กร)
-- ---------------------------------
INSERT IGNORE INTO role_permissions (role_id, permission_id)
SELECT r.role_id, p.permission_id
FROM roles r
JOIN permissions p ON p.permission_code IN (
-- System
'system.admin_panel', 'system.view_audit_logs', 'system.view_reports',
-- Admin Actions
'admin.manage_users', 'admin.manage_roles', 'admin.manage_master_data', 'admin.manage_numbering',
-- Project
'project.view', 'project.manage', 'project.manage_parties',
-- Correspondence
'corr.view', 'corr.view_all', 'corr.create', 'corr.submit', 'corr.manage_submitted', 'corr.manage_attachments',
-- RFA
'rfa.view', 'rfa.view_all', 'rfa.create', 'rfa.submit', 'rfa.respond', 'rfa.override_workflow', 'rfa.delete',
-- Drawing
'drawing.contract.view', 'drawing.contract.manage', 'drawing.shop.view', 'drawing.shop.manage',
-- Transmittal
'transmittal.view', 'transmittal.create',
-- Circulation
'circulation.view', 'circulation.create', 'circulation.respond', 'circulation.close', 'circulation.manage_templates'
)
WHERE r.role_code = 'ADMIN';
-- ---------------------------------
-- 3.3 DOC_CONTROL (สิทธิ์จัดการเอกสาร)
-- ---------------------------------
INSERT IGNORE INTO role_permissions (role_id, permission_id)
SELECT r.role_id, p.permission_id
FROM roles r
JOIN permissions p ON p.permission_code IN (
-- System
'system.view_reports',
-- Project
'project.view',
-- Correspondence
'corr.view', 'corr.create', 'corr.submit', 'corr.manage_attachments',
-- RFA
'rfa.view', 'rfa.create', 'rfa.submit', 'rfa.respond', 'rfa.delete',
-- Drawing
'drawing.contract.view', 'drawing.contract.manage', 'drawing.shop.view', 'drawing.shop.manage',
-- Transmittal
'transmittal.view', 'transmittal.create',
-- Circulation
'circulation.view', 'circulation.create', 'circulation.respond', 'circulation.close', 'circulation.manage_templates'
)
WHERE r.role_code = 'DOC_CONTROL';
-- ---------------------------------
-- 3.4 EDITOR (สิทธิ์สร้าง/แก้ไข)
-- ---------------------------------
INSERT IGNORE INTO role_permissions (role_id, permission_id)
SELECT r.role_id, p.permission_id
FROM roles r
JOIN permissions p ON p.permission_code IN (
-- System
'system.view_reports',
-- Project
'project.view',
-- Correspondence
'corr.view', 'corr.create', 'corr.submit', 'corr.manage_attachments',
-- RFA
'rfa.view', 'rfa.create', 'rfa.submit', 'rfa.respond', 'rfa.delete',
-- Drawing
'drawing.shop.view',
-- Transmittal
'transmittal.view', 'transmittal.create',
-- Circulation
'circulation.view', 'circulation.create', 'circulation.respond', 'circulation.close'
-- Editor ไม่สามารถจัดการ Drawing หรือ Template ได้
)
WHERE r.role_code = 'EDITOR';
-- ---------------------------------
-- 3.5 VIEWER (สิทธิ์อ่านอย่างเดียว)
-- ---------------------------------
INSERT IGNORE INTO role_permissions (role_id, permission_id)
SELECT r.role_id, p.permission_id
FROM roles r
JOIN permissions p ON p.permission_code IN (
-- System
'system.view_reports',
-- Project
'project.view',
-- Correspondence
'corr.view',
-- RFA
'rfa.view',
-- Drawing
'drawing.contract.view', 'drawing.shop.view',
-- Transmittal
'transmittal.view',
-- Circulation
'circulation.view', 'circulation.respond' -- (สามารถ Respond งานที่ถูกส่งมาหาได้)
)
WHERE r.role_code = 'VIEWER';
-- 1.25 user_roles Table: User Roles Junction Table (RBAC) - For global/system-level roles
CREATE TABLE user_roles (
user_id INT NOT NULL COMMENT 'ID ของผู้ใช้',
role_id INT NOT NULL COMMENT 'ID ของบทบาท',
PRIMARY KEY (user_id, role_id),
CONSTRAINT fk_ur_user FOREIGN KEY (user_id) REFERENCES users(user_id) ON UPDATE CASCADE ON DELETE CASCADE,
CONSTRAINT fk_ur_role FOREIGN KEY (role_id) REFERENCES roles(role_id) ON UPDATE CASCADE ON DELETE CASCADE
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_general_ci COMMENT='ตารางเชื่อมระหว่างผู้ใช้และบทบาท (RBAC)';
-- Initial SUPER_ADMIN
INSERT IGNORE INTO user_roles (user_id, role_id)
SELECT u.user_id, r.role_id
FROM users AS u
JOIN roles AS r ON r.role_code='SUPER_ADMIN'
WHERE u.username='superadmin';
-- 1.26 Table: User Project Roles Junction Table (RBAC) - For project-specific roles
CREATE TABLE user_project_roles (
user_id INT NOT NULL COMMENT 'ID ของผู้ใช้',
project_id INT NOT NULL COMMENT 'ID ของโครงการ',
role_id INT NOT NULL COMMENT 'ID ของบทบาท',
PRIMARY KEY (user_id, project_id, role_id),
CONSTRAINT fk_upr_user FOREIGN KEY (user_id) REFERENCES users(user_id) ON UPDATE CASCADE ON DELETE CASCADE,
CONSTRAINT fk_upr_project FOREIGN KEY (project_id) REFERENCES projects(id) ON UPDATE CASCADE ON DELETE CASCADE,
CONSTRAINT fk_upr_role FOREIGN KEY (role_id) REFERENCES roles(role_id) ON UPDATE CASCADE ON DELETE CASCADE
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_general_ci COMMENT='ตารางเชื่อมระหว่างผู้ใช้ โครงการ และบทบาท (RBAC)';
-- Sample seed for user_project_roles (assign superadmin)
INSERT IGNORE INTO user_project_roles (user_id, project_id, role_id)
SELECT u.user_id, p.id, r.role_id
FROM users u
JOIN projects p ON p.project_code='LCBP3C1'
JOIN roles r ON r.role_code='SUPER_ADMIN'
WHERE u.username='superadmin';
-- Sample seed for user_project_roles (assign superadmin)
INSERT IGNORE INTO user_project_roles (user_id, project_id, role_id)
SELECT u.user_id, p.id, r.role_id
FROM users u
JOIN projects p ON p.project_code='LCBP3C1'
JOIN roles r ON r.role_code='SUPER_ADMIN'
WHERE u.username='superadmin';
-- Assign editor01 as EDITOR in project LCBP3C1
INSERT IGNORE INTO user_project_roles (user_id, project_id, role_id)
SELECT u.user_id, p.id, r.role_id
FROM users u
JOIN projects p ON p.project_code='LCBP3C1'
JOIN roles r ON r.role_code='EDITOR'
WHERE u.username='editor01';
-- Assign editor01 as VIEWER in project LCBP3C2
INSERT IGNORE INTO user_project_roles (user_id, project_id, role_id)
SELECT u.user_id, p.id, r.role_id
FROM users u
JOIN projects p ON p.project_code='LCBP3C2'
JOIN roles r ON r.role_code='VIEWER'
WHERE u.username='editor01';
-- Assign viewer01 as VIEWER in project LCBP3C2
INSERT IGNORE INTO user_project_roles (user_id, project_id, role_id)
SELECT u.user_id, p.id, r.role_id
FROM users u
JOIN projects p ON p.project_code='LCBP3C2'
JOIN roles r ON r.role_code='VIEWER'
WHERE u.username='viewer01';
-- 1.27 audit_logs Table: (optional)
CREATE TABLE audit_logs (
audit_id BIGINT AUTO_INCREMENT PRIMARY KEY COMMENT 'ID ของบันทึกการตรวจสอบ',
user_id INT NULL COMMENT 'ID ของผู้ใช้ที่ทำการกระทำ',
action VARCHAR(100) NOT NULL COMMENT 'Action ที่ทำ', -- e.g., login.success, rfa.create
entity_type VARCHAR(50) NULL COMMENT 'table/model name',
entity_id VARCHAR(50) NULL COMMENT 'primary key of the entity',
details_json JSON NULL COMMENT 'รายละเอียดเพิ่มเติมในรูปแบบ JSON',
ip_address VARCHAR(45) NULL COMMENT 'IP Address ของผู้ใช้',
user_agent VARCHAR(255) NULL COMMENT 'User Agent ของผู้ใช้',
created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP NOT NULL COMMENT 'เวลาที่กระทำ',
CONSTRAINT fk_audit_user FOREIGN KEY (user_id) REFERENCES users(user_id) ON UPDATE CASCADE ON DELETE SET NULL
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_general_ci COMMENT='ตารางบันทึกการตรวจสอบกิจกรรมของผู้ใช้';
CREATE INDEX idx_audit_created ON audit_logs(created_at);
-- ==========================================================
-- View Creation
-- ==========================================================
-- V.1. View สำหรับ Query ง่าย (รวม Master + Corespondence Current Revision)
CREATE VIEW v_current_correspondences AS
SELECT
co.id,
co.correspondence_number,
co.project_id,
co.correspondence_type_id,
cr.correspondence_id,
cr.revision_number,
cr.revision_label,
cr.correspondence_status_id,
cr.title,
co.originator_id,
co.recipient_id,
cr.issued_date,
cr.description,
cr.details,
co.created_at AS correspondence_created_at,
cr.created_at AS revision_created_at
FROM correspondences co
INNER JOIN correspondence_revisions cr
ON cr.is_current = true
WHERE co.deleted_at IS NULL;
-- V.2. View สำหรับ Query ง่าย (รวม Master + RFA Current Revision)
CREATE VIEW v_current_rfas AS
SELECT
co.id,
co.correspondence_number,
co.project_id,
co.correspondence_type_id,
rr.correspondence_id,
rr.revision_number,
rr.revision_label,
rr.rfa_status_code_id,
rr.rfa_approve_code_id,
rr.title,
co.originator_id,
co.recipient_id,
rr.issued_date,
rr.description,
co.created_at AS correspondence_created_at,
rr.created_at AS revision_created_at,
rf.created_at AS rfa_created_at,
rf.rfa_type_id
FROM rfa_revisions rr
LEFT JOIN correspondences co ON rr.correspondence_id = co.id
LEFT JOIN rfas rf ON rr.rfa_id = rf.id
WHERE rr.is_current = 'TRUE';
-- V.3. View สำหรับ Query ง่าย แontract_parties
CREATE VIEW v_contract_parties_all AS
SELECT
ct.contract_code,
ct.contract_name,
pr.project_code,
pr.project_name,
og.organization_code,
og.organization_name
FROM contract_parties cp
LEFT JOIN contracts ct ON cp.contract_id = ct.id
LEFT JOIN projects pr ON cp.project_id = pr.id
LEFT JOIN organizations og ON cp.organization_id = og.id
WHERE pr.is_active = 0;
-- ----------------------------------------------------------
-- View 1: v_user_tasks (สำหรับ Dashboard "งานของฉัน" Req 5.3)
-- ----------------------------------------------------------
CREATE OR REPLACE VIEW v_user_tasks AS
SELECT
ca.user_id,
c.id AS circulation_id,
c.organization_id,
c.circulation_no,
c.circulation_subject,
ca.assignee_type,
ca.deadline,
c.created_at,
c.correspondence_id
FROM circulations c
JOIN circulation_assignees ca ON c.id = ca.circulation_id
WHERE
ca.is_completed = FALSE
AND ca.assignee_type IN ('MAIN', 'ACTION');
-- ----------------------------------------------------------
-- View 2: v_audit_log_details (สำหรับ Activity Feed Req 6.1)
-- ----------------------------------------------------------
CREATE OR REPLACE VIEW v_audit_log_details AS
SELECT
al.audit_id,
al.user_id,
al.action,
al.entity_type,
al.entity_id,
al.details_json,
al.ip_address,
al.created_at,
u.username,
u.first_name,
u.last_name,
u.email
FROM audit_logs al
LEFT JOIN users u ON al.user_id = u.user_id;
-- ----------------------------------------------------------
-- View 3: v_user_all_permissions (สำหรับ RBAC 2 ระดับ Req 4.2)
-- ----------------------------------------------------------
-- View นี้จะรวมสิทธิ์ 2 ระดับ (Global และ Project)
-- (หมายเหตุ: ไม่รวม Contract-level เนื่องจากยังไม่มีตาราง)
-- ----------------------------------------------------------
CREATE OR REPLACE VIEW v_user_all_permissions AS
-- 1. สิทธิ์ระดับ Global (project_id IS NULL)
SELECT
ur.user_id,
NULL AS project_id,
p.permission_code
FROM user_roles ur
JOIN role_permissions rp ON ur.role_id = rp.role_id
JOIN permissions p ON rp.permission_id = p.permission_id
UNION
-- 2. สิทธิ์ระดับ Project
SELECT
upr.user_id,
upr.project_id,
p.permission_code
FROM user_project_roles upr
JOIN role_permissions rp ON upr.role_id = rp.role_id
JOIN permissions p ON rp.permission_id = p.permission_id;
-- ==========================================================
-- Procedure Creation
-- ==========================================================
-- ==========================================================
-- สร้าง Stored Procedure ใหม่ (สำหรับ Document Numbering)
-- ==========================================================
-- ใช้ Procedure นี้เพื่อจัดการ Race Condition
-- ในการดึงเลขที่เอกสารล่าสุด
-- ----------------------------------------------------------
DELIMITER $$
CREATE PROCEDURE sp_get_next_document_number(
IN p_project_id INT,
IN p_organization_id INT,
IN p_type_id INT,
IN p_year INT,
OUT p_next_number INT
)
BEGIN
DECLARE v_last_number INT;
-- 1. พยายามดึงแถวปัจจุบันและ "ล็อก" (FOR UPDATE)
-- เพื่อป้องกันไม่ให้ Transaction อื่นอ่านค่านี้จนกว่าเราจะเสร็จ
SELECT last_number
INTO v_last_number
FROM document_number_counters
WHERE
project_id = p_project_id AND
originator_organization_id = p_organization_id AND
correspondence_type_id = p_type_id AND
current_year = p_year
FOR UPDATE;
-- 2. ตรวจสอบว่าพบบแถวหรือไม่
IF v_last_number IS NULL THEN
-- 2a. ไม่พบ (นี่คือเลขที่ "1" ของ Key นี้)
INSERT INTO document_number_counters
(project_id, originator_organization_id, correspondence_type_id, current_year, last_number)
VALUES
(p_project_id, p_organization_id, p_type_id, p_year, 1);
SET p_next_number = 1;
ELSE
-- 2b. พบ (บวกเลขที่เดิม)
SET p_next_number = v_last_number + 1;
UPDATE document_number_counters
SET last_number = p_next_number
WHERE
project_id = p_project_id AND
originator_organization_id = p_organization_id AND
correspondence_type_id = p_type_id AND
current_year = p_year;
END IF;
-- (Transaction จะ Commit อัตโนมัติเมื่อ Procedure จบ)
END$$
DELIMITER ;
SET FOREIGN_KEY_CHECKS=1;