commit a16e154531c4cbe1c2d3910101fcf062ff604403 Author: admin Date: Mon Nov 17 16:48:49 2025 +0700 251117:1700 first commit diff --git a/.cursor/rules/instructions.mdc b/.cursor/rules/instructions.mdc new file mode 100644 index 0000000..3dca909 --- /dev/null +++ b/.cursor/rules/instructions.mdc @@ -0,0 +1,3 @@ +--- +alwaysApply: true +--- diff --git a/.cursor/rules/project_description.mdc b/.cursor/rules/project_description.mdc new file mode 100644 index 0000000..a178c80 --- /dev/null +++ b/.cursor/rules/project_description.mdc @@ -0,0 +1,6 @@ +--- +description: Documents Management Sytem Version 1.1.0 +globs: + - docs/LCBP3-DMS_V1_1_0_*.md +alwaysApply: true +--- diff --git a/.cursorignore b/.cursorignore new file mode 100644 index 0000000..fbcdc7b --- /dev/null +++ b/.cursorignore @@ -0,0 +1,10 @@ +venv/ +node_modules/ +*.log +.env + +.syncing_db/ +@Recently-Snapshot/ +logs/ +design_specs/ +legacy_code/ \ No newline at end of file diff --git a/.gitignore b/.gitignore new file mode 100644 index 0000000..2cd6ff5 --- /dev/null +++ b/.gitignore @@ -0,0 +1,353 @@ +# ============================================ +# Dependencies +# ============================================ +/node_modules/ +node_modules/ +backend/node_modules/ +frontend/node_modules/ +jspm_packages/ +bower_components/ +web_modules/ + +# Yarn +.yarn/cache +.yarn/unplugged +.yarn/build-state.yml +.yarn/install-state.gz +.pnp.* +.pnp.js + +# ============================================ +# Build Outputs & Cache +# ============================================ +# Next.js +.next/ +out/ + +# Production builds +build/ +dist/ +*.tsbuildinfo + +# Build artifacts +build/Release + +# Cache directories +.cache/ +.parcel-cache +.nuxt +.docusaurus +.temp +**/.vitepress/dist +**/.vitepress/cache +.vuepress/dist +.fusebox/ +.rpt2_cache/ +.rts2_cache_cjs/ +.rts2_cache_es/ +.rts2_cache_umd/ + +# ============================================ +# Logs & Debug +# ============================================ +logs +*.log +npm-debug.log* +yarn-debug.log* +yarn-error.log* +lerna-debug.log* +.pnpm-debug.log* +report.[0-9]*.[0-9]*.[0-9]*.[0-9]*.json + +# ============================================ +# Environment & Config +# ============================================ +.env +.env.local +.env.*.local +.env.development.local +.env.test.local +.env.production.local +*.pem + +# ============================================ +# Testing & Coverage +# ============================================ +coverage/ +*.lcov +.nyc_output +.vscode-test + +# ============================================ +# Runtime & Temp Files +# ============================================ +pids +*.pid +*.seed +*.pid.lock +lib-cov +.grunt +.lock-wscript +.node_repl_history +*.tgz +.serverless/ +.dynamodb/ +.tern-port + +# ============================================ +# IDE & Editor +# ============================================ +# VSCode +# .vscode/* +# !.vscode/settings.json +# !.vscode/tasks.json +# !.vscode/launch.json +# !.vscode/extensions.json +# *.code-workspace + +# JetBrains IDEs +.idea/ +*.iml +*.iws +*.ipr +out/ + +# Sublime Text +*.sublime-project +*.sublime-workspace + +# Vim +*.swp +*.swo +*~ + +# Emacs +*~ +\#*\# +.\#* + +# ============================================ +# OS Files +# ============================================ +# macOS +.@upload_cache/ +.qsync/ +.syncing_db/ +@Recently-Snapshot/ +.DS_Store +.AppleDouble +.LSOverride +Icon +._* +.DocumentRevisions-V100 +.fseventsd +.Spotlight-V100 +.TemporaryItems +.Trashes +.VolumeIcon.icns +.com.apple.timemachine.donotpresent +.AppleDB +.AppleDesktop +Network Trash Folder +Temporary Items +.apdisk + +# Windows +Thumbs.db +Thumbs.db:encryptable +ehthumbs.db +ehthumbs_vista.db +*.stackdump +[Dd]esktop.ini +$RECYCLE.BIN/ +*.cab +*.msi +*.msix +*.msm +*.msp +*.lnk + +# Linux +.directory +.Trash-* +.nfs* + +# ============================================ +# Optional Tools & Caches +# ============================================ +# npm +.npm +.eslintcache +.stylelintcache +package-lock.json +npm-shrinkwrap.json + +# TypeScript +next-env.d.ts + +# Vercel +.vercel + +# Turborepo +.turbo + +# Sentry +.sentryclirc + +# Storybook +storybook-static/ + +# Playwright +playwright-report/ +playwright/.cache/ +test-results/ + +# Jest +jest-results/ + +# Cypress +cypress/videos/ +cypress/screenshots/ +cypress/downloads/ + +# Docker +*.log +docker-compose.override.yml + +# Terraform +*.tfstate +*.tfstate.* +.terraform/ +.terraform.lock.hcl + +# ============================================ +# NestJS Specific +# ============================================ +# NestJS build output +dist/ +*.js.map + +# NestJS documentation +documentation/ +compodoc/ + +# NestJS testing +.jest/ +coverage/ + +# ============================================ +# Database +# ============================================ +# MariaDB / MySQL +npm/letsencrypt/ +*.sql.gz +*.sql.zip +mysql-data/ +mariadb/data/ +db-data/ + +# Database dumps +dump.rdb +*.dump +*.backup + +# Database configuration (if contains credentials) +ormconfig.json +database.json + +# ============================================ +# n8n Workflow Automation +# ============================================ +# n8n data directory +.n8n/ +n8n/cache/ +n8n/postgres/ +n8n/pgadmin/sessions + +# n8n encryption key +encryptionKey.txt + +# n8n database +database.sqlite + +# n8n configuration +n8n.config.json + +# n8n credentials (IMPORTANT - never commit!) +credentials.json +credentials/ + +# n8n workflows (uncomment if you want to version control workflows) +# workflows/ + +# ============================================ +# Node Version Management +# ============================================ +# n (Node version manager) +.n-node-versions/ +n/versions/ + +# nvm +.nvmrc.local + +# Python (if using Python tools) +__pycache__/ +*.py[cod] +*$py.class +venv/ +env/ +ENV/ + +# Ruby (if using Ruby tools) +*.gem +*.rbc +/.config +/InstalledFiles +/pkg/ +/spec/reports/ +/spec/examples.txt +/test/tmp/ +/test/version_tmp/ +/tmp/ +.bundle/ +vendor/bundle + +# +.qsync/ +@Recently-Snapshot/ +.@__thumb +# ============================================ +# Project Specific (Uncomment as needed) +# ============================================ +# Design files +# *.sketch +# *.fig +# *.xd +# *.psd + +# Documentation builds +# docs/_build/ +# site/ + +# Database +# *.db +# *.sqlite +# *.sqlite3 + +# Compiled source +# *.com +# *.class +# *.dll +# *.exe +# *.o +# *.so + +# Archives +# *.7z +# *.dmg +# *.gz +# *.iso +# *.jar +# *.rar +# *.tar +# *.zip \ No newline at end of file diff --git a/.vscode/extensions.json b/.vscode/extensions.json new file mode 100644 index 0000000..b5ac8dd --- /dev/null +++ b/.vscode/extensions.json @@ -0,0 +1,66 @@ +{ "recommendations": [ + "aaron-bond.better-comments", + "anbuselvanrocky.bootstrap5-vscode", + "bmewburn.vscode-intelephense-client", + "bradlc.vscode-tailwindcss", + "christian-kohler.path-intellisense", + "codezombiech.gitignore", + "davidanson.vscode-markdownlint", + "dbaeumer.vscode-eslint", + "dsznajder.es7-react-js-snippets", + "dunstontc.vscode-docker-syntax", + "eamodio.gitlens", + "easycodeai.chatgpt-gpt4-gpt3-vscode", + "ecmel.vscode-html-css", + "editorconfig.editorconfig", + "esbenp.prettier-vscode", + "firsttris.vscode-jest-runner", + "formulahendry.auto-rename-tag", + "github.copilot", + "github.copilot-chat", + "google.geminicodeassist", + "hansuxdev.bootstrap5-snippets", + "heybourn.headwind", + "humao.rest-client", + "imgildev.vscode-auto-barrel", + "imgildev.vscode-json-flow", + "imgildev.vscode-nestjs-generator", + "imgildev.vscode-nestjs-pack", + "imgildev.vscode-nestjs-snippets-extension", + "imgildev.vscode-nestjs-swagger-snippets", + "inferrinizzard.prettier-sql-vscode", + "jmkrivocapich.drawfolderstructure", + "mhutchie.git-graph", + "mikestead.dotenv", + "ms-azuretools.vscode-containers", + "ms-azuretools.vscode-docker", + "ms-edgedevtools.vscode-edge-devtools", + "ms-python.debugpy", + "ms-python.python", + "ms-vscode-remote.remote-containers", + "ms-vscode-remote.remote-ssh", + "ms-vscode-remote.remote-ssh-edit", + "ms-vscode.powershell", + "ms-vscode.remote-explorer", + "mtxr.sqltools", + "mtxr.sqltools-driver-mysql", + "oderwat.indent-rainbow", + "orta.vscode-jest", + "pdconsec.vscode-print", + "pmneo.tsimporter", + "postman.postman-for-vscode", + "prisma.prisma", + "redhat.vscode-yaml", + "rioj7.command-variable", + "ritwickdey.liveserver", + "rvest.vs-code-prettier-eslint", + "shardulm94.trailing-spaces", + "steoates.autoimport", + "stringham.move-ts", + "usernamehw.errorlens", + "vincaslt.highlight-matching-tag", + "vscode-icons-team.vscode-icons", + "yoavbls.pretty-ts-errors", + "yzhang.markdown-all-in-one", + ] +} diff --git a/.vscode/settings.json b/.vscode/settings.json new file mode 100644 index 0000000..b9b9364 --- /dev/null +++ b/.vscode/settings.json @@ -0,0 +1,12 @@ +{ + "editor.formatOnSave": true, + "editor.codeActionsOnSave": { + "source.fixAll.eslint": "explicit" + }, + "eslint.validate": [ + "javascript", + "javascriptreact", + "typescript", + "typescriptreact" + ] +} \ No newline at end of file diff --git a/.vscode/tasks.json b/.vscode/tasks.json new file mode 100644 index 0000000..e69de29 diff --git a/01_lcbp3_v1_4_0.sql b/01_lcbp3_v1_4_0.sql new file mode 100644 index 0000000..48e7802 --- /dev/null +++ b/01_lcbp3_v1_4_0.sql @@ -0,0 +1,1878 @@ +-- ========================================================== +-- 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 (GLM-4.6 & Gemini) +-- ========================================================== + +SET NAMES utf8mb4; +SET time_zone = '+07:00'; +-- ปิดการตรวจสอบ Foreign Key ชั่วคราวเพื่อให้สามารถลบตารางได้ทั้งหมด +SET FOREIGN_KEY_CHECKS=0; + +DROP VIEW IF EXISTS v_document_statistics; +DROP VIEW IF EXISTS v_documents_with_attachments; +DROP VIEW IF EXISTS v_user_all_permissions; +DROP VIEW IF EXISTS v_audit_log_details; +DROP VIEW IF EXISTS v_user_tasks; +DROP VIEW IF EXISTS v_contract_parties_all; +DROP VIEW IF EXISTS v_current_rfas; +DROP VIEW IF EXISTS v_current_correspondences; + +DROP PROCEDURE IF EXISTS sp_get_next_document_number; +-- 🗑️ Drop all tables in reverse dependency order +-- ส่วนที่ 1: ตาราง System & Utility (ไม่ค่อยมีการอ้างอิง หรือเป็นตารางสุดท้ายในสายงาน) +DROP TABLE IF EXISTS backup_logs; +DROP TABLE IF EXISTS search_indices; +DROP TABLE IF EXISTS notifications; +DROP TABLE IF EXISTS audit_logs; + +-- ส่วนที่ 2: ตารางที่เชื่อมโยงกับเอกสารและข้อมูลหลัก (Junction Tables) +DROP TABLE IF EXISTS correspondence_tags; +DROP TABLE IF EXISTS shop_drawing_revision_contract_refs; +DROP TABLE IF EXISTS contract_drawing_subcat_cat_maps; + +-- ส่วนที่ 3: ตารางไฟล์แนบและการเชื่อมโยง (Attachments & Their Junctions) +DROP TABLE IF EXISTS contract_drawing_attachments; +DROP TABLE IF EXISTS circulation_attachments; +DROP TABLE IF EXISTS shop_drawing_revision_attachments; +DROP TABLE IF EXISTS correspondence_attachments; +DROP TABLE IF EXISTS attachments; + +-- ส่วนที่ 4: ตารางเกี่ยวกับ Workflow และ Template +DROP TABLE IF EXISTS circulation_routings; +DROP TABLE IF EXISTS circulation_template_assignees; +DROP TABLE IF EXISTS circulation_templates; +DROP TABLE IF EXISTS rfa_workflows; +DROP TABLE IF EXISTS rfa_workflow_template_steps; +DROP TABLE IF EXISTS rfa_workflow_templates; +-- add +DROP TABLE IF EXISTS correspondence_routings; +DROP TABLE IF EXISTS correspondence_routing_template_steps; +DROP TABLE IF EXISTS correspondence_status_transitions; +DROP TABLE IF EXISTS correspondence_routing_templates; + +-- ส่วนที่ 5: ตาราง Mapping หลัก (Main Mapping Tables) +DROP TABLE IF EXISTS role_permissions; +DROP TABLE IF EXISTS user_assignments; +DROP TABLE IF EXISTS contract_organizations; +DROP TABLE IF EXISTS project_organizations; + +-- ส่วนที่ 6: ตารางรายละเอียดของเอกสาร (Detail/Item Tables) +DROP TABLE IF EXISTS transmittal_items; +DROP TABLE IF EXISTS shop_drawing_revisions; +DROP TABLE IF EXISTS rfa_items; +DROP TABLE IF EXISTS rfa_revisions; +DROP TABLE IF EXISTS correspondence_references; +DROP TABLE IF EXISTS correspondence_recipients; +DROP TABLE IF EXISTS correspondence_revisions; + +-- ส่วนที่ 7: ตารางเอกสารหลัก (Core Document Tables) +DROP TABLE IF EXISTS circulations; +DROP TABLE IF EXISTS transmittals; +DROP TABLE IF EXISTS contract_drawings; +DROP TABLE IF EXISTS shop_drawings; +DROP TABLE IF EXISTS rfas; +DROP TABLE IF EXISTS correspondences; + +-- ส่วนที่ 8: ตารางหมวดหมู่และข้อมูลหลัก (Categories & Master Data) +DROP TABLE IF EXISTS shop_drawing_sub_categories; +DROP TABLE IF EXISTS shop_drawing_main_categories; +DROP TABLE IF EXISTS contract_drawing_sub_cats; +DROP TABLE IF EXISTS contract_drawing_cats; +DROP TABLE IF EXISTS contract_drawing_volumes; +DROP TABLE IF EXISTS circulation_status_codes; +DROP TABLE IF EXISTS rfa_approve_codes; +DROP TABLE IF EXISTS rfa_status_codes; +DROP TABLE IF EXISTS rfa_types; +DROP TABLE IF EXISTS correspondence_status; +DROP TABLE IF EXISTS correspondence_types; +DROP TABLE IF EXISTS document_number_counters; +DROP TABLE IF EXISTS document_number_formats; +DROP TABLE IF EXISTS tags; + +-- ส่วนที่ 9: ตารางผู้ใช้ บทบาท และโครงสร้างหลัก (Users, Roles & Core Structure) +DROP TABLE IF EXISTS organization_roles; +DROP TABLE IF EXISTS roles; +DROP TABLE IF EXISTS permissions; +DROP TABLE IF EXISTS contracts; +DROP TABLE IF EXISTS projects; +DROP TABLE IF EXISTS users; +DROP TABLE IF EXISTS organizations; + +-- ===================================================== +-- 1. 🏢 Core & Master Data (องค์กร, โครงการ, สัญญา) +-- ===================================================== + +-- ตาราง Master เก็บประเภทบทบาทขององค์กร +CREATE TABLE organization_roles ( + id INT PRIMARY KEY AUTO_INCREMENT COMMENT 'ID ของตาราง', + role_name VARCHAR(20) NOT NULL UNIQUE COMMENT 'ชื่อบทบาท (OWNER, DESIGNER, CONSULTANT, CONTRACTOR, THIRD PARTY)' +) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_general_ci COMMENT='ตาราง Master เก็บประเภทบทบาทขององค์กร'; + +-- ตาราง Master เก็บข้อมูลองค์กรทั้งหมดที่เกี่ยวข้องในระบบ +CREATE TABLE organizations ( + id INT PRIMARY KEY AUTO_INCREMENT COMMENT 'ID ของตาราง', + organization_code VARCHAR(20) NOT NULL UNIQUE COMMENT 'รหัสองค์กร', + organization_name VARCHAR(255) NOT NULL COMMENT 'ชื่อองค์กร', + -- role_id INT COMMENT 'บทบาทขององค์กร', + is_active BOOLEAN DEFAULT TRUE COMMENT 'สถานะการใช้งาน', + created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP COMMENT 'วันที่สร้าง', + updated_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP COMMENT 'วันที่แก้ไขล่าสุด' + -- FOREIGN KEY (role_id) REFERENCES organization_roles(id) ON DELETE SET NULL +) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_general_ci COMMENT='ตาราง Master เก็บข้อมูลองค์กรทั้งหมดที่เกี่ยวข้องในระบบ'; +-- Seed organization +INSERT INTO organizations (id, organization_code, organization_name) VALUES +(1, 'กทท.', 'การท่าเรือแห่งประเทศไทย'), +(10, 'สคฉ.3', 'โครงการพัฒนาท่าเรือแหลมฉบัง ระยะที่ 3'), +(11, 'สคฉ.3-01', 'ตรวจรับพัสดุ ที่ปรึกษาควบคุมงาน'), +(12, 'สคฉ.3-02', 'ตรวจรับพัสดุ งานทางทะเล'), +(13, 'สคฉ.3-03', 'ตรวจรับพัสดุ อาคารและระบบสาธารณูปโภค'), +(14, 'สคฉ.3-04', 'ตรวจรับพัสดุ ตรวจสอบผลกระทบสิ่งแวดล้อม'), +(15, 'สคฉ.3-05', 'ตรวจรับพัสดุ เยียวยาการประมง'), +(16, 'สคฉ.3-06', 'ตรวจรับพัสดุ งานก่อสร้าง ส่วนที่ 3'), +(17, 'สคฉ.3-07', 'ตรวจรับพัสดุ งานก่อสร้าง ส่วนที่ 4'), +(18, 'สคฉ.3-xx', 'ตรวจรับพัสดุ ที่ปรึกษาออกแบบ ส่วนที่ 4'), +(21, 'TEAM', 'Designer Consulting Ltd.'), +(22, 'คคง.', 'Construction Supervision Ltd.'), +(41, 'ผรม.1', 'Contractor งานทางทะเล'), +(42, 'ผรม.2', 'Contractor อาคารและระบบ'), +(43, 'ผรม.3', 'Contractor #3 Ltd.'), +(44, 'ผรม.4', 'Contractor #4 Ltd.'), +(31, 'EN', 'Third Party Environment'), +(32, 'CAR', 'Third Party Fishery Care'); + +-- ตาราง Master เก็บข้อมูลโครงการ +CREATE TABLE projects ( + id INT PRIMARY KEY AUTO_INCREMENT COMMENT 'ID ของตาราง', + project_code VARCHAR(50) NOT NULL UNIQUE COMMENT 'รหัสโครงการ', + project_name VARCHAR(255) NOT NULL COMMENT 'ชื่อโครงการ', + -- parent_project_id INT COMMENT 'รหัสโครงการหลัก (ถ้ามี)', + -- contractor_organization_id INT COMMENT 'รหัสองค์กรผู้รับเหมา (ถ้ามี)', + is_active TINYINT(1) DEFAULT 1 COMMENT 'สถานะการใช้งาน' + -- FOREIGN KEY (parent_project_id) REFERENCES projects(id) ON DELETE SET NULL, + -- FOREIGN KEY (contractor_organization_id) REFERENCES organizations(id) ON DELETE SET NULL +) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_general_ci COMMENT='ตาราง Master เก็บข้อมูลโครงการ'; +INSERT INTO projects (project_code, project_name) VALUES + ('LCBP3','โครงการพัฒนาท่าเรือแหลมฉบัง ระยะที่ 3 (ส่วนที่ 1-4)'), + ('LCBP3C1','โครงการพัฒนาท่าเรือแหลมฉบัง ระยะที่ 3 (ส่วนที่ 1) งานก่อสร้างงานทางทะเล'), + ('LCBP3C2','โครงการพัฒนาท่าเรือแหลมฉบัง ระยะที่ 3 (ส่วนที่ 2) งานก่อสร้างอาคาร ท่าเทียบเรือ ระบบถนน และระบบสาธารณูปโภค'), + ('LCBP3C3','โครงการพัฒนาท่าเรือแหลมฉบัง ระยะที่ 3 (ส่วนที่ 3) งานก่อสร้าง'), + ('LCBP3C4','โครงการพัฒนาท่าเรือแหลมฉบัง ระยะที่ 3 (ส่วนที่ 4) งานก่อสร้าง'); + +-- ตาราง Master เก็บข้อมูลสัญญา +CREATE TABLE contracts ( + id INT PRIMARY KEY AUTO_INCREMENT COMMENT 'ID ของตาราง', + project_id INT NOT NULL, + contract_code VARCHAR(50) NOT NULL UNIQUE COMMENT 'รหัสสัญญา', + contract_name VARCHAR(255) NOT NULL COMMENT 'ชื่อสัญญา', + description TEXT COMMENT 'คำอธิบายสัญญา', + start_date DATE COMMENT 'วันที่เริ่มสัญญา', + end_date DATE COMMENT 'วันที่สิ้นสุดสัญญา', + is_active BOOLEAN DEFAULT TRUE, + created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP COMMENT 'วันที่สร้าง', + updated_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP COMMENT 'วันที่แก้ไขล่าสุด', + FOREIGN KEY (project_id) REFERENCES projects(id) ON DELETE CASCADE +) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_general_ci COMMENT='ตาราง Master เก็บข้อมูลสัญญา'; +-- ใช้ Subquery เพื่อดึง project_id มาเชื่อมโยง ทำให้ไม่ต้องมานั่งจัดการ ID ด้วยตัวเอง +INSERT INTO contracts (contract_code, contract_name, project_id, is_active) VALUES +('DSLCBP3', 'งานจ้างที่ปรีกษาออกแบบ โครงการพัฒนาท่าเรือแหลมฉบัง ระยะที่ 3 (ส่วนที่ 1-4)', (SELECT id FROM projects WHERE project_code = 'LCBP3'), TRUE), +('PSLCBP3', 'งานจ้างที่ปรีกษาควบคุมงาน โครงการพัฒนาท่าเรือแหลมฉบัง ระยะที่ 3 (ส่วนที่ 1-4)', (SELECT id FROM projects WHERE project_code = 'LCBP3'), TRUE), +('LCBP3-C1', 'งานก่อสร้าง โครงการพัฒนาท่าเรือแหลมฉบัง ระยะที่ 3 (ส่วนที่ 1) งานก่อสร้างงานทางทะเล', (SELECT id FROM projects WHERE project_code = 'LCBP3C1'), TRUE), +('LCBP3-C2', 'งานก่อสร้าง โครงการพัฒนาท่าเรือแหลมฉบัง ระยะที่ 3 (ส่วนที่ 2) งานก่อสร้างอาคาร ท่าเทียบเรือ ระบบถนน และระบบสาธารณูปโภค', (SELECT id FROM projects WHERE project_code = 'LCBP3C2'), TRUE), +('LCBP3-C3', 'งานก่อสร้าง โครงการพัฒนาท่าเรือแหลมฉบัง ระยะที่ 3 (ส่วนที่ 3) งานก่อสร้าง', (SELECT id FROM projects WHERE project_code = 'LCBP3C3'), TRUE), +('LCBP3-C4', 'งานก่อสร้าง โครงการพัฒนาท่าเรือแหลมฉบัง ระยะที่ 3 (ส่วนที่ 4) งานก่อสร้าง', (SELECT id FROM projects WHERE project_code = 'LCBP3C4'), TRUE), +('ENLCBP3', 'งานจ้างเหมาตรวจสอบผลกระทบสิ่งแวดล้อมนะหว่างงานก่อสร้างโครงการพัฒนาท่าเรือแหลมฉบัง ระยะที่ 3 (ส่วนที่ 1-4)', (SELECT id FROM projects WHERE project_code = 'LCBP3'), TRUE); +-- ===================================================== +-- 2. 👥 Users & RBAC (ผู้ใช้, สิทธิ์, บทบาท) +-- ===================================================== + +-- ตาราง Master เก็บข้อมูลผู้ใช้งาน (User) +CREATE TABLE users ( + user_id INT PRIMARY KEY AUTO_INCREMENT COMMENT 'ID ของตาราง', + username VARCHAR(50) NOT NULL UNIQUE COMMENT 'ชื่อผู้ใช้งาน', + password_hash VARCHAR(255) NOT NULL COMMENT 'รหัสผ่าน (Hashed)', + first_name VARCHAR(50) COMMENT 'ชื่อจริง', + last_name VARCHAR(50) COMMENT 'นามสกุล', + email VARCHAR(100) NOT NULL UNIQUE COMMENT 'อีเมล', + line_id VARCHAR(100) COMMENT 'LINE ID', + primary_organization_id INT COMMENT 'สังกัดองค์กร', + is_active TINYINT(1) DEFAULT 1 COMMENT 'สถานะการใช้งาน', + failed_attempts INT DEFAULT 0 COMMENT 'จำนวนครั้งที่ล็อกอินล้มเหลว', + locked_until DATETIME COMMENT 'ล็อกอินไม่ได้จนถึงเวลา', + last_login_at TIMESTAMP NULL COMMENT 'วันที่และเวลาที่ล็อกอินล่าสุด', + created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP COMMENT 'วันที่สร้าง', + updated_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP COMMENT 'วันที่แก้ไขล่าสุด', + FOREIGN KEY (primary_organization_id) REFERENCES organizations(id) ON DELETE SET NULL +) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_general_ci COMMENT='ตาราง Master เก็บข้อมูลผู้ใช้งาน (User)'; +-- 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); + +-- ตาราง Master เก็บ "บทบาท" ของผู้ใช้ในระบบ +CREATE TABLE roles ( + role_id INT PRIMARY KEY AUTO_INCREMENT COMMENT 'ID ของตาราง', + -- role_code VARCHAR(50) NOT NULL UNIQUE COMMENT 'รหัสบทบาท (เช่น SUPER_ADMIN, ADMIN, EDITOR, VIEWER)', + role_name VARCHAR(100) NOT NULL COMMENT 'ชื่อบทบาท', + scope ENUM('Global', 'Organization', 'Project', 'Contract') NOT NULL, -- ขอบเขตของบทบาท (จากข้อ 4.3) + description TEXT COMMENT 'คำอธิบายบทบาท', + is_system BOOLEAN DEFAULT FALSE COMMENT '(1 = บทบาทของระบบ ลบไม่ได้)' +) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_general_ci COMMENT='ตาราง Master เก็บ "บทบาท" ของผู้ใช้ในระบบ'; +-- ========================================================== +-- Seed Roles (บทบาทพื้นฐาน 5 บทบาท ตาม Req 4.3) +-- ========================================================== +-- 1. Superadmin (Global) +INSERT INTO roles (role_id, role_name, scope, description) VALUES +(1, 'Superadmin', 'Global', 'ผู้ดูแลระบบสูงสุด: สามารถทำทุกอย่างในระบบ, จัดการองค์กร, และจัดการข้อมูลหลักระดับ Global'); + +-- 2. Org Admin (Organization) +INSERT INTO roles (role_id, role_name, scope, description) VALUES +(2, 'Org Admin', 'Organization', 'ผู้ดูแลองค์กร: จัดการผู้ใช้ในองค์กร, จัดการบทบาท/สิทธิ์ภายในองค์กร, และดูรายงานขององค์กร'); + +-- 3. Document Control (Organization) +INSERT INTO roles (role_id, role_name, scope, description) VALUES +(3, 'Document Control', 'Organization', 'ควบคุมเอกสารขององค์กร: เพิ่ม/แก้ไข/ลบเอกสาร, และกำหนดสิทธิ์เอกสารภายในองค์กร'); + +-- 4. Editor (Organization) +INSERT INTO roles (role_id, role_name, scope, description) VALUES +(4, 'Editor', 'Organization', 'ผู้แก้ไขเอกสารขององค์กร: เพิ่ม/แก้ไขเอกสารที่ได้รับมอบหมาย'); + +-- 5. Viewer (Organization) +INSERT INTO roles (role_id, role_name, scope, description) VALUES +(5, 'Viewer', 'Organization', 'ผู้ดูเอกสารขององค์กร: ดูเอกสารที่มีสิทธิ์เข้าถึงเท่านั้น'); + +-- 6. Project Manager (Project) +INSERT INTO roles (role_id, role_name, scope, description) VALUES +(6, 'Project Manager', 'Project', 'ผู้จัดการโครงการ: จัดการสมาชิกในโครงการ, สร้าง/จัดการสัญญาในโครงการ, และดูรายงานโครงการ'); + +-- 7. Contract Admin (Contract) +INSERT INTO roles (role_id, role_name, scope, description) VALUES +(7, 'Contract Admin', 'Contract', 'ผู้ดูแลสัญญา: จัดการสมาชิกในสัญญา, สร้าง/จัดการข้อมูลหลักเฉพาะสัญญา, และอนุมัติเอกสารในสัญญา'); + +-- ตาราง Master เก็บ "สิทธิ์" (Permission) หรือ "การกระทำ" ทั้งหมดในระบบ +CREATE TABLE permissions ( + permission_id INT PRIMARY KEY AUTO_INCREMENT COMMENT 'ID ของตาราง', + permission_name VARCHAR(100) NOT NULL UNIQUE COMMENT 'รหัสสิทธิ์ (เช่น rfas.create, rfas.view)', + description TEXT COMMENT 'คำอธิบายสิทธิ์', + module VARCHAR(50) COMMENT 'โมดูลที่เกี่ยวข้อง', + scope_level ENUM('GLOBAL', 'ORG', 'PROJECT') COMMENT 'ระดับขอบเขตของสิทธิ์', + is_active TINYINT(1) DEFAULT 1 COMMENT 'สถานะการใช้งาน' +) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_general_ci COMMENT='ตาราง Master เก็บ "สิทธิ์" (Permission) หรือ "การกระทำ" ทั้งหมดในระบบ'; +-- ===================================================== +-- 2. Seed Permissions (สิทธิ์การใช้งานทั้งหมด) +-- สิทธิ์ระดับระบบและการจัดการหลัก (System & Master Data) +-- ===================================================== + +INSERT INTO permissions (permission_id, permission_name, description) VALUES +(1, 'system.manage_all', 'ทำทุกอย่างในระบบ (Superadmin Power)'), + +-- การจัดการองค์กร +(2, 'organization.create', 'สร้างองค์กรใหม่'), +(3, 'organization.edit', 'แก้ไขข้อมูลองค์กร'), +(4, 'organization.delete', 'ลบองค์กร'), +(5, 'organization.view', 'ดูรายการองค์กร'), + +-- การจัดการโครงการ +(6, 'project.create', 'สร้างโครงการใหม่'), +(7, 'project.edit', 'แก้ไขข้อมูลโครงการ'), +(8, 'project.delete', 'ลบโครงการ'), +(9, 'project.view', 'ดูรายการโครงการ'), + +-- การจัดการบทบาทและสิทธิ์ (Roles & Permissions) +(10, 'role.create', 'สร้างบทบาท (Role) ใหม่'), +(11, 'role.edit', 'แก้ไขบทบาท (Role)'), +(12, 'role.delete', 'ลบบทบาท (Role)'), +(13, 'permission.assign', 'มอบสิทธิ์ให้กับบทบาท (Role)'), + +-- การจัดการข้อมูลหลัก (Master Data) +(14, 'master_data.document_type.manage', 'จัดการประเภทเอกสาร (Document Types)'), +(15, 'master_data.document_status.manage', 'จัดการสถานะเอกสาร (Document Statuses)'), +(16, 'master_data.drawing_category.manage', 'จัดการหมวดหมู่แบบ (Drawing Categories)'), +(17, 'master_data.tag.manage', 'จัดการ Tags'), + +-- การจัดการผู้ใช้งาน +(18, 'user.create', 'สร้างผู้ใช้งานใหม่'), +(19, 'user.edit', 'แก้ไขข้อมูลผู้ใช้งาน'), +(20, 'user.delete', 'ลบ/ปิดการใช้งานผู้ใช้'), +(21, 'user.view', 'ดูข้อมูลผู้ใช้งาน'), +(22, 'user.assign_organization', 'มอบผู้ใช้งานให้กับองค์กร'); + + +-- ===================================================== +-- == 2. สิทธิ์การจัดการโครงการและสัญญา (Project & Contract) == +-- ===================================================== + +INSERT INTO permissions (permission_id, permission_name, description) VALUES +(23, 'project.manage_members', 'จัดการสมาชิกในโครงการ (เชิญ/ถอดสมาชิก)'), +(24, 'project.create_contracts', 'สร้างสัญญาในโครงการ'), +(25, 'project.manage_contracts', 'จัดการสัญญาในโครงการ'), +(26, 'project.view_reports', 'ดูรายงานระดับโครงการ'), + +(27, 'contract.manage_members', 'จัดการสมาชิกในสัญญา'), +(28, 'contract.view', 'ดูข้อมูลสัญญา'); + + +-- ===================================================== +-- == 3. สิทธิ์การจัดการเอกสาร (Document Management) == +-- ===================================================== + +-- สิทธิ์ทั่วไปสำหรับเอกสารทุกประเภท +INSERT INTO permissions (permission_id, permission_name, description) VALUES +(29, 'document.create_draft', 'สร้างเอกสารในสถานะฉบับร่าง (Draft)'), +(30, 'document.submit', 'ส่งเอกสาร (Submitted)'), +(31, 'document.view', 'ดูเอกสาร'), +(32, 'document.edit', 'แก้ไขเอกสาร (ทั่วไป)'), +(33, 'document.admin_edit', 'แก้ไข/ถอน/ยกเลิกเอกสารที่ส่งแล้ว (Admin Power)'), +(34, 'document.delete', 'ลบเอกสาร'), +(35, 'document.attach', 'จัดการไฟล์แนบ (อัปโหลด/ลบ)'), + +-- สิทธิ์เฉพาะสำหรับ Correspondence +(36, 'correspondence.create', 'สร้างเอกสารโต้ตอบ (Correspondence)'), + +-- สิทธิ์เฉพาะสำหรับ Request for Approval (RFA) +(37, 'rfa.create', 'สร้างเอกสารขออนุมัติ (RFA)'), +(38, 'rfa.manage_shop_drawings', 'จัดการข้อมูล Shop Drawing และ Contract Drawing ที่เกี่ยวข้อง'), + +-- สิทธิ์เฉพาะสำหรับ Shop Drawing & Contract Drawing +(39, 'drawing.create', 'สร้าง/แก้ไขข้อมูลแบบ (Shop/Contract Drawing)'), + +-- สิทธิ์เฉพาะสำหรับ Transmittal +(40, 'transmittal.create', 'สร้างเอกสารนำส่ง (Transmittal)'), + +-- สิทธิ์เฉพาะสำหรับ Circulation Sheet (ใบเวียน) +(41, 'circulation.create', 'สร้างใบเวียนเอกสาร (Circulation)'), +(42, 'circulation.respond', 'ตอบกลับใบเวียน (Main/Action)'), +(43, 'circulation.acknowledge', 'รับทราบใบเวียน (Information)'), +(44, 'circulation.close', 'ปิดใบเวียน'); + + +-- ===================================================== +-- == 4. สิทธิ์การจัดการ Workflow == +-- ===================================================== + +INSERT INTO permissions (permission_id, permission_name, description) VALUES +(45, 'workflow.action_review', 'ดำเนินการในขั้นตอนปัจจุบัน (เช่น ตรวจสอบแล้ว)'), +(46, 'workflow.force_proceed', 'บังคับไปยังขั้นตอนถัดไป (Document Control Power)'), +(47, 'workflow.revert', 'ย้อนกลับไปยังขั้นตอนก่อนหน้า (Document Control Power)'); + + +-- ===================================================== +-- == 5. สิทธิ์ด้านการค้นหาและรายงาน (Search & Reporting) == +-- ===================================================== + +INSERT INTO permissions (permission_id, permission_name, description) VALUES +(48, 'search.advanced', 'ใช้งานการค้นหาขั้นสูง'), +(49, 'report.generate', 'สร้างรายงานสรุป (รายวัน/สัปดาห์/เดือน/ปี)'); + +-- ตารางเชื่อมระหว่าง roles และ permissions (M:N) +CREATE TABLE role_permissions ( + role_id INT COMMENT 'ID ของบทบาท', + permission_id INT COMMENT 'ID ของสิทธิ์', + PRIMARY KEY (role_id, permission_id), + FOREIGN KEY (role_id) REFERENCES roles(role_id) ON DELETE CASCADE, + FOREIGN KEY (permission_id) REFERENCES permissions(permission_id) ON DELETE CASCADE +) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_general_ci COMMENT='ตารางเชื่อมระหว่าง roles และ permissions (M:N)'; +-- ========================================================== +-- Seed Role-Permissions Mapping (จับคู่สิทธิ์เริ่มต้น) +-- ========================================================== +-- Seed data for the 'role_permissions' table +-- This table links roles to their specific permissions. + +-- NOTE: This assumes the role_id and permission_id from the previous seed data files. +-- Superadmin (role_id = 1), Org Admin (role_id = 2), Document Control (role_id = 3), etc. + +-- ===================================================== +-- == 1. Superadmin (role_id = 1) - Gets ALL permissions == +-- ===================================================== + +-- Superadmin can do everything. We can dynamically link all permissions to this role. +-- This is a robust way to ensure Superadmin always has full power. +INSERT INTO role_permissions (role_id, permission_id) +SELECT 1, permission_id FROM permissions; + +-- ===================================================== +-- == 2. Org Admin (role_id = 2) == +-- ===================================================== +INSERT INTO role_permissions (role_id, permission_id) VALUES +-- จัดการผู้ใช้ในองค์กร +(2, 18), -- user.create +(2, 19), -- user.edit +(2, 20), -- user.delete +(2, 21), -- user.view +(2, 22), -- user.assign_organization +-- จัดการองค์กร +(2, 3), -- organization.edit +(2, 5), -- organization.view +-- จัดการข้อมูลหลักที่อนุญาต (เฉพาะ Tags) +(2, 17), -- master_data.tag.manage +-- ดูข้อมูลต่างๆ ในองค์กร +(2, 31), -- document.view +(2, 9), -- project.view +(2, 28), -- contract.view +-- การค้นหาและรายงาน +(2, 48), -- search.advanced +(2, 49); -- report.generate + +-- ===================================================== +-- == 3. Document Control (role_id = 3) == +-- ===================================================== +INSERT INTO role_permissions (role_id, permission_id) VALUES +-- สิทธิ์จัดการเอกสารทั้งหมด +(3, 29), -- document.create_draft +(3, 30), -- document.submit +(3, 31), -- document.view +(3, 32), -- document.edit +(3, 33), -- document.admin_edit +(3, 34), -- document.delete +(3, 35), -- document.attach +-- สิทธิ์สร้างเอกสารแต่ละประเภท +(3, 36), -- correspondence.create +(3, 37), -- rfa.create +(3, 39), -- drawing.create +(3, 40), -- transmittal.create +(3, 41), -- circulation.create +-- สิทธิ์จัดการ Workflow +(3, 45), -- workflow.action_review +(3, 46), -- workflow.force_proceed +(3, 47), -- workflow.revert +-- สิทธิ์จัดการ Circulation +(3, 42), -- circulation.respond +(3, 43), -- circulation.acknowledge +(3, 44), -- circulation.close +-- สิทธิ์อื่นๆ ที่จำเป็น +(3, 38), -- rfa.manage_shop_drawings +(3, 48), -- search.advanced +(3, 49); -- report.generate + +-- ===================================================== +-- == 4. Editor (role_id = 4) == +-- ===================================================== +INSERT INTO role_permissions (role_id, permission_id) VALUES +-- สิทธิ์แก้ไขเอกสาร (แต่ไม่ใช่สิทธิ์ Admin) +(4, 29), -- document.create_draft +(4, 30), -- document.submit +(4, 31), -- document.view +(4, 32), -- document.edit +(4, 35), -- document.attach +-- สิทธิ์สร้างเอกสารแต่ละประเภท +(4, 36), -- correspondence.create +(4, 37), -- rfa.create +(4, 39), -- drawing.create +(4, 40), -- transmittal.create +(4, 41), -- circulation.create +-- สิทธิ์อื่นๆ ที่จำเป็น +(4, 38), -- rfa.manage_shop_drawings +(4, 48); -- search.advanced + +-- ===================================================== +-- == 5. Viewer (role_id = 5) == +-- ===================================================== +INSERT INTO role_permissions (role_id, permission_id) VALUES +-- สิทธิ์ดูเท่านั้น +(5, 31), -- document.view +(5, 48); -- search.advanced + +-- ===================================================== +-- == 6. Project Manager (role_id = 6) == +-- ===================================================== +INSERT INTO role_permissions (role_id, permission_id) VALUES +-- สิทธิ์จัดการโครงการ +(6, 23), -- project.manage_members +(6, 24), -- project.create_contracts +(6, 25), -- project.manage_contracts +(6, 26), -- project.view_reports +(6, 9), -- project.view +-- สิทธิ์จัดการข้อมูลหลักระดับโครงการ +(6, 16), -- master_data.drawing_category.manage +-- สิทธิ์ดูข้อมูลในสัญญา +(6, 28), -- contract.view +-- สิทธิ์ในการจัดการเอกสาร (ระดับ Editor) +(6, 29), -- document.create_draft +(6, 30), -- document.submit +(6, 31), -- document.view +(6, 32), -- document.edit +(6, 35), -- document.attach +(6, 36), -- correspondence.create +(6, 37), -- rfa.create +(6, 39), -- drawing.create +(6, 40), -- transmittal.create +(6, 41), -- circulation.create +(6, 38), -- rfa.manage_shop_drawings +(6, 48), -- search.advanced +(6, 49); -- report.generate + +-- ===================================================== +-- == 7. Contract Admin (role_id = 7) == +-- ===================================================== +INSERT INTO role_permissions (role_id, permission_id) VALUES +-- สิทธิ์จัดการสัญญา +(7, 27), -- contract.manage_members +(7, 28), -- contract.view +-- สิทธิ์ในการอนุมัติ (ส่วนหนึ่งของ Workflow) +(7, 45), -- workflow.action_review +-- สิทธิ์จัดการข้อมูลเฉพาะสัญญา +(7, 38), -- rfa.manage_shop_drawings +(7, 39), -- drawing.create +-- สิทธิ์ในการจัดการเอกสาร (ระดับ Editor) +(7, 29), -- document.create_draft +(7, 30), -- document.submit +(7, 31), -- document.view +(7, 32), -- document.edit +(7, 35), -- document.attach +(7, 36), -- correspondence.create +(7, 37), -- rfa.create +(7, 40), -- transmittal.create +(7, 41), -- circulation.create +(7, 48); -- search.advanced + +-- ตารางเชื่อมผู้ใช้ (users) +CREATE TABLE user_assignments ( + id INT AUTO_INCREMENT PRIMARY KEY, + user_id INT NOT NULL, + role_id INT NOT NULL, + + -- คอลัมน์สำหรับกำหนดขอบเขต (จะใช้เพียงอันเดียวต่อแถว) + organization_id INT NULL, + project_id INT NULL, + contract_id INT NULL, + + assigned_by_user_id INT, -- ผู้ที่มอบหมายบทบาทนี้ + assigned_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP, + + FOREIGN KEY (user_id) REFERENCES users(user_id) ON DELETE CASCADE, + FOREIGN KEY (role_id) REFERENCES roles(role_id) ON DELETE CASCADE, + FOREIGN KEY (organization_id) REFERENCES organizations(id) ON DELETE CASCADE, + FOREIGN KEY (project_id) REFERENCES projects(id) ON DELETE CASCADE, + FOREIGN KEY (contract_id) REFERENCES contracts(id) ON DELETE CASCADE, + FOREIGN KEY (assigned_by_user_id) REFERENCES users(user_id), + + -- Constraint เพื่อให้แน่ใจว่ามีเพียงขอบเขตเดียวที่ถูกกำหนดในแต่ละแถว + CONSTRAINT chk_scope CHECK ( + (organization_id IS NOT NULL AND project_id IS NULL AND contract_id IS NULL) OR + (organization_id IS NULL AND project_id IS NOT NULL AND contract_id IS NULL) OR + (organization_id IS NULL AND project_id IS NULL AND contract_id IS NOT NULL) OR + (organization_id IS NULL AND project_id IS NULL AND contract_id IS NULL) -- สำหรับ Global scope + ) +); + +CREATE TABLE project_organizations ( + project_id INT NOT NULL, + organization_id INT NOT NULL, + PRIMARY KEY (project_id, organization_id), + FOREIGN KEY (project_id) REFERENCES projects(id) ON DELETE CASCADE, + FOREIGN KEY (organization_id) REFERENCES organizations(id) ON DELETE CASCADE +); + +CREATE TABLE contract_organizations ( + contract_id INT NOT NULL, + organization_id INT NOT NULL, + role_in_contract VARCHAR(100), -- เช่น 'Owner', 'Designer', 'Consultant', 'Contractor' + PRIMARY KEY (contract_id, organization_id), + FOREIGN KEY (contract_id) REFERENCES contracts(id) ON DELETE CASCADE, + FOREIGN KEY (organization_id) REFERENCES organizations(id) ON DELETE CASCADE +); + +-- ===================================================== +-- == 4. การเชื่อมโยงโครงการกับองค์กร (project_organizations) == +-- ===================================================== + +-- โครงการหลัก (LCBP3) จะมีองค์กรหลักๆ เข้ามาเกี่ยวข้องทั้งหมด +INSERT INTO project_organizations (project_id, organization_id) +SELECT + (SELECT id FROM projects WHERE project_code = 'LCBP3'), + id +FROM organizations +WHERE organization_code IN ('กทท.', 'สคฉ.3', 'TEAM', 'คคง.', 'ผรม.1', 'ผรม.2', 'ผรม.3', 'ผรม.4', 'EN', 'CAR'); + +-- โครงการย่อย (LCBP3C1) จะมีเฉพาะองค์กรที่เกี่ยวข้อง +INSERT INTO project_organizations (project_id, organization_id) +SELECT + (SELECT id FROM projects WHERE project_code = 'LCBP3C1'), + id +FROM organizations +WHERE organization_code IN ('กทท.', 'สคฉ.3', 'สคฉ.3-02', 'คคง.', 'ผรม.1'); + +-- ทำเช่นเดียวกันสำหรับโครงการอื่นๆ (ตัวอย่าง) +INSERT INTO project_organizations (project_id, organization_id) +SELECT + (SELECT id FROM projects WHERE project_code = 'LCBP3C2'), + id +FROM organizations +WHERE organization_code IN ('กทท.', 'สคฉ.3', 'สคฉ.3-03', 'คคง.', 'ผรม.2'); + + +-- ===================================================== +-- == 5. การเชื่อมโยงสัญญากับองค์กร (contract_organizations) == +-- ===================================================== + +-- สัญญาที่ปรึกษาออกแบบ (DSLCBP3) +INSERT INTO contract_organizations (contract_id, organization_id, role_in_contract) +VALUES + ((SELECT id FROM contracts WHERE contract_code = 'DSLCBP3'), (SELECT id FROM organizations WHERE organization_code = 'กทท.'), 'Owner'), + ((SELECT id FROM contracts WHERE contract_code = 'DSLCBP3'), (SELECT id FROM organizations WHERE organization_code = 'TEAM'), 'Designer'); + +-- สัญญาที่ปรึกษาควบคุมงาน (PSLCBP3) +INSERT INTO contract_organizations (contract_id, organization_id, role_in_contract) +VALUES + ((SELECT id FROM contracts WHERE contract_code = 'PSLCBP3'), (SELECT id FROM organizations WHERE organization_code = 'กทท.'), 'Owner'), + ((SELECT id FROM contracts WHERE contract_code = 'PSLCBP3'), (SELECT id FROM organizations WHERE organization_code = 'คคง.'), 'Consultant'); + +-- สัญญางานก่อสร้าง ส่วนที่ 1 (LCBP3-C1) +INSERT INTO contract_organizations (contract_id, organization_id, role_in_contract) +VALUES + ((SELECT id FROM contracts WHERE contract_code = 'LCBP3-C1'), (SELECT id FROM organizations WHERE organization_code = 'กทท.'), 'Owner'), + ((SELECT id FROM contracts WHERE contract_code = 'LCBP3-C1'), (SELECT id FROM organizations WHERE organization_code = 'ผรม.1'), 'Contractor'); + +-- สัญญางานก่อสร้าง ส่วนที่ 2 (LCBP3-C2) +INSERT INTO contract_organizations (contract_id, organization_id, role_in_contract) +VALUES + ((SELECT id FROM contracts WHERE contract_code = 'LCBP3-C2'), (SELECT id FROM organizations WHERE organization_code = 'กทท.'), 'Owner'), + ((SELECT id FROM contracts WHERE contract_code = 'LCBP3-C2'), (SELECT id FROM organizations WHERE organization_code = 'ผรม.2'), 'Contractor'); + +-- สัญญาตรวจสอบสิ่งแวดล้อม (ENLCBP3) +INSERT INTO contract_organizations (contract_id, organization_id, role_in_contract) +VALUES + ((SELECT id FROM contracts WHERE contract_code = 'ENLCBP3'), (SELECT id FROM organizations WHERE organization_code = 'กทท.'), 'Owner'), + ((SELECT id FROM contracts WHERE contract_code = 'ENLCBP3'), (SELECT id FROM organizations WHERE organization_code = 'EN'), 'Consultant'); + +-- ===================================================== +-- 3. ✉️ Correspondences (เอกสารหลัก, Revisions) +-- ===================================================== + +-- ตาราง Master เก็บประเภทเอกสารโต้ตอบ +CREATE TABLE correspondence_types ( + id INT PRIMARY KEY AUTO_INCREMENT COMMENT 'ID ของตาราง', + type_code VARCHAR(50) NOT NULL UNIQUE COMMENT 'รหัสประเภท (เช่น RFA, RFI)', + 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='ตาราง Master เก็บประเภทเอกสารโต้ตอบ'; +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); + +-- ตาราง Master เก็บสถานะของเอกสาร +CREATE TABLE correspondence_status ( + id INT PRIMARY KEY AUTO_INCREMENT COMMENT 'ID ของตาราง', + status_code VARCHAR(50) NOT NULL UNIQUE COMMENT 'รหัสสถานะหนังสือ (เช่น DRAFT, SUBOWN)', + 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='ตาราง Master เก็บสถานะของเอกสาร'; +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); + +-- ตาราง "แม่" ของเอกสารโต้ตอบ เก็บข้อมูลที่ไม่เปลี่ยนตาม Revision +CREATE TABLE correspondences ( + id INT PRIMARY KEY AUTO_INCREMENT COMMENT 'ID ของตาราง (นี่คือ "Master ID" ที่ใช้เชื่อมโยง)', + correspondence_number VARCHAR(100) NOT NULL COMMENT 'เลขที่เอกสาร (สร้างจาก DocumentNumberingModule)', + correspondence_type_id INT NOT NULL COMMENT 'ประเภทเอกสาร', + is_internal_communication TINYINT(1) DEFAULT 0 COMMENT '(1 = ภายใน, 0 = ภายนอก)', + project_id INT NOT NULL COMMENT 'อยู่ในโครงการ', + originator_id INT COMMENT 'องค์กรผู้ส่ง', + created_at DATETIME DEFAULT CURRENT_TIMESTAMP COMMENT 'วันที่สร้าง', + created_by INT COMMENT 'ผู้สร้าง', + deleted_at DATETIME NULL COMMENT 'สำหรับ Soft Delete', + FOREIGN KEY (correspondence_type_id) REFERENCES correspondence_types(id) ON DELETE RESTRICT, + FOREIGN KEY (project_id) REFERENCES projects(id) ON DELETE CASCADE, + FOREIGN KEY (originator_id) REFERENCES organizations(id) ON DELETE SET NULL, + FOREIGN KEY (created_by) REFERENCES users(user_id) ON DELETE SET NULL, + UNIQUE KEY uq_corr_no_per_project (project_id, correspondence_number) +) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_general_ci COMMENT='ตาราง "แม่" ของเอกสารโต้ตอบ เก็บข้อมูลที่ไม่เปลี่ยนตาม Revision'; + +-- ตาราง "ลูก" เก็บประวัติการแก้ไข (Revisions) ของ correspondences (1:N) +CREATE TABLE correspondence_revisions ( + id INT PRIMARY KEY AUTO_INCREMENT COMMENT 'ID ของ Revision', + correspondence_id INT NOT NULL COMMENT 'Master ID', + revision_number INT NOT NULL COMMENT 'หมายเลข Revision (0, 1, 2...)', + revision_label VARCHAR(10) COMMENT 'Revision ที่แสดง (เช่น A, B, 1.1)', + is_current BOOLEAN DEFAULT FALSE COMMENT '(1 = Revision ปัจจุบัน)', + correspondence_status_id INT NOT NULL COMMENT 'สถานะของ Revision นี้', + title VARCHAR(255) NOT NULL COMMENT 'เรื่อง', + document_date DATE COMMENT 'วันที่ในเอกสาร', + issued_date DATETIME COMMENT 'วันที่ออกเอกสาร', + received_date DATETIME COMMENT 'วันที่ลงรับเอกสาร', + due_date DATETIME COMMENT 'วันที่ครบกำหนด', + description TEXT COMMENT 'คำอธิบายการแก้ไขใน Revision นี้', + details JSON COMMENT 'ข้อมูลเฉพาะ (เช่น RFI details)', + created_at DATETIME DEFAULT CURRENT_TIMESTAMP COMMENT 'วันที่สร้างเอกสาร', + created_by INT COMMENT 'ผู้สร้าง', + updated_by INT COMMENT 'ผู้แก้ไขล่าสุด', + FOREIGN KEY (correspondence_id) REFERENCES correspondences(id) ON DELETE CASCADE, + FOREIGN KEY (correspondence_status_id) REFERENCES correspondence_status(id) ON DELETE RESTRICT, + FOREIGN KEY (created_by) REFERENCES users(user_id) ON DELETE SET NULL, + FOREIGN KEY (updated_by) REFERENCES users(user_id) ON DELETE SET NULL, + UNIQUE KEY uq_master_revision_number (correspondence_id, revision_number), + UNIQUE KEY uq_master_current (correspondence_id, is_current) +) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_general_ci COMMENT='ตาราง "ลูก" เก็บประวัติการแก้ไข (Revisions) ของ correspondences (1:N)'; + +-- ตารางเชื่อมผู้รับ (TO/CC) สำหรับเอกสารแต่ละฉบับ (M:N) +CREATE TABLE correspondence_recipients ( + correspondence_id INT COMMENT 'ID ของเอกสาร', + recipient_organization_id INT COMMENT 'ID องค์กรผู้รับ', + recipient_type ENUM('TO', 'CC') COMMENT 'ประเภทผู้รับ (TO หรือ CC)', + PRIMARY KEY (correspondence_id, recipient_organization_id, recipient_type), + FOREIGN KEY (correspondence_id) REFERENCES correspondence_revisions(correspondence_id) ON DELETE CASCADE, + FOREIGN KEY (recipient_organization_id) REFERENCES organizations(id) ON DELETE RESTRICT +) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_general_ci COMMENT='ตารางเชื่อมผู้รับ (TO/CC) สำหรับเอกสารแต่ละฉบับ (M:N)'; + +-- ตาราง Master เก็บ Tags ทั้งหมดที่ใช้ในระบบ +CREATE TABLE tags ( + id INT PRIMARY KEY AUTO_INCREMENT COMMENT 'ID ของตาราง', + tag_name VARCHAR(100) NOT NULL UNIQUE COMMENT 'ชื่อ Tag', + description TEXT COMMENT 'คำอธิบายแท็ก', + created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP COMMENT 'วันที่สร้าง', + updated_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP COMMENT 'วันที่แก้ไขล่าสุด' +) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_general_ci COMMENT='ตาราง Master เก็บ Tags ทั้งหมดที่ใช้ในระบบ'; + +-- ตารางเชื่อมระหว่าง correspondences และ tags (M:N) +CREATE TABLE correspondence_tags ( + correspondence_id INT COMMENT 'ID ของเอกสาร', + tag_id INT COMMENT 'ID ของ Tag', + PRIMARY KEY (correspondence_id, tag_id), + FOREIGN KEY (correspondence_id) REFERENCES correspondences(id) ON DELETE CASCADE, + FOREIGN KEY (tag_id) REFERENCES tags(id) ON DELETE CASCADE +) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_general_ci COMMENT='ตารางเชื่อมระหว่าง correspondences และ tags (M:N)'; + +-- ตารางเชื่อมการอ้างอิงระหว่างเอกสาร (M:N) +CREATE TABLE correspondence_references ( + src_correspondence_id INT COMMENT 'ID เอกสารต้นทาง', + tgt_correspondence_id INT COMMENT 'ID เอกสารเป้าหมาย', + PRIMARY KEY (src_correspondence_id, tgt_correspondence_id), + FOREIGN KEY (src_correspondence_id) REFERENCES correspondences(id) ON DELETE CASCADE, + FOREIGN KEY (tgt_correspondence_id) REFERENCES correspondences(id) ON DELETE CASCADE +) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_general_ci COMMENT='ตารางเชื่อมการอ้างอิงระหว่างเอกสาร (M:N)'; + +-- ===================================================== +-- 4. 📐 approval: RFA (เอกสารขออนุมัติ, Workflows) +-- ===================================================== +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='แม่แบบสายงานการส่งต่อเอกสารขออนุมัติ'; + +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 การส่งต่อเอกสารทั่วไป'; + +-- ตาราง Master สำหรับประเภท RFA +CREATE TABLE rfa_types ( + id INT PRIMARY KEY AUTO_INCREMENT COMMENT 'ID ของตาราง', + type_code VARCHAR(20) NOT NULL UNIQUE COMMENT 'รหัสประเภท RFA (เช่น DWG, DOC, MAT)', + type_name VARCHAR(100) NOT NULL COMMENT 'ชื่อประเภท RFA', + description TEXT COMMENT 'คำอธิบาย', + sort_order INT DEFAULT 0 COMMENT 'ลำดับการแสดงผล', + is_active TINYINT(1) DEFAULT 1 COMMENT 'สถานะการใช้งาน' +) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_general_ci COMMENT='ตาราง Master สำหรับประเภท RFA'; +INSERT INTO rfa_types (type_code, type_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); + +-- ตาราง Master สำหรับสถานะ RFA +CREATE TABLE rfa_status_codes ( + id INT PRIMARY KEY AUTO_INCREMENT COMMENT 'ID ของตาราง', + status_code VARCHAR(20) NOT NULL UNIQUE COMMENT 'รหัสสถานะ RFA (เช่น DFT - Draft, FAP - For Approve)', + status_name VARCHAR(100) NOT NULL COMMENT 'ชื่อสถานะ', + description TEXT COMMENT 'คำอธิบาย', + sort_order INT DEFAULT 0 COMMENT 'ลำดับการแสดงผล', + is_active TINYINT(1) DEFAULT 1 COMMENT 'สถานะการใช้งาน' +) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_general_ci COMMENT='ตาราง Master สำหรับสถานะ RFA'; +INSERT INTO rfa_status_codes (status_code, status_name, 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); + +-- ตาราง Master สำหรับรหัสผลการอนุมัติ RFA +CREATE TABLE rfa_approve_codes ( + id INT PRIMARY KEY AUTO_INCREMENT COMMENT 'ID ของตาราง', + approve_code VARCHAR(20) NOT NULL UNIQUE COMMENT 'รหัสผลการอนุมัติ (เช่น 1A - Approved, 3R - Revise and Resubmit)', + approve_name VARCHAR(100) NOT NULL COMMENT 'ชื่อผลการอนุมัติ', + description TEXT COMMENT 'คำอธิบาย', + sort_order INT DEFAULT 0 COMMENT 'ลำดับการแสดงผล', + is_active TINYINT(1) DEFAULT 1 COMMENT 'สถานะการใช้งาน' +) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_general_ci COMMENT='ตาราง Master สำหรับรหัสผลการอนุมัติ RFA'; +INSERT INTO rfa_approve_codes (approve_code, approve_name, 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); + +-- ตาราง "แม่" ของ RFA (มีความสัมพันธ์ 1:N กับ rfa_revisions) +CREATE TABLE rfas ( + id INT PRIMARY KEY AUTO_INCREMENT COMMENT 'ID ของตาราง (RFA Master ID)', + rfa_type_id INT NOT NULL COMMENT 'ประเภท RFA', + created_at DATETIME DEFAULT CURRENT_TIMESTAMP COMMENT 'วันที่สร้าง', + created_by INT COMMENT 'ผู้สร้าง', + deleted_at DATETIME NULL COMMENT 'สำหรับ Soft Delete', + FOREIGN KEY (rfa_type_id) REFERENCES rfa_types(id), + FOREIGN KEY (created_by) REFERENCES users(user_id) ON DELETE SET NULL +) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_general_ci COMMENT='ตาราง "แม่" ของ RFA (มีความสัมพันธ์ 1:N กับ rfa_revisions)'; + +-- ตาราง "ลูก" เก็บประวัติ (Revisions) ของ rfas (1:N) +CREATE TABLE rfa_revisions ( + id INT PRIMARY KEY AUTO_INCREMENT COMMENT 'ID ของ Revision', + correspondence_id INT NOT NULL COMMENT 'Master ID ของ Correspondence', + rfa_id INT NOT NULL COMMENT 'Master ID ของ RFA', + revision_number INT NOT NULL COMMENT 'หมายเลข Revision (0, 1, 2...)', + revision_label VARCHAR(10) COMMENT 'Revision ที่แสดง (เช่น A, B, 1.1)', + is_current BOOLEAN DEFAULT FALSE COMMENT '(1 = Revision ปัจจุบัน)', + rfa_status_code_id INT NOT NULL COMMENT 'สถานะ RFA', + rfa_approve_code_id INT COMMENT 'ผลการอนุมัติ', + title VARCHAR(255) NOT NULL COMMENT 'เรื่อง', + document_date DATE COMMENT 'วันที่ในเอกสาร', + issued_date DATE COMMENT 'วันที่ส่งขออนุมัติ', + received_date DATETIME COMMENT 'วันที่ลงรับเอกสาร', + approved_date DATE COMMENT 'วันที่อนุมัติ', + description TEXT COMMENT 'คำอธิบายการแก้ไขใน Revision นี้', + created_at DATETIME DEFAULT CURRENT_TIMESTAMP COMMENT 'วันที่สร้างเอกสาร', + created_by INT COMMENT 'ผู้สร้าง', + updated_by INT COMMENT 'ผู้แก้ไขล่าสุด', + FOREIGN KEY (correspondence_id) REFERENCES correspondences(id) ON DELETE CASCADE, + FOREIGN KEY (rfa_id) REFERENCES rfas(id) ON DELETE CASCADE, + FOREIGN KEY (rfa_status_code_id) REFERENCES rfa_status_codes(id), + FOREIGN KEY (rfa_approve_code_id) REFERENCES rfa_approve_codes(id) ON DELETE SET NULL, + FOREIGN KEY (created_by) REFERENCES users(user_id) ON DELETE SET NULL, + FOREIGN KEY (updated_by) REFERENCES users(user_id) ON DELETE SET NULL, + UNIQUE KEY uq_rr_rev_number (rfa_id, revision_number), + UNIQUE KEY uq_rr_current (rfa_id, is_current) +) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_general_ci COMMENT='ตาราง "ลูก" เก็บประวัติ (Revisions) ของ rfas (1:N)'; + +-- ตารางเชื่อมระหว่าง rfa_revisions (ที่เป็นประเภท DWG) กับ shop_drawing_revisions (M:N) +CREATE TABLE rfa_items ( + rfarev_correspondence_id INT COMMENT 'ID ของ RFA Revision', + shop_drawing_revision_id INT COMMENT 'ID ของ Shop Drawing Revision', + PRIMARY KEY (rfarev_correspondence_id, shop_drawing_revision_id), + FOREIGN KEY (rfarev_correspondence_id) REFERENCES rfa_revisions(correspondence_id) ON DELETE CASCADE, + FOREIGN KEY (shop_drawing_revision_id) REFERENCES shop_drawing_revisions(id) ON DELETE CASCADE +) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_general_ci COMMENT='ตารางเชื่อมระหว่าง rfa_revisions (ที่เป็นประเภท DWG) กับ shop_drawing_revisions (M:N)'; + +-- ตาราง Master เก็บแม่แบบสายอนุมัติ +CREATE TABLE rfa_workflow_templates ( + id INT PRIMARY KEY AUTO_INCREMENT COMMENT 'ID ของตาราง', + template_name VARCHAR(100) NOT NULL COMMENT 'ชื่อแม่แบบสายอนุมัติ', + description TEXT COMMENT 'คำอธิบาย', + is_active TINYINT(1) DEFAULT 1 COMMENT 'สถานะการใช้งาน', + created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP COMMENT 'วันที่สร้าง', + updated_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP COMMENT 'วันที่แก้ไขล่าสุด' +) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_general_ci COMMENT='ตาราง Master เก็บแม่แบบสายอนุมัติ'; + +-- ตารางลูก เก็บขั้นตอนในแม่แบบ +CREATE TABLE rfa_workflow_template_steps ( + id INT PRIMARY KEY AUTO_INCREMENT COMMENT 'ID ของตาราง', + template_id INT NOT NULL COMMENT 'ID ของแม่แบบ', + step_number INT NOT NULL COMMENT 'ลำดับขั้นตอน', + organization_id INT NOT NULL COMMENT 'องค์กรที่รับผิดชอบ', + role_id INT COMMENT 'บทบาทที่รับผิดชอบ', + action_type ENUM('REVIEW', 'APPROVE', 'ACKNOWLEDGE') COMMENT 'ประเภทการกระทำ', + duration_days INT COMMENT 'ระยะเวลาที่กำหนด (วัน)', + is_optional BOOLEAN DEFAULT FALSE COMMENT 'เป็นขั้นตอนเลือกหรือไม่', + FOREIGN KEY (template_id) REFERENCES rfa_workflow_templates(id) ON DELETE CASCADE, + FOREIGN KEY (organization_id) REFERENCES organizations(id), + FOREIGN KEY (role_id) REFERENCES roles(role_id) +) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_general_ci COMMENT='ตารางลูก เก็บขั้นตอนในแม่แบบ'; + +-- ตารางประวัติ (Log) การอนุมัติของ RFA จริงตามสายงาน +CREATE TABLE rfa_workflows ( + id INT PRIMARY KEY AUTO_INCREMENT COMMENT 'ID ของตาราง', + rfa_revision_id INT NOT NULL COMMENT 'ID ของ RFA Revision', + step_number INT NOT NULL COMMENT 'ลำดับขั้นตอน', + organization_id INT NOT NULL COMMENT 'องค์กรที่รับผิดชอบ', + assigned_to INT COMMENT 'ผู้ใช้ที่ได้รับมอบหมาย', + action_type ENUM('REVIEW', 'APPROVE', 'ACKNOWLEDGE') COMMENT 'ประเภทการกระทำ', + status ENUM('PENDING', 'IN_PROGRESS', 'COMPLETED', 'REJECTED') COMMENT 'สถานะ', + comments TEXT COMMENT 'ความคิดเห็น', + completed_at DATETIME COMMENT 'วันที่เสร็จสิ้น', + created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP COMMENT 'วันที่สร้าง', + updated_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP COMMENT 'วันที่แก้ไขล่าสุด', + FOREIGN KEY (rfa_revision_id) REFERENCES rfa_revisions(id) ON DELETE CASCADE, + FOREIGN KEY (organization_id) REFERENCES organizations(id), + FOREIGN KEY (assigned_to) REFERENCES users(user_id) +) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_general_ci COMMENT='ตารางประวัติ (Log) การอนุมัติของ RFA จริงตามสายงาน'; + +-- ===================================================== +-- 5. 📐 Drawings (แบบ, หมวดหมู่) +-- ===================================================== + +-- ตาราง Master สำหรับ "เล่ม" ของแบบคู่สัญญา +CREATE TABLE contract_drawing_volumes ( + id INT PRIMARY KEY AUTO_INCREMENT COMMENT 'ID ของตาราง', + project_id INT NOT NULL COMMENT 'โครงการ', + volume_code VARCHAR(50) NOT NULL COMMENT 'รหัสเล่ม', + volume_name VARCHAR(255) NOT NULL COMMENT 'ชื่อเล่ม', + description TEXT COMMENT 'คำอธิบาย', + sort_order INT DEFAULT 0 COMMENT 'ลำดับการแสดงผล', + created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP COMMENT 'วันที่สร้าง', + updated_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP COMMENT 'วันที่แก้ไขล่าสุด', + FOREIGN KEY (project_id) REFERENCES projects(id) ON DELETE CASCADE, + UNIQUE KEY ux_volume_project (project_id, volume_code) +) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_general_ci COMMENT='ตาราง Master สำหรับ "เล่ม" ของแบบคู่สัญญา'; + +-- ตาราง Master สำหรับ "หมวดหมู่หลัก" ของแบบคู่สัญญา +CREATE TABLE contract_drawing_cats ( + id INT PRIMARY KEY AUTO_INCREMENT COMMENT 'ID ของตาราง', + project_id INT NOT NULL COMMENT 'โครงการ', + cat_code VARCHAR(50) NOT NULL COMMENT 'รหัสหมวดหมู่หลัก', + cat_name VARCHAR(255) NOT NULL COMMENT 'ชื่อหมวดหมู่หลัก', + description TEXT COMMENT 'คำอธิบาย', + sort_order INT DEFAULT 0 COMMENT 'ลำดับการแสดงผล', + created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP COMMENT 'วันที่สร้าง', + updated_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP COMMENT 'วันที่แก้ไขล่าสุด', + FOREIGN KEY (project_id) REFERENCES projects(id) ON DELETE CASCADE, + UNIQUE KEY ux_cat_project (project_id, cat_code) +) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_general_ci COMMENT='ตาราง Master สำหรับ "หมวดหมู่หลัก" ของแบบคู่สัญญา'; + +-- ตาราง Master สำหรับ "หมวดหมู่ย่อย" ของแบบคู่สัญญา +CREATE TABLE contract_drawing_sub_cats ( + id INT PRIMARY KEY AUTO_INCREMENT COMMENT 'ID ของตาราง', + project_id INT NOT NULL COMMENT 'โครงการ', + sub_cat_code VARCHAR(50) NOT NULL COMMENT 'รหัสหมวดหมู่ย่อย', + sub_cat_name VARCHAR(255) NOT NULL COMMENT 'ชื่อหมวดหมู่ย่อย', + description TEXT COMMENT 'คำอธิบาย', + sort_order INT DEFAULT 0 COMMENT 'ลำดับการแสดงผล', + created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP COMMENT 'วันที่สร้าง', + updated_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP COMMENT 'วันที่แก้ไขล่าสุด', + FOREIGN KEY (project_id) REFERENCES projects(id) ON DELETE CASCADE, + UNIQUE KEY ux_subcat_project (project_id, sub_cat_code) +) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_general_ci COMMENT='ตาราง Master สำหรับ "หมวดหมู่ย่อย" ของแบบคู่สัญญา'; + +-- ตารางเชื่อมระหว่าง หมวดหมู่หลัก-ย่อย (M:N) +CREATE TABLE contract_drawing_subcat_cat_maps ( + project_id INT COMMENT 'ID ของโครงการ', + sub_cat_id INT COMMENT 'ID ของหมวดหมู่ย่อย', + cat_id INT COMMENT 'ID ของหมวดหมู่หลัก', + PRIMARY KEY (project_id, sub_cat_id, cat_id), + FOREIGN KEY (project_id) REFERENCES projects(id) ON DELETE CASCADE, + FOREIGN KEY (sub_cat_id) REFERENCES contract_drawing_sub_cats(id) ON DELETE CASCADE, + FOREIGN KEY (cat_id) REFERENCES contract_drawing_cats(id) ON DELETE CASCADE +) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_general_ci COMMENT='ตารางเชื่อมระหว่าง หมวดหมู่หลัก-ย่อย (M:N)'; + +-- ตาราง Master เก็บข้อมูล "แบบคู่สัญญา" +CREATE TABLE contract_drawings ( + id INT PRIMARY KEY AUTO_INCREMENT COMMENT 'ID ของตาราง', + project_id INT NOT NULL COMMENT 'โครงการ', + condwg_no VARCHAR(255) NOT NULL COMMENT 'เลขที่แบบสัญญา', + title VARCHAR(255) NOT NULL COMMENT 'ชื่อแบบสัญญา', + sub_cat_id INT COMMENT 'หมวดหมู่ย่อย', + volume_id INT COMMENT 'เล่ม', + created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP COMMENT 'วันที่สร้าง', + updated_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP COMMENT 'วันที่แก้ไขล่าสุด', + deleted_at DATETIME NULL COMMENT 'วันที่ลบ', + updated_by INT COMMENT 'ผู้แก้ไขล่าสุด', + FOREIGN KEY (project_id) REFERENCES projects(id) ON DELETE CASCADE, + FOREIGN KEY (sub_cat_id) REFERENCES contract_drawing_sub_cats(id) ON DELETE RESTRICT, + FOREIGN KEY (volume_id) REFERENCES contract_drawing_volumes(id) ON DELETE RESTRICT, + UNIQUE KEY ux_condwg_no_project (project_id, condwg_no) +) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_general_ci COMMENT='ตาราง Master เก็บข้อมูล "แบบคู่สัญญา"'; + +-- ตาราง Master สำหรับ "หมวดหมู่หลัก" ของแบบก่อสร้าง +CREATE TABLE shop_drawing_main_categories ( + id INT PRIMARY KEY AUTO_INCREMENT COMMENT 'ID ของตาราง', + main_category_code VARCHAR(50) NOT NULL UNIQUE COMMENT 'รหัสหมวดหมู่หลัก (เช่น ARCH, STR)', + main_category_name VARCHAR(255) NOT NULL COMMENT 'ชื่อหมวดหมู่หลัก', + description TEXT COMMENT 'คำอธิบาย', + sort_order INT DEFAULT 0 COMMENT 'ลำดับการแสดงผล', + is_active TINYINT(1) DEFAULT 1 COMMENT 'สถานะการใช้งาน', + created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP COMMENT 'วันที่สร้าง', + updated_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP COMMENT 'วันที่แก้ไขล่าสุด' +) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_general_ci COMMENT='ตาราง Master สำหรับ "หมวดหมู่หลัก" ของแบบก่อสร้าง'; + +-- ตาราง Master สำหรับ "หมวดหมู่ย่อย" ของแบบก่อสร้าง +CREATE TABLE shop_drawing_sub_categories ( + id INT PRIMARY KEY AUTO_INCREMENT COMMENT 'ID ของตาราง', + sub_category_code VARCHAR(50) NOT NULL UNIQUE COMMENT 'รหัสหมวดหมู่ย่อย (เช่น STR-COLUMN)', + sub_category_name VARCHAR(255) NOT NULL COMMENT 'ชื่อหมวดหมู่ย่อย', + main_category_id INT NOT NULL COMMENT 'หมวดหมู่หลัก', + description TEXT COMMENT 'คำอธิบาย', + sort_order INT DEFAULT 0 COMMENT 'ลำดับการแสดงผล', + is_active TINYINT(1) DEFAULT 1 COMMENT 'สถานะการใช้งาน', + created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP COMMENT 'วันที่สร้าง', + updated_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP COMMENT 'วันที่แก้ไขล่าสุด', + FOREIGN KEY (main_category_id) REFERENCES shop_drawing_main_categories(id) +) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_general_ci COMMENT='ตาราง Master สำหรับ "หมวดหมู่ย่อย" ของแบบก่อสร้าง'; + +-- ตาราง Master เก็บข้อมูล "แบบก่อสร้าง" +CREATE TABLE shop_drawings ( + id INT PRIMARY KEY AUTO_INCREMENT COMMENT 'ID ของตาราง', + project_id INT NOT NULL COMMENT 'โครงการ', + drawing_number VARCHAR(100) NOT NULL UNIQUE COMMENT 'เลขที่ Shop Drawing', + title VARCHAR(500) NOT NULL COMMENT 'ชื่อแบบ', + main_category_id INT NOT NULL COMMENT 'หมวดหมู่หลัก', + sub_category_id INT NOT NULL COMMENT 'หมวดหมู่ย่อย', + created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP COMMENT 'วันที่สร้าง', + updated_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP COMMENT 'วันที่แก้ไขล่าสุด', + deleted_at DATETIME NULL COMMENT 'วันที่ลบ', + updated_by INT COMMENT 'ผู้แก้ไขล่าสุด', + FOREIGN KEY (project_id) REFERENCES projects(id), + FOREIGN KEY (main_category_id) REFERENCES shop_drawing_main_categories(id), + FOREIGN KEY (sub_category_id) REFERENCES shop_drawing_sub_categories(id) +) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_general_ci COMMENT='ตาราง Master เก็บข้อมูล "แบบก่อสร้าง"'; + +-- ตาราง "ลูก" เก็บประวัติ (Revisions) ของ shop_drawings (1:N) +CREATE TABLE shop_drawing_revisions ( + id INT PRIMARY KEY AUTO_INCREMENT COMMENT 'ID ของ Revision', + shop_drawing_id INT NOT NULL COMMENT 'Master ID', + revision_number INT NOT NULL COMMENT 'หมายเลข Revision (เช่น 0, 1, 2...)', + revision_label VARCHAR(10) COMMENT 'Revision ที่แสดง (เช่น A, B, 1.1)', + revision_date DATE COMMENT 'วันที่ของ Revision', + description TEXT COMMENT 'คำอธิบายการแก้ไข', + created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP COMMENT 'วันที่สร้าง', + FOREIGN KEY (shop_drawing_id) REFERENCES shop_drawings(id) ON DELETE CASCADE, + UNIQUE KEY ux_sd_rev_drawing_revision (shop_drawing_id, revision_number) +) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_general_ci COMMENT='ตาราง "ลูก" เก็บประวัติ (Revisions) ของ shop_drawings (1:N)'; + +-- ตารางเชื่อมระหว่าง shop_drawing_revisions กับ contract_drawings (M:N) +CREATE TABLE shop_drawing_revision_contract_refs ( + shop_drawing_revision_id INT COMMENT 'ID ของ Shop Drawing Revision', + contract_drawing_id INT COMMENT 'ID ของ Contract Drawing', + PRIMARY KEY (shop_drawing_revision_id, contract_drawing_id), + FOREIGN KEY (shop_drawing_revision_id) REFERENCES shop_drawing_revisions(id) ON DELETE CASCADE, + FOREIGN KEY (contract_drawing_id) REFERENCES contract_drawings(id) ON DELETE CASCADE +) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_general_ci COMMENT='ตารางเชื่อมระหว่าง shop_drawing_revisions กับ contract_drawings (M:N)'; + +-- ===================================================== +-- 6. 🔄 Circulations (ใบเวียนภายใน) +-- ===================================================== + +-- ตาราง Master เก็บสถานะใบเวียน +CREATE TABLE circulation_status_codes ( + id INT PRIMARY KEY AUTO_INCREMENT COMMENT 'ID ของตาราง', + code VARCHAR(20) NOT NULL UNIQUE COMMENT 'รหัสสถานะการดำเนินงาน', + description VARCHAR(50) 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='ตาราง Master เก็บสถานะใบเวียน'; +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); + +-- ตาราง "แม่" ของใบเวียนเอกสารภายใน +CREATE TABLE circulations ( + id INT PRIMARY KEY AUTO_INCREMENT COMMENT 'ID ของตารางใบเวียน', + correspondence_id INT UNIQUE COMMENT 'ID ของเอกสาร (จากตาราง correspondences)', + organization_id INT NOT NULL COMMENT 'ID ขององค์กรณ์ที่เป็นเจ้าของใบเวียนนี้', + circulation_no VARCHAR(100) NOT NULL COMMENT 'เลขที่ใบเวียน', + circulation_subject VARCHAR(500) NOT NULL COMMENT 'เรื่องใบเวียน', + circulation_status_code VARCHAR(20) NOT NULL COMMENT 'รหัสสถานะใบเวียน', + created_by_user_id INT NOT NULL COMMENT 'ID ของผู้สร้างใบเวียน', + submitted_at TIMESTAMP NULL COMMENT 'วันที่ส่งใบเวียน', + closed_at TIMESTAMP NULL COMMENT 'วันที่ปิดใบเวียน', + created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP COMMENT 'วันที่สร้าง', + updated_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP COMMENT 'วันที่แก้ไขล่าสุด', + FOREIGN KEY (correspondence_id) REFERENCES correspondences(id), + FOREIGN KEY (organization_id) REFERENCES organizations(id), + FOREIGN KEY (circulation_status_code) REFERENCES circulation_status_codes(code), + FOREIGN KEY (created_by_user_id) REFERENCES users(user_id) +) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_general_ci COMMENT='ตาราง "แม่" ของใบเวียนเอกสารภายใน'; + +-- ตาราง Master เก็บแม่แบบสายงาน +CREATE TABLE circulation_templates ( + id INT PRIMARY KEY AUTO_INCREMENT COMMENT 'ID ของตาราง', + template_name VARCHAR(100) NOT NULL COMMENT 'ชื่อแม่แบบสายงาน', + description TEXT COMMENT 'คำอธิบาย', + organization_id INT NOT NULL COMMENT 'องค์กรเจ้าของแม่แบบ', + is_active TINYINT(1) DEFAULT 1 COMMENT 'สถานะการใช้งาน', + created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP COMMENT 'วันที่สร้าง', + updated_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP COMMENT 'วันที่แก้ไขล่าสุด', + FOREIGN KEY (organization_id) REFERENCES organizations(id) +) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_general_ci COMMENT='ตาราง Master เก็บแม่แบบสายงาน'; + +-- ตารางลูก เก็บขั้นตอนในแม่แบบ +CREATE TABLE circulation_template_assignees ( + id INT PRIMARY KEY AUTO_INCREMENT COMMENT 'ID ของตาราง', + template_id INT NOT NULL COMMENT 'ID ของแม่แบบ', + step_number INT NOT NULL COMMENT 'ลำดับขั้นตอน', + organization_id INT NOT NULL COMMENT 'องค์กรที่รับผิดชอบ', + role_id INT COMMENT 'บทบาทที่รับผิดชอบ', + duration_days INT COMMENT 'ระยะเวลาที่กำหนด (วัน)', + is_optional BOOLEAN DEFAULT FALSE COMMENT 'เป็นขั้นตอนเลือกหรือไม่', + FOREIGN KEY (template_id) REFERENCES circulation_templates(id) ON DELETE CASCADE, + FOREIGN KEY (organization_id) REFERENCES organizations(id), + FOREIGN KEY (role_id) REFERENCES roles(role_id) +) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_general_ci COMMENT='ตารางลูก เก็บขั้นตอนในแม่แบบ'; + +-- ตารางประวัติ (Log) การส่งต่อของเอกสารจริงตาม Workflow +CREATE TABLE circulation_routings ( + id INT PRIMARY KEY AUTO_INCREMENT COMMENT 'ID ของตาราง', + circulation_id INT NOT NULL COMMENT 'ID ของใบเวียน', + step_number INT NOT NULL COMMENT 'ลำดับขั้นตอน', + organization_id INT NOT NULL COMMENT 'องค์กรที่รับผิดชอบ', + assigned_to INT COMMENT 'ผู้ใช้ที่ได้รับมอบหมาย', + status ENUM('PENDING', 'IN_PROGRESS', 'COMPLETED', 'REJECTED') COMMENT 'สถานะ', + comments TEXT COMMENT 'ความคิดเห็น', + completed_at DATETIME COMMENT 'วันที่เสร็จสิ้น', + created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP COMMENT 'วันที่สร้าง', + updated_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP COMMENT 'วันที่แก้ไขล่าสุด', + FOREIGN KEY (circulation_id) REFERENCES circulations(id) ON DELETE CASCADE, + FOREIGN KEY (organization_id) REFERENCES organizations(id), + FOREIGN KEY (assigned_to) REFERENCES users(user_id) +) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_general_ci COMMENT='ตารางประวัติ (Log) การส่งต่อของเอกสารจริงตาม Workflow'; + +-- ===================================================== +-- 7. 📤 Transmittals (เอกสารนำส่ง) +-- ===================================================== + +-- ตารางข้อมูลเฉพาะของเอกสารนำส่ง (เป็นตารางลูก 1:1 ของ correspondences) +CREATE TABLE transmittals ( + correspondence_id INT PRIMARY KEY COMMENT 'ID ของเอกสาร', + purpose ENUM('FOR_APPROVAL', 'FOR_INFORMATION', 'FOR_REVIEW', 'OTHER') COMMENT 'วัตถุประสงค์', + remarks TEXT COMMENT 'หมายเหตุ', + FOREIGN KEY (correspondence_id) REFERENCES correspondences(id) ON DELETE CASCADE +) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_general_ci COMMENT='ตารางข้อมูลเฉพาะของเอกสารนำส่ง (เป็นตารางลูก 1:1 ของ correspondences)'; + +-- ตารางเชื่อมระหว่าง transmittals และเอกสารที่นำส่ง (M:N) +CREATE TABLE transmittal_items ( + id INT PRIMARY KEY AUTO_INCREMENT COMMENT 'ID ของรายการ', + transmittal_id INT NOT NULL COMMENT 'ID ของ Transmittal', + item_correspondence_id INT NOT NULL COMMENT 'ID ของเอกสารที่แนบไป', + quantity INT DEFAULT 1 COMMENT 'จำนวน', + remarks VARCHAR(255) COMMENT 'หมายเหตุสำหรับรายการนี้', + FOREIGN KEY (transmittal_id) REFERENCES transmittals(correspondence_id) ON DELETE CASCADE, + FOREIGN KEY (item_correspondence_id) REFERENCES correspondences(id) ON DELETE CASCADE, + UNIQUE KEY ux_transmittal_item (transmittal_id, item_correspondence_id) +) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_general_ci COMMENT='ตารางเชื่อมระหว่าง transmittals และเอกสารที่นำส่ง (M:N)'; + +-- ===================================================== +-- 8. 📎 File Management (ไฟล์แนบ) +-- ===================================================== + +-- ตาราง "กลาง" เก็บไฟล์แนบทั้งหมดของระบบ +CREATE TABLE attachments ( + id INT PRIMARY KEY AUTO_INCREMENT 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 ที่เก็บไฟล์ (บน QNAP /share/dms-data/)', + mime_type VARCHAR(100) NOT NULL COMMENT 'ประเภทไฟล์ (เช่น application/pdf)', + file_size INT NOT NULL COMMENT 'ขนาดไฟล์ (bytes)', + uploaded_by_user_id INT NOT NULL COMMENT 'ผู้อัปโหลดไฟล์', + created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP COMMENT 'วันที่อัปโหลด', + FOREIGN KEY (uploaded_by_user_id) REFERENCES users(user_id) ON DELETE CASCADE +) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_general_ci COMMENT='ตาราง "กลาง" เก็บไฟล์แนบทั้งหมดของระบบ'; + +-- ตารางเชื่อม correspondences กับ attachments (M:N) +CREATE TABLE correspondence_attachments ( + correspondence_id INT COMMENT 'ID ของเอกสาร', + attachment_id INT COMMENT 'ID ของไฟล์แนบ', + is_main_document BOOLEAN DEFAULT FALSE COMMENT '(1 = ไฟล์หลัก)', + PRIMARY KEY (correspondence_id, attachment_id), + FOREIGN KEY (correspondence_id) REFERENCES correspondences(id) ON DELETE CASCADE, + FOREIGN KEY (attachment_id) REFERENCES attachments(id) ON DELETE CASCADE +) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_general_ci COMMENT='ตารางเชื่อม correspondences กับ attachments (M:N)'; + +-- ตารางเชื่อม circulations กับ attachments (M:N) +CREATE TABLE circulation_attachments ( + circulation_id INT COMMENT 'ID ของใบเวียน', + attachment_id INT COMMENT 'ID ของไฟล์แนบ', + is_main_document BOOLEAN DEFAULT FALSE COMMENT '(1 = ไฟล์หลักของใบเวียน)', + PRIMARY KEY (circulation_id, attachment_id), + FOREIGN KEY (circulation_id) REFERENCES circulations(id) ON DELETE CASCADE, + FOREIGN KEY (attachment_id) REFERENCES attachments(id) ON DELETE CASCADE +) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_general_ci COMMENT='ตารางเชื่อม circulations กับ attachments (M:N)'; + +-- ตารางเชื่อม shop_drawing_revisions กับ attachments (M:N) +CREATE TABLE shop_drawing_revision_attachments ( + shop_drawing_revision_id INT COMMENT 'ID ของ Shop Drawing Revision', + attachment_id INT COMMENT 'ID ของไฟล์แนบ', + file_type ENUM('PDF', 'DWG', 'SOURCE', 'OTHER') COMMENT 'ประเภทไฟล์', + is_main_document BOOLEAN DEFAULT FALSE COMMENT '(1 = ไฟล์หลัก)', + PRIMARY KEY (shop_drawing_revision_id, attachment_id), + FOREIGN KEY (shop_drawing_revision_id) REFERENCES shop_drawing_revisions(id) ON DELETE CASCADE, + FOREIGN KEY (attachment_id) REFERENCES attachments(id) ON DELETE CASCADE +) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_general_ci COMMENT='ตารางเชื่อม shop_drawing_revisions กับ attachments (M:N)'; + +-- ตารางเชื่อม contract_drawings กับ attachments (M:N) +CREATE TABLE contract_drawing_attachments ( + contract_drawing_id INT COMMENT 'ID ของ Contract Drawing', + attachment_id INT COMMENT 'ID ของไฟล์แนบ', + file_type ENUM('PDF', 'DWG', 'SOURCE', 'OTHER') COMMENT 'ประเภทไฟล์', + is_main_document BOOLEAN DEFAULT FALSE COMMENT '(1 = ไฟล์หลัก)', + PRIMARY KEY (contract_drawing_id, attachment_id), + FOREIGN KEY (contract_drawing_id) REFERENCES contract_drawings(id) ON DELETE CASCADE, + FOREIGN KEY (attachment_id) REFERENCES attachments(id) ON DELETE CASCADE +) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_general_ci COMMENT='ตารางเชื่อม contract_drawings กับ attachments (M:N)'; + +-- ===================================================== +-- 9. 🔢 Document Numbering (การสร้างเลขที่เอกสาร) +-- ===================================================== + +-- ตาราง Master เก็บ "รูปแบบ" Template ของเลขที่เอกสาร +CREATE TABLE document_number_formats ( + id INT PRIMARY KEY AUTO_INCREMENT COMMENT 'ID ของตาราง', + project_id INT NOT NULL COMMENT 'โครงการ', + correspondence_type_id INT NOT NULL COMMENT 'ประเภทเอกสาร', + format_template VARCHAR(255) NOT NULL COMMENT 'รูปแบบ Template (เช่น {ORG_CODE}-{TYPE_CODE}-{SEQ:4})', + description TEXT COMMENT 'คำอธิบายรูปแบบนี้', + created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP COMMENT 'วันที่สร้าง', + updated_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP COMMENT 'วันที่แก้ไขล่าสุด', + FOREIGN KEY (project_id) REFERENCES projects(id) ON DELETE CASCADE, + FOREIGN KEY (correspondence_type_id) REFERENCES correspondence_types(id) ON DELETE CASCADE, + UNIQUE KEY uk_project_type (project_id, correspondence_type_id) +) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_general_ci COMMENT='ตาราง Master เก็บ "รูปแบบ" Template ของเลขที่เอกสาร'; + +-- ตารางเก็บ "ตัวนับ" (Running Number) ล่าสุด +CREATE TABLE document_number_counters ( + project_id INT COMMENT 'โครงการ', + originator_organization_id INT COMMENT 'องค์กรผู้ส่ง', + correspondence_type_id INT COMMENT 'ประเภทเอกสาร', + current_year INT COMMENT 'ปี ค.ศ. ของตัวนับ', + last_number INT DEFAULT 0 COMMENT 'เลขที่ล่าสุดที่ใช้ไปแล้ว', + PRIMARY KEY (project_id, originator_organization_id, correspondence_type_id, current_year), + FOREIGN KEY (project_id) REFERENCES projects(id) ON DELETE CASCADE, + FOREIGN KEY (originator_organization_id) REFERENCES organizations(id) ON DELETE CASCADE, + FOREIGN KEY (correspondence_type_id) REFERENCES correspondence_types(id) ON DELETE CASCADE +) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_general_ci COMMENT='ตารางเก็บ "ตัวนับ" (Running Number) ล่าสุด'; + +-- ===================================================== +-- 10. ⚙️ System & Logs (ระบบและ Log) +-- ===================================================== +-- ตารางเก็บบันทึกการกระทำของผู้ใช้ +CREATE TABLE audit_logs ( + audit_id BIGINT PRIMARY KEY AUTO_INCREMENT COMMENT 'ID ของ Log', + user_id INT COMMENT 'ผู้กระทำ', + action VARCHAR(100) NOT NULL COMMENT 'การกระทำ (เช่น rfa.create, correspondence.update, login.success)', + entity_type VARCHAR(50) COMMENT 'ตาราง/โมดูล (เช่น ''rfa'', ''correspondence'')', + entity_id VARCHAR(50) COMMENT 'Primary ID ของระเบียนที่ได้รับผลกระทำ', + details_json JSON COMMENT 'ข้อมูลบริบท', + ip_address VARCHAR(45) COMMENT 'IP Address', + user_agent VARCHAR(255) COMMENT 'User Agent', + created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP COMMENT 'เวลาที่กระทำ', + FOREIGN KEY (user_id) REFERENCES users(user_id) ON DELETE SET NULL +) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_general_ci COMMENT='ตารางเก็บบันทึกการกระทำของผู้ใช้'; + +-- ตารางสำหรับจัดการการแจ้งเตือน (Email/Line/System) +CREATE TABLE notifications ( + id INT PRIMARY KEY AUTO_INCREMENT COMMENT 'ID ของการแจ้งเตือน', + user_id INT NOT NULL COMMENT 'ID ผู้ใช้', + title VARCHAR(255) NOT NULL COMMENT 'หัวข้อการแจ้งเตือน', + message TEXT NOT NULL COMMENT 'รายละเอียดการแจ้งเตือน', + notification_type ENUM('EMAIL', 'LINE', 'SYSTEM') NOT NULL COMMENT 'ประเภท (EMAIL, LINE, SYSTEM)', + is_read BOOLEAN DEFAULT FALSE COMMENT 'สถานะการอ่าน', + entity_type VARCHAR(50) COMMENT 'เช่น ''rfa'', ''circulation''', + entity_id INT COMMENT 'ID ของเอนทิตีที่เกี่ยวข้อง', + created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP COMMENT 'วันที่สร้าง', + FOREIGN KEY (user_id) REFERENCES users(user_id) ON DELETE CASCADE +) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_general_ci COMMENT='ตารางสำหรับจัดการการแจ้งเตือน (Email/Line/System)'; + +-- ตารางสำหรับจัดการดัชนีการค้นหาขั้นสูง (Full-text Search) +CREATE TABLE search_indices ( + id INT PRIMARY KEY AUTO_INCREMENT COMMENT 'ID ของดัชนี', + entity_type VARCHAR(50) NOT NULL COMMENT 'ชนิดเอนทิตี (เช่น ''correspondence'', ''rfa'')', + entity_id INT NOT NULL COMMENT 'ID ของเอนทิตี', + content TEXT NOT NULL COMMENT 'เนื้อหาที่จะค้นหา', + indexed_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP COMMENT 'วันที่สร้าง/อัปเดตัชนี' +) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_general_ci COMMENT='ตารางสำหรับจัดการดัชนีการค้นหาขั้นสูง (Full-text Search)'; + +-- ตารางสำหรับบันทึกประวัติการสำรองข้อมูล +CREATE TABLE backup_logs ( + id INT PRIMARY KEY AUTO_INCREMENT COMMENT 'ID ของการสำรอง', + backup_type ENUM('DATABASE', 'FILES', 'FULL') NOT NULL COMMENT 'ประเภท (DATABASE, FILES, FULL)', + backup_path VARCHAR(500) NOT NULL COMMENT 'ตำแหน่งไฟล์สำรอง', + file_size BIGINT COMMENT 'ขนาดไฟล์', + status ENUM('STARTED', 'COMPLETED', 'FAILED') NOT NULL COMMENT 'สถานะ', + started_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP COMMENT 'เวลาเริ่มต้น', + completed_at TIMESTAMP NULL COMMENT 'เวลาเสร็จสิ้น', + error_message TEXT COMMENT 'ข้อความผิดพลาด (ถ้ามี)' +) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_general_ci COMMENT='ตารางสำหรับบันทึกประวัติการสำรองข้อมูล'; + +-- ===================================================== +-- CREATE INDEXES +-- ===================================================== + +-- Indexes for document_number_formats +CREATE INDEX idx_document_number_formats_project ON document_number_formats(project_id); +CREATE INDEX idx_document_number_formats_type ON document_number_formats(correspondence_type_id); +CREATE INDEX idx_document_number_formats_project_type ON document_number_formats(project_id, correspondence_type_id); + +-- Indexes for document_number_counters +CREATE INDEX idx_document_number_counters_project ON document_number_counters(project_id); +CREATE INDEX idx_document_number_counters_org ON document_number_counters(originator_organization_id); +CREATE INDEX idx_document_number_counters_type ON document_number_counters(correspondence_type_id); +CREATE INDEX idx_document_number_counters_year ON document_number_counters(current_year); + +-- Indexes for tags +CREATE INDEX idx_tags_name ON tags(tag_name); +CREATE INDEX idx_tags_created_at ON tags(created_at); + +-- Indexes for correspondence_tags +CREATE INDEX idx_correspondence_tags_correspondence ON correspondence_tags(correspondence_id); +CREATE INDEX idx_correspondence_tags_tag ON correspondence_tags(tag_id); + +-- Indexes for audit_logs +CREATE INDEX idx_audit_logs_user ON audit_logs(user_id); +CREATE INDEX idx_audit_logs_action ON audit_logs(action); +CREATE INDEX idx_audit_logs_entity ON audit_logs(entity_type, entity_id); +CREATE INDEX idx_audit_logs_created_at ON audit_logs(created_at); +CREATE INDEX idx_audit_logs_ip ON audit_logs(ip_address); + +-- Indexes for notifications +CREATE INDEX idx_notifications_user ON notifications(user_id); +CREATE INDEX idx_notifications_type ON notifications(notification_type); +CREATE INDEX idx_notifications_read ON notifications(is_read); +CREATE INDEX idx_notifications_entity ON notifications(entity_type, entity_id); +CREATE INDEX idx_notifications_created_at ON notifications(created_at); + +-- Indexes for search_indices +CREATE INDEX idx_search_indices_entity ON search_indices(entity_type, entity_id); +CREATE INDEX idx_search_indices_indexed_at ON search_indices(indexed_at); +CREATE FULLTEXT INDEX idx_search_indices_content ON search_indices(content); + +-- Indexes for backup_logs +CREATE INDEX idx_backup_logs_type ON backup_logs(backup_type); +CREATE INDEX idx_backup_logs_status ON backup_logs(status); +CREATE INDEX idx_backup_logs_started_at ON backup_logs(started_at); +CREATE INDEX idx_backup_logs_completed_at ON backup_logs(completed_at); + +-- ===================================================== +-- Additional Composite Indexes for Performance +-- ===================================================== + +-- Composite index for document_number_counters for faster lookups +CREATE INDEX idx_doc_counter_composite ON document_number_counters(project_id, originator_organization_id, correspondence_type_id, current_year); + +-- Composite index for notifications for user-specific queries +CREATE INDEX idx_notifications_user_unread ON notifications(user_id, is_read, created_at); + +-- Composite index for audit_logs for reporting +CREATE INDEX idx_audit_logs_reporting ON audit_logs(created_at, entity_type, action); + +-- Composite index for search_indices for entity-based queries +CREATE INDEX idx_search_entities ON search_indices(entity_type, entity_id, indexed_at); + +-- ===================================================== +-- SQL Script for LCBP3-DMS (V1.4.0) - MariaDB +-- Generated from Data Dictionary +-- ===================================================== + +-- ===================================================== +-- 11. 📊 Views & Procedures (วิว และ โปรซีเดอร์) +-- ===================================================== + +-- Stored Procedure ดึงเลขที่เอกสารถัดไป +DELIMITER // + +CREATE PROCEDURE sp_get_next_document_number( + IN p_project_id INT, + IN p_originator_organization_id INT, + IN p_correspondence_type_id INT, + IN p_current_year INT, + OUT p_next_number INT +) +BEGIN + DECLARE EXIT HANDLER FOR SQLEXCEPTION + BEGIN + -- หากเกิดข้อผิดพลาด ให้ยกเลิก Transaction และส่ง Error กลับไป + ROLLBACK; + END; + + START TRANSACTION; + + -- ล็อกแถวเพื่อป้องกัน Race Condition + SELECT last_number INTO p_next_number + FROM document_number_counters + WHERE project_id = p_project_id + AND originator_organization_id = p_originator_organization_id + AND correspondence_type_id = p_correspondence_type_id + AND current_year = p_current_year + FOR UPDATE; + + -- ถ้าไม่พบ record ให้สร้างใหม่ + IF p_next_number IS NULL THEN + SET p_next_number = 1; + INSERT INTO document_number_counters + (project_id, originator_organization_id, correspondence_type_id, current_year, last_number) + VALUES (p_project_id, p_originator_organization_id, p_correspondence_type_id, p_current_year, p_next_number); + ELSE + -- อัพเดทเลขที่ล่าสุด + SET p_next_number = p_next_number + 1; + UPDATE document_number_counters + SET last_number = p_next_number + WHERE project_id = p_project_id + AND originator_organization_id = p_originator_organization_id + AND correspondence_type_id = p_correspondence_type_id + AND current_year = p_current_year; + END IF; + + COMMIT; +END // + +DELIMITER ; + +-- View แสดง Revision "ปัจจุบัน" ของ correspondences ทั้งหมด (ที่ไม่ใช่ RFA) +CREATE VIEW v_current_correspondences AS +SELECT + c.id AS correspondence_id, + c.correspondence_number, + c.correspondence_type_id, + ct.type_code AS correspondence_type_code, + ct.type_name AS correspondence_type_name, + c.project_id, + p.project_code, + p.project_name, + c.originator_id, + org.organization_code AS originator_code, + org.organization_name AS originator_name, + cr.id AS revision_id, + cr.revision_number, + cr.revision_label, + cr.title, + cr.document_date, + cr.issued_date, + cr.received_date, + cr.due_date, + cr.correspondence_status_id, + cs.status_code, + cs.status_name, + cr.created_by, + u.username AS created_by_username, + cr.created_at AS revision_created_at +FROM correspondences c +INNER JOIN correspondence_types ct ON c.correspondence_type_id = ct.id +INNER JOIN projects p ON c.project_id = p.id +LEFT JOIN organizations org ON c.originator_id = org.id +INNER JOIN correspondence_revisions cr ON c.id = cr.correspondence_id +INNER JOIN correspondence_status cs ON cr.correspondence_status_id = cs.id +LEFT JOIN users u ON cr.created_by = u.user_id +WHERE cr.is_current = TRUE + AND c.correspondence_type_id NOT IN (SELECT id FROM correspondence_types WHERE type_code = 'RFA') + AND c.deleted_at IS NULL; + +-- View แสดง Revision "ปัจจุบัน" ของ rfa_revisions ทั้งหมด +CREATE VIEW v_current_rfas AS +SELECT + r.id AS rfa_id, + r.rfa_type_id, + rt.type_code AS rfa_type_code, + rt.type_name AS rfa_type_name, + rr.correspondence_id, + c.correspondence_number, + c.project_id, + p.project_code, + p.project_name, + c.originator_id, + org.organization_name AS originator_name, + rr.id AS revision_id, + rr.revision_number, + rr.revision_label, + rr.title, + rr.document_date, + rr.issued_date, + rr.received_date, + rr.approved_date, + rr.rfa_status_code_id, + rsc.status_code AS rfa_status_code, + rsc.status_name AS rfa_status_name, + rr.rfa_approve_code_id, + rac.approve_code AS rfa_approve_code, + rac.approve_name AS rfa_approve_name, + rr.created_by, + u.username AS created_by_username, + rr.created_at AS revision_created_at +FROM rfas r +INNER JOIN rfa_types rt ON r.rfa_type_id = rt.id +INNER JOIN rfa_revisions rr ON r.id = rr.rfa_id +INNER JOIN correspondences c ON rr.correspondence_id = c.id +INNER JOIN projects p ON c.project_id = p.id +INNER JOIN organizations org ON c.originator_id = org.id +INNER JOIN rfa_status_codes rsc ON rr.rfa_status_code_id = rsc.id +LEFT JOIN rfa_approve_codes rac ON rr.rfa_approve_code_id = rac.id +LEFT JOIN users u ON rr.created_by = u.user_id +WHERE rr.is_current = TRUE + AND r.deleted_at IS NULL + AND c.deleted_at IS NULL; + +-- View แสดงความสัมพันธ์ทั้งหมดระหว่าง Contract, Project, และ Organization +CREATE VIEW v_contract_parties_all AS +SELECT + c.id AS contract_id, + c.contract_code, + c.contract_name, + p.id AS project_id, + p.project_code, + p.project_name, + o.id AS organization_id, + o.organization_code, + o.organization_name, + co.role_in_contract +FROM contracts c +INNER JOIN projects p ON c.project_id = p.id +INNER JOIN contract_organizations co ON c.id = co.contract_id +INNER JOIN organizations o ON co.organization_id = o.id +WHERE c.is_active = TRUE; + +-- View แสดงรายการ "งานของฉัน" (My Tasks) ที่ยังไม่เสร็จ +CREATE VIEW v_user_tasks AS +SELECT + cr.id AS routing_id, + c.id AS circulation_id, + c.circulation_no, + c.circulation_subject, + c.correspondence_id, + corr.correspondence_number, + corr.project_id, + p.project_code, + p.project_name, + cr.assigned_to AS user_id, + u.username, + u.first_name, + u.last_name, + cr.organization_id, + org.organization_name, + cr.step_number, + cr.status AS task_status, + cr.comments, + cr.completed_at, + cr.created_at AS assigned_at, + c.created_at AS circulation_created_at +FROM circulation_routings cr +INNER JOIN circulations c ON cr.circulation_id = c.id +INNER JOIN correspondences corr ON c.correspondence_id = corr.id +INNER JOIN projects p ON corr.project_id = p.id +INNER JOIN organizations org ON cr.organization_id = org.id +INNER JOIN users u ON cr.assigned_to = u.user_id +WHERE cr.status IN ('PENDING', 'IN_PROGRESS') + AND cr.assigned_to IS NOT NULL; + +-- View แสดง audit_logs พร้อมข้อมูล username และ email ของผู้กระทำ +CREATE VIEW v_audit_log_details AS +SELECT + al.audit_id, + al.user_id, + u.username, + u.email, + u.first_name, + u.last_name, + al.action, + al.entity_type, + al.entity_id, + al.details_json, + al.ip_address, + al.user_agent, + al.created_at +FROM audit_logs al +LEFT JOIN users u ON al.user_id = u.user_id; + +-- View รวมสิทธิ์ทั้งหมด (Global + Project) ของผู้ใช้ทุกคน +CREATE VIEW v_user_all_permissions AS +-- Global Permissions +SELECT + ua.user_id, + ua.role_id, + r.role_name, + rp.permission_id, + p.permission_name, + p.module, + p.scope_level, + ua.organization_id, + NULL AS project_id, + NULL AS contract_id, + 'GLOBAL' AS permission_scope +FROM user_assignments ua +INNER JOIN roles r ON ua.role_id = r.role_id +INNER JOIN role_permissions rp ON ua.role_id = rp.role_id +INNER JOIN permissions p ON rp.permission_id = p.permission_id +-- Global scope +WHERE p.is_active = 1 AND ua.organization_id IS NULL AND ua.project_id IS NULL AND ua.contract_id IS NULL + +UNION ALL + +-- Organization-specific Permissions +SELECT + ua.user_id, + ua.role_id, + r.role_name, + rp.permission_id, + p.permission_name, + p.module, + p.scope_level, + ua.organization_id, + NULL AS project_id, + NULL AS contract_id, + 'ORGANIZATION' AS permission_scope +FROM user_assignments ua +INNER JOIN roles r ON ua.role_id = r.role_id +INNER JOIN role_permissions rp ON ua.role_id = rp.role_id +INNER JOIN permissions p ON rp.permission_id = p.permission_id +-- Organization scope +WHERE p.is_active = 1 AND ua.organization_id IS NOT NULL AND ua.project_id IS NULL AND ua.contract_id IS NULL +UNION ALL + +-- Project-specific Permissions +SELECT + ua.user_id, + ua.role_id, + r.role_name, + rp.permission_id, + p.permission_name, + p.module, + p.scope_level, + ua.organization_id, + ua.project_id, + NULL AS contract_id, + 'PROJECT' AS permission_scope +FROM user_assignments ua +INNER JOIN roles r ON ua.role_id = r.role_id +INNER JOIN role_permissions rp ON ua.role_id = rp.role_id +INNER JOIN permissions p ON rp.permission_id = p.permission_id +-- Project scope + +WHERE p.is_active = 1 AND ua.project_id IS NOT NULL AND ua.contract_id IS NULL +UNION ALL + +-- Contract-specific Permissions +SELECT + ua.user_id, + ua.role_id, + r.role_name, + rp.permission_id, + p.permission_name, + p.module, + p.scope_level, + ua.organization_id, + ua.project_id, + ua.contract_id, + 'CONTRACT' AS permission_scope +FROM user_assignments ua +INNER JOIN roles r ON ua.role_id = r.role_id +INNER JOIN role_permissions rp ON ua.role_id = rp.role_id +INNER JOIN permissions p ON rp.permission_id = p.permission_id +-- Contract scope +WHERE p.is_active = 1 AND ua.contract_id IS NOT NULL; + +-- ===================================================== +-- Additional Useful Views +-- ===================================================== + +-- View แสดงเอกสารทั้งหมดที่มีไฟล์แนบ +CREATE VIEW v_documents_with_attachments AS +SELECT + 'CORRESPONDENCE' AS document_type, + c.id AS document_id, + c.correspondence_number AS document_number, + c.project_id, + p.project_code, + p.project_name, + COUNT(ca.attachment_id) AS attachment_count, + MAX(a.created_at) AS latest_attachment_date +FROM correspondences c +INNER JOIN projects p ON c.project_id = p.id +LEFT JOIN correspondence_attachments ca ON c.id = ca.correspondence_id +LEFT JOIN attachments a ON ca.attachment_id = a.id +WHERE c.deleted_at IS NULL +GROUP BY c.id, c.correspondence_number, c.project_id, p.project_code, p.project_name + +UNION ALL + +SELECT + 'CIRCULATION' AS document_type, + circ.id AS document_id, + circ.circulation_no AS document_number, + corr.project_id, + p.project_code, + p.project_name, + COUNT(ca.attachment_id) AS attachment_count, + MAX(a.created_at) AS latest_attachment_date +FROM circulations circ +INNER JOIN correspondences corr ON circ.correspondence_id = corr.id +INNER JOIN projects p ON corr.project_id = p.id +LEFT JOIN circulation_attachments ca ON circ.id = ca.circulation_id +LEFT JOIN attachments a ON ca.attachment_id = a.id +GROUP BY circ.id, circ.circulation_no, corr.project_id, p.project_code, p.project_name + +UNION ALL + +SELECT + 'SHOP_DRAWING' AS document_type, + sdr.id AS document_id, + sd.drawing_number AS document_number, + sd.project_id, + p.project_code, + p.project_name, + COUNT(sdra.attachment_id) AS attachment_count, + MAX(a.created_at) AS latest_attachment_date +FROM shop_drawing_revisions sdr +INNER JOIN shop_drawings sd ON sdr.shop_drawing_id = sd.id +INNER JOIN projects p ON sd.project_id = p.id +LEFT JOIN shop_drawing_revision_attachments sdra ON sdr.id = sdra.shop_drawing_revision_id +LEFT JOIN attachments a ON sdra.attachment_id = a.id +WHERE sd.deleted_at IS NULL +GROUP BY sdr.id, sd.drawing_number, sd.project_id, p.project_code, p.project_name + +UNION ALL + +SELECT + 'CONTRACT_DRAWING' AS document_type, + cd.id AS document_id, + cd.condwg_no AS document_number, + cd.project_id, + p.project_code, + p.project_name, + COUNT(cda.attachment_id) AS attachment_count, + MAX(a.created_at) AS latest_attachment_date +FROM contract_drawings cd +INNER JOIN projects p ON cd.project_id = p.id +LEFT JOIN contract_drawing_attachments cda ON cd.id = cda.contract_drawing_id +LEFT JOIN attachments a ON cda.attachment_id = a.id +WHERE cd.deleted_at IS NULL +GROUP BY cd.id, cd.condwg_no, cd.project_id, p.project_code, p.project_name; + +-- View แสดงสถิติเอกสารตามประเภทและสถานะ +CREATE VIEW v_document_statistics AS +SELECT + p.id AS project_id, + p.project_code, + p.project_name, + ct.id AS correspondence_type_id, + ct.type_code, + ct.type_name, + cs.id AS status_id, + cs.status_code, + cs.status_name, + COUNT(DISTINCT c.id) AS document_count, + COUNT(DISTINCT cr.id) AS revision_count +FROM projects p +CROSS JOIN correspondence_types ct +CROSS JOIN correspondence_status cs +LEFT JOIN correspondences c ON p.id = c.project_id AND ct.id = c.correspondence_type_id +LEFT JOIN correspondence_revisions cr ON c.id = cr.correspondence_id AND cs.id = cr.correspondence_status_id AND cr.is_current = TRUE +WHERE p.is_active = 1 + AND ct.is_active = 1 + AND cs.is_active = 1 +GROUP BY p.id, p.project_code, p.project_name, ct.id, ct.type_code, ct.type_name, cs.id, cs.status_code, cs.status_name; + +-- ===================================================== +-- Indexes for View Performance Optimization +-- ===================================================== + +-- Indexes for v_current_correspondences performance +CREATE INDEX idx_correspondences_type_project ON correspondences(correspondence_type_id, project_id); +CREATE INDEX idx_corr_revisions_current_status ON correspondence_revisions(is_current, correspondence_status_id); +CREATE INDEX idx_corr_revisions_correspondence_current ON correspondence_revisions(correspondence_id, is_current); + +-- Indexes for v_current_rfas performance +CREATE INDEX idx_rfa_revisions_current_status ON rfa_revisions(is_current, rfa_status_code_id); +CREATE INDEX idx_rfa_revisions_rfa_current ON rfa_revisions(rfa_id, is_current); + +-- Indexes for v_user_tasks performance +CREATE INDEX idx_circulation_routings_status_assigned ON circulation_routings(status, assigned_to); +CREATE INDEX idx_circulation_routings_circulation_status ON circulation_routings(circulation_id, status); + +-- Indexes for document statistics performance +CREATE INDEX idx_correspondences_project_type ON correspondences(project_id, correspondence_type_id); +CREATE INDEX idx_corr_revisions_status_current ON correspondence_revisions(correspondence_status_id, is_current); + +SET FOREIGN_KEY_CHECKS=1; diff --git a/backend/.prettierrc b/backend/.prettierrc new file mode 100644 index 0000000..a20502b --- /dev/null +++ b/backend/.prettierrc @@ -0,0 +1,4 @@ +{ + "singleQuote": true, + "trailingComma": "all" +} diff --git a/backend/Dockerfile b/backend/Dockerfile new file mode 100644 index 0000000..3812e04 --- /dev/null +++ b/backend/Dockerfile @@ -0,0 +1,48 @@ +# File: Dockerfile +# บันทึกการแก้ไข: (สร้างไฟล์) + +# --- STAGE 1: Builder --- +# ติดตั้ง Dependencies และ Build โค้ด +FROM node:18-alpine AS builder + +WORKDIR /usr/src/app + +# Copy package.json และ lock file +COPY package*.json ./ + +# ติดตั้ง Dependencies (สำหรับ Build) +RUN npm install + +# Copy source code ทั้งหมด +COPY . . + +# Build application +RUN npm run build + +# ติดตั้งเฉพาะ Production Dependencies (สำหรับ Stage สุดท้าย) +RUN npm prune --production + +# --- STAGE 2: Runner --- +# Image สุดท้ายที่มีขนาดเล็ก +FROM node:18-alpine + +WORKDIR /usr/src/app + +# (Security) สร้าง User ที่ไม่มีสิทธิ์ Root +RUN addgroup -S nestjs && adduser -S nestjs -G nestjs +USER nestjs + +# Copy Production Dependencies (จาก Stage 1) +COPY --from=builder /usr/src/app/node_modules ./node_modules + +# Copy Build Artifacts (จาก Stage 1) +COPY --from=builder /usr/src/app/dist ./dist + +# Copy package.json (เผื่อจำเป็น) +COPY package*.json ./ + +# เปิด Port (อ่านจาก Environment Variable) +EXPOSE ${PORT:-3000} + +# รัน Application +CMD [ "node", "dist/main" ] \ No newline at end of file diff --git a/backend/README.md b/backend/README.md new file mode 100644 index 0000000..8f0f65f --- /dev/null +++ b/backend/README.md @@ -0,0 +1,98 @@ +

+ Nest Logo +

+ +[circleci-image]: https://img.shields.io/circleci/build/github/nestjs/nest/master?token=abc123def456 +[circleci-url]: https://circleci.com/gh/nestjs/nest + +

A progressive Node.js framework for building efficient and scalable server-side applications.

+

+NPM Version +Package License +NPM Downloads +CircleCI +Discord +Backers on Open Collective +Sponsors on Open Collective + Donate us + Support us + Follow us on Twitter +

+ + +## Description + +[Nest](https://github.com/nestjs/nest) framework TypeScript starter repository. + +## Project setup + +```bash +$ npm install +``` + +## Compile and run the project + +```bash +# development +$ npm run start + +# watch mode +$ npm run start:dev + +# production mode +$ npm run start:prod +``` + +## Run tests + +```bash +# unit tests +$ npm run test + +# e2e tests +$ npm run test:e2e + +# test coverage +$ npm run test:cov +``` + +## Deployment + +When you're ready to deploy your NestJS application to production, there are some key steps you can take to ensure it runs as efficiently as possible. Check out the [deployment documentation](https://docs.nestjs.com/deployment) for more information. + +If you are looking for a cloud-based platform to deploy your NestJS application, check out [Mau](https://mau.nestjs.com), our official platform for deploying NestJS applications on AWS. Mau makes deployment straightforward and fast, requiring just a few simple steps: + +```bash +$ npm install -g @nestjs/mau +$ mau deploy +``` + +With Mau, you can deploy your application in just a few clicks, allowing you to focus on building features rather than managing infrastructure. + +## Resources + +Check out a few resources that may come in handy when working with NestJS: + +- Visit the [NestJS Documentation](https://docs.nestjs.com) to learn more about the framework. +- For questions and support, please visit our [Discord channel](https://discord.gg/G7Qnnhy). +- To dive deeper and get more hands-on experience, check out our official video [courses](https://courses.nestjs.com/). +- Deploy your application to AWS with the help of [NestJS Mau](https://mau.nestjs.com) in just a few clicks. +- Visualize your application graph and interact with the NestJS application in real-time using [NestJS Devtools](https://devtools.nestjs.com). +- Need help with your project (part-time to full-time)? Check out our official [enterprise support](https://enterprise.nestjs.com). +- To stay in the loop and get updates, follow us on [X](https://x.com/nestframework) and [LinkedIn](https://linkedin.com/company/nestjs). +- Looking for a job, or have a job to offer? Check out our official [Jobs board](https://jobs.nestjs.com). + +## Support + +Nest is an MIT-licensed open source project. It can grow thanks to the sponsors and support by the amazing backers. If you'd like to join them, please [read more here](https://docs.nestjs.com/support). + +## Stay in touch + +- Author - [Kamil Myśliwiec](https://twitter.com/kammysliwiec) +- Website - [https://nestjs.com](https://nestjs.com/) +- Twitter - [@nestframework](https://twitter.com/nestframework) + +## License + +Nest is [MIT licensed](https://github.com/nestjs/nest/blob/master/LICENSE). diff --git a/backend/docker-compose.yml b/backend/docker-compose.yml new file mode 100644 index 0000000..a05d67e --- /dev/null +++ b/backend/docker-compose.yml @@ -0,0 +1,62 @@ +# File: docker-compose.yml +# บันทึกการแก้ไข: (สร้างไฟล์) +# (สำคัญ: ไฟล์นี้จะถูก import หรือคัดลอกไปใส่ใน UI ของ QNAP Container Station) + +version: '3.8' + +services: + # --------------------------------- + # Service 1: Backend (NestJS) + # (Req 2.3) + # --------------------------------- + backend: + build: + context: ./backend # (สมมติว่า Dockerfile อยู่ในโฟลเดอร์ backend) + dockerfile: Dockerfile + image: lcbp3-backend:1.3.0 # (ตั้งชื่อ Image) + container_name: lcbp3-backend + restart: unless-stopped + + # (สำคัญ) กำหนด Environment Variables ที่นี่ (ห้ามใช้ .env) + # (Req 6.5, 2.1) + environment: + # --- App Config --- + - PORT=3000 + - NODE_ENV=production + + # --- Database (Req 2.4) --- + # (ชี้ไปที่ Service 'mariadb' ใน Network 'lcbp3') + - DATABASE_HOST=mariadb + - DATABASE_PORT=3306 + - DATABASE_USER=your_db_user # (ต้องเปลี่ยน) + - DATABASE_PASSWORD=your_db_pass # (ต้องเปลี่ยน) + - DATABASE_NAME=lcbp3_dms + + # --- Security (JWT) (Req 6.5) --- + - JWT_SECRET=YOUR_VERY_STRONG_JWT_SECRET_KEY # (ต้องเปลี่ยน) + - JWT_EXPIRATION_TIME=3600s # (เช่น 1 ชั่วโมง) + + # --- Phase 4 Services --- + - ELASTICSEARCH_URL=http://elasticsearch:9200 # (ชี้ไปที่ Service ES ถ้ามี) + - N8N_WEBHOOK_URL=http://n8n:5678/webhook/your-webhook-id # (ชี้ไปที่ N8N) + + # (สำคัญ) เชื่อมต่อ Network กลาง (Req 2.1) + networks: + - lcbp3 + + # (Deploy) ตั้งค่า Health Check + healthcheck: + test: ["CMD", "curl", "-f", "http://localhost:3000/api/v1/health"] + interval: 30s + timeout: 10s + retries: 3 + start_period: 20s # (รอให้ App เริ่มก่อน) + +# --------------------------------- +# Network กลาง (Req 2.1) +# (ต้องสร้าง Network นี้ไว้ก่อนใน QNAP หรือสร้างพร้อมกัน) +# --------------------------------- +networks: + lcbp3: + external: true # (ถ้าสร้างไว้แล้ว) + # name: lcbp3 # (ถ้าต้องการให้ Compose สร้าง) \ No newline at end of file diff --git a/backend/eslint.config.mjs b/backend/eslint.config.mjs new file mode 100644 index 0000000..4e9f827 --- /dev/null +++ b/backend/eslint.config.mjs @@ -0,0 +1,35 @@ +// @ts-check +import eslint from '@eslint/js'; +import eslintPluginPrettierRecommended from 'eslint-plugin-prettier/recommended'; +import globals from 'globals'; +import tseslint from 'typescript-eslint'; + +export default tseslint.config( + { + ignores: ['eslint.config.mjs'], + }, + eslint.configs.recommended, + ...tseslint.configs.recommendedTypeChecked, + eslintPluginPrettierRecommended, + { + languageOptions: { + globals: { + ...globals.node, + ...globals.jest, + }, + sourceType: 'commonjs', + parserOptions: { + projectService: true, + tsconfigRootDir: import.meta.dirname, + }, + }, + }, + { + rules: { + '@typescript-eslint/no-explicit-any': 'off', + '@typescript-eslint/no-floating-promises': 'warn', + '@typescript-eslint/no-unsafe-argument': 'warn', + "prettier/prettier": ["error", { endOfLine: "auto" }], + }, + }, +); diff --git a/backend/nest-cli.json b/backend/nest-cli.json new file mode 100644 index 0000000..f9aa683 --- /dev/null +++ b/backend/nest-cli.json @@ -0,0 +1,8 @@ +{ + "$schema": "https://json.schemastore.org/nest-cli", + "collection": "@nestjs/schematics", + "sourceRoot": "src", + "compilerOptions": { + "deleteOutDir": true + } +} diff --git a/backend/package.json b/backend/package.json new file mode 100644 index 0000000..b018b06 --- /dev/null +++ b/backend/package.json @@ -0,0 +1,98 @@ +{ + "name": "backend", + "version": "0.0.1", + "description": "", + "author": "", + "private": true, + "license": "UNLICENSED", + "scripts": { + "build": "nest build", + "format": "prettier --write \"src/**/*.ts\" \"test/**/*.ts\"", + "start": "nest start", + "start:dev": "nest start --watch", + "start:debug": "nest start --debug --watch", + "start:prod": "node dist/main", + "lint": "eslint \"{src,apps,libs,test}/**/*.ts\" --fix", + "test": "jest", + "test:watch": "jest --watch", + "test:cov": "jest --coverage", + "test:debug": "node --inspect-brk -r tsconfig-paths/register -r ts-node/register node_modules/.bin/jest --runInBand", + "test:e2e": "jest --config ./test/jest-e2e.json" + }, + "dependencies": { + "@elastic/elasticsearch": "^9.2.0", + "@nestjs/cache-manager": "^3.0.1", + "@nestjs/common": "^11.0.1", + "@nestjs/config": "^4.0.2", + "@nestjs/core": "^11.0.1", + "@nestjs/elasticsearch": "^11.1.0", + "@nestjs/jwt": "^11.0.1", + "@nestjs/passport": "^11.0.5", + "@nestjs/platform-express": "^11.1.9", + "@nestjs/schedule": "^6.0.1", + "@nestjs/swagger": "^11.2.1", + "@nestjs/typeorm": "^11.0.0", + "@types/nodemailer": "^7.0.3", + "@types/uuid": "^10.0.0", + "bcrypt": "^6.0.0", + "cache-manager": "^7.2.4", + "casl": "^0.2.0", + "class-transformer": "^0.5.1", + "class-validator": "^0.14.2", + "helmet": "^8.1.0", + "multer": "^2.0.2", + "mysql2": "^3.15.3", + "nodemailer": "^7.0.10", + "passport": "^0.7.0", + "passport-jwt": "^4.0.1", + "rate-limiter-flexible": "^8.2.1", + "reflect-metadata": "^0.2.2", + "rxjs": "^7.8.1", + "typeorm": "^0.3.27", + "uuid": "^13.0.0" + }, + "devDependencies": { + "@eslint/eslintrc": "^3.2.0", + "@eslint/js": "^9.18.0", + "@nestjs/cli": "^11.0.0", + "@nestjs/schematics": "^11.0.0", + "@nestjs/testing": "^11.1.9", + "@types/express": "^5.0.0", + "@types/jest": "^30.0.0", + "@types/multer": "^2.0.0", + "@types/node": "^22.10.7", + "@types/passport-jwt": "^4.0.1", + "@types/supertest": "^6.0.2", + "eslint": "^9.18.0", + "eslint-config-prettier": "^10.0.1", + "eslint-plugin-prettier": "^5.2.2", + "globals": "^16.0.0", + "jest": "^30.2.0", + "prettier": "^3.4.2", + "source-map-support": "^0.5.21", + "supertest": "^7.1.4", + "ts-jest": "^29.2.5", + "ts-loader": "^9.5.2", + "ts-node": "^10.9.2", + "tsconfig-paths": "^4.2.0", + "typescript": "^5.7.3", + "typescript-eslint": "^8.20.0" + }, + "jest": { + "moduleFileExtensions": [ + "js", + "json", + "ts" + ], + "rootDir": "src", + "testRegex": ".*\\.spec\\.ts$", + "transform": { + "^.+\\.(t|j)s$": "ts-jest" + }, + "collectCoverageFrom": [ + "**/*.(t|j)s" + ], + "coverageDirectory": "../coverage", + "testEnvironment": "node" + } +} diff --git a/backend/src/app.controller.spec.ts b/backend/src/app.controller.spec.ts new file mode 100644 index 0000000..d22f389 --- /dev/null +++ b/backend/src/app.controller.spec.ts @@ -0,0 +1,22 @@ +import { Test, TestingModule } from '@nestjs/testing'; +import { AppController } from './app.controller'; +import { AppService } from './app.service'; + +describe('AppController', () => { + let appController: AppController; + + beforeEach(async () => { + const app: TestingModule = await Test.createTestingModule({ + controllers: [AppController], + providers: [AppService], + }).compile(); + + appController = app.get(AppController); + }); + + describe('root', () => { + it('should return "Hello World!"', () => { + expect(appController.getHello()).toBe('Hello World!'); + }); + }); +}); diff --git a/backend/src/app.controller.ts b/backend/src/app.controller.ts new file mode 100644 index 0000000..cce879e --- /dev/null +++ b/backend/src/app.controller.ts @@ -0,0 +1,12 @@ +import { Controller, Get } from '@nestjs/common'; +import { AppService } from './app.service'; + +@Controller() +export class AppController { + constructor(private readonly appService: AppService) {} + + @Get() + getHello(): string { + return this.appService.getHello(); + } +} diff --git a/backend/src/app.module.ts b/backend/src/app.module.ts new file mode 100644 index 0000000..8662803 --- /dev/null +++ b/backend/src/app.module.ts @@ -0,0 +1,10 @@ +import { Module } from '@nestjs/common'; +import { AppController } from './app.controller'; +import { AppService } from './app.service'; + +@Module({ + imports: [], + controllers: [AppController], + providers: [AppService], +}) +export class AppModule {} diff --git a/backend/src/app.service.ts b/backend/src/app.service.ts new file mode 100644 index 0000000..927d7cc --- /dev/null +++ b/backend/src/app.service.ts @@ -0,0 +1,8 @@ +import { Injectable } from '@nestjs/common'; + +@Injectable() +export class AppService { + getHello(): string { + return 'Hello World!'; + } +} diff --git a/backend/src/main.ts b/backend/src/main.ts new file mode 100644 index 0000000..f76bc8d --- /dev/null +++ b/backend/src/main.ts @@ -0,0 +1,8 @@ +import { NestFactory } from '@nestjs/core'; +import { AppModule } from './app.module'; + +async function bootstrap() { + const app = await NestFactory.create(AppModule); + await app.listen(process.env.PORT ?? 3000); +} +bootstrap(); diff --git a/backend/test/app.e2e-spec.ts b/backend/test/app.e2e-spec.ts new file mode 100644 index 0000000..36852c5 --- /dev/null +++ b/backend/test/app.e2e-spec.ts @@ -0,0 +1,25 @@ +import { Test, TestingModule } from '@nestjs/testing'; +import { INestApplication } from '@nestjs/common'; +import request from 'supertest'; +import { App } from 'supertest/types'; +import { AppModule } from './../src/app.module'; + +describe('AppController (e2e)', () => { + let app: INestApplication; + + beforeEach(async () => { + const moduleFixture: TestingModule = await Test.createTestingModule({ + imports: [AppModule], + }).compile(); + + app = moduleFixture.createNestApplication(); + await app.init(); + }); + + it('/ (GET)', () => { + return request(app.getHttpServer()) + .get('/') + .expect(200) + .expect('Hello World!'); + }); +}); diff --git a/backend/test/jest-e2e.json b/backend/test/jest-e2e.json new file mode 100644 index 0000000..e9d912f --- /dev/null +++ b/backend/test/jest-e2e.json @@ -0,0 +1,9 @@ +{ + "moduleFileExtensions": ["js", "json", "ts"], + "rootDir": ".", + "testEnvironment": "node", + "testRegex": ".e2e-spec.ts$", + "transform": { + "^.+\\.(t|j)s$": "ts-jest" + } +} diff --git a/backend/tsconfig.build.json b/backend/tsconfig.build.json new file mode 100644 index 0000000..64f86c6 --- /dev/null +++ b/backend/tsconfig.build.json @@ -0,0 +1,4 @@ +{ + "extends": "./tsconfig.json", + "exclude": ["node_modules", "test", "dist", "**/*spec.ts"] +} diff --git a/backend/tsconfig.json b/backend/tsconfig.json new file mode 100644 index 0000000..aba29b0 --- /dev/null +++ b/backend/tsconfig.json @@ -0,0 +1,25 @@ +{ + "compilerOptions": { + "module": "nodenext", + "moduleResolution": "nodenext", + "resolvePackageJsonExports": true, + "esModuleInterop": true, + "isolatedModules": true, + "declaration": true, + "removeComments": true, + "emitDecoratorMetadata": true, + "experimentalDecorators": true, + "allowSyntheticDefaultImports": true, + "target": "ES2023", + "sourceMap": true, + "outDir": "./dist", + "baseUrl": "./", + "incremental": true, + "skipLibCheck": true, + "strictNullChecks": true, + "forceConsistentCasingInFileNames": true, + "noImplicitAny": false, + "strictBindCallApply": false, + "noFallthroughCasesInSwitch": false + } +} diff --git a/docs/.gitignore b/docs/.gitignore new file mode 100644 index 0000000..30b9c7c --- /dev/null +++ b/docs/.gitignore @@ -0,0 +1,164 @@ +# ---> Node +# Logs +logs +*.log +npm-debug.log* +yarn-debug.log* +yarn-error.log* +lerna-debug.log* +.pnpm-debug.log* + +# Diagnostic reports (https://nodejs.org/api/report.html) +report.[0-9]*.[0-9]*.[0-9]*.[0-9]*.json + +# Runtime data +pids +*.pid +*.seed +*.pid.lock + +# Directory for instrumented libs generated by jscoverage/JSCover +lib-cov + +# Coverage directory used by tools like istanbul +coverage +*.lcov + +# nyc test coverage +.nyc_output + +# Grunt intermediate storage (https://gruntjs.com/creating-plugins#storing-task-files) +.grunt + +# Bower dependency directory (https://bower.io/) +bower_components + +# node-waf configuration +.lock-wscript + +# Compiled binary addons (https://nodejs.org/api/addons.html) +build/Release + +# Dependency directories +node_modules/ +jspm_packages/ + +# Snowpack dependency directory (https://snowpack.dev/) +web_modules/ + +# TypeScript cache +*.tsbuildinfo + +# Optional npm cache directory +.npm + +# Optional eslint cache +.eslintcache + +# Optional stylelint cache +.stylelintcache + +# Microbundle cache +.rpt2_cache/ +.rts2_cache_cjs/ +.rts2_cache_es/ +.rts2_cache_umd/ + +# Optional REPL history +.node_repl_history + +# Output of 'npm pack' +*.tgz + +# Yarn Integrity file +.yarn-integrity + +# dotenv environment variable files +.env +.env.development.local +.env.test.local +.env.production.local +.env.local + +# parcel-bundler cache (https://parceljs.org/) +.cache +.parcel-cache + +# Next.js build output +.next +out + +# Nuxt.js build / generate output +.nuxt +dist + +# Gatsby files +.cache/ +# Comment in the public line in if your project uses Gatsby and not Next.js +# https://nextjs.org/blog/next-9-1#public-directory-support +# public + +# vuepress build output +.vuepress/dist + +# vuepress v2.x temp and cache directory +.temp +.cache + +# vitepress build output +**/.vitepress/dist + +# vitepress cache directory +**/.vitepress/cache + +# Docusaurus cache and generated files +.docusaurus + +# Serverless directories +.serverless/ + +# FuseBox cache +.fusebox/ + +# DynamoDB Local files +.dynamodb/ + +# TernJS port file +.tern-port + +# Stores VSCode versions used for testing VSCode extensions +.vscode-test + +# yarn v2 +.yarn/cache +.yarn/unplugged +.yarn/build-state.yml +.yarn/install-state.gz +.pnp.* + +# ---> Windows +# Windows thumbnail cache files +Thumbs.db +Thumbs.db:encryptable +ehthumbs.db +ehthumbs_vista.db + +# Dump file +*.stackdump + +# Folder config file +[Dd]esktop.ini + +# Recycle Bin used on file shares +$RECYCLE.BIN/ + +# Windows Installer files +*.cab +*.msi +*.msix +*.msm +*.msp + +# Windows shortcuts +*.lnk + diff --git a/docs/1.bak b/docs/1.bak new file mode 100644 index 0000000..e2393d2 --- /dev/null +++ b/docs/1.bak @@ -0,0 +1,377 @@ +ผมได้ตรวจสอบไฟล์ `FullStackJS_Guidelines01.md` และ `01_lcbp3_v1_1_0.sql` ของคุณแล้ว และได้อัปเดตไฟล์ Guidelines (Markdown) ให้สอดคล้องกับโครงสร้างฐานข้อมูล (SQL) ที่คุณกำหนดไว้อย่างสมบูรณ์ครับ + +การเปลี่ยนแปลงที่สำคัญคือ: + +1. **การจัดการ UI (UI Conflict):** แก้ไขความขัดแย้งในไฟล์เดิมที่ระบุทั้ง **Tailwind/Shadcn** และ **Bootstrap** ผมได้รวมศูนย์การพัฒนา UI ไปที่ **Tailwind/Shadcn** ตามที่ระบุไว้ในโปรไฟล์นักพัฒนา (Frontend Developer Profile) และลบส่วนของ Bootstrap ที่ซ้ำซ้อนออกไป +2. **DMS-Specific Conventions:** อัปเดตส่วนนี้ทั้งหมดเพื่อให้ตรงกับสคีม SQL ของคุณ + * เปลี่ยนชื่อโปรเจกต์อ้างอิงเป็น **LCBP3-DMS** + * ปรับปรุงแผนผัง **Domain Modules** ให้สะท้อนโครงสร้างจริง (เช่น `correspondences` เป็นศูนย์กลาง, เพิ่ม `circulations`) + * อัปเดตตาราง **AuditLog** ให้ตรงกับฟิลด์ใน SQL (เช่น เพิ่ม `entity_type`, `details_json`, `ip_address`) + * อัปเดตตัวอย่าง **RBAC Permissions** ให้ตรงกับสิทธิ์ที่มีในตาราง `permissions` ของคุณ + * ชี้แจง + เรื่อง **File Handling** ว่าตาราง `attachments` จะเชื่อมโยงผ่าน `correspondence_id` + * อัปเดตส่วน **Reporting** เพื่ออ้างอิงถึง `VIEWS` (เช่น `v_current_rfas`) ที่คุณได้สร้างไว้ใน SQL + * ย้ายส่วน **"Recommended Enhancements"** (เช่น soft delete, indexes) ที่มีอยู่แล้วใน SQL ไปยังส่วนใหม่ชื่อ **"Implemented Standards"** เพื่อสะท้อนว่างานส่วนนี้เสร็จแล้ว + +นี่คือไฟล์ `FullStackJS_Guidelines01.md` ฉบับที่อัปเดตแล้วครับ: + +----- + +# FullStackJS Development Guidelines + +## 🧠 General Philosophy + +Unified best practices for **NestJS Backend**, **NextJS Frontend**, and **Tailwind-based UI/UX** development in TypeScript environments. +Focus on **clarity**, **maintainability**, **consistency**, and **accessibility** across the entire stack. + +----- + +## ⚙️ TypeScript General Guidelines + +### Basic Principles + + - Use **English** for all code and documentation. + - Explicitly type all variables, parameters, and return values. + - Avoid `any`; create custom types or interfaces. + - Use **JSDoc** for public classes and methods. + - Export only **one main symbol** per file. + - Avoid blank lines within functions. + +### Naming Conventions + +| Entity | Convention | Example | +|:--|:--|:--| +| Classes | PascalCase | `UserService` | +| Variables & Functions | camelCase | `getUserInfo` | +| Files & Folders | kebab-case | `user-service.ts` | +| Environment Variables | UPPERCASE | `DATABASE_URL` | +| Booleans | Verb + Noun | `isActive`, `canDelete`, `hasPermission` | + +Use full words — no abbreviations — except for standard ones (`API`, `URL`, `req`, `res`, `err`, `ctx`). + +----- + +## 🧩 Functions + + - Write short, single-purpose functions (\<20 lines). + - Use **early returns** to reduce nesting. + - Use **map**, **filter**, **reduce** instead of loops when suitable. + - Prefer **arrow functions** for short logic, **named functions** otherwise. + - Use **default parameters** over null checks. + - Group multiple parameters into a single object (RO-RO pattern). + - Return typed objects, not primitives. + - Maintain a single abstraction level per function. + +----- + +## 🧱 Data Handling + + - Encapsulate data in composite types. + - Use **immutability** with `readonly` and `as const`. + - Perform validations in classes or DTOs, not within business functions. + - Always validate data using typed DTOs. + +----- + +## 🧰 Classes + + - Follow **SOLID** principles. + - Prefer **composition over inheritance**. + - Define **interfaces** for contracts. + - Keep classes focused and small (\<200 lines, \<10 methods, \<10 properties). + +----- + +## 🚨 Error Handling + + - Use exceptions for unexpected errors. + - Catch only to fix or add context; otherwise, use global error handlers. + - Always provide meaningful error messages. + +----- + +## 🧪 Testing (General) + + - Use the **Arrange–Act–Assert** pattern. + - Use descriptive test variable names (`inputData`, `expectedOutput`). + - Write **unit tests** for all public methods. + - Mock external dependencies. + - Add **acceptance tests** per module using Given–When–Then. + +----- + +# 🏗️ Backend (NestJS) + +### Principles + + - **Modular architecture**: + - One module per domain. + - Controller → Service → Repository (Model) structure. + - DTOs validated with **class-validator**. + - Use **MikroORM** (or TypeORM/Prisma) for persistence, aligning with the MariaDB schema. + - Encapsulate reusable code in a **common module** (`@app/common`): + - Configs, decorators, DTOs, guards, interceptors, notifications, shared services, types, validators. + +### Core Functionalities + + - Global **filters** for exception handling. + - **Middlewares** for request handling. + - **Guards** for permissions and RBAC. + - **Interceptors** for response transformation and logging. + +### Testing + + - Use **Jest** for testing. + - Test each controller and service. + - Add `admin/test` endpoint as a smoke test. + +----- + +# 🖥️ Frontend (NextJS / React / UI) + +### Developer Profile + +Senior-level TypeScript + React/NextJS engineer. +Expert in **TailwindCSS**, **Shadcn/UI**, and **Radix** for UI development. + +### Code Implementation Guidelines + + - Use **early returns** for clarity. + - Always style with **TailwindCSS** classes. + - Prefer `class:` conditional syntax (or `clsx` utility) over ternary operators in class strings. + - Use **const arrow functions** for components and handlers. + - Event handlers start with `handle...` (e.g., `handleClick`, `handleSubmit`). + - Include accessibility attributes: + `tabIndex="0"`, `aria-label`, `onKeyDown`, etc. + - Ensure all code is **complete**, **tested**, and **DRY**. + - Always import required modules explicitly. + +### UI/UX with React + + - Use **semantic HTML**. + - Apply **responsive Tailwind** classes (`sm:`, `md:`, `lg:`). + - Maintain visual hierarchy with typography and spacing. + - Use **Shadcn** components (Button, Input, Card, etc.) for consistent UI. + - Keep components small and focused. + - Use utility classes for quick styling (spacing, colors, text, etc.). + - Ensure **ARIA compliance** and semantic markup. + +### Form Validation & Errors + + - Use client-side libraries like `zod` and `react-hook-form`. + - Show errors with **alert components** or inline messages. + - Include labels, placeholders, and feedback messages. + +----- + +# 🔗 Full Stack Integration Guidelines + +| Aspect | Backend (NestJS) | Frontend (NextJS) | UI Layer (Tailwind/Shadcn) | +|:--|:--|:--|:--| +| API | REST / GraphQL Controllers | API hooks via fetch/axios/SWR | Components consuming data | +| Validation | `class-validator` DTOs | `zod` / `react-hook-form` | Shadcn form/input states | +| Auth | Guards, JWT | NextAuth / cookies | Auth UI states (loading, signed in) | +| Errors | Global filters | Toasts / modals | Alerts / feedback text | +| Testing | Jest (unit/e2e) | Vitest / Playwright | Visual regression | +| Styles | Scoped modules (if needed) | Tailwind / Shadcn | Tailwind utilities | +| Accessibility | Guards + filters | ARIA attributes | Semantic HTML | + +----- + +# 🗂️ DMS-Specific Conventions (LCBP3-DMS) + +This section extends the general FullStackJS guidelines for the **LCBP3-DMS** project, focusing on document approval workflows (Correspondence, RFA, Drawing, Contract, Transmittal, Circulation). + +## 🧱 Backend Domain Modules + +Use a modular domain structure reflecting the SQL schema. `correspondences` should act as the central hub. + +``` +src/ + ├─ modules/ + │ ├─ correspondences/ (Core: Master documents, Revisions, Attachments) + │ ├─ rfas/ (RFA logic, Revisions, Workflows, Items) + │ ├─ drawings/ (ShopDrawings, ContractDrawings, Categories) + │ ├─ circulations/ (Internal circulation, Templates, Assignees) + │ ├─ transmittals/ (Transmittal logic, Items) + │ ├─ projects-contracts/ (Projects, Contracts, Organizations, Parties) + │ ├─ users-auth/ (Users, Roles, Permissions, Auth) + │ ├─ audit-log/ + │ └─ common/ +``` + +### Naming Convention + +| Entity | Example (from SQL) | +|:--|:--| +| Table | `correspondences`, `rfa_revisions`, `contract_parties` | +| Column | `correspondence_id`, `created_by`, `is_current` | +| DTO | `CreateRfaDto`, `UpdateCorrespondenceDto` | +| Controller | `rfas.controller.ts` | +| Service | `correspondences.service.ts` | + +----- + +## 🧩 RBAC & Permission Control + +Use decorators to enforce access rights, referencing permissions from the `permissions` table. + +```ts +@RequirePermission('rfas.respond') // Must match a 'permission_code' +@Put(':id') +updateRFA(@Param('id') id: string) { + return this.rfaService.update(id); +} +``` + +### Roles + + - **SUPER\_ADMIN**: Full system access (from `roles` table). + - **ADMIN**: Organization-level access. + - **EDITOR**: Module-specific write access. + - **VIEWER**: Read-only access. + +### Example Permissions (from `permissions` table) + + - `rfas.view`, `rfas.create`, `rfas.respond`, `rfas.delete` + - `drawings.view`, `drawings.upload`, `drawings.delete` + - `corr.view`, `corr.manage` + - `transmittals.manage` + - `cirs.manage` + - `project_parties.manage` + +Seed mapping between roles and permissions via seeder scripts (as seen in SQL file). + +----- + +## 🧾 AuditLog Standard + +Log all CRUD and mapping operations to the `audit_logs` table. + +| Field | Type (from SQL) | Description | +|:--|:--|:--| +| `audit_id` | `BIGINT` | Primary Key | +| `user_id` | `INT` | User performing the action (FK -\> users) | +| `action` | `VARCHAR(100)` | `rfa.create`, `correspondence.update`, `login.success` | +| `entity_type`| `VARCHAR(50)` | Table/module name, e.g., 'rfa', 'correspondence' | +| `entity_id` | `VARCHAR(50)` | Primary ID of the affected record | +| `details_json`| `JSON` | Contextual data (e.g., changed fields) | +| `ip_address` | `VARCHAR(45)` | Actor's IP address | +| `user_agent` | `VARCHAR(255)`| Actor's User Agent | +| `created_at` | `TIMESTAMP` | UTC timestamp | + +Example implementation: + +```ts +await this.auditLogService.log({ + userId: user.id, + action: 'rfa.update_status', + entityType: 'rfa_revisions', + entityId: rfaRevision.id, + detailsJson: { from: 'DFT', to: 'FAP' }, + ipAddress: req.ip, +}); +``` + +----- + +## 📂 File Handling + +### File Upload Standard + + - Centralize all uploads via the `attachments` table. + - Upload path (convention): `/storage/{year}/{month}/` + - Stored filename: Use `stored_filename` (e.g., UUID or hash) to prevent conflicts. `original_filename` is for display. + - Allowed types: `pdf, dwg, docx, xlsx, zip` + - Max size: **50 MB** + - Store outside webroot. + - Serve via secure endpoint `/files/:attachment_id/download`. + +### Access Control + +File access is not direct. The `/files/:attachment_id/download` endpoint must: + +1. Find the `attachment` record. +2. Get its `correspondence_id`. +3. Verify the user has permission to view that specific `correspondence` (or its related RFA, Transmittal, etc.). + +----- + +## 📊 Reporting & Exports + +### Reporting Views (from SQL) + +Reports should be built primarily from the pre-defined database Views: + + - `v_current_correspondences`: For all current non-RFA document revisions. + - `v_current_rfas`: For all current RFA revisions and their master data. + - `v_contract_parties_all`: For auditing project/contract/organization relationships. + +These views serve as the primary source for server-side reporting and data exports. + +### Export Rules + + - Export formats: CSV, Excel, PDF. + - Provide print view. + - Include source entity link (e.g., `/rfas/:id`). + +----- + +## 🧮 Frontend: DataTable & Form Patterns + +### DataTable (Server‑Side) + + - Endpoint: `/api/{module}?page=1&pageSize=20&sort=...&filter=...` + - Must support: pagination, sorting, search, filters. + - Always display latest revision inline (for RFA/Drawing). + +### Form Standards + + - Dependent dropdowns must be implemented (as supported by schema): + - Project → Contract Drawing Volumes + - Contract Drawing Category → Sub-Category + - RFA (Shop Drawing type) → Linkable Shop Drawing Revisions + - File upload: preview + validation (via `attachments` logic). + - Submit via API with toast feedback. + +----- + +## 🧭 Dashboard & Activity Feed + +### Dashboard Cards + + - Show latest Correspondences, RFAs, Circulations. + - Include KPI summaries (e.g., "RFAs Pending Approval"). + - Include quick links to modules. + +### Activity Feed + + - Display recent `audit_logs` actions (10 latest) relevant to the user. + + + +```ts +// Example API response +[ + { user: 'editor01', action: 'Updated RFA (LCBP3C1-RFA-001)', time: '2025-11-04T09:30Z' } +] +``` + +----- + +## ✅ Implemented Standards (from SQL v1.1.0) + +This section confirms that the following best practices are already part of the database design and should be leveraged, not re-implemented. + + - ✅ **Soft Delete:** Implemented via `deleted_at` columns on key tables (e.g., `correspondences`, `rfas`, `project_parties`). Logic must filter for `deleted_at IS NULL`. + - ✅ **Database Indexes:** The schema is heavily indexed on foreign keys and common query columns (e.g., `idx_rr_rfa`, `idx_cor_project`, `idx_cr_is_current`) for performance. + - ✅ **RBAC Structure:** A comprehensive `users`, `roles`, `permissions`, `user_roles`, and `user_project_roles` system is in place. + - ✅ **Data Seeding:** Master data (roles, permissions, organization\_roles, initial users, project parties) is included in the schema script. + +## 🧩 Recommended Enhancements (Future) + + - ✅ Implement Fulltext search on fields like `correspondence_revisions.title` or `details`. + - ✅ Create a background job (using **n8n** as noted in SQL comments) for RFA deadline reminders based on `due_date`. + - ✅ Add a periodic cleanup job for `attachments` that are not linked to any `correspondence_id` (orphaned files). + +----- \ No newline at end of file diff --git a/docs/DMS README.bak b/docs/DMS README.bak new file mode 100644 index 0000000..4e83e9d --- /dev/null +++ b/docs/DMS README.bak @@ -0,0 +1,777 @@ +# 📝 0. Project Title: Document Management System (DMS) Web Application for Laem Chabang Port Development Project, Phase 3 + +## 0. Project + +### 📌 0.1 Project Overview / Description + +- ระบบ Document Management System (DMS) เป็นเว็บแอปพลิเคชันที่ออกแบบมาเพื่อจัดการเอกสารภายในโครงการอย่างมีประสิทธิภาพ +- โดยมีฟังก์ชันหลักในการอัปโหลด จัดเก็บ ค้นหา แชร์ และควบคุมสิทธิ์การเข้าถึงเอกสาร +- ระบบนี้จะช่วยลดการใช้เอกสารกระดาษ เพิ่มความปลอดภัยในการจัดเก็บข้อมูล +- เพิ่มความสะดวกในการทำงานร่วมกันระหว่างองกรณ์ + +### 🎯 0.2 Objectives + +- พัฒนาระบบที่สามารถจัดการเอกสารได้อย่างเป็นระบบ +- ลดความซ้ำซ้อนในการจัดเก็บเอกสาร +- เพิ่มความปลอดภัยในการเข้าถึงและจัดการเอกสาร +- รองรับการทำงานร่วมกันแบบออนไลน์ + +### 📦 0.3 Scope of Work + +ระบบจะครอบคลุมฟีเจอร์หลักดังนี้: + +- การลงทะเบียนและเข้าสู่ระบบ ของผู้ใช้งาน +- การอัปโหลดและจัดเก็บเอกสารในรูปแบบต่าง ๆ (PDF, DOCX, XLSX ฯลฯ) +- การจัดหมวดหมู่และแท็กเอกสาร +- การค้นหาเอกสารด้วยคำสำคัญหรือฟิลเตอร์ +- การกำหนดสิทธิ์การเข้าถึงเอกสาร (เช่น อ่านอย่างเดียว, แก้ไข, ลบ) +- การบันทึกประวัติการใช้งานเอกสาร (Audit Trail) +- การมอบหมายงานให้กับผู้เกี่ยวข้อง และแจ้งเตือนเมื่อมีการมอบหมายงาน +- การแจ้งเตือนเมื่อถึงกำหนดวันที่ต้องส่งเอกสารต่อให้ ผู้เกี่ยวข้องอื่นๆ +- การแจ้งเตือนเมื่อมีการเปลี่ยนแปลงเอกสาร + +### 👥 0.4 Target Users + +- พนักงานภายใน ขององค์กร +- พนักงานควบคุมเอกสาร (Document Control)/ ผู้ดูแลระบบขององค์กร (admin) +- ผู้จัดการฝ่ายเอกสาร ขององค์กร +- ผู้จัดการโครงการ ขององค์กร +- คณะกรรมการ ของโครงการ +- ผู้ดูแลระบบ IT ของโครงการ (superadmin) + +### 📈 0.5 Expected Outcomes + +- ลดเวลาในการค้นหาเอกสารลงอย่างน้อย 50% +- ลดเวลาในการจัดทำรายงานเอกสาร ประจำวัน, ประจำสัปดาห์, ประจำเดือน, ประจำปี และ รายงานเอกสารทั้งโครงการ +- ลดการใช้เอกสารกระดาษในองค์กร +- เพิ่มความปลอดภัยในการจัดเก็บข้อมูล +- รองรับการทำงานแบบ Remote Work + +### 📘 0.6 Requirements Use Cases + +#### 📘 Use Case: Upload Document + +Actor: พนักงานควบคุมเอกสาร (Document Control) +Description: พนักงานควบคุมเอกสารสามารถอัปโหลดเอกสารเข้าสู่ระบบเพื่อจัดเก็บและใช้งานในภายหลัง +Preconditions: พนักงานควบคุมเอกสารต้องเข้าสู่ระบบก่อน +Main Flow: + +พนักงานควบคุมเอกสารเลือกเมนู “อัปโหลดเอกสาร” +เลือกไฟล์จากเครื่องคอมพิวเตอร์ +กรอกข้อมูลประกอบ เช่น ชื่อเอกสาร หมวดหมู่ แท็ก +กดปุ่ม “อัปโหลด” +ระบบบันทึกเอกสารและแสดงผลการอัปโหลดสำเร็จ + +Postconditions: เอกสารถูกจัดเก็บในระบบและสามารถค้นหาได้ + +#### 📘 Use Case: Assign Users to Document + +Actor: พนักงานควบคุมเอกสาร (Document Control) +Description: พนักงานควบคุมเอกสารสามารถ มอบหมายงานให้กับ Users +Preconditions: พนักงานควบคุมเอกสารต้องเข้าสู่ระบบก่อน, เอกสารต้องอัปโหลดเรียบร้อยแล้ว +Main Flow: + +พนักงานควบคุมเอกสารเลือกเมนู “มอบหมายงาน” +เลือกเอกสารในระบบ +เลือก Users กำหนดวันสิ้นสุดงาน +กดปุ่ม “มอบหมายงาน” +ระบบบันทึกเอกสารและแสดงผลการมอบหมายงานสำเร็จ + +Postconditions: งานที่มอยหมาย จัดเก็บในระบบและสามารถค้นหาได้ + +#### 📘 Use Case: Search Document + +Actor: ผู้ใช้งานทั่วไป +Description: ผู้ใช้งานสามารถค้นหาเอกสารจากระบบด้วยคำสำคัญหรือฟิลเตอร์ +Preconditions: ผู้ใช้งานต้องเข้าสู่ระบบ +Main Flow: + +ผู้ใช้งานกรอกคำค้นหรือเลือกฟิลเตอร์ (หมวดหมู่, วันที่, ผู้สร้าง, ผู้ได้รับมอบหมายงาน, สถานะ, title, subject) +กดปุ่ม “ค้นหา” +ระบบแสดงรายการเอกสารที่ตรงกับเงื่อนไข + +Postconditions: ผู้ใช้งานสามารถเปิดดูหรือดาวน์โหลดเอกสารที่ค้นพบได้ + +#### 📘 Use Case: Manage Access + +Actor: ผู้ดูแลระบบโครงการ (superadmin) / ผู้ดูแลระบบขององค์กร (admin) +Description: ผู้ดูแลระบบสามารถกำหนดสิทธิ์การเข้าถึงเอกสารให้กับผู้ใช้งาน +Preconditions: ผู้ดูแลระบบต้องเข้าสู่ระบบ +Main Flow: + +ผู้ดูแลระบบเลือกเอกสาร +กด “จัดการสิทธิ์” +เลือกผู้ใช้งานและกำหนดสิทธิ์ (อ่าน, แก้ไข, ลบ) +กด “บันทึก” + +Postconditions: สิทธิ์การเข้าถึงเอกสารถูกปรับตามที่กำหนด + +#### 📘 Use Case: View Document History + +Actor: ผู้ใช้งานทั่วไป / ผู้ดูแลระบบ +Description: ผู้ใช้งานสามารถดูประวัติการใช้งานเอกสาร เช่น การแก้ไข การดาวน์โหลด +Preconditions: ผู้ใช้งานต้องมีสิทธิ์เข้าถึงเอกสาร +Main Flow: + +ผู้ใช้งานเปิดเอกสาร +เลือก “ดูประวัติ” +ระบบแสดงรายการกิจกรรมที่เกี่ยวข้องกับเอกสาร + +Postconditions: ผู้ใช้งานสามารถตรวจสอบการเปลี่ยนแปลงย้อนหลังได้ + +### 🔄 0.7 Workflow อัตโนมัติในระบบ DMS + +✅ ประโยชน์ของ Workflow อัตโนมัติใน DMS + +- ลดภาระงานซ้ำ ๆ ของผู้ใช้งาน +- เพิ่มความปลอดภัยและการควบคุมเอกสาร +- เพิ่มความเร็วในการดำเนินงาน +- ลดข้อผิดพลาดจากการทำงานด้วยมือ + +#### 🧩 Workflow: 1. Document treat Workflow + +กรณี: เมื่อมีการอัปโหลดเอกสารต้องได้รับการมอบหมายงานให้กับ พนักงานภายในองค์กรณ์ +ขั้นตอนอัตโนมัติ: + +1. ผู้ใช้งานอัปโหลดเอกสารและเลือก “มอบหมายงาน” +2. ระบบส่งแจ้งเตือนไปยังผู้ได้รับมอบหมายงาน +3. ผู้อนุมัติสามารถตรวจสอบและกด “ตรวจสอบแล้ว” +4. ระบบบันทึกสถานะเอกสารและ ส่งต่อ ไปยัง องกรณือื่น ตามลำดับ เมื่อได้ผลและจัดทำเอกสารตอบแล้ว จึงแจ้งผลกลับไปยังผู้ส่ง + +#### 📥 Workflow: 2. Auto Tagging & Categorization + +กรณี: เอกสารที่อัปโหลดมีชื่อหรือเนื้อหาที่ตรงกับหมวดหมู่ที่กำหนดไว้ +ขั้นตอนอัตโนมัติ: + +เมื่ออัปโหลดเอกสาร ระบบวิเคราะห์ชื่อไฟล์หรือเนื้อหา +ระบบกำหนดหมวดหมู่และแท็กให้โดยอัตโนมัติ เช่น “ใบเสนอราคา” → หมวด “การเงิน” +ผู้ใช้งานสามารถแก้ไขได้หากต้องการ + +#### 🔐 Workflow: 3. Access Control Workflow + +กรณี: เอกสารที่มีความลับสูงต้องจำกัดการเข้าถึง +ขั้นตอนอัตโนมัติ: + +เมื่ออัปโหลดเอกสารที่มีคำว่า “ลับ” หรือ “Confidential” +ระบบกำหนดสิทธิ์เริ่มต้นให้เฉพาะผู้ใช้งานระดับผู้จัดการขึ้นไป +ระบบแจ้งเตือนผู้ดูแลระบบให้ตรวจสอบสิทธิ์เพิ่มเติม + +#### 📤 Workflow: 4. Expiry & Archiving Workflow + +กรณี: เอกสารที่มีอายุการใช้งาน เช่น สัญญา หรือใบอนุญาต +ขั้นตอนอัตโนมัติ: + +เมื่ออัปโหลดเอกสาร ผู้ใช้งานระบุวันหมดอายุ +ระบบแจ้งเตือนก่อนหมดอายุล่วงหน้า เช่น 30 วัน +เมื่อถึงวันหมดอายุ ระบบย้ายเอกสารไปยังหมวด “Archive” โดยอัตโนมัติ + +#### 📊 Workflow: 5. Audit Trail & Notification Workflow + +กรณี: มีการแก้ไขหรือดาวน์โหลดเอกสารสำคัญ +ขั้นตอนอัตโนมัติ: + +ทุกการกระทำกับเอกสาร (เปิด, แก้ไข, ลบ) จะถูกบันทึกใน Audit Log +หากเอกสารถูกแก้ไขโดยผู้ใช้งานที่ไม่ใช่เจ้าของ ระบบแจ้งเตือนเจ้าของเอกสารทันที + +## 🛠️ 1. DMS Architecture Deep Dive (Backend + Frontend) + +### 1.1 Executive Summary + +- Reverse proxy (Nginx/NPM) เผยแพร่ Frontend (Next.js) และ Backend (Node.js/Express) ผ่าน HTTPS (HSTS) +- Backend เชื่อม MariaDB 10.11 (ข้อมูลหลัก DMS) และแยก n8n + Postgres 16 สำหรับ workflow +- RBAC/ABAC ถูกบังคับใช้งานใน middleware + มีชุด SQL (tables → triggers → procedures → views → seed) +- ไฟล์จริง (PDF/DWG) เก็บนอก webroot ที่ /share/dms‑data พร้อมมาตรฐานการตั้งชื่อ+โฟลเดอร์ +- Dev/Prod แยกชัดเจนผ่าน Docker multi‑stage + docker‑compose + โฟลเดอร์ persist logs/config/certs + +### 1.2 Runtime Topology & Trust Boundaries + +```text +Internet Clients (Browser) + │ HTTPS 443 (HSTS) [QNAP mgmt = 8443] + ▼ +┌─────────────────────────────────────────────────────┐ +│ Reverse Proxy Layer │ +│ ├─ Nginx (Alpine) or Nginx Proxy Manager (NPM) │ +│ ├─ TLS (LE cert; SAN multi‑subdomain) │ +│ └─ Routes: │ +│ • /, /_next/* → Frontend (Next.js :3000) │ +│ • /api/* → Backend (Express :3001) │ +│ • /pma/* → phpMyAdmin │ +│ • /n8n/* → n8n (Workflows) │ +└─────────────────────────────────────────────────────┘ + │ │ + │ └──────────┐ + ▼ │ + Frontend (Next.js) │ + │ Cookie-based Auth (HttpOnly) │ + ▼ ▼ + Backend (Node/Express ESM) ─────────► MariaDB 10.11 + │ │ + └────────────────────────────────────┘ + Project data (.pdf/.dwg) @ /share/dms-data + + n8n (workflows) ──► Postgres 16 (separate DB for automations) +``` + +==Trust Boundaries== + +- Public zone: Internet ↔ Reverse proxy +- App zone: Reverse proxy ↔ FE/BE containers (internal Docker network) +- # Data zone: Backend ↔ Databases (MariaDB, Postgres) + /share/dms-data + +### 1.3 Frontend: Next.js (ESM) / React.js + +#### 1.3.1 Stack & Key libs + +- Next.js (App Router), React, ESM +- Tailwind CSS, PostCSS, shadcn/ui (components.json) +- Fetch API (credentials include) → Cookie Auth (HttpOnly) + +#### 1.3.2 Directory Layout + +```text +/frontend/ +├─ app/ +│ ├─ login/ +│ ├─ dashboard/ +│ ├─ users/ +│ ├─ correspondences/ +│ ├─ health/ +│ └─ layout.tsx / page.tsx (ตาม App Router) +├─ public/ +├─ Dockerfile (multi-stage: dev/prod) +├─ package.json +├─ next.config.js +└─ ... +``` + +#### 1.3.3 Routing & Layouts + +- Public /login, /health +- Protected: /dashboard, /users, /correspondences, ... (client-side guard) +- เก็บ middleware.ts (ของเดิม) เพื่อหลีกเลี่ยง regression; ใช้ client‑guard + server action อย่างระมัดระวัง + +#### 1.3.4 Auth Flow (Cookie-based) + +1. ผู้ใช้ submit form /login → POST /api/auth/login (Backend) +2. Backend set HttpOnly cookie (JWT) + SameSite=Lax/Strict, Secure +3. หน้า protected เรียก GET /api/auth/me เพื่อตรวจสอบสถานะ +4. หาก 401 → redirect → /login + +**CORS/Fetch**: เเปิด credentials: 'include' ทุกครั้ง, ตั้ง NEXT_PUBLIC_API_BASE เป็น origin ของ backend ผ่าน proxy (เช่น https://lcbp3.np-dms.work) + +#### 1.3.5 UI/UX + +- Sea‑blue palette, sidebar พับได้, card‑based KPI +- ตารางข้อมูลเตรียมรองรับ server‑side DataTables\*\* +- shadcn/ui: Button, Card, Badge, Tabs, Dropdown, Tooltip, Switch, etc. + +#### 1.3.6 Config & ENV + +- NEXT_PUBLIC_API_BAS (ex: https://lcbp3.np-dms.work) +- Build output แยก dev/prod; ระวัง EACCES บน QNAP → ใช้ user node + ปรับสิทธิ์โวลุ่ม .next/\* + +#### 1.3.7 Error Handling & Observability (FE) + +- Global error boundary (app router) + toast/alert patterns +- Network layer: แยก handler สำหรับ 401/403/500 + retry/backoff ที่จำเป็น +- Metrics (optional): web‑vitals, UX timing (เก็บฝั่ง n8n หรือ simple logging) + +--- + +### 1.4 Backend Architecture (Node.js ESM / Express) + +#### 1.4.1 Stack & Structure + +- Node 20.x, ESM modules, Express\*\* +- mysql2/promise, jsonwebtoken, cookie-parser, cors, helmet, winston/morgan + +```text +/backend/ +├─ src/ +│ ├─ index.js # bootstrap server, CORS, cookies, health +│ ├─ routes/ +│ │ ├─ auth.js # /api/auth/* (login, me, logout) +│ │ ├─ users.js # /api/users/* +│ │ ├─ correspondences.js # /api/correspondences/* +│ │ ├─ drawings.js # /api/drawings/* +│ │ ├─ rfas.js # /api/rfas/* +│ │ └─ transmittals.js # /api/transmittals/* +│ ├─ middleware/ +│ │ ├─ authGuard.js # verify JWT from cookie +│ │ ├─ requirePermission.js# RBAC/ABAC enforcement +│ │ ├─ errorHandler.js +│ │ └─ requestLogger.js +│ ├─ db/ +│ │ ├─ pool.js # createPool, sane defaults +│ │ └─ models/ # query builders (User, Drawing, ...) +│ ├─ utils/ +│ │ ├─ hash.js (bcrypt/argon2) +│ │ ├─ jwt.js +│ │ ├─ pagination.js +│ │ └─ responses.js +│ └─ config/ +│ └─ index.js # env, constants +├─ Dockerfile +└─ package.json +``` + +#### 1.4.2 Request Lifecycle + +1. helmet + cors (allow specific origin; credentials true) +2. cookie-parser, json limit (e.g., 2MB) +3. requestLogger → trace + response time +4. Route handler → authGuard (protected) → requirePermission (per‑route) → Controller +5. Error bubbles → errorHandler (JSON shape, status map) + +#### 1.4.3 Auth & RBAC/ABAC + +- JWT ใน HttpOnly cookie; Claims: sub (user_id), roles, exp +- authGuard: ตรวจ token → แนบ req.user +- requirePermission: เช็ค permission ตามเส้นทาง/วิธี; แผนขยาย ABAC (เช่น project scope, owner, doc state) +- Roles/Permissions ถูก seed ใน SQL; มี view เมทริกซ์ เพื่อ debug (เช่น v_role_permission_matrix) + +\*\*ตัวอย่าง pseudo requirePermission(permission) + +```js +export const requirePermission = (perm) => async (req, res, next) => { + if (!req.user) return res.status(401).json({ error: "Unauthenticated" }); + const ok = await checkPermission(req.user.user_id, perm, req.context); + if (!ok) return res.status(403).json({ error: "Forbidden" }); + return next(); +}; +``` + +#### 1.4.4 Database Access & Pooling + +- createPool({ connectionLimit: 10~25, queueLimit: 0, waitForConnections: true }) +- ใช้ parameterized queries เสมอ; ปรับ sql_mode ที่จำเป็นใน my.cnf + +#### 1.4.5 File Storage & Secure Download + +- Root: /share/dms‑data +- โครงโฟลเดอร์: {module}/{yyyy}/{mm}/{entityId}/ + ชื่อไฟล์ตามมาตรฐาน (เช่น DRW-code-REV-rev.pdf) +- Endpoint download: ตรวจสิทธิ์ (RBAC/ABAC) → res.sendFile()/stream; ป้องกัน path traversal +- MIME allowlist + size limit + virus scan (optional; ภายหลัง) + +#### 1.4.6 Health & Readiness + +- GET /api/health → { ok: true } +- (optional) /api/ready ตรวจ DB ping + disk space (dms‑data) + +#### 1.4.7 Config & ENV (BE) + +- DB_HOST, DB_PORT, DB_USER, DB_PASS, DB_NAME +- JWT_SECRET, COOKIE_NAME, COOKIE_SAMESITE, COOKIE_SECURE +- CORS_ORIGIN, LOG_LEVEL, APP_BASE_URL +- FILE_ROOT=/share/dms-data + +#### 1.4.8 Logging + +- Access log (morgan) + App log (winston) → /share/Container/dms/logs/backend/ +- รูปแบบ JSON (timestamp, level, msg, reqId) + daily rotation (logrotate/container‑side) + +### 1.5 Database (MariaDB 10.11) + +#### 1.5.1 Schema Overview (ย่อ) + +- RBAC core: users, roles, permissions, user_roles, role_permissions +- Domain: drawings, contracts, correspondences, rfas, transmittals, organizations, projects, ... +- Audit: audit_logs (แผนขยาย), deleted_at (soft delete, แผนงาน) + +```text +[users]────[roles]────[permissions] + │ + └── activities/audit_logs (future expansion) + +[drawings]────[contracts] +[rfas]────[drawings] +[correspondences] (internal/external flag) +``` + +#### 1.5.2 Init SQL Pipeline + +1. 01\_\*\_deploy_table_rbac.sql — สร้างตารางหลักทั้งหมด + RBAC +2. 02\_\*\_triggers.sql — บังคับ data rules, auto‑audit fields +3. 03\_\*\_procedures_handlers.sql — upsert/bulk handlers (เช่น sp_bulk_import_contract_dwg) +4. 04\_\*\_views.sql — รายงาน/เมทริกซ์สิทธิ์ (v_role_permission_matrix, etc.) +5. 05\_\*\_seed_data.sql — ค่าพื้นฐาน domain (project, categories, statuses) +6. 06\_\*\_seed_users.sql — บัญชีเริ่มต้น (superadmin, editors, viewers) +7. 07\_\*\_seed_contract_dwg.sql — ข้อมูลตัวอย่างแบบสัญญา + +#### 1.5.3 Indexing & Performance + +- Composite indexes ตามคอลัมน์ filter/sort (เช่น (project_id, updated_at DESC)) +- Full‑text index (optional) สำหรับ advanced search +- Query plan review (EXPLAIN) + เพิ่ม covering index ตามรายงาน + +#### 1.5.4 MySQL/MariaDB Config (my.cnf — แนวทาง) + +```conf +[mysqld] +innodb_buffer_pool_size = 4G # ปรับตาม RAM/QNAP +innodb_log_file_size = 512M +innodb_flush_log_at_trx_commit = 1 +max_connections = 200 +sql_mode = STRICT_TRANS_TABLES,NO_ENGINE_SUBSTITUTION +character-set-server = utf8mb4 +collation-server = utf8mb4_unicode_ci +``` + +> ปรับค่าให้เหมาะกับ workload จริง + เฝ้าดู IO/CPU ของ QNAP + +#### 1.5.5 Backup/Restore + +- Logical backup: mysqldump --routines --triggers --single-transaction +- Physical (snapshot QNAP) + schedule ผ่าน n8n/cron +- เก็บสำเนา off‑NAS (encrypted) + +### 1.6 Reverse Proxy & TLS + +#### 1.6.1 Nginx (Alpine) — ตัวอย่าง server block + +> สำคัญ: บนสภาพแวดล้อมนี้ ให้ใช้คนละบรรทัด: +> listen 443 ssl; +> http2 on; +> หลีกเลี่ยง listen 443 ssl http2; + +```conf +server { + listen 80; + server_name lcbp3.np-dms.work; + return 301 https://$host$request_uri; +} + +server { + listen 443 ssl; + http2 on; + server_name lcbp3.np-dms.work; + + ssl_certificate /etc/nginx/certs/fullchain.pem; + ssl_certificate_key /etc/nginx/certs/privkey.pem; + add_header Strict-Transport-Security "max-age=63072000; preload" always; + + # Frontend + location / { + proxy_pass http://frontend:3000; + proxy_set_header Host $host; + proxy_set_header X-Real-IP $remote_addr; + proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for; + proxy_set_header X-Forwarded-Proto $scheme; + } + + # Next.js static + location /_next/ { + proxy_pass http://frontend:3000; + } + + # Backend API + location /api/ { + proxy_http_version 1.1; + proxy_set_header Connection ""; + proxy_pass http://backend:3001; + proxy_set_header Host $host; + proxy_set_header X-Real-IP $remote_addr; + proxy_set_header X-Forwarded-Proto $scheme; + } + + # phpMyAdmin (sub-path) + location /pma/ { + proxy_pass http://phpmyadmin:80/; + } + + # n8n + location /n8n/ { + proxy_pass http://n8n:5678/; + } +} +``` + +#### 1.6.2 Nginx Proxy Manager (NPM) — Tips + +- ระวังอย่าใส่ proxy_http_version ซ้ำซ้อน (duplicate directive) ใน Advanced +- ถ้าต้องแก้ไฟล์ด้านใน NPM → ระวังไฟล์ใน /data/nginx/proxy_host/\*.conf +- จัดการ certificate / SAN หลาย sub‑domain ใน UI แต่ mainten ดีเรื่อง symlink/renew + +#### 1.6.3 TLS & Certificates + +- Let’s Encrypt (HTTP‑01 webroot/standalone) + HSTS +- QNAP mgmt เปลี่ยนเป็น 8443 → พอร์ต 443 public ว่างสำหรับ Nginx/NPM + +### 1.7 Docker Compose Topology + +#### 1.7.1 Services (สรุป) + +- frontend (Next.js) :3000 +- backend (Express) :3001 +- mariadb (10.11) :3306 (internal) +- phpmyadmin :80 (internal) +- nginx or npm :80/443 (published) +- n8n :5678 (internal) +- postgres_n8n (16-alpine) +- pgadmin4 + +#### 1.7.2 Volumes & Paths + +```text +/share/Container/dms/ +├─ mariadb/data +├─ mariadb/init/*.sql +├─ backend/ (code) +├─ frontend/ (code) +├─ phpmyadmin/{sessions,tmp,config.user.inc.php} +├─ nginx/{nginx.conf,dms.conf,certs/} +├─ n8n, n8n-postgres, n8n-cache +└─ logs/{backend,frontend,nginx,pgadmin,phpmyadmin,postgres_n8n} +/share/dms-data (pdf/dwg storage) +``` + +#### 1.7.3 Healthchecks (suggested) + +- backend: + + ```sh + curl http://localhost:3001/api/health + ``` + +- frontend: curl /health (simple JSON) +- mariadb: mysqladmin ping with credentials +- nginx: nginx -t at startup + +#### 1.7.4 Security Hardening + +- รัน container ด้วย user non‑root (user: node สำหรับ FE/BE) +- จำกัด capabilities; read‑only FS (ยกเว้นโวลุ่มจำเป็น) +- เฉพาะ backend เมานต์ /share/dms-data + +### 1.8 Observability, Ops, and Troubleshooting + +#### 1.8.1 Logs + +- Frontend → /logs/frontend/\* +- Backend → /logs/backend/\* (app/access/error) +- Nginx/NPM → /logs/nginx/\* +- MariaDB → default datadir log + slow query (เปิดใน my.cnf หากต้องการ) + +#### 1.8.2 Common Issues & Playbooks + +- 401 Unauthenticated: ตรวจ authGuard → JWT cookie มี/หมดอายุ → เวลา server/FE sync → CORS credentials: true +- EACCES Next.js: สิทธิ์ .next/\* + run as`node, โวลุ่ม map ถูก user:group +- NPM duplicate directive: ลบซ้ำ proxy_http_version ใน Advanced / ตรวจ proxy_host/\*.conf +- LE cert path/symlink: ตรวจ /etc/letsencrypt/live/npm-\* symlink ชี้ถูก +- DB field not found: ตรวจ schema vs code (migration/init SQL) → sync ให้ตรง + +#### 1.8.3 Performance Guides + +- Backend: keep‑alive, gzip/deflate at proxy, pool 10–25, paginate, avoid N+1 +- Frontend: prefetch critical routes, cache static, image optimization +- DB: เพิ่ม index จุด filter, analyze query (EXPLAIN), ปรับ buffer pool + +### 1.9 Security & Compliance + +- HTTPS only + HSTS (preload) +- CORS: allow list เฉพาะ FE origin; Access-Control-Allow-Credentials: true +- Cookie: HttpOnly, Secure, SameSite=Lax/Strict +- Input Validation: celebrate/zod (optional) + sanitize +- Rate limiting: per IP/route (optional) +- AuditLog: วางแผนเพิ่ม ครอบคลุม CRUD + mapping (actor, action, entity, before/after) +- Backups: DB + /share/dms-data + config (encrypted off‑NAS) + +### 1.10 Backlog → Architecture Mapping + +1. RBAC Enforcement ครบ → เติม requirePermission ทุก route + test matrix ผ่าน view +2. AuditLog ครบ CRUD/Mapping → trigger + table audit_logs + BE hook +3. Upload/Download จริงของ Drawing Revisions → BE endpoints + virus scan (optional) +4. Dashboard KPI → BE summary endpoints + FE cards/charts +5. Server‑side DataTables → paging/sort/filter + indexesรองรับ +6. รายงาน Export CSV/Excel/PDF → BE export endpoints + FE buttons +7. Soft delete (deleted_at) → BE filter default scope + restore endpoint +8. Validation เข้ม → celebrate/zod schema + consistent error shape +9. Indexing/Perf → slow query log + EXPLAIN review +10. Job/Cron Deadline Alerts → n8n schedule + SMTP + +### 1.11 Port & ENV Matrix (Quick Ref) + +| Component | Ports | Key ENV | +| Nginx/NPM | 80/443 (public) | SSL paths, HSTS | +| Frontend | 3000 (internal) | NEXT*PUBLIC_API_BASE | +| Backend | 3001 (internal) | DB*\*, JWT*SECRET, CORS_ORIGIN, FILE_ROOT | +| MariaDB | 3306 (internal) | MY_CNF, credentials | +| n8n | 5678 (internal) | N8N*, webhook URL under /n8n/ | +| Postgres | 5432 (internal) | n8n DB | + +QNAP mgmt: 8443 (already moved) + +### 1.12 Sample Snippets + +#### 1.12.1 Backend CORS (credentials) + +```js +app.use( + cors({ + origin: ["https://lcbp3.np-dms.work"], + credentials: true, + }) +); +``` + +#### 1.12.2 Secure Download (guarded) + +```js +router.get( + "/files/:module/:id/:filename", + authGuard, + requirePermission("file.read"), + async (req, res) => { + const { module, id, filename } = req.params; + // 1) ABAC: verify user can access this module/entity + const ok = await canReadFile(req.user.user_id, module, id); + if (!ok) return res.status(403).json({ error: "Forbidden" }); + + const abs = path.join(FILE_ROOT, module, id, filename); + if (!abs.startsWith(FILE_ROOT)) + return res.status(400).json({ error: "Bad path" }); + return res.sendFile(abs); + } +); +``` + +#### 1.12.3 Healthcheck + +```js +router.get("/health", (req, res) => res.json({ ok: true })); +``` + +### 13 Deployment Workflow (Suggested) + +1. Git (Gitea) branch strategy feature/\* → PR → main +2. Build images (dev/prod) via Dockerfile multi‑stage; pin Node/MariaDB versions +3. docker compose up -d --build จาก /share/Container/dms +4. Validate: /health, /api/health, login roundtrip +5. Monitor logs + baseline perf; run SQL smoke tests (views/triggers/procs) + +### 14 Appendix + +- Naming conventions: snake_case DB, camelCase JS +- Timezones: store UTC in DB; display in app TZ (+07:00) +- Character set: UTF‑8 (utf8mb4_unicode_ci) +- Large file policy: size limit (e.g., 50–200MB), allowlist extensions +- Retention: archive strategy for old revisions (optional) + +## บทบาท: คุณคือ Programmer และ Document Engineer ที่เชี่ยวชาญ + +1. การพัฒนาเว็บแอป (Web Application Development) +2. Configuration of Container Station on QNAP +3. Database: mariadb:10.11 +4. Database management: phpmyadmin:5-apache +5. Backend: node:.js (ESM) +6. Frontend: next.js, react +7. Workflow automation: n8n: +8. Workflow database: postgres:16-alpine +9. Workflow database management: pgadmin4 +10. Reverse proxy: nginx:1.27-alpine +11. linux on QNAP +12. การจัดการฐานข้อมูล (Database Management) +13. การวิเคราะห์ฐานข้อมูล (Database Analysis) +14. การจัดการฐานข้อมูลเชิงสัมพันธ์ (Relational Databases) +15. ภาษา SQL +16. RBAC + +## 2. ระบบที่ใช้ + +## Server + +- ใช้ Container Station เป็น SERVER บน QNAP (Model: TS-473A, RAM: 32GB, CPU: AMD Ryzen V1500B 4 cores 8 threads) **เปลี่ยน port 443 ของ QNAP เป็น 8443 แล้ว** + +## การพัฒนาโครงการ + +- ด้วย Visual Studio Code บน Windows 11 +- ใช้ ๊ UI ของ Container Station เป็นหลัก + +## โครงสร้างโฟลเดอร์ (บน QNAP) + +/share/Container/dms/ +├─ docker-compose.yml # Create โดย UI Container Station +├─ mariadb/ +│ ├─ data/ # ข้อมูลจริงของ MariaDB +│ ├─ init/ # ข้อมูลเริ่มต้นของ MariaDB +│ │ ├─ 01_dms_data_v5_1_deploy_table_rbac.sql # Create all data table & RBAC table here! +│ │ ├─ 02_dms_data_v5_1_triggers.sql # Create all triggers here! +│ │ ├─ 03_dms_data_v5_1_procedures_handlers.sql # Create all procedures here! +│ │ ├─ 04_dms_data_v5_1_views.sql # Create all views here! +│ │ ├─ 05 dms_data_v5_1_seeก_data.sql # Seed nescesary data here! +│ │ ├─ 06_dms_data_v5_1_seed_users.sql # Seed users data here! +│ │ └─ 07_dms_data_v5_1_seed_contract_dwg.sql # Seed contract drawing data here! +│ └─ my.cnf +├─ backend/ +│ ├─ app/ +│ ├─ src/ +│ │ ├─ db/ +│ │ │ └─models/ +│ │ ├─ middleware/ +│ │ ├─ routes/ +│ │ ├─ utils/ +│ │ └─ index.js +│ ├─ Dockerfile +│ ├─ package.json +│ └─ package-lock.json # ไม่มี +├─ frontend/ +│ ├─ app/ +│ │ ├─ correspondences/ +│ │ ├─ dashboard/ +│ │ ├─ health/ +│ │ ├─ login/ +│ │ └─ users/ +│ ├─ public/ +│ ├─ Dockerfile +│ ├─ package.json +│ ├─ package-lock.json # ไม่มี +│ ├─ next.config.js +│ └─ page.jsx +├─ phpmyadmin/ +│ ├─ sessions/ # โฟลเดอร์เซสชันถาวรของ phpMyAdmin +│ ├─ tmp/ +│ ├─ config.user.inc.php +│ └─ zzz-custom.ini +├─ nginx/ +│ ├─ certs/ +│ ├─ nginx.conf +│ └─ dms.conf +├─ n8n/ +├─ n8n-cache/ +├─ n8n-postgres/ +└─ logs/ +├─ backend/ +├─ frontend/ +├─ nginx/ +├─ pgadmin/ +├─ phpmyadmin/ +└─ postgres_n8n/ +/share/dms-data # เก็บข้อมมูล .pdf, .dwg แยกตาม correspondences, documents + +# งานที่ต้องการ: + +- ไม่ใช้ .env เด็ดขาด Container Station ไม่รองรับ และ docker-compose.yml ได้ทดสอบ รันบน Container station มาแล้ว +- Code ของ backend ทั้งหมด +- การทดสอบระบบ backend ทุกส่วน ให้พร้อม สำหรับ frontend + +# กรณี 2: มี Git อยู่แล้ว (มี main อยู่) + +2.1 อัปเดต main ให้ตรงล่าสุดก่อนแตกบร้านช์ + +cd /share/Container/dms +git checkout main +git pull --ff-only # ถ้าเชื่อม remote อยู่ +git tag -f stable-$(date +%F) # tag จุดเสถียรปัจจุบัน + +2.2 แตก branch งาน Dashboard +git checkout -b feature/dashboard-update-$(date +%y%m%d) +git checkout -b feature/dashboard-update-251004 + +2.3 ทำงาน/คอมมิตตามปกติ + +# แก้ไฟล์ frontend/app/dashboard/\* และที่เกี่ยวข้อง + +git add frontend/app/dashboard +git commit -m "feat(dashboard): เพิ่มส่วนจัดการ user" +git push -u origin feature/dashboard-update-251004 diff --git a/docs/DMS v1.3.0 - Interactive Report.html b/docs/DMS v1.3.0 - Interactive Report.html new file mode 100644 index 0000000..f9323e8 --- /dev/null +++ b/docs/DMS v1.3.0 - Interactive Report.html @@ -0,0 +1,724 @@ + + + + + + DMS v1.3.0 - รายงานสรุปสถาปัตยกรรมระบบ + + + + + + + + + + + + + + +
+ +
+ + +
+ + +
+

ภาพรวมระบบ (Overview)

+

+ นี่คือรายงานสรุปเชิงโต้ตอบสำหรับ **ระบบจัดการเอกสาร (DMS) v1.3.0** แอปพลิเคชันนี้ถูกออกแบบมาเพื่อวิเคราะห์ข้อกำหนดของระบบ, สถาปัตยกรรม, และโครงสร้างข้อมูล เพื่อให้ทีมพัฒนาและผู้มีส่วนได้ส่วนเสียสามารถทำความเข้าใจภาพรวมของโปรเจกต์ที่ซับซ้อนนี้ได้อย่างรวดเร็ว +

+
+
+
6+
+
โมดูลเอกสารหลัก
+
+
+
44+
+
ตารางข้อมูล (Tables)
+
+
+
5+
+
วิวข้อมูล (Views)
+
+
+
7
+
Services (Docker)
+
+
+
+ + +
+

สถาปัตยกรรมและเทคโนโลยี (System Architecture)

+

+ ระบบ DMS v1.3.0 ถูกออกแบบบนสถาปัตยกรรม Headless/API-First ที่ทันสมัย โดยทำงานทั้งหมดบน QNAP Server ผ่าน Container Station (Docker) เพื่อให้ง่ายต่อการจัดการและบำรุงรักษา +

+ +
+

แผนผังการเชื่อมต่อ (Docker Container Stack)

+
+ +
+
Nginx Proxy Manager
+

np-dms.work (HTTPS)

+ + +
+
Network: 'lcbp3'
+ +
+ +
+
+

Next.js (Frontend)

+

ให้บริการ UI (React)

+
+
+ +
+
+

NestJS (Backend)

+

จัดการ API & Business Logic

+
+
+ +
+
+

N8N (Automation)

+

จัดการ Workflow & Line Notify

+
+
+
+ + +
+
+
▼
+
+ + +
+
+

MariaDB (Database)

+

เก็บข้อมูลทั้งหมด (SQL)

+
+
+

Elasticsearch (Search)

+

ให้บริการค้นหาขั้นสูง

+
+
+ +
+
+
+
+
+ + +
+

โมดูลเอกสารหลัก (Document Modules)

+

+ ระบบ DMS แบ่งการจัดการเอกสารออกเป็นโมดูลย่อยที่ชัดเจน แต่ละโมดูลมี Workflow และตารางข้อมูลเฉพาะของตนเอง แต่ทั้งหมดเชื่อมโยงกับโครงสร้างเอกสารกลาง (Correspondence) +

+
+ +
+
+

1. Correspondence (เอกสารโต้ตอบ)

+

โมดูลหลักสำหรับเอกสารเข้า-ออกทั่วไป (จดหมาย, เมโม) เป็นตาราง "แม่" สำหรับเอกสารประเภทอื่นเกือบทั้งหมด

+ ตารางข้อมูลหลัก: +
    +
  • `correspondences` (Master)
    • +
  • `correspondence_revisions` (Child)
    • +
  • `correspondence_recipients`
    • +
+
+
+ +
+
+

2. RFA (ขออนุมัติ)

+

โมดูลสำหรับเอกสารขออนุมัติ (Request for Approval) เช่น ขออนุมัติแบบ, วัสดุ, หรือเอกสาร ที่มี Workflow ชัดเจน (Draft, Submit, Review, Approved)

+ ตารางข้อมูลหลัก: +
    +
  • `rfas` (Master)
    • +
  • `rfa_revisions` (Child)
    • +
  • `rfa_status_codes`
    • +
  • `rfa_items` (เชื่อม Shop Drawing)
    • +
+
+
+ +
+
+

3. Drawing (แบบแปลน)

+

จัดการแบบแปลน 2 ประเภทหลัก: แบบตามสัญญา (Contract Drawing) และแบบสำหรับก่อสร้าง (Shop Drawing) ซึ่ง Shop Drawing จะถูกอ้างอิงใน RFA

+ ตารางข้อมูลหลัก: +
    +
  • `contract_drawings`
    • +
  • `shop_drawings` (Master)
    • +
  • `shop_drawing_revisions` (Child)
    • +
  • `shop_drawing_revision_contract_refs`
    • + +
+
+
+ +
+
+

4. Transmittal (เอกสารนำส่ง)

+

เอกสารนำส่ง (คล้ายใบปะหน้า) ที่ใช้สำหรับรวบรวมเอกสาร RFA หลายๆ ฉบับ เพื่อส่งให้ผู้รับในคราวเดียว

+ ตารางข้อมูลหลัก: +
    +
  • `transmittals` (1:1 with Correspondence)
    • +
  • `transmittal_items` (เชื่อม RFA)
    • +
+
+
+ +
+
+

5. Circulation (ใบเวียนภายใน)

+

ระบบใบเวียนภายในองค์กร (Internal) ใช้สำหรับส่งเอกสาร (ที่อ้างอิงจาก Correspondence) เพื่อให้ทีมตรวจสอบ, รับทราบ, หรือดำเนินการ

+ ตารางข้อมูลหลัก: +
    +
  • `circulations` (Master)
    • +
  • `circulation_assignees` (Tasks)
    • +
  • `circulation_actions` (Logs)
    • +
+
+
+ +
+
+

6. สัดส่วนตารางข้อมูล

+

แผนภูมิแสดงสัดส่วนตารางข้อมูลที่เกี่ยวข้องในแต่ละโมดูลหลัก (ไม่รวมตาราง Core และ RBAC)

+
+ +
+
+
+ +
+
+ + +
+

ฟีเจอร์หลัก (Core Features)

+

+ นอกเหนือจากโมดูลเอกสาร ระบบยังมีฟีเจอร์สนับสนุนที่สำคัญ ซึ่งทำงานข้ามโมดูลต่างๆ เพื่อให้ระบบทำงานได้อย่างสมบูรณ์ +

+
+ +
+

การจัดการสิทธิ์ (RBAC)

+

+ ระบบใช้ Role-Based Access Control (RBAC) ที่ละเอียดมาก ผู้ใช้ (Users) จะได้รับบทบาท (Roles) ซึ่งผูกกับสิทธิ์ (Permissions) + แผนภูมินี้แสดงตัวอย่างจำนวนสิทธิ์ (Permissions) ที่แต่ละบทบาทพื้นฐานอาจมี เพื่อให้เห็นภาพความซับซ้อนในการเข้าถึง +

+
+ +
+
+ +
+

การสร้างเลขที่เอกสาร (Numbering)

+

+ หนึ่งในส่วนที่สำคัญที่สุด คือการสร้างเลขที่เอกสาร (Running Number) เพื่อป้องกันเลขที่ซ้ำ (Race Condition) ระบบใช้ Stored Procedure (`sp_get_next_document_number`) ใน MariaDB ซึ่งใช้คำสั่ง `SELECT ... FOR UPDATE` เพื่อ "ล็อก" แถวของตัวนับก่อนที่จะอัปเดตค่า +

+ 
+SELECT last_number
+INTO v_last_number
+FROM document_number_counters
+WHERE project_id = p_project_id 
+  AND ...
+FOR UPDATE;
+
+IF v_last_number IS NULL THEN
+  INSERT INTO ... (last_number) VALUES (1);
+  SET p_next_number = 1;
+ELSE
+  SET p_next_number = v_last_number + 1;
+  UPDATE document_number_counters
+  SET last_number = p_next_number
+  WHERE ...;
+END IF;
+
+ +
+

การค้นหา (Advanced Search)

+

+ (Req 6.2) ระบบใช้ **Elasticsearch** เป็น Service แยกต่างหากสำหรับให้บริการค้นหาขั้นสูง + NestJS (Backend) จะทำการ Index ข้อมูลจาก Views (`v_current_correspondences`, `v_current_rfas` ฯลฯ) ไปยัง Elasticsearch + ทำให้ผู้ใช้สามารถค้นหาแบบ Full-text ข้ามโมดูลทั้งหมด (Correspondence, RFA, Drawing) ได้อย่างรวดเร็ว +

+
+ +
+

การแจ้งเตือน (Notifications)

+

+ (Req 6.7) ระบบใช้ **N8N (Automation)** เป็นศูนย์กลางการแจ้งเตือน + เมื่อมีเหตุการณ์สำคัญ (เช่น มีการสร้างใบเวียนใหม่) NestJS (Backend) จะยิง Webhook ไปที่ N8N + จากนั้น N8N จะทำหน้าที่ส่งการแจ้งเตือนไปยัง **Line Notify** หรือ Email ตาม Workflow ที่ตั้งค่าไว้ +

+
+
+
+ + +
+

สำรวจโครงสร้างข้อมูล (Data Explorer)

+

+ ระบบ DMS มีตารางข้อมูลมากกว่า 44 ตารางเพื่อรองรับฟีเจอร์ที่ซับซ้อน เลือกตารางจากรายการด้านล่างเพื่อดูโครงสร้าง, ประเภทข้อมูล, และความสัมพันธ์ (Foreign Keys) +

+ +
+
+ + +
+ +
+

+

+ +
+ + + + + + + + + + + +
Column (Field)TypeDescription / Relation
+
+
+
+
+ +
+ +
+

Interactive Report generated for DMS v1.3.0

+
+ + + + \ No newline at end of file diff --git a/docs/Docker compose all.yaml b/docs/Docker compose all.yaml new file mode 100644 index 0000000..7d0a73e --- /dev/null +++ b/docs/Docker compose all.yaml @@ -0,0 +1,194 @@ +# version: '3.8' + +# ========================================================== +# Volumes (พื้นที่จัดเก็บข้อมูลถาวร) +# ========================================================== +volumes: + # (จากไฟล์เดิม) + backend_node_modules: + + # (ที่เพิ่มใหม่) + db_data: # 2.4. Database + npm_data: # 2.8. Reverse Proxy + npm_letsencrypt: # 2.8. SSL Certs + es_data: # 6.2. Elasticsearch + n8n_data: # 2.7. n8n + gitea_data: # 2.2. Gitea + +# ========================================================== +# Services (บริการทั้งหมดของระบบ) +# ========================================================== +services: + # -------------------------------------------------------- + # Service 1: Reverse Proxy (Nginx Proxy Manager) + # -------------------------------------------------------- + npm: + image: 'jc21/nginx-proxy-manager:latest' + container_name: npm + restart: unless-stopped + ports: + - '80:80' # HTTP + - '443:443' # HTTPS + - '81:81' # Admin UI + volumes: + - npm_data:/data + - npm_letsencrypt:/etc/letsencrypt + networks: + - lcbp3 + + # -------------------------------------------------------- + # Service 2: Database (MariaDB) + # -------------------------------------------------------- + mariadb: + image: mariadb:10.11 + container_name: mariadb + restart: unless-stopped + ports: + - "3306:3306" + volumes: + - db_data:/var/lib/mysql + environment: + - MYSQL_ROOT_PASSWORD=YOUR_STRONG_ROOT_PASSWORD + - MYSQL_DATABASE=lcbp3 + - MYSQL_USER=center + - MYSQL_PASSWORD=Center#2025 + - TZ=Asia/Bangkok + networks: + - lcbp3 + + # -------------------------------------------------------- + # Service 3: Database UI (phpMyAdmin) + # -------------------------------------------------------- + pma: + image: phpmyadmin:5-apache + container_name: pma + restart: unless-stopped + ports: + - "8080:80" + environment: + - PMA_HOST=mariadb + - PMA_PORT=3306 + - UPLOAD_LIMIT=256M + networks: + - lcbp3 + depends_on: + - mariadb + + # -------------------------------------------------------- + # Service 4: Backend (NestJS) + # (ปรับแก้จากไฟล์ ของคุณ) + # -------------------------------------------------------- + backend: + build: + context: /share/Container/lcbp3/backend + container_name: backend + restart: unless-stopped + stdin_open: true + tty: true + command: npm run start:dev + networks: + - lcbp3 + ports: + - "3000:3000" + environment: + # --- Database Connection (จากไฟล์เดิม) --- + - DB_HOST=mariadb + - DB_PORT=3306 + - DB_USER=center + - DB_PASSWORD=Center#2025 + - DB_NAME=lcbp3 + - PORT=3000 + # --- Security (จากไฟล์เดิม) --- + - JWT_SECRET=9a6d8705a6695ab9bae4ca1cd46c72a6379aa72404b96e2c5b59af881bb55c639dd583afdce5a885c68e188da55ce6dbc1fb4aa9cd4055ceb51507e56204e4ca + - JWT_EXPIRES_IN=1d + # --- (เพิ่มใหม่) Environment Variables ที่ Service ต้องการ --- + - STORAGE_PATH=/app/storage # (Path ภายใน Container ที่เชื่อมกับ /share/dms-data) + - ELASTICSEARCH_NODE=http://elasticsearch:9200 + - N8N_WEBHOOK_URL=http://n8n:5678/webhook/lcbp3-notify + volumes: + - /share/Container/lcbp3/backend:/app + - /share/dms-data:/app/storage # (เชื่อม Path จริงบน QNAP เข้ากับ Container) + - /share/Container/dms/logs/backend:/app/logs:rw + - backend_node_modules:/app/node_modules + depends_on: + - mariadb + + # -------------------------------------------------------- + # Service 5: Frontend (Next.js) + # -------------------------------------------------------- + frontend: + build: + context: /share/Container/lcbp3/frontend + container_name: frontend + restart: unless-stopped + command: npm run dev + ports: + - "3001:3000" # (ใช้ Host Port 3001) + networks: + - lcbp3 + volumes: + - /share/Container/lcbp3/frontend:/app + - /share/Container/lcbp3/frontend/node_modules:/app/node_modules + environment: + # (Frontend ต้องเรียก API ผ่าน Domain ที่ NPM จัดการ) + - NEXT_PUBLIC_API_URL=https://backend.np-dms.work + depends_on: + - backend + + # -------------------------------------------------------- + # Service 6: Search (Elasticsearch) + # -------------------------------------------------------- + elasticsearch: + image: elasticsearch:8.11.0 # (แนะนำให้ระบุเวอร์ชัน) + container_name: elasticsearch + restart: unless-stopped + ports: + - "9200:9200" + volumes: + - es_data:/usr/share/elasticsearch/data + environment: + - discovery.type=single-node + - xpack.security.enabled=false # (ปิดการยืนยันตัวตนสำหรับ Dev) + - ES_JAVA_OPTS=-Xms512m -Xmx512m # (จำกัด RAM) + networks: + - lcbp3 + + # -------------------------------------------------------- + # Service 7: Workflow (n8n) + # -------------------------------------------------------- + n8n: + image: n8nio/n8n:latest + container_name: n8n + restart: unless-stopped + ports: + - "5678:5678" + volumes: + - n8n_data:/home/node/.n8n + environment: + - TZ=Asia/Bangkok + networks: + - lcbp3 + + # -------------------------------------------------------- + # Service 8: Code Hosting (Gitea) + # -------------------------------------------------------- + gitea: + image: gitea/gitea:latest + container_name: gitea + restart: unless-stopped + ports: + - "3002:3000" # (ใช้ Host Port 3002) + - "2222:22" # (ใช้ Host Port 2222 สำหรับ SSH) + volumes: + - gitea_data:/data + networks: + - lcbp3 + depends_on: + - mariadb + +# ========================================================== +# Networks (เครือข่ายกลาง) +# ========================================================== +networks: + lcbp3: + external: true \ No newline at end of file diff --git a/docs/Entity.xlsx b/docs/Entity.xlsx new file mode 100644 index 0000000..d1a8aae Binary files /dev/null and b/docs/Entity.xlsx differ diff --git a/docs/LCBP3-DMS_V1_4_0_Backend_Development_Plan.md b/docs/LCBP3-DMS_V1_4_0_Backend_Development_Plan.md new file mode 100644 index 0000000..eb3a275 --- /dev/null +++ b/docs/LCBP3-DMS_V1_4_0_Backend_Development_Plan.md @@ -0,0 +1,655 @@ +# 📋 แผนการพัฒนา Backend (NestJS) - LCBP3-DMS v1.4.0 + +## 🎯 ภาพรวมโครงการ + +พัฒนา Backend สำหรับระบบบริหารจัดการเอกสารโครงการ (Document Management System) ที่รองรับการจัดการเอกสารที่ซับซ้อน มีระบบ Workflow การอนุมัติ และการควบคุมสิทธิ์แบบ RBAC 3 ระดับ + +--- + +## 📐 สถาปัตยกรรมระบบ + +### Technology Stack + +- **Framework:** NestJS (TypeScript, ESM) +- **Database:** MariaDB 10.11 +- **ORM:** TypeORM +- **Authentication:** JWT + Passport +- **Authorization:** CASL (RBAC) +- **File Upload:** Multer +- **Search:** Elasticsearch +- **Notification:** Nodemailer + n8n (Line Integration) +- **Scheduling:** @nestjs/schedule (Cron Jobs) +- **Documentation:** Swagger + +### โครงสร้างโมดูล (Domain-Driven) + +```tree +src/ +├── common/ # Shared Module +│ ├── auth/ # JWT, Guards +│ ├── config/ # Configuration +│ ├── decorators/ # @RequirePermission +│ ├── entities/ # Base Entities +│ ├── exceptions/ # Global Filters +│ ├── file-storage/ # FileStorageService +│ ├── guards/ # RBAC Guard +│ ├── interceptors/ # Audit, Transform +│ └── services/ # Notification, etc. +├── modules/ +│ ├── user/ # Users, Roles, Permissions +│ ├── project/ # Projects, Contracts, Organizations +│ ├── master/ # Master Data +│ ├── correspondence/ # Correspondence Management +│ ├── rfa/ # RFA & Workflows +│ ├── drawing/ # Shop/Contract Drawings +│ ├── circulation/ # Internal Circulation +│ ├── transmittal/ # Transmittals +│ ├── search/ # Elasticsearch +│ └── document-numbering/ # Internal Service +└── database/ # Migrations & Seeds +``` + +--- + +## 🗓️ แผนการพัฒนาแบบ Phase-Based + +## **Phase 0: Infrastructure Setup (สัปดาห์ที่ 1)** + +Milestone: สร้างโครงสร้างพื้นฐานและเชื่อมต่อ Services + +### Phase 0: Tasks + +- **[✅]T0.1 Setup QNAP Container Station** + + - สร้าง Docker Network: `lcbp3` + - Setup docker-compose.yml สำหรับ: + - MariaDB (db.np-dms.work) + - PHPMyAdmin (pma.np-dms.work) + - Backend (backend.np-dms.work) + - Nginx Proxy Manager (npm.np-dms.work) + - กำหนด Environment Variables ใน docker-compose.yml (ไม่ใช้ .env) + - Deliverable: Services ทั้งหมดรันได้และเชื่อมต่อกันผ่าน Network + +- **[✅]T0.2 Initialize NestJS Project** + + - สร้างโปรเจกต์ใหม่ด้วย Nest CLI + - ติดตั้ง Dependencies: + + ```bash + npm install @nestjs/typeorm typeorm mysql2 + npm install @nestjs/config + npm install class-validator class-transformer + npm install @nestjs/jwt @nestjs/passport passport passport-jwt + npm install casl + npm install @nestjs/platform-express multer + npm install @nestjs/swagger + npm install helmet rate-limiter-flexible + npm install bcrypt + npm install --save-dev @nestjs/testing jest @types/jest @types/passport-jwt @types/multer supertest + npm install @nestjs/cache-manager cache-manager + npm install @nestjs/schedule + npm install @nestjs/config + npm install @nestjs/elasticsearch @elastic/elasticsearch + npm install nodemailer @types/nodemailer + npm install uuid @types/uuid + ``` + +```` + + - Setup โครงสร้างโฟลเดอร์ตาม Domain-Driven Architecture + - Deliverable: Project Structure พร้อม, แสดง Swagger ที่ `/api` + +- **[✅]T0.3 Setup Database Connection** + + - Import SQL Schema v1.4.0 เข้า MariaDB + - Run Seed Data (organizations, users, roles, permissions) + - Configure TypeORM ใน AppModule + - ทดสอบ Connection + - Deliverable: Database พร้อมใช้งาน, มี Seed Data + +- **[✅]T0.4 Setup Git Repository** + - สร้าง Repository ใน Gitea (git.np-dms.work) + - Setup .gitignore, README.md + - Commit Initial Project + - Deliverable: Code อยู่ใน Version Control + +--- + +## **Phase 1: Core Foundation (สัปดาห์ที่ 2-3)** + +Milestone: ระบบ Authentication, Authorization และ Base Entities + +### Phase 1: Tasks + +- **[ ] T1.1 CommonModule - Base Infrastructure** + - [ ] สร้าง Base Entity (id, created_at, updated_at, deleted_at) + - [ ] สร้าง Global Exception Filter + - [ ] สร้าง Response Transform Interceptor + - [ ] สร้าง Audit Log Interceptor + - [ ] สร้าง RequestContextService - สำหรับเก็บข้อมูลระหว่าง Request + - [ ] สร้าง ConfigService - Centralized configuration management + - [ ] สร้าง CryptoService - สำหรับ encryption/decryption + - [ ] Deliverable: Common Services พร้อมใช้ + +- **[ ] T1.2 AuthModule - JWT Authentication** + - [ ] สร้าง Entity: User + - [ ] สร้าง AuthService: + - [ ] `login(username, password)` → JWT Token + - [ ] `validateUser(username, password)` → User | null + - [ ] Password Hashing (bcrypt) + - [ ] สร้าง JWT Strategy (Passport) + - [ ] สร้าง JwtAuthGuard + - [ ] สร้าง Controllers: + - [ ] `POST /auth/login` → { access_token } + - [ ] `POST /auth/register` (Admin only) + - [ ] `GET /auth/profile` (Protected) + - [ ] Deliverable: ล็อกอิน/ล็อกเอาต์ทำงานได้ + +- **[ ] T1.3 UserModule - User Management** + - [ ] สร้าง Entities: User, Role, Permission, UserRole + - [ ] สร้าง UserService CRUD + - [ ] สร้าง RoleService CRUD + - [ ] สร้าง PermissionService (Read-Only, จาก Seed) + - [ ] สร้าง Controllers: + - [ ] `GET /users` → List Users (Paginated) + - [ ] `GET /users/:id` → User Detail + - [ ] `POST /users` → Create User + - [ ] `PUT /users/:id` → Update User + - [ ] `DELETE /users/:id` → Soft Delete + - [ ] `GET /roles` → List Roles + - [ ] `POST /roles` → Create Role (Admin) + - [ ] `PUT /roles/:id/permissions` → Assign Permissions + - [ ] Deliverable: จัดการผู้ใช้และ Role ได้ + +- **[ ] T1.4 RBAC Guard - Authorization** + - [ ] สร้าง `@RequirePermission()` Decorator + - [ ] สร้าง RbacGuard ที่ตรวจสอบ: + - [ ] Global Permissions + - [ ] Organization Permissions + - [ ] Project Permissions + - [ ] Contract Permissions + - [ ] Permission Hierarchy Logic + +```bash + // Current: 3-level hierarchy + // Recommended: 4-level hierarchy (Global → Organization → Project → Contract) + @Injectable() + export class RbacGuard implements CanActivate { + async canActivate(context: ExecutionContext): Promise { + const requiredPermission = this.getRequiredPermission(context); + const user = this.getUser(context); + + // Check permissions in order: Global → Org → Project → Contract + return await this.checkGlobalPermissions(user, requiredPermission) || + await this.checkOrgPermissions(user, requiredPermission) || + await this.checkProjectPermissions(user, requiredPermission) || + await this.checkContractPermissions(user, requiredPermission); + } + } + +```` + +- [ ] Integration กับ CASL +- [ ] Deliverable: ระบบสิทธิ์ทำงานได้ทั้ง 4 ระดับ + +- **T1.5 ProjectModule - Base Structures** + - [ ] สร้าง Entities: + - [ ] Organization + - [ ] Project + - [ ] Contract + - [ ] ProjectOrganization (Junction) + - [ ] ContractOrganization (Junction) + - [ ] UserAssignment Entity - สำหรับจัดการ user assignments ตาม scope + - [ ] สร้าง Services & Controllers: + - [ ] `GET /organizations` → List + - [ ] `POST /projects` → Create (Superadmin) + - [ ] `GET /projects/:id/contracts` → List Contracts + - [ ] `POST /projects/:id/contracts` → Create Contract + - [ ] UserAssignment - สำหรับจัดการ user assignments ตาม scope + - [ ] ProjectOrganization - สำหรับจัดการความสัมพันธ์ project-organization + - [ ] ContractOrganization - สำหรับจัดการความสัมพันธ์ contract-organization + - [ ] Deliverable: จัดการโครงสร้างโปรเจกต์ได้ + +--- + +## **Phase 2: Master Data & File Management (สัปดาห์ที่ 4)** + +Milestone: Master Data และระบบจัดการไฟล์ + +### Phase 2: Tasks + +- **[ ] T2.1 MasterModule - Master Data Management** + + - [ ] สร้าง Entities: + - [ ] CorrespondenceType + - [ ] CorrespondenceStatus + - [ ] RfaType + - [ ] RfaStatusCode + - [ ] RfaApproveCode + - [ ] CirculationStatusCode + - [ ] Tag + - [ ] สร้าง Services & Controllers (CRUD): + - [ ] `GET /master/correspondence-types` + - [ ] `POST /master/tags` → Create Tag + - [ ] `GET /master/tags` → List Tags (Autocomplete) + - [ ] Deliverable: Admin จัดการ Master Data ได้ + +- **[ ] T2.2 FileStorageService - Central File Management** + + - [ ] สร้าง Attachment Entity + - [ ] สร้าง FileStorageService: (การจัดเก็บไฟล์ในรูปแบบ centralized storage, ครอบคลุมการจัดการไฟล์แนบทั้งหมด, Security Measures) + - [ ] `uploadFile(file: Express.Multer.File)` → Attachment + - [ ] `getFilePath(attachmentId)` → string + - [ ] `deleteFile(attachmentId)` → boolean + - [ ] จัดเก็บไฟล์ใน `/share/dms-data/uploads/{YYYY}/{MM}/` + - [ ] สร้าง Controller: + - [ ] `POST /files/upload` → { attachment_id, url } + - [ ] `GET /files/:id/download` → File Stream (Protected) + - [ ] Access Control: ตรวจสอบสิทธิ์ผ่าน Junction Table + - [ ] Deliverable: อัปโหลด/ดาวน์โหลดไฟล์ได้อย่างปลอดภัย + +- **[ ] T2.3 DocumentNumberingModule - Internal Service** + - [ ] สร้าง Entities: + - [ ] DocumentNumberFormat + - [ ] DocumentNumberCounter + - [ ] สร้าง DocumentNumberingService: รวม Stored Procedure (sp_get_next_document_number), Error Handling และ Retry Logic + - [ ] `generateNextNumber(projectId, orgId, typeId, year)` → string + - [ ] เรียก Stored Procedure: `sp_get_next_document_number` + - [ ] Format ตาม Template: `{ORG_CODE}-{TYPE_CODE}-{YEAR_SHORT}-{SEQ:4}` + - **ไม่มี Controller** (Internal Service เท่านั้น) + - [ ] Deliverable: Service สร้างเลขที่เอกสารได้ถูกต้อง + +--- + +## **Phase 3: Correspondence & RFA Core (สัปดาห์ที่ 5-6)** + +Milestone: ระบบเอกสารโต้ตอบและ RFA + +### Phase 3: Tasks + +- **[ ] T3.1 CorrespondenceModule - Basic CRUD** + + - [ ] สร้าง Entities: + - [ ] Correspondence + - [ ] CorrespondenceRevision + - [ ] CorrespondenceRecipient + - [ ] CorrespondenceTag + - [ ] CorrespondenceReference + - [ ] CorrespondenceAttachment + - [ ] สร้าง CorrespondenceService: Complex Business Rules, State Machine สำหรับ Status Transitions + - [ ] `create(dto)` → Correspondence + - [ ] สร้าง Correspondence + Revision แรก (rev 0) + - [ ] เรียก DocumentNumberingService + - [ ] สร้าง Recipients (TO/CC) + - [ ] สร้าง Tags + - [ ] สร้าง Attachments + - [ ] `update(id, dto)` → Correspondence + - [ ] สร้าง Revision ใหม่ + - [ ] Update `is_current` flag + - [ ] `findAll(filters)` → Paginated List + - [ ] `findById(id)` → Correspondence with Current Revision + - [ ] สร้าง Controllers: + - [ ] `POST /correspondences` → Create + - [ ] `GET /correspondences` → List (Filter by type, status, org) + - [ ] `GET /correspondences/:id` → Detail + - [ ] `PUT /correspondences/:id` → Update (Create new revision) + - [ ] `DELETE /correspondences/:id` → Soft Delete (Admin only) + - [ ] Deliverable: สร้าง/แก้ไข/ดูเอกสารได้ + +- **[ ] T3.2 CorrespondenceModule - Advanced Features** + + - [ ] Implement Status Transitions: + - [ ] `DRAFT` → `SUBMITTED` (Document Control) + - [ ] `SUBMITTED` → `CLOSED` (Admin) + - [ ] `SUBMITTED` → `CANCELLED` (Admin + Reason) + - [ ] Implement References: + - [ ] `POST /correspondences/:id/references` → Link Documents + - [ ] Implement Search (Basic): + - `GET /correspondences/search?q=...` + - [ ] Deliverable: Workflow พื้นฐานทำงานได้ + +- **[ ] T3.3 RfaModule - Basic CRUD** + - [ ] สร้าง Entities: + - [ ] Rfa + - [ ] RfaRevision + - [ ] RfaItem (Junction to Shop Drawings) + - [ ] สร้าง RfaService: Complex Business Rules + - [ ] `create(dto)` → Rfa + - [ ] สร้าง Correspondence + Rfa + RfaRevision + - [ ] เชื่อม Shop Drawing Revisions (สำหรับ RFA_DWG) + - [ ] `findAll(filters)` → Paginated List + - [ ] `findById(id)` → Rfa with Items + - [ ] สร้าง Controllers: + - [ ] `POST /rfas` → Create + - [ ] `GET /rfas` → List + - [ ] `GET /rfas/:id` → Detail + - [ ] Deliverable: สร้าง RFA และเชื่อม Shop Drawings ได้ + +--- + +## **Phase 4: Drawing Management (สัปดาห์ที่ 7)** + +Milestone: ระบบจัดการแบบ + +### Phase 4: Tasks + +- **[ ] T4.1 DrawingModule - Contract Drawings** + + - [ ] สร้าง Entities: + - [ ] ContractDrawing + - [ ] ContractDrawingVolume + - [ ] ContractDrawingCat + - [ ] ContractDrawingSubCat + - [ ] ContractDrawingSubcatCatMap + - [ ] ContractDrawingAttachment + - [ ] สร้าง ContractDrawingService CRUD + - [ ] สร้าง Controllers: + - [ ] `GET /drawings/contract` → List + - [ ] `POST /drawings/contract` → Create (Admin) + - [ ] `GET /drawings/contract/:id` → Detail + - [ ] Deliverable: จัดการ Contract Drawings ได้ + +- **[ ] T4.2 DrawingModule - Shop Drawings** + - [ ] สร้าง Entities: + - [ ] ShopDrawing + - [ ] ShopDrawingRevision + - [ ] ShopDrawingMainCategory + - [ ] ShopDrawingSubCategory + - [ ] ShopDrawingRevisionContractRef + - [ ] ShopDrawingRevisionAttachment + - [ ] สร้าง ShopDrawingService CRUD + - [ ] สร้าง Controllers: + - [ ] `GET /drawings/shop` → List + - [ ] `POST /drawings/shop` → Create + - [ ] `POST /drawings/shop/:id/revisions` → Create Revision + - [ ] `GET /drawings/shop/:id` → Detail with Revisions + - [ ] Link Shop Drawing Revision → Contract Drawings + - [ ] Deliverable: จัดการ Shop Drawings และ Revisions ได้ + +--- + +## **Phase 5: Workflow Systems (สัปดาห์ที่ 8-9)** + +Milestone: ระบบ Workflow ทั้งหมด + +### Phase 5: Tasks + +- **[ ] T5.1 RfaModule - Workflow Implementation** + + - [ ] สร้าง Entities: + - [ ] RfaWorkflowTemplate + - [ ] RfaWorkflowTemplateStep + - [ ] RfaWorkflow (Transaction Log) + - [ ] สร้าง RfaWorkflowService: Advanced Workflow Features + - [ ] `initiateWorkflow(rfaId, templateId)` → void + - [ ] สร้าง RfaWorkflow records ตาม Template + - [ ] กำหนด Step 1 เป็น PENDING + - [ ] `completeStep(rfaId, stepNumber, action, comments)` → void + - [ ] Update Status → COMPLETED + - [ ] Set Next Step → PENDING + - [ ] Send Notifications + - [ ] `rejectStep(rfaId, stepNumber, reason)` → void + - [ ] Update Status → REJECTED + - [ ] Send back to Originator + - [ ] สร้าง Controllers: + - [ ] `POST /rfas/:id/workflow/start` → Start Workflow + - [ ] `POST /rfas/:id/workflow/steps/:stepNumber/complete` → Complete Step + - [ ] `GET /rfas/:id/workflow` → Get Workflow Status + - [ ] Deliverable: RFA Workflow ทำงานได้ + +- **[ ] T5.2 CirculationModule - Internal Routing** + + - [ ] สร้าง Entities: + - [ ] Circulation + - [ ] CirculationTemplate + - [ ] CirculationTemplateAssignee + - [ ] CirculationRouting (Transaction Log) + - [ ] CirculationAttachment + - [ ] สร้าง CirculationService: + - [ ] `create(correspondenceId, dto)` → Circulation + - [ ] สร้าง Circulation (1:1 กับ Correspondence) + - [ ] สร้าง Routing ตาม Template + - [ ] `assignUser(circulationId, stepNumber, userId)` → void + - [ ] `completeStep(circulationId, stepNumber, comments)` → void + - [ ] `close(circulationId)` → void (เมื่อตอบกลับองค์กรผู้ส่งแล้ว) + - สร้าง Controllers: + - [ ] `POST /circulations` → Create + - [ ] `GET /circulations/:id` → Detail + - [ ] `POST /circulations/:id/steps/:stepNumber/complete` → Complete + - [ ] `POST /circulations/:id/close` → Close + - [ ] Deliverable: ใบเวียนภายในองค์กรทำงานได้ + +- **[ ] T5.3 TransmittalModule - Document Forwarding** + - [ ] สร้าง Entities: + - [ ] Transmittal + - [ ] TransmittalItem + - [ ] สร้าง TransmittalService: + - [ ] `create(dto)` → Transmittal + - [ ] สร้าง Correspondence + Transmittal + - [ ] เชื่อม Multiple Correspondences เป็น Items + - [ ] สร้าง Controllers: + - [ ] `POST /transmittals` → Create + - [ ] `GET /transmittals` → List + - [ ] `GET /transmittals/:id` → Detail with Items + - [ ] Deliverable: สร้าง Transmittal ได้ + +--- + +## **Phase 6: Advanced Features (สัปดาห์ที่ 10-11)** + +Milestone: ฟีเจอร์ขั้นสูง + +### Phase 6: Tasks + +- **[ ] T6.1 SearchModule - Elasticsearch Integration** + + - [ ] Setup Elasticsearch Container ใน docker-compose.yml + - [ ] สร้าง SearchService: + - [ ] `indexDocument(entity)` → void + - [ ] `updateDocument(entity)` → void + - [ ] `deleteDocument(entity)` → void + - [ ] `search(query, filters)` → SearchResult[] + - [ ] Index ทุกครั้งที่ Create/Update: + - [ ] Correspondence + - [ ] RFA + - [ ] Shop Drawing + - [ ] Contract Drawing + - [ ] Circulation + - [ ] Transmittal + - [ ] สร้าง Controllers: + - [ ] `GET /search?q=...&type=...&from=...&to=...` → Results + - [ ] Deliverable: ค้นหาขั้นสูงทำงานได้ + +- **[ ] T6.2 NotificationModule - Email & Line** + + - [ ] สร้าง NotificationService: + - [ ] `sendEmail(to, subject, body)` → void (Nodemailer) + - [ ] `sendLine(userId, message)` → void (ผ่าน n8n Webhook) + - [ ] `createSystemNotification(userId, message, entityType, entityId)` → void + - [ ] Integrate กับ Workflow Events: + - [ ] เมื่อสร้าง Correspondence ใหม่ → แจ้ง Recipients + - [ ] เมื่อสร้าง Circulation → แจ้ง Assignees + - [ ] เมื่อ RFA Workflow ถึง Step → แจ้ง Responsible Org + - [ ] เมื่อใกล้ถึง Deadline → แจ้ง (Optional) + - [ ] สร้าง Controllers: + - [ ] `GET /notifications` → List User's Notifications + - [ ] `PUT /notifications/:id/read` → Mark as Read + - [ ] Deliverable: ระบบแจ้งเตือนทำงานได้ + +- **[ ] T6.3 Reporting & Analytics** + + - [ ] สร้าง ReportService: + - [ ] `getCorrespondenceSummary(projectId, from, to)` → Report + - [ ] `getRfaSummary(projectId, from, to)` → Report + - [ ] `getActivityLog(userId, from, to)` → Report + - [ ] ใช้ Views จาก Database: + - [ ] `v_current_correspondences` + - [ ] `v_current_rfas` + - [ ] `v_user_tasks` + - [ ] `v_audit_log_details` + - [ ] สร้าง Controllers: + - [ ] `GET /reports/correspondence` → Summary (CSV, PDF) + - [ ] `GET /reports/rfa` → Summary + - [ ] `GET /reports/activity` → User Activity + - [ ] Deliverable: สร้างรายงานได้ + +- **T6.4 Audit Log & Activity Feed** + - [ ] AuditLogInterceptor ทำงานอัตโนมัติแล้ว (Phase 1) + - [ ] สร้าง AuditLogService: + - [ ] `log(userId, action, entityType, entityId, details)` → void + - [ ] `getUserActivity(userId, limit)` → AuditLog[] + - [ ] สร้าง Controllers: + - [ ] `GET /audit-logs` → List (Admin only) + - [ ] `GET /audit-logs/user/:userId` → User's Activity + - [ ] Deliverable: ดู Audit Log ได้ + +--- + +## **Phase 7: Testing & Optimization (สัปดาห์ที่ 12-13)** + +Milestone: ทดสอบและปรับปรุงประสิทธิภาพ + +### Phase 7: Tasks + +- **[ ] T7.1 Unit Testing** + + - [ ] เขียน Unit Tests สำหรับ Services สำคัญ: + - [ ] AuthService (login, validateUser) + - [ ] RbacGuard (permission checks) + - [ ] DocumentNumberingService (number generation) + - [ ] CorrespondenceService (create, update) + - [ ] RfaWorkflowService (workflow logic) + - [ ] Target: 70% Code Coverage + - [ ] Deliverable: Unit Tests ผ่านทั้งหมด + +- **[ ] T7.2 Integration Testing** + + - [ ] เขียน Integration Tests: + - [ ] Authentication Flow (login → access protected route) + - [ ] Document Creation Flow (create correspondence → attach files) + - [ ] RFA Workflow Flow (start → step 1 → step 2 → complete) + - [ ] Circulation Flow (create → assign → complete → close) + - [ ] ทดสอบ SQL Views (v_user_all_permissions, v_user_tasks) + - [ ] ใช้ Test Database แยกต่างหาก + - [ ] Deliverable: Integration Tests ผ่าน + +- **[ ] T7.3 E2E Testing** + + - [ ] เขียน E2E Tests: + - [ ] User Registration & Login + - [ ] Create Correspondence (Full Flow) + - [ ] Create RFA with Shop Drawings + - [ ] Complete RFA Workflow + - [ ] Search Documents + - [ ] Deliverable: E2E Tests ผ่าน + +- **[ ] T7.4 Performance Optimization** + + - [ ] Implement Caching: + - [ ] Cache Master Data (Roles, Permissions) + - [ ] Cache User Permissions (ใช้ @nestjs/cache-manager) + - [ ] Database Optimization: + - [ ] Review Indexes + - [ ] Optimize Queries (N+1 Problem) + - I[ ] mplement Pagination ทุก List Endpoint + - [ ] Deliverable: Response Time < 200ms (90th percentile) + +- **[ ] T7.5 Security Hardening** + - [ ] Implement Rate Limiting (ใช้ rate-limiter-flexible) + - [ ] Setup Helmet (Security Headers) + - [ ] Review CORS Configuration + - [ ] Input Validation (ตรวจสอบ DTOs ทั้งหมด) + - [ ] Deliverable: Security Checklist ผ่าน + +--- + +## **Phase 8: Documentation & Deployment (สัปดาห์ที่ 14)** + +Milestone: เอกสารและ Deploy สู่ Production + +### Phase 8: Tasks + +- **[ ] T8.1 API Documentation** + + - [ ] ครบทุก Endpoint ใน Swagger: + - [ ] ใส่ Description, Example Request/Response + - [ ] ระบุ Required Permissions + - [ ] ใส่ Error Responses + - [ ] Export Swagger JSON → Frontend Team + - [ ] Deliverable: Swagger Docs สมบูรณ์ + +- **[ ] T8.2 Technical Documentation** + + - [ ] เขียนเอกสาร: + - [ ] Architecture Overview + - [ ] Module Structure + - [ ] Database Schema Diagram + - [ ] API Design Patterns + - [ ] Deployment Guide + - [ ] Deliverable: Technical Docs พร้อม + +- **[ ] T8.3 Deployment Preparation** + + - [ ] สร้าง Production docker-compose.yml + - [ ] Setup Environment Variables ใน QNAP + - [ ] Setup Nginx Proxy Manager (SSL Certificate) + - [ ] Setup Backup Scripts (Database + Files) + - [ ] Deliverable: Deployment Guide พร้อม + +- **[ ] T8.4 Production Deployment** + + - [ ] Deploy Backend ไปยัง backend.np-dms.work + - [ ] ทดสอบ API ผ่าน Postman + - [ ] Monitor Logs (Winston) + - [ ] Setup Health Check Endpoint (`GET /health`) + - [ ] Deliverable: Backend รันบน Production + +- **T8.5 Handover to Frontend Team** + - [ ] Demo API ให้ Frontend Team + - [ ] ส่งมอบ Swagger Documentation + - [ ] ส่งมอบ Postman Collection + - [ ] Workshop: วิธีใช้ Authentication & RBAC + - [ ] Deliverable: Frontend เริ่มพัฒนาได้ + +--- + +## 📊 สรุป Timeline + +| Phase | ระยะเวลา | จำนวนงาน | Output หลัก | +| ------- | -------------- | ------------ | ---------------------------- | +| Phase 0 | 1 สัปดาห์ | 4 | Infrastructure Ready | +| Phase 1 | 2 สัปดาห์ | 5 | Auth & User Management | +| Phase 2 | 1 สัปดาห์ | 3 | Master Data & File Storage | +| Phase 3 | 2 สัปดาห์ | 3 | Correspondence & RFA Core | +| Phase 4 | 1 สัปดาห์ | 2 | Drawing Management | +| Phase 5 | 2 สัปดาห์ | 3 | Workflow Systems | +| Phase 6 | 2 สัปดาห์ | 4 | Advanced Features | +| Phase 7 | 2 สัปดาห์ | 5 | Testing & Optimization | +| Phase 8 | 1 สัปดาห์ | 5 | Documentation & Deploy | +| **รวม** | **14 สัปดาห์** | **34 Tasks** | **Production-Ready Backend** | + +--- + +## 🎯 Critical Success Factors + +1. **Database First**: ใช้ Schema v1.4.0 เป็นหลัก ไม่แก้ไข Schema โดยไม่จำเป็น +2. **Emphasizing Soft Delete**: Service ทั้งหมดที่ทำการ Query ข้อมูล (เช่น findAll, findById) ต้อง ใช้ Global Filter หรือ Default Scope ของ TypeORM เพื่อกรอง WHERE deleted_at IS NULL เสมอ +3. **API Contract**: ทุก Endpoint ต้องมี Swagger Documentation สมบูรณ์ +4. **Security**: RBAC ต้องทำงานถูกต้อง 100% ก่อน Deploy +5. **Testing**: Code Coverage อย่างน้อย 70% ก่อน Production +6. **Performance**: Response Time < 200ms (90th percentile) +7. **Documentation**: เอกสารต้องครบถ้วนเพื่อ Handover ให้ Frontend Team + +--- + +## 🚀 ขั้นตอนถัดไป + +1. **Approve แผนนี้** → ปรับแต่งตาม Feedback +2. **Setup Phase 0** → เริ่มสร้าง Infrastructure +3. **Daily Standup** → รายงานความก้าวหน้าทุกวัน +4. **Weekly Review** → ทบทวนความก้าวหน้าทุกสัปดาห์ +5. **Deploy to Production** → Week 14 + +--- + +**หมายเหตุ:** แผนนี้สามารถปรับแต่งได้ตามความต้องการและข้อจำกัดของทีม หาก Phase ใดใช้เวลามากกว่าที่คาดการณ์ ควรปรับ Timeline ให้เหมาะสม diff --git a/docs/LCBP3-DMS_V1_4_0_Data_Dictionary.md b/docs/LCBP3-DMS_V1_4_0_Data_Dictionary.md new file mode 100644 index 0000000..2395191 --- /dev/null +++ b/docs/LCBP3-DMS_V1_4_0_Data_Dictionary.md @@ -0,0 +1,2835 @@ +# **ตารางฐานข้อมูล (Data Dictionary) - LCBP3-DMS (V1.4.0)** + +เอกสารนี้สรุปโครงสร้างตาราง, Foreign Keys (FK), และ Constraints ที่สำคัญทั้งหมดในฐานข้อมูล LCBP3-DMS (v1.4.0) เพื่อใช้เป็นเอกสารอ้างอิงสำหรับทีมพัฒนา Backend (NestJS) และ Frontend (Next.js) โดยอิงจาก Requirements และ SQL Script ล่าสุด [GLM-4.6] + +--- + +## **1. 🏢 Core & Master Data Tables (องค์กร, โครงการ, สัญญา)** + +### 1.1 organization_roles + +**Purpose**: Master table for organization role types in the system + +| Column Name | Data Type | Constraints | Description | +| ----------- | ----------- | --------------------------- | ---------------------------------------------------------------- | +| id | INT | PRIMARY KEY, AUTO_INCREMENT | Unique identifier for organization role | +| role_name | VARCHAR(20) | NOT NULL, UNIQUE | Role name (OWNER, DESIGNER, CONSULTANT, CONTRACTOR, THIRD PARTY) | + +**Indexes**: + +- PRIMARY KEY (id) +- UNIQUE (role_name) + +**Business Rules**: + +- Predefined system roles for organization types +- Cannot be deleted if referenced by organizations + +--- + +### 1.2 organizations + +**Purpose**: Master table storing all organizations involved in the system + +| Column Name | Data Type | Constraints | Description | +| ----------------- | ------------ | ----------------------------------- | ---------------------------------------- | +| id | INT | PRIMARY KEY, AUTO_INCREMENT | Unique identifier for organization | +| organization_code | VARCHAR(20) | NOT NULL, UNIQUE | Organization code (e.g., 'กทท.', 'TEAM') | +| organization_name | VARCHAR(255) | NOT NULL | Full organization name | +| is_active | BOOLEAN | DEFAULT TRUE | Active status (1=active, 0=inactive) | +| created_at | TIMESTAMP | DEFAULT CURRENT_TIMESTAMP | Record creation timestamp | +| updated_at | TIMESTAMP | DEFAULT CURRENT_TIMESTAMP ON UPDATE | Last update timestamp | + +**Indexes**: + +- PRIMARY KEY (id) +- UNIQUE (organization_code) +- INDEX (is_active) + +**Relationships**: + +- Referenced by: users, project_organizations, contract_organizations, correspondences, circulations + +**Seed Data**: Pre-populated with 15 organizations including: + +- Port Authority of Thailand (กทท.) +- Project supervision consultants (สค©.3-xx) +- Design consultants (TEAM) +- Construction supervisors (คคง.) +- Contractors (ผรม.1-4) +- Third parties (EN, CAR) + +--- + +### 1.3 projects + +**Purpose**: Master table for all projects in the system + +| Column Name | Data Type | Constraints | Description | +| ------------ | ------------ | --------------------------- | ----------------------------- | +| id | INT | PRIMARY KEY, AUTO_INCREMENT | Unique identifier for project | +| project_code | VARCHAR(50) | NOT NULL, UNIQUE | Project code (e.g., 'LCBP3') | +| project_name | VARCHAR(255) | NOT NULL | Full project name | +| is_active | TINYINT(1) | DEFAULT 1 | Active status | + +**Indexes**: + +- PRIMARY KEY (id) +- UNIQUE (project_code) +- INDEX (is_active) + +**Relationships**: + +- Referenced by: contracts, correspondences, document_number_formats, drawings + +**Seed Data**: 5 projects for Laem Chabang Port Phase 3 (LCBP3) including main project and 4 sub-contracts + +--- + +### 1.4 contracts + +**Purpose**: Master table for contracts within projects + +| Column Name | Data Type | Constraints | Description | +| ------------- | ------------ | ----------------------------------- | ------------------------------ | +| id | INT | PRIMARY KEY, AUTO_INCREMENT | Unique identifier for contract | +| project_id | INT | NOT NULL, FK | Reference to projects table | +| contract_code | VARCHAR(50) | NOT NULL, UNIQUE | Contract code | +| contract_name | VARCHAR(255) | NOT NULL | Full contract name | +| description | TEXT | NULL | Contract description | +| start_date | DATE | NULL | Contract start date | +| end_date | DATE | NULL | Contract end date | +| is_active | BOOLEAN | DEFAULT TRUE | Active status | +| created_at | TIMESTAMP | DEFAULT CURRENT_TIMESTAMP | Record creation timestamp | +| updated_at | TIMESTAMP | DEFAULT CURRENT_TIMESTAMP ON UPDATE | Last update timestamp | + +**Indexes**: + +- PRIMARY KEY (id) +- UNIQUE (contract_code) +- FOREIGN KEY (project_id) REFERENCES projects(id) ON DELETE CASCADE +- INDEX (project_id, is_active) + +**Relationships**: + +- Parent: projects +- Referenced by: contract_organizations, user_assignments + +**Seed Data**: 7 contracts including design, supervision, construction, and environmental monitoring + +--- + +## **2. 👥 Users & RBAC Tables (ผู้ใช้, สิทธิ์, บทบาท)** + +### 2.1 users + +**Purpose**: Master table storing all system users + +| Column Name | Data Type | Constraints | Description | +| ----------------------- | ------------ | ----------------------------------- | -------------------------------- | +| user_id | INT | PRIMARY KEY, AUTO_INCREMENT | Unique identifier for user | +| username | VARCHAR(50) | NOT NULL, UNIQUE | Login username | +| password_hash | VARCHAR(255) | NOT NULL | Hashed password (bcrypt) | +| first_name | VARCHAR(50) | NULL | User's first name | +| last_name | VARCHAR(50) | NULL | User's last name | +| email | VARCHAR(100) | NOT NULL, UNIQUE | Email address | +| line_id | VARCHAR(100) | NULL | LINE messenger ID | +| primary_organization_id | INT | NULL, FK | Primary organization affiliation | +| is_active | TINYINT(1) | DEFAULT 1 | Active status | +| failed_attempts | INT | DEFAULT 0 | Failed login attempts counter | +| locked_until | DATETIME | NULL | Account lock expiration time | +| last_login_at | TIMESTAMP | NULL | Last successful login timestamp | +| created_at | TIMESTAMP | DEFAULT CURRENT_TIMESTAMP | Record creation timestamp | +| updated_at | TIMESTAMP | DEFAULT CURRENT_TIMESTAMP ON UPDATE | Last update timestamp | + +**Indexes**: + +- PRIMARY KEY (user_id) +- UNIQUE (username) +- UNIQUE (email) +- FOREIGN KEY (primary_organization_id) REFERENCES organizations(id) ON DELETE SET NULL +- INDEX (is_active) +- INDEX (email) + +**Relationships**: + +- Parent: organizations (primary_organization_id) +- Referenced by: user_assignments, audit_logs, notifications, circulation_routings + +**Security Features**: + +- Password stored as bcrypt hash +- Account locking after failed attempts +- Last login tracking + +**Seed Data**: 3 initial users (superadmin, editor01, viewer01) + +--- + +### 2.2 roles + +**Purpose**: Master table defining system roles with scope levels + +| Column Name | Data Type | Constraints | Description | +| ----------- | ------------ | --------------------------- | ---------------------------------------------------- | +| role_id | INT | PRIMARY KEY, AUTO_INCREMENT | Unique identifier for role | +| role_name | VARCHAR(100) | NOT NULL | Role name (e.g., 'Superadmin', 'Document Control') | +| scope | ENUM | NOT NULL | Scope level: Global, Organization, Project, Contract | +| description | TEXT | NULL | Role description | +| is_system | BOOLEAN | DEFAULT FALSE | System role flag (cannot be deleted) | + +**Indexes**: + +- PRIMARY KEY (role_id) +- INDEX (scope) + +**Relationships**: + +- Referenced by: role_permissions, user_assignments + +**Seed Data**: 7 predefined roles + +1. Superadmin (Global) - Full system access +2. Org Admin (Organization) - Organization management +3. Document Control (Organization) - Document lifecycle management +4. Editor (Organization) - Document creation and editing +5. Viewer (Organization) - Read-only access +6. Project Manager (Project) - Project-level management +7. Contract Admin (Contract) - Contract-specific administration + +--- + +### 2.3 permissions + +**Purpose**: Master table defining all system permissions + +| Column Name | Data Type | Constraints | Description | +| --------------- | ------------ | --------------------------- | ------------------------------------------------------ | +| permission_id | INT | PRIMARY KEY, AUTO_INCREMENT | Unique identifier for permission | +| permission_name | VARCHAR(100) | NOT NULL, UNIQUE | Permission code (e.g., 'rfas.create', 'document.view') | +| description | TEXT | NULL | Permission description | +| module | VARCHAR(50) | NULL | Related module name | +| scope_level | ENUM | NULL | Scope: GLOBAL, ORG, PROJECT | +| is_active | TINYINT(1) | DEFAULT 1 | Active status | + +**Indexes**: + +- PRIMARY KEY (permission_id) +- UNIQUE (permission_name) +- INDEX (module) +- INDEX (scope_level) +- INDEX (is_active) + +**Relationships**: + +- Referenced by: role_permissions + +**Permission Categories**: + +1. **System Management** (1): system.manage_all +2. **Organization Management** (2-5): create, edit, delete, view +3. **Project Management** (6-9, 23-26): create, edit, delete, view, manage members/contracts/reports +4. **Role & Permission Management** (10-13): create, edit, delete roles, assign permissions +5. **Master Data Management** (14-17): document types, statuses, categories, tags +6. **User Management** (18-22): create, edit, delete, view, assign organization +7. **Contract Management** (27-28): manage members, view +8. **Document Management** (29-44): CRUD operations, workflows, circulation +9. **Search & Reporting** (48-49): advanced search, generate reports + +**Total Permissions**: 49 + +--- + +### 2.4 role_permissions + +**Purpose**: Junction table mapping roles to permissions (M:N) + +| Column Name | Data Type | Constraints | Description | +| ------------- | --------- | --------------- | ------------------------------ | +| role_id | INT | PRIMARY KEY, FK | Reference to roles table | +| permission_id | INT | PRIMARY KEY, FK | Reference to permissions table | + +**Indexes**: + +- PRIMARY KEY (role_id, permission_id) +- FOREIGN KEY (role_id) REFERENCES roles(role_id) ON DELETE CASCADE +- FOREIGN KEY (permission_id) REFERENCES permissions(permission_id) ON DELETE CASCADE +- INDEX (permission_id) + +**Relationships**: + +- Parent: roles, permissions + +**Seed Data**: Complete permission mappings for all 7 roles + +- Superadmin: All 49 permissions +- Org Admin: 15 permissions (user/org/tag management, view access) +- Document Control: 26 permissions (full document lifecycle) +- Editor: 12 permissions (document CRUD without admin powers) +- Viewer: 2 permissions (view and search only) +- Project Manager: 23 permissions (project management + document CRUD) +- Contract Admin: 15 permissions (contract management + document CRUD) + +--- + +### 2.5 user_assignments + +**Purpose**: Junction table assigning users to roles with scope context + +| Column Name | Data Type | Constraints | Description | +| ------------------- | --------- | --------------------------- | ---------------------------------- | +| id | INT | PRIMARY KEY, AUTO_INCREMENT | Unique identifier | +| user_id | INT | NOT NULL, FK | Reference to users table | +| role_id | INT | NOT NULL, FK | Reference to roles table | +| organization_id | INT | NULL, FK | Organization scope (if applicable) | +| project_id | INT | NULL, FK | Project scope (if applicable) | +| contract_id | INT | NULL, FK | Contract scope (if applicable) | +| assigned_by_user_id | INT | NULL, FK | User who made the assignment | +| assigned_at | TIMESTAMP | DEFAULT CURRENT_TIMESTAMP | Assignment timestamp | + +**Indexes**: + +- PRIMARY KEY (id) +- FOREIGN KEY (user_id) REFERENCES users(user_id) ON DELETE CASCADE +- FOREIGN KEY (role_id) REFERENCES roles(role_id) ON DELETE CASCADE +- FOREIGN KEY (organization_id) REFERENCES organizations(id) ON DELETE CASCADE +- FOREIGN KEY (project_id) REFERENCES projects(id) ON DELETE CASCADE +- FOREIGN KEY (contract_id) REFERENCES contracts(id) ON DELETE CASCADE +- FOREIGN KEY (assigned_by_user_id) REFERENCES users(user_id) +- INDEX (user_id, role_id) +- INDEX (organization_id) +- INDEX (project_id) +- INDEX (contract_id) + +**Constraints**: + +- CHECK: Only one scope field (organization_id, project_id, contract_id) can be NOT NULL, or all NULL for Global scope + +**Relationships**: + +- Parent: users, roles, organizations, projects, contracts + +**Business Rules**: + +- User can have multiple role assignments with different scopes +- Scope inheritance: Contract → Project → Organization → Global +- Global scope: all scope fields are NULL + +--- + +### 2.6 project_organizations + +**Purpose**: Junction table linking projects to participating organizations (M:N) + +| Column Name | Data Type | Constraints | Description | +| --------------- | --------- | --------------- | -------------------------------- | +| project_id | INT | PRIMARY KEY, FK | Reference to projects table | +| organization_id | INT | PRIMARY KEY, FK | Reference to organizations table | + +**Indexes**: + +- PRIMARY KEY (project_id, organization_id) +- FOREIGN KEY (project_id) REFERENCES projects(id) ON DELETE CASCADE +- FOREIGN KEY (organization_id) REFERENCES organizations(id) ON DELETE CASCADE +- INDEX (organization_id) + +**Relationships**: + +- Parent: projects, organizations + +**Seed Data**: Pre-populated with project-organization relationships + +--- + +### 2.7 contract_organizations + +**Purpose**: Junction table linking contracts to participating organizations with roles (M:N) + +| Column Name | Data Type | Constraints | Description | +| ---------------- | ------------ | --------------- | ------------------------------------------------------------------------- | +| contract_id | INT | PRIMARY KEY, FK | Reference to contracts table | +| organization_id | INT | PRIMARY KEY, FK | Reference to organizations table | +| role_in_contract | VARCHAR(100) | NULL | Organization's role in contract (Owner, Designer, Consultant, Contractor) | + +**Indexes**: + +- PRIMARY KEY (contract_id, organization_id) +- FOREIGN KEY (contract_id) REFERENCES contracts(id) ON DELETE CASCADE +- FOREIGN KEY (organization_id) REFERENCES organizations(id) ON DELETE CASCADE +- INDEX (organization_id) +- INDEX (role_in_contract) + +**Relationships**: + +- Parent: contracts, organizations + +**Seed Data**: Pre-populated with contract-organization-role relationships + +--- + +## **3. ✉️ Correspondences Tables (เอกสารหลัก, Revisions, Workflows)** + +### 3.1 correspondence_types + +**Purpose**: Master table for correspondence document types + +| Column Name | Data Type | Constraints | Description | +| ----------- | ------------ | --------------------------- | --------------------------------------------- | +| id | INT | PRIMARY KEY, AUTO_INCREMENT | Unique identifier | +| type_code | VARCHAR(50) | NOT NULL, UNIQUE | Type code (e.g., 'RFA', 'RFI', 'TRANSMITTAL') | +| type_name | VARCHAR(255) | NOT NULL | Full type name | +| sort_order | INT | DEFAULT 0 | Display order | +| is_active | TINYINT(1) | DEFAULT 1 | Active status | + +**Indexes**: + +- PRIMARY KEY (id) +- UNIQUE (type_code) +- INDEX (is_active) +- INDEX (sort_order) + +**Relationships**: + +- Referenced by: correspondences, document_number_formats, document_number_counters + +**Seed Data**: 10 correspondence types including RFA, RFI, TRANSMITTAL, EMAIL, INSTRUCTION, LETTER, MEMO, MOM, NOTICE, OTHER + +--- + +### 3.2 correspondence_status + +**Purpose**: Master table for correspondence status codes + +| Column Name | Data Type | Constraints | Description | +| ----------- | ------------ | --------------------------- | ------------------------------------- | +| id | INT | PRIMARY KEY, AUTO_INCREMENT | Unique identifier | +| status_code | VARCHAR(50) | NOT NULL, UNIQUE | Status code (e.g., 'DRAFT', 'SUBOWN') | +| status_name | VARCHAR(255) | NOT NULL | Full status name | +| sort_order | INT | DEFAULT 0 | Display order | +| is_active | TINYINT(1) | DEFAULT 1 | Active status | + +**Indexes**: + +- PRIMARY KEY (id) +- UNIQUE (status_code) +- INDEX (is_active) +- INDEX (sort_order) + +**Relationships**: + +- Referenced by: correspondence_revisions + +**Seed Data**: 23 status codes covering draft, submission, reply, resubmission, closure, and cancellation states by different parties (Owner, Designer, CSC, Contractor) + +--- + +### 3.3 correspondences + +**Purpose**: Master table for correspondence documents (non-revisioned data) + +| Column Name | Data Type | Constraints | Description | +| ------------------------- | ------------ | --------------------------- | ------------------------------------------ | +| id | INT | PRIMARY KEY, AUTO_INCREMENT | Master correspondence ID | +| correspondence_number | VARCHAR(100) | NOT NULL | Document number (from numbering system) | +| correspondence_type_id | INT | NOT NULL, FK | Reference to correspondence_types | +| is_internal_communication | TINYINT(1) | DEFAULT 0 | Internal (1) or external (0) communication | +| project_id | INT | NOT NULL, FK | Reference to projects table | +| originator_id | INT | NULL, FK | Originating organization | +| created_at | DATETIME | DEFAULT CURRENT_TIMESTAMP | Record creation timestamp | +| created_by | INT | NULL, FK | User who created the record | +| deleted_at | DATETIME | NULL | Soft delete timestamp | + +**Indexes**: + +- PRIMARY KEY (id) +- FOREIGN KEY (correspondence_type_id) REFERENCES correspondence_types(id) ON DELETE RESTRICT +- FOREIGN KEY (project_id) REFERENCES projects(id) ON DELETE CASCADE +- FOREIGN KEY (originator_id) REFERENCES organizations(id) ON DELETE SET NULL +- FOREIGN KEY (created_by) REFERENCES users(user_id) ON DELETE SET NULL +- UNIQUE KEY (project_id, correspondence_number) +- INDEX (correspondence_type_id) +- INDEX (originator_id) +- INDEX (deleted_at) + +**Relationships**: + +- Parent: correspondence_types, projects, organizations, users +- Children: correspondence_revisions, correspondence_recipients, correspondence_tags, correspondence_references, correspondence_attachments, circulations, transmittals + +**Business Rules**: + +- One correspondence can have multiple revisions +- Correspondence number must be unique within a project +- Soft delete preserves history + +--- + +### 3.4 correspondence_revisions + +**Purpose**: Child table storing revision history of correspondences (1:N) + +| Column Name | Data Type | Constraints | Description | +| ------------------------ | ------------ | --------------------------- | ------------------------------------------- | +| id | INT | PRIMARY KEY, AUTO_INCREMENT | Unique revision ID | +| correspondence_id | INT | NOT NULL, FK | Master correspondence ID | +| revision_number | INT | NOT NULL | Revision sequence (0, 1, 2...) | +| revision_label | VARCHAR(10) | NULL | Display revision (A, B, 1.1...) | +| is_current | BOOLEAN | DEFAULT FALSE | Current revision flag | +| correspondence_status_id | INT | NOT NULL, FK | Current status of this revision | +| title | VARCHAR(255) | NOT NULL | Document title | +| document_date | DATE | NULL | Document date | +| issued_date | DATETIME | NULL | Issue date | +| received_date | DATETIME | NULL | Received date | +| due_date | DATETIME | NULL | Due date for response | +| description | TEXT | NULL | Revision description | +| details | JSON | NULL | Type-specific details (e.g., RFI questions) | +| created_at | DATETIME | DEFAULT CURRENT_TIMESTAMP | Revision creation timestamp | +| created_by | INT | NULL, FK | User who created revision | +| updated_by | INT | NULL, FK | User who last updated | + +**Indexes**: + +- PRIMARY KEY (id) +- FOREIGN KEY (correspondence_id) REFERENCES correspondences(id) ON DELETE CASCADE +- FOREIGN KEY (correspondence_status_id) REFERENCES correspondence_status(id) ON DELETE RESTRICT +- FOREIGN KEY (created_by) REFERENCES users(user_id) ON DELETE SET NULL +- FOREIGN KEY (updated_by) REFERENCES users(user_id) ON DELETE SET NULL +- UNIQUE KEY (correspondence_id, revision_number) +- UNIQUE KEY (correspondence_id, is_current) - Only one current revision per correspondence +- INDEX (correspondence_status_id) +- INDEX (is_current) +- INDEX (document_date) +- INDEX (issued_date) + +**Relationships**: + +- Parent: correspondences, correspondence_status, users + +**Business Rules**: + +- Only one revision can be marked as current (is_current=TRUE) per correspondence +- Revision numbers are sequential starting from 0 +- JSON details field allows type-specific data storage + +--- + +### 3.5 correspondence_recipients + +**Purpose**: Junction table for correspondence recipients (TO/CC) (M:N) + +| Column Name | Data Type | Constraints | Description | +| ------------------------- | ---------------- | --------------- | ---------------------------- | +| correspondence_id | INT | PRIMARY KEY, FK | Reference to correspondences | +| recipient_organization_id | INT | PRIMARY KEY, FK | Recipient organization | +| recipient_type | ENUM('TO', 'CC') | PRIMARY KEY | Recipient type | + +**Indexes**: + +- PRIMARY KEY (correspondence_id, recipient_organization_id, recipient_type) +- FOREIGN KEY (correspondence_id) REFERENCES correspondence_revisions(correspondence_id) ON DELETE CASCADE +- FOREIGN KEY (recipient_organization_id) REFERENCES organizations(id) ON DELETE RESTRICT +- INDEX (recipient_organization_id) +- INDEX (recipient_type) + +**Relationships**: + +- Parent: correspondences, organizations + +**Business Rules**: + +- One organization can be both TO and CC recipient +- Cascade delete when correspondence is deleted + +--- + +### 3.6 tags + +**Purpose**: Master table for document tagging system + +| Column Name | Data Type | Constraints | Description | +| ----------- | ------------ | ----------------------------------- | ------------------------- | +| id | INT | PRIMARY KEY, AUTO_INCREMENT | Unique tag ID | +| tag_name | VARCHAR(100) | NOT NULL, UNIQUE | Tag name | +| description | TEXT | NULL | Tag description | +| created_at | TIMESTAMP | DEFAULT CURRENT_TIMESTAMP | Record creation timestamp | +| updated_at | TIMESTAMP | DEFAULT CURRENT_TIMESTAMP ON UPDATE | Last update timestamp | + +**Indexes**: + +- PRIMARY KEY (id) +- UNIQUE (tag_name) +- INDEX (tag_name) - For autocomplete + +**Relationships**: + +- Referenced by: correspondence_tags + +--- + +### 3.7 correspondence_tags + +**Purpose**: Junction table linking correspondences to tags (M:N) + +| Column Name | Data Type | Constraints | Description | +| ----------------- | --------- | --------------- | ---------------------------- | +| correspondence_id | INT | PRIMARY KEY, FK | Reference to correspondences | +| tag_id | INT | PRIMARY KEY, FK | Reference to tags | + +**Indexes**: + +- PRIMARY KEY (correspondence_id, tag_id) +- FOREIGN KEY (correspondence_id) REFERENCES correspondences(id) ON DELETE CASCADE +- FOREIGN KEY (tag_id) REFERENCES tags(id) ON DELETE CASCADE +- INDEX (tag_id) + +**Relationships**: + +- Parent: correspondences, tags + +--- + +### 3.8 correspondence_references + +**Purpose**: Junction table for cross-referencing correspondences (M:N) + +| Column Name | Data Type | Constraints | Description | +| --------------------- | --------- | --------------- | ------------------------------------- | +| src_correspondence_id | INT | PRIMARY KEY, FK | Source correspondence ID | +| tgt_correspondence_id | INT | PRIMARY KEY, FK | Target (referenced) correspondence ID | + +**Indexes**: + +- PRIMARY KEY (src_correspondence_id, tgt_correspondence_id) +- FOREIGN KEY (src_correspondence_id) REFERENCES correspondences(id) ON DELETE CASCADE +- FOREIGN KEY (tgt_correspondence_id) REFERENCES correspondences(id) ON DELETE CASCADE +- INDEX (tgt_correspondence_id) + +**Relationships**: + +- Parent: correspondences (both sides) + +**Business Rules**: + +- Allows tracing document relationships +- Bi-directional references should be created as separate records + +### 3.9 ตาราง correspondence_routing_templates + +**Purpose**: เก็บข้อมูลแม่แบบ (Template) ของสายงานการส่งต่อเอกสารเพื่อขออนุมัติ ทำให้ไม่ต้องกำหนดขั้นตอนซ้ำทุกครั้ง สามารถสร้างเป็นแม่แบบทั่วไป หรือเฉพาะสำหรับโครงการใดโครงการหนึ่งได้ + +| Column Name | Data Type | Constraints | Description | +| ------------- | --------- | --------------------------- | -------------------------------------------- | +| id | INT | PRIMARY KEY, AUTO_INCREMENT | ID หลัก (Primary Key) ของแม่แบบ รันค่าอัตโนมัติ | +| template_name | VARCHAR(255) | NOT NULL | ชื่อของแม่แบบ เช่น "เสนอโครงการ", "ขออนุมัติจัดซื้อ" | +| description | TEXT | NULL | คำอธิบายรายละเอียดเกี่ยวกับแม่แบบนี้ | +| project_id | INT | NULL | ID ของโครงการที่แม่แบบนี้สังกัดอยู่ (ถ้ามี) **ค่า NULL หมายถึง** เป็น "แม่แบบทั่วไป" ที่สามารถใช้กับทุกโครงการได้ | +| created_a | TIMESTAMP | NOT NULL, DEFAULT CURRENT_TIMESTAMP | วันที่และเวลาที่สร้างแม่แบบนี้ | +| updated_at | TIMESTAMP | NOT NULL,`DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP | วันที่และเวลาที่แก้ไขข้อมูลในแม่แบบนี้ล่าสุด | + +**Indexes**: + +- ux_routing_template_name_project (template_name, project_id): ดัชนีแบบ UNIQUE ป้องกันการมีชื่อแม่แบบซ้ำกันในแต่ละโครงการ หรือในส่วนของแม่แบบทั่วไป (ที่ project_id เป็น NULL) + +**ความสัมพันธ์ Foreign Key:** + +- fk_crt_project: อ้างอิงไปยัง projects(id) +- ON DELETE CASCAD`: ถ้าโครงการ (projects) ถูกลบ แม่แบบที่เกี่ยวข้องกับโครงการนั้นๆ จะถูกลบไปด้วยทั้งหมด + +--- + +### 3.10. ตาราง correspondence_status_transitions + +**Purpose**: ตารางนี้ใช้กำหนดกฎ (State Machine) ว่าสถานะใดสามารถเปลี่ยนไปเป็นสถานะใดได้บ้าง โดยขึ้นอยู่กับประเภทของหนังสือ เพื่อควบคุมการไหลของสถานะให้ถูกต้องตามข้อบังคับ + +| Column Name | Data Type | Constraints | Description | +| -------------- | --------- | ----------- | ------------------------------------------------- | +| type_id | INT | PRIMARY KEY | ID ของประเภทหนังสือ (เช่น หนังสือภายใน, หนังสือภายนอก) | +| from_status_id | INT | PRIMARY KEY | ID ของสถานะต้นทาง (เช่น ร่าง) | +| to_status_id | INT | PRIMARY KEY | ID ของสถานะปลายทาง (เช่น รออนุมัติ) | + +**คีย์หลัก (Primary Key):** + +- (type_id, from_status_id, to_status_id)`: คีย์หลักแบบประกอบ ทำให้แน่ใจว่าแต่ละประเภทหนังสือ การเปลี่ยนจากสถานะหนึ่งไปอีกสถานะหนึ่งจะซ้ำกันไม่ได้ + +**ความสัมพันธ์ Foreign Key:** + +- fk_cst_type : อ้างอิงไปยัง correspondence_types(id) +- fk_cst_from : อ้างอิงไปยัง correspondence_status(id) +- fk_cst_to : อ้างอิงไปยัง correspondence_status(id) +- ไม่มีการกำหนด ON DELETE จึงเป็นค่าเริ่มต้น RESTRICT หมายความว่า จะลบประเภทหนังสือหรือสถานะไม่ได้ ถ้ายังมีการใช้งานอยู่ในตารางนี้ + +--- + +### 3.10 ตาราง correspondence_routing_template_steps + +**Purpose**: เก็บรายละเอียดของแต่ละขั้นตอน (Steps) ภายในแม่แบบสายงาน (correspondence_routing_templates) กำหนดว่าจะส่งไปที่องค์กรไหน ลำดับเป็นเท่าไร และเพื่อวัตถุประสงค์อะไร + +| Column Name | Data Type | Constraints | Description | +| :----- |----- | ----- | ---- | +| id | INT | PRIMARY KEY, AUTO_INCREMENT | ID หลักของขั้นตอน | +| template_id | INT | NOT NULL | ID ของแม่แบบที่ขั้นตอนนี้สังกัดอยู่ | +| sequence | INT | NOT NULL | ลำดับของขั้นตอน (1, 2, 3, ...) | +| to_organization_id | INT | NOT NULL | ID ขององค์กรที่เป็นผู้รับในขั้นตอนนี้ | +| step_purpose | ENUM | NOT NULL,DEFAULT FOR_REVIEW | วัตถุประสงค์ของการส่งต่อในขั้นตอนนี้ **ค่าที่เป็นไปได้:** [FOR_APPROVAL: เพื่ออนุมัติ, FOR_REVIEW: เพื่อตรวจสอบ/พิจารณา, FOR_INFORMATION: เพื่อทราบ] | + +**Indexes**: + +- ux_cor_template_sequence (template_id, sequence): ดัชนีแบบ UNIQUE ป้องกันการมีลำดับขั้นตอนซ้ำกันภายในแม่แบบเดียวกัน + +**ความสัมพันธ์ Foreign Key:** + +- fk_cwts_template: อ้างอิงไปยัง correspondence_routing_templates(id) +- ON DELETE CASCADE: ถ้าแม่แบบถูกลบ ขั้นตอนทั้งหมดภายในแม่แบบนั้นจะถูกลบไปด้วย +- fk_cwts_org: อ้างอิงไปยัง organizations(id) +- ON DELETE CASCADE: ถ้าองค์กรถูกลบ ขั้นตอนที่ชี้ไปยังองค์กรนั้นจะถูกลบ + +--- + +### 3.11 ตาราง correspondence_routings + +**Purpose**: เป็นตารางที่เก็บข้อมูลการส่งต่อเอกสารจริง (Instance/Run-time) ติดตามประวัติการเคลื่อนย้ายของแต่ละเอกสาร ว่าผ่านใครมาบ้าง อยู่ที่ใคร และสถานะปัจจุบันคืออะไร + +| Column Name | Data Type | Constraints | Description | +| --- | --- | --- | --- | +| id | INT | PRIMARY KEY, AUTO_INCREMENT | ID หลักของรายการส่งต่อ | +| correspondence_id | INT | NOT NUL | ID ของเอกสาร (FK ไปยัง correspondence_revisions) | +| template_id | INT | NULL | ID ของแม่แบบที่ใช้สร้างสายงานนี้ (เก็บไว้เป็นข้อมูลอ้างอิง) | +| sequence | INT | NOT NULL | ลำดับของขั้นตอนการส่งต่อจริง | +| from_organization_id | INT | NOT NULL | ID ขององค์กรผู้ส่ง | +| to_organization_id| INT | NOT NULL | ID ขององค์กรผู้รับ | +| step_purpose | ENUM | NOT NULL, DEFAULT FOR_REVIEW | วัตถุประสงค์ของการส่งต่อในขั้นตอนนี้จริง **ค่าที่เป็นไปได้:** [FOR_APPROVAL: เพื่ออนุมัติ, FOR_REVIEW: เพื่อตรวจสอบ/พิจารณา, FOR_INFORMATION: เพื่อทราบ, FOR_ACTION: เพื่อดำเนินการ] | +| status | ENUM | NOT NULL, DEFAULT SENT | [ACTIONED: ดำเนินการแล้ว, FORWARDED: ส่งต่อแล้ว, REPLIE: ตอบกลับแล้ว] | +| comments | TEXT | NULL | หมายเหตุหรือความคิดเห็นในการส่งต่อ | +| due_date | DATETIME | NULL | วันที่ครบกำหนดที่ต้องดำเนินการในขั้นตอนนี้ | +| processed_by_user_id | INT |NULL | ID ของผู้ใช้ที่ดำเนินการในขั้นตอนนี้จริงๆ | +| processed_at | TIMESTAMP | NULL | เวลาที่ผู้ใช้ดำเนินการเสร็จสิ้น | +| created_at | TIMESTAMP | NOT NULL, DEFAULT CURRENT_TIMESTAMP | เวลาที่สร้างรายการส่งต่อนี้ | + +**Indexes**: + +- ux_cor_routing_sequence (correspondence_id, sequence): ดัชนีแบบ UNIQUE ทำให้มั่นใจได้ว่าแต่ละเอกสารจะมีขั้นตอนการส่งต่อตามลำดับได้เพียงชุดเดียว + +**ความสัมพันธ์ Foreign Key:** + +- fk_crs_correspondence: อ้างอิงไปยัง correspondence_revisions(correspondence_id) +- ON DELETE CASCADE`: ถ้าเอกสาร (revision) ถูกลบ ประวัติการส่งต่อทั้งหมดจะถูกลบไปด้วย +- fk_crs_template: อ้างอิงไปยัง correspondence_routing_templates(id) +- ON DELETE SET NULL: ถ้าแม่แบบถูกลบ ค่า template_id ในตารางนี้จะถูกเปลี่ยนเป็น NULL เพื่อรักษาประวัติการส่งต่อไว้ +- fk_crs_from_org: อ้างอิงไปยัง organizations(id) +- ON DELETE CASCADE: ถ้าองค์กรผู้ส่งถูกลบ รายการส่งต่อนี้จะถูกลบ +- fk_crs_to_org: อ้างอิงไปยัง organizations(id) +- ON DELETE CASCADE: ถ้าองค์กรผู้รับถูกลบ รายการส่งต่อนี้จะถูกลบ +- fk_crs_processed_by_user: อ้างอิงไปยัง users(user_id) +- ON DELETE SET NULL: ถ้าผู้ใช้ถูกลบ ค่า processed_by_user_id จะถูกเปลี่ยนเป็น NULL เพื่อรักษาประวัติการดำเนินการไว้ + +--- + +## **4. 📐 approval: RFA Tables (เอกสารขออนุมัติ, Workflows)** + +### 4.1 rfa_types + +**Purpose**: Master table for RFA (Request for Approval) types + +| Column Name | Data Type | Constraints | Description | +| ----------- | ------------ | --------------------------- | ------------------------------- | +| id | INT | PRIMARY KEY, AUTO_INCREMENT | Unique identifier | +| type_code | VARCHAR(20) | NOT NULL, UNIQUE | Type code (DWG, DOC, MAT, etc.) | +| type_name | VARCHAR(100) | NOT NULL | Full type name | +| description | TEXT | NULL | Type description | +| sort_order | INT | DEFAULT 0 | Display order | +| is_active | TINYINT(1) | DEFAULT 1 | Active status | + +**Indexes**: + +- PRIMARY KEY (id) +- UNIQUE (type_code) +- INDEX (is_active) +- INDEX (sort_order) + +**Relationships**: + +- Referenced by: rfas + +**Seed Data**: 11 RFA types including Shop Drawing (DWG), Document (DOC), Specification (SPC), Calculation (CAL), Test Report (TRP), Survey Report (SRY), QA/QC Document, Method Statement (MES), Material (MAT), As-Built (ASB), Other (OTH) + +--- + +### 4.2 rfa_status_codes + +**Purpose**: Master table for RFA status codes + +| Column Name | Data Type | Constraints | Description | +| ----------- | ------------ | --------------------------- | --------------------------------- | +| id | INT | PRIMARY KEY, AUTO_INCREMENT | Unique identifier | +| status_code | VARCHAR(20) | NOT NULL, UNIQUE | Status code (DFT, FAP, FRE, etc.) | +| status_name | VARCHAR(100) | NOT NULL | Full status name | +| description | TEXT | NULL | Status description | +| sort_order | INT | DEFAULT 0 | Display order | +| is_active | TINYINT(1) | DEFAULT 1 | Active status | + +**Indexes**: + +- PRIMARY KEY (id) +- UNIQUE (status_code) +- INDEX (is_active) +- INDEX (sort_order) + +**Relationships**: + +- Referenced by: rfa_revisions + +**Seed Data**: 7 status codes + +- DFT: Draft +- FAP: For Approve +- FRE: For Review +- FCO: For Construction +- ASB: AS-Built +- OBS: Obsolete +- CC: Canceled + +--- + +### 4.3 rfa_approve_codes + +**Purpose**: Master table for RFA approval result codes + +| Column Name | Data Type | Constraints | Description | +| ------------ | ------------ | --------------------------- | -------------------------------- | +| id | INT | PRIMARY KEY, AUTO_INCREMENT | Unique identifier | +| approve_code | VARCHAR(20) | NOT NULL, UNIQUE | Approval code (1A, 1C, 3R, etc.) | +| approve_name | VARCHAR(100) | NOT NULL | Full approval name | +| description | TEXT | NULL | Code description | +| sort_order | INT | DEFAULT 0 | Display order | +| is_active | TINYINT(1) | DEFAULT 1 | Active status | + +**Indexes**: + +- PRIMARY KEY (id) +- UNIQUE (approve_code) +- INDEX (is_active) +- INDEX (sort_order) + +**Relationships**: + +- Referenced by: rfa_revisions + +**Seed Data**: 8 approval codes + +- 1A: Approved by Authority +- 1C: Approved by CSC +- 1N: Approved As Note +- 1R: Approved with Remarks +- 3C: Consultant Comments +- 3R: Revise and Resubmit +- 4X: Reject +- 5N: No Further Action + +--- + +### 4.4 rfas + +**Purpose**: Master table for RFA documents (non-revisioned data) + +| Column Name | Data Type | Constraints | Description | +| ----------- | --------- | --------------------------- | --------------------------- | +| id | INT | PRIMARY KEY, AUTO_INCREMENT | Master RFA ID | +| rfa_type_id | INT | NOT NULL, FK | Reference to rfa_types | +| created_at | DATETIME | DEFAULT CURRENT_TIMESTAMP | Record creation timestamp | +| created_by | INT | NULL, FK | User who created the record | +| deleted_at | DATETIME | NULL | Soft delete timestamp | + +**Indexes**: + +- PRIMARY KEY (id) +- FOREIGN KEY (rfa_type_id) REFERENCES rfa_types(id) +- FOREIGN KEY (created_by) REFERENCES users(user_id) ON DELETE SET NULL +- INDEX (rfa_type_id) +- INDEX (deleted_at) + +**Relationships**: + +- Parent: rfa_types, users +- Children: rfa_revisions + +**Business Rules**: + +- One RFA can have multiple revisions +- Soft delete preserves history + +--- + +### 4.5 rfa_revisions + +**Purpose**: Child table storing revision history of RFAs (1:N) + +| Column Name | Data Type | Constraints | Description | +| ------------------- | ------------ | --------------------------- | ---------------------------------------------- | +| id | INT | PRIMARY KEY, AUTO_INCREMENT | Unique revision ID | +| correspondence_id | INT | NOT NULL, FK | Link to correspondence (RFA as correspondence) | +| rfa_id | INT | NOT NULL, FK | Master RFA ID | +| revision_number | INT | NOT NULL | Revision sequence (0, 1, 2...) | +| revision_label | VARCHAR(10) | NULL | Display revision (A, B, 1.1...) | +| is_current | BOOLEAN | DEFAULT FALSE | Current revision flag | +| rfa_status_code_id | INT | NOT NULL, FK | Current RFA status | +| rfa_approve_code_id | INT | NULL, FK | Approval result code | +| title | VARCHAR(255) | NOT NULL | RFA title | +| document_date | DATE | NULL | Document date | +| issued_date | DATE | NULL | Issue date for approval | +| received_date | DATETIME | NULL | Received date | +| approved_date | DATE | NULL | Approval date | +| description | TEXT | NULL | Revision description | +| created_at | DATETIME | DEFAULT CURRENT_TIMESTAMP | Revision creation timestamp | +| created_by | INT | NULL, FK | User who created revision | +| updated_by | INT | NULL, FK | User who last updated | + +**Indexes**: + +- PRIMARY KEY (id) +- FOREIGN KEY (correspondence_id) REFERENCES correspondences(id) ON DELETE CASCADE +- FOREIGN KEY (rfa_id) REFERENCES rfas(id) ON DELETE CASCADE +- FOREIGN KEY (rfa_status_code_id) REFERENCES rfa_status_codes(id) +- FOREIGN KEY (rfa_approve_code_id) REFERENCES rfa_approve_codes(id) ON DELETE SET NULL +- FOREIGN KEY (created_by) REFERENCES users(user_id) ON DELETE SET NULL +- FOREIGN KEY (updated_by) REFERENCES users(user_id) ON DELETE SET NULL +- UNIQUE KEY (rfa_id, revision_number) +- UNIQUE KEY (rfa_id, is_current) +- INDEX (rfa_status_code_id) +- INDEX (rfa_approve_code_id) +- INDEX (is_current) + +**Relationships**: + +- Parent: correspondences, rfas, rfa_status_codes, rfa_approve_codes, users +- Children: rfa_items, rfa_workflows + +**Business Rules**: + +- RFA is a specialized type of correspondence +- Only one revision can be current per RFA +- Links to shop drawings through rfa_items + +--- + +### 4.6 rfa_items + +**Purpose**: Junction table linking RFA revisions to shop drawing revisions (M:N) + +| Column Name | Data Type | Constraints | Description | +| ------------------------ | --------- | --------------- | ------------------------------ | +| rfarev_correspondence_id | INT | PRIMARY KEY, FK | RFA revision correspondence ID | +| shop_drawing_revision_id | INT | PRIMARY KEY, FK | Shop drawing revision ID | + +**Indexes**: + +- PRIMARY KEY (rfarev_correspondence_id, shop_drawing_revision_id) +- FOREIGN KEY (rfarev_correspondence_id) REFERENCES rfa_revisions(correspondence_id) ON DELETE CASCADE +- FOREIGN KEY (shop_drawing_revision_id) REFERENCES shop_drawing_revisions(id) ON DELETE CASCADE +- INDEX (shop_drawing_revision_id) + +**Relationships**: + +- Parent: rfa_revisions, shop_drawing_revisions + +**Business Rules**: + +- Used primarily for RFA type = 'DWG' (Shop Drawing) +- One RFA can contain multiple shop drawings +- One shop drawing can be referenced by multiple RFAs + +--- + +### 4.7 rfa_workflow_templates + +**Purpose**: Master table for RFA approval workflow templates + +| Column Name | Data Type | Constraints | Description | +| ------------- | ------------ | ----------------------------------- | ------------------------- | +| id | INT | PRIMARY KEY, AUTO_INCREMENT | Unique template ID | +| template_name | VARCHAR(100) | NOT NULL | Template name | +| description | TEXT | NULL | Template description | +| is_active | TINYINT(1) | DEFAULT 1 | Active status | +| created_at | TIMESTAMP | DEFAULT CURRENT_TIMESTAMP | Record creation timestamp | +| updated_at | TIMESTAMP | DEFAULT CURRENT_TIMESTAMP ON UPDATE | Last update timestamp | + +**Indexes**: + +- PRIMARY KEY (id) +- INDEX (is_active) +- INDEX (template_name) + +**Relationships**: + +- Children: rfa_workflow_template_steps + +**Business Rules**: + +- Defines reusable approval workflows for RFAs +- Can be assigned to specific RFA types or organizations + +--- + +### 4.8 rfa_workflow_template_steps + +**Purpose**: Child table defining steps in workflow templates + +| Column Name | Data Type | Constraints | Description | +| --------------- | --------- | --------------------------- | ----------------------------------------- | +| id | INT | PRIMARY KEY, AUTO_INCREMENT | Unique step ID | +| template_id | INT | NOT NULL, FK | Reference to workflow template | +| step_number | INT | NOT NULL | Step sequence order | +| organization_id | INT | NOT NULL, FK | Organization responsible for step | +| role_id | INT | NULL, FK | Required role for this step | +| action_type | ENUM | NULL | Action type: REVIEW, APPROVE, ACKNOWLEDGE | +| duration_days | INT | NULL | Expected duration in days | +| is_optional | BOOLEAN | DEFAULT FALSE | Optional step flag | + +**Indexes**: + +- PRIMARY KEY (id) +- FOREIGN KEY (template_id) REFERENCES rfa_workflow_templates(id) ON DELETE CASCADE +- FOREIGN KEY (organization_id) REFERENCES organizations(id) +- FOREIGN KEY (role_id) REFERENCES roles(role_id) +- INDEX (template_id, step_number) +- INDEX (organization_id) + +**Relationships**: + +- Parent: rfa_workflow_templates, organizations, roles + +**Business Rules**: + +- Steps are executed in step_number order +- Optional steps can be skipped +- Duration used for deadline calculation + +--- + +### 4.9 rfa_workflows + +**Purpose**: Transaction log table tracking actual RFA approval workflow execution + +| Column Name | Data Type | Constraints | Description | +| --------------- | --------- | ----------------------------------- | ------------------------------------------------- | +| id | INT | PRIMARY KEY, AUTO_INCREMENT | Unique workflow log ID | +| rfa_revision_id | INT | NOT NULL, FK | Reference to RFA revision | +| step_number | INT | NOT NULL | Current step number | +| organization_id | INT | NOT NULL, FK | Organization responsible | +| assigned_to | INT | NULL, FK | Assigned user ID | +| action_type | ENUM | NULL | Action type: REVIEW, APPROVE, ACKNOWLEDGE | +| status | ENUM | NULL | Status: PENDING, IN_PROGRESS, COMPLETED, REJECTED | +| comments | TEXT | NULL | Comments/remarks | +| completed_at | DATETIME | NULL | Completion timestamp | +| created_at | TIMESTAMP | DEFAULT CURRENT_TIMESTAMP | Record creation timestamp | +| updated_at | TIMESTAMP | DEFAULT CURRENT_TIMESTAMP ON UPDATE | Last update timestamp | + +**Indexes**: + +- PRIMARY KEY (id) +- FOREIGN KEY (rfa_revision_id) REFERENCES rfa_revisions(id) ON DELETE CASCADE +- FOREIGN KEY (organization_id) REFERENCES organizations(id) +- FOREIGN KEY (assigned_to) REFERENCES users(user_id) +- INDEX (rfa_revision_id, step_number) +- INDEX (assigned_to, status) +- INDEX (status) + +**Relationships**: + +- Parent: rfa_revisions, organizations, users + +**Business Rules**: + +- Records actual workflow execution history +- Tracks who did what and when +- Multiple records per RFA revision (one per step) +- Status changes tracked via updated_at + +--- + +## **5. 📐 Drawings Tables (แบบ, หมวดหมู่)** + +### 5.1 contract_drawing_volumes + +**Purpose**: Master table for contract drawing volume classification + +| Column Name | Data Type | Constraints | Description | +| ----------- | ------------ | ----------------------------------- | ------------------------- | +| id | INT | PRIMARY KEY, AUTO_INCREMENT | Unique volume ID | +| project_id | INT | NOT NULL, FK | Reference to projects | +| volume_code | VARCHAR(50) | NOT NULL | Volume code | +| volume_name | VARCHAR(255) | NOT NULL | Volume name | +| description | TEXT | NULL | Volume description | +| sort_order | INT | DEFAULT 0 | Display order | +| created_at | TIMESTAMP | DEFAULT CURRENT_TIMESTAMP | Record creation timestamp | +| updated_at | TIMESTAMP | DEFAULT CURRENT_TIMESTAMP ON UPDATE | Last update timestamp | + +**Indexes**: + +- PRIMARY KEY (id) +- FOREIGN KEY (project_id) REFERENCES projects(id) ON DELETE CASCADE +- UNIQUE KEY (project_id, volume_code) +- INDEX (sort_order) + +**Relationships**: + +- Parent: projects +- Referenced by: contract_drawings + +**Business Rules**: + +- Volume codes must be unique within a project +- Used for organizing large sets of contract drawings + +--- + +### 5.2 contract_drawing_cats + +**Purpose**: Master table for contract drawing main categories + +| Column Name | Data Type | Constraints | Description | +| ----------- | ------------ | ----------------------------------- | ------------------------- | +| id | INT | PRIMARY KEY, AUTO_INCREMENT | Unique category ID | +| project_id | INT | NOT NULL, FK | Reference to projects | +| cat_code | VARCHAR(50) | NOT NULL | Category code | +| cat_name | VARCHAR(255) | NOT NULL | Category name | +| description | TEXT | NULL | Category description | +| sort_order | INT | DEFAULT 0 | Display order | +| created_at | TIMESTAMP | DEFAULT CURRENT_TIMESTAMP | Record creation timestamp | +| updated_at | TIMESTAMP | DEFAULT CURRENT_TIMESTAMP ON UPDATE | Last update timestamp | + +**Indexes**: + +- PRIMARY KEY (id) +- FOREIGN KEY (project_id) REFERENCES projects(id) ON DELETE CASCADE +- UNIQUE KEY (project_id, cat_code) +- INDEX (sort_order) + +**Relationships**: + +- Parent: projects +- Referenced by: contract_drawing_subcat_cat_maps + +**Business Rules**: + +- Category codes must be unique within a project +- Hierarchical relationship with sub-categories via mapping table + +--- + +### 5.3 contract_drawing_sub_cats + +**Purpose**: Master table for contract drawing sub-categories + +| Column Name | Data Type | Constraints | Description | +| ------------ | ------------ | ----------------------------------- | ------------------------- | +| id | INT | PRIMARY KEY, AUTO_INCREMENT | Unique sub-category ID | +| project_id | INT | NOT NULL, FK | Reference to projects | +| sub_cat_code | VARCHAR(50) | NOT NULL | Sub-category code | +| sub_cat_name | VARCHAR(255) | NOT NULL | Sub-category name | +| description | TEXT | NULL | Sub-category description | +| sort_order | INT | DEFAULT 0 | Display order | +| created_at | TIMESTAMP | DEFAULT CURRENT_TIMESTAMP | Record creation timestamp | +| updated_at | TIMESTAMP | DEFAULT CURRENT_TIMESTAMP ON UPDATE | Last update timestamp | + +**Indexes**: + +- PRIMARY KEY (id) +- FOREIGN KEY (project_id) REFERENCES projects(id) ON DELETE CASCADE +- UNIQUE KEY (project_id, sub_cat_code) +- INDEX (sort_order) + +**Relationships**: + +- Parent: projects +- Referenced by: contract_drawings, contract_drawing_subcat_cat_maps + +**Business Rules**: + +- Sub-category codes must be unique within a project +- Can be mapped to multiple main categories via mapping table + +--- + +### 5.4 contract_drawing_subcat_cat_maps + +**Purpose**: Junction table mapping sub-categories to main categories (M:N) + +| Column Name | Data Type | Constraints | Description | +| ----------- | --------- | --------------- | -------------------------- | +| project_id | INT | PRIMARY KEY, FK | Reference to projects | +| sub_cat_id | INT | PRIMARY KEY, FK | Reference to sub-category | +| cat_id | INT | PRIMARY KEY, FK | Reference to main category | + +**Indexes**: + +- PRIMARY KEY (project_id, sub_cat_id, cat_id) +- FOREIGN KEY (project_id) REFERENCES projects(id) ON DELETE CASCADE +- FOREIGN KEY (sub_cat_id) REFERENCES contract_drawing_sub_cats(id) ON DELETE CASCADE +- FOREIGN KEY (cat_id) REFERENCES contract_drawing_cats(id) ON DELETE CASCADE +- INDEX (sub_cat_id) +- INDEX (cat_id) + +**Relationships**: + +- Parent: projects, contract_drawing_sub_cats, contract_drawing_cats + +**Business Rules**: + +- Allows flexible categorization +- One sub-category can belong to multiple main categories +- All three fields required for uniqueness + +--- + +### 5.5 contract_drawings + +**Purpose**: Master table for contract drawings (from contract specifications) + +| Column Name | Data Type | Constraints | Description | +| ----------- | ------------ | ----------------------------------- | ------------------------- | +| id | INT | PRIMARY KEY, AUTO_INCREMENT | Unique drawing ID | +| project_id | INT | NOT NULL, FK | Reference to projects | +| condwg_no | VARCHAR(255) | NOT NULL | Contract drawing number | +| title | VARCHAR(255) | NOT NULL | Drawing title | +| sub_cat_id | INT | NULL, FK | Reference to sub-category | +| volume_id | INT | NULL, FK | Reference to volume | +| created_at | TIMESTAMP | DEFAULT CURRENT_TIMESTAMP | Record creation timestamp | +| updated_at | TIMESTAMP | DEFAULT CURRENT_TIMESTAMP ON UPDATE | Last update timestamp | +| deleted_at | DATETIME | NULL | Soft delete timestamp | +| updated_by | INT | NULL, FK | User who last updated | + +**Indexes**: + +- PRIMARY KEY (id) +- FOREIGN KEY (project_id) REFERENCES projects(id) ON DELETE CASCADE +- FOREIGN KEY (sub_cat_id) REFERENCES contract_drawing_sub_cats(id) ON DELETE RESTRICT +- FOREIGN KEY (volume_id) REFERENCES contract_drawing_volumes(id) ON DELETE RESTRICT +- FOREIGN KEY (updated_by) REFERENCES users(user_id) +- UNIQUE KEY (project_id, condwg_no) +- INDEX (sub_cat_id) +- INDEX (volume_id) +- INDEX (deleted_at) + +**Relationships**: + +- Parent: projects, contract_drawing_sub_cats, contract_drawing_volumes, users +- Referenced by: shop_drawing_revision_contract_refs, contract_drawing_attachments + +**Business Rules**: + +- Drawing numbers must be unique within a project +- Represents baseline/contract drawings +- Referenced by shop drawings for compliance tracking +- Soft delete preserves history + +--- + +### 5.6 shop_drawing_main_categories + +**Purpose**: Master table for shop drawing main categories (discipline-level) + +| Column Name | Data Type | Constraints | Description | +| ------------------ | ------------ | ----------------------------------- | ------------------------------------ | +| id | INT | PRIMARY KEY, AUTO_INCREMENT | Unique category ID | +| main_category_code | VARCHAR(50) | NOT NULL, UNIQUE | Category code (ARCH, STR, MEP, etc.) | +| main_category_name | VARCHAR(255) | NOT NULL | Category name | +| description | TEXT | NULL | Category description | +| sort_order | INT | DEFAULT 0 | Display order | +| is_active | TINYINT(1) | DEFAULT 1 | Active status | +| created_at | TIMESTAMP | DEFAULT CURRENT_TIMESTAMP | Record creation timestamp | +| updated_at | TIMESTAMP | DEFAULT CURRENT_TIMESTAMP ON UPDATE | Last update timestamp | + +**Indexes**: + +- PRIMARY KEY (id) +- UNIQUE (main_category_code) +- INDEX (is_active) +- INDEX (sort_order) + +**Relationships**: + +- Referenced by: shop_drawing_sub_categories, shop_drawings + +**Business Rules**: + +- Global categories (not project-specific) +- Typically represents engineering disciplines + +--- + +### 5.7 shop_drawing_sub_categories + +**Purpose**: Master table for shop drawing sub-categories (component-level) + +| Column Name | Data Type | Constraints | Description | +| ----------------- | ------------ | ----------------------------------- | ----------------------------------------------- | +| id | INT | PRIMARY KEY, AUTO_INCREMENT | Unique sub-category ID | +| sub_category_code | VARCHAR(50) | NOT NULL, UNIQUE | Sub-category code (STR-COLUMN, ARCH-DOOR, etc.) | +| sub_category_name | VARCHAR(255) | NOT NULL | Sub-category name | +| main_category_id | INT | NOT NULL, FK | Reference to main category | +| description | TEXT | NULL | Sub-category description | +| sort_order | INT | DEFAULT 0 | Display order | +| is_active | TINYINT(1) | DEFAULT 1 | Active status | +| created_at | TIMESTAMP | DEFAULT CURRENT_TIMESTAMP | Record creation timestamp | +| updated_at | TIMESTAMP | DEFAULT CURRENT_TIMESTAMP ON UPDATE | Last update timestamp | + +**Indexes**: + +- PRIMARY KEY (id) +- UNIQUE (sub_category_code) +- FOREIGN KEY (main_category_id) REFERENCES shop_drawing_main_categories(id) +- INDEX (main_category_id) +- INDEX (is_active) +- INDEX (sort_order) + +**Relationships**: + +- Parent: shop_drawing_main_categories +- Referenced by: shop_drawings + +**Business Rules**: + +- Global sub-categories (not project-specific) +- Hierarchical under main categories +- Represents specific drawing types or components + +--- + +### 5.8 shop_drawings + +**Purpose**: Master table for shop drawings (contractor-submitted) + +| Column Name | Data Type | Constraints | Description | +| ---------------- | ------------ | ----------------------------------- | -------------------------- | +| id | INT | PRIMARY KEY, AUTO_INCREMENT | Unique drawing ID | +| project_id | INT | NOT NULL, FK | Reference to projects | +| drawing_number | VARCHAR(100) | NOT NULL, UNIQUE | Shop drawing number | +| title | VARCHAR(500) | NOT NULL | Drawing title | +| main_category_id | INT | NOT NULL, FK | Reference to main category | +| sub_category_id | INT | NOT NULL, FK | Reference to sub-category | +| created_at | TIMESTAMP | DEFAULT CURRENT_TIMESTAMP | Record creation timestamp | +| updated_at | TIMESTAMP | DEFAULT CURRENT_TIMESTAMP ON UPDATE | Last update timestamp | +| deleted_at | DATETIME | NULL | Soft delete timestamp | +| updated_by | INT | NULL, FK | User who last updated | + +**Indexes**: + +- PRIMARY KEY (id) +- UNIQUE (drawing_number) +- FOREIGN KEY (project_id) REFERENCES projects(id) +- FOREIGN KEY (main_category_id) REFERENCES shop_drawing_main_categories(id) +- FOREIGN KEY (sub_category_id) REFERENCES shop_drawing_sub_categories(id) +- FOREIGN KEY (updated_by) REFERENCES users(user_id) +- INDEX (project_id) +- INDEX (main_category_id) +- INDEX (sub_category_id) +- INDEX (deleted_at) + +**Relationships**: + +- Parent: projects, shop_drawing_main_categories, shop_drawing_sub_categories, users +- Children: shop_drawing_revisions + +**Business Rules**: + +- Drawing numbers are globally unique across all projects +- Represents contractor shop drawings +- Can have multiple revisions +- Soft delete preserves history + +--- + +### 5.9 shop_drawing_revisions + +**Purpose**: Child table storing revision history of shop drawings (1:N) + +| Column Name | Data Type | Constraints | Description | +| --------------- | ----------- | --------------------------- | ------------------------------ | +| id | INT | PRIMARY KEY, AUTO_INCREMENT | Unique revision ID | +| shop_drawing_id | INT | NOT NULL, FK | Master shop drawing ID | +| revision_number | INT | NOT NULL | Revision sequence (0, 1, 2...) | +| revision_label | VARCHAR(10) | NULL | Display revision (A, B, C...) | +| revision_date | DATE | NULL | Revision date | +| description | TEXT | NULL | Revision description/changes | +| created_at | TIMESTAMP | DEFAULT CURRENT_TIMESTAMP | Revision creation timestamp | + +**Indexes**: + +- PRIMARY KEY (id) +- FOREIGN KEY (shop_drawing_id) REFERENCES shop_drawings(id) ON DELETE CASCADE +- UNIQUE KEY (shop_drawing_id, revision_number) +- INDEX (revision_date) + +**Relationships**: + +- Parent: shop_drawings +- Referenced by: rfa_items, shop_drawing_revision_contract_refs, shop_drawing_revision_attachments + +**Business Rules**: + +- Revision numbers are sequential starting from 0 +- Each revision can reference multiple contract drawings +- Each revision can have multiple file attachments +- Linked to RFAs for approval tracking + +--- + +### 5.10 shop_drawing_revision_contract_refs + +**Purpose**: Junction table linking shop drawing revisions to referenced contract drawings (M:N) + +| Column Name | Data Type | Constraints | Description | +| ------------------------ | --------- | --------------- | ---------------------------------- | +| shop_drawing_revision_id | INT | PRIMARY KEY, FK | Reference to shop drawing revision | +| contract_drawing_id | INT | PRIMARY KEY, FK | Reference to contract drawing | + +**Indexes**: + +- PRIMARY KEY (shop_drawing_revision_id, contract_drawing_id) +- FOREIGN KEY (shop_drawing_revision_id) REFERENCES shop_drawing_revisions(id) ON DELETE CASCADE +- FOREIGN KEY (contract_drawing_id) REFERENCES contract_drawings(id) ON DELETE CASCADE +- INDEX (contract_drawing_id) + +**Relationships**: + +- Parent: shop_drawing_revisions, contract_drawings + +**Business Rules**: + +- Tracks which contract drawings each shop drawing revision is based on +- Ensures compliance with contract specifications +- One shop drawing revision can reference multiple contract drawings + +--- + +## **6. 🔄 Circulations Tables (ใบเวียนภายใน)** + +### 6.1 circulation_status_codes + +**Purpose**: Master table for circulation workflow status codes + +| Column Name | Data Type | Constraints | Description | +| ----------- | ----------- | --------------------------- | --------------------------------------------------- | +| id | INT | PRIMARY KEY, AUTO_INCREMENT | Unique status ID | +| code | VARCHAR(20) | NOT NULL, UNIQUE | Status code (OPEN, IN_REVIEW, COMPLETED, CANCELLED) | +| description | VARCHAR(50) | NOT NULL | Status description | +| sort_order | INT | DEFAULT 0 | Display order | +| is_active | TINYINT(1) | DEFAULT 1 | Active status | + +**Indexes**: + +- PRIMARY KEY (id) +- UNIQUE (code) +- INDEX (is_active) +- INDEX (sort_order) + +**Relationships**: + +- Referenced by: circulations + +**Seed Data**: 4 status codes + +- OPEN: Initial status when created +- IN_REVIEW: Under review by recipients +- COMPLETED: All recipients have responded +- CANCELLED: Withdrawn/cancelled + +--- + +### 6.2 circulations + +**Purpose**: Master table for internal circulation sheets (document routing) + +| Column Name | Data Type | Constraints | Description | +| ----------------------- | ------------ | ----------------------------------- | ----------------------------------------- | +| id | INT | PRIMARY KEY, AUTO_INCREMENT | Unique circulation ID | +| correspondence_id | INT | UNIQUE, FK | Link to correspondence (1:1 relationship) | +| organization_id | INT | NOT NULL, FK | Organization that owns this circulation | +| circulation_no | VARCHAR(100) | NOT NULL | Circulation sheet number | +| circulation_subject | VARCHAR(500) | NOT NULL | Subject/title | +| circulation_status_code | VARCHAR(20) | NOT NULL, FK | Current status code | +| created_by_user_id | INT | NOT NULL, FK | User who created circulation | +| submitted_at | TIMESTAMP | NULL | Submission timestamp | +| closed_at | TIMESTAMP | NULL | Closure timestamp | +| created_at | TIMESTAMP | DEFAULT CURRENT_TIMESTAMP | Record creation timestamp | +| updated_at | TIMESTAMP | DEFAULT CURRENT_TIMESTAMP ON UPDATE | Last update timestamp | + +**Indexes**: + +- PRIMARY KEY (id) +- UNIQUE (correspondence_id) +- FOREIGN KEY (correspondence_id) REFERENCES correspondences(id) +- FOREIGN KEY (organization_id) REFERENCES organizations(id) +- FOREIGN KEY (circulation_status_code) REFERENCES circulation_status_codes(code) +- FOREIGN KEY (created_by_user_id) REFERENCES users(user_id) +- INDEX (organization_id) +- INDEX (circulation_status_code) +- INDEX (created_by_user_id) + +**Relationships**: + +- Parent: correspondences, organizations, circulation_status_codes, users +- Children: circulation_routings, circulation_attachments + +**Business Rules**: + +- Internal document routing within organization +- One-to-one relationship with correspondences +- Tracks document review/approval workflow +- Status progression: OPEN → IN_REVIEW → COMPLETED/CANCELLED + +--- + +### 6.3 circulation_templates + +**Purpose**: Master table for circulation workflow templates + +| Column Name | Data Type | Constraints | Description | +| --------------- | ------------ | ----------------------------------- | --------------------------- | +| id | INT | PRIMARY KEY, AUTO_INCREMENT | Unique template ID | +| template_name | VARCHAR(100) | NOT NULL | Template name | +| description | TEXT | NULL | Template description | +| organization_id | INT | NOT NULL, FK | Template owner organization | +| is_active | TINYINT(1) | DEFAULT 1 | Active status | +| created_at | TIMESTAMP | DEFAULT CURRENT_TIMESTAMP | Record creation timestamp | +| updated_at | TIMESTAMP | DEFAULT CURRENT_TIMESTAMP ON UPDATE | Last update timestamp | + +**Indexes**: + +- PRIMARY KEY (id) +- FOREIGN KEY (organization_id) REFERENCES organizations(id) +- INDEX (organization_id) +- INDEX (is_active) + +**Relationships**: + +- Parent: organizations +- Children: circulation_template_assignees + +**Business Rules**: + +- Organization-specific templates +- Defines reusable routing workflows + +--- + +### 6.4 circulation_template_assignees + +**Purpose**: Child table defining steps in circulation templates + +| Column Name | Data Type | Constraints | Description | +| --------------- | --------- | --------------------------- | --------------------------------- | +| id | INT | PRIMARY KEY, AUTO_INCREMENT | Unique step ID | +| template_id | INT | NOT NULL, FK | Reference to template | +| step_number | INT | NOT NULL | Step sequence order | +| organization_id | INT | NOT NULL, FK | Organization responsible for step | +| role_id | INT | NULL, FK | Required role for this step | +| duration_days | INT | NULL | Expected duration in days | +| is_optional | BOOLEAN | DEFAULT FALSE | Optional step flag | + +**Indexes**: + +- PRIMARY KEY (id) +- FOREIGN KEY (template_id) REFERENCES circulation_templates(id) ON DELETE CASCADE +- FOREIGN KEY (organization_id) REFERENCES organizations(id) +- FOREIGN KEY (role_id) REFERENCES roles(role_id) +- INDEX (template_id, step_number) +- INDEX (organization_id) + +**Relationships**: + +- Parent: circulation_templates, organizations, roles + +**Business Rules**: + +- Steps executed in step_number order +- Optional steps can be skipped +- Duration used for deadline calculation + +--- + +### 6.5 circulation_routings + +**Purpose**: Transaction log table tracking actual circulation routing execution + +| Column Name | Data Type | Constraints | Description | +| --------------- | --------- | ----------------------------------- | ------------------------------------------------- | +| id | INT | PRIMARY KEY, AUTO_INCREMENT | Unique routing log ID | +| circulation_id | INT | NOT NULL, FK | Reference to circulation | +| step_number | INT | NOT NULL | Current step number | +| organization_id | INT | NOT NULL, FK | Organization responsible | +| assigned_to | INT | NULL, FK | Assigned user ID | +| status | ENUM | NULL | Status: PENDING, IN_PROGRESS, COMPLETED, REJECTED | +| comments | TEXT | NULL | Comments/remarks | +| completed_at | DATETIME | NULL | Completion timestamp | +| created_at | TIMESTAMP | DEFAULT CURRENT_TIMESTAMP | Record creation timestamp | +| updated_at | TIMESTAMP | DEFAULT CURRENT_TIMESTAMP ON UPDATE | Last update timestamp | + +**Indexes**: + +- PRIMARY KEY (id) +- FOREIGN KEY (circulation_id) REFERENCES circulations(id) ON DELETE CASCADE +- FOREIGN KEY (organization_id) REFERENCES organizations(id) +- FOREIGN KEY (assigned_to) REFERENCES users(user_id) +- INDEX (circulation_id, step_number) +- INDEX (assigned_to, status) +- INDEX (status) + +**Relationships**: + +- Parent: circulations, organizations, users + +**Business Rules**: + +- Records actual routing history +- Multiple records per circulation (one per step) +- Tracks who reviewed/approved and when +- Used in v_user_tasks view for pending items + +--- + +## **7. 📤 Transmittals Tables (เอกสารนำส่ง)** + +### 7.1 transmittals + +**Purpose**: Child table for transmittal-specific data (1:1 with correspondences) + +| Column Name | Data Type | Constraints | Description | +| ----------------- | --------- | --------------- | --------------------------------------------------------- | +| correspondence_id | INT | PRIMARY KEY, FK | Reference to correspondences (1:1) | +| purpose | ENUM | NULL | Purpose: FOR_APPROVAL, FOR_INFORMATION, FOR_REVIEW, OTHER | +| remarks | TEXT | NULL | Additional remarks | + +**Indexes**: + +- PRIMARY KEY (correspondence_id) +- FOREIGN KEY (correspondence_id) REFERENCES correspondences(id) ON DELETE CASCADE +- INDEX (purpose) + +**Relationships**: + +- Parent: correspondences +- Children: transmittal_items + +**Business Rules**: + +- One-to-one relationship with correspondences +- Transmittal is a correspondence type for forwarding documents +- Contains metadata about the transmission + +--- + +### 7.2 transmittal_items + +**Purpose**: Junction table listing documents included in transmittal (M:N) + +| Column Name | Data Type | Constraints | Description | +| ---------------------- | ------------ | --------------------------- | --------------------------------------- | +| id | INT | PRIMARY KEY, AUTO_INCREMENT | Unique item ID | +| transmittal_id | INT | NOT NULL, FK | Reference to transmittal | +| item_correspondence_id | INT | NOT NULL, FK | Reference to document being transmitted | +| quantity | INT | DEFAULT 1 | Number of copies | +| remarks | VARCHAR(255) | NULL | Item-specific remarks | + +**Indexes**: + +- PRIMARY KEY (id) +- FOREIGN KEY (transmittal_id) REFERENCES transmittals(correspondence_id) ON DELETE CASCADE +- FOREIGN KEY (item_correspondence_id) REFERENCES correspondences(id) ON DELETE CASCADE +- UNIQUE KEY (transmittal_id, item_correspondence_id) +- INDEX (item_correspondence_id) + +**Relationships**: + +- Parent: transmittals, correspondences + +**Business Rules**: + +- One transmittal can contain multiple documents +- Tracks quantity of physical copies (if applicable) +- Links to any type of correspondence document + +--- + +## **8. 📎 File Management Tables (ไฟล์แนบ)** + +### 8.1 attachments + +**Purpose**: Central repository for all file attachments in the system + +| Column Name | Data Type | Constraints | Description | +| ------------------- | ------------ | --------------------------- | --------------------------------------------- | +| id | INT | PRIMARY KEY, AUTO_INCREMENT | Unique attachment ID | +| original_filename | VARCHAR(255) | NOT NULL | Original filename from upload | +| stored_filename | VARCHAR(255) | NOT NULL | System-generated unique filename | +| file_path | VARCHAR(500) | NOT NULL | Full file path on server (/share/dms-data/) | +| mime_type | VARCHAR(100) | NOT NULL | MIME type (application/pdf, image/jpeg, etc.) | +| file_size | INT | NOT NULL | File size in bytes | +| uploaded_by_user_id | INT | NOT NULL, FK | User who uploaded file | +| created_at | TIMESTAMP | DEFAULT CURRENT_TIMESTAMP | Upload timestamp | + +**Indexes**: + +- PRIMARY KEY (id) +- FOREIGN KEY (uploaded_by_user_id) REFERENCES users(user_id) ON DELETE CASCADE +- INDEX (stored_filename) +- INDEX (mime_type) +- INDEX (uploaded_by_user_id) +- INDEX (created_at) + +**Relationships**: + +- Parent: users +- Referenced by: correspondence_attachments, circulation_attachments, shop_drawing_revision_attachments, contract_drawing_attachments + +**Business Rules**: + +- Central storage prevents file duplication +- Stored filename prevents naming conflicts +- File path points to QNAP NAS storage +- Original filename preserved for download +- One file record can be linked to multiple documents + +--- + +### 8.2 correspondence_attachments + +**Purpose**: Junction table linking correspondences to file attachments (M:N) + +| Column Name | Data Type | Constraints | Description | +| ----------------- | --------- | --------------- | ---------------------------- | +| correspondence_id | INT | PRIMARY KEY, FK | Reference to correspondences | +| attachment_id | INT | PRIMARY KEY, FK | Reference to attachments | +| is_main_document | BOOLEAN | DEFAULT FALSE | Main/primary document flag | + +**Indexes**: + +- PRIMARY KEY (correspondence_id, attachment_id) +- FOREIGN KEY (correspondence_id) REFERENCES correspondences(id) ON DELETE CASCADE +- FOREIGN KEY (attachment_id) REFERENCES attachments(id) ON DELETE CASCADE +- INDEX (attachment_id) +- INDEX (is_main_document) + +**Relationships**: + +- Parent: correspondences, attachments + +**Business Rules**: + +- One correspondence can have multiple attachments +- One attachment can be linked to multiple correspondences +- is_main_document identifies primary file (typically PDF) + +--- + +### 8.3 circulation_attachments + +**Purpose**: Junction table linking circulations to file attachments (M:N) + +| Column Name | Data Type | Constraints | Description | +| ---------------- | --------- | --------------- | -------------------------- | +| circulation_id | INT | PRIMARY KEY, FK | Reference to circulations | +| attachment_id | INT | PRIMARY KEY, FK | Reference to attachments | +| is_main_document | BOOLEAN | DEFAULT FALSE | Main/primary document flag | + +**Indexes**: + +- PRIMARY KEY (circulation_id, attachment_id) +- FOREIGN KEY (circulation_id) REFERENCES circulations(id) ON DELETE CASCADE +- FOREIGN KEY (attachment_id) REFERENCES attachments(id) ON DELETE CASCADE +- INDEX (attachment_id) +- INDEX (is_main_document) + +**Relationships**: + +- Parent: circulations, attachments + +--- + +### 8.4 shop_drawing_revision_attachments + +**Purpose**: Junction table linking shop drawing revisions to file attachments (M:N) + +| Column Name | Data Type | Constraints | Description | +| ------------------------ | --------- | --------------- | ---------------------------------- | +| shop_drawing_revision_id | INT | PRIMARY KEY, FK | Reference to shop drawing revision | +| attachment_id | INT | PRIMARY KEY, FK | Reference to attachments | +| file_type | ENUM | NULL | File type: PDF, DWG, SOURCE, OTHER | +| is_main_document | BOOLEAN | DEFAULT FALSE | Main/primary document flag | + +**Indexes**: + +- PRIMARY KEY (shop_drawing_revision_id, attachment_id) +- FOREIGN KEY (shop_drawing_revision_id) REFERENCES shop_drawing_revisions(id) ON DELETE CASCADE +- FOREIGN KEY (attachment_id) REFERENCES attachments(id) ON DELETE CASCADE +- INDEX (attachment_id) +- INDEX (file_type) +- INDEX (is_main_document) + +**Relationships**: + +- Parent: shop_drawing_revisions, attachments + +**Business Rules**: + +- file_type categorizes drawing file formats +- Typically includes PDF for viewing and DWG for editing +- SOURCE may include native CAD files + +--- + +### 8.5 contract_drawing_attachments + +**Purpose**: Junction table linking contract drawings to file attachments (M:N) + +| Column Name | Data Type | Constraints | Description | +| ------------------- | --------- | --------------- | ---------------------------------- | +| contract_drawing_id | INT | PRIMARY KEY, FK | Reference to contract drawing | +| attachment_id | INT | PRIMARY KEY, FK | Reference to attachments | +| file_type | ENUM | NULL | File type: PDF, DWG, SOURCE, OTHER | +| is_main_document | BOOLEAN | DEFAULT FALSE | Main/primary document flag | + +**Indexes**: + +- PRIMARY KEY (contract_drawing_id, attachment_id) +- FOREIGN KEY (contract_drawing_id) REFERENCES contract_drawings(id) ON DELETE CASCADE +- FOREIGN KEY (attachment_id) REFERENCES attachments(id) ON DELETE CASCADE +- INDEX (attachment_id) +- INDEX (file_type) +- INDEX (is_main_document) + +**Relationships**: + +- Parent: contract_drawings, attachments + +--- + +## **9. 🔢 Document Numbering Tables (การสร้างเลขที่เอกสาร)** + +### 9.1 document_number_formats + +**Purpose**: Master table defining document numbering templates per project and type + +| Column Name | Data Type | Constraints | Description | +| ---------------------- | ------------ | ----------------------------------- | -------------------------------------------------------- | +| id | INT | PRIMARY KEY, AUTO_INCREMENT | Unique format ID | +| project_id | INT | NOT NULL, FK | Reference to projects | +| correspondence_type_id | INT | NOT NULL, FK | Reference to correspondence types | +| format_template | VARCHAR(255) | NOT NULL | Template string (e.g., '{ORG_CODE}-{TYPE_CODE}-{SEQ:4}') | +| description | TEXT | NULL | Format description | +| created_at | TIMESTAMP | DEFAULT CURRENT_TIMESTAMP | Record creation timestamp | +| updated_at | TIMESTAMP | DEFAULT CURRENT_TIMESTAMP ON UPDATE | Last update timestamp | + +**Indexes**: + +- PRIMARY KEY (id) +- FOREIGN KEY (project_id) REFERENCES projects(id) ON DELETE CASCADE +- FOREIGN KEY (correspondence_type_id) REFERENCES correspondence_types(id) ON DELETE CASCADE +- UNIQUE KEY (project_id, correspondence_type_id) +- INDEX (project_id) +- INDEX (correspondence_type_id) + +**Relationships**: + +- Parent: projects, correspondence_types + +**Business Rules**: + +- One format template per project per correspondence type combination +- Template placeholders: {ORG_CODE}, {TYPE_CODE}, {YEAR}, {SEQ:n} where n is zero-padding length +- Used by document numbering module to generate unique document numbers + +--- + +### 9.2 document_number_counters + +**Purpose**: Transaction table maintaining running sequence numbers for document numbering + +| Column Name | Data Type | Constraints | Description | +| -------------------------- | --------- | --------------- | --------------------------------- | +| project_id | INT | PRIMARY KEY, FK | Reference to projects | +| originator_organization_id | INT | PRIMARY KEY, FK | Originating organization | +| correspondence_type_id | INT | PRIMARY KEY, FK | Reference to correspondence types | +| current_year | INT | PRIMARY KEY | Year (Buddhist calendar) | +| last_number | INT | DEFAULT 0 | Last assigned sequence number | + +**Indexes**: + +- PRIMARY KEY (project_id, originator_organization_id, correspondence_type_id, current_year) +- FOREIGN KEY (project_id) REFERENCES projects(id) ON DELETE CASCADE +- FOREIGN KEY (originator_organization_id) REFERENCES organizations(id) ON DELETE CASCADE +- FOREIGN KEY (correspondence_type_id) REFERENCES correspondence_types(id) ON DELETE CASCADE +- INDEX (project_id) +- INDEX (originator_organization_id) +- INDEX (correspondence_type_id) +- INDEX (current_year) + +**Relationships**: + +- Parent: projects, organizations, correspondence_types + +**Business Rules**: + +- Composite primary key ensures unique counters per project/organization/type/year +- Counter resets each year +- Thread-safe increments handled by stored procedure sp_get_next_document_number +- last_number tracks highest assigned number +- Used with document_number_formats to generate complete document numbers + +--- + +## **10. ⚙️ System & Logs Tables (ระบบและ Log)** + +### 10.1 audit_logs + +**Purpose**: Comprehensive audit trail for all significant system actions + +| Column Name | Data Type | Constraints | Description | +| ------------ | ------------ | --------------------------- | ------------------------------------------------------ | +| audit_id | BIGINT | PRIMARY KEY, AUTO_INCREMENT | Unique audit log ID | +| user_id | INT | NULL, FK | User who performed action | +| action | VARCHAR(100) | NOT NULL | Action code (e.g., 'rfa.create', 'login.success') | +| entity_type | VARCHAR(50) | NULL | Entity/module affected (e.g., 'rfa', 'correspondence') | +| entity_id | VARCHAR(50) | NULL | Primary ID of affected record | +| details_json | JSON | NULL | Additional context/details in JSON format | +| ip_address | VARCHAR(45) | NULL | Client IP address (supports IPv6) | +| user_agent | VARCHAR(255) | NULL | Browser user agent string | +| created_at | TIMESTAMP | DEFAULT CURRENT_TIMESTAMP | Action timestamp | + +**Indexes**: + +- PRIMARY KEY (audit_id) +- FOREIGN KEY (user_id) REFERENCES users(user_id) ON DELETE SET NULL +- INDEX (user_id) +- INDEX (action) +- INDEX (entity_type, entity_id) +- INDEX (created_at) +- INDEX (ip_address) + +**Relationships**: + +- Parent: users + +**Business Rules**: + +- Immutable records (no updates/deletes) +- Captures all CRUD operations on sensitive data +- Includes authentication events (login, logout, failed attempts) +- JSON details field for flexible data storage +- Retention policy: typically 7 years for compliance +- Used for security audits, compliance reporting, and troubleshooting + +**Common Actions**: + +- Authentication: login.success, login.failed, logout +- Documents: correspondence.create, correspondence.update, rfa.submit +- Users: user.create, user.deactivate, role.assign +- Workflow: rfa.approve, rfa.reject, circulation.complete + +--- + +### 10.2 notifications + +**Purpose**: User notification queue for email, LINE, and in-system alerts + +| Column Name | Data Type | Constraints | Description | +| ----------------- | ------------ | --------------------------- | ------------------------------------------------ | +| id | INT | PRIMARY KEY, AUTO_INCREMENT | Unique notification ID | +| user_id | INT | NOT NULL, FK | Recipient user ID | +| title | VARCHAR(255) | NOT NULL | Notification title/subject | +| message | TEXT | NOT NULL | Notification message body | +| notification_type | ENUM | NOT NULL | Type: EMAIL, LINE, SYSTEM | +| is_read | BOOLEAN | DEFAULT FALSE | Read status flag | +| entity_type | VARCHAR(50) | NULL | Related entity type (e.g., 'rfa', 'circulation') | +| entity_id | INT | NULL | Related entity ID | +| created_at | TIMESTAMP | DEFAULT CURRENT_TIMESTAMP | Notification creation timestamp | + +**Indexes**: + +- PRIMARY KEY (id) +- FOREIGN KEY (user_id) REFERENCES users(user_id) ON DELETE CASCADE +- INDEX (user_id) +- INDEX (notification_type) +- INDEX (is_read) +- INDEX (entity_type, entity_id) +- INDEX (created_at) +- COMPOSITE INDEX (user_id, is_read, created_at) - For user notification listing + +**Relationships**: + +- Parent: users + +**Business Rules**: + +- EMAIL: Sent via SMTP to user's email address +- LINE: Sent via LINE Notify API to user's LINE ID +- SYSTEM: In-app notifications displayed in user interface +- Same notification can trigger multiple types (EMAIL + SYSTEM) +- entity_type/entity_id allow deep-linking to related records +- is_read flag only applicable for SYSTEM notifications +- Auto-cleanup: delete read notifications older than 30 days + +**Common Notification Triggers**: + +- Task assignment (circulation routing, RFA workflow) +- Document status changes (submitted, approved, rejected) +- Approaching deadlines +- System announcements +- Mention in comments + +--- + +### 10.3 search_indices + +**Purpose**: Full-text search index for document content + +| Column Name | Data Type | Constraints | Description | +| ----------- | ----------- | --------------------------- | ------------------------------------------- | +| id | INT | PRIMARY KEY, AUTO_INCREMENT | Unique index ID | +| entity_type | VARCHAR(50) | NOT NULL | Entity type (e.g., 'correspondence', 'rfa') | +| entity_id | INT | NOT NULL | Entity primary ID | +| content | TEXT | NOT NULL | Searchable text content | +| indexed_at | TIMESTAMP | DEFAULT CURRENT_TIMESTAMP | Last indexing timestamp | + +**Indexes**: + +- PRIMARY KEY (id) +- INDEX (entity_type, entity_id) +- INDEX (indexed_at) +- FULLTEXT INDEX (content) - Enables full-text searching + +**Business Rules**: + +- Automatically populated/updated when documents change +- Content includes: title, description, document number, metadata +- May include OCR text from PDF attachments (future enhancement) +- Used by advanced search functionality +- Periodic re-indexing to catch missed updates +- Supports Boolean operators, phrase searching + +**Search Features**: + +- Natural language queries +- Wildcard support (\*, ?) +- Boolean operators (AND, OR, NOT) +- Phrase matching with quotes +- Result ranking by relevance + +--- + +### 10.4 backup_logs + +**Purpose**: Log table tracking database and file backup operations + +| Column Name | Data Type | Constraints | Description | +| ------------- | ------------ | --------------------------- | ---------------------------------- | +| id | INT | PRIMARY KEY, AUTO_INCREMENT | Unique backup log ID | +| backup_type | ENUM | NOT NULL | Type: DATABASE, FILES, FULL | +| backup_path | VARCHAR(500) | NOT NULL | Path to backup file/directory | +| file_size | BIGINT | NULL | Backup file size in bytes | +| status | ENUM | NOT NULL | Status: STARTED, COMPLETED, FAILED | +| started_at | TIMESTAMP | DEFAULT CURRENT_TIMESTAMP | Backup start timestamp | +| completed_at | TIMESTAMP | NULL | Backup completion timestamp | +| error_message | TEXT | NULL | Error details if failed | + +**Indexes**: + +- PRIMARY KEY (id) +- INDEX (backup_type) +- INDEX (status) +- INDEX (started_at) +- INDEX (completed_at) + +**Business Rules**: + +- DATABASE: MariaDB dump of database schema and data +- FILES: Backup of attachment files from QNAP storage +- FULL: Complete system backup (database + files) +- Triggered by n8n cron jobs +- Backup retention policy defined in backup strategy +- Failed backups trigger alert notifications +- completed_at - started_at = backup duration + +**Monitoring**: + +- Alert if no successful backup in 24 hours +- Track backup size trends over time +- Verify backup integrity with test restores + +--- + +## **11. 📊 Views & Procedures (วิว และ โปรซีเดอร์)** + +### 11.1 v_current_correspondences + +**Purpose**: View showing current revision of all non-RFA correspondences + +**Columns**: + +- correspondence_id, correspondence_number, correspondence_type_id/code/name +- project_id/code/name +- originator_id/code/name +- revision_id, revision_number, revision_label +- title, document_date, issued_date, received_date, due_date +- correspondence_status_id/code/name +- created_by, created_by_username, revision_created_at + +**Filters**: + +- is_current = TRUE (only latest revision) +- correspondence_type NOT IN ('RFA') (excludes RFAs) +- deleted_at IS NULL (excludes soft-deleted records) + +**Business Rules**: + +- Provides flattened view of current correspondence state +- Joins correspondence_revisions with is_current flag +- Used by dashboard, document listing screens +- Excludes RFAs (they have separate view) + +--- + +### 11.2 v_current_rfas + +**Purpose**: View showing current revision of all RFA documents + +**Columns**: + +- rfa_id, rfa_type_id/code/name +- correspondence_id, correspondence_number +- project_id/code/name +- originator_id/name +- revision_id, revision_number, revision_label +- title, document_date, issued_date, received_date, approved_date +- rfa_status_code_id/code/name +- rfa_approve_code_id/code/name +- created_by, created_by_username, revision_created_at + +**Filters**: + +- is_current = TRUE +- deleted_at IS NULL (both rfas and correspondences) + +**Business Rules**: + +- Specialized view for RFA documents +- Includes RFA-specific fields (approval codes, approved date) +- Joins across rfas → rfa_revisions → correspondences +- Used by RFA management screens + +--- + +### 11.3 v_contract_parties_all + +**Purpose**: View showing all organization relationships across contracts and projects + +**Columns**: + +- contract_id/code/name +- project_id/code/name +- organization_id/code/name +- role_in_contract + +**Business Rules**: + +- Joins contracts → projects → contract_organizations → organizations +- Shows only active contracts (is_active = TRUE) +- Used for permission checks and document routing +- Supports multi-organization projects/contracts + +--- + +### 11.4 v_user_tasks + +**Purpose**: View showing pending tasks assigned to users (action items) + +**Columns**: + +- routing_id, circulation_id, circulation_no, circulation_subject +- correspondence_id, correspondence_number +- project_id/code/name +- user_id, username, first_name, last_name +- organization_id/name +- step_number, task_status, comments +- completed_at, assigned_at, circulation_created_at + +**Filters**: + +- status IN ('PENDING', 'IN_PROGRESS') +- assigned_to IS NOT NULL + +**Business Rules**: + +- Shows circulation routings requiring user action +- Used for "My Tasks" / "Inbox" functionality +- Excludes completed/cancelled tasks +- Ordered by creation date (oldest first) + +--- + +### 11.5 v_audit_log_details + +**Purpose**: View enriching audit logs with user information + +**Columns**: + +- audit_id, user_id, username, email, first_name, last_name +- action, entity_type, entity_id +- details_json, ip_address, user_agent +- created_at + +**Business Rules**: + +- Joins audit_logs with users table +- Used for audit trail reports +- Includes user details even if user later deleted (LEFT JOIN) + +--- + +### 11.6 v_user_all_permissions + +**Purpose**: View showing all effective permissions for users across all scopes + +**Columns**: + +- user_id, role_id, role_name +- permission_id, permission_name +- module, scope_level +- organization_id, project_id, contract_id +- permission_scope (GLOBAL, ORGANIZATION, PROJECT, CONTRACT) + +**Business Rules**: + +- UNION of permissions from Global, Organization, Project, and Contract scopes +- Used for authorization checks +- Considers role-permission mappings at all levels +- Only shows active permissions (is_active = 1) +- One row per user-permission-scope combination + +**Usage Example**: + +```sql +SELECT permission_name +FROM v_user_all_permissions +WHERE user_id = ? + AND project_id = ? + AND permission_name = 'document.edit'; +``` + +--- + +### 11.7 v_documents_with_attachments + +**Purpose**: View showing all documents and their attachment counts + +**Columns**: + +- document_type (CORRESPONDENCE, CIRCULATION, SHOP_DRAWING, CONTRACT_DRAWING) +- document_id, document_number +- project_id/code/name +- attachment_count, latest_attachment_date + +**Business Rules**: + +- UNION of all document types with attachments +- Used for document listing with file indicators +- Helps identify documents missing attachments +- Aggregates count per document + +--- + +### 11.8 v_document_statistics + +**Purpose**: View providing aggregated document statistics by project, type, and status + +**Columns**: + +- project_id/code/name +- correspondence_type_id/code/name +- status_id/code/name +- document_count, revision_count + +**Business Rules**: + +- CROSS JOIN creates all possible combinations +- LEFT JOIN shows zeros for combinations with no documents +- Only includes active projects, types, and statuses +- Used for dashboard charts and reports +- Groups by project → type → status + +--- + +### 11.9 sp_get_next_document_number + +**Purpose**: Stored procedure to safely generate next sequential document number + +**Parameters**: + +- IN p_project_id INT +- IN p_originator_organization_id INT +- IN p_correspondence_type_id INT +- IN p_current_year INT +- OUT p_next_number INT + +**Logic**: + +1. Start transaction +2. SELECT last_number FOR UPDATE (locks row) +3. If record doesn't exist, INSERT with last_number = 1 +4. Else UPDATE last_number = last_number + 1 +5. Return new number via OUT parameter +6. COMMIT transaction + +**Business Rules**: + +- Thread-safe counter increment +- FOR UPDATE lock prevents race conditions +- Handles first-time counter initialization +- Rolls back on any error +- Must be called within document creation transaction +- Used in conjunction with document_number_formats template + +**Usage Example**: + +```sql +CALL sp_get_next_document_number( + 1, -- project_id + 10, -- organization_id + 1, -- type_id (RFA) + 2568, -- Buddhist year + @next_number +); +-- @next_number now contains next sequence +``` + +--- + +## Database Indexes Summary + +### Performance Optimization Indexes + +**Primary Indexes** (automatic with PRIMARY KEY): + +- All tables have PRIMARY KEY with AUTO_INCREMENT + +**Foreign Key Indexes** (automatic with FOREIGN KEY): + +- All FK relationships automatically indexed + +**Additional Performance Indexes**: + +1. **Correspondence Tables**: + + - `idx_correspondences_type_project` on (correspondence_type_id, project_id) + - `idx_corr_revisions_current_status` on (is_current, correspondence_status_id) + - `idx_corr_revisions_correspondence_current` on (correspondence_id, is_current) + - `idx_correspondences_project_type` on (project_id, correspondence_type_id) + +2. **RFA Tables**: + + - `idx_rfa_revisions_current_status` on (is_current, rfa_status_code_id) + - `idx_rfa_revisions_rfa_current` on (rfa_id, is_current) + +3. **Circulation Tables**: + + - `idx_circulation_routings_status_assigned` on (status, assigned_to) + - `idx_circulation_routings_circulation_status` on (circulation_id, status) + +4. **Document Numbering**: + + - `idx_doc_counter_composite` on (project_id, originator_organization_id, correspondence_type_id, current_year) + +5. **Audit & Notifications**: + + - `idx_audit_logs_reporting` on (created_at, entity_type, action) + - `idx_notifications_user_unread` on (user_id, is_read, created_at) + +6. **Search**: + - `FULLTEXT idx_search_indices_content` on (content) + +--- + +## Data Integrity Constraints + +### Foreign Key Constraints + +**Cascade Delete**: + +- Parent-child relationships where child should be deleted with parent +- Examples: correspondence_revisions, shop_drawing_revisions, project/contract relationships + +**Restrict Delete**: + +- Prevents deletion if references exist +- Examples: correspondence_types, rfa_status_codes, organizations (when referenced) + +**Set NULL**: + +- Preserves record but removes reference +- Examples: originator_id, created_by, updated_by + +### Unique Constraints + +1. **Globally Unique**: + + - usernames, emails + - shop_drawing.drawing_number + +2. **Unique Within Scope**: + + - (project_id, correspondence_number) + - (project_id, condwg_no) + - (correspondence_id, revision_number) + - (rfa_id, revision_number) + +3. **Composite Unique**: + - (correspondence_id, is_current) - ensures only one current revision + - (project_id, correspondence_type_id) - in document_number_formats + +### Check Constraints + +1. **user_assignments.chk_scope**: + - Ensures only one scope field (organization_id, project_id, contract_id) is NOT NULL + - OR all are NULL for Global scope + +### Business Rule Constraints + +1. **Soft Delete Pattern**: + + - deleted_at timestamp instead of hard delete + - Preserves audit trail and relationships + - Applied to: correspondences, rfas, shop_drawings, contract_drawings + +2. **Current Revision Pattern**: + + - is_current flag with UNIQUE constraint + - Ensures only one current revision per document + +3. **Sequential Numbering**: + - revision_number starts at 0, increments by 1 + - Enforced by application logic + stored procedure + +--- + +## Security & Permissions Model + +### Access Control Hierarchy + +```tree +Global Scope (Superadmin) + └── Organization Scope (Org Admin, Document Control) + └── Project Scope (Project Manager) + └── Contract Scope (Contract Admin) +``` + +### Permission Inheritance + +- Users can have multiple role assignments at different scopes +- More specific scopes inherit access from broader scopes +- Permission checks evaluate all applicable scopes +- View v_user_all_permissions aggregates effective permissions + +### Role-Based Access Control (RBAC) + +**7 Predefined Roles**: + +1. Superadmin (Global) - Full system access +2. Org Admin (Organization) - Organization management +3. Document Control (Organization) - Document lifecycle + admin powers +4. Editor (Organization) - Document CRUD +5. Viewer (Organization) - Read-only +6. Project Manager (Project) - Project + document management +7. Contract Admin (Contract) - Contract-specific management + +### Permission Categories (49 total) + +1. **System Management** (1): Full system control +2. **Organization Management** (4): CRUD on organizations +3. **Project Management** (8): CRUD + member/contract management +4. **Role & Permission Management** (4): RBAC administration +5. **Master Data Management** (4): Document types, categories, tags +6. **User Management** (5): User CRUD + organization assignment +7. **Contract Management** (2): Contract administration +8. **Document Management** (16): Full document lifecycle +9. **Workflow Management** (3): Approval workflow control +10. **Search & Reporting** (2): Advanced search, report generation + +--- + +## Data Migration & Seeding + +### Pre-populated Master Data + +1. **organization_roles**: Not used in current implementation +2. **organizations**: 15 organizations (Owner, Consultants, Contractors, Third parties) +3. **projects**: 5 projects (LCBP3 + 4 sub-contracts) +4. **contracts**: 7 contracts +5. **users**: 3 initial users (superadmin, editor01, viewer01) +6. **roles**: 7 predefined roles +7. **permissions**: 49 system permissions +8. **role_permissions**: Complete permission mappings +9. **project_organizations**: Project-organization relationships +10. **contract_organizations**: Contract-organization-role relationships +11. **correspondence_types**: 10 types +12. **correspondence_status**: 23 status codes +13. **rfa_types**: 11 types +14. **rfa_status_codes**: 7 statuses +15. **rfa_approve_codes**: 8 approval codes +16. **circulation_status_codes**: 4 statuses + +### Initial Passwords + +All seed users have password: `password123` + +- Hashed as: `$2y$10$0kjBMxWq7E4G7P.dc8r5i.cjiPBiup553AsFpDfxUt31gKg9h/udq` +- **Must be changed on first login in production** + +--- + +## Backup & Recovery Strategy + +### Database Backup + +**Strategy**: + +- Daily full database backups +- Hourly incremental backups (transaction logs) +- Retention: 30 days online, 7 years archived + +**Backup Method**: + +- MariaDB mysqldump for logical backups +- MariaDB Backup (Mariabackup) for physical backups +- Automated via n8n cron workflows + +### File Backup + +**Strategy**: + +- Daily backup of /share/dms-data/ directory +- QNAP snapshot every 4 hours +- Offsite replication to secondary NAS + +**File Organization**: + +```tree +/share/dms-data/ + ├── attachments/ + │ ├── 2025/ + │ │ ├── 01/ + │ │ │ └── {uuid}-{filename} + │ │ └── 02/ + │ └── 2024/ + └── temp/ +``` + +### Recovery Procedures + +1. **Point-in-Time Recovery**: Using transaction logs +2. **Full Restore**: From latest full backup +3. **Selective Restore**: Individual tables or records +4. **File Recovery**: From QNAP snapshots or backup + +--- + +## Performance Optimization + +### Query Optimization + +1. **Use Indexed Columns**: WHERE, JOIN, ORDER BY clauses +2. **Avoid SELECT \***: Specify needed columns +3. **Use Views**: For complex, frequently-used queries +4. **Limit Result Sets**: Use LIMIT and pagination +5. **Analyze Slow Queries**: Enable slow query log + +### Index Maintenance + +```sql +-- Check index usage +SELECT * FROM information_schema.STATISTICS +WHERE TABLE_SCHEMA = 'lcbp3'; + +-- Optimize tables +OPTIMIZE TABLE correspondences; + +-- Analyze tables +ANALYZE TABLE correspondences; +``` + +### Connection Pooling + +- Backend uses connection pool (NestJS TypeORM) +- Min pool size: 5 +- Max pool size: 20 +- Idle timeout: 10 minutes + +--- + +## Data Validation Rules + +### Required Fields Validation + +**At Application Level**: + +- Email format validation +- Date range validation (start_date < end_date) +- File size limits (5MB per attachment) +- File type restrictions (PDF, DWG, DOC, XLS, images) + +**At Database Level**: + +- NOT NULL constraints +- UNIQUE constraints +- Foreign key constraints +- Check constraints (user_assignments scope) + +### Business Logic Validation + +1. **Document Workflow**: + + - Cannot edit submitted documents (unless Document Control) + - Cannot skip workflow steps (unless forced) + - Must provide approval comments + +2. **User Management**: + + - Cannot delete users with active assignments + - Cannot deactivate own account + - Must have valid organization for non-Global roles + +3. **File Management**: + - Original filename preserved for audit + - Unique stored filename prevents conflicts + - File path must exist and be accessible + +--- + +## Change Log & Versioning + +### Database Version: v1.4.0 + +**Changes from v1.3.0**: + +- Added comprehensive RBAC system (roles, permissions, user_assignments) +- Refactored organization-project-contract relationships +- Added junction tables for M:N relationships +- Implemented soft delete pattern +- Added full-text search support +- Enhanced audit logging with JSON details +- Added circulation workflow templates +- Improved document numbering with stored procedure +- Added comprehensive views for common queries +- Optimized indexes for performance + +**Migration Path**: + +- v1.3.0 → v1.4.0: Run migration script (not provided in this excerpt) +- Backup database before migration +- Test migration on staging environment first + +--- + +## Technical Specifications + +### Database Configuration + +**MariaDB Server**: + +- Version: 10.11 +- Character Set: utf8mb4 +- Collation: utf8mb4_general_ci +- Time Zone: +07:00 (Bangkok/Asia) +- SQL Mode: STRICT_TRANS_TABLES, NO_ENGINE_SUBSTITUTION + +**Connection Settings**: + +- Host: Container on QNAP TS-473A +- Port: 3306 (default) +- Max Connections: 100 +- Max Packet Size: 64MB + +### Table Engine + +**InnoDB Features Used**: + +- ACID compliance +- Foreign key constraints +- Row-level locking +- Crash recovery +- Transaction support + +### Storage Requirements + +**Estimated Initial Size**: + +- Database: ~50 MB (with seed data) +- Indexes: ~20 MB +- Total: ~70 MB + +**Growth Estimates**: + +- 1,000 documents/month: +100 MB/month (database) +- 10 attachments/document @ 2MB avg: +20 GB/month (files) +- Plan for 1TB+ storage within first year + +--- + +## Application Integration + +### Backend (NestJS) + +**TypeORM Entities**: + +- One entity class per table +- Decorators for columns, relationships +- DTOs for data transfer +- Repositories for data access + +**Key Modules**: + +- AuthModule: Authentication, authorization +- DocumentsModule: Correspondence, RFA management +- DrawingsModule: Shop drawing, contract drawing +- WorkflowModule: Circulation, approval workflows +- FilesModule: Attachment management +- UsersModule: User, role, permission management + +### Frontend (Next.js) + +**Key Features**: + +- Document listing/search +- Document creation wizards +- Workflow approval interface +- File upload/download +- User management console +- Dashboard analytics + +### Integration Points + +1. **Document Numbering**: + + - Call sp_get_next_document_number + - Format with template from document_number_formats + - Store in correspondences.correspondence_number + +2. **File Upload**: + + - Upload to QNAP /share/dms-data/ + - Create attachment record + - Link via junction table + +3. **Workflow Execution**: + + - Check rfa_workflow_templates + - Create rfa_workflows records + - Update status as steps complete + - Send notifications + +4. **Permission Checks**: + - Query v_user_all_permissions + - Cache results per session + - Re-check on sensitive operations + +--- + +## Monitoring & Maintenance + +### Health Checks + +```sql +-- Database size +SELECT + table_schema, + SUM(data_length + index_length) / 1024 / 1024 AS size_mb +FROM information_schema.TABLES +WHERE table_schema = 'dms_db' +GROUP BY table_schema; + +-- Table sizes +SELECT + table_name, + (data_length + index_length) / 1024 / 1024 AS size_mb, + table_rows +FROM information_schema.TABLES +WHERE table_schema = 'dms_db' +ORDER BY (data_length + index_length) DESC; + +-- Active connections +SHOW PROCESSLIST; + +-- Lock wait statistics +SELECT * FROM information_schema.INNODB_LOCK_WAITS; +``` + +### Scheduled Maintenance + +**Daily**: + +- Full database backup +- Check backup log for failures +- Monitor disk space + +**Weekly**: + +- OPTIMIZE tables +- ANALYZE tables +- Review slow query log +- Check for deadlocks + +**Monthly**: + +- Review audit logs +- Clean up old notifications (30+ days) +- Archive old audit logs (7+ years) +- Verify backup integrity (test restore) + +**Quarterly**: + +- Review and optimize indexes +- Update database statistics +- Capacity planning review + +--- + +## Glossary + +**Terms**: + +- **Correspondence**: Any formal document exchanged between parties +- **RFA**: Request for Approval - formal submittal for review/approval +- **Circulation**: Internal document routing workflow +- **Transmittal**: Cover sheet for forwarding multiple documents +- **Shop Drawing**: Detailed construction drawing from contractor +- **Contract Drawing**: Baseline drawing from contract specifications +- **Revision**: Version of a document +- **Originator**: Organization that creates/sends a document +- **Recipient**: Organization that receives a document (TO or CC) +- **Scope**: Level of permission application (Global, Organization, Project, Contract) + +**Acronyms**: + +- **DMS**: Document Management System +- **LCBP3**: Laem Chabang Port Phase 3 +- **RBAC**: Role-Based Access Control +- **RFA**: Request for Approval +- **RFI**: Request for Information +- **CSC**: Construction Supervision Consultant +- **TO**: Primary recipient (action required) +- **CC**: Carbon copy (for information) +- **QNAP**: Network Attached Storage device manufacturer + +--- + +**Document Control**: + +- Document: Data Dictionary - DMS v1.4.0 +- Version: 1.0 +- Date: 2025-01-XX +- Author: System Architecture Team +- Status: FINAL +- Classification: Internal Technical Documentation + +--- + +_End of Data Dictionary diff --git a/docs/LCBP3-DMS_V1_4_0_Frontend_Development_Plan.md b/docs/LCBP3-DMS_V1_4_0_Frontend_Development_Plan.md new file mode 100644 index 0000000..5de23e4 --- /dev/null +++ b/docs/LCBP3-DMS_V1_4_0_Frontend_Development_Plan.md @@ -0,0 +1,833 @@ +# 📋 แผนการพัฒนา Frontend (NestJS) - LCBP3-DMS v1.4.0 + +# 📋 แผนการพัฒนา Frontend (Next.js) - LCBP3-DMS v1.4.0 + +## 🎯 ภาพรวมโครงการ + +พัฒนา Frontend สำหรับระบบบริหารจัดการเอกสารโครงการ (Document Management System) ที่ทันสมัย responsive และใช้งานง่าย รองรับการจัดการเอกสารที่ซับซ้อน มี Dashboard แบบ Real-time และระบบ Workflow Visualization + +--- + +## 📐 สถาปัตยกรรมระบบ + +### Technology Stack + +- **Framework:** Next.js 14+ (App Router, React 18+, TypeScript, ESM) +- **Styling:** Tailwind CSS + PostCSS +- **Component Library:** shadcn/ui (Radix UI) +- **State Management:** + - **Server State:** TanStack Query (React Query) + - **Global Client State:** Zustand + - **Form State:** React Hook Form + Zod +- **Data Fetching:** Axios + TanStack Query +- **Authentication:** NextAuth.js (JWT Strategy) +- **File Upload:** React Dropzone +- **Tables:** TanStack Table +- **Charts:** Recharts +- **Date Picker:** date-fns + shadcn/ui Calendar +- **Icons:** Lucide React +- **Testing:** + - **Unit/Integration:** Vitest + React Testing Library + - **E2E:** Playwright + - **API Mocking:** Mock Service Worker (MSW) + +### โครงสร้างโปรเจกต์ + +``` +app/ +├── (public)/ # Public routes (Landing, Login) +│ ├── page.tsx # Landing Page +│ └── login/ # Login Page +├── (protected)/ # Protected routes +│ ├── layout.tsx # App Shell (Navbar + Sidebar) +│ ├── dashboard/ # Dashboard +│ ├── correspondences/ # Correspondence Management +│ ├── rfas/ # RFA Management +│ ├── drawings/ # Drawing Management +│ ├── circulations/ # Circulation Management +│ ├── transmittals/ # Transmittal Management +│ ├── search/ # Advanced Search +│ ├── reports/ # Reports +│ ├── admin/ # Admin Panel +│ └── profile/ # User Profile +├── api/ # API Routes (if needed) +components/ +├── ui/ # shadcn/ui components +├── features/ # Feature-specific components +│ ├── auth/ +│ ├── correspondence/ +│ ├── rfa/ +│ ├── drawing/ +│ ├── circulation/ +│ └── common/ +└── layouts/ # Layout components +lib/ +├── api/ # API client & hooks +├── stores/ # Zustand stores +├── utils/ # Utility functions +├── hooks/ # Custom hooks +└── types/ # TypeScript types +public/ +├── images/ +└── fonts/ +``` + +--- + +## 🗓️ แผนการพัฒนาแบบ Phase-Based + +## **Phase 0: Setup & Infrastructure (สัปดาห์ที่ 1)** + +### Milestone: สร้างโครงสร้างพื้นฐานและ Development Environment + +#### Tasks: + +**T0.1 Initialize Next.js Project** + +- สร้างโปรเจกต์ด้วย `create-next-app`: + ```bash + npx create-next-app@latest lcbp3-frontend --typescript --tailwind --app --src-dir=false + ``` +- เลือก Options: + - ✅ TypeScript + - ✅ ESLint + - ✅ Tailwind CSS + - ✅ App Router + - ✅ Import alias (@/\*) +- Setup .gitignore, README.md +- Deliverable: ✅ โปรเจกต์เริ่มต้นพร้อม + +**T0.2 Install Core Dependencies** + +```bash +# State Management & Data Fetching +npm install @tanstack/react-query zustand +npm install axios +npm install react-hook-form @hookform/resolvers zod + +# UI Components & Styling +npm install clsx tailwind-merge +npm install lucide-react +npm install date-fns + +# File Upload +npm install react-dropzone + +# Authentication +npm install next-auth + +# Development Tools +npm install -D @types/node +``` + +- Deliverable: ✅ Dependencies ติดตั้งสมบูรณ์ + +**T0.3 Setup shadcn/ui** + +```bash +npx shadcn-ui@latest init +``` + +- เลือก Style: Default +- เลือก Base Color: Slate +- ติดตั้ง Components เบื้องต้น: + ```bash + npx shadcn-ui@latest add button input label card table dropdown-menu + npx shadcn-ui@latest add dialog sheet toast alert + npx shadcn-ui@latest add form select textarea checkbox + npx shadcn-ui@latest add calendar popover + ``` +- Deliverable: ✅ shadcn/ui พร้อมใช้งาน + +**T0.4 Configure Tailwind CSS** + +- แก้ไข `tailwind.config.ts`: + - เพิ่ม Custom Colors (ตาม Brand) + - เพิ่ม Custom Fonts (ภาษาไทย: Noto Sans Thai) + - Configure Container, Spacing +- สร้าง `app/globals.css` พร้อม Custom Styles +- Deliverable: ✅ Tailwind พร้อมใช้ + +**T0.5 Setup Development Environment** + +- สร้าง `.env.local`: + ``` + NEXT_PUBLIC_API_URL=http://backend.np-dms.work/api + NEXTAUTH_URL=http://localhost:3000 + NEXTAUTH_SECRET=... + ``` +- Setup ESLint Rules (ไทย Comments OK) +- Setup Prettier +- Setup VS Code Settings +- Deliverable: ✅ Dev Environment พร้อม + +**T0.6 Setup Git & Docker** + +- Push โปรเจกต์ไปยัง Gitea (git.np-dms.work) +- สร้าง Dockerfile สำหรับ Next.js: + ```dockerfile + FROM node:20-alpine + WORKDIR /app + COPY package*.json ./ + RUN npm ci + COPY . . + RUN npm run build + EXPOSE 3000 + CMD ["npm", "start"] + ``` +- สร้าง docker-compose.yml (เชื่อม Network `lcbp3`) +- Deliverable: ✅ Project อยู่ใน Git + Docker พร้อม + +--- + +## **Phase 1: Authentication & App Shell (สัปดาห์ที่ 2-3)** + +### Milestone: ระบบ Login และ Layout หลัก + +#### Tasks: + +**T1.1 Setup API Client** + +- สร้าง `lib/api/client.ts`: + + ```typescript + import axios from "axios"; + + export const apiClient = axios.create({ + baseURL: process.env.NEXT_PUBLIC_API_URL, + headers: { + "Content-Type": "application/json", + }, + }); + + // Request Interceptor (Add JWT Token) + apiClient.interceptors.request.use((config) => { + const token = localStorage.getItem("access_token"); + if (token) { + config.headers.Authorization = `Bearer ${token}`; + } + return config; + }); + + // Response Interceptor (Handle Errors) + apiClient.interceptors.response.use( + (response) => response, + (error) => { + if (error.response?.status === 401) { + // Redirect to login + window.location.href = "/login"; + } + return Promise.reject(error); + } + ); + ``` + +- Deliverable: ✅ API Client พร้อมใช้ + +**T1.2 Setup TanStack Query** + +- สร้าง `app/providers.tsx`: + + ```typescript + "use client"; + import { QueryClient, QueryClientProvider } from "@tanstack/react-query"; + import { useState } from "react"; + + export function Providers({ children }: { children: React.ReactNode }) { + const [queryClient] = useState( + () => + new QueryClient({ + defaultOptions: { + queries: { + staleTime: 60 * 1000, // 1 minute + refetchOnWindowFocus: false, + }, + }, + }) + ); + + return ( + {children} + ); + } + ``` + +- Wrap ใน `app/layout.tsx` +- Deliverable: ✅ React Query พร้อม + +**T1.3 Create Auth Store (Zustand)** + +- สร้าง `lib/stores/auth-store.ts`: + + ```typescript + import { create } from "zustand"; + import { persist } from "zustand/middleware"; + + interface User { + user_id: number; + username: string; + email: string; + first_name: string; + last_name: string; + primary_organization_id: number; + permissions: string[]; + } + + interface AuthStore { + user: User | null; + token: string | null; + setAuth: (user: User, token: string) => void; + clearAuth: () => void; + hasPermission: (permission: string) => boolean; + } + + export const useAuthStore = create()( + persist( + (set, get) => ({ + user: null, + token: null, + setAuth: (user, token) => { + set({ user, token }); + localStorage.setItem("access_token", token); + }, + clearAuth: () => { + set({ user: null, token: null }); + localStorage.removeItem("access_token"); + }, + hasPermission: (permission) => { + const user = get().user; + return user?.permissions.includes(permission) || false; + }, + }), + { + name: "auth-storage", + } + ) + ); + ``` + +- Deliverable: ✅ Auth Store พร้อม + +**T1.4 Create Login Page** + +- สร้าง `app/(public)/login/page.tsx`: + + ```typescript + "use client"; + import { useForm } from "react-hook-form"; + import { zodResolver } from "@hookform/resolvers/zod"; + import * as z from "zod"; + import { Button } from "@/components/ui/button"; + import { Input } from "@/components/ui/input"; + import { useRouter } from "next/navigation"; + import { useAuthStore } from "@/lib/stores/auth-store"; + import { apiClient } from "@/lib/api/client"; + + const loginSchema = z.object({ + username: z.string().min(1, "กรุณากรอกชื่อผู้ใช้"), + password: z.string().min(1, "กรุณากรอกรหัสผ่าน"), + }); + + export default function LoginPage() { + const router = useRouter(); + const setAuth = useAuthStore((state) => state.setAuth); + const form = useForm({ + resolver: zodResolver(loginSchema), + }); + + const handleLogin = async (data: z.infer) => { + try { + const response = await apiClient.post("/auth/login", data); + const { access_token, user } = response.data; + setAuth(user, access_token); + router.push("/dashboard"); + } catch (error) { + console.error("Login failed:", error); + // แสดง Toast Error + } + }; + + return ( +
+
+ {/* Form Fields */} +
+
+ ); + } + ``` + +- Deliverable: ✅ หน้า Login พร้อม + +**T1.5 Create Landing Page** + +- สร้าง `app/(public)/page.tsx`: + - Hero Section พร้อมข้อมูลโครงการ + - Feature Highlights + - CTA Button → Login +- ใช้ Tailwind + Animations +- Deliverable: ✅ Landing Page สวยงาม + +**T1.6 Create Protected Layout (App Shell)** + +- สร้าง `app/(protected)/layout.tsx`: + + ```typescript + "use client"; + import { useEffect } from "react"; + import { useRouter } from "next/navigation"; + import { useAuthStore } from "@/lib/stores/auth-store"; + import Navbar from "@/components/layouts/navbar"; + import Sidebar from "@/components/layouts/sidebar"; + + export default function ProtectedLayout({ + children, + }: { + children: React.ReactNode; + }) { + const router = useRouter(); + const user = useAuthStore((state) => state.user); + + useEffect(() => { + if (!user) { + router.push("/login"); + } + }, [user, router]); + + if (!user) return null; + + return ( +
+ +
+ +
{children}
+
+
+ ); + } + ``` + +- Deliverable: ✅ App Shell พร้อม + +**T1.7 Create Navbar Component** + +- สร้าง `components/layouts/navbar.tsx`: + - แสดงชื่อระบบ + - แสดงชื่อผู้ใช้ + Avatar + - Dropdown Menu: + - Profile + - Settings + - Logout +- Responsive (Mobile Hamburger Menu) +- Deliverable: ✅ Navbar พร้อม + +**T1.8 Create Sidebar Component** + +- สร้าง `components/layouts/sidebar.tsx`: + - เมนูหลัก: + - Dashboard + - Correspondences + - RFAs + - Drawings (Shop & Contract) + - Circulations + - Transmittals + - Search + - Reports + - เมนู Admin (แสดงตามสิทธิ์): + - Users + - Roles & Permissions + - Master Data + - Document Numbering +- Collapsible Sidebar +- Active State Highlighting +- Deliverable: ✅ Sidebar พร้อม + +--- + +## **Phase 2: Dashboard & Common Components (สัปดาห์ที่ 4)** + +### Milestone: Dashboard และ Reusable Components + +#### Tasks: + +**T2.1 Create Reusable Components** + +- `components/features/common/data-table.tsx`: + - ใช้ TanStack Table + - รองรับ Pagination, Sorting, Filtering + - Responsive +- `components/features/common/file-upload.tsx`: + - ใช้ React Dropzone + - รองรับ Multi-file Upload + - Drag & Drop + - Progress Bar +- `components/features/common/status-badge.tsx`: + - แสดง Status แบบสีสัน (Draft, Submitted, Approved) +- `components/features/common/permission-guard.tsx`: + - ซ่อน/แสดง Component ตามสิทธิ์ +- Deliverable: ✅ Reusable Components พร้อม + +**T2.2 Create Dashboard Page** + +- สร้าง `app/(protected)/dashboard/page.tsx`: + - **KPI Cards Section**: + - จำนวนเอกสารทั้งหมด + - งานที่รอดำเนินการ + - เอกสารที่เกินกำหนด + - RFA ที่รออนุมัติ + - **My Tasks Table**: + - ดึงข้อมูลจาก `/api/circulations/my-tasks` (ใช้ `v_user_tasks`) + - แสดงรายการงานที่ต้องทำ (Pending, In Progress) + - Columns: Document Number, Title, Type, Status, Deadline, Actions + - คลิกแถวแล้วไปยังหน้า Detail + - **Recent Activity Feed**: + - ดึงข้อมูลจาก `/api/audit-logs/user/:userId` + - แสดง 10 รายการล่าสุด +- Deliverable: ✅ Dashboard ครบถ้วน + +**T2.3 Create API Hooks** + +- สร้าง `lib/api/hooks/use-my-tasks.ts`: + + ```typescript + import { useQuery } from "@tanstack/react-query"; + import { apiClient } from "../client"; + + export function useMyTasks() { + return useQuery({ + queryKey: ["my-tasks"], + queryFn: async () => { + const response = await apiClient.get("/circulations/my-tasks"); + return response.data; + }, + }); + } + ``` + +- สร้าง Hooks เพิ่มเติม: + - `use-dashboard-stats.ts` + - `use-recent-activity.ts` +- Deliverable: ✅ API Hooks พร้อม + +--- + +## **Phase 3: Correspondence Management (สัปดาห์ที่ 5-6)** + +### Milestone: ระบบจัดการเอกสารโต้ตอบ + +#### Tasks: + +**T3.1 Create Correspondence List Page** + +- สร้าง `app/(protected)/correspondences/page.tsx`: + - Data Table แสดงรายการเอกสาร + - Columns: + - Document Number (คลิกไปยัง Detail) + - Title + - Type + - Status (Badge) + - Originator + - Date + - Actions (View, Edit, Delete) + - Filters: + - ประเภทเอกสาร (Dropdown) + - สถานะ (Dropdown) + - วันที่ (Date Range Picker) + - องค์กร (Dropdown) + - Pagination (Server-side) + - Search Box + - Create Button (ตรวจสิทธิ์) +- Deliverable: ✅ หน้ารายการเอกสาร + +**T3.2 Create Correspondence Detail Page** + +- สร้าง `app/(protected)/correspondences/[id]/page.tsx`: + - **Header Section**: + - Document Number (ใหญ่) + - Status Badge + - Action Buttons: Edit, Delete, Export PDF + - **Metadata Section**: + - Title, Description + - Document Date, Issued Date, Received Date + - Originator, Recipients (TO/CC) + - Due Date (ถ้ามี) + - **Revision History**: + - แสดง Revisions ทั้งหมดเป็น Timeline + - แต่ละ Revision แสดง: Revision Number, Date, Changes, User + - **Attachments**: + - แสดงไฟล์แนบทั้งหมด + - กำหนดไฟล์หลัก (Main Document) ด้วยไอคอน + - ปุ่ม Download + - **References**: + - แสดงเอกสารที่อ้างถึง (Links) + - **Tags**: + - แสดง Tags แบบ Chips + - **Activity Log**: + - แสดง Audit Log ของเอกสารนี้ +- Deliverable: ✅ หน้า Detail ครบถ้วน + +**T3.3 Create Correspondence Form (Create/Edit)** + +- สร้าง `app/(protected)/correspondences/create/page.tsx`: +- สร้าง `app/(protected)/correspondences/[id]/edit/page.tsx`: +- Form Fields: + - **Basic Info**: + - Correspondence Type (Dropdown) + - Title (Text) + - Description (Textarea) + - Document Date (Date Picker) + - **Recipients**: + - TO: Multi-select Organizations + - CC: Multi-select Organizations + - **References**: + - Search & Select เอกสารอื่นๆ + - **Tags**: + - Autocomplete Tag Input + - **Attachments**: + - File Upload (Multi-file) + - กำหนด Main Document (Radio) + - **Deadline**: + - Due Date (Date Picker) +- Validation ด้วย Zod +- Submit → API → Redirect to Detail +- Deliverable: ✅ ฟอร์มสร้าง/แก้ไข + +**T3.4 Create Status Management** + +- ใน Detail Page เพิ่มปุ่ม Status Actions: + - **Draft → Submit** (Document Control) + - **Submit → Close** (Admin) + - **Submit → Cancel** (Admin + Dialog ให้กรอกเหตุผล) +- แสดง Confirmation Dialog ก่อนเปลี่ยนสถานะ +- Deliverable: ✅ เปลี่ยนสถานะได้ + +--- + +## **Phase 4: RFA & Workflow Visualization (สัปดาห์ที่ 7-8)** + +### Milestone: ระบบ RFA และ Workflow + +#### Tasks: + +**T4.1 Create RFA List Page** + +- สร้าง `app/(protected)/rfas/page.tsx`: + - คล้าย Correspondence List + - Columns เพิ่มเติม: + - RFA Type (DWG, DOC, MAT) + - Approval Status (Badge) + - Approval Code (1A, 3R, etc.) + - Filters: + - RFA Type + - Status + - Approval Code +- Deliverable: ✅ หน้ารายการ RFA + +**T4.2 Create RFA Detail Page** + +- สร้าง `app/(protected)/rfas/[id]/page.tsx`: + - คล้าย Correspondence Detail + - เพิ่ม Section: + - **Shop Drawings** (สำหรับ RFA_DWG): + - แสดงรายการ Shop Drawings ที่เชื่อมโยง + - แสดง Revision ของแต่ละแบบ + - Link ไปยัง Shop Drawing Detail + - **Workflow Visualization** (ดูรายละเอียดใน T4.3) +- Deliverable: ✅ หน้า Detail RFA + +**T4.3 Create Workflow Visualization Component** + +- สร้าง `components/features/rfa/workflow-visualizer.tsx`: + - **Layout**: Steps แนวนอน (Timeline) + - **Step States**: + - ✅ **Completed**: สีเขียว, ไอคอน Check + - ⏳ **Active**: สีฟ้า, ปุ่ม Action เปิดใช้งาน + - ⏸️ **Pending**: สีเทา, ปุ่ม disabled + - ❌ **Rejected**: สีแดง + - **Step Info Card** (เมื่อคลิก): + - Organization + - Assigned User + - Action Type (Review, Approve) + - Status + - Comments + - Completed Date + - **Actions** (สำหรับ Active Step): + - ปุ่ม "อนุมัติ" (Approve) + - ปุ่ม "ปฏิเสธ" (Reject) + - Dialog ให้กรอก Comments + - **Admin Override**: + - ปุ่ม "ไปยังขั้นตอนต่อไป" (Skip Step) + - ปุ่ม "ย้อนกลับ" (Previous Step) +- Deliverable: ✅ Workflow Component พร้อม + +**T4.4 Create RFA Form (Create/Edit)** + +- สร้าง `app/(protected)/rfas/create/page.tsx`: +- Form Fields: + - RFA Type (Dropdown) + - Title, Description + - Document Date + - **Shop Drawings Section** (สำหรับ RFA_DWG): + - Search & Select Shop Drawings + - แสดง Revisions ที่มี (Dropdown) + - เพิ่มได้หลายแบบ + - Attachments + - Workflow Template (Dropdown) +- Submit → สร้าง RFA + Start Workflow +- Deliverable: ✅ ฟอร์ม RFA พร้อม + +**T4.5 Implement Workflow Actions API** + +- สร้าง `lib/api/hooks/use-rfa-workflow.ts`: + + ```typescript + import { useMutation, useQueryClient } from "@tanstack/react-query"; + import { apiClient } from "../client"; + + export function useCompleteWorkflowStep() { + const queryClient = useQueryClient(); + + return useMutation({ + mutationFn: async ({ rfaId, stepNumber, action, comments }) => { + const response = await apiClient.post( + `/rfas/${rfaId}/workflow/steps/${stepNumber}/complete`, + { action, comments } + ); + return response.data; + }, + onSuccess: (_, variables) => { + queryClient.invalidateQueries(["rfa", variables.rfaId]); + queryClient.invalidateQueries(["my-tasks"]); + }, + }); + } + ``` + +- Hooks เพิ่มเติม: + - `use-reject-workflow-step.ts` + - `use-start-workflow.ts` +- Deliverable: ✅ Workflow Actions ทำงานได้ + +--- + +## **Phase 5: Drawing Management (สัปดาห์ที่ 9)** + +### Milestone: ระบบจัดการแบบ + +#### Tasks: + +**T5.1 Create Shop Drawing List Page** + +- สร้าง `app/(protected)/drawings/shop/page.tsx`: + - Data Table: + - Drawing Number + - Title + - Main Category + - Sub Category + - Current Revision + - Actions + - Filters: + - Category (Dropdown) + - Sub Category (Dropdown) + - Create Button +- Deliverable: ✅ หน้ารายการ Shop Drawings + +**T5.2 Create Shop Drawing Detail Page** + +- สร้าง `app/(protected)/drawings/shop/[id]/page.tsx`: + - **Header**: Drawing Number, Title + - **Current Revision Info**: + - Revision Number, Date + - Description + - Attachments (PDF, DWG) + - **Contract Drawing References**: + - แสดง Contract Drawings ที่อ้างถึง + - Links ไปยัง Contract Drawing Detail + - **Revision History**: + - แสดง Revisions ทั้งหมดเป็น Timeline + - **Related RFAs**: + - แสดง RFAs ที่เชื่อมโยงกับแบบนี้ +- Deliverable: ✅ หน้า Detail Shop Drawing + +**T5.3 Create Shop Drawing Form** + +- สร้าง `app/(protected)/drawings/shop/create/page.tsx`: +- Form Fields: + - Drawing Number (Auto-generate หรือ Manual) + - Title + - Main Category (Dropdown) + - Sub Category (Dropdown, dependent on Main) + - **Contract Drawing References**: + - Search & Select Contract Drawings (Multi-select) + - **Revision Info**: + - Revision Number (Auto) + - Revision Label (A, B, C) + - Description + - **Attachments**: + - Upload PDF (Main) + - Upload DWG (Optional) + - Upload Other Files +- Deliverable: ✅ ฟอร์ม Shop Drawing + +**T5.4 Create Contract Drawing List & Detail** + +- สร้าง `app/(protected)/drawings/contract/page.tsx`: + - Data Table: + - Drawing Number + - Title + - Volume + - Category + - Sub Category + - Filters: + - Volume (Dropdown) + - Category (Dropdown) +- สร้าง `app/(protected)/drawings/contract/[id]/page.tsx`: + - แสดง Metadata + - Attachments + - **Referenced By**: + - แสดง Shop Drawings ที่อ้างถึงแบบนี้ +- Deliverable: ✅ Contract Drawing Pages + +--- + +## **Phase 6: Circulation & Transmittal (สัปดาห์ที่ 10)** + +### Milestone: ระบบใบเวียนและเอกสารนำส่ง + +#### Tasks: + +**T6.1 Create Circulation List Page** + +- สร้าง `app/(protected)/circulations/page.tsx`: + - Data Table: + - Circulation Number + - Subject + - Status (Badge) + - Created By + - Created Date + - Filters: + - Status + - Date Range +- Deliverable: ✅ หน้ารายการใบเวียน + +**T6.2 Create Circulation Detail & Workflow** + +- สร้าง `app/(protected)/circulations/[id]/page.tsx`: + - **Header**: Circulation Number, Subject, Status + - **Linked Correspondence**: + - Link ไปยังเอกสารต้นทาง + - **Workflow Visualization**: + - คล้าย RFA Workflow + - แสดง Steps: + - Organization + - Assigned Users (Main, Action, Information) + - Status + - Comments + - Deadline + - **Actions** (สำหรับ Assigned User): + - ปุ่ม "ดำเนินการเสร็จสิ้น" (Complete) + - Dialog ให้กรอก Comments + - **Close Circulation** (Document Control): + - ปุ่ม "ปิดใบเวียน" (เมื่อตอบกลับองค์กรผู้ส่งแล้ว) +- Deliverable: ✅ หน้า Detail ใบเวียน diff --git a/docs/LCBP3-DMS_V1_4_0_FullStackJS.md b/docs/LCBP3-DMS_V1_4_0_FullStackJS.md new file mode 100644 index 0000000..b1ee793 --- /dev/null +++ b/docs/LCBP3-DMS_V1_4_0_FullStackJS.md @@ -0,0 +1,480 @@ +# **Documents Management Sytem Version 1.4.0: แนวทางการพัฒนา FullStackJS** + +## **🧠 ปรัชญาทั่วไป** + +แนวทางปฏิบัติที่ดีที่สุดแบบครบวงจรสำหรับการพัฒนา NestJS Backend, NextJS Frontend และ Tailwind-based UI/UX ในสภาพแวดล้อม TypeScript มุ่งเน้นที่ ความชัดเจน (clarity), ความง่ายในการบำรุงรักษา (maintainability), ความสอดคล้องกัน (consistency) และ การเข้าถึงได้ (accessibility) ตลอดทั้งสแต็ก + +## **⚙️ แนวทางทั่วไปสำหรับ TypeScript** + +### **หลักการพื้นฐาน** + +* ใช้ **ภาษาอังกฤษ** สำหรับโค้ด +* ใช้ **ภาษาไทย** สำหรับ comment และเอกสารทั้งหมด +* กำหนดไทป์ (type) อย่างชัดเจนสำหรับตัวแปร, พารามิเตอร์ และค่าที่ส่งกลับ (return values) ทั้งหมด +* หลีกเลี่ยงการใช้ any; ให้สร้างไทป์ (types) หรืออินเทอร์เฟซ (interfaces) ที่กำหนดเอง +* ใช้ **JSDoc** สำหรับคลาส (classes) และเมธอด (methods) ที่เป็น public +* ส่งออก (Export) **สัญลักษณ์หลัก (main symbol) เพียงหนึ่งเดียว** ต่อไฟล์ +* หลีกเลี่ยงบรรทัดว่างภายในฟังก์ชัน +* ระบุ // File: path/filename ในบรรทัดแรกของทุกไฟล์ +* ระบุ // บันทึกการแก้ไข, หากมีการแก้ไขเพิ่มในอนาคต ให้เพิ่มบันทึก + +### **ข้อตกลงในการตั้งชื่อ (Naming Conventions)** + +| Entity (สิ่งที่ตั้งชื่อ) | Convention (รูปแบบ) | Example (ตัวอย่าง) | +| :---- | :---- | :---- | +| Classes | PascalCase | UserService | +| Property | snake_sase | user_id | +| Variables & Functions | camelCase | getUserInfo | +| Files & Folders | kebab-case | user-service.ts | +| Environment Variables | UPPERCASE | DATABASE\URL | +| Booleans | Verb \+ Noun | isActive, canDelete, hasPermission | + +ใช้คำเต็ม — ไม่ใช้อักษรย่อ — ยกเว้นคำมาตรฐาน (เช่น API, URL, req, res, err, ctx) + +## **🧩 ฟังก์ชัน (Functions)** + +* เขียนฟังก์ชันให้สั้น และทำ **หน้าที่เพียงอย่างเดียว** (single-purpose) (\< 20 บรรทัด) +* ใช้ **early returns** เพื่อลดการซ้อน (nesting) ของโค้ด +* ใช้ **map**, **filter**, **reduce** แทนการใช้ loops เมื่อเหมาะสม +* ควรใช้ **arrow functions** สำหรับตรรกะสั้นๆ, และใช้ **named functions** ในกรณีอื่น +* ใช้ **default parameters** แทนการตรวจสอบค่า null +* จัดกลุ่มพารามิเตอร์หลายตัวให้เป็นอ็อบเจกต์เดียว (RO-RO pattern) +* ส่งค่ากลับ (Return) เป็นอ็อบเจกต์ที่มีไทป์กำหนด (typed objects) ไม่ใช่ค่าพื้นฐาน (primitives) +* รักษาระดับของสิ่งที่เป็นนามธรรม (abstraction level) ให้เป็นระดับเดียวในแต่ละฟังก์ชัน + +## **🧱 การจัดการข้อมูล (Data Handling)** + +* ห่อหุ้มข้อมูล (Encapsulate) ในไทป์แบบผสม (composite types) +* ใช้ **immutability** (การไม่เปลี่ยนแปลงค่า) ด้วย readonly และ as const +* ทำการตรวจสอบความถูกต้องของข้อมูล (Validations) ในคลาสหรือ DTOs ไม่ใช่ภายในฟังก์ชันทางธุรกิจ +* ตรวจสอบความถูกต้องของข้อมูลโดยใช้ DTOs ที่มีไทป์กำหนดเสมอ + +## **🧰 คลาส (Classes)** + +* ปฏิบัติตามหลักการ **SOLID** +* ควรใช้ **composition มากกว่า inheritance** (Prefer composition over inheritance) +* กำหนด **interfaces** สำหรับสัญญา (contracts) +* ให้คลาสมุ่งเน้นการทำงานเฉพาะอย่างและมีขนาดเล็ก (\< 200 บรรทัด, \< 10 เมธอด, \< 10 properties) + +## **🚨 การจัดการข้อผิดพลาด (Error Handling)** + +* ใช้ Exceptions สำหรับข้อผิดพลาดที่ไม่คาดคิด +* ดักจับ (Catch) ข้อผิดพลาดเพื่อแก้ไขหรือเพิ่มบริบท (context) เท่านั้น; หากไม่เช่นนั้น ให้ใช้ global error handlers +* ระบุข้อความข้อผิดพลาด (error messages) ที่มีความหมายเสมอ + +## **🧪 การทดสอบ (ทั่วไป) (Testing (General))** + +* ใช้รูปแบบ **Arrange–Act–Assert** +* ใช้ชื่อตัวแปรในการทดสอบที่สื่อความหมาย (inputData, expectedOutput) +* เขียน **unit tests** สำหรับ public methods ทั้งหมด +* จำลอง (Mock) การพึ่งพาภายนอก (external dependencies) +* เพิ่ม **acceptance tests** ต่อโมดูลโดยใช้รูปแบบ Given–When-Then + +## **🏗️ แบ็กเอนด์ (NestJS) (Backend (NestJS))** + +### **หลักการ** + +* **สถาปัตยกรรมแบบโมดูลาร์ (Modular architecture)**: + * หนึ่งโมดูลต่อหนึ่งโดเมน + * โครงสร้างแบบ Controller → Service → Repository (Model) +* API-First: มุ่งเน้นการสร้าง API ที่มีคุณภาพสูง มีเอกสารประกอบ (Swagger) ที่ชัดเจนสำหรับ Frontend Team +* DTOs ที่ตรวจสอบความถูกต้องด้วย **class-validator** +* ใช้ **MikroORM** (หรือ TypeORM/Prisma) สำหรับการคงอยู่ของข้อมูล (persistence) ซึ่งสอดคล้องกับสคีมา MariaDB +* ห่อหุ้มโค้ดที่ใช้ซ้ำได้ไว้ใน **common module** (@app/common): + * Configs, decorators, DTOs, guards, interceptors, notifications, shared services, types, validators + +### **ฟังก์ชันหลัก (Core Functionalities)** + +* Global **filters** สำหรับการจัดการ exception +* **Middlewares** สำหรับการจัดการ request +* **Guards** สำหรับการอนุญาต (permissions) และ RBAC +* **Interceptors** สำหรับการแปลงข้อมูล response และการบันทึก log + +### **ข้อจำกัดในการ Deploy (QNAP Container Station)** + +* **ห้ามใช้ไฟล์ .env** ในการตั้งค่า Environment Variables [cite: 2.1] +* การตั้งค่าทั้งหมด (เช่น Database connection string, JWT secret) **จะต้องถูกกำหนดผ่าน Environment Variable ใน docker-compose.yml โดยตรง** [cite: 6.5] ซึ่งจะจัดการผ่าน UI ของ QNAP Container Station [cite: 2.1] + +### **โครงสร้างโมดูลตามโดเมน (Domain-Driven Module Structure)** + +เพื่อให้สอดคล้องกับสคีมา SQL (LCBP3-DMS) เราจะใช้โครงสร้างโมดูลแบบ **Domain-Driven (แบ่งตามขอบเขตธุรกิจ)** แทนการแบ่งตามฟังก์ชัน: + +1. **CommonModule:** + * เก็บ Services ที่ใช้ร่วมกัน เช่น DatabaseModule, FileStorageService (จัดการไฟล์ใน QNAP), AuditLogService, NotificationService + * จัดการ audit_logs + * NotificationService ต้องรองรับ Triggers ที่ระบุใน Requirement 6.7 [cite: 6.7] +2. **AuthModule:** + * จัดการะการยืนยันตัวตน (JWT, Guards) + * **(สำคัญ)** ต้องรับผิดชอบการตรวจสอบสิทธิ์ **4 ระดับ** [cite: 4.2]: สิทธิ์ระดับระบบ (Global Role), สิทธิ์ระดับองกรณ์ (Organization Role), สิทธิ์ระดับโปรเจกต์ (Project Role), และ สิทธิ์ระดับสัญญา (Contract Role) + * **(สำคัญ)** ต้องมี API สำหรับ **Admin Panel** เพื่อ: + * สร้างและจัดการ Role และการจับคู่ Permission แบบไดนามิก [cite: 4.3] + * ให้ Superadmin สร้าง Organizations และกำหนด Org Admin ได้ [cite: 4.6] + * ให้ Superadmin/Admin จัดการ document_number_formats (รูปแบบเลขที่เอกสาร), document_number_counters (Running Number) [cite: 3.10] +3. **UserModule:** + * จัดการ users, roles, permissions, global_default_roles, role_permissions, user_roles, user_project_roles + * **(สำคัญ)** ต้องมี API สำหรับ **Admin Panel** เพื่อ: + * สร้างและจัดการ Role และการจับคู่ Permission แบบไดนามิก [cite: 4.3] +4. **ProjectModule:** + * จัดการ projects, organizations, contracts, project_parties, contract_parties +5. **MasterModule:** + * จัดการ master data (correspondence_types, rfa_types, rfa_status_codes, rfa_approve_codes, circulation_status_codes, correspondence_types, correspondence_status, tags) [cite: 4.5] +6. **CorrespondenceModule (โมดูลศูนย์กลาง):** + * จัดการ correspondences, correspondence_revisions, correspondence_tags + + * **(สำคัญ)** Service นี้ต้อง Inject DocumentNumberingService เพื่อขอเลขที่เอกสารใหม่ก่อนการสร้าง + * **(สำคัญ)** ตรรกะการสร้าง/อัปเดต Revision จะอยู่ใน Service นี้ + * จัดการ correspondence_attachments (ตารางเชื่อมไฟล์แนบ) + * รับผิดชอบ Routing **Correspondence Routing** (correspondence_routings, correspondence_routing_template_steps, correspondence_routing_templates, correspondence_status_transitions) สำหรับการส่งต่อเอกสารทั่วไประหว่างองค์กร +7. **RfaModule:** + * จัดการ rfas, rfa_revisions, rfa_items + * รับผิดชอบเวิร์กโฟลว์ **"RFA Workflows"** (rfa_workflows, rfa_workflow_templates, rfa_workflow_template_steps, rfa_status_transitions) สำหรับการอนุมัติเอกสารทางเทคนิค +8. **DrawingModule:** + * จัดการ shop_drawings, shop_drawing_revisions, contract_drawings, contract_drawing_volumes, contract_drawing_cats, contract_drawing_sub_cats, shop_drawing_main_categories, shop_drawing_sub_categories, contract_drawing_subcat_cat_maps, shop_drawing_revision_contract_refs + * จัดการ shop_drawing_revision_attachments และ contract_drawing_attachments(ตารางเชื่อมไฟล์แนบ) +9. **CirculationModule:** + * จัดการ circulations, circulation_templates, circulation_assignees + * จัดการ circulation_attachments (ตารางเชื่อมไฟล์แนบ) + * รับผิดชอบเวิร์กโฟลว์ **"Circulations"** (circulation_status_transitions, circulation_template_assignees, circulation_assignees, circulation_recipients, circulation_actions, circulation_action_documents)สำหรับการเวียนเอกสาร **ภายในองค์กร** +10. **TransmittalModule:** + * จัดการ transmittals และ transmittal_items +11. **SearchModule:** + * ให้บริการค้นหาขั้นสูง (Advanced Search) [cite: 6.2] โดยใช้ **Elasticsearch** เพื่อรองรับการค้นหาแบบ Full-text จากชื่อเรื่อง, รายละเอียด, เลขที่เอกสาร, ประเภท, วันที่, และ Tags + * ระบบจะใช้ Elasticsearch Engine ในการจัดทำดัชนีเพื่อการค้นหาข้อมูลเชิงลึกจากเนื้อหาของเอกสาร โดยข้อมูลจะถูกส่งไปทำดัชนีจาก Backend (NestJS) ทุกครั้งที่มีการสร้างหรือแก้ไขเอกสาร +12. **DocumentNumberingModule:** + * **สถานะ:** เป็น Module ภายใน (Internal Module) ไม่เปิด API สู่ภายนอก + * **หน้าที่:** ให้บริการ DocumentNumberingService ที่ Module อื่น (เช่น CorrespondenceModule) จะ Inject ไปใช้งาน + * **ตรรกะ:** รับผิดชอบการสร้างเลขที่เอกสาร โดยการเรียกใช้ Stored Procedure *sp_get_next_document_number** เพื่อป้องกัน Race Condition + +### **สถาปัตยกรรมระบบ (System Architecture)** + +โครงสร้างโมดูล (Module Structure) + +```bash +📁 src +├── 📄 app.module.ts +├── 📄 main.ts +├── 📁 common # @app/common (โมดูลส่วนกลาง) +│ ├── 📁 auth # AuthModule (JWT, Guards) +│ ├── 📁 config # Configuration +│ ├── 📁 decorators # Custom Decorators (เช่น @RequirePermission) +│ ├── 📁 entities # Shared Entities (User, Role, Permission) +│ ├── 📁 exceptions # Global Exception Filters +│ ├── 📁 file-storage # FileStorageService +│ ├── 📁 guards # Custom Guards (RBAC Guard) +│ ├── 📁 interceptors # Interceptors (Audit Log, Transform) +│ └── 📁 services # Shared Services (NotificationService) +├── 📁 modules +│ ├── 📁 user # UserModule (จัดการ Users, Roles, Permissions) +│ ├── 📁 project # ProjectModule (จัดการ Projects, Organizations, Contracts) +│ ├── 📁 correspondence # CorrespondenceModule (จัดการเอกสารโต้ตอบ) +│ ├── 📁 rfa # RfaModule (จัดการเอกสารขออนุมัติ) +│ ├── 📁 drawing # DrawingModule (จัดการแบบแปลน) +│ ├── 📁 circulation # CirculationModule (จัดการใบเวียน) +│ ├── 📁 transmittal # TransmittalModule (จัดการเอกสารนำส่ง) +│ ├── 📁 search # SearchModule (ค้นหาขั้นสูงด้วย Elasticsearch) +│ └── 📁 document-numbering # DocumentNumberingModule (Internal Module) +└── 📁 database # Database Migration & Seeding Scripts +``` + +### **เเทคโนโลยีที่ใช้ (Technology Stack)** + +| ส่วน | Library/Tool | หมายเหตุ | +|---|---|---| +| **Framework** | `@nestjs/core`, `@nestjs/common` | Core Framework | +| **Language** | `TypeScript` | ใช้ TypeScript ทั้งระบบ | +| **Database** | `MariaDB 10.11` | ฐานข้อมูลหลัก | +| **ORM** | `@nestjs/typeorm`, `typeorm` | 🗃️จัดการการเชื่อมต่อและ Query ฐานข้อมูล | +| **Validation** | `class-validator`, `class-transformer` | 📦ตรวจสอบและแปลงข้อมูลใน DTO | +| **Auth** | `@nestjs/jwt`, `@nestjs/passport`, `passport-jwt` | 🔐การยืนยันตัวตนด้วย JWT | +|**Authorization** | `casl` | 🔐จัดการสิทธิ์แบบ RBAC | +| **File Upload** | `multer` | 📁จัดการการอัปโหลดไฟล์ | +| **Search** | `@nestjs/elasticsearch` | 🔍สำหรับการค้นหาขั้นสูง | +| **Notification** | `nodemailer` | 📬ส่งอีเมลแจ้งเตือน | +| **Scheduling** | `@nestjs/schedule` | 📬สำหรับ Cron Jobs (เช่น แจ้งเตือน Deadline) | +| **Logging** | `winston` | 📊บันทึก Log ที่มีประสิทธิภาพ | +| **Testing** | `@nestjs/testing`, `jest`, `supertest` | 🧪ทดสอบ Unit, Integration และ E2E | +| **Documentation** | `@nestjs/swagger` | 🌐สร้าง API Documentation อัตโนมัติ | +| **Security** | `helmet`, `rate-limiter-flexible` | 🛡️เพิ่มความปลอดภัยให้ API | + +เราจะแบ่งการทดสอบเป็น 3 ระดับ โดยใช้ **Jest** และ @nestjs/testing: + +* **Unit Tests (การทดสอบหน่วยย่อย):** + * **เป้าหมาย:** ทดสอบ Logic ภายใน Service, Guard, หรือ Pipe โดยจำลอง (Mock) Dependencies ทั้งหมด + * **สิ่งที่ต้องทดสอบ:** Business Logic (เช่น การเปลี่ยนสถานะ Workflow, การตรวจสอบ Deadline) [cite: 2.9.1], ตรรกะการตรวจสอบสิทธิ์ (Auth Guard) ทั้ง 4 ระดับ +* **Integration Tests (การทดสอบการบูรณาการ):** + * **เป้าหมาย:** ทดสอบการทำงานร่วมกันของ Controller -> Service -> Repository (Database) + * **เทคนิค:** ใช้ **Test Database แยกต่างหาก** (ห้ามใช้ Dev DB) และใช้ supertest เพื่อยิง HTTP Request จริงไปยัง App + * **สิ่งที่ต้องทดสอบ:** การเรียก sp\get\next\document\number [cite: 2.9.3] และการทำงานของ Views (เช่น v_user_tasks) +* **E2E (End-to-End) Tests:** + * **เป้าหมาย:** ทดสอบ API Contract ว่า Response Body Shape ตรงตามเอกสาร Swagger เพื่อรับประกันทีม Frontend + +### **🗄️ Backend State Management** + +Backend (NestJS) ควรเป็น **Stateless** (ไม่เก็บสถานะ) "State" ทั้งหมดจะถูกจัดเก็บใน MariaDB + +* **Request-Scoped State (สถานะภายใน Request เดียว):** + * **ปัญหา:** จะส่งต่อข้อมูล (เช่น User ที่ล็อกอิน) ระหว่าง Guard และ Service ใน Request เดียวกันได้อย่างไร? + * **วิธีแก้:** ใช้ **Request-Scoped Providers** ของ NestJS (เช่น AuthContextService) เพื่อเก็บข้อมูล User ปัจจุบันที่ได้จาก AuthGuard และให้ Service อื่น Inject ไปใช้ +* **Application-Scoped State (การ Caching):** + * **ปัญหา:** ข้อมูล Master (เช่น roles, permissions, organizations) ถูกเรียกใช้บ่อย + * **วิธีแก้:** ใช้ **Caching** (เช่น @nestjs/cache-manager) เพื่อ Caching ข้อมูลเหล่านี้ และลดภาระ Database + +### **การไหลของข้อมูล (Data Flow)** + +1. Request: ผ่าน Nginx Proxy Manager -> NestJS Controller +2. Authentication: JWT Guard ตรวจสอบ Token และดึงข้อมูล User +3. Authorization: RBAC Guard (ใช้ CASL) ตรวจสอบสิทธิ์จาก Decorators (@RequirePermission) +4. Validation: Validation Pipe (ใช้ class-validator) ตรวจสอบ DTO +5. Business Logic: Service Layer ประมวลผลตรรกะทางธุรกิจ +6. Data Access: Repository Layer (ใช้ TypeORM) ติดต่อกับฐานข้อมูล MariaDB +7. Response: ส่งกลับไปยัง Frontend พร้อมสถานะและข้อมูลที่เหมาะสม + +# **🖥️ ฟรอนต์เอนด์ (NextJS / React / UI) (Frontend (NextJS / React / UI))** + +### **โปรไฟล์นักพัฒนา (Developer Profile)** + +วิศวกร TypeScript + React/NextJS ระดับ Senior +เชี่ยวชาญ TailwindCSS, Shadcn/UI, และ Radix สำหรับการพัฒนา UI + +### **แนวทางการพัฒนาโค้ด (Code Implementation Guidelines)** + +* ใช้ **early returns** เพื่อความชัดเจน +* ใช้คลาสของ **TailwindCSS** ในการกำหนดสไตล์เสมอ +* ควรใช้ class: syntax แบบมีเงื่อนไข (หรือ utility clsx) มากกว่าการใช้ ternary operators ใน class strings +* ใช้ **const arrow functions** สำหรับ components และ handlers +* Event handlers ให้ขึ้นต้นด้วย handle... (เช่น handleClick, handleSubmit) +* รวมแอตทริบิวต์สำหรับการเข้าถึง (accessibility) ด้วย: + tabIndex="0", aria-label, onKeyDown, ฯลฯ +* ตรวจสอบให้แน่ใจว่าโค้ดทั้งหมด **สมบูรณ์**, **ผ่านการทดสอบ**, และ **ไม่ซ้ำซ้อน (DRY)** +* ต้อง import โมดูลที่จำเป็นต้องใช้อย่างชัดเจนเสมอ + +### **UI/UX ด้วย React** + +* ใช้ **semantic HTML** +* ใช้คลาสของ **Tailwind** ที่รองรับ responsive (sm:, md:, lg:) +* รักษาลำดับชั้นของการมองเห็น (visual hierarchy) ด้วยการใช้ typography และ spacing +* ใช้ **Shadcn** components (Button, Input, Card, ฯลฯ) เพื่อ UI ที่สอดคล้องกัน +* ทำให้ components มีขนาดเล็กและมุ่งเน้นการทำงานเฉพาะอย่าง +* ใช้ utility classes สำหรับการจัดสไตล์อย่างรวดเร็ว (spacing, colors, text, ฯลฯ) +* ตรวจสอบให้แน่ใจว่าสอดคล้องกับ **ARIA** และใช้ semantic markup + +### **การตรวจสอบฟอร์มและข้อผิดพลาด (Form Validation & Errors)** + +* ใช้ไลบรารีฝั่ง client เช่น zod และ react-hook-form +* แสดงข้อผิดพลาดด้วย **alert components** หรือข้อความ inline +* ต้องมี labels, placeholders, และข้อความ feedback + +### **🧪 Frontend Testing** + +เราจะใช้ **React Testing Library (RTL)** สำหรับการทดสอบ Component และ **Playwright** สำหรับ E2E: + +* **Unit Tests (การทดสอบหน่วยย่อย):** + * **เครื่องมือ:** Vitest + RTL + * **เป้าหมาย:** ทดสอบ Component ขนาดเล็ก (เช่น Buttons, Inputs) หรือ Utility functions +* **Integration Tests (การทดสอบการบูรณาการ):** + * **เครื่องมือ:** RTL + **Mock Service Worker (MSW)** + * **เป้าหมาย:** ทดสอบว่า Component หรือ Page ทำงานกับ API (ที่จำลองขึ้น) ได้ถูกต้อง + * **เทคนิค:** ใช้ MSW เพื่อจำลอง NestJS API และทดสอบว่า Component แสดงผลข้อมูลจำลองได้ถูกต้องหรือไม่ (เช่น ทดสอบหน้า Dashboard [cite: 5.3] ที่ดึงข้อมูลจาก v_user_tasks) +* **E2E (End-to-End) Tests:** + * **เครื่องมือ:** **Playwright** + * **เป้าหมาย:** ทดสอบ User Flow ทั้งระบบโดยอัตโนมัติ (เช่น ล็อกอิน -> สร้าง RFA -> ตรวจสอบ Workflow Visualization [cite: 5.6]) + +### **🗄️ Frontend State Management** + +สำหรับ Next.js App Router เราจะแบ่ง State เป็น 4 ระดับ: + +1. **Local UI State (สถานะ UI ชั่วคราว):** + * **เครื่องมือ:** useState, useReducer + * **ใช้เมื่อ:** จัดการสถานะเล็กๆ ที่จบใน Component เดียว (เช่น Modal เปิด/ปิด, ค่าใน Input) +2. **Server State (สถานะข้อมูลจากเซิร์ฟเวอร์):** + * **เครื่องมือ:** **React Query (TanStack Query)** หรือ SWR + * **ใช้เมื่อ:** จัดการข้อมูลที่ดึงมาจาก NestJS API (เช่น รายการ correspondences, rfas, drawings) + * **ทำไม:** React Query เป็น "Cache" ที่จัดการ Caching, Re-fetching, และ Invalidation ให้โดยอัตโนมัติ +3. **Global Client State (สถานะส่วนกลางฝั่ง Client):** + * **เครื่องมือ:** **Zustand** (แนะนำ) หรือ Context API + * **ใช้เมื่อ:** จัดการข้อมูลที่ต้องใช้ร่วมกันทั่วทั้งแอป และ *ไม่ใช่* ข้อมูลจากเซิร์ฟเวอร์ (เช่น ข้อมูล User ที่ล็อกอิน, สิทธิ์ Permissions) +4. **Form State (สถานะของฟอร์ม):** + * **เครื่องมือ:** **React Hook Form** + **Zod** + * **ใช้เมื่อ:** จัดการฟอร์มที่ซับซ้อน (เช่น ฟอร์มสร้าง RFA, ฟอร์ม Circulation [cite: 3.7]) + +# **🔗 แนวทางการบูรณาการ Full Stack (Full Stack Integration Guidelines)** + +| Aspect (แง่มุม) | Backend (NestJS) | Frontend (NextJS) | UI Layer (Tailwind/Shadcn) | +| :---- | :---- | :---- | :---- | +| API | REST / GraphQL Controllers | API hooks ผ่าน fetch/axios/SWR | Components ที่รับข้อมูล | +| Validation (การตรวจสอบ) | class-validator DTOs | zod / react-hook-form | สถานะของฟอร์ม/input ใน Shadcn | +| Auth (การยืนยันตัวตน) | Guards, JWT | NextAuth / cookies | สถานะ UI ของ Auth (loading, signed in) | +| Errors (ข้อผิดพลาด) | Global filters | Toasts / modals | Alerts / ข้อความ feedback | +| Testing (การทดสอบ) | Jest (unit/e2e) | Vitest / Playwright | Visual regression | +| Styles (สไตล์) | Scoped modules (ถ้าจำเป็น) | Tailwind / Shadcn | Tailwind utilities | +| Accessibility (การเข้าถึง) | Guards + filters | ARIA attributes | Semantic HTML | + +## **🗂️ ข้อตกลงเฉพาะสำหรับ DMS (LCBP3-DMS)** + +ส่วนนี้ขยายแนวทาง FullStackJS ทั่วไปสำหรับโปรเจกต์ **LCBP3-DMS** โดยมุ่งเน้นไปที่เวิร์กโฟลว์การอนุมัติเอกสาร (Correspondence, RFA, Drawing, Contract, Transmittal, Circulation) + +### **🧩 RBAC และการควบคุมสิทธิ์ (RBAC & Permission Control)** + +ใช้ Decorators เพื่อบังคับใช้สิทธิ์การเข้าถึง โดยอ้างอิงสิทธิ์จากตาราง permissions + +@RequirePermission('rfas.respond') // ต้องตรงกับ 'permission\code' +@Put(':id') +updateRFA(@Param('id') id: string) { + return this.rfaService.update(id); +} + +### **Roles (บทบาท)** + +* **Superadmin**: ไม่มีข้อจำกัดใดๆ [cite: 4.3] +* **Admin**: มีสิทธิ์เต็มที่ในองค์กร [cite: 4.3] +* **Document Control**: เพิ่ม/แก้ไข/ลบ เอกสารในองค์กร [cite: 4.3] +* **Editor**: สามารถ เพิ่ม/แก้ไข เอกสารที่กำหนด [cite: 4.3] +* **Viewer**: สามารถดู เอกสาร [cite: 4.3] + +### **ตัวอย่าง Permissions (จากตาราง permissions)** + +* rfas.view, rfas.create, rfas.respond, rfas.delete +* drawings.view, drawings.upload, drawings.delete +* corr.view, corr.manage +* transmittals.manage +* cirs.manage +* project\parties.manage + +การจับคู่ระหว่าง roles และ permissions **เริ่มต้น** จะถูก seed ผ่านสคริปต์ (ดังที่เห็นในไฟล์ SQL)**อย่างไรก็ตาม AuthModule/UserModule ต้องมี API สำหรับ Admin เพื่อสร้าง Role ใหม่และกำหนดสิทธิ์ (Permissions) เพิ่มเติมได้ในภายหลัง** [cite: 4.3] + +## **🧾 มาตรฐาน AuditLog (AuditLog Standard)** + +บันทึกการดำเนินการ CRUD และการจับคู่ทั้งหมดลงในตาราง audit_logs + +| Field (ฟิลด์) | Type (จาก SQL) | Description (คำอธิบาย) | +| :---- | :---- | :---- | +| audit_id | BIGINT | Primary Key | +| user_id | INT | ผู้ใช้ที่ดำเนินการ (FK -> users) | +| action | VARCHAR(100) | rfa.create, correspondence.update, login.success | +| entity_type | VARCHAR(50) | ชื่อตาราง/โมดูล เช่น 'rfa', 'correspondence' | +| entity_id | VARCHAR(50) | Primary ID ของระเบียนที่ได้รับผลกระทบ | +| details_json | JSON | ข้อมูลบริบท (เช่น ฟิลด์ที่มีการเปลี่ยนแปลง) | +| ip_address | VARCHAR(45) | IP address ของผู้ดำเนินการ | +| user_agent | VARCHAR(255) | User Agent ของผู้ดำเนินการ | +| created_at | TIMESTAMP | Timestamp (UTC) | + +## **📂 การจัดการไฟล์ (File Handling) (ปรับปรุงใหม่)** + +### **มาตรฐานการอัปโหลดไฟล์ (File Upload Standard)** + +* **ตรรกะใหม่:** การอัปโหลดไฟล์ทั้งหมดจะถูกจัดการโดย FileStorageService และบันทึกข้อมูลไฟล์ลงในตาราง attachments (ตารางกลาง) +* ไฟล์จะถูกเชื่อมโยงไปยัง Entity ที่ถูกต้องผ่าน **ตารางเชื่อม (Junction Tables)** เท่านั้น: + * correspondence_attachments (เชื่อม Correspondence กับ Attachments) + * circulation_attachments (เชื่อม Circulation กับ Attachments) + * shop_drawing_revision_attachments (เชื่อม Shop Drawing Revision กับ Attachments) + * contract_drawing_attachments (เชื่อม Contract Drawing กับ Attachments) +* เส้นทางจัดเก็บไฟล์ (Upload path): อ้างอิงจาก Requirement 2.1 คือ /share/dms-data [cite: 2.1] โดย FileStorageService จะสร้างโฟลเดอร์ย่อยแบบรวมศูนย์ (เช่น /share/dms-data/uploads/{YYYY}/{MM}/[stored\filename]) +* ประเภทไฟล์ที่อนุญาต: pdf, dwg, docx, xlsx, zip +* ขนาดสูงสุด: **50 MB** +* จัดเก็บนอก webroot +* ให้บริการไฟล์ผ่าน endpoint ที่ปลอดภัย /files/:attachment_id/download + +### **การควบคุมการเข้าถึง (Access Control)** + +การเข้าถึงไฟล์ไม่ใช่การเข้าถึงโดยตรง endpoint /files/:attachment_id/download จะต้อง: + +1. ค้นหาระเบียน attachment +2. ตรวจสอบว่า attachment_id นี้ เชื่อมโยงกับ Entity ใด (เช่น correspondence, circulation, shop_drawing_revision, contract_drawing) ผ่านตารางเชื่อม +3. ตรวจสอบว่าผู้ใช้มีสิทธิ์ (permission) ในการดู Entity ต้นทางนั้นๆ หรือไม่ + +## **🔟 การจัดการเลขที่เอกสาร (Document Numbering) [cite: 3.10]** + +* **เป้าหมาย:** สร้างเลขที่เอกสาร (เช่น correspondence\number) โดยอัตโนมัติ ตามรูปแบบที่กำหนด +* **ตรรกะการนับ:** การนับ Running number (SEQ) จะนับแยกตาม Key: **Project + Originator Organization + Document Type + Year** +* **ตาราง SQL:** + * document_number_formats: Admin ใช้กำหนด "รูปแบบ" (Template) ของเลขที่ (เช่น {ORG\CODE}-{TYPE\CODE}-{YEAR\SHORT}-{SEQ:4}) โดยกำหนดตาม **Project** และ **Document Type** [cite: 4.5] + * document_number_counters: ระบบใช้เก็บ "ตัวนับ" ล่าสุดของ Key (Project+Org+Type+Year) +* **การทำงาน (Backend):** + * DocumentNumberingModule จะให้บริการ DocumentNumberingService + * เมื่อ CorrespondenceModule ต้องการสร้างเอกสารใหม่, มันจะเรียก documentNumberingService.generateNextNumber(...) + * Service นี้จะเรียกใช้ Stored Procedure **sp_get_next_document_number** [cite: 2.9.3] ซึ่ง Procedure นี้จะจัดการ Database Transaction และ Row Lock (FOR UPDATE) ภายใน DB เพื่อรับประกันการป้องกัน Race Condition + +## **📊 การรายงานและการส่งออก (Reporting & Exports)** + +### **วิวสำหรับการรายงาน (Reporting Views) (จาก SQL)** + +การรายงานควรสร้างขึ้นจาก Views ที่กำหนดไว้ล่วงหน้าในฐานข้อมูลเป็นหลัก: + +* v_current_correspondences: สำหรับ revision ปัจจุบันทั้งหมดของเอกสารที่ไม่ใช่ RFA +* v_current_rfas: สำหรับ revision ปัจจุบันทั้งหมดของ RFA และข้อมูล master +* v_contract_parties_all: สำหรับการตรวจสอบความสัมพันธ์ของ project/contract/organization +* v_user_tasks: สำหรับ Dashboard "งานของฉัน" +* v_audit_log_details: สำหรับ Activity Feed + +Views เหล่านี้ทำหน้าที่เป็นแหล่งข้อมูลหลักสำหรับการรายงานฝั่งเซิร์ฟเวอร์และการส่งออกข้อมูล + +### **กฎการส่งออก (Export Rules)** + +* Export formats: CSV, Excel, PDF. +* จัดเตรียมมุมมองสำหรับพิมพ์ (Print view). +* รวมลิงก์ไปยังต้นทาง (เช่น /rfas/:id). + +## **🧮 ฟรอนต์เอนด์: รูปแบบ DataTable และฟอร์ม (Frontend: DataTable & Form Patterns)** + +### **DataTable (Server‑Side)** + +* Endpoint: /api/{module}?page=1\&pageSize=20\&sort=...\&filter=... +* ต้องรองรับ: การแบ่งหน้า (pagination), การเรียงลำดับ (sorting), การค้นหา (search), การกรอง (filters) +* แสดง revision ล่าสุดแบบ inline เสมอ (สำหรับ RFA/Drawing) + +### **มาตรฐานฟอร์ม (Form Standards)** + +* ต้องมีการใช้งาน Dropdowns แบบขึ้นต่อกัน (Dependent dropdowns) (ตามที่สคีมารองรับ): + * Project → Contract Drawing Volumes + * Contract Drawing Category → Sub-Category + * RFA (ประเภท Shop Drawing) → Shop Drawing Revisions ที่เชื่อมโยงได้ +* **(ใหม่)** การอัปโหลดไฟล์: ต้องรองรับ **Multi-file upload (Drag-and-Drop)** [cite: 5.7] +* **(ใหม่)** UI ต้องอนุญาตให้ผู้ใช้กำหนดว่าไฟล์ใดเป็น **"เอกสารหลัก"** หรือ "เอกสารแนบประกอบ" [cite: 5.7] +* ส่ง (Submit) ผ่าน API พร้อม feedback แบบ toast + +### **ข้อกำหนด Component เฉพาะ (Specific UI Requirements)** + +* **Dashboard \- My Tasks:** ต้องพัฒนา Component ตาราง "งานของฉัน" (My Tasks)ซึ่งดึงข้อมูลงานที่ผู้ใช้ล็อกอินอยู่ต้องรับผิดชอบ (Main/Action) จาก v\user\tasks [cite: 5.3] +* **Workflow Visualization:** ต้องพัฒนา Component สำหรับแสดงผล Workflow (โดยเฉพาะ RFA)ที่แสดงขั้นตอนทั้งหมดเป็นลำดับ โดยขั้นตอนปัจจุบัน (active) เท่านั้นที่ดำเนินการได้ และขั้นตอนอื่นเป็น disabled [cite: 5.6] ต้องมีตรรกะสำหรับ Admin ในการ override หรือย้อนกลับขั้นตอนได้ [cite: 5.6] +* ** Admin Panel:** ต้องมีหน้า UI สำหรับ Superadmin/Admin เพื่อจัดการข้อมูลหลัก (Master Data [cite: 4.5]), การเริ่มต้นใช้งาน (Onboarding [cite: 4.6]), และ **รูปแบบเลขที่เอกสาร (Numbering Formats [cite: 3.10])** + +## **🧭 แดชบอร์ดและฟีดกิจกรรม (Dashboard & Activity Feed)** + +### **การ์ดบนแดชบอร์ด (Dashboard Cards)** + +* แสดง Correspondences, RFAs, Circulations, Shop Drawing Revision ล่าสุด +* รวมสรุป KPI (เช่น "RFAs ที่รอการอนุมัติ", "Shop Drawing ที่รอการอนุมัติ") [cite: 5.3] +* รวมลิงก์ด่วนไปยังโมดูลต่างๆ + +### **ฟีดกิจกรรม (Activity Feed)** + +* แสดงรายการ v\audit\log\details ล่าสุด (10 รายการ) ที่เกี่ยวข้องกับผู้ใช้ + +// ตัวอย่าง API response +[ + { user: 'editor01', action: 'Updated RFA (LCBP3-RFA-001)', time: '2025-11-04T09:30Z' } +] + +## **🛡️ ข้อกำหนดที่ไม่ใช่ฟังก์ชันการทำงาน (Non-Functional Requirements)** + +ส่วนนี้สรุปข้อกำหนด Non-Functional จาก requirements.md เพื่อให้ทีมพัฒนาทราบ + +* **Audit Log [cite: 6.1]:** ทุกการกระทำที่สำคัญ (C/U/D) ต้องถูกบันทึกใน audit_logs +* **Performance [cite: 6.4]:** ต้องใช้ Caching สำหรับข้อมูลที่เรียกบ่อย และใช้ Pagination +* **Security [cite: 6.5]:** ต้องมี Rate Limiting และจัดการ Secret ผ่าน docker-compose.yml (ไม่ใช่ .env) +* **(ใหม่) Backup & Recovery [cite: 6.6]:** ต้องมีแผนสำรองข้อมูลทั้ง Database (MariaDB) และ File Storage (/share/dms-data) อย่างน้อยวันละ 1 ครั้ง +* **(ใหม่) Notification Strategy [cite: 6.7]:** ระบบแจ้งเตือน (Email/Line) ต้องถูก Trigger เมื่อมีเอกสารใหม่ส่งถึง, มีการมอบหมายงานใหม่ (Circulation), หรือ (ทางเลือก) เมื่องานเสร็จ/ใกล้ถึงกำหนด + +## **✅ มาตรฐานที่นำไปใช้แล้ว (จาก SQL v1.1.0) (Implemented Standards (from SQL v1.1.0))** + +ส่วนนี้ยืนยันว่าแนวทางปฏิบัติที่ดีที่สุดต่อไปนี้เป็นส่วนหนึ่งของการออกแบบฐานข้อมูลอยู่แล้ว และควรถูกนำไปใช้ประโยชน์ ไม่ใช่สร้างขึ้นใหม่ + +* ✅ **Soft Delete:** นำไปใช้แล้วผ่านคอลัมน์ deleted_at ในตารางสำคัญ (เช่น correspondences, rfas, project_parties) ตรรกะการดึงข้อมูลต้องกรอง deleted_at IS NULL +* ✅ **Database Indexes:** สคีมาได้มีการทำ index ไว้อย่างหนักหน่วงบน foreign keys และคอลัมน์ที่ใช้ค้นหาบ่อย (เช่น idx_rr_rfa, idx_cor_project, idx_cr_is_current) เพื่อประสิทธิภาพ +* ✅ **โครงสร้าง RBAC:** มีระบบ users, roles, permissions, user_roles, และ user_project_roles ที่ครอบคลุมอยู่แล้ว +* ✅ **Data Seeding:** ข้อมูล Master (roles, permissions, organization_roles, initial users, project parties) ถูกรวมอยู่ในสคริปต์สคีมาแล้ว + +## **🧩 การปรับปรุงที่แนะนำ (สำหรับอนาคต) (Recommended Enhancements (Future))** + +* ✅ สร้าง Background job (โดยใช้ **n8n** เพื่อเชื่อมต่อกับ **Line** [cite: 2.7] และ/หรือใช้สำหรับการแจ้งเตือน RFA ที่ใกล้ถึงกำหนด due_date [cite: 6.7]) +* ✅ เพิ่ม job ล้างข้อมูลเป็นระยะสำหรับ attachments ที่ไม่ถูกเชื่อมโยงกับ Entity ใดๆ เลย (ไฟล์กำพร้า) diff --git a/docs/LCBP3-DMS_V1_4_0_requirements.md b/docs/LCBP3-DMS_V1_4_0_requirements.md new file mode 100644 index 0000000..6de7ee9 --- /dev/null +++ b/docs/LCBP3-DMS_V1_4_0_requirements.md @@ -0,0 +1,245 @@ +# **📝 Documents Management Sytem Version 1.4.0: Application Requirements Specification** + +## **📌 1. วัตถุประสงค์** + +สร้างเว็บแอปพลิเคชั่นสำหรับระบบบริหารจัดการเอกสารโครงการ (Document Management System)ที่สามารถจัดการและควบคุม การสื่อสารด้วยเอกสารที่ซับซ้อน อย่างมีประสิทธิภาพ + +- มีฟังก์ชันหลักในการอัปโหลด จัดเก็บ ค้นหา แชร์ และควบคุมสิทธิ์การเข้าถึงเอกสาร +- ช่วยลดการใช้เอกสารกระดาษ เพิ่มความปลอดภัยในการจัดเก็บข้อมูล +- เพิ่มความสะดวกในการทำงานร่วมกันระหว่างองกรณ์ + +## **🛠️ 2. สถาปัตยกรรมและเทคโนโลยี (System Architecture & Technology Stack)** + +ใช้สถาปัตยกรรมแบบ Headless/API-First ที่ทันสมัย ทำงานทั้งหมดบน QNAP Server ผ่าน Container Station เพื่อความสะดวกในการจัดการและบำรุงรักษา, Domain: np-dms.work, มี fix ip, รัน docker command ใน application ของ Container Station ได้โดยตรง, ประกอบด้วย + +- **2.1. Infrastructure & Environment:** + - Server: QNAP (Model: TS-473A, RAM: 32GB, CPU: AMD Ryzen V1500B) + - Containerization: Container Station (Docker & Docker Compose) ใช้ UI ของ Container Station เป็นหลัก ในการ configuration และการรัน docker command + - Development Environment: VS Code on Windows 11 + - Domain: np-dms.work, www.np-dms.work + - ip: 159.192.126.103 + - Docker Network: ทุก Service จะเชื่อมต่อผ่านเครือข่ายกลางชื่อ lcbp3 เพื่อให้สามารถสื่อสารกันได้ + - Data Storage: /share/dms-data บน QNAP + - ข้อจำกัด: ไม่สามารถใช้ .env ในการกำหนดตัวแปรภายนอกได้ ต้องกำหนดใน docker-compose.yml เท่านั้น +- **2.2. Code Hosting:** + - Application name: git + - Service: Gitea (Self-hosted on QNAP) + - Service name: gitea + - Domain: git.np-dms.work + - หน้าที่: เป็นศูนย์กลางในการเก็บและจัดการเวอร์ชันของโค้ด (Source Code) สำหรับทุกส่วน +- **2.3. Backend / Data Platform:** + - Application name: lcbp3-backend + - Service: NestJS + - Service name: backend + - Domain: backend.np-dms.work + - Framework: NestJS (Node.js, TypeScript, ESM) + - หน้าที่: จัดการโครงสร้างข้อมูล (Data Models), สร้าง API, จัดการสิทธิ์ผู้ใช้ (Roles & Permissions), และสร้าง Workflow ทั้งหมดของระบบ +- **2.4. Database:** + - Application name: lcbp3-db + - Service: mariadb:10.11 + - Service name: mariadb + - Domain: db.np-dms.work + - หน้าที่: ฐานข้อมูลหลักสำหรับเก็บข้อมูลทั้งหมด + - Tooling: DBeaver (Community Edition), phpmyadmin สำหรับการออกแบบและจัดการฐานข้อมูล +- **2.5. Database management:** + - Application name: lcbp3-db + - Service: phpmyadmin:5-apache + - Service name: pma + - Domain: pma.np-dms.work + - หน้าที่: จัดการฐานข้อมูล mariadb ผ่าน Web UI +- **2.6. Frontend:** + - Application name: lcbp3-frontend + - Service: next.js + - Service name: frontend + - Domain: lcbp3.np-dms.work + - Framework: Next.js (App Router, React, TypeScript, ESM) + - Styling: Tailwind CSS + PostCSS + - Component Library: shadcn/ui + - หน้าที่: สร้างหน้าตาเว็บแอปพลิเคชันสำหรับให้ผู้ใช้งานเข้ามาดู Dashboard, จัดการเอกสาร, และติดตามงาน โดยจะสื่อสารกับ Backend ผ่าน API +- **2.7. Workflow automation:** + - Application name: lcbp3-n8n + - Service: n8nio/n8n:latest + - Service name: n8n + - Domain: n8n.np-dms.work + - หน้าที่: จัดการ workflow ระหว่าง Backend และ Line +- **2.8. Reverse Proxy:** + - Application name: lcbp3-npm + - Service: Nginx Proxy Manager (nginx-proxy-manage: latest) + - Service name: npm + - Domain: npm.np-dms.work + - หน้าที่: เป็นด่านหน้าในการรับ-ส่งข้อมูล จัดการโดเมนทั้งหมด, ทำหน้าที่เป็น Proxy ชี้ไปยัง Service ที่ถูกต้อง, และจัดการ SSL Certificate (HTTPS) ให้อัตโนมัติ +- **2.9. การจัดการตรรกะทางธุรกิจ (Business Logic Implementation):** + - 2.9.1. ตรรกะทางธุรกิจที่ซับซ้อนทั้งหมด (เช่น การเปลี่ยนสถานะ Workflow [cite: 3.5.4, 3.6.5], การบังคับใช้สิทธิ์ [cite: 4.4], การตรวจสอบ Deadline [cite: 3.2.5]) **จะถูกจัดการในฝั่ง Backend (NestJS)** [cite: 2.3] เพื่อให้สามารถบำรุงรักษาและทดสอบได้ง่าย (Testability) + - 2.9.2. **จะไม่มีการใช้ SQL Triggers** เพื่อป้องกันตรรกะซ่อนเร้น (Hidden Logic) และความซับซ้อนในการดีบัก + - 2.9.3. **ข้อยกเว้น:** ตรรกะเดียวที่จะอยู่ในฐานข้อมูลคือ **Stored Procedure** สำหรับการสร้างเลขที่เอกสาร (Document Numbering) [cite: 3.10] เพื่อป้องกันการซ้ำซ้อนของข้อมูล (Race Condition) + +## **📦 3. ข้อกำหนดด้านฟังก์ชันการทำงาน (Functional Requirements)** + +- **3.1. การจัดการโครงสร้างโครงการและองค์กร** + - 3.1.1. โครงการ (Projects): ระบบต้องสามารถจัดการเอกสารภายในหลายโครงการได้ (ปัจจุบันมี 4 โครงการ และจะเพิ่มขึ้นในอนาคต) + - 3.1.2. สัญญา (Contracts): ระบบต้องสามารถจัดการเอกสารภายในแต่ละสัญญาได้ ในแต่ละโครงการ มีได้หลายสัญญา หรืออย่างน้อย 1 สัญญา + - 3.1.3. องค์กร (Organizations): + - มีหลายองค์กรในโครงการ องค์กรณ์ที่เป็น Owner, Designer และ Consultant สามารถอยู่ในหลายโครงการและหลายสัญญาได้ + - Contractor จะถือ 1 สัญญา และอยู่ใน 1 โครงการเท่านั้น +- **3.2. การจัดการเอกสารโต้ตอบ (Correspondence Management)** + - 3.2.1. วัตถุประสงค์: เอกสารโต้ตอบ (correspondences) ระหว่างองกรณื-องกรณ์ ภายใน โครงการ (Projects) และระหว่าง องค์กร-องค์กร ภายนอก โครงการ (Projects), รองรับ To (ผู้รับหลัก) และ CC (ผู้รับสำเนา) หลายองค์กร + - 3.2.2. ประเภทเอกสาร: ระบบต้องรองรับเอกสารรูปแบบ ไฟล์ PDF หลายประเภท (Types) เช่น จดหมาย (Letter), อีเมล์ (Email), Request for Information (RFI), และสามารถเพิ่มประเภทใหม่ได้ในภายหลัง + - 3.2.3. การสร้างเอกสาร (Correspondence): + - ผู้ใช้ที่มีสิทธิ์ (เช่น Document Control) สามารถสร้างเอกสารรอไว้ในสถานะ ฉบับร่าง" (Draft) ได้ ซึ่งผู้ใช้งานต่างองค์กรจะมองไม่เห็น + - เมื่อกด "Submitted" แล้ว การแก้ไข, ถอนเอกสารกลับไปสถานะ Draft, หรือยกเลิก (Cancel) จะต้องทำโดยผู้ใช้ระดับ Admin ขึ้นไป พร้อมระบุเหตุผล + - 3.2.4. การอ้างอิงและจัดกลุ่ม: + - เอกสารสามารถอ้างถึง (Reference) เอกสารฉบับก่อนหน้าได้หลายฉบับ + - สามารถกำหนด Tag ได้หลาย Tag เพื่อจัดกลุ่มและใช้ในการค้นหาขั้นสูง + - 3.2.5. Routings : ต้องรองรับกระบวนการส่งต่อเอกสาร (Routing) ตามลำดับ เช่น + - ส่งจาก Originator -> Organization 1 -> Organization 2 -> Organization 3 แล้วส่งผลกลับตามลำดับเดิม (โดยถ้า องกรณ์ใดใน Wouting ให้ส่งกลับ ก็สามารถส่งผลกลับตามลำดับเดิมโดยไม่ต้องรอให้ถึง องกรณืในลำดับถัดไป) + - 3.2.6. การจัดการ: มีการจัดการอย่างน้อยดังนี้ + - สามารถกำหนดวันแล้วเสร็จ (Deadline) สำหรับผู้รับผิดชอบของ องกรณ์ ที่เป็นผู้รับได้ + - มีระบบแจ้งเตือน ให้ผู้รับผิดชอบขององกรณ์ที่เป็น ผู้รับ/ผู้ส่ง ทราบ เมื่อมีเอกสารใหม่ หรือมีการเปลี่ยนสถานะ +- **3.3. การจัดกาแบบคู่สัญญา (Contract Drawing)** + - 3.3.1. วัตถุประสงค์: แบบคู่สัญญา (Contract Drawing) ใช้เพื่ออ้างอิงและใช้ในการตรวจสอบ + - 3.3.2. ประเภทเอกสาร: ไฟล์ PDF + - 3.3.3. การสร้างเอกสาร: ผู้ใช้ที่มีสิทธิ์ สามารถสร้างและแก้ไขได้ + - 3.3.4. การอ้างอิงและจัดกลุ่ม: ใช้สำหรับอ้างอิง ใน Shop Drawings, มีการจัดหมวดหมู่ของ Contract Drawing +- **3.4. การจัดกาแบบก่อสร้าง (Shop Drawing)** + - 3.4.1. วัตถุประสงค์: แบบก่อสร้าง (Shop Drawing) ใช้เในการตรวจสอบ โดยจัดส่งด้วย Request for Approval (RFA) + - 3.4.2. ประเภทเอกสาร: ไฟล์ PDF + - 3.4.3. การสร้างเอกสาร: ผู้ใช้ที่มีสิทธิ์ สามารถสร้างและแก้ไขได้ + - 3.4.4. การอ้างอิงและจัดกลุ่ม: ช้สำหรับอ้างอิง ใน Shop Drawings, มีการจัดหมวดหมู่ของ Shop Drawings +- **3.5. การจัดการเอกสารขออนุมัติ (Request for Approval & Workflow)** + - 3.5.1. วัตถุประสงค์: เอกสารขออนุมัติ (Request for Approval) ใช้ในการส่งเอกสารเพิอขออนุมัติ + - 3.5.2. ประเภทเอกสาร: Request for Approval (RFA) เป็นชนิดหนึ่งของ Correspondence ที่มีลักษณะเฉพาะที่ต้องได้รับการอนุมัติ มีประเภทดังนี้: + - Request for Drawing Approval (RFA_DWG) + - Request for Document Approval (RFA_DOC) + - Request for Method statement Approval (RFA_MES) + - Request for Material Approval (RFA_MAT) + - 3.5.2. การสร้างเอกสาร: ผู้ใช้ที่มีสิทธิ์ สามารถสร้างและแก้ไขได้ + - 3.5.4. การอ้างอิงและจัดกลุ่ม: การจัดการ Drawing (RFA_DWG): + - เอกสาร RFA_DWG จะประกอบไปด้วย Shop Drawing (shop_drawings) หลายแผ่น ซึ่งแต่ละแผ่นมี Revision ของตัวเอง + - Shop Drawing แต่ละ Revision สามารถอ้างอิงถึง Contract Drawing (Ccontract_drawings) หลายแผ่น หรือไม่อ้างถึงก็ได้ + - ระบบต้องมีส่วนสำหรับจัดการข้อมูล Master Data ของทั้ง Shop Drawing และ Contract Drawing แยกจากกัน + - 3.6.5. Workflow การอนุมัติ: ต้องรองรับกระบวนการอนุมัติที่ซับซ้อนและเป็นลำดับ เช่น + - ส่งจาก Originator -> Organization 1 -> Organization 2 -> Organization 3 แล้วส่งผลกลับตามลำดับเดิม (โดยถ้า องกรณ์ใดใน Workflow ให้ส่งกลับ ก็สามารถส่งผลกลับตามลำดับเดิมโดยไม่ต้องรอให้ถึง องกรณืในลำดับถัดไป) + - 3.6.6. การจัดการ: มีการจัดการอย่างน้อยดังนี้ + - สามารถกำหนดวันแล้วเสร็จ (Deadline) สำหรับผู้รับผิดชอบของ องกรณ์ ที่อยู่ใน Workflow ได้ + - มีระบบแจ้งเตือน ให้ผู้รับผิดชอบของ องกรณ์ ที่อยู่ใน Workflow ทราบ เมื่อมี RFA ใหม่ หรือมีการเปลี่ยนสถานะ +- **3.6.การจัดการเอกสารนำส่ง (Transmittals)** + - 3.6.1. วัตถุประสงค์: เอกสารนำส่ง ใช้สำหรับ นำส่ง Request for Approval (RFAS) หลายฉบับ ไปยังองค์กรอื่น + - 3.6.2. ประเภทเอกสาร: ไฟล์ PDF + - 3.6.3. การสร้างเอกสาร: ผู้ใช้ที่มีสิทธิ์ สามารถสร้างและแก้ไขได้ + - 3.6.4. การอ้างอิงและจัดกลุ่ม: เอกสารนำส่ง เป็นส่วนหนึ่งใน Correspondence +- **3.7. ใบเวียนเอกสาร (Circulation Sheet)** + - 3.7.1. วัตถุประสงค์: การสื่อสาร เอกสาร (Correspondence) ทุกฉบับ จะมีใบเวียนเอกสารเพื่อควบคุมและมอบหมายงานภายในองค์กร (สามารถดูและแก้ไขได้เฉพาะคนในองค์กร) + - 3.7.2. ประเภทเอกสาร: ไฟล์ PDF + - 3.7.3. การสร้างเอกสาร: ผู้ใช้ที่มีสิทธิ์ในองค์กรนั้น สามารถสร้างและแก้ไขได้ + - 3.7.4. การอ้างอิงและจัดกลุ่ม: การระบุผู้รับผิดชอบ: + - ผู้รับผิดชอบหลัก (Main): มีได้หลายคน + - ผู้ร่วมปฏิบัติงาน (Action): มีได้หลายคน + - ผู้ที่ต้องรับทราบ (Information): มีได้หลายคน + - 3.7.5. การติดตามงาน: + - สามารถกำหนดวันแล้วเสร็จ (Deadline) สำหรับผู้รับผิดชอบประเภท Main และ Action ได้ + - มีระบบแจ้งเตือนเมื่อมี Circulation ใหม่ และแจ้งเตือนล่วงหน้าก่อนถึงวันแล้วเสร็จ + - สามารถปิด Circulation ได้เมื่อดำเนินการตอบกลับไปยังองค์กรผู้ส่ง (Originator) แล้ว หรือ รับทราบแล้ว (For Information) +- **3.8. ประวัติการแก้ไข (Revisions):** ระบบจะเก็บประวัติการสร้างและแก้ไข เอกสารทั้งหมด +- **3.9. การจัดเก็บ: (ปรับปรุงตามสถาปัตยกรรมใหม่)** + - เอกสารและไฟล์แนบทั้งหมดจะถูกจัดเก็บในโฟลเดอร์บน Server (/share/dms-data/) [cite: 2.1] + - ข้อมูล Metadata ของไฟล์ (เช่น ชื่อไฟล์, ขนาด, path) จะถูกเก็บในตาราง attachments (ตารางกลาง) + - ไฟล์จะถูกเชื่อมโยงกับเอกสารประเภทต่างๆ ผ่านตารางเชื่อม (Junction tables) เช่น correspondence_attachments, circulation_attachments, shop_drawing_revision_attachments ,และ contracy_drawing_attachments + - สถาปัตยกรรมแบบรวมศูนย์นี้ _แทนที่_ แนวคิดเดิมที่จะแยกโฟลเดอร์ตามประเภทเอกสาร เพื่อรองรับการขยายระบบที่ดีกว่า +- **3.10. การจัดการเลขที่เอกสาร (Document Numbering):** + - 3.10.1. ระบบต้องสามารถสร้างเลขที่เอกสาร (เช่น correspondence_number) ได้โดยอัตโนมัติ + - 3.10.2. การนับเลข Running Number (SEQ) จะต้องนับแยกตาม Key ดังนี้: **โครงการ (Project)**, **องค์กรผู้ส่ง (Originator Organization)**, **ประเภทเอกสาร (Document Type)** และ **ปีปัจจุบัน (Year)** + - 3.10.3. ผู้ดูแลระบบ (Admin) ต้องสามารถกำหนด "รูปแบบ" (Format Template) ของเลขที่เอกสารได้ (เช่น {ORG_CODE}-{TYPE_CODE}-{YEAR_SHORT}-{SEQ:4}) โดยกำหนดแยกตามโครงการและประเภทเอกสาร + +## **🔐 4. ข้อกำหนดด้านสิทธิ์และการเข้าถึง (Access Control Requirements)** + +- **4.1. ภาพรวม:** ผู้ใช้และองค์กรสามารถดูและแก้ไขเอกสารได้ตามสิทธิ์ที่ได้รับ โดยระบบสิทธิ์จะเป็นแบบ Role-Based Access Control (RBAC) +- **4.2. ลำดับชั้นของสิทธิ์ (Permission Hierarchy)** + + - Global: สิทธิ์สูงสุดของระบบ + - Organization: สิทธิ์ภายในองค์กร เป็นสิทธิ์พื้นฐานของผู้ใช้ + - Project: สิทธิ์เฉพาะในโครงการ จะถูกพิจารณาเมื่อผู้ใช้อยู่ในโครงการนั้น + - Contract: สิทธิ์เฉพาะในสัญญา จะถูกพิจารณาเมื่อผู้ใช้อยู่ในสัญญานั้น (สัญญาเป็นส่วนหนึ่งของโครงการ) + + กฎการบังคับใช้: เมื่อตรวจสอบสิทธิ์ ระบบจะพิจารณาสิทธิ์จากทุกระดับที่ผู้ใช้มี และใช้ สิทธิ์ที่มากที่สุด (Most Permissive) เป็นตัวตัดสิน + + ตัวอย่าง: ผู้ใช้ A เป็น Viewer ในองค์กร แต่ถูกมอบหมายเป็น Editor ในโครงการ X เมื่ออยู่ในโครงการ X ผู้ใช้ A จะมีสิทธิ์แก้ไขได้ + +- **4.3. การกำหนดบทบาท (Roles) และขอบเขต (Scope)** + +| บทบาท (Role) | ขอบเขต (Scope) | คำอธิบาย | สิทธิ์หลัก (Key Permissions) | +| :------------------- | :------------- | :---------------------- | :------------------------------------------------------------------------------------- | +| **Superadmin** | Global | ผู้ดูแลระบบสูงสุด | ทำทุกอย่างในระบบ, จัดการองค์กร, จัดการข้อมูลหลักระดับ Global | +| **Org Admin** | Organization | ผู้ดูแลองค์กร | จัดการผู้ใช้ในองค์กร, จัดการบทบาท/สิทธิ์ภายในองค์กร, ดูรายงานขององค์กร | +| **Document Control** | Organization | ควบคุมเอกสารขององค์กร | เพิ่ม/แก้ไข/ลบเอกสาร, กำหนดสิทธิ์เอกสารภายในองค์กร | +| **Editor** | Organization | ผู้แก้ไขเอกสารขององค์กร | เพิ่ม/แก้ไขเอกสารที่ได้รับมอบหมาย | +| **Viewer** | Organization | ผู้ดูเอกสารขององค์กร | ดูเอกสารที่มีสิทธิ์เข้าถึง | +| **Project Manager** | Project | ผู้จัดการโครงการ | จัดการสมาชิกในโครงการ (เพิ่ม/ลบ/มอบบทบาท), สร้าง/จัดการสัญญาในโครงการ, ดูรายงานโครงการ | +| **Contract Admin** | Contract | ผู้ดูแลสัญญา | จัดการสมาชิกในสัญญา, สร้าง/จัดการข้อมูลหลักเฉพาะสัญญา (ถ้ามี), อนุมัติเอกสารในสัญญา | + +- **4.4. กระบวนการเริ่มต้นใช้งาน (Onboarding Workflow) ที่สมบูรณ์** + + - 4.1. **สร้างองค์กร (Organization)** + + - **Superadmin** สร้างองค์กรใหม่ (เช่น บริษัท A) + - **Superadmin** แต่งตั้งผู้ใช้อย่างน้อย 1 คนให้เป็น **Org Admin** หรือ **Document Control** ของบริษัท A + + - 4.2. **เพิ่มผู้ใช้ในองค์กร** + + - **Org Admin** ของบริษัท A เพิ่มผู้ใช้อื่นๆ (Editor, Viewer) เข้ามาในองค์กรของตน + + - 4.3. **มอบหมายผู้ใช้ให้กับโครงการ (Project)** + + - **Project Manager** ของโครงการ X (ซึ่งอาจมาจากบริษัท A หรือบริษัทอื่น) ทำการ "เชิญ" หรือ "มอบหมาย" ผู้ใช้จากองค์กรต่างๆ ที่เกี่ยวข้องเข้ามาในโครงการ X + - ในขั้นตอนนี้ **Project Manager** จะกำหนด **บทบาทระดับโครงการ** (เช่น Project Member, หรืออาจไม่มีบทบาทพิเศษ ให้ใช้สิทธิ์จากระดับองค์กรไปก่อน) + + - 4.4. **เมอบหมายผู้ใช้ให้กับสัญญา (Contract)** + - **Contract Admin** ของสัญญา Y (ซึ่งเป็นส่วนหนึ่งของโครงการ X) ทำการเลือกผู้ใช้ที่อยู่ในโครงการ X แล้ว มอบหมายให้เข้ามาในสัญญา Y + - ในขั้นตอนนี้ **Contract Admin** จะกำหนด **บทบาทระดับสัญญา** (เช่น Contract Member) และสิทธิ์เฉพาะที่จำเป็น + +- **4.5. การจัดการข้อมูลหลัก (Master Data Management) ที่แบ่งตามระดับ** + +| ข้อมูลหลัก | ผู้มีสิทธิ์จัดการ | ระดับ | +| :---------------------------------- | :------------------------------ | :--------------------------------- | +| ประเภทเอกสาร (Correspondence, RFA) | **Superadmin** | Global | +| สถานะเอกสาร (Draft, Approved, etc.) | **Superadmin** | Global | +| หมวดหมู่แบบ (Shop Drawing) | **Project Manager** | Project (สร้างใหม่ได้ภายในโครงการ) | +| Tags | **Org Admin / Project Manager** | Organization / Project | +| บทบาทและสิทธิ์ (Custom Roles) | **Superadmin / Org Admin** | Global / Organization | + +## **👥 5. ข้อกำหนดด้านผู้ใช้งาน (User Interface & Experience)** + +- **5.1. Layout หลัก:** หน้าเว็บใช้รูปแบบ App Shell ที่ประกอบด้วย: + - Navbar (ส่วนบน): แสดงชื่อระบบ, เมนูผู้ใช้ (Profile), เมนูสำหรับ Document Control/เมนูสำหรับ Admin/Superadmin (จัดการผู้ใช้, จัดการสิทธิ์), และปุ่ม Login/Logout + - Sidebar (ด้านข้าง): เป็นเมนูหลักสำหรับเข้าถึงส่วนที่เกี่ยวกับเอกสารทั้งหมด เช่น Dashboard, Correspondences, RFA, Drawings + - Main Content Area: พื้นที่สำหรับแสดงเนื้อหาหลักของหน้าที่เลือก +- **5.2. หน้า Landing Page:** เป็นหน้าแรกที่แสดงข้อมูลบางส่วนของโครงการสำหรับผู้ใช้ที่ยังไม่ได้ล็อกอิน +- **5.3. หน้า Dashboard:** เป็นหน้าแรกหลังจากล็อกอิน ประกอบด้วย: + - การ์ดสรุปภาพรวม (KPI Cards): แสดงข้อมูลสรุปที่สำคัญขององค์กร เช่น จำนวนเอกสาร, งานที่เกินกำหนด + - ตาราง "งานของฉัน" (My Tasks Table): แสดงรายการงานทั้งหมดจาก Circulation ที่ผู้ใช้ต้องดำเนินการ +- **5.4. การติดตามสถานะ:** องค์กรสามารถติดตามสถานะเอกสารทั้งของตนเอง (Originator) และสถานะเอกสารที่ส่งมาถึงตนเอง (Recipient) +- **5.5. การจัดการข้อมูลส่วนตัว (Profile Page):** ผู้ใช้สามารถจัดการข้อมูลส่วนตัวและเปลี่ยนรหัสผ่านของตนเองได้ +- **5.6. การจัดการเอกสารทางเทคนิค (RFA & Workflow):** ผู้ใช้สามารถดู RFA ในรูปแบบ Workflow ทั้งหมดได้ในหน้าเดียว, ขั้นตอนที่ยังไม่ถึงหรือผ่านไปแล้วจะเป็นรูปแบบ diable, สามารถดำเนินการได้เฉพาะในขั้นตอนที่ได้รับมอบหมายงาน (active) เช่น ตรวจสอบแล้ว เพื่อไปยังขั้นตอนต่อไป, สิทธิ์ Document Control ขึ้นไป สามรถกด ไปยังขั้นตอนต่อไป ได้ทุกขั้นตอน, การย้อนกลับ ไปขั้นตอนก่อนหน้า สามารถทำได้โดย สิทธิ์ Document Control ขึ้นไป +- **5.7. การจัดการใบเวียนเอกสาร (Circulation):** ผู้ใช้สามารถดู Circulation ในรูปแบบ Workflow ทั้งหมดได้ในหน้าเดียว,ขั้นตอนที่ยังไม่ถึงหรือผ่านไปแล้วจะเป็นรูปแบบ diable, สามารถดำเนินการได้เฉพาะในขั้นตอนที่ได้รับมอบหมายงาน (active) เช่น ตรวจสอบแล้ว เพื่อไปยังขั้นตอนต่อไป, สิทธิ์ Document Control ขึ้นไป สามรถกด ไปยังขั้นตอนต่อไป ได้ทุกขั้นตอน, การย้อนกลับ ไปขั้นตอนก่อนหน้า สามารถทำได้โดย สิทธิ์ Document Control ขึ้นไป +- **5.8. การจัดการเอกสารนำส่ง (Transmittals):** ผู้ใช้สามารถดู Transmittals ในรูปแบบรายการทั้งหมดได้ในหน้าเดียว +- **5.9. ข้อกำหนด UI/UX การแนบไฟล์ (File Attachment UX):** + - ระบบต้องรองรับการอัปโหลดไฟล์หลายไฟล์พร้อมกัน (Multi-file upload) เช่น การลากและวาง (Drag-and-Drop) + - ในหน้าอัปโหลด (เช่น สร้าง RFA หรือ Correspondence) ผู้ใช้ต้องสามารถกำหนดได้ว่าไฟล์ใดเป็น "เอกสารหลัก" (Main Document เช่น PDF) และไฟล์ใดเป็น "เอกสารแนบประกอบ" (Supporting Attachments เช่น .dwg, .docx, .zip) + +## **6. ข้อกำหนดที่ไม่ใช่ฟังก์ชันการทำงาน (Non-Functional Requirements)** + +- **6.1. การบันทึกการกระทำ (Audit Log):** ทุกการกระทำที่สำคัญของผู้ใช้ (สร้าง, แก้ไข, ลบ, ส่ง) จะถูกบันทึกไว้ใน audit_logs เพื่อการตรวจสอบย้อนหลัง +- **6.2. การค้นหา (Search):** ระบบต้องมีฟังก์ชันการค้นหาขั้นสูง ที่สามารถค้นหาเอกสาร **correspondence**, **rfa**, **shop_drawing**, **contract-drawing**, **transmittal** และ **ใบเวียน (Circulations)** จากหลายเงื่อนไขพร้อมกันได้ เช่น ค้นหาจากชื่อเรื่อง, ประเภท, วันที่, และ Tag +- **6.3. การทำรายงาน (Reporting):** สามารถจัดทำรายงานสรุปแยกประเภทของ Correspondence ประจำวัน, สัปดาห์, เดือน, และปีได้ +- **6.4. ประสิทธิภาพ (Performance):** มีการใช้ Caching กับข้อมูลที่เรียกใช้บ่อย และใช้ Pagination ในตารางข้อมูลเพื่อจัดการข้อมูลจำนวนมาก +- **6.5. ความปลอดภัย (Security):** + - มีระบบ Rate Limiting เพื่อป้องกันการโจมตีแบบ Brute-force + - การจัดการ Secret (เช่น รหัสผ่าน DB, JWT Secret) จะต้องทำผ่าน Environment Variable ของ Docker เพื่อความปลอดภัยสูงสุด +- **6.6. การสำรองข้อมูลและการกู้คืน (Backup & Recovery):** + - ระบบจะต้องมีกลไกการสำรองข้อมูลอัตโนมัติสำหรับฐานข้อมูล MariaDB [cite: 2.4] และไฟล์เอกสารทั้งหมดใน /share/dms-data [cite: 2.1] (เช่น ใช้ HBS 3 ของ QNAP หรือสคริปต์สำรองข้อมูล) อย่างน้อยวันละ 1 ครั้ง + - ต้องมีแผนการกู้คืนระบบ (Disaster Recovery Plan) ในกรณีที่ Server หลัก (QNAP) ใช้งานไม่ได้ +- **6.7. กลยุทธ์การแจ้งเตือน (Notification Strategy):** + - ระบบจะส่งการแจ้งเตือน (ผ่าน Email หรือ Line [cite: 2.7]) เมื่อมีการกระทำที่สำคัญ ดังนี้: + 1. เมื่อมีเอกสารใหม่ (Correspondence, RFA) ถูกส่งมาถึงองค์กรณ์ของเรา + 2. เมื่อมีใบเวียน (Circulation) ใหม่ มอบหมายงานมาที่เรา + 3. (ทางเลือก) เมื่อเอกสารที่เราส่งไป ถูกดำเนินการ (เช่น อนุมัติ/ปฏิเสธ) + 4. (ทางเลือก) เมื่อใกล้ถึงวันครบกำหนด (Deadline) [cite: 3.2.5, 3.6.6, 3.7.5] diff --git a/docs/LCBP3C2.ovpn b/docs/LCBP3C2.ovpn new file mode 100644 index 0000000..8737084 --- /dev/null +++ b/docs/LCBP3C2.ovpn @@ -0,0 +1,45 @@ +## How to setup OpenVPN client? +## 1. Install OpenVPN software on your platform. +## 2. Double click LCBP3C2.ovpn file to create new connection profile. +## 3. Type username and password while connection. + +client +dev tun +script-security 3 +remote 159.192.126.103 1194 +resolv-retry infinite +nobind +auth-nocache +auth-user-pass +remote-cert-tls server +reneg-sec 0 +cipher AES-128-CBC +tls-cipher TLS-ECDHE-RSA-WITH-AES-256-GCM-SHA384:TLS-ECDHE-ECDSA-WITH-AES-256-GCM-SHA384:TLS-DHE-RSA-WITH-AES-256-GCM-SHA384:TLS-DHE-RSA-WITH-AES-256-CBC-SHA256:TLS-DHE-RSA-WITH-AES-128-CBC-SHA256 +comp-lzo +proto udp +explicit-exit-notify 1 + +-----BEGIN CERTIFICATE----- +MIID2zCCA0SgAwIBAgIUBaWIp2IXBo22znekNT/ua2FyXuYwDQYJKoZIhvcNAQEL +BQAwgZ4xCzAJBgNVBAYTAlRXMQ8wDQYDVQQIEwZUYWl3YW4xDzANBgNVBAcTBlRh +aXBlaTEaMBgGA1UEChMRUU5BUCBTeXN0ZW1zIEluYy4xDDAKBgNVBAsTA05BUzEW +MBQGA1UEAxMNVFMgU2VyaWVzIE5BUzEMMAoGA1UEKRMDTkFTMR0wGwYJKoZIhvcN +AQkBFg5hZG1pbkBxbmFwLmNvbTAeFw0yNTEwMjIxNzAyNDFaFw0zNTEwMjAxNzAy +NDFaMIGeMQswCQYDVQQGEwJUVzEPMA0GA1UECBMGVGFpd2FuMQ8wDQYDVQQHEwZU +YWlwZWkxGjAYBgNVBAoTEVFOQVAgU3lzdGVtcyBJbmMuMQwwCgYDVQQLEwNOQVMx +FjAUBgNVBAMTDVRTIFNlcmllcyBOQVMxDDAKBgNVBCkTA05BUzEdMBsGCSqGSIb3 +DQEJARYOYWRtaW5AcW5hcC5jb20wgZ8wDQYJKoZIhvcNAQEBBQADgY0AMIGJAoGB +ALBqU2XV3yBuKLKVUHom4IoKxUUAkUZ2BNuPFUhRP8lDFVVaYq0MfNZD1DkblCSu +YDeuaWERz2/M4XJ45mEyuSiUy74dHCYMp+JzeRnBnT0d8jXwjBAGXBTGhzgm5F28 +bgXgJKfXAd41xjxWtgQbFHgY6sctoHgKbmnzrEZR7QypAgMBAAGjggESMIIBDjAd +BgNVHQ4EFgQUGgFl+Hy1Ry4AMr2ZuFXVJen0GPgwgd4GA1UdIwSB1jCB04AUGgFl ++Hy1Ry4AMr2ZuFXVJen0GPihgaSkgaEwgZ4xCzAJBgNVBAYTAlRXMQ8wDQYDVQQI +EwZUYWl3YW4xDzANBgNVBAcTBlRhaXBlaTEaMBgGA1UEChMRUU5BUCBTeXN0ZW1z +IEluYy4xDDAKBgNVBAsTA05BUzEWMBQGA1UEAxMNVFMgU2VyaWVzIE5BUzEMMAoG +A1UEKRMDTkFTMR0wGwYJKoZIhvcNAQkBFg5hZG1pbkBxbmFwLmNvbYIUBaWIp2IX +Bo22znekNT/ua2FyXuYwDAYDVR0TBAUwAwEB/zANBgkqhkiG9w0BAQsFAAOBgQBs +2+aU5QbKV9Is2MPLZLINaSPUs5ZFndiMYVzd4WsoEvZebpAOk07RiopIVANdsw/Q +gs9ZDRzaCTFFxFBM4YOgl6RHo2GfqSDze1GHkrqPKH2u7Sqd6xk+bge2L0eN5F7d +yMIK4go4ydLAqXZWom6ASEtz8zBXS+tMnCH+SULeLg== +-----END CERTIFICATE----- + diff --git a/docs/Markdown/FullStackJS_Guidelines.md b/docs/Markdown/FullStackJS_Guidelines.md new file mode 100644 index 0000000..5782d29 --- /dev/null +++ b/docs/Markdown/FullStackJS_Guidelines.md @@ -0,0 +1,192 @@ +# FullStackJS Development Guidelines + +## 🧠 General Philosophy + +Unified best practices for **NestJS Backend**, **NextJS Frontend**, and **Bootstrap-based UI/UX** development in TypeScript environments. +Focus on **clarity**, **maintainability**, **consistency**, and **accessibility** across the entire stack. + +--- + +## ⚙️ TypeScript General Guidelines + +### Basic Principles +- Use **English** for all code and documentation. +- Explicitly type all variables, parameters, and return values. +- Avoid `any`; create custom types or interfaces. +- Use **JSDoc** for public classes and methods. +- Export only **one main symbol** per file. +- Avoid blank lines within functions. + +### Naming Conventions +| Entity | Convention | Example | +|:--|:--|:--| +| Classes | PascalCase | `UserService` | +| Variables & Functions | camelCase | `getUserInfo` | +| Files & Folders | kebab-case | `user-service.ts` | +| Environment Variables | UPPERCASE | `DATABASE_URL` | +| Booleans | Verb + Noun | `isActive`, `canDelete`, `hasPermission` | + +Use full words — no abbreviations — except for standard ones (`API`, `URL`, `req`, `res`, `err`, `ctx`). + +--- + +## 🧩 Functions + +- Write short, single-purpose functions (<20 lines). +- Use **early returns** to reduce nesting. +- Use **map**, **filter**, **reduce** instead of loops when suitable. +- Prefer **arrow functions** for short logic, **named functions** otherwise. +- Use **default parameters** over null checks. +- Group multiple parameters into a single object (RO-RO pattern). +- Return typed objects, not primitives. +- Maintain a single abstraction level per function. + +--- + +## 🧱 Data Handling + +- Encapsulate data in composite types. +- Use **immutability** with `readonly` and `as const`. +- Perform validations in classes or DTOs, not within business functions. +- Always validate data using typed DTOs. + +--- + +## 🧰 Classes + +- Follow **SOLID** principles. +- Prefer **composition over inheritance**. +- Define **interfaces** for contracts. +- Keep classes focused and small (<200 lines, <10 methods, <10 properties). + +--- + +## 🚨 Error Handling + +- Use exceptions for unexpected errors. +- Catch only to fix or add context; otherwise, use global error handlers. +- Always provide meaningful error messages. + +--- + +## 🧪 Testing (General) + +- Use the **Arrange–Act–Assert** pattern. +- Use descriptive test variable names (`inputData`, `expectedOutput`). +- Write **unit tests** for all public methods. +- Mock external dependencies. +- Add **acceptance tests** per module using Given–When–Then. + +--- + +# 🏗️ Backend (NestJS) + +### Principles +- **Modular architecture**: + - One module per domain. + - Controller → Service → Model structure. +- DTOs validated with **class-validator**. +- Use **MikroORM** or equivalent for persistence. +- Encapsulate reusable code in a **common module** (`@app/common`): + - Configs, decorators, DTOs, guards, interceptors, notifications, shared services, types, validators. + +### Core Functionalities +- Global **filters** for exception handling. +- **Middlewares** for request handling. +- **Guards** for permissions and RBAC. +- **Interceptors** for response transformation and logging. + +### Testing +- Use **Jest** for testing. +- Test each controller and service. +- Add `admin/test` endpoint as a smoke test. + +--- + +# 🖥️ Frontend (NextJS / React) + +### Developer Profile +Senior-level TypeScript + React/NextJS engineer. +Expert in **TailwindCSS**, **Shadcn/UI**, and **Radix** for UI development. + +### Code Implementation Guidelines +- Use **early returns** for clarity. +- Always style with **TailwindCSS** classes. +- Prefer `class:` conditional syntax over ternary operators. +- Use **const arrow functions** for components and handlers. +- Event handlers start with `handle...` (e.g., `handleClick`, `handleSubmit`). +- Include accessibility attributes: + `tabIndex="0"`, `aria-label`, `onKeyDown`, etc. +- Ensure all code is **complete**, **tested**, and **DRY**. +- Always import required modules explicitly. + +### UI/UX with React +- Use **semantic HTML**. +- Apply **responsive Tailwind** classes. +- Maintain visual hierarchy with typography and spacing. +- Use **Shadcn** components for consistent UI. +- Keep components small and focused. + +--- + +# 🎨 UI/UX (Bootstrap Integration) + +### Key Principles +- Use **Bootstrap 5+** for responsive design and consistent UI. +- Focus on **maintainability**, **readability**, and **accessibility**. +- Use clear and descriptive class names. + +### Bootstrap Usage +- Structure layout with **container**, **row**, **col**. +- Use built-in **components** (buttons, modals, alerts, etc.) instead of custom CSS. +- Apply **utility classes** for quick styling (spacing, colors, text, etc.). +- Ensure **ARIA compliance** and semantic markup. + +### Form Validation & Errors +- Use Bootstrap’s built-in validation states. +- Show errors with **alert components**. +- Include labels, placeholders, and feedback messages. + +### Dependencies +- Bootstrap (latest CSS + JS) +- Optionally jQuery (for legacy interactive components) + +### Bootstrap-Specific Guidelines +- Customize Bootstrap via **Sass variables** and **mixins**. +- Use responsive visibility utilities. +- Avoid overriding Bootstrap; extend it. +- Follow official documentation for examples. + +### Performance Optimization +- Include only necessary Bootstrap modules. +- Use CDN for assets and caching. +- Optimize images and assets for mobile. + +### Key Conventions +1. Follow Bootstrap’s naming and structure. +2. Prioritize **responsiveness** and **accessibility**. +3. Keep the file structure organized and modular. + +--- + +# 🔗 Full Stack Integration Guidelines + +| Aspect | Backend (NestJS) | Frontend (NextJS) | UI Layer (Bootstrap/Tailwind) | +|:--|:--|:--|:--| +| API | REST / GraphQL Controllers | API hooks via fetch/axios | Components consuming data | +| Validation | `class-validator` DTOs | `zod` / form-level validation | Bootstrap validation feedback | +| Auth | Guards, JWT | NextAuth / cookies | Auth UI states | +| Errors | Global filters | Toasts / modals | Alerts / feedback | +| Testing | Jest (unit/e2e) | Vitest / Playwright | Visual regression | +| Styles | Scoped modules | Tailwind / Shadcn | Bootstrap utilities | +| Accessibility | Guards + filters | ARIA attributes | Semantic HTML | + +--- + +# ✅ Final Notes + +- Use a **shared types package** (`@types/shared`) for consistent interfaces. +- Document your modules and APIs. +- Run lint, type-check, and tests before commit. +- Use **Prettier + ESLint** for consistent formatting. +- Prefer **clarity over cleverness** — readable code wins. diff --git a/docs/Markdown/FullStackJS_Guidelines01.md b/docs/Markdown/FullStackJS_Guidelines01.md new file mode 100644 index 0000000..a3f592a --- /dev/null +++ b/docs/Markdown/FullStackJS_Guidelines01.md @@ -0,0 +1,364 @@ +# FullStackJS Development Guidelines + +## 🧠 General Philosophy + +Unified best practices for **NestJS Backend**, **NextJS Frontend**, and **Bootstrap-based UI/UX** development in TypeScript environments. +Focus on **clarity**, **maintainability**, **consistency**, and **accessibility** across the entire stack. + +--- + +## ⚙️ TypeScript General Guidelines + +### Basic Principles +- Use **English** for all code and documentation. +- Explicitly type all variables, parameters, and return values. +- Avoid `any`; create custom types or interfaces. +- Use **JSDoc** for public classes and methods. +- Export only **one main symbol** per file. +- Avoid blank lines within functions. + +### Naming Conventions +| Entity | Convention | Example | +|:--|:--|:--| +| Classes | PascalCase | `UserService` | +| Variables & Functions | camelCase | `getUserInfo` | +| Files & Folders | kebab-case | `user-service.ts` | +| Environment Variables | UPPERCASE | `DATABASE_URL` | +| Booleans | Verb + Noun | `isActive`, `canDelete`, `hasPermission` | + +Use full words — no abbreviations — except for standard ones (`API`, `URL`, `req`, `res`, `err`, `ctx`). + +--- + +## 🧩 Functions + +- Write short, single-purpose functions (<20 lines). +- Use **early returns** to reduce nesting. +- Use **map**, **filter**, **reduce** instead of loops when suitable. +- Prefer **arrow functions** for short logic, **named functions** otherwise. +- Use **default parameters** over null checks. +- Group multiple parameters into a single object (RO-RO pattern). +- Return typed objects, not primitives. +- Maintain a single abstraction level per function. + +--- + +## 🧱 Data Handling + +- Encapsulate data in composite types. +- Use **immutability** with `readonly` and `as const`. +- Perform validations in classes or DTOs, not within business functions. +- Always validate data using typed DTOs. + +--- + +## 🧰 Classes + +- Follow **SOLID** principles. +- Prefer **composition over inheritance**. +- Define **interfaces** for contracts. +- Keep classes focused and small (<200 lines, <10 methods, <10 properties). + +--- + +## 🚨 Error Handling + +- Use exceptions for unexpected errors. +- Catch only to fix or add context; otherwise, use global error handlers. +- Always provide meaningful error messages. + +--- + +## 🧪 Testing (General) + +- Use the **Arrange–Act–Assert** pattern. +- Use descriptive test variable names (`inputData`, `expectedOutput`). +- Write **unit tests** for all public methods. +- Mock external dependencies. +- Add **acceptance tests** per module using Given–When–Then. + +--- + +# 🏗️ Backend (NestJS) + +### Principles +- **Modular architecture**: + - One module per domain. + - Controller → Service → Model structure. +- DTOs validated with **class-validator**. +- Use **MikroORM** or equivalent for persistence. +- Encapsulate reusable code in a **common module** (`@app/common`): + - Configs, decorators, DTOs, guards, interceptors, notifications, shared services, types, validators. + +### Core Functionalities +- Global **filters** for exception handling. +- **Middlewares** for request handling. +- **Guards** for permissions and RBAC. +- **Interceptors** for response transformation and logging. + +### Testing +- Use **Jest** for testing. +- Test each controller and service. +- Add `admin/test` endpoint as a smoke test. + +--- + +# 🖥️ Frontend (NextJS / React) + +### Developer Profile +Senior-level TypeScript + React/NextJS engineer. +Expert in **TailwindCSS**, **Shadcn/UI**, and **Radix** for UI development. + +### Code Implementation Guidelines +- Use **early returns** for clarity. +- Always style with **TailwindCSS** classes. +- Prefer `class:` conditional syntax over ternary operators. +- Use **const arrow functions** for components and handlers. +- Event handlers start with `handle...` (e.g., `handleClick`, `handleSubmit`). +- Include accessibility attributes: + `tabIndex="0"`, `aria-label`, `onKeyDown`, etc. +- Ensure all code is **complete**, **tested**, and **DRY**. +- Always import required modules explicitly. + +### UI/UX with React +- Use **semantic HTML**. +- Apply **responsive Tailwind** classes. +- Maintain visual hierarchy with typography and spacing. +- Use **Shadcn** components for consistent UI. +- Keep components small and focused. + +--- + +# 🎨 UI/UX (Bootstrap Integration) + +### Key Principles +- Use **Bootstrap 5+** for responsive design and consistent UI. +- Focus on **maintainability**, **readability**, and **accessibility**. +- Use clear and descriptive class names. + +### Bootstrap Usage +- Structure layout with **container**, **row**, **col**. +- Use built-in **components** (buttons, modals, alerts, etc.) instead of custom CSS. +- Apply **utility classes** for quick styling (spacing, colors, text, etc.). +- Ensure **ARIA compliance** and semantic markup. + +### Form Validation & Errors +- Use Bootstrap’s built-in validation states. +- Show errors with **alert components**. +- Include labels, placeholders, and feedback messages. + +### Dependencies +- Bootstrap (latest CSS + JS) +- Optionally jQuery (for legacy interactive components) + +### Bootstrap-Specific Guidelines +- Customize Bootstrap via **Sass variables** and **mixins**. +- Use responsive visibility utilities. +- Avoid overriding Bootstrap; extend it. +- Follow official documentation for examples. + +### Performance Optimization +- Include only necessary Bootstrap modules. +- Use CDN for assets and caching. +- Optimize images and assets for mobile. + +### Key Conventions +1. Follow Bootstrap’s naming and structure. +2. Prioritize **responsiveness** and **accessibility**. +3. Keep the file structure organized and modular. + +--- + +# 🔗 Full Stack Integration Guidelines + +| Aspect | Backend (NestJS) | Frontend (NextJS) | UI Layer (Bootstrap/Tailwind) | +|:--|:--|:--|:--| +| API | REST / GraphQL Controllers | API hooks via fetch/axios | Components consuming data | +| Validation | `class-validator` DTOs | `zod` / form-level validation | Bootstrap validation feedback | +| Auth | Guards, JWT | NextAuth / cookies | Auth UI states | +| Errors | Global filters | Toasts / modals | Alerts / feedback | +| Testing | Jest (unit/e2e) | Vitest / Playwright | Visual regression | +| Styles | Scoped modules | Tailwind / Shadcn | Bootstrap utilities | +| Accessibility | Guards + filters | ARIA attributes | Semantic HTML | + +--- + +# ✅ Final Notes + +- Use a **shared types package** (`@types/shared`) for consistent interfaces. +- Document your modules and APIs. +- Run lint, type-check, and tests before commit. +- Use **Prettier + ESLint** for consistent formatting. +- Prefer **clarity over cleverness** — readable code wins. + + +--- + +# 🗂️ DMS-Specific Conventions (Document Management System) + +This section extends the general FullStackJS guidelines for projects similar to **np‑dms.work**, focusing on document approval workflows (RFA, Drawing, Contract, Revision, Transmittal, Report). + +## 🧱 Backend Domain Modules + +Use modular domain structure per document type: + +``` +src/ + ├─ modules/ + │ ├─ rfas/ + │ ├─ drawings/ + │ ├─ contracts/ + │ ├─ transmittals/ + │ ├─ audit-log/ + │ ├─ users/ + │ └─ common/ +``` + +### Naming Convention +| Entity | Example | +|:--|:--| +| Table | `rfa_revisions`, `drawing_contracts` | +| DTO | `CreateRfaDto`, `UpdateContractDto` | +| Controller | `rfas.controller.ts` | +| Service | `rfas.service.ts` | + +--- + +## 🧩 RBAC & Permission Control + +Use decorators to enforce access rights: + +```ts +@RequirePermission('rfa.update') +@Put(':id') +updateRFA(@Param('id') id: string) { + return this.rfaService.update(id); +} +``` + +### Roles +- **Admin**: Full access to all modules. +- **Editor**: Modify data within assigned modules. +- **Viewer**: Read‑only access. + +### Permissions +- `rfa.create`, `rfa.update`, `rfa.delete`, `rfa.view` +- `drawing.upload`, `drawing.map`, `drawing.view` +- `contract.assign`, `contract.view` + +Seed mapping between roles and permissions via seeder scripts. + +--- + +## 🧾 AuditLog Standard + +Log all CRUD and mapping operations: + +| Field | Description | +|:--|:--| +| `actor_id` | user performing the action | +| `module_name` | e.g. `rfa`, `drawing` | +| `action` | `create`, `update`, `delete`, `map` | +| `target_id` | primary id of the record | +| `timestamp` | UTC timestamp | +| `description` | contextual note | + +Example implementation: + +```ts +await this.auditLogService.log({ + actorId: user.id, + moduleName: 'rfa', + action: 'update', + targetId: rfa.id, + description: `Updated revision ${rev}`, +}); +``` + +--- + +## 📂 File Handling + +### File Upload Standard +- Upload path: `/storage/{year}/{month}/` +- File naming: `{drawing_code}_{revision}_{timestamp}.pdf` +- Allowed types: `pdf, dwg, docx, xlsx, zip` +- Max size: **50 MB** +- Store outside webroot. +- Serve via secure endpoint `/files/:id/download`. + +### Access Control +Each file download must verify user permission (`hasPermission('drawing.view')`). + +--- + +## 📊 Reporting & Exports + +| Report | Description | +|:--|:--| +| **Report A** | RFA → Drawings → All Drawing Revisions | +| **Report B** | RFA Revision Timeline vs Drawing Revision | +| **Dashboard KPI** | RFAs, Drawings, Revisions, Transmittals summary | + +### Export Rules +- Export formats: CSV, Excel, PDF. +- Provide print view. +- Include source entity link (e.g., `/rfas/:id`). + +--- + +## 🧮 Frontend: DataTable & Form Patterns + +### DataTable (Server‑Side) +- Endpoint: `/api/{module}?page=1&pageSize=20` +- Must support: pagination, sorting, search, filters. +- Always display latest revision inline (for RFA/Drawing). + +### Form Standards +- Dependent dropdowns: + - Contract → Subcategory + - RFA → Related Drawing +- File upload: preview + validation. +- Submit via API with toast feedback. + +--- + +## 🧭 Dashboard & Activity Feed + +### Dashboard Cards +- Show latest RFA, Drawing, Transmittal, KPI summary. +- Include quick links to modules. + +### Activity Feed +- Display recent AuditLog actions (10 latest). + +```ts +// Example response +[ + { user: 'admin', action: 'Updated RFA 023-Rev02', time: '2025‑11‑04T09:30Z' } +] +``` + +--- + +## ✅ Integration Summary + +| Aspect | Backend | Frontend | Description | +|:--|:--|:--| +| **File Handling** | Secure storage, token check | Upload/Preview UI | Consistent standard path | +| **RBAC** | `RequirePermission` guard | Hide/disable UI actions | Unified permission logic | +| **AuditLog** | Persist actions | Show in dashboard | Traceable user activity | +| **Reports** | Aggregation queries | Export + Print | Consistent data pipeline | +| **DataTables** | Server‑side paging | Filter/Search UI | Scalable dataset management | + +--- + +## 🧩 Recommended Enhancements + +- ✅ Add `deleted_at` for soft delete + restore. +- ✅ Fulltext search + date filters. +- ✅ Background job for RFA deadline reminders. +- ✅ Optimize DB with indexes on `rfa_id`, `drawing_id`, `contract_id`. +- ✅ Periodic cleanup for unused file uploads. + +--- diff --git a/docs/Markdown/LCBP3-DMS Backend Documentation (ฉบับสมบูรณ์) b/docs/Markdown/LCBP3-DMS Backend Documentation (ฉบับสมบูรณ์) new file mode 100644 index 0000000..cab3edc --- /dev/null +++ b/docs/Markdown/LCBP3-DMS Backend Documentation (ฉบับสมบูรณ์) @@ -0,0 +1,588 @@ +From: +Snapshot-Content-Location: https://docs.google.com/document/u/0/d/1KfeiWDih7G3I40FtWma7Eab3OUDqeIK3os240-At5cA/mobilebasic?hl=th-TH&pli=1 +Subject: =?utf-8?Q?LCBP3-DMS=20Backend=20Documentation=20(=E0=B8=89=E0=B8=9A=E0=B8?= + =?utf-8?Q?=B1=E0=B8=9A=E0=B8=AA=E0=B8=A1=E0=B8=9A=E0=B8=B9=E0=B8=A3=E0=B8?= + =?utf-8?Q?=93=E0=B9=8C)?= +Date: Thu, 16 Oct 2025 23:04:32 +0700 +MIME-Version: 1.0 +Content-Type: multipart/related; + type="text/html"; + boundary="----MultipartBoundary--VhiUdJuxlxmxWrLaXiSlRP2gfR2PuYkGvhdYgSLHby----" + + +------MultipartBoundary--VhiUdJuxlxmxWrLaXiSlRP2gfR2PuYkGvhdYgSLHby---- +Content-Type: text/html +Content-ID: +Content-Transfer-Encoding: binary +Content-Location: https://docs.google.com/document/u/0/d/1KfeiWDih7G3I40FtWma7Eab3OUDqeIK3os240-At5cA/mobilebasic?hl=th-TH&pli=1 + +LCBP3-DMS Backend Documentation (ฉบับสมบูรณ์)
LCBP3-DMS Backend Documentation (ฉบับสมบูรณ์)

LCBP3-DMS: Backend Documentation (ฉบับสมบูรณ์)

เอกสารนี้รวบรวมรายละเอียดทั้งหมดของส่วน Backend สำหรับระบบ LCBP3 Document Management System ซึ่งพัฒนาด้วย NestJS Framework ประกอบด้วยขั้นตอนการติดตั้ง, สถาปัตยกรรม, และซอร์สโค้ดทั้งหมดของโปรเจกต์

1. ข้อกำหนดเบื้องต้น (Prerequisites)

ก่อนเริ่มการติดตั้งและพัฒนา คุณจะต้องมีเครื่องมือต่อไปนี้ติดตั้งบนเครื่องคอมพิวเตอร์ของคุณ:

  • Node.js: เวอร์ชัน 18.x หรือสูงกว่า
  • NPM หรือ Yarn: ตัวจัดการ Package (มาพร้อมกับ Node.js)
  • NestJS CLI: ติดตั้งผ่านคำสั่ง npm install -g @nestjs/cli
  • Git: สำหรับการ Clone โปรเจกต์จาก Gitea
  • Docker: (แนะนำ) สำหรับการรันฐานข้อมูล MariaDB ในสภาพแวดล้อมที่เหมือนกับ Production

2. ขั้นตอนการติดตั้งและเริ่มใช้งาน (Installation & Setup)

  1. Clone โปรเจกต์:
  • คัดลอกโปรเจกต์จาก Gitea repository ของคุณมาไว้ที่เครื่อง

<!-- end list -->git clone [http://git.np-dms.work/your-repo/backend-np-dms.git](http://git.np-dms.work/your-repo/backend-np-dms.git)
cd backend-np-dms

  1. ติดตั้ง Dependencies:
  • ใช้ npm เพื่อติดตั้ง Library ทั้งหมดที่โปรเจกต์ต้องการ

<!-- end list -->npm install

  1. ตั้งค่า Environment File:
  • สร้างไฟล์ใหม่ชื่อ .env ที่รากของโปรเจกต์
  • คัดลอกเนื้อหาจากไฟล์ .env.example (ถ้ามี) หรือใช้โครงสร้างด้านล่าง แล้วแก้ไขค่าให้ตรงกับสภาพแวดล้อมของคุณ (โดยเฉพาะข้อมูลการเชื่อมต่อฐานข้อมูล)

ไฟล์ .env (ตัวอย่าง):# Database Configuration
DB_TYPE=mysql
DB_HOST=localhost
DB_PORT=3306
DB_USERNAME=your_db_user
DB_PASSWORD=your_db_password
DB_DATABASE=dms_db

# JWT Configuration
JWT_SECRET=your_super_long_and_random_jwt_secret

# Application Configuration
API_PORT=3001

  1. เริ่มต้นฐานข้อมูล:
  • ตรวจสอบให้แน่ใจว่า MariaDB Server ของคุณกำลังทำงาน
  • สร้างฐานข้อมูลชื่อ dms_db (หรือตามที่คุณตั้งค่าใน .env)
  • นำไฟล์ SQL Scripts (01_..., 05_..., 06_...) ไปรันในฐานข้อมูลเพื่อสร้างตารางและใส่ข้อมูลเริ่มต้น
  1. รันแอปพลิเคชัน (Development Mode):
  • ใช้คำสั่งนี้เพื่อเริ่ม Backend server ในโหมดพัฒนา ซึ่งจะมีการรีสตาร์ทอัตโนมัติเมื่อมีการแก้ไขโค้ด

<!-- end list -->npm run start:dev

  1. ตรวจสอบการทำงาน:
  • หากทุกอย่างถูกต้อง คุณจะเห็น Log การเริ่มต้นทำงานและเชื่อมต่อฐานข้อมูลใน Terminal
  • เปิดเว็บเบราว์เซอร์แล้วไปที่ http://localhost:3001/api-docs เพื่อดูหน้าเอกสาร API ของ Swagger

3. สถาปัตยกรรมและโครงสร้างโปรเจกต์

Backend นี้ใช้สถาปัตยกรรมแบบ Modular ของ NestJS ซึ่งจัดระเบียบโค้ดตามฟังก์ชันการทำงาน (Feature) ทำให้ง่ายต่อการจัดการและขยายระบบ

โครงสร้างโฟลเดอร์หลัก:

src/
├── attachments/          # 📎 โมดูลจัดการไฟล์แนบ
├── audit-logs/           # 📋 โมดูลบันทึกการตรวจสอบ
├── auth/                 # 🔑 โมดูลยืนยันตัวตนและจัดการสิทธิ์
├── circulations/         # 🔄 โมดูลการเวียนเอกสาร
├── common/               # 🌐 โฟลเดอร์สำหรับโค้ดที่ใช้ร่วมกัน
├── contracts/            # 📑 โมดูลจัดการสัญญา
├── correspondences/      # 💌 โมดูลจัดการเอกสารหลัก
├── dashboard/            # 📊 โมดูลสำหรับ API หน้า Dashboard
├── drawings/             # 🖼️ โมดูลจัดการข้อมูล Drawing
├── lookup/               # 🗂️ โฟลเดอร์เก็บ Entity ที่เป็น Master Data
├── organizations/        # 🏢 โมดูลจัดการองค์กร
├── permissions/          # 🔐 โมดูลจัดการ Permissions
├── projects/             # 🏗️ โมดูลจัดการโครงการ
├── rbac/                 # 🧑‍💼 โมดูลจัดการการกำหนดสิทธิ์ (RBAC)
├── reports/              # 📈 โมดูลสร้างรายงาน
├── roles/                # 🛡️ โมดูลจัดการ Roles
├── tags/                 # 🏷️ โมดูลจัดการแท็ก
├── technical-docs/       # ⚙️ โมดูลเอกสารทางเทคนิค
├── users/                # 👤 โมดูลจัดการผู้ใช้
├── app.module.ts         # Root Module ที่รวบรวมทุก Module
└── main.ts               # ไฟล์เริ่มต้นของแอปพลิเคชัน

+------MultipartBoundary--VhiUdJuxlxmxWrLaXiSlRP2gfR2PuYkGvhdYgSLHby---- +Content-Type: text/css +Content-Transfer-Encoding: binary +Content-Location: https://themes.googleusercontent.com/fonts/css?kit=kbffV7V9BIH3Ot2AQ2LQRA + +@charset "utf-8"; + +@font-face { font-family: Courier; font-style: normal; font-weight: 400; src: url("https://fonts.gstatic.com/l/font?kit=i7dKIFtyYSaNG9A_JrmedWxeSFI&skey=415f62b718dd1a36&v=v12") format("woff2"); unicode-range: U+0-FF, U+131, U+152-153, U+2BB-2BC, U+2C6, U+2DA, U+2DC, U+304, U+308, U+329, U+2000-206F, U+20AC, U+2122, U+2191, U+2193, U+2212, U+2215, U+FEFF, U+FFFD; } +------MultipartBoundary--VhiUdJuxlxmxWrLaXiSlRP2gfR2PuYkGvhdYgSLHby---- +Content-Type: text/css +Content-Transfer-Encoding: binary +Content-Location: cid:css-a43a30ce-0932-481b-8734-60b84ca204e0@mhtml.blink + +@charset "utf-8"; + +@import url("https://themes.googleusercontent.com/fonts/css?kit=kbffV7V9BIH3Ot2AQ2LQRA"); + +ol.lst-kix_list_7-0 { list-style-type: none; } + +ul.lst-kix_list_1-0 { list-style-type: none; } + +ol.lst-kix_list_3-0 { list-style-type: none; } + +.lst-kix_list_3-0 > li::before { content: "" counter(lst-ctn-kix_list_3-0) ". "; } + +ul.lst-kix_list_5-7 { list-style-type: none; } + +ul.lst-kix_list_5-8 { list-style-type: none; } + +.lst-kix_list_3-1 > li::before { content: "○ "; } + +.lst-kix_list_3-2 > li::before { content: "■ "; } + +ul.lst-kix_list_5-5 { list-style-type: none; } + +ul.lst-kix_list_5-6 { list-style-type: none; } + +.lst-kix_list_8-1 > li::before { content: "○ "; } + +.lst-kix_list_4-0 > li { counter-increment: lst-ctn-kix_list_4-0 1; } + +.lst-kix_list_8-2 > li::before { content: "■ "; } + +.lst-kix_list_5-0 > li { counter-increment: lst-ctn-kix_list_5-0 1; } + +.lst-kix_list_6-0 > li { counter-increment: lst-ctn-kix_list_6-0 1; } + +.lst-kix_list_7-0 > li { counter-increment: lst-ctn-kix_list_7-0 1; } + +.lst-kix_list_8-0 > li { counter-increment: lst-ctn-kix_list_8-0 1; } + +ul.lst-kix_list_1-3 { list-style-type: none; } + +.lst-kix_list_3-5 > li::before { content: "■ "; } + +ul.lst-kix_list_1-4 { list-style-type: none; } + +ul.lst-kix_list_1-1 { list-style-type: none; } + +.lst-kix_list_3-4 > li::before { content: "■ "; } + +ul.lst-kix_list_1-2 { list-style-type: none; } + +ul.lst-kix_list_5-3 { list-style-type: none; } + +ul.lst-kix_list_1-7 { list-style-type: none; } + +.lst-kix_list_3-3 > li::before { content: "■ "; } + +ul.lst-kix_list_5-4 { list-style-type: none; } + +ul.lst-kix_list_1-8 { list-style-type: none; } + +ul.lst-kix_list_5-1 { list-style-type: none; } + +.lst-kix_list_8-0 > li::before { content: "" counter(lst-ctn-kix_list_8-0) ". "; } + +ul.lst-kix_list_1-5 { list-style-type: none; } + +ul.lst-kix_list_5-2 { list-style-type: none; } + +ul.lst-kix_list_1-6 { list-style-type: none; } + +.lst-kix_list_8-7 > li::before { content: "■ "; } + +.lst-kix_list_3-8 > li::before { content: "■ "; } + +.lst-kix_list_8-5 > li::before { content: "■ "; } + +.lst-kix_list_8-6 > li::before { content: "■ "; } + +.lst-kix_list_2-0 > li { counter-increment: lst-ctn-kix_list_2-0 1; } + +.lst-kix_list_8-3 > li::before { content: "■ "; } + +.lst-kix_list_3-6 > li::before { content: "■ "; } + +.lst-kix_list_3-7 > li::before { content: "■ "; } + +.lst-kix_list_8-4 > li::before { content: "■ "; } + +ol.lst-kix_list_5-0.start { counter-reset: lst-ctn-kix_list_5-0 0; } + +.lst-kix_list_8-8 > li::before { content: "■ "; } + +.lst-kix_list_5-0 > li::before { content: "" counter(lst-ctn-kix_list_5-0) ". "; } + +ol.lst-kix_list_6-0 { list-style-type: none; } + +ol.lst-kix_list_2-0 { list-style-type: none; } + +.lst-kix_list_4-8 > li::before { content: "■ "; } + +.lst-kix_list_5-3 > li::before { content: "■ "; } + +.lst-kix_list_4-7 > li::before { content: "■ "; } + +.lst-kix_list_5-2 > li::before { content: "■ "; } + +.lst-kix_list_5-1 > li::before { content: "○ "; } + +ul.lst-kix_list_4-8 { list-style-type: none; } + +.lst-kix_list_5-7 > li::before { content: "■ "; } + +ul.lst-kix_list_8-4 { list-style-type: none; } + +ul.lst-kix_list_8-5 { list-style-type: none; } + +ul.lst-kix_list_4-6 { list-style-type: none; } + +.lst-kix_list_5-6 > li::before { content: "■ "; } + +.lst-kix_list_5-8 > li::before { content: "■ "; } + +ul.lst-kix_list_8-2 { list-style-type: none; } + +ul.lst-kix_list_4-7 { list-style-type: none; } + +ul.lst-kix_list_8-3 { list-style-type: none; } + +ul.lst-kix_list_8-8 { list-style-type: none; } + +ul.lst-kix_list_8-6 { list-style-type: none; } + +ul.lst-kix_list_8-7 { list-style-type: none; } + +ul.lst-kix_list_4-1 { list-style-type: none; } + +.lst-kix_list_5-4 > li::before { content: "■ "; } + +ul.lst-kix_list_4-4 { list-style-type: none; } + +.lst-kix_list_5-5 > li::before { content: "■ "; } + +ul.lst-kix_list_4-5 { list-style-type: none; } + +ul.lst-kix_list_8-1 { list-style-type: none; } + +ul.lst-kix_list_4-2 { list-style-type: none; } + +ul.lst-kix_list_4-3 { list-style-type: none; } + +.lst-kix_list_6-1 > li::before { content: "○ "; } + +.lst-kix_list_6-3 > li::before { content: "■ "; } + +.lst-kix_list_6-0 > li::before { content: "" counter(lst-ctn-kix_list_6-0) ". "; } + +.lst-kix_list_6-4 > li::before { content: "■ "; } + +.lst-kix_list_3-0 > li { counter-increment: lst-ctn-kix_list_3-0 1; } + +ol.lst-kix_list_4-0.start { counter-reset: lst-ctn-kix_list_4-0 0; } + +.lst-kix_list_6-2 > li::before { content: "■ "; } + +.lst-kix_list_6-8 > li::before { content: "■ "; } + +ol.lst-kix_list_8-0.start { counter-reset: lst-ctn-kix_list_8-0 0; } + +.lst-kix_list_6-5 > li::before { content: "■ "; } + +.lst-kix_list_6-7 > li::before { content: "■ "; } + +.lst-kix_list_7-0 > li::before { content: "" counter(lst-ctn-kix_list_7-0) ". "; } + +.lst-kix_list_6-6 > li::before { content: "■ "; } + +ol.lst-kix_list_5-0 { list-style-type: none; } + +.lst-kix_list_2-6 > li::before { content: "■ "; } + +.lst-kix_list_2-7 > li::before { content: "■ "; } + +.lst-kix_list_7-4 > li::before { content: "■ "; } + +.lst-kix_list_7-6 > li::before { content: "■ "; } + +.lst-kix_list_2-4 > li::before { content: "■ "; } + +.lst-kix_list_2-5 > li::before { content: "■ "; } + +.lst-kix_list_2-8 > li::before { content: "■ "; } + +.lst-kix_list_7-1 > li::before { content: "○ "; } + +.lst-kix_list_7-5 > li::before { content: "■ "; } + +.lst-kix_list_7-2 > li::before { content: "■ "; } + +.lst-kix_list_7-3 > li::before { content: "■ "; } + +ul.lst-kix_list_7-5 { list-style-type: none; } + +ul.lst-kix_list_7-6 { list-style-type: none; } + +ul.lst-kix_list_7-3 { list-style-type: none; } + +ul.lst-kix_list_3-7 { list-style-type: none; } + +ul.lst-kix_list_7-4 { list-style-type: none; } + +ul.lst-kix_list_3-8 { list-style-type: none; } + +ul.lst-kix_list_7-7 { list-style-type: none; } + +ul.lst-kix_list_7-8 { list-style-type: none; } + +ol.lst-kix_list_3-0.start { counter-reset: lst-ctn-kix_list_3-0 0; } + +ul.lst-kix_list_3-1 { list-style-type: none; } + +ul.lst-kix_list_3-2 { list-style-type: none; } + +.lst-kix_list_7-8 > li::before { content: "■ "; } + +ul.lst-kix_list_7-1 { list-style-type: none; } + +ul.lst-kix_list_3-5 { list-style-type: none; } + +ul.lst-kix_list_7-2 { list-style-type: none; } + +ul.lst-kix_list_3-6 { list-style-type: none; } + +ul.lst-kix_list_3-3 { list-style-type: none; } + +.lst-kix_list_7-7 > li::before { content: "■ "; } + +ul.lst-kix_list_3-4 { list-style-type: none; } + +.lst-kix_list_4-0 > li::before { content: "" counter(lst-ctn-kix_list_4-0) ". "; } + +.lst-kix_list_4-1 > li::before { content: "○ "; } + +.lst-kix_list_4-4 > li::before { content: "■ "; } + +.lst-kix_list_4-3 > li::before { content: "■ "; } + +.lst-kix_list_4-5 > li::before { content: "■ "; } + +.lst-kix_list_4-2 > li::before { content: "■ "; } + +.lst-kix_list_4-6 > li::before { content: "■ "; } + +ol.lst-kix_list_7-0.start { counter-reset: lst-ctn-kix_list_7-0 0; } + +ol.lst-kix_list_4-0 { list-style-type: none; } + +ul.lst-kix_list_6-6 { list-style-type: none; } + +ul.lst-kix_list_6-7 { list-style-type: none; } + +ul.lst-kix_list_6-4 { list-style-type: none; } + +ul.lst-kix_list_2-8 { list-style-type: none; } + +ul.lst-kix_list_6-5 { list-style-type: none; } + +ul.lst-kix_list_6-8 { list-style-type: none; } + +ul.lst-kix_list_2-2 { list-style-type: none; } + +.lst-kix_list_1-0 > li::before { content: "● "; } + +ul.lst-kix_list_2-3 { list-style-type: none; } + +ul.lst-kix_list_2-1 { list-style-type: none; } + +ul.lst-kix_list_6-2 { list-style-type: none; } + +ol.lst-kix_list_8-0 { list-style-type: none; } + +ul.lst-kix_list_2-6 { list-style-type: none; } + +ul.lst-kix_list_6-3 { list-style-type: none; } + +.lst-kix_list_1-1 > li::before { content: "○ "; } + +.lst-kix_list_1-2 > li::before { content: "■ "; } + +ol.lst-kix_list_2-0.start { counter-reset: lst-ctn-kix_list_2-0 0; } + +ul.lst-kix_list_2-7 { list-style-type: none; } + +ul.lst-kix_list_2-4 { list-style-type: none; } + +ul.lst-kix_list_6-1 { list-style-type: none; } + +ul.lst-kix_list_2-5 { list-style-type: none; } + +.lst-kix_list_1-3 > li::before { content: "■ "; } + +.lst-kix_list_1-4 > li::before { content: "■ "; } + +.lst-kix_list_1-7 > li::before { content: "■ "; } + +.lst-kix_list_1-5 > li::before { content: "■ "; } + +.lst-kix_list_1-6 > li::before { content: "■ "; } + +.lst-kix_list_2-0 > li::before { content: "" counter(lst-ctn-kix_list_2-0) ". "; } + +.lst-kix_list_2-1 > li::before { content: "○ "; } + +ol.lst-kix_list_6-0.start { counter-reset: lst-ctn-kix_list_6-0 0; } + +.lst-kix_list_1-8 > li::before { content: "■ "; } + +.lst-kix_list_2-2 > li::before { content: "■ "; } + +.lst-kix_list_2-3 > li::before { content: "■ "; } +------MultipartBoundary--VhiUdJuxlxmxWrLaXiSlRP2gfR2PuYkGvhdYgSLHby---- +Content-Type: image/png +Content-Transfer-Encoding: binary +Content-Location: https://ssl.gstatic.com/docs/common/mobileweb_sprite1.png + +PNG + + IHDR$ UIDATh[[lWΙٛn 8Ik'm\*VEBj51/T5PZ&чJ *ch ܀B)I+!XNHbr:w*>z˅ۦz,3?0u%K/ݚ=sl, XGfѪڎꂒ"ԷU +L*ݟ(9 ?/(ϥdb}۽TAq(&c~@̸ +($ L Dҩ:?slxt4eHY' L]; tzMc;#) >bs{SSL.#T<@Sc$T ǝ)9 0*e,Ok=DDAi?3b'_ OP&^`WX?nf0[ט> 2P_"cTd"$`i6'WjEŒF V*4 +7I ;f,RlxLwMÕ=f13dtb zM}b-`"@2)q.wJQ-ޙX=r1/caOڭxfֆ +x ӏUbX'Wo}fPb3\=~*kULi_mpIe=$S5~ zS0McH^Z&:9 ([ k5|ǡ8=ˮI$;=e?:HoFy, FXQcC7 aN#Q3ZGH:9%m@  8U#'ږKN{ūvF±01ߜFˮӳN,PcT^>z_<^KGc5yۉg_I 49f1|Yډ4FF,NGuA)jUXd:8A$lkC50'S[=+ tbbٱѓfcPg%w-\c)m* + "<%i1lBDc 1(/™3sbΙ4 C kW!BUde6V$ 9iMX\٩ \AN1Ba >O \';2LV(\v "]Le6 \Ėe|v$``hʂ)gzEN 2W_Vnhhp~ `*,#rDv NjU,bO -a-ST?+%ߘqw2Yȋ<#je\(܃PTbC1BDP1<&xܞeUGcH@cdp c#g93#;^K@Kct$ ߿1i0yOZh@}..M.'|f|FŌs M ̂дfki0[o&0T`l` B' +LZfbS~8X'7"l[S7Ļ;3A6 킀xgW5l|k?XFk?Hp^[:n?b, +L/c@ұ+&3lޒ<0])ᜂKhd VWmI7+c\,)ݮP*?Z/0pŹ u|ԾUB)]+KƔ8s?Z+r`כּe MԶ2Cy|MfS&9ѽ̄i/%ڝfP' սµ[=ߌX?V/$ 5c,b1HBSȿE+5@{ +4(:] +Snapshot-Content-Location: https://docs.google.com/document/u/0/d/1XWr9JrV4BaVyKzFuXzz2geNiib_SJd5iTNaVsfb599A/mobilebasic?hl=th-TH&pli=1 +Subject: =?utf-8?Q?LCBP3-DMS=20Frontend=20Documentation=20(=E0=B8=89=E0=B8=9A=E0?= + =?utf-8?Q?=B8=B1=E0=B8=9A=E0=B8=AA=E0=B8=A1=E0=B8=9A=E0=B8=B9=E0=B8=A3=E0?= + =?utf-8?Q?=B8=93=E0=B9=8C)?= +Date: Thu, 16 Oct 2025 23:11:12 +0700 +MIME-Version: 1.0 +Content-Type: multipart/related; + type="text/html"; + boundary="----MultipartBoundary--csF0EXC0RJ3vOG6iJZx4sbJHPtjAmchlkrKXyomDzE----" + + +------MultipartBoundary--csF0EXC0RJ3vOG6iJZx4sbJHPtjAmchlkrKXyomDzE---- +Content-Type: text/html +Content-ID: +Content-Transfer-Encoding: binary +Content-Location: https://docs.google.com/document/u/0/d/1XWr9JrV4BaVyKzFuXzz2geNiib_SJd5iTNaVsfb599A/mobilebasic?hl=th-TH&pli=1 + +LCBP3-DMS Frontend Documentation (ฉบับสมบูรณ์)
LCBP3-DMS Frontend Documentation (ฉบับสมบูรณ์)

LCBP3-DMS: Frontend Documentation (ฉบับสมบูรณ์)

เอกสารนี้รวบรวมรายละเอียดทั้งหมดของส่วน Frontend สำหรับระบบ LCBP3 Document Management System ซึ่งพัฒนาด้วย Next.js (App Router), TypeScript, Tailwind CSS, และ shadcn/ui

1. ข้อกำหนดเบื้องต้น (Prerequisites)

ก่อนเริ่มการติดตั้งและพัฒนา คุณจะต้องมีเครื่องมือต่อไปนี้ติดตั้งบนเครื่องคอมพิวเตอร์ของคุณ:

  • Node.js: เวอร์ชัน 18.x หรือสูงกว่า
  • NPM หรือ Yarn: ตัวจัดการ Package (มาพร้อมกับ Node.js)
  • Git: สำหรับการ Clone โปรเจกต์จาก Gitea

2. ขั้นตอนการติดตั้งและเริ่มใช้งาน (Installation & Setup)

  1. Clone โปรเจกต์:
  • คัดลอกโปรเจกต์จาก Gitea repository ของคุณมาไว้ที่เครื่อง

<!-- end list -->git clone [http://git.np-dms.work/your-repo/frontend-np-dms.git](http://git.np-dms.work/your-repo/frontend-np-dms.git)
cd frontend-np-dms

  1. ติดตั้ง Dependencies:
  • ใช้ npm เพื่อติดตั้ง Library ทั้งหมดที่โปรเจกต์ต้องการ

<!-- end list -->npm install

  1. ตั้งค่า Environment File:
  • สร้างไฟล์ใหม่ชื่อ .env.local ที่รากของโปรเจกต์
  • กำหนด URL ของ Backend API ที่จะให้ Frontend เชื่อมต่อ

ไฟล์ .env.local:# URL ของ NestJS Backend (ที่รันผ่าน Docker)
NEXT_PUBLIC_API_BASE_URL=http://localhost:3001

  1. รันแอปพลิเคชัน (Development Mode):
  • ใช้คำสั่งนี้เพื่อเริ่ม Frontend server ในโหมดพัฒนา

<!-- end list -->npm run dev

  1. ตรวจสอบการทำงาน:
  • เปิดเว็บเบราว์เซอร์แล้วไปที่ http://localhost:3000
  • คุณควรจะเห็นหน้า Landing Page ของระบบ

3. สถาปัตยกรรมและโครงสร้างโปรเจกต์

Frontend นี้ใช้ App Router ของ Next.js ซึ่งเป็นสถาปัตยกรรมสมัยใหม่ที่เน้นการทำ Server-Side Rendering (SSR) และ Server Components เพื่อประสิทธิภาพสูงสุด

  • Framework: Next.js 14+ (App Router)
  • ภาษา: TypeScript
  • Styling: Tailwind CSS
  • Component Library: shadcn/ui (ไม่ใช่ Library แต่เป็นชุดของ Reusable Components ที่สามารถปรับแต่งได้)
  • State Management: React Context API (สำหรับ Global Authentication State)
  • Data Fetching: ใช้ API Routes ของ Next.js เป็น Proxy เพื่อสื่อสารกับ Backend อย่างปลอดภัย

โครงสร้างโฟลเดอร์หลัก:

frontend-np-dms/
├── app/
│   ├── (auth)/             # Group สำหรับหน้าหลัง Login (มี Layout พร้อม Navbar/Sidebar)
│   │   ├── admin/
│   │   ├── correspondences/
│   │   ├── dashboard/
│   │   └── layout.tsx
│   ├── (public)/           # Group สำหรับหน้าสาธารณะ (มี Layout แบบว่าง)
│   │   ├── login/
│   │   └── layout.tsx
│   ├── api/                # API Routes ที่ทำหน้าที่เป็น Proxy ไปยัง Backend
│   ├── globals.css
│   └── layout.tsx          # Root Layout (ที่ห่อหุ้มด้วย AuthProvider)
├── components/             # ที่เก็บ UI Components ที่สร้างด้วย shadcn และ Components ที่สร้างขึ้นเอง
│   ├── dashboard/
│   ├── layout/
│   ├── rfa/
│   └── ui/
├── contexts/               # ที่เก็บ React Context สำหรับ Global State
│   └── AuthContext.tsx
├── lib/                    # ที่เก็บฟังก์ชันเสริม (เช่น utils.ts จาก shadcn)
├── public/                 # ที่เก็บไฟล์สาธารณะ เช่น รูปภาพ, favicon
├── types/                  # (แนะนำ) ที่เก็บ TypeScript type definitions ที่ใช้ร่วมกัน
├── middleware.ts           # ไฟล์สำคัญสำหรับป้องกัน Route (Route Protection)
└── package.json

+------MultipartBoundary--csF0EXC0RJ3vOG6iJZx4sbJHPtjAmchlkrKXyomDzE---- +Content-Type: text/css +Content-Transfer-Encoding: binary +Content-Location: https://themes.googleusercontent.com/fonts/css?kit=kbffV7V9BIH3Ot2AQ2LQRA + +@charset "utf-8"; + +@font-face { font-family: Courier; font-style: normal; font-weight: 400; src: url("https://fonts.gstatic.com/l/font?kit=i7dKIFtyYSaNG9A_JrmedWxeSFI&skey=415f62b718dd1a36&v=v12") format("woff2"); unicode-range: U+0-FF, U+131, U+152-153, U+2BB-2BC, U+2C6, U+2DA, U+2DC, U+304, U+308, U+329, U+2000-206F, U+20AC, U+2122, U+2191, U+2193, U+2212, U+2215, U+FEFF, U+FFFD; } +------MultipartBoundary--csF0EXC0RJ3vOG6iJZx4sbJHPtjAmchlkrKXyomDzE---- +Content-Type: text/css +Content-Transfer-Encoding: binary +Content-Location: cid:css-8579d4bc-81a4-446d-b2aa-5e3d220689ab@mhtml.blink + +@charset "utf-8"; + +@import url("https://themes.googleusercontent.com/fonts/css?kit=kbffV7V9BIH3Ot2AQ2LQRA"); + +ol.lst-kix_list_7-0 { list-style-type: none; } + +ul.lst-kix_list_1-0 { list-style-type: none; } + +ol.lst-kix_list_3-0 { list-style-type: none; } + +.lst-kix_list_3-0 > li::before { content: "" counter(lst-ctn-kix_list_3-0) ". "; } + +ul.lst-kix_list_5-7 { list-style-type: none; } + +ul.lst-kix_list_5-8 { list-style-type: none; } + +.lst-kix_list_3-1 > li::before { content: "○ "; } + +.lst-kix_list_3-2 > li::before { content: "■ "; } + +ul.lst-kix_list_5-5 { list-style-type: none; } + +ul.lst-kix_list_5-6 { list-style-type: none; } + +.lst-kix_list_8-1 > li::before { content: "○ "; } + +.lst-kix_list_4-0 > li { counter-increment: lst-ctn-kix_list_4-0 1; } + +.lst-kix_list_8-2 > li::before { content: "■ "; } + +.lst-kix_list_5-0 > li { counter-increment: lst-ctn-kix_list_5-0 1; } + +.lst-kix_list_6-0 > li { counter-increment: lst-ctn-kix_list_6-0 1; } + +.lst-kix_list_7-0 > li { counter-increment: lst-ctn-kix_list_7-0 1; } + +ul.lst-kix_list_1-3 { list-style-type: none; } + +.lst-kix_list_3-5 > li::before { content: "■ "; } + +ul.lst-kix_list_1-4 { list-style-type: none; } + +ul.lst-kix_list_1-1 { list-style-type: none; } + +.lst-kix_list_3-4 > li::before { content: "■ "; } + +ul.lst-kix_list_1-2 { list-style-type: none; } + +ul.lst-kix_list_5-3 { list-style-type: none; } + +ul.lst-kix_list_1-7 { list-style-type: none; } + +.lst-kix_list_3-3 > li::before { content: "■ "; } + +ul.lst-kix_list_5-4 { list-style-type: none; } + +ul.lst-kix_list_1-8 { list-style-type: none; } + +ul.lst-kix_list_5-1 { list-style-type: none; } + +.lst-kix_list_8-0 > li::before { content: "● "; } + +ul.lst-kix_list_1-5 { list-style-type: none; } + +ul.lst-kix_list_5-2 { list-style-type: none; } + +ul.lst-kix_list_1-6 { list-style-type: none; } + +.lst-kix_list_8-7 > li::before { content: "■ "; } + +.lst-kix_list_3-8 > li::before { content: "■ "; } + +.lst-kix_list_8-5 > li::before { content: "■ "; } + +.lst-kix_list_8-6 > li::before { content: "■ "; } + +.lst-kix_list_2-0 > li { counter-increment: lst-ctn-kix_list_2-0 1; } + +.lst-kix_list_8-3 > li::before { content: "■ "; } + +.lst-kix_list_3-6 > li::before { content: "■ "; } + +.lst-kix_list_3-7 > li::before { content: "■ "; } + +.lst-kix_list_8-4 > li::before { content: "■ "; } + +ol.lst-kix_list_5-0.start { counter-reset: lst-ctn-kix_list_5-0 0; } + +.lst-kix_list_8-8 > li::before { content: "■ "; } + +.lst-kix_list_5-0 > li::before { content: "" counter(lst-ctn-kix_list_5-0) ". "; } + +ol.lst-kix_list_6-0 { list-style-type: none; } + +ol.lst-kix_list_2-0 { list-style-type: none; } + +.lst-kix_list_4-8 > li::before { content: "■ "; } + +.lst-kix_list_5-3 > li::before { content: "■ "; } + +.lst-kix_list_4-7 > li::before { content: "■ "; } + +.lst-kix_list_5-2 > li::before { content: "■ "; } + +.lst-kix_list_5-1 > li::before { content: "○ "; } + +ul.lst-kix_list_4-8 { list-style-type: none; } + +.lst-kix_list_5-7 > li::before { content: "■ "; } + +ul.lst-kix_list_8-4 { list-style-type: none; } + +ul.lst-kix_list_8-5 { list-style-type: none; } + +ul.lst-kix_list_4-6 { list-style-type: none; } + +.lst-kix_list_5-6 > li::before { content: "■ "; } + +.lst-kix_list_5-8 > li::before { content: "■ "; } + +ul.lst-kix_list_8-2 { list-style-type: none; } + +ul.lst-kix_list_4-7 { list-style-type: none; } + +ul.lst-kix_list_8-3 { list-style-type: none; } + +ul.lst-kix_list_8-8 { list-style-type: none; } + +ul.lst-kix_list_8-6 { list-style-type: none; } + +ul.lst-kix_list_8-7 { list-style-type: none; } + +ul.lst-kix_list_4-1 { list-style-type: none; } + +.lst-kix_list_5-4 > li::before { content: "■ "; } + +ul.lst-kix_list_4-4 { list-style-type: none; } + +.lst-kix_list_5-5 > li::before { content: "■ "; } + +ul.lst-kix_list_8-0 { list-style-type: none; } + +ul.lst-kix_list_4-5 { list-style-type: none; } + +ul.lst-kix_list_8-1 { list-style-type: none; } + +ul.lst-kix_list_4-2 { list-style-type: none; } + +ul.lst-kix_list_4-3 { list-style-type: none; } + +.lst-kix_list_6-1 > li::before { content: "○ "; } + +.lst-kix_list_6-3 > li::before { content: "■ "; } + +.lst-kix_list_6-0 > li::before { content: "" counter(lst-ctn-kix_list_6-0) ". "; } + +.lst-kix_list_6-4 > li::before { content: "■ "; } + +.lst-kix_list_3-0 > li { counter-increment: lst-ctn-kix_list_3-0 1; } + +ol.lst-kix_list_4-0.start { counter-reset: lst-ctn-kix_list_4-0 0; } + +.lst-kix_list_6-2 > li::before { content: "■ "; } + +.lst-kix_list_6-8 > li::before { content: "■ "; } + +.lst-kix_list_6-5 > li::before { content: "■ "; } + +.lst-kix_list_6-7 > li::before { content: "■ "; } + +.lst-kix_list_7-0 > li::before { content: "" counter(lst-ctn-kix_list_7-0) ". "; } + +.lst-kix_list_6-6 > li::before { content: "■ "; } + +ol.lst-kix_list_5-0 { list-style-type: none; } + +.lst-kix_list_2-6 > li::before { content: "■ "; } + +.lst-kix_list_2-7 > li::before { content: "■ "; } + +.lst-kix_list_7-4 > li::before { content: "■ "; } + +.lst-kix_list_7-6 > li::before { content: "■ "; } + +.lst-kix_list_2-4 > li::before { content: "■ "; } + +.lst-kix_list_2-5 > li::before { content: "■ "; } + +.lst-kix_list_2-8 > li::before { content: "■ "; } + +.lst-kix_list_7-1 > li::before { content: "○ "; } + +.lst-kix_list_7-5 > li::before { content: "■ "; } + +.lst-kix_list_7-2 > li::before { content: "■ "; } + +.lst-kix_list_7-3 > li::before { content: "■ "; } + +ul.lst-kix_list_7-5 { list-style-type: none; } + +ul.lst-kix_list_7-6 { list-style-type: none; } + +ul.lst-kix_list_7-3 { list-style-type: none; } + +ul.lst-kix_list_3-7 { list-style-type: none; } + +ul.lst-kix_list_7-4 { list-style-type: none; } + +ul.lst-kix_list_3-8 { list-style-type: none; } + +ul.lst-kix_list_7-7 { list-style-type: none; } + +ul.lst-kix_list_7-8 { list-style-type: none; } + +ol.lst-kix_list_3-0.start { counter-reset: lst-ctn-kix_list_3-0 0; } + +ul.lst-kix_list_3-1 { list-style-type: none; } + +ul.lst-kix_list_3-2 { list-style-type: none; } + +.lst-kix_list_7-8 > li::before { content: "■ "; } + +ul.lst-kix_list_7-1 { list-style-type: none; } + +ul.lst-kix_list_3-5 { list-style-type: none; } + +ul.lst-kix_list_7-2 { list-style-type: none; } + +ul.lst-kix_list_3-6 { list-style-type: none; } + +ul.lst-kix_list_3-3 { list-style-type: none; } + +.lst-kix_list_7-7 > li::before { content: "■ "; } + +ul.lst-kix_list_3-4 { list-style-type: none; } + +.lst-kix_list_4-0 > li::before { content: "" counter(lst-ctn-kix_list_4-0) ". "; } + +.lst-kix_list_4-1 > li::before { content: "○ "; } + +.lst-kix_list_4-4 > li::before { content: "■ "; } + +.lst-kix_list_4-3 > li::before { content: "■ "; } + +.lst-kix_list_4-5 > li::before { content: "■ "; } + +.lst-kix_list_4-2 > li::before { content: "■ "; } + +.lst-kix_list_4-6 > li::before { content: "■ "; } + +ol.lst-kix_list_7-0.start { counter-reset: lst-ctn-kix_list_7-0 0; } + +ol.lst-kix_list_4-0 { list-style-type: none; } + +ul.lst-kix_list_6-6 { list-style-type: none; } + +ul.lst-kix_list_6-7 { list-style-type: none; } + +ul.lst-kix_list_6-4 { list-style-type: none; } + +ul.lst-kix_list_2-8 { list-style-type: none; } + +ul.lst-kix_list_6-5 { list-style-type: none; } + +ul.lst-kix_list_6-8 { list-style-type: none; } + +ul.lst-kix_list_2-2 { list-style-type: none; } + +.lst-kix_list_1-0 > li::before { content: "● "; } + +ul.lst-kix_list_2-3 { list-style-type: none; } + +ul.lst-kix_list_2-1 { list-style-type: none; } + +ul.lst-kix_list_6-2 { list-style-type: none; } + +ul.lst-kix_list_2-6 { list-style-type: none; } + +ul.lst-kix_list_6-3 { list-style-type: none; } + +.lst-kix_list_1-1 > li::before { content: "○ "; } + +.lst-kix_list_1-2 > li::before { content: "■ "; } + +ol.lst-kix_list_2-0.start { counter-reset: lst-ctn-kix_list_2-0 0; } + +ul.lst-kix_list_2-7 { list-style-type: none; } + +ul.lst-kix_list_2-4 { list-style-type: none; } + +ul.lst-kix_list_6-1 { list-style-type: none; } + +ul.lst-kix_list_2-5 { list-style-type: none; } + +.lst-kix_list_1-3 > li::before { content: "■ "; } + +.lst-kix_list_1-4 > li::before { content: "■ "; } + +.lst-kix_list_1-7 > li::before { content: "■ "; } + +.lst-kix_list_1-5 > li::before { content: "■ "; } + +.lst-kix_list_1-6 > li::before { content: "■ "; } + +.lst-kix_list_2-0 > li::before { content: "" counter(lst-ctn-kix_list_2-0) ". "; } + +.lst-kix_list_2-1 > li::before { content: "○ "; } + +ol.lst-kix_list_6-0.start { counter-reset: lst-ctn-kix_list_6-0 0; } + +.lst-kix_list_1-8 > li::before { content: "■ "; } + +.lst-kix_list_2-2 > li::before { content: "■ "; } + +.lst-kix_list_2-3 > li::before { content: "■ "; } +------MultipartBoundary--csF0EXC0RJ3vOG6iJZx4sbJHPtjAmchlkrKXyomDzE---- +Content-Type: image/png +Content-Transfer-Encoding: binary +Content-Location: https://ssl.gstatic.com/docs/common/mobileweb_sprite1.png + +PNG + + IHDR$ UIDATh[[lWΙٛn 8Ik'm\*VEBj51/T5PZ&чJ *ch ܀B)I+!XNHbr:w*>z˅ۦz,3?0u%K/ݚ=sl, XGfѪڎꂒ"ԷU +L*ݟ(9 ?/(ϥdb}۽TAq(&c~@̸ +($ L Dҩ:?slxt4eHY' L]; tzMc;#) >bs{SSL.#T<@Sc$T ǝ)9 0*e,Ok=DDAi?3b'_ OP&^`WX?nf0[ט> 2P_"cTd"$`i6'WjEŒF V*4 +7I ;f,RlxLwMÕ=f13dtb zM}b-`"@2)q.wJQ-ޙX=r1/caOڭxfֆ +x ӏUbX'Wo}fPb3\=~*kULi_mpIe=$S5~ zS0McH^Z&:9 ([ k5|ǡ8=ˮI$;=e?:HoFy, FXQcC7 aN#Q3ZGH:9%m@  8U#'ږKN{ūvF±01ߜFˮӳN,PcT^>z_<^KGc5yۉg_I 49f1|Yډ4FF,NGuA)jUXd:8A$lkC50'S[=+ tbbٱѓfcPg%w-\c)m* + "<%i1lBDc 1(/™3sbΙ4 C kW!BUde6V$ 9iMX\٩ \AN1Ba >O \';2LV(\v "]Le6 \Ėe|v$``hʂ)gzEN 2W_Vnhhp~ `*,#rDv NjU,bO -a-ST?+%ߘqw2Yȋ<#je\(܃PTbC1BDP1<&xܞeUGcH@cdp c#g93#;^K@Kct$ ߿1i0yOZh@}..M.'|f|FŌs M ̂дfki0[o&0T`l` B' +LZfbS~8X'7"l[S7Ļ;3A6 킀xgW5l|k?XFk?Hp^[:n?b, +L/c@ұ+&3lޒ<0])ᜂKhd VWmI7+c\,)ݮP*?Z/0pŹ u|ԾUB)]+KƔ8s?Z+r`כּe MԶ2Cy|MfS&9ѽ̄i/%ڝfP' սµ[=ߌX?V/$ 5c,b1HBSȿE+5@{ +4(:] +Snapshot-Content-Location: https://docs.google.com/document/u/0/d/1LMjIhp2TCy9QpzTUzL55cP0dx61WM4epmr8qy9N9Rgc/mobilebasic?hl=th-TH&pli=1 +Subject: LCBP3-DMS Requirements Specification (v2.0) +Date: Thu, 16 Oct 2025 22:57:30 +0700 +MIME-Version: 1.0 +Content-Type: multipart/related; + type="text/html"; + boundary="----MultipartBoundary--zmGvipyjWUpT0gAfLJbw3hmbaeNqVxyLAosKXVU9r0----" + + +------MultipartBoundary--zmGvipyjWUpT0gAfLJbw3hmbaeNqVxyLAosKXVU9r0---- +Content-Type: text/html +Content-ID: +Content-Transfer-Encoding: binary +Content-Location: https://docs.google.com/document/u/0/d/1LMjIhp2TCy9QpzTUzL55cP0dx61WM4epmr8qy9N9Rgc/mobilebasic?hl=th-TH&pli=1 + +LCBP3-DMS Requirements Specification (v2.0)
LCBP3-DMS Requirements Specification (v2.0)

LCBP3-DMS: Requirements Specification (v2.0)

เอกสารนี้สรุปข้อกำหนดทางธุรกิจ, สถาปัตยกรรมทางเทคนิค, และรายละเอียดการ υλοποίηση (Implementation) สำหรับระบบบริหารจัดการเอกสารโครงการ (Document Management System)

1. สถาปัตยกรรมและเทคโนโลยี (System Architecture & Technology Stack)

ระบบใช้สถาปัตยกรรมแบบ Headless/API-First ที่ทันสมัย ทำงานทั้งหมดบน QNAP Server ผ่าน Container Station เพื่อความสะดวกในการจัดการและบำรุงรักษา

  • 1.1 Infrastructure & Environment:
  • Server: QNAP (Model: TS-473A, RAM: 32GB, CPU: AMD Ryzen V1500B)
  • Containerization: Docker & Docker Compose
  • Development Environment: VS Code on Windows 11
  • Domain: np-dms.work (มี Fixed IP)
  • Docker Network: ทุก Service จะเชื่อมต่อผ่านเครือข่ายกลางชื่อ lcbp3 เพื่อให้สามารถสื่อสารกันได้
  • 1.2 Code Hosting:
  • Service: Gitea (Self-hosted on QNAP)
  • Domain: git.np-dms.work
  • หน้าที่: เป็นศูนย์กลางในการเก็บและจัดการเวอร์ชันของโค้ด (Source Code) สำหรับทุกส่วน
  • 1.3 Backend / Data Platform:
  • Framework: NestJS (Node.js, TypeScript, ESM)
  • Domain: backend.np-dms.work
  • หน้าที่: จัดการโครงสร้างข้อมูล (Data Models), สร้าง API, จัดการสิทธิ์ผู้ใช้ (Roles & Permissions), และสร้าง Workflow ทั้งหมดของระบบ
  • 1.4 Database:
  • Service: MariaDB
  • หน้าที่: ฐานข้อมูลหลักสำหรับเก็บข้อมูลทั้งหมด
  • Tooling: DBeaver (Community Edition) สำหรับการออกแบบและจัดการฐานข้อมูล
  • 1.5 Frontend:
  • Framework: Next.js (App Router, React, TypeScript, ESM)
  • Styling: Tailwind CSS + PostCSS
  • Component Library: shadcn/ui
  • Domain: lcbp3.np-dms.work
  • หน้าที่: สร้างหน้าตาเว็บแอปพลิเคชันสำหรับให้ผู้ใช้งานเข้ามาดู Dashboard, จัดการเอกสาร, และติดตามงาน โดยจะสื่อสารกับ Backend ผ่าน API
  • 1.6 Reverse Proxy:
  • Service: Nginx Proxy Manager
  • หน้าที่: เป็นด่านหน้าในการรับ-ส่งข้อมูล จัดการโดเมนทั้งหมด, ทำหน้าที่เป็น Proxy ชี้ไปยัง Service ที่ถูกต้อง, และจัดการ SSL Certificate (HTTPS) ให้อัตโนมัติ

2. ข้อกำหนดด้านฟังก์ชันการทำงาน (Functional Requirements)

2.1 การจัดการโครงสร้างโครงการและองค์กร

  • 2.1.1 โครงการ (Projects): ระบบต้องสามารถจัดการเอกสารภายในหลายโครงการได้ (ปัจจุบันมี 4 โครงการ และจะเพิ่มขึ้นในอนาคต)
  • 2.1.2 สัญญา (Contracts): ในแต่ละโครงการ มีได้หลายสัญญา หรืออย่างน้อย 1 สัญญา
  • 2.1.3 องค์กร (Organizations):
  • มีหลายองค์กรในโครงการ บางองค์กรเช่น Owner, Designer และ Consultant สามารถอยู่ในหลายโครงการและหลายสัญญาได้
  • Contractor จะถือ 1 สัญญา และอยู่ใน 1 โครงการเท่านั้น

2.2 การจัดการเอกสาร (Correspondence Management)

  • 2.2.1 ประเภทเอกสาร: ระบบต้องรองรับเอกสารหลายประเภท (Types) เช่น จดหมาย (Letter), อีเมล์ (Email), Request for Information (RFI), และสามารถเพิ่มประเภทใหม่ได้ในภายหลัง
  • 2.2.2 การสร้างเอกสาร:
  • ผู้ใช้ที่มีสิทธิ์ (เช่น Document Control) สามารถสร้างเอกสารรอไว้ในสถานะ "ฉบับร่าง" (Draft) ได้ ซึ่งผู้ใช้งานต่างองค์กรจะมองไม่เห็น
  • เมื่อกด "Submitted" แล้ว การแก้ไข, ถอนเอกสารกลับไปสถานะ Draft, หรือยกเลิก (Cancel) จะต้องทำโดยผู้ใช้ระดับ Admin ขึ้นไป พร้อมระบุเหตุผล
  • 2.2.3 การอ้างอิงและจัดกลุ่ม:
  • เอกสารสามารถอ้างถึง (Reference) เอกสารฉบับก่อนหน้าได้หลายฉบับ
  • สามารถกำหนด Tag ได้หลาย Tag เพื่อจัดกลุ่มและใช้ในการค้นหาขั้นสูง
  • 2.2.4 ประวัติการแก้ไข (Revisions): เอกสารสามารถมีได้หลาย Revision โดยระบบจะเก็บประวัติการแก้ไขทั้งหมด
  • 2.2.5 การจัดเก็บ: เอกสารและไฟล์แนบจะถูกจัดเก็บในโฟลเดอร์บน Server โดยมีการอ้างอิงข้อมูล (Metadata) ในฐานข้อมูล และสามารถจัดเรียงตามวันที่ออกเอกสาร (Issue Date) ได้

2.3 การจัดการเอกสารทางเทคนิค (Technical Documents & Workflow)

  • 2.3.1 ประเภท: เป็นชนิดหนึ่งของ Correspondence ที่มีลักษณะเฉพาะคือต้องได้รับการอนุมัติ และมีประเภทดังนี้:
  • Request for Material Approval (RFA_Mat)
  • Request for Method statement Approval (RFA_MST)
  • Request for Document Approval (RFA_DOC)
  • Request for Drawing Approval (RFA_DWG)
  • 2.3.2 Workflow การอนุมัติ: ต้องรองรับกระบวนการอนุมัติที่ซับซ้อนและเป็นลำดับ เช่น ส่งจาก Originator -> Org1 -> Org2 -> Org3 แล้วส่งผลกลับตามลำดับเดิม
  • 2.3.3 การจัดการ Drawing (RFA_DWG):
  • เอกสาร RFA_DWG จะประกอบไปด้วย Shop Drawing (Shp_DWG) หลายแผ่น ซึ่งแต่ละแผ่นมี Revision ของตัวเอง
  • Shop Drawing สามารถอ้างอิงถึง Contract Drawing (Con_DWG) หลายแผ่น หรือไม่อ้างถึงก็ได้
  • ระบบต้องมีส่วนสำหรับจัดการข้อมูล Master Data ของทั้ง Shop Drawing และ Contract Drawing แยกจากกัน

2.4 ใบเวียนเอกสารภายใน (Internal Circulation Sheet)

  • 2.4.1 วัตถุประสงค์: การสื่อสาร (Correspondence) ทุกฉบับ จะมีใบเวียนเอกสารเพื่อควบคุมและมอบหมายงานภายในองค์กร (สามารถดูและแก้ไขได้เฉพาะคนในองค์กร)
  • 2.4.2 การระบุผู้รับผิดชอบ:
  • ผู้รับผิดชอบหลัก (Main): มีได้หลายคน
  • ผู้ร่วมปฏิบัติงาน (Action): มีได้หลายคน
  • ผู้ที่ต้องรับทราบ (Information): มีได้หลายคน
  • 2.4.3 การติดตามงาน:
  • สามารถกำหนดวันแล้วเสร็จ (Deadline) สำหรับผู้รับผิดชอบประเภท Main และ Action ได้
  • มีระบบแจ้งเตือนเมื่อมี Circulation ใหม่ และแจ้งเตือนล่วงหน้าก่อนถึงวันแล้วเสร็จ
  • สามารถปิด Circulation ได้เมื่อดำเนินการตอบกลับไปยังองค์กรผู้ส่ง (Originator) แล้ว

3. ข้อกำหนดด้านสิทธิ์และการเข้าถึง (Access Control Requirements)

  • 3.1 ภาพรวม: ผู้ใช้และองค์กรสามารถดูและแก้ไขเอกสารได้ตามสิทธิ์ที่ได้รับ โดยระบบสิทธิ์จะเป็นแบบ Role-Based Access Control (RBAC)
  • 3.2 ระดับของสิทธิ์:
  • Global Roles: สิทธิ์ในภาพรวมของระบบ
  • Project-Specific Roles: สิทธิ์ที่ถูกกำหนดให้ผู้ใช้สำหรับโครงการนั้นๆ โดยเฉพาะ (เช่น เป็น Editor ในโครงการ A แต่เป็น Viewer ในโครงการ B)
  • 3.3 บทบาท (Roles) พื้นฐาน:
  • Superadmin: ไม่มีข้อจำกัดใดๆ สามารถจัดการได้ทุกอย่างข้ามองค์กร
  • Admin: มีสิทธิ์เต็มที่ แต่จำกัดเฉพาะในองค์กรที่ตัวเองสังกัด สามารถจัดการผู้ใช้ในองค์กรได้
  • Document Control / Editor: สามารถ เพิ่ม/แก้ไข เอกสาร เฉพาะในองค์กรที่ตัวเองสังกัด ไม่สามารถจัดการผู้ใช้ได้
  • สามารถสร้าง Role ใหม่และกำหนดสิทธิ์ (Permissions) เพิ่มเติมได้ในภายหลังผ่านหน้า Admin Panel
  • 3.4 การบังคับใช้สิทธิ์: สิทธิ์ขององค์กรจะครอบคลุมสิทธิ์ของผู้ใช้ และการเข้าถึงข้อมูลที่เกี่ยวข้องกับโครงการ (เช่น การแก้ไขเอกสาร) จะถูกตรวจสอบเทียบกับสิทธิ์ที่ผู้ใช้มีในโครงการนั้นๆ โดยเฉพาะ

4. ข้อกำหนดด้านผู้ใช้งาน (User Interface & Experience)

  • 4.1 Layout หลัก: หน้าเว็บใช้รูปแบบ App Shell ที่ประกอบด้วย:
  • Navbar (ส่วนบน): แสดงชื่อระบบ, เมนูผู้ใช้ (Profile), เมนูสำหรับ Admin/Superadmin (จัดการผู้ใช้, จัดการสิทธิ์), และปุ่ม Login/Logout
  • Sidebar (ด้านข้าง): เป็นเมนูหลักสำหรับเข้าถึงส่วนที่เกี่ยวกับเอกสารทั้งหมด เช่น Dashboard, Correspondences, RFA, Drawings
  • Main Content Area: พื้นที่สำหรับแสดงเนื้อหาหลักของหน้าที่เลือก
  • 4.2 หน้า Landing Page: เป็นหน้าแรกที่แสดงข้อมูลบางส่วนของโครงการสำหรับผู้ใช้ที่ยังไม่ได้ล็อกอิน
  • 4.3 หน้า Dashboard: เป็นหน้าแรกหลังจากล็อกอิน ประกอบด้วย:
  • การ์ดสรุปภาพรวม (KPI Cards): แสดงข้อมูลสรุปที่สำคัญขององค์กร เช่น จำนวนเอกสาร, งานที่เกินกำหนด
  • ตาราง "งานของฉัน" (My Tasks Table): แสดงรายการงานทั้งหมดจาก Circulation ที่ผู้ใช้ต้องดำเนินการ
  • 4.4 การติดตามสถานะ: องค์กรสามารถติดตามสถานะเอกสารทั้งของตนเอง (Originator) และสถานะเอกสารที่ส่งมาถึงตนเอง (Recipient)
  • 4.5 การจัดการข้อมูลส่วนตัว (Profile Page): ผู้ใช้สามารถจัดการข้อมูลส่วนตัวและเปลี่ยนรหัสผ่านของตนเองได้

5. ข้อกำหนดที่ไม่ใช่ฟังก์ชันการทำงาน (Non-Functional Requirements)

  • 5.1 การบันทึกการกระทำ (Audit Log): ทุกการกระทำที่สำคัญของผู้ใช้ (สร้าง, แก้ไข, ลบ, ส่ง) จะถูกบันทึกไว้ใน audit_logs เพื่อการตรวจสอบย้อนหลัง
  • 5.2 การค้นหา (Search): ระบบต้องมีฟังก์ชันการค้นหาขั้นสูง ที่สามารถค้นหาเอกสารจากหลายเงื่อนไขพร้อมกันได้ เช่น ค้นหาจากชื่อเรื่อง, ประเภท, วันที่, และ Tag
  • 5.3 การทำรายงาน (Reporting): สามารถจัดทำรายงานสรุปแยกประเภทของ Correspondence ประจำวัน, สัปดาห์, เดือน, และปีได้
  • 5.4 ประสิทธิภาพ (Performance): มีการใช้ Caching กับข้อมูลที่เรียกใช้บ่อย และใช้ Pagination ในตารางข้อมูลเพื่อจัดการข้อมูลจำนวนมาก
  • 5.5 ความปลอดภัย (Security):
  • มีระบบ Rate Limiting เพื่อป้องกันการโจมตีแบบ Brute-force
  • การจัดการ Secret (เช่น รหัสผ่าน DB, JWT Secret) จะต้องทำผ่าน Environment Variable ของ Docker เพื่อความปลอดภัยสูงสุด

+------MultipartBoundary--zmGvipyjWUpT0gAfLJbw3hmbaeNqVxyLAosKXVU9r0---- +Content-Type: text/css +Content-Transfer-Encoding: binary +Content-Location: cid:css-941c3c4b-eff7-4021-b2a8-f5f59715b21d@mhtml.blink + +@charset "utf-8"; + +.lst-kix_list_14-1 > li::before { content: "○ "; } + +.lst-kix_list_14-3 > li::before { content: "■ "; } + +.lst-kix_list_14-0 > li::before { content: "● "; } + +.lst-kix_list_14-4 > li::before { content: "■ "; } + +.lst-kix_list_14-5 > li::before { content: "■ "; } + +.lst-kix_list_14-7 > li::before { content: "■ "; } + +.lst-kix_list_14-6 > li::before { content: "■ "; } + +ul.lst-kix_list_9-3 { list-style-type: none; } + +ul.lst-kix_list_9-4 { list-style-type: none; } + +ul.lst-kix_list_9-1 { list-style-type: none; } + +ul.lst-kix_list_9-2 { list-style-type: none; } + +ul.lst-kix_list_9-7 { list-style-type: none; } + +ul.lst-kix_list_9-8 { list-style-type: none; } + +ul.lst-kix_list_9-5 { list-style-type: none; } + +ul.lst-kix_list_9-6 { list-style-type: none; } + +ul.lst-kix_list_9-0 { list-style-type: none; } + +.lst-kix_list_14-2 > li::before { content: "■ "; } + +ul.lst-kix_list_17-1 { list-style-type: none; } + +ul.lst-kix_list_17-0 { list-style-type: none; } + +ul.lst-kix_list_17-8 { list-style-type: none; } + +ul.lst-kix_list_17-7 { list-style-type: none; } + +ul.lst-kix_list_17-6 { list-style-type: none; } + +ul.lst-kix_list_17-5 { list-style-type: none; } + +ul.lst-kix_list_17-4 { list-style-type: none; } + +ul.lst-kix_list_17-3 { list-style-type: none; } + +.lst-kix_list_14-8 > li::before { content: "■ "; } + +ul.lst-kix_list_17-2 { list-style-type: none; } + +.lst-kix_list_5-0 > li::before { content: "● "; } + +.lst-kix_list_5-3 > li::before { content: "■ "; } + +.lst-kix_list_5-2 > li::before { content: "■ "; } + +.lst-kix_list_5-1 > li::before { content: "○ "; } + +.lst-kix_list_5-7 > li::before { content: "■ "; } + +ul.lst-kix_list_8-4 { list-style-type: none; } + +ul.lst-kix_list_8-5 { list-style-type: none; } + +.lst-kix_list_5-6 > li::before { content: "■ "; } + +.lst-kix_list_5-8 > li::before { content: "■ "; } + +ul.lst-kix_list_8-2 { list-style-type: none; } + +ul.lst-kix_list_8-3 { list-style-type: none; } + +ul.lst-kix_list_8-8 { list-style-type: none; } + +ul.lst-kix_list_8-6 { list-style-type: none; } + +ul.lst-kix_list_8-7 { list-style-type: none; } + +.lst-kix_list_5-4 > li::before { content: "■ "; } + +.lst-kix_list_5-5 > li::before { content: "■ "; } + +ul.lst-kix_list_8-0 { list-style-type: none; } + +ul.lst-kix_list_8-1 { list-style-type: none; } + +.lst-kix_list_6-1 > li::before { content: "○ "; } + +.lst-kix_list_6-3 > li::before { content: "■ "; } + +.lst-kix_list_6-0 > li::before { content: "● "; } + +.lst-kix_list_6-4 > li::before { content: "■ "; } + +ul.lst-kix_list_16-2 { list-style-type: none; } + +ul.lst-kix_list_16-1 { list-style-type: none; } + +ul.lst-kix_list_16-0 { list-style-type: none; } + +.lst-kix_list_6-2 > li::before { content: "■ "; } + +ul.lst-kix_list_16-8 { list-style-type: none; } + +ul.lst-kix_list_16-7 { list-style-type: none; } + +ul.lst-kix_list_16-6 { list-style-type: none; } + +ul.lst-kix_list_16-5 { list-style-type: none; } + +ul.lst-kix_list_16-4 { list-style-type: none; } + +.lst-kix_list_6-8 > li::before { content: "■ "; } + +ul.lst-kix_list_16-3 { list-style-type: none; } + +.lst-kix_list_6-5 > li::before { content: "■ "; } + +.lst-kix_list_6-7 > li::before { content: "■ "; } + +.lst-kix_list_6-6 > li::before { content: "■ "; } + +.lst-kix_list_7-4 > li::before { content: "■ "; } + +.lst-kix_list_7-6 > li::before { content: "■ "; } + +.lst-kix_list_7-2 > li::before { content: "■ "; } + +.lst-kix_list_13-7 > li::before { content: "■ "; } + +.lst-kix_list_7-8 > li::before { content: "■ "; } + +.lst-kix_list_15-5 > li::before { content: "■ "; } + +.lst-kix_list_4-1 > li::before { content: "○ "; } + +.lst-kix_list_15-7 > li::before { content: "■ "; } + +ul.lst-kix_list_19-7 { list-style-type: none; } + +ul.lst-kix_list_19-6 { list-style-type: none; } + +.lst-kix_list_4-3 > li::before { content: "■ "; } + +.lst-kix_list_4-5 > li::before { content: "■ "; } + +ul.lst-kix_list_19-5 { list-style-type: none; } + +ul.lst-kix_list_19-4 { list-style-type: none; } + +ul.lst-kix_list_19-3 { list-style-type: none; } + +ul.lst-kix_list_19-2 { list-style-type: none; } + +ul.lst-kix_list_19-1 { list-style-type: none; } + +ul.lst-kix_list_19-0 { list-style-type: none; } + +.lst-kix_list_15-1 > li::before { content: "○ "; } + +.lst-kix_list_15-3 > li::before { content: "■ "; } + +ul.lst-kix_list_19-8 { list-style-type: none; } + +.lst-kix_list_12-3 > li::before { content: "■ "; } + +.lst-kix_list_12-1 > li::before { content: "○ "; } + +.lst-kix_list_13-3 > li::before { content: "■ "; } + +ul.lst-kix_list_18-0 { list-style-type: none; } + +.lst-kix_list_13-5 > li::before { content: "■ "; } + +.lst-kix_list_12-5 > li::before { content: "■ "; } + +ul.lst-kix_list_18-8 { list-style-type: none; } + +ul.lst-kix_list_18-7 { list-style-type: none; } + +ul.lst-kix_list_18-6 { list-style-type: none; } + +ul.lst-kix_list_18-5 { list-style-type: none; } + +.lst-kix_list_12-7 > li::before { content: "■ "; } + +ul.lst-kix_list_18-4 { list-style-type: none; } + +ul.lst-kix_list_18-3 { list-style-type: none; } + +ul.lst-kix_list_18-2 { list-style-type: none; } + +ul.lst-kix_list_18-1 { list-style-type: none; } + +.lst-kix_list_13-1 > li::before { content: "○ "; } + +ul.lst-kix_list_f-7 { list-style-type: none; } + +ul.lst-kix_list_f-6 { list-style-type: none; } + +ul.lst-kix_list_f-5 { list-style-type: none; } + +ul.lst-kix_list_f-4 { list-style-type: none; } + +ul.lst-kix_list_f-8 { list-style-type: none; } + +ul.lst-kix_list_f-3 { list-style-type: none; } + +.lst-kix_list_3-0 > li::before { content: "● "; } + +ul.lst-kix_list_f-2 { list-style-type: none; } + +ul.lst-kix_list_f-1 { list-style-type: none; } + +ul.lst-kix_list_f-0 { list-style-type: none; } + +ul.lst-kix_list_5-7 { list-style-type: none; } + +ul.lst-kix_list_5-8 { list-style-type: none; } + +ul.lst-kix_list_5-5 { list-style-type: none; } + +ul.lst-kix_list_5-6 { list-style-type: none; } + +ul.lst-kix_list_5-0 { list-style-type: none; } + +.lst-kix_list_3-4 > li::before { content: "■ "; } + +ul.lst-kix_list_5-3 { list-style-type: none; } + +.lst-kix_list_3-3 > li::before { content: "■ "; } + +ul.lst-kix_list_5-4 { list-style-type: none; } + +ul.lst-kix_list_5-1 { list-style-type: none; } + +.lst-kix_list_8-0 > li::before { content: "● "; } + +ul.lst-kix_list_5-2 { list-style-type: none; } + +.lst-kix_list_8-7 > li::before { content: "■ "; } + +.lst-kix_list_3-8 > li::before { content: "■ "; } + +.lst-kix_list_f-6 > li::before { content: "■ "; } + +.lst-kix_list_a-7 > li::before { content: "■ "; } + +.lst-kix_list_f-7 > li::before { content: "■ "; } + +.lst-kix_list_8-3 > li::before { content: "■ "; } + +ul.lst-kix_list_13-5 { list-style-type: none; } + +ul.lst-kix_list_13-4 { list-style-type: none; } + +ul.lst-kix_list_13-3 { list-style-type: none; } + +ul.lst-kix_list_13-2 { list-style-type: none; } + +ul.lst-kix_list_13-1 { list-style-type: none; } + +.lst-kix_list_3-7 > li::before { content: "■ "; } + +ul.lst-kix_list_13-0 { list-style-type: none; } + +.lst-kix_list_8-4 > li::before { content: "■ "; } + +.lst-kix_list_a-2 > li::before { content: "■ "; } + +ul.lst-kix_list_13-8 { list-style-type: none; } + +.lst-kix_list_a-3 > li::before { content: "■ "; } + +.lst-kix_list_11-1 > li::before { content: "○ "; } + +ul.lst-kix_list_13-7 { list-style-type: none; } + +ul.lst-kix_list_13-6 { list-style-type: none; } + +.lst-kix_list_f-3 > li::before { content: "■ "; } + +.lst-kix_list_a-6 > li::before { content: "■ "; } + +.lst-kix_list_f-2 > li::before { content: "■ "; } + +.lst-kix_list_11-0 > li::before { content: "● "; } + +.lst-kix_list_8-8 > li::before { content: "■ "; } + +ul.lst-kix_list_e-8 { list-style-type: none; } + +.lst-kix_list_16-8 > li::before { content: "■ "; } + +ul.lst-kix_list_e-7 { list-style-type: none; } + +ul.lst-kix_list_e-6 { list-style-type: none; } + +.lst-kix_list_16-7 > li::before { content: "■ "; } + +ul.lst-kix_list_e-5 { list-style-type: none; } + +.lst-kix_list_e-3 > li::before { content: "■ "; } + +.lst-kix_list_e-7 > li::before { content: "■ "; } + +.lst-kix_list_e-2 > li::before { content: "■ "; } + +.lst-kix_list_e-6 > li::before { content: "■ "; } + +.lst-kix_list_4-8 > li::before { content: "■ "; } + +ul.lst-kix_list_e-0 { list-style-type: none; } + +.lst-kix_list_4-7 > li::before { content: "■ "; } + +.lst-kix_list_17-0 > li::before { content: "● "; } + +ul.lst-kix_list_e-4 { list-style-type: none; } + +ul.lst-kix_list_e-3 { list-style-type: none; } + +ul.lst-kix_list_e-2 { list-style-type: none; } + +ul.lst-kix_list_e-1 { list-style-type: none; } + +ul.lst-kix_list_4-8 { list-style-type: none; } + +.lst-kix_list_16-0 > li::before { content: "● "; } + +ul.lst-kix_list_4-6 { list-style-type: none; } + +ul.lst-kix_list_4-7 { list-style-type: none; } + +ul.lst-kix_list_4-0 { list-style-type: none; } + +.lst-kix_list_16-4 > li::before { content: "■ "; } + +ul.lst-kix_list_4-1 { list-style-type: none; } + +.lst-kix_list_16-3 > li::before { content: "■ "; } + +ul.lst-kix_list_4-4 { list-style-type: none; } + +ul.lst-kix_list_4-5 { list-style-type: none; } + +ul.lst-kix_list_4-2 { list-style-type: none; } + +ul.lst-kix_list_4-3 { list-style-type: none; } + +ul.lst-kix_list_12-6 { list-style-type: none; } + +ul.lst-kix_list_12-5 { list-style-type: none; } + +.lst-kix_list_17-7 > li::before { content: "■ "; } + +ul.lst-kix_list_12-4 { list-style-type: none; } + +ul.lst-kix_list_12-3 { list-style-type: none; } + +ul.lst-kix_list_12-2 { list-style-type: none; } + +ul.lst-kix_list_12-1 { list-style-type: none; } + +.lst-kix_list_17-8 > li::before { content: "■ "; } + +ul.lst-kix_list_12-0 { list-style-type: none; } + +.lst-kix_list_17-3 > li::before { content: "■ "; } + +.lst-kix_list_17-4 > li::before { content: "■ "; } + +ul.lst-kix_list_12-8 { list-style-type: none; } + +ul.lst-kix_list_12-7 { list-style-type: none; } + +.lst-kix_list_7-0 > li::before { content: "● "; } + +.lst-kix_list_2-4 > li::before { content: "■ "; } + +.lst-kix_list_2-8 > li::before { content: "■ "; } + +.lst-kix_list_7-3 > li::before { content: "■ "; } + +ul.lst-kix_list_7-5 { list-style-type: none; } + +.lst-kix_list_10-0 > li::before { content: "● "; } + +ul.lst-kix_list_7-6 { list-style-type: none; } + +ul.lst-kix_list_7-3 { list-style-type: none; } + +ul.lst-kix_list_7-4 { list-style-type: none; } + +.lst-kix_list_13-8 > li::before { content: "■ "; } + +.lst-kix_list_b-3 > li::before { content: "■ "; } + +.lst-kix_list_b-7 > li::before { content: "■ "; } + +.lst-kix_list_18-3 > li::before { content: "■ "; } + +.lst-kix_list_18-7 > li::before { content: "■ "; } + +ul.lst-kix_list_7-7 { list-style-type: none; } + +ul.lst-kix_list_7-8 { list-style-type: none; } + +ul.lst-kix_list_7-1 { list-style-type: none; } + +ul.lst-kix_list_7-2 { list-style-type: none; } + +ul.lst-kix_list_7-0 { list-style-type: none; } + +.lst-kix_list_7-7 > li::before { content: "■ "; } + +.lst-kix_list_15-4 > li::before { content: "■ "; } + +.lst-kix_list_10-4 > li::before { content: "■ "; } + +.lst-kix_list_10-8 > li::before { content: "■ "; } + +.lst-kix_list_4-0 > li::before { content: "● "; } + +ul.lst-kix_list_15-3 { list-style-type: none; } + +ul.lst-kix_list_15-2 { list-style-type: none; } + +.lst-kix_list_15-0 > li::before { content: "● "; } + +ul.lst-kix_list_15-1 { list-style-type: none; } + +.lst-kix_list_15-8 > li::before { content: "■ "; } + +ul.lst-kix_list_15-0 { list-style-type: none; } + +.lst-kix_list_4-4 > li::before { content: "■ "; } + +ul.lst-kix_list_15-8 { list-style-type: none; } + +ul.lst-kix_list_15-7 { list-style-type: none; } + +ul.lst-kix_list_15-6 { list-style-type: none; } + +.lst-kix_list_9-3 > li::before { content: "■ "; } + +ul.lst-kix_list_15-5 { list-style-type: none; } + +ul.lst-kix_list_15-4 { list-style-type: none; } + +.lst-kix_list_9-7 > li::before { content: "■ "; } + +.lst-kix_list_11-4 > li::before { content: "■ "; } + +.lst-kix_list_12-4 > li::before { content: "■ "; } + +ul.lst-kix_list_6-6 { list-style-type: none; } + +ul.lst-kix_list_6-7 { list-style-type: none; } + +ul.lst-kix_list_6-4 { list-style-type: none; } + +ul.lst-kix_list_6-5 { list-style-type: none; } + +ul.lst-kix_list_6-8 { list-style-type: none; } + +.lst-kix_list_1-0 > li::before { content: "● "; } + +.lst-kix_list_1a-3 > li::before { content: "■ "; } + +ul.lst-kix_list_6-2 { list-style-type: none; } + +.lst-kix_list_11-8 > li::before { content: "■ "; } + +ul.lst-kix_list_6-3 { list-style-type: none; } + +ul.lst-kix_list_6-0 { list-style-type: none; } + +.lst-kix_list_12-0 > li::before { content: "● "; } + +ul.lst-kix_list_6-1 { list-style-type: none; } + +.lst-kix_list_1-4 > li::before { content: "■ "; } + +.lst-kix_list_13-0 > li::before { content: "● "; } + +ul.lst-kix_list_14-4 { list-style-type: none; } + +ul.lst-kix_list_14-3 { list-style-type: none; } + +ul.lst-kix_list_14-2 { list-style-type: none; } + +.lst-kix_list_13-4 > li::before { content: "■ "; } + +ul.lst-kix_list_14-1 { list-style-type: none; } + +ul.lst-kix_list_14-0 { list-style-type: none; } + +ul.lst-kix_list_14-8 { list-style-type: none; } + +ul.lst-kix_list_14-7 { list-style-type: none; } + +.lst-kix_list_2-0 > li::before { content: "● "; } + +ul.lst-kix_list_14-6 { list-style-type: none; } + +ul.lst-kix_list_14-5 { list-style-type: none; } + +.lst-kix_list_1-8 > li::before { content: "■ "; } + +.lst-kix_list_12-8 > li::before { content: "■ "; } + +.lst-kix_list_c-0 > li::before { content: "● "; } + +.lst-kix_list_19-0 > li::before { content: "● "; } + +.lst-kix_list_19-1 > li::before { content: "○ "; } + +ul.lst-kix_list_b-8 { list-style-type: none; } + +ul.lst-kix_list_1-0 { list-style-type: none; } + +.lst-kix_list_c-1 > li::before { content: "○ "; } + +ul.lst-kix_list_b-3 { list-style-type: none; } + +ul.lst-kix_list_b-2 { list-style-type: none; } + +.lst-kix_list_c-3 > li::before { content: "■ "; } + +.lst-kix_list_c-4 > li::before { content: "■ "; } + +.lst-kix_list_19-4 > li::before { content: "■ "; } + +ul.lst-kix_list_b-1 { list-style-type: none; } + +ul.lst-kix_list_b-0 { list-style-type: none; } + +ul.lst-kix_list_b-7 { list-style-type: none; } + +ul.lst-kix_list_b-6 { list-style-type: none; } + +.lst-kix_list_c-2 > li::before { content: "■ "; } + +.lst-kix_list_19-2 > li::before { content: "■ "; } + +.lst-kix_list_19-3 > li::before { content: "■ "; } + +ul.lst-kix_list_b-5 { list-style-type: none; } + +ul.lst-kix_list_b-4 { list-style-type: none; } + +ul.lst-kix_list_1-3 { list-style-type: none; } + +ul.lst-kix_list_1-4 { list-style-type: none; } + +ul.lst-kix_list_1-1 { list-style-type: none; } + +ul.lst-kix_list_1-2 { list-style-type: none; } + +ul.lst-kix_list_1-7 { list-style-type: none; } + +ul.lst-kix_list_1-8 { list-style-type: none; } + +ul.lst-kix_list_1-5 { list-style-type: none; } + +ul.lst-kix_list_1-6 { list-style-type: none; } + +.lst-kix_list_1a-5 > li::before { content: "■ "; } + +.lst-kix_list_1a-6 > li::before { content: "■ "; } + +.lst-kix_list_1a-8 > li::before { content: "■ "; } + +.lst-kix_list_19-8 > li::before { content: "■ "; } + +.lst-kix_list_1a-7 > li::before { content: "■ "; } + +.lst-kix_list_19-5 > li::before { content: "■ "; } + +.lst-kix_list_19-6 > li::before { content: "■ "; } + +.lst-kix_list_19-7 > li::before { content: "■ "; } + +ul.lst-kix_list_a-4 { list-style-type: none; } + +ul.lst-kix_list_a-3 { list-style-type: none; } + +ul.lst-kix_list_a-2 { list-style-type: none; } + +ul.lst-kix_list_a-1 { list-style-type: none; } + +ul.lst-kix_list_a-8 { list-style-type: none; } + +ul.lst-kix_list_a-7 { list-style-type: none; } + +ul.lst-kix_list_a-6 { list-style-type: none; } + +ul.lst-kix_list_a-5 { list-style-type: none; } + +.lst-kix_list_d-6 > li::before { content: "■ "; } + +.lst-kix_list_d-8 > li::before { content: "■ "; } + +.lst-kix_list_d-7 > li::before { content: "■ "; } + +.lst-kix_list_d-2 > li::before { content: "■ "; } + +.lst-kix_list_18-0 > li::before { content: "● "; } + +.lst-kix_list_d-1 > li::before { content: "○ "; } + +.lst-kix_list_d-5 > li::before { content: "■ "; } + +.lst-kix_list_18-1 > li::before { content: "○ "; } + +.lst-kix_list_18-2 > li::before { content: "■ "; } + +.lst-kix_list_d-4 > li::before { content: "■ "; } + +.lst-kix_list_d-3 > li::before { content: "■ "; } + +.lst-kix_list_c-7 > li::before { content: "■ "; } + +ul.lst-kix_list_a-0 { list-style-type: none; } + +.lst-kix_list_c-5 > li::before { content: "■ "; } + +.lst-kix_list_c-8 > li::before { content: "■ "; } + +.lst-kix_list_d-0 > li::before { content: "● "; } + +.lst-kix_list_c-6 > li::before { content: "■ "; } + +.lst-kix_list_2-7 > li::before { content: "■ "; } + +ul.lst-kix_list_d-8 { list-style-type: none; } + +ul.lst-kix_list_d-7 { list-style-type: none; } + +ul.lst-kix_list_d-6 { list-style-type: none; } + +.lst-kix_list_2-5 > li::before { content: "■ "; } + +ul.lst-kix_list_d-1 { list-style-type: none; } + +ul.lst-kix_list_d-0 { list-style-type: none; } + +.lst-kix_list_b-8 > li::before { content: "■ "; } + +ul.lst-kix_list_d-5 { list-style-type: none; } + +ul.lst-kix_list_d-4 { list-style-type: none; } + +ul.lst-kix_list_d-3 { list-style-type: none; } + +ul.lst-kix_list_d-2 { list-style-type: none; } + +ul.lst-kix_list_1a-0 { list-style-type: none; } + +ul.lst-kix_list_1a-1 { list-style-type: none; } + +.lst-kix_list_b-4 > li::before { content: "■ "; } + +.lst-kix_list_18-6 > li::before { content: "■ "; } + +ul.lst-kix_list_3-7 { list-style-type: none; } + +ul.lst-kix_list_1a-2 { list-style-type: none; } + +ul.lst-kix_list_3-8 { list-style-type: none; } + +ul.lst-kix_list_1a-3 { list-style-type: none; } + +ul.lst-kix_list_1a-4 { list-style-type: none; } + +.lst-kix_list_10-1 > li::before { content: "○ "; } + +ul.lst-kix_list_1a-5 { list-style-type: none; } + +.lst-kix_list_18-4 > li::before { content: "■ "; } + +.lst-kix_list_18-8 > li::before { content: "■ "; } + +ul.lst-kix_list_1a-6 { list-style-type: none; } + +ul.lst-kix_list_1a-7 { list-style-type: none; } + +ul.lst-kix_list_3-1 { list-style-type: none; } + +ul.lst-kix_list_3-2 { list-style-type: none; } + +ul.lst-kix_list_3-0 { list-style-type: none; } + +ul.lst-kix_list_3-5 { list-style-type: none; } + +ul.lst-kix_list_3-6 { list-style-type: none; } + +.lst-kix_list_b-6 > li::before { content: "■ "; } + +ul.lst-kix_list_3-3 { list-style-type: none; } + +ul.lst-kix_list_3-4 { list-style-type: none; } + +.lst-kix_list_10-7 > li::before { content: "■ "; } + +.lst-kix_list_10-5 > li::before { content: "■ "; } + +.lst-kix_list_10-3 > li::before { content: "■ "; } + +ul.lst-kix_list_11-7 { list-style-type: none; } + +ul.lst-kix_list_11-6 { list-style-type: none; } + +.lst-kix_list_b-0 > li::before { content: "● "; } + +ul.lst-kix_list_11-5 { list-style-type: none; } + +ul.lst-kix_list_11-4 { list-style-type: none; } + +ul.lst-kix_list_11-3 { list-style-type: none; } + +ul.lst-kix_list_11-2 { list-style-type: none; } + +.lst-kix_list_b-2 > li::before { content: "■ "; } + +ul.lst-kix_list_11-1 { list-style-type: none; } + +ul.lst-kix_list_11-0 { list-style-type: none; } + +.lst-kix_list_9-2 > li::before { content: "■ "; } + +ul.lst-kix_list_11-8 { list-style-type: none; } + +.lst-kix_list_9-0 > li::before { content: "● "; } + +ul.lst-kix_list_c-8 { list-style-type: none; } + +ul.lst-kix_list_c-7 { list-style-type: none; } + +.lst-kix_list_9-6 > li::before { content: "■ "; } + +ul.lst-kix_list_c-2 { list-style-type: none; } + +ul.lst-kix_list_c-1 { list-style-type: none; } + +ul.lst-kix_list_c-0 { list-style-type: none; } + +.lst-kix_list_9-4 > li::before { content: "■ "; } + +ul.lst-kix_list_c-6 { list-style-type: none; } + +.lst-kix_list_a-0 > li::before { content: "● "; } + +ul.lst-kix_list_c-5 { list-style-type: none; } + +.lst-kix_list_11-3 > li::before { content: "■ "; } + +ul.lst-kix_list_c-4 { list-style-type: none; } + +ul.lst-kix_list_c-3 { list-style-type: none; } + +ul.lst-kix_list_2-8 { list-style-type: none; } + +.lst-kix_list_11-5 > li::before { content: "■ "; } + +ul.lst-kix_list_2-2 { list-style-type: none; } + +.lst-kix_list_1a-4 > li::before { content: "■ "; } + +ul.lst-kix_list_2-3 { list-style-type: none; } + +ul.lst-kix_list_2-0 { list-style-type: none; } + +ul.lst-kix_list_2-1 { list-style-type: none; } + +.lst-kix_list_9-8 > li::before { content: "■ "; } + +ul.lst-kix_list_2-6 { list-style-type: none; } + +.lst-kix_list_1a-2 > li::before { content: "■ "; } + +.lst-kix_list_1-1 > li::before { content: "○ "; } + +ul.lst-kix_list_2-7 { list-style-type: none; } + +.lst-kix_list_11-7 > li::before { content: "■ "; } + +ul.lst-kix_list_2-4 { list-style-type: none; } + +ul.lst-kix_list_2-5 { list-style-type: none; } + +ul.lst-kix_list_10-0 { list-style-type: none; } + +.lst-kix_list_1a-0 > li::before { content: "● "; } + +.lst-kix_list_1-3 > li::before { content: "■ "; } + +ul.lst-kix_list_10-8 { list-style-type: none; } + +ul.lst-kix_list_1a-8 { list-style-type: none; } + +ul.lst-kix_list_10-7 { list-style-type: none; } + +.lst-kix_list_1-7 > li::before { content: "■ "; } + +ul.lst-kix_list_10-6 { list-style-type: none; } + +ul.lst-kix_list_10-5 { list-style-type: none; } + +ul.lst-kix_list_10-4 { list-style-type: none; } + +ul.lst-kix_list_10-3 { list-style-type: none; } + +.lst-kix_list_1-5 > li::before { content: "■ "; } + +ul.lst-kix_list_10-2 { list-style-type: none; } + +ul.lst-kix_list_10-1 { list-style-type: none; } + +.lst-kix_list_2-1 > li::before { content: "○ "; } + +.lst-kix_list_2-3 > li::before { content: "■ "; } + +.lst-kix_list_3-1 > li::before { content: "○ "; } + +.lst-kix_list_3-2 > li::before { content: "■ "; } + +.lst-kix_list_8-1 > li::before { content: "○ "; } + +.lst-kix_list_8-2 > li::before { content: "■ "; } + +.lst-kix_list_3-5 > li::before { content: "■ "; } + +.lst-kix_list_f-8 > li::before { content: "■ "; } + +.lst-kix_list_8-5 > li::before { content: "■ "; } + +.lst-kix_list_8-6 > li::before { content: "■ "; } + +.lst-kix_list_3-6 > li::before { content: "■ "; } + +.lst-kix_list_f-4 > li::before { content: "■ "; } + +.lst-kix_list_a-8 > li::before { content: "■ "; } + +.lst-kix_list_f-5 > li::before { content: "■ "; } + +.lst-kix_list_11-2 > li::before { content: "■ "; } + +.lst-kix_list_a-1 > li::before { content: "○ "; } + +.lst-kix_list_f-0 > li::before { content: "● "; } + +.lst-kix_list_a-5 > li::before { content: "■ "; } + +.lst-kix_list_a-4 > li::before { content: "■ "; } + +.lst-kix_list_f-1 > li::before { content: "○ "; } + +.lst-kix_list_e-5 > li::before { content: "■ "; } + +.lst-kix_list_16-6 > li::before { content: "■ "; } + +.lst-kix_list_17-1 > li::before { content: "○ "; } + +.lst-kix_list_e-4 > li::before { content: "■ "; } + +.lst-kix_list_16-1 > li::before { content: "○ "; } + +.lst-kix_list_16-2 > li::before { content: "■ "; } + +.lst-kix_list_e-1 > li::before { content: "○ "; } + +.lst-kix_list_16-5 > li::before { content: "■ "; } + +.lst-kix_list_e-0 > li::before { content: "● "; } + +.lst-kix_list_17-2 > li::before { content: "■ "; } + +.lst-kix_list_17-6 > li::before { content: "■ "; } + +.lst-kix_list_17-5 > li::before { content: "■ "; } + +.lst-kix_list_2-6 > li::before { content: "■ "; } + +.lst-kix_list_7-1 > li::before { content: "○ "; } + +.lst-kix_list_7-5 > li::before { content: "■ "; } + +.lst-kix_list_b-5 > li::before { content: "■ "; } + +.lst-kix_list_18-5 > li::before { content: "■ "; } + +.lst-kix_list_13-6 > li::before { content: "■ "; } + +.lst-kix_list_15-6 > li::before { content: "■ "; } + +.lst-kix_list_b-1 > li::before { content: "○ "; } + +.lst-kix_list_10-2 > li::before { content: "■ "; } + +.lst-kix_list_4-2 > li::before { content: "■ "; } + +.lst-kix_list_4-6 > li::before { content: "■ "; } + +.lst-kix_list_15-2 > li::before { content: "■ "; } + +.lst-kix_list_10-6 > li::before { content: "■ "; } + +.lst-kix_list_9-1 > li::before { content: "○ "; } + +.lst-kix_list_e-8 > li::before { content: "■ "; } + +.lst-kix_list_9-5 > li::before { content: "■ "; } + +.lst-kix_list_12-2 > li::before { content: "■ "; } + +.lst-kix_list_11-6 > li::before { content: "■ "; } + +.lst-kix_list_1-2 > li::before { content: "■ "; } + +.lst-kix_list_1a-1 > li::before { content: "○ "; } + +.lst-kix_list_1-6 > li::before { content: "■ "; } + +.lst-kix_list_12-6 > li::before { content: "■ "; } + +.lst-kix_list_2-2 > li::before { content: "■ "; } + +.lst-kix_list_13-2 > li::before { content: "■ "; } +------MultipartBoundary--zmGvipyjWUpT0gAfLJbw3hmbaeNqVxyLAosKXVU9r0---- +Content-Type: image/png +Content-Transfer-Encoding: binary +Content-Location: https://ssl.gstatic.com/docs/common/mobileweb_sprite1.png + +PNG + + IHDR$ UIDATh[[lWΙٛn 8Ik'm\*VEBj51/T5PZ&чJ *ch ܀B)I+!XNHbr:w*>z˅ۦz,3?0u%K/ݚ=sl, XGfѪڎꂒ"ԷU +L*ݟ(9 ?/(ϥdb}۽TAq(&c~@̸ +($ L Dҩ:?slxt4eHY' L]; tzMc;#) >bs{SSL.#T<@Sc$T ǝ)9 0*e,Ok=DDAi?3b'_ OP&^`WX?nf0[ט> 2P_"cTd"$`i6'WjEŒF V*4 +7I ;f,RlxLwMÕ=f13dtb zM}b-`"@2)q.wJQ-ޙX=r1/caOڭxfֆ +x ӏUbX'Wo}fPb3\=~*kULi_mpIe=$S5~ zS0McH^Z&:9 ([ k5|ǡ8=ˮI$;=e?:HoFy, FXQcC7 aN#Q3ZGH:9%m@  8U#'ږKN{ūvF±01ߜFˮӳN,PcT^>z_<^KGc5yۉg_I 49f1|Yډ4FF,NGuA)jUXd:8A$lkC50'S[=+ tbbٱѓfcPg%w-\c)m* + "<%i1lBDc 1(/™3sbΙ4 C kW!BUde6V$ 9iMX\٩ \AN1Ba >O \';2LV(\v "]Le6 \Ėe|v$``hʂ)gzEN 2W_Vnhhp~ `*,#rDv NjU,bO -a-ST?+%ߘqw2Yȋ<#je\(܃PTbC1BDP1<&xܞeUGcH@cdp c#g93#;^K@Kct$ ߿1i0yOZh@}..M.'|f|FŌs M ̂дfki0[o&0T`l` B' +LZfbS~8X'7"l[S7Ļ;3A6 킀xgW5l|k?XFk?Hp^[:n?b, +L/c@ұ+&3lޒ<0])ᜂKhd VWmI7+c\,)ݮP*?Z/0pŹ u|ԾUB)]+KƔ8s?Z+r`כּe MԶ2Cy|MfS&9ѽ̄i/%ڝfP' սµ[=ߌX?V/$ 5c,b1HBSȿE+5@{ +4(:] Org1 -> Org2 -> Org3 แล้วส่งผลกลับตามลำดับเดิม + - 2.5.3 การจัดการ Drawing (RFA_DWG): + - เอกสาร RFA_DWG จะประกอบไปด้วย Shop Drawing (shop_drawings) หลายแผ่น ซึ่งแต่ละแผ่นมี Revision ของตัวเอง + - Shop Drawing แต่ละ Revision สามารถอ้างอิงถึง Contract Drawing (Ccontract_drawings) หลายแผ่น หรือไม่อ้างถึงก็ได้ + - ระบบต้องมีส่วนสำหรับจัดการข้อมูล Master Data ของทั้ง Shop Drawing และ Contract Drawing แยกจากกัน + +## 3. ข้อกำหนดด้านสิทธิ์และการเข้าถึง (Access Control Requirements) + +- 3.1 ภาพรวม: ผู้ใช้และองค์กรสามารถดูและแก้ไขเอกสารได้ตามสิทธิ์ที่ได้รับ โดยระบบสิทธิ์จะเป็นแบบ Role-Based Access Control (RBAC) +- 3.2 ระดับของสิทธิ์: + - Global Roles: สิทธิ์ในภาพรวมของระบบ + - Project-Specific Roles: สิทธิ์ที่ถูกกำหนดให้ผู้ใช้สำหรับโครงการนั้นๆ โดยเฉพาะ (เช่น เป็น Editor ในโครงการ A แต่เป็น Viewer ในโครงการ B) +- 3.3 บทบาท (Roles) พื้นฐาน: + - Superadmin: ไม่มีข้อจำกัดใดๆ สามารถจัดการได้ทุกอย่างข้ามองค์กร + - Admin: มีสิทธิ์เต็มที่ แต่จำกัดเฉพาะในองค์กรที่ตัวเองสังกัด สามารถจัดการผู้ใช้ในองค์กรได้ + - Document Control / Editor: สามารถ เพิ่ม/แก้ไข เอกสาร เฉพาะในองค์กรที่ตัวเองสังกัด ไม่สามารถจัดการผู้ใช้ได้ + - สามารถสร้าง Role ใหม่และกำหนดสิทธิ์ (Permissions) เพิ่มเติมได้ในภายหลังผ่านหน้า Admin Panel +- 3.4 การบังคับใช้สิทธิ์: สิทธิ์ขององค์กรจะครอบคลุมสิทธิ์ของผู้ใช้ และการเข้าถึงข้อมูลที่เกี่ยวข้องกับโครงการ (เช่น การแก้ไขเอกสาร) จะถูกตรวจสอบเทียบกับสิทธิ์ที่ผู้ใช้มีในโครงการนั้นๆ โดยเฉพาะ + +## 4. ข้อกำหนดด้านผู้ใช้งาน (User Interface & Experience) + +- 4.1 Layout หลัก: หน้าเว็บใช้รูปแบบ App Shell ที่ประกอบด้วย: + - Navbar (ส่วนบน): แสดงชื่อระบบ, เมนูผู้ใช้ (Profile), เมนูสำหรับ Admin/Superadmin (จัดการผู้ใช้, จัดการสิทธิ์), และปุ่ม Login/Logout + - Sidebar (ด้านข้าง): เป็นเมนูหลักสำหรับเข้าถึงส่วนที่เกี่ยวกับเอกสารทั้งหมด เช่น Dashboard, Correspondences, RFA, Drawings + - Main Content Area: พื้นที่สำหรับแสดงเนื้อหาหลักของหน้าที่เลือก +- 4.2 หน้า Landing Page: เป็นหน้าแรกที่แสดงข้อมูลบางส่วนของโครงการสำหรับผู้ใช้ที่ยังไม่ได้ล็อกอิน +- 4.3 หน้า Dashboard: เป็นหน้าแรกหลังจากล็อกอิน ประกอบด้วย: + - การ์ดสรุปภาพรวม (KPI Cards): แสดงข้อมูลสรุปที่สำคัญขององค์กร เช่น จำนวนเอกสาร, งานที่เกินกำหนด + - ตาราง "งานของฉัน" (My Tasks Table): แสดงรายการงานทั้งหมดจาก Circulation ที่ผู้ใช้ต้องดำเนินการ +- 4.4 การติดตามสถานะ: องค์กรสามารถติดตามสถานะเอกสารทั้งของตนเอง (Originator) และสถานะเอกสารที่ส่งมาถึงตนเอง (Recipient) +- 4.5 การจัดการข้อมูลส่วนตัว (Profile Page): ผู้ใช้สามารถจัดการข้อมูลส่วนตัวและเปลี่ยนรหัสผ่านของตนเองได้ +- 4.6 การจัดการเอกสารทางเทคนิค (Technical Documents & Workflow): ผู้ใช้สามารถดู Technical Document ในรูปแบบ Workflow ทั้งหมดได้ในหน้าเดียว, ขั้นตอนที่ยังไม่ถึงหรือผ่านไปแล้วจะเป็นรูปแบบ diable, สามารถดำเนินการได้เฉพาะในขั้นตอนที่ได้รับมอบหมายงาน (active) เช่น ตรวจสอบแล้ว เพื่อไปยังขั้นตอนต่อไป, สิทธิ์ admin ขึ้นไป สามรถกด ไปยังขั้นตอนต่อไป ได้ทุกขั้นตอน, การย้อนกลับ ไปขั้นตอนก่อนหน้า สามารถทำได้โดย สิทธิ์ admin ขึ้นไป + +## 5. ข้อกำหนดที่ไม่ใช่ฟังก์ชันการทำงาน (Non-Functional Requirements) + +- 5.1 การบันทึกการกระทำ (Audit Log): ทุกการกระทำที่สำคัญของผู้ใช้ (สร้าง, แก้ไข, ลบ, ส่ง) จะถูกบันทึกไว้ใน audit_logs เพื่อการตรวจสอบย้อนหลัง +- 5.2 การค้นหา (Search): ระบบต้องมีฟังก์ชันการค้นหาขั้นสูง ที่สามารถค้นหาเอกสารจากหลายเงื่อนไขพร้อมกันได้ เช่น ค้นหาจากชื่อเรื่อง, ประเภท, วันที่, และ Tag +- 5.3 การทำรายงาน (Reporting): สามารถจัดทำรายงานสรุปแยกประเภทของ Correspondence ประจำวัน, สัปดาห์, เดือน, และปีได้ +- 5.4 ประสิทธิภาพ (Performance): มีการใช้ Caching กับข้อมูลที่เรียกใช้บ่อย และใช้ Pagination ในตารางข้อมูลเพื่อจัดการข้อมูลจำนวนมาก +- 5.5 ความปลอดภัย (Security): + - มีระบบ Rate Limiting เพื่อป้องกันการโจมตีแบบ Brute-force + - การจัดการ Secret (เช่น รหัสผ่าน DB, JWT Secret) จะต้องทำผ่าน Environment Variable ของ Docker เพื่อความปลอดภัยสูงสุด diff --git a/docs/Markdown/LCBP3-DMS V1_1_0_application _requirements.md b/docs/Markdown/LCBP3-DMS V1_1_0_application _requirements.md new file mode 100644 index 0000000..db0e7a1 --- /dev/null +++ b/docs/Markdown/LCBP3-DMS V1_1_0_application _requirements.md @@ -0,0 +1,197 @@ +# 📝 Documents Management Sytem Version 1.1.0: Application Requirements Specification +## 📌 1. วัตถุประสงค์ +สร้างเว็บแอปพลิเคชั่นสำหรับระบบบริหารจัดการเอกสารโครงการ (Document Management System) ที่สามารถจัดการและควบคุม การสื่อสารด้วยเอกสารที่ซับซ้อน อย่างมีประสิทธิภาพ +* มีฟังก์ชันหลักในการอัปโหลด จัดเก็บ ค้นหา แชร์ และควบคุมสิทธิ์การเข้าถึงเอกสาร +* ช่วยลดการใช้เอกสารกระดาษ เพิ่มความปลอดภัยในการจัดเก็บข้อมูล +* เพิ่มความสะดวกในการทำงานร่วมกันระหว่างองกรณ์ + +## 🛠️ 2. สถาปัตยกรรมและเทคโนโลยี (System Architecture & Technology Stack) + +ใช้สถาปัตยกรรมแบบ Headless/API-First ที่ทันสมัย ทำงานทั้งหมดบน QNAP Server ผ่าน Container Station เพื่อความสะดวกในการจัดการและบำรุงรักษา, Domain: np-dms.work, มี fix ip, รัน docker command ใน application ของ Container Station ได้โดยตรง, ประกอบด้วย + +* 2.1. Infrastructure & Environment: + - Server: QNAP (Model: TS-473A, RAM: 32GB, CPU: AMD Ryzen V1500B) + - Containerization: Container Station (Docker & Docker Compose) ใช้ UI ของ Container Station เป็นหลัก ในการ configuration และการรัน docker command + - Development Environment: VS Code on Windows 11 + - Domain: np-dms.work, www.np-dms.work + - ip: 159.192.126.103 + - Docker Network: ทุก Service จะเชื่อมต่อผ่านเครือข่ายกลางชื่อ lcbp3 เพื่อให้สามารถสื่อสารกันได้ + - Data Storage: /share/dms-data บน QNAP + - ข้อจำกัด: ไม่สามารถใช้ .env ในการกำหนดตัวแปรภายนอกได้ ต้องกำหนดใน docker-compose.yml เท่านั้น +* 2.2. Code Hosting: + - Application name: git + - Service: Gitea (Self-hosted on QNAP) + - Service name: gitea + - Domain: git.np-dms.work + - หน้าที่: เป็นศูนย์กลางในการเก็บและจัดการเวอร์ชันของโค้ด (Source Code) สำหรับทุกส่วน +* 2.3. Backend / Data Platform: + - Application name: lcbp3-backend + - Service: NestJS + - Service name: backend + - Domain: backend.np-dms.work + - Framework: NestJS (Node.js, TypeScript, ESM) + - หน้าที่: จัดการโครงสร้างข้อมูล (Data Models), สร้าง API, จัดการสิทธิ์ผู้ใช้ (Roles & Permissions), และสร้าง Workflow ทั้งหมดของระบบ +* 2.4. Database: + - Application name: lcbp3-db + - Service: mariadb:10.11 + - Service name: mariadb + - Domain: db.np-dms.work + - หน้าที่: ฐานข้อมูลหลักสำหรับเก็บข้อมูลทั้งหมด + - Tooling: DBeaver (Community Edition), phpmyadmin สำหรับการออกแบบและจัดการฐานข้อมูล +* 2.5. Database management: + - Application name: lcbp3-db + - Service: phpmyadmin:5-apache + - Service name: pma + - Domain: pma.np-dms.work + - หน้าที่: จัดการฐานข้อมูล mariadb ผ่าน Web UI +* 2.6. Frontend: + - Application name: lcbp3-frontend + - Service: next.js + - Service name: frontend + - Domain: lcbp3.np-dms.work + - Framework: Next.js (App Router, React, TypeScript, ESM) + - Styling: Tailwind CSS + PostCSS + - Component Library: shadcn/ui + - หน้าที่: สร้างหน้าตาเว็บแอปพลิเคชันสำหรับให้ผู้ใช้งานเข้ามาดู Dashboard, จัดการเอกสาร, และติดตามงาน โดยจะสื่อสารกับ Backend ผ่าน API +* 2.7. Workflow automation: + - Application name: lcbp3-n8n + - Service: n8nio/n8n:latest + - Service name: n8n + - Domain: n8n.np-dms.work + - หน้าที่: จัดการ workflow ระหว่าง Backend และ Line +* 2.8. Reverse Proxy: + - Application name: lcbp3-npm + - Service: Nginx Proxy Manager (nginx-proxy-manage: latest) + - Service name: npm + - Domain: npm.np-dms.work + - หน้าที่: เป็นด่านหน้าในการรับ-ส่งข้อมูล จัดการโดเมนทั้งหมด, ทำหน้าที่เป็น Proxy ชี้ไปยัง Service ที่ถูกต้อง, และจัดการ SSL Certificate (HTTPS) ให้อัตโนมัติ + + +## 📦 3. ข้อกำหนดด้านฟังก์ชันการทำงาน (Functional Requirements) + +* 3.1. การจัดการโครงสร้างโครงการและองค์กร + - 3.1.1. โครงการ (Projects): ระบบต้องสามารถจัดการเอกสารภายในหลายโครงการได้ (ปัจจุบันมี 4 โครงการ และจะเพิ่มขึ้นในอนาคต) + - 3.1.2. สัญญา (Contracts): ระบบต้องสามารถจัดการเอกสารภายในแต่ละสัญญาได้ ในแต่ละโครงการ มีได้หลายสัญญา หรืออย่างน้อย 1 สัญญา + - 3.1.3. องค์กร (Organizations): + - มีหลายองค์กรในโครงการ องค์กรณ์ที่เป็น Owner, Designer และ Consultant สามารถอยู่ในหลายโครงการและหลายสัญญาได้ + - Contractor จะถือ 1 สัญญา และอยู่ใน 1 โครงการเท่านั้น + +* 3.2. การจัดการเอกสารโต้ตอบ (Correspondence Management) + - 3.2.1. วัตถุประสงค์: เอกสารโต้ตอบ (correspondences) ระหว่างองกรณื-องกรณ์ ภายใน โครงการ (Projects) และระหว่าง องค์กร-องค์กร ภายนอก โครงการ (Projects) + - 3.2.2. ประเภทเอกสาร: ระบบต้องรองรับเอกสารรูปแบบ ไฟล์ PDF หลายประเภท (Types) เช่น จดหมาย (Letter), อีเมล์ (Email), Request for Information (RFI), และสามารถเพิ่มประเภทใหม่ได้ในภายหลัง + - 3.2.3. การสร้างเอกสาร (Correspondence): + - ผู้ใช้ที่มีสิทธิ์ (เช่น Document Control) สามารถสร้างเอกสารรอไว้ในสถานะ ฉบับร่าง" (Draft) ได้ ซึ่งผู้ใช้งานต่างองค์กรจะมองไม่เห็น + - เมื่อกด "Submitted" แล้ว การแก้ไข, ถอนเอกสารกลับไปสถานะ Draft, หรือยกเลิก (Cancel) จะต้องทำโดยผู้ใช้ระดับ Admin ขึ้นไป พร้อมระบุเหตุผล + - 3.2.4. การอ้างอิงและจัดกลุ่ม: + - เอกสารสามารถอ้างถึง (Reference) เอกสารฉบับก่อนหน้าได้หลายฉบับ + - สามารถกำหนด Tag ได้หลาย Tag เพื่อจัดกลุ่มและใช้ในการค้นหาขั้นสูง + - 3.2.5. การจัดการ: มีการจัดการอย่างน้อยดังนี้ +0 - สามารถกำหนดวันแล้วเสร็จ (Deadline) สำหรับผู้รับผิดชอบของ องกรณ์ ที่อเป็นผู้รับ ได้ + - มีระบบแจ้งเตือน ให้ผู้รับผิดชอบขององกรณ์ที่เป็น ผู้รับ/ผู้ส่ง ทราบ เมื่อมีเอกสารใหม่ หรือมีการเปลี่ยนสถานะ + +* 3.3. การจัดกาแบบคู่สัญญา (Contract Drawing) + - 3.3.1. วัตถุประสงค์: แบบคู่สัญญา (Contract Drawing) ใช้เพื่ออ้างอิงและใช้ในการตรวจสอบ + - 3.3.2. ประเภทเอกสาร: ไฟล์ PDF + - 3.3.3. การสร้างเอกสาร: ผู้ใช้ที่มีสิทธิ์ สามารถสร้างและแก้ไขได้ + - 3.3.4. การอ้างอิงและจัดกลุ่ม: ใช้สำหรับอ้างอิง ใน Shop Drawings, มีการจัดหมวดหมู่ของ Contract Drawing + +* 3.4. การจัดกาแบบก่อสร้าง (Shop Drawing) + - 3.4.1. วัตถุประสงค์: แบบก่อสร้าง (Shop Drawing) ใช้เในการตรวจสอบ โดยจัดส่งด้วย Request for Approval (RFA) + - 3.4.2. ประเภทเอกสาร: ไฟล์ PDF + - 3.4.3. การสร้างเอกสาร: ผู้ใช้ที่มีสิทธิ์ สามารถสร้างและแก้ไขได้ + - 3.4.4. การอ้างอิงและจัดกลุ่ม: ช้สำหรับอ้างอิง ใน Shop Drawings, มีการจัดหมวดหมู่ของ Shop Drawings + +* 3.5. การจัดการเอกสารขออนุมัติ (Request for Approval & Workflow) + - 3.5.1. วัตถุประสงค์: เอกสารขออนุมัติ (Request for Approval) ใช้ในการส่งเอกสารเพิอขออนุมัติ + - 3.5.2. ประเภทเอกสาร: Request for Approval (RFA) เป็นชนิดหนึ่งของ Correspondence ที่มีลักษณะเฉพาะที่ต้องได้รับการอนุมัติ มีประเภทดังนี้: + - Request for Drawing Approval (RFA_DWG) + - Request for Document Approval (RFA_DOC) + - Request for Method statement Approval (RFA_MES) + - Request for Material Approval (RFA_MAT) + - 3.5.2. การสร้างเอกสาร: ผู้ใช้ที่มีสิทธิ์ สามารถสร้างและแก้ไขได้ + - 3.5.4. การอ้างอิงและจัดกลุ่ม: การจัดการ Drawing (RFA_DWG): + - เอกสาร RFA_DWG จะประกอบไปด้วย Shop Drawing (shop_drawings) หลายแผ่น ซึ่งแต่ละแผ่นมี Revision ของตัวเอง + - Shop Drawing แต่ละ Revision สามารถอ้างอิงถึง Contract Drawing (Ccontract_drawings) หลายแผ่น หรือไม่อ้างถึงก็ได้ + - ระบบต้องมีส่วนสำหรับจัดการข้อมูล Master Data ของทั้ง Shop Drawing และ Contract Drawing แยกจากกัน + - 3.6.5. Workflow การอนุมัติ: ต้องรองรับกระบวนการอนุมัติที่ซับซ้อนและเป็นลำดับ เช่น + - ส่งจาก Originator -> Organization 1 -> Organization 2 -> Organization 3 แล้วส่งผลกลับตามลำดับเดิม (โดยถ้า องกรณ์ใดใน Workflow ให้ส่งกลับ ก็สามารถส่งผลกลับตามลำดับเดิมโดยไม่ต้องรอให้ถึง องกรณืในลำดับถัดไป) + - 3.6.6. การจัดการ: มีการจัดการอย่างน้อยดังนี้ +0 - สามารถกำหนดวันแล้วเสร็จ (Deadline) สำหรับผู้รับผิดชอบของ องกรณ์ ที่อยู่ใน Workflow ได้ + - มีระบบแจ้งเตือน ให้ผู้รับผิดชอบของ องกรณ์ ที่อยู่ใน Workflow ทราบ เมื่อมี RFA ใหม่ หรือมีการเปลี่ยนสถานะ + +* 3.6.การจัดการเอกสารนำส่ง (Transmittals) + - 3.6.1. วัตถุประสงค์: เอกสารนำส่ง ใช้สำหรับ นำส่ง Request for Approval (RFAS) หลายฉบับ ไปยังองค์กรอื่น + - 3.6.2. ประเภทเอกสาร: ไฟล์ PDF + - 3.6.3. การสร้างเอกสาร: ผู้ใช้ที่มีสิทธิ์ สามารถสร้างและแก้ไขได้ + - 3.6.4. การอ้างอิงและจัดกลุ่ม: เอกสารนำส่ง เป็นส่วนหนึ่งใน Correspondence + +* 3.7. ใบเวียนเอกสารภายใน (Internal Circulation Sheet) + - 3.7.1. วัตถุประสงค์: การสื่อสาร เอกสาร (Correspondence) ทุกฉบับ จะมีใบเวียนเอกสารเพื่อควบคุมและมอบหมายงานภายในองค์กร (สามารถดูและแก้ไขได้เฉพาะคนในองค์กร) + - 3.7.2. ประเภทเอกสาร: ไฟล์ PDF + - 3.7.3. การสร้างเอกสาร: ผู้ใช้ที่มีสิทธิ์ในองค์กรนั้น สามารถสร้างและแก้ไขได้ + - 3.7.4. การอ้างอิงและจัดกลุ่ม: การระบุผู้รับผิดชอบ: + - ผู้รับผิดชอบหลัก (Main): มีได้หลายคน + - ผู้ร่วมปฏิบัติงาน (Action): มีได้หลายคน + - ผู้ที่ต้องรับทราบ (Information): มีได้หลายคน + - 3.7.5. การติดตามงาน: + - สามารถกำหนดวันแล้วเสร็จ (Deadline) สำหรับผู้รับผิดชอบประเภท Main และ Action ได้ + - มีระบบแจ้งเตือนเมื่อมี Circulation ใหม่ และแจ้งเตือนล่วงหน้าก่อนถึงวันแล้วเสร็จ + - สามารถปิด Circulation ได้เมื่อดำเนินการตอบกลับไปยังองค์กรผู้ส่ง (Originator) แล้ว หรือ รับทราบแล้ว (For Information) + +* 3.8. ประวัติการแก้ไข (Revisions): ระบบจะเก็บประวัติการสร้างและแก้ไข เอกสารทั้งหมด + +* 3.9. การจัดเก็บ: เอกสารและไฟล์แนบจะถูกจัดเก็บในโฟลเดอร์บน Server (/share/dms-data/) โดยมีการอ้างอิงข้อมูล (Metadata) ในฐานข้อมูล และสามารถจัดเรียงตามวันที่ในเอกสาร (Document Date) ได้ ตัวอย่างเช่น + - Correspondence จัดเก็บใน /share/dms-data/correspondences/YYMMDD/ชื่อไฟล์.pdf + - Request for Approval จัดเก็บใน /share/dms-data/rfas/YYMMDD/ชื่อไฟล์.pdf + - Shop Drawings จัดเก็บใน /share/dms-data/shop_drawings/YYMMDD/ชื่อไฟล์.pdf + +## 🔐 4. ข้อกำหนดด้านสิทธิ์และการเข้าถึง (Access Control Requirements) + +* 4.1. ภาพรวม: ผู้ใช้และองค์กรสามารถดูและแก้ไขเอกสารได้ตามสิทธิ์ที่ได้รับ โดยระบบสิทธิ์จะเป็นแบบ Role-Based Access Control (RBAC) +* 4.2. ระดับของสิทธิ์: + - Global Roles: สิทธิ์ในภาพรวมของระบบ + - Project-Specific Roles: สิทธิ์ที่ถูกกำหนดให้ผู้ใช้สำหรับโครงการนั้นๆ โดยเฉพาะ (เช่น เป็น Editor ในโครงการ A แต่เป็น Viewer ในโครงการ B) + - Contract-Specific Roles: สิทธิ์ที่ถูกกำหนดให้โครงการสำหรับสัญญานั้นๆ (เช่น เป็น Admin ในสัญญา 1 จะเป็น Admin ใน โครงการ A และ ฺB ที่อยู่ในสัญญา 1) +* 4.3. บทบาท (Roles) พื้นฐาน: + - Superadmin: ไม่มีข้อจำกัดใดๆ สามารถจัดการได้ทุกอย่างข้ามองค์กร + - Admin: มีสิทธิ์เต็มที่ แต่จำกัดเฉพาะในองค์กรที่ตัวเองสังกัด สามารถจัดการผู้ใช้ในองค์กรได้ สามารถสร้าง Role ใหม่และกำหนดสิทธิ์ (Permissions) เพิ่มเติมได้ในภายหลังผ่านหน้า Admin + - Document Control สามารถ เพิ่ม/แก้ไข/ลบ เอกสาร เฉพาะในองค์กรที่ตัวเองสังกัด ไม่สามารถจัดการผู้ใช้ได้ + - Editor: สามารถ เพิ่ม/แก้ไข เอกสารที่กำหนดไว้ เฉพาะในองค์กรที่ตัวเองสังกัด + - Viewer: สามารถดู เอกสาร เฉพาะในองค์กรที่ตัวเองสังกัด + +* 4.4. การบังคับใช้สิทธิ์: สิทธิ์ขององค์กรจะครอบคลุมสิทธิ์ของผู้ใช้ และการเข้าถึงข้อมูลที่เกี่ยวข้องกับโครงการ (เช่น การแก้ไขเอกสาร) จะถูกตรวจสอบเทียบกับสิทธิ์ที่ผู้ใช้มีในโครงการนั้นๆ โดยเฉพาะ + +## 👥 5. ข้อกำหนดด้านผู้ใช้งาน (User Interface & Experience) + +* 5.1. Layout หลัก: หน้าเว็บใช้รูปแบบ App Shell ที่ประกอบด้วย: + - Navbar (ส่วนบน): แสดงชื่อระบบ, เมนูผู้ใช้ (Profile), เมนูสำหรับ Admin/Superadmin (จัดการผู้ใช้, จัดการสิทธิ์), และปุ่ม Login/Logout + - Sidebar (ด้านข้าง): เป็นเมนูหลักสำหรับเข้าถึงส่วนที่เกี่ยวกับเอกสารทั้งหมด เช่น Dashboard, Correspondences, RFA, Drawings + - Main Content Area: พื้นที่สำหรับแสดงเนื้อหาหลักของหน้าที่เลือก +* 5.2. หน้า Landing Page: เป็นหน้าแรกที่แสดงข้อมูลบางส่วนของโครงการสำหรับผู้ใช้ที่ยังไม่ได้ล็อกอิน +* 5.3. หน้า Dashboard: เป็นหน้าแรกหลังจากล็อกอิน ประกอบด้วย: + - การ์ดสรุปภาพรวม (KPI Cards): แสดงข้อมูลสรุปที่สำคัญขององค์กร เช่น จำนวนเอกสาร, งานที่เกินกำหนด + - ตาราง "งานของฉัน" (My Tasks Table): แสดงรายการงานทั้งหมดจาก Circulation ที่ผู้ใช้ต้องดำเนินการ +* 5.4. การติดตามสถานะ: องค์กรสามารถติดตามสถานะเอกสารทั้งของตนเอง (Originator) และสถานะเอกสารที่ส่งมาถึงตนเอง (Recipient) +* 5.5. การจัดการข้อมูลส่วนตัว (Profile Page): ผู้ใช้สามารถจัดการข้อมูลส่วนตัวและเปลี่ยนรหัสผ่านของตนเองได้ +* 5.6. การจัดการเอกสารทางเทคนิค (Technical Documents & Workflow): ผู้ใช้สามารถดู Technical Document ในรูปแบบ Workflow ทั้งหมดได้ในหน้าเดียว, ขั้นตอนที่ยังไม่ถึงหรือผ่านไปแล้วจะเป็นรูปแบบ diable, สามารถดำเนินการได้เฉพาะในขั้นตอนที่ได้รับมอบหมายงาน (active) เช่น ตรวจสอบแล้ว เพื่อไปยังขั้นตอนต่อไป, สิทธิ์ admin ขึ้นไป สามรถกด ไปยังขั้นตอนต่อไป ได้ทุกขั้นตอน, การย้อนกลับ ไปขั้นตอนก่อนหน้า สามารถทำได้โดย สิทธิ์ admin ขึ้นไป + +## 6. ข้อกำหนดที่ไม่ใช่ฟังก์ชันการทำงาน (Non-Functional Requirements) + +* 6.1. การบันทึกการกระทำ (Audit Log): ทุกการกระทำที่สำคัญของผู้ใช้ (สร้าง, แก้ไข, ลบ, ส่ง) จะถูกบันทึกไว้ใน audit_logs เพื่อการตรวจสอบย้อนหลัง +* 6.2. การค้นหา (Search): ระบบต้องมีฟังก์ชันการค้นหาขั้นสูง ที่สามารถค้นหาเอกสารจากหลายเงื่อนไขพร้อมกันได้ เช่น ค้นหาจากชื่อเรื่อง, ประเภท, วันที่, และ Tag +* 6.3. การทำรายงาน (Reporting): สามารถจัดทำรายงานสรุปแยกประเภทของ Correspondence ประจำวัน, สัปดาห์, เดือน, และปีได้ +* 6.4. ประสิทธิภาพ (Performance): มีการใช้ Caching กับข้อมูลที่เรียกใช้บ่อย และใช้ Pagination ในตารางข้อมูลเพื่อจัดการข้อมูลจำนวนมาก +* 6.5. ความปลอดภัย (Security): + - มีระบบ Rate Limiting เพื่อป้องกันการโจมตีแบบ Brute-force + - การจัดการ Secret (เช่น รหัสผ่าน DB, JWT Secret) จะต้องทำผ่าน Environment Variable ของ Docker เพื่อความปลอดภัยสูงสุด + +## 📈 7. + +## 🧩 8. +🎯 +📤 +📊 +✅ +🔄 + + diff --git a/docs/Markdown/LCBP3-DMS V1_1_1_FullStackJS.md b/docs/Markdown/LCBP3-DMS V1_1_1_FullStackJS.md new file mode 100644 index 0000000..320dc6f --- /dev/null +++ b/docs/Markdown/LCBP3-DMS V1_1_1_FullStackJS.md @@ -0,0 +1,456 @@ +# แนวทางการพัฒนา FullStackJS + +## 🧠 ปรัชญาทั่วไป + +แนวทางปฏิบัติที่ดีที่สุดแบบครบวงจรสำหรับการพัฒนา **NestJS Backend**, **NextJS Frontend** และ **Tailwind-based UI/UX** ในสภาพแวดล้อม TypeScript +มุ่งเน้นที่ **ความชัดเจน (clarity)**, **ความง่ายในการบำรุงรักษา (maintainability)**, **ความสอดคล้องกัน (consistency)** และ **การเข้าถึงได้ (accessibility)** ตลอดทั้งสแต็ก + +----- + +## ⚙️ แนวทางทั่วไปสำหรับ TypeScript + +### หลักการพื้นฐาน + + - ใช้ **ภาษาอังกฤษ** สำหรับโค้ดและเอกสารทั้งหมด + - กำหนดไทป์ (type) อย่างชัดเจนสำหรับตัวแปร, พารามิเตอร์ และค่าที่ส่งกลับ (return values) ทั้งหมด + - หลีกเลี่ยงการใช้ `any`; ให้สร้างไทป์ (types) หรืออินเทอร์เฟซ (interfaces) ที่กำหนดเอง + - ใช้ **JSDoc** สำหรับคลาส (classes) และเมธอด (methods) ที่เป็น public + - ส่งออก (Export) **สัญลักษณ์หลัก (main symbol) เพียงหนึ่งเดียว** ต่อไฟล์ + - หลีกเลี่ยงบรรทัดว่างภายในฟังก์ชัน + +### ข้อตกลงในการตั้งชื่อ (Naming Conventions) + +| Entity (สิ่งที่ตั้งชื่อ) | Convention (รูปแบบ) | Example (ตัวอย่าง) | +|:--|:--|:--| +| Classes | PascalCase | `UserService` | +| Variables & Functions | camelCase | `getUserInfo` | +| Files & Folders | kebab-case | `user-service.ts` | +| Environment Variables | UPPERCASE | `DATABASE_URL` | +| Booleans | Verb + Noun | `isActive`, `canDelete`, `hasPermission` | + +ใช้คำเต็ม — ไม่ใช้อักษรย่อ — ยกเว้นคำมาตรฐาน (เช่น `API`, `URL`, `req`, `res`, `err`, `ctx`) + +----- + +## 🧩 ฟังก์ชัน (Functions) + + - เขียนฟังก์ชันให้สั้น และทำ **หน้าที่เพียงอย่างเดียว** (single-purpose) (\< 20 บรรทัด) + - ใช้ **early returns** เพื่อลดการซ้อน (nesting) ของโค้ด + - ใช้ **map**, **filter**, **reduce** แทนการใช้ loops เมื่อเหมาะสม + - ควรใช้ **arrow functions** สำหรับตรรกะสั้นๆ, และใช้ **named functions** ในกรณีอื่น + - ใช้ **default parameters** แทนการตรวจสอบค่า null + - จัดกลุ่มพารามิเตอร์หลายตัวให้เป็นอ็อบเจกต์เดียว (RO-RO pattern) + - ส่งค่ากลับ (Return) เป็นอ็อบเจกต์ที่มีไทป์กำหนด (typed objects) ไม่ใช่ค่าพื้นฐาน (primitives) + - รักษาระดับของสิ่งที่เป็นนามธรรม (abstraction level) ให้เป็นระดับเดียวในแต่ละฟังก์ชัน + +----- + +## 🧱 การจัดการข้อมูล (Data Handling) + + - ห่อหุ้มข้อมูล (Encapsulate) ในไทป์แบบผสม (composite types) + - ใช้ **immutability** (การไม่เปลี่ยนแปลงค่า) ด้วย `readonly` และ `as const` + - ทำการตรวจสอบความถูกต้องของข้อมูล (Validations) ในคลาสหรือ DTOs ไม่ใช่ภายในฟังก์ชันทางธุรกิจ + - ตรวจสอบความถูกต้องของข้อมูลโดยใช้ DTOs ที่มีไทป์กำหนดเสมอ + +----- + +## 🧰 คลาส (Classes) + + - ปฏิบัติตามหลักการ **SOLID** + - ควรใช้ **composition มากกว่า inheritance** (Prefer composition over inheritance) + - กำหนด **interfaces** สำหรับสัญญา (contracts) + - ให้คลาสมุ่งเน้นการทำงานเฉพาะอย่างและมีขนาดเล็ก (\< 200 บรรทัด, \< 10 เมธอด, \< 10 properties) + +----- + +## 🚨 การจัดการข้อผิดพลาด (Error Handling) + + - ใช้ Exceptions สำหรับข้อผิดพลาดที่ไม่คาดคิด + - ดักจับ (Catch) ข้อผิดพลาดเพื่อแก้ไขหรือเพิ่มบริบท (context) เท่านั้น; หากไม่เช่นนั้น ให้ใช้ global error handlers + - ระบุข้อความข้อผิดพลาด (error messages) ที่มีความหมายเสมอ + +----- + +## 🧪 การทดสอบ (ทั่วไป) (Testing (General)) + + - ใช้รูปแบบ **Arrange–Act–Assert** + - ใช้ชื่อตัวแปรในการทดสอบที่สื่อความหมาย (`inputData`, `expectedOutput`) + - เขียน **unit tests** สำหรับ public methods ทั้งหมด + - จำลอง (Mock) การพึ่งพาภายนอก (external dependencies) + - เพิ่ม **acceptance tests** ต่อโมดูลโดยใช้รูปแบบ Given–When–Then + +----- + +# 🏗️ แบ็กเอนด์ (NestJS) (Backend (NestJS)) + +### หลักการ + + - **สถาปัตยกรรมแบบโมดูลาร์ (Modular architecture)**: + - หนึ่งโมดูลต่อหนึ่งโดเมน + - โครงสร้างแบบ Controller → Service → Repository (Model) + - DTOs ที่ตรวจสอบความถูกต้องด้วย **class-validator** + - ใช้ **MikroORM** (หรือ TypeORM/Prisma) สำหรับการคงอยู่ของข้อมูล (persistence) ซึ่งสอดคล้องกับสคีมา MariaDB + - ห่อหุ้มโค้ดที่ใช้ซ้ำได้ไว้ใน **common module** (`@app/common`): + - Configs, decorators, DTOs, guards, interceptors, notifications, shared services, types, validators + +### ฟังก์ชันหลัก (Core Functionalities) + + - Global **filters** สำหรับการจัดการ exception + - **Middlewares** สำหรับการจัดการ request + - **Guards** สำหรับการอนุญาต (permissions) และ RBAC + - **Interceptors** สำหรับการแปลงข้อมูล response และการบันทึก log + +### ข้อจำกัดในการ Deploy (QNAP Container Station) + + - **ห้ามใช้ไฟล์ `.env`** ในการตั้งค่า Environment Variables + - การตั้งค่าทั้งหมด (เช่น Database connection string, JWT secret) **จะต้องถูกกำหนดผ่าน Environment Variable ใน `docker-compose.yml` โดยตรง** ซึ่งจะจัดการผ่าน UI ของ QNAP Container Station + +### โครงสร้างโมดูลตามโดเมน (Domain-Driven Module Structure) + +เพื่อให้สอดคล้องกับสคีมา SQL (LCBP3-DMS) เราจะใช้โครงสร้างโมดูลแบบ **Domain-Driven (แบ่งตามขอบเขตธุรกิจ)** แทนการแบ่งตามฟังก์ชัน: + +1. **CoreModule / CommonModule:** + * เก็บ Services ที่ใช้ร่วมกัน เช่น `DatabaseModule`, `FileStorageService` (จัดการไฟล์ใน QNAP), `AuditLogService`, และ `NotificationService` +2. **AuthModule / UserModule:** + * จัดการ `users`, `roles`, `permissions` และการยืนยันตัวตน (JWT, Guards) + * **(สำคัญ)** ต้องรับผิดชอบการตรวจสอบสิทธิ์ **3 ระดับ**: สิทธิ์ระดับระบบ (Global Role), สิทธิ์ระดับโปรเจกต์ (Project Role), และ **สิทธิ์ระดับสัญญา (Contract Role)** + * **(สำคัญ)** ต้องมี API สำหรับ Admin เพื่อ **สร้างและจัดการ Role และการจับคู่ Permission แบบไดนามิก** (ไม่ใช่แค่ seed ข้อมูลเริ่มต้น) +3. **ProjectModule:** + * จัดการ `projects`, `organizations`, `contracts`, `project_parties`, `contract_parties` +4. **CorrespondenceModule (โมดูลศูนย์กลาง):** + * จัดการ `correspondences`, `correspondence_revisions` + * จัดการ `correspondence_attachments` (ตารางเชื่อมไฟล์แนบ) + * รับผิดชอบเวิร์กโฟลว์ **"Correspondence Routings"** (`correspondence_routings`) สำหรับการส่งต่อเอกสารทั่วไประหว่างองค์กร +5. **RfaModule:** + * จัดการ `rfas`, `rfa_revisions`, `rfa_items` + * รับผิดชอบเวิร์กโฟลว์ **"RFA Workflows"** (`rfa_workflows`) สำหรับการอนุมัติเอกสารทางเทคนิค +6. **DrawingModule:** + * จัดการ `shop_drawings`, `shop_drawing_revisions`, `contract_drawings` และหมวดหมู่ต่างๆ + * จัดการ `shop_drawing_revision_attachments` (ตารางเชื่อมไฟล์แนบ) +7. **CirculationModule:** + * จัดการ `circulations`, `circulation_templates`, `circulation_assignees` + * จัดการ `circulation_attachments` (ตารางเชื่อมไฟล์แนบ) + * รับผิดชอบเวิร์กโฟลGว์ **"Circulations"** สำหรับการเวียนเอกสาร **ภายในองค์กร** +8. **TransmittalModule:** + * จัดการ `transmittals` และ `transmittal_items` +9. **SearchModule:** + * **(สำหรับ V1)** ให้บริการค้นหาขั้นสูง (Advanced Search) โดยต้องรองรับการกรองจาก ชื่อเรื่อง (LIKE), ประเภท, วันที่, และ **Tags** (ผ่านการ Join ตาราง) โดยค้นหาผ่าน Views (`v_current_rfas`, `v_current_correspondences`) + +### เครื่องมือและไลบรารีที่แนะนำ (Recommended Tools & Libraries) + +🔐 **Authentication & Authorization** + + * `@nestjs/passport` + * `@nestjs/jwt` + * `casl` – สำหรับ RBAC (Role-Based Access Control) + +🗃️ **Database & ORM** + + * `@nestjs/typeorm` – ORM สำหรับ SQL (หรือ `Prisma` เป็นทางเลือก) + * `typeorm-seeding` – สำหรับสร้างข้อมูลจำลอง (seeding) + +📦 **Validation & Transformation** + + * `class-validator` + * `class-transformer` + +📁 **File Upload & Storage** + + * `@nestjs/platform-express` + * `multer` – สำหรับจัดการไฟล์ + +🔍 **Search** + + * **(สำหรับ V1)** เน้นการค้นหาขั้นสูงตาม Requirement 6.2 (Full-text search/Elasticsearch จะพิจารณาใน V2) + +📬 **Notification** + + * `nodemailer` – สำหรับส่งอีเมล + * `@nestjs/schedule` – สำหรับ cron job หรือแจ้งเตือนตามเวลา + +📊 **Logging & Monitoring** + + * `winston` หรือ `nestjs-pino` – ระบบ log ที่ยืดหยุ่น + * `@nestjs/terminus` – สำหรับ health check + +🧪 **Testing** + + * `@nestjs/testing` + * `jest` – สำหรับ unit/integration test + +🌐 **API Documentation** + + * `@nestjs/swagger` – **(สำคัญมาก)** สร้าง Swagger UI อัตโนมัติ ต้องใช้ DTOs อย่างเคร่งครัดเพื่อความชัดเจนของ API สำหรับทีม Frontend + +🛡️ **Security** + + * `helmet` – ป้องกันช่องโหว่ HTTP + * `rate-limiter-flexible` – ป้องกัน brute force + +### การทดสอบ (Testing) + + - ใช้ **Jest** สำหรับการทดสอบ + - ทดสอบทุก controller และ service + - เพิ่ม endpoint `admin/test` เพื่อใช้เป็น smoke test + +----- + +# 🖥️ ฟรอนต์เอนด์ (NextJS / React / UI) (Frontend (NextJS / React / UI)) + +### โปรไฟล์นักพัฒนา (Developer Profile) + +วิศวกร TypeScript + React/NextJS ระดับ Senior +เชี่ยวชาญ **TailwindCSS**, **Shadcn/UI**, และ **Radix** สำหรับการพัฒนา UI + +### แนวทางการพัฒนาโค้ด (Code Implementation Guidelines) + + - ใช้ **early returns** เพื่อความชัดเจน + - ใช้คลาสของ **TailwindCSS** ในการกำหนดสไตล์เสมอ + - ควรใช้ `class:` syntax แบบมีเงื่อนไข (หรือ utility `clsx`) มากกว่าการใช้ ternary operators ใน class strings + - ใช้ **const arrow functions** สำหรับ components และ handlers + - Event handlers ให้ขึ้นต้นด้วย `handle...` (เช่น `handleClick`, `handleSubmit`) + - รวมแอตทริบิวต์สำหรับการเข้าถึง (accessibility) ด้วย: + `tabIndex="0"`, `aria-label`, `onKeyDown`, ฯลฯ + - ตรวจสอบให้แน่ใจว่าโค้ดทั้งหมด **สมบูรณ์**, **ผ่านการทดสอบ**, และ **ไม่ซ้ำซ้อน (DRY)** + - ต้อง import โมดูลที่จำเป็นต้องใช้อย่างชัดเจนเสมอ + +### UI/UX ด้วย React + + - ใช้ **semantic HTML** + - ใช้คลาสของ **Tailwind** ที่รองรับ responsive (`sm:`, `md:`, `lg:`) + - รักษาลำดับชั้นของการมองเห็น (visual hierarchy) ด้วยการใช้ typography และ spacing + - ใช้ **Shadcn** components (Button, Input, Card, ฯลฯ) เพื่อ UI ที่สอดคล้องกัน + - ทำให้ components มีขนาดเล็กและมุ่งเน้นการทำงานเฉพาะอย่าง + - ใช้ utility classes สำหรับการจัดสไตล์อย่างรวดเร็ว (spacing, colors, text, ฯลฯ) + - ตรวจสอบให้แน่ใจว่าสอดคล้องกับ **ARIA** และใช้ semantic markup + +### การตรวจสอบฟอร์มและข้อผิดพลาด (Form Validation & Errors) + + - ใช้ไลบรารีฝั่ง client เช่น `zod` และ `react-hook-form` + - แสดงข้อผิดพลาดด้วย **alert components** หรือข้อความ inline + - ต้องมี labels, placeholders, และข้อความ feedback + +----- + +# 🔗 แนวทางการบูรณาการ Full Stack (Full Stack Integration Guidelines) + +| Aspect (แง่มุม) | Backend (NestJS) | Frontend (NextJS) | UI Layer (Tailwind/Shadcn) | +|:--|:--|:--|:--| +| API | REST / GraphQL Controllers | API hooks ผ่าน fetch/axios/SWR | Components ที่รับข้อมูล | +| Validation (การตรวจสอบ) | `class-validator` DTOs | `zod` / `react-hook-form` | สถานะของฟอร์ม/input ใน Shadcn | +| Auth (การยืนยันตัวตน) | Guards, JWT | NextAuth / cookies | สถานะ UI ของ Auth (loading, signed in) | +| Errors (ข้อผิดพลาด) | Global filters | Toasts / modals | Alerts / ข้อความ feedback | +| Testing (การทดสอบ) | Jest (unit/e2e) | Vitest / Playwright | Visual regression | +| Styles (สไตล์) | Scoped modules (ถ้าจำเป็น) | Tailwind / Shadcn | Tailwind utilities | +| Accessibility (การเข้าถึง) | Guards + filters | ARIA attributes | Semantic HTML | + +----- + +# 🗂️ ข้อตกลงเฉพาะสำหรับ DMS (LCBP3-DMS) + +ส่วนนี้ขยายแนวทาง FullStackJS ทั่วไปสำหรับโปรเจกต์ **LCBP3-DMS** โดยมุ่งเน้นไปที่เวิร์กโฟลว์การอนุมัติเอกสาร (Correspondence, RFA, Drawing, Contract, Transmittal, Circulation) + +## 🧱 โมดูลโดเมนฝั่งแบ็กเอนด์ (Backend Domain Modules) + +ใช้โครงสร้างโดเมนแบบโมดูลาร์ที่สะท้อนสคีมา SQL โดย `correspondences` จะทำหน้าที่เป็นศูนย์กลาง (โครงสร้างนี้จะอยู่ภายใต้ "Functional Modules" ที่กล่าวถึงข้างต้น) + +``` +src/ + ├─ modules/ + │ ├─ correspondences/ (Core: Master documents, Revisions, correspondence_attachments) + │ ├─ rfas/ (RFA logic, Revisions, Workflows, Items) + │ ├─ drawings/ (ShopDrawings, Revisions, shop_drawing_revision_attachments) + │ ├─ circulations/ (Internal circulation, Templates, circulation_attachments) + │ ├─ transmittals/ (Transmittal logic, Items) + │ ├─ projects-contracts/ (Projects, Contracts, Organizations, Parties) + │ ├─ users-auth/ (Users, Roles, Permissions, Auth) + │ ├─ audit-log/ + │ └─ common/ +``` + +### ข้อตกลงการตั้งชื่อ (Naming Convention) + +| Entity (สิ่งที่ตั้งชื่อ) | Example (ตัวอย่างจาก SQL) | +|:--|:--| +| Table | `correspondences`, `rfa_revisions`, `contract_parties` | +| Column | `correspondence_id`, `created_by`, `is_current` | +| DTO | `CreateRfaDto`, `UpdateCorrespondenceDto` | +| Controller | `rfas.controller.ts` | +| Service | `correspondences.service.ts` | + +----- + +## 🧩 RBAC และการควบคุมสิทธิ์ (RBAC & Permission Control) + +ใช้ Decorators เพื่อบังคับใช้สิทธิ์การเข้าถึง โดยอ้างอิงสิทธิ์จากตาราง `permissions` + +```ts +@RequirePermission('rfas.respond') // ต้องตรงกับ 'permission_code' +@Put(':id') +updateRFA(@Param('id') id: string) { + return this.rfaService.update(id); +} +``` + +### Roles (บทบาท) + + - **Superadmin**: ไม่มีข้อจำกัดใดๆ + - **Admin**: มีสิทธิ์เต็มที่ในองค์กร + - **Document Control**: เพิ่ม/แก้ไข/ลบ เอกสารในองค์กร + - **Editor**: สามารถ เพิ่ม/แก้ไข เอกสารที่กำหนด + - **Viewer**: สามารถดู เอกสาร + +### ตัวอย่าง Permissions (จากตาราง `permissions`) + + - `rfas.view`, `rfas.create`, `rfas.respond`, `rfas.delete` + - `drawings.view`, `drawings.upload`, `drawings.delete` + - `corr.view`, `corr.manage` + - `transmittals.manage` + - `cirs.manage` + - `project_parties.manage` + +การจับคู่ระหว่าง roles และ permissions **เริ่มต้น** จะถูก seed ผ่านสคริปต์ (ดังที่เห็นในไฟล์ SQL) **อย่างไรก็ตาม `AuthModule`/`UserModule` ต้องมี API สำหรับ Admin เพื่อสร้าง Role ใหม่และกำหนดสิทธิ์ (Permissions) เพิ่มเติมได้ในภายหลัง** + +----- + +## 🧾 มาตรฐาน AuditLog (AuditLog Standard) + +บันทึกการดำเนินการ CRUD และการจับคู่ทั้งหมดลงในตาราง `audit_logs` + +| Field (ฟิลด์) | Type (จาก SQL) | Description (คำอธิบาย) | +|:--|:--|:--| +| `audit_id` | `BIGINT` | Primary Key | +| `user_id` | `INT` | ผู้ใช้ที่ดำเนินการ (FK -\> users) | +| `action` | `VARCHAR(100)` | `rfa.create`, `correspondence.update`, `login.success` | +| `entity_type`| `VARCHAR(50)` | ชื่อตาราง/โมดูล เช่น 'rfa', 'correspondence' | +| `entity_id` | `VARCHAR(50)` | Primary ID ของระเบียนที่ได้รับผลกระทบ | +| `details_json`| `JSON` | ข้อมูลบริบท (เช่น ฟิลด์ที่มีการเปลี่ยนแปลง) | +| `ip_address` | `VARCHAR(45)` | IP address ของผู้ดำเนินการ | +| `user_agent` | `VARCHAR(255)`| User Agent ของผู้ดำเนินการ | +| `created_at` | `TIMESTAMP` | Timestamp (UTC) | + +ตัวอย่างการใช้งาน: + +```ts +await this.auditLogService.log({ + userId: user.id, + action: 'rfa.update_status', + entityType: 'rfa_revisions', + entityId: rfaRevision.id, + detailsJson: { from: 'DFT', to: 'FAP' }, + ipAddress: req.ip, +}); +``` + +----- + +## 📂 การจัดการไฟล์ (File Handling) (ปรับปรุงใหม่) + +### มาตรฐานการอัปโหลดไฟล์ (File Upload Standard) + + - **ตรรกะใหม่:** การอัปโหลดไฟล์ทั้งหมดจะถูกจัดการโดย `FileStorageService` และบันทึกข้อมูลไฟล์ลงในตาราง `attachments` (ตารางกลาง) + - ไฟล์จะถูกเชื่อมโยงไปยัง Entity ที่ถูกต้องผ่าน **ตารางเชื่อม (Junction Tables)** เท่านั้น: + - `correspondence_attachments` (เชื่อม Correspondence กับ Attachments) + - `circulation_attachments` (เชื่อม Circulation กับ Attachments) + - `shop_drawing_revision_attachments` (เชื่อม Drawing Revision กับ Attachments) + - **(สำคัญ)** คอลัมน์ `file_path` ถูกลบออกจาก `shop_drawing_revisions` แล้ว ต้องใช้ระบบตารางเชื่อมใหม่นี้เท่านั้น + - เส้นทางจัดเก็บไฟล์ (Upload path): อ้างอิงจาก Requirement 2.1 คือ `/share/dms-data` โดย `FileStorageService` จะสร้างโฟลเดอร์ย่อยแบบรวมศูนย์ (เช่น `/share/dms-data/uploads/{YYYY}/{MM}/[stored_filename]`) + - **(หมายเหตุ)**: โครงสร้างนี้ *แทนที่* โครงสร้างแบบแยกโมดูลที่ระบุใน Requirement 3.9 เนื่องจากการออกแบบใหม่ได้รวมศูนย์ไฟล์ไว้ที่ตาราง `attachments` กลางแล้ว + - ประเภทไฟล์ที่อนุญาต: `pdf, dwg, docx, xlsx, zip` + - ขนาดสูงสุด: **50 MB** + - จัดเก็บนอก webroot + - ให้บริการไฟล์ผ่าน endpoint ที่ปลอดภัย `/files/:attachment_id/download` + +### การควบคุมการเข้าถึง (Access Control) + +การเข้าถึงไฟล์ไม่ใช่การเข้าถึงโดยตรง endpoint `/files/:attachment_id/download` จะต้อง: + +1. ค้นหาระเบียน `attachment` +2. ตรวจสอบว่า `attachment_id` นี้ เชื่อมโยงกับ Entity ใด (เช่น `correspondence`, `circulation`, `shop_drawing_revision`) ผ่านตารางเชื่อม +3. ตรวจสอบว่าผู้ใช้มีสิทธิ์ (permission) ในการดู Entity ต้นทางนั้นๆ หรือไม่ + +----- + +## 📊 การรายงานและการส่งออก (Reporting & Exports) + +### วิวสำหรับการรายงาน (Reporting Views) (จาก SQL) + +การรายงานควรสร้างขึ้นจาก Views ที่กำหนดไว้ล่วงหน้าในฐานข้อมูลเป็นหลัก: + + - `v_current_correspondences`: สำหรับ revision ปัจจุบันทั้งหมดของเอกสารที่ไม่ใช่ RFA + - `v_current_rfas`: สำหรับ revision ปัจจุบันทั้งหมดของ RFA และข้อมูล master + - `v_contract_parties_all`: สำหรับการตรวจสอบความสัมพันธ์ของ project/contract/organization + +Views เหล่านี้ทำหน้าที่เป็นแหล่งข้อมูลหลักสำหรับการรายงานฝั่งเซิร์ฟเวอร์และการส่งออกข้อมูล + +### กฎการส่งออก (Export Rules) + + - Export formats: CSV, Excel, PDF. + - จัดเตรียมมุมมองสำหรับพิมพ์ (Print view). + - รวมลิงก์ไปยังต้นทาง (เช่น `/rfas/:id`). + +----- + +## 🧮 ฟรอนต์เอนด์: รูปแบบ DataTable และฟอร์ม (Frontend: DataTable & Form Patterns) + +### DataTable (Server‑Side) + + - Endpoint: `/api/{module}?page=1&pageSize=20&sort=...&filter=...` + - ต้องรองรับ: การแบ่งหน้า (pagination), การเรียงลำดับ (sorting), การค้นหา (search), การกรอง (filters) + - แสดง revision ล่าสุดแบบ inline เสมอ (สำหรับ RFA/Drawing) + +### มาตรฐานฟอร์ม (Form Standards) + + - ต้องมีการใช้งาน Dropdowns แบบขึ้นต่อกัน (Dependent dropdowns) (ตามที่สคีมารองรับ): + - Project → Contract Drawing Volumes + - Contract Drawing Category → Sub-Category + - RFA (ประเภท Shop Drawing) → Shop Drawing Revisions ที่เชื่อมโยงได้ + - การอัปโหลดไฟล์: ต้องมี preview + validation (ผ่านตรรกะของ `attachments` และตารางเชื่อมใหม่) + - ส่ง (Submit) ผ่าน API พร้อม feedback แบบ toast + +### ข้อกำหนด Component เฉพาะ (Specific UI Requirements) + + - **Dashboard - My Tasks:** ต้องพัฒนา Component ตาราง "งานของฉัน" (My Tasks) ซึ่งดึงข้อมูลงานที่ผู้ใช้ล็อกอินอยู่ต้องรับผิดชอบ (Main/Action) จากโมดูล `Circulations` + - **Workflow Visualization:** ต้องพัฒนา Component สำหรับแสดงผล Workflow (โดยเฉพาะ RFA) ที่แสดงขั้นตอนทั้งหมดเป็นลำดับ โดยขั้นตอนปัจจุบัน (active) เท่านั้นที่ดำเนินการได้ และขั้นตอนอื่นเป็น `disabled` ต้องมีตรรกะสำหรับ Admin ในการ override หรือย้อนกลับขั้นตอนได้ + +----- + +## 🧭 แดชบอร์ดและฟีดกิจกรรม (Dashboard & Activity Feed) + +### การ์ดบนแดชบอร์ด (Dashboard Cards) + + - แสดง Correspondences, RFAs, Circulations ล่าสุด + - รวมสรุป KPI (เช่น "RFAs ที่รอการอนุมัติ") + - รวมลิงก์ด่วนไปยังโมดูลต่างๆ + +### ฟีดกิจกรรม (Activity Feed) + + - แสดงรายการ `audit_logs` ล่าสุด (10 รายการ) ที่เกี่ยวข้องกับผู้ใช้ + + + +```ts +// ตัวอย่าง API response +[ + { user: 'editor01', action: 'Updated RFA (LCBP3-RFA-001)', time: '2025-11-04T09:30Z' } +] +``` + +----- + +## ✅ มาตรฐานที่นำไปใช้แล้ว (จาก SQL v1.1.0) (Implemented Standards (from SQL v1.1.0)) + +ส่วนนี้ยืนยันว่าแนวทางปฏิบัติที่ดีที่สุดต่อไปนี้เป็นส่วนหนึ่งของการออกแบบฐานข้อมูลอยู่แล้ว และควรถูกนำไปใช้ประโยชน์ ไม่ใช่สร้างขึ้นใหม่ + + - ✅ **Soft Delete:** นำไปใช้แล้วผ่านคอลัมน์ `deleted_at` ในตารางสำคัญ (เช่น `correspondences`, `rfas`, `project_parties`) ตรรกะการดึงข้อมูลต้องกรอง `deleted_at IS NULL` + - ✅ **Database Indexes:** สคีมาได้มีการทำ index ไว้อย่างหนักหน่วงบน foreign keys และคอลัมน์ที่ใช้ค้นหาบ่อย (เช่น `idx_rr_rfa`, `idx_cor_project`, `idx_cr_is_current`) เพื่อประสิทธิภาพ + - ✅ **โครงสร้าง RBAC:** มีระบบ `users`, `roles`, `permissions`, `user_roles`, และ `user_project_roles` ที่ครอบคลุมอยู่แล้ว + - ✅ **Data Seeding:** ข้อมูล Master (roles, permissions, organization\_roles, initial users, project parties) ถูกรวมอยู่ในสคริปต์สคีมาแล้ว + +## 🧩 การปรับปรุงที่แนะนำ (สำหรับอนาคต) (Recommended Enhancements (Future)) + + - ✅ **(V2)** นำ Fulltext search หรือ Elasticsearch มาใช้กับฟิลด์เช่น `correspondence_revisions.title` หรือ `details` + - ✅ สร้าง Background job (โดยใช้ **n8n** เพื่อเชื่อมต่อกับ **Line** และ/หรือใช้สำหรับการแจ้งเตือน RFA ที่ใกล้ถึงกำหนด `due_date`) + - ✅ เพิ่ม job ล้างข้อมูลเป็นระยะสำหรับ `attachments` ที่ไม่ถูกเชื่อมโยงกับ Entity ใดๆ เลย (ไฟล์กำพร้า) + +----- \ No newline at end of file diff --git a/docs/Markdown/LCBP3-DMS V1_1_1_application _requirements.md b/docs/Markdown/LCBP3-DMS V1_1_1_application _requirements.md new file mode 100644 index 0000000..f9d3ecf --- /dev/null +++ b/docs/Markdown/LCBP3-DMS V1_1_1_application _requirements.md @@ -0,0 +1,201 @@ +# 📝 Documents Management Sytem Version 1.1.0: Application Requirements Specification + +## 📌 1. วัตถุประสงค์ + +สร้างเว็บแอปพลิเคชั่นสำหรับระบบบริหารจัดการเอกสารโครงการ (Document Management System) ที่สามารถจัดการและควบคุม การสื่อสารด้วยเอกสารที่ซับซ้อน อย่างมีประสิทธิภาพ + + * มีฟังก์ชันหลักในการอัปโหลด จัดเก็บ ค้นหา แชร์ และควบคุมสิทธิ์การเข้าถึงเอกสาร + * ช่วยลดการใช้เอกสารกระดาษ เพิ่มความปลอดภัยในการจัดเก็บข้อมูล + * เพิ่มความสะดวกในการทำงานร่วมกันระหว่างองกรณ์ + +## 🛠️ 2. สถาปัตยกรรมและเทคโนโลยี (System Architecture & Technology Stack) + +ใช้สถาปัตยกรรมแบบ Headless/API-First ที่ทันสมัย ทำงานทั้งหมดบน QNAP Server ผ่าน Container Station เพื่อความสะดวกในการจัดการและบำรุงรักษา, Domain: np-dms.work, มี fix ip, รัน docker command ใน application ของ Container Station ได้โดยตรง, ประกอบด้วย + + * 2.1. Infrastructure & Environment: + - Server: QNAP (Model: TS-473A, RAM: 32GB, CPU: AMD Ryzen V1500B) + - Containerization: Container Station (Docker & Docker Compose) ใช้ UI ของ Container Station เป็นหลัก ในการ configuration และการรัน docker command + - Development Environment: VS Code on Windows 11 + - Domain: np-dms.work, www.np-dms.work + - ip: 159.192.126.103 + - Docker Network: ทุก Service จะเชื่อมต่อผ่านเครือข่ายกลางชื่อ lcbp3 เพื่อให้สามารถสื่อสารกันได้ + - Data Storage: /share/dms-data บน QNAP + - ข้อจำกัด: ไม่สามารถใช้ .env ในการกำหนดตัวแปรภายนอกได้ ต้องกำหนดใน docker-compose.yml เท่านั้น + * 2.2. Code Hosting: + - Application name: git + - Service: Gitea (Self-hosted on QNAP) + - Service name: gitea + - Domain: git.np-dms.work + - หน้าที่: เป็นศูนย์กลางในการเก็บและจัดการเวอร์ชันของโค้ด (Source Code) สำหรับทุกส่วน + * 2.3. Backend / Data Platform: + - Application name: lcbp3-backend + - Service: NestJS + - Service name: backend + - Domain: backend.np-dms.work + - Framework: NestJS (Node.js, TypeScript, ESM) + - หน้าที่: จัดการโครงสร้างข้อมูล (Data Models), สร้าง API, จัดการสิทธิ์ผู้ใช้ (Roles & Permissions), และสร้าง Workflow ทั้งหมดของระบบ + * 2.4. Database: + - Application name: lcbp3-db + - Service: mariadb:10.11 + - Service name: mariadb + - Domain: db.np-dms.work + - หน้าที่: ฐานข้อมูลหลักสำหรับเก็บข้อมูลทั้งหมด + - Tooling: DBeaver (Community Edition), phpmyadmin สำหรับการออกแบบและจัดการฐานข้อมูล + * 2.5. Database management: + - Application name: lcbp3-db + - Service: phpmyadmin:5-apache + - Service name: pma + - Domain: pma.np-dms.work + - หน้าที่: จัดการฐานข้อมูล mariadb ผ่าน Web UI + * 2.6. Frontend: + - Application name: lcbp3-frontend + - Service: next.js + - Service name: frontend + - Domain: lcbp3.np-dms.work + - Framework: Next.js (App Router, React, TypeScript, ESM) + - Styling: Tailwind CSS + PostCSS + - Component Library: shadcn/ui + - หน้าที่: สร้างหน้าตาเว็บแอปพลิเคชันสำหรับให้ผู้ใช้งานเข้ามาดู Dashboard, จัดการเอกสาร, และติดตามงาน โดยจะสื่อสารกับ Backend ผ่าน API + * 2.7. Workflow automation: + - Application name: lcbp3-n8n + - Service: n8nio/n8n:latest + - Service name: n8n + - Domain: n8n.np-dms.work + - หน้าที่: จัดการ workflow ระหว่าง Backend และ Line + * 2.8. Reverse Proxy: + - Application name: lcbp3-npm + - Service: Nginx Proxy Manager (nginx-proxy-manage: latest) + - Service name: npm + - Domain: npm.np-dms.work + - หน้าที่: เป็นด่านหน้าในการรับ-ส่งข้อมูล จัดการโดเมนทั้งหมด, ทำหน้าที่เป็น Proxy ชี้ไปยัง Service ที่ถูกต้อง, และจัดการ SSL Certificate (HTTPS) ให้อัตโนมัติ + +## 📦 3. ข้อกำหนดด้านฟังก์ชันการทำงาน (Functional Requirements) + + * 3.1. การจัดการโครงสร้างโครงการและองค์กร + + - 3.1.1. โครงการ (Projects): ระบบต้องสามารถจัดการเอกสารภายในหลายโครงการได้ (ปัจจุบันมี 4 โครงการ และจะเพิ่มขึ้นในอนาคต) + - 3.1.2. สัญญา (Contracts): ระบบต้องสามารถจัดการเอกสารภายในแต่ละสัญญาได้ ในแต่ละโครงการ มีได้หลายสัญญา หรืออย่างน้อย 1 สัญญา + - 3.1.3. องค์กร (Organizations): + - มีหลายองค์กรในโครงการ องค์กรณ์ที่เป็น Owner, Designer และ Consultant สามารถอยู่ในหลายโครงการและหลายสัญญาได้ + - Contractor จะถือ 1 สัญญา และอยู่ใน 1 โครงการเท่านั้น + + * 3.2. การจัดการเอกสารโต้ตอบ (Correspondence Management) + + - 3.2.1. วัตถุประสงค์: เอกสารโต้ตอบ (correspondences) ระหว่างองกรณื-องกรณ์ ภายใน โครงการ (Projects) และระหว่าง องค์กร-องค์กร ภายนอก โครงการ (Projects) + - 3.2.2. ประเภทเอกสาร: ระบบต้องรองรับเอกสารรูปแบบ ไฟล์ PDF หลายประเภท (Types) เช่น จดหมาย (Letter), อีเมล์ (Email), Request for Information (RFI), และสามารถเพิ่มประเภทใหม่ได้ในภายหลัง + - 3.2.3. การสร้างเอกสาร (Correspondence): + - ผู้ใช้ที่มีสิทธิ์ (เช่น Document Control) สามารถสร้างเอกสารรอไว้ในสถานะ ฉบับร่าง" (Draft) ได้ ซึ่งผู้ใช้งานต่างองค์กรจะมองไม่เห็น + - เมื่อกด "Submitted" แล้ว การแก้ไข, ถอนเอกสารกลับไปสถานะ Draft, หรือยกเลิก (Cancel) จะต้องทำโดยผู้ใช้ระดับ Admin ขึ้นไป พร้อมระบุเหตุผล + - 3.2.4. การอ้างอิงและจัดกลุ่ม: + - เอกสารสามารถอ้างถึง (Reference) เอกสารฉบับก่อนหน้าได้หลายฉบับ + - สามารถกำหนด Tag ได้หลาย Tag เพื่อจัดกลุ่มและใช้ในการค้นหาขั้นสูง + - 3.2.5. การจัดการ: มีการจัดการอย่างน้อยดังนี้ + - สามารถกำหนดวันแล้วเสร็จ (Deadline) สำหรับผู้รับผิดชอบของ องกรณ์ ที่อเป็นผู้รับ ได้ + - มีระบบแจ้งเตือน ให้ผู้รับผิดชอบขององกรณ์ที่เป็น ผู้รับ/ผู้ส่ง ทราบ เมื่อมีเอกสารใหม่ หรือมีการเปลี่ยนสถานะ + + * 3.3. การจัดกาแบบคู่สัญญา (Contract Drawing) + + - 3.3.1. วัตถุประสงค์: แบบคู่สัญญา (Contract Drawing) ใช้เพื่ออ้างอิงและใช้ในการตรวจสอบ + - 3.3.2. ประเภทเอกสาร: ไฟล์ PDF + - 3.3.3. การสร้างเอกสาร: ผู้ใช้ที่มีสิทธิ์ สามารถสร้างและแก้ไขได้ + - 3.3.4. การอ้างอิงและจัดกลุ่ม: ใช้สำหรับอ้างอิง ใน Shop Drawings, มีการจัดหมวดหมู่ของ Contract Drawing + + * 3.4. การจัดกาแบบก่อสร้าง (Shop Drawing) + + - 3.4.1. วัตถุประสงค์: แบบก่อสร้าง (Shop Drawing) ใช้เในการตรวจสอบ โดยจัดส่งด้วย Request for Approval (RFA) + - 3.4.2. ประเภทเอกสาร: ไฟล์ PDF + - 3.4.3. การสร้างเอกสาร: ผู้ใช้ที่มีสิทธิ์ สามารถสร้างและแก้ไขได้ + - 3.4.4. การอ้างอิงและจัดกลุ่ม: ช้สำหรับอ้างอิง ใน Shop Drawings, มีการจัดหมวดหมู่ของ Shop Drawings + + * 3.5. การจัดการเอกสารขออนุมัติ (Request for Approval & Workflow) + + - 3.5.1. วัตถุประสงค์: เอกสารขออนุมัติ (Request for Approval) ใช้ในการส่งเอกสารเพิอขออนุมัติ + - 3.5.2. ประเภทเอกสาร: Request for Approval (RFA) เป็นชนิดหนึ่งของ Correspondence ที่มีลักษณะเฉพาะที่ต้องได้รับการอนุมัติ มีประเภทดังนี้: + - Request for Drawing Approval (RFA\_DWG) + - Request for Document Approval (RFA\_DOC) + - Request for Method statement Approval (RFA\_MES) + - Request for Material Approval (RFA\_MAT) + - 3.5.2. การสร้างเอกสาร: ผู้ใช้ที่มีสิทธิ์ สามารถสร้างและแก้ไขได้ + - 3.5.4. การอ้างอิงและจัดกลุ่ม: การจัดการ Drawing (RFA\_DWG): + - เอกสาร RFA\_DWG จะประกอบไปด้วย Shop Drawing (shop\_drawings) หลายแผ่น ซึ่งแต่ละแผ่นมี Revision ของตัวเอง + - Shop Drawing แต่ละ Revision สามารถอ้างอิงถึง Contract Drawing (Ccontract\_drawings) หลายแผ่น หรือไม่อ้างถึงก็ได้ + - ระบบต้องมีส่วนสำหรับจัดการข้อมูล Master Data ของทั้ง Shop Drawing และ Contract Drawing แยกจากกัน + - 3.6.5. Workflow การอนุมัติ: ต้องรองรับกระบวนการอนุมัติที่ซับซ้อนและเป็นลำดับ เช่น + - ส่งจาก Originator -\> Organization 1 -\> Organization 2 -\> Organization 3 แล้วส่งผลกลับตามลำดับเดิม (โดยถ้า องกรณ์ใดใน Workflow ให้ส่งกลับ ก็สามารถส่งผลกลับตามลำดับเดิมโดยไม่ต้องรอให้ถึง องกรณืในลำดับถัดไป) + - 3.6.6. การจัดการ: มีการจัดการอย่างน้อยดังนี้ + - สามารถกำหนดวันแล้วเสร็จ (Deadline) สำหรับผู้รับผิดชอบของ องกรณ์ ที่อยู่ใน Workflow ได้ + - มีระบบแจ้งเตือน ให้ผู้รับผิดชอบของ องกรณ์ ที่อยู่ใน Workflow ทราบ เมื่อมี RFA ใหม่ หรือมีการเปลี่ยนสถานะ + + * 3.6.การจัดการเอกสารนำส่ง (Transmittals) + + - 3.6.1. วัตถุประสงค์: เอกสารนำส่ง ใช้สำหรับ นำส่ง Request for Approval (RFAS) หลายฉบับ ไปยังองค์กรอื่น + - 3.6.2. ประเภทเอกสาร: ไฟล์ PDF + - 3.6.3. การสร้างเอกสาร: ผู้ใช้ที่มีสิทธิ์ สามารถสร้างและแก้ไขได้ + - 3.6.4. การอ้างอิงและจัดกลุ่ม: เอกสารนำส่ง เป็นส่วนหนึ่งใน Correspondence + + * 3.7. ใบเวียนเอกสารภายใน (Internal Circulation Sheet) + + - 3.7.1. วัตถุประสงค์: การสื่อสาร เอกสาร (Correspondence) ทุกฉบับ จะมีใบเวียนเอกสารเพื่อควบคุมและมอบหมายงานภายในองค์กร (สามารถดูและแก้ไขได้เฉพาะคนในองค์กร) + - 3.7.2. ประเภทเอกสาร: ไฟล์ PDF + - 3.7.3. การสร้างเอกสาร: ผู้ใช้ที่มีสิทธิ์ในองค์กรนั้น สามารถสร้างและแก้ไขได้ + - 3.7.4. การอ้างอิงและจัดกลุ่ม: การระบุผู้รับผิดชอบ: + - ผู้รับผิดชอบหลัก (Main): มีได้หลายคน + - ผู้ร่วมปฏิบัติงาน (Action): มีได้หลายคน + - ผู้ที่ต้องรับทราบ (Information): มีได้หลายคน + - 3.7.5. การติดตามงาน: + - สามารถกำหนดวันแล้วเสร็จ (Deadline) สำหรับผู้รับผิดชอบประเภท Main และ Action ได้ + - มีระบบแจ้งเตือนเมื่อมี Circulation ใหม่ และแจ้งเตือนล่วงหน้าก่อนถึงวันแล้วเสร็จ + - สามารถปิด Circulation ได้เมื่อดำเนินการตอบกลับไปยังองค์กรผู้ส่ง (Originator) แล้ว หรือ รับทราบแล้ว (For Information) + + * 3.8. ประวัติการแก้ไข (Revisions): ระบบจะเก็บประวัติการสร้างและแก้ไข เอกสารทั้งหมด + + * **3.9. การจัดเก็บ: (ปรับปรุงตามสถาปัตยกรรมใหม่)** + + - เอกสารและไฟล์แนบทั้งหมดจะถูกจัดเก็บในโฟลเดอร์บน Server (`/share/dms-data/`) + - ข้อมูล Metadata ของไฟล์ (เช่น ชื่อไฟล์, ขนาด, path) จะถูกเก็บในตาราง `attachments` (ตารางกลาง) + - ไฟล์จะถูกเชื่อมโยงกับเอกสารประเภทต่างๆ ผ่านตารางเชื่อม (Junction tables) เช่น `correspondence_attachments`, `circulation_attachments`, และ `shop_drawing_revision_attachments` + - สถาปัตยกรรมแบบรวมศูนย์นี้ *แทนที่* แนวคิดเดิมที่จะแยกโฟลเดอร์ตามประเภทเอกสาร เพื่อรองรับการขยายระบบที่ดีกว่า + +## 🔐 4. ข้อกำหนดด้านสิทธิ์และการเข้าถึง (Access Control Requirements) + + * 4.1. ภาพรวม: ผู้ใช้และองค์กรสามารถดูและแก้ไขเอกสารได้ตามสิทธิ์ที่ได้รับ โดยระบบสิทธิ์จะเป็นแบบ Role-Based Access Control (RBAC) + + * 4.2. ระดับของสิทธิ์: + + - Global Roles: สิทธิ์ในภาพรวมของระบบ + - Project-Specific Roles: สิทธิ์ที่ถูกกำหนดให้ผู้ใช้สำหรับโครงการนั้นๆ โดยเฉพาะ (เช่น เป็น Editor ในโครงการ A แต่เป็น Viewer ในโครงการ B) + - Contract-Specific Roles: สิทธิ์ที่ถูกกำหนดให้โครงการสำหรับสัญญานั้นๆ (เช่น เป็น Admin ในสัญญา 1 จะเป็น Admin ใน โครงการ A และ ฺB ที่อยู่ในสัญญา 1) + + * 4.3. บทบาท (Roles) พื้นฐาน: + + - Superadmin: ไม่มีข้อจำกัดใดๆ สามารถจัดการได้ทุกอย่างข้ามองค์กร + - Admin: มีสิทธิ์เต็มที่ แต่จำกัดเฉพาะในองค์กรที่ตัวเองสังกัด สามารถจัดการผู้ใช้ในองค์กรได้ สามารถสร้าง Role ใหม่และกำหนดสิทธิ์ (Permissions) เพิ่มเติมได้ในภายหลังผ่านหน้า Admin + - Document Control สามารถ เพิ่ม/แก้ไข/ลบ เอกสาร เฉพาะในองค์กรที่ตัวเองสังกัด ไม่สามารถจัดการผู้ใช้ได้ + - Editor: สามารถ เพิ่ม/แก้ไข เอกสารที่กำหนดไว้ เฉพาะในองค์กรที่ตัวเองสังกัด + - Viewer: สามารถดู เอกสาร เฉพาะในองค์กรที่ตัวเองสังกัด + + * 4.4. การบังคับใช้สิทธิ์: สิทธิ์ขององค์กรจะครอบคลุมสิทธิ์ของผู้ใช้ และการเข้าถึงข้อมูลที่เกี่ยวข้องกับโครงการ (เช่น การแก้ไขเอกสาร) จะถูกตรวจสอบเทียบกับสิทธิ์ที่ผู้ใช้มีในโครงการนั้นๆ โดยเฉพาะ + +## 👥 5. ข้อกำหนดด้านผู้ใช้งาน (User Interface & Experience) + + * 5.1. Layout หลัก: หน้าเว็บใช้รูปแบบ App Shell ที่ประกอบด้วย: + - Navbar (ส่วนบน): แสดงชื่อระบบ, เมนูผู้ใช้ (Profile), เมนูสำหรับ Admin/Superadmin (จัดการผู้ใช้, จัดการสิทธิ์), และปุ่ม Login/Logout + - Sidebar (ด้านข้าง): เป็นเมนูหลักสำหรับเข้าถึงส่วนที่เกี่ยวกับเอกสารทั้งหมด เช่น Dashboard, Correspondences, RFA, Drawings + - Main Content Area: พื้นที่สำหรับแสดงเนื้อหาหลักของหน้าที่เลือก + * 5.2. หน้า Landing Page: เป็นหน้าแรกที่แสดงข้อมูลบางส่วนของโครงการสำหรับผู้ใช้ที่ยังไม่ได้ล็อกอิน + * 5.3. หน้า Dashboard: เป็นหน้าแรกหลังจากล็อกอิน ประกอบด้วย: + - การ์ดสรุปภาพรวม (KPI Cards): แสดงข้อมูลสรุปที่สำคัญขององค์กร เช่น จำนวนเอกสาร, งานที่เกินกำหนด + - ตาราง "งานของฉัน" (My Tasks Table): แสดงรายการงานทั้งหมดจาก Circulation ที่ผู้ใช้ต้องดำเนินการ + * 5.4. การติดตามสถานะ: องค์กรสามารถติดตามสถานะเอกสารทั้งของตนเอง (Originator) และสถานะเอกสารที่ส่งมาถึงตนเอง (Recipient) + * 5.5. การจัดการข้อมูลส่วนตัว (Profile Page): ผู้ใช้สามารถจัดการข้อมูลส่วนตัวและเปลี่ยนรหัสผ่านของตนเองได้ + * 5.6. การจัดการเอกสารทางเทคนิค (Technical Documents & Workflow): ผู้ใช้สามารถดู Technical Document ในรูปแบบ Workflow ทั้งหมดได้ในหน้าเดียว, ขั้นตอนที่ยังไม่ถึงหรือผ่านไปแล้วจะเป็นรูปแบบ diable, สามารถดำเนินการได้เฉพาะในขั้นตอนที่ได้รับมอบหมายงาน (active) เช่น ตรวจสอบแล้ว เพื่อไปยังขั้นตอนต่อไป, สิทธิ์ admin ขึ้นไป สามรถกด ไปยังขั้นตอนต่อไป ได้ทุกขั้นตอน, การย้อนกลับ ไปขั้นตอนก่อนหน้า สามารถทำได้โดย สิทธิ์ admin ขึ้นไป + +## 6\. ข้อกำหนดที่ไม่ใช่ฟังก์ชันการทำงาน (Non-Functional Requirements) + + * 6.1. การบันทึกการกระทำ (Audit Log): ทุกการกระทำที่สำคัญของผู้ใช้ (สร้าง, แก้ไข, ลบ, ส่ง) จะถูกบันทึกไว้ใน `audit_logs` เพื่อการตรวจสอบย้อนหลัง + * 6.2. การค้นหา (Search): ระบบต้องมีฟังก์ชันการค้นหาขั้นสูง ที่สามารถค้นหาเอกสารจากหลายเงื่อนไขพร้อมกันได้ เช่น ค้นหาจากชื่อเรื่อง, ประเภท, วันที่, และ Tag + * 6.3. การทำรายงาน (Reporting): สามารถจัดทำรายงานสรุปแยกประเภทของ Correspondence ประจำวัน, สัปดาห์, เดือน, และปีได้ + * 6.4. ประสิทธิภาพ (Performance): มีการใช้ Caching กับข้อมูลที่เรียกใช้บ่อย และใช้ Pagination ในตารางข้อมูลเพื่อจัดการข้อมูลจำนวนมาก + * 6.5. ความปลอดภัย (Security): + - มีระบบ Rate Limiting เพื่อป้องกันการโจมตีแบบ Brute-force + - การจัดการ Secret (เช่น รหัสผ่าน DB, JWT Secret) จะต้องทำผ่าน Environment Variable ของ Docker เพื่อความปลอดภัยสูงสุด \ No newline at end of file diff --git a/docs/Markdown/LCBP3-DMS_V1_1_0_application _database.md b/docs/Markdown/LCBP3-DMS_V1_1_0_application _database.md new file mode 100644 index 0000000..8fff326 --- /dev/null +++ b/docs/Markdown/LCBP3-DMS_V1_1_0_application _database.md @@ -0,0 +1,55 @@ +# Documents Management Sytem Version 1.1.0: Application Databases Specification +## 1. วัตถุประสงค์ + + +## 2. สถาปัตยกรรมและเทคโนโลยี (System Architecture & Technology Stack) +correspondences ตารางเอกสารโต้ตอบ +-- 2.7.5 : n.n.5 for shop_drawing + shop_drawings; +-- 2.6.6 : n.n.6 for contract_drawing + contract_drawings; +-- 2.5.2 : n.n.2 for rfa + rfas; +-- 2.4.4 : n.n.4 for transmittal + transmittals; +-- 2.3.3: n.n.3 for circulation + circulations; + + + users; +-- 4.7 + projects ตารางโครงการ +-- 4.6 + contracts ตารางสัญญา +-- 4.2 + permissions; +-- 4.1 + roles; + +-- Level 5: ตารางที่เป็นรากฐานที่สุด +-- 5.2 + organizations ตารางองกรณ์; +-- 5.1 + organization_roles; + +-- 1.2 + attachments; + +-- 1.1 + global_default_roles; + + audit_logs; + + +ใช้สถาปัตยกรรมแบบ Headless/API-First ที่ทันสมัย ทำงานทั้งหมดบน QNAP Server ผ่าน Container Station เพื่อความสะดวกในการจัดการและบำรุงรักษา, Domain: np-dms.work, มี fix ip, รัน docker command ใน application ของ Container Station ได้โดยตรง, ประกอบด้วย + +* 2.1. Infrastructure & Environment: + - Server: QNAP (Model: TS-473A, RAM: 32GB, CPU: AMD Ryzen V1500B) + - Containerization: Container Station (Docker & Docker Compose) ใช้ UI ของ Container Station เป็นหลัก ในการ configuration และการรัน docker command + - Development Environment: VS Code on Windows 11 + - Domain: np-dms.work, www.np-dms.work + - ip: 159.192.126.103 + - Docker Network: ทุก Service จะเชื่อมต่อผ่านเครือข่ายกลางชื่อ lcbp3 เพื่อให้สามารถสื่อสารกันได้ + - Data Storage: /share/dms-data บน QNAP + - ข้อจำกัด: ไม่สามารถใช้ .env ในการกำหนดตัวแปรภายนอกได้ ต้องกำหนดใน docker-compose.yml เท่านั้น +* \ No newline at end of file diff --git a/docs/Markdown/LCBP3-DMS_V1_2_0_Data_Dictionary.ิbak b/docs/Markdown/LCBP3-DMS_V1_2_0_Data_Dictionary.ิbak new file mode 100644 index 0000000..706a6f5 --- /dev/null +++ b/docs/Markdown/LCBP3-DMS_V1_2_0_Data_Dictionary.ิbak @@ -0,0 +1,682 @@ +# **สรุปตารางฐานข้อมูล (Data Dictionary) \- LCBP3-DMS** + +เอกสารนี้สรุปโครงสร้างตาราง, Foreign Keys (FK), และ Constraints ที่สำคัญทั้งหมดในฐานข้อมูล LCBP3-DMS (v1.1.1) เพื่อใช้เป็นเอกสารอ้างอิงสำหรับทีมพัฒนา Backend (NestJS) และ Frontend (Next.js) + +## **1\. 🏢 Core & Master Data (องค์กร, โครงการ, สัญญา)** + +#### **1.1. organization\_roles** + +ตาราง Master เก็บประเภทบทบาทขององค์กร (เช่น OWNER, CONTRACTOR) + +| Column | Type | Key | Description | +| :---- | :---- | :---- | :---- | +| id | INT | **PK** | ID ของตาราง | +| role\_name | VARCHAR(20) | UK | ชื่อบทบาท (OWNER, DESIGNER, CONSULTANT, CONTRACTOR, THIRD PARTY) | + +* **Unique Keys (UK):** ux\_roles\_name (role\_name) + +#### **1.2. organizations** + +ตาราง Master เก็บข้อมูลองค์กรทั้งหมดที่เกี่ยวข้องในระบบ + +| Column | Type | Key | Description | +| :---- | :---- | :---- | :---- | +| id | INT | **PK** | ID ของตาราง | +| organization\_code | VARCHAR(20) | UK | รหัสองค์กร | +| organization\_name | VARCHAR(255) | | ชื่อองค์กร | +| role\_id | INT | FK | บทบาทขององค์กร (FK \-\> organization\_roles(id)) | +| is\_active | BOOLEAN | | สถานะการใช้งาน | + +* **Foreign Keys (FK):** + * role\_id \-\> organization\_roles(id) (ON DELETE SET NULL) +* **Unique Keys (UK):** ux\_organizations\_code (organization\_code) + +#### **1.3. projects** + +ตาราง Master เก็บข้อมูลโครงการ (เช่น LCBP3C1, LCBP3C2) + +| Column | Type | Key | Description | +| :---- | :---- | :---- | :---- | +| id | INT | **PK** | ID ของตาราง | +| project\_code | VARCHAR(50) | UK | รหัสโครงการ | +| project\_name | VARCHAR(255) | | ชื่อโครงการ | +| parent\_project\_id | INT | FK | รหัสโครงการหลัก (ถ้ามี) (FK \-\> projects(id)) | +| contractor\_organization\_id | INT | FK | รหัสองค์กรผู้รับเหมา (ถ้ามี) (FK \-\> organizations(id)) | +| is\_active | TINYINT(1) | | สถานะการใช้งาน | + +* **Foreign Keys (FK):** + * parent\_project\_id \-\> projects(id) (ON DELETE SET NULL) + * contractor\_organization\_id \-\> organizations(id) (ON DELETE SET NULL) +* **Unique Keys (UK):** uq\_pro\_code (project\_code) + +#### **1.4. contracts** + +ตาราง Master เก็บข้อมูลสัญญา + +| Column | Type | Key | Description | +| :---- | :---- | :---- | :---- | +| id | INT | **PK** | ID ของตาราง | +| contract\_code | VARCHAR(50) | UK | รหัสสัญญา | +| contract\_name | VARCHAR(255) | | ชื่อสัญญา | +| description | TEXT | | คำอธิบายสัญญา | + +* **Unique Keys (UK):** ux\_contracts\_code (contract\_code) + +#### **1.5. project\_parties (ตารางเชื่อม)** + +ตารางเชื่อมความสัมพันธ์ระหว่าง โครงการ, องค์กร, และบทบาท (M:N) + +| Column | Type | Key | Description | +| :---- | :---- | :---- | :---- | +| project\_id | INT | **PK**, FK | ID ของโครงการ (FK \-\> projects(id)) | +| organization\_id | INT | **PK**, FK | ID ขององค์กร (FK \-\> organizations(id)) | +| role | ENUM(...) | **PK** | บทบาทในโครงการ (OWNER, DESIGNER, CONSULTANT, CONTRACTOR, THIRD\_PARTY) | +| is\_contractor | TINYINT(1) | UK | (Generated) \= 1 ถ้า role \= 'CONTRACTOR' | + +* **Foreign Keys (FK):** + * project\_id \-\> projects(id) (ON DELETE CASCADE) + * organization\_id \-\> organizations(id) (ON DELETE RESTRICT) +* **Unique Keys (UK):** + * uq\_project\_parties\_contractor (project\_id, is\_contractor) \- **(Constraint สำคัญ)** บังคับว่า 1 โครงการมี CONTRACTOR ได้เพียง 1 องค์กร (ตาม Req 3.1.3) + +#### **1.6. contract\_parties (ตารางเชื่อม)** + +ตารางเชื่อมความสัมพันธ์ระหว่าง สัญญา, โครงการ, และองค์กร (M:N) + +| Column | Type | Key | Description | +| :---- | :---- | :---- | :---- | +| contract\_id | INT | **PK**, FK | ID ของสัญญา (FK \-\> contracts(id)) | +| project\_id | INT | **PK**, FK | ID ของโครงการ (FK \-\> projects(id)) | +| organization\_id | INT | **PK**, FK | ID ขององค์กร (FK \-\> organizations(id)) | + +* **Foreign Keys (FK):** + * contract\_id \-\> contracts(id) (ON DELETE CASCADE) + * project\_id \-\> projects(id) (ON DELETE CASCADE) + * organization\_id \-\> organizations(id) (ON DELETE CASCADE) + +## **2\. 👥 Users & RBAC (ผู้ใช้, สิทธิ์, บทบาท)** + +#### **2.1. users** + +ตาราง Master เก็บข้อมูลผู้ใช้งาน (User) + +| Column | Type | Key | Description | +| :---- | :---- | :---- | :---- | +| user\_id | INT | **PK** | ID ของตาราง | +| username | VARCHAR(50) | UK | ชื่อผู้ใช้งาน | +| password\_hash | VARCHAR(255) | | รหัสผ่าน (Hashed) | +| first\_name | VARCHAR(50) | | ชื่อจริง | +| last\_name | VARCHAR(50) | | นามสกุล | +| email | VARCHAR(100) | UK | อีเมล | +| organization\_id | INT | FK | สังกัดองค์กร (FK \-\> organizations(id)) | +| is\_active | TINYINT(1) | | สถานะการใช้งาน | + +* **Foreign Keys (FK):** + * organization\_id \-\> organizations(id) (ON DELETE SET NULL) +* **Unique Keys (UK):** ux\_users\_username (username), ux\_users\_email (email) + +#### **2.2. roles** + +ตาราง Master เก็บ "บทบาท" ของผู้ใช้ในระบบ (เช่น SUPER\_ADMIN, ADMIN, EDITOR) + +| Column | Type | Key | Description | +| :---- | :---- | :---- | :---- | +| role\_id | INT | **PK** | ID ของตาราง | +| role\_code | VARCHAR(50) | UK | รหัสบทบาท (เช่น SUPER\_ADMIN, ADMIN, EDITOR, VIEWER) | +| role\_name | VARCHAR(100) | | ชื่อบทบาท | +| is\_system | BOOLEAN | | (1 \= บทบาทของระบบ ลบไม่ได้) | + +* **Unique Keys (UK):** role\_code + +#### **2.3. permissions** + +ตาราง Master เก็บ "สิทธิ์" (Permission) หรือ "การกระทำ" ทั้งหมดในระบบ + +| Column | Type | Key | Description | +| :---- | :---- | :---- | :---- | +| permission\_id | INT | **PK** | ID ของตาราง | +| permission\_code | VARCHAR(100) | UK | รหัสสิทธิ์ (เช่น rfas.create, rfas.view) | +| module | VARCHAR(50) | | โมดูลที่เกี่ยวข้อง | +| scope\_level | ENUM(...) | | ระดับของสิทธิ์ (GLOBAL, ORG, PROJECT) | + +* **Unique Keys (UK):** ux\_permissions\_code (permission\_code) + +#### **2.4. role\_permissions (ตารางเชื่อม)** + +ตารางเชื่อมระหว่าง roles และ permissions (M:N) + +| Column | Type | Key | Description | +| :---- | :---- | :---- | :---- | +| role\_id | INT | **PK**, FK | ID ของบทบาท (FK \-\> roles(role\_id)) | +| permission\_id | INT | **PK**, FK | ID ของสิทธิ์ (FK \-\> permissions(permission\_id)) | + +* **Foreign Keys (FK):** + * role\_id \-\> roles(role\_id) (ON DELETE CASCADE) + * permission\_id \-\> permissions(permission\_id) (ON DELETE CASCADE) + +#### **2.5. user\_roles (ตารางเชื่อม)** + +ตารางเชื่อมผู้ใช้ (users) กับบทบาท (roles) ในระดับ **Global** (M:N) + +| Column | Type | Key | Description | +| :---- | :---- | :---- | :---- | +| user\_id | INT | **PK**, FK | ID ของผู้ใช้ (FK \-\> users(user\_id)) | +| role\_id | INT | **PK**, FK | ID ของบทบาท (FK \-\> roles(role\_id)) | + +* **Foreign Keys (FK):** + * user\_id \-\> users(user\_id) (ON DELETE CASCADE) + * role\_id \-\> roles(role\_id) (ON DELETE CASCADE) + +#### **2.6. user\_project\_roles (ตารางเชื่อม)** + +ตารางเชื่อมผู้ใช้ (users) กับบทบาท (roles) ในระดับ **Project-Specific** (M:N) (Req 4.2) + +| Column | Type | Key | Description | +| :---- | :---- | :---- | :---- | +| user\_id | INT | **PK**, FK | ID ของผู้ใช้ (FK \-\> users(user\_id)) | +| project\_id | INT | **PK**, FK | ID ของโครงการ (FK \-\> projects(id)) | +| role\_id | INT | **PK**, FK | ID ของบทบาท (FK \-\> roles(role\_id)) | + +* **Foreign Keys (FK):** + * user\_id \-\> users(user\_id) (ON DELETE CASCADE) + * project\_id \-\> projects(id) (ON DELETE CASCADE) + * role\_id \-\> roles(role\_id) (ON DELETE CASCADE) + +## **3\. ✉️ Correspondences (เอกสารหลัก, Revisions)** + +#### **3.1. correspondence\_types** + +ตาราง Master เก็บประเภทเอกสารโต้ตอบ (เช่น RFA, RFI, LETTER, MOM) + +| Column | Type | Key | Description | +| :---- | :---- | :---- | :---- | +| id | INT | **PK** | ID ของตาราง | +| type\_code | VARCHAR(50) | UK | รหัสประเภท (เช่น RFA, RFI) | +| type\_name | VARCHAR(255) | | ชื่อประเภท | + +* **Unique Keys (UK):** type\_code + +#### **3.2. correspondence\_status** + +ตาราง Master เก็บสถานะของเอกสาร (เช่น DRAFT, SUBMITTED, CLOSED) + +| Column | Type | Key | Description | +| :---- | :---- | :---- | :---- | +| id | INT | **PK** | ID ของตาราง | +| status\_code | VARCHAR(50) | UK | รหัสสถานะ (เช่น DRAFT, SUBOWN) | +| status\_name | VARCHAR(255) | | ชื่อสถานะ | + +* **Unique Keys (UK):** status\_code + +#### **3.3. correspondences (Master)** + +ตาราง "แม่" ของเอกสารโต้ตอบ เก็บข้อมูลที่ไม่เปลี่ยนแปลงตาม Revision (เช่น เลขที่เอกสาร) + +| Column | Type | Key | Description | +| :---- | :---- | :---- | :---- | +| id | INT | **PK** | ID ของตาราง (นี่คือ "Master ID" ที่ใช้เชื่อมโยง) | +| correspondence\_number | VARCHAR(100) | UK | เลขที่เอกสาร (สร้างจาก DocumentNumberingModule) | +| correspondence\_type\_id | INT | FK | ประเภทเอกสาร (FK \-\> correspondence\_types(id)) | +| is\_internal\_communication | TINYINT(1) | | (1 \= ภายใน, 0 \= ภายนอก) | +| project\_id | INT | FK | อยู่ในโครงการ (FK \-\> projects(id)) | +| originator\_id | INT | FK | องค์กรผู้ส่ง (FK \-\> organizations(id)) | +| recipient\_id | INT | FK | องค์กรผู้รับ (FK \-\> organizations(id)) | +| created\_by | INT | FK | ผู้สร้าง (FK \-\> users(user\_id)) | +| deleted\_at | DATETIME | | สำหรับ Soft Delete | + +* **Foreign Keys (FK):** + * correspondence\_type\_id \-\> correspondence\_types(id) (ON DELETE RESTRICT) + * project\_id \-\> projects(id) (ON DELETE CASCADE) + * originator\_id \-\> organizations(id) (ON DELETE SET NULL) + * recipient\_id \-\> organizations(id) (ON DELETE SET NULL) + * created\_by \-\> users(user\_id) (ON DELETE SET NULL) +* **Unique Keys (UK):** uq\_corr\_no\_per\_project (project\_id, correspondence\_number) + +#### **3.4. correspondence\_revisions (Revisions)** + +ตาราง "ลูก" เก็บประวัติการแก้ไข (Revisions) ของ correspondences (1:N) **(ปรับปรุง)** id เป็น PK ใหม่ เพื่อรองรับ 1:N + +| Column | Type | Key | Description | +| :---- | :---- | :---- | :---- | +| id | INT | **PK** | **ID ของ Revision** | +| correspondence\_id | INT | FK, UK | Master ID (FK \-\> correspondences(id)) | +| revision\_number | INT | UK | หมายเลข Revision (0, 1, 2...) | +| revision\_label | VARCHAR(10) | | Revision ที่แสดง (เช่น A, B, 1.1) | +| is\_current | BOOLEAN | UK | (1 \= Revision ปัจจุบัน) | +| correspondence\_status\_id | INT | FK | สถานะของ Revision นี้ (FK \-\> correspondence\_status(id)) | +| title | VARCHAR(255) | | เรื่อง | +| document\_date | DATE | | วันที่ในเอกสาร | +| issued\_date | DATETIME | | วันที่ออกเอกสาร | +| received\_date | DATETIME | | วันที่ลงรับ | +| due\_date | DATETIME | | **(ไม่สอดคล้องกับ Req 3.2.5)** วันที่ครบกำหนด (ควรย้ายไป correspondence\_recipients) | +| details | JSON | | ข้อมูลเฉพาะ (เช่น RFI details) | +| created\_by | INT | FK | ผู้สร้าง (FK \-\> users(user\_id)) | + +* **Foreign Keys (FK):** + * correspondence\_id \-\> correspondences(id) (ON DELETE CASCADE) + * correspondence\_status\_id \-\> correspondence\_status(id) (ON DELETE RESTRICT) + * created\_by \-\> users(user\_id) (ON DELETE SET NULL) +* **Unique Keys (UK):** + * uq\_master\_revision\_number (correspondence\_id, revision\_number) (ป้องกัน Rev ซ้ำใน Master เดียว) + * uq\_master\_current (correspondence\_id, is\_current) (ป้องกันการมี is\_current \= TRUE ซ้ำใน Master เดียว) +* **Check Constraints (CHK):** chk\_rev\_format (ตรวจสอบรูปแบบ revision\_label) + +#### **3.5. correspondence\_recipients (ตารางเชื่อม)** + +ตารางเชื่อมผู้รับ (TO/CC) สำหรับเอกสารแต่ละฉบับ (M:N) + +| Column | Type | Key | Description | +| :---- | :---- | :---- | :---- | +| correspondence\_id | INT | **PK**, FK | ID ของเอกสาร (FK \-\> correspondence\_revisions(correspondence\_id)) | +| recipient\_organization\_id | INT | **PK**, FK | ID องค์กรผู้รับ (FK \-\> organizations(id)) | +| recipient\_type | ENUM('TO', 'CC') | **PK** | ประเภทผู้รับ (TO หรือ CC) | + +* **Foreign Keys (FK):** + * correspondence\_id \-\> correspondence\_revisions(correspondence\_id) (ON DELETE CASCADE) + * recipient\_organization\_id \-\> organizations(id) (ON DELETE RESTRICT) + +#### **3.6. correspondence\_references (ตารางเชื่อม)** + +ตารางเชื่อมการอ้างอิงระหว่างเอกสาร (M:N) (Req 3.2.4) + +| Column | Type | Key | Description | +| :---- | :---- | :---- | :---- | +| src\_correspondence\_id | INT | **PK**, FK | ID เอกสารต้นทาง (FK \-\> correspondences(id)) | +| tgt\_correspondence\_id | INT | **PK**, FK | ID เอกสารเป้าหมาย (FK \-\> correspondences(id)) | + +* **Foreign Keys (FK):** + * src\_correspondence\_id \-\> correspondences(id) (ON DELETE CASCADE) + * tgt\_correspondence\_id \-\> correspondences(id) (ON DELETE CASCADE) + +#### **3.7. correspondence\_routing\_templates / ...\_steps / ...\_routings** + +ตารางที่เกี่ยวข้องกับ Workflow การส่งต่อเอกสาร (Req 3.5.4) + +* **correspondence\_routing\_templates:** ตาราง Master เก็บแม่แบบสายงาน (เช่น "ส่งให้ CSC ตรวจสอบ") +* **correspondence\_routing\_template\_steps:** ตารางลูก เก็บขั้นตอนในแม่แบบ (เช่น Step 1: ส่งไป Org A, Step 2: ส่งไป Org B) +* **correspondence\_routings:** ตารางประวัติ (Log) การส่งต่อของเอกสารจริงตาม Workflow + +## **4\. approval: RFA (เอกสารขออนุมัติ, Workflows)** + +#### **4.1. rfa\_types / ...\_status\_codes / ...\_approve\_codes** + +ตาราง Master สำหรับ RFA + +* **rfa\_types:** ประเภท RFA (เช่น DWG, DOC, MAT) (Req 3.5.2) +* **rfa\_status\_codes:** สถานะ RFA (เช่น DFT \- Draft, FAP \- For Approve) +* **rfa\_approve\_codes:** รหัสผลการอนุมัติ (เช่น 1A \- Approved, 3R \- Revise and Resubmit) + +#### **4.2. rfas (Master)** + +ตาราง "แม่" ของ RFA (มีความสัมพันธ์ 1:N กับ rfa\_revisions) + +| Column | Type | Key | Description | +| :---- | :---- | :---- | :---- | +| id | INT | **PK** | ID ของตาราง (RFA Master ID) | +| rfa\_type\_id | INT | FK | ประเภท RFA (FK \-\> rfa\_types(id)) | +| revision\_number | INT | | หมายเลข Revision ล่าสุด (ควรย้ายไป rfa\_revisions) | +| created\_by | INT | FK | ผู้สร้าง (FK \-\> users(user\_id)) | +| deleted\_at | DATETIME | | สำหรับ Soft Delete | + +* **Foreign Keys (FK):** + * rfa\_type\_id \-\> rfa\_types(id) + * created\_by \-\> users(user\_id) (ON DELETE SET NULL) + +#### **4.3. rfa\_revisions (Revisions)** + +ตาราง "ลูก" เก็บประวัติ (Revisions) ของ rfas (1:N) **(ปรับปรุง)** id เป็น PK ใหม่ เพื่อรองรับ 1:N + +| Column | Type | Key | Description | +| :---- | :---- | :---- | :---- | +| id | INT | **PK** | **ID ของ Revision** | +| correspondence\_id | INT | FK | Master ID ของ Correspondence (FK \-\> correspondences(id)) | +| rfa\_id | INT | FK, UK | Master ID ของ RFA (FK \-\> rfas(id)) | +| revision\_number | INT | UK | หมายเลข Revision (0, 1, 2...) | +| is\_current | BOOLEAN | UK | (1 \= Revision ปัจจุบัน) | +| rfa\_status\_code\_id | INT | FK | สถานะ RFA (FK \-\> rfa\_status\_codes(id)) | +| rfa\_approve\_code\_id | INT | FK | ผลการอนุมัติ (FK \-\> rfa\_approve\_codes(id)) | +| title | VARCHAR(255) | | เรื่อง | +| due\_date | DATETIME | | **(ไม่สอดคล้องกับ Req 3.6.6)** วันที่ครบกำหนด (ควรย้ายไป rfa\_workflows) | +| created\_by | INT | FK | ผู้สร้าง (FK \-\> users(user\_id)) | + +* **Foreign Keys (FK):** + * correspondence\_id \-\> correspondences(id) (ON DELETE CASCADE) + * rfa\_id \-\> rfas(id) (ON DELETE CASCADE) + * rfa\_status\_code\_id \-\> rfa\_status\_codes(id) + * rfa\_approve\_code\_id \-\> rfa\_approve\_codes(id) (ON DELETE SET NULL) + * created\_by \-\> users(user\_id) (ON DELETE SET NULL) +* **Unique Keys (UK):** + * uq\_rr\_rev\_number (rfa\_id, revision\_number) (ป้องกัน Rev ซ้ำใน Master เดียว) + * uq\_rr\_current (rfa\_id, is\_current) (ป้องกัน is\_current=TRUE ซ้ำใน Master เดียว) + +#### **4.4. rfa\_items (ตารางเชื่อม)** + +ตารางเชื่อมระหว่าง rfa\_revisions (ที่เป็นประเภท DWG) กับ shop\_drawing\_revisions (M:N) (Req 3.5.4) + +| Column | Type | Key | Description | +| :---- | :---- | :---- | :---- | +| rfarev\_correspondence\_id | INT | **PK**, FK | ID ของ RFA Revision (FK \-\> rfa\_revisions(correspondence\_id)) | +| shop\_drawing\_revision\_id | INT | **PK**, UK, FK | ID ของ Shop Drawing Revision (FK \-\> shop\_drawing\_revisions(id)) | + +* **Foreign Keys (FK):** + * rfarev\_correspondence\_id \-\> rfa\_revisions(correspondence\_id) (ON DELETE CASCADE) + * shop\_drawing\_revision\_id \-\> shop\_drawing\_revisions(id) (ON DELETE CASCADE) + +#### **4.5. rfa\_workflow\_templates / ...\_steps / ...\_workflows** + +ตารางที่เกี่ยวข้องกับ Workflow การอนุมัติ RFA (Req 3.6.5) + +* **rfa\_workflow\_templates:** ตาราง Master เก็บแม่แบบสายอนุมัติ (เช่น "สายอนุมัติ 3 ขั้นตอน") +* **rfa\_workflow\_template\_steps:** ตารางลูก เก็บขั้นตอนในแม่แบบ (เช่น Step 1: Org A (Review), Step 2: Org B (Approve)) +* **rfa\_workflows:** ตารางประวัติ (Log) การอนุมัติของ RFA จริงตามสายงาน + +## **5\. 📐 Drawings (แบบ, หมวดหมู่)** + +#### **5.1. contract\_drawing\_volumes / ...\_cats / ...\_sub\_cats / ...\_subcat\_cat\_maps** + +ตาราง Master สำหรับ "แบบคู่สัญญา" (Contract Drawings) (Req 3.3) + +* **contract\_drawing\_volumes:** เก็บ "เล่ม" ของแบบ +* **contract\_drawing\_cats:** เก็บ "หมวดหมู่หลัก" ของแบบ +* **contract\_drawing\_sub\_cats:** เก็บ "หมวดหมู่ย่อย" ของแบบ +* **contract\_drawing\_subcat\_cat\_maps:** ตารางเชื่อมระหว่าง หมวดหมู่หลัก-ย่อย (M:N) + +#### **5.2. contract\_drawings (Master)** + +ตาราง Master เก็บข้อมูล "แบบคู่สัญญา" (Req 3.3.4) + +| Column | Type | Key | Description | +| :---- | :---- | :---- | :---- | +| id | INT | **PK** | ID ของตาราง | +| project\_id | INT | FK, UK | โครงการ (FK \-\> projects(id)) | +| condwg\_no | VARCHAR(255) | UK | เลขที่แบบสัญญา | +| title | VARCHAR(255) | | ชื่อแบบ | +| sub\_cat\_id | INT | FK | หมวดหมู่ย่อย (FK \-\> contract\_drawing\_sub\_cats(id)) | +| volume\_id | INT | FK | เล่ม (FK \-\> contract\_drawing\_volumes(id)) | + +* **Foreign Keys (FK):** + * fk\_condwg\_project (project\_id) \-\> projects(id) (ON DELETE CASCADE) + * fk\_condwg\_subcat\_same\_project (project\_id, sub\_cat\_id) \-\> contract\_drawing\_sub\_cats(project\_id, id) + * fk\_condwg\_volume\_same\_project (project\_id, volume\_id) \-\> contract\_drawing\_volumes(project\_id, id) +* **Unique Keys (UK):** ux\_condwg\_no\_project (project\_id, condwg\_no) + +#### **5.3. shop\_drawing\_main\_categories / ...\_sub\_categories** + +ตาราง Master สำหรับ "แบบก่อสร้าง" (Shop Drawings) (Req 3.4) + +* **shop\_drawing\_main\_categories:** เก็บ "หมวดหมู่หลัก" (เช่น ARCH, STR) +* **shop\_drawing\_sub\_categories:** เก็บ "หมวดหมู่ย่อย" (เช่น STR-COLUMN) + +#### **5.4. shop\_drawings (Master)** + +ตาราง Master เก็บข้อมูล "แบบก่อสร้าง" (Req 3.4.4) + +| Column | Type | Key | Description | +| :---- | :---- | :---- | :---- | +| id | INT | **PK** | ID ของตาราง | +| project\_id | INT | FK | โครงการ (FK \-\> projects(id)) | +| drawing\_number | VARCHAR(100) | UK | เลขที่ Shop Drawing | +| title | VARCHAR(500) | | ชื่อแบบ | +| main\_category\_id | INT | FK | หมวดหมู่หลัก (FK \-\> shop\_drawing\_main\_categories(id)) | +| sub\_category\_id | INT | FK | หมวดหมู่ย่อย (FK \-\> shop\_drawing\_sub\_categories(id)) | + +* **Foreign Keys (FK):** project\_id, main\_category\_id, sub\_category\_id +* **Unique Keys (UK):** ux\_sd\_drawing\_number (drawing\_number) + +#### **5.5. shop\_drawing\_revisions (Revisions)** + +ตาราง "ลูก" เก็บประวัติ (Revisions) ของ shop\_drawings (1:N) **(ปรับปรุง)** ลบ file\_path ออกแล้ว + +| Column | Type | Key | Description | +| :---- | :---- | :---- | :---- | +| id | INT | **PK** | ID ของ Revision | +| shop\_drawing\_id | INT | FK, UK | Master ID (FK \-\> shop\_drawings(id)) | +| revision\_number | VARCHAR(10) | UK | หมายเลข Revision (เช่น A, B, 0, 1\) | +| revision\_date | DATE | | วันที่ของ Revision | +| description | TEXT | | คำอธิบายการแก้ไข | + +* **Foreign Keys (FK):** + * shop\_drawing\_id \-\> shop\_drawings(id) (ON DELETE CASCADE) +* **Unique Keys (UK):** ux\_sd\_rev\_drawing\_revision (shop\_drawing\_id, revision\_number) + +#### **5.6. shop\_drawing\_revision\_contract\_refs (ตารางเชื่อม)** + +ตารางเชื่อมระหว่าง shop\_drawing\_revisions กับ contract\_drawings (M:N) (Req 3.5.4) + +| Column | Type | Key | Description | +| :---- | :---- | :---- | :---- | +| shop\_drawing\_revision\_id | INT | FK | ID ของ Shop Drawing Revision (FK \-\> shop\_drawing\_revisions(id)) | +| contract\_drawing\_id | INT | FK | ID ของ Contract Drawing (FK \-\> contract\_drawings(id)) | + +* **Foreign Keys (FK):** shop\_drawing\_revision\_id, contract\_drawing\_id + +## **6\. 🔄 Circulations (ใบเวียนภายใน)** + +#### **6.1. circulation\_status\_codes** + +ตาราง Master เก็บสถานะใบเวียน (เช่น OPEN, IN\_REVIEW, COMPLETED) + +#### **6.2. circulations (Master)** + +ตาราง "แม่" ของใบเวียนเอกสารภายใน (Req 3.7) + +| Column | Type | Key | Description | +| :---- | :---- | :---- | :---- | +| id | INT | **PK** | ID ของตาราง | +| correspondence\_id | INT | UK, FK | เอกสารที่ใช้อ้างอิง (FK \-\> correspondences(id)) | +| organization\_id | INT | FK, UK | องค์กรเจ้าของใบเวียน (FK \-\> organizations(id)) | +| circulation\_no | VARCHAR(100) | UK | เลขที่ใบเวียน | +| circulation\_subject | VARCHAR(500) | | เรื่อง | +| circulation\_status\_code | VARCHAR(20) | FK | สถานะใบเวียน (FK \-\> circulation\_status\_codes(code)) | +| created\_by\_user\_id | INT | FK | ผู้สร้าง (FK \-\> users(user\_id)) | + +* **Foreign Keys (FK):** correspondence\_id, organization\_id, circulation\_status\_code, created\_by\_user\_id +* **Unique Keys (UK):** + * correspondence\_id (1 ใบเวียน ต่อ 1 เอกสาร) + * uq\_cir\_org\_no (organization\_id, circulation\_no) (เลขที่ใบเวียนห้ามซ้ำในองค์กร) + +#### **6.3. circulation\_recipients / ...\_assignees / ...\_actions** + +ตาราง "ลูก" ของ circulations + +* **circulation\_recipients:** รายชื่อผู้รับ (TO/CC) ภายในองค์กร +* **circulation\_assignees:** รายชื่อผู้รับผิดชอบ (MAIN, ACTION, INFO) (Req 3.7.4) และเก็บ deadline (Req 3.7.5) +* **circulation\_actions:** ประวัติการดำเนินการ (เช่น Comment, Forward, Close) +* **circulation\_action\_documents:** ตารางเชื่อม circulation\_actions กับ attachments (ไฟล์แนบระหว่างดำเนินการ) + +#### **6.4. circulation\_templates / ...\_assignees** + +ตารางสำหรับแม่แบบใบเวียน (Templates) + +* **circulation\_templates:** ตาราง Master เก็บแม่แบบใบเวียน +* **circulation\_template\_assignees:** ตารางลูก เก็บผู้รับผิดชอบที่กำหนดไว้ล่วงหน้าในแม่แบบ + +## **7\. 📤 Transmittals (เอกสารนำส่ง)** + +#### **7.1. transmittals** + +ตารางข้อมูลเฉพาะของเอกสารนำส่ง (เป็นตารางลูก 1:1 ของ correspondences) (Req 3.6) + +| Column | Type | Key | Description | +| :---- | :---- | :---- | :---- | +| correspondence\_id | INT | **PK**, FK | ID ของเอกสาร (FK \-\> correspondences(id)) | +| purpose | ENUM(...) | | วัตถุประสงค์ (FOR\_APPROVAL, FOR\_INFORMATION, ...) | +| remarks | TEXT | | หมายเหตุ | + +* **Foreign Keys (FK):** correspondence\_id \-\> correspondences(id) (ON DELETE CASCADE) + +#### **7.2. transmittal\_items (ตารางเชื่อม)** + +ตารางเชื่อมระหว่าง transmittals และ rfa\_revisions (M:N) (Req 3.6.1) + +| Column | Type | Key | Description | +| :---- | :---- | :---- | :---- | +| transmittal\_id | INT | **PK**, FK | ID ของ Transmittal (FK \-\> transmittals(correspondence\_id)) | +| rfarev\_id | INT | **PK**, FK | ID ของ RFA Revision (FK \-\> rfa\_revisions(correspondence\_id)) | + +* **Foreign Keys (FK):** + * transmittal\_id \-\> transmittals(correspondence\_id) (ON DELETE CASCADE) + * rfarev\_id \-\> rfa\_revisions(correspondence\_id) (ON DELETE CASCADE) +* **Unique Keys (UK):** ux\_transmittal\_item (transmittal\_id, rfarev\_id) + +## **8\. 📎 File Management (ไฟล์แนบ)** + +#### **8.1. attachments (Master)** + +ตาราง "กลาง" เก็บไฟล์แนบทั้งหมดของระบบ **(ปรับปรุง)** เป็นตารางกลาง ไม่มี FK ไปยังตารางอื่น + +| Column | Type | Key | Description | +| :---- | :---- | :---- | :---- | +| id | INT | **PK** | ID ของไฟล์แนบ | +| original\_filename | VARCHAR(255) | | ชื่อไฟล์ดั้งเดิม | +| stored\_filename | VARCHAR(255) | | ชื่อไฟล์ที่เก็บจริง (ป้องกันซ้ำ) | +| file\_path | VARCHAR(500) | | Path ที่เก็บไฟล์ (บน QNAP /share/dms-data/) | +| mime\_type | VARCHAR(100) | | ประเภทไฟล์ (เช่น application/pdf) | +| file\_size | INT | | ขนาดไฟล์ (bytes) | +| uploaded\_by\_user\_id | INT | FK | ผู้อัปโหลด (FK \-\> users(user\_id)) | + +* **Foreign Keys (FK):** uploaded\_by\_user\_id \-\> users(user\_id) (ON DELETE CASCADE) + +#### **8.2. correspondence\_attachments (ตารางเชื่อม \- ใหม่)** + +ตารางเชื่อม correspondences กับ attachments (M:N) + +| Column | Type | Key | Description | +| :---- | :---- | :---- | :---- | +| correspondence\_id | INT | **PK**, FK | ID ของเอกสาร (FK \-\> correspondences(id)) | +| attachment\_id | INT | **PK**, FK | ID ของไฟล์แนบ (FK \-\> attachments(id)) | +| is\_main\_document | BOOLEAN | | (1 \= ไฟล์หลัก) (Req 5.7) | + +* **Foreign Keys (FK):** correspondence\_id, attachment\_id + +#### **8.3. circulation\_attachments (ตารางเชื่อม \- ใหม่)** + +ตารางเชื่อม circulations กับ attachments (M:N) + +| Column | Type | Key | Description | +| :---- | :---- | :---- | :---- | +| circulation\_id | INT | **PK**, FK | ID ของใบเวียน (FK \-\> circulations(id)) | +| attachment\_id | INT | **PK**, FK | ID ของไฟล์แนบ (FK \-\> attachments(id)) | +| is\_main\_document | BOOLEAN | | (1 \= ไฟล์หลัก) | + +* **Foreign Keys (FK):** circulation\_id, attachment\_id + +#### **8.4. shop\_drawing\_revision\_attachments (ตารางเชื่อม \- ใหม่)** + +ตารางเชื่อม shop\_drawing\_revisions กับ attachments (M:N) + +| Column | Type | Key | Description | +| :---- | :---- | :---- | :---- | +| shop\_drawing\_revision\_id | INT | **PK**, FK | ID ของ Drawing Revision (FK \-\> shop\_drawing\_revisions(id)) | +| attachment\_id | INT | **PK**, FK | ID ของไฟล์แนบ (FK \-\> attachments(id)) | +| file\_type | ENUM(...) | | ประเภทไฟล์ (PDF, DWG, SOURCE, OTHER) (Req 5.7) | + +* **Foreign Keys (FK):** shop\_drawing\_revision\_id, attachment\_id + +## **9\. 🔢 Document Numbering (การสร้างเลขที่เอกสาร)** + +#### **9.1. document\_number\_formats (ตารางตั้งค่า \- ใหม่)** + +ตาราง Master เก็บ "รูปแบบ" Template ของเลขที่เอกสาร (Req 3.10) + +| Column | Type | Key | Description | +| :---- | :---- | :---- | :---- | +| id | INT | **PK** | ID ของตาราง | +| project\_id | INT | FK, UK | โครงการ (FK \-\> projects(id)) | +| correspondence\_type\_id | INT | FK, UK | ประเภทเอกสาร (FK \-\> correspondence\_types(id)) | +| format\_template | VARCHAR(255) | | รูปแบบ Template (เช่น {ORG\_CODE}-{TYPE\_CODE}-{SEQ:4}) | + +* **Foreign Keys (FK):** project\_id, correspondence\_type\_id +* **Unique Keys (UK):** uk\_project\_type (project\_id, correspondence\_type\_id) + +#### **9.2. document\_number\_counters (ตารางตัวนับ \- ใหม่)** + +ตารางเก็บ "ตัวนับ" (Running Number) ล่าสุด (Req 3.10.2) + +| Column | Type | Key | Description | +| :---- | :---- | :---- | :---- | +| project\_id | INT | **PK**, FK | โครงการ (FK \-\> projects(id)) | +| originator\_organization\_id | INT | **PK**, FK | องค์กรผู้ส่ง (FK \-\> organizations(id)) | +| correspondence\_type\_id | INT | **PK**, FK | ประเภทเอกสาร (FK \-\> correspondence\_types(id)) | +| current\_year | INT | **PK** | ปี ค.ศ. ของตัวนับ | +| last\_number | INT | | เลขที่ล่าสุดที่ใช้ไป | + +* **Foreign Keys (FK):** project\_id, originator\_organization\_id, correspondence\_type\_id + +## **10\. ⚙️ System & Logs (ระบบและ Log)** + +#### **10.1. tags** + +ตาราง Master เก็บ Tags ทั้งหมดที่ใช้ในระบบ (Req 6.2) + +| Column | Type | Key | Description | +| :---- | :---- | :---- | :---- | +| id | INT | **PK** | ID ของตาราง | +| tag\_name | VARCHAR(100) | UK | ชื่อ Tag | + +* **Unique Keys (UK):** ux\_tag\_name (tag\_name) + +#### **10.2. correspondence\_tags (ตารางเชื่อม)** + +ตารางเชื่อมระหว่าง correspondences และ tags (M:N) (Req 3.2.4) + +| Column | Type | Key | Description | +| :---- | :---- | :---- | :---- | +| correspondence\_id | INT | **PK**, FK | ID ของเอกสาร (FK \-\> correspondences(id)) | +| tag\_id | INT | **PK**, FK | ID ของ Tag (FK \-\> tags(id)) | + +* **Foreign Keys (FK):** correspondence\_id, tag\_id + +#### **10.3. audit\_logs** + +ตารางเก็บบันทึกการกระทำของผู้ใช้ (Req 6.1) + +| Column | Type | Key | Description | +| :---- | :---- | :---- | :---- | +| audit\_id | BIGINT | **PK** | ID ของ Log | +| user\_id | INT | FK | ผู้กระทำ (FK \-\> users(user\_id)) | +| action | VARCHAR(100) | | การกระทำ (เช่น rfa.create) | +| entity\_type | VARCHAR(50) | | ตาราง/โมดูล (เช่น rfas) | +| entity\_id | VARCHAR(50) | | ID ของสิ่งที่ถูกกระทำ | +| details\_json | JSON | | ข้อมูลเพิ่มเติม | +| ip\_address | VARCHAR(45) | | IP Address | +| created\_at | TIMESTAMP | | เวลาที่กระทำ | + +* **Foreign Keys (FK):** user\_id \-\> users(user\_id) (ON DELETE SET NULL) + +## **11\. 📋 Views & Procedures (วิว และ โปรซีเดอร์)** + +#### **11.1. sp\_get\_next\_document\_number (Procedure)** + +**(ใหม่)** Stored Procedure เดียวที่ใช้ในระบบ (Req 2.9.3) + +* **หน้าที่:** ดึงเลขที่เอกสารถัดไป (Next Running Number) จากตาราง document\_number\_counters +* **ตรรกะ:** ใช้ SELECT ... FOR UPDATE เพื่อ "ล็อก" แถว ป้องกัน Race Condition (การที่ผู้ใช้ 2 คนได้เลขที่ซ้ำกัน) + +#### **11.2. v\_current\_correspondences (View)** + +* **หน้าที่:** แสดง Revision "ปัจจุบัน" (is\_current \= TRUE) ของ correspondences ทั้งหมด (ที่ไม่ใช่ RFA) + +#### **11.3. v\_current\_rfas (View)** + +* **หน้าที่:** แสดง Revision "ปัจจุบัน" (is\_current \= TRUE) ของ rfa\_revisions ทั้งหมด + +#### **11.4. v\_user\_tasks (View)** + +**(ใหม่)** + +* **หน้าที่:** แสดงรายการ "งานของฉัน" (My Tasks) ที่ยังไม่เสร็จ (Req 5.3) +* **ตรรกะ:** JOIN ตาราง circulations กับ circulation\_assignees (ที่ is\_completed \= FALSE) + +#### **11.5. v\_audit\_log\_details (View)** + +**(ใหม่)** + +* **หน้าที่:** แสดง audit\_logs พร้อมข้อมูล username และ email ของผู้กระทำ (Req 6.1) + +#### **11.6. v\_user\_all\_permissions (View)** + +**(ใหม่)** + +* **หน้าที่:** รวมสิทธิ์ทั้งหมด (Global \+ Project) ของผู้ใช้ทุกคน เพื่อให้ Backend ตรวจสอบสิทธิ์ได้ง่าย (Req 4.2) +* **ตรรกะ:** UNION ข้อมูลจาก user\_roles และ user\_project\_roles \ No newline at end of file diff --git a/docs/Markdown/LCBP3-DMS_V1_2_1_Data_Dictionary.md b/docs/Markdown/LCBP3-DMS_V1_2_1_Data_Dictionary.md new file mode 100644 index 0000000..7528102 --- /dev/null +++ b/docs/Markdown/LCBP3-DMS_V1_2_1_Data_Dictionary.md @@ -0,0 +1,777 @@ +--- + +# **สรุปตารางฐานข้อมูล (Data Dictionary) - LCBP3-DMS (V1.2.1)** + +เอกสารนี้สรุปโครงสร้างตาราง, Foreign Keys (FK), และ Constraints ที่สำคัญทั้งหมดในฐานข้อมูล LCBP3-DMS (v1.2.0) เพื่อใช้เป็นเอกสารอ้างอิงสำหรับทีมพัฒนา Backend (NestJS) และ Frontend (Next.js) + +## **1\. 🏢 Core & Master Data (องค์กร, โครงการ, สัญญา)** + +#### **1.1. organization\_roles** + +ตาราง Master เก็บประเภทบทบาทขององค์กร (เช่น OWNER, CONTRACTOR) + +| Column | Type | Key | Description | +| :--- | :--- | :--- | :--- | +| id | INT | **PK** | ID ของตาราง | +| role\_name | VARCHAR(20) | UK | ชื่อบทบาท (OWNER, DESIGNER, CONSULTANT, CONTRACTOR, THIRD PARTY) | + +* **Unique Keys (UK):** ux\_roles\_name (role\_name) + +#### **1.2. organizations** + +ตาราง Master เก็บข้อมูลองค์กรทั้งหมดที่เกี่ยวข้องในระบบ + +| Column | Type | Key | Description | +| :--- | :--- | :--- | :--- | +| id | INT | **PK** | ID ของตาราง | +| organization\_code | VARCHAR(20) | UK | รหัสองค์กร | +| organization\_name | VARCHAR(255) | | ชื่อองค์กร | +| role\_id | INT | FK | บทบาทขององค์กร (FK \-> organization\_roles(id)) | +| is\_active | BOOLEAN | | สถานะการใช้งาน | + +* **Foreign Keys (FK):** + * role\_id \-> organization\_roles(id) (ON DELETE SET NULL) +* **Unique Keys (UK):** ux\_organizations\_code (organization\_code) + +#### **1.3. projects** + +ตาราง Master เก็บข้อมูลโครงการ (เช่น LCBP3C1, LCBP3C2) + +| Column | Type | Key | Description | +| :--- | :--- | :--- | :--- | +| id | INT | **PK** | ID ของตาราง | +| project\_code | VARCHAR(50) | UK | รหัสโครงการ | +| project\_name | VARCHAR(255) | | ชื่อโครงการ | +| parent\_project\_id | INT | FK | รหัสโครงการหลัก (ถ้ามี) (FK \-> projects(id)) | +| contractor\_organization\_id | INT | FK | รหัสองค์กรผู้รับเหมา (ถ้ามี) (FK \-> organizations(id)) | +| is\_active | TINYINT(1) | | สถานะการใช้งาน | + +* **Foreign Keys (FK):** + * parent\_project\_id \-> projects(id) (ON DELETE SET NULL) + * contractor\_organization\_id \-> organizations(id) (ON DELETE SET NULL) +* **Unique Keys (UK):** uq\_pro\_code (project\_code) + +#### **1.4. contracts** + +ตาราง Master เก็บข้อมูลสัญญา + +| Column | Type | Key | Description | +| :--- | :--- | :--- | :--- | +| id | INT | **PK** | ID ของตาราง | +| contract\_code | VARCHAR(50) | UK | รหัสสัญญา | +| contract\_name | VARCHAR(255) | | ชื่อสัญญา | +| description | TEXT | | คำอธิบายสัญญา | + +* **Unique Keys (UK):** ux\_contracts\_code (contract\_code) + +#### **1.5. project\_parties (ตารางเชื่อม)** + +ตารางเชื่อมความสัมพันธ์ระหว่าง โครงการ, องค์กร, และบทบาท (M:N) + +| Column | Type | Key | Description | +| :--- | :--- | :--- | :--- | +| project\_id | INT | **PK**, FK | ID ของโครงการ (FK \-> projects(id)) | +| organization\_id | INT | **PK**, FK | ID ขององค์กร (FK \-> organizations(id)) | +| role | ENUM(...) | **PK** | บทบาทในโครงการ (OWNER, DESIGNER, CONSULTANT, CONTRACTOR, THIRD\_PARTY) | +| is\_contractor | TINYINT(1) | UK | (Generated) \= 1 ถ้า role \= 'CONTRACTOR' | +| deleted\_at | DATETIME | | สำหรับ Soft Delete | + +* **Foreign Keys (FK):** + * project\_id \-> projects(id) (ON DELETE CASCADE) + * organization\_id \-> organizations(id) (ON DELETE RESTRICT) +* **Unique Keys (UK):** + * uq\_project\_parties\_contractor (project\_id, is\_contractor) \- **(Constraint สำคัญ)** บังคับว่า 1 โครงการมี CONTRACTOR ได้เพียง 1 องค์กร + +#### **1.6. contract\_parties (ตารางเชื่อม)** + +ตารางเชื่อมความสัมพันธ์ระหว่าง สัญญา, โครงการ, และองค์กร (M:N) + +| Column | Type | Key | Description | +| :--- | :--- | :--- | :--- | +| contract\_id | INT | **PK**, FK | ID ของสัญญา (FK \-> contracts(id)) | +| project\_id | INT | **PK**, FK | ID ของโครงการ (FK \-> projects(id)) | +| organization\_id | INT | **PK**, FK | ID ขององค์กร (FK \-> organizations(id)) | + +* **Foreign Keys (FK):** + * contract\_id \-> contracts(id) (ON DELETE CASCADE) + * project\_id \-> projects(id) (ON DELETE CASCADE) + * organization\_id \-> organizations(id) (ON DELETE CASCADE) + +--- + +## **2\. 👥 Users & RBAC (ผู้ใช้, สิทธิ์, บทบาท)** + +#### **2.1. users** + +ตาราง Master เก็บข้อมูลผู้ใช้งาน (User) + +| Column | Type | Key | Description | +| :--- | :--- | :--- | :--- | +| user\_id | INT | **PK** | ID ของตาราง | +| username | VARCHAR(50) | UK | ชื่อผู้ใช้งาน | +| password\_hash | VARCHAR(255) | | รหัสผ่าน (Hashed) | +| first\_name | VARCHAR(50) | | ชื่อจริง | +| last\_name | VARCHAR(50) | | นามสกุล | +| email | VARCHAR(100) | UK | อีเมล | +| organization\_id | INT | FK | สังกัดองค์กร (FK \-> organizations(id)) | +| is\_active | TINYINT(1) | | สถานะการใช้งาน | + +* **Foreign Keys (FK):** + * organization\_id \-> organizations(id) (ON DELETE SET NULL) +* **Unique Keys (UK):** ux\_users\_username (username), ux\_users\_email (email) + +#### **2.2. roles** + +ตาราง Master เก็บ "บทบาท" ของผู้ใช้ในระบบ (เช่น SUPER\_ADMIN, ADMIN, EDITOR) + +| Column | Type | Key | Description | +| :--- | :--- | :--- | :--- | +| role\_id | INT | **PK** | ID ของตาราง | +| role\_code | VARCHAR(50) | UK | รหัสบทบาท (เช่น SUPER\_ADMIN, ADMIN, EDITOR, VIEWER) | +| role\_name | VARCHAR(100) | | ชื่อบทบาท | +| is\_system | BOOLEAN | | (1 \= บทบาทของระบบ ลบไม่ได้) | + +* **Unique Keys (UK):** role\_code + +#### **2.3. permissions** + +ตาราง Master เก็บ "สิทธิ์" (Permission) หรือ "การกระทำ" ทั้งหมดในระบบ + +| Column | Type | Key | Description | +| :--- | :--- | :--- | :--- | +| permission\_id | INT | **PK** | ID ของตาราง | +| permission\_code | VARCHAR(100) | UK | รหัสสิทธิ์ (เช่น rfas.create, rfas.view) | +| module | VARCHAR(50) | | โมดูลที่เกี่ยวข้อง | +| scope\_level | ENUM(...) | | ระดับของสิทธิ์ (GLOBAL, ORG, PROJECT) | + +* **Unique Keys (UK):** ux\_permissions\_code (permission\_code) + +#### **2.4. role\_permissions (ตารางเชื่อม)** + +ตารางเชื่อมระหว่าง roles และ permissions (M:N) + +| Column | Type | Key | Description | +| :--- | :--- | :--- | :--- | +| role\_id | INT | **PK**, FK | ID ของบทบาท (FK \-> roles(role\_id)) | +| permission\_id | INT | **PK**, FK | ID ของสิทธิ์ (FK \-> permissions(permission\_id)) | + +* **Foreign Keys (FK):** + * role\_id \-> roles(role\_id) (ON DELETE CASCADE) + * permission\_id \-> permissions(permission\_id) (ON DELETE CASCADE) + +#### **2.5. user\_roles (ตารางเชื่อม)** + +ตารางเชื่อมผู้ใช้ (users) กับบทบาท (roles) ในระดับ **Global** (M:N) + +| Column | Type | Key | Description | +| :--- | :--- | :--- | :--- | +| user\_id | INT | **PK**, FK | ID ของผู้ใช้ (FK \-> users(user\_id)) | +| role\_id | INT | **PK**, FK | ID ของบทบาท (FK \-> roles(role\_id)) | + +* **Foreign Keys (FK):** + * user\_id \-> users(user\_id) (ON DELETE CASCADE) + * role\_id \-> roles(role\_id) (ON DELETE CASCADE) + +#### **2.6. user\_project\_roles (ตารางเชื่อม)** + +ตารางเชื่อมผู้ใช้ (users) กับบทบาท (roles) ในระดับ **Project-Specific** (M:N) + +| Column | Type | Key | Description | +| :--- | :--- | :--- | :--- | +| user\_id | INT | **PK**, FK | ID ของผู้ใช้ (FK \-> users(user\_id)) | +| project\_id | INT | **PK**, FK | ID ของโครงการ (FK \-> projects(id)) | +| role\_id | INT | **PK**, FK | ID ของบทบาท (FK \-> roles(role\_id)) | + +* **Foreign Keys (FK):** + * user\_id \-> users(user\_id) (ON DELETE CASCADE) + * project\_id \-> projects(id) (ON DELETE CASCADE) + * role\_id \-> roles(role\_id) (ON DELETE CASCADE) + +--- + +## **3\. ✉️ Correspondences (เอกสารหลัก, Revisions)** + +#### **3.1. correspondence\_types** + +ตาราง Master เก็บประเภทเอกสารโต้ตอบ (เช่น RFA, RFI, LETTER, MOM) + +| Column | Type | Key | Description | +| :--- | :--- | :--- | :--- | +| id | INT | **PK** | ID ของตาราง | +| type\_code | VARCHAR(50) | UK | รหัสประเภท (เช่น RFA, RFI) | +| type\_name | VARCHAR(255) | | ชื่อประเภท | + +* **Unique Keys (UK):** type\_code + +#### **3.2. correspondence\_status** + +ตาราง Master เก็บสถานะของเอกสาร (เช่น DRAFT, SUBMITTED, CLOSED) + +| Column | Type | Key | Description | +| :--- | :--- | :--- | :--- | +| id | INT | **PK** | ID ของตาราง | +| status\_code | VARCHAR(50) | UK | รหัสสถานะ (เช่น DRAFT, SUBOWN) | +| status\_name | VARCHAR(255) | | ชื่อสถานะ | + +* **Unique Keys (UK):** status\_code + +#### **3.3. correspondences (Master)** + +ตาราง "แม่" ของเอกสารโต้ตอบ เก็บข้อมูลที่ไม่เปลี่ยนแปลงตาม Revision (เช่น เลขที่เอกสาร) + +| Column | Type | Key | Description | +| :--- | :--- | :--- | :--- | +| id | INT | **PK** | ID ของตาราง (นี่คือ "Master ID" ที่ใช้เชื่อมโยง) | +| correspondence\_number | VARCHAR(100) | UK | เลขที่เอกสาร (สร้างจาก DocumentNumberingModule) | +| correspondence\_type\_id | INT | FK | ประเภทเอกสาร (FK \-> correspondence\_types(id)) | +| is\_internal\_communication | TINYINT(1) | | (1 \= ภายใน, 0 \= ภายนอก) | +| project\_id | INT | FK | อยู่ในโครงการ (FK \-> projects(id)) | +| originator\_id | INT | FK | องค์กรผู้ส่ง (FK \-> organizations(id)) | +| recipient\_id | INT | FK | องค์กรผู้รับ (FK \-> organizations(id)) | +| created\_by | INT | FK | ผู้สร้าง (FK \-> users(user\_id)) | +| deleted\_at | DATETIME | | สำหรับ Soft Delete | + +* **Foreign Keys (FK):** + * correspondence\_type\_id \-> correspondence\_types(id) (ON DELETE RESTRICT) + * project\_id \-> projects(id) (ON DELETE CASCADE) + * originator\_id \-> organizations(id) (ON DELETE SET NULL) + * recipient\_id \-> organizations(id) (ON DELETE SET NULL) + * created\_by \-> users(user\_id) (ON DELETE SET NULL) +* **Unique Keys (UK):** uq\_corr\_no\_per\_project (project\_id, correspondence\_number) + +#### **3.4. correspondence\_revisions (Revisions)** + +ตาราง "ลูก" เก็บประวัติการแก้ไข (Revisions) ของ correspondences (1:N) **(ปรับปรุง V1.2.0)** + +| Column | Type | Key | Description | +| :--- | :--- | :--- | :--- | +| id | INT | **PK** | **ID ของ Revision** | +| correspondence\_id | INT | FK, UK | Master ID (FK \-> correspondences(id)) | +| revision\_number | INT | UK | หมายเลข Revision (0, 1, 2...) | +| **revision\_label** | **VARCHAR(10)** | | **(ใหม่)** Revision ที่แสดง (เช่น A, B, 1.1) | +| is\_current | BOOLEAN | UK | (1 \= Revision ปัจจุบัน) | +| correspondence\_status\_id | INT | FK | สถานะของ Revision นี้ (FK \-> correspondence\_status(id)) | +| title | VARCHAR(255) | | เรื่อง | +| document\_date | DATE | | วันที่ในเอกสาร | +| issued\_date | DATETIME | | วันที่ออกเอกสาร | +| received\_date | DATETIME | | วันที่ลงรับ | +| **description** | **TEXT** | | **(ใหม่)** คำอธิบายการแก้ไขใน Revision นี้ | +| details | JSON | | ข้อมูลเฉพาะ (เช่น RFI details) | +| **created\_at** | **DATETIME** | | **(ใหม่)** วันที่สร้างเอกสาร | +| created\_by | INT | FK | ผู้สร้าง (FK \-> users(user\_id)) | +| **updated\_by** | **INT** | **FK** | **(ใหม่)** ผู้แก้ไขล่าสุด (FK \-> users(user\_id)) | + +* **Foreign Keys (FK):** + * correspondence\_id \-> correspondences(id) (ON DELETE CASCADE) + * correspondence\_status\_id \-> correspondence\_status(id) (ON DELETE RESTRICT) + * created\_by \-> users(user\_id) (ON DELETE SET NULL) + * **updated\_by \-> users(user\_id) (ON DELETE SET NULL)** +* **Unique Keys (UK):** + * uq\_master\_revision\_number (correspondence\_id, revision\_number) (ป้องกัน Rev ซ้ำใน Master เดียว) + * uq\_master\_current (correspondence\_id, is\_current) (ป้องกันการมี is\_current \= TRUE ซ้ำใน Master เดียว) +* **Check Constraints (CHK):** chk\_rev\_format (ตรวจสอบรูปแบบ revision\_label) + +#### **3.5. correspondence\_recipients (ตารางเชื่อม)** + +ตารางเชื่อมผู้รับ (TO/CC) สำหรับเอกสารแต่ละฉบับ (M:N) + +| Column | Type | Key | Description | +| :--- | :--- | :--- | :--- | +| correspondence\_id | INT | **PK**, FK | ID ของเอกสาร (FK \-> correspondence\_revisions(correspondence\_id)) | +| recipient\_organization\_id | INT | **PK**, FK | ID องค์กรผู้รับ (FK \-> organizations(id)) | +| recipient\_type | ENUM('TO', 'CC') | **PK** | ประเภทผู้รับ (TO หรือ CC) | + +* **Foreign Keys (FK):** + * correspondence\_id \-> correspondence\_revisions(correspondence\_id) (ON DELETE CASCADE) + * recipient\_organization\_id \-> organizations(id) (ON DELETE RESTRICT) + +#### **3.6. correspondence\_references (ตารางเชื่อม)** + +ตารางเชื่อมการอ้างอิงระหว่างเอกสาร (M:N) + +| Column | Type | Key | Description | +| :--- | :--- | :--- | :--- | +| src\_correspondence\_id | INT | **PK**, FK | ID เอกสารต้นทาง (FK \-> correspondences(id)) | +| tgt\_correspondence\_id | INT | **PK**, FK | ID เอกสารเป้าหมาย (FK \-> correspondences(id)) | + +* **Foreign Keys (FK):** + * src\_correspondence\_id \-> correspondences(id) (ON DELETE CASCADE) + * tgt\_correspondence\_id \-> correspondences(id) (ON DELETE CASCADE) + +#### **3.7. correspondence\_routing\_templates / ...\_steps / ...\_routings** + +ตารางที่เกี่ยวข้องกับ Workflow การส่งต่อเอกสาร (Req 3.5.4) + +* **correspondence\_routing\_templates:** ตาราง Master เก็บแม่แบบสายงาน (เช่น "ส่งให้ CSC ตรวจสอบ") +* **correspondence\_routing\_template\_steps:** ตารางลูก เก็บขั้นตอนในแม่แบบ (เช่น Step 1: ส่งไป Org A, Step 2: ส่งไป Org B) +* **correspondence\_routings:** ตารางประวัติ (Log) การส่งต่อของเอกสารจริงตาม Workflow + +--- + +## **4\. approval: RFA (เอกสารขออนุมัติ, Workflows)** + +#### **4.1. rfa\_types / ...\_status\_codes / ...\_approve\_codes** + +ตาราง Master สำหรับ RFA + +* **rfa\_types:** ประเภท RFA (เช่น DWG, DOC, MAT) +* **rfa\_status\_codes:** สถานะ RFA (เช่น DFT \- Draft, FAP \- For Approve) +* **rfa\_approve\_codes:** รหัสผลการอนุมัติ (เช่น 1A \- Approved, 3R \- Revise and Resubmit) + +#### **4.2. rfas (Master)** + +ตาราง "แม่" ของ RFA (มีความสัมพันธ์ 1:N กับ rfa\_revisions) + +| Column | Type | Key | Description | +| :--- | :--- | :--- | :--- | +| id | INT | **PK** | ID ของตาราง (RFA Master ID) | +| rfa\_type\_id | INT | FK | ประเภท RFA (FK \-> rfa\_types(id)) | +| revision\_number | INT | | หมายเลข Revision ล่าสุด (ข้อมูลนี้ถูกย้ายไป rfa\_revisions) | +| created\_by | INT | FK | ผู้สร้าง (FK \-> users(user\_id)) | +| deleted\_at | DATETIME | | สำหรับ Soft Delete | + +* **Foreign Keys (FK):** + * rfa\_type\_id \-> rfa\_types(id) + * created\_by \-> users(user\_id) (ON DELETE SET NULL) + +#### **4.3. rfa\_revisions (Revisions)** + +ตาราง "ลูก" เก็บประวัติ (Revisions) ของ rfas (1:N) **(ปรับปรุง V1.2.0)** + +| Column | Type | Key | Description | +| :--- | :--- | :--- | :--- | +| id | INT | **PK** | **ID ของ Revision** | +| correspondence\_id | INT | FK | Master ID ของ Correspondence (FK \-> correspondences(id)) | +| rfa\_id | INT | FK, UK | Master ID ของ RFA (FK \-> rfas(id)) | +| revision\_number | INT | UK | หมายเลข Revision (0, 1, 2...) | +| **revision\_label** | **VARCHAR(10)** | | **(ใหม่)** Revision ที่แสดง (เช่น A, B, 1.1) | +| is\_current | BOOLEAN | UK | (1 \= Revision ปัจจุบัน) | +| rfa\_status\_code\_id | INT | FK | สถานะ RFA (FK \-> rfa\_status\_codes(id)) | +| rfa\_approve\_code\_id | INT | FK | ผลการอนุมัติ (FK \-> rfa\_approve\_codes(id)) | +| title | VARCHAR(255) | | เรื่อง | +| **document\_date** | **DATE** | | **(ใหม่)** วันที่ในเอกสาร | +| **issued\_date** | **DATE** | | **(ใหม่)** วันที่ส่งขออนุมัติ | +| **received\_date** | **DATETIME** | | **(ใหม่)** วันที่ลงรับเอกสาร | +| **approved\_date** | **DATE** | | **(ใหม่)** วันที่อนุมัติ | +| **description** | **TEXT** | | **(ใหม่)** คำอธิบายการแก้ไขใน Revision นี้ | +| **created\_at** | **DATETIME** | | **(ใหม่)** วันที่สร้างเอกสาร | +| created\_by | INT | FK | ผู้สร้าง (FK \-> users(user\_id)) | +| **updated\_by** | **INT** | **FK** | **(ใหม่)** ผู้แก้ไขล่าสุด (FK \-> users(user\_id)) | + +* **Foreign Keys (FK):** + * correspondence\_id \-> correspondences(id) (ON DELETE CASCADE) + * rfa\_id \-> rfas(id) (ON DELETE CASCADE) + * rfa\_status\_code\_id \-> rfa\_status\_codes(id) + * rfa\_approve\_code\_id \-> rfa\_approve\_codes(id) (ON DELETE SET NULL) + * created\_by \-> users(user\_id) (ON DELETE SET NULL) + * **updated\_by \-> users(user\_id) (ON DELETE SET NULL)** +* **Unique Keys (UK):** + * uq\_rr\_rev\_number (rfa\_id, revision\_number) (ป้องกัน Rev ซ้ำใน Master เดียว) + * uq\_rr\_current (rfa\_id, is\_current) (ป้องกัน is\_current=TRUE ซ้ำใน Master เดียว) + +#### **4.4. rfa\_items (ตารางเชื่อม)** + +ตารางเชื่อมระหว่าง rfa\_revisions (ที่เป็นประเภท DWG) กับ shop\_drawing\_revisions (M:N) + +| Column | Type | Key | Description | +| :--- | :--- | :--- | :--- | +| rfarev\_correspondence\_id | INT | **PK**, FK | ID ของ RFA Revision (FK \-> rfa\_revisions(correspondence\_id)) | +| shop\_drawing\_revision\_id | INT | **PK**, UK, FK | ID ของ Shop Drawing Revision (FK \-> shop\_drawing\_revisions(id)) | + +* **Foreign Keys (FK):** + * rfarev\_correspondence\_id \-> rfa\_revisions(correspondence\_id) (ON DELETE CASCADE) + * shop\_drawing\_revision\_id \-> shop\_drawing\_revisions(id) (ON DELETE CASCADE) + +#### **4.5. rfa\_workflow\_templates / ...\_steps / ...\_workflows** + +ตารางที่เกี่ยวข้องกับ Workflow การอนุมัติ RFA + +* **rfa\_workflow\_templates:** ตาราง Master เก็บแม่แบบสายอนุมัติ (เช่น "สายอนุมัติ 3 ขั้นตอน") +* **rfa\_workflow\_template\_steps:** ตารางลูก เก็บขั้นตอนในแม่แบบ (เช่น Step 1: Org A (Review), Step 2: Org B (Approve)) +* **rfa\_workflows:** ตารางประวัติ (Log) การอนุมัติของ RFA จริงตามสายงาน + +--- + +## **5\. 📐 Drawings (แบบ, หมวดหมู่)** + +#### **5.1. contract\_drawing\_volumes / ...\_cats / ...\_sub\_cats** + +ตาราง Master สำหรับ "แบบคู่สัญญา" (Contract Drawings) + +* **contract\_drawing\_volumes:** เก็บ "เล่ม" ของแบบ +* **contract\_drawing\_cats:** เก็บ "หมวดหมู่หลัก" ของแบบ +* **contract\_drawing\_sub\_cats:** เก็บ "หมวดหมู่ย่อย" ของแบบ + +#### **5.2. contract\_drawing\_subcat\_cat\_maps (ตารางเชื่อม - ใหม่)** + +**(ใหม่)** ตารางเชื่อมระหว่าง หมวดหมู่หลัก-ย่อย (M:N) + +| Column | Type | Key | Description | +| :--- | :--- | :--- | :--- | +| project\_id | INT | **PK**, FK | ID ของโครงการ | +| sub\_cat\_id | INT | **PK**, FK | ID ของหมวดหมู่ย่อย | +| cat\_id | INT | **PK**, FK | ID ของหมวดหมู่หลัก | + +* **Foreign Keys (FK) (ตามเจตนา):** + * (project\_id, sub\_cat\_id) \-> contract\_drawing\_sub\_cats(project\_id, id) + * (project\_id, cat\_id) \-> contract\_drawing\_cats(project\_id, id) +* **Unique Keys (UK):** + * ux\_map\_unique (project\_id, sub\_cat\_id, cat\_id) +* ***ข้อสังเกตจาก DBA:*** *สคริปต์ SQL (1.3.6) มีการอ้างอิง FK ไปยังตารางและคอลัมน์ (`contract_dwg_sub_cat(project_id, sub_cat_id)`) ที่ไม่มีอยู่จริง ตารางนี้แสดงตามเจตนาที่ถูกต้อง* + +#### **5.3. contract\_drawings (Master)** + +ตาราง Master เก็บข้อมูล "แบบคู่สัญญา" + +| Column | Type | Key | Description | +| :--- | :--- | :--- | :--- | +| id | INT | **PK** | ID ของตาราง | +| project\_id | INT | FK, UK | โครงการ (FK \-> projects(id)) | +| condwg\_no | VARCHAR(255) | UK | เลขที่แบบสัญญา | +| title | VARCHAR(255) | | ชื่อแบบ | +| sub\_cat\_id | INT | FK | หมวดหมู่ย่อย (FK \-> contract\_drawing\_sub\_cats(id)) | +| volume\_id | INT | FK | เล่ม (FK \-> contract\_drawing\_volumes(id)) | + +* **Foreign Keys (FK):** + * fk\_condwg\_project (project\_id) \-> projects(id) (ON DELETE CASCADE) + * fk\_condwg\_subcat\_same\_project (project\_id, sub\_cat\_id) \-> contract\_drawing\_sub\_cats(project\_id, id) + * fk\_condwg\_volume\_same\_project (project\_id, volume\_id) \-> contract\_drawing\_volumes(project\_id, id) +* **Unique Keys (UK):** ux\_condwg\_no\_project (project\_id, condwg\_no) + +#### **5.4. shop\_drawing\_main\_categories / ...\_sub\_categories** + +ตาราง Master สำหรับ "แบบก่อสร้าง" (Shop Drawings) + +* **shop\_drawing\_main\_categories:** เก็บ "หมวดหมู่หลัก" (เช่น ARCH, STR) +* **shop\_drawing\_sub\_categories:** เก็บ "หมวดหมู่ย่อย" (เช่น STR-COLUMN) + +#### **5.5. shop\_drawings (Master)** + +ตาราง Master เก็บข้อมูล "แบบก่อสร้าง" + +| Column | Type | Key | Description | +| :--- | :--- | :--- | :--- | +| id | INT | **PK** | ID ของตาราง | +| project\_id | INT | FK | โครงการ (FK \-> projects(id)) | +| drawing\_number | VARCHAR(100) | UK | เลขที่ Shop Drawing | +| title | VARCHAR(500) | | ชื่อแบบ | +| main\_category\_id | INT | FK | หมวดหมู่หลัก (FK \-> shop\_drawing\_main\_categories(id)) | +| sub\_category\_id | INT | FK | หมวดหมู่ย่อย (FK \-> shop\_drawing\_sub\_categories(id)) | + +* **Foreign Keys (FK):** project\_id, main\_category\_id, sub\_category\_id +* **Unique Keys (UK):** ux\_sd\_drawing\_number (drawing\_number) + +#### **5.6. shop\_drawing\_revisions (Revisions)** + +ตาราง "ลูก" เก็บประวัติ (Revisions) ของ shop\_drawings (1:N) + +| Column | Type | Key | Description | +| :--- | :--- | :--- | :--- | +| id | INT | **PK** | ID ของ Revision | +| shop\_drawing\_id | INT | FK, UK | Master ID (FK \-> shop\_drawings(id)) | +| revision\_number | VARCHAR(10) | UK | หมายเลข Revision (เช่น A, B, 0, 1) | +| revision\_date | DATE | | วันที่ของ Revision | +| description | TEXT | | คำอธิบายการแก้ไข | + +* **Foreign Keys (FK):** + * shop\_drawing\_id \-> shop\_drawings(id) (ON DELETE CASCADE) +* **Unique Keys (UK):** ux\_sd\_rev\_drawing\_revision (shop\_drawing\_id, revision\_number) + +#### **5.7. shop\_drawing\_revision\_contract\_refs (ตารางเชื่อม)** + +ตารางเชื่อมระหว่าง shop\_drawing\_revisions กับ contract\_drawings (M:N) + +| Column | Type | Key | Description | +| :--- | :--- | :--- | :--- | +| shop\_drawing\_revision\_id | INT | FK | ID ของ Shop Drawing Revision (FK \-> shop\_drawing\_revisions(id)) | +| contract\_drawing\_id | INT | FK | ID ของ Contract Drawing (FK \-> contract\_drawings(id)) | + +* **Foreign Keys (FK):** shop\_drawing\_revision\_id, contract\_drawing\_id + +--- + +## **6\. 🔄 Circulations (ใบเวียนภายใน)** + +#### **6.1. circulation\_status\_codes** + +ตาราง Master เก็บสถานะใบเวียน (เช่น OPEN, IN\_REVIEW, COMPLETED) + +#### **6.2. circulations (Master)** + +ตาราง "แม่" ของใบเวียนเอกสารภายใน + +| Column | Type | Key | Description | +| :--- | :--- | :--- | :--- | +| id | INT | **PK** | ID ของตาราง | +| correspondence\_id | INT | UK, FK | เอกสารที่ใช้อ้างอิง (FK \-> correspondences(id)) | +| organization\_id | INT | FK, UK | องค์กรเจ้าของใบเวียน (FK \-> organizations(id)) | +| circulation\_no | VARCHAR(100) | UK | เลขที่ใบเวียน | +| circulation\_subject | VARCHAR(500) | | เรื่อง | +| circulation\_status\_code | VARCHAR(20) | FK | สถานะใบเวียน (FK \-> circulation\_status\_codes(code)) | +| created\_by\_user\_id | INT | FK | ผู้สร้าง (FK \-> users(user\_id)) | + +* **Foreign Keys (FK):** correspondence\_id, organization\_id, circulation\_status\_code, created\_by\_user\_id +* **Unique Keys (UK):** + * correspondence\_id (1 ใบเวียน ต่อ 1 เอกสาร) + * uq\_cir\_org\_no (organization\_id, circulation\_no) (เลขที่ใบเวียนห้ามซ้ำในองค์กร) + +#### **6.3. circulation\_recipients / ...\_assignees / ...\_actions** + +ตาราง "ลูก" ของ circulations + +* **circulation\_recipients:** รายชื่อผู้รับ (TO/CC) ภายในองค์กร +* **circulation\_assignees:** รายชื่อผู้รับผิดชอบ (MAIN, ACTION, INFO) และเก็บ deadline +* **circulation\_actions:** ประวัติการดำเนินการ (เช่น Comment, Forward, Close) +* **circulation\_action\_documents:** ตารางเชื่อม circulation\_actions กับ attachments (ไฟล์แนบระหว่างดำเนินการ) + +#### **6.4. circulation\_templates / ...\_assignees** + +ตารางสำหรับแม่แบบใบเวียน (Templates) + +* **circulation\_templates:** ตาราง Master เก็บแม่แบบใบเวียน +* **circulation\_template\_assignees:** ตารางลูก เก็บผู้รับผิดชอบที่กำหนดไว้ล่วงหน้าในแม่แบบ + +--- + +## **7\. 📤 Transmittals (เอกสารนำส่ง)** + +#### **7.1. transmittals** + +ตารางข้อมูลเฉพาะของเอกสารนำส่ง (เป็นตารางลูก 1:1 ของ correspondences) + +| Column | Type | Key | Description | +| :--- | :--- | :--- | :--- | +| correspondence\_id | INT | **PK**, FK | ID ของเอกสาร (FK \-> correspondences(id)) | +| purpose | ENUM(...) | | วัตถุประสงค์ (FOR\_APPROVAL, FOR\_INFORMATION, ...) | +| remarks | TEXT | | หมายเหตุ | + +* **Foreign Keys (FK):** correspondence\_id \-> correspondences(id) (ON DELETE CASCADE) + +#### **7.2. transmittal\_items (ตารางเชื่อม)** + +ตารางเชื่อมระหว่าง transmittals และเอกสารที่นำส่ง (M:N) **(ปรับปรุง V1.2.0)** + +| Column | Type | Key | Description | +| :--- | :--- | :--- | :--- | +| **id** | **INT** | **PK** | **(ใหม่)** ID ของรายการ | +| transmittal\_id | INT | **FK**, UK | ID ของ Transmittal (FK \-> transmittals(correspondence\_id)) | +| **item\_correspondence\_id** | **INT** | **FK**, UK | **(เปลี่ยน)** ID ของเอกสารที่แนบไป (FK \-> correspondences(id)) | +| **quantity** | **INT** | | **(ใหม่)** จำนวน | +| **remarks** | **VARCHAR(255)** | | **(ใหม่)** หมายเหตุสำหรับรายการนี้ | + +* **Foreign Keys (FK):** + * transmittal\_id \-> transmittals(correspondence\_id) (ON DELETE CASCADE) + * **item\_correspondence\_id \-> correspondences(id) (ON DELETE CASCADE)** +* **Unique Keys (UK):** ux\_transmittal\_item (transmittal\_id, item\_correspondence\_id) + +--- + +## **8\. 📎 File Management (ไฟล์แนบ)** + +#### **8.1. attachments (Master)** + +ตาราง "กลาง" เก็บไฟล์แนบทั้งหมดของระบบ + +| Column | Type | Key | Description | +| :--- | :--- | :--- | :--- | +| id | INT | **PK** | ID ของไฟล์แนบ | +| original\_filename | VARCHAR(255) | | ชื่อไฟล์ดั้งเดิม | +| stored\_filename | VARCHAR(255) | | ชื่อไฟล์ที่เก็บจริง (ป้องกันซ้ำ) | +| file\_path | VARCHAR(500) | | Path ที่เก็บไฟล์ (บน QNAP /share/dms-data/) | +| mime\_type | VARCHAR(100) | | ประเภทไฟล์ (เช่น application/pdf) | +| file\_size | INT | | ขนาดไฟล์ (bytes) | +| uploaded\_by\_user\_id | INT | FK | ผู้อัปโหลด (FK \-> users(user\_id)) | + +* **Foreign Keys (FK):** uploaded\_by\_user\_id \-> users(user\_id) (ON DELETE CASCADE) + +#### **8.2. correspondence\_attachments (ตารางเชื่อม - ใหม่)** + +ตารางเชื่อม correspondences กับ attachments (M:N) + +| Column | Type | Key | Description | +| :--- | :--- | :--- | :--- | +| correspondence\_id | INT | **PK**, FK | ID ของเอกสาร (FK \-> correspondences(id)) | +| attachment\_id | INT | **PK**, FK | ID ของไฟล์แนบ (FK \-> attachments(id)) | +| is\_main\_document | BOOLEAN | | (1 \= ไฟล์หลัก) | + +* **Foreign Keys (FK):** correspondence\_id, attachment\_id + +#### **8.3. circulation\_attachments (ตารางเชื่อม - ใหม่)** + +ตารางเชื่อม circulations กับ attachments (M:N) + +| Column | Type | Key | Description | +| :--- | :--- | :--- | :--- | +| circulation\_id | INT | **PK**, FK | ID ของใบเวียน (FK \-> circulations(id)) | +| attachment\_id | INT | **PK**, FK | ID ของไฟล์แนบ (FK \-> attachments(id)) | +| is\_main\_document | BOOLEAN | | (1 \= ไฟล์หลัก) | + +* **Foreign Keys (FK):** circulation\_id, attachment\_id + +#### **8.4. shop\_drawing\_revision\_attachments (ตารางเชื่อม - ใหม่)** + +ตารางเชื่อม shop\_drawing\_revisions กับ attachments (M:N) **(ปรับปรุง V1.2.0)** + +| Column | Type | Key | Description | +| :--- | :--- | :--- | :--- | +| shop\_drawing\_revision\_id | INT | **PK**, FK | ID ของ Drawing Revision (FK \-> shop\_drawing\_revisions(id)) | +| attachment\_id | INT | **PK**, FK | ID ของไฟล์แนบ (FK \-> attachments(id)) | +| file\_type | ENUM(...) | | ประเภทไฟล์ (PDF, DWG, SOURCE, OTHER) | +| **is\_main\_document** | **BOOLEAN** | | **(ใหม่)** (1 \= ไฟล์หลัก) | + +* **Foreign Keys (FK):** shop\_drawing\_revision\_id, attachment\_id + +#### **8.5. contract\_drawing\_attachments (ตารางเชื่อม - ใหม่)** + +**(ใหม่)** ตารางเชื่อม contract\_drawings กับ attachments (M:N) + +| Column | Type | Key | Description | +| :--- | :--- | :--- | :--- | +| contract\_drawing\_id | INT | **PK**, FK | ID ของ Contract Drawing (FK \-> contract\_drawings(id)) | +| attachment\_id | INT | **PK**, FK | ID ของไฟล์แนบ (FK \-> attachments(id)) | +| file\_type | ENUM(...) | | ประเภทไฟล์ (PDF, DWG, SOURCE, OTHER) | +| is\_main\_document | BOOLEAN | | (1 \= ไฟล์หลัก) | + +* **Foreign Keys (FK):** + * contract\_drawing\_id \-> contract\_drawings(id) (ON DELETE CASCADE) + * attachment\_id \-> attachments(id) (ON DELETE CASCADE) + +--- + +## **9\. 🔢 Document Numbering (การสร้างเลขที่เอกสาร)** + +#### **9.1. document\_number\_formats (ตารางตั้งค่า - ใหม่)** + +ตาราง Master เก็บ "รูปแบบ" Template ของเลขที่เอกสาร + +| Column | Type | Key | Description | +| :--- | :--- | :--- | :--- | +| id | INT | **PK** | ID ของตาราง | +| project\_id | INT | FK, UK | โครงการ (FK \-> projects(id)) | +| correspondence\_type\_id | INT | FK, UK | ประเภทเอกสาร (FK \-> correspondence\_types(id)) | +| format\_template | VARCHAR(255) | | รูปแบบ Template (เช่น {ORG\_CODE}-{TYPE\_CODE}-{SEQ:4}) | + +* **Foreign Keys (FK):** project\_id, correspondence\_type\_id +* **Unique Keys (UK):** uk\_project\_type (project\_id, correspondence\_type\_id) + +#### **9.2. document\_number\_counters (ตารางตัวนับ - ใหม่)** + +ตารางเก็บ "ตัวนับ" (Running Number) ล่าสุด + +| Column | Type | Key | Description | +| :--- | :--- | :--- | :--- | +| project\_id | INT | **PK**, FK | โครงการ (FK \-> projects(id)) | +| originator\_organization\_id | INT | **PK**, FK | องค์กรผู้ส่ง (FK \-> organizations(id)) | +| correspondence\_type\_id | INT | **PK**, FK | ประเภทเอกสาร (FK \-> correspondence\_types(id)) | +| current\_year | INT | **PK** | ปี ค.ศ. ของตัวนับ | +| last\_number | INT | | เลขที่ล่าสุดที่ใช้ไป | + +* **Foreign Keys (FK):** project\_id, originator\_organization\_id, correspondence\_type\_id + +--- + +## **10\. ⚙️ System & Logs (ระบบและ Log)** + +#### **10.1. tags** + +ตาราง Master เก็บ Tags ทั้งหมดที่ใช้ในระบบ + +| Column | Type | Key | Description | +| :--- | :--- | :--- | :--- | +| id | INT | **PK** | ID ของตาราง | +| tag\_name | VARCHAR(100) | UK | ชื่อ Tag | + +* **Unique Keys (UK):** ux\_tag\_name (tag\_name) + +#### **10.2. correspondence\_tags (ตารางเชื่อม)** + +ตารางเชื่อมระหว่าง correspondences และ tags (M:N) + +| Column | Type | Key | Description | +| :--- | :--- | :--- | :--- | +| correspondence\_id | INT | **PK**, FK | ID ของเอกสาร (FK \-> correspondences(id)) | +| tag\_id | INT | **PK**, FK | ID ของ Tag (FK \-> tags(id)) | + +* **Foreign Keys (FK):** correspondence\_id, tag\_id + +#### **10.3. audit\_logs** + +ตารางเก็บบันทึกการกระทำของผู้ใช้ + +| Column | Type | Key | Description | +| :--- | :--- | :--- | :--- | +| audit\_id | BIGINT | **PK** | ID ของ Log | +| user\_id | INT | FK | ผู้กระทำ (FK \-> users(user\_id)) | +| action | VARCHAR(100) | | การกระทำ (เช่น rfa.create) | +| entity\_type | VARCHAR(50) | | ตาราง/โมดูล (เช่น rfas) | +| entity\_id | VARCHAR(50) | | ID ของสิ่งที่ถูกกระทำ | +| details\_json | JSON | | ข้อมูลเพิ่มเติม | +| ip\_address | VARCHAR(45) | | IP Address | +| created\_at | TIMESTAMP | | เวลาที่กระทำ | + +* **Foreign Keys (FK):** user\_id \-> users(user\_id) (ON DELETE SET NULL) + +#### **10.4. global\_default\_roles (ใหม่)** + +ตารางเก็บค่าเริ่มต้นของบทบาทองค์กร (เช่น OWNER, DESIGNER) + +| Column | Type | Key | Description | +| :--- | :--- | :--- | :--- | +| id | TINYINT | **PK** | ID คงที่ ( \= 1) | +| role | ENUM(...) | **PK** | บทบาท (OWNER, DESIGNER, CONSULTANT) | +| position | TINYINT | **PK** | ลำดับที่ในบทบาท (1..n) | +| organization\_id | INT | FK, UK | ID องค์กร (FK \-> organizations(id)) | + +* **Foreign Keys (FK):** organization\_id \-> organizations(id) (ON DELETE RESTRICT) +* **Unique Keys (UK):** ux\_gdr\_unique\_org\_per\_role (id, role, organization\_id) + +#### **10.5. Workflow Transition Rules (ใหม่)** + +ตารางกำหนด Business Rules สำหรับการเปลี่ยนสถานะ + +* **correspondence\_status\_transitions:** (ใหม่) กฎการเปลี่ยนสถานะของ Correspondences (ทั่วไป) +* **rfa\_status\_transitions:** (ใหม่) กฎการเปลี่ยนสถานะของ RFA +* **circulation\_status\_transitions:** (ใหม่) กฎการเปลี่ยนสถานะของ Circulations (ใบเวียน) + +--- + +## **11\. 📋 Views & Procedures (วิว และ โปรซีเดอร์)** + +#### **11.1. sp\_get\_next\_document\_number (Procedure)** + +**(ใหม่)** Stored Procedure เดียวที่ใช้ในระบบ + +* **หน้าที่:** ดึงเลขที่เอกสารถัดไป (Next Running Number) จากตาราง document\_number\_counters +* **ตรรกะ:** ใช้ `SELECT ... FOR UPDATE` เพื่อ "ล็อก" แถว ป้องกัน Race Condition (การที่ผู้ใช้ 2 คนได้เลขที่ซ้ำกัน) + +#### **11.2. v\_current\_correspondences (View)** + +* **หน้าที่:** แสดง Revision "ปัจจุบัน" (is\_current \= TRUE) ของ correspondences ทั้งหมด (ที่ไม่ใช่ RFA) + +#### **11.3. v\_current\_rfas (View)** + +* **หน้าที่:** แสดง Revision "ปัจจุบัน" (is\_current \= TRUE) ของ rfa\_revisions ทั้งหมด + +#### **11.4. v\_contract\_parties\_all (View)** + +* **หน้าที่:** แสดงความสัมพันธ์ทั้งหมดระหว่าง Contract, Project, และ Organization + +#### **11.5. v\_user\_tasks (View)** + +**(ใหม่)** + +* **หน้าที่:** แสดงรายการ "งานของฉัน" (My Tasks) ที่ยังไม่เสร็จ +* **ตรรกะ:** JOIN ตาราง circulations กับ circulation\_assignees (ที่ is\_completed \= FALSE) + +#### **11.6. v\_audit\_log\_details (View)** + +**(ใหม่)** + +* **หน้าที่:** แสดง audit\_logs พร้อมข้อมูล username และ email ของผู้กระทำ + +#### **11.7. v\_user\_all\_permissions (View)** + +**(ใหม่)** + +* **หน้าที่:** รวมสิทธิ์ทั้งหมด (Global \+ Project) ของผู้ใช้ทุกคน เพื่อให้ Backend ตรวจสอบสิทธิ์ได้ง่าย +* **ตรรกะ:** UNION ข้อมูลจาก user\_roles และ user\_project\_roles \ No newline at end of file diff --git a/docs/Markdown/LCBP3-DMS_V1_2_1_FullStackJS.md b/docs/Markdown/LCBP3-DMS_V1_2_1_FullStackJS.md new file mode 100644 index 0000000..b90cdd2 --- /dev/null +++ b/docs/Markdown/LCBP3-DMS_V1_2_1_FullStackJS.md @@ -0,0 +1,459 @@ +# **Documents Management Sytem Version 1.2.1: แนวทางการพัฒนา FullStackJS** + +## **🧠 ปรัชญาทั่วไป** + +แนวทางปฏิบัติที่ดีที่สุดแบบครบวงจรสำหรับการพัฒนา NestJS Backend, NextJS Frontend และ Tailwind-based UI/UX ในสภาพแวดล้อม TypeScript มุ่งเน้นที่ ความชัดเจน (clarity), ความง่ายในการบำรุงรักษา (maintainability), ความสอดคล้องกัน (consistency) และ การเข้าถึงได้ (accessibility) ตลอดทั้งสแต็ก + +## **⚙️ แนวทางทั่วไปสำหรับ TypeScript** + +### **หลักการพื้นฐาน** + +* ใช้ **ภาษาอังกฤษ** สำหรับโค้ดและเอกสารทั้งหมด +* กำหนดไทป์ (type) อย่างชัดเจนสำหรับตัวแปร, พารามิเตอร์ และค่าที่ส่งกลับ (return values) ทั้งหมด +* หลีกเลี่ยงการใช้ any; ให้สร้างไทป์ (types) หรืออินเทอร์เฟซ (interfaces) ที่กำหนดเอง +* ใช้ **JSDoc** สำหรับคลาส (classes) และเมธอด (methods) ที่เป็น public +* ส่งออก (Export) **สัญลักษณ์หลัก (main symbol) เพียงหนึ่งเดียว** ต่อไฟล์ +* หลีกเลี่ยงบรรทัดว่างภายในฟังก์ชัน + +### **ข้อตกลงในการตั้งชื่อ (Naming Conventions)** + +| Entity (สิ่งที่ตั้งชื่อ) | Convention (รูปแบบ) | Example (ตัวอย่าง) | +| :---- | :---- | :---- | +| Classes | PascalCase | UserService | +| Variables & Functions | camelCase | getUserInfo | +| Files & Folders | kebab-case | user-service.ts | +| Environment Variables | UPPERCASE | DATABASE\URL | +| Booleans | Verb \+ Noun | isActive, canDelete, hasPermission | + +ใช้คำเต็ม — ไม่ใช้อักษรย่อ — ยกเว้นคำมาตรฐาน (เช่น API, URL, req, res, err, ctx) + +## **🧩 ฟังก์ชัน (Functions)** + +* เขียนฟังก์ชันให้สั้น และทำ **หน้าที่เพียงอย่างเดียว** (single-purpose) (\< 20 บรรทัด) +* ใช้ **early returns** เพื่อลดการซ้อน (nesting) ของโค้ด +* ใช้ **map**, **filter**, **reduce** แทนการใช้ loops เมื่อเหมาะสม +* ควรใช้ **arrow functions** สำหรับตรรกะสั้นๆ, และใช้ **named functions** ในกรณีอื่น +* ใช้ **default parameters** แทนการตรวจสอบค่า null +* จัดกลุ่มพารามิเตอร์หลายตัวให้เป็นอ็อบเจกต์เดียว (RO-RO pattern) +* ส่งค่ากลับ (Return) เป็นอ็อบเจกต์ที่มีไทป์กำหนด (typed objects) ไม่ใช่ค่าพื้นฐาน (primitives) +* รักษาระดับของสิ่งที่เป็นนามธรรม (abstraction level) ให้เป็นระดับเดียวในแต่ละฟังก์ชัน + +## **🧱 การจัดการข้อมูล (Data Handling)** + +* ห่อหุ้มข้อมูล (Encapsulate) ในไทป์แบบผสม (composite types) +* ใช้ **immutability** (การไม่เปลี่ยนแปลงค่า) ด้วย readonly และ as const +* ทำการตรวจสอบความถูกต้องของข้อมูล (Validations) ในคลาสหรือ DTOs ไม่ใช่ภายในฟังก์ชันทางธุรกิจ +* ตรวจสอบความถูกต้องของข้อมูลโดยใช้ DTOs ที่มีไทป์กำหนดเสมอ + +## **🧰 คลาส (Classes)** + +* ปฏิบัติตามหลักการ **SOLID** +* ควรใช้ **composition มากกว่า inheritance** (Prefer composition over inheritance) +* กำหนด **interfaces** สำหรับสัญญา (contracts) +* ให้คลาสมุ่งเน้นการทำงานเฉพาะอย่างและมีขนาดเล็ก (\< 200 บรรทัด, \< 10 เมธอด, \< 10 properties) + +## **🚨 การจัดการข้อผิดพลาด (Error Handling)** + +* ใช้ Exceptions สำหรับข้อผิดพลาดที่ไม่คาดคิด +* ดักจับ (Catch) ข้อผิดพลาดเพื่อแก้ไขหรือเพิ่มบริบท (context) เท่านั้น; หากไม่เช่นนั้น ให้ใช้ global error handlers +* ระบุข้อความข้อผิดพลาด (error messages) ที่มีความหมายเสมอ + +## **🧪 การทดสอบ (ทั่วไป) (Testing (General))** + +* ใช้รูปแบบ **Arrange–Act–Assert** +* ใช้ชื่อตัวแปรในการทดสอบที่สื่อความหมาย (inputData, expectedOutput) +* เขียน **unit tests** สำหรับ public methods ทั้งหมด +* จำลอง (Mock) การพึ่งพาภายนอก (external dependencies) +* เพิ่ม **acceptance tests** ต่อโมดูลโดยใช้รูปแบบ Given–When-Then + +# **🏗️ แบ็กเอนด์ (NestJS) (Backend (NestJS))** + +### **หลักการ** + +* **สถาปัตยกรรมแบบโมดูลาร์ (Modular architecture)**: + * หนึ่งโมดูลต่อหนึ่งโดเมน + * โครงสร้างแบบ Controller → Service → Repository (Model) +* DTOs ที่ตรวจสอบความถูกต้องด้วย **class-validator** +* ใช้ **MikroORM** (หรือ TypeORM/Prisma) สำหรับการคงอยู่ของข้อมูล (persistence) ซึ่งสอดคล้องกับสคีมา MariaDB +* ห่อหุ้มโค้ดที่ใช้ซ้ำได้ไว้ใน **common module** (@app/common): + * Configs, decorators, DTOs, guards, interceptors, notifications, shared services, types, validators + +### **ฟังก์ชันหลัก (Core Functionalities)** + +* Global **filters** สำหรับการจัดการ exception +* **Middlewares** สำหรับการจัดการ request +* **Guards** สำหรับการอนุญาต (permissions) และ RBAC +* **Interceptors** สำหรับการแปลงข้อมูล response และการบันทึก log + +### **ข้อจำกัดในการ Deploy (QNAP Container Station)** + +* **ห้ามใช้ไฟล์ .env** ในการตั้งค่า Environment Variables [cite: 2.1] +* การตั้งค่าทั้งหมด (เช่น Database connection string, JWT secret) **จะต้องถูกกำหนดผ่าน Environment Variable ใน docker-compose.yml โดยตรง** [cite: 6.5] ซึ่งจะจัดการผ่าน UI ของ QNAP Container Station [cite: 2.1] + +### **โครงสร้างโมดูลตามโดเมน (Domain-Driven Module Structure)** + +เพื่อให้สอดคล้องกับสคีมา SQL (LCBP3-DMS) เราจะใช้โครงสร้างโมดูลแบบ **Domain-Driven (แบ่งตามขอบเขตธุรกิจ)** แทนการแบ่งตามฟังก์ชัน: + +1. **CoreModule / CommonModule:** + * เก็บ Services ที่ใช้ร่วมกัน เช่น DatabaseModule, FileStorageService (จัดการไฟล์ใน QNAP), AuditLogService, NotificationService + * NotificationService ต้องรองรับ Triggers ที่ระบุใน Requirement 6.7 [cite: 6.7] +2. **AuthModule / UserModule:** + * จัดการ users, roles, permissions และการยืนยันตัวตน (JWT, Guards) + * **(สำคัญ)** ต้องรับผิดชอบการตรวจสอบสิทธิ์ **3 ระดับ** [cite: 4.2]: สิทธิ์ระดับระบบ (Global Role), สิทธิ์ระดับโปรเจกต์ (Project Role), และ **สิทธิ์ระดับสัญญา (Contract Role)** + * **(สำคัญ)** ต้องมี API สำหรับ **Admin Panel** เพื่อ: + * สร้างและจัดการ Role และการจับคู่ Permission แบบไดนามิก [cite: 4.3] + * จัดการ Master Data (เช่น correspondence_types, tags) [cite: 4.5] + * ให้ Superadmin สร้าง Organizations และกำหนด Org Admin ได้ [cite: 4.6] + * ให้ Superadmin/Admin จัดการ document_number_formats (รูปแบบเลขที่เอกสาร) [cite: 3.10] +3. **ProjectModule:** + * จัดการ projects, organizations, contracts, project_parties, contract_parties +4. **CorrespondenceModule (โมดูลศูนย์กลาง):** + * จัดการ correspondences, correspondence\revisions + * **(สำคัญ)** Service นี้ต้อง Inject DocumentNumberingService เพื่อขอเลขที่เอกสารใหม่ก่อนการสร้าง + * **(สำคัญ)** ตรรกะการสร้าง/อัปเดต Revision จะอยู่ใน Service นี้ + * จัดการ correspondence_attachments (ตารางเชื่อมไฟล์แนบ) + * รับผิดชอบเวิร์กโฟลว์ **"Correspondence Routings"** (correspondence\routings) สำหรับการส่งต่อเอกสารทั่วไประหว่างองค์กร +5. **RfaModule:** + * จัดการ rfas, rfa_revisions, rfa_items + * รับผิดชอบเวิร์กโฟลว์ **"RFA Workflows"** (rfa_workflows) สำหรับการอนุมัติเอกสารทางเทคนิค +6. **DrawingModule:** + * จัดการ shop_drawings, shop_drawing_revisions, contract_drawings และหมวดหมู่ต่างๆ + * จัดการ shop_drawing_revision_attachments และ contract_drawing_attachments(ตารางเชื่อมไฟล์แนบ) +7. **CirculationModule:** + * จัดการ circulations, circulation_templates, circulation_assignees + * จัดการ circulation_attachments (ตารางเชื่อมไฟล์แนบ) + * รับผิดชอบเวิร์กโฟลว์ **"Circulations"** สำหรับการเวียนเอกสาร **ภายในองค์กร** +8. **TransmittalModule:** + * จัดการ transmittals และ transmittal_items +9. **SearchModule:** + * ให้บริการค้นหาขั้นสูง (Advanced Search) [cite: 6.2] โดยใช้ **Elasticsearch** เพื่อรองรับการค้นหาแบบ Full-text จากชื่อเรื่อง, รายละเอียด, เลขที่เอกสาร, ประเภท, วันที่, และ Tags +10. **DocumentNumberingModule:** + * **สถานะ:** เป็น Module ภายใน (Internal Module) ไม่เปิด API สู่ภายนอก + * **หน้าที่:** ให้บริการ DocumentNumberingService ที่ Module อื่น (เช่น CorrespondenceModule) จะ Inject ไปใช้งาน + * **ตรรกะ:** รับผิดชอบการสร้างเลขที่เอกสาร โดยการเรียกใช้ Stored Procedure *sp_get_next_document_number** เพื่อป้องกัน Race Condition + +### **เครื่องมือและไลบรารีที่แนะนำ (Recommended Tools & Libraries)** + +🔐 **Authentication & Authorization** + +* @nestjs/passport +* @nestjs/jwt +* casl – สำหรับ RBAC (Role-Based Access Control) + +🗃️ **Database & ORM** + +* @nestjs/typeorm – ORM สำหรับ SQL (หรือ Prisma เป็นทางเลือก) +* typeorm-seeding – สำหรับสร้างข้อมูลจำลอง (seeding) + +📦 **Validation & Transformation** + +* class-validator +* class-transformer + +📁 **File Upload & Storage** + +* @nestjs/platform-express +* multer – สำหรับจัดการไฟล์ + +🔍 **Search** + +* @nestjs/elasticsearch – สำหรับ Full-text search [cite: 6.2] + +📬 **Notification** + +* nodemailer – สำหรับส่งอีเมล +* @nestjs/schedule – สำหรับ cron job หรือแจ้งเตือนตามเวลา + +📊 **Logging & Monitoring** + +* winston หรือ nestjs-pino – ระบบ log ที่ยืดหยุ่น +* @nestjs/terminus – สำหรับ health check + +🧪 **Testing** + +* @nestjs/testing +* jest – สำหรับ unit/integration test + +🌐 **API Documentation** + +* @nestjs/swagger – **(สำคัญมาก)** สร้าง Swagger UI อัตโนมัติ ต้องใช้ DTOs อย่างเคร่งครัดเพื่อความชัดเจนของ API สำหรับทีม Frontend + +🛡️ **Security** + +* helmet – ป้องกันช่องโหว่ HTTP +* rate-limiter-flexible – ป้องกัน brute force + +### **🧪 Backend Testing** + +เราจะแบ่งการทดสอบเป็น 3 ระดับ โดยใช้ **Jest** และ @nestjs/testing: + +* **Unit Tests (การทดสอบหน่วยย่อย):** + * **เป้าหมาย:** ทดสอบ Logic ภายใน Service, Guard, หรือ Pipe โดยจำลอง (Mock) Dependencies ทั้งหมด + * **สิ่งที่ต้องทดสอบ:** Business Logic (เช่น การเปลี่ยนสถานะ Workflow, การตรวจสอบ Deadline) [cite: 2.9.1], ตรรกะการตรวจสอบสิทธิ์ (Auth Guard) ทั้ง 3 ระดับ +* **Integration Tests (การทดสอบการบูรณาการ):** + * **เป้าหมาย:** ทดสอบการทำงานร่วมกันของ Controller -> Service -> Repository (Database) + * **เทคนิค:** ใช้ **Test Database แยกต่างหาก** (ห้ามใช้ Dev DB) และใช้ supertest เพื่อยิง HTTP Request จริงไปยัง App + * **สิ่งที่ต้องทดสอบ:** การเรียก sp\get\next\document\number [cite: 2.9.3] และการทำงานของ Views (เช่น v_user_tasks) +* **E2E (End-to-End) Tests:** + * **เป้าหมาย:** ทดสอบ API Contract ว่า Response Body Shape ตรงตามเอกสาร Swagger เพื่อรับประกันทีม Frontend + +### **🗄️ Backend State Management** + +Backend (NestJS) ควรเป็น **Stateless** (ไม่เก็บสถานะ) "State" ทั้งหมดจะถูกจัดเก็บใน MariaDB + +* **Request-Scoped State (สถานะภายใน Request เดียว):** + * **ปัญหา:** จะส่งต่อข้อมูล (เช่น User ที่ล็อกอิน) ระหว่าง Guard และ Service ใน Request เดียวกันได้อย่างไร? + * **วิธีแก้:** ใช้ **Request-Scoped Providers** ของ NestJS (เช่น AuthContextService) เพื่อเก็บข้อมูล User ปัจจุบันที่ได้จาก AuthGuard และให้ Service อื่น Inject ไปใช้ +* **Application-Scoped State (การ Caching):** + * **ปัญหา:** ข้อมูล Master (เช่น roles, permissions, organizations) ถูกเรียกใช้บ่อย + * **วิธีแก้:** ใช้ **Caching** (เช่น @nestjs/cache-manager) เพื่อ Caching ข้อมูลเหล่านี้ และลดภาระ Database + +# **🖥️ ฟรอนต์เอนด์ (NextJS / React / UI) (Frontend (NextJS / React / UI))** + +### **โปรไฟล์นักพัฒนา (Developer Profile)** + +วิศวกร TypeScript + React/NextJS ระดับ Senior +เชี่ยวชาญ TailwindCSS, Shadcn/UI, และ Radix สำหรับการพัฒนา UI + +### **แนวทางการพัฒนาโค้ด (Code Implementation Guidelines)** + +* ใช้ **early returns** เพื่อความชัดเจน +* ใช้คลาสของ **TailwindCSS** ในการกำหนดสไตล์เสมอ +* ควรใช้ class: syntax แบบมีเงื่อนไข (หรือ utility clsx) มากกว่าการใช้ ternary operators ใน class strings +* ใช้ **const arrow functions** สำหรับ components และ handlers +* Event handlers ให้ขึ้นต้นด้วย handle... (เช่น handleClick, handleSubmit) +* รวมแอตทริบิวต์สำหรับการเข้าถึง (accessibility) ด้วย: + tabIndex="0", aria-label, onKeyDown, ฯลฯ +* ตรวจสอบให้แน่ใจว่าโค้ดทั้งหมด **สมบูรณ์**, **ผ่านการทดสอบ**, และ **ไม่ซ้ำซ้อน (DRY)** +* ต้อง import โมดูลที่จำเป็นต้องใช้อย่างชัดเจนเสมอ + +### **UI/UX ด้วย React** + +* ใช้ **semantic HTML** +* ใช้คลาสของ **Tailwind** ที่รองรับ responsive (sm:, md:, lg:) +* รักษาลำดับชั้นของการมองเห็น (visual hierarchy) ด้วยการใช้ typography และ spacing +* ใช้ **Shadcn** components (Button, Input, Card, ฯลฯ) เพื่อ UI ที่สอดคล้องกัน +* ทำให้ components มีขนาดเล็กและมุ่งเน้นการทำงานเฉพาะอย่าง +* ใช้ utility classes สำหรับการจัดสไตล์อย่างรวดเร็ว (spacing, colors, text, ฯลฯ) +* ตรวจสอบให้แน่ใจว่าสอดคล้องกับ **ARIA** และใช้ semantic markup + +### **การตรวจสอบฟอร์มและข้อผิดพลาด (Form Validation & Errors)** + +* ใช้ไลบรารีฝั่ง client เช่น zod และ react-hook-form +* แสดงข้อผิดพลาดด้วย **alert components** หรือข้อความ inline +* ต้องมี labels, placeholders, และข้อความ feedback + +### **🧪 Frontend Testing** + +เราจะใช้ **React Testing Library (RTL)** สำหรับการทดสอบ Component และ **Playwright** สำหรับ E2E: + +* **Unit Tests (การทดสอบหน่วยย่อย):** + * **เครื่องมือ:** Vitest + RTL + * **เป้าหมาย:** ทดสอบ Component ขนาดเล็ก (เช่น Buttons, Inputs) หรือ Utility functions +* **Integration Tests (การทดสอบการบูรณาการ):** + * **เครื่องมือ:** RTL + **Mock Service Worker (MSW)** + * **เป้าหมาย:** ทดสอบว่า Component หรือ Page ทำงานกับ API (ที่จำลองขึ้น) ได้ถูกต้อง + * **เทคนิค:** ใช้ MSW เพื่อจำลอง NestJS API และทดสอบว่า Component แสดงผลข้อมูลจำลองได้ถูกต้องหรือไม่ (เช่น ทดสอบหน้า Dashboard [cite: 5.3] ที่ดึงข้อมูลจาก v_user_tasks) +* **E2E (End-to-End) Tests:** + * **เครื่องมือ:** **Playwright** + * **เป้าหมาย:** ทดสอบ User Flow ทั้งระบบโดยอัตโนมัติ (เช่น ล็อกอิน -> สร้าง RFA -> ตรวจสอบ Workflow Visualization [cite: 5.6]) + +### **🗄️ Frontend State Management** + +สำหรับ Next.js App Router เราจะแบ่ง State เป็น 4 ระดับ: + +1. **Local UI State (สถานะ UI ชั่วคราว):** + * **เครื่องมือ:** useState, useReducer + * **ใช้เมื่อ:** จัดการสถานะเล็กๆ ที่จบใน Component เดียว (เช่น Modal เปิด/ปิด, ค่าใน Input) +2. **Server State (สถานะข้อมูลจากเซิร์ฟเวอร์):** + * **เครื่องมือ:** **React Query (TanStack Query)** หรือ SWR + * **ใช้เมื่อ:** จัดการข้อมูลที่ดึงมาจาก NestJS API (เช่น รายการ correspondences, rfas, drawings) + * **ทำไม:** React Query เป็น "Cache" ที่จัดการ Caching, Re-fetching, และ Invalidation ให้โดยอัตโนมัติ +3. **Global Client State (สถานะส่วนกลางฝั่ง Client):** + * **เครื่องมือ:** **Zustand** (แนะนำ) หรือ Context API + * **ใช้เมื่อ:** จัดการข้อมูลที่ต้องใช้ร่วมกันทั่วทั้งแอป และ *ไม่ใช่* ข้อมูลจากเซิร์ฟเวอร์ (เช่น ข้อมูล User ที่ล็อกอิน, สิทธิ์ Permissions) +4. **Form State (สถานะของฟอร์ม):** + * **เครื่องมือ:** **React Hook Form** + **Zod** + * **ใช้เมื่อ:** จัดการฟอร์มที่ซับซ้อน (เช่น ฟอร์มสร้าง RFA, ฟอร์ม Circulation [cite: 3.7]) + +# **🔗 แนวทางการบูรณาการ Full Stack (Full Stack Integration Guidelines)** + +| Aspect (แง่มุม) | Backend (NestJS) | Frontend (NextJS) | UI Layer (Tailwind/Shadcn) | +| :---- | :---- | :---- | :---- | +| API | REST / GraphQL Controllers | API hooks ผ่าน fetch/axios/SWR | Components ที่รับข้อมูล | +| Validation (การตรวจสอบ) | class-validator DTOs | zod / react-hook-form | สถานะของฟอร์ม/input ใน Shadcn | +| Auth (การยืนยันตัวตน) | Guards, JWT | NextAuth / cookies | สถานะ UI ของ Auth (loading, signed in) | +| Errors (ข้อผิดพลาด) | Global filters | Toasts / modals | Alerts / ข้อความ feedback | +| Testing (การทดสอบ) | Jest (unit/e2e) | Vitest / Playwright | Visual regression | +| Styles (สไตล์) | Scoped modules (ถ้าจำเป็น) | Tailwind / Shadcn | Tailwind utilities | +| Accessibility (การเข้าถึง) | Guards + filters | ARIA attributes | Semantic HTML | + +# **🗂️ ข้อตกลงเฉพาะสำหรับ DMS (LCBP3-DMS)** + +ส่วนนี้ขยายแนวทาง FullStackJS ทั่วไปสำหรับโปรเจกต์ **LCBP3-DMS** โดยมุ่งเน้นไปที่เวิร์กโฟลว์การอนุมัติเอกสาร (Correspondence, RFA, Drawing, Contract, Transmittal, Circulation) + +## **🧩 RBAC และการควบคุมสิทธิ์ (RBAC & Permission Control)** + +ใช้ Decorators เพื่อบังคับใช้สิทธิ์การเข้าถึง โดยอ้างอิงสิทธิ์จากตาราง permissions + +@RequirePermission('rfas.respond') // ต้องตรงกับ 'permission\code' +@Put(':id') +updateRFA(@Param('id') id: string) { + return this.rfaService.update(id); +} + +### **Roles (บทบาท)** + +* **Superadmin**: ไม่มีข้อจำกัดใดๆ [cite: 4.3] +* **Admin**: มีสิทธิ์เต็มที่ในองค์กร [cite: 4.3] +* **Document Control**: เพิ่ม/แก้ไข/ลบ เอกสารในองค์กร [cite: 4.3] +* **Editor**: สามารถ เพิ่ม/แก้ไข เอกสารที่กำหนด [cite: 4.3] +* **Viewer**: สามารถดู เอกสาร [cite: 4.3] + +### **ตัวอย่าง Permissions (จากตาราง permissions)** + +* rfas.view, rfas.create, rfas.respond, rfas.delete +* drawings.view, drawings.upload, drawings.delete +* corr.view, corr.manage +* transmittals.manage +* cirs.manage +* project\parties.manage + +การจับคู่ระหว่าง roles และ permissions **เริ่มต้น** จะถูก seed ผ่านสคริปต์ (ดังที่เห็นในไฟล์ SQL)**อย่างไรก็ตาม AuthModule/UserModule ต้องมี API สำหรับ Admin เพื่อสร้าง Role ใหม่และกำหนดสิทธิ์ (Permissions) เพิ่มเติมได้ในภายหลัง** [cite: 4.3] + +## **🧾 มาตรฐาน AuditLog (AuditLog Standard)** + +บันทึกการดำเนินการ CRUD และการจับคู่ทั้งหมดลงในตาราง audit_logs + +| Field (ฟิลด์) | Type (จาก SQL) | Description (คำอธิบาย) | +| :---- | :---- | :---- | +| audit_id | BIGINT | Primary Key | +| user_id | INT | ผู้ใช้ที่ดำเนินการ (FK -> users) | +| action | VARCHAR(100) | rfa.create, correspondence.update, login.success | +| entity_type | VARCHAR(50) | ชื่อตาราง/โมดูล เช่น 'rfa', 'correspondence' | +| entity_id | VARCHAR(50) | Primary ID ของระเบียนที่ได้รับผลกระทบ | +| details_json | JSON | ข้อมูลบริบท (เช่น ฟิลด์ที่มีการเปลี่ยนแปลง) | +| ip_address | VARCHAR(45) | IP address ของผู้ดำเนินการ | +| user_agent | VARCHAR(255) | User Agent ของผู้ดำเนินการ | +| created_at | TIMESTAMP | Timestamp (UTC) | + +## **📂 การจัดการไฟล์ (File Handling) (ปรับปรุงใหม่)** + +### **มาตรฐานการอัปโหลดไฟล์ (File Upload Standard)** + +* **ตรรกะใหม่:** การอัปโหลดไฟล์ทั้งหมดจะถูกจัดการโดย FileStorageService และบันทึกข้อมูลไฟล์ลงในตาราง attachments (ตารางกลาง) +* ไฟล์จะถูกเชื่อมโยงไปยัง Entity ที่ถูกต้องผ่าน **ตารางเชื่อม (Junction Tables)** เท่านั้น: + * correspondence_attachments (เชื่อม Correspondence กับ Attachments) + * circulation_attachments (เชื่อม Circulation กับ Attachments) + * shop_drawing_revision_attachments (เชื่อม Shop Drawing Revision กับ Attachments) + * contract_drawing_attachments (เชื่อม Contract Drawing กับ Attachments) +* เส้นทางจัดเก็บไฟล์ (Upload path): อ้างอิงจาก Requirement 2.1 คือ /share/dms-data [cite: 2.1] โดย FileStorageService จะสร้างโฟลเดอร์ย่อยแบบรวมศูนย์ (เช่น /share/dms-data/uploads/{YYYY}/{MM}/[stored\filename]) +* ประเภทไฟล์ที่อนุญาต: pdf, dwg, docx, xlsx, zip +* ขนาดสูงสุด: **50 MB** +* จัดเก็บนอก webroot +* ให้บริการไฟล์ผ่าน endpoint ที่ปลอดภัย /files/:attachment_id/download + +### **การควบคุมการเข้าถึง (Access Control)** + +การเข้าถึงไฟล์ไม่ใช่การเข้าถึงโดยตรง endpoint /files/:attachment_id/download จะต้อง: + +1. ค้นหาระเบียน attachment +2. ตรวจสอบว่า attachment_id นี้ เชื่อมโยงกับ Entity ใด (เช่น correspondence, circulation, shop_drawing_revision, contract_drawing) ผ่านตารางเชื่อม +3. ตรวจสอบว่าผู้ใช้มีสิทธิ์ (permission) ในการดู Entity ต้นทางนั้นๆ หรือไม่ + +## **🔟 การจัดการเลขที่เอกสาร (Document Numbering) [cite: 3.10]** + +* **เป้าหมาย:** สร้างเลขที่เอกสาร (เช่น correspondence\number) โดยอัตโนมัติ ตามรูปแบบที่กำหนด +* **ตรรกะการนับ:** การนับ Running number (SEQ) จะนับแยกตาม Key: **Project + Originator Organization + Document Type + Year** +* **ตาราง SQL:** + * document_number_formats: Admin ใช้กำหนด "รูปแบบ" (Template) ของเลขที่ (เช่น {ORG\CODE}-{TYPE\CODE}-{YEAR\SHORT}-{SEQ:4}) โดยกำหนดตาม **Project** และ **Document Type** [cite: 4.5] + * document_number_counters: ระบบใช้เก็บ "ตัวนับ" ล่าสุดของ Key (Project+Org+Type+Year) +* **การทำงาน (Backend):** + * DocumentNumberingModule จะให้บริการ DocumentNumberingService + * เมื่อ CorrespondenceModule ต้องการสร้างเอกสารใหม่, มันจะเรียก documentNumberingService.generateNextNumber(...) + * Service นี้จะเรียกใช้ Stored Procedure **sp_get_next_document_number** [cite: 2.9.3] ซึ่ง Procedure นี้จะจัดการ Database Transaction และ Row Lock (FOR UPDATE) ภายใน DB เพื่อรับประกันการป้องกัน Race Condition + +## **📊 การรายงานและการส่งออก (Reporting & Exports)** + +### **วิวสำหรับการรายงาน (Reporting Views) (จาก SQL)** + +การรายงานควรสร้างขึ้นจาก Views ที่กำหนดไว้ล่วงหน้าในฐานข้อมูลเป็นหลัก: + +* v_current_correspondences: สำหรับ revision ปัจจุบันทั้งหมดของเอกสารที่ไม่ใช่ RFA +* v_current_rfas: สำหรับ revision ปัจจุบันทั้งหมดของ RFA และข้อมูล master +* v_contract_parties_all: สำหรับการตรวจสอบความสัมพันธ์ของ project/contract/organization +* v_user_tasks: สำหรับ Dashboard "งานของฉัน" +* v_audit_log_details: สำหรับ Activity Feed + +Views เหล่านี้ทำหน้าที่เป็นแหล่งข้อมูลหลักสำหรับการรายงานฝั่งเซิร์ฟเวอร์และการส่งออกข้อมูล + +### **กฎการส่งออก (Export Rules)** + +* Export formats: CSV, Excel, PDF. +* จัดเตรียมมุมมองสำหรับพิมพ์ (Print view). +* รวมลิงก์ไปยังต้นทาง (เช่น /rfas/:id). + +## **🧮 ฟรอนต์เอนด์: รูปแบบ DataTable และฟอร์ม (Frontend: DataTable & Form Patterns)** + +### **DataTable (Server‑Side)** + +* Endpoint: /api/{module}?page=1\&pageSize=20\&sort=...\&filter=... +* ต้องรองรับ: การแบ่งหน้า (pagination), การเรียงลำดับ (sorting), การค้นหา (search), การกรอง (filters) +* แสดง revision ล่าสุดแบบ inline เสมอ (สำหรับ RFA/Drawing) + +### **มาตรฐานฟอร์ม (Form Standards)** + +* ต้องมีการใช้งาน Dropdowns แบบขึ้นต่อกัน (Dependent dropdowns) (ตามที่สคีมารองรับ): + * Project → Contract Drawing Volumes + * Contract Drawing Category → Sub-Category + * RFA (ประเภท Shop Drawing) → Shop Drawing Revisions ที่เชื่อมโยงได้ +* **(ใหม่)** การอัปโหลดไฟล์: ต้องรองรับ **Multi-file upload (Drag-and-Drop)** [cite: 5.7] +* **(ใหม่)** UI ต้องอนุญาตให้ผู้ใช้กำหนดว่าไฟล์ใดเป็น **"เอกสารหลัก"** หรือ "เอกสารแนบประกอบ" [cite: 5.7] +* ส่ง (Submit) ผ่าน API พร้อม feedback แบบ toast + +### **ข้อกำหนด Component เฉพาะ (Specific UI Requirements)** + +* **Dashboard \- My Tasks:** ต้องพัฒนา Component ตาราง "งานของฉัน" (My Tasks)ซึ่งดึงข้อมูลงานที่ผู้ใช้ล็อกอินอยู่ต้องรับผิดชอบ (Main/Action) จาก v\user\tasks [cite: 5.3] +* **Workflow Visualization:** ต้องพัฒนา Component สำหรับแสดงผล Workflow (โดยเฉพาะ RFA)ที่แสดงขั้นตอนทั้งหมดเป็นลำดับ โดยขั้นตอนปัจจุบัน (active) เท่านั้นที่ดำเนินการได้ และขั้นตอนอื่นเป็น disabled [cite: 5.6] ต้องมีตรรกะสำหรับ Admin ในการ override หรือย้อนกลับขั้นตอนได้ [cite: 5.6] +* ** Admin Panel:** ต้องมีหน้า UI สำหรับ Superadmin/Admin เพื่อจัดการข้อมูลหลัก (Master Data [cite: 4.5]), การเริ่มต้นใช้งาน (Onboarding [cite: 4.6]), และ **รูปแบบเลขที่เอกสาร (Numbering Formats [cite: 3.10])** + +## **🧭 แดชบอร์ดและฟีดกิจกรรม (Dashboard & Activity Feed)** + +### **การ์ดบนแดชบอร์ด (Dashboard Cards)** + +* แสดง Correspondences, RFAs, Circulations, Shop Drawing Revision ล่าสุด +* รวมสรุป KPI (เช่น "RFAs ที่รอการอนุมัติ", "Shop Drawing ที่รอการอนุมัติ") [cite: 5.3] +* รวมลิงก์ด่วนไปยังโมดูลต่างๆ + +### **ฟีดกิจกรรม (Activity Feed)** + +* แสดงรายการ v\audit\log\details ล่าสุด (10 รายการ) ที่เกี่ยวข้องกับผู้ใช้ + +// ตัวอย่าง API response +[ + { user: 'editor01', action: 'Updated RFA (LCBP3-RFA-001)', time: '2025-11-04T09:30Z' } +] + +## **🛡️ ข้อกำหนดที่ไม่ใช่ฟังก์ชันการทำงาน (Non-Functional Requirements)** + +ส่วนนี้สรุปข้อกำหนด Non-Functional จาก requirements.md เพื่อให้ทีมพัฒนาทราบ + +* **Audit Log [cite: 6.1]:** ทุกการกระทำที่สำคัญ (C/U/D) ต้องถูกบันทึกใน audit_logs +* **Performance [cite: 6.4]:** ต้องใช้ Caching สำหรับข้อมูลที่เรียกบ่อย และใช้ Pagination +* **Security [cite: 6.5]:** ต้องมี Rate Limiting และจัดการ Secret ผ่าน docker-compose.yml (ไม่ใช่ .env) +* **(ใหม่) Backup & Recovery [cite: 6.6]:** ต้องมีแผนสำรองข้อมูลทั้ง Database (MariaDB) และ File Storage (/share/dms-data) อย่างน้อยวันละ 1 ครั้ง +* **(ใหม่) Notification Strategy [cite: 6.7]:** ระบบแจ้งเตือน (Email/Line) ต้องถูก Trigger เมื่อมีเอกสารใหม่ส่งถึง, มีการมอบหมายงานใหม่ (Circulation), หรือ (ทางเลือก) เมื่องานเสร็จ/ใกล้ถึงกำหนด + +## **✅ มาตรฐานที่นำไปใช้แล้ว (จาก SQL v1.1.0) (Implemented Standards (from SQL v1.1.0))** + +ส่วนนี้ยืนยันว่าแนวทางปฏิบัติที่ดีที่สุดต่อไปนี้เป็นส่วนหนึ่งของการออกแบบฐานข้อมูลอยู่แล้ว และควรถูกนำไปใช้ประโยชน์ ไม่ใช่สร้างขึ้นใหม่ + +* ✅ **Soft Delete:** นำไปใช้แล้วผ่านคอลัมน์ deleted_at ในตารางสำคัญ (เช่น correspondences, rfas, project_parties) ตรรกะการดึงข้อมูลต้องกรอง deleted_at IS NULL +* ✅ **Database Indexes:** สคีมาได้มีการทำ index ไว้อย่างหนักหน่วงบน foreign keys และคอลัมน์ที่ใช้ค้นหาบ่อย (เช่น idx_rr_rfa, idx_cor_project, idx_cr_is_current) เพื่อประสิทธิภาพ +* ✅ **โครงสร้าง RBAC:** มีระบบ users, roles, permissions, user_roles, และ user_project_roles ที่ครอบคลุมอยู่แล้ว +* ✅ **Data Seeding:** ข้อมูล Master (roles, permissions, organization_roles, initial users, project parties) ถูกรวมอยู่ในสคริปต์สคีมาแล้ว + +## **🧩 การปรับปรุงที่แนะนำ (สำหรับอนาคต) (Recommended Enhancements (Future))** + +* ✅ สร้าง Background job (โดยใช้ **n8n** เพื่อเชื่อมต่อกับ **Line** [cite: 2.7] และ/หรือใช้สำหรับการแจ้งเตือน RFA ที่ใกล้ถึงกำหนด due_date [cite: 6.7]) +* ✅ เพิ่ม job ล้างข้อมูลเป็นระยะสำหรับ attachments ที่ไม่ถูกเชื่อมโยงกับ Entity ใดๆ เลย (ไฟล์กำพร้า) \ No newline at end of file diff --git a/docs/Markdown/LCBP3-DMS_V1_2_1_application _requirements.md b/docs/Markdown/LCBP3-DMS_V1_2_1_application _requirements.md new file mode 100644 index 0000000..7e2ceac --- /dev/null +++ b/docs/Markdown/LCBP3-DMS_V1_2_1_application _requirements.md @@ -0,0 +1,210 @@ +# **📝 Documents Management Sytem Version 1.2.1: Application Requirements Specification** + +## **📌 1. วัตถุประสงค์** + +สร้างเว็บแอปพลิเคชั่นสำหรับระบบบริหารจัดการเอกสารโครงการ (Document Management System)ที่สามารถจัดการและควบคุม การสื่อสารด้วยเอกสารที่ซับซ้อน อย่างมีประสิทธิภาพ + +* มีฟังก์ชันหลักในการอัปโหลด จัดเก็บ ค้นหา แชร์ และควบคุมสิทธิ์การเข้าถึงเอกสาร +* ช่วยลดการใช้เอกสารกระดาษ เพิ่มความปลอดภัยในการจัดเก็บข้อมูล +* เพิ่มความสะดวกในการทำงานร่วมกันระหว่างองกรณ์ + +## **🛠️ 2. สถาปัตยกรรมและเทคโนโลยี (System Architecture & Technology Stack)** + +ใช้สถาปัตยกรรมแบบ Headless/API-First ที่ทันสมัย ทำงานทั้งหมดบน QNAP Server ผ่าน Container Station เพื่อความสะดวกในการจัดการและบำรุงรักษา, Domain: np-dms.work, มี fix ip, รัน docker command ใน application ของ Container Station ได้โดยตรง, ประกอบด้วย + +* 2.1. Infrastructure & Environment: + * Server: QNAP (Model: TS-473A, RAM: 32GB, CPU: AMD Ryzen V1500B) + * Containerization: Container Station (Docker & Docker Compose) ใช้ UI ของ Container Station เป็นหลัก ในการ configuration และการรัน docker command + * Development Environment: VS Code on Windows 11 + * Domain: np-dms.work, www.np-dms.work + * ip: 159.192.126.103 + * Docker Network: ทุก Service จะเชื่อมต่อผ่านเครือข่ายกลางชื่อ lcbp3 เพื่อให้สามารถสื่อสารกันได้ + * Data Storage: /share/dms-data บน QNAP + * ข้อจำกัด: ไม่สามารถใช้ .env ในการกำหนดตัวแปรภายนอกได้ ต้องกำหนดใน docker-compose.yml เท่านั้น +* 2.2. Code Hosting: + * Application name: git + * Service: Gitea (Self-hosted on QNAP) + * Service name: gitea + * Domain: git.np-dms.work + * หน้าที่: เป็นศูนย์กลางในการเก็บและจัดการเวอร์ชันของโค้ด (Source Code) สำหรับทุกส่วน +* 2.3. Backend / Data Platform: + * Application name: lcbp3-backend + * Service: NestJS + * Service name: backend + * Domain: backend.np-dms.work + * Framework: NestJS (Node.js, TypeScript, ESM) + * หน้าที่: จัดการโครงสร้างข้อมูล (Data Models), สร้าง API, จัดการสิทธิ์ผู้ใช้ (Roles & Permissions), และสร้าง Workflow ทั้งหมดของระบบ +* 2.4. Database: + * Application name: lcbp3-db + * Service: mariadb:10.11 + * Service name: mariadb + * Domain: db.np-dms.work + * หน้าที่: ฐานข้อมูลหลักสำหรับเก็บข้อมูลทั้งหมด + * Tooling: DBeaver (Community Edition), phpmyadmin สำหรับการออกแบบและจัดการฐานข้อมูล +* 2.5. Database management: + * Application name: lcbp3-db + * Service: phpmyadmin:5-apache + * Service name: pma + * Domain: pma.np-dms.work + * หน้าที่: จัดการฐานข้อมูล mariadb ผ่าน Web UI +* 2.6. Frontend: + * Application name: lcbp3-frontend + * Service: next.js + * Service name: frontend + * Domain: lcbp3.np-dms.work + * Framework: Next.js (App Router, React, TypeScript, ESM) + * Styling: Tailwind CSS + PostCSS + * Component Library: shadcn/ui + * หน้าที่: สร้างหน้าตาเว็บแอปพลิเคชันสำหรับให้ผู้ใช้งานเข้ามาดู Dashboard, จัดการเอกสาร, และติดตามงาน โดยจะสื่อสารกับ Backend ผ่าน API +* 2.7. Workflow automation: + * Application name: lcbp3-n8n + * Service: n8nio/n8n:latest + * Service name: n8n + * Domain: n8n.np-dms.work + * หน้าที่: จัดการ workflow ระหว่าง Backend และ Line +* 2.8. Reverse Proxy: + * Application name: lcbp3-npm + * Service: Nginx Proxy Manager (nginx-proxy-manage: latest) + * Service name: npm + * Domain: npm.np-dms.work + * หน้าที่: เป็นด่านหน้าในการรับ-ส่งข้อมูล จัดการโดเมนทั้งหมด, ทำหน้าที่เป็น Proxy ชี้ไปยัง Service ที่ถูกต้อง, และจัดการ SSL Certificate (HTTPS) ให้อัตโนมัติ +* **2.9. การจัดการตรรกะทางธุรกิจ (Business Logic Implementation):** + * 2.9.1. ตรรกะทางธุรกิจที่ซับซ้อนทั้งหมด (เช่น การเปลี่ยนสถานะ Workflow [cite: 3.5.4, 3.6.5], การบังคับใช้สิทธิ์ [cite: 4.4], การตรวจสอบ Deadline [cite: 3.2.5]) **จะถูกจัดการในฝั่ง Backend (NestJS)** [cite: 2.3] เพื่อให้สามารถบำรุงรักษาและทดสอบได้ง่าย (Testability) + * 2.9.2. **จะไม่มีการใช้ SQL Triggers** เพื่อป้องกันตรรกะซ่อนเร้น (Hidden Logic) และความซับซ้อนในการดีบัก + * 2.9.3. **ข้อยกเว้น:** ตรรกะเดียวที่จะอยู่ในฐานข้อมูลคือ **Stored Procedure** สำหรับการสร้างเลขที่เอกสาร (Document Numbering) [cite: 3.10] เพื่อป้องกันการซ้ำซ้อนของข้อมูล (Race Condition) + +## **📦 3. ข้อกำหนดด้านฟังก์ชันการทำงาน (Functional Requirements)** + +* 3.1. การจัดการโครงสร้างโครงการและองค์กร + * 3.1.1. โครงการ (Projects): ระบบต้องสามารถจัดการเอกสารภายในหลายโครงการได้ (ปัจจุบันมี 4 โครงการ และจะเพิ่มขึ้นในอนาคต) + * 3.1.2. สัญญา (Contracts): ระบบต้องสามารถจัดการเอกสารภายในแต่ละสัญญาได้ ในแต่ละโครงการ มีได้หลายสัญญา หรืออย่างน้อย 1 สัญญา + * 3.1.3. องค์กร (Organizations): + * มีหลายองค์กรในโครงการ องค์กรณ์ที่เป็น Owner, Designer และ Consultant สามารถอยู่ในหลายโครงการและหลายสัญญาได้ + * Contractor จะถือ 1 สัญญา และอยู่ใน 1 โครงการเท่านั้น +* 3.2. การจัดการเอกสารโต้ตอบ (Correspondence Management) + * 3.2.1. วัตถุประสงค์: เอกสารโต้ตอบ (correspondences) ระหว่างองกรณื-องกรณ์ ภายใน โครงการ (Projects) และระหว่าง องค์กร-องค์กร ภายนอก โครงการ (Projects), รองรับ To (ผู้รับหลัก) และ CC (ผู้รับสำเนา) หลายองค์กร + * 3.2.2. ประเภทเอกสาร: ระบบต้องรองรับเอกสารรูปแบบ ไฟล์ PDF หลายประเภท (Types) เช่น จดหมาย (Letter), อีเมล์ (Email), Request for Information (RFI), และสามารถเพิ่มประเภทใหม่ได้ในภายหลัง + * 3.2.3. การสร้างเอกสาร (Correspondence): + * ผู้ใช้ที่มีสิทธิ์ (เช่น Document Control) สามารถสร้างเอกสารรอไว้ในสถานะ ฉบับร่าง" (Draft) ได้ ซึ่งผู้ใช้งานต่างองค์กรจะมองไม่เห็น + * เมื่อกด "Submitted" แล้ว การแก้ไข, ถอนเอกสารกลับไปสถานะ Draft, หรือยกเลิก (Cancel) จะต้องทำโดยผู้ใช้ระดับ Admin ขึ้นไป พร้อมระบุเหตุผล + * 3.2.4. การอ้างอิงและจัดกลุ่ม: + * เอกสารสามารถอ้างถึง (Reference) เอกสารฉบับก่อนหน้าได้หลายฉบับ + * สามารถกำหนด Tag ได้หลาย Tag เพื่อจัดกลุ่มและใช้ในการค้นหาขั้นสูง + * 3.2.5. การจัดการ: มีการจัดการอย่างน้อยดังนี้ + * สามารถกำหนดวันแล้วเสร็จ (Deadline) สำหรับผู้รับผิดชอบของ องกรณ์ ที่เป็นผู้รับได้ + * มีระบบแจ้งเตือน ให้ผู้รับผิดชอบขององกรณ์ที่เป็น ผู้รับ/ผู้ส่ง ทราบ เมื่อมีเอกสารใหม่ หรือมีการเปลี่ยนสถานะ +* 3.3. การจัดกาแบบคู่สัญญา (Contract Drawing) + * 3.3.1. วัตถุประสงค์: แบบคู่สัญญา (Contract Drawing) ใช้เพื่ออ้างอิงและใช้ในการตรวจสอบ + * 3.3.2. ประเภทเอกสาร: ไฟล์ PDF + * 3.3.3. การสร้างเอกสาร: ผู้ใช้ที่มีสิทธิ์ สามารถสร้างและแก้ไขได้ + * 3.3.4. การอ้างอิงและจัดกลุ่ม: ใช้สำหรับอ้างอิง ใน Shop Drawings, มีการจัดหมวดหมู่ของ Contract Drawing +* 3.4. การจัดกาแบบก่อสร้าง (Shop Drawing) + * 3.4.1. วัตถุประสงค์: แบบก่อสร้าง (Shop Drawing) ใช้เในการตรวจสอบ โดยจัดส่งด้วย Request for Approval (RFA) + * 3.4.2. ประเภทเอกสาร: ไฟล์ PDF + * 3.4.3. การสร้างเอกสาร: ผู้ใช้ที่มีสิทธิ์ สามารถสร้างและแก้ไขได้ + * 3.4.4. การอ้างอิงและจัดกลุ่ม: ช้สำหรับอ้างอิง ใน Shop Drawings, มีการจัดหมวดหมู่ของ Shop Drawings +* 3.5. การจัดการเอกสารขออนุมัติ (Request for Approval & Workflow) + * 3.5.1. วัตถุประสงค์: เอกสารขออนุมัติ (Request for Approval) ใช้ในการส่งเอกสารเพิอขออนุมัติ + * 3.5.2. ประเภทเอกสาร: Request for Approval (RFA) เป็นชนิดหนึ่งของ Correspondence ที่มีลักษณะเฉพาะที่ต้องได้รับการอนุมัติ มีประเภทดังนี้: + * Request for Drawing Approval (RFA_DWG) + * Request for Document Approval (RFA_DOC) + * Request for Method statement Approval (RFA_MES) + * Request for Material Approval (RFA_MAT) + * 3.5.2. การสร้างเอกสาร: ผู้ใช้ที่มีสิทธิ์ สามารถสร้างและแก้ไขได้ + * 3.5.4. การอ้างอิงและจัดกลุ่ม: การจัดการ Drawing (RFA_DWG): + * เอกสาร RFA_DWG จะประกอบไปด้วย Shop Drawing (shop_drawings) หลายแผ่น ซึ่งแต่ละแผ่นมี Revision ของตัวเอง + * Shop Drawing แต่ละ Revision สามารถอ้างอิงถึง Contract Drawing (Ccontract_drawings) หลายแผ่น หรือไม่อ้างถึงก็ได้ + * ระบบต้องมีส่วนสำหรับจัดการข้อมูล Master Data ของทั้ง Shop Drawing และ Contract Drawing แยกจากกัน + * 3.6.5. Workflow การอนุมัติ: ต้องรองรับกระบวนการอนุมัติที่ซับซ้อนและเป็นลำดับ เช่น + * ส่งจาก Originator -> Organization 1 -> Organization 2 -> Organization 3 แล้วส่งผลกลับตามลำดับเดิม (โดยถ้า องกรณ์ใดใน Workflow ให้ส่งกลับ ก็สามารถส่งผลกลับตามลำดับเดิมโดยไม่ต้องรอให้ถึง องกรณืในลำดับถัดไป) + * 3.6.6. การจัดการ: มีการจัดการอย่างน้อยดังนี้ + * สามารถกำหนดวันแล้วเสร็จ (Deadline) สำหรับผู้รับผิดชอบของ องกรณ์ ที่อยู่ใน Workflow ได้ + * มีระบบแจ้งเตือน ให้ผู้รับผิดชอบของ องกรณ์ ที่อยู่ใน Workflow ทราบ เมื่อมี RFA ใหม่ หรือมีการเปลี่ยนสถานะ +* 3.6.การจัดการเอกสารนำส่ง (Transmittals) + * 3.6.1. วัตถุประสงค์: เอกสารนำส่ง ใช้สำหรับ นำส่ง Request for Approval (RFAS) หลายฉบับ ไปยังองค์กรอื่น + * 3.6.2. ประเภทเอกสาร: ไฟล์ PDF + * 3.6.3. การสร้างเอกสาร: ผู้ใช้ที่มีสิทธิ์ สามารถสร้างและแก้ไขได้ + * 3.6.4. การอ้างอิงและจัดกลุ่ม: เอกสารนำส่ง เป็นส่วนหนึ่งใน Correspondence +* 3.7. ใบเวียนเอกสารภายใน (Internal Circulation Sheet) + * 3.7.1. วัตถุประสงค์: การสื่อสาร เอกสาร (Correspondence) ทุกฉบับ จะมีใบเวียนเอกสารเพื่อควบคุมและมอบหมายงานภายในองค์กร (สามารถดูและแก้ไขได้เฉพาะคนในองค์กร) + * 3.7.2. ประเภทเอกสาร: ไฟล์ PDF + * 3.7.3. การสร้างเอกสาร: ผู้ใช้ที่มีสิทธิ์ในองค์กรนั้น สามารถสร้างและแก้ไขได้ + * 3.7.4. การอ้างอิงและจัดกลุ่ม: การระบุผู้รับผิดชอบ: + * ผู้รับผิดชอบหลัก (Main): มีได้หลายคน + * ผู้ร่วมปฏิบัติงาน (Action): มีได้หลายคน + * ผู้ที่ต้องรับทราบ (Information): มีได้หลายคน + * 3.7.5. การติดตามงาน: + * สามารถกำหนดวันแล้วเสร็จ (Deadline) สำหรับผู้รับผิดชอบประเภท Main และ Action ได้ + * มีระบบแจ้งเตือนเมื่อมี Circulation ใหม่ และแจ้งเตือนล่วงหน้าก่อนถึงวันแล้วเสร็จ + * สามารถปิด Circulation ได้เมื่อดำเนินการตอบกลับไปยังองค์กรผู้ส่ง (Originator) แล้ว หรือ รับทราบแล้ว (For Information) +* 3.8. ประวัติการแก้ไข (Revisions): ระบบจะเก็บประวัติการสร้างและแก้ไข เอกสารทั้งหมด +* 3.9. การจัดเก็บ: (ปรับปรุงตามสถาปัตยกรรมใหม่) + * เอกสารและไฟล์แนบทั้งหมดจะถูกจัดเก็บในโฟลเดอร์บน Server (/share/dms-data/) [cite: 2.1] + * ข้อมูล Metadata ของไฟล์ (เช่น ชื่อไฟล์, ขนาด, path) จะถูกเก็บในตาราง attachments (ตารางกลาง) + * ไฟล์จะถูกเชื่อมโยงกับเอกสารประเภทต่างๆ ผ่านตารางเชื่อม (Junction tables) เช่น correspondence_attachments, circulation_attachments, shop_drawing_revision_attachments ,และ contracy_drawing_attachments + * สถาปัตยกรรมแบบรวมศูนย์นี้ *แทนที่* แนวคิดเดิมที่จะแยกโฟลเดอร์ตามประเภทเอกสาร เพื่อรองรับการขยายระบบที่ดีกว่า +* 3.10. การจัดการเลขที่เอกสาร (Document Numbering): + * 3.10.1. ระบบต้องสามารถสร้างเลขที่เอกสาร (เช่น correspondence_number) ได้โดยอัตโนมัติ + * 3.10.2. การนับเลข Running Number (SEQ) จะต้องนับแยกตาม Key ดังนี้: **โครงการ (Project)**, **องค์กรผู้ส่ง (Originator Organization)**, **ประเภทเอกสาร (Document Type)** และ **ปีปัจจุบัน (Year)** + * 3.10.3. ผู้ดูแลระบบ (Admin) ต้องสามารถกำหนด "รูปแบบ" (Format Template) ของเลขที่เอกสารได้ (เช่น {ORG_CODE}-{TYPE_CODE}-{YEAR_SHORT}-{SEQ:4}) โดยกำหนดแยกตามโครงการและประเภทเอกสาร + +## **🔐 4. ข้อกำหนดด้านสิทธิ์และการเข้าถึง (Access Control Requirements)** + +* 4.1. ภาพรวม: ผู้ใช้และองค์กรสามารถดูและแก้ไขเอกสารได้ตามสิทธิ์ที่ได้รับ โดยระบบสิทธิ์จะเป็นแบบ Role-Based Access Control (RBAC) +* 4.2. ระดับของสิทธิ์: + * Global Roles: สิทธิ์ในภาพรวมของระบบ + * Project-Specific Roles: สิทธิ์ที่ถูกกำหนดให้ผู้ใช้สำหรับโครงการนั้นๆ โดยเฉพาะ (เช่น เป็น Editor ในโครงการ A แต่เป็น Viewer ในโครงการ B) +* 4.3. บทบาท (Roles) พื้นฐาน: + * Superadmin: ไม่มีข้อจำกัดใดๆ สามารถจัดการได้ทุกอย่างข้ามองค์กรณ์ + * Admin: มีสิทธิ์เต็มที่ แต่จำกัดเฉพาะในองค์กรที่ตัวเองสังกัด สามารถจัดการผู้ใช้ในองค์กรณ์ได้ สามารถสร้าง Role ใหม่และกำหนดสิทธิ์ (Permissions) เพิ่มเติมได้ในภายหลังผ่านหน้า Admin + * Document Control สามารถ เพิ่ม/แก้ไข/ลบ เอกสาร เฉพาะในองค์กรณ์ที่ตัวเองสังกัด ไม่สามารถจัดการผู้ใช้ได้ + * Editor: สามารถ เพิ่ม/แก้ไข เอกสารที่กำหนดไว้ เฉพาะในองค์กรณ์ที่ตัวเองสังกัด + * Viewer: สามารถดู เอกสาร เฉพาะในองค์กรณ์ที่ตัวเองสังกัด +* 4.4. การบังคับใช้สิทธิ์: สิทธิ์ขององค์กรจะครอบคลุมสิทธิ์ของผู้ใช้ และการเข้าถึงข้อมูลที่เกี่ยวข้องกับโครงการ (เช่น การแก้ไขเอกสาร) จะถูกตรวจสอบเทียบกับสิทธิ์ที่ผู้ใช้มีในโครงการนั้นๆ โดยเฉพาะ +* 4.5. (ใหม่) การจัดการข้อมูลหลัก (Master Data Management): + * ระบบจะต้องมีส่วน "Admin Panel" (สำหรับ Superadmin และ Admin) เพื่อใช้จัดการข้อมูลหลัก (Master Data) ของระบบ + * ข้อมูลหลักที่ต้องจัดการได้เป็นอย่างน้อย: + * ประเภทเอกสาร (เช่น correspondence_types, rfa_types) + * หมวดหมู่แบบ (เช่น shop_drawing_categories) + * Tags ที่ใช้ในระบบ + * สถานะเอกสาร (หากจำเป็นต้องเพิ่มในอนาคต) +* 4.6. (ใหม่) การเริ่มต้นใช้งาน (User & Organization Onboarding): + * การเพิ่มองค์กรณ์ใหม่ (Organizations) เข้าสู่ระบบ จะต้องดำเนินการโดย Superadmin เท่านั้น + * เมื่อ Superadmin สร้างองค์กรณ์ใหม่ จะต้องสามารถกำหนดผู้ใช้ (User) อย่างน้อย 1 คน ให้เป็น "Admin" ประจำองค์กรณ์นั้นๆ + * Admin ประจำองค์กณ์รจึงจะสามารถเพิ่มผู้ใช้ (Editor, Viewer, Document Control) คนอื่นๆ เข้าสู่องค์กรของตนเองได้ + +## **👥 5\. ข้อกำหนดด้านผู้ใช้งาน (User Interface & Experience)** + +* 5.1. Layout หลัก: หน้าเว็บใช้รูปแบบ App Shell ที่ประกอบด้วย: + * Navbar (ส่วนบน): แสดงชื่อระบบ, เมนูผู้ใช้ (Profile), เมนูสำหรับ Admin/Superadmin (จัดการผู้ใช้, จัดการสิทธิ์), และปุ่ม Login/Logout + * Sidebar (ด้านข้าง): เป็นเมนูหลักสำหรับเข้าถึงส่วนที่เกี่ยวกับเอกสารทั้งหมด เช่น Dashboard, Correspondences, RFA, Drawings + * Main Content Area: พื้นที่สำหรับแสดงเนื้อหาหลักของหน้าที่เลือก +* 5.2. หน้า Landing Page: เป็นหน้าแรกที่แสดงข้อมูลบางส่วนของโครงการสำหรับผู้ใช้ที่ยังไม่ได้ล็อกอิน +* 5.3. หน้า Dashboard: เป็นหน้าแรกหลังจากล็อกอิน ประกอบด้วย: + * การ์ดสรุปภาพรวม (KPI Cards): แสดงข้อมูลสรุปที่สำคัญขององค์กร เช่น จำนวนเอกสาร, งานที่เกินกำหนด + * ตาราง "งานของฉัน" (My Tasks Table): แสดงรายการงานทั้งหมดจาก Circulation ที่ผู้ใช้ต้องดำเนินการ +* 5.4. การติดตามสถานะ: องค์กรสามารถติดตามสถานะเอกสารทั้งของตนเอง (Originator) และสถานะเอกสารที่ส่งมาถึงตนเอง (Recipient) +* 5.5. การจัดการข้อมูลส่วนตัว (Profile Page): ผู้ใช้สามารถจัดการข้อมูลส่วนตัวและเปลี่ยนรหัสผ่านของตนเองได้ +* 5.6. การจัดการเอกสารทางเทคนิค (Technical Documents & Workflow): ผู้ใช้สามารถดู Technical Document ในรูปแบบ Workflow ทั้งหมดได้ในหน้าเดียว, ขั้นตอนที่ยังไม่ถึงหรือผ่านไปแล้วจะเป็นรูปแบบ diable, สามารถดำเนินการได้เฉพาะในขั้นตอนที่ได้รับมอบหมายงาน (active) เช่น ตรวจสอบแล้ว เพื่อไปยังขั้นตอนต่อไป, สิทธิ์ admin ขึ้นไป สามรถกด ไปยังขั้นตอนต่อไป ได้ทุกขั้นตอน, การย้อนกลับ ไปขั้นตอนก่อนหน้า สามารถทำได้โดย สิทธิ์ admin ขึ้นไป +* 5.7. ข้อกำหนด UI/UX การแนบไฟล์ (File Attachment UX): + * ระบบต้องรองรับการอัปโหลดไฟล์หลายไฟล์พร้อมกัน (Multi-file upload) เช่น การลากและวาง (Drag-and-Drop) + * ในหน้าอัปโหลด (เช่น สร้าง RFA หรือ Correspondence) ผู้ใช้ต้องสามารถกำหนดได้ว่าไฟล์ใดเป็น "เอกสารหลัก" (Main Document เช่น PDF) และไฟล์ใดเป็น "เอกสารแนบประกอบ" (Supporting Attachments เช่น .dwg, .docx, .zip) + +## **6. ข้อกำหนดที่ไม่ใช่ฟังก์ชันการทำงาน (Non-Functional Requirements)** + +* 6.1. การบันทึกการกระทำ (Audit Log): ทุกการกระทำที่สำคัญของผู้ใช้ (สร้าง, แก้ไข, ลบ, ส่ง) จะถูกบันทึกไว้ใน audit_logs เพื่อการตรวจสอบย้อนหลัง +* 6.2. การค้นหา (Search): ระบบต้องมีฟังก์ชันการค้นหาขั้นสูง ที่สามารถค้นหาเอกสาร **correspondence**, **rfa**, **shop_drawing**, **contract-drawing**, **transmittal** และ **ใบเวียน (Circulations)** จากหลายเงื่อนไขพร้อมกันได้ เช่น ค้นหาจากชื่อเรื่อง, ประเภท, วันที่, และ Tag +* 6.3. การทำรายงาน (Reporting): สามารถจัดทำรายงานสรุปแยกประเภทของ Correspondence ประจำวัน, สัปดาห์, เดือน, และปีได้ +* 6.4. ประสิทธิภาพ (Performance): มีการใช้ Caching กับข้อมูลที่เรียกใช้บ่อย และใช้ Pagination ในตารางข้อมูลเพื่อจัดการข้อมูลจำนวนมาก +* 6.5. ความปลอดภัย (Security): + * มีระบบ Rate Limiting เพื่อป้องกันการโจมตีแบบ Brute-force + * การจัดการ Secret (เช่น รหัสผ่าน DB, JWT Secret) จะต้องทำผ่าน Environment Variable ของ Docker เพื่อความปลอดภัยสูงสุด +* 6.6. (ใหม่) การสำรองข้อมูลและการกู้คืน (Backup & Recovery): + * ระบบจะต้องมีกลไกการสำรองข้อมูลอัตโนมัติสำหรับฐานข้อมูล MariaDB [cite: 2.4] และไฟล์เอกสารทั้งหมดใน /share/dms-data [cite: 2.1] (เช่น ใช้ HBS 3 ของ QNAP หรือสคริปต์สำรองข้อมูล) อย่างน้อยวันละ 1 ครั้ง + * ต้องมีแผนการกู้คืนระบบ (Disaster Recovery Plan) ในกรณีที่ Server หลัก (QNAP) ใช้งานไม่ได้ +* 6.7. (ใหม่) กลยุทธ์การแจ้งเตือน (Notification Strategy): + * ระบบจะส่งการแจ้งเตือน (ผ่าน Email หรือ Line [cite: 2.7]) เมื่อมีการกระทำที่สำคัญ ดังนี้: + 1. เมื่อมีเอกสารใหม่ (Correspondence, RFA) ถูกส่งมาถึงองค์กรณ์ของเรา + 2. เมื่อมีใบเวียน (Circulation) ใหม่ มอบหมายงานมาที่เรา + 3. (ทางเลือก) เมื่อเอกสารที่เราส่งไป ถูกดำเนินการ (เช่น อนุมัติ/ปฏิเสธ) + 4. (ทางเลือก) เมื่อใกล้ถึงวันครบกำหนด (Deadline) [cite: 3.2.5, 3.6.6, 3.7.5] \ No newline at end of file diff --git a/docs/Markdown/LCBP3-DMS_V1_3_0_Data_Dictionary.md b/docs/Markdown/LCBP3-DMS_V1_3_0_Data_Dictionary.md new file mode 100644 index 0000000..c66beda --- /dev/null +++ b/docs/Markdown/LCBP3-DMS_V1_3_0_Data_Dictionary.md @@ -0,0 +1,775 @@ +--- +# **สรุปตารางฐานข้อมูล (Data Dictionary) - LCBP3-DMS (V1.3.00** +เอกสารนี้สรุปโครงสร้างตาราง, Foreign Keys (FK), และ Constraints ที่สำคัญทั้งหมดในฐานข้อมูล LCBP3-DMS (v1.3.0) เพื่อใช้เป็นเอกสารอ้างอิงสำหรับทีมพัฒนา Backend (NestJS) และ Frontend (Next.js) + +## **1\. 🏢 Core & Master Data (องค์กร, โครงการ, สัญญา)** + +#### **1.1. organization\_roles** + +ตาราง Master เก็บประเภทบทบาทขององค์กร (เช่น OWNER, CONTRACTOR) + +| Column | Type | Key | Description | +| :--- | :--- | :--- | :--- | +| id | INT | **PK** | ID ของตาราง | +| role\_name | VARCHAR(20) | UK | ชื่อบทบาท (OWNER, DESIGNER, CONSULTANT, CONTRACTOR, THIRD PARTY) | + +* **Unique Keys (UK):** ux\_roles\_name (role\_name) + +#### **1.2. organizations** + +ตาราง Master เก็บข้อมูลองค์กรทั้งหมดที่เกี่ยวข้องในระบบ + +| Column | Type | Key | Description | +| :--- | :--- | :--- | :--- | +| id | INT | **PK** | ID ของตาราง | +| organization\_code | VARCHAR(20) | UK | รหัสองค์กร | +| organization\_name | VARCHAR(255) | | ชื่อองค์กร | +| role\_id | INT | FK | บทบาทขององค์กร (FK \-> organization\_roles(id)) | +| is\_active | BOOLEAN | | สถานะการใช้งาน | + +* **Foreign Keys (FK):** + * role\_id \-> organization\_roles(id) (ON DELETE SET NULL) +* **Unique Keys (UK):** ux\_organizations\_code (organization\_code) + +#### **1.3. projects** + +ตาราง Master เก็บข้อมูลโครงการ (เช่น LCBP3C1, LCBP3C2) + +| Column | Type | Key | Description | +| :--- | :--- | :--- | :--- | +| id | INT | **PK** | ID ของตาราง | +| project\_code | VARCHAR(50) | UK | รหัสโครงการ | +| project\_name | VARCHAR(255) | | ชื่อโครงการ | +| parent\_project\_id | INT | FK | รหัสโครงการหลัก (ถ้ามี) (FK \-> projects(id)) | +| contractor\_organization\_id | INT | FK | รหัสองค์กรผู้รับเหมา (ถ้ามี) (FK \-> organizations(id)) | +| is\_active | TINYINT(1) | | สถานะการใช้งาน | + +* **Foreign Keys (FK):** + * parent\_project\_id \-> projects(id) (ON DELETE SET NULL) + * contractor\_organization\_id \-> organizations(id) (ON DELETE SET NULL) +* **Unique Keys (UK):** uq\_pro\_code (project\_code) + +#### **1.4. contracts** + +ตาราง Master เก็บข้อมูลสัญญา + +| Column | Type | Key | Description | +| :--- | :--- | :--- | :--- | +| id | INT | **PK** | ID ของตาราง | +| contract\_code | VARCHAR(50) | UK | รหัสสัญญา | +| contract\_name | VARCHAR(255) | | ชื่อสัญญา | +| description | TEXT | | คำอธิบายสัญญา | + +* **Unique Keys (UK):** ux\_contracts\_code (contract\_code) + +#### **1.5. project\_parties (ตารางเชื่อม)** + +ตารางเชื่อมความสัมพันธ์ระหว่าง โครงการ, องค์กร, และบทบาท (M:N) + +| Column | Type | Key | Description | +| :--- | :--- | :--- | :--- | +| project\_id | INT | **PK**, FK | ID ของโครงการ (FK \-> projects(id)) | +| organization\_id | INT | **PK**, FK | ID ขององค์กร (FK \-> organizations(id)) | +| role | ENUM(...) | **PK** | บทบาทในโครงการ (OWNER, DESIGNER, CONSULTANT, CONTRACTOR, THIRD\_PARTY) | +| is\_contractor | TINYINT(1) | UK | (Generated) \= 1 ถ้า role \= 'CONTRACTOR' | +| deleted\_at | DATETIME | | สำหรับ Soft Delete | + +* **Foreign Keys (FK):** + * project\_id \-> projects(id) (ON DELETE CASCADE) + * organization\_id \-> organizations(id) (ON DELETE RESTRICT) +* **Unique Keys (UK):** + * uq\_project\_parties\_contractor (project\_id, is\_contractor) \- **(Constraint สำคัญ)** บังคับว่า 1 โครงการมี CONTRACTOR ได้เพียง 1 องค์กร + +#### **1.6. contract\_parties (ตารางเชื่อม)** + +ตารางเชื่อมความสัมพันธ์ระหว่าง สัญญา, โครงการ, และองค์กร (M:N) + +| Column | Type | Key | Description | +| :--- | :--- | :--- | :--- | +| contract\_id | INT | **PK**, FK | ID ของสัญญา (FK \-> contracts(id)) | +| project\_id | INT | **PK**, FK | ID ของโครงการ (FK \-> projects(id)) | +| organization\_id | INT | **PK**, FK | ID ขององค์กร (FK \-> organizations(id)) | + +* **Foreign Keys (FK):** + * contract\_id \-> contracts(id) (ON DELETE CASCADE) + * project\_id \-> projects(id) (ON DELETE CASCADE) + * organization\_id \-> organizations(id) (ON DELETE CASCADE) + +--- + +## **2. 👥 Users & RBAC (ผู้ใช้, สิทธิ์, บทบาท)** + +### **2.1. users** + +ตาราง Master เก็บข้อมูลผู้ใช้งาน (User) + +| Column | Type | Key | Description | +| :--- | :--- | :--- | :--- | +| user\_id | INT | **PK** | ID ของตาราง | +| username | VARCHAR(50) | UK | ชื่อผู้ใช้งาน | +| password\_hash | VARCHAR(255) | | รหัสผ่าน (Hashed) | +| first\_name | VARCHAR(50) | | ชื่อจริง | +| last\_name | VARCHAR(50) | | นามสกุล | +| email | VARCHAR(100) | UK | อีเมล | +| organization\_id | INT | FK | สังกัดองค์กร (FK \-> organizations(id)) | +| is\_active | TINYINT(1) | | สถานะการใช้งาน | + +* **Foreign Keys (FK):** + * organization\_id \-> organizations(id) (ON DELETE SET NULL) +* **Unique Keys (UK):** ux\_users\_username (username), ux\_users\_email (email) + +#### **2.2. roles** + +ตาราง Master เก็บ "บทบาท" ของผู้ใช้ในระบบ (เช่น SUPER\_ADMIN, ADMIN, EDITOR) + +| Column | Type | Key | Description | +| :--- | :--- | :--- | :--- | +| role\_id | INT | **PK** | ID ของตาราง | +| role\_code | VARCHAR(50) | UK | รหัสบทบาท (เช่น SUPER\_ADMIN, ADMIN, EDITOR, VIEWER) | +| role\_name | VARCHAR(100) | | ชื่อบทบาท | +| is\_system | BOOLEAN | | (1 \= บทบาทของระบบ ลบไม่ได้) | + +* **Unique Keys (UK):** role\_code + +#### **2.3. permissions** + +ตาราง Master เก็บ "สิทธิ์" (Permission) หรือ "การกระทำ" ทั้งหมดในระบบ + +| Column | Type | Key | Description | +| :--- | :--- | :--- | :--- | +| permission\_id | INT | **PK** | ID ของตาราง | +| permission\_code | VARCHAR(100) | UK | รหัสสิทธิ์ (เช่น rfas.create, rfas.view) | +| module | VARCHAR(50) | | โมดูลที่เกี่ยวข้อง | +| scope\_level | ENUM(...) | | ระดับของสิทธิ์ (GLOBAL, ORG, PROJECT) | + +* **Unique Keys (UK):** ux\_permissions\_code (permission\_code) + +#### **2.4. role\_permissions (ตารางเชื่อม)** + +ตารางเชื่อมระหว่าง roles และ permissions (M:N) + +| Column | Type | Key | Description | +| :--- | :--- | :--- | :--- | +| role\_id | INT | **PK**, FK | ID ของบทบาท (FK \-> roles(role\_id)) | +| permission\_id | INT | **PK**, FK | ID ของสิทธิ์ (FK \-> permissions(permission\_id)) | + +* **Foreign Keys (FK):** + * role\_id \-> roles(role\_id) (ON DELETE CASCADE) + * permission\_id \-> permissions(permission\_id) (ON DELETE CASCADE) + +#### **2.5. user\_roles (ตารางเชื่อม)** + +ตารางเชื่อมผู้ใช้ (users) กับบทบาท (roles) ในระดับ **Global** (M:N) + +| Column | Type | Key | Description | +| :--- | :--- | :--- | :--- | +| user\_id | INT | **PK**, FK | ID ของผู้ใช้ (FK \-> users(user\_id)) | +| role\_id | INT | **PK**, FK | ID ของบทบาท (FK \-> roles(role\_id)) | + +* **Foreign Keys (FK):** + * user\_id \-> users(user\_id) (ON DELETE CASCADE) + * role\_id \-> roles(role\_id) (ON DELETE CASCADE) + +#### **2.6. user\_project\_roles (ตารางเชื่อม)** + +ตารางเชื่อมผู้ใช้ (users) กับบทบาท (roles) ในระดับ **Project-Specific** (M:N) + +| Column | Type | Key | Description | +| :--- | :--- | :--- | :--- | +| user\_id | INT | **PK**, FK | ID ของผู้ใช้ (FK \-> users(user\_id)) | +| project\_id | INT | **PK**, FK | ID ของโครงการ (FK \-> projects(id)) | +| role\_id | INT | **PK**, FK | ID ของบทบาท (FK \-> roles(role\_id)) | + +* **Foreign Keys (FK):** + * user\_id \-> users(user\_id) (ON DELETE CASCADE) + * project\_id \-> projects(id) (ON DELETE CASCADE) + * role\_id \-> roles(role\_id) (ON DELETE CASCADE) + +--- + +## **3\. ✉️ Correspondences (เอกสารหลัก, Revisions)** + +#### **3.1. correspondence\_types** + +ตาราง Master เก็บประเภทเอกสารโต้ตอบ (เช่น RFA, RFI, LETTER, MOM) + +| Column | Type | Key | Description | +| :--- | :--- | :--- | :--- | +| id | INT | **PK** | ID ของตาราง | +| type\_code | VARCHAR(50) | UK | รหัสประเภท (เช่น RFA, RFI) | +| type\_name | VARCHAR(255) | | ชื่อประเภท | + +* **Unique Keys (UK):** type\_code + +#### **3.2. correspondence\_status** + +ตาราง Master เก็บสถานะของเอกสาร (เช่น DRAFT, SUBMITTED, CLOSED) + +| Column | Type | Key | Description | +| :--- | :--- | :--- | :--- | +| id | INT | **PK** | ID ของตาราง | +| status\_code | VARCHAR(50) | UK | รหัสสถานะ (เช่น DRAFT, SUBOWN) | +| status\_name | VARCHAR(255) | | ชื่อสถานะ | + +* **Unique Keys (UK):** status\_code + +#### **3.3. correspondences (Master)** + +ตาราง "แม่" ของเอกสารโต้ตอบ เก็บข้อมูลที่ไม่เปลี่ยนแปลงตาม Revision (เช่น เลขที่เอกสาร) + +| Column | Type | Key | Description | +| :--- | :--- | :--- | :--- | +| id | INT | **PK** | ID ของตาราง (นี่คือ "Master ID" ที่ใช้เชื่อมโยง) | +| correspondence\_number | VARCHAR(100) | UK | เลขที่เอกสาร (สร้างจาก DocumentNumberingModule) | +| correspondence\_type\_id | INT | FK | ประเภทเอกสาร (FK \-> correspondence\_types(id)) | +| is\_internal\_communication | TINYINT(1) | | (1 \= ภายใน, 0 \= ภายนอก) | +| project\_id | INT | FK | อยู่ในโครงการ (FK \-> projects(id)) | +| originator\_id | INT | FK | องค์กรผู้ส่ง (FK \-> organizations(id)) | +| recipient\_id | INT | FK | องค์กรผู้รับ (FK \-> organizations(id)) | +| created\_by | INT | FK | ผู้สร้าง (FK \-> users(user\_id)) | +| deleted\_at | DATETIME | | สำหรับ Soft Delete | + +* **Foreign Keys (FK):** + * correspondence\_type\_id \-> correspondence\_types(id) (ON DELETE RESTRICT) + * project\_id \-> projects(id) (ON DELETE CASCADE) + * originator\_id \-> organizations(id) (ON DELETE SET NULL) + * recipient\_id \-> organizations(id) (ON DELETE SET NULL) + * created\_by \-> users(user\_id) (ON DELETE SET NULL) +* **Unique Keys (UK):** uq\_corr\_no\_per\_project (project\_id, correspondence\_number) + +#### **3.4. correspondence\_revisions (Revisions)** + +ตาราง "ลูก" เก็บประวัติการแก้ไข (Revisions) ของ correspondences (1:N) **(ปรับปรุง V1.2.0)** + +| Column | Type | Key | Description | +| :--- | :--- | :--- | :--- | +| id | INT | **PK** | **ID ของ Revision** | +| correspondence\_id | INT | FK, UK | Master ID (FK \-> correspondences(id)) | +| revision\_number | INT | UK | หมายเลข Revision (0, 1, 2...) | +| **revision\_label** | **VARCHAR(10)** | | **(ใหม่)** Revision ที่แสดง (เช่น A, B, 1.1) | +| is\_current | BOOLEAN | UK | (1 \= Revision ปัจจุบัน) | +| correspondence\_status\_id | INT | FK | สถานะของ Revision นี้ (FK \-> correspondence\_status(id)) | +| title | VARCHAR(255) | | เรื่อง | +| document\_date | DATE | | วันที่ในเอกสาร | +| issued\_date | DATETIME | | วันที่ออกเอกสาร | +| received\_date | DATETIME | | วันที่ลงรับ | +| **description** | **TEXT** | | **(ใหม่)** คำอธิบายการแก้ไขใน Revision นี้ | +| details | JSON | | ข้อมูลเฉพาะ (เช่น RFI details) | +| **created\_at** | **DATETIME** | | **(ใหม่)** วันที่สร้างเอกสาร | +| created\_by | INT | FK | ผู้สร้าง (FK \-> users(user\_id)) | +| **updated\_by** | **INT** | **FK** | **(ใหม่)** ผู้แก้ไขล่าสุด (FK \-> users(user\_id)) | + +* **Foreign Keys (FK):** + * correspondence\_id \-> correspondences(id) (ON DELETE CASCADE) + * correspondence\_status\_id \-> correspondence\_status(id) (ON DELETE RESTRICT) + * created\_by \-> users(user\_id) (ON DELETE SET NULL) + * **updated\_by \-> users(user\_id) (ON DELETE SET NULL)** +* **Unique Keys (UK):** + * uq\_master\_revision\_number (correspondence\_id, revision\_number) (ป้องกัน Rev ซ้ำใน Master เดียว) + * uq\_master\_current (correspondence\_id, is\_current) (ป้องกันการมี is\_current \= TRUE ซ้ำใน Master เดียว) +* **Check Constraints (CHK):** chk\_rev\_format (ตรวจสอบรูปแบบ revision\_label) + +#### **3.5. correspondence\_recipients (ตารางเชื่อม)** + +ตารางเชื่อมผู้รับ (TO/CC) สำหรับเอกสารแต่ละฉบับ (M:N) + +| Column | Type | Key | Description | +| :--- | :--- | :--- | :--- | +| correspondence\_id | INT | **PK**, FK | ID ของเอกสาร (FK \-> correspondence\_revisions(correspondence\_id)) | +| recipient\_organization\_id | INT | **PK**, FK | ID องค์กรผู้รับ (FK \-> organizations(id)) | +| recipient\_type | ENUM('TO', 'CC') | **PK** | ประเภทผู้รับ (TO หรือ CC) | + +* **Foreign Keys (FK):** + * correspondence\_id \-> correspondence\_revisions(correspondence\_id) (ON DELETE CASCADE) + * recipient\_organization\_id \-> organizations(id) (ON DELETE RESTRICT) + +#### **3.6. correspondence\_references (ตารางเชื่อม)** + +ตารางเชื่อมการอ้างอิงระหว่างเอกสาร (M:N) + +| Column | Type | Key | Description | +| :--- | :--- | :--- | :--- | +| src\_correspondence\_id | INT | **PK**, FK | ID เอกสารต้นทาง (FK \-> correspondences(id)) | +| tgt\_correspondence\_id | INT | **PK**, FK | ID เอกสารเป้าหมาย (FK \-> correspondences(id)) | + +* **Foreign Keys (FK):** + * src\_correspondence\_id \-> correspondences(id) (ON DELETE CASCADE) + * tgt\_correspondence\_id \-> correspondences(id) (ON DELETE CASCADE) + +#### **3.7. correspondence\_routing\_templates / ...\_steps / ...\_routings** + +ตารางที่เกี่ยวข้องกับ Workflow การส่งต่อเอกสาร (Req 3.5.4) + +* **correspondence\_routing\_templates:** ตาราง Master เก็บแม่แบบสายงาน (เช่น "ส่งให้ CSC ตรวจสอบ") +* **correspondence\_routing\_template\_steps:** ตารางลูก เก็บขั้นตอนในแม่แบบ (เช่น Step 1: ส่งไป Org A, Step 2: ส่งไป Org B) +* **correspondence\_routings:** ตารางประวัติ (Log) การส่งต่อของเอกสารจริงตาม Workflow + +--- + +## **4\. approval: RFA (เอกสารขออนุมัติ, Workflows)** + +#### **4.1. rfa\_types / ...\_status\_codes / ...\_approve\_codes** + +ตาราง Master สำหรับ RFA + +* **rfa\_types:** ประเภท RFA (เช่น DWG, DOC, MAT) +* **rfa\_status\_codes:** สถานะ RFA (เช่น DFT \- Draft, FAP \- For Approve) +* **rfa\_approve\_codes:** รหัสผลการอนุมัติ (เช่น 1A \- Approved, 3R \- Revise and Resubmit) + +#### **4.2. rfas (Master)** + +ตาราง "แม่" ของ RFA (มีความสัมพันธ์ 1:N กับ rfa\_revisions) + +| Column | Type | Key | Description | +| :--- | :--- | :--- | :--- | +| id | INT | **PK** | ID ของตาราง (RFA Master ID) | +| rfa\_type\_id | INT | FK | ประเภท RFA (FK \-> rfa\_types(id)) | +| revision\_number | INT | | หมายเลข Revision ล่าสุด (ข้อมูลนี้ถูกย้ายไป rfa\_revisions) | +| created\_by | INT | FK | ผู้สร้าง (FK \-> users(user\_id)) | +| deleted\_at | DATETIME | | สำหรับ Soft Delete | + +* **Foreign Keys (FK):** + * rfa\_type\_id \-> rfa\_types(id) + * created\_by \-> users(user\_id) (ON DELETE SET NULL) + +#### **4.3. rfa\_revisions (Revisions)** + +ตาราง "ลูก" เก็บประวัติ (Revisions) ของ rfas (1:N) **(ปรับปรุง V1.2.0)** + +| Column | Type | Key | Description | +| :--- | :--- | :--- | :--- | +| id | INT | **PK** | **ID ของ Revision** | +| correspondence\_id | INT | FK | Master ID ของ Correspondence (FK \-> correspondences(id)) | +| rfa\_id | INT | FK, UK | Master ID ของ RFA (FK \-> rfas(id)) | +| revision\_number | INT | UK | หมายเลข Revision (0, 1, 2...) | +| **revision\_label** | **VARCHAR(10)** | | **(ใหม่)** Revision ที่แสดง (เช่น A, B, 1.1) | +| is\_current | BOOLEAN | UK | (1 \= Revision ปัจจุบัน) | +| rfa\_status\_code\_id | INT | FK | สถานะ RFA (FK \-> rfa\_status\_codes(id)) | +| rfa\_approve\_code\_id | INT | FK | ผลการอนุมัติ (FK \-> rfa\_approve\_codes(id)) | +| title | VARCHAR(255) | | เรื่อง | +| **document\_date** | **DATE** | | **(ใหม่)** วันที่ในเอกสาร | +| **issued\_date** | **DATE** | | **(ใหม่)** วันที่ส่งขออนุมัติ | +| **received\_date** | **DATETIME** | | **(ใหม่)** วันที่ลงรับเอกสาร | +| **approved\_date** | **DATE** | | **(ใหม่)** วันที่อนุมัติ | +| **description** | **TEXT** | | **(ใหม่)** คำอธิบายการแก้ไขใน Revision นี้ | +| **created\_at** | **DATETIME** | | **(ใหม่)** วันที่สร้างเอกสาร | +| created\_by | INT | FK | ผู้สร้าง (FK \-> users(user\_id)) | +| **updated\_by** | **INT** | **FK** | **(ใหม่)** ผู้แก้ไขล่าสุด (FK \-> users(user\_id)) | + +* **Foreign Keys (FK):** + * correspondence\_id \-> correspondences(id) (ON DELETE CASCADE) + * rfa\_id \-> rfas(id) (ON DELETE CASCADE) + * rfa\_status\_code\_id \-> rfa\_status\_codes(id) + * rfa\_approve\_code\_id \-> rfa\_approve\_codes(id) (ON DELETE SET NULL) + * created\_by \-> users(user\_id) (ON DELETE SET NULL) + * **updated\_by \-> users(user\_id) (ON DELETE SET NULL)** +* **Unique Keys (UK):** + * uq\_rr\_rev\_number (rfa\_id, revision\_number) (ป้องกัน Rev ซ้ำใน Master เดียว) + * uq\_rr\_current (rfa\_id, is\_current) (ป้องกัน is\_current=TRUE ซ้ำใน Master เดียว) + +#### **4.4. rfa\_items (ตารางเชื่อม)** + +ตารางเชื่อมระหว่าง rfa\_revisions (ที่เป็นประเภท DWG) กับ shop\_drawing\_revisions (M:N) + +| Column | Type | Key | Description | +| :--- | :--- | :--- | :--- | +| rfarev\_correspondence\_id | INT | **PK**, FK | ID ของ RFA Revision (FK \-> rfa\_revisions(correspondence\_id)) | +| shop\_drawing\_revision\_id | INT | **PK**, UK, FK | ID ของ Shop Drawing Revision (FK \-> shop\_drawing\_revisions(id)) | + +* **Foreign Keys (FK):** + * rfarev\_correspondence\_id \-> rfa\_revisions(correspondence\_id) (ON DELETE CASCADE) + * shop\_drawing\_revision\_id \-> shop\_drawing\_revisions(id) (ON DELETE CASCADE) + +#### **4.5. rfa\_workflow\_templates / ...\_steps / ...\_workflows** + +ตารางที่เกี่ยวข้องกับ Workflow การอนุมัติ RFA + +* **rfa\_workflow\_templates:** ตาราง Master เก็บแม่แบบสายอนุมัติ (เช่น "สายอนุมัติ 3 ขั้นตอน") +* **rfa\_workflow\_template\_steps:** ตารางลูก เก็บขั้นตอนในแม่แบบ (เช่น Step 1: Org A (Review), Step 2: Org B (Approve)) +* **rfa\_workflows:** ตารางประวัติ (Log) การอนุมัติของ RFA จริงตามสายงาน + +--- + +## **5\. 📐 Drawings (แบบ, หมวดหมู่)** + +#### **5.1. contract\_drawing\_volumes / ...\_cats / ...\_sub\_cats** + +ตาราง Master สำหรับ "แบบคู่สัญญา" (Contract Drawings) + +* **contract\_drawing\_volumes:** เก็บ "เล่ม" ของแบบ +* **contract\_drawing\_cats:** เก็บ "หมวดหมู่หลัก" ของแบบ +* **contract\_drawing\_sub\_cats:** เก็บ "หมวดหมู่ย่อย" ของแบบ + +#### **5.2. contract\_drawing\_subcat\_cat\_maps (ตารางเชื่อม - ใหม่)** + +**(ใหม่)** ตารางเชื่อมระหว่าง หมวดหมู่หลัก-ย่อย (M:N) + +| Column | Type | Key | Description | +| :--- | :--- | :--- | :--- | +| project\_id | INT | **PK**, FK | ID ของโครงการ | +| sub\_cat\_id | INT | **PK**, FK | ID ของหมวดหมู่ย่อย | +| cat\_id | INT | **PK**, FK | ID ของหมวดหมู่หลัก | + +* **Foreign Keys (FK) (ตามเจตนา):** + * (project\_id, sub\_cat\_id) \-> contract\_drawing\_sub\_cats(project\_id, id) + * (project\_id, cat\_id) \-> contract\_drawing\_cats(project\_id, id) +* **Unique Keys (UK):** + * ux\_map\_unique (project\_id, sub\_cat\_id, cat\_id) +* ***ข้อสังเกตจาก DBA:*** *สคริปต์ SQL (1.3.6) มีการอ้างอิง FK ไปยังตารางและคอลัมน์ (`contract_dwg_sub_cat(project_id, sub_cat_id)`) ที่ไม่มีอยู่จริง ตารางนี้แสดงตามเจตนาที่ถูกต้อง* + +#### **5.3. contract\_drawings (Master)** + +ตาราง Master เก็บข้อมูล "แบบคู่สัญญา" + +| Column | Type | Key | Description | +| :--- | :--- | :--- | :--- | +| id | INT | **PK** | ID ของตาราง | +| project\_id | INT | FK, UK | โครงการ (FK \-> projects(id)) | +| condwg\_no | VARCHAR(255) | UK | เลขที่แบบสัญญา | +| title | VARCHAR(255) | | ชื่อแบบ | +| sub\_cat\_id | INT | FK | หมวดหมู่ย่อย (FK \-> contract\_drawing\_sub\_cats(id)) | +| volume\_id | INT | FK | เล่ม (FK \-> contract\_drawing\_volumes(id)) | + +* **Foreign Keys (FK):** + * fk\_condwg\_project (project\_id) \-> projects(id) (ON DELETE CASCADE) + * fk\_condwg\_subcat\_same\_project (project\_id, sub\_cat\_id) \-> contract\_drawing\_sub\_cats(project\_id, id) + * fk\_condwg\_volume\_same\_project (project\_id, volume\_id) \-> contract\_drawing\_volumes(project\_id, id) +* **Unique Keys (UK):** ux\_condwg\_no\_project (project\_id, condwg\_no) + +#### **5.4. shop\_drawing\_main\_categories / ...\_sub\_categories** + +ตาราง Master สำหรับ "แบบก่อสร้าง" (Shop Drawings) + +* **shop\_drawing\_main\_categories:** เก็บ "หมวดหมู่หลัก" (เช่น ARCH, STR) +* **shop\_drawing\_sub\_categories:** เก็บ "หมวดหมู่ย่อย" (เช่น STR-COLUMN) + +#### **5.5. shop\_drawings (Master)** + +ตาราง Master เก็บข้อมูล "แบบก่อสร้าง" + +| Column | Type | Key | Description | +| :--- | :--- | :--- | :--- | +| id | INT | **PK** | ID ของตาราง | +| project\_id | INT | FK | โครงการ (FK \-> projects(id)) | +| drawing\_number | VARCHAR(100) | UK | เลขที่ Shop Drawing | +| title | VARCHAR(500) | | ชื่อแบบ | +| main\_category\_id | INT | FK | หมวดหมู่หลัก (FK \-> shop\_drawing\_main\_categories(id)) | +| sub\_category\_id | INT | FK | หมวดหมู่ย่อย (FK \-> shop\_drawing\_sub\_categories(id)) | + +* **Foreign Keys (FK):** project\_id, main\_category\_id, sub\_category\_id +* **Unique Keys (UK):** ux\_sd\_drawing\_number (drawing\_number) + +#### **5.6. shop\_drawing\_revisions (Revisions)** + +ตาราง "ลูก" เก็บประวัติ (Revisions) ของ shop\_drawings (1:N) + +| Column | Type | Key | Description | +| :--- | :--- | :--- | :--- | +| id | INT | **PK** | ID ของ Revision | +| shop\_drawing\_id | INT | FK, UK | Master ID (FK \-> shop\_drawings(id)) | +| revision\_number | VARCHAR(10) | UK | หมายเลข Revision (เช่น A, B, 0, 1) | +| revision\_date | DATE | | วันที่ของ Revision | +| description | TEXT | | คำอธิบายการแก้ไข | + +* **Foreign Keys (FK):** + * shop\_drawing\_id \-> shop\_drawings(id) (ON DELETE CASCADE) +* **Unique Keys (UK):** ux\_sd\_rev\_drawing\_revision (shop\_drawing\_id, revision\_number) + +#### **5.7. shop\_drawing\_revision\_contract\_refs (ตารางเชื่อม)** + +ตารางเชื่อมระหว่าง shop\_drawing\_revisions กับ contract\_drawings (M:N) + +| Column | Type | Key | Description | +| :--- | :--- | :--- | :--- | +| shop\_drawing\_revision\_id | INT | FK | ID ของ Shop Drawing Revision (FK \-> shop\_drawing\_revisions(id)) | +| contract\_drawing\_id | INT | FK | ID ของ Contract Drawing (FK \-> contract\_drawings(id)) | + +* **Foreign Keys (FK):** shop\_drawing\_revision\_id, contract\_drawing\_id + +--- + +## **6\. 🔄 Circulations (ใบเวียนภายใน)** + +#### **6.1. circulation\_status\_codes** + +ตาราง Master เก็บสถานะใบเวียน (เช่น OPEN, IN\_REVIEW, COMPLETED) + +#### **6.2. circulations (Master)** + +ตาราง "แม่" ของใบเวียนเอกสารภายใน + +| Column | Type | Key | Description | +| :--- | :--- | :--- | :--- | +| id | INT | **PK** | ID ของตาราง | +| correspondence\_id | INT | UK, FK | เอกสารที่ใช้อ้างอิง (FK \-> correspondences(id)) | +| organization\_id | INT | FK, UK | องค์กรเจ้าของใบเวียน (FK \-> organizations(id)) | +| circulation\_no | VARCHAR(100) | UK | เลขที่ใบเวียน | +| circulation\_subject | VARCHAR(500) | | เรื่อง | +| circulation\_status\_code | VARCHAR(20) | FK | สถานะใบเวียน (FK \-> circulation\_status\_codes(code)) | +| created\_by\_user\_id | INT | FK | ผู้สร้าง (FK \-> users(user\_id)) | + +* **Foreign Keys (FK):** correspondence\_id, organization\_id, circulation\_status\_code, created\_by\_user\_id +* **Unique Keys (UK):** + * correspondence\_id (1 ใบเวียน ต่อ 1 เอกสาร) + * uq\_cir\_org\_no (organization\_id, circulation\_no) (เลขที่ใบเวียนห้ามซ้ำในองค์กร) + +#### **6.3. circulation\_recipients / ...\_assignees / ...\_actions** + +ตาราง "ลูก" ของ circulations + +* **circulation\_recipients:** รายชื่อผู้รับ (TO/CC) ภายในองค์กร +* **circulation\_assignees:** รายชื่อผู้รับผิดชอบ (MAIN, ACTION, INFO) และเก็บ deadline +* **circulation\_actions:** ประวัติการดำเนินการ (เช่น Comment, Forward, Close) +* **circulation\_action\_documents:** ตารางเชื่อม circulation\_actions กับ attachments (ไฟล์แนบระหว่างดำเนินการ) + +#### **6.4. circulation\_templates / ...\_assignees** + +ตารางสำหรับแม่แบบใบเวียน (Templates) + +* **circulation\_templates:** ตาราง Master เก็บแม่แบบใบเวียน +* **circulation\_template\_assignees:** ตารางลูก เก็บผู้รับผิดชอบที่กำหนดไว้ล่วงหน้าในแม่แบบ + +--- + +## **7\. 📤 Transmittals (เอกสารนำส่ง)** + +#### **7.1. transmittals** + +ตารางข้อมูลเฉพาะของเอกสารนำส่ง (เป็นตารางลูก 1:1 ของ correspondences) + +| Column | Type | Key | Description | +| :--- | :--- | :--- | :--- | +| correspondence\_id | INT | **PK**, FK | ID ของเอกสาร (FK \-> correspondences(id)) | +| purpose | ENUM(...) | | วัตถุประสงค์ (FOR\_APPROVAL, FOR\_INFORMATION, ...) | +| remarks | TEXT | | หมายเหตุ | + +* **Foreign Keys (FK):** correspondence\_id \-> correspondences(id) (ON DELETE CASCADE) + +#### **7.2. transmittal\_items (ตารางเชื่อม)** + +ตารางเชื่อมระหว่าง transmittals และเอกสารที่นำส่ง (M:N) **(ปรับปรุง V1.2.0)** + +| Column | Type | Key | Description | +| :--- | :--- | :--- | :--- | +| **id** | **INT** | **PK** | **(ใหม่)** ID ของรายการ | +| transmittal\_id | INT | **FK**, UK | ID ของ Transmittal (FK \-> transmittals(correspondence\_id)) | +| **item\_correspondence\_id** | **INT** | **FK**, UK | **(เปลี่ยน)** ID ของเอกสารที่แนบไป (FK \-> correspondences(id)) | +| **quantity** | **INT** | | **(ใหม่)** จำนวน | +| **remarks** | **VARCHAR(255)** | | **(ใหม่)** หมายเหตุสำหรับรายการนี้ | + +* **Foreign Keys (FK):** + * transmittal\_id \-> transmittals(correspondence\_id) (ON DELETE CASCADE) + * **item\_correspondence\_id \-> correspondences(id) (ON DELETE CASCADE)** +* **Unique Keys (UK):** ux\_transmittal\_item (transmittal\_id, item\_correspondence\_id) + +--- + +## **8\. 📎 File Management (ไฟล์แนบ)** + +#### **8.1. attachments (Master)** + +ตาราง "กลาง" เก็บไฟล์แนบทั้งหมดของระบบ + +| Column | Type | Key | Description | +| :--- | :--- | :--- | :--- | +| id | INT | **PK** | ID ของไฟล์แนบ | +| original\_filename | VARCHAR(255) | | ชื่อไฟล์ดั้งเดิม | +| stored\_filename | VARCHAR(255) | | ชื่อไฟล์ที่เก็บจริง (ป้องกันซ้ำ) | +| file\_path | VARCHAR(500) | | Path ที่เก็บไฟล์ (บน QNAP /share/dms-data/) | +| mime\_type | VARCHAR(100) | | ประเภทไฟล์ (เช่น application/pdf) | +| file\_size | INT | | ขนาดไฟล์ (bytes) | +| uploaded\_by\_user\_id | INT | FK | ผู้อัปโหลด (FK \-> users(user\_id)) | + +* **Foreign Keys (FK):** uploaded\_by\_user\_id \-> users(user\_id) (ON DELETE CASCADE) + +#### **8.2. correspondence\_attachments (ตารางเชื่อม - ใหม่)** + +ตารางเชื่อม correspondences กับ attachments (M:N) + +| Column | Type | Key | Description | +| :--- | :--- | :--- | :--- | +| correspondence\_id | INT | **PK**, FK | ID ของเอกสาร (FK \-> correspondences(id)) | +| attachment\_id | INT | **PK**, FK | ID ของไฟล์แนบ (FK \-> attachments(id)) | +| is\_main\_document | BOOLEAN | | (1 \= ไฟล์หลัก) | + +* **Foreign Keys (FK):** correspondence\_id, attachment\_id + +#### **8.3. circulation\_attachments (ตารางเชื่อม - ใหม่)** + +ตารางเชื่อม circulations กับ attachments (M:N) + +| Column | Type | Key | Description | +| :--- | :--- | :--- | :--- | +| circulation\_id | INT | **PK**, FK | ID ของใบเวียน (FK \-> circulations(id)) | +| attachment\_id | INT | **PK**, FK | ID ของไฟล์แนบ (FK \-> attachments(id)) | +| is\_main\_document | BOOLEAN | | (1 \= ไฟล์หลัก) | + +* **Foreign Keys (FK):** circulation\_id, attachment\_id + +#### **8.4. shop\_drawing\_revision\_attachments (ตารางเชื่อม - ใหม่)** + +ตารางเชื่อม shop\_drawing\_revisions กับ attachments (M:N) **(ปรับปรุง V1.2.0)** + +| Column | Type | Key | Description | +| :--- | :--- | :--- | :--- | +| shop\_drawing\_revision\_id | INT | **PK**, FK | ID ของ Drawing Revision (FK \-> shop\_drawing\_revisions(id)) | +| attachment\_id | INT | **PK**, FK | ID ของไฟล์แนบ (FK \-> attachments(id)) | +| file\_type | ENUM(...) | | ประเภทไฟล์ (PDF, DWG, SOURCE, OTHER) | +| **is\_main\_document** | **BOOLEAN** | | **(ใหม่)** (1 \= ไฟล์หลัก) | + +* **Foreign Keys (FK):** shop\_drawing\_revision\_id, attachment\_id + +#### **8.5. contract\_drawing\_attachments (ตารางเชื่อม - ใหม่)** + +**(ใหม่)** ตารางเชื่อม contract\_drawings กับ attachments (M:N) + +| Column | Type | Key | Description | +| :--- | :--- | :--- | :--- | +| contract\_drawing\_id | INT | **PK**, FK | ID ของ Contract Drawing (FK \-> contract\_drawings(id)) | +| attachment\_id | INT | **PK**, FK | ID ของไฟล์แนบ (FK \-> attachments(id)) | +| file\_type | ENUM(...) | | ประเภทไฟล์ (PDF, DWG, SOURCE, OTHER) | +| is\_main\_document | BOOLEAN | | (1 \= ไฟล์หลัก) | + +* **Foreign Keys (FK):** + * contract\_drawing\_id \-> contract\_drawings(id) (ON DELETE CASCADE) + * attachment\_id \-> attachments(id) (ON DELETE CASCADE) + +--- + +## **9\. 🔢 Document Numbering (การสร้างเลขที่เอกสาร)** + +#### **9.1. document\_number\_formats (ตารางตั้งค่า - ใหม่)** + +ตาราง Master เก็บ "รูปแบบ" Template ของเลขที่เอกสาร + +| Column | Type | Key | Description | +| :--- | :--- | :--- | :--- | +| id | INT | **PK** | ID ของตาราง | +| project\_id | INT | FK, UK | โครงการ (FK \-> projects(id)) | +| correspondence\_type\_id | INT | FK, UK | ประเภทเอกสาร (FK \-> correspondence\_types(id)) | +| format\_template | VARCHAR(255) | | รูปแบบ Template (เช่น {ORG\_CODE}-{TYPE\_CODE}-{SEQ:4}) | + +* **Foreign Keys (FK):** project\_id, correspondence\_type\_id +* **Unique Keys (UK):** uk\_project\_type (project\_id, correspondence\_type\_id) + +#### **9.2. document\_number\_counters (ตารางตัวนับ - ใหม่)** + +ตารางเก็บ "ตัวนับ" (Running Number) ล่าสุด + +| Column | Type | Key | Description | +| :--- | :--- | :--- | :--- | +| project\_id | INT | **PK**, FK | โครงการ (FK \-> projects(id)) | +| originator\_organization\_id | INT | **PK**, FK | องค์กรผู้ส่ง (FK \-> organizations(id)) | +| correspondence\_type\_id | INT | **PK**, FK | ประเภทเอกสาร (FK \-> correspondence\_types(id)) | +| current\_year | INT | **PK** | ปี ค.ศ. ของตัวนับ | +| last\_number | INT | | เลขที่ล่าสุดที่ใช้ไป | + +* **Foreign Keys (FK):** project\_id, originator\_organization\_id, correspondence\_type\_id + +--- + +## **10\. ⚙️ System & Logs (ระบบและ Log)** + +#### **10.1. tags** + +ตาราง Master เก็บ Tags ทั้งหมดที่ใช้ในระบบ + +| Column | Type | Key | Description | +| :--- | :--- | :--- | :--- | +| id | INT | **PK** | ID ของตาราง | +| tag\_name | VARCHAR(100) | UK | ชื่อ Tag | + +* **Unique Keys (UK):** ux\_tag\_name (tag\_name) + +#### **10.2. correspondence\_tags (ตารางเชื่อม)** + +ตารางเชื่อมระหว่าง correspondences และ tags (M:N) + +| Column | Type | Key | Description | +| :--- | :--- | :--- | :--- | +| correspondence\_id | INT | **PK**, FK | ID ของเอกสาร (FK \-> correspondences(id)) | +| tag\_id | INT | **PK**, FK | ID ของ Tag (FK \-> tags(id)) | + +* **Foreign Keys (FK):** correspondence\_id, tag\_id + +#### **10.3. audit\_logs** + +ตารางเก็บบันทึกการกระทำของผู้ใช้ + +| Column | Type | Key | Description | +| :--- | :--- | :--- | :--- | +| audit\_id | BIGINT | **PK** | ID ของ Log | +| user\_id | INT | FK | ผู้กระทำ (FK \-> users(user\_id)) | +| action | VARCHAR(100) | | การกระทำ (เช่น rfa.create) | +| entity\_type | VARCHAR(50) | | ตาราง/โมดูล (เช่น rfas) | +| entity\_id | VARCHAR(50) | | ID ของสิ่งที่ถูกกระทำ | +| details\_json | JSON | | ข้อมูลเพิ่มเติม | +| ip\_address | VARCHAR(45) | | IP Address | +| created\_at | TIMESTAMP | | เวลาที่กระทำ | + +* **Foreign Keys (FK):** user\_id \-> users(user\_id) (ON DELETE SET NULL) + +#### **10.4. global\_default\_roles (ใหม่)** + +ตารางเก็บค่าเริ่มต้นของบทบาทองค์กร (เช่น OWNER, DESIGNER) + +| Column | Type | Key | Description | +| :--- | :--- | :--- | :--- | +| id | TINYINT | **PK** | ID คงที่ ( \= 1) | +| role | ENUM(...) | **PK** | บทบาท (OWNER, DESIGNER, CONSULTANT) | +| position | TINYINT | **PK** | ลำดับที่ในบทบาท (1..n) | +| organization\_id | INT | FK, UK | ID องค์กร (FK \-> organizations(id)) | + +* **Foreign Keys (FK):** organization\_id \-> organizations(id) (ON DELETE RESTRICT) +* **Unique Keys (UK):** ux\_gdr\_unique\_org\_per\_role (id, role, organization\_id) + +#### **10.5. Workflow Transition Rules (ใหม่)** + +ตารางกำหนด Business Rules สำหรับการเปลี่ยนสถานะ + +* **correspondence\_status\_transitions:** (ใหม่) กฎการเปลี่ยนสถานะของ Correspondences (ทั่วไป) +* **rfa\_status\_transitions:** (ใหม่) กฎการเปลี่ยนสถานะของ RFA +* **circulation\_status\_transitions:** (ใหม่) กฎการเปลี่ยนสถานะของ Circulations (ใบเวียน) + +--- + +## **11\. 📋 Views & Procedures (วิว และ โปรซีเดอร์)** + +#### **11.1. sp\_get\_next\_document\_number (Procedure)** + +**(ใหม่)** Stored Procedure เดียวที่ใช้ในระบบ + +* **หน้าที่:** ดึงเลขที่เอกสารถัดไป (Next Running Number) จากตาราง document\_number\_counters +* **ตรรกะ:** ใช้ `SELECT ... FOR UPDATE` เพื่อ "ล็อก" แถว ป้องกัน Race Condition (การที่ผู้ใช้ 2 คนได้เลขที่ซ้ำกัน) + +#### **11.2. v\_current\_correspondences (View)** + +* **หน้าที่:** แสดง Revision "ปัจจุบัน" (is\_current \= TRUE) ของ correspondences ทั้งหมด (ที่ไม่ใช่ RFA) + +#### **11.3. v\_current\_rfas (View)** + +* **หน้าที่:** แสดง Revision "ปัจจุบัน" (is\_current \= TRUE) ของ rfa\_revisions ทั้งหมด + +#### **11.4. v\_contract\_parties\_all (View)** + +* **หน้าที่:** แสดงความสัมพันธ์ทั้งหมดระหว่าง Contract, Project, และ Organization + +#### **11.5. v\_user\_tasks (View)** + +**(ใหม่)** + +* **หน้าที่:** แสดงรายการ "งานของฉัน" (My Tasks) ที่ยังไม่เสร็จ +* **ตรรกะ:** JOIN ตาราง circulations กับ circulation\_assignees (ที่ is\_completed \= FALSE) + +#### **11.6. v\_audit\_log\_details (View)** + +**(ใหม่)** + +* **หน้าที่:** แสดง audit\_logs พร้อมข้อมูล username และ email ของผู้กระทำ + +#### **11.7. v\_user\_all\_permissions (View)** + +**(ใหม่)** + +* **หน้าที่:** รวมสิทธิ์ทั้งหมด (Global \+ Project) ของผู้ใช้ทุกคน เพื่อให้ Backend ตรวจสอบสิทธิ์ได้ง่าย +* **ตรรกะ:** UNION ข้อมูลจาก user\_roles และ user\_project\_roles \ No newline at end of file diff --git a/docs/Markdown/LCBP3-DMS_V1_3_0_FullStackJS.md b/docs/Markdown/LCBP3-DMS_V1_3_0_FullStackJS.md new file mode 100644 index 0000000..653197a --- /dev/null +++ b/docs/Markdown/LCBP3-DMS_V1_3_0_FullStackJS.md @@ -0,0 +1,478 @@ +# **Documents Management Sytem Version 1.3.0: แนวทางการพัฒนา FullStackJS** + +## **🧠 ปรัชญาทั่วไป** + +แนวทางปฏิบัติที่ดีที่สุดแบบครบวงจรสำหรับการพัฒนา NestJS Backend, NextJS Frontend และ Tailwind-based UI/UX ในสภาพแวดล้อม TypeScript มุ่งเน้นที่ ความชัดเจน (clarity), ความง่ายในการบำรุงรักษา (maintainability), ความสอดคล้องกัน (consistency) และ การเข้าถึงได้ (accessibility) ตลอดทั้งสแต็ก + +## **⚙️ แนวทางทั่วไปสำหรับ TypeScript** + +### **หลักการพื้นฐาน** + +* ใช้ **ภาษาอังกฤษ** สำหรับโค้ด +* ใช้ **ภาษาไทย** สำหรับ comment และเอกสารทั้งหมด +* กำหนดไทป์ (type) อย่างชัดเจนสำหรับตัวแปร, พารามิเตอร์ และค่าที่ส่งกลับ (return values) ทั้งหมด +* หลีกเลี่ยงการใช้ any; ให้สร้างไทป์ (types) หรืออินเทอร์เฟซ (interfaces) ที่กำหนดเอง +* ใช้ **JSDoc** สำหรับคลาส (classes) และเมธอด (methods) ที่เป็น public +* ส่งออก (Export) **สัญลักษณ์หลัก (main symbol) เพียงหนึ่งเดียว** ต่อไฟล์ +* หลีกเลี่ยงบรรทัดว่างภายในฟังก์ชัน +* ระบุ // File: path/filename ในบรรทัดแรกของทุกไฟล์ +* ระบุ // บันทึกการแก้ไข, หากมีการแก้ไขเพิ่มในอนาคต ให้เพิ่มบันทึก + +### **ข้อตกลงในการตั้งชื่อ (Naming Conventions)** + +| Entity (สิ่งที่ตั้งชื่อ) | Convention (รูปแบบ) | Example (ตัวอย่าง) | +| :---- | :---- | :---- | +| Classes | PascalCase | UserService | +| Property | snake_sase | user_id | +| Variables & Functions | camelCase | getUserInfo | +| Files & Folders | kebab-case | user-service.ts | +| Environment Variables | UPPERCASE | DATABASE\URL | +| Booleans | Verb \+ Noun | isActive, canDelete, hasPermission | + +ใช้คำเต็ม — ไม่ใช้อักษรย่อ — ยกเว้นคำมาตรฐาน (เช่น API, URL, req, res, err, ctx) + +## **🧩 ฟังก์ชัน (Functions)** + +* เขียนฟังก์ชันให้สั้น และทำ **หน้าที่เพียงอย่างเดียว** (single-purpose) (\< 20 บรรทัด) +* ใช้ **early returns** เพื่อลดการซ้อน (nesting) ของโค้ด +* ใช้ **map**, **filter**, **reduce** แทนการใช้ loops เมื่อเหมาะสม +* ควรใช้ **arrow functions** สำหรับตรรกะสั้นๆ, และใช้ **named functions** ในกรณีอื่น +* ใช้ **default parameters** แทนการตรวจสอบค่า null +* จัดกลุ่มพารามิเตอร์หลายตัวให้เป็นอ็อบเจกต์เดียว (RO-RO pattern) +* ส่งค่ากลับ (Return) เป็นอ็อบเจกต์ที่มีไทป์กำหนด (typed objects) ไม่ใช่ค่าพื้นฐาน (primitives) +* รักษาระดับของสิ่งที่เป็นนามธรรม (abstraction level) ให้เป็นระดับเดียวในแต่ละฟังก์ชัน + +## **🧱 การจัดการข้อมูล (Data Handling)** + +* ห่อหุ้มข้อมูล (Encapsulate) ในไทป์แบบผสม (composite types) +* ใช้ **immutability** (การไม่เปลี่ยนแปลงค่า) ด้วย readonly และ as const +* ทำการตรวจสอบความถูกต้องของข้อมูล (Validations) ในคลาสหรือ DTOs ไม่ใช่ภายในฟังก์ชันทางธุรกิจ +* ตรวจสอบความถูกต้องของข้อมูลโดยใช้ DTOs ที่มีไทป์กำหนดเสมอ + +## **🧰 คลาส (Classes)** + +* ปฏิบัติตามหลักการ **SOLID** +* ควรใช้ **composition มากกว่า inheritance** (Prefer composition over inheritance) +* กำหนด **interfaces** สำหรับสัญญา (contracts) +* ให้คลาสมุ่งเน้นการทำงานเฉพาะอย่างและมีขนาดเล็ก (\< 200 บรรทัด, \< 10 เมธอด, \< 10 properties) + +## **🚨 การจัดการข้อผิดพลาด (Error Handling)** + +* ใช้ Exceptions สำหรับข้อผิดพลาดที่ไม่คาดคิด +* ดักจับ (Catch) ข้อผิดพลาดเพื่อแก้ไขหรือเพิ่มบริบท (context) เท่านั้น; หากไม่เช่นนั้น ให้ใช้ global error handlers +* ระบุข้อความข้อผิดพลาด (error messages) ที่มีความหมายเสมอ + +## **🧪 การทดสอบ (ทั่วไป) (Testing (General))** + +* ใช้รูปแบบ **Arrange–Act–Assert** +* ใช้ชื่อตัวแปรในการทดสอบที่สื่อความหมาย (inputData, expectedOutput) +* เขียน **unit tests** สำหรับ public methods ทั้งหมด +* จำลอง (Mock) การพึ่งพาภายนอก (external dependencies) +* เพิ่ม **acceptance tests** ต่อโมดูลโดยใช้รูปแบบ Given–When-Then + +## **🏗️ แบ็กเอนด์ (NestJS) (Backend (NestJS))** + +### **หลักการ** + +* **สถาปัตยกรรมแบบโมดูลาร์ (Modular architecture)**: + * หนึ่งโมดูลต่อหนึ่งโดเมน + * โครงสร้างแบบ Controller → Service → Repository (Model) +* API-First: มุ่งเน้นการสร้าง API ที่มีคุณภาพสูง มีเอกสารประกอบ (Swagger) ที่ชัดเจนสำหรับ Frontend Team +* DTOs ที่ตรวจสอบความถูกต้องด้วย **class-validator** +* ใช้ **MikroORM** (หรือ TypeORM/Prisma) สำหรับการคงอยู่ของข้อมูล (persistence) ซึ่งสอดคล้องกับสคีมา MariaDB +* ห่อหุ้มโค้ดที่ใช้ซ้ำได้ไว้ใน **common module** (@app/common): + * Configs, decorators, DTOs, guards, interceptors, notifications, shared services, types, validators + +### **ฟังก์ชันหลัก (Core Functionalities)** + +* Global **filters** สำหรับการจัดการ exception +* **Middlewares** สำหรับการจัดการ request +* **Guards** สำหรับการอนุญาต (permissions) และ RBAC +* **Interceptors** สำหรับการแปลงข้อมูล response และการบันทึก log + +### **ข้อจำกัดในการ Deploy (QNAP Container Station)** + +* **ห้ามใช้ไฟล์ .env** ในการตั้งค่า Environment Variables [cite: 2.1] +* การตั้งค่าทั้งหมด (เช่น Database connection string, JWT secret) **จะต้องถูกกำหนดผ่าน Environment Variable ใน docker-compose.yml โดยตรง** [cite: 6.5] ซึ่งจะจัดการผ่าน UI ของ QNAP Container Station [cite: 2.1] + +### **โครงสร้างโมดูลตามโดเมน (Domain-Driven Module Structure)** + +เพื่อให้สอดคล้องกับสคีมา SQL (LCBP3-DMS) เราจะใช้โครงสร้างโมดูลแบบ **Domain-Driven (แบ่งตามขอบเขตธุรกิจ)** แทนการแบ่งตามฟังก์ชัน: + +1. **CommonModule:** + * เก็บ Services ที่ใช้ร่วมกัน เช่น DatabaseModule, FileStorageService (จัดการไฟล์ใน QNAP), AuditLogService, NotificationService + * จัดการ audit_logs + * NotificationService ต้องรองรับ Triggers ที่ระบุใน Requirement 6.7 [cite: 6.7] +2. **AuthModule:** + * จัดการะการยืนยันตัวตน (JWT, Guards) + * **(สำคัญ)** ต้องรับผิดชอบการตรวจสอบสิทธิ์ **3 ระดับ** [cite: 4.2]: สิทธิ์ระดับระบบ (Global Role), สิทธิ์ระดับโปรเจกต์ (Project Role), และ **สิทธิ์ระดับสัญญา (Contract Role)** + * **(สำคัญ)** ต้องมี API สำหรับ **Admin Panel** เพื่อ: + * สร้างและจัดการ Role และการจับคู่ Permission แบบไดนามิก [cite: 4.3] + * ให้ Superadmin สร้าง Organizations และกำหนด Org Admin ได้ [cite: 4.6] + * ให้ Superadmin/Admin จัดการ document_number_formats (รูปแบบเลขที่เอกสาร), document_number_counters (Running Number) [cite: 3.10] +3. **UserModule:** + * จัดการ users, roles, permissions, global_default_roles, role_permissions, user_roles, user_project_roles + * **(สำคัญ)** ต้องมี API สำหรับ **Admin Panel** เพื่อ: + * สร้างและจัดการ Role และการจับคู่ Permission แบบไดนามิก [cite: 4.3] +4. **ProjectModule:** + * จัดการ projects, organizations, contracts, project_parties, contract_parties +5. **MasterModule:** + * จัดการ master data (correspondence_types, rfa_types, rfa_status_codes, rfa_approve_codes, circulation_status_codes, correspondence_types, correspondence_status, tags) [cite: 4.5] +6. **CorrespondenceModule (โมดูลศูนย์กลาง):** + * จัดการ correspondences, correspondence_revisions, correspondence_tags + * **(สำคัญ)** Service นี้ต้อง Inject DocumentNumberingService เพื่อขอเลขที่เอกสารใหม่ก่อนการสร้าง + * **(สำคัญ)** ตรรกะการสร้าง/อัปเดต Revision จะอยู่ใน Service นี้ + * จัดการ correspondence_attachments (ตารางเชื่อมไฟล์แนบ) + * รับผิดชอบเวิร์กโฟลว์ **"Correspondence Routings"** (correspondence_routings, correspondence_routing_templates) สำหรับการส่งต่อเอกสารทั่วไประหว่างองค์กร +7. **RfaModule:** + * จัดการ rfas, rfa_revisions, rfa_items + * รับผิดชอบเวิร์กโฟลว์ **"RFA Workflows"** (rfa_workflows, rfa_workflow_templates, rfa_workflow_template_steps, rfa_status_transitions) สำหรับการอนุมัติเอกสารทางเทคนิค +8. **DrawingModule:** + * จัดการ shop_drawings, shop_drawing_revisions, contract_drawings, contract_drawing_volumes, contract_drawing_cats, contract_drawing_sub_cats, shop_drawing_main_categories, shop_drawing_sub_categories, contract_drawing_subcat_cat_maps, shop_drawing_revision_contract_refs + * จัดการ shop_drawing_revision_attachments และ contract_drawing_attachments(ตารางเชื่อมไฟล์แนบ) +9. **CirculationModule:** + * จัดการ circulations, circulation_templates, circulation_assignees + * จัดการ circulation_attachments (ตารางเชื่อมไฟล์แนบ) + * รับผิดชอบเวิร์กโฟลว์ **"Circulations"** (circulation_status_transitions, circulation_template_assignees, circulation_assignees, circulation_recipients, circulation_actions, circulation_action_documents)สำหรับการเวียนเอกสาร **ภายในองค์กร** +10. **TransmittalModule:** + * จัดการ transmittals และ transmittal_items +11. **SearchModule:** + * ให้บริการค้นหาขั้นสูง (Advanced Search) [cite: 6.2] โดยใช้ **Elasticsearch** เพื่อรองรับการค้นหาแบบ Full-text จากชื่อเรื่อง, รายละเอียด, เลขที่เอกสาร, ประเภท, วันที่, และ Tags +12. **DocumentNumberingModule:** + * **สถานะ:** เป็น Module ภายใน (Internal Module) ไม่เปิด API สู่ภายนอก + * **หน้าที่:** ให้บริการ DocumentNumberingService ที่ Module อื่น (เช่น CorrespondenceModule) จะ Inject ไปใช้งาน + * **ตรรกะ:** รับผิดชอบการสร้างเลขที่เอกสาร โดยการเรียกใช้ Stored Procedure *sp_get_next_document_number** เพื่อป้องกัน Race Condition + +### **สถาปัตยกรรมระบบ (System Architecture)** + +โครงสร้างโมดูล (Module Structure) + +```bash +📁 src +├── 📄 app.module.ts +├── 📄 main.ts +├── 📁 common # @app/common (โมดูลส่วนกลาง) +│ ├── 📁 auth # AuthModule (JWT, Guards) +│ ├── 📁 config # Configuration +│ ├── 📁 decorators # Custom Decorators (เช่น @RequirePermission) +│ ├── 📁 entities # Shared Entities (User, Role, Permission) +│ ├── 📁 exceptions # Global Exception Filters +│ ├── 📁 file-storage # FileStorageService +│ ├── 📁 guards # Custom Guards (RBAC Guard) +│ ├── 📁 interceptors # Interceptors (Audit Log, Transform) +│ └── 📁 services # Shared Services (NotificationService) +├── 📁 modules +│ ├── 📁 user # UserModule (จัดการ Users, Roles, Permissions) +│ ├── 📁 project # ProjectModule (จัดการ Projects, Organizations, Contracts) +│ ├── 📁 correspondence # CorrespondenceModule (จัดการเอกสารโต้ตอบ) +│ ├── 📁 rfa # RfaModule (จัดการเอกสารขออนุมัติ) +│ ├── 📁 drawing # DrawingModule (จัดการแบบแปลน) +│ ├── 📁 circulation # CirculationModule (จัดการใบเวียน) +│ ├── 📁 transmittal # TransmittalModule (จัดการเอกสารนำส่ง) +│ ├── 📁 search # SearchModule (ค้นหาขั้นสูงด้วย Elasticsearch) +│ └── 📁 document-numbering # DocumentNumberingModule (Internal Module) +└── 📁 database # Database Migration & Seeding Scripts +``` + +### **เเทคโนโลยีที่ใช้ (Technology Stack)** + +| ส่วน | Library/Tool | หมายเหตุ | +|---|---|---| +| **Framework** | `@nestjs/core`, `@nestjs/common` | Core Framework | +| **Language** | `TypeScript` | ใช้ TypeScript ทั้งระบบ | +| **Database** | `MariaDB 10.11` | ฐานข้อมูลหลัก | +| **ORM** | `@nestjs/typeorm`, `typeorm` | 🗃️จัดการการเชื่อมต่อและ Query ฐานข้อมูล | +| **Validation** | `class-validator`, `class-transformer` | 📦ตรวจสอบและแปลงข้อมูลใน DTO | +| **Auth** | `@nestjs/jwt`, `@nestjs/passport`, `passport-jwt` | 🔐การยืนยันตัวตนด้วย JWT | +|**Authorization** | `casl` | 🔐จัดการสิทธิ์แบบ RBAC | +| **File Upload** | `multer` | 📁จัดการการอัปโหลดไฟล์ | +| **Search** | `@nestjs/elasticsearch` | 🔍สำหรับการค้นหาขั้นสูง | +| **Notification** | `nodemailer` | 📬ส่งอีเมลแจ้งเตือน | +| **Scheduling** | `@nestjs/schedule` | 📬สำหรับ Cron Jobs (เช่น แจ้งเตือน Deadline) | +| **Logging** | `winston` | 📊บันทึก Log ที่มีประสิทธิภาพ | +| **Testing** | `@nestjs/testing`, `jest`, `supertest` | 🧪ทดสอบ Unit, Integration และ E2E | +| **Documentation** | `@nestjs/swagger` | 🌐สร้าง API Documentation อัตโนมัติ | +| **Security** | `helmet`, `rate-limiter-flexible` | 🛡️เพิ่มความปลอดภัยให้ API | + +เราจะแบ่งการทดสอบเป็น 3 ระดับ โดยใช้ **Jest** และ @nestjs/testing: + +* **Unit Tests (การทดสอบหน่วยย่อย):** + * **เป้าหมาย:** ทดสอบ Logic ภายใน Service, Guard, หรือ Pipe โดยจำลอง (Mock) Dependencies ทั้งหมด + * **สิ่งที่ต้องทดสอบ:** Business Logic (เช่น การเปลี่ยนสถานะ Workflow, การตรวจสอบ Deadline) [cite: 2.9.1], ตรรกะการตรวจสอบสิทธิ์ (Auth Guard) ทั้ง 3 ระดับ +* **Integration Tests (การทดสอบการบูรณาการ):** + * **เป้าหมาย:** ทดสอบการทำงานร่วมกันของ Controller -> Service -> Repository (Database) + * **เทคนิค:** ใช้ **Test Database แยกต่างหาก** (ห้ามใช้ Dev DB) และใช้ supertest เพื่อยิง HTTP Request จริงไปยัง App + * **สิ่งที่ต้องทดสอบ:** การเรียก sp\get\next\document\number [cite: 2.9.3] และการทำงานของ Views (เช่น v_user_tasks) +* **E2E (End-to-End) Tests:** + * **เป้าหมาย:** ทดสอบ API Contract ว่า Response Body Shape ตรงตามเอกสาร Swagger เพื่อรับประกันทีม Frontend + +### **🗄️ Backend State Management** + +Backend (NestJS) ควรเป็น **Stateless** (ไม่เก็บสถานะ) "State" ทั้งหมดจะถูกจัดเก็บใน MariaDB + +* **Request-Scoped State (สถานะภายใน Request เดียว):** + * **ปัญหา:** จะส่งต่อข้อมูล (เช่น User ที่ล็อกอิน) ระหว่าง Guard และ Service ใน Request เดียวกันได้อย่างไร? + * **วิธีแก้:** ใช้ **Request-Scoped Providers** ของ NestJS (เช่น AuthContextService) เพื่อเก็บข้อมูล User ปัจจุบันที่ได้จาก AuthGuard และให้ Service อื่น Inject ไปใช้ +* **Application-Scoped State (การ Caching):** + * **ปัญหา:** ข้อมูล Master (เช่น roles, permissions, organizations) ถูกเรียกใช้บ่อย + * **วิธีแก้:** ใช้ **Caching** (เช่น @nestjs/cache-manager) เพื่อ Caching ข้อมูลเหล่านี้ และลดภาระ Database + +### **การไหลของข้อมูล (Data Flow)** + +1. Request: ผ่าน Nginx Proxy Manager -> NestJS Controller +2. Authentication: JWT Guard ตรวจสอบ Token และดึงข้อมูล User +3. Authorization: RBAC Guard (ใช้ CASL) ตรวจสอบสิทธิ์จาก Decorators (@RequirePermission) +4. Validation: Validation Pipe (ใช้ class-validator) ตรวจสอบ DTO +5. Business Logic: Service Layer ประมวลผลตรรกะทางธุรกิจ +6. Data Access: Repository Layer (ใช้ TypeORM) ติดต่อกับฐานข้อมูล MariaDB +7. Response: ส่งกลับไปยัง Frontend พร้อมสถานะและข้อมูลที่เหมาะสม + +# **🖥️ ฟรอนต์เอนด์ (NextJS / React / UI) (Frontend (NextJS / React / UI))** + +### **โปรไฟล์นักพัฒนา (Developer Profile)** + +วิศวกร TypeScript + React/NextJS ระดับ Senior +เชี่ยวชาญ TailwindCSS, Shadcn/UI, และ Radix สำหรับการพัฒนา UI + +### **แนวทางการพัฒนาโค้ด (Code Implementation Guidelines)** + +* ใช้ **early returns** เพื่อความชัดเจน +* ใช้คลาสของ **TailwindCSS** ในการกำหนดสไตล์เสมอ +* ควรใช้ class: syntax แบบมีเงื่อนไข (หรือ utility clsx) มากกว่าการใช้ ternary operators ใน class strings +* ใช้ **const arrow functions** สำหรับ components และ handlers +* Event handlers ให้ขึ้นต้นด้วย handle... (เช่น handleClick, handleSubmit) +* รวมแอตทริบิวต์สำหรับการเข้าถึง (accessibility) ด้วย: + tabIndex="0", aria-label, onKeyDown, ฯลฯ +* ตรวจสอบให้แน่ใจว่าโค้ดทั้งหมด **สมบูรณ์**, **ผ่านการทดสอบ**, และ **ไม่ซ้ำซ้อน (DRY)** +* ต้อง import โมดูลที่จำเป็นต้องใช้อย่างชัดเจนเสมอ + +### **UI/UX ด้วย React** + +* ใช้ **semantic HTML** +* ใช้คลาสของ **Tailwind** ที่รองรับ responsive (sm:, md:, lg:) +* รักษาลำดับชั้นของการมองเห็น (visual hierarchy) ด้วยการใช้ typography และ spacing +* ใช้ **Shadcn** components (Button, Input, Card, ฯลฯ) เพื่อ UI ที่สอดคล้องกัน +* ทำให้ components มีขนาดเล็กและมุ่งเน้นการทำงานเฉพาะอย่าง +* ใช้ utility classes สำหรับการจัดสไตล์อย่างรวดเร็ว (spacing, colors, text, ฯลฯ) +* ตรวจสอบให้แน่ใจว่าสอดคล้องกับ **ARIA** และใช้ semantic markup + +### **การตรวจสอบฟอร์มและข้อผิดพลาด (Form Validation & Errors)** + +* ใช้ไลบรารีฝั่ง client เช่น zod และ react-hook-form +* แสดงข้อผิดพลาดด้วย **alert components** หรือข้อความ inline +* ต้องมี labels, placeholders, และข้อความ feedback + +### **🧪 Frontend Testing** + +เราจะใช้ **React Testing Library (RTL)** สำหรับการทดสอบ Component และ **Playwright** สำหรับ E2E: + +* **Unit Tests (การทดสอบหน่วยย่อย):** + * **เครื่องมือ:** Vitest + RTL + * **เป้าหมาย:** ทดสอบ Component ขนาดเล็ก (เช่น Buttons, Inputs) หรือ Utility functions +* **Integration Tests (การทดสอบการบูรณาการ):** + * **เครื่องมือ:** RTL + **Mock Service Worker (MSW)** + * **เป้าหมาย:** ทดสอบว่า Component หรือ Page ทำงานกับ API (ที่จำลองขึ้น) ได้ถูกต้อง + * **เทคนิค:** ใช้ MSW เพื่อจำลอง NestJS API และทดสอบว่า Component แสดงผลข้อมูลจำลองได้ถูกต้องหรือไม่ (เช่น ทดสอบหน้า Dashboard [cite: 5.3] ที่ดึงข้อมูลจาก v_user_tasks) +* **E2E (End-to-End) Tests:** + * **เครื่องมือ:** **Playwright** + * **เป้าหมาย:** ทดสอบ User Flow ทั้งระบบโดยอัตโนมัติ (เช่น ล็อกอิน -> สร้าง RFA -> ตรวจสอบ Workflow Visualization [cite: 5.6]) + +### **🗄️ Frontend State Management** + +สำหรับ Next.js App Router เราจะแบ่ง State เป็น 4 ระดับ: + +1. **Local UI State (สถานะ UI ชั่วคราว):** + * **เครื่องมือ:** useState, useReducer + * **ใช้เมื่อ:** จัดการสถานะเล็กๆ ที่จบใน Component เดียว (เช่น Modal เปิด/ปิด, ค่าใน Input) +2. **Server State (สถานะข้อมูลจากเซิร์ฟเวอร์):** + * **เครื่องมือ:** **React Query (TanStack Query)** หรือ SWR + * **ใช้เมื่อ:** จัดการข้อมูลที่ดึงมาจาก NestJS API (เช่น รายการ correspondences, rfas, drawings) + * **ทำไม:** React Query เป็น "Cache" ที่จัดการ Caching, Re-fetching, และ Invalidation ให้โดยอัตโนมัติ +3. **Global Client State (สถานะส่วนกลางฝั่ง Client):** + * **เครื่องมือ:** **Zustand** (แนะนำ) หรือ Context API + * **ใช้เมื่อ:** จัดการข้อมูลที่ต้องใช้ร่วมกันทั่วทั้งแอป และ *ไม่ใช่* ข้อมูลจากเซิร์ฟเวอร์ (เช่น ข้อมูล User ที่ล็อกอิน, สิทธิ์ Permissions) +4. **Form State (สถานะของฟอร์ม):** + * **เครื่องมือ:** **React Hook Form** + **Zod** + * **ใช้เมื่อ:** จัดการฟอร์มที่ซับซ้อน (เช่น ฟอร์มสร้าง RFA, ฟอร์ม Circulation [cite: 3.7]) + +# **🔗 แนวทางการบูรณาการ Full Stack (Full Stack Integration Guidelines)** + +| Aspect (แง่มุม) | Backend (NestJS) | Frontend (NextJS) | UI Layer (Tailwind/Shadcn) | +| :---- | :---- | :---- | :---- | +| API | REST / GraphQL Controllers | API hooks ผ่าน fetch/axios/SWR | Components ที่รับข้อมูล | +| Validation (การตรวจสอบ) | class-validator DTOs | zod / react-hook-form | สถานะของฟอร์ม/input ใน Shadcn | +| Auth (การยืนยันตัวตน) | Guards, JWT | NextAuth / cookies | สถานะ UI ของ Auth (loading, signed in) | +| Errors (ข้อผิดพลาด) | Global filters | Toasts / modals | Alerts / ข้อความ feedback | +| Testing (การทดสอบ) | Jest (unit/e2e) | Vitest / Playwright | Visual regression | +| Styles (สไตล์) | Scoped modules (ถ้าจำเป็น) | Tailwind / Shadcn | Tailwind utilities | +| Accessibility (การเข้าถึง) | Guards + filters | ARIA attributes | Semantic HTML | + +## **🗂️ ข้อตกลงเฉพาะสำหรับ DMS (LCBP3-DMS)** + +ส่วนนี้ขยายแนวทาง FullStackJS ทั่วไปสำหรับโปรเจกต์ **LCBP3-DMS** โดยมุ่งเน้นไปที่เวิร์กโฟลว์การอนุมัติเอกสาร (Correspondence, RFA, Drawing, Contract, Transmittal, Circulation) + +### **🧩 RBAC และการควบคุมสิทธิ์ (RBAC & Permission Control)** + +ใช้ Decorators เพื่อบังคับใช้สิทธิ์การเข้าถึง โดยอ้างอิงสิทธิ์จากตาราง permissions + +@RequirePermission('rfas.respond') // ต้องตรงกับ 'permission\code' +@Put(':id') +updateRFA(@Param('id') id: string) { + return this.rfaService.update(id); +} + +### **Roles (บทบาท)** + +* **Superadmin**: ไม่มีข้อจำกัดใดๆ [cite: 4.3] +* **Admin**: มีสิทธิ์เต็มที่ในองค์กร [cite: 4.3] +* **Document Control**: เพิ่ม/แก้ไข/ลบ เอกสารในองค์กร [cite: 4.3] +* **Editor**: สามารถ เพิ่ม/แก้ไข เอกสารที่กำหนด [cite: 4.3] +* **Viewer**: สามารถดู เอกสาร [cite: 4.3] + +### **ตัวอย่าง Permissions (จากตาราง permissions)** + +* rfas.view, rfas.create, rfas.respond, rfas.delete +* drawings.view, drawings.upload, drawings.delete +* corr.view, corr.manage +* transmittals.manage +* cirs.manage +* project\parties.manage + +การจับคู่ระหว่าง roles และ permissions **เริ่มต้น** จะถูก seed ผ่านสคริปต์ (ดังที่เห็นในไฟล์ SQL)**อย่างไรก็ตาม AuthModule/UserModule ต้องมี API สำหรับ Admin เพื่อสร้าง Role ใหม่และกำหนดสิทธิ์ (Permissions) เพิ่มเติมได้ในภายหลัง** [cite: 4.3] + +## **🧾 มาตรฐาน AuditLog (AuditLog Standard)** + +บันทึกการดำเนินการ CRUD และการจับคู่ทั้งหมดลงในตาราง audit_logs + +| Field (ฟิลด์) | Type (จาก SQL) | Description (คำอธิบาย) | +| :---- | :---- | :---- | +| audit_id | BIGINT | Primary Key | +| user_id | INT | ผู้ใช้ที่ดำเนินการ (FK -> users) | +| action | VARCHAR(100) | rfa.create, correspondence.update, login.success | +| entity_type | VARCHAR(50) | ชื่อตาราง/โมดูล เช่น 'rfa', 'correspondence' | +| entity_id | VARCHAR(50) | Primary ID ของระเบียนที่ได้รับผลกระทบ | +| details_json | JSON | ข้อมูลบริบท (เช่น ฟิลด์ที่มีการเปลี่ยนแปลง) | +| ip_address | VARCHAR(45) | IP address ของผู้ดำเนินการ | +| user_agent | VARCHAR(255) | User Agent ของผู้ดำเนินการ | +| created_at | TIMESTAMP | Timestamp (UTC) | + +## **📂 การจัดการไฟล์ (File Handling) (ปรับปรุงใหม่)** + +### **มาตรฐานการอัปโหลดไฟล์ (File Upload Standard)** + +* **ตรรกะใหม่:** การอัปโหลดไฟล์ทั้งหมดจะถูกจัดการโดย FileStorageService และบันทึกข้อมูลไฟล์ลงในตาราง attachments (ตารางกลาง) +* ไฟล์จะถูกเชื่อมโยงไปยัง Entity ที่ถูกต้องผ่าน **ตารางเชื่อม (Junction Tables)** เท่านั้น: + * correspondence_attachments (เชื่อม Correspondence กับ Attachments) + * circulation_attachments (เชื่อม Circulation กับ Attachments) + * shop_drawing_revision_attachments (เชื่อม Shop Drawing Revision กับ Attachments) + * contract_drawing_attachments (เชื่อม Contract Drawing กับ Attachments) +* เส้นทางจัดเก็บไฟล์ (Upload path): อ้างอิงจาก Requirement 2.1 คือ /share/dms-data [cite: 2.1] โดย FileStorageService จะสร้างโฟลเดอร์ย่อยแบบรวมศูนย์ (เช่น /share/dms-data/uploads/{YYYY}/{MM}/[stored\filename]) +* ประเภทไฟล์ที่อนุญาต: pdf, dwg, docx, xlsx, zip +* ขนาดสูงสุด: **50 MB** +* จัดเก็บนอก webroot +* ให้บริการไฟล์ผ่าน endpoint ที่ปลอดภัย /files/:attachment_id/download + +### **การควบคุมการเข้าถึง (Access Control)** + +การเข้าถึงไฟล์ไม่ใช่การเข้าถึงโดยตรง endpoint /files/:attachment_id/download จะต้อง: + +1. ค้นหาระเบียน attachment +2. ตรวจสอบว่า attachment_id นี้ เชื่อมโยงกับ Entity ใด (เช่น correspondence, circulation, shop_drawing_revision, contract_drawing) ผ่านตารางเชื่อม +3. ตรวจสอบว่าผู้ใช้มีสิทธิ์ (permission) ในการดู Entity ต้นทางนั้นๆ หรือไม่ + +## **🔟 การจัดการเลขที่เอกสาร (Document Numbering) [cite: 3.10]** + +* **เป้าหมาย:** สร้างเลขที่เอกสาร (เช่น correspondence\number) โดยอัตโนมัติ ตามรูปแบบที่กำหนด +* **ตรรกะการนับ:** การนับ Running number (SEQ) จะนับแยกตาม Key: **Project + Originator Organization + Document Type + Year** +* **ตาราง SQL:** + * document_number_formats: Admin ใช้กำหนด "รูปแบบ" (Template) ของเลขที่ (เช่น {ORG\CODE}-{TYPE\CODE}-{YEAR\SHORT}-{SEQ:4}) โดยกำหนดตาม **Project** และ **Document Type** [cite: 4.5] + * document_number_counters: ระบบใช้เก็บ "ตัวนับ" ล่าสุดของ Key (Project+Org+Type+Year) +* **การทำงาน (Backend):** + * DocumentNumberingModule จะให้บริการ DocumentNumberingService + * เมื่อ CorrespondenceModule ต้องการสร้างเอกสารใหม่, มันจะเรียก documentNumberingService.generateNextNumber(...) + * Service นี้จะเรียกใช้ Stored Procedure **sp_get_next_document_number** [cite: 2.9.3] ซึ่ง Procedure นี้จะจัดการ Database Transaction และ Row Lock (FOR UPDATE) ภายใน DB เพื่อรับประกันการป้องกัน Race Condition + +## **📊 การรายงานและการส่งออก (Reporting & Exports)** + +### **วิวสำหรับการรายงาน (Reporting Views) (จาก SQL)** + +การรายงานควรสร้างขึ้นจาก Views ที่กำหนดไว้ล่วงหน้าในฐานข้อมูลเป็นหลัก: + +* v_current_correspondences: สำหรับ revision ปัจจุบันทั้งหมดของเอกสารที่ไม่ใช่ RFA +* v_current_rfas: สำหรับ revision ปัจจุบันทั้งหมดของ RFA และข้อมูล master +* v_contract_parties_all: สำหรับการตรวจสอบความสัมพันธ์ของ project/contract/organization +* v_user_tasks: สำหรับ Dashboard "งานของฉัน" +* v_audit_log_details: สำหรับ Activity Feed + +Views เหล่านี้ทำหน้าที่เป็นแหล่งข้อมูลหลักสำหรับการรายงานฝั่งเซิร์ฟเวอร์และการส่งออกข้อมูล + +### **กฎการส่งออก (Export Rules)** + +* Export formats: CSV, Excel, PDF. +* จัดเตรียมมุมมองสำหรับพิมพ์ (Print view). +* รวมลิงก์ไปยังต้นทาง (เช่น /rfas/:id). + +## **🧮 ฟรอนต์เอนด์: รูปแบบ DataTable และฟอร์ม (Frontend: DataTable & Form Patterns)** + +### **DataTable (Server‑Side)** + +* Endpoint: /api/{module}?page=1\&pageSize=20\&sort=...\&filter=... +* ต้องรองรับ: การแบ่งหน้า (pagination), การเรียงลำดับ (sorting), การค้นหา (search), การกรอง (filters) +* แสดง revision ล่าสุดแบบ inline เสมอ (สำหรับ RFA/Drawing) + +### **มาตรฐานฟอร์ม (Form Standards)** + +* ต้องมีการใช้งาน Dropdowns แบบขึ้นต่อกัน (Dependent dropdowns) (ตามที่สคีมารองรับ): + * Project → Contract Drawing Volumes + * Contract Drawing Category → Sub-Category + * RFA (ประเภท Shop Drawing) → Shop Drawing Revisions ที่เชื่อมโยงได้ +* **(ใหม่)** การอัปโหลดไฟล์: ต้องรองรับ **Multi-file upload (Drag-and-Drop)** [cite: 5.7] +* **(ใหม่)** UI ต้องอนุญาตให้ผู้ใช้กำหนดว่าไฟล์ใดเป็น **"เอกสารหลัก"** หรือ "เอกสารแนบประกอบ" [cite: 5.7] +* ส่ง (Submit) ผ่าน API พร้อม feedback แบบ toast + +### **ข้อกำหนด Component เฉพาะ (Specific UI Requirements)** + +* **Dashboard \- My Tasks:** ต้องพัฒนา Component ตาราง "งานของฉัน" (My Tasks)ซึ่งดึงข้อมูลงานที่ผู้ใช้ล็อกอินอยู่ต้องรับผิดชอบ (Main/Action) จาก v\user\tasks [cite: 5.3] +* **Workflow Visualization:** ต้องพัฒนา Component สำหรับแสดงผล Workflow (โดยเฉพาะ RFA)ที่แสดงขั้นตอนทั้งหมดเป็นลำดับ โดยขั้นตอนปัจจุบัน (active) เท่านั้นที่ดำเนินการได้ และขั้นตอนอื่นเป็น disabled [cite: 5.6] ต้องมีตรรกะสำหรับ Admin ในการ override หรือย้อนกลับขั้นตอนได้ [cite: 5.6] +* ** Admin Panel:** ต้องมีหน้า UI สำหรับ Superadmin/Admin เพื่อจัดการข้อมูลหลัก (Master Data [cite: 4.5]), การเริ่มต้นใช้งาน (Onboarding [cite: 4.6]), และ **รูปแบบเลขที่เอกสาร (Numbering Formats [cite: 3.10])** + +## **🧭 แดชบอร์ดและฟีดกิจกรรม (Dashboard & Activity Feed)** + +### **การ์ดบนแดชบอร์ด (Dashboard Cards)** + +* แสดง Correspondences, RFAs, Circulations, Shop Drawing Revision ล่าสุด +* รวมสรุป KPI (เช่น "RFAs ที่รอการอนุมัติ", "Shop Drawing ที่รอการอนุมัติ") [cite: 5.3] +* รวมลิงก์ด่วนไปยังโมดูลต่างๆ + +### **ฟีดกิจกรรม (Activity Feed)** + +* แสดงรายการ v\audit\log\details ล่าสุด (10 รายการ) ที่เกี่ยวข้องกับผู้ใช้ + +// ตัวอย่าง API response +[ + { user: 'editor01', action: 'Updated RFA (LCBP3-RFA-001)', time: '2025-11-04T09:30Z' } +] + +## **🛡️ ข้อกำหนดที่ไม่ใช่ฟังก์ชันการทำงาน (Non-Functional Requirements)** + +ส่วนนี้สรุปข้อกำหนด Non-Functional จาก requirements.md เพื่อให้ทีมพัฒนาทราบ + +* **Audit Log [cite: 6.1]:** ทุกการกระทำที่สำคัญ (C/U/D) ต้องถูกบันทึกใน audit_logs +* **Performance [cite: 6.4]:** ต้องใช้ Caching สำหรับข้อมูลที่เรียกบ่อย และใช้ Pagination +* **Security [cite: 6.5]:** ต้องมี Rate Limiting และจัดการ Secret ผ่าน docker-compose.yml (ไม่ใช่ .env) +* **(ใหม่) Backup & Recovery [cite: 6.6]:** ต้องมีแผนสำรองข้อมูลทั้ง Database (MariaDB) และ File Storage (/share/dms-data) อย่างน้อยวันละ 1 ครั้ง +* **(ใหม่) Notification Strategy [cite: 6.7]:** ระบบแจ้งเตือน (Email/Line) ต้องถูก Trigger เมื่อมีเอกสารใหม่ส่งถึง, มีการมอบหมายงานใหม่ (Circulation), หรือ (ทางเลือก) เมื่องานเสร็จ/ใกล้ถึงกำหนด + +## **✅ มาตรฐานที่นำไปใช้แล้ว (จาก SQL v1.1.0) (Implemented Standards (from SQL v1.1.0))** + +ส่วนนี้ยืนยันว่าแนวทางปฏิบัติที่ดีที่สุดต่อไปนี้เป็นส่วนหนึ่งของการออกแบบฐานข้อมูลอยู่แล้ว และควรถูกนำไปใช้ประโยชน์ ไม่ใช่สร้างขึ้นใหม่ + +* ✅ **Soft Delete:** นำไปใช้แล้วผ่านคอลัมน์ deleted_at ในตารางสำคัญ (เช่น correspondences, rfas, project_parties) ตรรกะการดึงข้อมูลต้องกรอง deleted_at IS NULL +* ✅ **Database Indexes:** สคีมาได้มีการทำ index ไว้อย่างหนักหน่วงบน foreign keys และคอลัมน์ที่ใช้ค้นหาบ่อย (เช่น idx_rr_rfa, idx_cor_project, idx_cr_is_current) เพื่อประสิทธิภาพ +* ✅ **โครงสร้าง RBAC:** มีระบบ users, roles, permissions, user_roles, และ user_project_roles ที่ครอบคลุมอยู่แล้ว +* ✅ **Data Seeding:** ข้อมูล Master (roles, permissions, organization_roles, initial users, project parties) ถูกรวมอยู่ในสคริปต์สคีมาแล้ว + +## **🧩 การปรับปรุงที่แนะนำ (สำหรับอนาคต) (Recommended Enhancements (Future))** + +* ✅ สร้าง Background job (โดยใช้ **n8n** เพื่อเชื่อมต่อกับ **Line** [cite: 2.7] และ/หรือใช้สำหรับการแจ้งเตือน RFA ที่ใกล้ถึงกำหนด due_date [cite: 6.7]) +* ✅ เพิ่ม job ล้างข้อมูลเป็นระยะสำหรับ attachments ที่ไม่ถูกเชื่อมโยงกับ Entity ใดๆ เลย (ไฟล์กำพร้า) diff --git a/docs/Markdown/LCBP3-DMS_V1_3_0_Test_Plan_TH.md b/docs/Markdown/LCBP3-DMS_V1_3_0_Test_Plan_TH.md new file mode 100644 index 0000000..3c678ee --- /dev/null +++ b/docs/Markdown/LCBP3-DMS_V1_3_0_Test_Plan_TH.md @@ -0,0 +1,79 @@ +# **🧪 แผนการทดสอบระบบ (Test Plan) \- DMS v1.3.0 Backend** + +เอกสารนี้สรุปแผนการทดสอบ, ขั้นตอน, และเครื่องมือที่ใช้ในการตรวจสอบความถูกต้องของ NestJS Backend API (DMS v1.3.0) ก่อนการ Deploy ใช้งานจริงร่วมกับ Frontend + +## **1\. วัตถุประสงค์ (Objectives)** + +* เพื่อให้มั่นใจว่า API ทั้งหมดทำงานตรงตาม requirements.md +* เพื่อตรวจสอบว่าระบบรักษาความปลอดภัย (RBAC และ Security) ทำงานได้ถูกต้อง 100% +* เพื่อค้นหาและแก้ไขข้อบกพร่อง (Bugs) ที่เกี่ยวข้องกับการเชื่อมต่อฐานข้อมูลและ Business Logic +* เพื่อยืนยันว่าระบบทนทานต่อการใช้งานพร้อมกัน (Concurrency) และมีประสิทธิภาพ (Performance) +* เพื่อส่งมอบ API ที่เสถียรและมีเอกสาร (Swagger) ครบถ้วนให้แก่ทีม Frontend + +## **2\. ขอบเขตการทดสอบ (Scope)** + +### **สิ่งที่อยู่ในขอบเขต (In-Scope)** + +* **API Functionality:** การทดสอบ Endpoints ทั้งหมด (CRUD, Search, Upload) +* **Business Logic:** ตรรกะการสร้างเอกสาร (RFA, Correspondence), การสร้างเลขที่, และ Workflow +* **Security:** การยืนยันตัวตน (JWT), การจัดการสิทธิ์ (RBAC Guard), การป้องกัน (Helmet, Rate Limiter) +* **Data Integrity:** การตรวจสอบความถูกต้องของข้อมูลที่บันทึกลง MariaDB +* **Performance:** การทดสอบ Concurrency (การสร้างเลขที่) และการตอบสนองของ API +* **Error Handling:** การตรวจสอบว่า Global Exception Filter ทำงานได้ถูกต้อง + +### **สิ่งที่อยู่นอกขอบเขต (Out-of-Scope)** + +* การทดสอบ Next.js Frontend (UI/UX) +* การทดสอบตรรกะภายในของ N8N (เราทดสอบแค่ว่า Backend *ยิง* Webhook ไปหรือไม่) +* การทดสอบ Penetration Test ขั้นสูง (เน้น Functional & Security พื้นฐาน) + +## **3\. สภาพแวดล้อมและเครื่องมือ (Environment & Tools)** + +| ประเภท | เครื่องมือ/สภาพแวดล้อม | วัตถุประสงค์ | +| :---- | :---- | :---- | +| **สภาพแวดล้อม** | **Staging (QNAP)** | สภาพแวดล้อมจำลอง (บน Docker) ที่เหมือน Production ที่สุด ประกอบด้วย backend, mariadb, elasticsearch, n8n (Mock Receiver) | +| **ฐานข้อมูล** | **DBeaver** | ใช้สำหรับเชื่อมต่อ MariaDB (Staging) เพื่อตรวจสอบผลลัพธ์ (Data Verification) | +| **API (Manual)** | **Postman / Insomnia** | ใช้สำหรับการทดสอบ API ด้วยตนเอง, สำรวจ Endpoints, และสร้าง Test Case | +| **API (Automation)** | **Postman (Newman) / Supertest** | (E2E) ใช้รัน Test Case อัตโนมัติเพื่อตรวจสอบ API Contract | +| **Unit/Integration** | **Jest / @nestjs/testing** | (Developer) ใช้สำหรับทดสอบ Logic ภายใน Service และ Guard (ตามตัวอย่าง spec.ts ที่สร้างไว้) | +| **Concurrency** | **k6 (แนะนำ) / Node.js Script** | ใช้สำหรับทดสอบ Stress Test และ Concurrency (โดยเฉพาะ TC-CON-01) | +| **Webhook** | **N8N (Webhook Node)** | ใช้ N8N จริง (Staging) ตั้งค่า Webhook Node เพื่อรับ Event จาก NotificationService | + +## **4\. รายละเอียดสถานการณ์ทดสอบ (Detailed Test Scenarios)** + +นี่คือ Test Case ที่สำคัญที่สุด โดยแบ่งตามความเสี่ยงและ Function + +### **T1: การรักษาความปลอดภัย (Security & RBAC) \- (ความเสี่ยงสูงมาก)** + +| ID | สถานการณ์ | ขั้นตอนการทดสอบ (Steps) | ผลลัพธ์ที่คาดหวัง (Expected) | เครื่องมือ | +| :---- | :---- | :---- | :---- | :---- | +| **TC-SEC-01** | **(RBAC) ห้าม Viewer สร้างเอกสาร** | 1\. (Postman) เรียก POST /api/v1/auth/login ด้วย User "Viewer" 2\. คัดลอก access\_token 3\. เรียก POST /api/v1/correspondence (ใน Auth Header) พร้อม Body ที่ถูกต้อง | 403 Forbidden (RBACGuard ทำงาน) | Postman | +| **TC-SEC-02** | **(RBAC) Editor ข้าม Project** | 1\. (Postman) Login User "Editor" ที่มีสิทธิ์เฉพาะ Project A 2\. (DBeaver) หา ID เอกสาร (เช่น corr\_id: 99\) ที่อยู่ใน Project B 3\. (Postman) เรียก GET /api/v1/correspondence/99 ด้วย Token ของ Editor | 403 Forbidden หรือ 404 Not Found | Postman, DBeaver | +| **TC-SEC-03** | **(RBAC) Super Admin** | 1\. (Postman) Login User "Super Admin" 2\. เรียก Endpoint ที่จำกัดสิทธิ์สูง (เช่น POST /api/v1/admin/users) | 201 Created (Super Admin ต้องผ่านทุกการตรวจสอบ) | Postman | +| **TC-SEC-04** | **(Rate Limit) Brute-force** | 1\. (Postman Runner หรือ k6) ตั้งค่าให้เรียก POST /api/v1/auth/login (ด้วยรหัสผ่านผิด) 110 ครั้ง (Limit คือ 100\) 2\. สังเกตผลลัพธ์ | Request ที่ 1-100: 401 Unauthorized Request ที่ 101+: 429 Too Many Requests | k6, Postman | +| **TC-SEC-05** | **(Security) Helmet** | 1\. (Postman) เรียก Endpoint ใดก็ได้ (เช่น GET /api/v1/health) 2\. ตรวจสอบ Response Headers | ต้องมี Headers เช่น X-Content-Type-Options: nosniff, Strict-Transport-Security, X-Frame-Options: SAMEORIGIN | Postman | + +### **T2: ตรรกะหลัก (Core Logic & Concurrency) \- (ความเสี่ยงสูง)** + +| ID | สถานการณ์ | ขั้นตอนการทดสอบ (Steps) | ผลลัพธ์ที่คาดหวัง (Expected) | เครื่องมือ | +| :---- | :---- | :---- | :---- | :---- | +| **TC-CON-01** | **(Concurrency) สร้างเลขที่เอกสาร** | 1\. (k6/Script) สร้าง Script ที่เรียก POST /api/v1/correspondence (สร้างเอกสารใหม่) 50 ครั้ง *พร้อมกัน* (Simultaneously) 2\. (Postman) Login Admin 3\. (DBeaver) ตรวจสอบตาราง correspondences และ document\_number\_counters | 1\. Script ทั้ง 50 ครั้งสำเร็จ (201 Created) 2\. (DBeaver) document\_number\_counters มี last\_number: 50 3\. correspondences มีเอกสาร 50 ฉบับ โดย *ไม่มี* correspondence\_number ซ้ำกันเลย | k6, DBeaver | +| **TC-FUNC-01** | **(Data) สร้าง RFA (Complex)** | 1\. (Postman) Login User (เช่น "Editor") 2\. เรียก POST /api/v1/rfa พร้อม DTO ที่ซับซ้อน (มี rfa\_type\_id, title, attachments, shop\_drawings) | 1\. 201 Created 2\. (DBeaver) ตรวจสอบว่ามีข้อมูลถูกสร้างขึ้นใน 3 ตารางหลัก: \- correspondences (ตารางแม่) \- rfas (ตารางแม่ RFA) \- rfa\_revisions (ตารางลูก Revision 0\) | Postman, DBeaver | + +### **T3: การทำงานของโมดูล (Module Functionality)** + +| ID | สถานการณ์ | ขั้นตอนการทดสอบ (Steps) | ผลลัพธ์ที่คาดหวัง (Expected) | เครื่องมือ | +| :---- | :---- | :---- | :---- | :---- | +| **TC-FUNC-02** | **(File) อัปโหลดไฟล์** | 1\. (Postman) Login User 2\. เรียก POST /api/v1/files/upload (ประเภท form-data, key file) 3\. (DBeaver) ตรวจสอบตาราง attachments | 1\. 201 Created คืนค่าข้อมูล Attachment (เช่น ID, stored\_filename) 2\. (DBeaver) มีแถวใหม่ในตาราง attachments 3\. (ถ้าทำได้) ตรวจสอบ QNAP /share/dms-data/... ว่ามีไฟล์จริง | Postman, DBeaver | +| **TC-FUNC-03** | **(File) ดาวน์โหลด (ผ่าน Auth)** | 1\. (Postman) ทำ TC-FUNC-02 เพื่ออัปโหลดไฟล์ (สมมติได้ attachment\_id: 123\) 2\. เรียก GET /api/v1/files/download/123 (ต้องใส่ Auth Header) | 200 OK และได้ข้อมูลไฟล์กลับมา | Postman | +| **TC-FUNC-04** | **(Search) Elasticsearch** | 1\. (Postman) สร้างเอกสารใหม่ POST /api/v1/correspondence (จดจำ Title ไว้) 2\. (รอ 10 วินาที ให้ Elastic Index) 3\. เรียก GET /api/v1/search?query=\[Title ที่จดไว้\] | 200 OK และผลลัพธ์การค้นหาต้องมีเอกสารที่เพิ่งสร้าง | Postman | +| **TC-FUNC-05** | **(Notification) N8N Webhook** | 1\. (N8N) สร้าง Workflow ใหม่, ใช้ "Webhook" Node (เปิด Test Mode) 2\. (Postman) Login User 3\. เรียก POST /api/v1/circulation (สร้างใบเวียนใหม่) | 1\. (Postman) 201 Created 2\. (N8N) Webhook Node ได้รับข้อมูล Payload ({ event: 'NEW\_CIRCULATION\_TASK', ... }) | Postman, N8N | +| **TC-FUNC-06** | **(Audit) Audit Log** | 1\. (Postman) Login Admin 2\. เรียก DELETE /api/v1/admin/roles/10 (ลบ Role สมมติ) 3\. (DBeaver) ตรวจสอบ audit\_logs | 1\. (DBeaver) มีแถวใหม่ใน audit\_logs 2\. ข้อมูลถูกต้อง: action: 'role.delete', entity\_type: 'role', entity\_id: '10', user\_id: \[Admin ID\] | Postman, DBeaver | + +### **T4: การ Deploy (NFR)** + +| ID | สถานการณ์ | ขั้นตอนการทดสอบ (Steps) | ผลลัพธ์ที่คาดหวัง (Expected) | เครื่องมือ | +| :---- | :---- | :---- | :---- | :---- | +| **TC-NFR-01** | **(Health) Health Check** | 1\. (Browser/Postman) เรียก GET /api/v1/health (จาก Staging URL) | 200 OK และ JSON Response แสดง status: "ok" และสถานะ DB | Postman, Browser | +| **TC-NFR-02** | **(Error) Global Filter** | 1\. (Postman) เรียก Endpoint ที่ไม่มีอยู่จริง (เช่น GET /api/v1/invalid\_path) | 404 Not Found Response Body ต้องมีโครงสร้าง JSON ที่กำหนดไว้ (เช่น { "statusCode": 404, "message": "Cannot GET /api/v1/invalid\_path", ... }) | Postman | + diff --git a/docs/Markdown/LCBP3-DMS_V1_3_0_backend_dev_plan.md b/docs/Markdown/LCBP3-DMS_V1_3_0_backend_dev_plan.md new file mode 100644 index 0000000..19d4c12 --- /dev/null +++ b/docs/Markdown/LCBP3-DMS_V1_3_0_backend_dev_plan.md @@ -0,0 +1,117 @@ + +# แผนการพัฒนา Backend NestJS สำหรับ DMS v1.3.0 + +## การเตรียมความพร้อมและการติดตั้ง (Prerequisites & Setup) + +- [ ] สร้าง NestJS Project ใหม่ (backend/src) +- [✅] ติดตั้ง Dependencies หลักๆ ตาม Technology Stack + - [✅] `@nestjs/core`, `@nestjs/common` + - [✅] `@nestjs/typeorm`, `typeorm` + - [✅] `@nestjs/jwt`, `@nestjs/passport`, `passport-jwt` + - [✅] `casl` + - [✅] `class-validator`, `class-transformer` + - [✅] `@nestjs/swagger` + - [✅] `winston`, `helmet`, `rate-limiter-flexible` +- [✅] ตั้งค่า `tsconfig.json`, `nest-cli.json` และไฟล์ config อื่นๆ +- [ ] ตั้งค่าการเชื่อมต่อ MariaDB ผ่าน TypeORM + - [ ] **(สำคัญ)** กำหนดค่าตัวแปรสภาพแวดล้อม (DATABASE_URL, JWT_SECRET) ผ่าน `docker-compose.yml` + +--- + +## Phase 1: การสร้างรากฐาน (Foundation) - สัปดาห์ที่ 1-2 + +- [ ] พัฒนา Core Auth Module (`AuthModule`) + - [✅] สร้าง Entities: `Users`, `Roles`, `Permissions` + - [✅] สร้าง `AuthService` สำหรับ Login, Register, JWT Generation + - [✅] สร้าง `JwtStrategy` สำหรับ Passport + - [✅] สร้าง `RBACGuard` โดยใช้ CASL + - [✅] สร้าง API Endpoints: `/auth/login`, `/auth/me` +- [✅] พัฒนา Common Module (`@app/common`) + - [✅] สร้าง `FileStorageService` สำหรับจัดการไฟล์ (อัปโหลด/ดาวน์โหลด) + - [✅] สร้าง `AuditLogInterceptor` สำหรับบันทึกการกระทำโดยอัตโนมัติ + - [✅] สร้าง Global Exception Filter + - [✅] สร้าง DTOs และ Interfaces พื้นฐาน + +--- + +## Phase 2: พัฒนาเอนทิตีหลัก (Core Entities) - สัปดาห์ที่ 3-4 + +- [✅] พัฒนา Project Module (`ProjectModule`) + - [✅] สร้าง Entities: `Project`, `Organization`, `Contract`, `ProjectParty` + - [✅] สร้าง Services สำหรับ CRUD และจัดการความสัมพันธ์ + - [✅] สร้าง Controller พร้อม Swagger Decorators +- [ ] พัฒนา Correspondence Module (`CorrespondenceModule`) + - [ ] สร้าง Entities: `Correspondence`, `CorrespondenceRevision`, `CorrespondenceAttachment` + - [ ] สร้าง Services สำหรับจัดการเอกสาร การสร้าง Revision + - [ ] เชื่อมโยงกับ `FileStorageService` และ `DocumentNumberingService` +- [ ] พัฒนา Attachment Management + - [ ] พัฒนา API อัปโหลดไฟล์ (`POST /correspondences/:id/attachments`) + - [ ] พัฒนา API ดาวน์โหลดไฟล์ (`GET /attachments/:id/download`) + - [ ] ใช้ Junction Tables (`correspondence_attachments`) ในการเชื่อมโยง + +--- + +## Phase 3: พัฒนาเวิร์กโฟลว์เฉพาะทาง (Specialized Workflows) - สัปดาห์ที่ 5-7 + +- [ ] พัฒนา RFA Module (`RfaModule`) + - [ ] สร้าง Entities: `Rfa`, `RfaRevision`, `RfaWorkflow`, `RfaItem` + - [ ] สร้าง Service สำหรับจัดการ Workflow การอนุมัติ (ส่ง -> อนุมัติ/ปฏิเสธ -> ส่งกลับ) + - [ ] จัดการ State Transitions ตาม `rfa_status_transitions` +- [ ] พัฒนา Drawing Module (`DrawingModule`) + - [ ] สร้าง Entities: `ShopDrawing`, `ShopDrawingRevision`, `ContractDrawing` + - [ ] สร้าง Services สำหรับจัดการแบบแปลนและการอ้างอิงระหว่าง Shop และ Contract Drawing +- [ ] พัฒนา Circulation Module (`CirculationModule`) + - [ ] สร้าง Entities: `Circulation`, `CirculationAssignee` + - [ ] สร้าง Service สำหรับการสร้างใบเวียน มอบหมายงาน และติดตามสถานะ +- [ ] พัฒนา Transmittal Module (`TransmittalModule`) + - [ ] สร้าง Entities: `Transmittal`, `TransmittalItem` + - [ ] สร้าง Service สำหรับการสร้างเอกสารนำส่ง + +--- + +## Phase 4: คุณสมบัติขั้นสูงและการเชื่อมโยง (Advanced Features) - สัปดาห์ที่ 8-9 + +- [ ] พัฒนา Document Numbering Module (`DocumentNumberingModule`) + - [ ] สร้าง `DocumentNumberingService` (Internal Module) + - [ ] Implement การเรียกใช้ Stored Procedure `sp_get_next_document_number` + - [ ] ให้บริการแก่ `CorrespondenceModule` และโมดูลอื่นๆ +- [ ] พัฒนา Search Module (`SearchModule`) + - [ ] ตั้งค่า Elasticsearch + - [ ] สร้าง Service สำหรับ Index ข้อมูลจาก Views (`v_current_correspondences`, `v_current_rfas`) + - [ ] สร้าง API ค้นหาขั้นสูง (`/search`) +- [ ] พัฒนา Notification Service + - [ ] สร้าง `NotificationService` ใน `CommonModule` + - [ ] Implement การส่ง Email ผ่าน `nodemailer` + - [ ] สร้าง Trigger สำหรับส่งการแจ้งเตือน (เอกสารใหม่, เปลี่ยนสถานะ, ใกล้ถึง Deadline) + - [ ] เตรียมพร้อมสำหรับการเชื่อมต่อกับ N8N สำหรับ Line Notification + +--- + +## Phase 5: การทดสอบและเพิ่มประสิทธิภาพ (Testing & Optimization) - สัปดาห์ที่ 10 + +- [ ] ดำเนินการทดสอบ (Testing) + - [ ] เขียน Unit Tests สำหรับ Business Logic ใน Services และ Guards + - [ ] เขียน Integration Tests สำหรับ Controller -> Service -> Repository (โดยใช้ Test Database) + - [ ] เขียน E2E Tests สำหรับตรวจสอบ API Contract ว่าตรงตาม Swagger +- [ ] ปรับปรุงประสิทธิภาพ (Performance) + - [ ] ใช้ Caching (`@nestjs/cache-manager`) สำหรับข้อมูลที่ถูกเรียกบ่อย (Roles, Permissions) + - [ ] ตรวจสอบ Query และใช้ Database Indexes ให้เป็นประโยชน์ (มีอยู่แล้วใน SQL) + - [ ] ใช้ Pagination สำหรับข้อมูลจำนวนมาก +- [ ] เพิ่มความปลอดภัย (Security) + - [ ] ติดตั้ง `helmet` สำหรับตั้งค่า HTTP Headers + - [ ] ติดตั้ง `rate-limiter-flexible` สำหรับป้องกัน Brute-force +- [ ] จัดเตรียมเอกสาร (Documentation) + - [ ] ตรวจสอบความสมบูรณ์ของ Swagger Documentation + - [ ] เพิ่ม JSDoc Comments สำหรับ Methods และ Classes ที่สำคัญ + +--- + +## การ Deploy บน QNAP Container Station + +- [ ] เตรียมการ Deploy บน QNAP Container Station + - [ ] สร้าง `Dockerfile` สำหรับ NestJS App + - [ ] สร้างไฟล์ `docker-compose.yml` สำหรับ `backend` service + - [ ] กำหนด `environment` สำหรับ `DATABASE_HOST`, `DATABASE_USER`, `DATABASE_PASSWORD`, `JWT_SECRET` + - [ ] เชื่อมต่อกับ `lcbp3` network + - [ ] ทดสอบ Build และ Run บน Container Station UI + - [ ] ตั้งค่า Health Check endpoint (`/health`) โดยใช้ `@nestjs/terminus` diff --git a/docs/Markdown/LCBP3-DMS_V1_3_0_frontend_dev_plan.md b/docs/Markdown/LCBP3-DMS_V1_3_0_frontend_dev_plan.md new file mode 100644 index 0000000..32e4e52 --- /dev/null +++ b/docs/Markdown/LCBP3-DMS_V1_3_0_frontend_dev_plan.md @@ -0,0 +1,169 @@ + +# แผนการพัฒนา Frontend Next.js สำหรับ DMS v1.3.0 + +## การเตรียมความพร้อมและการติดตั้ง (Prerequisites & Setup) + +- [ ] สร้าง Next.js Project ใหม่ (App Router) + + ```bash + npx create-next-app@latest frontend --typescript --tailwind --eslint --app + ``` + +- [ ] ติดตั้ง Dependencies หลักๆ ตามเอกสาร FullStackJS + - [ ] UI Library: `@shadcn/ui` และ dependencies ที่เกี่ยวข้อง + - [ ] State Management: `zustand` + - [ ] Server State: `@tanstack/react-query` + - [ ] Form Handling: `react-hook-form`, `zod`, `@hookform/resolvers` + - [ ] File Upload: `react-dropzone` + - [ ] Icons: `lucide-react` + - [ ] Testing: `vitest`, `@testing-library/react`, `@testing-library/jest-dom`, `@playwright/test` +- [ ] ตั้งค่าโครงสร้างโปรเจกต์ + + ``` + src/ + ├── app/ # App Router + │ ├── (dashboard)/ # Route Groups + │ ├── api/ # API Routes (ถ้าจำเป็น) + │ ├── globals.css + │ ├── layout.tsx + │ └── page.tsx + ├── components/ # Reusable UI Components + │ ├── ui/ # shadcn/ui components + │ ├── forms/ # Form Components + │ └── features/ # Feature-specific Components + ├── lib/ # Utility functions + │ ├── api.ts # Axios/Fetch wrapper + │ ├── auth.ts # Auth helpers + │ └── utils.ts + ├── hooks/ # Custom React Hooks + ├── store/ # Zustand stores + └── types/ # TypeScript type definitions + ``` + +- [ ] ตั้งค่า Tailwind CSS และ shadcn/ui +- [ ] ตั้งค่า React Query ใน `app/providers.tsx` และครอบใน `layout.tsx` +- [ ] ตั้งค่า Zustand store สำหรับ Global State (เช่น User, Auth) + +--- + +## Phase 1: การสร้างรากฐานและการยืนยันตัวตน (Foundation & Authentication) - สัปดาห์ที่ 1-2 + +- [ ] พัฒนา Layout หลัก (App Shell - Req 5.1) + - [ ] สร้าง `Navbar` Component (ชื่อระบบ, เมนูผู้ใช้, ปุ่ม Logout) + - [ ] สร้าง `Sidebar` Component (เมนูการนำทางหลัก) + - [ ] สร้าง `MainContent` Component สำหรับแสดงผลหน้าต่างๆ + - [ ] ประกอบ Component ทั้งหมดใน `layout.tsx` +- [ ] พัฒนาระบบ Authentication + - [ ] สร้าง `LoginPage` Component (ใช้ `react-hook-form` + `zod`) + - [ ] สร้าง Auth Store ด้วย Zustand (เก็บ User, Token, สถานะการล็อกอิน) + - [ ] สร้าง `useAuth` Hook สำหรับเข้าถึง Auth State + - [ ] สร้าง API functions สำหรับ Login, Logout, Get Profile + - [ ] สร้าง Middleware สำหรับป้องกัน Route ที่ต้องการ Login +- [ ] สร้าง `ProfilePage` (Req 5.5) + - [ ] แสดงข้อมูลผู้ใช้ + - [ ] ฟอร์มแก้ไขข้อมูลส่วนตัว + - [ ] ฟอร์มเปลี่ยนรหัสผ่าน + +--- + +## Phase 2: พัฒนาคอมโพเนนต์หลักและหน้า Dashboard (Core Components & Dashboard) - สัปดาห์ที่ 3-4 + +- [ ] พัฒนา Reusable Components พื้นฐาน + - [ ] `DataTable` Component (รองรับ Server-side Pagination, Sorting, Filtering) + - [ ] `FormSelect`, `FormInput`, `FormTextarea` (ครอบด้วย `react-hook-form`) + - [ ] `LoadingSpinner`, `ErrorAlert` Components + - [ ] `ConfirmDialog` Component +- [ ] พัฒนา `FileUpload` Component (Req 5.7) + - [ ] ใช้ `react-dropzone` สำหรับ Drag-and-Drop + - [ ] รองรับการอัปโหลดหลายไฟล์ + - [ ] มี Checkbox ให้เลือก "เอกสารหลัก" (Main Document) + - [ ] แสดงรายการไฟล์ที่เลือกพร้อมตัวเลือกลบ +- [ ] พัฒนา `AttachmentList` Component + - [ ] แสดงรายการไฟล์แนบที่เชื่อมโยงกับเอกสาร + - [ ] แสดง Badge "เอกสารหลัก" + - [ ] ปุ่มดาวน์โหลดแต่ละไฟล์ +- [ ] พัฒนา `DashboardPage` (Req 5.3) + - [ ] สร้าง `KpiCard` Component สำหรับแสดงข้อมูลสรุป + - [ ] สร้าง `MyTasksTable` Component + - [ ] ดึงข้อมูลจาก API endpoint ที่เชื่อมต่อกับ View `v_user_tasks` + - [ ] แสดงคอลัมน์: ชื่อเอกสาร, ประเภท, วันครบกำหนด, สถานะ + - [ ] ปุ่ม "ดำเนินการ" ที่นำไปยังหน้าที่เกี่ยวข้อง + +--- + +## Phase 3: พัฒนาโมดูลเอกสารโต้ตอบและเวิร์กโฟลว์ (Correspondence & Workflow Modules) - สัปดาห์ที่ 5-7 + +- [ ] พัฒนา `CorrespondenceModule` (Req 3.2) + - [ ] หน้ารายการเอกสาร (`/correspondences`) + - [ ] `DataTable` พร้อม Filter: โครงการ, ประเภทเอกสาร, ช่วงวันที่, ผู้ส่ง/ผู้รับ + - [ ] ปุ่ม "สร้างใหม่", "ดู", "แก้ไข" (ตามสิทธิ์) + - [ ] หน้าสร้าง/แก้ไขเอกสาร (`/correspondences/new`, `/correspondences/[id]/edit`) + - [ ] ฟอร์มสร้างเอกสาร (ใช้ `react-hook-form`) + - [ ] Dropdowns ที่เชื่อมโยงกัน (Project -> Contract) + - [ ] การเลือกผู้รับ (To/CC) หลายองค์กร + - [ ] การใส่ Tag + - [ ] การเชื่อมโยงเอกสารอ้างอิง + - [ ] ใช้ `FileUpload` และ `AttachmentList` Components + - [ ] หน้ารายละเอียดเอกสาร (`/correspondences/[id]`) + - [ ] แสดงข้อมูลทั้งหมดของเอกสาร + - [ ] แสดงประวัติการแก้ไข (Revisions) + - [ ] แสดงสถานะการส่งต่อ (Routings) +- [ ] พัฒนา `RfaModule` (Req 3.5, 5.6) + - [ ] ฟังก์ชันพื้นฐานคล้ายกับ CorrespondenceModule + - [ ] พัฒนา `WorkflowVisualization` Component **(สำคัญ)** + - [ ] ดึงข้อมูลจาก `rfa_workflows` table + - [ ] แสดงขั้นตอนทั้งหมดเป็นลำดับ (เช่น การ์ดหรือไลน์) + - [ ] ขั้นตอนปัจจุบัน (Active) สามารถดำเนินการได้ + - [ ] ขั้นตอนอื่นๆ แสดงเป็น Disabled + - [ ] มีปุ่มสำหรับ Action: "อนุมัติ", "ปฏิเสธ", "ขอแก้ไข" + - [ ] สำหรับ Admin: ปุ่ม "บังคับไปขั้นตอนถัดไป", "ย้อนกลับ" + - [ ] แสดงความคิดเห็นในแต่ละขั้นตอน + +--- + +## Phase 4: พัฒนาโมดูลแบบแปลนและคุณสมบัติขั้นสูง (Drawings & Advanced Features) - สัปดาห์ที่ 8-9 + +- [ ] พัฒนา `DrawingModule` (Req 3.3, 3.4) + - [ ] แยกระหว่าง `ContractDrawingPage` และ `ShopDrawingPage` + - [ ] ฟอร์มสร้าง/แก้ไขแบบแปลน + - [ ] การจัดการ Revision (เช่น การสร้าง Revision ใหม่จาก Revision ปัจจุบัน) + - [ ] การเชื่อมโยง Shop Drawing Revision กับ Contract Drawing +- [ ] พัฒนา `CirculationModule` (Req 3.7) + - [ ] หน้ารายการใบเวียนภายใน + - [ ] ฟอร์มสร้างใบเวียน + - [ ] การมอบหมายงานให้ผู้รับผิดชอบ (Main, Action, Info) + - [ ] หน้ารายละเอียดสำหรับผู้รับผิดชอบกระทำ (แสดงความคิดเห็น, ปุ่มปิดงาน) +- [ ] พัฒนา `AdminPanel` (Req 4.5, 4.6) + - [ ] หน้าจัดการผู้ใช้ (Create/Edit/Delete Users ในองค์กร) + - [ ] หน้าจัดการ Roles และ Permissions + - [ ] หน้าจัดการ Master Data (Tags, Document Types, Categories) + - [ ] หน้าจัดการรูปแบบเลขที่เอกสาร (Document Numbering Formats) +- [ ] พัฒนา `AdvancedSearchPage` (Req 6.2) + - [ ] ฟอร์มค้นหาขั้นสูงพร้อมฟิลด์ต่างๆ + - [ ] ส่งคำขอไปยัง Search API (Elasticsearch) + - [ ] แสดงผลลัพธ์ใน `DataTable` + +--- + +## Phase 5: การทดสอบ ปรับปรุงประสิทธิภาพ และเตรียม Deploy (Testing, Optimization & Deployment) - สัปดาห์ที่ 10 + +- [ ] ดำเนินการทดสอบ (Testing) + - [ ] **Unit/Integration Tests:** + - [ ] เขียนทดสอบสำหรับ `FileUpload` Component (Vitest + RTL) + - [ ] เขียนทดสอบสำหรับ `DataTable` Component + - [ ] เขียนทดสอบสำหรับ Custom Hooks (เช่น `useAuth`) + - [ ] **E2E Tests:** + - [ ] เขียนทดสอบ User Flow: Login -> สร้าง RFA -> อนุมัติ (Playwright) + - [ ] เขียนทดสอบ User Flow: สร้างใบเวียน -> มอบหมายงาน -> ตอบกลับ +- [ ] ปรับปรุงประสิทธิภาพ (Performance) + - [ ] ใช้ `next/dynamic` สำหรับ lazy loading ของ Components ที่ใหญ่ + - [ ] ตรวจสอบการใช้ React Query เพื่อให้แน่ใจว่ามีการ Caching และ Re-fetching ที่เหมาะสม + - [ ] ใช้ Image Optimization ของ Next.js +- [ ] การเตรียม Deploy + - [ ] สร้าง `Dockerfile` สำหรับ Frontend (Multi-stage build) + - [ ] สร้างไฟล์ `docker-compose.yml` สำหรับ `frontend` service + - [ ] กำหนด `build` จาก `Dockerfile` + - [ ] กำหนด `environment` สำหรับ `NEXT_PUBLIC_API_URL` + - [ ] เชื่อมต่อกับ `lcbp3` network + - [ ] ทดสอบ Build และ Run บน Container Station UI + - [ ] ตั้งค่า Nginx Proxy Manager ให้ชี้ `lcbp3.np-dms.work` มายัง Frontend Container diff --git a/docs/Markdown/LCBP3-DMS_V1_3_0_requirements.md b/docs/Markdown/LCBP3-DMS_V1_3_0_requirements.md new file mode 100644 index 0000000..4499c52 --- /dev/null +++ b/docs/Markdown/LCBP3-DMS_V1_3_0_requirements.md @@ -0,0 +1,210 @@ +# **📝 Documents Management Sytem Version 1.2.1: Application Requirements Specification** + +## **📌 1. วัตถุประสงค์** + +สร้างเว็บแอปพลิเคชั่นสำหรับระบบบริหารจัดการเอกสารโครงการ (Document Management System)ที่สามารถจัดการและควบคุม การสื่อสารด้วยเอกสารที่ซับซ้อน อย่างมีประสิทธิภาพ + +* มีฟังก์ชันหลักในการอัปโหลด จัดเก็บ ค้นหา แชร์ และควบคุมสิทธิ์การเข้าถึงเอกสาร +* ช่วยลดการใช้เอกสารกระดาษ เพิ่มความปลอดภัยในการจัดเก็บข้อมูล +* เพิ่มความสะดวกในการทำงานร่วมกันระหว่างองกรณ์ + +## **🛠️ 2. สถาปัตยกรรมและเทคโนโลยี (System Architecture & Technology Stack)** + +ใช้สถาปัตยกรรมแบบ Headless/API-First ที่ทันสมัย ทำงานทั้งหมดบน QNAP Server ผ่าน Container Station เพื่อความสะดวกในการจัดการและบำรุงรักษา, Domain: np-dms.work, มี fix ip, รัน docker command ใน application ของ Container Station ได้โดยตรง, ประกอบด้วย + +* 2.1. Infrastructure & Environment: + * Server: QNAP (Model: TS-473A, RAM: 32GB, CPU: AMD Ryzen V1500B) + * Containerization: Container Station (Docker & Docker Compose) ใช้ UI ของ Container Station เป็นหลัก ในการ configuration และการรัน docker command + * Development Environment: VS Code on Windows 11 + * Domain: np-dms.work, www.np-dms.work + * ip: 159.192.126.103 + * Docker Network: ทุก Service จะเชื่อมต่อผ่านเครือข่ายกลางชื่อ lcbp3 เพื่อให้สามารถสื่อสารกันได้ + * Data Storage: /share/dms-data บน QNAP + * ข้อจำกัด: ไม่สามารถใช้ .env ในการกำหนดตัวแปรภายนอกได้ ต้องกำหนดใน docker-compose.yml เท่านั้น +* 2.2. Code Hosting: + * Application name: git + * Service: Gitea (Self-hosted on QNAP) + * Service name: gitea + * Domain: git.np-dms.work + * หน้าที่: เป็นศูนย์กลางในการเก็บและจัดการเวอร์ชันของโค้ด (Source Code) สำหรับทุกส่วน +* 2.3. Backend / Data Platform: + * Application name: lcbp3-backend + * Service: NestJS + * Service name: backend + * Domain: backend.np-dms.work + * Framework: NestJS (Node.js, TypeScript, ESM) + * หน้าที่: จัดการโครงสร้างข้อมูล (Data Models), สร้าง API, จัดการสิทธิ์ผู้ใช้ (Roles & Permissions), และสร้าง Workflow ทั้งหมดของระบบ +* 2.4. Database: + * Application name: lcbp3-db + * Service: mariadb:10.11 + * Service name: mariadb + * Domain: db.np-dms.work + * หน้าที่: ฐานข้อมูลหลักสำหรับเก็บข้อมูลทั้งหมด + * Tooling: DBeaver (Community Edition), phpmyadmin สำหรับการออกแบบและจัดการฐานข้อมูล +* 2.5. Database management: + * Application name: lcbp3-db + * Service: phpmyadmin:5-apache + * Service name: pma + * Domain: pma.np-dms.work + * หน้าที่: จัดการฐานข้อมูล mariadb ผ่าน Web UI +* 2.6. Frontend: + * Application name: lcbp3-frontend + * Service: next.js + * Service name: frontend + * Domain: lcbp3.np-dms.work + * Framework: Next.js (App Router, React, TypeScript, ESM) + * Styling: Tailwind CSS + PostCSS + * Component Library: shadcn/ui + * หน้าที่: สร้างหน้าตาเว็บแอปพลิเคชันสำหรับให้ผู้ใช้งานเข้ามาดู Dashboard, จัดการเอกสาร, และติดตามงาน โดยจะสื่อสารกับ Backend ผ่าน API +* 2.7. Workflow automation: + * Application name: lcbp3-n8n + * Service: n8nio/n8n:latest + * Service name: n8n + * Domain: n8n.np-dms.work + * หน้าที่: จัดการ workflow ระหว่าง Backend และ Line +* 2.8. Reverse Proxy: + * Application name: lcbp3-npm + * Service: Nginx Proxy Manager (nginx-proxy-manage: latest) + * Service name: npm + * Domain: npm.np-dms.work + * หน้าที่: เป็นด่านหน้าในการรับ-ส่งข้อมูล จัดการโดเมนทั้งหมด, ทำหน้าที่เป็น Proxy ชี้ไปยัง Service ที่ถูกต้อง, และจัดการ SSL Certificate (HTTPS) ให้อัตโนมัติ +* **2.9. การจัดการตรรกะทางธุรกิจ (Business Logic Implementation):** + * 2.9.1. ตรรกะทางธุรกิจที่ซับซ้อนทั้งหมด (เช่น การเปลี่ยนสถานะ Workflow [cite: 3.5.4, 3.6.5], การบังคับใช้สิทธิ์ [cite: 4.4], การตรวจสอบ Deadline [cite: 3.2.5]) **จะถูกจัดการในฝั่ง Backend (NestJS)** [cite: 2.3] เพื่อให้สามารถบำรุงรักษาและทดสอบได้ง่าย (Testability) + * 2.9.2. **จะไม่มีการใช้ SQL Triggers** เพื่อป้องกันตรรกะซ่อนเร้น (Hidden Logic) และความซับซ้อนในการดีบัก + * 2.9.3. **ข้อยกเว้น:** ตรรกะเดียวที่จะอยู่ในฐานข้อมูลคือ **Stored Procedure** สำหรับการสร้างเลขที่เอกสาร (Document Numbering) [cite: 3.10] เพื่อป้องกันการซ้ำซ้อนของข้อมูล (Race Condition) + +## **📦 3. ข้อกำหนดด้านฟังก์ชันการทำงาน (Functional Requirements)** + +* 3.1. การจัดการโครงสร้างโครงการและองค์กร + * 3.1.1. โครงการ (Projects): ระบบต้องสามารถจัดการเอกสารภายในหลายโครงการได้ (ปัจจุบันมี 4 โครงการ และจะเพิ่มขึ้นในอนาคต) + * 3.1.2. สัญญา (Contracts): ระบบต้องสามารถจัดการเอกสารภายในแต่ละสัญญาได้ ในแต่ละโครงการ มีได้หลายสัญญา หรืออย่างน้อย 1 สัญญา + * 3.1.3. องค์กร (Organizations): + * มีหลายองค์กรในโครงการ องค์กรณ์ที่เป็น Owner, Designer และ Consultant สามารถอยู่ในหลายโครงการและหลายสัญญาได้ + * Contractor จะถือ 1 สัญญา และอยู่ใน 1 โครงการเท่านั้น +* 3.2. การจัดการเอกสารโต้ตอบ (Correspondence Management) + * 3.2.1. วัตถุประสงค์: เอกสารโต้ตอบ (correspondences) ระหว่างองกรณื-องกรณ์ ภายใน โครงการ (Projects) และระหว่าง องค์กร-องค์กร ภายนอก โครงการ (Projects), รองรับ To (ผู้รับหลัก) และ CC (ผู้รับสำเนา) หลายองค์กร + * 3.2.2. ประเภทเอกสาร: ระบบต้องรองรับเอกสารรูปแบบ ไฟล์ PDF หลายประเภท (Types) เช่น จดหมาย (Letter), อีเมล์ (Email), Request for Information (RFI), และสามารถเพิ่มประเภทใหม่ได้ในภายหลัง + * 3.2.3. การสร้างเอกสาร (Correspondence): + * ผู้ใช้ที่มีสิทธิ์ (เช่น Document Control) สามารถสร้างเอกสารรอไว้ในสถานะ ฉบับร่าง" (Draft) ได้ ซึ่งผู้ใช้งานต่างองค์กรจะมองไม่เห็น + * เมื่อกด "Submitted" แล้ว การแก้ไข, ถอนเอกสารกลับไปสถานะ Draft, หรือยกเลิก (Cancel) จะต้องทำโดยผู้ใช้ระดับ Admin ขึ้นไป พร้อมระบุเหตุผล + * 3.2.4. การอ้างอิงและจัดกลุ่ม: + * เอกสารสามารถอ้างถึง (Reference) เอกสารฉบับก่อนหน้าได้หลายฉบับ + * สามารถกำหนด Tag ได้หลาย Tag เพื่อจัดกลุ่มและใช้ในการค้นหาขั้นสูง + * 3.2.5. การจัดการ: มีการจัดการอย่างน้อยดังนี้ + * สามารถกำหนดวันแล้วเสร็จ (Deadline) สำหรับผู้รับผิดชอบของ องกรณ์ ที่เป็นผู้รับได้ + * มีระบบแจ้งเตือน ให้ผู้รับผิดชอบขององกรณ์ที่เป็น ผู้รับ/ผู้ส่ง ทราบ เมื่อมีเอกสารใหม่ หรือมีการเปลี่ยนสถานะ +* 3.3. การจัดกาแบบคู่สัญญา (Contract Drawing) + * 3.3.1. วัตถุประสงค์: แบบคู่สัญญา (Contract Drawing) ใช้เพื่ออ้างอิงและใช้ในการตรวจสอบ + * 3.3.2. ประเภทเอกสาร: ไฟล์ PDF + * 3.3.3. การสร้างเอกสาร: ผู้ใช้ที่มีสิทธิ์ สามารถสร้างและแก้ไขได้ + * 3.3.4. การอ้างอิงและจัดกลุ่ม: ใช้สำหรับอ้างอิง ใน Shop Drawings, มีการจัดหมวดหมู่ของ Contract Drawing +* 3.4. การจัดกาแบบก่อสร้าง (Shop Drawing) + * 3.4.1. วัตถุประสงค์: แบบก่อสร้าง (Shop Drawing) ใช้เในการตรวจสอบ โดยจัดส่งด้วย Request for Approval (RFA) + * 3.4.2. ประเภทเอกสาร: ไฟล์ PDF + * 3.4.3. การสร้างเอกสาร: ผู้ใช้ที่มีสิทธิ์ สามารถสร้างและแก้ไขได้ + * 3.4.4. การอ้างอิงและจัดกลุ่ม: ช้สำหรับอ้างอิง ใน Shop Drawings, มีการจัดหมวดหมู่ของ Shop Drawings +* 3.5. การจัดการเอกสารขออนุมัติ (Request for Approval & Workflow) + * 3.5.1. วัตถุประสงค์: เอกสารขออนุมัติ (Request for Approval) ใช้ในการส่งเอกสารเพิอขออนุมัติ + * 3.5.2. ประเภทเอกสาร: Request for Approval (RFA) เป็นชนิดหนึ่งของ Correspondence ที่มีลักษณะเฉพาะที่ต้องได้รับการอนุมัติ มีประเภทดังนี้: + * Request for Drawing Approval (RFA_DWG) + * Request for Document Approval (RFA_DOC) + * Request for Method statement Approval (RFA_MES) + * Request for Material Approval (RFA_MAT) + * 3.5.2. การสร้างเอกสาร: ผู้ใช้ที่มีสิทธิ์ สามารถสร้างและแก้ไขได้ + * 3.5.4. การอ้างอิงและจัดกลุ่ม: การจัดการ Drawing (RFA_DWG): + * เอกสาร RFA_DWG จะประกอบไปด้วย Shop Drawing (shop_drawings) หลายแผ่น ซึ่งแต่ละแผ่นมี Revision ของตัวเอง + * Shop Drawing แต่ละ Revision สามารถอ้างอิงถึง Contract Drawing (Ccontract_drawings) หลายแผ่น หรือไม่อ้างถึงก็ได้ + * ระบบต้องมีส่วนสำหรับจัดการข้อมูล Master Data ของทั้ง Shop Drawing และ Contract Drawing แยกจากกัน + * 3.6.5. Workflow การอนุมัติ: ต้องรองรับกระบวนการอนุมัติที่ซับซ้อนและเป็นลำดับ เช่น + * ส่งจาก Originator -> Organization 1 -> Organization 2 -> Organization 3 แล้วส่งผลกลับตามลำดับเดิม (โดยถ้า องกรณ์ใดใน Workflow ให้ส่งกลับ ก็สามารถส่งผลกลับตามลำดับเดิมโดยไม่ต้องรอให้ถึง องกรณืในลำดับถัดไป) + * 3.6.6. การจัดการ: มีการจัดการอย่างน้อยดังนี้ + * สามารถกำหนดวันแล้วเสร็จ (Deadline) สำหรับผู้รับผิดชอบของ องกรณ์ ที่อยู่ใน Workflow ได้ + * มีระบบแจ้งเตือน ให้ผู้รับผิดชอบของ องกรณ์ ที่อยู่ใน Workflow ทราบ เมื่อมี RFA ใหม่ หรือมีการเปลี่ยนสถานะ +* 3.6.การจัดการเอกสารนำส่ง (Transmittals) + * 3.6.1. วัตถุประสงค์: เอกสารนำส่ง ใช้สำหรับ นำส่ง Request for Approval (RFAS) หลายฉบับ ไปยังองค์กรอื่น + * 3.6.2. ประเภทเอกสาร: ไฟล์ PDF + * 3.6.3. การสร้างเอกสาร: ผู้ใช้ที่มีสิทธิ์ สามารถสร้างและแก้ไขได้ + * 3.6.4. การอ้างอิงและจัดกลุ่ม: เอกสารนำส่ง เป็นส่วนหนึ่งใน Correspondence +* 3.7. ใบเวียนเอกสารภายใน (Internal Circulation Sheet) + * 3.7.1. วัตถุประสงค์: การสื่อสาร เอกสาร (Correspondence) ทุกฉบับ จะมีใบเวียนเอกสารเพื่อควบคุมและมอบหมายงานภายในองค์กร (สามารถดูและแก้ไขได้เฉพาะคนในองค์กร) + * 3.7.2. ประเภทเอกสาร: ไฟล์ PDF + * 3.7.3. การสร้างเอกสาร: ผู้ใช้ที่มีสิทธิ์ในองค์กรนั้น สามารถสร้างและแก้ไขได้ + * 3.7.4. การอ้างอิงและจัดกลุ่ม: การระบุผู้รับผิดชอบ: + * ผู้รับผิดชอบหลัก (Main): มีได้หลายคน + * ผู้ร่วมปฏิบัติงาน (Action): มีได้หลายคน + * ผู้ที่ต้องรับทราบ (Information): มีได้หลายคน + * 3.7.5. การติดตามงาน: + * สามารถกำหนดวันแล้วเสร็จ (Deadline) สำหรับผู้รับผิดชอบประเภท Main และ Action ได้ + * มีระบบแจ้งเตือนเมื่อมี Circulation ใหม่ และแจ้งเตือนล่วงหน้าก่อนถึงวันแล้วเสร็จ + * สามารถปิด Circulation ได้เมื่อดำเนินการตอบกลับไปยังองค์กรผู้ส่ง (Originator) แล้ว หรือ รับทราบแล้ว (For Information) +* 3.8. ประวัติการแก้ไข (Revisions): ระบบจะเก็บประวัติการสร้างและแก้ไข เอกสารทั้งหมด +* 3.9. การจัดเก็บ: (ปรับปรุงตามสถาปัตยกรรมใหม่) + * เอกสารและไฟล์แนบทั้งหมดจะถูกจัดเก็บในโฟลเดอร์บน Server (/share/dms-data/) [cite: 2.1] + * ข้อมูล Metadata ของไฟล์ (เช่น ชื่อไฟล์, ขนาด, path) จะถูกเก็บในตาราง attachments (ตารางกลาง) + * ไฟล์จะถูกเชื่อมโยงกับเอกสารประเภทต่างๆ ผ่านตารางเชื่อม (Junction tables) เช่น correspondence_attachments, circulation_attachments, shop_drawing_revision_attachments ,และ contracy_drawing_attachments + * สถาปัตยกรรมแบบรวมศูนย์นี้ *แทนที่* แนวคิดเดิมที่จะแยกโฟลเดอร์ตามประเภทเอกสาร เพื่อรองรับการขยายระบบที่ดีกว่า +* 3.10. การจัดการเลขที่เอกสาร (Document Numbering): + * 3.10.1. ระบบต้องสามารถสร้างเลขที่เอกสาร (เช่น correspondence_number) ได้โดยอัตโนมัติ + * 3.10.2. การนับเลข Running Number (SEQ) จะต้องนับแยกตาม Key ดังนี้: **โครงการ (Project)**, **องค์กรผู้ส่ง (Originator Organization)**, **ประเภทเอกสาร (Document Type)** และ **ปีปัจจุบัน (Year)** + * 3.10.3. ผู้ดูแลระบบ (Admin) ต้องสามารถกำหนด "รูปแบบ" (Format Template) ของเลขที่เอกสารได้ (เช่น {ORG_CODE}-{TYPE_CODE}-{YEAR_SHORT}-{SEQ:4}) โดยกำหนดแยกตามโครงการและประเภทเอกสาร + +## **🔐 4. ข้อกำหนดด้านสิทธิ์และการเข้าถึง (Access Control Requirements)** + +* 4.1. ภาพรวม: ผู้ใช้และองค์กรสามารถดูและแก้ไขเอกสารได้ตามสิทธิ์ที่ได้รับ โดยระบบสิทธิ์จะเป็นแบบ Role-Based Access Control (RBAC) +* 4.2. ระดับของสิทธิ์: + * Global Roles: สิทธิ์ในภาพรวมของระบบ + * Project-Specific Roles: สิทธิ์ที่ถูกกำหนดให้ผู้ใช้สำหรับโครงการนั้นๆ โดยเฉพาะ (เช่น เป็น Editor ในโครงการ A แต่เป็น Viewer ในโครงการ B) +* 4.3. บทบาท (Roles) พื้นฐาน: + * Superadmin: ไม่มีข้อจำกัดใดๆ สามารถจัดการได้ทุกอย่างข้ามองค์กรณ์ + * Admin: มีสิทธิ์เต็มที่ แต่จำกัดเฉพาะในองค์กรที่ตัวเองสังกัด สามารถจัดการผู้ใช้ในองค์กรณ์ได้ สามารถสร้าง Role ใหม่และกำหนดสิทธิ์ (Permissions) เพิ่มเติมได้ในภายหลังผ่านหน้า Admin + * Document Control สามารถ เพิ่ม/แก้ไข/ลบ เอกสาร เฉพาะในองค์กรณ์ที่ตัวเองสังกัด ไม่สามารถจัดการผู้ใช้ได้ + * Editor: สามารถ เพิ่ม/แก้ไข เอกสารที่กำหนดไว้ เฉพาะในองค์กรณ์ที่ตัวเองสังกัด + * Viewer: สามารถดู เอกสาร เฉพาะในองค์กรณ์ที่ตัวเองสังกัด +* 4.4. การบังคับใช้สิทธิ์: สิทธิ์ขององค์กรจะครอบคลุมสิทธิ์ของผู้ใช้ และการเข้าถึงข้อมูลที่เกี่ยวข้องกับโครงการ (เช่น การแก้ไขเอกสาร) จะถูกตรวจสอบเทียบกับสิทธิ์ที่ผู้ใช้มีในโครงการนั้นๆ โดยเฉพาะ +* 4.5. (ใหม่) การจัดการข้อมูลหลัก (Master Data Management): + * ระบบจะต้องมีส่วน "Admin Panel" (สำหรับ Superadmin และ Admin) เพื่อใช้จัดการข้อมูลหลัก (Master Data) ของระบบ + * ข้อมูลหลักที่ต้องจัดการได้เป็นอย่างน้อย: + * ประเภทเอกสาร (เช่น correspondence_types, rfa_types) + * หมวดหมู่แบบ (เช่น shop_drawing_categories) + * Tags ที่ใช้ในระบบ + * สถานะเอกสาร (หากจำเป็นต้องเพิ่มในอนาคต) +* 4.6. (ใหม่) การเริ่มต้นใช้งาน (User & Organization Onboarding): + * การเพิ่มองค์กรณ์ใหม่ (Organizations) เข้าสู่ระบบ จะต้องดำเนินการโดย Superadmin เท่านั้น + * เมื่อ Superadmin สร้างองค์กรณ์ใหม่ จะต้องสามารถกำหนดผู้ใช้ (User) อย่างน้อย 1 คน ให้เป็น "Admin" ประจำองค์กรณ์นั้นๆ + * Admin ประจำองค์กณ์รจึงจะสามารถเพิ่มผู้ใช้ (Editor, Viewer, Document Control) คนอื่นๆ เข้าสู่องค์กรของตนเองได้ + +## **👥 5\. ข้อกำหนดด้านผู้ใช้งาน (User Interface & Experience)** + +* 5.1. Layout หลัก: หน้าเว็บใช้รูปแบบ App Shell ที่ประกอบด้วย: + * Navbar (ส่วนบน): แสดงชื่อระบบ, เมนูผู้ใช้ (Profile), เมนูสำหรับ Admin/Superadmin (จัดการผู้ใช้, จัดการสิทธิ์), และปุ่ม Login/Logout + * Sidebar (ด้านข้าง): เป็นเมนูหลักสำหรับเข้าถึงส่วนที่เกี่ยวกับเอกสารทั้งหมด เช่น Dashboard, Correspondences, RFA, Drawings + * Main Content Area: พื้นที่สำหรับแสดงเนื้อหาหลักของหน้าที่เลือก +* 5.2. หน้า Landing Page: เป็นหน้าแรกที่แสดงข้อมูลบางส่วนของโครงการสำหรับผู้ใช้ที่ยังไม่ได้ล็อกอิน +* 5.3. หน้า Dashboard: เป็นหน้าแรกหลังจากล็อกอิน ประกอบด้วย: + * การ์ดสรุปภาพรวม (KPI Cards): แสดงข้อมูลสรุปที่สำคัญขององค์กร เช่น จำนวนเอกสาร, งานที่เกินกำหนด + * ตาราง "งานของฉัน" (My Tasks Table): แสดงรายการงานทั้งหมดจาก Circulation ที่ผู้ใช้ต้องดำเนินการ +* 5.4. การติดตามสถานะ: องค์กรสามารถติดตามสถานะเอกสารทั้งของตนเอง (Originator) และสถานะเอกสารที่ส่งมาถึงตนเอง (Recipient) +* 5.5. การจัดการข้อมูลส่วนตัว (Profile Page): ผู้ใช้สามารถจัดการข้อมูลส่วนตัวและเปลี่ยนรหัสผ่านของตนเองได้ +* 5.6. การจัดการเอกสารทางเทคนิค (Technical Documents & Workflow): ผู้ใช้สามารถดู Technical Document ในรูปแบบ Workflow ทั้งหมดได้ในหน้าเดียว, ขั้นตอนที่ยังไม่ถึงหรือผ่านไปแล้วจะเป็นรูปแบบ diable, สามารถดำเนินการได้เฉพาะในขั้นตอนที่ได้รับมอบหมายงาน (active) เช่น ตรวจสอบแล้ว เพื่อไปยังขั้นตอนต่อไป, สิทธิ์ admin ขึ้นไป สามรถกด ไปยังขั้นตอนต่อไป ได้ทุกขั้นตอน, การย้อนกลับ ไปขั้นตอนก่อนหน้า สามารถทำได้โดย สิทธิ์ admin ขึ้นไป +* 5.7. ข้อกำหนด UI/UX การแนบไฟล์ (File Attachment UX): + * ระบบต้องรองรับการอัปโหลดไฟล์หลายไฟล์พร้อมกัน (Multi-file upload) เช่น การลากและวาง (Drag-and-Drop) + * ในหน้าอัปโหลด (เช่น สร้าง RFA หรือ Correspondence) ผู้ใช้ต้องสามารถกำหนดได้ว่าไฟล์ใดเป็น "เอกสารหลัก" (Main Document เช่น PDF) และไฟล์ใดเป็น "เอกสารแนบประกอบ" (Supporting Attachments เช่น .dwg, .docx, .zip) + +## **6. ข้อกำหนดที่ไม่ใช่ฟังก์ชันการทำงาน (Non-Functional Requirements)** + +* 6.1. การบันทึกการกระทำ (Audit Log): ทุกการกระทำที่สำคัญของผู้ใช้ (สร้าง, แก้ไข, ลบ, ส่ง) จะถูกบันทึกไว้ใน audit_logs เพื่อการตรวจสอบย้อนหลัง +* 6.2. การค้นหา (Search): ระบบต้องมีฟังก์ชันการค้นหาขั้นสูง ที่สามารถค้นหาเอกสาร **correspondence**, **rfa**, **shop_drawing**, **contract-drawing**, **transmittal** และ **ใบเวียน (Circulations)** จากหลายเงื่อนไขพร้อมกันได้ เช่น ค้นหาจากชื่อเรื่อง, ประเภท, วันที่, และ Tag +* 6.3. การทำรายงาน (Reporting): สามารถจัดทำรายงานสรุปแยกประเภทของ Correspondence ประจำวัน, สัปดาห์, เดือน, และปีได้ +* 6.4. ประสิทธิภาพ (Performance): มีการใช้ Caching กับข้อมูลที่เรียกใช้บ่อย และใช้ Pagination ในตารางข้อมูลเพื่อจัดการข้อมูลจำนวนมาก +* 6.5. ความปลอดภัย (Security): + * มีระบบ Rate Limiting เพื่อป้องกันการโจมตีแบบ Brute-force + * การจัดการ Secret (เช่น รหัสผ่าน DB, JWT Secret) จะต้องทำผ่าน Environment Variable ของ Docker เพื่อความปลอดภัยสูงสุด +* 6.6. (ใหม่) การสำรองข้อมูลและการกู้คืน (Backup & Recovery): + * ระบบจะต้องมีกลไกการสำรองข้อมูลอัตโนมัติสำหรับฐานข้อมูล MariaDB [cite: 2.4] และไฟล์เอกสารทั้งหมดใน /share/dms-data [cite: 2.1] (เช่น ใช้ HBS 3 ของ QNAP หรือสคริปต์สำรองข้อมูล) อย่างน้อยวันละ 1 ครั้ง + * ต้องมีแผนการกู้คืนระบบ (Disaster Recovery Plan) ในกรณีที่ Server หลัก (QNAP) ใช้งานไม่ได้ +* 6.7. (ใหม่) กลยุทธ์การแจ้งเตือน (Notification Strategy): + * ระบบจะส่งการแจ้งเตือน (ผ่าน Email หรือ Line [cite: 2.7]) เมื่อมีการกระทำที่สำคัญ ดังนี้: + 1. เมื่อมีเอกสารใหม่ (Correspondence, RFA) ถูกส่งมาถึงองค์กรณ์ของเรา + 2. เมื่อมีใบเวียน (Circulation) ใหม่ มอบหมายงานมาที่เรา + 3. (ทางเลือก) เมื่อเอกสารที่เราส่งไป ถูกดำเนินการ (เช่น อนุมัติ/ปฏิเสธ) + 4. (ทางเลือก) เมื่อใกล้ถึงวันครบกำหนด (Deadline) [cite: 3.2.5, 3.6.6, 3.7.5] diff --git a/docs/Markdown/LCBP3-DMS_V1_4_0_Data_Dictionary.bak.md b/docs/Markdown/LCBP3-DMS_V1_4_0_Data_Dictionary.bak.md new file mode 100644 index 0000000..204d8e0 --- /dev/null +++ b/docs/Markdown/LCBP3-DMS_V1_4_0_Data_Dictionary.bak.md @@ -0,0 +1,900 @@ +# **สรุปตารางฐานข้อมูล (Data Dictionary) - LCBP3-DMS (V1.4.0)** + +เอกสารนี้สรุปโครงสร้างตาราง, Foreign Keys (FK), และ Constraints ที่สำคัญทั้งหมดในฐานข้อมูล LCBP3-DMS (v1.4.0) เพื่อใช้เป็นเอกสารอ้างอิงสำหรับทีมพัฒนา Backend (NestJS) และ Frontend (Next.js) โดยอิงจาก Requirements และ SQL Script ล่าสุด + +## **1. 🏢 Core & Master Data (องค์กร, โครงการ, สัญญา)** + +#### **1.1. organization_roles** + +ตาราง Master เก็บประเภทบทบาทขององค์กร (เช่น OWNER, CONTRACTOR) + +| Column | Type | Key | Description | +| :-------- | :---------- | :----- | :--------------------------------------------------------------- | +| id | INT | **PK** | ID ของตาราง | +| role_name | VARCHAR(20) | UK | ชื่อบทบาท (OWNER, DESIGNER, CONSULTANT, CONTRACTOR, THIRD PARTY) | + +- **Unique Keys (UK):** ux_roles_name (role_name) + +--- + +#### **1.2. organizations** + +ตาราง Master เก็บข้อมูลองค์กรทั้งหมดที่เกี่ยวข้องในระบบ + +| Column | Type | Key | Description | +| :---------------- | :----------- | :----- | :--------------------------------------------- | +| id | INT | **PK** | ID ของตาราง | +| organization_code | VARCHAR(20) | UK | รหัสองค์กร | +| organization_name | VARCHAR(255) | | ชื่อองค์กร | +| role_id | INT | FK | บทบาทขององค์กร (FK \-> organization_roles(id)) | +| is_active | BOOLEAN | | สถานะการใช้งาน | +| created_at | TIMESTAMP | | วันที่สร้าง | +| updated_at | TIMESTAMP | | วันที่แก้ไขล่าสุด | + +- **Foreign Keys (FK):** + - role_id -> organization_roles(id) (ON DELETE SET NULL) +- **Unique Keys (UK):** ux_organizations_code (organization_code) + +--- + +#### **1.3. projects** + +ตาราง Master เก็บข้อมูลโครงการ (เช่น LCBP3C1, LCBP3C2) + +| Column | Type | Key | Description | +| :------------------------- | :----------- | :----- | :------------------------------------------------------ | +| id | INT | **PK** | ID ของตาราง | +| project_code | VARCHAR(50) | UK | รหัสโครงการ | +| project_name | VARCHAR(255) | | ชื่อโครงการ | +| parent_project_id | INT | FK | รหัสโครงการหลัก (ถ้ามี) (FK \-> projects(id)) | +| contractor_organization_id | INT | FK | รหัสองค์กรผู้รับเหมา (ถ้ามี) (FK \-> organizations(id)) | +| is_active | TINYINT(1) | | สถานะการใช้งาน | + +- **Foreign Keys (FK):** + - parent_project_id -> projects(id) (ON DELETE SET NULL) + - contractor_organization_id -> organizations(id) (ON DELETE SET NULL) +- **Unique Keys (UK):** uq_pro_code (project_code) + +--- + +#### **1.4. contracts** + +ตาราง Master เก็บข้อมูลสัญญา + +| Column | Type | Key | Description | +| :------------ | :----------- | :----- | :----------------- | +| id | INT | **PK** | ID ของตาราง | +| contract_code | VARCHAR(50) | UK | รหัสสัญญา | +| contract_name | VARCHAR(255) | | ชื่อสัญญา | +| description | TEXT | | คำอธิบายสัญญา | +| start_date | DATE | | วันที่เริ่มสัญญา | +| end_date | DATE | | วันที่สิ้นสุดสัญญา | +| created_at | TIMESTAMP | | วันที่สร้าง | +| updated_at | TIMESTAMP | | วันที่แก้ไขล่าสุด | + +- **Unique Keys (UK):** ux_contracts_code (contract_code) + +--- + +## **2. 👥 Users & RBAC (ผู้ใช้, สิทธิ์, บทบาท)** + +#### **2.1. users** + +ตาราง Master เก็บข้อมูลผู้ใช้งาน (User) + +| Column | Type | Key | Description | +| :-------------- | :----------- | :----- | :-------------------------------------- | +| user_id | INT | **PK** | ID ของตาราง | +| username | VARCHAR(50) | UK | ชื่อผู้ใช้งาน | +| password_hash | VARCHAR(255) | | รหัสผ่าน (Hashed) | +| first_name | VARCHAR(50) | | ชื่อจริง | +| last_name | VARCHAR(50) | | นามสกุล | +| email | VARCHAR(100) | UK | อีเมล | +| line_id | VARCHAR(100) | | LINE ID | +| organization_id | INT | FK | สังกัดองค์กร (FK \-> organizations(id)) | +| is_active | TINYINT(1) | | สถานะการใช้งาน | +| failed_attempts | INT | | จำนวนครั้งที่ล็อกอินล้มเหลว | +| locked_until | DATETIME | | ล็อกอินไม่ได้จนถึงเวลา | +| last_login_at | TIMESTAMP | | วันที่และเวลาที่ล็อกอินล่าสุด | +| created_at | TIMESTAMP | | วันที่สร้าง | +| updated_at | TIMESTAMP | | วันที่แก้ไขล่าสุด | + +- **Foreign Keys (FK):** + - organization_id -> organizations(id) (ON DELETE SET NULL) +- **Unique Keys (UK):** ux_users_username (username), ux_users_email (email) + +--- + +#### **2.2. roles** + +ตาราง Master เก็บ "บทบาท" ของผู้ใช้ในระบบ (เช่น SUPER_ADMIN, ADMIN, EDITOR) + +| Column | Type | Key | Description | +| :---------- | :----------- | :----- | :-------------------------------------------------- | +| role_id | INT | **PK** | ID ของตาราง | +| role_code | VARCHAR(50) | UK | รหัสบทบาท (เช่น SUPER_ADMIN, ADMIN, EDITOR, VIEWER) | +| role_name | VARCHAR(100) | | ชื่อบทบาท | +| description | TEXT | | คำอธิบายบทบาท | +| is_system | BOOLEAN | | (1 = บทบาทของระบบ ลบไม่ได้) | + +- **Unique Keys (UK):** role_code + +--- + +#### **2.3. permissions** + +ตาราง Master เก็บ "สิทธิ์" (Permission) หรือ "การกระทำ" ทั้งหมดในระบบ + +| Column | Type | Key | Description | +| :-------------- | :----------- | :----- | :------------------------------------------ | +| permission_id | INT | **PK** | ID ของตาราง | +| permission_code | VARCHAR(100) | UK | รหัสสิทธิ์ (เช่น rfas.create, rfas.view) | +| description | TEXT | | คำอธิบายสิทธิ์ | +| module | VARCHAR(50) | | โมดูลที่เกี่ยวข้อง | +| scope_level | ENUM(...) | | ระดับขอบเขตของสิทธิ์ (GLOBAL, ORG, PROJECT) | +| is_active | TINYINT(1) | | สถานะการใช้งาน | + +- **Unique Keys (UK):** ux_permissions_code (permission_code) + +--- + +#### **2.4. role_permissions (ตารางเชื่อม)** + +ตารางเชื่อมระหว่าง roles และ permissions (M:N) + +| Column | Type | Key | Description | +| :------------ | :--- | :--------- | :----------------------------------------------- | +| role_id | INT | **PK**, FK | ID ของบทบาท (FK \-> roles(role_id)) | +| permission_id | INT | **PK**, FK | ID ของสิทธิ์ (FK \-> permissions(permission_id)) | + +- **Foreign Keys (FK):** + - role_id -> roles(role_id) (ON DELETE CASCADE) + - permission_id -> permissions(permission_id) (ON DELETE CASCADE) + +--- + +#### **2.5. user_roles (ตารางเชื่อม)** + +ตารางเชื่อมผู้ใช้ (users) กับบทบาท (roles) ในระดับ **Global** (M:N) + +| Column | Type | Key | Description | +| :------ | :--- | :--------- | :----------------------------------- | +| user_id | INT | **PK**, FK | ID ของผู้ใช้ (FK \-> users(user_id)) | +| role_id | INT | **PK**, FK | ID ของบทบาท (FK \-> roles(role_id)) | + +- **Foreign Keys (FK):** + - user_id -> users(user_id) (ON DELETE CASCADE) + - role_id -> roles(role_id) (ON DELETE CASCADE) + +--- + +#### **2.6. user_project_roles (ตารางเชื่อม)** + +ตารางเชื่อมผู้ใช้ (users) กับบทบาท (roles) ในระดับ **Project-Specific** (M:N) + +| Column | Type | Key | Description | +| :--------- | :--- | :--------- | :----------------------------------- | +| user_id | INT | **PK**, FK | ID ของผู้ใช้ (FK \-> users(user_id)) | +| project_id | INT | **PK**, FK | ID ของโครงการ (FK \-> projects(id)) | +| role_id | INT | **PK**, FK | ID ของบทบาท (FK \-> roles(role_id)) | + +- **Foreign Keys (FK):** + - user_id -> users(user_id) (ON DELETE CASCADE) + - project_id -> projects(id) (ON DELETE CASCADE) + - role_id -> roles(role_id) (ON DELETE CASCADE) + +--- + +## **3. ✉️ Correspondences (เอกสารหลัก, Revisions)** + +#### **3.1. correspondence_types** + +ตาราง Master เก็บประเภทเอกสารโต้ตอบ (เช่น RFA, RFI, LETTER, MOM) + +| Column | Type | Key | Description | +| :--------- | :----------- | :----- | :------------------------- | +| id | INT | **PK** | ID ของตาราง | +| type_code | VARCHAR(50) | UK | รหัสประเภท (เช่น RFA, RFI) | +| type_name | VARCHAR(255) | | ชื่อประเภท | +| sort_order | INT | | ลำดับการแสดงผล | +| is_active | TINYINT(1) | | สถานะการใช้งาน | + +- **Unique Keys (UK):** type_code + +--- + +#### **3.2. correspondence_status** + +ตาราง Master เก็บสถานะของเอกสาร (เช่น DRAFT, SUBMITTED, CLOSED) + +| Column | Type | Key | Description | +| :---------- | :----------- | :----- | :------------------------------------ | +| id | INT | **PK** | ID ของตาราง | +| status_code | VARCHAR(50) | UK | รหัสสถานะหนังสือ (เช่น DRAFT, SUBOWN) | +| status_name | VARCHAR(255) | | ชื่อสถานะหนังสือ | +| sort_order | INT | | ลำดับการแสดงผล | +| is_active | TINYINT(1) | | สถานะการใช้งาน | + +- **Unique Keys (UK):** status_code + +--- + +#### **3.3. correspondences (Master)** + +ตาราง "แม่" ของเอกสารโต้ตอบ เก็บข้อมูลที่ไม่เปลี่ยนตาม Revision (เช่น เลขที่เอกสาร) + +| Column | Type | Key | Description | +| :------------------------ | :----------- | :----- | :----------------------------------------------- | +| id | INT | **PK** | ID ของตาราง (นี่คือ "Master ID" ที่ใช้เชื่อมโยง) | +| correspondence_number | VARCHAR(100) | UK | เลขที่เอกสาร (สร้างจาก DocumentNumberingModule) | +| correspondence_type_id | INT | FK | ประเภทเอกสาร (FK \-> correspondence_types(id)) | +| is_internal_communication | TINYINT(1) | | (1 = ภายใน, 0 = ภายนอก) | +| project_id | INT | FK | อยู่ในโครงการ (FK \-> projects(id)) | +| originator_id | INT | FK | องค์กรผู้ส่ง (FK \-> organizations(id)) | +| created_at | DATETIME | | วันที่สร้าง | +| created_by | INT | FK | ผู้สร้าง (FK \-> users(user_id)) | +| deleted_at | DATETIME | | สำหรับ Soft Delete | + +- **Foreign Keys (FK):** + - correspondence_type_id -> correspondence_types(id) (ON DELETE RESTRICT) + - project_id -> projects(id) (ON DELETE CASCADE) + - originator_id -> organizations(id) (ON DELETE SET NULL) + - created_by -> users(user_id) (ON DELETE SET NULL) +- **Unique Keys (UK):** uq_corr_no_per_project (project_id, correspondence_number) + +--- + +#### **3.4. correspondence_revisions (Revisions)** + +ตาราง "ลูก" เก็บประวัติการแก้ไข (Revisions) ของ correspondences (1:N) **(ปรับปรุง V1.4.0)** + +| Column | Type | Key | Description | +| :----------------------- | :----------- | :----- | :------------------------------------------------------- | +| id | INT | **PK** | **ID ของ Revision** | +| correspondence_id | INT | FK, UK | Master ID (FK \-> correspondences(id)) | +| revision_number | INT | UK | หมายเลข Revision (0, 1, 2...) | +| revision_label | VARCHAR(10) | | **(ใหม่)** Revision ที่แสดง (เช่น A, B, 1.1) | +| is_current | BOOLEAN | UK | (1 = Revision ปัจจุบัน) | +| correspondence_status_id | INT | FK | สถานะของ Revision นี้ (FK \-> correspondence_status(id)) | +| title | VARCHAR(255) | | เรื่อง | +| document_date | DATE | | วันที่ในเอกสาร | +| issued_date | DATETIME | | วันที่ออกเอกสาร | +| received_date | DATETIME | | วันที่ลงรับเอกสาร | +| due_date | DATETIME | | **(ใหม่)** วันที่ครบกำหนด (ตาม Requirements 3.2.5) | +| description | TEXT | | **(ใหม่)** คำอธิบายการแก้ไขใน Revision นี้ | +| details | JSON | | ข้อมูลเฉพาะ (เช่น RFI details) | +| created_at | DATETIME | | **(ใหม่)** วันที่สร้างเอกสาร | +| created_by | INT | FK | ผู้สร้าง (FK \-> users(user_id)) | +| updated_by | INT | **FK** | **(ใหม่)** ผู้แก้ไขล่าสุด (FK \-> users(user_id)) | + +- **Foreign Keys (FK):** + - correspondence_id -> correspondences(id) (ON DELETE CASCADE) + - correspondence_status_id -> correspondence_status(id) (ON DELETE RESTRICT) + - created_by -> users(user_id) (ON DELETE SET NULL) + - updated_by -> users(user_id) (ON DELETE SET NULL) +- **Unique Keys (UK):** + - uq_master_revision_number (correspondence_id, revision_number) (ป้องกัน Rev ซ้ำใน Master เดียว) + - uq_master_current (correspondence_id, is_current) (ป้องกัน is_current = TRUE ซ้ำใน Master เดียว) +- **Check Constraints (CHK):** chk_rev_format (ตรวจสอบรูปแบบ revision_label) + +--- + +#### **3.5. correspondence_recipients (ตารางเชื่อม)** + +ตารางเชื่อมผู้รับ (TO/CC) สำหรับเอกสารแต่ละฉบับ (M:N) + +| Column | Type | Key | Description | +| :------------------------ | :--------------- | :--------- | :---------------------------------------------------------------- | +| correspondence_id | INT | **PK**, FK | ID ของเอกสาร (FK \-> correspondence_revisions(correspondence_id)) | +| recipient_organization_id | INT | **PK**, FK | ID องค์กรผู้รับ (FK \-> organizations(id)) | +| recipient_type | ENUM('TO', 'CC') | **PK** | ประเภทผู้รับ (TO หรือ CC) | + +- **Foreign Keys (FK):** + - correspondence_id -> correspondence_revisions(correspondence_id) (ON DELETE CASCADE) + - recipient_organization_id -> organizations(id) (ON DELETE RESTRICT) + +--- + +#### **3.6. correspondence_tags (ตารางเชื่อม)** + +ตารางเชื่อมระหว่าง correspondences และ tags (M:N) + +| Column | Type | Key | Description | +| :---------------- | :--- | :--------- | :---------------------------------------- | +| correspondence_id | INT | **PK**, FK | ID ของเอกสาร (FK \-> correspondences(id)) | +| tag_id | INT | **PK**, FK | ID ของ Tag (FK \-> tags(id)) | + +- **Foreign Keys (FK):** + - correspondence_id -> correspondences(id) (ON DELETE CASCADE) + - tag_id -> tags(id) (ON DELETE CASCADE) + +--- + +#### **3.7. correspondence_references (ตารางเชื่อม)** + +ตารางเชื่อมการอ้างอิงระหว่างเอกสาร (M:N) + +| Column | Type | Key | Description | +| :-------------------- | :--- | :--------- | :--------------------------------------------- | +| src_correspondence_id | INT | **PK**, FK | ID เอกสารต้นทาง (FK \-> correspondences(id)) | +| tgt_correspondence_id | INT | **PK**, FK | ID เอกสารเป้าหมาย (FK \-> correspondences(id)) | + +- **Foreign Keys (FK):** + - src_correspondence_id -> correspondences(id) (ON DELETE CASCADE) + - tgt_correspondence_id -> correspondences(id) (ON DELETE CASCADE) + +--- + +## **4. 📐 approval: RFA (เอกสารขออนุมัติ, Workflows)** + +#### **4.1. rfa_types / ...\_status_codes / ...\_approve_codes** + +ตาราง Master สำหรับ RFA + +- **rfa_types:** ประเภท RFA (เช่น DWG, DOC, MAT) +- **rfa_status_codes:** สถานะ RFA (เช่น DFT \- Draft, FAP \- For Approve) +- **rfa_approve_codes:** รหัสผลการอนุมัติ (เช่น 1A \- Approved, 3R \- Revise and Resubmit) + +--- + +#### **4.2. rfas (Master)** + +ตาราง "แม่" ของ RFA (มีความสัมพันธ์ 1:N กับ rfa_revisions) + +| Column | Type | Key | Description | +| :---------- | :------- | :----- | :-------------------------------- | +| id | INT | **PK** | ID ของตาราง (RFA Master ID) | +| rfa_type_id | INT | FK | ประเภท RFA (FK \-> rfa_types(id)) | +| created_at | DATETIME | | วันที่สร้าง | +| created_by | INT | FK | ผู้สร้าง (FK \-> users(user_id)) | +| deleted_at | DATETIME | | สำหรับ Soft Delete | + +- **Foreign Keys (FK):** + - rfa_type_id -> rfa_types(id) + - created_by -> users(user_id) (ON DELETE SET NULL) + +--- + +#### **4.3. rfa_revisions (Revisions)** + +ตาราง "ลูก" เก็บประวัติ (Revisions) ของ rfas (1:N) **(ปรับปรุง V1.4.0)** + +| Column | Type | Key | Description | +| :------------------ | :----------- | :----- | :-------------------------------------------------------- | +| id | INT | **PK** | **ID ของ Revision** | +| correspondence_id | INT | FK | Master ID ของ Correspondence (FK \-> correspondences(id)) | +| rfa_id | INT | FK, UK | Master ID ของ RFA (FK \-> rfas(id)) | +| revision_number | INT | UK | หมายเลข Revision (0, 1, 2...) | +| revision_label | VARCHAR(10) | | **(ใหม่)** Revision ที่แสดง (เช่น A, B, 1.1) | +| is_current | BOOLEAN | UK | (1 = Revision ปัจจุบัน) | +| rfa_status_code_id | INT | FK | สถานะ RFA (FK \-> rfa_status_codes(id)) | +| rfa_approve_code_id | INT | FK | ผลการอนุมัติ (FK \-> rfa_approve_codes(id)) | +| title | VARCHAR(255) | | เรื่อง | +| document_date | DATE | | **(ใหม่)** วันที่ในเอกสาร | +| issued_date | DATE | | **(ใหม่)** วันที่ส่งขออนุมัติ | +| received_date | DATETIME | | **(ใหม่)** วันที่ลงรับเอกสาร | +| approved_date | DATE | | **(ใหม่)** วันที่อนุมัติ | +| description | TEXT | | **(ใหม่)** คำอธิบายการแก้ไขใน Revision นี้ | +| created_at | DATETIME | | **(ใหม่)** วันที่สร้างเอกสาร | +| created_by | INT | FK | ผู้สร้าง (FK \-> users(user_id)) | +| updated_by | INT | **FK** | **(ใหม่)** ผู้แก้ไขล่าสุด (FK \-> users(user_id)) | + +- **Foreign Keys (FK):** + - correspondence_id -> correspondences(id) (ON DELETE CASCADE) + - rfa_id -> rfas(id) (ON DELETE CASCADE) + - rfa_status_code_id -> rfa_status_codes(id) + - rfa_approve_code_id -> rfa_approve_codes(id) (ON DELETE SET NULL) + - created_by -> users(user_id) (ON DELETE SET NULL) + - updated_by -> users(user_id) (ON DELETE SET NULL) +- **Unique Keys (UK):** + - uq_rr_rev_number (rfa_id, revision_number) (ป้องกัน Rev ซ้ำใน Master เดียว) + - uq_rr_current (rfa_id, is_current) (ป้องกัน is_current=TRUE ซ้ำใน Master เดียว) + +--- + +#### **4.4. rfa_items (ตารางเชื่อม)** + +ตารางเชื่อมระหว่าง rfa_revisions (ที่เป็นประเภท DWG) กับ shop_drawing_revisions (M:N) + +| Column | Type | Key | Description | +| :----------------------- | :--- | :------------- | :--------------------------------------------------------------- | +| rfarev_correspondence_id | INT | **PK**, FK | ID ของ RFA Revision (FK \-> rfa_revisions(correspondence_id)) | +| shop_drawing_revision_id | INT | **PK**, UK, FK | ID ของ Shop Drawing Revision (FK \-> shop_drawing_revisions(id)) | + +- **Foreign Keys (FK):** + - rfarev_correspondence_id -> rfa_revisions(correspondence_id) (ON DELETE CASCADE) + - shop_drawing_revision_id -> shop_drawing_revisions(id) (ON DELETE CASCADE) + +--- + +#### **4.5. rfa_workflow_templates / ...\_steps / ...\_workflows** + +ตารางที่เกี่ยวข้องกับ Workflow การอนุมัติ RFA + +- **rfa_workflow_templates:** ตาราง Master เก็บแม่แบบสายอนุมัติ (เช่น "สายอนุมัติ 3 ขั้นตอน") +- **rfa_workflow_template_steps:** ตารางลูก เก็บขั้นตอนในแม่แบบ (เช่น Step 1: Org A (Review), Step 2: Org B (Approve)) +- **rfa_workflows:** ตารางประวัติ (Log) การอนุมัติของ RFA จริงตามสายงงาน + +--- + +## **5. 📐 Drawings (แบบ, หมวดหมู่)** + +#### **5.1. contract_drawing_volumes / ...\_cats / ...\_sub_cats** + +ตาราง Master สำหรับ "แบบคู่สัญญา" (Contract Drawings) + +- **contract_drawing_volumes:** เก็บ "เล่ม" ของแบบ +- **contract_drawing_cats:** เก็บ "หมวดหมู่หลัก" ของแบบ +- **contract_drawing_sub_cats:** เก็บ "หมวดหมู่ย่อย" ของแบบ + +--- + +#### **5.2. contract_drawing_subcat_cat_maps (ตารางเชื่อม - ใหม่)** + +**(ใหม่)** ตารางเชื่อมระหว่าง หมวดหมู่หลัก-ย่อย (M:N) + +| Column | Type | Key | Description | +| :--------- | :--- | :--------- | :----------------- | +| project_id | INT | **PK**, FK | ID ของโครงการ | +| sub_cat_id | INT | **PK**, FK | ID ของหมวดหมู่ย่อย | +| cat_id | INT | **PK**, FK | ID ของหมวดหมู่หลัก | + +- **Foreign Keys (FK) (ตามเจตนา):** + - (project_id, sub_cat_id) -> contract_drawing_sub_cats(project_id, id) + - (project_id, cat_id) -> contract_drawing_cats(project_id, id) +- **Unique Keys (UK):** + - ux_map_unique (project_id, sub_cat_id, cat_id) + +--- + +#### **5.3. contract_drawings (Master)** + +ตาราง Master เก็บข้อมูล "แบบคู่สัญญา" + +| Column | Type | Key | Description | +| :--------- | :----------- | :----- | :-------------------------------------------------- | +| id | INT | **PK** | ID ของตาราง | +| project_id | INT | FK, UK | โครงการ (FK \-> projects(id)) | +| condwg_no | VARCHAR(255) | UK | เลขที่แบบสัญญา | +| title | VARCHAR(255) | | ชื่อแบบสัญญา | +| sub_cat_id | INT | FK | หมวดหมู่ย่อย (FK \-> contract_drawing_sub_cats(id)) | +| volume_id | INT | FK | เล่ม (FK \-> contract_drawing_volumes(id)) | +| created_at | TIMESTAMP | | วันที่สร้าง | +| updated_at | TIMESTAMP | | วันที่แก้ไขล่าสุด | +| deleted_at | DATETIME | | **(ใหม่)** วันที่ลบ | +| updated_by | INT | FK | **(ใหม่)** ผู้แก้ไขล่าสุด | + +- **Foreign Keys (FK):** + - fk_condwg_project (project_id) -> projects(id) (ON DELETE CASCADE) + - fk_condwg_subcat_same_project (project_id, sub_cat_id) -> contract_drawing_sub_cats(project_id, id) (ON DELETE RESTRICT) + - fk_condwg_volume_same_project (project_id, volume_id) -> contract_drawing_volumes(project_id, id) (ON DELETE RESTRICT) +- **Unique Keys (UK):** ux_condwg_no_project (project_id, condwg_no) + +--- + +#### **5.4. shop_drawing_main_categories / ...\_sub_categories** + +ตาราง Master สำหรับ "แบบก่อสร้าง" (Shop Drawings) + +- **shop_drawing_main_categories:** เก็บ "หมวดหมู่หลัก" (เช่น ARCH, STR) +- **shop_drawing_sub_categories:** เก็บ "หมวดหมู่ย่อย" (เช่น STR-COLUMN) + +--- + +#### **5.5. shop_drawings (Master)** + +ตาราง Master เก็บข้อมูล "แบบก่อสร้าง" + +| Column | Type | Key | Description | +| :--------------- | :----------- | :----- | :----------------------------------------------------- | +| id | INT | **PK** | ID ของตาราง | +| project_id | INT | FK | โครงการ (FK \-> projects(id)) | +| drawing_number | VARCHAR(100) | UK | เลขที่ Shop Drawing | +| title | VARCHAR(500) | | ชื่อแบบ | +| main_category_id | INT | FK | หมวดหมู่หลัก (FK \-> shop_drawing_main_categories(id)) | +| sub_category_id | INT | FK | หมวดหมู่ย่อย (FK \-> shop_drawing_sub_categories(id)) | +| created_at | TIMESTAMP | | วันที่สร้าง | +| updated_at | TIMESTAMP | | วันที่แก้ไขล่าสุด | +| deleted_at | DATETIME | | **(ใหม่)** วันที่ลบ | +| updated_by | INT | FK | **(ใหม่)** ผู้แก้ไขล่าสุด | + +- **Foreign Keys (FK):** project_id, main_category_id, sub_category_id +- **Unique Keys (UK):** ux_sd_drawing_number (drawing_number) + +--- + +#### **5.6. shop_drawing_revisions (Revisions)** + +ตาราง "ลูก" เก็บประวัติ (Revisions) ของ shop_drawings (1:N) + +| Column | Type | Key | Description | +| :-------------- | :---------- | :----- | :------------------------------------------------ | +| id | INT | **PK** | ID ของ Revision | +| shop_drawing_id | INT | FK, UK | Master ID (FK \-> shop_drawings(id)) | +| revision_number | INT | UK | **(ปรับปรุง)** หมายเลข Revision (เช่น 0, 1, 2...) | +| revision_label | VARCHAR(10) | | **(ปรับปรุง)** Revision ที่แสดง (เช่น A, B, 1.1) | +| revision_date | DATE | | วันที่ของ Revision | +| description | TEXT | | คำอธิบายการแก้ไข | +| created_at | TIMESTAMP | | วันที่สร้าง | + +- **Foreign Keys (FK):** + - shop_drawing_id -> shop_drawings(id) (ON DELETE CASCADE) +- **Unique Keys (UK):** ux_sd_rev_drawing_revision (shop_drawing_id, revision_number) + +--- + +#### **5.7. shop_drawing_revision_contract_refs (ตารางเชื่อม)** + +ตารางเชื่อมระหว่าง shop_drawing_revisions กับ contract_drawings (M:N) + +| Column | Type | Key | Description | +| :----------------------- | :--- | :--------- | :--------------------------------------------------------------- | +| shop_drawing_revision_id | INT | **PK**, FK | ID ของ Shop Drawing Revision (FK \-> shop_drawing_revisions(id)) | +| contract_drawing_id | INT | **PK**, FK | ID ของ Contract Drawing (FK \-> contract_drawings(id)) | + +- **Foreign Keys (FK):** + - shop_drawing_revision_id -> shop_drawing_revisions(id) (ON DELETE CASCADE) + - contract_drawing_id -> contract_drawings(id) (ON DELETE CASCADE) + +--- + +## **6. 🔄 Circulations (ใบเวียนภายใน)** + +#### **6.1. circulation_status_codes** + +ตาราง Master เก็บสถานะใบเวียน (เช่น OPEN, IN_REVIEW, COMPLETED) + +| Column | Type | Key | Description | +| :---------- | :---------- | :----- | :------------------------ | +| id | INT | **PK** | ID ของตาราง | +| code | VARCHAR(20) | UK | รหัสสถานะการดำเนินงาน | +| description | VARCHAR(50) | | คำอธิบายสถานะการดำเนินงาน | +| sort_order | INT | | ลำดับการแสดงผล | +| is_active | TINYINT(1) | | สถานะการใช้งาน | + +--- + +#### **6.2. circulations (Master)** + +ตาราง "แม่" ของใบเวียนเอกสารภายใน + +| Column | Type | Key | Description | +| :---------------------- | :----------- | :----- | :---------------------------------------------------------------- | +| id | INT | **PK** | ID ของตารางใบเวียน | +| correspondence_id | INT | UNIQUE | ID ของเอกสาร (จากตาราง correspondences) | +| organization_id | INT | FK | ID ขององค์กรณ์ที่เป็นเจ้าของใบเวียนนี้ (FK \-> organizations(id)) | +| circulation_no | VARCHAR(100) | | เลขที่ใบเวียน | +| circulation_subject | VARCHAR(500) | | เรื่องใบเวียน | +| circulation_status_code | VARCHAR(20) | FK | รหัสสถานะใบเวียน (FK \-> circulation_status_codes(code)) | +| created_by_user_id | INT | FK | ID ของผู้สร้างใบเวียน (FK \-> users(user_id)) | +| submitted_at | TIMESTAMP | | วันที่ส่งใบเวียน | +| closed_at | TIMESTAMP | | วันที่ปิดใบเวียน | +| created_at | TIMESTAMP | | วันที่สร้าง | +| updated_at | TIMESTAMP | | วันที่แก้ไขล่าสุด | + +- **Foreign Keys (FK):** + - correspondence_id -> correspondences(id) + - organization_id -> organizations(id) + - circulation_status_code -> circulation_status_codes(code) + - created_by_user_id -> users(user_id) + +--- + +#### **6.3. circulation_templates / ...\_assignees / ...\_routings** + +ตารางที่เกี่ยวข้องกับ Workflow การส่งต่อเอกสาร (Req 3.5.4) + +- **circulation_templates:** ตาราง Master เก็บแม่แบบสายงาน (เช่น "ส่งให้ CSC ตรวจสอบ") +- **circulation_template_assignees:** ตารางลูก เก็บขั้นตอนในแม่แบบ (เช่น Step 1: ส่งไป Org A, Step 2: ส่งไป Org B) +- **circulation_routings:** ตารางประวัติ (Log) การส่งต่อของเอกสารจริงตาม Workflow + +--- + +## **7. 📤 Transmittals (เอกสารนำส่ง)** + +#### **7.1. transmittals** + +ตารางข้อมูลเฉพาะของเอกสารนำส่ง (เป็นตารางลูก 1:1 ของ correspondences) + +| Column | Type | Key | Description | +| :---------------- | :-------- | :--------- | :------------------------------------------------ | +| correspondence_id | INT | **PK**, FK | ID ของเอกสาร (FK \-> correspondences(id)) | +| purpose | ENUM(...) | | วัตถุประสงค์ (FOR_APPROVAL, FOR_INFORMATION, ...) | +| remarks | TEXT | | หมายเหตุ | + +- **Foreign Keys (FK):** correspondence_id -> correspondences(id) (ON DELETE CASCADE) + +--- + +#### **7.2. transmittal_items (ตารางเชื่อม)** + +ตารางเชื่อมระหว่าง transmittals และเอกสารที่นำส่ง (M:N) **(ปรับปรุง V1.4.0)** + +| Column | Type | Key | Description | +| :------------------------- | :--------------- | :--------- | :-------------------------------------------------------------- | +| **id** | **INT** | **PK** | **(ใหม่)** ID ของรายการ | +| transmittal_id | INT | **FK**, UK | ID ของ Transmittal (FK \-> transmittals(correspondence_id)) | +| **item_correspondence_id** | INT | **FK**, UK | **(เปลี่ยน)** ID ของเอกสารที่แนบไป (FK \-> correspondences(id)) | +| **quantity** | **INT** | | **(ใหม่)** จำนวน | +| **remarks** | **VARCHAR(255)** | | **(ใหม่)** หมายเหตุสำหรับรายการนี้ | + +- **Foreign Keys (FK):** + - transmittal_id -> transmittals(correspondence_id) (ON DELETE CASCADE) + - item_correspondence_id -> correspondences(id) (ON DELETE CASCADE) +- **Unique Keys (UK):** ux_transmittal_item (transmittal_id, item_correspondence_id) + +--- + +## **8. 📎 File Management (ไฟล์แนบ)** + +#### **8.1. attachments (Master)** + +ตาราง "กลาง" เก็บไฟล์แนบทั้งหมดของระบบ (ตาม Requirements 3.9) + +| Column | Type | Key | Description | +| :------------------ | :----------- | :----- | :-------------------------------------------- | +| id | INT | **PK** | ID ของไฟล์แนบ | +| original_filename | VARCHAR(255) | | ชื่อไฟล์ดั้งเดิมตอนอัปโหลด | +| stored_filename | VARCHAR(255) | | ชื่อไฟล์ที่เก็บจริงบน Server (ป้องกันชื่อซ้ำ) | +| file_path | VARCHAR(500) | | Path ที่เก็บไฟล์ (บน QNAP /share/dms-data/) | +| mime_type | VARCHAR(100) | | ประเภทไฟล์ (เช่น application/pdf) | +| file_size | INT | | ขนาดไฟล์ (bytes) | +| uploaded_by_user_id | INT | FK | ผู้อัปโหลดไฟล์ (FK \-> users(user_id)) | + +- **Foreign Keys (FK):** uploaded_by_user_id -> users(user_id) (ON DELETE CASCADE) + +--- + +#### **8.2. correspondence_attachments (ตารางเชื่อม - ใหม่)** + +ตารางเชื่อม correspondences กับ attachments (M:N) + +| Column | Type | Key | Description | +| :---------------- | :------ | :--------- | :---------------------------------------- | +| correspondence_id | INT | **PK**, FK | ID ของเอกสาร (FK \-> correspondences(id)) | +| attachment_id | INT | **PK**, FK | ID ของไฟล์แนบ (FK \-> attachments(id)) | +| is_main_document | BOOLEAN | | (1 = ไฟล์หลัก) | + +- **Foreign Keys (FK):** correspondence_id, attachment_id + +--- + +#### **8.3. circulation_attachments (ตารางเชื่อม - ใหม่)** + +ตารางเชื่อม circulations กับ attachments (M:N) + +| Column | Type | Key | Description | +| :--------------- | :------ | :--------- | :-------------------------------------- | +| circulation_id | INT | **PK**, FK | ID ของใบเวียน (FK \-> circulations(id)) | +| attachment_id | INT | **PK**, FK | ID ของไฟล์แนบ (FK \-> attachments(id)) | +| is_main_document | BOOLEAN | | (1 = ไฟล์หลักของใบเวียน) | + +- **Foreign Keys (FK):** circulation_id, attachment_id + +--- + +#### **8.4. shop_drawing_revision_attachments (ตารางเชื่อม - ใหม่)** + +ตารางเชื่อม shop_drawing_revisions กับ attachments (M:N) **(ปรับปรุง V1.2.0)** + +| Column | Type | Key | Description | +| :----------------------- | :---------- | :--------- | :--------------------------------------------------------------- | +| shop_drawing_revision_id | INT | **PK**, FK | ID ของ Shop Drawing Revision (FK \-> shop_drawing_revisions(id)) | +| attachment_id | INT | **PK**, FK | ID ของไฟล์แนบ (FK \-> attachments(id)) | +| file_type | ENUM(...) | | ประเภทไฟล์ (PDF, DWG, SOURCE, OTHER) | +| **is_main_document** | **BOOLEAN** | | **(ใหม่)** (1 = ไฟล์หลัก) | + +- **Foreign Keys (FK):** shop_drawing_revision_id, attachment_id + +--- + +#### **8.5. contract_drawing_attachments (ตารางเชื่อม - ใหม่)** + +**(ใหม่)** ตารางเชื่อม contract_drawings กับ attachments (M:N) + +| Column | Type | Key | Description | +| :------------------ | :-------- | :--------- | :----------------------------------------------------- | +| contract_drawing_id | INT | **PK**, FK | ID ของ Contract Drawing (FK \-> contract_drawings(id)) | +| attachment_id | INT | **PK**, FK | ID ของไฟล์แนบ (FK \-> attachments(id)) | +| file_type | ENUM(...) | | ประเภทไฟล์ (PDF, DWG, SOURCE, OTHER) | +| is_main_document | BOOLEAN | | (1 = ไฟล์หลัก) | + +- **Foreign Keys (FK):** + - contract_drawing_id -> contract_drawings(id) (ON DELETE CASCADE) + - attachment_id -> attachments(id) (ON DELETE CASCADE) + +--- + +## **9. 🔢 Document Numbering (การสร้างเลขที่เอกสาร)** + +#### **9.1. document_number_formats (ตารางตั้งค่า - ใหม่)** + +ตาราง Master เก็บ "รูปแบบ" Template ของเลขที่เอกสาร (ตาม Requirements 3.10.3) + +| Column | Type | Key | Description | +| :--------------------- | :----------- | :----- | :---------------------------------------------------- | +| id | INT | **PK** | ID ของตาราง | +| project_id | INT | FK, UK | โครงการ (FK \-> projects(id)) | +| correspondence_type_id | INT | FK, UK | ประเภทเอกสาร (FK \-> correspondence_types(id)) | +| format_template | VARCHAR(255) | | รูปแบบ Template (เช่น {ORG_CODE}-{TYPE_CODE}-{SEQ:4}) | +| description | TEXT | | คำอธิบายรูปแบบนี้ | + +- **Foreign Keys (FK):** project_id, correspondence_type_id +- **Unique Keys (UK):** uk_project_type (project_id, correspondence_type_id) + +--- + +#### **9.2. document_number_counters (ตารางตัวนับ - ใหม่)** + +ตารางเก็บ "ตัวนับ" (Running Number) ล่าสุด (ตาม Requirements 3.10.2) + +| Column | Type | Key | Description | +| :------------------------- | :--- | :--------- | :--------------------------------------------- | +| project_id | INT | **PK**, FK | โครงการ (FK \-> projects(id)) | +| originator_organization_id | INT | **PK**, FK | องค์กรผู้ส่ง (FK \-> organizations(id)) | +| correspondence_type_id | INT | **PK**, FK | ประเภทเอกสาร (FK \-> correspondence_types(id)) | +| current_year | INT | **PK** | ปี ค.ศ. ของตัวนับ | +| last_number | INT | | เลขที่ล่าสุดที่ใช้ไปแล้ว | + +- **Foreign Keys (FK):** project_id, originator_organization_id, correspondence_type_id + +--- + +## **10. ⚙️ System & Logs (ระบบและ Log)** + +#### **10.1. tags** + +ตาราง Master เก็บ Tags ทั้งหมดที่ใช้ในระบบ + +| Column | Type | Key | Description | +| :---------- | :----------- | :----- | :---------------- | +| id | INT | **PK** | ID ของตาราง | +| tag_name | VARCHAR(100) | UK | ชื่อ Tag | +| description | TEXT | | คำอธิบายแท็ก | +| created_at | TIMESTAMP | | วันที่สร้าง | +| updated_at | TIMESTAMP | | วันที่แก้ไขล่าสุด | + +- **Unique Keys (UK):** ux_tag_name (tag_name) + +--- + +#### **10.2. correspondence_tags (ตารางเชื่อม)** + +ตารางเชื่อมระหว่าง correspondences และ tags (M:N) + +| Column | Type | Key | Description | +| :---------------- | :--- | :--------- | :---------------------------------------- | +| correspondence_id | INT | **PK**, FK | ID ของเอกสาร (FK \-> correspondences(id)) | +| tag_id | INT | **PK**, FK | ID ของ Tag (FK \-> tags(id)) | + +- **Foreign Keys (FK):** correspondence_id, tag_id + +--- + +#### **10.3. audit_logs** + +ตารางเก็บบันทึกการกระทำของผู้ใช้ (ตาม Requirements 6.1) + +| Column | Type | Key | Description | +| :----------- | :----------- | :----- | :--------------------------------------------------------------- | +| audit_id | BIGINT | **PK** | ID ของ Log | +| user_id | INT | FK | ผู้กระทำ (FK \-> users(user_id)) | +| action | VARCHAR(100) | | การกระทำ (เช่น rfa.create, correspondence.update, login.success) | +| entity_type | VARCHAR(50) | | ตาราง/โมดูล (เช่น 'rfa', 'correspondence') | +| entity_id | VARCHAR(50) | | Primary ID ของระเบียนที่ได้รับผลกระทำ | +| details_json | JSON | | ข้อมูลบริบที่ | +| ip_address | VARCHAR(45) | | IP Address | +| user_agent | VARCHAR(255) | | User Agent | +| created_at | TIMESTAMP | | เวลาที่กระทำ | + +- **Foreign Keys (FK):** user_id -> users(user_id) (ON DELETE SET NULL) + +--- + +#### **10.4. notifications (ตารางใหม่ - ตาม Requirements 6.7)** + +ตารางสำหรับจัดการการแจ้งเตือน (Email/Line/System) + +| Column | Type | Key | Description | +| :---------------- | :------------------------------ | :----- | :-------------------------------- | +| id | INT | **PK** | ID ของการแจ้งเตือน | +| user_id | INT | FK | ID ผู้ใช้ (FK \-> users(user_id)) | +| title | VARCHAR(255) | | หัวข้อการแจ้งเตือน | +| message | TEXT | | รายละเอียดการแจ้งเตือน | +| notification_type | ENUM('EMAIL', 'LINE', 'SYSTEM') | | ประเภท (EMAIL, LINE, SYSTEM) | +| is_read | BOOLEAN | | สถานะการอ่าน | +| entity_type | VARCHAR(50) | | เช่น 'rfa', 'circulation' | +| entity_id | INT | | ID ของเอนทิตีที่เกี่ยวข้อง | +| created_at | TIMESTAMP | | วันที่สร้าง | + +- **Foreign Keys (FK):** user_id -> users(user_id) + +--- + +#### **10.5. search_indices (ตารางใหม่ - ตาม Requirements 6.2)** + +ตารางสำหรับจัดการดัชนีการค้นหาขั้นสูง (Full-text Search) + +| Column | Type | Key | Description | +| :---------- | :---------- | :----- | :----------------------------------------- | +| id | INT | **PK** | ID ของดัชนี | +| entity_type | VARCHAR(50) | | ชนิดเอนทิตี (เช่น 'correspondence', 'rfa') | +| entity_id | INT | | ID ของเอนทิตี | +| content | TEXT | | เนื้อหาที่จะค้นหา | +| indexed_at | TIMESTAMP | | วันที่สร้าง/อัปเดตัชนี | + +- **Indexes:** `idx_entity (entity_type, entity_id)`, `FULLTEXT INDEX idx_content (content)` + +--- + +#### **10.6. backup_logs (ตารางใหม่ - ตาม Requirements 6.6)** + +ตารางสำหรับบันทึกประวัติการสำรองข้อมูล + +| Column | Type | Key | Description | +| :------------ | :------------------------------------- | :----- | :----------------------------- | +| id | INT | **PK** | ID ของการสำรอง | +| backup_type | ENUM('DATABASE', 'FILES', 'FULL') | | ประเภท (DATABASE, FILES, FULL) | +| backup_path | VARCHAR(500) | | ตำแหน่งไฟล์สำรอง | +| file_size | BIGINT | | ขนาดไฟล์ | +| status | ENUM('STARTED', 'COMPLETED', 'FAILED') | | สถานะ | +| started_at | TIMESTAMP | | เวลาเริ่มต้น | +| completed_at | TIMESTAMP | | เวลาเสร็จสิ้น | +| error_message | TEXT | | ข้อความผิดพลาด (ถ้ามี) | + +--- + +## **11. 📊 Views & Procedures (วิว และ โปรซีเดอร์)** + +#### **11.1. sp_get_next_document_number (Procedure)** + +**(ใหม่)** Stored Procedure ดึงเดียวที่ใช้ในระบบ + +- **หน้าที่:** ดึงเลขที่เอกสารถัดไป (Next Running Number) จากตาราง document_number_counters +- **ตรรกะ:** ใช้ `SELECT ... FOR UPDATE` เพื่อ "ล็อก" แถว ป้องกัน Race Condition (การที่ผู้ใช้ 2 คนได้เลขที่ซ้ำกัน) ตาม Requirement 3.10.2 + +--- + +#### **11.2. v_current_correspondences (View)** + +- **หน้าที่:** แสดง Revision "ปัจจุบัน" (is_current \= TRUE) ของ correspondences ทั้งหมด (ที่ไม่ใช่ RFA) + +--- + +#### **11.3. v_current_rfas (View)** + +- **หน้าที่:** แสดง Revision "ปัจจุบัน" (is_current \= TRUE) ของ rfa_revisions ทั้งหมด + +--- + +#### **11.4. v_contract_parties_all (View)** + +- **หน้าที่:** แสดงความสัมพันธ์ทั้งหมดระหว่าง Contract, Project, และ Organization + +--- + +#### **11.5. v_user_tasks (View - ใหม่)** + +**(ใหม่)** + +- **หน้าที่:** แสดงรายการ "งานของฉัน" (My Tasks) ที่ยังไม่เสร็จ (ตาม Requirement 5.3) +- **ตรรกะ:** JOIN ตาราง circulations กับ circulation_assignees (ที่ is_completed \= FALSE) + +--- + +#### **11.6. v_audit_log_details (View - ใหม่)** + +**(ใหม่)** + +- **หน้าที่:** แสดง audit_logs พร้อมข้อมูล username และ email ของผู้กระทำ + +--- + +#### **11.7. v_user_all_permissions (View - ใหม่)** + +**(ใหม่)** + +- **หน้าที่:** รวมสิทธิ์ทั้งหมด (Global \+ Project) ของผู้ใช้ทุกคน เพื่อให้ Backend ตรวจสอบสิทธิ์ได้ง่าย +- **ตรรกะ:** UNION ข้อมูลจาก user_roles และ user_project_roles + +--- diff --git a/docs/Markdown/icon.md b/docs/Markdown/icon.md new file mode 100644 index 0000000..d1ef325 --- /dev/null +++ b/docs/Markdown/icon.md @@ -0,0 +1,110 @@ +```Icon +📂 +🔐 +⚙️ +✨ +📦 +🐞 +🖥️ +📊 +💡 +📄 +💬 + +# 🎯 Icon Showcase for Documentation & Presentations + +This document presents a curated set of emoji and image-based icons across multiple categories for use in Markdown files, presentations, and documentation. + +--- +## 📌 UI Icons + +**Description:** Icons used for user interface elements such as settings, navigation, and interaction. + +| Icon | Meaning | +|------|---------| +| ⚙️ | Settings | +| 🖱️ | Mouse Click | +| 📁 | Folder Navigation | +| 🔍 | Search | +| 📂 | Open Folder | + +--- +## 📌 Communication Icons + +**Description:** Icons representing communication methods and tools. + +| Icon | Meaning | +|------|---------| +| 📞 | Phone Call | +| ✉️ | Email | +| 💬 | Chat | +| 📢 | Announcement | +| 📡 | Signal | + +--- +## 📌 Technology Icons + +**Description:** Icons related to devices, cloud services, and digital infrastructure. + +| Icon | Meaning | +|------|---------| +| 💻 | Laptop | +| 🖥️ | Desktop | +| ☁️ | Cloud | +| 🔌 | Plug | +| 🧠 | AI / Intelligence | + +--- +## 📌 Productivity Icons + +**Description:** Icons used to represent tasks, schedules, and progress. + +| Icon | Meaning | +|------|---------| +| 📅 | Calendar | +| ✅ | Completed Task | +| ⏰ | Alarm / Reminder | +| 📊 | Statistics | +| 📝 | Notes | + +--- +## 📌 Creative Icons + +**Description:** Icons representing artistic and creative activities. + +| Icon | Meaning | +|------|---------| +| 🎨 | Art / Design | +| 🎬 | Video / Film | +| 🎵 | Music | +| ✏️ | Drawing / Writing | +| 📸 | Photography | + +--- +## 📌 Business Icons + +**Description:** Icons used in business contexts such as finance, strategy, and management. + +| Icon | Meaning | +|------|---------| +| 💼 | Briefcase | +| 📈 | Growth Chart | +| 📉 | Decline Chart | +| 🧾 | Invoice | +| 🏢 | Office Building | + +--- +## 📌 Education Icons + +**Description:** Icons representing learning, teaching, and academic activities. + +| Icon | Meaning | +|------|---------| +| 🎓 | Graduation | +| 📚 | Books | +| 🧑‍🏫 | Teacher | +| 📝 | Exam / Assignment | +| 🏫 | School | + +--- +``` \ No newline at end of file diff --git a/docs/NestJS01.bak b/docs/NestJS01.bak new file mode 100644 index 0000000..ed4b89f --- /dev/null +++ b/docs/NestJS01.bak @@ -0,0 +1,134 @@ +You are a senior TypeScript programmer with experience in the NestJS framework and a preference for clean programming and design patterns. + +Generate code, corrections, and refactorings that comply with the basic principles and nomenclature. + +## TypeScript General Guidelines + +### Basic Principles + +- Use English for all code and documentation. +- Always declare the type of each variable and function (parameters and return value). + - Avoid using any. + - Create necessary types. +- Use JSDoc to document public classes and methods. +- Don't leave blank lines within a function. +- One export per file. + +### Nomenclature + +- Use PascalCase for classes. +- Use camelCase for variables, functions, and methods. +- Use kebab-case for file and directory names. +- Use UPPERCASE for environment variables. + - Avoid magic numbers and define constants. +- Start each function with a verb. +- Use verbs for boolean variables. Example: isLoading, hasError, canDelete, etc. +- Use complete words instead of abbreviations and correct spelling. + - Except for standard abbreviations like API, URL, etc. + - Except for well-known abbreviations: + - i, j for loops + - err for errors + - ctx for contexts + - req, res, next for middleware function parameters + +### Functions + +- In this context, what is understood as a function will also apply to a method. +- Write short functions with a single purpose. Less than 20 instructions. +- Name functions with a verb and something else. + - If it returns a boolean, use isX or hasX, canX, etc. + - If it doesn't return anything, use executeX or saveX, etc. +- Avoid nesting blocks by: + - Early checks and returns. + - Extraction to utility functions. +- Use higher-order functions (map, filter, reduce, etc.) to avoid function nesting. + - Use arrow functions for simple functions (less than 3 instructions). + - Use named functions for non-simple functions. +- Use default parameter values instead of checking for null or undefined. +- Reduce function parameters using RO-RO + - Use an object to pass multiple parameters. + - Use an object to return results. + - Declare necessary types for input arguments and output. +- Use a single level of abstraction. + +### Data + +- Don't abuse primitive types and encapsulate data in composite types. +- Avoid data validations in functions and use classes with internal validation. +- Prefer immutability for data. + - Use readonly for data that doesn't change. + - Use as const for literals that don't change. + +### Classes + +- Follow SOLID principles. +- Prefer composition over inheritance. +- Declare interfaces to define contracts. +- Write small classes with a single purpose. + - Less than 200 instructions. + - Less than 10 public methods. + - Less than 10 properties. + +### Exceptions + +- Use exceptions to handle errors you don't expect. +- If you catch an exception, it should be to: + - Fix an expected problem. + - Add context. + - Otherwise, use a global handler. + +### Testing + +- Follow the Arrange-Act-Assert convention for tests. +- Name test variables clearly. + - Follow the convention: inputX, mockX, actualX, expectedX, etc. +- Write unit tests for each public function. + - Use test doubles to simulate dependencies. + - Except for third-party dependencies that are not expensive to execute. +- Write acceptance tests for each module. + - Follow the Given-When-Then convention. + + + ## Specific to NestJS + + ### Basic Principles + + - Use modular architecture. + - Encapsulate the API in modules. + - One module per main domain/route. + - One controller for its route. + - And other controllers for secondary routes. + - A models folder with data types. + - DTOs validated with class-validator for inputs. + - Declare simple types for outputs. + - A services module with business logic and persistence. + - Entities with MikroORM for data persistence. + - One service per entity. + + - Common Module: Create a common module (e.g., @app/common) for shared, reusable code across the application. + - This module should include: + - Configs: Global configuration settings. + - Decorators: Custom decorators for reusability. + - DTOs: Common data transfer objects. + - Guards: Guards for role-based or permission-based access control. + - Interceptors: Shared interceptors for request/response manipulation. + - Notifications: Modules for handling app-wide notifications. + - Services: Services that are reusable across modules. + - Types: Common TypeScript types or interfaces. + - Utils: Helper functions and utilities. + - Validators: Custom validators for consistent input validation. + + - Core module functionalities: + - Global filters for exception handling. + - Global middlewares for request management. + - Guards for permission management. + - Interceptors for request processing. + +### Testing + +- Use the standard Jest framework for testing. +- Write tests for each controller and service. +- Write end to end tests for each api module. +- Add a admin/test method to each controller as a smoke test. + + diff --git a/docs/NextJS01.bak b/docs/NextJS01.bak new file mode 100644 index 0000000..aef1239 --- /dev/null +++ b/docs/NextJS01.bak @@ -0,0 +1,33 @@ +You are a Senior Front-End Developer and an Expert in ReactJS, NextJS, JavaScript, TypeScript, HTML, CSS and modern UI/UX frameworks (e.g., TailwindCSS, Shadcn, Radix). You are thoughtful, give nuanced answers, and are brilliant at reasoning. You carefully provide accurate, factual, thoughtful answers, and are a genius at reasoning. + +- Follow the user’s requirements carefully & to the letter. +- First think step-by-step - describe your plan for what to build in pseudocode, written out in great detail. +- Confirm, then write code! +- Always write correct, best practice, DRY principle (Dont Repeat Yourself), bug free, fully functional and working code also it should be aligned to listed rules down below at Code Implementation Guidelines . +- Focus on easy and readability code, over being performant. +- Fully implement all requested functionality. +- Leave NO todo’s, placeholders or missing pieces. +- Ensure code is complete! Verify thoroughly finalised. +- Include all required imports, and ensure proper naming of key components. +- Be concise Minimize any other prose. +- If you think there might not be a correct answer, you say so. +- If you do not know the answer, say so, instead of guessing. + +### Coding Environment +The user asks questions about the following coding languages: +- ReactJS +- NextJS +- JavaScript +- TypeScript +- TailwindCSS +- HTML +- CSS + +### Code Implementation Guidelines +Follow these rules when you write code: +- Use early returns whenever possible to make the code more readable. +- Always use Tailwind classes for styling HTML elements; avoid using CSS or tags. +- Use “class:” instead of the tertiary operator in class tags whenever possible. +- Use descriptive variable and function/const names. Also, event functions should be named with a “handle” prefix, like “handleClick” for onClick and “handleKeyDown” for onKeyDown. +- Implement accessibility features on elements. For example, a tag should have a tabindex=“0”, aria-label, on:click, and on:keydown, and similar attributes. +- Use consts instead of functions, for example, “const toggle = () =>”. Also, define a type if possible. \ No newline at end of file diff --git a/docs/Project_File_Tree_TH.md b/docs/Project_File_Tree_TH.md new file mode 100644 index 0000000..b27e6a5 --- /dev/null +++ b/docs/Project_File_Tree_TH.md @@ -0,0 +1,162 @@ +# **🌳 โครงสร้างไฟล์และโฟลเดอร์ทั้งหมด \- DMS v1.3.0 Backend** + +DMS\_Backend\_Project/ +├── Dockerfile +├── docker-compose.yml +├── nest-cli.json +├── package.json +├── tsconfig.json +└── src/ +├── app.module.ts +├── main.ts +├── common/ +│ ├── common.module.ts +│ ├── audit-log/ +│ │ ├── audit-log.interceptor.ts +│ │ └── audit-log.service.ts +│ ├── auth/ +│ │ ├── auth.controller.ts +│ │ ├── auth.module.ts +│ │ ├── auth.service.spec.ts +│ │ ├── auth.service.ts +│ │ ├── decorators/ +│ │ │ ├── current-user.decorator.ts +│ │ │ └── require-permission.decorator.ts +│ │ ├── dto/ +│ │ │ └── login.dto.ts +│ │ ├── guards/ +│ │ │ ├── rbac.guard.spec.ts +│ │ │ └── rbac.guard.ts +│ │ └── strategies/ +│ │ └── jwt.strategy.ts +│ ├── config/ +│ │ └── typeorm.config.ts (ตามที่ระบุใน app.module) +│ ├── entities/ +│ │ ├── attachment.entity.ts +│ │ ├── audit-log.entity.ts +│ │ ├── circulation-action.entity.ts +│ │ ├── circulation-assignee.entity.ts +│ │ ├── circulation-attachment.entity.ts +│ │ ├── circulation-recipient.entity.ts +│ │ ├── circulation-status-code.entity.ts +│ │ ├── circulation.entity.ts +│ │ ├── contract-drawing-attachment.entity.ts +│ │ ├── contract-drawing-category.entity.ts +│ │ ├── contract-drawing-sub-category.entity.ts +│ │ ├── contract-drawing-volume.entity.ts +│ │ ├── contract-drawing.entity.ts +│ │ ├── correspondence-attachment.entity.ts +│ │ ├── correspondence-recipient.entity.ts +│ │ ├── correspondence-revision.entity.ts +│ │ ├── correspondence-status.entity.ts +│ │ ├── correspondence-type.entity.ts +│ │ ├── correspondence.entity.ts +│ │ ├── document-number-counter.entity.ts +│ │ ├── document-number-format.entity.ts +│ │ ├── permission.entity.ts +│ │ ├── rfa-approve-code.entity.ts +│ │ ├── rfa-item.entity.ts +│ │ ├── rfa-revision.entity.ts +│ │ ├── rfa-status-code.entity.ts +│ │ ├── rfa-type.entity.ts +│ │ ├── rfa.entity.ts +│ │ ├── role.entity.ts +│ │ ├── shop-drawing-main-category.entity.ts +│ │ ├── shop-drawing-revision-attachment.entity.ts +│ │ ├── shop-drawing-revision-contract-ref.entity.ts +│ │ ├── shop-drawing-revision.entity.ts +│ │ ├── shop-drawing-sub-category.entity.ts +│ │ ├── shop-drawing.entity.ts +│ │ ├── tag.entity.ts +│ │ ├── transmittal-item.entity.ts +│ │ ├── transmittal.entity.ts +│ │ ├── user.entity.ts +│ │ └── views/ +│ │ ├── view-current-correspondence.entity.ts +│ │ └── view-current-rfa.entity.ts +│ ├── exceptions/ +│ │ └── http-exception.filter.ts +│ ├── file-storage/ +│ │ ├── file-storage.service.ts +│ │ └── file.controller.ts +│ └── security/ +│ └── rate-limiter.module.ts +└── modules/ +├── caching/ +│ └── caching.module.ts +├── circulation/ +│ ├── circulation.controller.ts +│ ├── circulation.module.ts +│ ├── circulation.service.ts +│ └── dto/ +│ ├── add-action.dto.ts +│ ├── assignee.dto.ts +│ ├── attachment.dto.ts +│ ├── create-circulation.dto.ts +│ └── recipient.dto.ts +├── correspondence/ +│ ├── correspondence.controller.ts +│ ├── correspondence.module.ts +│ ├── correspondence.service.ts +│ └── dto/ +│ ├── create-correspondence.dto.ts +│ └── query-correspondence.dto.ts +├── document-numbering/ +│ ├── admin-numbering.controller.ts +│ ├── document-numbering.module.ts +│ ├── document-numbering.service.ts +│ └── dto/ +│ ├── admin-create-number-format.dto.ts +│ └── admin-update-number-format.dto.ts +├── drawing/ +│ ├── drawing.controller.ts +│ ├── drawing.module.ts +│ ├── drawing.service.ts +│ └── dto/ +│ ├── attachment.dto.ts +│ ├── create-contract-drawing.dto.ts +│ ├── create-shop-drawing-revision.dto.ts +│ └── create-shop-drawing.dto.ts +├── health/ +│ ├── health.controller.ts +│ └── health.module.ts +├── master-data/ +│ ├── admin-master-data.controller.ts +│ ├── master-data.module.ts +│ ├── master-data.service.ts +│ └── dto/ +│ └── create-tag.dto.ts +├── notification/ +│ ├── notification.module.ts +│ └── notification.service.ts +├── project/ +│ └── (ยังไม่ได้สร้างไฟล์) +├── rfa/ +│ ├── rfa.controller.ts +│ ├── rfa.module.ts +│ ├── rfa.service.ts +│ └── dto/ +│ └── create-rfa.dto.ts +├── search/ +│ ├── search.controller.ts +│ ├── search.module.ts +│ ├── search.service.ts +│ └── dto/ +│ └── advanced-search.dto.ts +├── transmittal/ +│ ├── transmittal.controller.ts +│ ├── transmittal.module.ts +│ ├── transmittal.service.ts +│ └── dto/ +│ ├── create-transmittal-item.dto.ts +│ └── create-transmittal.dto.ts +└── user/ +├── admin-roles.controller.ts +├── admin-users.controller.ts +├── roles.service.ts +├── user.module.ts +├── user.service.ts +└── dto/ +├── admin-assign-permissions.dto.ts +├── admin-create-role.dto.ts +└── admin-create-user.dto.ts \ No newline at end of file diff --git a/docs/Project_Structure_Summary_TH.md b/docs/Project_Structure_Summary_TH.md new file mode 100644 index 0000000..5d7a55d --- /dev/null +++ b/docs/Project_Structure_Summary_TH.md @@ -0,0 +1,100 @@ +# **🗂️ สรุปโครงสร้างไฟล์และโฟลเดอร์ (Backend NestJS) \- DMS v1.3.0** + +นี่คือภาพรวมสถาปัตยกรรมโฟลเดอร์ทั้งหมดของโปรเจกต์ NestJS API ที่เราได้พัฒนาขึ้น โดยแบ่งตามหลักการ Separation of Concerns + +## **📂 (Root) โฟลเดอร์หลักของโปรเจกต์** + +ไฟล์เหล่านี้จะอยู่ที่ระดับบนสุดของโปรเจกต์ (นอก src/) + +* Dockerfile + * **หน้าที่:** คำสั่งสำหรับ Build Docker Image (Multi-stage build) เพื่อนำไป Deploy +* docker-compose.yml + * **หน้าที่:** ไฟล์ตั้งค่าสำหรับ QNAP Container Station ใช้กำหนด Services, Networks, และ (สำคัญที่สุด) Environment Variables (เช่น DATABASE\_HOST, JWT\_SECRET) +* package.json + * **หน้าที่:** เก็บรายการ Dependencies ทั้งหมด (เช่น @nestjs/core, typeorm, bcrypt, @nestjs/elasticsearch) +* .gitignore, tsconfig.json, nest-cli.json + * **หน้าที่:** ไฟล์ตั้งค่าพื้นฐานของโปรเจกต์ TypeScript และ NestJS + +## **📂 src/ (Source Code)** + +นี่คือหัวใจหลักของแอปพลิเคชัน + +### **1\. src/ (Root Files)** + +* main.ts + * **หน้าที่:** จุดเริ่มต้น (Entry Point) ของแอปพลิเคชัน + * **การตั้งค่า:** + * ใช้ helmet() (Security) + * ใช้ RateLimiterGuard (Security) + * ใช้ ValidationPipe (Global Pipe สำหรับ DTO) + * ใช้ HttpExceptionFilter (Global Filter สำหรับ Error Handling) + * ตั้งค่า SwaggerModule (สำหรับสร้าง API Docs) + * ตั้งค่า Global Prefix (/api/v1) +* app.module.ts + * **หน้าที่:** โมดูลหลัก (Root Module) + * **การตั้งค่า:** + * Import ConfigModule (สำหรับ .env) + * Import TypeOrmModule (เชื่อมต่อฐานข้อมูล) + * **Import โมดูลหลักและโมดูล Feature ทั้งหมด** (เช่น CommonModule, UserModule, CorrespondenceModule, SearchModule ฯลฯ) + +### **2\. src/common/ (The Foundation)** + +โฟลเดอร์นี้คือ "รากฐาน" เก็บโค้ดที่โมดูลอื่นต้องใช้ร่วมกัน (Shared Logic) + +* common.module.ts + * **หน้าที่:** ไฟล์ที่รวบรวมและ export Service/Module ทั้งหมดใน common/ ให้โมดูลอื่นเรียกใช้ง่ายๆ +* auth/ + * **หน้าที่:** จัดการการยืนยันตัวตน (Authentication) และสิทธิ์ (RBAC) + * auth.module.ts, auth.service.ts, auth.controller.ts (สำหรับ /login, /me) + * strategies/jwt.strategy.ts (ตรรกะการถอดรหัส JWT) + * guards/rbac.guard.ts (ตัวตรวจสอบสิทธิ์ RBACGuard) + * decorators/require-permission.decorator.ts (@RequirePermission) + * decorators/current-user.decorator.ts (@CurrentUser) +* entities/ + * **หน้าที่:** **ศูนย์รวม Entities ทั้งหมด (44+ ไฟล์)** ที่ Map กับตารางใน MariaDB + * เช่น user.entity.ts, role.entity.ts, correspondence.entity.ts, rfa.entity.ts, shop-drawing.entity.ts, circulation.entity.ts, attachment.entity.ts, audit-log.entity.ts ฯลฯ + * views/: โฟลเดอร์ย่อยสำหรับ View Entities (เช่น view-current-correspondence.entity.ts) +* config/ + * **หน้าที่:** เก็บ Config ที่ซับซ้อน เช่น typeorm.config.ts (ตั้งค่าการเชื่อมต่อ TypeORM) +* exceptions/ + * http-exception.filter.ts (Global Error Handler) +* file-storage/ + * file-storage.service.ts (Logic การบันทึกไฟล์ลง Disk) + * file.controller.ts (API Endpoint /files/upload) +* audit-log/ + * audit-log.service.ts (Service บันทึก Log) + * audit-log.interceptor.ts (Interceptor ดักจับการกระทำ) +* security/ + * rate-limiter.module.ts (ตั้งค่า Rate Limiting) + +### **3\. src/modules/ (The Features)** + +โฟลเดอร์นี้เก็บ "Business Logic" โดยแยกเป็น Feature Modules อย่างชัดเจน + +* user/ (Phase 1\) + * **หน้าที่:** API สำหรับ Admin Panel (จัดการ Users, Roles, Permissions) + * admin-users.controller.ts, admin-roles.controller.ts, user.service.ts, roles.service.ts +* project/ (Phase 2\) + * **หน้าที่:** API สำหรับจัดการโปรเจกต์ (ยังไม่ได้สร้างไฟล์ แต่มีในแผน) +* document-numbering/ (Phase 2\) + * **หน้าที่:** API สำหรับ Admin (ตั้งค่า Format เลขที่) และ Service (generateNextDocumentNumber) +* master-data/ (Phase 2\) + * **หน้าที่:** API สำหรับ Admin (จัดการ Master Data เช่น Tags, RFA Types, Corr. Types) +* correspondence/ (Phase 2\) + * **หน้าที่:** Logic หลักในการสร้าง/ค้นหา เอกสารโต้ตอบ +* rfa/ (Phase 3\) + * **หน้าที่:** Logic หลักในการสร้าง/ค้นหา เอกสารขออนุมัติ (RFA) +* drawing/ (Phase 3\) + * **หน้าที่:** Logic หลักในการสร้าง/ค้นหา แบบแปลน (Contract & Shop Drawing) +* circulation/ (Phase 3\) + * **หน้าที่:** Logic หลักในการสร้าง/ค้นหา ใบเวียนภายใน +* transmittal/ (Phase 3\) + * **หน้าที่:** Logic หลักในการสร้าง/ค้นหา เอกสารนำส่ง +* search/ (Phase 4\) + * **หน้าที่:** API (/search) และ Service ที่เชื่อมต่อกับ Elasticsearch +* notification/ (Phase 4\) + * **หน้าที่:** Service สำหรับยิง Webhook ไปยัง N8N +* caching/ (Phase 4\) + * **หน้าที่:** โมดูลตั้งค่า Caching (Global) +* health/ (Phase 5 \- Deploy) + * **หน้าที่:** API (/health) สำหรับ Health Check \ No newline at end of file diff --git a/docs/SQL/01_dms_v1_0_0.bak.sql b/docs/SQL/01_dms_v1_0_0.bak.sql new file mode 100644 index 0000000..a06a01c --- /dev/null +++ b/docs/SQL/01_dms_v1_0_0.bak.sql @@ -0,0 +1,1248 @@ +-- ========================================================== +-- DMS v1.0.0 +-- Database v1.0 - 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 +-- Notes: +-- ========================================================== + +SET NAMES utf8mb4; +SET time_zone = '+07:00'; + +-- ปิดการตรวจสอบ Foreign Key ชั่วคราวเพื่อให้สามารถลบตารางได้ทั้งหมด +SET FOREIGN_KEY_CHECKS=0; + +-- Level 1: ตารางที่มีความสัมพันธ์มากที่สุด (Junction Tables & Detail Tables) +DROP TABLE IF EXISTS audit_logs; +DROP TABLE IF EXISTS user_project_roles; +DROP TABLE IF EXISTS user_roles; +DROP TABLE IF EXISTS role_permissions; +DROP TABLE IF EXISTS contract_parties; +DROP TABLE IF EXISTS project_parties; +DROP TABLE IF EXISTS correspondence_references; +DROP TABLE IF EXISTS correspondence_cc_recipients; +DROP TABLE IF EXISTS correspondence_routing_steps; +DROP TABLE IF EXISTS correspondence_routing_template_steps; +DROP TABLE IF EXISTS rfa_items; +DROP TABLE IF EXISTS transmittal_items; +DROP TABLE IF EXISTS technicaldoc_workflows; +DROP TABLE IF EXISTS technicaldoc_workflow_template_steps; +DROP TABLE IF EXISTS shop_drawing_revisions; +DROP TABLE IF EXISTS contract_dwg_subcat_cat_map; +DROP TABLE IF EXISTS circulation_template_assignees; +DROP TABLE IF EXISTS cir_action_documents; +DROP TABLE IF EXISTS cir_actions; +DROP TABLE IF EXISTS attachments; +DROP TABLE IF EXISTS cir_recipients; +DROP TABLE IF EXISTS circulation_assignees; +DROP TABLE IF EXISTS correspondence_status_transitions; +DROP TABLE IF EXISTS global_default_roles; + +-- Level 2: ตารางที่ถูกอ้างอิงโดย Level 1 +DROP TABLE IF EXISTS correspondence_revisions; +DROP TABLE IF EXISTS transmittals; +DROP TABLE IF EXISTS circulations; +DROP TABLE IF EXISTS correspondence_routing_templates; +DROP TABLE IF EXISTS technicaldoc_workflow_templates; +DROP TABLE IF EXISTS shop_drawings; +DROP TABLE IF EXISTS contract_drawings; +DROP TABLE IF EXISTS technicaldocs; +DROP TABLE IF EXISTS circulation_templates; +DROP TABLE IF EXISTS correspondence_tags; +DROP TABLE IF EXISTS tags; + +-- Level 3: ตารางที่ถูกอ้างอิงโดย Level 2 +DROP TABLE IF EXISTS correspondences; +DROP TABLE IF EXISTS shop_drawing_sub_categories; +DROP TABLE IF EXISTS shop_drawing_main_categories; +DROP TABLE IF EXISTS contract_dwg_sub_cat; +DROP TABLE IF EXISTS contract_dwg_cat; +DROP TABLE IF EXISTS technicaldoc_approve_codes; +DROP TABLE IF EXISTS technicaldoc_status_codes; +DROP TABLE IF EXISTS technicaldoc_types; +DROP TABLE IF EXISTS contract_dwg_volume; + +-- Level 4: ตาราง Master Data หลัก และตารางที่ถูกอ้างอิงโดย Level 3 +DROP TABLE IF EXISTS users; +DROP TABLE IF EXISTS projects; +DROP TABLE IF EXISTS contracts; +DROP TABLE IF EXISTS correspondence_status; -- Using this name from your list +DROP TABLE IF EXISTS correspondence_types; +DROP TABLE IF EXISTS cir_status_codes; +DROP TABLE IF EXISTS permissions; +DROP TABLE IF EXISTS roles; + +-- Level 5: ตารางที่เป็นรากฐานที่สุด +DROP TABLE IF EXISTS organizations; +DROP TABLE IF EXISTS organization_roles; + +-- เปิดการตรวจสอบ Foreign Key กลับมาเหมือนเดิม +SET FOREIGN_KEY_CHECKS=1; + +-- ========================================================== +-- Table Creation +-- ========================================================== +-- Level 5: Organizations +-- ========================================================== +-- 5.1 Organizations_roles Table +CREATE TABLE organization_roles ( + role_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_roles +INSERT INTO organization_roles (role_name) VALUES +('OWNER'), +('DESIGNER'), +('CONSULTANT'), +('CONTRACTOR'), +('THIRD PARTY'); + +-- 5.2 Organizations Table +CREATE TABLE organizations ( + org_id INT NOT NULL PRIMARY KEY COMMENT 'ID ของตาราง', + org_code VARCHAR(20) NOT NULL COMMENT 'รหัสองค์กร', + org_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 'วันที่แก้ไขล่าสุด', + -- PRIMARY KEY (org_id), + UNIQUE KEY ux_organizations_code (org_code), + FOREIGN KEY (role_id) REFERENCES organization_roles(role_id) + ON DELETE SET NULL + ON UPDATE CASCADE +) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_general_ci COMMENT='Organizations Table'; + +INSERT INTO organizations (org_id, org_code, org_name, role_id) VALUES (1, 'กทท.','การท่าเรือแห่งประเทศไทย',1); +INSERT INTO organizations (org_id, org_code, org_name, role_id) VALUES (10, 'สคฉ.3','สำนักงานโครงการพัฒนาท่าเรือแหลมฉบัง ระยะที่ 3 (ส่วนที่ 1-4)', 1); +INSERT INTO organizations (org_id, org_code, org_name, role_id) VALUES (11, 'สคฉ.3-01','คณะกรรมการตรวจรับพัสดุ งานจ้างที่ปรีกษาควบคุมงาน โครงการพัฒนาท่าเรือแหลมฉบัง ระยะที่ 3 (ส่วนที่ 1-4)', 1); +INSERT INTO organizations (org_id, org_code, org_name, role_id) VALUES (12, 'สคฉ.3-02','คณะกรรมการตรวจรับพัสดุ งานก่อสร้าง โครงการพัฒนาท่าเรือแหลมฉบัง ระยะที่ 3 (ส่วนที่ 1) งานก่อสร้างงานทางทะเล', 1); +INSERT INTO organizations (org_id, org_code, org_name, role_id) VALUES (13, 'สคฉ.3-03','คณะกรรมการตรวจรับพัสดุ งานก่อสร้าง โครงการพัฒนาท่าเรือแหลมฉบัง ระยะที่ 3 (ส่วนที่ 2) งานก่อสร้างอาคาร ท่าเทียบเรือ ระบบถนน และระบบสาธารณูปโภค',1); +INSERT INTO organizations (org_id, org_code, org_name, role_id) VALUES (16, 'สคฉ.3-06','คณะกรรมการตรวจรับพัสดุ งานก่อสร้าง โครงการพัฒนาท่าเรือแหลมฉบัง ระยะที่ 3 (ส่วนที่ 3) งานก่อสร้าง', 1); +INSERT INTO organizations (org_id, org_code, org_name, role_id) VALUES (17, 'สคฉ.3-07','คณะกรรมการตรวจรับพัสดุ งานก่อสร้าง โครงการพัฒนาท่าเรือแหลมฉบัง ระยะที่ 3 (ส่วนที่ 4) งานก่อสร้าง', 1); +INSERT INTO organizations (org_id, org_code, org_name, role_id) VALUES (18, 'สคฉ.3-xx','คณะกรรมการตรวจรับพัสดุ งานจ้างที่ปรีกษาออกแบบ โครงการพัฒนาท่าเรือแหลมฉบัง ระยะที่ 3 (ส่วนที่ 4) งานก่อสร้าง', 1); +INSERT INTO organizations (org_id, org_code, org_name, role_id) VALUES (14, 'สคฉ.3-04','คณะกรรมการตรวจรับพัสด งานจ้างเหมาตรวจสอบผลกระทบสิ่งแวดล้อมระหว่างงานก่อสร้างโครงการพัฒนาท่าเรือแหลมฉบัง ระยะที่ 3 (ส่วนที่ 1-4)', 1); +INSERT INTO organizations (org_id, org_code, org_name, role_id) VALUES (15, 'สคฉ.3-05','คณะกรรมการตรวจรับพัสดุ งานเยียวยาการประมงและเพาะเลี้ยงสัตว์น้ำ', 1); +INSERT INTO organizations (org_id, org_code, org_name, role_id) VALUES (21, 'TEAM',' Designer Consulting Ltd.', 2); +INSERT INTO organizations (org_id, org_code, org_name, role_id) VALUES (22, 'คคง.','Construction Supervision Ltd.', 3); +INSERT INTO organizations (org_id, org_code, org_name, role_id) VALUES (41, 'ผรม.1',' โครงการพัฒนาท่าเรือแหลมฉบังระยะที่ 3 (ส่วนที่ 1) งานก่อสร้างงานทางทะเล', 4); +INSERT INTO organizations (org_id, org_code, org_name, role_id) VALUES (42, 'ผรม.2','ผรม.2 โครงการพัฒนาท่าเรือแหลมฉบัง ระยะที่ 3 (ส่วนที่ 2) งานก่อสร้างอาคาร ท่าเทียบเรือ ระบบถนน และระบบสาธารณูปโภค', 4); +INSERT INTO organizations (org_id, org_code, org_name, role_id) VALUES (43, 'ผรม.3','ผรม.3 Contractor Company #3 Ltd.', 4); +INSERT INTO organizations (org_id, org_code, org_name, role_id) VALUES (44, 'ผรม.4','ผรม.4 Contractor Company #4 Ltd.', 4); +INSERT INTO organizations (org_id, org_code, org_name, role_id) VALUES (31, 'EN','Third Party Environment', 5); +INSERT INTO organizations (org_id, org_code, org_name, role_id) VALUES (32, 'CAR','Third Party Care for Fishery', 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'; + +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), + ('EDITOR', 'Editor', 'Can create/edit RFA/Drawings/Docs/Transmittals' ,1), + ('VIEWER', 'Viewer', 'Read-only access' ,0), + ('GUEST', 'Guest', 'Limited read-only access' ,0) +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'; + +INSERT INTO permissions (permission_code, description, module, scope_level) VALUES + -- System + ('superadmin.access','Access Everything (All Orgs)','admin','GLOBAL'), + ('admin.access','Access Admin Panel (scoped)','admin','ORG'), + ('settings.manage','Manage Settings','admin','GLOBAL'), + -- Projects & Parties + ('projects.view','View Projects','projects','ORG'), + ('projects.manage','Create/Edit/Delete Projects','projects','ORG'), + ('project_parties.manage','Manage Project Parties','projects','ORG'), + -- Organizations + ('organizations.view','View Organizations','organizations','GLOBAL'), + ('organizations.manage','Manage Organizations','organizations','GLOBAL'), + -- Drawings + ('drawings.view','View Drawings','drawings','PROJECT'), + ('drawings.upload','Upload Drawing Revisions','drawings','PROJECT'), + ('drawings.delete','Delete Drawings/Revisions','drawings','PROJECT'), + -- Documents/Materials/MS + ('documents.view','View Documents','documents','PROJECT'), + ('documents.manage','Manage Documents/Revisions','documents','PROJECT'), + ('materials.view','View Materials','materials','PROJECT'), + ('materials.manage','Manage Materials/Revisions','materials','PROJECT'), + ('ms.view','View Method Statements','ms','PROJECT'), + ('ms.manage','Manage Method Statements/Revisions','ms','PROJECT'), + -- RFAs + ('rfas.view','View RFAs','rfas','PROJECT'), + ('rfas.create','Create RFA','rfas','PROJECT'), + ('rfas.respond','Respond / Update RFA','rfas','PROJECT'), + ('rfas.delete','Delete RFA','rfas','PROJECT'), + -- Correspondence & Transmittal & Circulation + ('corr.view','View Correspondences','correspondence','PROJECT'), + ('corr.manage','Manage Correspondences','correspondence','PROJECT'), + ('transmittals.manage','Manage Transmittals','transmittal','PROJECT'), + ('cirs.manage','Manage Circulations','circulation','ORG'), + -- Reports + ('reports.view','View Reports','reports','GLOBAL') +ON DUPLICATE KEY UPDATE + description=VALUES(description), + module=VALUES(module), + scope_level=VALUES(scope_level), + is_active=1; + +-- 4.5 cir_status_codes Table +CREATE TABLE cir_status_codes ( + cir_status_code_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 cir_status_codes (code, description, sort_order) VALUES +('OPEN', 'Open', 10), +('IN_REVIEW', 'In Review', 20), +('COMPLETED', 'Completed', 30), +('CANCELLED', 'Cancelled/Withdrawn', 99); + +-- 4.6 correspondence_types Table +CREATE TABLE correspondence_types ( + type_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', 10,1), + ('EMAIL', 'Email', 20,1), + ('INSTRUCTION', 'Instruction', 30,1), + ('LETTER', 'Letter', 40,1), + ('MEMO', 'Memorandum', 50,1), + ('MOM', 'Minutes of Meeting', 60,1), + ('RFI', 'Request for Information', 70,1), + ('TRANSMITTAL', 'Transmittal', 80,1); + +-- 4.7 correspondence_status Table +CREATE TABLE correspondence_status ( + 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.8 contracts Table: Stores information about each contract. +CREATE TABLE contracts ( + contract_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.9 Projects (contractor optional, FK -> organizations with SET NULL) +CREATE TABLE projects ( + project_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_org_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(project_id) ON UPDATE CASCADE ON DELETE SET NULL, + CONSTRAINT fk_proj_contractor FOREIGN KEY (contractor_org_id) REFERENCES organizations(org_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_org_id); + +INSERT INTO projects (project_code, project_name) VALUES + ('LCBP3','โครงการพัฒนาท่าเรือแหลมฉบัง ระยะที่ 3 (ส่วนที่ 1-4)'), + ('LCBP3C1','โครงการพัฒนาท่าเรือแหลมฉบัง ระยะที่ 3 (ส่วนที่ 1) งานก่อสร้างงานทางทะเล'), + ('LCBP3C2','โครงการพัฒนาท่าเรือแหลมฉบัง ระยะที่ 3 (ส่วนที่ 2) งานก่อสร้างอาคาร ท่าเทียบเรือ ระบบถนน และระบบสาธารณูปโภค'), + ('LCBP3C3','โครงการพัฒนาท่าเรือแหลมฉบัง ระยะที่ 3 (ส่วนที่ 3) งานก่อสร้าง'), + ('LCBP3C4','โครงการพัฒนาท่าเรือแหลมฉบัง ระยะที่ 3 (ส่วนที่ 4) งานก่อสร้าง'); + +-- 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', + org_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 (org_id) REFERENCES organizations(org_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); + +-- ========================================================== +-- Level 3: ตารางที่ถูกอ้างอิงโดย Level 2 +-- ========================================================== +-- 3.1 technicaldocs_types Table +CREATE TABLE technicaldoc_types ( + document_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 technicaldoc_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 technicaldocs_status_codes Table +CREATE TABLE technicaldoc_status_codes ( + status_code_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 technicaldoc_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 technicaldocs_approve_codes Table +CREATE TABLE technicaldoc_approve_codes ( + approve_code_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 technicaldoc_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 contract_dwg_cat Table: Category (ต่อโปรเจกต์) +CREATE TABLE contract_dwg_cat ( + cat_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, cat_id), -- เพิ่ม unique (project_id, cat_id) เพื่อรองรับ composite FK + + KEY idx_cat_project (project_id), + KEY idx_cat_project_code (project_id, cat_code), + + CONSTRAINT fk_cat_project + FOREIGN KEY (project_id) REFERENCES projects(project_id) + ON UPDATE CASCADE ON DELETE CASCADE +) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_general_ci COMMENT='ตารางหมวดหมู่ของแบบสัญญา'; + +-- 3.5 contract_dwg_sub_cat Table: Sub-Category (ต่อโปรเจกต์) +CREATE TABLE contract_dwg_sub_cat ( + sub_cat_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, sub_cat_id), -- เพิ่ม unique (project_id, sub_cat_id) เพื่อรองรับ composite FK + + KEY idx_subcat_project (project_id), + KEY idx_subcat_project_code (project_id, sub_cat_code), + + CONSTRAINT fk_subcat_project + FOREIGN KEY (project_id) REFERENCES projects(project_id) + ON UPDATE CASCADE ON DELETE CASCADE +) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_general_ci COMMENT='ตารางหมวดหมู่ย่อยของแบบสัญญา'; + +-- 3.6 shop_drawing_main_categories Table: ตารางหมวดหมู่หลักของ Shop Drawing +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.7 shop_drawing_sub_categories Table: ตารางหมวดหมู่ย่อยของ Shop Drawing +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.8 correspondences Table: +-- details [email_details, instruction_details, letter_details, memorandum_details, minutes_of_meeting_details, rfi_details] +CREATE TABLE correspondences ( + corr_id INT AUTO_INCREMENT PRIMARY KEY COMMENT 'ID ของตาราง', + + -- root of a document family (first revision) + root_id INT NULL COMMENT 'รหัสเอกสารต้นทาง (NULL ถ้าเป็นเอกสารต้นทาง)', + + correspondence_number VARCHAR(100) NOT NULL COMMENT 'เลขที่หนังสือ', + correspondence_type_id INT NOT NULL COMMENT 'ประเภทหนังสือ', + correspondence_status_id INT NOT NULL COMMENT 'สถานะหนังสือ', + + is_internal_communication TINYINT(1) NOT NULL DEFAULT 0 COMMENT 'ระบุว่าเป็นหนังสือสื่อสารภายใน (1=ใช่,0=ไม่ใช่)', + revision VARCHAR(50) NULL COMMENT 'หมายเลขแก้ไขของหนังสือ', -- e.g., A,B or 1,2; NULL for first issue if desired + project_id INT NOT NULL COMMENT 'รหัสโครงการ', + originator_id INT NULL COMMENT 'รหัสองค์กรผู้ส่ง', + recipient_id INT NULL COMMENT 'รหัสองค์กรผู้รับ', + title VARCHAR(255) NOT NULL COMMENT 'หัวเรื่องหนังสือ', + keywords VARCHAR(255) NULL COMMENT 'คำสำคัญของหนังสือ (คั่นด้วย comma)', + created_at DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP COMMENT 'วันที่สร้าง', + created_by INT NULL COMMENT 'รหัสผู้สร้าง', + issued_date DATETIME NULL COMMENT 'วันที่ออกหนังสือ', + updated_by INT NULL COMMENT 'รหัสผู้แก้ไข', + deleted_at DATETIME NULL COMMENT 'วันที่ลบ', + deleted_by INT NULL COMMENT 'รหัสผู้ลบ', + pdf_path VARCHAR(500) NULL COMMENT 'ที่เก็บไฟล์ PDF ของหนังสือ', + details JSON NULL COMMENT 'เก็บข้อมูลเฉพาะของเอกสารแต่ละประเภทในรูปแบบ JSON', + CONSTRAINT chk_cor_internal CHECK (is_internal_communication IN (0,1)), + + -- doc number uniqueness per project + CONSTRAINT uq_cor_no_per_project UNIQUE (project_id, correspondence_number), + + -- enforce unique revision per root per project + CONSTRAINT uq_root_rev_per_project UNIQUE (root_id, revision, project_id), + + -- FKs + CONSTRAINT fk_cor_project FOREIGN KEY (project_id) REFERENCES projects(project_id) ON UPDATE CASCADE ON DELETE CASCADE, + CONSTRAINT fk_cor_originator FOREIGN KEY (originator_id) REFERENCES organizations(org_id) ON UPDATE CASCADE ON DELETE SET NULL, + CONSTRAINT fk_cor_recipient FOREIGN KEY (recipient_id) REFERENCES organizations(org_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_updated_by FOREIGN KEY (updated_by) REFERENCES users(user_id) ON UPDATE CASCADE ON DELETE SET NULL, + CONSTRAINT fk_cor_type FOREIGN KEY (correspondence_type_id) REFERENCES correspondence_types(type_id) ON UPDATE CASCADE ON DELETE RESTRICT, + CONSTRAINT fk_cor_status FOREIGN KEY (correspondence_status_id) REFERENCES correspondence_status(status_id) ON UPDATE CASCADE ON DELETE RESTRICT, + + -- self reference; prevent deleting root accidentally + CONSTRAINT fk_cor_root FOREIGN KEY (root_id) REFERENCES correspondences(corr_id) ON UPDATE CASCADE ON DELETE RESTRICT +) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_general_ci COMMENT='ตารางเก็บข้อมูลหนังสือสื่อสารต่างๆ'; + +CREATE INDEX idx_cor_project ON correspondences(project_id); +CREATE INDEX idx_cor_originator ON correspondences(originator_id); +CREATE INDEX idx_cor_recipient ON correspondences(recipient_id); +CREATE INDEX idx_cor_type ON correspondences(correspondence_type_id); +CREATE INDEX idx_cor_status ON correspondences(correspondence_status_id); +CREATE INDEX idx_cor_created_at ON correspondences(created_at); + +-- 3.9 contract_dwg_volume Table: +CREATE TABLE contract_dwg_volume ( + volume_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, volume_id), + + KEY idx_volume_project (project_id), + KEY idx_volume_project_code (project_id, volume_code), + + CONSTRAINT fk_volume_project + FOREIGN KEY (project_id) REFERENCES projects(project_id) + ON UPDATE CASCADE ON DELETE CASCADE +) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_general_ci; + +-- ========================================================== +-- Level 2: ตารางที่ถูกอ้างอิงโดย Level 1 +-- ========================================================== +-- 2.1 circulation_templates Table: ตารางหลักสำหรับเก็บชื่อแม่แบบใบเวียน +CREATE TABLE circulation_templates ( + template_id INT NOT NULL AUTO_INCREMENT PRIMARY KEY COMMENT 'ID ของแม่แบบ', + template_name VARCHAR(255) NOT NULL COMMENT 'ชื่อแม่แบบ (เช่น "สำหรับเอกสารการเงิน", "สำหรับ Drawing โครงสร้าง")', + org_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, org_id), + + -- Foreign Key + CONSTRAINT fk_ct_org FOREIGN KEY (org_id) REFERENCES organizations(org_id) ON DELETE CASCADE +) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_general_ci COMMENT='แม่แบบสำหรับใบเวียนเอกสารภายในองค์กร'; + +-- 2.2 technicaldocs Table +CREATE TABLE technicaldocs ( + id INT AUTO_INCREMENT PRIMARY KEY COMMENT 'ID ของตาราง', + document_type_id INT NOT NULL COMMENT 'ประเภทเอกสาร', + original_id INT NOT NULL COMMENT 'รหัสเอกสารต้นฉบับ (root document)', + revision VARCHAR(50) NOT NULL COMMENT 'หมายเลขแก้ไขของเอกสาร', -- e.g., A,B or 1,2; NULL for first issue if desired + title VARCHAR(255) NOT NULL COMMENT 'หัวเรื่องเอกสาร', + project_id INT NOT NULL COMMENT 'รหัสโครงการ', + status_code_id INT NOT NULL COMMENT 'รหัสสถานะเอกสาร', + approve_code_id INT NULL COMMENT 'รหัสการอนุมัติเอกสาร', + created_at DATETIME DEFAULT CURRENT_TIMESTAMP COMMENT 'วันที่สร้าง', + updated_at DATETIME NULL COMMENT 'วันที่แก้ไขล่าสุด', + created_by INT NULL COMMENT 'รหัสผู้สร้าง', + updated_by INT NULL COMMENT 'รหัสผู้แก้ไข', + deleted_at DATETIME NULL COMMENT 'วันที่ลบ', + pdf_path VARCHAR(500) NULL COMMENT 'ที่เก็บไฟล์ PDF ของเอกสาร', + CONSTRAINT fk_techdoc_created_by FOREIGN KEY (created_by) REFERENCES users(user_id) ON UPDATE CASCADE ON DELETE SET NULL, + CONSTRAINT fk_techdoc_updated_by FOREIGN KEY (updated_by) REFERENCES users(user_id) ON UPDATE CASCADE ON DELETE SET NULL, + CONSTRAINT fk_techdoc_status FOREIGN KEY (status_code_id) REFERENCES technicaldoc_status_codes(status_code_id), + CONSTRAINT fk_techdoc_approve FOREIGN KEY (approve_code_id) REFERENCES technicaldoc_approve_codes(approve_code_id) ON UPDATE CASCADE ON DELETE SET NULL, + CONSTRAINT fk_techdoc_type FOREIGN KEY (document_type_id) REFERENCES technicaldoc_types(document_types_id), + CONSTRAINT fk_techdoc_project FOREIGN KEY (project_id) REFERENCES projects(project_id) +) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_general_ci COMMENT='ตารางเก็บข้อมูลเอกสารทางเทคนิค'; + +CREATE UNIQUE INDEX idx_unique_techdoc_revision ON technicaldocs (original_id, revision, project_id); + +/* =========================================================== +2.3 Drawings (ต่อโปรเจกต์) + - 1 drawing ∈ 1 project + - ชี้ 1 sub-category (ในโปรเจกต์เดียวกัน) + - ชี้ 1 volume (ในโปรเจกต์เดียวกัน) + - unique: (project_id, condwg_no) + =========================================================== */ + +CREATE TABLE contract_drawings ( + condwg_id INT AUTO_INCREMENT PRIMARY KEY COMMENT 'ID ของตาราง', + project_id INT NOT NULL COMMENT 'รหัสโปรเจกต์', + condwg_no VARCHAR(255) NOT NULL COMMENT 'เลขที่แบบ Drawing', -- รหัส/เลขดรอว์อิง + title VARCHAR(255) NULL COMMENT 'ชื่อแบบ Drawing', + 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 'วันที่แก้ไขล่าสุด', + + 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(project_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_dwg_sub_cat (project_id, sub_cat_id) + ON UPDATE CASCADE ON DELETE RESTRICT, + + CONSTRAINT fk_condwg_volume_same_project + FOREIGN KEY (project_id, volume_id) + REFERENCES contract_dwg_volume (project_id, volume_id) + ON UPDATE CASCADE ON DELETE RESTRICT +) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_general_ci COMMENT='ตารางเก็บข้อมูล Drawing ต่อโปรเจกต์'; + +-- 2.4 shop_drawings Table: ตารางหลักสำหรับข้อมูล Shop Drawing +CREATE TABLE shop_drawings ( + id INT NOT NULL AUTO_INCREMENT PRIMARY KEY COMMENT 'ID ของตาราง', + 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 หมวดหมู่ย่อย', + remark VARCHAR(500) NULL 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_sd_drawing_number (drawing_number), + 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.5 technicaldoc_workflow_templates Table: ตารางหลักสำหรับเก็บชื่อแม่แบบ +CREATE TABLE technicaldoc_workflow_templates ( + template_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 'รหัสโครงการ', -- (Optional) ทำให้สามารถสร้างแม่แบบเฉพาะโครงการได้ + 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_template_name_project (template_name, project_id), + CONSTRAINT fk_wt_project FOREIGN KEY (project_id) REFERENCES projects(project_id) ON DELETE CASCADE +) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_general_ci; + +-- 2.6 correspondence_routing_templates Table:ตารางหลักสำหรับเก็บชื่อแม่แบบการส่งต่อ +CREATE TABLE correspondence_routing_templates ( + template_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 โครงการ (ถ้าเป็นแม่แบบเฉพาะโครงการ)', + 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(project_id) ON DELETE CASCADE +) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_general_ci COMMENT='แม่แบบสายงานการส่งต่อเอกสารทั่วไป'; + +-- 2.7 circulations Table: +CREATE TABLE circulations ( + cir_id INT NOT NULL AUTO_INCREMENT PRIMARY KEY COMMENT 'ID ของตาราง', + correspondence_id INT UNIQUE COMMENT 'ID ของเอกสาร (จากตาราง correspondences)', -- one circulation record per correspondence (optional) + org_id INT NOT NULL COMMENT 'ID ขององค์กรที่เป็นเจ้าของใบเวียนนี้', + cir_no VARCHAR(100) NOT NULL COMMENT 'เลขที่ใบเวียน', + cir_subject VARCHAR(500) NOT NULL COMMENT 'หัวเรื่องใบเวียน', + cir_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 'วันที่แก้ไขล่าสุด', + pdf_path VARCHAR(500) NULL COMMENT 'ที่เก็บไฟล์ PDF ของใบเวียน', + CONSTRAINT uq_cir_org_no UNIQUE(org_id, cir_no), + CONSTRAINT fk_cir_correspondence FOREIGN KEY (correspondence_id) REFERENCES correspondences(corr_id), + CONSTRAINT fk_cir_org FOREIGN KEY (org_id) REFERENCES organizations(org_id), + CONSTRAINT fk_cir_status FOREIGN KEY (cir_status_code) REFERENCES cir_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(org_id); +CREATE INDEX idx_cir_status ON circulations(cir_status_code); +CREATE INDEX idx_cir_corr ON circulations(correspondence_id); + +-- 2.8 transmittal Table: ตารางสำหรับเก็บข้อมูลเฉพาะของ Transmittal (เป็นตารางลูกของ correspondences) +CREATE TABLE transmittals ( + -- ใช้ corr_id เป็นทั้ง Primary Key และ Foreign Key เพื่อสร้างความสัมพันธ์แบบ One-to-One + corr_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 'หมายเหตุเพิ่มเติม', + created_by_user_id INT NOT NULL COMMENT 'ID ของผู้สร้าง Transmittal', + submitted_at TIMESTAMP NULL COMMENT 'เวลาที่ส่ง Transmittal', + created_at TIMESTAMP NOT NULL DEFAULT CURRENT_TIMESTAMP COMMENT 'วันที่สร้าง', + + -- Foreign Key + CONSTRAINT fk_transmittal_correspondence FOREIGN KEY (corr_id) REFERENCES correspondences(corr_id) ON DELETE CASCADE +) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_general_ci COMMENT='ตารางเก็บข้อมูลเฉพาะของเอกสารนำส่ง (Transmittal)'; + +-- 2.9 correspondence_revisions Table: ตารางสำหรับเก็บประวัติการแก้ไขเอกสาร (Revision History) +CREATE TABLE correspondence_revisions ( + revision_id INT NOT NULL AUTO_INCREMENT PRIMARY KEY COMMENT 'ID ของตาราง', + correspondence_id INT NOT NULL COMMENT 'ID ของเอกสาร (จากตาราง correspondences)', + version_number INT NOT NULL COMMENT 'หมายเลขเวอร์ชันของเอกสาร', + change_reason TEXT NOT NULL COMMENT 'สาเหตุการแก้ไข', + changed_by_user_id INT NOT NULL COMMENT 'ID ของผู้ที่ทำการแก้ไข', + changed_at TIMESTAMP NOT NULL DEFAULT CURRENT_TIMESTAMP COMMENT 'วันที่และเวลาที่แก้ไข', + -- คอลัมน์ที่ต้องการเก็บประวัติ (Snapshot of data before change) + document_data_json JSON NOT NULL COMMENT 'ข้อมูลเอกสารในรูปแบบ JSON ณ เวลาที่แก้ไข', + CONSTRAINT fk_cr_correspondence FOREIGN KEY (correspondence_id) REFERENCES correspondences(corr_id) ON DELETE CASCADE, + CONSTRAINT fk_cr_user FOREIGN KEY (changed_by_user_id) REFERENCES users(user_id) +) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_general_ci COMMENT='ตารางเก็บประวัติการแก้ไขเอกสาร (Revision History)'; + +-- 2.10 ตารางหลักสำหรับเก็บ Tag ทั้งหมด (Master Data) +CREATE TABLE tags ( + tag_id INT NOT NULL AUTO_INCREMENT PRIMARY KEY COMMENT 'ID ของ Tag', + tag_name VARCHAR(50) NOT NULL COMMENT 'ชื่อ Tag', + + -- ป้องกันการสร้างชื่อ Tag ซ้ำ + UNIQUE KEY ux_tag_name (tag_name) +) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_general_ci COMMENT='ตารางเก็บ Master Data ของ Tags'; + + +-- 2.11 ตารางเชื่อม (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(corr_id) ON DELETE CASCADE, + CONSTRAINT fk_ct_tag FOREIGN KEY (tag_id) REFERENCES tags(tag_id) ON DELETE CASCADE +) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_general_ci COMMENT='ตารางเชื่อมความสัมพันธ์ระหว่างเอกสารและ Tags'; + +-- ========================================================== +-- Level 1: ตารางที่มีความสัมพันธ์มากที่สุด (Junction Tables & Detail Tables) +-- ========================================================== +-- 1.1 global_default_roles Table: Global default roles (template defaults) +CREATE TABLE global_default_roles ( + id TINYINT NOT NULL DEFAULT 1 COMMENT 'ID ของตาราง', + role ENUM('OWNER','DESIGNER','CONSULTANT') NOT NULL COMMENT 'บทบาทมาตรฐาน', + position TINYINT NOT NULL COMMENT 'ลำดับที่ของบทบาทในแต่ละประเภท', + org_id INT NOT NULL COMMENT 'ID ขององค์กรที่ถูกกำหนดเป็นบทบาทนี้', + PRIMARY KEY (id, role, position), + UNIQUE KEY ux_gdr_unique_org_per_role (id, role, org_id), + CONSTRAINT fk_gdr_org FOREIGN KEY (org_id) REFERENCES organizations(org_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, org_id) +SELECT 1, 'OWNER', pos, org_id +FROM ( + SELECT org_id, ROW_NUMBER() OVER (ORDER BY org_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 org_id=VALUES(org_id); + +-- DESIGNER +INSERT INTO global_default_roles (id, role, position, org_id) +SELECT 1, 'DESIGNER', 1, org_id +FROM organizations +-- WHERE primary_role='DESIGNER' +WHERE role_id = 2 +ORDER BY org_id +LIMIT 1 +ON DUPLICATE KEY UPDATE org_id=VALUES(org_id); + +-- CONSULTANT +INSERT INTO global_default_roles (id, role, position, org_id) +SELECT 1, 'CONSULTANT', 1, org_id +FROM organizations +-- WHERE primary_role='CONSULTANT' +WHERE role_id = 3 +ORDER BY org_id +LIMIT 1 +ON DUPLICATE KEY UPDATE org_id=VALUES(org_id); + +-- 1.2 correspondence_status_transitions Table: เพิ่ม “ตาราง/วิว Allowed Status Transition” เพื่อตรวจ business rule บน +-- sp_correspondence_update_status (ยังทำแบบ soft rule ใน proc) +-- NEW: table of allowed transitions (per type) +DROP TABLE IF EXISTS correspondence_status_transitions; +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(type_id), + CONSTRAINT fk_cst_from FOREIGN KEY (from_status_id) REFERENCES correspondence_status(status_id), + CONSTRAINT fk_cst_to FOREIGN KEY (to_status_id) REFERENCES correspondence_status(status_id) +) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_general_ci COMMENT='ตารางเก็บสถานะที่อนุญาตให้เปลี่ยนแปลงได้ของหนังสือแต่ละประเภท'; + +-- 1.3 circulation_assignees Table: ตารางสำหรับระบุผู้รับผิดชอบใน Circulation Sheet แต่ละใบ +CREATE TABLE circulation_assignees ( + assignee_id INT NOT NULL AUTO_INCREMENT PRIMARY KEY COMMENT 'ID ของรายการ', + cir_id INT NOT NULL COMMENT 'ID ของใบเวียน (จากตาราง circulations)', + user_id INT NOT NULL COMMENT 'ID ของผู้ใช้ที่รับผิดชอบ', + assignee_type ENUM('MAIN', 'ACTION', 'INFO') NOT NULL COMMENT 'ประเภทผู้รับผิดชอบ', + deadline DATE NULL COMMENT 'กำหนดวันแล้วเสร็จ (สำหรับ Main/Action)', + action_taken TEXT NULL COMMENT 'หมายเหตุการดำเนินการ', + is_completed BOOLEAN NOT NULL DEFAULT FALSE COMMENT 'สถานะการดำเนินการ', + completed_at TIMESTAMP NULL COMMENT 'เวลาที่ดำเนินการเสร็จ', + completed_by_user_id INT NULL COMMENT 'ID ของผู้ใช้ที่ดำเนินการเสร็จ', + UNIQUE KEY ux_cir_user_type (cir_id, user_id, assignee_type), + CONSTRAINT fk_ca_cir FOREIGN KEY (cir_id) REFERENCES circulations(cir_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.4 cir_recipients Table: ตารางสำหรับเก็บรายชื่อผู้รับในใบเวียน (เพิ่มเติมจาก assignees) +CREATE TABLE cir_recipients ( + recipient_id INT NOT NULL AUTO_INCREMENT PRIMARY KEY COMMENT 'ID ของรายการ', + cir_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 (cir_id, user_id, recipient_role), + -- Foreign Keys + CONSTRAINT fk_cir_recipients_circulation FOREIGN KEY (cir_id) REFERENCES circulations(cir_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.5 attachments Table: ตารางสำหรับเก็บ Metadata ของไฟล์แนบทั้งหมดในระบบ +CREATE TABLE attachments ( + attachment_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(corr_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='ตารางกลางสำหรับเก็บข้อมูลไฟล์แนบ'; + +-- 1.6 cir_actions Table: ตารางสำหรับบันทึกประวัติการดำเนินการในใบเวียน +CREATE TABLE cir_actions ( + action_id INT NOT NULL AUTO_INCREMENT PRIMARY KEY COMMENT 'ID ของการกระทำ', + cir_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 (cir_id) REFERENCES circulations(cir_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.7 cir_action_documents Table: ตารางเชื่อมระหว่างการดำเนินการและไฟล์แนบ +CREATE TABLE cir_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 cir_actions(action_id) ON DELETE CASCADE, + CONSTRAINT fk_cad_attachment FOREIGN KEY (attachment_id) REFERENCES attachments(attachment_id) ON DELETE CASCADE +) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_general_ci COMMENT='ตารางเชื่อมไฟล์แนบกับการดำเนินการในใบเวียน'; + +-- 1.8 circulation_template_assignees Table: ตารางสำหรับเก็บรายชื่อผู้รับผิดชอบในแต่ละแม่แบบ +CREATE TABLE circulation_template_assignees ( + assignee_template_id INT NOT NULL AUTO_INCREMENT 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 'บทบาทของผู้ใช้ในแม่แบบนี้', + + PRIMARY KEY (assignee_template_id), + + -- ป้องกันการกำหนด 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(template_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 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_dwg_subcat_cat_map ( + project_id INT NOT NULL COMMENT 'รหัสโปรเจกต์', + sub_cat_id INT NOT NULL COMMENT 'รหัสหมวดหมู่ย่อย', + cat_id INT NOT NULL COMMENT 'รหัสหมวดหมู่หลัก', + + 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_dwg_sub_cat (project_id, sub_cat_id) + ON UPDATE CASCADE ON DELETE CASCADE, + + CONSTRAINT fk_map_cat + FOREIGN KEY (project_id, cat_id) + REFERENCES contract_dwg_cat (project_id, cat_id) + ON UPDATE CASCADE ON DELETE CASCADE +) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_general_ci COMMENT='ตารางแมปความสัมพันธ์ระหว่างหมวดหมู่ย่อยและหมวดหมู่หลักของ Drawing'; + +-- 1.10 shop_drawing_revisions Table: ตารางสำหรับเก็บประวัติการแก้ไข (Revision) ของ Shop Drawing +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 VARCHAR(10) NOT NULL COMMENT 'หมายเลข Revision (เช่น A, B, 0, 1)', + 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 'วันที่สร้าง', + + 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='ประวัติการแก้ไขของ Shop Drawing'; + +-- 1.11 technicaldoc_workflow_template_steps Table: ตารางสำหรับเก็บขั้นตอนของแต่ละแม่แบบ +CREATE TABLE technicaldoc_workflow_template_steps ( + step_id INT NOT NULL AUTO_INCREMENT PRIMARY KEY COMMENT 'ID ของขั้นตอน', + template_id INT NOT NULL COMMENT 'ID ของแม่แบบ', + sequence INT NOT NULL COMMENT 'ลำดับขั้นตอน', + org_id INT NOT NULL COMMENT 'ID องค์กรที่ต้องพิจารณาในขั้นตอนนี้', + step_purpose ENUM('FOR_APPROVAL', 'FOR_REVIEW', 'FOR_INFORMATION') NOT NULL DEFAULT 'FOR_APPROVAL' COMMENT 'วัตถุประสงค์ของขั้นตอนนี้ เช่น เพื่ออนุมัติ, เพื่อตรวจสอบ, หรือเพื่อรับทราบ', + + UNIQUE KEY ux_template_sequence (template_id, sequence), + CONSTRAINT fk_wts_template FOREIGN KEY (template_id) REFERENCES technicaldoc_workflow_templates(template_id) ON DELETE CASCADE, + CONSTRAINT fk_wts_org FOREIGN KEY (org_id) REFERENCES organizations(org_id) ON DELETE CASCADE +) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_general_ci COMMENT='ขั้นตอนในแม่แบบ Workflow ของเอกสาร Technical'; + +-- 1.12 technicaldoc_workflows Table: ตารางสำหรับติดตามสถานะ Workflow ของเอกสาร Technical (RFA) +CREATE TABLE technicaldoc_workflows ( + workflow_id INT NOT NULL AUTO_INCREMENT PRIMARY KEY COMMENT 'ID ของขั้นตอน', + correspondence_id INT NOT NULL COMMENT 'ID ของเอกสาร Technical', + sequence INT NOT NULL COMMENT 'ลำดับขั้นตอน', + org_id INT NOT NULL COMMENT 'ID ขององค์กรที่ต้องพิจารณาในขั้นตอนนี้', + status ENUM('PENDING', 'APPROVED', 'REJECTED', 'APPROVED_WITH_COMMENTS', 'FORWARDED', 'RETURNED') NOT NULL DEFAULT 'PENDING' COMMENT 'สถานะของขั้นตอนนี้', + comments TEXT 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), + CONSTRAINT fk_tdw_correspondence FOREIGN KEY (correspondence_id) REFERENCES correspondences(corr_id) ON DELETE CASCADE, + CONSTRAINT fk_tdw_org FOREIGN KEY (org_id) REFERENCES organizations(org_id), + CONSTRAINT fk_tdw_user FOREIGN KEY (processed_by_user_id) REFERENCES users(user_id) +) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_general_ci COMMENT='ตารางติดตามสถานะ Workflow ของเอกสาร Technical'; + +-- 1.13 transmittal_items Table: ตารางสำหรับเก็บรายการเอกสารที่ถูกส่งใน Transmittal แต่ละฉบับ +CREATE TABLE transmittal_items ( + item_id INT NOT NULL AUTO_INCREMENT PRIMARY KEY COMMENT 'ID ของรายการ', + transmittal_id INT NOT NULL COMMENT 'ID ของ Transmittal (จากตาราง transmittals)', + technical_doc_id INT NOT NULL COMMENT 'ID ของเอกสารทางเทคนิคที่แนบไป', + quantity INT NOT NULL DEFAULT 1 COMMENT 'จำนวน', + remarks VARCHAR(255) COMMENT 'หมายเหตุสำหรับรายการนี้', + + -- ป้องกันการเพิ่มเอกสารเดิมซ้ำใน Transmittal ฉบับเดียวกัน + UNIQUE KEY ux_transmittal_item (transmittal_id, technical_doc_id), + + -- Foreign Keys + CONSTRAINT fk_ti_transmittal FOREIGN KEY (transmittal_id) REFERENCES transmittals(corr_id) ON DELETE CASCADE, + CONSTRAINT fk_ti_technical_doc FOREIGN KEY (technical_doc_id) REFERENCES technicaldocs(id) ON DELETE CASCADE +) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_general_ci COMMENT='รายการเอกสารที่แนบใน Transmittal'; + +-- 1.14 rfa_items Table: RFA ↔ TechnicalDocs (RFA เป็นชนิดหนึ่งของ correspondences) +CREATE TABLE rfa_items ( + rfa_corr_id INT NOT NULL COMMENT 'ID ของเอกสาร RFA (จากตาราง correspondences)', -- FK to correspondences.corr_id (type=RFA) + technical_doc_id INT NOT NULL UNIQUE COMMENT 'ID ของเอกสารทางเทคนิคที่เกี่ยวข้อง', -- one techdoc appears in at most one RFA + PRIMARY KEY (rfa_corr_id, technical_doc_id), + CONSTRAINT fk_rfa_corr FOREIGN KEY (rfa_corr_id) REFERENCES correspondences(corr_id) ON UPDATE CASCADE ON DELETE CASCADE, + CONSTRAINT fk_rfa_tech FOREIGN KEY (technical_doc_id) REFERENCES technicaldocs(id) ON UPDATE CASCADE ON DELETE CASCADE +) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_general_ci COMMENT='ตารางเชื่อมระหว่าง RFA และเอกสารทางเทคนิค'; + +CREATE INDEX idx_rfaitems_rfa ON rfa_items(rfa_corr_id); +CREATE INDEX idx_rfaitems_techdoc ON rfa_items(technical_doc_id); + +-- 1.15 correspondence_routing_template_steps Table: ตารางสำหรับเก็บขั้นตอนของแต่ละแม่แบบ +CREATE TABLE correspondence_routing_template_steps ( + step_id INT NOT NULL AUTO_INCREMENT PRIMARY KEY COMMENT 'ID ของขั้นตอน', + template_id INT NOT NULL COMMENT 'ID ของแม่แบบ', + sequence INT NOT NULL COMMENT 'ลำดับขั้นตอน', + to_org_id INT NOT NULL COMMENT 'ID องค์กรผู้รับในขั้นตอนนี้', + step_purpose ENUM('FOR_APPROVAL', 'FOR_REVIEW', 'FOR_INFORMATION') NOT NULL DEFAULT 'FOR_REVIEW' COMMENT 'วัตถุประสงค์ของขั้นตอนนี้', + + UNIQUE KEY ux_routing_template_sequence (template_id, sequence), + CONSTRAINT fk_crts_template FOREIGN KEY (template_id) REFERENCES correspondence_routing_templates(template_id) ON DELETE CASCADE, + CONSTRAINT fk_crts_org FOREIGN KEY (to_org_id) REFERENCES organizations(org_id) ON DELETE CASCADE +) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_general_ci COMMENT='ขั้นตอนในแม่แบบการส่งต่อเอกสาร'; + +-- 1.16 correspondence_routing_steps Table: ตารางสำหรับติดตามขั้นตอนการส่งต่อเอกสารทั่วไป +CREATE TABLE correspondence_routing_steps ( + routing_step_id INT NOT NULL AUTO_INCREMENT PRIMARY KEY COMMENT 'ID ของขั้นตอน', + correspondence_id INT NOT NULL COMMENT 'ID ของเอกสารที่ถูกส่งต่อ', + -- [ปรับปรุง] เพิ่มคอลัมน์สำหรับอ้างอิงถึงแม่แบบ + template_id INT NULL COMMENT 'ID ของแม่แบบที่ใช้ (ถ้ามี)', + sequence INT NOT NULL COMMENT 'ลำดับของขั้นตอนการส่งต่อ', + from_org_id INT NOT NULL COMMENT 'ID ขององค์กรผู้ส่ง', + to_org_id INT NOT NULL COMMENT 'ID ขององค์กรผู้รับ', + step_purpose ENUM('FOR_APPROVAL', 'FOR_REVIEW', 'FOR_INFORMATION') NOT NULL DEFAULT 'FOR_REVIEW' COMMENT 'วัตถุประสงค์ของขั้นตอนนี้ เช่น เพื่ออนุมัติ, เพื่อตรวจสอบ, หรือเพื่อรับทราบ', + status ENUM('SENT', 'RECEIVED', 'ACTIONED', 'FORWARDED', 'REPLIED') NOT NULL DEFAULT 'SENT' COMMENT 'สถานะการดำเนินการของเอกสารในขั้นตอนนี้', + comments TEXT 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_corr_routing_sequence (correspondence_id, sequence), + -- Foreign Keys + CONSTRAINT fk_crs_correspondence FOREIGN KEY (correspondence_id) REFERENCES correspondences(corr_id) ON DELETE CASCADE, + -- หมายเหตุ: Script สำหรับสร้างตาราง correspondence_routing_templates ต้องถูกรันก่อนไฟล์นี้ + CONSTRAINT fk_crs_template FOREIGN KEY (template_id) REFERENCES correspondence_routing_templates(template_id) ON DELETE SET NULL, + CONSTRAINT fk_crs_from_org FOREIGN KEY (from_org_id) REFERENCES organizations(org_id) ON DELETE CASCADE, + CONSTRAINT fk_crs_to_org FOREIGN KEY (to_org_id) REFERENCES organizations(org_id) ON DELETE CASCADE, + CONSTRAINT fk_crs_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 correspondence_cc_recipients Table: CC recipients (org-level) +CREATE TABLE correspondence_cc_recipients ( + corr_id INT NOT NULL COMMENT 'ID ของเอกสาร', + org_id INT NOT NULL COMMENT 'ID ขององค์กรที่ได้รับสำเนา', + PRIMARY KEY (corr_id, org_id), + CONSTRAINT fk_cc_cor FOREIGN KEY (corr_id) REFERENCES correspondences(corr_id) ON UPDATE CASCADE ON DELETE CASCADE, + CONSTRAINT fk_cc_org FOREIGN KEY (org_id) REFERENCES organizations(org_id) ON UPDATE CASCADE ON DELETE RESTRICT +) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_general_ci COMMENT='ตารางเก็บรายชื่อองค์กรที่ได้รับสำเนาเอกสาร'; + +-- 1.18 correspondence_references Table: cross references between correspondences +CREATE TABLE correspondence_references ( + src_corr_id INT NOT NULL COMMENT 'ID ของเอกสารต้นทาง', + tgt_corr_id INT NOT NULL COMMENT 'ID ของเอกสารปลายทาง', + PRIMARY KEY (src_corr_id, tgt_corr_id), + CONSTRAINT fk_ref_src FOREIGN KEY (src_corr_id) REFERENCES correspondences(corr_id) ON UPDATE CASCADE ON DELETE CASCADE, + CONSTRAINT fk_ref_tgt FOREIGN KEY (tgt_corr_id) REFERENCES correspondences(corr_id) ON UPDATE CASCADE ON DELETE CASCADE +) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_general_ci COMMENT='ตารางเก็บความสัมพันธ์อ้างอิงระหว่างเอกสาร'; + +-- 1.19 project_parties Table: enforce <=1 contractor per project via generated column + unique index +CREATE TABLE project_parties ( + project_id INT NOT NULL COMMENT 'ID ของโปรเจกต์', + org_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 'คอลัมน์สร้างเพื่อบังคับบทบาท CONTRACTOR', + PRIMARY KEY (project_id, org_id, role), + UNIQUE KEY uq_project_parties_contractor (project_id, is_contractor), + CONSTRAINT fk_pp_project FOREIGN KEY (project_id) REFERENCES projects(project_id) ON DELETE CASCADE ON UPDATE CASCADE, + CONSTRAINT fk_pp_org FOREIGN KEY (org_id) REFERENCES organizations(org_id) ON DELETE RESTRICT ON UPDATE CASCADE + ) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_general_ci COMMENT='ตารางเก็บข้อมูลบทบาทขององค์กรในโปรเจกต์'; + +INSERT INTO project_parties (`project_id`, `org_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.20 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 ของโปรเจกต์', + org_id INT NOT NULL COMMENT 'ID ขององค์กร', + PRIMARY KEY (contract_id, project_id, org_id), + CONSTRAINT fk_cp_contract FOREIGN KEY (contract_id) REFERENCES contracts(contract_id) ON DELETE CASCADE ON UPDATE CASCADE, + CONSTRAINT fk_cp_project FOREIGN KEY (project_id) REFERENCES projects(project_id) ON DELETE CASCADE ON UPDATE CASCADE, + CONSTRAINT fk_cp_org FOREIGN KEY (org_id) REFERENCES organizations(org_id) ON DELETE CASCADE ON UPDATE CASCADE +) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_general_ci COMMENT='ตารางเชื่อมระหว่างสัญญา โปรเจกต์ และองค์กร'; + +INSERT INTO contract_parties (org_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), (41, 3, 4), (41, 4, 5), (41, 5, 6); + +-- 1.21 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='ตารางเชื่อมระหว่างบทบาทและสิทธิ์การใช้งาน'; + +-- xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx +-- SUPER_ADMIN: all permissions (disambiguated columns with aliases) +INSERT IGNORE INTO role_permissions (role_id, permission_id) +SELECT r.role_id, p.permission_id +FROM roles AS r +CROSS JOIN permissions AS p +WHERE r.role_code='SUPER_ADMIN'; + +-- ADMIN: all except superadmin.access (scope enforced app-side) +INSERT IGNORE INTO role_permissions (role_id, permission_id) +SELECT r.role_id, p.permission_id +FROM roles AS r +JOIN permissions AS p ON p.permission_code <> 'superadmin.access' +WHERE r.role_code='ADMIN'; + +-- EDITOR: operational set +INSERT IGNORE INTO role_permissions (role_id, permission_id) +SELECT r.role_id, p.permission_id +FROM roles AS r +JOIN permissions AS p ON p.permission_code IN ( + 'projects.view','project_parties.manage', + 'drawings.view','drawings.upload', + 'documents.view','documents.manage', + 'materials.view','materials.manage', + 'ms.view','ms.manage', + 'rfas.view','rfas.create','rfas.respond', + 'corr.view','corr.manage', + 'transmittals.manage','reports.view' +) +WHERE r.role_code='EDITOR'; + +-- VIEWER: read-only set +INSERT IGNORE INTO role_permissions (role_id, permission_id) +SELECT r.role_id, p.permission_id +FROM roles AS r +JOIN permissions AS p ON p.permission_code IN ( + 'projects.view','organizations.view','drawings.view','documents.view','materials.view','ms.view','rfas.view','corr.view','reports.view' +) +WHERE r.role_code='VIEWER'; + +-- 1.22 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='ตารางเชื่อมระหว่างผู้ใช้และบทบาท'; + +-- 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.23 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(project_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='ตารางเชื่อมระหว่างผู้ใช้ โปรเจกต์ และบทบาท'; + +-- Sample seed for user_project_roles (assign superadmin as EDITOR in project LCBP3C1) +INSERT IGNORE INTO user_project_roles (user_id, project_id, role_id) +SELECT u.user_id, p.project_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='superadmin'; + +-- Sample seed for user_project_roles (assign superadmin as VIEWER in project LCBP3C2) +INSERT IGNORE INTO user_project_roles (user_id, project_id, role_id) +SELECT u.user_id, p.project_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='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.project_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 viewer01 as VIEWER in project LCBP3C2 +INSERT IGNORE INTO user_project_roles (user_id, project_id, role_id) +SELECT u.user_id, p.project_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.24 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 'ประเภทของการกระทำ', -- e.g., login.success, rfa.create + entity_type VARCHAR(50) NULL COMMENT 'ประเภทของข้อมูลที่ถูกกระทำ', -- table/model name + entity_id VARCHAR(50) NULL COMMENT 'ID ของข้อมูลที่ถูกกระทำ', -- primary key value + details_json JSON NULL COMMENT 'รายละเอียดเพิ่มเติมในรูปแบบ JSON', + ip_address VARCHAR(45) NULL COMMENT 'ที่อยู่ IP ของผู้ใช้', + user_agent VARCHAR(255) NULL COMMENT 'User-Agent ของเบราว์เซอร์', + created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP 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); + +SET FOREIGN_KEY_CHECKS=1; \ No newline at end of file diff --git a/docs/SQL/01_dms_v1_0_0.sql b/docs/SQL/01_dms_v1_0_0.sql new file mode 100644 index 0000000..4958989 --- /dev/null +++ b/docs/SQL/01_dms_v1_0_0.sql @@ -0,0 +1,1565 @@ +-- ========================================================== +-- DMS v1.0.2 Correspondence Improvements +-- Database v1.0 - 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.0.0 Initial Schema +-- DMS v1.0.1 Add missing relationship for Req 2.5.3, +-- Update: shop_drawing_revision_contract_refs Changed link to revision-level instead of master-level based on clarification. +-- DMS v1.0.2 Correspondence Improvements +-- Update: +-- 1. (Files) Consolidate file management: +-- - DROPs `pdf_path` from `correspondences` +-- - ADDs `is_main_document` to `attachments` +-- 2. (Recipients) Make recipients more flexible: +-- - DROPs `recipient_id` from `correspondences` +-- - DROPs `correspondence_cc_recipients` table +-- - CREATES `correspondence_recipients` (M:N table with TO/CC type) +-- 3. (Search) Remove keyword redundancy: +-- - DROPs `keywords` from `correspondences` (use `tags` system instead) +-- 4. (Change) corr_id -> correspondence_id for consistency +-- 5. (Change) revision VARCHAR(50) NULL in correspondences to support alphanumeric revisions รูปแบบ (A-Z?) → ตัวอักษร A-Z ตามด้วยตัวเลข 0 ตัวหรือมากกว่า (เช่น A, A1, B10), ตัวเลขล้วน หรือ ตัวเลขทศนิยม (เช่น 1, 2.1, 10.5) +-- 6. (Change) Changed tecnicaldoc to rfa (Requested_for_Approval) +-- ========================================================== + +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; + +-- 1.12.3 +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; + +-- 1.2 +DROP TABLE IF EXISTS attachments; + +-- 1.1 +DROP TABLE IF EXISTS global_default_roles; + + +-- 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 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; + +-- Views +DROP VIEW IF EXISTS v_current_correspondences; + +-- Procedure +DROP PROCEDURE IF EXISTS sp_create_correspondence_revision; + +-- เปิดการตรวจสอบ Foreign Key กลับมาเหมือนเดิม +-- SET FOREIGN_KEY_CHECKS=1; + +-- ========================================================== +-- Table Creation +-- ========================================================== +-- Level 5: Organizations +-- ========================================================== +-- 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='Organizations Table'; +-- 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 role +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), + ('EDITOR', 'Editor', 'Can create/edit RFA/Drawings/Docs/Transmittals' ,1), + ('VIEWER', 'Viewer', 'Read-only access' ,0), + ('GUEST', 'Guest', 'Limited read-only access' ,0) +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'; +-- Seed permission +INSERT INTO permissions (permission_code, description, module, scope_level) VALUES + -- System + ('superadmin.access','Access Everything (All Orgs)','admin','GLOBAL'), + ('admin.access','Access Admin Panel (scoped)','admin','ORG'), + ('settings.manage','Manage Settings','admin','GLOBAL'), + -- Projects & Parties + ('projects.view','View Projects','projects','ORG'), + ('projects.manage','Create/Edit/Delete Projects','projects','ORG'), + ('project_parties.manage','Manage Project Parties','projects','ORG'), + -- Organizations + ('organizations.view','View Organizations','organizations','GLOBAL'), + ('organizations.manage','Manage Organizations','organizations','GLOBAL'), + -- Drawings + ('drawings.view','View Drawings','drawings','PROJECT'), + ('drawings.upload','Upload Drawing Revisions','drawings','PROJECT'), + ('drawings.delete','Delete Drawings/Revisions','drawings','PROJECT'), + -- Documents/Materials/MS + ('documents.view','View Documents','documents','PROJECT'), + ('documents.manage','Manage Documents/Revisions','documents','PROJECT'), + ('materials.view','View Materials','materials','PROJECT'), + ('materials.manage','Manage Materials/Revisions','materials','PROJECT'), + ('ms.view','View Method Statements','ms','PROJECT'), + ('ms.manage','Manage Method Statements/Revisions','ms','PROJECT'), + -- RFAs + ('rfas.view','View RFAs','rfas','PROJECT'), + ('rfas.create','Create RFA','rfas','PROJECT'), + ('rfas.respond','Respond / Update RFA','rfas','PROJECT'), + ('rfas.delete','Delete RFA','rfas','PROJECT'), + -- Correspondence & Transmittal & Circulation + ('corr.view','View Correspondences','correspondence','PROJECT'), + ('corr.manage','Manage Correspondences','correspondence','PROJECT'), + ('transmittals.manage','Manage Transmittals','transmittal','PROJECT'), + ('cirs.manage','Manage Circulations','circulation','ORG'), + -- Reports + ('reports.view','View Reports','reports','GLOBAL') +ON DUPLICATE KEY UPDATE + description=VALUES(description), + module=VALUES(module), + scope_level=VALUES(scope_level), + is_active=1; + +-- 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) VALUES + ('LCBP3','โครงการพัฒนาท่าเรือแหลมฉบัง ระยะที่ 3 (ส่วนที่ 1-4)'), + ('LCBP3C1','โครงการพัฒนาท่าเรือแหลมฉบัง ระยะที่ 3 (ส่วนที่ 1) งานก่อสร้างงานทางทะเล'), + ('LCBP3C2','โครงการพัฒนาท่าเรือแหลมฉบัง ระยะที่ 3 (ส่วนที่ 2) งานก่อสร้างอาคาร ท่าเทียบเรือ ระบบถนน และระบบสาธารณูปโภค'), + ('LCBP3C3','โครงการพัฒนาท่าเรือแหลมฉบัง ระยะที่ 3 (ส่วนที่ 3) งานก่อสร้าง'), + ('LCBP3C4','โครงการพัฒนาท่าเรือแหลมฉบัง ระยะที่ 3 (ส่วนที่ 4) งานก่อสร้าง'); + +-- 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); + +-- ========================================================== +-- 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 + + 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_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 cir_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 VARCHAR(50) NOT NULL COMMENT 'หมายเลข revision (e.g., A, B, 1, 2.1)', + 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 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 'วันที่แก้ไขล่าสุด', + + 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 'วันที่แก้ไขล่าสุด', + + 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 +CREATE TABLE rfa_revisions ( + -- Primary Key & One-to-One with correspondences + correspondence_id INT NOT NULL PRIMARY KEY 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_codes_id INT NOT NULL COMMENT 'รรหัสสถานะเอกสาร (FK → rfa_status_codes.id)', + rfa_approve_codes_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)', + + 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)), + CONSTRAINT chk_issued_after_created + CHECK (issued_date IS NULL OR created_at IS NULL OR issued_date >= DATE(created_at)), + CONSTRAINT chk_received_after_created + CHECK (received_date IS NULL OR created_at IS NULL OR received_date >= created_at), + + -- 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_codes_id) + REFERENCES rfa_status_codes(id), + CONSTRAINT fk_rr_approve FOREIGN KEY (rfa_approve_codes_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'; + +-- 2.9.1 correspondence_revisions Table: ตารางสำหรับเก็บประวัติการแก้ไขเอกสาร (Revision History) +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 PRIMARY KEY 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_statuss_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 'ผู้แก้ไขล่าสุด', + + 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_due_after_received CHECK (due_date IS NULL OR received_date IS NULL OR due_date >= received_date), + CONSTRAINT + 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_submitted CHECK (approved_date IS NULL OR submitted_date IS NULL OR approved_date >= submitted_date), + CONSTRAINT chk_submitted_after_created CHECK (submitted_date IS NULL OR created_at IS NULL + OR submitted_date >= DATE(created_at)), + CONSTRAINT chk_received_after_created CHECK (received_date IS NULL OR created_at IS NULL OR + received_date >= created_at), + CONSTRAINT chk_updated_by_diff_created_by CHECK (updated_by IS NULL OR updated_by <> created_by), + + -- 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 +) 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); + +-- 2.10.3 circulation_templates Table +CREATE TABLE circulation_templates ( + id INT NOT NULL AUTO_INCREMENT CHARACTERPRIMARY 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 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 ON UPDATE COMMENT 'วันที่สร้าง', + updated_at TIMESTAMP NOT NULL DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP COMMENT 'วันที่แก้ไขล่าสุด', + PRIMARY KEY (template_id), + UNIQUE KEY ux_workflow_template_name_project (template_name, project_id), + 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='แม่แบบสายงานการส่งต่อเอกสารขออนุมัติ'; + + +-- ========================================================== +-- 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, organization_id +FROM ( + SELECT organization_id, ROW_NUMBER() OVER (ORDER BY organization_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, organization_id +FROM organizations +-- WHERE primary_role='DESIGNER' +WHERE role_id = 2 +ORDER BY organization_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, organization_id +FROM organizations +-- WHERE primary_role='CONSULTANT' +WHERE role_id = 3 +ORDER BY organization_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='ตารางกลางสำหรับเก็บข้อมูลไฟล์แนบ'; + +/* =========================================================== + 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_dwg_sub_cat (project_id, sub_cat_id) ON UPDATE CASCADE ON DELETE CASCADE, + CONSTRAINT fk_map_cat FOREIGN KEY (project_id, cat_id) REFERENCES contract_dwg_cat (project_id, cat_id) ON UPDATE CASCADE ON DELETE CASCADE +) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_general_ci COMMENT='ตารางเชื่อมระหว่างหมวดหมู่ย่อยและหมวดหมู่หลักของแบบสัญญา'; + +CREATE INDEX idx_sdr_shop_drawing ON shop_drawing_revisions(shop_drawing_id); + +-- 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 VARCHAR(10) NOT NULL COMMENT 'หมายเลข Revision (เช่น A, B, 0, 1)', + 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 'วันที่สร้าง', + + 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'; + +-- สร้างตารางเชื่อมระหว่าง 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(condwg_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)', + technical_rfarev_id INT NOT NULL COMMENT 'ID ของเอกสารทางเทคนิคที่แนบไป', + quantity INT NOT NULL DEFAULT 1 COMMENT 'จำนวน', + remarks VARCHAR(255) COMMENT 'หมายเหตุสำหรับรายการนี้', + + -- ป้องกันการเพิ่มเอกสารเดิมซ้ำใน Transmittal ฉบับเดียวกัน + UNIQUE KEY ux_transmittal_item (transmittal_id, technical_rfarev_id), + + -- Foreign Keys + CONSTRAINT fk_ti_transmittal FOREIGN KEY (transmittal_id) REFERENCES transmittals(correspondence_id) ON DELETE CASCADE, + CONSTRAINT fk_ti_technical_doc FOREIGN KEY (technical_rfarev_id) REFERENCES rfa_revisions(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 cir_status_codes(code), + CONSTRAINT fk_cstt_to FOREIGN KEY (to_status_code) REFERENCES cir_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 ของผู้รับผิดชอบ', + circulations_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 TIMESTAMP NULL COMMENT 'เวลาที่ดำเนินการเสร็จสิ้น', + + UNIQUE KEY ux_cir_assignee (cir_id, user_id, assignee_type), + CONSTRAINT fk_ca_assignee_circulation FOREIGN KEY (circulations_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 ของรายการ', + circulations_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 (cir_id, user_id, recipient_role), + + -- Foreign Keys + CONSTRAINT fk_cir_recipients_circulation FOREIGN KEY (circulations_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 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(template_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 -> correspondences)', + 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 'ความคิดเห็นหรือหมายเหตุจากองค์กร', + 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_correspondence FOREIGN KEY (correspondence_id) REFERENCES correspondences(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(status_id), + CONSTRAINT fk_cst_to FOREIGN KEY (to_status_id) REFERENCES correspondence_status(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(template_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 -> correspondences)', + 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 'หมายเหตุ หรือความคิดเห็นในการส่งต่อ', + 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 correspondences(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 การส่งต่อเอกสารทั่วไป'; + +-- 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_cr_correspondence FOREIGN KEY (correspondence_id) REFERENCES correspondences(id) ON DELETE CASCADE ON UPDATE CASCADE, + CONSTRAINT fk_cr_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 UPDATE CASCADE ON DELETE CASCADE, + CONSTRAINT fk_ref_tgt FOREIGN KEY (tgt_correspondence_id) REFERENCES correspondences(id) ON UPDATE CASCADE ON DELETE 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, + 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), (41, 3, 4), (41, 4, 5), (41, 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)'; + +-- xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx +-- SUPER_ADMIN: all permissions (disambiguated columns with aliases) +INSERT IGNORE INTO role_permissions (role_id, permission_id) +SELECT r.role_id, p.permission_id +FROM roles AS r +CROSS JOIN permissions AS p +WHERE r.role_code='SUPER_ADMIN'; + +-- ADMIN: all except superadmin.access (scope enforced app-side) +INSERT IGNORE INTO role_permissions (role_id, permission_id) +SELECT r.role_id, p.permission_id +FROM roles AS r +JOIN permissions AS p ON p.permission_code <> 'superadmin.access' +WHERE r.role_code='ADMIN'; + +-- EDITOR: operational set +INSERT IGNORE INTO role_permissions (role_id, permission_id) +SELECT r.role_id, p.permission_id +FROM roles AS r +JOIN permissions AS p ON p.permission_code IN ( + 'projects.view','project_parties.manage', + 'drawings.view','drawings.upload', + 'documents.view','documents.manage', + 'materials.view','materials.manage', + 'ms.view','ms.manage', + 'rfas.view','rfas.create','rfas.respond', + 'corr.view','corr.manage', + 'transmittals.manage','reports.view' +) +WHERE r.role_code='EDITOR'; + +-- VIEWER: read-only set +INSERT IGNORE INTO role_permissions (role_id, permission_id) +SELECT r.role_id, p.permission_id +FROM roles AS r +JOIN permissions AS p ON p.permission_code IN ( + 'projects.view','organizations.view','drawings.view','documents.view','materials.view','ms.view','rfas.view','corr.view','reports.view' +) +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(project_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 as EDITOR in project LCBP3C1) +INSERT IGNORE INTO user_project_roles (user_id, project_id, role_id) +SELECT u.user_id, p.project_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='superadmin'; + +-- Sample seed for user_project_roles (assign superadmin as VIEWER in project LCBP3C2) +INSERT IGNORE INTO user_project_roles (user_id, project_id, role_id) +SELECT u.user_id, p.project_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='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.project_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 viewer01 as VIEWER in project LCBP3C2 +INSERT IGNORE INTO user_project_roles (user_id, project_id, role_id) +SELECT u.user_id, p.project_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 + Current Revision) +CREATE VIEW v_current_correspondences AS +SELECT + co.correspondence_id, + co.correspondence_number, + co.project_id, + co.correspondence_type_id, + cr.correspondence_revision_id, + cr.revision_number, + cr.revision_label, + cr.correspondence_status_id, + cr.title, + cr.keywords, + co.originator_id, + co.recipient_id, + cr.issued_date, + -- cr.pdf_path, + cr.details, + co.created_at AS correspondence_created_at, + cr.created_at AS revision_created_at, + co.latest_revision_number +FROM correspondences co +INNER JOIN correspondence_revisions cr + ON co.current_revision_id = cr.correspondence_revision_id +WHERE co.deleted_at IS NULL; + +-- ========================================================== +-- Procedure Creation +-- ========================================================== +-- P.1. Stored Procedure สำหรับสร้าง Revision ใหม่ +DELIMITER $$ + +CREATE PROCEDURE sp_create_correspondence_revision( + IN p_correspondence_id INT, + IN p_title VARCHAR(255), + IN p_originator_id INT, + IN p_recipient_id INT, + IN p_status_id INT, + IN p_created_by INT, + IN p_change_reason TEXT, + OUT p_revision_id INT +) +BEGIN + DECLARE v_next_revision_number INT; + DECLARE v_revision_label VARCHAR(10); + DECLARE v_correspondence_type_id INT; + + -- Get correspondence_type + SELECT correspondence_type_id + INTO v_correspondence_type_id + FROM correspondences + WHERE correspondence_id = p_correspondence_id; + + -- Get next revision number + SELECT COALESCE(MAX(revision_number), 0) + 1 + INTO v_next_revision_number + FROM correspondence_revisions + WHERE correspondence_id = p_correspondence_id; + + -- Generate label (A, B, C... or 0, 1, 2...) + IF v_correspondence_type_id = 1 THEN + IF v_next_revision_number = 0 THEN + SET v_revision_label = 'A'; + ELSE + SET v_revision_label = CHAR(65 + v_next_revision_number); -- B, C, D... + END IF; + ELSE + SET v_revision_label = CHAR(v_next_revision_number); + END IF; + + -- Mark all previous revisions as not current + UPDATE correspondence_revisions + SET is_current = FALSE + WHERE correspondence_id = p_correspondence_id; + + -- Insert new revision + INSERT INTO correspondence_revisions ( + correspondence_id, revision_number, revision_label, + correspondence_status_id, is_current, + title, originator_id, recipient_id, + created_by, change_reason + ) VALUES ( + p_correspondence_id, v_next_revision_number, v_revision_label, + p_status_id, TRUE, + p_title, p_originator_id, p_recipient_id, + p_created_by, p_change_reason + ); + + SET p_revision_id = LAST_INSERT_ID(); + + -- Update master + UPDATE correspondence_master + SET + current_revision_id = p_revision_id, + latest_revision_number = v_next_revision_number + WHERE correspondence_id = p_correspondence_id; +END$$ + +DELIMITER ; + +SET FOREIGN_KEY_CHECKS=1; \ No newline at end of file diff --git a/docs/SQL/01_dms_v1_0_0_patch.sql b/docs/SQL/01_dms_v1_0_0_patch.sql new file mode 100644 index 0000000..1b339ef --- /dev/null +++ b/docs/SQL/01_dms_v1_0_0_patch.sql @@ -0,0 +1,40 @@ +-- ========================================================== +-- DMS v1.0.1 Patch +-- Reason: Add missing relationship for Req 2.5.3 +-- Update: Changed link to revision-level instead of master-level based on clarification. +-- ========================================================== + +SET NAMES utf8mb4; +SET time_zone = '+07:00'; +SET FOREIGN_KEY_CHECKS=1; + +-- สร้างตารางเชื่อมระหว่าง shop_drawing_revisions (ตารางลูก) กับ contract_drawings (Master) +-- เพื่อรองรับ Requirement 2.5.3 ที่ระบุว่า Shop Drawing "แต่ละ revision" สามารถอ้างอิง Contract Drawing ที่แตกต่างกันได้ +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 + CONSTRAINT fk_sdrcr_revision + FOREIGN KEY (shop_drawing_revision_id) + REFERENCES shop_drawing_revisions(id) -- เชื่อมโยงกับตาราง Revision + ON DELETE CASCADE + ON UPDATE CASCADE, + + CONSTRAINT fk_sdrcr_contract_drawing + FOREIGN KEY (contract_drawing_id) + REFERENCES contract_drawings(condwg_id) + ON DELETE CASCADE + ON UPDATE CASCADE +) +ENGINE=InnoDB +DEFAULT CHARSET=utf8mb4 +COLLATE=utf8mb4_general_ci +COMMENT='ตารางเชื่อมโยง Shop Drawing Revisions กับ Contract Drawings (Req 2.5.3)'; + diff --git a/docs/SQL/01_dms_v1_0_1.sql b/docs/SQL/01_dms_v1_0_1.sql new file mode 100644 index 0000000..9b8bab0 --- /dev/null +++ b/docs/SQL/01_dms_v1_0_1.sql @@ -0,0 +1,1537 @@ +-- ========================================================== +-- DMS v1.0.2 Correspondence Improvements +-- Database v1.0 - 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.0.0 Initial Schema +-- DMS v1.0.1 Add missing relationship for Req 2.5.3, +-- Update: shop_drawing_revision_contract_refs Changed link to revision-level instead of master-level based on clarification. +-- DMS v1.0.2 Correspondence Improvements +-- Update: +-- 1. (Files) Consolidate file management: +-- - DROPs `pdf_path` from `correspondences` +-- - ADDs `is_main_document` to `attachments` +-- 2. (Recipients) Make recipients more flexible: +-- - DROPs `recipient_id` from `correspondences` +-- - DROPs `correspondence_cc_recipients` table +-- - CREATES `correspondence_recipients` (M:N table with TO/CC type) +-- 3. (Search) Remove keyword redundancy: +-- - DROPs `keywords` from `correspondences` (use `tags` system instead) +-- 4. (Change) corr_id -> correspondence_id for consistency +-- 5. (Change) revision VARCHAR(50) NULL in correspondences to support alphanumeric revisions รูปแบบ (A-Z?) → ตัวอักษร A-Z ตามด้วยตัวเลข 0 ตัวหรือมากกว่า (เช่น A, A1, B10), ตัวเลขล้วน หรือ ตัวเลขทศนิยม (เช่น 1, 2.1, 10.5) +-- 6. (Change) Changed tecnicaldoc to rfa (Requested_for_Approval) +-- ========================================================== + +SET NAMES utf8mb4; +SET time_zone = '+07:00'; + +-- ปิดการตรวจสอบ Foreign Key ชั่วคราวเพื่อให้สามารถลบตารางได้ทั้งหมด +SET FOREIGN_KEY_CHECKS=0; + +-- Level 1: ตารางที่มีความสัมพันธ์มากที่สุด (Junction Tables & Detail Tables) +DROP TABLE IF EXISTS audit_logs; +DROP TABLE IF EXISTS user_project_roles; +DROP TABLE IF EXISTS user_roles; +DROP TABLE IF EXISTS role_permissions; +DROP TABLE IF EXISTS contract_parties; +DROP TABLE IF EXISTS project_parties; +DROP TABLE IF EXISTS correspondence_references; +DROP TABLE IF EXISTS correspondence_recipients; +DROP TABLE IF EXISTS correspondence_routing_steps; +DROP TABLE IF EXISTS correspondence_routing_template_steps; +DROP TABLE IF EXISTS transmittal_items; +DROP TABLE IF EXISTS rfa_workflows; +DROP TABLE IF EXISTS rfa_workflow_template_steps; +DROP TABLE IF EXISTS rfa_items; +DROP TABLE IF EXISTS rfa_revision; +DROP TABLE IF EXISTS shop_drawing_revision_contract_refs; +DROP TABLE IF EXISTS shop_drawing_revisions; +DROP TABLE IF EXISTS contract_dwg_subcat_cat_map; +DROP TABLE IF EXISTS circulation_template_assignees; +DROP TABLE IF EXISTS cir_action_documents; +DROP TABLE IF EXISTS cir_actions; +DROP TABLE IF EXISTS attachments; +DROP TABLE IF EXISTS cir_recipients; +DROP TABLE IF EXISTS circulation_assignees; +DROP TABLE IF EXISTS correspondence_status_transitions; +DROP TABLE IF EXISTS global_default_roles; + +-- Level 2: ตารางที่ถูกอ้างอิงโดย Level 1 +DROP TABLE IF EXISTS correspondence_revisions; +DROP TABLE IF EXISTS transmittals; +DROP TABLE IF EXISTS circulations; +DROP TABLE IF EXISTS correspondence_routing_templates; +DROP TABLE IF EXISTS rfa_workflow_templates; +DROP TABLE IF EXISTS shop_drawings; +DROP TABLE IF EXISTS contract_drawings; +DROP TABLE IF EXISTS rfa_revisions +DROP TABLE IF EXISTS rfas; +DROP TABLE IF EXISTS circulation_templates; +DROP TABLE IF EXISTS correspondence_tags; +DROP TABLE IF EXISTS tags; + +-- Level 3: ตารางที่ถูกอ้างอิงโดย Level 2 +DROP TABLE IF EXISTS correspondences; +DROP TABLE IF EXISTS shop_drawing_sub_categories; +DROP TABLE IF EXISTS shop_drawing_main_categories; +DROP TABLE IF EXISTS contract_dwg_sub_cat; +DROP TABLE IF EXISTS contract_dwg_cat; +DROP TABLE IF EXISTS rfa_approve_codes; +DROP TABLE IF EXISTS rfa_status_codes; +DROP TABLE IF EXISTS rfa_types; +DROP TABLE IF EXISTS contract_dwg_volume; + +-- Level 4: ตาราง Master Data หลัก และตารางที่ถูกอ้างอิงโดย Level 3 +DROP TABLE IF EXISTS users; +DROP TABLE IF EXISTS projects; +DROP TABLE IF EXISTS contracts; +DROP TABLE IF EXISTS correspondence_status; -- Using this name from your list +DROP TABLE IF EXISTS correspondence_types; +DROP TABLE IF EXISTS cir_status_codes; +DROP TABLE IF EXISTS permissions; +DROP TABLE IF EXISTS roles; + +-- Level 5: ตารางที่เป็นรากฐานที่สุด +DROP TABLE IF EXISTS organizations; +DROP TABLE IF EXISTS organization_roles; + +-- Views +DROP VIEW IF EXISTS v_current_correspondences; + +-- Procedure +DRO PROCEDURE IF EXISTS sp_create_correspondence_revision + +-- เปิดการตรวจสอบ Foreign Key กลับมาเหมือนเดิม +-- SET FOREIGN_KEY_CHECKS=1; + +-- ========================================================== +-- Table Creation +-- ========================================================== +-- Level 5: Organizations +-- ========================================================== +-- 5.1 Organizations_roles Table +CREATE TABLE organization_roles ( + role_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_roles +INSERT INTO organization_roles (role_name) VALUES +('OWNER'), +('DESIGNER'), +('CONSULTANT'), +('CONTRACTOR'), +('THIRD PARTY'); + +-- 5.2 Organizations Table +CREATE TABLE organizations ( + org_id INT NOT NULL PRIMARY KEY COMMENT 'ID ของตาราง', + org_code VARCHAR(20) NOT NULL COMMENT 'รหัสองค์กร', + org_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 (org_code), + FOREIGN KEY (role_id) REFERENCES organization_roles(role_id) + ON DELETE SET NULL + ON UPDATE CASCADE +) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_general_ci COMMENT='Organizations Table'; + +INSERT INTO organizations (org_id, org_code, org_name, role_id) VALUES (1, 'กทท.','การท่าเรือแห่งประเทศไทย',1); +INSERT INTO organizations (org_id, org_code, org_name, role_id) VALUES (10, 'สคฉ.3','สำนักงานโครงการพัฒนาท่าเรือแหลมฉบัง ระยะที่ 3 (ส่วนที่ 1-4)', 1); +INSERT INTO organizations (org_id, org_code, org_name, role_id) VALUES (11, 'สคฉ.3-01','คณะกรรมการตรวจรับพัสดุ งานจ้างที่ปรีกษาควบคุมงาน โครงการพัฒนาท่าเรือแหลมฉบัง ระยะที่ 3 (ส่วนที่ 1-4)', 1); +INSERT INTO organizations (org_id, org_code, org_name, role_id) VALUES (12, 'สคฉ.3-02','คณะกรรมการตรวจรับพัสดุ งานก่อสร้าง โครงการพัฒนาท่าเรือแหลมฉบัง ระยะที่ 3 (ส่วนที่ 1) งานก่อสร้างงานทางทะเล', 1); +INSERT INTO organizations (org_id, org_code, org_name, role_id) VALUES (13, 'สคฉ.3-03','คณะกรรมการตรวจรับพัสดุ งานก่อสร้าง โครงการพัฒนาท่าเรือแหลมฉบัง ระยะที่ 3 (ส่วนที่ 2) งานก่อสร้างอาคาร ท่าเทียบเรือ ระบบถนน และระบบสาธารณูปโภค',1); +INSERT INTO organizations (org_id, org_code, org_name, role_id) VALUES (16, 'สคฉ.3-06','คณะกรรมการตรวจรับพัสดุ งานก่อสร้าง โครงการพัฒนาท่าเรือแหลมฉบัง ระยะที่ 3 (ส่วนที่ 3) งานก่อสร้าง', 1); +INSERT INTO organizations (org_id, org_code, org_name, role_id) VALUES (17, 'สคฉ.3-07','คณะกรรมการตรวจรับพัสดุ งานก่อสร้าง โครงการพัฒนาท่าเรือแหลมฉบัง ระยะที่ 3 (ส่วนที่ 4) งานก่อสร้าง', 1); +INSERT INTO organizations (org_id, org_code, org_name, role_id) VALUES (18, 'สคฉ.3-xx','คณะกรรมการตรวจรับพัสดุ งานจ้างที่ปรีกษาออกแบบ โครงการพัฒนาท่าเรือแหลมฉบัง ระยะที่ 3 (ส่วนที่ 4) งานก่อสร้าง', 1); +INSERT INTO organizations (org_id, org_code, org_name, role_id) VALUES (14, 'สคฉ.3-04','คณะกรรมการตรวจรับพัสด งานจ้างเหมาตรวจสอบผลกระทบสิ่งแวดล้อมระหว่างงานก่อสร้างโครงการพัฒนาท่าเรือแหลมฉบัง ระยะที่ 3 (ส่วนที่ 1-4)', 1); +INSERT INTO organizations (org_id, org_code, org_name, role_id) VALUES (15, 'สคฉ.3-05','คณะกรรมการตรวจรับพัสดุ งานเยียวยาการประมงและเพาะเลี้ยงสัตว์น้ำ', 1); +INSERT INTO organizations (org_id, org_code, org_name, role_id) VALUES (21, 'TEAM',' Designer Consulting Ltd.', 2); +INSERT INTO organizations (org_id, org_code, org_name, role_id) VALUES (22, 'คคง.','Construction Supervision Ltd.', 3); +INSERT INTO organizations (org_id, org_code, org_name, role_id) VALUES (41, 'ผรม.1',' โครงการพัฒนาท่าเรือแหลมฉบังระยะที่ 3 (ส่วนที่ 1) งานก่อสร้างงานทางทะเล', 4); +INSERT INTO organizations (org_id, org_code, org_name, role_id) VALUES (42, 'ผรม.2','ผรม.2 โครงการพัฒนาท่าเรือแหลมฉบัง ระยะที่ 3 (ส่วนที่ 2) งานก่อสร้างอาคาร ท่าเทียบเรือ ระบบถนน และระบบสาธารณูปโภค', 4); +INSERT INTO organizations (org_id, org_code, org_name, role_id) VALUES (43, 'ผรม.3','ผรม.3 Contractor Company #3 Ltd.', 4); +INSERT INTO organizations (org_id, org_code, org_name, role_id) VALUES (44, 'ผรม.4','ผรม.4 Contractor Company #4 Ltd.', 4); +INSERT INTO organizations (org_id, org_code, org_name, role_id) VALUES (31, 'EN','Third Party Environment', 5); +INSERT INTO organizations (org_id, org_code, org_name, role_id) VALUES (32, 'CAR','Third Party Care for Fishery', 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'; +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), + ('EDITOR', 'Editor', 'Can create/edit RFA/Drawings/Docs/Transmittals' ,1), + ('VIEWER', 'Viewer', 'Read-only access' ,0), + ('GUEST', 'Guest', 'Limited read-only access' ,0) +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'; +INSERT INTO permissions (permission_code, description, module, scope_level) VALUES + -- System + ('superadmin.access','Access Everything (All Orgs)','admin','GLOBAL'), + ('admin.access','Access Admin Panel (scoped)','admin','ORG'), + ('settings.manage','Manage Settings','admin','GLOBAL'), + -- Projects & Parties + ('projects.view','View Projects','projects','ORG'), + ('projects.manage','Create/Edit/Delete Projects','projects','ORG'), + ('project_parties.manage','Manage Project Parties','projects','ORG'), + -- Organizations + ('organizations.view','View Organizations','organizations','GLOBAL'), + ('organizations.manage','Manage Organizations','organizations','GLOBAL'), + -- Drawings + ('drawings.view','View Drawings','drawings','PROJECT'), + ('drawings.upload','Upload Drawing Revisions','drawings','PROJECT'), + ('drawings.delete','Delete Drawings/Revisions','drawings','PROJECT'), + -- Documents/Materials/MS + ('documents.view','View Documents','documents','PROJECT'), + ('documents.manage','Manage Documents/Revisions','documents','PROJECT'), + ('materials.view','View Materials','materials','PROJECT'), + ('materials.manage','Manage Materials/Revisions','materials','PROJECT'), + ('ms.view','View Method Statements','ms','PROJECT'), + ('ms.manage','Manage Method Statements/Revisions','ms','PROJECT'), + -- RFAs + ('rfas.view','View RFAs','rfas','PROJECT'), + ('rfas.create','Create RFA','rfas','PROJECT'), + ('rfas.respond','Respond / Update RFA','rfas','PROJECT'), + ('rfas.delete','Delete RFA','rfas','PROJECT'), + -- Correspondence & Transmittal & Circulation + ('corr.view','View Correspondences','correspondence','PROJECT'), + ('corr.manage','Manage Correspondences','correspondence','PROJECT'), + ('transmittals.manage','Manage Transmittals','transmittal','PROJECT'), + ('cirs.manage','Manage Circulations','circulation','ORG'), + -- Reports + ('reports.view','View Reports','reports','GLOBAL') +ON DUPLICATE KEY UPDATE + description=VALUES(description), + module=VALUES(module), + scope_level=VALUES(scope_level), + is_active=1; + +-- 4.5 cir_status_codes Table +CREATE TABLE cir_status_codes ( + cir_status_code_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 cir_status_codes (code, description, sort_order) VALUES +('OPEN', 'Open', 10), +('IN_REVIEW', 'In Review', 20), +('COMPLETED', 'ปCompleted', 30), +('CANCELLED', 'Cancelled/Withdrawn', 99); + +-- 4.6 correspondence_types Table +CREATE TABLE correspondence_types ( + type_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', 10,1), + ('EMAIL', 'Email', 20,1), + ('INSTRUCTION', 'Instruction', 30,1), + ('LETTER', 'Letter', 40,1), + ('MEMO', 'Memorandum', 50,1), + ('MOM', 'Minutes of Meeting', 60,1), + ('RFI', 'Request for Information', 70,1), + ('TRANSMITTAL', 'Transmittal', 80,1); + +-- 4.7 correspondence_status Table +CREATE TABLE correspondence_status ( + 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.8 contracts Table: Stores information about each contract. +CREATE TABLE contracts ( + contract_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.9 Projects (contractor optional, FK -> organizations with SET NULL) +CREATE TABLE projects ( + project_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_org_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(project_id) ON UPDATE CASCADE ON DELETE SET NULL, + CONSTRAINT fk_proj_contractor FOREIGN KEY (contractor_org_id) REFERENCES organizations(org_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_org_id); +INSERT INTO projects (project_code, project_name) VALUES + ('LCBP3','โครงการพัฒนาท่าเรือแหลมฉบัง ระยะที่ 3 (ส่วนที่ 1-4)'), + ('LCBP3C1','โครงการพัฒนาท่าเรือแหลมฉบัง ระยะที่ 3 (ส่วนที่ 1) งานก่อสร้างงานทางทะเล'), + ('LCBP3C2','โครงการพัฒนาท่าเรือแหลมฉบัง ระยะที่ 3 (ส่วนที่ 2) งานก่อสร้างอาคาร ท่าเทียบเรือ ระบบถนน และระบบสาธารณูปโภค'), + ('LCBP3C3','โครงการพัฒนาท่าเรือแหลมฉบัง ระยะที่ 3 (ส่วนที่ 3) งานก่อสร้าง'), + ('LCBP3C4','โครงการพัฒนาท่าเรือแหลมฉบัง ระยะที่ 3 (ส่วนที่ 4) งานก่อสร้าง'); + +-- 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', + org_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 (org_id) REFERENCES organizations(org_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); + +-- ========================================================== +-- Level 3: ตารางที่ถูกอ้างอิงโดย Level 2 +-- ========================================================== +-- 3.1 rfas_types Table +CREATE TABLE rfa_types ( + rfa_type_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 rfas_status_codes Table +CREATE TABLE rfa_status_codes ( + status_code_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 rfas_approve_codes Table +CREATE TABLE rfa_approve_codes ( + approve_code_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 contract_dwg_cat Table: Category (ต่อโครงการ) +CREATE TABLE contract_dwg_cat ( + cat_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, cat_id), -- เพิ่ม unique (project_id, cat_id) เพื่อรองรับ composite FK + + KEY idx_cat_project (project_id), + KEY idx_cat_project_code (project_id, cat_code), + + CONSTRAINT fk_cat_project + FOREIGN KEY (project_id) REFERENCES projects(project_id) + ON UPDATE CASCADE ON DELETE CASCADE +) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_general_ci COMMENT='ตารางหมวดหมู่ของแบบสัญญา'; + +-- 3.5 contract_dwg_sub_cat Table: Sub-Category (ต่อโครงการ) +CREATE TABLE contract_dwg_sub_cat ( + sub_cat_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, sub_cat_id), -- เพิ่ม unique (project_id, sub_cat_id) เพื่อรองรับ composite FK + + KEY idx_subcat_project (project_id), + KEY idx_subcat_project_code (project_id, sub_cat_code), + + CONSTRAINT fk_subcat_project + FOREIGN KEY (project_id) REFERENCES projects(project_id) + ON UPDATE CASCADE ON DELETE CASCADE +) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_general_ci COMMENT='ตารางหมวดหมู่ย่อยของแบบสัญญา'; + +-- 3.6 shop_drawing_main_categories Table: ตารางหมวดหมู่หลักของ Shop Drawing +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.7 shop_drawing_sub_categories Table: ตารางหมวดหมู่ย่อยของ Shop Drawing +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 contract_dwg_volume Table: +CREATE TABLE contract_dwg_volume ( + volume_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, volume_id), + + KEY idx_volume_project (project_id), + KEY idx_volume_project_code (project_id, volume_code), + + CONSTRAINT fk_volume_project + FOREIGN KEY (project_id) REFERENCES projects(project_id) + ON UPDATE CASCADE ON DELETE CASCADE +) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_general_ci COMMENT='เล่มของ Contract Drawing'; + +-- 3.8 correspondences Table ตารางเก็บข้อมูลการสื่อสาร : +-- details [email_details, instruction_details, letter_details, memorandum_details, minutes_of_meeting_details, rfi_details] +CREATE TABLE correspondences ( + correspondence_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.org_id + recipient_id INT NULL COMMENT 'องกรณ์ที่เป็นปู้รับเอกสาร', -- organizations.org_id + + created_at DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP COMMENT 'วันที่สร้าง', + created_by INT NULL 'รหัสผู้สร้าง', + 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(project_id) ON UPDATE CASCADE ON DELETE CASCADE, + CONSTRAINT fk_cor_originator FOREIGN KEY (originator_id) REFERENCES organizations(org_id) ON UPDATE CASCADE ON DELETE SET NULL, + CONSTRAINT fk_cor_recipient FOREIGN KEY (recipient_id) REFERENCES organizations(org_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(type_id) ON UPDATE CASCADE ON DELETE RESTRICT, + CONSTRAINT fk_cm_current_revision FOREIGN KEY (current_revision_id) REFERENCES correspondence_revisions(correspondence_revision_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_created_at ON correspondences(created_at); +CREATE INDEX idx_attach_main_doc ON correspondences(correspondence_id, is_main_document); +CREATE INDEX idx_cor_current_rev ON correspondences(current_revision_id); + + +-- ========================================================== +-- Level 2: ตารางที่ถูกอ้างอิงโดย Level 1 +-- ========================================================== +-- 2.1 circulation_templates Table: ตารางหลักสำหรับเก็บชื่อแม่แบบใบเวียน +CREATE TABLE circulation_templates ( + template_id INT NOT NULL AUTO_INCREMENT COMMENT 'ID ของแม่แบบ', + template_name VARCHAR(255) NOT NULL COMMENT 'ชื่อแม่แบบ (เช่น "สำหรับเอกสารการเงิน", "สำหรับ Drawing โครงสร้าง")', + org_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 'วันที่แก้ไขล่าสุด', + PRIMARY KEY (template_id), + + -- ป้องกันการสร้างชื่อแม่แบบซ้ำในองค์กรเดียวกัน + UNIQUE KEY ux_circulation_template_name_org (template_name, org_id), + + -- Foreign Key + CONSTRAINT fk_ct_org FOREIGN KEY (org_id) REFERENCES organizations(org_id) ON DELETE CASCADE +) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_general_ci COMMENT='แม่แบบสำหรับใบเวียนเอกสารภายในองค์กร'; + +-- 2.2 rfas Table ตารางเก็บข้อมูลเอกสารขออนุมัติ (Request for Approval): rfas 1 to many rfa_revision +CREATE TABLE rfas ( + rfa_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 VARCHAR(50) NOT NULL COMMENT 'หมายเลข revision (e.g., A, B, 1, 2.1)', + 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_techdoc_created_by FOREIGN KEY (created_by) REFERENCES users(user_id) ON UPDATE CASCADE ON DELETE SET NULL, + CONSTRAINT fk_techdoc_updated_by FOREIGN KEY (updated_by) REFERENCES users(user_id) ON UPDATE CASCADE ON DELETE SET NULL, + CONSTRAINT fk_techdoc_status FOREIGN KEY (status_code_id) REFERENCES rfa_status_codes(status_code_id), + CONSTRAINT fk_techdoc_approve FOREIGN KEY (approve_code_id) REFERENCES rfa_approve_codes(approve_code_id) ON UPDATE CASCADE ON DELETE SET NULL, + CONSTRAINT fk_techdoc_type FOREIGN KEY (rfa_type_id) REFERENCES rfa_types(rfa_type_id), + CONSTRAINT fk_techdoc_project FOREIGN KEY (project_id) REFERENCES projects(project_id) +) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_general_ci COMMENT='ตารางเก็บเอกสารขออนุมัติ'; + +CREATE UNIQUE INDEX idx_unique_techdoc_revision ON rfas (original_id, revision, project_id); + +-- 2.2 rfas_revisions Table +CREATE TABLE rfa_revisions ( + rfa_revision_id INT AUTO_INCREMENT PRIMARY KEY COMMENT 'ID ของตาราง', + rfa_id INT COMMENT 'rfa id', -- FK -> rfas.rfa_id + correspondence_id INT NOT NULL COMMENT 'Master correspondence ID', + + rfa_type_id INT NOT NULL COMMENT 'ประเภทเอกสาร', + + master_id INT NOT NULL, + revision_number INT NOT NULL, + revision_label VARCHAR(10) NULL, -- A, B, C + + status_code_id INT NOT NULL, + approve_code_id INT NULL, + is_current BOOLEAN NOT NULL DEFAULT FALSE, + + -- File references + pdf_path VARCHAR(500) NULL, + dwg_path VARCHAR(500) NULL, -- สำหรับ DWG type + + -- Metadata + revision_description TEXT NULL, + submitted_date DATE NULL, + approved_date DATE NULL, + + created_at DATETIME DEFAULT CURRENT_TIMESTAMP, + created_by INT NULL, + updated_by INT NULL, + + CONSTRAINT uq_master_rev_number UNIQUE (master_id, revision_number), + + CONSTRAINT chk_rev_format CHECK (revision_label IS NULL OR revision_label REGEXP '^(A-Z?|[0-9]+(\\.[0-9]+)?)$'), -- validate format + CONSTRAINT fk_rr_correspondence FOREIGN KEY (correspondence_id) REFERENCES correspondences(correspondence_id) ON UPDATE CASCADE ON DELETE CASCADE, -- link to master correspondence + CONSTRAINT fk_rr_status FOREIGN KEY (correspondence_status_id) REFERENCES correspondence_status(status_id) ON UPDATE CASCADE ON DELETE RESTRICT, -- link to correspondence status + CONSTRAINT fk_rr_type FOREIGN KEY (rfa_type_id) REFERENCES rfa_types(rfa_type_id) ON DELETE RESTRICT, -- link to rfa types + CONSTRAINT fk_rr_status_code FOREIGN KEY (status_code_id) REFERENCES rfa_status_codes(status_code_id) ON DELETE RESTRICT, -- link to rfa status codes + CONSTRAINT fk_rr_approve FOREIGN KEY (approve_code_id) REFERENCES rfa_approve_codes(approve_code_id) ON DELETE RESTRICT, -- link to rfa approve codes + CONSTRAINT fk_rr_created_by FOREIGN KEY (created_by) REFERENCES users(user_id) ON DELETE SET NULL, -- link to users + CONSTRAINT fk_rr_updated_by FOREIGN KEY (updated_by) REFERENCES users(user_id) ON DELETE SET NULL -- link to users +) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_general_ci COMMENT='ตารางเก็บ revision ของเอกสารขออนุมัติ'; + + +/* =========================================================== +2.3 Drawings (ต่อโครงการ) + - 1 drawing ∈ 1 project + - ชี้ 1 sub-category (ในโครงการเดียวกัน) + - ชี้ 1 volume (ในโครงการเดียวกัน) + - unique: (project_id, condwg_no) + =========================================================== */ + +CREATE TABLE contract_drawings ( + condwg_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 'วันที่แก้ไขล่าสุด', + + 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(project_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_dwg_sub_cat (project_id, sub_cat_id) + ON UPDATE CASCADE ON DELETE RESTRICT, + + CONSTRAINT fk_condwg_volume_same_project + FOREIGN KEY (project_id, volume_id) + REFERENCES contract_dwg_volume (project_id, volume_id) + ON UPDATE CASCADE ON DELETE RESTRICT +) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_general_ci COMMENT='ตารางเก็บแบบสัญญาต่อโครงการ'; + +-- 2.4 shop_drawings Table: ตารางหลักสำหรับข้อมูล Shop Drawing +CREATE TABLE shop_drawings ( + id INT NOT NULL AUTO_INCREMENT COMMENT 'ID ของตาราง', + 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 'วันที่แก้ไขล่าสุด', + PRIMARY KEY (id), + UNIQUE KEY ux_sd_drawing_number (drawing_number), + 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.x rfa_revision Table ตารางเก็บข้อมูล Revision ของเอกสารขออนุมัติ : rfa_revision many to 1 rfas, rfa_revision 1 to 1 correwpondence +CREATE TABLE rfa_revision ( + rfa_revision_id INT AUTO_INCREMENT PRIMARY KEY COMMENT 'ID ของตาราง', + rfa_id INT COMMENT 'ID ของเอกสารขออนุมัติ (จากตาราง rfas)', -- FK -> rfas.rfa_id + correspondence_id INT NOT NULL COMMENT 'Master correspondence ID', -- FK -> correspondences.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 + + -- project_id INT NOT NULL COMMENT 'รหัสโครงการ', refer by correspondences + -- rfa_number VARCHAR(100) NOT NULL COMMENT 'เลขที่เอกสารขออนุมัติ', refer by correspondences + title VARCHAR(255) NOT NULL COMMENT 'เรื่อง', + + -- สถานะเฉพาะของ Revision นี้ + status_code_id INT NOT NULL COMMENT 'รหัสสถานะเอกสาร', + approve_code_id INT NULL COMMENT 'รหัสการอนุมัติเอกสาร', + is_current BOOLEAN NOT NULL DEFAULT FALSE COMMENT 'ระบุว่าเป็น Revision ปัจจุบัน (1=ใช่,0=ไม่ใช่)', + + -- Metadata + revision_description TEXT NULL COMMENT 'คำอธิบายการแก้ไขใน Revision นี้', + submitted_date DATE NULL COMMENT 'วันที่ส่งขออนุมัติ', + received_date DATETIME NULL COMMENT 'วันที่ลงรับเอกสาร', + due_date DATETIME NULL COMMENT 'วันที่ต้องตอบเอกสาร', + approved_date DATE NULL COMMENT 'วันที่อนุมัติ', + updated_by INT NULL COMMENT 'ผู้แก้ไขล่าสุด', + + -- pdf_path เก็บไฟล์ PDF ที่ ตาราง rfa_attachments, + + -- Audit + created_at DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP COMMENT 'วันที่สร้างเอกสาร', + created_by INT NULL COMMENT 'ผู้สร้างเอกสาร', + change_reason TEXT NULL COMMENT 'เหตุผลที่แก้ไขเอกสาร', + + 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 ได้ดีกว่า + + -- รูปแบบ (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?|[0-9]+(\\.[0-9]+)?)$'), + CONSTRAINT chk_is_current CHECK (is_current IN (0,1)), + CONSTRAINT chk_rev_number_positive CHECK (revision_number >= 0), + 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_submitted CHECK (approved_date IS NULL OR submitted_date IS NULL OR approved_date >= submitted_date), + CONSTRAINT chk_submitted_after_created CHECK (submitted_date IS NULL OR created_at IS NULL OR submitted_date >= DATE(created_at)), + CONSTRAINT chk_received_after_created CHECK (received_date IS NULL OR created_at IS NULL OR received_date >= created_at), + CONSTRAINT chk_updated_by_diff_created_by CHECK (updated_by IS NULL OR updated_by <> created_by), + CONSTRAINT chk_rfa_id_not_null_if_correspondence FOREIGN KEY (correspondence_id) REFERENCES correspondences(correspondence_id), -- ถ้า correspondence_id ไม่เป็น NULL ต้องมี rfa_id ด้วย + CONSTRAINT chk_rfa_id_null_if_no_correspondence CHECK ((correspondence_id IS NULL AND rfa_id IS NULL) OR (correspondence_id IS NOT NULL AND rfa_id IS NOT NULL)), -- ถ้า correspondence_id เป็น NULL rfa_id ต้องเป็น NULL ด้วย + CONSTRAINT chk_only_one_current_revision_per_rfa CHECK ( + is_current = 0 OR + (is_current = 1 AND rfa_id IS NOT NULL) + ), -- ถ้า is_current=1 ต้องมี rfa_id ด้วย + CONSTRAINT chk_only_one_current_revision_per_correspondence CHECK ( + is_current = 0 OR + (is_current = 1 AND correspondence_id IS NOT NULL) + ), -- ถ้า is_current=1 ต้องมี correspondence_id ด้วย + CONSTRAINT chk_either_rfa_or_correspondence CHECK ( + (rfa_id IS NOT NULL AND correspondence_id IS NULL) OR + (rfa_id IS NULL AND correspondence_id IS NOT NULL) + ), -- ต้องมีแค่ rfa_id หรือ correspondence_id เท่านั้น ไม่สามารถมีทั้งสองอย่างพร้อมกัน + CONSTRAINT + + -- FKs + CONSTRAINT fk_rr_correspondence FOREIGN KEY (correspondence_id) REFERENCES correspondences(correspondence_id) ON DELETE CASCADE, -- ถ้าเอกสารถูกลบ ให้ลบ revision ด้วย + CONSTRAINT fk_rr_rfa FOREIGN KEY (rfa_id) REFERENCES rfas(rfa_id) ON DELETE CASCADE, -- ถ้าเอกสารถูกลบ ให้ลบ revision ด้วย + CONSTRAINT fk_rr_status FOREIGN KEY (status_code_id) REFERENCES rfa_status_codes(status_code_id), + CONSTRAINT fk_rr_approve FOREIGN KEY (approve_code_id) REFERENCES rfa_approve_codes(approve_code_id) ON DELETE SET NULL, + CONSTRAINT fk_rr_updated_by FOREIGN KEY (updated_by) REFERENCES users(user_id) ON UPDATE CASCADE ON DELETE SET NULL +) + +-- 2.5 rfa_workflow_templates Table: ตารางหลักสำหรับเก็บชื่อแม่แบบ +CREATE TABLE rfa_workflow_templates ( + template_id INT NOT NULL AUTO_INCREMENT COMMENT 'ID ของแม่แบบ', + template_name VARCHAR(255) NOT NULL COMMENT 'ชื่อแม่แบบ', + description TEXT COMMENT 'คำอธิบาย', + project_id INT NULL, -- (Optional) ทำให้สามารถสร้างแม่แบบเฉพาะโครงการได้ + created_at TIMESTAMP NOT NULL DEFAULT CURRENT_TIMESTAMP ON UPDATE COMMENT 'วันที่สร้าง', + updated_at TIMESTAMP NOT NULL DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP COMMENT 'วันที่แก้ไขล่าสุด', + PRIMARY KEY (template_id), + UNIQUE KEY ux_template_name_project (template_name, project_id), + CONSTRAINT fk_wt_project FOREIGN KEY (project_id) REFERENCES projects(project_id) ON DELETE CASCADE +) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_general_ci COMMENT='แม่แบบ Workflow การอนุมัติเอกสารทางเทคนิค'; + +-- 2.6 correspondence_routing_templates Table:ตารางหลักสำหรับเก็บชื่อแม่แบบการส่งต่อ +CREATE TABLE correspondence_routing_templates ( + template_id INT NOT NULL AUTO_INCREMENT COMMENT 'ID ของแม่แบบ', + template_name VARCHAR(255) NOT NULL COMMENT 'ชื่อแม่แบบ', + description TEXT COMMENT 'คำอธิบาย', + project_id INT 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 'วันที่แก้ไขล่าสุด', + PRIMARY KEY (template_id), + UNIQUE KEY ux_routing_template_name_project (template_name, project_id), + CONSTRAINT fk_crt_project FOREIGN KEY (project_id) REFERENCES projects(project_id) ON DELETE CASCADE +) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_general_ci COMMENT='แม่แบบสายงานการส่งต่อเอกสารทั่วไป'; + +-- 2.7 circulations Table: +CREATE TABLE circulations ( + cir_id INT NOT NULL AUTO_INCREMENT COMMENT 'ID ของตารางใบเวียน', + correspondence_id INT UNIQUE NOT NULL COMMENT 'ID ของเอกสาร (จากตาราง correspondences)', -- one circulation record per correspondence (optional) + org_id INT NOT NULL COMMENT 'ID ขององค์กรที่เป็นเจ้าของใบเวียนนี้', -- องค์กรที่เป็นเจ้าของใบเวียนนี้ + cir_no VARCHAR(100) NOT NULL COMMENT 'เลขที่ใบเวียน', -- unique per organization + cir_subject VARCHAR(500) NOT NULL COMMENT 'เรื่องใบเวียน', + cir_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 'วันที่แก้ไขล่าสุด', + -- pdf_path VARCHAR(500) NULL, + PRIMARY KEY (cir_id), + CONSTRAINT uq_cir_org_no UNIQUE(org_id, cir_no), + CONSTRAINT fk_cir_correspondence FOREIGN KEY (correspondence_id) REFERENCES correspondences(correspondence_id), + CONSTRAINT fk_cir_org FOREIGN KEY (org_id) REFERENCES organizations(org_id), + CONSTRAINT fk_cir_status FOREIGN KEY (cir_status_code) REFERENCES cir_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(org_id); +CREATE INDEX idx_cir_status ON circulations(cir_status_code); +CREATE INDEX idx_cir_corr ON circulations(correspondence_id); + +-- 2.8 transmittal Table: ตารางสำหรับเก็บข้อมูลเฉพาะของ Transmittal (เป็นตารางลูกของ correspondences) +CREATE TABLE transmittals ( + -- ใช้ correspondence_id เป็นทั้ง Primary Key และ Foreign Key เพื่อสร้างความสัมพันธ์แบบ One-to-One + correspondence_id INT NOT NULL COMMENT 'ID ของเอกสาร (จากตาราง correspondences)', + purpose ENUM('FOR_APPROVAL', 'FOR_INFORMATION', 'FOR_CONSTRUCTION', 'AS_BUILT') NOT NULL DEFAULT 'FOR_INFORMATION' COMMENT 'วัตถุประสงค์ในการส่ง', + remarks TEXT COMMENT 'หมายเหตุเพิ่มเติม', + + PRIMARY KEY (correspondence_id), + + -- Foreign Key + CONSTRAINT fk_transmittal_correspondence FOREIGN KEY (correspondence_id) REFERENCES correspondences(correspondence_id) ON DELETE CASCADE +) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_general_ci COMMENT='ตารางเก็บข้อมูลเฉพาะของเอกสารนำส่ง (Transmittal)'; + +-- 2.9 correspondence_revisions Table: ตารางสำหรับเก็บประวัติการแก้ไขเอกสาร (Revision History) +CREATE TABLE correspondence_revisions ( + correspondence_revision_id INT AUTO_INCREMENT PRIMARY KEY COMMENT 'ID ของตาราง', + 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 นี้ + correspondence_status_id INT NOT NULL COMMENT 'สถานะหนังสือ', + is_current BOOLEAN NOT NULL DEFAULT FALSE COMMENT 'ระบุว่าเป็น Revision ปัจจุบัน (1=ใช่,0=ไม่ใช่)', + + -- ข้อมูลที่เปลี่ยนแปลงตาม Revision + title VARCHAR(255) NOT NULL COMMENT 'เรื่อง', + -- keywords VARCHAR(255) NULL, ใช้ tag แทน + issued_date DATETIME NULL COMMENT 'วันที่ออกเอกสาร', + received_date DATETIME NULL COMMENT 'วันที่ลงรับเอกสาร', + due_date DATETIME NULL COMMENT 'วันที่ต้องตอบเอกสาร', + + -- pdf_path เก็บไฟล์ PDF ที่ ตาราง correspondence_attachments, + + details JSON NULL COMMENT 'เก็บข้อมูลเฉพาะของเอกสารแต่ละประเภทในรูปแบบ JSON', + -- Audit + created_at DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP COMMENT 'วันที่สร้างเอกสาร', + created_by INT NULL COMMENT 'ผู้สร้างเอกสาร', + change_reason TEXT NULL COMMENT 'เหตุผลที่แก้ไขเอกสาร', + + CONSTRAINT uq_master_revision_number UNIQUE (master_id, revision_number), + CONSTRAINT uq_master_current UNIQUE (master_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?|[0-9]+(\\.[0-9]+)?)$'), + CONSTRAINT fk_cr_correspondence FOREIGN KEY (correspondence_id) REFERENCES correspondences(correspondence_id) ON UPDATE CASCADE ON DELETE CASCADE, + CONSTRAINT fk_cr_status FOREIGN KEY (correspondence_status_id) REFERENCES correspondence_status(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 +) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_general_ci COMMENT = 'ตารางเก็บ Revision ของหนังสือ'; + +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); + +-- 2.10 ตารางหลักสำหรับเก็บ Tag ทั้งหมด (Master Data) +CREATE TABLE tags ( + tag_id INT NOT NULL AUTO_INCREMENT PRIMARY KEY COMMENT 'ID ของ Tag', + tag_name VARCHAR(50) NOT NULL COMMENT 'ชื่อ Tag', + + -- ป้องกันการสร้างชื่อ Tag ซ้ำ + UNIQUE KEY ux_tag_name (tag_name) +) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_general_ci COMMENT='ตารางเก็บ Master Data ของ Tags'; + + +-- 2.11 ตารางเชื่อม (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(correspondence_id) ON DELETE CASCADE, + CONSTRAINT fk_ct_tag FOREIGN KEY (tag_id) REFERENCES tags(tag_id) ON DELETE CASCADE +) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_general_ci COMMENT='ตารางเชื่อมความสัมพันธ์ระหว่างเอกสารและ Tags'; + +-- ========================================================== +-- Level 1: ตารางที่มีความสัมพันธ์มากที่สุด (Junction Tables & Detail Tables) +-- ========================================================== +-- 1.1 global_default_roles Table: Global default roles (template defaults) +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)', + org_id INT NOT NULL COMMENT 'ID ขององค์กรที่ถูกกำหนดเป็นค่าเริ่มต้น', + PRIMARY KEY (id, role, position), + UNIQUE KEY ux_gdr_unique_org_per_role (id, role, org_id), + CONSTRAINT fk_gdr_org FOREIGN KEY (org_id) REFERENCES organizations(org_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, org_id) +SELECT 1, 'OWNER', pos, org_id +FROM ( + SELECT org_id, ROW_NUMBER() OVER (ORDER BY org_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 org_id=VALUES(org_id); + +-- DESIGNER +INSERT INTO global_default_roles (id, role, position, org_id) +SELECT 1, 'DESIGNER', 1, org_id +FROM organizations +-- WHERE primary_role='DESIGNER' +WHERE role_id = 2 +ORDER BY org_id +LIMIT 1 +ON DUPLICATE KEY UPDATE org_id=VALUES(org_id); + +-- CONSULTANT +INSERT INTO global_default_roles (id, role, position, org_id) +SELECT 1, 'CONSULTANT', 1, org_id +FROM organizations +-- WHERE primary_role='CONSULTANT' +WHERE role_id = 3 +ORDER BY org_id +LIMIT 1 +ON DUPLICATE KEY UPDATE org_id=VALUES(org_id); + +-- 1.2 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(type_id), + CONSTRAINT fk_cst_from FOREIGN KEY (from_status_id) REFERENCES correspondence_status(status_id), + CONSTRAINT fk_cst_to FOREIGN KEY (to_status_id) REFERENCES correspondence_status(status_id) +) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_general_ci COMMENT='ตารางสถานะที่อนุญาตให้เปลี่ยนแปลงได้ตามประเภทหนังสือ'; + +-- 1.3 circulation_assignees Table: ตารางสำหรับระบุผู้รับผิดชอบใน Circulation Sheet แต่ละใบ +CREATE TABLE circulation_assignees ( + assignee_id INT NOT NULL AUTO_INCREMENT PRIMARY KEY COMMENT 'ID ของผู้รับผิดชอบ', + cir_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 TIMESTAMP NULL COMMENT 'เวลาที่ดำเนินการเสร็จสิ้น', + + UNIQUE KEY ux_cir_user_type (cir_id, user_id, assignee_type), + CONSTRAINT fk_ca_cir FOREIGN KEY (cir_id) REFERENCES circulations(cir_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.4 cir_recipients Table: ตารางสำหรับเก็บรายชื่อผู้รับในใบเวียน (เพิ่มเติมจาก assignees) +CREATE TABLE cir_recipients ( + recipient_id INT NOT NULL AUTO_INCREMENT PRIMARY KEY COMMENT 'ID ของรายการ', + cir_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 (cir_id, user_id, recipient_role), + + -- Foreign Keys + CONSTRAINT fk_cir_recipients_circulation FOREIGN KEY (cir_id) REFERENCES circulations(cir_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.5 attachments Table: ตารางสำหรับเก็บ Metadata ของไฟล์แนบทั้งหมดในระบบ +CREATE TABLE attachments ( + attachment_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(correspondence_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='ตารางกลางสำหรับเก็บข้อมูลไฟล์แนบ'; + +-- 1.6 cir_actions Table: ตารางสำหรับบันทึกประวัติการดำเนินการในใบเวียน +CREATE TABLE cir_actions ( + action_id INT NOT NULL AUTO_INCREMENT PRIMARY KEY COMMENT 'ID ของการกระทำ', + cir_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 (cir_id) REFERENCES circulations(cir_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.7 cir_action_documents Table: ตารางเชื่อมระหว่างการดำเนินการและไฟล์แนบ +CREATE TABLE cir_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 cir_actions(action_id) ON DELETE CASCADE, + CONSTRAINT fk_cad_attachment FOREIGN KEY (attachment_id) REFERENCES attachments(attachment_id) ON DELETE CASCADE +) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_general_ci COMMENT='ตารางเชื่อมไฟล์แนบกับการดำเนินการในใบเวียน'; + +-- 1.8 circulation_template_assignees Table: ตารางสำหรับเก็บรายชื่อผู้รับผิดชอบในแต่ละแม่แบบ +CREATE TABLE circulation_template_assignees ( + assignee_template_id INT NOT NULL AUTO_INCREMENT 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 'บทบาทของผู้ใช้ในแม่แบบนี้', + + PRIMARY KEY (assignee_template_id), + + -- ป้องกันการกำหนด 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(template_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 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_dwg_subcat_cat_map ( + 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_dwg_sub_cat (project_id, sub_cat_id) + ON UPDATE CASCADE ON DELETE CASCADE, + + CONSTRAINT fk_map_cat + FOREIGN KEY (project_id, cat_id) + REFERENCES contract_dwg_cat (project_id, cat_id) + ON UPDATE CASCADE ON DELETE CASCADE +) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_general_ci COMMENT='ตารางเชื่อมระหว่างหมวดหมู่ย่อยและหมวดหมู่หลักของแบบสัญญา'; + +-- 1.10 shop_drawing_revisions Table: ตารางสำหรับเก็บประวัติการแก้ไข (Revision) ของ Shop Drawing +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 VARCHAR(10) NOT NULL COMMENT 'หมายเลข Revision (เช่น A, B, 0, 1)', + 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 'วันที่สร้าง', + + 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='ประวัติการแก้ไขของ Shop Drawing'; + +CREATE INDEX idx_sdr_shop_drawing ON shop_drawing_revisions(shop_drawing_id); + +-- สร้างตารางเชื่อมระหว่าง shop_drawing_revisions (ตารางลูก) กับ contract_drawings (Master) +-- เพื่อรองรับ Requirement 2.5.3 ที่ระบุว่า Shop Drawing "แต่ละ revision" สามารถอ้างอิง Contract Drawing ที่แตกต่างกันได้ +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 + CONSTRAINT fk_sdrcr_revision + FOREIGN KEY (shop_drawing_revision_id) + REFERENCES shop_drawing_revisions(id) -- เชื่อมโยงกับตาราง Revision + ON DELETE CASCADE + ON UPDATE CASCADE, + + CONSTRAINT fk_sdrcr_contract_drawing + FOREIGN KEY (contract_drawing_id) + REFERENCES contract_drawings(condwg_id) + ON DELETE CASCADE + ON UPDATE CASCADE +) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_general_ci COMMENT='ตารางเชื่อมระหว่าง Shop Drawing Revisions กับ Contract Drawings'; + + +-- 1.11 rfa_workflow_template_steps Table: ตารางสำหรับเก็บขั้นตอนของแต่ละแม่แบบ +CREATE TABLE rfa_workflow_template_steps ( + step_id INT NOT NULL AUTO_INCREMENT PRIMARY KEY COMMENT 'ID ของขั้นตอน', + template_id INT NOT NULL COMMENT 'ID ของแม่แบบ', + sequence INT NOT NULL COMMENT 'ลำดับขั้นตอน', + org_id INT NOT NULL COMMENT 'ID องค์กรที่ต้องพิจารณาในขั้นตอนนี้', + step_purpose ENUM('FOR_APPROVAL', 'FOR_REVIEW', 'FOR_INFORMATION') NOT NULL DEFAULT 'FOR_APPROVAL' COMMENT 'วัตถุประสงค์ของขั้นตอนนี้ เช่น เพื่ออนุมัติ, เพื่อตรวจสอบ, หรือเพื่อรับทราบ', + + UNIQUE KEY ux_template_sequence (template_id, sequence), + CONSTRAINT fk_wts_template FOREIGN KEY (template_id) REFERENCES rfa_workflow_templates(template_id) ON DELETE CASCADE, + CONSTRAINT fk_wts_org FOREIGN KEY (org_id) REFERENCES organizations(org_id) ON DELETE CASCADE +) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_general_ci COMMENT='ขั้นตอนในแม่แบบ Workflow การอนุมัติเอกสารทางเทคนิค'; + +-- 1.12 rfa_workflows Table: ตารางสำหรับติดตามสถานะ Workflow ของเอกสาร Technical (RFA) +CREATE TABLE rfa_workflows ( + workflow_id INT NOT NULL AUTO_INCREMENT PRIMARY KEY COMMENT 'ID ของ Workflow', + correspondence_id INT NOT NULL COMMENT 'ID ของเอกสาร (FK -> correspondences)', + sequence INT NOT NULL COMMENT 'ลำดับขั้นตอน', + org_id INT NOT NULL COMMENT 'ID ขององค์กรที่ต้องพิจารณาในขั้นตอนนี้', + status ENUM('PENDING', 'APPROVED', 'REJECTED', 'APPROVED_WITH_COMMENTS', 'FORWARDED', 'RETURNED') NOT NULL DEFAULT 'PENDING' COMMENT 'สถานะของขั้นตอนนี้', + comments TEXT 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), + CONSTRAINT fk_tdw_correspondence FOREIGN KEY (correspondence_id) REFERENCES correspondences(correspondence_id) ON DELETE CASCADE, + CONSTRAINT fk_tdw_org FOREIGN KEY (org_id) REFERENCES organizations(org_id), + CONSTRAINT fk_tdw_user FOREIGN KEY (processed_by_user_id) REFERENCES users(user_id) +) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_general_ci COMMENT='ตารางติดตามสถานะ Workflow การอนุมัติเอกสารทางเทคนิค'; + +-- 1.13 transmittal_items Table: ตารางสำหรับเก็บรายการเอกสารที่ถูกส่งใน Transmittal แต่ละฉบับ +CREATE TABLE transmittal_items ( + item_id INT NOT NULL AUTO_INCREMENT PRIMARY KEY COMMENT 'ID ของรายการ', + transmittal_id INT NOT NULL COMMENT 'ID ของ Transmittal (จากตาราง transmittals)', + technical_doc_id INT NOT NULL COMMENT 'ID ของเอกสารทางเทคนิคที่แนบไป', + quantity INT NOT NULL DEFAULT 1 COMMENT 'จำนวน', + remarks VARCHAR(255) COMMENT 'หมายเหตุสำหรับรายการนี้', + + -- ป้องกันการเพิ่มเอกสารเดิมซ้ำใน Transmittal ฉบับเดียวกัน + UNIQUE KEY ux_transmittal_item (transmittal_id, technical_doc_id), + + -- Foreign Keys + CONSTRAINT fk_ti_transmittal FOREIGN KEY (transmittal_id) REFERENCES transmittals(correspondence_id) ON DELETE CASCADE, + CONSTRAINT fk_ti_technical_doc FOREIGN KEY (technical_doc_id) REFERENCES rfas(id) ON DELETE CASCADE +) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_general_ci COMMENT='รายการเอกสารที่แนบใน Transmittal'; + +-- 1.14 rfa_items Table: RFA ↔ rfas (RFA เป็นชนิดหนึ่งของ correspondences) +CREATE TABLE rfa_items ( + rfa_correspondence_id INT NOT NULL, -- FK to correspondences.correspondence_id (type=RFA) + technical_doc_id INT NOT NULL UNIQUE, -- one techdoc appears in at most one RFA + PRIMARY KEY (rfa_correspondence_id, technical_doc_id), + CONSTRAINT fk_rfa_corr FOREIGN KEY (rfa_correspondence_id) REFERENCES correspondences(correspondence_id) ON UPDATE CASCADE ON DELETE CASCADE, + CONSTRAINT fk_rfa_tech FOREIGN KEY (technical_doc_id) REFERENCES rfas(id) ON UPDATE CASCADE ON DELETE CASCADE +) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_general_ci; + +CREATE INDEX idx_rfaitems_rfa ON rfa_items(rfa_correspondence_id); +CREATE INDEX idx_rfaitems_techdoc ON rfa_items(technical_doc_id); + +-- 1.15 correspondence_routing_template_steps Table: ตารางสำหรับเก็บขั้นตอนของแต่ละแม่แบบ +CREATE TABLE correspondence_routing_template_steps ( + step_id INT NOT NULL AUTO_INCREMENT PRIMARY KEY COMMENT 'ID ของขั้นตอน', + template_id INT NOT NULL COMMENT 'ID ของแม่แบบ', + sequence INT NOT NULL COMMENT 'ลำดับขั้นตอน', + to_org_id INT NOT NULL COMMENT 'ID องค์กรผู้รับในขั้นตอนนี้', + step_purpose ENUM('FOR_APPROVAL', 'FOR_REVIEW', 'FOR_INFORMATION') NOT NULL DEFAULT 'FOR_REVIEW' COMMENT 'วัตถุประสงค์ของขั้นตอนนี้', + + UNIQUE KEY ux_routing_template_sequence (template_id, sequence), + CONSTRAINT fk_crts_template FOREIGN KEY (template_id) REFERENCES correspondence_routing_templates(template_id) ON DELETE CASCADE, + CONSTRAINT fk_crts_org FOREIGN KEY (to_org_id) REFERENCES organizations(org_id) ON DELETE CASCADE +) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_general_ci COMMENT='ขั้นตอนในแม่แบบการส่งต่อเอกสาร'; + +-- 1.16 correspondence_routing_steps Table: ตารางสำหรับติดตามขั้นตอนการส่งต่อเอกสารทั่วไป +CREATE TABLE correspondence_routing_steps ( + routing_step_id INT NOT NULL AUTO_INCREMENT PRIMARY KEY COMMENT 'ID ของขั้นตอน', + correspondence_id INT NOT NULL COMMENT 'ID ของเอกสารที่ถูกส่งต่อ', + -- [ปรับปรุง] เพิ่มคอลัมน์สำหรับอ้างอิงถึงแม่แบบ + template_id INT NULL COMMENT 'ID ของแม่แบบที่ใช้ (ถ้ามี)', + sequence INT NOT NULL COMMENT 'ลำดับของขั้นตอนการส่งต่อ', + from_org_id INT NOT NULL COMMENT 'ID ขององค์กรผู้ส่ง', + to_org_id INT NOT NULL COMMENT 'ID ขององค์กรผู้รับ', + step_purpose ENUM('FOR_APPROVAL', 'FOR_REVIEW', 'FOR_INFORMATION') NOT NULL DEFAULT 'FOR_REVIEW' COMMENT 'วัตถุประสงค์ของขั้นตอนนี้ เช่น เพื่ออนุมัติ, เพื่อตรวจสอบ, หรือเพื่อรับทราบ', + status ENUM('SENT', 'RECEIVED', 'ACTIONED', 'FORWARDED', 'REPLIED') NOT NULL DEFAULT 'SENT' COMMENT 'สถานะการดำเนินการของเอกสารในขั้นตอนนี้', + comments TEXT 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_corr_routing_sequence (correspondence_id, sequence), + -- Foreign Keys + CONSTRAINT fk_crs_correspondence FOREIGN KEY (correspondence_id) REFERENCES correspondences(correspondence_id) ON DELETE CASCADE, + -- หมายเหตุ: Script สำหรับสร้างตาราง correspondence_routing_templates ต้องถูกรันก่อนไฟล์นี้ + CONSTRAINT fk_crs_template FOREIGN KEY (template_id) REFERENCES correspondence_routing_templates(template_id) ON DELETE SET NULL, + CONSTRAINT fk_crs_from_org FOREIGN KEY (from_org_id) REFERENCES organizations(org_id) ON DELETE CASCADE, + CONSTRAINT fk_crs_to_org FOREIGN KEY (to_org_id) REFERENCES organizations(org_id) ON DELETE CASCADE, + CONSTRAINT fk_crs_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 Create a new, unified recipients table +CREATE TABLE correspondence_recipients ( + correspondence_id INT NOT NULL COMMENT 'ID ของเอกสาร (FK -> correspondences)', + recipient_org_id INT NOT NULL COMMENT 'ID ขององค์กรผู้รับ (FK -> organizations)', + recipient_type ENUM('TO', 'CC') NOT NULL COMMENT 'ประเภทผู้รับ (To=หลัก, CC=สำเนา)', + + PRIMARY KEY (correspondence_id, recipient_org_id, recipient_type), + + KEY idx_cr_corr (correspondence_id), + KEY idx_cr_org (recipient_org_id), + + CONSTRAINT fk_cr_correspondence FOREIGN KEY (correspondence_id) REFERENCES correspondences(correspondence_id) ON DELETE CASCADE ON UPDATE CASCADE, + CONSTRAINT fk_cr_organization FOREIGN KEY (recipient_org_id) REFERENCES organizations(org_id) ON DELETE RESTRICT ON UPDATE CASCADE +) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_general_ci COMMENT='ตารางเชื่อมผู้รับเอกสาร (รองรับ To/CC หลายองค์กร)'; + +-- 1.18 correspondence_references Table: cross references between correspondences +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(correspondence_id) ON UPDATE CASCADE ON DELETE CASCADE, + CONSTRAINT fk_ref_tgt FOREIGN KEY (tgt_correspondence_id) REFERENCES correspondences(correspondence_id) ON UPDATE CASCADE ON DELETE CASCADE +) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_general_ci COMMENT='ตารางเชื่อมโยงความสัมพันธ์ระหว่างหนังสือ'; + +-- 1.19 project_parties Table: enforce <=1 contractor per project via generated column + unique index +CREATE TABLE project_parties ( + project_id INT NOT NULL COMMENT 'ID ของโครงการ', + org_id INT NOT NULL COMMENT, + 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, org_id, role), + UNIQUE KEY uq_project_parties_contractor (project_id, is_contractor), + CONSTRAINT fk_pp_project FOREIGN KEY (project_id) REFERENCES projects(project_id) ON DELETE CASCADE ON UPDATE CASCADE, + CONSTRAINT fk_pp_org FOREIGN KEY (org_id) REFERENCES organizations(org_id) ON DELETE RESTRICT ON UPDATE CASCADE + ) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_general_ci COMMENT='ตารางเชื่อมระหว่างโครงการและองค์กรที่มีบทบาทต่างๆ'; + +INSERT INTO project_parties (`project_id`, `org_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.20 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 ของโครงการ', + org_id INT NOT NULL COMMENT 'ID ขององค์กร', + PRIMARY KEY (contract_id, project_id, org_id), + CONSTRAINT fk_cp_contract FOREIGN KEY (contract_id) REFERENCES contracts(contract_id) ON DELETE CASCADE ON UPDATE CASCADE, + CONSTRAINT fk_cp_project FOREIGN KEY (project_id) REFERENCES projects(project_id) ON DELETE CASCADE ON UPDATE CASCADE, + CONSTRAINT fk_cp_org FOREIGN KEY (org_id) REFERENCES organizations(org_id) ON DELETE CASCADE ON UPDATE CASCADE +) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_general_ci COMMENT='ตารางเชื่อมระหว่างสัญญา โครงการ และองค์กรที่เกี่ยวข้อง'; + +INSERT INTO contract_parties (org_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), (41, 3, 4), (41, 4, 5), (41, 5, 6); + +-- 1.21 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)'; + +-- xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx +-- SUPER_ADMIN: all permissions (disambiguated columns with aliases) +INSERT IGNORE INTO role_permissions (role_id, permission_id) +SELECT r.role_id, p.permission_id +FROM roles AS r +CROSS JOIN permissions AS p +WHERE r.role_code='SUPER_ADMIN'; + +-- ADMIN: all except superadmin.access (scope enforced app-side) +INSERT IGNORE INTO role_permissions (role_id, permission_id) +SELECT r.role_id, p.permission_id +FROM roles AS r +JOIN permissions AS p ON p.permission_code <> 'superadmin.access' +WHERE r.role_code='ADMIN'; + +-- EDITOR: operational set +INSERT IGNORE INTO role_permissions (role_id, permission_id) +SELECT r.role_id, p.permission_id +FROM roles AS r +JOIN permissions AS p ON p.permission_code IN ( + 'projects.view','project_parties.manage', + 'drawings.view','drawings.upload', + 'documents.view','documents.manage', + 'materials.view','materials.manage', + 'ms.view','ms.manage', + 'rfas.view','rfas.create','rfas.respond', + 'corr.view','corr.manage', + 'transmittals.manage','reports.view' +) +WHERE r.role_code='EDITOR'; + +-- VIEWER: read-only set +INSERT IGNORE INTO role_permissions (role_id, permission_id) +SELECT r.role_id, p.permission_id +FROM roles AS r +JOIN permissions AS p ON p.permission_code IN ( + 'projects.view','organizations.view','drawings.view','documents.view','materials.view','ms.view','rfas.view','corr.view','reports.view' +) +WHERE r.role_code='VIEWER'; + +-- 1.22 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.23 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(project_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 as EDITOR in project LCBP3C1) +INSERT IGNORE INTO user_project_roles (user_id, project_id, role_id) +SELECT u.user_id, p.project_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='superadmin'; + +-- Sample seed for user_project_roles (assign superadmin as VIEWER in project LCBP3C2) +INSERT IGNORE INTO user_project_roles (user_id, project_id, role_id) +SELECT u.user_id, p.project_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='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.project_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 viewer01 as VIEWER in project LCBP3C2 +INSERT IGNORE INTO user_project_roles (user_id, project_id, role_id) +SELECT u.user_id, p.project_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.24 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 + Current Revision) +CREATE VIEW v_current_correspondences AS +SELECT + co.correspondence_id, + co.correspondence_number, + co.project_id, + co.correspondence_type_id, + cr.correspondence_revision_id, + cr.revision_number, + cr.revision_label, + cr.correspondence_status_id, + cr.title, + cr.keywords, + co.originator_id, + co.recipient_id, + cr.issued_date, + -- cr.pdf_path, + cr.details, + co.created_at AS correspondence_created_at, + cr.created_at AS revision_created_at, + co.latest_revision_number +FROM correspondences co +INNER JOIN correspondence_revisions cr + ON co.current_revision_id = cr.correspondence_revision_id +WHERE co.deleted_at IS NULL; + +-- ========================================================== +-- Procedure Creation +-- ========================================================== +-- P.1. Stored Procedure สำหรับสร้าง Revision ใหม่ +DELIMITER $$ + +CREATE PROCEDURE sp_create_correspondence_revision( + IN p_correspondence_id INT, + IN p_title VARCHAR(255), + IN p_originator_id INT, + IN p_recipient_id INT, + IN p_status_id INT, + IN p_created_by INT, + IN p_change_reason TEXT, + OUT p_revision_id INT +) +BEGIN + DECLARE v_next_revision_number INT; + DECLARE v_revision_label VARCHAR(10); + DECLARE v_correspondence_type_id INT; + + -- Get correspondence_type + SELECT correspondence_type_id + INTO v_correspondence_type_id + FROM correspondences + WHERE correspondence_id = p_correspondence_id; + + -- Get next revision number + SELECT COALESCE(MAX(revision_number), 0) + 1 + INTO v_next_revision_number + FROM correspondence_revisions + WHERE correspondence_id = p_correspondence_id; + + -- Generate label (A, B, C... or 0, 1, 2...) + IF v_correspondence_type_id = 1 THEN + IF v_next_revision_number = 0 THEN + SET v_revision_label = 'A'; + ELSE + SET v_revision_label = CHAR(65 + v_next_revision_number); -- B, C, D... + END IF; + ELSE + SET v_revision_label = CHAR(v_next_revision_number); + END IF; + + -- Mark all previous revisions as not current + UPDATE correspondence_revisions + SET is_current = FALSE + WHERE correspondence_id = p_correspondence_id; + + -- Insert new revision + INSERT INTO correspondence_revisions ( + correspondencer_id, revision_number, revision_label, + correspondence_status_id, is_current, + title, originator_id, recipient_id, + created_by, change_reason + ) VALUES ( + p_correspondence_id, v_next_revision_number, v_revision_label, + p_status_id, TRUE, + p_title, p_originator_id, p_recipient_id, + p_created_by, p_change_reason + ); + + SET p_revision_id = LAST_INSERT_ID(); + + -- Update master + UPDATE correspondence_master + SET + current_revision_id = p_revision_id, + latest_revision_number = v_next_revision_number + WHERE correspondence_id = p_correspondence_id; +END$$ + +DELIMITER ; + +SET FOREIGN_KEY_CHECKS=1; \ No newline at end of file diff --git a/docs/SQL/01_lcbp3_v1_1_0.sql b/docs/SQL/01_lcbp3_v1_1_0.sql new file mode 100644 index 0000000..87b7ec2 --- /dev/null +++ b/docs/SQL/01_lcbp3_v1_1_0.sql @@ -0,0 +1,1603 @@ +-- ========================================================== +-- DMS v1.0.2 Correspondence Improvements +-- Database v1.0 - 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.0.0 Initial Schema +-- DMS v1.0.1 Add missing relationship for Req 2.5.3, +-- Update: shop_drawing_revision_contract_refs Changed link to revision-level instead of master-level based on clarification. +-- DMS v1.0.2 Correspondence Improvements +-- Update: +-- 1. (Files) Consolidate file management: +-- - DROPs `pdf_path` from `correspondences` +-- - ADDs `is_main_document` to `attachments` +-- 2. (Recipients) Make recipients more flexible: +-- - DROPs `recipient_id` from `correspondences` +-- - DROPs `correspondence_cc_recipients` table +-- - CREATES `correspondence_recipients` (M:N table with TO/CC type) +-- 3. (Search) Remove keyword redundancy: +-- - DROPs `keywords` from `correspondences` (use `tags` system instead) +-- 4. (Change) corr_id -> correspondence_id for consistency +-- 5. (Change) revision VARCHAR(50) NULL in correspondences to support alphanumeric revisions รูปแบบ (A-Z?) → ตัวอักษร A-Z ตามด้วยตัวเลข 0 ตัวหรือมากกว่า (เช่น A, A1, B10), ตัวเลขล้วน หรือ ตัวเลขทศนิยม (เช่น 1, 2.1, 10.5) +-- 6. (Change) Changed tecnicaldoc to rfa (Requested_for_Approval) +-- DMS v1.1.0 Improvements +-- Update: +-- 1. แก้ไข/ปรบปรุง โครงสร้างตาราง correspondences และตารางที่เกี่ยวข้อง +-- 2. แก้ไข/ปรบปรุง โครงสร้างตาราง rfas และตารางที่เกี่ยวข้อง +-- 3. แก้ไข/ปรบปรุง โครงสร้างตาราง circulations และตารางที่เกี่ยวข้อง +-- 4. แก้ไข/ปรบปรุง โครงสร้างตาราง transmittals และตารางที่เกี่ยวข้อง +-- 5. แก้ไข/ปรบปรุง โครงสร้างตาราง shop_drawings และตารางที่เกี่ยวข้อง +-- 6. เพิ่ม ตารางที่เกี่ยวกับ routings(correspondences) และตารางที่เกี่ยวข้อง +-- 7. เพิ่ม ตารางที่เกี่ยวกับ work_flows(rfas) และตารางที่เกี่ยวข้อง +-- 8. เพิ่ม Views/Triggers/Procedures +-- ========================================================== + +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; + +-- 1.12.3 +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; + +-- 1.2 +DROP TABLE IF EXISTS attachments; + +-- 1.1 +DROP TABLE IF EXISTS global_default_roles; + + +-- 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 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; + +-- Views +DROP VIEW IF EXISTS v_current_rfas; +DROP VIEW IF EXISTS v_current_correspondences; +DROP VIEW IF EXISTS v_contract_parties_all; +-- Procedure +DROP PROCEDURE IF EXISTS sp_create_correspondence_revision; + +-- ========================================================== +-- Table Creation +-- ========================================================== +-- Level 5: Organizations +-- ========================================================== +-- 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 role +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), + ('EDITOR', 'Editor', 'Can create/edit RFA/Drawings/Docs/Transmittals' ,1), + ('VIEWER', 'Viewer', 'Read-only access' ,0), + ('GUEST', 'Guest', 'Limited read-only access' ,0) +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'; +-- Seed permission +INSERT INTO permissions (permission_code, description, module, scope_level) VALUES + -- System + ('superadmin.access','Access Everything (All Orgs)','admin','GLOBAL'), + ('admin.access','Access Admin Panel (scoped)','admin','ORG'), + ('settings.manage','Manage Settings','admin','GLOBAL'), + -- Projects & Parties + ('projects.view','View Projects','projects','ORG'), + ('projects.manage','Create/Edit/Delete Projects','projects','ORG'), + ('project_parties.manage','Manage Project Parties','projects','ORG'), + -- Organizations + ('organizations.view','View Organizations','organizations','GLOBAL'), + ('organizations.manage','Manage Organizations','organizations','GLOBAL'), + -- Drawings + ('drawings.view','View Drawings','drawings','PROJECT'), + ('drawings.upload','Upload Drawing Revisions','drawings','PROJECT'), + ('drawings.delete','Delete Drawings/Revisions','drawings','PROJECT'), + -- Documents/Materials/MS + ('documents.view','View Documents','documents','PROJECT'), + ('documents.manage','Manage Documents/Revisions','documents','PROJECT'), + ('materials.view','View Materials','materials','PROJECT'), + ('materials.manage','Manage Materials/Revisions','materials','PROJECT'), + ('ms.view','View Method Statements','ms','PROJECT'), + ('ms.manage','Manage Method Statements/Revisions','ms','PROJECT'), + -- RFAs + ('rfas.view','View RFAs','rfas','PROJECT'), + ('rfas.create','Create RFA','rfas','PROJECT'), + ('rfas.respond','Respond / Update RFA','rfas','PROJECT'), + ('rfas.delete','Delete RFA','rfas','PROJECT'), + -- Correspondence & Transmittal & Circulation + ('corr.view','View Correspondences','correspondence','PROJECT'), + ('corr.manage','Manage Correspondences','correspondence','PROJECT'), + ('transmittals.manage','Manage Transmittals','transmittal','PROJECT'), + ('cirs.manage','Manage Circulations','circulation','ORG'), + -- Reports + ('reports.view','View Reports','reports','GLOBAL') +ON DUPLICATE KEY UPDATE + description=VALUES(description), + module=VALUES(module), + scope_level=VALUES(scope_level), + is_active=1; + +-- 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)', ''), + ('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); + +-- ========================================================== +-- 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 + + 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_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 cir_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 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 'วันที่แก้ไขล่าสุด', + + 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 'วันที่แก้ไขล่าสุด', + + 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 +CREATE TABLE rfa_revisions ( + -- Primary Key & One-to-One with correspondences + correspondence_id INT NOT NULL PRIMARY KEY 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)', + + 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); + +-- 2.9.1 correspondence_revisions Table: ตารางสำหรับเก็บประวัติการแก้ไขเอกสาร (Revision History) +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 PRIMARY KEY 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 'ผู้แก้ไขล่าสุด', + + 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); + +-- 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='แม่แบบสายงานการส่งต่อเอกสารขออนุมัติ'; + + +-- ========================================================== +-- 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='ตารางกลางสำหรับเก็บข้อมูลไฟล์แนบ'; + +/* =========================================================== + 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_dwg_sub_cat (project_id, sub_cat_id) ON UPDATE CASCADE ON DELETE CASCADE, + CONSTRAINT fk_map_cat FOREIGN KEY (project_id, cat_id) REFERENCES contract_dwg_cat (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 VARCHAR(10) NOT NULL COMMENT 'หมายเลข Revision (เช่น A, B, 0, 1)', + 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 'วันที่สร้าง', + + 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)', + rfarev_id INT NOT NULL COMMENT 'ID ของเอกสารทางเทคนิคที่แนบไป', + quantity INT NOT NULL DEFAULT 1 COMMENT 'จำนวน', + remarks VARCHAR(255) COMMENT 'หมายเหตุสำหรับรายการนี้', + + -- ป้องกันการเพิ่มเอกสารเดิมซ้ำใน Transmittal ฉบับเดียวกัน + UNIQUE KEY ux_transmittal_item (transmittal_id, rfarev_id), + + -- Foreign Keys + CONSTRAINT fk_ti_transmittal FOREIGN KEY (transmittal_id) REFERENCES transmittals(correspondence_id) ON DELETE CASCADE, + CONSTRAINT fk_ti_rfarev FOREIGN KEY (rfarev_id) REFERENCES rfa_revisions(correspondence_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 cir_status_codes(code), + CONSTRAINT fk_cstt_to FOREIGN KEY (to_status_code) REFERENCES cir_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 TIMESTAMP 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 'ความคิดเห็นหรือหมายเหตุจากองค์กร', + 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 'หมายเหตุ หรือความคิดเห็นในการส่งต่อ', + 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 การส่งต่อเอกสารทั่วไป'; + +-- 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)'; + +-- xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx +-- SUPER_ADMIN: all permissions (disambiguated columns with aliases) +INSERT IGNORE INTO role_permissions (role_id, permission_id) +SELECT r.role_id, p.permission_id +FROM roles AS r +CROSS JOIN permissions AS p +WHERE r.role_code='SUPER_ADMIN'; + +-- ADMIN: all except superadmin.access (scope enforced app-side) +INSERT IGNORE INTO role_permissions (role_id, permission_id) +SELECT r.role_id, p.permission_id +FROM roles AS r +JOIN permissions AS p ON p.permission_code <> 'superadmin.access' +WHERE r.role_code='ADMIN'; + +-- EDITOR: operational set +INSERT IGNORE INTO role_permissions (role_id, permission_id) +SELECT r.role_id, p.permission_id +FROM roles AS r +JOIN permissions AS p ON p.permission_code IN ( + 'projects.view','project_parties.manage', + 'drawings.view','drawings.upload', + 'documents.view','documents.manage', + 'materials.view','materials.manage', + 'ms.view','ms.manage', + 'rfas.view','rfas.create','rfas.respond', + 'corr.view','corr.manage', + 'transmittals.manage','reports.view' +) +WHERE r.role_code='EDITOR'; + +-- VIEWER: read-only set +INSERT IGNORE INTO role_permissions (role_id, permission_id) +SELECT r.role_id, p.permission_id +FROM roles AS r +JOIN permissions AS p ON p.permission_code IN ( + 'projects.view','organizations.view','drawings.view','documents.view','materials.view','ms.view','rfas.view','corr.view','reports.view' +) +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 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='superadmin'; + +-- Sample seed for user_project_roles (assign superadmin 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='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 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; + +-- ========================================================== +-- Procedure Creation +-- ========================================================== +-- P.1. Stored Procedure สำหรับสร้าง Revision ใหม่ +DELIMITER $$ + +CREATE PROCEDURE sp_create_correspondence_revision( + IN p_correspondence_id INT, + IN p_title VARCHAR(255), + IN p_originator_id INT, + IN p_recipient_id INT, + IN p_status_id INT, + IN p_created_by INT, + IN p_change_reason TEXT, + OUT p_revision_id INT +) +BEGIN + DECLARE v_next_revision_number INT; + DECLARE v_revision_label VARCHAR(10); + DECLARE v_correspondence_type_id INT; + + -- Get correspondence_type + SELECT correspondence_type_id + INTO v_correspondence_type_id + FROM correspondences + WHERE correspondence_id = p_correspondence_id; + + -- Get next revision number + SELECT COALESCE(MAX(revision_number), 0) + 1 + INTO v_next_revision_number + FROM correspondence_revisions + WHERE correspondence_id = p_correspondence_id; + + -- Generate label (A, B, C... or 0, 1, 2...) + IF v_correspondence_type_id = 1 THEN + IF v_next_revision_number = 0 THEN + SET v_revision_label = 'A'; + ELSE + SET v_revision_label = CHAR(65 + v_next_revision_number); -- B, C, D... + END IF; + ELSE + SET v_revision_label = CHAR(v_next_revision_number); + END IF; + + -- Mark all previous revisions as not current + UPDATE correspondence_revisions + SET is_current = FALSE + WHERE correspondence_id = p_correspondence_id; + + -- Insert new revision + INSERT INTO correspondence_revisions ( + correspondence_id, revision_number, revision_label, + correspondence_status_id, is_current, + title, originator_id, recipient_id, + created_by, change_reason + ) VALUES ( + p_correspondence_id, v_next_revision_number, v_revision_label, + p_status_id, TRUE, + p_title, p_originator_id, p_recipient_id, + p_created_by, p_change_reason + ); + + SET p_revision_id = LAST_INSERT_ID(); + + -- Update master + UPDATE correspondence_master + SET + current_revision_id = p_revision_id, + latest_revision_number = v_next_revision_number + WHERE correspondence_id = p_correspondence_id; +END$$ + +DELIMITER ; + +SET FOREIGN_KEY_CHECKS=1; \ No newline at end of file diff --git a/docs/SQL/01_lcbp3_v1_1_1.sql b/docs/SQL/01_lcbp3_v1_1_1.sql new file mode 100644 index 0000000..8145ca7 --- /dev/null +++ b/docs/SQL/01_lcbp3_v1_1_1.sql @@ -0,0 +1,1660 @@ +-- ========================================================== +-- DMS v1.0.2 Correspondence Improvements +-- Database v1.0 - 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.0.0 Initial Schema +-- DMS v1.0.1 Add missing relationship for Req 2.5.3, +-- Update: shop_drawing_revision_contract_refs Changed link to revision-level instead of master-level based on clarification. +-- DMS v1.0.2 Correspondence Improvements +-- Update: +-- 1. (Files) Consolidate file management: +-- - DROPs `pdf_path` from `correspondences` +-- - ADDs `is_main_document` to `attachments` +-- 2. (Recipients) Make recipients more flexible: +-- - DROPs `recipient_id` from `correspondences` +-- - DROPs `correspondence_cc_recipients` table +-- - CREATES `correspondence_recipients` (M:N table with TO/CC type) +-- 3. (Search) Remove keyword redundancy: +-- - DROPs `keywords` from `correspondences` (use `tags` system instead) +-- 4. (Change) corr_id -> correspondence_id for consistency +-- 5. (Change) revision VARCHAR(50) NULL in correspondences to support alphanumeric revisions รูปแบบ (A-Z?) → ตัวอักษร A-Z ตามด้วยตัวเลข 0 ตัวหรือมากกว่า (เช่น A, A1, B10), ตัวเลขล้วน หรือ ตัวเลขทศนิยม (เช่น 1, 2.1, 10.5) +-- 6. (Change) Changed tecnicaldoc to rfa (Requested_for_Approval) +-- DMS v1.1.0 Improvements +-- Update: +-- 1. แก้ไข/ปรบปรุง โครงสร้างตาราง correspondences และตารางที่เกี่ยวข้อง +-- 2. แก้ไข/ปรบปรุง โครงสร้างตาราง rfas และตารางที่เกี่ยวข้อง +-- 3. แก้ไข/ปรบปรุง โครงสร้างตาราง circulations และตารางที่เกี่ยวข้อง +-- 4. แก้ไข/ปรบปรุง โครงสร้างตาราง transmittals และตารางที่เกี่ยวข้อง +-- 5. แก้ไข/ปรบปรุง โครงสร้างตาราง shop_drawings และตารางที่เกี่ยวข้อง +-- 6. เพิ่ม ตารางที่เกี่ยวกับ routings(correspondences) และตารางที่เกี่ยวข้อง +-- 7. เพิ่ม ตารางที่เกี่ยวกับ work_flows(rfas) และตารางที่เกี่ยวข้อง +-- 8. เพิ่ม Views/Triggers/Procedures +-- ========================================================== + +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; + +-- 1.12.3 +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; + + +-- 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 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; + +-- Views +DROP VIEW IF EXISTS v_current_rfas; +DROP VIEW IF EXISTS v_current_correspondences; +DROP VIEW IF EXISTS v_contract_parties_all; +-- Procedure +DROP PROCEDURE IF EXISTS sp_create_correspondence_revision; + +-- ========================================================== +-- Table Creation +-- ========================================================== +-- Level 5: Organizations +-- ========================================================== +-- 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 role +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), + ('EDITOR', 'Editor', 'Can create/edit RFA/Drawings/Docs/Transmittals' ,1), + ('VIEWER', 'Viewer', 'Read-only access' ,0), + ('GUEST', 'Guest', 'Limited read-only access' ,0) +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'; +-- Seed permission +INSERT INTO permissions (permission_code, description, module, scope_level) VALUES + -- System + ('superadmin.access','Access Everything (All Orgs)','admin','GLOBAL'), + ('admin.access','Access Admin Panel (scoped)','admin','ORG'), + ('settings.manage','Manage Settings','admin','GLOBAL'), + -- Projects & Parties + ('projects.view','View Projects','projects','ORG'), + ('projects.manage','Create/Edit/Delete Projects','projects','ORG'), + ('project_parties.manage','Manage Project Parties','projects','ORG'), + -- Organizations + ('organizations.view','View Organizations','organizations','GLOBAL'), + ('organizations.manage','Manage Organizations','organizations','GLOBAL'), + -- Drawings + ('drawings.view','View Drawings','drawings','PROJECT'), + ('drawings.upload','Upload Drawing Revisions','drawings','PROJECT'), + ('drawings.delete','Delete Drawings/Revisions','drawings','PROJECT'), + -- Documents/Materials/MS + ('documents.view','View Documents','documents','PROJECT'), + ('documents.manage','Manage Documents/Revisions','documents','PROJECT'), + ('materials.view','View Materials','materials','PROJECT'), + ('materials.manage','Manage Materials/Revisions','materials','PROJECT'), + ('ms.view','View Method Statements','ms','PROJECT'), + ('ms.manage','Manage Method Statements/Revisions','ms','PROJECT'), + -- RFAs + ('rfas.view','View RFAs','rfas','PROJECT'), + ('rfas.create','Create RFA','rfas','PROJECT'), + ('rfas.respond','Respond / Update RFA','rfas','PROJECT'), + ('rfas.delete','Delete RFA','rfas','PROJECT'), + -- Correspondence & Transmittal & Circulation + ('corr.view','View Correspondences','correspondence','PROJECT'), + ('corr.manage','Manage Correspondences','correspondence','PROJECT'), + ('transmittals.manage','Manage Transmittals','transmittal','PROJECT'), + ('cirs.manage','Manage Circulations','circulation','ORG'), + -- Reports + ('reports.view','View Reports','reports','GLOBAL') +ON DUPLICATE KEY UPDATE + description=VALUES(description), + module=VALUES(module), + scope_level=VALUES(scope_level), + is_active=1; + +-- 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); + +-- ========================================================== +-- 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 + + 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_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 cir_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 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 'วันที่แก้ไขล่าสุด', + + 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 'วันที่แก้ไขล่าสุด', + + 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 +CREATE TABLE rfa_revisions ( + -- Primary Key & One-to-One with correspondences + correspondence_id INT NOT NULL PRIMARY KEY 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)', + + 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); + +-- 2.9.1 correspondence_revisions Table: ตารางสำหรับเก็บประวัติการแก้ไขเอกสาร (Revision History) +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 PRIMARY KEY 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 'ผู้แก้ไขล่าสุด', + + 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); + +-- 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='แม่แบบสายงานการส่งต่อเอกสารขออนุมัติ'; + + +-- ========================================================== +-- 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 ต้นฉบับ)', + 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 ต้นฉบับ)', + 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_dwg_sub_cat (project_id, sub_cat_id) ON UPDATE CASCADE ON DELETE CASCADE, + CONSTRAINT fk_map_cat FOREIGN KEY (project_id, cat_id) REFERENCES contract_dwg_cat (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 VARCHAR(10) NOT NULL COMMENT 'หมายเลข Revision (เช่น A, B, 0, 1)', + 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 'วันที่สร้าง', + + 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)', + rfarev_id INT NOT NULL COMMENT 'ID ของเอกสารทางเทคนิคที่แนบไป', + quantity INT NOT NULL DEFAULT 1 COMMENT 'จำนวน', + remarks VARCHAR(255) COMMENT 'หมายเหตุสำหรับรายการนี้', + + -- ป้องกันการเพิ่มเอกสารเดิมซ้ำใน Transmittal ฉบับเดียวกัน + UNIQUE KEY ux_transmittal_item (transmittal_id, rfarev_id), + + -- Foreign Keys + CONSTRAINT fk_ti_transmittal FOREIGN KEY (transmittal_id) REFERENCES transmittals(correspondence_id) ON DELETE CASCADE, + CONSTRAINT fk_ti_rfarev FOREIGN KEY (rfarev_id) REFERENCES rfa_revisions(correspondence_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 cir_status_codes(code), + CONSTRAINT fk_cstt_to FOREIGN KEY (to_status_code) REFERENCES cir_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 TIMESTAMP 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 'ความคิดเห็นหรือหมายเหตุจากองค์กร', + 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 'หมายเหตุ หรือความคิดเห็นในการส่งต่อ', + 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 การส่งต่อเอกสารทั่วไป'; + +-- 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)'; + +-- xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx +-- SUPER_ADMIN: all permissions (disambiguated columns with aliases) +INSERT IGNORE INTO role_permissions (role_id, permission_id) +SELECT r.role_id, p.permission_id +FROM roles AS r +CROSS JOIN permissions AS p +WHERE r.role_code='SUPER_ADMIN'; + +-- ADMIN: all except superadmin.access (scope enforced app-side) +INSERT IGNORE INTO role_permissions (role_id, permission_id) +SELECT r.role_id, p.permission_id +FROM roles AS r +JOIN permissions AS p ON p.permission_code <> 'superadmin.access' +WHERE r.role_code='ADMIN'; + +-- EDITOR: operational set +INSERT IGNORE INTO role_permissions (role_id, permission_id) +SELECT r.role_id, p.permission_id +FROM roles AS r +JOIN permissions AS p ON p.permission_code IN ( + 'projects.view','project_parties.manage', + 'drawings.view','drawings.upload', + 'documents.view','documents.manage', + 'materials.view','materials.manage', + 'ms.view','ms.manage', + 'rfas.view','rfas.create','rfas.respond', + 'corr.view','corr.manage', + 'transmittals.manage','reports.view' +) +WHERE r.role_code='EDITOR'; + +-- VIEWER: read-only set +INSERT IGNORE INTO role_permissions (role_id, permission_id) +SELECT r.role_id, p.permission_id +FROM roles AS r +JOIN permissions AS p ON p.permission_code IN ( + 'projects.view','organizations.view','drawings.view','documents.view','materials.view','ms.view','rfas.view','corr.view','reports.view' +) +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 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='superadmin'; + +-- Sample seed for user_project_roles (assign superadmin 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='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 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; + +-- ========================================================== +-- Procedure Creation +-- ========================================================== +-- P.1. Stored Procedure สำหรับสร้าง Revision ใหม่ +DELIMITER $$ + +CREATE PROCEDURE sp_create_correspondence_revision( + IN p_correspondence_id INT, + IN p_title VARCHAR(255), + IN p_originator_id INT, + IN p_recipient_id INT, + IN p_status_id INT, + IN p_created_by INT, + IN p_change_reason TEXT, + OUT p_revision_id INT +) +BEGIN + DECLARE v_next_revision_number INT; + DECLARE v_revision_label VARCHAR(10); + DECLARE v_correspondence_type_id INT; + + -- Get correspondence_type + SELECT correspondence_type_id + INTO v_correspondence_type_id + FROM correspondences + WHERE correspondence_id = p_correspondence_id; + + -- Get next revision number + SELECT COALESCE(MAX(revision_number), 0) + 1 + INTO v_next_revision_number + FROM correspondence_revisions + WHERE correspondence_id = p_correspondence_id; + + -- Generate label (A, B, C... or 0, 1, 2...) + IF v_correspondence_type_id = 1 THEN + IF v_next_revision_number = 0 THEN + SET v_revision_label = 'A'; + ELSE + SET v_revision_label = CHAR(65 + v_next_revision_number); -- B, C, D... + END IF; + ELSE + SET v_revision_label = CHAR(v_next_revision_number); + END IF; + + -- Mark all previous revisions as not current + UPDATE correspondence_revisions + SET is_current = FALSE + WHERE correspondence_id = p_correspondence_id; + + -- Insert new revision + INSERT INTO correspondence_revisions ( + correspondence_id, revision_number, revision_label, + correspondence_status_id, is_current, + title, originator_id, recipient_id, + created_by, change_reason + ) VALUES ( + p_correspondence_id, v_next_revision_number, v_revision_label, + p_status_id, TRUE, + p_title, p_originator_id, p_recipient_id, + p_created_by, p_change_reason + ); + + SET p_revision_id = LAST_INSERT_ID(); + + -- Update master + UPDATE correspondence_master + SET + current_revision_id = p_revision_id, + latest_revision_number = v_next_revision_number + WHERE correspondence_id = p_correspondence_id; +END$$ + +DELIMITER ; + +SET FOREIGN_KEY_CHECKS=1; \ No newline at end of file diff --git a/docs/SQL/01_lcbp3_v1_2_0.sql b/docs/SQL/01_lcbp3_v1_2_0.sql new file mode 100644 index 0000000..b2c9f23 --- /dev/null +++ b/docs/SQL/01_lcbp3_v1_2_0.sql @@ -0,0 +1,1877 @@ +-- ========================================================== +-- DMS v1.0.2 Correspondence Improvements +-- Database v1.0 - 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.2.0 Improvements +-- Update: +-- 1. ปรับปรุง Seed Roles, Permissions, and Role-Permissions Mapping +-- 2. ปรับปรุงตาราง: correspondence_revisions, rfa_revisions +-- 3. เพิ่ม ตาราง: document_number_formats, document_number_counters +-- 4. สร้าง Stored Procedure ใหม่ (สำหรับ Document Numbering) sp_get_next_document_number +-- 5. สร้าง Views: v_user_tasks, v_audit_log_details, v_user_all_permissions +-- ========================================================== + +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; + +-- 1.12.3 +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 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; + +-- 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 +-- ========================================================== +-- 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); + +-- ========================================================== +-- 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 + + 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 'วันที่แก้ไขล่าสุด', + + 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 'วันที่แก้ไขล่าสุด', + + 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)', + + 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 'ผู้แก้ไขล่าสุด', + + 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)'; + +-- ========================================================== +-- 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_dwg_sub_cat (project_id, sub_cat_id) ON UPDATE CASCADE ON DELETE CASCADE, + CONSTRAINT fk_map_cat FOREIGN KEY (project_id, cat_id) REFERENCES contract_dwg_cat (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 VARCHAR(10) NOT NULL COMMENT 'หมายเลข Revision (เช่น A, B, 0, 1)', + 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 'วันที่สร้าง', + + 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 การส่งต่อเอกสารทั่วไป'; + +-- 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; \ No newline at end of file diff --git a/docs/SQL/01_lcbp3_v1_3_0.sql b/docs/SQL/01_lcbp3_v1_3_0.sql new file mode 100644 index 0000000..ebba55a --- /dev/null +++ b/docs/SQL/01_lcbp3_v1_3_0.sql @@ -0,0 +1,1870 @@ +-- ========================================================== +-- DMS v1.3.0 Correspondence Improvements +-- Database v3.0 - 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.3.0 Improvements +-- Update: +-- ========================================================== + +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 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; + +-- 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 +-- ========================================================== +-- 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); + +-- ========================================================== +-- 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 + + 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 'วันที่แก้ไขล่าสุด', + + 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 'วันที่แก้ไขล่าสุด', + + 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)', + + 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 'ผู้แก้ไขล่าสุด', + + 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)'; + +-- ========================================================== +-- 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_dwg_sub_cat (project_id, sub_cat_id) ON UPDATE CASCADE ON DELETE CASCADE, + CONSTRAINT fk_map_cat FOREIGN KEY (project_id, cat_id) REFERENCES contract_dwg_cat (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 VARCHAR(10) NOT NULL COMMENT 'หมายเลข Revision (เช่น A, B, 0, 1)', + 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 'วันที่สร้าง', + + 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 การส่งต่อเอกสารทั่วไป'; + +-- 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; \ No newline at end of file diff --git a/docs/SQL/01_lcbp3_v1_3_0.txt b/docs/SQL/01_lcbp3_v1_3_0.txt new file mode 100644 index 0000000..ebba55a --- /dev/null +++ b/docs/SQL/01_lcbp3_v1_3_0.txt @@ -0,0 +1,1870 @@ +-- ========================================================== +-- DMS v1.3.0 Correspondence Improvements +-- Database v3.0 - 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.3.0 Improvements +-- Update: +-- ========================================================== + +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 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; + +-- 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 +-- ========================================================== +-- 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); + +-- ========================================================== +-- 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 + + 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 'วันที่แก้ไขล่าสุด', + + 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 'วันที่แก้ไขล่าสุด', + + 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)', + + 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 'ผู้แก้ไขล่าสุด', + + 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)'; + +-- ========================================================== +-- 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_dwg_sub_cat (project_id, sub_cat_id) ON UPDATE CASCADE ON DELETE CASCADE, + CONSTRAINT fk_map_cat FOREIGN KEY (project_id, cat_id) REFERENCES contract_dwg_cat (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 VARCHAR(10) NOT NULL COMMENT 'หมายเลข Revision (เช่น A, B, 0, 1)', + 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 'วันที่สร้าง', + + 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 การส่งต่อเอกสารทั่วไป'; + +-- 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; \ No newline at end of file diff --git a/docs/SQL/01_lcbp3_v1_4_0.sql b/docs/SQL/01_lcbp3_v1_4_0.sql new file mode 100644 index 0000000..044a12f --- /dev/null +++ b/docs/SQL/01_lcbp3_v1_4_0.sql @@ -0,0 +1,1923 @@ +-- ========================================================== +-- 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; \ No newline at end of file diff --git a/docs/SQL/01_lcbp3_v1_4_0.txt b/docs/SQL/01_lcbp3_v1_4_0.txt new file mode 100644 index 0000000..044a12f --- /dev/null +++ b/docs/SQL/01_lcbp3_v1_4_0.txt @@ -0,0 +1,1923 @@ +-- ========================================================== +-- 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; \ No newline at end of file diff --git a/docs/SQL/Cluad.sql b/docs/SQL/Cluad.sql new file mode 100644 index 0000000..c90fa6a --- /dev/null +++ b/docs/SQL/Cluad.sql @@ -0,0 +1,385 @@ +-- ปรับปรุงโครงสร้าง Correspondence เพื่อจัดการ Revisions ได้ดีขึ้น + +-- 1. แยก Master และ Revision ชัดเจน +CREATE TABLE correspondence_master ( + master_id INT AUTO_INCREMENT PRIMARY KEY, + correspondence_number VARCHAR(100) NOT NULL, + project_id INT NOT NULL, + correspondence_type_id INT NOT NULL, + + -- Metadata ที่ไม่เปลี่ยนแปลงตาม Revision + created_at DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP, + created_by INT NULL, + deleted_at DATETIME NULL, + + -- Track current/latest revision + current_revision_id INT NULL, + latest_revision_number INT NOT NULL DEFAULT 0, + + CONSTRAINT uq_corr_no_per_project UNIQUE (project_id, correspondence_number), + + CONSTRAINT fk_cm_project FOREIGN KEY (project_id) + REFERENCES projects(project_id) ON UPDATE CASCADE ON DELETE CASCADE, + CONSTRAINT fk_cm_type FOREIGN KEY (correspondence_type_id) + REFERENCES correspondence_types(type_id) ON UPDATE CASCADE ON DELETE RESTRICT, + CONSTRAINT fk_cm_created_by FOREIGN KEY (created_by) + REFERENCES users(user_id) ON UPDATE CASCADE ON DELETE SET NULL +) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_general_ci; + +-- 2. Revision ที่เก็บข้อมูลที่เปลี่ยนแปลงได้ +CREATE TABLE correspondence_revisions_new ( + revision_id INT AUTO_INCREMENT PRIMARY KEY, + master_id INT NOT NULL, + revision_number INT NOT NULL, -- เปลี่ยนเป็น INT เพื่อง่ายต่อการเรียงลำดับ + revision_label VARCHAR(10) NULL, -- A, B, C สำหรับแสดงผล + + -- สถานะเฉพาะของ Revision นี้ + correspondence_status_id INT NOT NULL, + is_current BOOLEAN NOT NULL DEFAULT FALSE, + + -- ข้อมูลที่เปลี่ยนแปลงตาม Revision + originator_id INT NULL, + recipient_id INT NULL, + title VARCHAR(255) NOT NULL, + keywords VARCHAR(255) NULL, + issued_date DATETIME NULL, + pdf_path VARCHAR(500) NULL, + details JSON NULL, + + -- Audit + created_at DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP, + created_by INT NULL, + change_reason TEXT NULL, + + CONSTRAINT uq_master_revision_number UNIQUE (master_id, revision_number), + CONSTRAINT uq_master_current UNIQUE (master_id, is_current), -- ใช้ partial unique index ได้ดีกว่า + + CONSTRAINT fk_cr_master FOREIGN KEY (master_id) + REFERENCES correspondence_master(master_id) ON UPDATE CASCADE ON DELETE CASCADE, + CONSTRAINT fk_cr_status FOREIGN KEY (correspondence_status_id) + REFERENCES correspondence_status(status_id) ON UPDATE CASCADE ON DELETE RESTRICT, + CONSTRAINT fk_cr_originator FOREIGN KEY (originator_id) + REFERENCES organizations(org_id) ON UPDATE CASCADE ON DELETE SET NULL, + CONSTRAINT fk_cr_recipient FOREIGN KEY (recipient_id) + REFERENCES organizations(org_id) ON UPDATE CASCADE ON DELETE SET NULL, + CONSTRAINT fk_cr_created_by FOREIGN KEY (created_by) + REFERENCES users(user_id) ON UPDATE CASCADE ON DELETE SET NULL +) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_general_ci; + +-- 3. Update current_revision_id FK +ALTER TABLE correspondence_master + ADD CONSTRAINT fk_cm_current_revision + FOREIGN KEY (current_revision_id) + REFERENCES correspondence_revisions_new(revision_id) + ON UPDATE CASCADE ON DELETE SET NULL; + +-- 4. View สำหรับ Query ง่าย (รวม Master + Current Revision) +CREATE OR REPLACE VIEW v_current_correspondences AS +SELECT + cm.master_id, + cm.correspondence_number, + cm.project_id, + cm.correspondence_type_id, + cr.revision_id, + cr.revision_number, + cr.revision_label, + cr.correspondence_status_id, + cr.title, + cr.keywords, + cr.originator_id, + cr.recipient_id, + cr.issued_date, + cr.pdf_path, + cr.details, + cm.created_at AS master_created_at, + cr.created_at AS revision_created_at, + cm.latest_revision_number +FROM correspondence_master cm +INNER JOIN correspondence_revisions_new cr + ON cm.current_revision_id = cr.revision_id +WHERE cm.deleted_at IS NULL; + +-- 5. Stored Procedure สำหรับสร้าง Revision ใหม่ +DELIMITER $$ + +CREATE PROCEDURE sp_create_correspondence_revision( + IN p_master_id INT, + IN p_title VARCHAR(255), + IN p_originator_id INT, + IN p_recipient_id INT, + IN p_status_id INT, + IN p_created_by INT, + IN p_change_reason TEXT, + OUT p_revision_id INT +) +BEGIN + DECLARE v_next_revision_number INT; + DECLARE v_revision_label VARCHAR(10); + + -- Get next revision number + SELECT COALESCE(MAX(revision_number), 0) + 1 + INTO v_next_revision_number + FROM correspondence_revisions_new + WHERE master_id = p_master_id; + + -- Generate label (0->Original, 1->A, 2->B, etc.) + IF v_next_revision_number = 0 THEN + SET v_revision_label = 'Original'; + ELSE + SET v_revision_label = CHAR(64 + v_next_revision_number); -- A, B, C... + END IF; + + -- Mark all previous revisions as not current + UPDATE correspondence_revisions_new + SET is_current = FALSE + WHERE master_id = p_master_id; + + -- Insert new revision + INSERT INTO correspondence_revisions_new ( + master_id, revision_number, revision_label, + correspondence_status_id, is_current, + title, originator_id, recipient_id, + created_by, change_reason + ) VALUES ( + p_master_id, v_next_revision_number, v_revision_label, + p_status_id, TRUE, + p_title, p_originator_id, p_recipient_id, + p_created_by, p_change_reason + ); + + SET p_revision_id = LAST_INSERT_ID(); + + -- Update master + UPDATE correspondence_master + SET + current_revision_id = p_revision_id, + latest_revision_number = v_next_revision_number + WHERE master_id = p_master_id; +END$$ + +DELIMITER ; + + + +-- ***************************************************** +-- ***************************************************** +-- ***************************************************** +-- ***************************************************** +-- ***************************************************** +-- ***************************************************** + +-- ปรับปรุง Technical Documents เพื่อความชัดเจนและเชื่อมโยงกับ Correspondence + +-- 1. Technical Document Master +CREATE TABLE technical_document_master ( + master_id INT AUTO_INCREMENT PRIMARY KEY, + document_number VARCHAR(100) NOT NULL, + document_type_id INT NOT NULL, + project_id INT NOT NULL, + title VARCHAR(255) NOT NULL, + + -- Link to RFA Correspondence (optional - เพราะอาจยังไม่ได้ส่ง RFA) + rfa_correspondence_id INT NULL, + + -- Tracking + current_revision_id INT NULL, + latest_revision_number INT NOT NULL DEFAULT 0, + + created_at DATETIME DEFAULT CURRENT_TIMESTAMP, + created_by INT NULL, + deleted_at DATETIME NULL, + + CONSTRAINT uq_techdoc_no_project UNIQUE (project_id, document_number), + + CONSTRAINT fk_tdm_type FOREIGN KEY (document_type_id) + REFERENCES technicaldoc_types(document_types_id), + CONSTRAINT fk_tdm_project FOREIGN KEY (project_id) + REFERENCES projects(project_id) ON DELETE CASCADE, + CONSTRAINT fk_tdm_rfa_corr FOREIGN KEY (rfa_correspondence_id) + REFERENCES correspondences(corr_id) ON DELETE SET NULL, + CONSTRAINT fk_tdm_created_by FOREIGN KEY (created_by) + REFERENCES users(user_id) ON DELETE SET NULL +) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_general_ci; + +-- 2. Technical Document Revisions +CREATE TABLE technical_document_revisions ( + revision_id INT AUTO_INCREMENT PRIMARY KEY, + master_id INT NOT NULL, + revision_number INT NOT NULL, + revision_label VARCHAR(10) NULL, -- A, B, C + + status_code_id INT NOT NULL, + approve_code_id INT NULL, + is_current BOOLEAN NOT NULL DEFAULT FALSE, + + -- File references + pdf_path VARCHAR(500) NULL, + dwg_path VARCHAR(500) NULL, -- สำหรับ DWG type + + -- Metadata + revision_description TEXT NULL, + submitted_date DATE NULL, + approved_date DATE NULL, + + created_at DATETIME DEFAULT CURRENT_TIMESTAMP, + created_by INT NULL, + updated_by INT NULL, + + CONSTRAINT uq_master_rev_number UNIQUE (master_id, revision_number), + + CONSTRAINT fk_tdr_master FOREIGN KEY (master_id) + REFERENCES technical_document_master(master_id) ON DELETE CASCADE, + CONSTRAINT fk_tdr_status FOREIGN KEY (status_code_id) + REFERENCES technicaldoc_status_codes(status_code_id), + CONSTRAINT fk_tdr_approve FOREIGN KEY (approve_code_id) + REFERENCES technicaldoc_approve_codes(approve_code_id) ON DELETE SET NULL, + CONSTRAINT fk_tdr_created_by FOREIGN KEY (created_by) + REFERENCES users(user_id) ON DELETE SET NULL, + CONSTRAINT fk_tdr_updated_by FOREIGN KEY (updated_by) + REFERENCES users(user_id) ON DELETE SET NULL +) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_general_ci; + +-- 3. Shop Drawing References (Many-to-Many with Revisions) +CREATE TABLE technical_document_shop_drawing_refs ( + tech_doc_revision_id INT NOT NULL, + shop_drawing_rev_id INT NOT NULL, + reference_type ENUM('SUPERSEDES', 'RELATED', 'AS_PER') DEFAULT 'RELATED', + + PRIMARY KEY (tech_doc_revision_id, shop_drawing_rev_id), + + CONSTRAINT fk_tdsdr_tech_doc FOREIGN KEY (tech_doc_revision_id) + REFERENCES technical_document_revisions(revision_id) ON DELETE CASCADE, + CONSTRAINT fk_tdsdr_shop_dwg FOREIGN KEY (shop_drawing_rev_id) + REFERENCES shop_drawing_revisions(id) ON DELETE CASCADE +) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_general_ci; + +-- 4. Contract Drawing References (Many-to-Many) +CREATE TABLE technical_document_contract_drawing_refs ( + tech_doc_revision_id INT NOT NULL, + contract_drawing_id INT NOT NULL, + reference_type ENUM('AS_PER', 'RELATED') DEFAULT 'AS_PER', + sheet_numbers VARCHAR(255) NULL, -- "Sheet 1-5, 10" เก็บเป็น text + + PRIMARY KEY (tech_doc_revision_id, contract_drawing_id), + + CONSTRAINT fk_tdcdr_tech_doc FOREIGN KEY (tech_doc_revision_id) + REFERENCES technical_document_revisions(revision_id) ON DELETE CASCADE, + CONSTRAINT fk_tdcdr_contract_dwg FOREIGN KEY (contract_drawing_id) + REFERENCES contract_drawings(condwg_id) ON DELETE CASCADE +) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_general_ci; + +-- 5. ปรับปรุง RFA Workflow ให้ชัดเจนขึ้น +CREATE TABLE rfa_workflow_instances ( + workflow_id INT AUTO_INCREMENT PRIMARY KEY, + rfa_correspondence_id INT NOT NULL UNIQUE, + template_id INT NULL, -- อ้างอิงถึงแม่แบบที่ใช้ + + current_step_sequence INT NOT NULL DEFAULT 1, + overall_status ENUM('DRAFT', 'IN_PROGRESS', 'APPROVED', 'REJECTED', 'RETURNED', 'CANCELLED') + NOT NULL DEFAULT 'DRAFT', + + started_at DATETIME NULL, + completed_at DATETIME NULL, + + CONSTRAINT fk_rwi_corr FOREIGN KEY (rfa_correspondence_id) + REFERENCES correspondences(corr_id) ON DELETE CASCADE, + CONSTRAINT fk_rwi_template FOREIGN KEY (template_id) + REFERENCES technicaldoc_workflow_templates(template_id) ON DELETE SET NULL +) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_general_ci; + +-- 6. RFA Workflow Steps (แยกจาก technicaldoc_workflows เดิม) +CREATE TABLE rfa_workflow_steps ( + step_id INT AUTO_INCREMENT PRIMARY KEY, + workflow_id INT NOT NULL, + sequence INT NOT NULL, + org_id INT NOT NULL, + step_purpose ENUM('FOR_APPROVAL', 'FOR_REVIEW', 'FOR_INFORMATION') + NOT NULL DEFAULT 'FOR_APPROVAL', + + status ENUM('PENDING', 'ACTIVE', 'APPROVED', 'REJECTED', + 'APPROVED_WITH_COMMENTS', 'SKIPPED', 'RETURNED') + NOT NULL DEFAULT 'PENDING', + + approve_code_id INT NULL, -- Link to approve codes + comments TEXT NULL, + + activated_at DATETIME NULL, + processed_at DATETIME NULL, + processed_by_user_id INT NULL, + + deadline_date DATE NULL, + + CONSTRAINT uq_workflow_sequence UNIQUE (workflow_id, sequence), + + CONSTRAINT fk_rws_workflow FOREIGN KEY (workflow_id) + REFERENCES rfa_workflow_instances(workflow_id) ON DELETE CASCADE, + CONSTRAINT fk_rws_org FOREIGN KEY (org_id) + REFERENCES organizations(org_id), + CONSTRAINT fk_rws_approve_code FOREIGN KEY (approve_code_id) + REFERENCES technicaldoc_approve_codes(approve_code_id), + CONSTRAINT fk_rws_user FOREIGN KEY (processed_by_user_id) + REFERENCES users(user_id) ON DELETE SET NULL +) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_general_ci; + +-- 7. View: Current Technical Documents with Latest Revision +CREATE OR REPLACE VIEW v_current_technical_documents AS +SELECT + tdm.master_id, + tdm.document_number, + tdm.document_type_id, + dt.code AS document_type_code, + dt.name AS document_type_name, + tdm.project_id, + tdm.title, + tdm.rfa_correspondence_id, + tdr.revision_id, + tdr.revision_number, + tdr.revision_label, + tdr.status_code_id, + sc.code AS status_code, + sc.description AS status_description, + tdr.approve_code_id, + ac.code AS approve_code, + ac.description AS approve_description, + tdr.pdf_path, + tdr.dwg_path, + tdr.submitted_date, + tdr.approved_date, + tdm.created_at, + tdr.created_at AS revision_created_at +FROM technical_document_master tdm +INNER JOIN technical_document_revisions tdr + ON tdm.current_revision_id = tdr.revision_id +INNER JOIN technicaldoc_types dt + ON tdm.document_type_id = dt.document_types_id +LEFT JOIN technicaldoc_status_codes sc + ON tdr.status_code_id = sc.status_code_id +LEFT JOIN technicaldoc_approve_codes ac + ON tdr.approve_code_id = ac.approve_code_id +WHERE tdm.deleted_at IS NULL; + + +-- 8. View: RFA Workflow Status +CREATE OR REPLACE VIEW v_rfa_workflow_status AS +SELECT + rwi.workflow_id, + rwi.rfa_correspondence_id, + c.correspondence_number AS rfa_number, + rwi.overall_status, + rwi.current_step_sequence, + rws.step_id AS current_step_id, + rws.org_id AS current_org_id, + o.org_name AS current_org_name, + rws.status AS current_step_status, + rws.deadline_date, + rwi.started_at, + DATEDIFF(CURDATE(), rwi.started_at) AS days_in_progress, + (SELECT COUNT(*) FROM rfa_workflow_steps WHERE workflow_id = rwi.workflow_id) AS total_steps, + (SELECT COUNT(*) FROM rfa_workflow_steps WHERE workflow_id = rwi.workflow_id AND status IN ('APPROVED','APPROVED_WITH_COMMENTS')) AS completed_steps +FROM rfa_workflow_instances rwi +INNER JOIN correspondences c ON rwi.rfa_correspondence_id = c.corr_id +LEFT JOIN rfa_workflow_steps rws + ON rwi.workflow_id = rws.workflow_id + AND rwi.current_step_sequence = rws.sequence +LEFT JOIN organizations o ON rws.org_id = o.org_id +WHERE rwi.overall_status NOT IN ('CANCELLED', 'APPROVED'); \ No newline at end of file diff --git a/docs/SQL/seed01.sql b/docs/SQL/seed01.sql new file mode 100644 index 0000000..5c6b3e2 --- /dev/null +++ b/docs/SQL/seed01.sql @@ -0,0 +1,215 @@ +-- ========================================================== +-- DMS v0.5.0 +-- Database v5.1 - Deploy Script Schema (Revised) +-- Server: Container Station on QNAP TS-473A +-- Database service: MariaDB 10.11 +-- Notes: +-- - Removed 'rfas' table. +-- - Added 'contracts' and 'contract_parties' tables. +-- ========================================================== + +SET NAMES utf8mb4; +SET time_zone = '+07:00'; +SET FOREIGN_KEY_CHECKS=0; + +-- Drop tables in reverse order of creation due to dependencies +DROP TABLE IF EXISTS audit_logs; +DROP TABLE IF EXISTS user_project_roles; +DROP TABLE IF EXISTS user_roles; +DROP TABLE IF EXISTS role_permissions; +DROP TABLE IF EXISTS permissions; +DROP TABLE IF EXISTS roles; +DROP TABLE IF EXISTS users; +DROP TABLE IF EXISTS project_parties; +DROP TABLE IF EXISTS contract_parties; -- New +DROP TABLE IF EXISTS contracts; -- New +DROP TABLE IF EXISTS projects; +DROP TABLE IF EXISTS organizations; +DROP TABLE IF EXISTS correspondence_references; +DROP TABLE IF EXISTS correspondence_cc_recipients; +DROP TABLE IF EXISTS correspondences; +DROP TABLE IF EXISTS email_details; +DROP TABLE IF EXISTS instruction_details; +DROP TABLE IF EXISTS letter_details; +DROP TABLE IF EXISTS memorandum_details; +DROP TABLE IF EXISTS minutes_of_meeting_details; +DROP TABLE IF EXISTS rfi_details; +DROP TABLE IF EXISTS rfa_items; +DROP TABLE IF EXISTS transmittal_items; +DROP TABLE IF EXISTS transmittals; +DROP TABLE IF EXISTS technicaldocs; +DROP TABLE IF EXISTS shop_drawing_revisions; +DROP TABLE IF EXISTS shop_drawings; +DROP TABLE IF EXISTS shop_drawing_sub_categories; +DROP TABLE IF EXISTS shop_drawing_main_categories; +DROP TABLE IF EXISTS contract_dwg_subcat_cat_map; +DROP TABLE IF EXISTS contract_dwg_sub_cat; +DROP TABLE IF EXISTS contract_dwg_cat; +DROP TABLE IF EXISTS contract_drawings; +DROP TABLE IF EXISTS cir_action_documents; +DROP TABLE IF EXISTS cir_actions; +DROP TABLE IF EXISTS cir_recipients; +DROP TABLE IF EXISTS circulations; +DROP TABLE IF EXISTS cir_status_codes; +DROP TABLE IF EXISTS correspondence_status_transitions; +DROP TABLE IF EXISTS correspondence_statuses; +DROP TABLE IF EXISTS correspondence_types; +DROP TABLE IF EXISTS correspondence_tags; +DROP TABLE IF EXISTS tags; +DROP TABLE IF EXISTS global_default_roles; + +SET FOREIGN_KEY_CHECKS=1; + +-- ========================================================== +-- Table Creation +-- ========================================================== + +-- Organizations Table +CREATE TABLE organizations ( + org_id INT NOT NULL AUTO_INCREMENT, + org_code VARCHAR(20) NOT NULL, + org_name VARCHAR(255) NOT NULL, + primary_role ENUM('OWNER','DESIGNER','CONSULTANT','CONTRACTOR') NULL, + is_active BOOLEAN NOT NULL DEFAULT TRUE, + created_at TIMESTAMP NOT NULL DEFAULT CURRENT_TIMESTAMP, + updated_at TIMESTAMP NOT NULL DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP, + PRIMARY KEY (org_id), + UNIQUE KEY ux_organizations_code (org_code) +) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_general_ci; + +-- Projects Table +CREATE TABLE projects ( + project_id INT NOT NULL AUTO_INCREMENT, + project_code VARCHAR(20) NOT NULL, + project_name VARCHAR(255) NOT NULL, + description TEXT, + is_active BOOLEAN NOT NULL DEFAULT TRUE, + created_at TIMESTAMP NOT NULL DEFAULT CURRENT_TIMESTAMP, + updated_at TIMESTAMP NOT NULL DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP, + PRIMARY KEY (project_id), + UNIQUE KEY ux_projects_code (project_code) +) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_general_ci; + +-- NEW: Contracts Table +-- Stores information about each contract. +CREATE TABLE contracts ( + contract_id INT NOT NULL AUTO_INCREMENT, + contract_code VARCHAR(50) NOT NULL, + contract_name VARCHAR(255) NOT NULL, + description TEXT, + start_date DATE, + end_date DATE, + created_at TIMESTAMP NOT NULL DEFAULT CURRENT_TIMESTAMP, + updated_at TIMESTAMP NOT NULL DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP, + PRIMARY KEY (contract_id), + UNIQUE KEY ux_contracts_code (contract_code) +) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_general_ci; + +-- NEW: Contract Parties Table +-- Links contracts, projects, and organizations together. +CREATE TABLE contract_parties ( + contract_id INT NOT NULL, + project_id INT NOT NULL, + org_id INT NOT NULL, + PRIMARY KEY (contract_id, project_id, org_id), + CONSTRAINT fk_cp_contract FOREIGN KEY (contract_id) REFERENCES contracts(contract_id) ON DELETE CASCADE ON UPDATE CASCADE, + CONSTRAINT fk_cp_project FOREIGN KEY (project_id) REFERENCES projects(project_id) ON DELETE CASCADE ON UPDATE CASCADE, + CONSTRAINT fk_cp_org FOREIGN KEY (org_id) REFERENCES organizations(org_id) ON DELETE CASCADE ON UPDATE CASCADE +) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_general_ci; + + +-- Users Table (RBAC) +CREATE TABLE users ( + user_id INT NOT NULL AUTO_INCREMENT, + username VARCHAR(50) NOT NULL, + password_hash VARCHAR(255) NOT NULL, + email VARCHAR(100) NOT NULL, + first_name VARCHAR(50), + last_name VARCHAR(50), + org_id INT, + is_active BOOLEAN NOT NULL DEFAULT TRUE, + last_login TIMESTAMP NULL, + created_at TIMESTAMP NOT NULL DEFAULT CURRENT_TIMESTAMP, + updated_at TIMESTAMP NOT NULL DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP, + PRIMARY KEY (user_id), + UNIQUE KEY ux_users_username (username), + UNIQUE KEY ux_users_email (email), + CONSTRAINT fk_users_org FOREIGN KEY (org_id) REFERENCES organizations(org_id) ON DELETE SET NULL ON UPDATE CASCADE +) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_general_ci; + +-- Roles Table (RBAC) +CREATE TABLE roles ( + role_id INT NOT NULL AUTO_INCREMENT, + role_code VARCHAR(50) NOT NULL, + role_name VARCHAR(100) NOT NULL, + description TEXT, + is_system BOOLEAN NOT NULL DEFAULT FALSE, + PRIMARY KEY (role_id), + UNIQUE KEY ux_roles_code (role_code) +) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_general_ci; + +-- Permissions Table (RBAC) +CREATE TABLE permissions ( + permission_id INT NOT NULL AUTO_INCREMENT, + permission_code VARCHAR(100) NOT NULL, + description TEXT, + PRIMARY KEY (permission_id), + UNIQUE KEY ux_permissions_code (permission_code) +) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_general_ci; + +-- Role Permissions Junction Table (RBAC) +CREATE TABLE role_permissions ( + role_id INT NOT NULL, + permission_id INT NOT NULL, + PRIMARY KEY (role_id, permission_id), + CONSTRAINT fk_rp_role FOREIGN KEY (role_id) REFERENCES roles(role_id) ON DELETE CASCADE ON UPDATE CASCADE, + CONSTRAINT fk_rp_permission FOREIGN KEY (permission_id) REFERENCES permissions(permission_id) ON DELETE CASCADE ON UPDATE CASCADE +) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_general_ci; + +-- User Roles Junction Table (RBAC) - For global/system-level roles +CREATE TABLE user_roles ( + user_id INT NOT NULL, + role_id INT NOT NULL, + PRIMARY KEY (user_id, role_id), + CONSTRAINT fk_ur_user FOREIGN KEY (user_id) REFERENCES users(user_id) ON DELETE CASCADE ON UPDATE CASCADE, + CONSTRAINT fk_ur_role FOREIGN KEY (role_id) REFERENCES roles(role_id) ON DELETE CASCADE ON UPDATE CASCADE +) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_general_ci; + +-- User Project Roles Junction Table (RBAC) - For project-specific roles +CREATE TABLE user_project_roles ( + user_id INT NOT NULL, + project_id INT NOT NULL, + role_id INT NOT NULL, + PRIMARY KEY (user_id, project_id, role_id), + CONSTRAINT fk_upr_user FOREIGN KEY (user_id) REFERENCES users(user_id) ON DELETE CASCADE ON UPDATE CASCADE, + CONSTRAINT fk_upr_project FOREIGN KEY (project_id) REFERENCES projects(project_id) ON DELETE CASCADE ON UPDATE CASCADE, + CONSTRAINT fk_upr_role FOREIGN KEY (role_id) REFERENCES roles(role_id) ON DELETE CASCADE ON UPDATE CASCADE +) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_general_ci; + +-- Project Parties Table +CREATE TABLE project_parties ( + project_id INT NOT NULL, + org_id INT NOT NULL, + role ENUM('OWNER','DESIGNER','CONSULTANT','CONTRACTOR') NOT NULL, + is_contractor TINYINT(1) GENERATED ALWAYS AS (IF(role = 'CONTRACTOR', 1, NULL)) STORED, + PRIMARY KEY (project_id, org_id), + UNIQUE KEY uq_project_parties_contractor (project_id, is_contractor), + CONSTRAINT fk_pp_project FOREIGN KEY (project_id) REFERENCES projects(project_id) ON DELETE CASCADE ON UPDATE CASCADE, + CONSTRAINT fk_pp_org FOREIGN KEY (org_id) REFERENCES organizations(org_id) ON DELETE RESTRICT ON UPDATE CASCADE +) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_general_ci; + + +-- ... (The rest of your original script for correspondences, technical docs, etc. remains here) ... + +-- Global default roles (template defaults) +CREATE TABLE global_default_roles ( + id TINYINT NOT NULL DEFAULT 1, + role ENUM('OWNER','DESIGNER','CONSULTANT') NOT NULL, + position TINYINT NOT NULL, + org_id INT NOT NULL, + PRIMARY KEY (id, role, position), + UNIQUE KEY ux_gdr_unique_org_per_role (id, role, org_id), + CONSTRAINT fk_gdr_org FOREIGN KEY (org_id) REFERENCES organizations(org_id) ON UPDATE CASCADE ON DELETE RESTRICT +) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_general_ci; + +-- ... (The rest of your original script continues from here) ... \ No newline at end of file diff --git a/docs/SQL/seed02.sql b/docs/SQL/seed02.sql new file mode 100644 index 0000000..7af00ae --- /dev/null +++ b/docs/SQL/seed02.sql @@ -0,0 +1,316 @@ +-- ========================================================== +-- DMS v0.5.0 +-- Database v5.1 - Deploy Script Schema (Complete & Revised) +-- Server: Container Station on QNAP TS-473A +-- Database service: MariaDB 10.11 +-- Notes: +-- - This is a consolidated and updated version. +-- - Removed 'rfas' table. +-- - Added tables for Contracts, detailed Circulations, +-- Technical Document Workflow, and Correspondence Revisions. +-- ========================================================== + +SET NAMES utf8mb4; +SET time_zone = '+07:00'; +SET FOREIGN_KEY_CHECKS=0; + +-- Drop tables in reverse order of creation due to dependencies +DROP TABLE IF EXISTS audit_logs; +DROP TABLE IF EXISTS user_project_roles; +DROP TABLE IF EXISTS user_roles; +DROP TABLE IF EXISTS role_permissions; +DROP TABLE IF EXISTS permissions; +DROP TABLE IF EXISTS roles; +DROP TABLE IF EXISTS users; +DROP TABLE IF EXISTS project_parties; +DROP TABLE IF EXISTS contract_parties; +DROP TABLE IF EXISTS contracts; +DROP TABLE IF EXISTS projects; +DROP TABLE IF EXISTS organizations; +DROP TABLE IF EXISTS correspondence_references; +DROP TABLE IF EXISTS correspondence_revisions; +DROP TABLE IF EXISTS correspondence_cc_recipients; +DROP TABLE IF EXISTS technical_doc_workflows; +DROP TABLE IF EXISTS correspondences; +DROP TABLE IF EXISTS email_details; +DROP TABLE IF EXISTS instruction_details; +DROP TABLE IF EXISTS letter_details; +DROP TABLE IF EXISTS memorandum_details; +DROP TABLE IF EXISTS minutes_of_meeting_details; +DROP TABLE IF EXISTS rfi_details; +DROP TABLE IF EXISTS rfa_items; +DROP TABLE IF EXISTS transmittal_items; +DROP TABLE IF EXISTS transmittals; +DROP TABLE IF EXISTS technicaldocs; +DROP TABLE IF EXISTS shop_drawing_revisions; +DROP TABLE IF EXISTS shop_drawings; +DROP TABLE IF EXISTS shop_drawing_sub_categories; +DROP TABLE IF EXISTS shop_drawing_main_categories; +DROP TABLE IF EXISTS contract_dwg_subcat_cat_map; +DROP TABLE IF EXISTS contract_dwg_sub_cat; +DROP TABLE IF EXISTS contract_dwg_cat; +DROP TABLE IF EXISTS contract_drawings; +DROP TABLE IF EXISTS circulation_assignees; +DROP TABLE IF EXISTS circulations; +DROP TABLE IF EXISTS cir_action_documents; +DROP TABLE IF EXISTS cir_actions; +DROP TABLE IF EXISTS cir_recipients; +DROP TABLE IF EXISTS cir_status_codes; +DROP TABLE IF EXISTS correspondence_status_transitions; +DROP TABLE IF EXISTS correspondence_statuses; +DROP TABLE IF EXISTS correspondence_types; +DROP TABLE IF EXISTS correspondence_tags; +DROP TABLE IF EXISTS tags; +DROP TABLE IF EXISTS global_default_roles; + +SET FOREIGN_KEY_CHECKS=1; + +-- ========================================================== +-- Table Creation +-- ========================================================== + +CREATE TABLE organizations ( + org_id INT NOT NULL AUTO_INCREMENT, + org_code VARCHAR(20) NOT NULL, + org_name VARCHAR(255) NOT NULL, + primary_role ENUM('OWNER','DESIGNER','CONSULTANT','CONTRACTOR') NULL, + is_active BOOLEAN NOT NULL DEFAULT TRUE, + created_at TIMESTAMP NOT NULL DEFAULT CURRENT_TIMESTAMP, + updated_at TIMESTAMP NOT NULL DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP, + PRIMARY KEY (org_id), + UNIQUE KEY ux_organizations_code (org_code) +) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_general_ci; + +CREATE TABLE projects ( + project_id INT NOT NULL AUTO_INCREMENT, + project_code VARCHAR(20) NOT NULL, + project_name VARCHAR(255) NOT NULL, + description TEXT, + is_active BOOLEAN NOT NULL DEFAULT TRUE, + created_at TIMESTAMP NOT NULL DEFAULT CURRENT_TIMESTAMP, + updated_at TIMESTAMP NOT NULL DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP, + PRIMARY KEY (project_id), + UNIQUE KEY ux_projects_code (project_code) +) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_general_ci; + +CREATE TABLE contracts ( + contract_id INT NOT NULL AUTO_INCREMENT, + contract_code VARCHAR(50) NOT NULL, + contract_name VARCHAR(255) NOT NULL, + description TEXT, + start_date DATE, + end_date DATE, + created_at TIMESTAMP NOT NULL DEFAULT CURRENT_TIMESTAMP, + updated_at TIMESTAMP NOT NULL DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP, + PRIMARY KEY (contract_id), + UNIQUE KEY ux_contracts_code (contract_code) +) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_general_ci; + +CREATE TABLE contract_parties ( + contract_id INT NOT NULL, + project_id INT NOT NULL, + org_id INT NOT NULL, + PRIMARY KEY (contract_id, project_id, org_id), + CONSTRAINT fk_cp_contract FOREIGN KEY (contract_id) REFERENCES contracts(contract_id) ON DELETE CASCADE ON UPDATE CASCADE, + CONSTRAINT fk_cp_project FOREIGN KEY (project_id) REFERENCES projects(project_id) ON DELETE CASCADE ON UPDATE CASCADE, + CONSTRAINT fk_cp_org FOREIGN KEY (org_id) REFERENCES organizations(org_id) ON DELETE CASCADE ON UPDATE CASCADE +) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_general_ci; + +CREATE TABLE users ( + user_id INT NOT NULL AUTO_INCREMENT, + username VARCHAR(50) NOT NULL, + password_hash VARCHAR(255) NOT NULL, + email VARCHAR(100) NOT NULL, + first_name VARCHAR(50), + last_name VARCHAR(50), + org_id INT, + is_active BOOLEAN NOT NULL DEFAULT TRUE, + last_login TIMESTAMP NULL, + created_at TIMESTAMP NOT NULL DEFAULT CURRENT_TIMESTAMP, + updated_at TIMESTAMP NOT NULL DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP, + PRIMARY KEY (user_id), + UNIQUE KEY ux_users_username (username), + UNIQUE KEY ux_users_email (email), + CONSTRAINT fk_users_org FOREIGN KEY (org_id) REFERENCES organizations(org_id) ON DELETE SET NULL ON UPDATE CASCADE +) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_general_ci; + +CREATE TABLE roles ( + role_id INT NOT NULL AUTO_INCREMENT, + role_code VARCHAR(50) NOT NULL, + role_name VARCHAR(100) NOT NULL, + description TEXT, + is_system BOOLEAN NOT NULL DEFAULT FALSE, + PRIMARY KEY (role_id), + UNIQUE KEY ux_roles_code (role_code) +) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_general_ci; + +CREATE TABLE permissions ( + permission_id INT NOT NULL AUTO_INCREMENT, + permission_code VARCHAR(100) NOT NULL, + description TEXT, + PRIMARY KEY (permission_id), + UNIQUE KEY ux_permissions_code (permission_code) +) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_general_ci; + +CREATE TABLE role_permissions ( + role_id INT NOT NULL, + permission_id INT NOT NULL, + PRIMARY KEY (role_id, permission_id), + CONSTRAINT fk_rp_role FOREIGN KEY (role_id) REFERENCES roles(role_id) ON DELETE CASCADE ON UPDATE CASCADE, + CONSTRAINT fk_rp_permission FOREIGN KEY (permission_id) REFERENCES permissions(permission_id) ON DELETE CASCADE ON UPDATE CASCADE +) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_general_ci; + +CREATE TABLE user_roles ( + user_id INT NOT NULL, + role_id INT NOT NULL, + PRIMARY KEY (user_id, role_id), + CONSTRAINT fk_ur_user FOREIGN KEY (user_id) REFERENCES users(user_id) ON DELETE CASCADE ON UPDATE CASCADE, + CONSTRAINT fk_ur_role FOREIGN KEY (role_id) REFERENCES roles(role_id) ON DELETE CASCADE ON UPDATE CASCADE +) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_general_ci; + +CREATE TABLE user_project_roles ( + user_id INT NOT NULL, + project_id INT NOT NULL, + role_id INT NOT NULL, + PRIMARY KEY (user_id, project_id, role_id), + CONSTRAINT fk_upr_user FOREIGN KEY (user_id) REFERENCES users(user_id) ON DELETE CASCADE ON UPDATE CASCADE, + CONSTRAINT fk_upr_project FOREIGN KEY (project_id) REFERENCES projects(project_id) ON DELETE CASCADE ON UPDATE CASCADE, + CONSTRAINT fk_upr_role FOREIGN KEY (role_id) REFERENCES roles(role_id) ON DELETE CASCADE ON UPDATE CASCADE +) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_general_ci; + +CREATE TABLE project_parties ( + project_id INT NOT NULL, + org_id INT NOT NULL, + role ENUM('OWNER','DESIGNER','CONSULTANT','CONTRACTOR') NOT NULL, + is_contractor TINYINT(1) GENERATED ALWAYS AS (IF(role = 'CONTRACTOR', 1, NULL)) STORED, + PRIMARY KEY (project_id, org_id), + UNIQUE KEY uq_project_parties_contractor (project_id, is_contractor), + CONSTRAINT fk_pp_project FOREIGN KEY (project_id) REFERENCES projects(project_id) ON DELETE CASCADE ON UPDATE CASCADE, + CONSTRAINT fk_pp_org FOREIGN KEY (org_id) REFERENCES organizations(org_id) ON DELETE RESTRICT ON UPDATE CASCADE +) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_general_ci; + +-- Correspondence & Workflow Tables + +CREATE TABLE correspondence_types ( + type_id INT NOT NULL AUTO_INCREMENT, + type_code VARCHAR(20) NOT NULL, + type_name VARCHAR(100) NOT NULL, + PRIMARY KEY (type_id), + UNIQUE KEY ux_ct_code (type_code) +) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_general_ci; + +CREATE TABLE correspondence_statuses ( + status_id INT NOT NULL AUTO_INCREMENT, + status_code VARCHAR(20) NOT NULL, + status_name VARCHAR(100) NOT NULL, + PRIMARY KEY (status_id), + UNIQUE KEY ux_cs_code (status_code) +) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_general_ci; + +CREATE TABLE correspondences ( + id INT NOT NULL AUTO_INCREMENT, + project_id INT NOT NULL, + document_number VARCHAR(100) NOT NULL, + title VARCHAR(500) NOT NULL, + issue_date DATE NOT NULL, + status_id INT NOT NULL, + type_id INT NOT NULL, + originator_org_id INT NOT NULL, + created_by_user_id INT NOT NULL, + root_id INT NULL, -- for revisions + version INT NOT NULL DEFAULT 1, + submitted_at TIMESTAMP NULL, + created_at TIMESTAMP NOT NULL DEFAULT CURRENT_TIMESTAMP, + updated_at TIMESTAMP NOT NULL DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP, + PRIMARY KEY (id), + UNIQUE KEY ux_corr_doc_num (document_number), + CONSTRAINT fk_corr_project FOREIGN KEY (project_id) REFERENCES projects(project_id), + CONSTRAINT fk_corr_status FOREIGN KEY (status_id) REFERENCES correspondence_statuses(status_id), + CONSTRAINT fk_corr_type FOREIGN KEY (type_id) REFERENCES correspondence_types(type_id), + CONSTRAINT fk_corr_org FOREIGN KEY (originator_org_id) REFERENCES organizations(org_id), + CONSTRAINT fk_corr_user FOREIGN KEY (created_by_user_id) REFERENCES users(user_id), + CONSTRAINT fk_corr_root FOREIGN KEY (root_id) REFERENCES correspondences(id) ON DELETE SET NULL +) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_general_ci; + +CREATE TABLE correspondence_revisions ( + revision_id INT NOT NULL AUTO_INCREMENT, + correspondence_id INT NOT NULL, + version_number INT NOT NULL, + change_reason TEXT NOT NULL, + changed_by_user_id INT NOT NULL, + changed_at TIMESTAMP NOT NULL DEFAULT CURRENT_TIMESTAMP, + document_data_json JSON NOT NULL, + PRIMARY KEY (revision_id), + CONSTRAINT fk_cr_correspondence FOREIGN KEY (correspondence_id) REFERENCES correspondences(id) ON DELETE CASCADE, + CONSTRAINT fk_cr_user FOREIGN KEY (changed_by_user_id) REFERENCES users(user_id) +) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_general_ci; + +CREATE TABLE cir_status_codes ( + code VARCHAR(20) NOT NULL, + description VARCHAR(255), + sort_order INT NOT NULL, + PRIMARY KEY (code) +) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_general_ci; + +CREATE TABLE circulations ( + cir_id INT NOT NULL AUTO_INCREMENT, + correspondence_id INT NOT NULL, + org_id INT NOT NULL, + cir_subject VARCHAR(500) NOT NULL, + cir_status_code VARCHAR(20) NOT NULL DEFAULT 'DRAFT', + created_by_user_id INT NOT NULL, + submitted_at TIMESTAMP NULL, + closed_at TIMESTAMP NULL, + created_at TIMESTAMP NOT NULL DEFAULT CURRENT_TIMESTAMP, + updated_at TIMESTAMP NOT NULL DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP, + PRIMARY KEY (cir_id), + CONSTRAINT fk_cir_correspondence FOREIGN KEY (correspondence_id) REFERENCES correspondences(id), + CONSTRAINT fk_cir_org FOREIGN KEY (org_id) REFERENCES organizations(org_id), + CONSTRAINT fk_cir_status FOREIGN KEY (cir_status_code) REFERENCES cir_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; + +CREATE TABLE circulation_assignees ( + assignee_id INT NOT NULL AUTO_INCREMENT, + cir_id INT NOT NULL, + user_id INT NOT NULL, + assignee_type ENUM('MAIN', 'ACTION', 'INFO') NOT NULL, + deadline DATE NULL, + action_taken TEXT NULL, + is_completed BOOLEAN NOT NULL DEFAULT FALSE, + completed_at TIMESTAMP NULL, + PRIMARY KEY (assignee_id), + UNIQUE KEY ux_cir_user_type (cir_id, user_id, assignee_type), + CONSTRAINT fk_ca_cir FOREIGN KEY (cir_id) REFERENCES circulations(cir_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; + +CREATE TABLE technical_doc_workflows ( + workflow_id INT NOT NULL AUTO_INCREMENT, + correspondence_id INT NOT NULL, + sequence INT NOT NULL, + org_id INT NOT NULL, + status ENUM('PENDING', 'APPROVED', 'REJECTED', 'APPROVED_WITH_COMMENTS', 'FORWARDED', 'RETURNED') NOT NULL DEFAULT 'PENDING', + comments TEXT, + processed_by_user_id INT NULL, + processed_at TIMESTAMP NULL, + created_at TIMESTAMP NOT NULL DEFAULT CURRENT_TIMESTAMP, + PRIMARY KEY (workflow_id), + UNIQUE KEY ux_workflow_corr_sequence (correspondence_id, sequence), + CONSTRAINT fk_tdw_correspondence FOREIGN KEY (correspondence_id) REFERENCES correspondences(id) ON DELETE CASCADE, + CONSTRAINT fk_tdw_org FOREIGN KEY (org_id) REFERENCES organizations(org_id), + CONSTRAINT fk_tdw_user FOREIGN KEY (processed_by_user_id) REFERENCES users(user_id) +) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_general_ci; + +CREATE TABLE correspondence_status_transitions( + type_id INT NOT NULL, + from_status_id INT NOT NULL, + to_status_id INT NOT NULL, + PRIMARY KEY (type_id, from_status_id, to_status_id), + CONSTRAINT fk_cst_type FOREIGN KEY (type_id) REFERENCES correspondence_types(type_id), + CONSTRAINT fk_cst_from FOREIGN KEY (from_status_id) REFERENCES correspondence_statuses(status_id), + CONSTRAINT fk_cst_to FOREIGN KEY (to_status_id) REFERENCES correspondence_statuses(status_id) +) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_general_ci; + +-- (The rest of your original tables for technical docs, drawings, etc. would follow here) +-- For brevity, I've included the core structure. You can append the remaining tables from your original file. \ No newline at end of file diff --git a/docs/SQL/temp.sql b/docs/SQL/temp.sql new file mode 100644 index 0000000..9727e80 --- /dev/null +++ b/docs/SQL/temp.sql @@ -0,0 +1,143 @@ +SET NAMES utf8mb4; +SET time_zone = '+07:00'; +SET FOREIGN_KEY_CHECKS=0; + +-- ========================================================== +-- 1. ลบ Stored Procedure เก่า (ย้าย Logic ไป NestJS) +-- ========================================================== +-- ตรรกะนี้ (การสร้าง Revision) จะถูกย้ายไปจัดการใน +-- CorrespondenceService และ RfaService ของ NestJS +DROP PROCEDURE IF EXISTS sp_create_correspondence_revision; + + +-- ========================================================== +-- 2. สร้าง 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 ; + + +-- ========================================================== +-- 3. สร้าง Views (สำหรับช่วย Backend/Frontend) +-- ========================================================== + +-- ---------------------------------------------------------- +-- 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; + + +SET FOREIGN_KEY_CHECKS=1; \ No newline at end of file diff --git a/docs/SQL/triggers.sql b/docs/SQL/triggers.sql new file mode 100644 index 0000000..27ed959 --- /dev/null +++ b/docs/SQL/triggers.sql @@ -0,0 +1,47 @@ +-- trigger +DROP TRIGGER IF EXISTS trg_rfa_revisions_is_current; +DROP TRIGGER IF EXISTS trg_rfa_revisions_is_current_upd; +DROP TRIGGER IF EXISTS trg_rfa_revisions_auto_reset; +-- ============================================================ +-- ⚙️ TRIGGERS +-- ============================================================ +-- ป้องกันไม่ให้มี revision ที่ is_current=TRUE ซ้ำใน rfa_id เดียวกัน +DELIMITER $$ +CREATE TRIGGER trg_rfa_revisions_is_current +BEFORE INSERT ON rfa_revisions +FOR EACH ROW +BEGIN + IF NEW.is_current = TRUE THEN + IF (SELECT COUNT(*) FROM rfa_revisions WHERE rfa_id = NEW.rfa_id AND is_current = TRUE) > 0 THEN + SIGNAL SQLSTATE '45000' + SET MESSAGE_TEXT = 'Cannot insert more than one current revision per RFA.'; + END IF; + END IF; +END$$ +DELIMITER ; +DELIMITER $$ +CREATE TRIGGER trg_rfa_revisions_is_current_upd +BEFORE UPDATE ON rfa_revisions +FOR EACH ROW +BEGIN + IF NEW.is_current = TRUE AND (OLD.is_current IS NULL OR OLD.is_current = FALSE) THEN + IF (SELECT COUNT(*) FROM rfa_revisions WHERE rfa_id = NEW.rfa_id AND is_current = TRUE AND correspondences_id <> OLD.correspondences_id) > 0 THEN + SIGNAL SQLSTATE '45000' + SET MESSAGE_TEXT = 'Cannot set more than one current revision per RFA.'; + END IF; + END IF; +END$$ +DELIMITER ; +-- ทำให้เวลาสร้าง revision ใหม่ที่ is_current=TRUE ระบบจะ set revision เดิมเป็น FALSE อัตโนมัติ +DELIMITER $$ +CREATE TRIGGER trg_rfa_revisions_auto_reset +BEFORE INSERT ON rfa_revisions +FOR EACH ROW +BEGIN + IF NEW.is_current = TRUE THEN + UPDATE rfa_revisions + SET is_current = FALSE + WHERE rfa_id = NEW.rfa_id; + END IF; +END$$ +DELIMITER ; \ No newline at end of file diff --git a/docs/backend_setup.bak b/docs/backend_setup.bak new file mode 100644 index 0000000..2c911e8 --- /dev/null +++ b/docs/backend_setup.bak @@ -0,0 +1,171 @@ + +# การติดตั้งและสร้างโปรเจกต์ (Project Initialization) + +1. ข้อกำหนดเบื้องต้น (Prerequisites) + ก่อนเริ่ม, ตรวจสอบให้แน่ใจว่าคุณมีเครื่องมือเหล่านี้ติดตั้งบน Windows 11 ของคุณแล้ว: + Node.js: เวอร์ชัน 18.x หรือสูงกว่า + NPM หรือ Yarn: ตัวจัดการ Package (มักจะมาพร้อมกับ Node.js) + NestJS CLI: เครื่องมือ Command-line สำหรับ NestJS + หากยังไม่ได้ติดตั้ง NestJS CLI, ให้เปิด VS Code Terminal หรือ Command Prompt แล้วรันคำสั่ง: + +bash +npm install -g @nestjs/cli + +## 2.1 สร้างโปรเจกต์ NestJS ใหม่ + ไปที่ Directory ที่คุณต้องการเก็บโปรเจกต์ (เช่น C:\Users\YourUser\Development\) + ใช้ NestJS CLI เพื่อสร้างโปรเจกต์ใหม่ ผมจะตั้งชื่อว่า backend-np-dms นะครับ: + +Bash +nest new backend + + ระบบจะถามว่าต้องการใช้ Package Manager ตัวไหน แนะนำให้เลือก npm, รอจนกว่ากระบวนการจะเสร็จสิ้น คุณจะได้โฟลเดอร์ backend ที่มีโครงสร้างพื้นฐานของ NestJS พร้อมใช้งาน + +## 2.2 ติดตั้ง Dependencies ที่จำเป็น +ตอนนี้เราจะติดตั้ง Modules ทั้งหมดที่คุณวางแผนไว้ในคราวเดียว เพื่อให้โปรเจกต์พร้อมสำหรับการพัฒนา + +เปิด Terminal ใน VS Code ภายในโฟลเดอร์ backend (cd backend) แล้วรันคำสั่งต่อไปนี้: + +* Database & ORM (TypeORM for MariaDB/MySQL) + Bash +npm install @nestjs/typeorm typeorm mysql2 + +* Configuration Management (สำหรับ .env) +npm install @nestjs/config + +* API Documentation +npm install @nestjs/swagger + +* Validation & Transformation +npm install class-validator class-transformer + +* Security +npm install helmet + +* Authentication (JWT) +npm install @nestjs/passport passport passport-jwt @nestjs/jwt +npm install --save-dev @types/passport-jwt + +คำอธิบาย: +@nestjs/typeorm typeorm mysql2: สำหรับเชื่อมต่อและจัดการฐานข้อมูล MariaDB +@nestjs/config: สำหรับจัดการ Environment Variables (เช่น ข้อมูลการเชื่อมต่อ DB) ผ่านไฟล์ .env +@nestjs/swagger: สำหรับสร้างหน้าเอกสาร API (Swagger/OpenAPI) โดยอัตโนมัติ +class-validator class-transformer: ใช้สำหรับตรวจสอบความถูกต้องของข้อมูลที่ส่งเข้ามาใน API (Request Body Validation) +helmet: ช่วยเพิ่มความปลอดภัยพื้นฐานโดยการตั้งค่า HTTP Headers ที่เหมาะสม +@nestjs/passport, @nestjs/jwt: เครื่องมือมาตรฐานสำหรับทำระบบ Authentication + +## 2.3: ตั้งค่าพื้นฐานในโปรเจกต์ (Initial Configuration) +ตอนนี้เราจะแก้ไขไฟล์หลักๆ เพื่อเปิดใช้งาน Modules ที่ติดตั้งไป + +1. สร้างไฟล์ Environment (.env) +ที่ราก (root) ของโปรเจกต์ backend-np-dms, สร้างไฟล์ใหม่ชื่อ .env และใส่ข้อมูลการเชื่อมต่อฐานข้อมูลของคุณ (ข้อมูลนี้จะไม่ถูกเก็บใน Git): + +.env + +Code snippet + +* Database Configuration +DB_TYPE=mysql +DB_HOST=localhost +DB_PORT=3306 +DB_USERNAME=your_db_user # <-- แก้ไขเป็น user ของคุณ +DB_PASSWORD=your_db_password # <-- แก้ไขเป็น password ของคุณ +DB_DATABASE=dms_db # <-- แก้ไขเป็นชื่อ database ของคุณ + +* Application +API_PORT=3001 +💡 Tip: หากคุณรัน MariaDB ผ่าน Docker, DB_HOST อาจจะเป็นชื่อ Service ของ Docker container (เช่น mariadb-container) หรือ IP ของ QNAP ของคุณ + +2. แก้ไข app.module.ts เพื่อเชื่อมต่อ Database และ Config +เปิดไฟล์ src/app.module.ts และแก้ไขให้เป็นตามนี้เพื่อ import ConfigModule และ TypeOrmModule: + +src/app.module.ts + +```TypeScript + +import { Module } from '@nestjs/common'; +import { ConfigModule, ConfigService } from '@nestjs/config'; +import { TypeOrmModule } from '@nestjs/typeorm'; +import { AppController } from './app.controller'; +import { AppService } from './app.service'; + +@Module({ + imports: [ + // 1. Config Module - สำหรับอ่าน .env (ต้องอยู่บนสุด) + ConfigModule.forRoot({ + isGlobal: true, // ทำให้ ConfigService พร้อมใช้งานทั่วทั้งแอป + envFilePath: '.env', + }), + + // 2. TypeORM Module - สำหรับเชื่อมต่อ Database + TypeOrmModule.forRootAsync({ + imports: [ConfigModule], + inject: [ConfigService], + useFactory: (configService: ConfigService) => ({ + type: 'mysql', + host: configService.get('DB_HOST'), + port: configService.get('DB_PORT'), + username: configService.get('DB_USERNAME'), + password: configService.get('DB_PASSWORD'), + database: configService.get('DB_DATABASE'), + entities: [__dirname + '/../**/*.entity{.ts,.js}'], + synchronize: true, // สำหรับ Development เท่านั้น! จะสร้างตารางให้อัตโนมัติ + logging: true, + }), + }), + ], + controllers: [AppController], + providers: [AppService], +}) +export class AppModule {} +``` +⚠️ คำเตือน: synchronize: true สะดวกมากในช่วงพัฒนาเพราะมันจะปรับโครงสร้างตารางตาม Entity ให้อัตโนมัติ ห้ามใช้ใน Production เด็ดขาด เพราะอาจทำให้ข้อมูลหายได้ ใน Production ควรใช้ระบบ Migration แทน + +3. แก้ไข main.ts เพื่อเปิดใช้งาน Swagger, Validation และ Security +เปิดไฟล์ src/main.ts และเพิ่มการตั้งค่าต่างๆ เข้าไป: + +src/main.ts + +TypeScript + +import { NestFactory } from '@nestjs/core'; +import { AppModule } from './app.module'; +import { ValidationPipe } from '@nestjs/common'; +import { DocumentBuilder, SwaggerModule } from '@nestjs/swagger'; +import helmet from 'helmet'; + +async function bootstrap() { + const app = await NestFactory.create(AppModule); + + // เปิดใช้งาน CORS (Cross-Origin Resource Sharing) + app.enableCors(); + + // เพิ่ม Helmet เพื่อความปลอดภัย + app.use(helmet()); + + // ตั้งค่า Global Validation Pipe + app.useGlobalPipes(new ValidationPipe({ + whitelist: true, // ตัด property ที่ไม่มีใน DTO ออก + transform: true, // แปลงข้อมูลให้เป็น type ที่ระบุใน DTO + })); + + // ตั้งค่า Swagger API Documentation + const config = new DocumentBuilder() + .setTitle('LCBP3-DMS API') + .setDescription('The Document Management System API for LCBP3 Project') + .setVersion('1.0') + .addBearerAuth() // สำหรับ JWT + .build(); + const document = SwaggerModule.createDocument(app, config); + SwaggerModule.setup('api-docs', app, document); // เข้าถึงได้ที่ /api-docs + + // เริ่มรัน Server + const port = process.env.API_PORT || 3001; + await app.listen(port); + console.log(`Application is running on: ${await app.getUrl()}`); +} +bootstrap(); + +curl -i -X POST \ + -H "Content-Type: application/json" \ + -d '{"username": "superadmin", "password": "Center#2025"}' \ + https://backend.np-dms.work/api/auth/login \ No newline at end of file diff --git a/docs/features.bak b/docs/features.bak new file mode 100644 index 0000000..f191988 --- /dev/null +++ b/docs/features.bak @@ -0,0 +1,17 @@ +ฟีเจอร์ขั้นสูง (Advanced Features) +Error Handling: ใช้ Global Exception Filter เพื่อจัดการ Error และส่ง Response ที่เป็นมาตรฐาน + +Logging: ใช้ Winston สำหรับ Structured Logging และบันทึก Error ลงไฟล์ + +Testing: มีโครงสร้างสำหรับ Unit Test และ E2E Test ด้วย Jest และ Supertest + +Performance: ใช้ CacheModule สำหรับ Caching ข้อมูลที่เรียกใช้บ่อย + +Security: + +Rate Limiting: ใช้ ThrottlerModule เพื่อป้องกัน Brute-force attack + +Secret Management: แนะนำให้ใช้ Environment Variable ของ Docker แทนไฟล์ .env ใน Production + +API Documentation: สร้างเอกสาร API อัตโนมัติด้วย @nestjs/swagger และเข้าถึงได้ที่ /api-docs + diff --git a/docs/frontend.md b/docs/frontend.md new file mode 100644 index 0000000..61c0fcf --- /dev/null +++ b/docs/frontend.md @@ -0,0 +1,94 @@ + +xxx npx shadcn@latest init + +✔ npx shadcn@latest init + +✔ Would you like to use TypeScript (recommended)? Yes +✔ Which style would you like to use? Default +✔ Which base color would you like to use? Slate +✔ Where is your global CSS file? src/app/globals.css +✔ Would you like to use CSS variables...? Yes +✔ Where is your tailwind.config.ts...? tailwind.config.ts +✔ Configure the import alias for components: @/components +✔ Configure the import alias for utils: @/lib/utils +✔ Are you using React Server Components? Yes + +npm install @tanstack/react-query zustand react-hook-form zod axios + +npm install msw --save-dev + +LCBP3 DMS V1.2.0 +Custom Gem +รับทราบครับ เราจะไปขั้นตอนต่อไป คือการสร้าง App Shell Layout (โครงสร้างหน้าเว็บหลัก) ตามข้อกำหนด 5.1 + +เราจะสร้าง 3 ส่วนหลัก: + +Sidebar (เมนูด้านข้าง) + +Navbar/Header (แถบด้านบน) + +Main Content Area (พื้นที่เนื้อหา) + +2.1 ติดตั้ง Icons +npm install lucide-react + +3.1 ติดตั้ง Shadcn Components ที่จำเป็น +npx shadcn@latest add card +npx shadcn@latest add table +npx shadcn@latest add button +npx shadcn@latest + +4.1 ตั้งค่า React Query (TanStack Query) Provider +npm install @tanstack/react-query-devtools + +4.2 ตั้งค่า Mock Service Worker (MSW) +npx msw init public/ --save + +4.4 อัปเดต MyTasksTable (ให้เรียก API จริง) +npm install axios + +5.1 ติดตั้ง Shadcn Components +npx shadcn@latest add badge + + +5.4 (ตัวอย่าง) การนำไปใช้ในหน้า RFA +เรายังไม่ได้สร้างหน้า /rfa/[id]/page.tsx แต่เมื่อสร้างเสร็จ เราจะเรียกใช้ Component นี้โดยส่ง props ไป: + +// src/app/rfa/[id]/page.tsx (ตัวอย่างในอนาคต) + +// import { mockWorkflow } from "@/mocks/data/mock-workflow"; +// import { WorkflowVisualizer } from "@/components/workflow/workflow-visualizer"; + +// export default function RfaDetailPage({ params }: { params: { id: string } }) { +// // 1. (ในอนาคต) ดึงข้อมูล RFA และ Workflow steps จาก API +// // const { data: rfaData } = useQuery(...); +// // const steps = rfaData.workflowSteps; + +// // 2. (ในอนาคต) ดึงสิทธิ์ผู้ใช้จาก Zustand (Global State) +// // const { user } = useAuthStore(); +// // const isAdmin = user.role === 'ADMIN' || user.role === 'SUPER_ADMIN'; + +// // 3. ส่ง Props ไปยัง Component +// return ( +//
+// {/* (แสดงรายละเอียด RFA ที่นี่) */} + +// +//
+// ); +// } + +6.1 ติดตั้ง Shadcn Components ที่จำเป็น +npx shadcn@latest add avatar +npx shadcn@latest add dialog +npx shadcn@latest add form +npx shadcn@latest add input +npx shadcn@latest add label +npx shadcn@latest add dropdown-menu +npx shadcn@latest add checkbox +npx shadcn@latest add pagination + +x 6.2 อัปเดต Mock API (MSW) x \ No newline at end of file diff --git a/docs/ux_ui.md b/docs/ux_ui.md new file mode 100644 index 0000000..5ec2872 --- /dev/null +++ b/docs/ux_ui.md @@ -0,0 +1,42 @@ + + You are an expert in Bootstrap and modern web application development. + + Key Principles + - Write clear, concise, and technical responses with precise Bootstrap examples. + - Utilize Bootstrap's components and utilities to streamline development and ensure responsiveness. + - Prioritize maintainability and readability; adhere to clean coding practices throughout your HTML and CSS. + - Use descriptive class names and structure to promote clarity and collaboration among developers. + + Bootstrap Usage + - Leverage Bootstrap's grid system for responsive layouts; use container, row, and column classes to structure content. + - Utilize Bootstrap components (e.g., buttons, modals, alerts) to enhance user experience without extensive custom CSS. + - Apply Bootstrap's utility classes for quick styling adjustments, such as spacing, typography, and visibility. + - Ensure all components are accessible; use ARIA attributes and semantic HTML where applicable. + + Error Handling and Validation + - Implement form validation using Bootstrap's built-in styles and classes to enhance user feedback. + - Use Bootstrap's alert component to display error messages clearly and informatively. + - Structure forms with appropriate labels, placeholders, and error messages for a better user experience. + + Dependencies + - Bootstrap (latest version, CSS and JS) + - Any JavaScript framework (like jQuery, if required) for interactive components. + + Bootstrap-Specific Guidelines + - Customize Bootstrap's Sass variables and mixins to create a unique theme without overriding default styles. + - Utilize Bootstrap's responsive utilities to control visibility and layout on different screen sizes. + - Keep custom styles to a minimum; use Bootstrap's classes wherever possible for consistency. + - Use the Bootstrap documentation to understand component behavior and customization options. + + Performance Optimization + - Minimize file sizes by including only the necessary Bootstrap components in your build process. + - Use a CDN for Bootstrap resources to improve load times and leverage caching. + - Optimize images and other assets to enhance overall performance, especially for mobile users. + + Key Conventions + 1. Follow Bootstrap's naming conventions and class structures to ensure consistency across your project. + 2. Prioritize responsiveness and accessibility in every stage of development. + 3. Maintain a clear and organized file structure to enhance maintainability and collaboration. + + Refer to the Bootstrap documentation for best practices and detailed examples of usage patterns. + \ No newline at end of file diff --git a/docs/workflow.bak b/docs/workflow.bak new file mode 100644 index 0000000..1df2e7c --- /dev/null +++ b/docs/workflow.bak @@ -0,0 +1,192 @@ +## Workflow ระดับ Project (correspondence_routing_steps, technical_doc_workflows): คือ "การเดินทาง" ของเอกสาร ระหว่างองค์กร (เช่น จากผู้รับเหมา -> ไปยังที่ปรึกษา -> ไปยังเจ้าของโครงการ) + +## Workflow ระดับ Organization (Circulation): คือ "การแจกจ่าย" เอกสาร ภายในองค์กรของคุณเอง หลังจากที่คุณได้รับเอกสารนั้นมาแล้ว (เช่น เอกสารมาถึง Document Control แล้วต้องส่งต่อให้ใครบ้างในบริษัท) + +circulation_templates: ตารางหลักสำหรับเก็บชื่อแม่แบบ +circulation_template_assignees: ตารางสำหรับเก็บ "รายชื่อผู้รับผิดชอบ" ที่ถูกกำหนดไว้ในแต่ละแม่แบบ + +Workflow การทำงานใน Frontend +1. หน้า Admin Panel: จะต้องมีเมนูใหม่สำหรับให้ Admin หรือผู้มีสิทธิ์ เข้าไป สร้าง/แก้ไข/ลบ แม่แบบใบเวียน (circulation_templates) สำหรับองค์กรของตนเองได้ + +2. หน้าที่สร้างใบเวียน (Create Circulation Dialog): + * ที่ด้านบนสุดของฟอร์ม จะมี Dropdown ใหม่ ปรากฏขึ้นมา เขียนว่า "ใช้แม่แบบ (Use Template)" + * ใน Dropdown นี้ จะแสดงรายชื่อแม่แบบทั้งหมดที่องค์กรนั้นๆ สร้างไว้ + * เมื่อผู้ใช้เลือกแม่แบบ: + ** ระบบจะยิง API ไปดึงรายชื่อผู้รับผิดชอบจากตาราง circulation_template_assignees + ** จากนั้น JavaScript จะทำการเติมข้อมูล (Auto-populate) ลงในช่อง "Main", "Action", และ "Information" ให้โดยอัตโนมัติ + * ผู้ใช้ยังสามารถ แก้ไข/เพิ่มเติม/ลบ รายชื่อผู้รับผิดชอบได้ตามต้องการ ก่อนที่จะกดสร้างใบเวียนจริง + + +การจัดการข้อมูล JSON จะเกิดขึ้นใน 3 ส่วนหลักๆ คือ Backend, Frontend, และ Database ครับ + +## 1. การจัดการในฝั่ง Backend (NestJS) +นี่คือส่วนที่ทำหน้าที่หลักในการสร้างและอ่านข้อมูล JSON อย่างเป็นระบบและปลอดภัย + +1.1 การแก้ไข Entity +เราจะแก้ไข Correspondence entity โดยเพิ่มคอลัมน์ details เข้าไป และลบ Entity ย่อยๆ ที่ไม่ใช้ออก + +src/correspondences/entities/correspondence.entity.ts +@Entity('correspondences') +export class Correspondence { + // ... (คอลัมน์เดิมทั้งหมด: id, document_number, title, etc.) + + @Column({ + type: 'json', // ◀️ กำหนดประเภทข้อมูลเป็น JSON + nullable: true, + comment: 'เก็บข้อมูลเฉพาะของเอกสารแต่ละประเภทในรูปแบบ JSON' + }) + details: any; // ◀️ ใช้ type 'any' หรือสร้าง Interface/Type ที่ซับซ้อนขึ้น +} + +1.2 การสร้าง DTOs สำหรับแต่ละประเภทเอกสาร +เพื่อรักษาความถูกต้องของข้อมูล (Validation) เราจะสร้าง DTO แยกสำหรับเอกสารแต่ละประเภท + +ตัวอย่าง src/correspondences/dto/create-letter.dto.ts: + +TypeScript + +import { ApiProperty } from '@nestjs/swagger'; +import { IsNotEmpty, IsString } from 'class-validator'; + +// DTO สำหรับข้อมูลใน details ของ Letter +class LetterDetailsDto { + @ApiProperty() + @IsString() + @IsNotEmpty() + attention_to: string; + + @ApiProperty() + @IsString() + @IsNotEmpty() + signatory_name: string; +} + +// DTO หลักสำหรับสร้าง Letter +export class CreateLetterDto { + @ApiProperty({ description: "ข้อมูลพื้นฐานของเอกสาร" }) + @ValidateNested() // ◀️ บอกให้ class-validator ตรวจสอบ object ข้างในด้วย + @Type(() => CreateCorrespondenceDto) // ◀️ ใช้ DTO พื้นฐานร่วมกัน + base_data: CreateCorrespondenceDto; + + @ApiProperty({ description: "ข้อมูลเฉพาะของ Letter" }) + @ValidateNested() + @Type(() => LetterDetailsDto) + details: LetterDetailsDto; +} + +1.3 การสร้าง API Endpoint และ Logic ใน Service +เราจะสร้าง Endpoint แยกสำหรับสร้างเอกสารแต่ละประเภทเพื่อความชัดเจน + +ใน CorrespondencesController: + +TypeScript + +@Post('letter') +@ApiOperation({ summary: 'Create a new Letter' }) +createLetter(@Body() createLetterDto: CreateLetterDto, @Req() req: Request) { + const user = req.user as any; + return this.correspondencesService.createTypedCorrespondence( + createLetterDto.base_data, + createLetterDto.details, + user + ); +} +ใน CorrespondencesService: + +TypeScript + +async createTypedCorrespondence(baseData: CreateCorrespondenceDto, details: any, user: User): Promise { + // ... (โค้ดตรวจสอบสิทธิ์เหมือนเดิม) + + const newCorrespondence = this.correspondenceRepository.create({ + ...baseData, // ข้อมูลพื้นฐาน (เลขที่เอกสาร, ชื่อเรื่อง, etc.) + details: details, // ◀️ นำ object ของ details มาใส่ในคอลัมน์ JSON โดยตรง + created_by_user_id: user.user_id, + originator_org_id: user.org_id, + status_id: 1, // 'Draft' + }); + + return this.correspondenceRepository.save(newCorrespondence); +} +## 2. การจัดการในฝั่ง Frontend (Next.js / React) +Frontend จะทำหน้าที่แสดงฟอร์มที่ถูกต้องตามประเภทเอกสาร และส่งข้อมูลในรูปแบบที่ Backend ต้องการ + +2.1 การแสดงฟอร์มแบบไดนามิก (Dynamic Forms) +ในหน้า "Create Correspondence" เมื่อผู้ใช้เลือกประเภทเอกสารจาก Dropdown เราจะใช้ State เพื่อแสดงฟอร์มที่ถูกต้อง + +TypeScript + +const [docType, setDocType] = useState('LETTER'); + +// ... + +const renderDetailFields = () => { + switch (docType) { + case 'LETTER': + return ( + <> + {/* ฟิลด์สำหรับ Attention To, Signatory */} + + ); + case 'RFI': + return ( + <> + {/* ฟิลด์สำหรับ Question, Required By Date */} + + ); + default: + return null; + } +} + +return ( +
+ {/* ฟิลด์พื้นฐาน (Document Number, Title) */} + {/* Dropdown เลือกประเภทเอกสาร */} + {renderDetailFields()} {/* ◀️ แสดงฟิลด์เฉพาะทางที่นี่ */} +
+); +2.2 การส่งข้อมูล +เมื่อผู้ใช้กด Submit เราจะรวบรวมข้อมูลจากฟอร์มให้เป็นโครงสร้าง JSON ที่ Backend ต้องการ + +JavaScript + +const handleSubmit = () => { + // รวบรวมข้อมูลพื้นฐาน + const base_data = { + document_number: '...', + title: '...', + // ... + }; + + // รวบรวมข้อมูลเฉพาะทาง + const details = { + attention_to: '...', + signatory_name: '...', + }; + + // ส่งข้อมูลไปที่ API Endpoint ที่ถูกต้อง + fetch('/api/correspondences/letter', { + method: 'POST', + body: JSON.stringify({ base_data, details }), + }); +} +## 3. การจัดการในระดับฐานข้อมูล (MariaDB) +แม้ว่าเราจะไม่ค่อยได้ Query ข้อมูล JSON โดยตรงผ่าน SQL บ่อยนัก แต่ก็สามารถทำได้เมื่อจำเป็น (เช่น สำหรับการทำรายงานที่ซับซ้อน) + +ตัวอย่าง: ค้นหาเอกสาร Letter ทั้งหมดที่ส่งถึง "Mr. John Doe" + +SQL + +SELECT + corr_id, + document_number, + details +FROM + correspondences +WHERE + type_id = (SELECT type_id FROM correspondence_types WHERE type_code = 'LETTER') -- กรองเฉพาะ Letter + AND JSON_VALUE(details, '$.attention_to') = 'Mr. John Doe'; -- ◀️ ค้นหาค่าใน JSON +การจัดการข้อมูลด้วยวิธีนี้จะทำให้ระบบของคุณมีความ + + diff --git a/prompt.md b/prompt.md new file mode 100644 index 0000000..7d57728 --- /dev/null +++ b/prompt.md @@ -0,0 +1,150 @@ +# **PROMPT** + +## Gemini + +## VSCode Shortcut + +Markdown preview Ctrl+Shift+V + +## สร้างโครงสร้างโฟลเดอร์สำหรับ lcbp3-backend + +```bash +# สร้างโฟลเดอร์หลัก +$rootFolder = "backend" +New-Item -ItemType Directory -Path $rootFolder -Force +Set-Location $rootFolder + +# รายการโฟลเดอร์ที่ต้องการสร้างทั้งหมด + $folders = @( + "src", + "database", + "src\common", + "src\modules", + "src\modules\user", + "src\modules\project", + "src\modules\master", + "src\modules\correspondence", + "src\modules\rfa", + "src\modules\drawing", + "src\modules\circulations", + "src\modules\transmittal", + "src\modules\search", + "src\modules\document-numbering", + "src\common\auth", + "src\common\config", + "src\common\decorators", + "src\common\entities", + "src\common\exceptions", + "src\common\file-storage", + "src\common\guards", + "src\common\interceptors", + "src\common\services" +) + +# วนลูปสร้างโฟลเดอร์ทั้งหมด +foreach ($folder in $folders) { + New-Item -ItemType Directory -Path $folder -Force +} + +Write-Host "สร้างโครงสร้างโฟลเดอร์สำหรับ backend เรียบร้อยแล้ว" -ForegroundColor Green + +``` + +## Git Commands + +```bash + +# 1️⃣ ตั้งชื่อและอีเมลของคุณ (ใช้กับทุก repo) +git config --global user.name "Pean Charoen" +git config --global user.email "peancharoen.pslcp3@gmail.com" + +# 2️⃣ ตรวจสอบว่าเชื่อมกับ remote ถูกต้อง (แก้ URL ให้ตรง repo จริงของคุณ) +git remote set-url origin ssh://git@git.np-dms.work:2222/np-dms/lcbp3_v1.git + +# 3️⃣ ตรวจสอบสถานะไฟล์ +git status + +# 4️⃣ เพิ่มไฟล์ทั้งหมด +git add . + +# 5️⃣ Commit พร้อมข้อความ +git commit -m "Update project files" + +# 6️⃣ ดึง remote ก่อนเพื่อป้องกัน conflict (ถ้ามี) +git pull --rebase origin main + +# 7️⃣ Push ขึ้น Gitea +git push -u origin main + +``` + +## **สร้าง NestJS Project ใหม่** + +* ขั้นตอนที่ 1: ติดตั้ง NestJS CLI (ถ้ายังไม่ได้ติดตั้ง) + * npm install -g @nestjs/cli + +* ขั้นตอนที่ 2: สร้างโปรเจกต์ใหม่ + * nest new backend + * nest new . /อยู่ในโฟลเดอร์ที่สร้างไว้แล้ว และต้องการสร้างโปรเจกต์ลงในโฟลเดอร์นั้นโดยตรง: + +* ขั้นตอนที่ 3: ติดตั้ง Dependencies เพิ่มเติมสำหรับ DMS + +```bash +# Core & Database +npm install @nestjs/typeorm typeorm mysql2 +npm install @nestjs/config + +# Validation & Transformation +npm install class-validator class-transformer + +# Authentication & Authorization +npm install @nestjs/jwt @nestjs/passport passport passport-jwt +npm install @nestjs/passport +npm install casl + +# File Upload +npm install @nestjs/platform-express multer + +# Documentation +npm install @nestjs/swagger + +# Security & Performance +npm install helmet rate-limiter-flexible + +# Development Dependencies (สำหรับทดสอบ) +npm install --save-dev @nestjs/testing jest @types/jest @types/passport-jwt @types/multer supertest + +``` + +## Prompt: การพัฒนา Core Auth Module (AuthModule) สำหรับ DMS v1.2.0 + +ช่วยตั้งค่า tsconfig.json, nest-cli.json และไฟล์ config อื่นๆ + +* 1.1 สร้าง User Entity + +* 1.2 สร้าง Role Entity + +* 1.3 สร้าง Permission Entity + +ถัดไป ช่วยสร้าง TypeORM configuration และ DatabaseModule ให้หน่อย +ช่วยสร้าง AuthService, JwtStrategy และ AuthController พื้นฐานให้หน่อย +ช่วยสร้าง UserModule, UserService, LocalAuthGuard และ LocalStrategy สำหรับจัดการข้อมูลผู้ใช้หน่อย +ช่วยสร้าง Guard สำหรับตรวจสอบสิทธิ์ตามบทบาท (RBAC) โดยใช้ CASL หน่อย +ช่วยสร้าง UserModule, UserService, และ UserController + +ช่วยตั้งค่าการเชื่อมต่อ MariaDB ผ่าน TypeORM + +พัฒนา Core Auth Module (`AuthModule`) +- ช่วยสร้าง API Endpoints: `/auth/login`, `/auth/me` + +พัฒนา Common Module (`@app/common`) +- ช่วยสร้าง FileStorageService สำหรับจัดการไฟล์ (อัปโหลด/ดาวน์โหลด) backend/common/file-storage +- ช่วยสร้าง AuditLogInterceptor สำหรับบันทึกการกระทำโดยอัตโนมัติ +- ช่วยสร้าง Global Exception Filter +- ช่วยสร้าง DTOs และ Interfaces พื้นฐาน + +--- + + + +ขอบคุณสำหรับข้อมูลที่ละเอียดครับ นี่คือการวิเคราะห์และข้อเสนอแนะเพื่อให้โครงสร้างสิทธิ์การใช้งาน (Access Control / RBAC) ชัดเจน สมบูรณ์ และสามารถนำไปพัฒนาได้จริงครับ