From 0a0c6645d5d8640a1764015631e1a8dee29638b6 Mon Sep 17 00:00:00 2001 From: admin Date: Wed, 26 Nov 2025 13:24:32 +0700 Subject: [PATCH] =?UTF-8?q?251126:1200=20=E0=B9=81=E0=B8=81=E0=B9=89?= =?UTF-8?q?=E0=B9=84=E0=B8=82=20document-numbering:=E0=B8=82=E0=B9=89?= =?UTF-8?q?=E0=B8=AD=E0=B8=81=E0=B8=B3=E0=B8=AB=E0=B8=99=E0=B8=94,=20?= =?UTF-8?q?=E0=B8=95=E0=B8=B2=E0=B8=A3=E0=B8=B2=E0=B8=87?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- 0_Requirements_V1_4_4.md | 777 +++++ 1_FullStackJS_V1_4_4.md | 975 ++++++ 2_Backend_Plan_V1_4_4.md | 565 ++++ 3_Frontend_Plan_V1_4_4.md | 1008 ++++++ 4_Data_Dictionary_V1_4_4.md | 2905 +++++++++++++++++ 01_lcbp3_v1_4_3.sql => 8_lcbp3_v1_4_4.sql | 1018 +----- 8_lcbp3_v1_4_4_seed.sql | 2127 ++++++++++++ .../01_lcbp3_v1_4_3.sql | 0 docs/6B.md | 191 ++ .../Markdown/0_Requirements_V1_4_3.md | 0 .../Markdown/1_FullStackJS_V1_4_3.md | 0 .../Markdown/2_Backend_Plan_Phase6A_V1_4_3.md | 397 +++ .../Markdown/2_Backend_Plan_V1_4_3.md | 0 .../Markdown/3_Frontend_Plan_V1_4_3.md | 0 .../Markdown/4_Data_Dictionary_V1_4_3.md | 0 docs/prompt.md | 200 +- docs/temp.md | 188 -- ~$Dis.xlsx | Bin 165 -> 0 bytes 18 files changed, 9209 insertions(+), 1142 deletions(-) create mode 100644 0_Requirements_V1_4_4.md create mode 100644 1_FullStackJS_V1_4_4.md create mode 100644 2_Backend_Plan_V1_4_4.md create mode 100644 3_Frontend_Plan_V1_4_4.md create mode 100644 4_Data_Dictionary_V1_4_4.md rename 01_lcbp3_v1_4_3.sql => 8_lcbp3_v1_4_4.sql (75%) create mode 100644 8_lcbp3_v1_4_4_seed.sql rename 01_lcbp3_v1_4_3 copy.sql => docs/01_lcbp3_v1_4_3.sql (100%) create mode 100644 docs/6B.md rename 0_Requirements_V1_4_3.md => docs/Markdown/0_Requirements_V1_4_3.md (100%) rename 1_FullStackJS_V1_4_3.md => docs/Markdown/1_FullStackJS_V1_4_3.md (100%) create mode 100644 docs/Markdown/2_Backend_Plan_Phase6A_V1_4_3.md rename 2_Backend_Plan_V1_4_3.md => docs/Markdown/2_Backend_Plan_V1_4_3.md (100%) rename 3_Frontend_Plan_V1_4_3.md => docs/Markdown/3_Frontend_Plan_V1_4_3.md (100%) rename 4_Data_Dictionary_V1_4_3.md => docs/Markdown/4_Data_Dictionary_V1_4_3.md (100%) delete mode 100644 docs/temp.md delete mode 100644 ~$Dis.xlsx diff --git a/0_Requirements_V1_4_4.md b/0_Requirements_V1_4_4.md new file mode 100644 index 0000000..1ec46b9 --- /dev/null +++ b/0_Requirements_V1_4_4.md @@ -0,0 +1,777 @@ +# 📝 **Documents Management System Version 1.4.4: Application Requirements Specification** + +**āļŠāļ–āļēāļ™āļ°:** FINAL-Rev.04 +**āļ§āļąāļ™āļ—āļĩāđˆ:** 2025-11-26 +**āļ­āđ‰āļēāļ‡āļ­āļīāļ‡āļžāļ·āđ‰āļ™āļāļēāļ™:** v1.4.3 +**Classification:** Internal Technical Documentation + +## 📌 **1. āļ§āļąāļ•āļ–āļļāļ›āļĢāļ°āļŠāļ‡āļ„āđŒ** + +āļŠāļĢāđ‰āļēāļ‡āđ€āļ§āđ‡āļšāđāļ­āļ›āļžāļĨāļīāđ€āļ„āļŠāļąāļ™āļŠāļģāļŦāļĢāļąāļšāļĢāļ°āļšāļšāļšāļĢāļīāļŦāļēāļĢāļˆāļąāļ”āļāļēāļĢāđ€āļ­āļāļŠāļēāļĢāđ‚āļ„āļĢāļ‡āļāļēāļĢ (Document Management System - DMS) āđāļšāļšāļ„āļĢāļšāļ§āļ‡āļˆāļĢ āļ—āļĩāđˆāđ€āļ™āđ‰āļ™āļ„āļ§āļēāļĄāļ›āļĨāļ­āļ”āļ āļąāļĒāļŠāļđāļ‡āļŠāļļāļ” āļ„āļ§āļēāļĄāļ–āļđāļāļ•āđ‰āļ­āļ‡āļ‚āļ­āļ‡āļ‚āđ‰āļ­āļĄāļđāļĨ (Data Integrity) āđāļĨāļ°āļĢāļ­āļ‡āļĢāļąāļšāļāļēāļĢāļ‚āļĒāļēāļĒāļ•āļąāļ§āđƒāļ™āļ­āļ™āļēāļ„āļ• (Scalability) āđ‚āļ”āļĒāđāļāđ‰āđ„āļ‚āļ›āļąāļāļŦāļē Race Condition āđāļĨāļ°āđ€āļžāļīāđˆāļĄāļ„āļ§āļēāļĄāđ€āļŠāļ–āļĩāļĒāļĢāđƒāļ™āļāļēāļĢāļˆāļąāļ”āļāļēāļĢāđ„āļŸāļĨāđŒāđāļĨāļ° Workflow + +- āļĄāļĩāļŸāļąāļ‡āļāđŒāļŠāļąāļ™āļŦāļĨāļąāļāđƒāļ™āļāļēāļĢāļ­āļąāļ›āđ‚āļŦāļĨāļ” āļˆāļąāļ”āđ€āļāđ‡āļš āļ„āđ‰āļ™āļŦāļē āđāļŠāļĢāđŒ āđāļĨāļ°āļ„āļ§āļšāļ„āļļāļĄāļŠāļīāļ—āļ˜āļīāđŒāļāļēāļĢāđ€āļ‚āđ‰āļēāļ–āļķāļ‡āđ€āļ­āļāļŠāļēāļĢ +- āļŠāđˆāļ§āļĒāļĨāļ”āļāļēāļĢāđƒāļŠāđ‰āđ€āļ­āļāļŠāļēāļĢāļāļĢāļ°āļ”āļēāļĐ āđ€āļžāļīāđˆāļĄāļ„āļ§āļēāļĄāļ›āļĨāļ­āļ”āļ āļąāļĒāđƒāļ™āļāļēāļĢāļˆāļąāļ”āđ€āļāđ‡āļšāļ‚āđ‰āļ­āļĄāļđāļĨ +- āđ€āļžāļīāđˆāļĄāļ„āļ§āļēāļĄāļŠāļ°āļ”āļ§āļāđƒāļ™āļāļēāļĢāļ—āļģāļ‡āļēāļ™āļĢāđˆāļ§āļĄāļāļąāļ™āļĢāļ°āļŦāļ§āđˆāļēāļ‡āļ­āļ‡āļāļĢāļ“āđŒ +- **āđ€āļŠāļĢāļīāļĄ:** āļ›āļĢāļąāļšāļ›āļĢāļļāļ‡āļ„āļ§āļēāļĄāļ›āļĨāļ­āļ”āļ āļąāļĒāļ‚āļ­āļ‡āļĢāļ°āļšāļšāļ”āđ‰āļ§āļĒāļĄāļēāļ•āļĢāļāļēāļĢāļ›āđ‰āļ­āļ‡āļāļąāļ™āļ—āļĩāđˆāļ—āļąāļ™āļŠāļĄāļąāļĒ +- **āđ€āļŠāļĢāļīāļĄ:** āđ€āļžāļīāđˆāļĄāļ„āļ§āļēāļĄāļ—āļ™āļ—āļēāļ™āļ‚āļ­āļ‡āļĢāļ°āļšāļšāļ”āđ‰āļ§āļĒāļāļĨāđ„āļ resilience patterns +- **āđ€āļŠāļĢāļīāļĄ:** āļŠāļĢāđ‰āļēāļ‡āļĢāļ°āļšāļš monitoring āđāļĨāļ° observability āļ—āļĩāđˆāļ„āļĢāļ­āļšāļ„āļĨāļļāļĄ + +## 🛠ïļ **2. āļŠāļ–āļēāļ›āļąāļ•āļĒāļāļĢāļĢāļĄāđāļĨāļ°āđ€āļ—āļ„āđ‚āļ™āđ‚āļĨāļĒāļĩ (System Architecture & Technology Stack)** + +āđƒāļŠāđ‰āļŠāļ–āļēāļ›āļąāļ•āļĒāļāļĢāļĢāļĄāđāļšāļš Headless/API-First āļ—āļĩāđˆāļ—āļąāļ™āļŠāļĄāļąāļĒ āļ—āļģāļ‡āļēāļ™āļ—āļąāđ‰āļ‡āļŦāļĄāļ”āļšāļ™ QNAP Server āļœāđˆāļēāļ™ Container Station āđ€āļžāļ·āđˆāļ­āļ„āļ§āļēāļĄāļŠāļ°āļ”āļ§āļāđƒāļ™āļāļēāļĢāļˆāļąāļ”āļāļēāļĢāđāļĨāļ°āļšāļģāļĢāļļāļ‡āļĢāļąāļāļĐāļē + +**Domain:** `np-dms.work`, `www.np-dms.work` +**IP:** 159.192.126.103 +**Docker Network:** āļ—āļļāļ Service āļˆāļ°āđ€āļŠāļ·āđˆāļ­āļĄāļ•āđˆāļ­āļœāđˆāļēāļ™āđ€āļ„āļĢāļ·āļ­āļ‚āđˆāļēāļĒāļāļĨāļēāļ‡āļŠāļ·āđˆāļ­ `lcbp3` āđ€āļžāļ·āđˆāļ­āđƒāļŦāđ‰āļŠāļēāļĄāļēāļĢāļ–āļŠāļ·āđˆāļ­āļŠāļēāļĢāļāļąāļ™āđ„āļ”āđ‰ + +### **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/Cursor on Windows 11 +- **Data Storage:** `/share/dms-data` āļšāļ™ QNAP +- **āļ‚āđ‰āļ­āļˆāļģāļāļąāļ”:** āđ„āļĄāđˆāļŠāļēāļĄāļēāļĢāļ–āđƒāļŠāđ‰ .env āđƒāļ™āļāļēāļĢāļāļģāļŦāļ™āļ”āļ•āļąāļ§āđāļ›āļĢāļ āļēāļĒāļ™āļ­āļāđ„āļ”āđ‰ āļ•āđ‰āļ­āļ‡āļāļģāļŦāļ™āļ”āđƒāļ™ docker-compose.yml āđ€āļ—āđˆāļēāļ™āļąāđ‰āļ™ + +### **2.2 āļāļēāļĢāļˆāļąāļ”āļāļēāļĢ Configuration (āļ›āļĢāļąāļšāļ›āļĢāļļāļ‡):** + +- āđƒāļŠāđ‰ `docker-compose.yml` āļŠāļģāļŦāļĢāļąāļš environment variables āļ•āļēāļĄāļ‚āđ‰āļ­āļˆāļģāļāļąāļ”āļ‚āļ­āļ‡ QNAP +- **Secrets Management (āđƒāļŦāļĄāđˆ):** + - āļŦāđ‰āļēāļĄāļĢāļ°āļšāļļ Sensitive Secrets (Password, Keys) āđƒāļ™ `docker-compose.yml` āļŦāļĨāļąāļ + - āļ•āđ‰āļ­āļ‡āđƒāļŠāđ‰āđ„āļŸāļĨāđŒ `docker-compose.override.yml` (āļ—āļĩāđˆāļ–āļđāļ gitignore) āļŠāļģāļŦāļĢāļąāļš Inject Environment Variables āļ—āļĩāđˆāđ€āļ›āđ‡āļ™āļ„āļ§āļēāļĄāļĨāļąāļšāđƒāļ™āđāļ•āđˆāļĨāļ° Environment (Dev/Prod) + - āđ„āļŸāļĨāđŒ `docker-compose.yml` āļŦāļĨāļąāļāđƒāļŦāđ‰āđƒāļŠāđˆāļ„āđˆāļē Dummy āļŦāļĢāļ·āļ­āļ§āđˆāļēāļ‡āđ„āļ§āđ‰ +- **āđāļ•āđˆāļ•āđ‰āļ­āļ‡āļĄāļĩ mechanism āļŠāļģāļŦāļĢāļąāļšāļˆāļąāļ”āļāļēāļĢ sensitive secrets āļ­āļĒāđˆāļēāļ‡āļ›āļĨāļ­āļ”āļ āļąāļĒ** āđ‚āļ”āļĒāđƒāļŠāđ‰: + - Docker secrets (āļ–āđ‰āļēāļĢāļ­āļ‡āļĢāļąāļš) + - External secret management (Hashicorp Vault) āļŦāļĢāļ·āļ­ + - Encrypted environment variables +- Development environment āļĒāļąāļ‡āđƒāļŠāđ‰ .env āđ„āļ”āđ‰ āđāļ•āđˆāļ•āđ‰āļ­āļ‡āđ„āļĄāđˆ commit āđ€āļ‚āđ‰āļē version control +- āļ•āđ‰āļ­āļ‡āļĄāļĩ configuration validation during application startup +- āļ•āđ‰āļ­āļ‡āđāļĒāļ configuration āļ•āļēāļĄ environment (development, staging, production) + +### **2.3 Core Services:** + +- **Code Hosting:** Gitea (Self-hosted on QNAP) + - Application name: git + - Service name: gitea + - Domain: `git.np-dms.work` + - āļŦāļ™āđ‰āļēāļ—āļĩāđˆ: āđ€āļ›āđ‡āļ™āļĻāļđāļ™āļĒāđŒāļāļĨāļēāļ‡āđƒāļ™āļāļēāļĢāđ€āļāđ‡āļšāđāļĨāļ°āļˆāļąāļ”āļāļēāļĢāđ€āļ§āļ­āļĢāđŒāļŠāļąāļ™āļ‚āļ­āļ‡āđ‚āļ„āđ‰āļ” (Source Code) āļŠāļģāļŦāļĢāļąāļšāļ—āļļāļāļŠāđˆāļ§āļ™ + +- **Backend / Data Platform:** NestJS + - Application name: lcbp3-backend + - Service name: backend + - Domain: `backend.np-dms.work` + - Framework: NestJS (Node.js, TypeScript, ESM) + - āļŦāļ™āđ‰āļēāļ—āļĩāđˆ: āļˆāļąāļ”āļāļēāļĢāđ‚āļ„āļĢāļ‡āļŠāļĢāđ‰āļēāļ‡āļ‚āđ‰āļ­āļĄāļđāļĨ (Data Models), āļŠāļĢāđ‰āļēāļ‡ API, āļˆāļąāļ”āļāļēāļĢāļŠāļīāļ—āļ˜āļīāđŒāļœāļđāđ‰āđƒāļŠāđ‰ (Roles & Permissions), āđāļĨāļ°āļŠāļĢāđ‰āļēāļ‡ Workflow āļ—āļąāđ‰āļ‡āļŦāļĄāļ”āļ‚āļ­āļ‡āļĢāļ°āļšāļš + +- **Database:** MariaDB 10.11 + - Application name: lcbp3-db + - Service name: mariadb + - Domain: `db.np-dms.work` + - āļŦāļ™āđ‰āļēāļ—āļĩāđˆ: āļāļēāļ™āļ‚āđ‰āļ­āļĄāļđāļĨāļŦāļĨāļąāļāļŠāļģāļŦāļĢāļąāļšāđ€āļāđ‡āļšāļ‚āđ‰āļ­āļĄāļđāļĨāļ—āļąāđ‰āļ‡āļŦāļĄāļ” + - Tooling: DBeaver (Community Edition), phpmyadmin āļŠāļģāļŦāļĢāļąāļšāļāļēāļĢāļ­āļ­āļāđāļšāļšāđāļĨāļ°āļˆāļąāļ”āļāļēāļĢāļāļēāļ™āļ‚āđ‰āļ­āļĄāļđāļĨ + +- **Database Management:** phpMyAdmin + - Application name: lcbp3-db + - Service: phpmyadmin:5-apache + - Service name: pma + - Domain: `pma.np-dms.work` + - āļŦāļ™āđ‰āļēāļ—āļĩāđˆ: āļˆāļąāļ”āļāļēāļĢāļāļēāļ™āļ‚āđ‰āļ­āļĄāļđāļĨ mariadb āļœāđˆāļēāļ™ Web UI + +- **Frontend:** Next.js + - Application name: lcbp3-frontend + - 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 + +- **Workflow Automation:** n8n + - Application name: lcbp3-n8n + - Service: n8nio/n8n:latest + - Service name: n8n + - Domain: `n8n.np-dms.work` + - āļŦāļ™āđ‰āļēāļ—āļĩāđˆ: āļˆāļąāļ”āļāļēāļĢ workflow āļĢāļ°āļŦāļ§āđˆāļēāļ‡ Backend āđāļĨāļ° Line + +- **Reverse Proxy:** Nginx Proxy Manager + - 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) āđƒāļŦāđ‰āļ­āļąāļ•āđ‚āļ™āļĄāļąāļ•āļī + +- **Search Engine:** Elasticsearch +- **Cache:** Redis + +### **2.4 Business Logic & Consistency (āļ›āļĢāļąāļšāļ›āļĢāļļāļ‡):** + +- **2.4.1 āļ•āļĢāļĢāļāļ°āļ—āļēāļ‡āļ˜āļļāļĢāļāļīāļˆāļ—āļĩāđˆāļ‹āļąāļšāļ‹āđ‰āļ­āļ™āļ—āļąāđ‰āļ‡āļŦāļĄāļ”** (āđ€āļŠāđˆāļ™ āļāļēāļĢāđ€āļ›āļĨāļĩāđˆāļĒāļ™āļŠāļ–āļēāļ™āļ° Workflow [cite: 3.5.3, 3.6.5], āļāļēāļĢāļšāļąāļ‡āļ„āļąāļšāđƒāļŠāđ‰āļŠāļīāļ—āļ˜āļīāđŒ [cite: 4.4], āļāļēāļĢāļ•āļĢāļ§āļˆāļŠāļ­āļš Deadline [cite: 3.2.5]) **āļˆāļ°āļ–āļđāļāļˆāļąāļ”āļāļēāļĢāđƒāļ™āļāļąāđˆāļ‡ Backend (NestJS)** [cite: 2.3] āđ€āļžāļ·āđˆāļ­āđƒāļŦāđ‰āļŠāļēāļĄāļēāļĢāļ–āļšāļģāļĢāļļāļ‡āļĢāļąāļāļĐāļēāđāļĨāļ°āļ—āļ”āļŠāļ­āļšāđ„āļ”āđ‰āļ‡āđˆāļēāļĒ (Testability) + +- **2.4.2 Unified Workflow Engine (āđƒāļŦāļĄāđˆ):** āļĢāļ§āļĄ Logic āļāļēāļĢāđ€āļ”āļīāļ™āđ€āļ­āļāļŠāļēāļĢāļ‚āļ­āļ‡ `CorrespondenceRouting` āđāļĨāļ° `RfaWorkflow` āđƒāļŦāđ‰āđƒāļŠāđ‰ Core Engine āđ€āļ”āļĩāļĒāļ§āļāļąāļ™āđ€āļžāļ·āđˆāļ­āļĨāļ”āļ„āļ§āļēāļĄāļ‹āđ‰āļģāļ‹āđ‰āļ­āļ™āđāļĨāļ°āļ‡āđˆāļēāļĒāļ•āđˆāļ­āļāļēāļĢāļšāļģāļĢāļļāļ‡āļĢāļąāļāļĐāļē + +- **2.4.3 Idempotency Keys (āđƒāļŦāļĄāđˆ):** API āļ—āļĩāđˆāļŠāļģāļ„āļąāļ (āđ€āļŠāđˆāļ™ Submit Document, Approve) āļ•āđ‰āļ­āļ‡āļšāļąāļ‡āļ„āļąāļšāļŠāđˆāļ‡ Header `Idempotency-Key` āđ€āļžāļ·āđˆāļ­āļ›āđ‰āļ­āļ‡āļāļąāļ™āļāļēāļĢāļ—āļģāļĢāļēāļĒāļāļēāļĢāļ‹āđ‰āļģāļˆāļēāļāļāļēāļĢāļāļ”āļ›āļļāđˆāļĄāļĢāļąāļ§āđ† āļŦāļĢāļ·āļ­ Network Retry + +- **2.4.4 Optimistic Locking (āđƒāļŦāļĄāđˆ):** āđƒāļŠāđ‰ Version Column āđƒāļ™ Database āļ„āļ§āļšāļ„āļđāđˆāļāļąāļš Redis Lock āļŠāļģāļŦāļĢāļąāļšāļāļēāļĢāļŠāļĢāđ‰āļēāļ‡āđ€āļĨāļ‚āļ—āļĩāđˆāđ€āļ­āļāļŠāļēāļĢ āđ€āļžāļ·āđˆāļ­āđ€āļ›āđ‡āļ™ Safety Net āļŠāļąāđ‰āļ™āļŠāļļāļ”āļ—āđ‰āļēāļĒ + +- **2.4.5** **āļˆāļ°āđ„āļĄāđˆāļĄāļĩāļāļēāļĢāđƒāļŠāđ‰ SQL Triggers** āđ€āļžāļ·āđˆāļ­āļ›āđ‰āļ­āļ‡āļāļąāļ™āļ•āļĢāļĢāļāļ°āļ‹āđˆāļ­āļ™āđ€āļĢāđ‰āļ™ (Hidden Logic) āđāļĨāļ°āļ„āļ§āļēāļĄāļ‹āļąāļšāļ‹āđ‰āļ­āļ™āđƒāļ™āļāļēāļĢāļ”āļĩāļšāļąāļ + +### **2.5 Data Migration āđāļĨāļ° Schema Versioning:** + +- āļ•āđ‰āļ­āļ‡āļĄāļĩ database migration scripts āļŠāļģāļŦāļĢāļąāļšāļ—āļļāļ schema change āđ‚āļ”āļĒāđƒāļŠāđ‰ TypeORM migrations +- āļ•āđ‰āļ­āļ‡āļĢāļ­āļ‡āļĢāļąāļš rollback āļ‚āļ­āļ‡ migration āđ„āļ”āđ‰ +- āļ•āđ‰āļ­āļ‡āļĄāļĩ data seeding strategy āļŠāļģāļŦāļĢāļąāļš environment āļ•āđˆāļēāļ‡āđ† (development, staging, production) +- āļ•āđ‰āļ­āļ‡āļĄāļĩ version compatibility between schema versions +- Migration scripts āļ•āđ‰āļ­āļ‡āļœāđˆāļēāļ™āļāļēāļĢāļ—āļ”āļŠāļ­āļšāđƒāļ™ staging environment āļāđˆāļ­āļ™ production +- āļ•āđ‰āļ­āļ‡āļĄāļĩ database backup āļāđˆāļ­āļ™āļ—āļģ migration āđƒāļ™ production + +### **2.6 āļāļĨāļĒāļļāļ—āļ˜āđŒāļ„āļ§āļēāļĄāļ—āļ™āļ—āļēāļ™āđāļĨāļ°āļāļēāļĢāļˆāļąāļ”āļāļēāļĢāļ‚āđ‰āļ­āļœāļīāļ”āļžāļĨāļēāļ” (Resilience & Error Handling Strategy)** + +- 2.6.1 Circuit Breaker Pattern: āđƒāļŠāđ‰āļŠāļģāļŦāļĢāļąāļš external service calls (Email, LINE, Elasticsearch) +- 2.6.2 Retry Mechanism: āļ”āđ‰āļ§āļĒ exponential backoff āļŠāļģāļŦāļĢāļąāļš transient failures +- 2.6.3 Fallback Strategies: Graceful degradation āđ€āļĄāļ·āđˆāļ­āļšāļĢāļīāļāļēāļĢāļ āļēāļĒāļ™āļ­āļāļĨāđ‰āļĄāđ€āļŦāļĨāļ§ +- 2.6.4 Error Handling: Error messages āļ•āđ‰āļ­āļ‡āđ„āļĄāđˆāđ€āļ›āļīāļ”āđ€āļœāļĒāļ‚āđ‰āļ­āļĄāļđāļĨ sensitive +- 2.6.5 Monitoring: Centralized error monitoring āđāļĨāļ° alerting system + +## **ðŸ“Ķ 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. Correspondence Routing & Workflow + - 3.2.5.1 Routing Templates (āđāļĄāđˆāđāļšāļšāļāļēāļĢāļŠāđˆāļ‡āļ•āđˆāļ­) + - āļœāļđāđ‰āļ”āļđāđāļĨāļĢāļ°āļšāļšāļ•āđ‰āļ­āļ‡āļŠāļēāļĄāļēāļĢāļ–āļŠāļĢāđ‰āļēāļ‡āđāļĄāđˆāđāļšāļšāļāļēāļĢāļŠāđˆāļ‡āļ•āđˆāļ­āđ„āļ”āđ‰ + - āđāļĄāđˆāđāļšāļšāļŠāļēāļĄāļēāļĢāļ–āđ€āļ›āđ‡āļ™āđāļšāļšāļ—āļąāđˆāļ§āđ„āļ› (āđƒāļŠāđ‰āđ„āļ”āđ‰āļ—āļļāļāđ‚āļ„āļĢāļ‡āļāļēāļĢ) āļŦāļĢāļ·āļ­āđ€āļ‰āļžāļēāļ°āđ‚āļ„āļĢāļ‡āļāļēāļĢ + - āđāļ•āđˆāļĨāļ°āđāļĄāđˆāđāļšāļšāļ›āļĢāļ°āļāļ­āļšāļ”āđ‰āļ§āļĒāļĨāļģāļ”āļąāļšāļ‚āļąāđ‰āļ™āļ•āļ­āļ™āļāļēāļĢāļŠāđˆāļ‡āļ•āđˆāļ­ + - āļāļēāļĢāļŠāđˆāļ‡āļˆāļēāļ Originator -> Organization 1 -> Organization 2 -> Organization 3 āđāļĨāđ‰āļ§āļŠāđˆāļ‡āļœāļĨāļāļĨāļąāļšāļ•āļēāļĄāļĨāļģāļ”āļąāļšāđ€āļ”āļīāļĄ (āđ‚āļ”āļĒāļ–āđ‰āļē āļ­āļ‡āļāļĢāļ“āđŒāđƒāļ”āđƒāļ™ Wouting āđƒāļŦāđ‰āļŠāđˆāļ‡āļāļĨāļąāļš āļāđ‡āļŠāļēāļĄāļēāļĢāļ–āļŠāđˆāļ‡āļœāļĨāļāļĨāļąāļšāļ•āļēāļĄāļĨāļģāļ”āļąāļšāđ€āļ”āļīāļĄāđ‚āļ”āļĒāđ„āļĄāđˆāļ•āđ‰āļ­āļ‡āļĢāļ­āđƒāļŦāđ‰āļ–āļķāļ‡ āļ­āļ‡āļāļĢāļ“āļ·āđƒāļ™āļĨāļģāļ”āļąāļšāļ–āļąāļ”āđ„āļ›) + - 3.2.5.2 Routing Steps (āļ‚āļąāđ‰āļ™āļ•āļ­āļ™āļāļēāļĢāļŠāđˆāļ‡āļ•āđˆāļ­) āđāļ•āđˆāļĨāļ°āļ‚āļąāđ‰āļ™āļ•āļ­āļ™āđƒāļ™āđāļĄāđˆāđāļšāļšāļ•āđ‰āļ­āļ‡āļāļģāļŦāļ™āļ”: + - **āļĨāļģāļ”āļąāļšāļ‚āļąāđ‰āļ™āļ•āļ­āļ™** (Sequence) + - **āļ­āļ‡āļ„āđŒāļāļĢāļœāļđāđ‰āļĢāļąāļš** (To Organization) + - **āļ§āļąāļ•āļ–āļļāļ›āļĢāļ°āļŠāļ‡āļ„āđŒ** (Purpose): āđ€āļžāļ·āđˆāļ­āļ­āļ™āļļāļĄāļąāļ•āļī (FOR_APPROVAL), āđ€āļžāļ·āđˆāļ­āļ•āļĢāļ§āļˆāļŠāļ­āļš (FOR_REVIEW), āđ€āļžāļ·āđˆāļ­āļ—āļĢāļēāļš (FOR_INFORMATION), āđ€āļžāļ·āđˆāļ­āļ”āļģāđ€āļ™āļīāļ™āļāļēāļĢ (FOR_ACTION) + - **āļĢāļ°āļĒāļ°āđ€āļ§āļĨāļēāļ—āļĩāđˆāļ„āļēāļ”āļŦāļ§āļąāļ‡** (Expected Duration) + - 3.2.5.3 Actual Routing Execution (āļāļēāļĢāļŠāđˆāļ‡āļ•āđˆāļ­āļˆāļĢāļīāļ‡) āđ€āļĄāļ·āđˆāļ­āļŠāļĢāđ‰āļēāļ‡āđ€āļ­āļāļŠāļēāļĢāđāļĨāļ°āđ€āļĨāļ·āļ­āļāđƒāļŠāđ‰āđāļĄāđˆāđāļšāļš āļĢāļ°āļšāļšāļ•āđ‰āļ­āļ‡: + - āļŠāļĢāđ‰āļēāļ‡āļĨāļģāļ”āļąāļšāļāļēāļĢāļŠāđˆāļ‡āļ•āđˆāļ­āļ•āļēāļĄāđāļĄāđˆāđāļšāļš + - āļ•āļīāļ”āļ•āļēāļĄāļŠāļ–āļēāļ™āļ°āļ‚āļ­āļ‡āđāļ•āđˆāļĨāļ°āļ‚āļąāđ‰āļ™āļ•āļ­āļ™: āļŠāđˆāļ‡āđāļĨāđ‰āļ§ (SENT), āļāļģāļĨāļąāļ‡āļ”āļģāđ€āļ™āļīāļ™āļāļēāļĢ (IN_PROGRESS), āļ”āļģāđ€āļ™āļīāļ™āļāļēāļĢāđāļĨāđ‰āļ§ (ACTIONED), āļŠāđˆāļ‡āļ•āđˆāļ­āđāļĨāđ‰āļ§ (FORWARDED), āļ•āļ­āļšāļāļĨāļąāļšāđāļĨāđ‰āļ§ (REPLIED) + - āļĢāļ°āļšāļļāļ§āļąāļ™āļ„āļĢāļšāļāļģāļŦāļ™āļ” (Due Date) āļŠāļģāļŦāļĢāļąāļšāđāļ•āđˆāļĨāļ°āļ‚āļąāđ‰āļ™āļ•āļ­āļ™ + - āļšāļąāļ™āļ—āļķāļāļœāļđāđ‰āļ”āļģāđ€āļ™āļīāļ™āļāļēāļĢāđāļĨāļ°āđ€āļ§āļĨāļēāļ—āļĩāđˆāļ”āļģāđ€āļ™āļīāļ™āļāļēāļĢ + - 3.2.5.4 Routing Flexibility (āļ„āļ§āļēāļĄāļĒāļ·āļ”āļŦāļĒāļļāđˆāļ™) + - āļŠāļēāļĄāļēāļĢāļ–āļ‚āđ‰āļēāļĄāļ‚āļąāđ‰āļ™āļ•āļ­āļ™āđ„āļ”āđ‰āđƒāļ™āļāļĢāļ“āļĩāļžāļīāđ€āļĻāļĐ (āđ‚āļ”āļĒāļœāļđāđ‰āļĄāļĩāļŠāļīāļ—āļ˜āļīāđŒ) + - āļŠāļēāļĄāļēāļĢāļ–āļŠāđˆāļ‡āļāļĨāļąāļšāļ‚āļąāđ‰āļ™āļ•āļ­āļ™āļāđˆāļ­āļ™āļŦāļ™āđ‰āļēāđ„āļ”āđ‰ + - āļŠāļēāļĄāļēāļĢāļ–āđ€āļžāļīāđˆāļĄāļ„āļ§āļēāļĄāļ„āļīāļ”āđ€āļŦāđ‡āļ™āđƒāļ™āđāļ•āđˆāļĨāļ°āļ‚āļąāđ‰āļ™āļ•āļ­āļ™ + - āđāļˆāđ‰āļ‡āđ€āļ•āļ·āļ­āļ™āļ­āļąāļ•āđ‚āļ™āļĄāļąāļ•āļīāđ€āļĄāļ·āđˆāļ­āļ–āļķāļ‡āļ‚āļąāđ‰āļ™āļ•āļ­āļ™āđƒāļŦāļĄāđˆāļŦāļĢāļ·āļ­āđƒāļāļĨāđ‰āļ„āļĢāļšāļāļģāļŦāļ™āļ” +- 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.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.5.4. Workflow āļāļēāļĢāļ­āļ™āļļāļĄāļąāļ•āļī: āļ•āđ‰āļ­āļ‡āļĢāļ­āļ‡āļĢāļąāļšāļāļĢāļ°āļšāļ§āļ™āļāļēāļĢāļ­āļ™āļļāļĄāļąāļ•āļīāļ—āļĩāđˆāļ‹āļąāļšāļ‹āđ‰āļ­āļ™āđāļĨāļ°āđ€āļ›āđ‡āļ™āļĨāļģāļ”āļąāļš āđ€āļŠāđˆāļ™ + - āļŠāđˆāļ‡āļˆāļēāļ Originator -> Organization 1 -> Organization 2 -> Organization 3 āđāļĨāđ‰āļ§āļŠāđˆāļ‡āļœāļĨāļāļĨāļąāļšāļ•āļēāļĄāļĨāļģāļ”āļąāļšāđ€āļ”āļīāļĄ (āđ‚āļ”āļĒāļ–āđ‰āļē āļ­āļ‡āļāļĢāļ“āđŒāđƒāļ”āđƒāļ™ Workflow āđƒāļŦāđ‰āļŠāđˆāļ‡āļāļĨāļąāļš āļāđ‡āļŠāļēāļĄāļēāļĢāļ–āļŠāđˆāļ‡āļœāļĨāļāļĨāļąāļšāļ•āļēāļĄāļĨāļģāļ”āļąāļšāđ€āļ”āļīāļĄāđ‚āļ”āļĒāđ„āļĄāđˆāļ•āđ‰āļ­āļ‡āļĢāļ­āđƒāļŦāđ‰āļ–āļķāļ‡ āļ­āļ‡āļāļĢāļ“āļ·āđƒāļ™āļĨāļģāļ”āļąāļšāļ–āļąāļ”āđ„āļ›) +- 3.5.5. āļāļēāļĢāļˆāļąāļ”āļāļēāļĢ: āļĄāļĩāļāļēāļĢāļˆāļąāļ”āļāļēāļĢāļ­āļĒāđˆāļēāļ‡āļ™āđ‰āļ­āļĒāļ”āļąāļ‡āļ™āļĩāđ‰ + - āļŠāļēāļĄāļēāļĢāļ–āļāļģāļŦāļ™āļ”āļ§āļąāļ™āđāļĨāđ‰āļ§āđ€āļŠāļĢāđ‡āļˆ (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. āļāļēāļĢāļˆāļąāļ”āđ€āļāđ‡āļšāđ„āļŸāļĨāđŒ (File Handling - āļ›āļĢāļąāļšāļ›āļĢāļļāļ‡āđƒāļŦāļāđˆ)** + +- **3.9.1 Two-Phase Storage Strategy:** + 1. **Phase 1 (Upload):** āđ„āļŸāļĨāđŒāļ–āļđāļāļ­āļąāļ›āđ‚āļŦāļĨāļ”āđ€āļ‚āđ‰āļēāđ‚āļŸāļĨāđ€āļ”āļ­āļĢāđŒ `temp/` āđāļĨāļ°āđ„āļ”āđ‰āļĢāļąāļš `temp_id` + 2. **Phase 2 (Commit):** āđ€āļĄāļ·āđˆāļ­ User āļāļ” Submit āļŸāļ­āļĢāđŒāļĄāļŠāļģāđ€āļĢāđ‡āļˆ āļĢāļ°āļšāļšāļˆāļ°āļĒāđ‰āļēāļĒāđ„āļŸāļĨāđŒāļˆāļēāļ `temp/` āđ„āļ›āļĒāļąāļ‡ `permanent/{YYYY}/{MM}/` āđāļĨāļ°āļšāļąāļ™āļ—āļķāļāļĨāļ‡ Database āļ āļēāļĒāđƒāļ™ Transaction āđ€āļ”āļĩāļĒāļ§āļāļąāļ™ + 3. **Cleanup:** āļĄāļĩ Cron Job āļĨāļšāđ„āļŸāļĨāđŒāđƒāļ™ `temp/` āļ—āļĩāđˆāļ„āđ‰āļēāļ‡āđ€āļāļīāļ™ 24 āļŠāļĄ. (Orphan Files) + +- **3.9.2 Security:** + - Virus Scan (ClamAV) āļāđˆāļ­āļ™āļĒāđ‰āļēāļĒāđ€āļ‚āđ‰āļē Permanent + - Whitelist File Types: PDF, DWG, DOCX, XLSX, ZIP + - Max Size: 50MB + - Access Control: āļ•āļĢāļ§āļˆāļŠāļ­āļšāļŠāļīāļ—āļ˜āļīāđŒāļœāđˆāļēāļ™ Junction Table āļāđˆāļ­āļ™āđƒāļŦāđ‰ Download Link + +- **3.9.3 āļ„āļ§āļēāļĄāļ›āļĨāļ­āļ”āļ āļąāļĒāļ‚āļ­āļ‡āļāļēāļĢāļˆāļąāļ”āđ€āļāđ‡āļšāđ„āļŸāļĨāđŒ:** + - āļ•āđ‰āļ­āļ‡āļĄāļĩāļāļēāļĢ scan virus āļŠāļģāļŦāļĢāļąāļšāđ„āļŸāļĨāđŒāļ—āļĩāđˆāļ­āļąāļ›āđ‚āļŦāļĨāļ”āļ—āļąāđ‰āļ‡āļŦāļĄāļ” āđ‚āļ”āļĒāđƒāļŠāđ‰ ClamAV āļŦāļĢāļ·āļ­āļšāļĢāļīāļāļēāļĢ third-party + - āļˆāļģāļāļąāļ”āļ›āļĢāļ°āđ€āļ āļ—āđ„āļŸāļĨāđŒāļ—āļĩāđˆāļ­āļ™āļļāļāļēāļ•: PDF, DWG, DOCX, XLSX, ZIP (āļ•āđ‰āļ­āļ‡āļĢāļ°āļšāļļāļĢāļēāļĒāļāļēāļĢāļ—āļĩāđˆāļŠāļąāļ”āđ€āļˆāļ™) + - āļ‚āļ™āļēāļ”āđ„āļŸāļĨāđŒāļŠāļđāļ‡āļŠāļļāļ”: 50MB āļ•āđˆāļ­āđ„āļŸāļĨāđŒ + - āđ„āļŸāļĨāđŒāļ•āđ‰āļ­āļ‡āļ–āļđāļāđ€āļāđ‡āļšāļ™āļ­āļ web root āđāļĨāļ°āđ€āļ‚āđ‰āļēāļ–āļķāļ‡āđ„āļ”āđ‰āļœāđˆāļēāļ™ authenticated endpoint āđ€āļ—āđˆāļēāļ™āļąāđ‰āļ™ + - āļ•āđ‰āļ­āļ‡āļĄāļĩ file integrity check (checksum) āđ€āļžāļ·āđˆāļ­āļ›āđ‰āļ­āļ‡āļāļąāļ™āļāļēāļĢāđāļāđ‰āđ„āļ‚āđ„āļŸāļĨāđŒ + - Download links āļ•āđ‰āļ­āļ‡āļĄāļĩ expiration time (default: 24 āļŠāļąāđˆāļ§āđ‚āļĄāļ‡) + - āļ•āđ‰āļ­āļ‡āļšāļąāļ™āļ—āļķāļ audit log āļ—āļļāļāļ„āļĢāļąāđ‰āļ‡āļ—āļĩāđˆāļĄāļĩāļāļēāļĢāļ”āļēāļ§āļ™āđŒāđ‚āļŦāļĨāļ”āđ„āļŸāļĨāđŒāļŠāļģāļ„āļąāļ + +### **3.10. āļāļēāļĢāļˆāļąāļ”āļāļēāļĢāđ€āļĨāļ‚āļ—āļĩāđˆāđ€āļ­āļāļŠāļēāļĢ (Document Numbering - āļ›āļĢāļąāļšāļ›āļĢāļļāļ‡)** + +- 3.10.1. āļĢāļ°āļšāļšāļ•āđ‰āļ­āļ‡āļŠāļēāļĄāļēāļĢāļ–āļŠāļĢāđ‰āļēāļ‡āđ€āļĨāļ‚āļ—āļĩāđˆāđ€āļ­āļāļŠāļēāļĢ (Running Number) āđ„āļ”āđ‰āđ‚āļ”āļĒāļ­āļąāļ•āđ‚āļ™āļĄāļąāļ•āļīāđāļĨāļ°āļĒāļ·āļ”āļŦāļĒāļļāđˆāļ™āļŠāļđāļ‡ +- 3.10.2. **Logic āļāļēāļĢāļ™āļąāļšāđ€āļĨāļ‚ (Counter Logic):** āļāļēāļĢāļ™āļąāļšāđ€āļĨāļ‚āļˆāļ°āļ•āđ‰āļ­āļ‡āļĢāļ­āļ‡āļĢāļąāļšāļāļēāļĢāđāļĒāļāļ•āļēāļĄ Key āļ—āļĩāđˆāļ‹āļąāļšāļ‹āđ‰āļ­āļ™āļ‚āļķāđ‰āļ™: + - **Project** + **Originator** + **Type** + **Discipline** (āļ–āđ‰āļēāļĄāļĩ) + **Sub-Type** (āļ–āđ‰āļēāļĄāļĩ) + **Year** +- 3.10.3. **Format Template:** āļĢāļ­āļ‡āļĢāļąāļšāļāļēāļĢāļāļģāļŦāļ™āļ”āļĢāļđāļ›āđāļšāļšāļ”āđ‰āļ§āļĒ **Token Replacement** āđ€āļŠāđˆāļ™: + - `{ORG}-{TYPE}-{DISCIPLINE}-{SEQ:4}-{REV}` -> `TEAM-RFA-STR-0001-A` + - āļĢāļ­āļ‡āļĢāļąāļš Token: `{PROJECT}`, `{ORG}`, `{TYPE}`, `{DISCIPLINE}`, `{SUBTYPE}`, `{SUBTYPE_NUM}`, `{YEAR}`, `{YEAR_SHORT}`, `{SEQ:n}` +- 3.10.4. **Transmittal Logic:** āļĢāļ­āļ‡āļĢāļąāļšāđ€āļ‡āļ·āđˆāļ­āļ™āđ„āļ‚āļžāļīāđ€āļĻāļĐāļŠāļģāļŦāļĢāļąāļš Transmittal āļ—āļĩāđˆāđ€āļĨāļ‚āļ­āļēāļˆāđ€āļ›āļĨāļĩāđˆāļĒāļ™āļ•āļēāļĄāļœāļđāđ‰āļĢāļąāļš (To Owner vs To Contractor) +- 3.10.5. **āļāļĨāđ„āļāļ„āļ§āļēāļĄāļ›āļĨāļ­āļ”āļ āļąāļĒ:** āļĒāļąāļ‡āļ„āļ‡āđƒāļŠāđ‰ Redis Distributed Lock āđāļĨāļ° Optimistic Locking āđ€āļžāļ·āđˆāļ­āļ›āđ‰āļ­āļ‡āļāļąāļ™āđ€āļĨāļ‚āļ‹āđ‰āļģāļŦāļĢāļ·āļ­āļ‚āđ‰āļēāļĄ +- 3.10.6. āļ•āđ‰āļ­āļ‡āļĄāļĩ retry mechanism āđāļĨāļ° fallback strategy āđ€āļĄāļ·āđˆāļ­āļāļēāļĢ generate āđ€āļĨāļ‚āļ—āļĩāđˆāđ€āļ­āļāļŠāļēāļĢāļĨāđ‰āļĄāđ€āļŦāļĨāļ§ + +### **3.11 āļāļēāļĢāļˆāļąāļ”āļāļēāļĢ JSON Details (JSON & Performance - āļ›āļĢāļąāļšāļ›āļĢāļļāļ‡)** + +- **3.11.1 āļ§āļąāļ•āļ–āļļāļ›āļĢāļ°āļŠāļ‡āļ„āđŒ** + - āļˆāļąāļ”āđ€āļāđ‡āļšāļ‚āđ‰āļ­āļĄāļđāļĨāđāļšāļšāđ„āļ”āļ™āļēāļĄāļīāļāļ—āļĩāđˆāđ€āļ‰āļžāļēāļ°āđ€āļˆāļēāļ°āļˆāļ‡āļāļąāļšāđāļ•āđˆāļĨāļ°āļ›āļĢāļ°āđ€āļ āļ—āļ‚āļ­āļ‡āđ€āļ­āļāļŠāļēāļĢ + - āļĢāļ­āļ‡āļĢāļąāļšāļāļēāļĢāļ‚āļĒāļēāļĒāļ•āļąāļ§āļ‚āļ­āļ‡āļĢāļ°āļšāļšāđ‚āļ”āļĒāđ„āļĄāđˆāļ•āđ‰āļ­āļ‡āđ€āļ›āļĨāļĩāđˆāļĒāļ™āđāļ›āļĨāļ‡ database schema + - āļˆāļąāļ”āļāļēāļĢ metadata āđāļĨāļ°āļ‚āđ‰āļ­āļĄāļđāļĨāļ›āļĢāļ°āļāļ­āļšāļŠāļģāļŦāļĢāļąāļš correspondence, routing, āđāļĨāļ° workflows + +- **3.11.2 āđ‚āļ„āļĢāļ‡āļŠāļĢāđ‰āļēāļ‡ JSON Schema** + āļĢāļ°āļšāļšāļ•āđ‰āļ­āļ‡āļĄāļĩ predefined JSON schemas āļŠāļģāļŦāļĢāļąāļšāļ›āļĢāļ°āđ€āļ āļ—āđ€āļ­āļāļŠāļēāļĢāļ•āđˆāļēāļ‡āđ†: + - **3.11.2.1 Correspondence Types** + - **GENERIC**: āļ‚āđ‰āļ­āļĄāļđāļĨāļžāļ·āđ‰āļ™āļāļēāļ™āļŠāļģāļŦāļĢāļąāļšāđ€āļ­āļāļŠāļēāļĢāļ—āļąāđˆāļ§āđ„āļ› + - **RFI**: āļĢāļēāļĒāļĨāļ°āđ€āļ­āļĩāļĒāļ”āļ„āļģāļ–āļēāļĄāđāļĨāļ°āļ‚āđ‰āļ­āļĄāļđāļĨāļ—āļēāļ‡āđ€āļ—āļ„āļ™āļīāļ„ + - **RFA**: āļ‚āđ‰āļ­āļĄāļđāļĨāļāļēāļĢāļ‚āļ­āļ­āļ™āļļāļĄāļąāļ•āļīāđāļšāļšāđāļĨāļ°āļ§āļąāļŠāļ”āļļ + - **TRANSMITTAL**: āļĢāļēāļĒāļāļēāļĢāđ€āļ­āļāļŠāļēāļĢāļ—āļĩāđˆāļŠāđˆāļ‡āļ•āđˆāļ­ + - **LETTER**: āļ‚āđ‰āļ­āļĄāļđāļĨāļˆāļ”āļŦāļĄāļēāļĒāļ—āļēāļ‡āļāļēāļĢ + - **EMAIL**: āļ‚āđ‰āļ­āļĄāļđāļĨāļ­āļĩāđ€āļĄāļĨ + - **3.11.2.2 Routing Types** + - **ROUTING_TEMPLATE**: āļāļŽāđāļĨāļ°āđ€āļ‡āļ·āđˆāļ­āļ™āđ„āļ‚āļāļēāļĢāļŠāđˆāļ‡āļ•āđˆāļ­ + - **ROUTING_INSTANCE**: āļŠāļ–āļēāļ™āļ°āđāļĨāļ°āļ›āļĢāļ°āļ§āļąāļ•āļīāļāļēāļĢāļŠāđˆāļ‡āļ•āđˆāļ­ + - **ROUTING_ACTION**: āļāļēāļĢāļ”āļģāđ€āļ™āļīāļ™āļāļēāļĢāđƒāļ™āđāļ•āđˆāļĨāļ°āļ‚āļąāđ‰āļ™āļ•āļ­āļ™ + - **3.11.2.3 Audit Types** + - **AUDIT_LOG**: āļ‚āđ‰āļ­āļĄāļđāļĨāļāļēāļĢāļ•āļĢāļ§āļˆāļŠāļ­āļš + - **SECURITY_SCAN**: āļœāļĨāļāļēāļĢāļ•āļĢāļ§āļˆāļŠāļ­āļšāļ„āļ§āļēāļĄāļ›āļĨāļ­āļ”āļ āļąāļĒ + +- **3.11.3 Virtual Columns (āđƒāļŦāļĄāđˆ):** āļŠāļģāļŦāļĢāļąāļš Field āđƒāļ™ JSON āļ—āļĩāđˆāļ•āđ‰āļ­āļ‡āđƒāļŠāđ‰āđƒāļ™āļāļēāļĢāļ„āđ‰āļ™āļŦāļē (Search) āļŦāļĢāļ·āļ­āļˆāļąāļ”āđ€āļĢāļĩāļĒāļ‡ (Sort) āļšāđˆāļ­āļĒāđ† **āļ•āđ‰āļ­āļ‡āļŠāļĢāđ‰āļēāļ‡ Generated Column (Virtual Column)** āđƒāļ™ Database āđāļĨāļ°āļ—āļģ Index āđ„āļ§āđ‰ āđ€āļžāļ·āđˆāļ­āļ›āļĢāļ°āļŠāļīāļ—āļ˜āļīāļ āļēāļžāļŠāļđāļ‡āļŠāļļāļ” + +- **3.11.4 Validation Rules** + - āļ•āđ‰āļ­āļ‡āļĄāļĩ JSON schema validation āļŠāļģāļŦāļĢāļąāļšāđāļ•āđˆāļĨāļ°āļ›āļĢāļ°āđ€āļ āļ— + - āļ•āđ‰āļ­āļ‡āļĢāļ­āļ‡āļĢāļąāļš versioning āļ‚āļ­āļ‡ schema + - āļ•āđ‰āļ­āļ‡āļĄāļĩ default values āļŠāļģāļŦāļĢāļąāļš field āļ—āļĩāđˆāđ„āļĄāđˆāļšāļąāļ‡āļ„āļąāļš + - āļ•āđ‰āļ­āļ‡āļ•āļĢāļ§āļˆāļŠāļ­āļš data types āđāļĨāļ° format āđƒāļŦāđ‰āļ–āļđāļāļ•āđ‰āļ­āļ‡ + +- **3.11.5 Performance Requirements** + - JSON field āļ•āđ‰āļ­āļ‡āļĄāļĩāļ‚āļ™āļēāļ”āđ„āļĄāđˆāđ€āļāļīāļ™ 50KB + - āļ•āđ‰āļ­āļ‡āļĢāļ­āļ‡āļĢāļąāļš indexing āļŠāļģāļŦāļĢāļąāļš field āļ—āļĩāđˆāđƒāļŠāđ‰āļ„āđ‰āļ™āļŦāļēāļšāđˆāļ­āļĒ + - āļ•āđ‰āļ­āļ‡āļĄāļĩ compression āļŠāļģāļŦāļĢāļąāļš JSON āļ‚āļ™āļēāļ”āđƒāļŦāļāđˆ + +- **3.11.6 Security Requirements** + - āļ•āđ‰āļ­āļ‡ sanitize JSON input āđ€āļžāļ·āđˆāļ­āļ›āđ‰āļ­āļ‡āļāļąāļ™ injection attacks + - āļ•āđ‰āļ­āļ‡ validate JSON structure āļāđˆāļ­āļ™āļšāļąāļ™āļ—āļķāļ + - āļ•āđ‰āļ­āļ‡ encrypt sensitive data āđƒāļ™ JSON fields + +### **3.12 āļ‚āđ‰āļ­āļāļģāļŦāļ™āļ”āļžāļīāđ€āļĻāļĐ** +- **āļœāļđāđ‰āđƒāļŠāđ‰āļ‡āļēāļ™āļ—āļĩāđˆāļĄāļĩāļŠāļīāļ—āļ˜āļīāđŒāļĢāļ°āļ”āļąāļšāļŠāļđāļ‡ (Global) āļŦāļĢāļ·āļ­āļœāļđāđ‰āđ„āļ”āđ‰āļĢāļąāļšāļ­āļ™āļļāļāļēāļ•āđ€āļ›āđ‡āļ™āļāļĢāļ“āļĩāļžāļīāđ€āļĻāļĐ** + - āļŠāļēāļĄāļēāļĢāļ–āđ€āļĨāļ·āļ­āļ **āļŠāļĢāđ‰āļēāļ‡āđƒāļ™āļ™āļēāļĄāļ­āļ‡āļ„āđŒāļāļĢ (Create on behalf of)** āđ„āļ”āđ‰ āđ€āļžāļ·āđˆāļ­āđƒāļŦāđ‰āļŠāļēāļĄāļēāļĢāļ–āļ­āļ­āļāđ€āļĨāļ‚āļ—āļĩāđˆāđ€āļ­āļāļŠāļēāļĢ (Running Number) āļ‚āļ­āļ‡āļ­āļ‡āļ„āđŒāļāļĢāļ­āļ·āđˆāļ™āđ„āļ”āđ‰āđ‚āļ”āļĒāđ„āļĄāđˆāļ•āđ‰āļ­āļ‡āļĨāđ‡āļ­āļāļ­āļīāļ™āđƒāļŦāļĄāđˆ + - āļŠāļēāļĄāļēāļĢāļ–āļ—āļģāļ‡āļēāļ™āđāļ—āļ™āļœāļđāđ‰āđƒāļŠāđ‰āļ‡āļēāļ™āļ­āļ·āđˆāļ™āđ„āļ”āđ‰ Routing & Workflow āļ‚āļ­āļ‡ Correspondence, RFA, Circulation Sheet + +### 3.13. āļāļēāļĢāļˆāļąāļ”āļāļēāļĢāļ‚āđ‰āļ­āļĄāļđāļĨāļŦāļĨāļąāļāļ‚āļąāđ‰āļ™āļŠāļđāļ‡ (Admin Panel for Master Data) + +- 3.13.1. **Disciplines Management:** Admin āļ•āđ‰āļ­āļ‡āļŠāļēāļĄāļēāļĢāļ– āđ€āļžāļīāđˆāļĄ/āļĨāļš/āđāļāđ‰āđ„āļ‚ āļŠāļēāļ‚āļēāļ‡āļēāļ™ (Disciplines) āđāļĒāļāļ•āļēāļĄāļŠāļąāļāļāļē (Contract) āđ„āļ”āđ‰ +- 3.13.2. **Sub-Type Mapping:** Admin āļ•āđ‰āļ­āļ‡āļŠāļēāļĄāļēāļĢāļ–āļāļģāļŦāļ™āļ” Correspondence Sub-types āđāļĨāļ° Mapping āļĢāļŦāļąāļŠāļ•āļąāļ§āđ€āļĨāļ‚ (āđ€āļŠāđˆāļ™ MAT = 11) āđ„āļ”āđ‰ +- 3.13.3. **Numbering Format Configuration:** Admin āļ•āđ‰āļ­āļ‡āļĄāļĩ UI āļŠāļģāļŦāļĢāļąāļšāļ•āļąāđ‰āļ‡āļ„āđˆāļē Format Template āļ‚āļ­āļ‡āđāļ•āđˆāļĨāļ° Project/Type āđ„āļ”āđ‰āđ‚āļ”āļĒāđ„āļĄāđˆāļ•āđ‰āļ­āļ‡āđāļāđ‰āđ‚āļ„āđ‰āļ” + +## **🔐 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. Token Management (āļ›āļĢāļąāļšāļ›āļĢāļļāļ‡)** + +- **Payload Optimization:** āđƒāļ™ JWT Access Token āđƒāļŦāđ‰āđ€āļāđ‡āļšāđ€āļ‰āļžāļēāļ° `userId` āđāļĨāļ° `scope` āļ›āļąāļˆāļˆāļļāļšāļąāļ™āđ€āļ—āđˆāļēāļ™āļąāđ‰āļ™ +- **Permission Caching:** āļŠāļīāļ—āļ˜āļīāđŒāļĨāļ°āđ€āļ­āļĩāļĒāļ” (Permissions List) āđƒāļŦāđ‰āđ€āļāđ‡āļšāđƒāļ™ **Redis** āđāļĨāļ°āļ”āļķāļ‡āļĄāļēāļ•āļĢāļ§āļˆāļŠāļ­āļšāđ€āļĄāļ·āđˆāļ­ Request āđ€āļ‚āđ‰āļēāļĄāļē āđ€āļžāļ·āđˆāļ­āļĨāļ”āļ‚āļ™āļēāļ” Token āđāļĨāļ°āđ€āļžāļīāđˆāļĄāļ„āļ§āļēāļĄāđ€āļĢāđ‡āļ§ + +### **4.5. āļāļĢāļ°āļšāļ§āļ™āļāļēāļĢāđ€āļĢāļīāđˆāļĄāļ•āđ‰āļ™āđƒāļŠāđ‰āļ‡āļēāļ™ (Onboarding Workflow) āļ—āļĩāđˆāļŠāļĄāļšāļđāļĢāļ“āđŒ** + +- **4.5.1. āļŠāļĢāđ‰āļēāļ‡āļ­āļ‡āļ„āđŒāļāļĢ (Organization)** + - **Superadmin** āļŠāļĢāđ‰āļēāļ‡āļ­āļ‡āļ„āđŒāļāļĢāđƒāļŦāļĄāđˆ (āđ€āļŠāđˆāļ™ āļšāļĢāļīāļĐāļąāļ— A) + - **Superadmin** āđāļ•āđˆāļ‡āļ•āļąāđ‰āļ‡āļœāļđāđ‰āđƒāļŠāđ‰āļ­āļĒāđˆāļēāļ‡āļ™āđ‰āļ­āļĒ 1 āļ„āļ™āđƒāļŦāđ‰āđ€āļ›āđ‡āļ™ **Org Admin** āļŦāļĢāļ·āļ­ **Document Control** āļ‚āļ­āļ‡āļšāļĢāļīāļĐāļąāļ— A +- **4.5.2. āđ€āļžāļīāđˆāļĄāļœāļđāđ‰āđƒāļŠāđ‰āđƒāļ™āļ­āļ‡āļ„āđŒāļāļĢ** + - **Org Admin** āļ‚āļ­āļ‡āļšāļĢāļīāļĐāļąāļ— A āđ€āļžāļīāđˆāļĄāļœāļđāđ‰āđƒāļŠāđ‰āļ­āļ·āđˆāļ™āđ† (Editor, Viewer) āđ€āļ‚āđ‰āļēāļĄāļēāđƒāļ™āļ­āļ‡āļ„āđŒāļāļĢāļ‚āļ­āļ‡āļ•āļ™ +- **4.5.3. āļĄāļ­āļšāļŦāļĄāļēāļĒāļœāļđāđ‰āđƒāļŠāđ‰āđƒāļŦāđ‰āļāļąāļšāđ‚āļ„āļĢāļ‡āļāļēāļĢ (Project)** + - **Project Manager** āļ‚āļ­āļ‡āđ‚āļ„āļĢāļ‡āļāļēāļĢ X (āļ‹āļķāđˆāļ‡āļ­āļēāļˆāļĄāļēāļˆāļēāļāļšāļĢāļīāļĐāļąāļ— A āļŦāļĢāļ·āļ­āļšāļĢāļīāļĐāļąāļ—āļ­āļ·āđˆāļ™) āļ—āļģāļāļēāļĢ "āđ€āļŠāļīāļ" āļŦāļĢāļ·āļ­ "āļĄāļ­āļšāļŦāļĄāļēāļĒ" āļœāļđāđ‰āđƒāļŠāđ‰āļˆāļēāļāļ­āļ‡āļ„āđŒāļāļĢāļ•āđˆāļēāļ‡āđ† āļ—āļĩāđˆāđ€āļāļĩāđˆāļĒāļ§āļ‚āđ‰āļ­āļ‡āđ€āļ‚āđ‰āļēāļĄāļēāđƒāļ™āđ‚āļ„āļĢāļ‡āļāļēāļĢ X + - āđƒāļ™āļ‚āļąāđ‰āļ™āļ•āļ­āļ™āļ™āļĩāđ‰ **Project Manager** āļˆāļ°āļāļģāļŦāļ™āļ” **āļšāļ—āļšāļēāļ—āļĢāļ°āļ”āļąāļšāđ‚āļ„āļĢāļ‡āļāļēāļĢ** (āđ€āļŠāđˆāļ™ Project Member, āļŦāļĢāļ·āļ­āļ­āļēāļˆāđ„āļĄāđˆāļĄāļĩāļšāļ—āļšāļēāļ—āļžāļīāđ€āļĻāļĐ āđƒāļŦāđ‰āđƒāļŠāđ‰āļŠāļīāļ—āļ˜āļīāđŒāļˆāļēāļāļĢāļ°āļ”āļąāļšāļ­āļ‡āļ„āđŒāļāļĢāđ„āļ›āļāđˆāļ­āļ™) +- **4.5.4. āđ€āļĄāļ­āļšāļŦāļĄāļēāļĒāļœāļđāđ‰āđƒāļŠāđ‰āđƒāļŦāđ‰āļāļąāļšāļŠāļąāļāļāļē (Contract)** + - **Contract Admin** āļ‚āļ­āļ‡āļŠāļąāļāļāļē Y (āļ‹āļķāđˆāļ‡āđ€āļ›āđ‡āļ™āļŠāđˆāļ§āļ™āļŦāļ™āļķāđˆāļ‡āļ‚āļ­āļ‡āđ‚āļ„āļĢāļ‡āļāļēāļĢ X) āļ—āļģāļāļēāļĢāđ€āļĨāļ·āļ­āļāļœāļđāđ‰āđƒāļŠāđ‰āļ—āļĩāđˆāļ­āļĒāļđāđˆāđƒāļ™āđ‚āļ„āļĢāļ‡āļāļēāļĢ X āđāļĨāđ‰āļ§ āļĄāļ­āļšāļŦāļĄāļēāļĒāđƒāļŦāđ‰āđ€āļ‚āđ‰āļēāļĄāļēāđƒāļ™āļŠāļąāļāļāļē Y + - āđƒāļ™āļ‚āļąāđ‰āļ™āļ•āļ­āļ™āļ™āļĩāđ‰ **Contract Admin** āļˆāļ°āļāļģāļŦāļ™āļ” **āļšāļ—āļšāļēāļ—āļĢāļ°āļ”āļąāļšāļŠāļąāļāļāļē** (āđ€āļŠāđˆāļ™ Contract Member) āđāļĨāļ°āļŠāļīāļ—āļ˜āļīāđŒāđ€āļ‰āļžāļēāļ°āļ—āļĩāđˆāļˆāļģāđ€āļ›āđ‡āļ™ +- **4.5.5 Security Onboarding:** + - āļ•āđ‰āļ­āļ‡āļšāļąāļ‡āļ„āļąāļšāđ€āļ›āļĨāļĩāđˆāļĒāļ™ password āļ„āļĢāļąāđ‰āļ‡āđāļĢāļāļŠāļģāļŦāļĢāļąāļšāļœāļđāđ‰āđƒāļŠāđ‰āđƒāļŦāļĄāđˆ + - āļ•āđ‰āļ­āļ‡āļĄāļĩ security awareness training āļŠāļģāļŦāļĢāļąāļšāļœāļđāđ‰āđƒāļŠāđ‰āļ—āļĩāđˆāļĄāļĩāļŠāļīāļ—āļ˜āļīāđŒāļŠāļđāļ‡ + - āļ•āđ‰āļ­āļ‡āļĄāļĩ process āļŠāļģāļŦāļĢāļąāļšāļāļēāļĢāļĢāļĩāđ€āļ‹āđ‡āļ• password āļ—āļĩāđˆāļ›āļĨāļ­āļ”āļ āļąāļĒ + - āļ•āđ‰āļ­āļ‡āļšāļąāļ™āļ—āļķāļ audit log āļ—āļļāļāļ„āļĢāļąāđ‰āļ‡āļ—āļĩāđˆāļĄāļĩāļāļēāļĢāđ€āļ›āļĨāļĩāđˆāļĒāļ™āđāļ›āļĨāļ‡ permissions + +### **4.6. āļāļēāļĢāļˆāļąāļ”āļāļēāļĢāļ‚āđ‰āļ­āļĄāļđāļĨāļŦāļĨāļąāļ (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 | +| Document Numbering Formats | **Superadmin / 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 āļ—āļĩāđˆāļœāļđāđ‰āđƒāļŠāđ‰āļ•āđ‰āļ­āļ‡āļ”āļģāđ€āļ™āļīāļ™āļāļēāļĢ +- Security Metrics: āđāļŠāļ”āļ‡āļˆāļģāļ™āļ§āļ™ files scanned, security incidents, failed login attempts + +### **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) +- **Security Feedback:** āđāļŠāļ”āļ‡ security warnings āļŠāļģāļŦāļĢāļąāļš file types āļ—āļĩāđˆāđ€āļŠāļĩāđˆāļĒāļ‡āļŦāļĢāļ·āļ­ files āļ—āļĩāđˆ fail virus scan +- **File Type Indicators:** āđāļŠāļ”āļ‡ file type icons āđāļĨāļ° security status + +### **5.10 Form & Interaction (āđƒāļŦāļĄāđˆ)** + +- **Dynamic Form Generator:** āđƒāļŠāđ‰ Component āļāļĨāļēāļ‡āļ—āļĩāđˆāļĢāļąāļš JSON Schema āđāļĨāđ‰āļ§ Render Form āļ­āļ­āļāļĄāļēāļ­āļąāļ•āđ‚āļ™āļĄāļąāļ•āļī āđ€āļžāļ·āđˆāļ­āļĨāļ”āļ„āļ§āļēāļĄāļ‹āđ‰āļģāļ‹āđ‰āļ­āļ™āļ‚āļ­āļ‡āđ‚āļ„āđ‰āļ”āļŦāļ™āđ‰āļēāļšāđ‰āļēāļ™ āđāļĨāļ°āļĢāļ­āļ‡āļĢāļąāļšāđ€āļ­āļāļŠāļēāļĢāļ›āļĢāļ°āđ€āļ āļ—āđƒāļŦāļĄāđˆāđ† āđ„āļ”āđ‰āļ—āļąāļ™āļ—āļĩ +- **Optimistic Updates:** āļāļēāļĢāđ€āļ›āļĨāļĩāđˆāļĒāļ™āļŠāļ–āļēāļ™āļ° (āđ€āļŠāđˆāļ™ āļāļ” Approve, āļāļ” Read) āđƒāļŦāđ‰ UI āđ€āļ›āļĨāļĩāđˆāļĒāļ™āļŠāļ–āļēāļ™āļ°āļ—āļąāļ™āļ—āļĩāđƒāļŦāđ‰āļœāļđāđ‰āđƒāļŠāđ‰āđ€āļŦāđ‡āļ™āļāđˆāļ­āļ™āļĢāļ­ API Response (Rollback āļ–āđ‰āļē Failed) + +### **5.11 Mobile Responsiveness (āđƒāļŦāļĄāđˆ)** + +- **Table Visualization:** āļšāļ™āļŦāļ™āđ‰āļēāļˆāļ­āļĄāļ·āļ­āļ–āļ·āļ­ āļ•āļēāļĢāļēāļ‡āļ‚āđ‰āļ­āļĄāļđāļĨāļ—āļĩāđˆāļĄāļĩāļŦāļĨāļēāļĒ Column (āđ€āļŠāđˆāļ™ Correspondence List) āļ•āđ‰āļ­āļ‡āđ€āļ›āļĨāļĩāđˆāļĒāļ™āļāļēāļĢāđāļŠāļ”āļ‡āļœāļĨāđ€āļ›āđ‡āļ™āđāļšāļš **Card View** āļ­āļąāļ•āđ‚āļ™āļĄāļąāļ•āļī +- **Navigation:** Sidebar āļ•āđ‰āļ­āļ‡āđ€āļ›āđ‡āļ™āđāļšāļš Collapsible Drawer + +### **5.12 Resilience & Offline Support (āđƒāļŦāļĄāđˆ)** + +- **Auto-Save Draft:** āļĢāļ°āļšāļšāļ•āđ‰āļ­āļ‡āļšāļąāļ™āļ—āļķāļāļ‚āđ‰āļ­āļĄāļđāļĨāļŸāļ­āļĢāđŒāļĄāļ—āļĩāđˆāļāļģāļĨāļąāļ‡āļāļĢāļ­āļāļĨāļ‡ **LocalStorage** āļ­āļąāļ•āđ‚āļ™āļĄāļąāļ•āļī āđ€āļžāļ·āđˆāļ­āļ›āđ‰āļ­āļ‡āļāļąāļ™āļ‚āđ‰āļ­āļĄāļđāļĨāļŦāļēāļĒāļāļĢāļ“āļĩāđ€āļ™āđ‡āļ•āļŦāļĨāļļāļ”āļŦāļĢāļ·āļ­āļ›āļīāļ” Browser āđ‚āļ”āļĒāđ„āļĄāđˆāđ„āļ”āđ‰āļ•āļąāđ‰āļ‡āđƒāļˆ +- **Graceful Degradation:** āļŦāļēāļ Service āļĢāļ­āļ‡ (āđ€āļŠāđˆāļ™ Search, Notification) āļĨāđˆāļĄ āļĢāļ°āļšāļšāļŦāļĨāļąāļ (CRUD) āļ•āđ‰āļ­āļ‡āļĒāļąāļ‡āļ—āļģāļ‡āļēāļ™āļ•āđˆāļ­āđ„āļ”āđ‰ + +## **ðŸ›Ąïļ 6. āļ‚āđ‰āļ­āļāļģāļŦāļ™āļ”āļ—āļĩāđˆāđ„āļĄāđˆāđƒāļŠāđˆāļŸāļąāļ‡āļāđŒāļŠāļąāļ™āļāļēāļĢāļ—āļģāļ‡āļēāļ™ (Non-Functional Requirements)** + +### **6.1. āļāļēāļĢāļšāļąāļ™āļ—āļķāļāļāļēāļĢāļāļĢāļ°āļ—āļģ (Audit Log):** āļ—āļļāļāļāļēāļĢāļāļĢāļ°āļ—āļģāļ—āļĩāđˆāļŠāļģāļ„āļąāļāļ‚āļ­āļ‡āļœāļđāđ‰āđƒāļŠāđ‰ (āļŠāļĢāđ‰āļēāļ‡, āđāļāđ‰āđ„āļ‚, āļĨāļš, āļŠāđˆāļ‡) āļˆāļ°āļ–āļđāļāļšāļąāļ™āļ—āļķāļāđ„āļ§āđ‰āđƒāļ™ audit_logs āđ€āļžāļ·āđˆāļ­āļāļēāļĢāļ•āļĢāļ§āļˆāļŠāļ­āļšāļĒāđ‰āļ­āļ™āļŦāļĨāļąāļ‡ + +- **6.1.1 āļ‚āļ­āļšāđ€āļ‚āļ•āļāļēāļĢāļšāļąāļ™āļ—āļķāļ Audit Log:** + - āļ—āļļāļāļāļēāļĢāļŠāļĢāđ‰āļēāļ‡/āđāļāđ‰āđ„āļ‚/āļĨāļš āļ‚āđ‰āļ­āļĄāļđāļĨāļŠāļģāļ„āļąāļ (correspondences, RFAs, drawings, users, permissions) + - āļ—āļļāļāļāļēāļĢāđ€āļ‚āđ‰āļēāļ–āļķāļ‡āļ‚āđ‰āļ­āļĄāļđāļĨ sensitive (user data, financial information) + - āļ—āļļāļāļāļēāļĢāđ€āļ›āļĨāļĩāđˆāļĒāļ™āļŠāļ–āļēāļ™āļ° workflow (status transitions) + - āļ—āļļāļāļāļēāļĢāļ”āļēāļ§āļ™āđŒāđ‚āļŦāļĨāļ”āđ„āļŸāļĨāđŒāļŠāļģāļ„āļąāļ (contract documents, financial reports) + - āļ—āļļāļāļāļēāļĢāđ€āļ›āļĨāļĩāđˆāļĒāļ™āđāļ›āļĨāļ‡ permission āđāļĨāļ° role assignment + - āļ—āļļāļāļāļēāļĢāļĨāđ‡āļ­āļāļ­āļīāļ™āļ—āļĩāđˆāļŠāļģāđ€āļĢāđ‡āļˆāđāļĨāļ°āļĨāđ‰āļĄāđ€āļŦāļĨāļ§ + - āļ—āļļāļāļāļēāļĢāļŠāđˆāļ‡āļ„āļģāļ‚āļ­ API āļ—āļĩāđˆāļŠāļģāļ„āļąāļ + +- **6.1.2 āļ‚āđ‰āļ­āļĄāļđāļĨāļ—āļĩāđˆāļ•āđ‰āļ­āļ‡āļšāļąāļ™āļ—āļķāļāđƒāļ™ Audit Log:** + - āļœāļđāđ‰āđƒāļŠāđ‰āļ‡āļēāļ™ (user_id) + - āļāļēāļĢāļāļĢāļ°āļ—āļģ (action) + - āļŠāļ™āļīāļ”āļ‚āļ­āļ‡ entity (entity_type) + - ID āļ‚āļ­āļ‡ entity (entity_id) + - āļ‚āđ‰āļ­āļĄāļđāļĨāļāđˆāļ­āļ™āļāļēāļĢāđ€āļ›āļĨāļĩāđˆāļĒāļ™āđāļ›āļĨāļ‡ (old_values) - āļŠāļģāļŦāļĢāļąāļš update operations + - āļ‚āđ‰āļ­āļĄāļđāļĨāļŦāļĨāļąāļ‡āļāļēāļĢāđ€āļ›āļĨāļĩāđˆāļĒāļ™āđāļ›āļĨāļ‡ (new_values) - āļŠāļģāļŦāļĢāļąāļš update operations + - IP address + - User agent + - Timestamp + - Request ID āļŠāļģāļŦāļĢāļąāļš tracing + +### **6.2. Data Archiving & Partitioning (āđƒāļŦāļĄāđˆ)** + +- āļŠāļģāļŦāļĢāļąāļšāļ•āļēāļĢāļēāļ‡āļ—āļĩāđˆāļĄāļĩāļ‚āļ™āļēāļ”āđƒāļŦāļāđˆāđāļĨāļ°āđ‚āļ•āđ€āļĢāđ‡āļ§ (āđ€āļŠāđˆāļ™ `audit_logs`, `notifications`, `correspondence_revisions`) āļ•āđ‰āļ­āļ‡āļ­āļ­āļāđāļšāļšāđ‚āļ”āļĒāļĢāļ­āļ‡āļĢāļąāļš **Table Partitioning** (āđāļšāđˆāļ‡āļ•āļēāļĄ Range āļ§āļąāļ™āļ—āļĩāđˆ āļŦāļĢāļ·āļ­ List) āđ€āļžāļ·āđˆāļ­āļ›āļĢāļ°āļŠāļīāļ—āļ˜āļīāļ āļēāļžāđƒāļ™āļĢāļ°āļĒāļ°āļĒāļēāļ§ + +### **6.3. āļāļēāļĢāļ„āđ‰āļ™āļŦāļē (Search):** āļĢāļ°āļšāļšāļ•āđ‰āļ­āļ‡āļĄāļĩāļŸāļąāļ‡āļāđŒāļŠāļąāļ™āļāļēāļĢāļ„āđ‰āļ™āļŦāļēāļ‚āļąāđ‰āļ™āļŠāļđāļ‡ āļ—āļĩāđˆāļŠāļēāļĄāļēāļĢāļ–āļ„āđ‰āļ™āļŦāļēāđ€āļ­āļāļŠāļēāļĢ **correspondence**, **rfa**, **shop_drawing**, **contract-drawing**, **transmittal** āđāļĨāļ° **āđƒāļšāđ€āļ§āļĩāļĒāļ™ (Circulations)** āļˆāļēāļāļŦāļĨāļēāļĒāđ€āļ‡āļ·āđˆāļ­āļ™āđ„āļ‚āļžāļĢāđ‰āļ­āļĄāļāļąāļ™āđ„āļ”āđ‰ āđ€āļŠāđˆāļ™ āļ„āđ‰āļ™āļŦāļēāļˆāļēāļāļŠāļ·āđˆāļ­āđ€āļĢāļ·āđˆāļ­āļ‡, āļ›āļĢāļ°āđ€āļ āļ—, āļ§āļąāļ™āļ—āļĩāđˆ, āđāļĨāļ° Tag + +### **6.4. āļāļēāļĢāļ—āļģāļĢāļēāļĒāļ‡āļēāļ™ (Reporting):** āļŠāļēāļĄāļēāļĢāļ–āļˆāļąāļ”āļ—āļģāļĢāļēāļĒāļ‡āļēāļ™āļŠāļĢāļļāļ›āđāļĒāļāļ›āļĢāļ°āđ€āļ āļ—āļ‚āļ­āļ‡ Correspondence āļ›āļĢāļ°āļˆāļģāļ§āļąāļ™, āļŠāļąāļ›āļ”āļēāļŦāđŒ, āđ€āļ”āļ·āļ­āļ™, āđāļĨāļ°āļ›āļĩāđ„āļ”āđ‰ + +### **6.5. āļ›āļĢāļ°āļŠāļīāļ—āļ˜āļīāļ āļēāļž (Performance):** āļĄāļĩāļāļēāļĢāđƒāļŠāđ‰ Caching āļāļąāļšāļ‚āđ‰āļ­āļĄāļđāļĨāļ—āļĩāđˆāđ€āļĢāļĩāļĒāļāđƒāļŠāđ‰āļšāđˆāļ­āļĒ āđāļĨāļ°āđƒāļŠāđ‰ Pagination āđƒāļ™āļ•āļēāļĢāļēāļ‡āļ‚āđ‰āļ­āļĄāļđāļĨāđ€āļžāļ·āđˆāļ­āļˆāļąāļ”āļāļēāļĢāļ‚āđ‰āļ­āļĄāļđāļĨāļˆāļģāļ™āļ§āļ™āļĄāļēāļ + +- **6.5.1 āļ•āļąāļ§āļŠāļĩāđ‰āļ§āļąāļ”āļ›āļĢāļ°āļŠāļīāļ—āļ˜āļīāļ āļēāļž:** + - **API Response Time:** < 200ms (90th percentile) āļŠāļģāļŦāļĢāļąāļš operation āļ—āļąāđˆāļ§āđ„āļ› + - **Search Query Performance:** < 500ms āļŠāļģāļŦāļĢāļąāļšāļāļēāļĢāļ„āđ‰āļ™āļŦāļēāļ‚āļąāđ‰āļ™āļŠāļđāļ‡ + - **File Upload Performance:** < 30 seconds āļŠāļģāļŦāļĢāļąāļšāđ„āļŸāļĨāđŒāļ‚āļ™āļēāļ” 50MB + - **Concurrent Users:** āļĢāļ­āļ‡āļĢāļąāļšāļœāļđāđ‰āđƒāļŠāđ‰āļžāļĢāđ‰āļ­āļĄāļāļąāļ™āļ­āļĒāđˆāļēāļ‡āļ™āđ‰āļ­āļĒ 100 āļ„āļ™ + - **Database Connection Pool:** āļ‚āļ™āļēāļ”āđ€āļŦāļĄāļēāļ°āļŠāļĄāļāļąāļš workload (default: min 5, max 20 connections) + - **Cache Hit Ratio:** > 80% āļŠāļģāļŦāļĢāļąāļš cached data + - **Application Startup Time:** < 30 seconds + +- **6.5.2 Caching Strategy:** + - **Master Data Cache:** Roles, Permissions, Organizations, Project metadata (TTL: 1 hour) + - **User Session Cache:** User permissions āđāļĨāļ° profile data (TTL: 30 minutes) + - **Search Result Cache:** Frequently searched queries (TTL: 15 minutes) + - **File Metadata Cache:** Attachment metadata (TTL: 1 hour) + - **Document Cache:** Frequently accessed document metadata (TTL: 30 minutes) + - **āļ•āđ‰āļ­āļ‡āļĄāļĩ cache invalidation strategy āļ—āļĩāđˆāļŠāļąāļ”āđ€āļˆāļ™:** + - Invalidate on update/delete operations + - Time-based expiration + - Manual cache clearance āļŠāļģāļŦāļĢāļąāļš admin operations + - āđƒāļŠāđ‰ Redis āđ€āļ›āđ‡āļ™ distributed cache backend + - āļ•āđ‰āļ­āļ‡āļĄāļĩ cache monitoring (hit/miss ratios) + +### **6.6. āļ„āļ§āļēāļĄāļ›āļĨāļ­āļ”āļ āļąāļĒ (Security):** + +- āļĄāļĩāļĢāļ°āļšāļš Rate Limiting āđ€āļžāļ·āđˆāļ­āļ›āđ‰āļ­āļ‡āļāļąāļ™āļāļēāļĢāđ‚āļˆāļĄāļ•āļĩāđāļšāļš Brute-force +- āļāļēāļĢāļˆāļąāļ”āļāļēāļĢ Secret (āđ€āļŠāđˆāļ™ āļĢāļŦāļąāļŠāļœāđˆāļēāļ™ DB, JWT Secret) āļˆāļ°āļ•āđ‰āļ­āļ‡āļ—āļģāļœāđˆāļēāļ™ Environment Variable āļ‚āļ­āļ‡ Docker āđ€āļžāļ·āđˆāļ­āļ„āļ§āļēāļĄāļ›āļĨāļ­āļ”āļ āļąāļĒāļŠāļđāļ‡āļŠāļļāļ” + +- **6.6.1 Rate Limiting Strategy:** + - **Anonymous Endpoints:** 100 requests/hour āļ•āđˆāļ­ IP address + - **Authenticated Endpoints:** + - Viewer: 500 requests/hour + - Editor: 1000 requests/hour + - Document Control: 2000 requests/hour + - Admin/Superadmin: 5000 requests/hour + - **File Upload Endpoints:** 50 requests/hour āļ•āđˆāļ­ user + - **Search Endpoints:** 500 requests/hour āļ•āđˆāļ­ user + - **Authentication Endpoints:** 10 requests/minute āļ•āđˆāļ­ IP address + - **āļ•āđ‰āļ­āļ‡āļĄāļĩ mechanism āļŠāļģāļŦāļĢāļąāļšāļĒāļāđ€āļ§āđ‰āļ™ rate limiting āļŠāļģāļŦāļĢāļąāļš trusted services** + - āļ•āđ‰āļ­āļ‡āļšāļąāļ™āļ—āļķāļ log āđ€āļĄāļ·āđˆāļ­āļĄāļĩāļāļēāļĢ trigger rate limiting + +- **6.6.2 Error Handling āđāļĨāļ° Resilience:** + - āļ•āđ‰āļ­āļ‡āļĄāļĩ circuit breaker pattern āļŠāļģāļŦāļĢāļąāļš external service calls + - āļ•āđ‰āļ­āļ‡āļĄāļĩ retry mechanism āļ”āđ‰āļ§āļĒ exponential backoff + - āļ•āđ‰āļ­āļ‡āļĄāļĩ graceful degradation āđ€āļĄāļ·āđˆāļ­āļšāļĢāļīāļāļēāļĢāļ āļēāļĒāļ™āļ­āļāļĨāđ‰āļĄāđ€āļŦāļĨāļ§ + - Error messages āļ•āđ‰āļ­āļ‡āđ„āļĄāđˆāđ€āļ›āļīāļ”āđ€āļœāļĒāļ‚āđ‰āļ­āļĄāļđāļĨ sensitive + +- **6.6.3 Input Validation:** + - āļ•āđ‰āļ­āļ‡āļĄāļĩ input validation āļ—āļąāđ‰āļ‡āļāļąāđˆāļ‡ client āđāļĨāļ° server (defense in depth) + - āļ•āđ‰āļ­āļ‡āļ›āđ‰āļ­āļ‡āļāļąāļ™ OWASP Top 10 vulnerabilities: + - SQL Injection (āđƒāļŠāđ‰ parameterized queries āļœāđˆāļēāļ™ ORM) + - XSS (input sanitization āđāļĨāļ° output encoding) + - CSRF (CSRF tokens āļŠāļģāļŦāļĢāļąāļš state-changing operations) + - āļ•āđ‰āļ­āļ‡ validate file uploads: + - File type (white-list approach) + - File size + - File content (magic number verification) + - āļ•āđ‰āļ­āļ‡ sanitize user inputs āļāđˆāļ­āļ™āđāļŠāļ”āļ‡āļœāļĨāđƒāļ™ UI + - āļ•āđ‰āļ­āļ‡āđƒāļŠāđ‰ content security policy (CSP) headers + - āļ•āđ‰āļ­āļ‡āļĄāļĩ request size limits āđ€āļžāļ·āđˆāļ­āļ›āđ‰āļ­āļ‡āļāļąāļ™ DoS attacks + +- **6.6.4 Session āđāļĨāļ° Token Management:** + - **JWT token expiration:** 8 hours āļŠāļģāļŦāļĢāļąāļš access token + - **Refresh token expiration:** 7 days + - **Refresh token mechanism:** āļ•āđ‰āļ­āļ‡āļĢāļ­āļ‡āļĢāļąāļš token rotation āđāļĨāļ° revocation + - **Token revocation on logout:** āļ•āđ‰āļ­āļ‡āļšāļąāļ™āļ—āļķāļ revoked tokens āļˆāļ™āļāļ§āđˆāļēāļˆāļ° expire + - **Concurrent session management:** + - āļˆāļģāļāļąāļ”āļˆāļģāļ™āļ§āļ™ session āļžāļĢāđ‰āļ­āļĄāļāļąāļ™āđ„āļ”āđ‰ (default: 5 devices) + - āļ•āđ‰āļ­āļ‡āđāļˆāđ‰āļ‡āđ€āļ•āļ·āļ­āļ™āđ€āļĄāļ·āđˆāļ­āļĄāļĩ login āļˆāļēāļ device/location āđƒāļŦāļĄāđˆ + - **Device fingerprinting:** āļŠāļģāļŦāļĢāļąāļš security āđāļĨāļ° audit purposes + - **Password policy:** + - āļ„āļ§āļēāļĄāļĒāļēāļ§āļ‚āļąāđ‰āļ™āļ•āđˆāļģ: 8 characters + - āļ•āđ‰āļ­āļ‡āļĄāļĩ uppercase, lowercase, number, special character + - āļ•āđ‰āļ­āļ‡āđ€āļ›āļĨāļĩāđˆāļĒāļ™ password āļ—āļļāļ 90 āļ§āļąāļ™ + - āļ•āđ‰āļ­āļ‡āļ›āđ‰āļ­āļ‡āļāļąāļ™āļāļēāļĢāđƒāļŠāđ‰ password āļ—āļĩāđˆāđ€āļ„āļĒāđƒāļŠāđ‰āļĄāļēāđāļĨāđ‰āļ§ 5 āļ„āļĢāļąāđ‰āļ‡āļĨāđˆāļēāļŠāļļāļ” + +### **6.7. āļāļēāļĢāļŠāļģāļĢāļ­āļ‡āļ‚āđ‰āļ­āļĄāļđāļĨāđāļĨāļ°āļāļēāļĢāļāļđāđ‰āļ„āļ·āļ™ (Backup & Recovery):** + +- āļĢāļ°āļšāļšāļˆāļ°āļ•āđ‰āļ­āļ‡āļĄāļĩāļāļĨāđ„āļāļāļēāļĢāļŠāļģāļĢāļ­āļ‡āļ‚āđ‰āļ­āļĄāļđāļĨāļ­āļąāļ•āđ‚āļ™āļĄāļąāļ•āļīāļŠāļģāļŦāļĢāļąāļšāļāļēāļ™āļ‚āđ‰āļ­āļĄāļđāļĨ MariaDB [cite: 2.4] āđāļĨāļ°āđ„āļŸāļĨāđŒāđ€āļ­āļāļŠāļēāļĢāļ—āļąāđ‰āļ‡āļŦāļĄāļ”āđƒāļ™ /share/dms-data [cite: 2.1] (āđ€āļŠāđˆāļ™ āđƒāļŠāđ‰ HBS 3 āļ‚āļ­āļ‡ QNAP āļŦāļĢāļ·āļ­āļŠāļ„āļĢāļīāļ›āļ•āđŒāļŠāļģāļĢāļ­āļ‡āļ‚āđ‰āļ­āļĄāļđāļĨ) āļ­āļĒāđˆāļēāļ‡āļ™āđ‰āļ­āļĒāļ§āļąāļ™āļĨāļ° 1 āļ„āļĢāļąāđ‰āļ‡ +- āļ•āđ‰āļ­āļ‡āļĄāļĩāđāļœāļ™āļāļēāļĢāļāļđāđ‰āļ„āļ·āļ™āļĢāļ°āļšāļš (Disaster Recovery Plan) āđƒāļ™āļāļĢāļ“āļĩāļ—āļĩāđˆ Server āļŦāļĨāļąāļ (QNAP) āđƒāļŠāđ‰āļ‡āļēāļ™āđ„āļĄāđˆāđ„āļ”āđ‰ + +- **6.7.1 āļ‚āļąāđ‰āļ™āļ•āļ­āļ™āļāļēāļĢāļāļđāđ‰āļ„āļ·āļ™:** + - **Database Restoration Procedure:** + - āļŠāļĢāđ‰āļēāļ‡āļˆāļēāļ full backup āļĨāđˆāļēāļŠāļļāļ” + - Apply transaction logs āļ–āļķāļ‡ point-in-time āļ—āļĩāđˆāļ•āđ‰āļ­āļ‡āļāļēāļĢ + - Verify data integrity post-restoration + - **File Storage Restoration Procedure:** + - Restore āļˆāļēāļ QNAP snapshot āļŦāļĢāļ·āļ­ backup + - Verify file integrity āđāļĨāļ° permissions + - **Application Redeployment Procedure:** + - Deploy āļˆāļēāļ version āļĨāđˆāļēāļŠāļļāļ”āļ—āļĩāđˆāļĢāļđāđ‰āļ§āđˆāļēāļ—āļģāļ‡āļēāļ™āđ„āļ”āđ‰ + - Verify application health + - **Data Integrity Verification Post-Recovery:** + - Run data consistency checks + - Verify critical business data + - **Recovery Time Objective (RTO):** < 4 āļŠāļąāđˆāļ§āđ‚āļĄāļ‡ + - **Recovery Point Objective (RPO):** < 1 āļŠāļąāđˆāļ§āđ‚āļĄāļ‡ + +### **6.8. āļāļĨāļĒāļļāļ—āļ˜āđŒāļāļēāļĢāđāļˆāđ‰āļ‡āđ€āļ•āļ·āļ­āļ™ (Notification Strategy - āļ›āļĢāļąāļšāļ›āļĢāļļāļ‡):** + +- **6.8.1 āļĢāļ°āļšāļšāļˆāļ°āļŠāđˆāļ‡āļāļēāļĢāđāļˆāđ‰āļ‡āđ€āļ•āļ·āļ­āļ™ (āļœāđˆāļēāļ™ Email āļŦāļĢāļ·āļ­ Line [cite: 2.7]) āđ€āļĄāļ·āđˆāļ­āļĄāļĩāļāļēāļĢāļāļĢāļ°āļ—āļģāļ—āļĩāđˆāļŠāļģāļ„āļąāļ** āļ”āļąāļ‡āļ™āļĩāđ‰: + 1. āđ€āļĄāļ·āđˆāļ­āļĄāļĩāđ€āļ­āļāļŠāļēāļĢāđƒāļŦāļĄāđˆ (Correspondence, RFA) āļ–āļđāļāļŠāđˆāļ‡āļĄāļēāļ–āļķāļ‡āļ­āļ‡āļ„āđŒāļāļĢāļ“āđŒāļ‚āļ­āļ‡āđ€āļĢāļē + 2. āđ€āļĄāļ·āđˆāļ­āļĄāļĩāđƒāļšāđ€āļ§āļĩāļĒāļ™ (Circulation) āđƒāļŦāļĄāđˆ āļĄāļ­āļšāļŦāļĄāļēāļĒāļ‡āļēāļ™āļĄāļēāļ—āļĩāđˆāđ€āļĢāļē + 3. (āļ—āļēāļ‡āđ€āļĨāļ·āļ­āļ) āđ€āļĄāļ·āđˆāļ­āđ€āļ­āļāļŠāļēāļĢāļ—āļĩāđˆāđ€āļĢāļēāļŠāđˆāļ‡āđ„āļ› āļ–āļđāļāļ”āļģāđ€āļ™āļīāļ™āļāļēāļĢ (āđ€āļŠāđˆāļ™ āļ­āļ™āļļāļĄāļąāļ•āļī/āļ›āļāļīāđ€āļŠāļ˜) + 4. (āļ—āļēāļ‡āđ€āļĨāļ·āļ­āļ) āđ€āļĄāļ·āđˆāļ­āđƒāļāļĨāđ‰āļ–āļķāļ‡āļ§āļąāļ™āļ„āļĢāļšāļāļģāļŦāļ™āļ” (Deadline) [cite: 3.2.5, 3.6.6, 3.7.5] + +- **6.8.2 Grouping/Digest (āđƒāļŦāļĄāđˆ):** āļāļĢāļ“āļĩāļĄāļĩāļāļēāļĢāđāļˆāđ‰āļ‡āđ€āļ•āļ·āļ­āļ™āļ›āļĢāļ°āđ€āļ āļ—āđ€āļ”āļĩāļĒāļ§āļāļąāļ™āļˆāļģāļ™āļ§āļ™āļĄāļēāļāđƒāļ™āļŠāđˆāļ§āļ‡āđ€āļ§āļĨāļēāļŠāļąāđ‰āļ™āđ† (āđ€āļŠāđˆāļ™ Approve āđ€āļ­āļāļŠāļēāļĢ 10 āļ‰āļšāļąāļšāļĢāļ§āļ”) āļĢāļ°āļšāļšāļ•āđ‰āļ­āļ‡ **āļĢāļ§āļĄ (Batch)** āđ€āļ›āđ‡āļ™ 1 Email/Line Notification āđ€āļžāļ·āđˆāļ­āđ„āļĄāđˆāđƒāļŦāđ‰āļĢāļšāļāļ§āļ™āļœāļđāđ‰āđƒāļŠāđ‰ (Spamming) + +- **6.8.3 Notification Delivery Guarantees:** + - **At-least-once delivery:** āļŠāļģāļŦāļĢāļąāļš important notifications + - **Retry mechanism:** āļ”āđ‰āļ§āļĒ exponential backoff (max 3 reties) + - **Dead letter queue:** āļŠāļģāļŦāļĢāļąāļš notifications āļ—āļĩāđˆāļŠāđˆāļ‡āđ„āļĄāđˆāļŠāļģāđ€āļĢāđ‡āļˆāļŦāļĨāļąāļ‡āļˆāļēāļ retries + - **Delivery status tracking:** āļ•āđ‰āļ­āļ‡āļšāļąāļ™āļ—āļķāļāļŠāļ–āļēāļ™āļ°āļāļēāļĢāļŠāđˆāļ‡ notifications + - **Fallback channels:** āļ–āđ‰āļē Email āļĨāđ‰āļĄāđ€āļŦāļĨāļ§ āđƒāļŦāđ‰āļŠāđˆāļ‡āļœāđˆāļēāļ™ SYSTEM notification + - **Notification preferences:** āļœāļđāđ‰āđƒāļŠāđ‰āļ•āđ‰āļ­āļ‡āļŠāļēāļĄāļēāļĢāļ–āļāļģāļŦāļ™āļ” channel preferences āđ„āļ”āđ‰ + +### **6.9. Maintenance Mode (āđƒāļŦāļĄāđˆ)** + +- āļĢāļ°āļšāļšāļ•āđ‰āļ­āļ‡āļĄāļĩāļāļĨāđ„āļ **Maintenance Mode** āļ—āļĩāđˆ Admin āļŠāļēāļĄāļēāļĢāļ–āđ€āļ›āļīāļ”āđƒāļŠāđ‰āļ‡āļēāļ™āđ„āļ”āđ‰ + - āđ€āļĄāļ·āđˆāļ­āđ€āļ›āļīāļ”: āļœāļđāđ‰āđƒāļŠāđ‰āļ—āļąāđˆāļ§āđ„āļ›āļˆāļ°āđ€āļŦāđ‡āļ™āļŦāļ™āđ‰āļē "āļ›āļīāļ”āļ›āļĢāļąāļšāļ›āļĢāļļāļ‡" āđāļĨāļ°āđ„āļĄāđˆāļŠāļēāļĄāļēāļĢāļ–āđ€āļĢāļĩāļĒāļ API āđ„āļ”āđ‰ (āļĒāļāđ€āļ§āđ‰āļ™ Admin) + - āđƒāļŠāđ‰āļŠāļģāļŦāļĢāļąāļšāļŠāđˆāļ§āļ‡ Deploy Version āđƒāļŦāļĄāđˆ āļŦāļĢāļ·āļ­ Database Migration + +### **6.10. Monitoring āđāļĨāļ° Observability** + +- **6.10.1 Application Monitoring:** + - **Health checks:** /health endpoint āļŠāļģāļŦāļĢāļąāļš load balancer + - **Metrics collection:** Response times, error rates, throughput + - **Distributed tracing:** āļŠāļģāļŦāļĢāļąāļš request tracing across services + - **Log aggregation:** Structured logging āļ”āđ‰āļ§āļĒ JSON format + - **Alerting:** āļŠāļģāļŦāļĢāļąāļš critical errors āđāļĨāļ° performance degradation +- **6.10.2 Business Metrics:** + - āļˆāļģāļ™āļ§āļ™ documents created āļ•āđˆāļ­āļ§āļąāļ™ + - Workflow completion rates + - User activity metrics + - System utilization rates + - Search query performance +- **6.10.3 Security Monitoring:** + - Failed login attempts + - Rate limiting triggers + - Virus scan results + - File download activities + - Permission changes + +### **6.11 JSON Processing & Validation** + +- **6.11.1 JSON Schema Management** + - āļ•āđ‰āļ­āļ‡āļĄāļĩ centralized JSON schema registry + - āļ•āđ‰āļ­āļ‡āļĢāļ­āļ‡āļĢāļąāļš schema versioning āđāļĨāļ° migration + - āļ•āđ‰āļ­āļ‡āļĄāļĩ schema validation during runtime +- **6.11.2 Performance Optimization** + - **Caching:** Cache parsed JSON structures + - **Compression:** āđƒāļŠāđ‰ compression āļŠāļģāļŦāļĢāļąāļš JSON āļ‚āļ™āļēāļ”āđƒāļŦāļāđˆ + - **Indexing:** Support JSON path indexing āļŠāļģāļŦāļĢāļąāļš query +- **6.11.3 Error Handling** + - āļ•āđ‰āļ­āļ‡āļĄāļĩ graceful degradation āđ€āļĄāļ·āđˆāļ­ JSON validation āļĨāđ‰āļĄāđ€āļŦāļĨāļ§ + - āļ•āđ‰āļ­āļ‡āļĄāļĩ default fallback values + - āļ•āđ‰āļ­āļ‡āļšāļąāļ™āļ—āļķāļ error logs āļŠāļģāļŦāļĢāļąāļš validation failures + +## **🧊 7. āļ‚āđ‰āļ­āļāļģāļŦāļ™āļ”āļ”āđ‰āļēāļ™āļāļēāļĢāļ—āļ”āļŠāļ­āļš (Testing Requirements)** + +### **7.1. Unit Testing:** + +- āļ•āđ‰āļ­āļ‡āļĄāļĩ unit tests āļŠāļģāļŦāļĢāļąāļš business logic āļ—āļąāđ‰āļ‡āļŦāļĄāļ” +- Code coverage āļ­āļĒāđˆāļēāļ‡āļ™āđ‰āļ­āļĒ 70% āļŠāļģāļŦāļĢāļąāļš backend services +- āļ•āđ‰āļ­āļ‡āļ—āļ”āļŠāļ­āļš RBAC permission logic āļ—āļļāļāļĢāļ°āļ”āļąāļš + +### **7.2. Integration Testing:** + +- āļ—āļ”āļŠāļ­āļšāļāļēāļĢāļ—āļģāļ‡āļēāļ™āļĢāđˆāļ§āļĄāļāļąāļ™āļ‚āļ­āļ‡ modules +- āļ—āļ”āļŠāļ­āļš database migrations āđāļĨāļ° data integrity +- āļ—āļ”āļŠāļ­āļš API endpoints āļ”āđ‰āļ§āļĒ realistic data + +### **7.3. End-to-End Testing:** + +- āļ—āļ”āļŠāļ­āļš complete user workflows +- āļ—āļ”āļŠāļ­āļš document lifecycle āļˆāļēāļ creation āļ–āļķāļ‡ archival +- āļ—āļ”āļŠāļ­āļš cross-module integrations + +### **7.4. Security Testing:** + +- **Penetration Testing:** āļ—āļ”āļŠāļ­āļš OWASP Top 10 vulnerabilities +- **Security Audit:** Review code āļŠāļģāļŦāļĢāļąāļš security flaws +- **Virus Scanning Test:** āļ—āļ”āļŠāļ­āļš file upload security +- **Rate Limiting Test:** āļ—āļ”āļŠāļ­āļš rate limiting functionality + +### **7.5. Performance Testing:** + +- **Load Testing:** āļ—āļ”āļŠāļ­āļšāļ”āđ‰āļ§āļĒ realistic workloads +- **Stress Testing:** āļŦāļē breaking points āļ‚āļ­āļ‡āļĢāļ°āļšāļš +- **Endurance Testing:** āļ—āļ”āļŠāļ­āļšāļāļēāļĢāļ—āļģāļ‡āļēāļ™āļ•āđˆāļ­āđ€āļ™āļ·āđˆāļ­āļ‡āđ€āļ›āđ‡āļ™āđ€āļ§āļĨāļēāļ™āļēāļ™ + +### **7.6. Disaster Recovery Testing:** + +- āļ—āļ”āļŠāļ­āļš backup āđāļĨāļ° restoration procedures +- āļ—āļ”āļŠāļ­āļš failover mechanisms +- āļ—āļ”āļŠāļ­āļš data integrity āļŦāļĨāļąāļ‡āļāļēāļĢ recovery + +### **7.7 Specific Scenario Testing (āđ€āļžāļīāđˆāļĄ)** + +- **Race Condition Test:** āļ—āļ”āļŠāļ­āļšāļĒāļīāļ‡ Request āļ‚āļ­āđ€āļĨāļ‚āļ—āļĩāđˆāđ€āļ­āļāļŠāļēāļĢāļžāļĢāđ‰āļ­āļĄāļāļąāļ™ 100 Request +- **Transaction Test:** āļ—āļ”āļŠāļ­āļšāļ›āļīāļ”āđ€āļ™āđ‡āļ•āļĢāļ°āļŦāļ§āđˆāļēāļ‡ Upload āđ„āļŸāļĨāđŒ (āļ•āļĢāļ§āļˆāļŠāļ­āļšāļ§āđˆāļēāđ„āļĄāđˆāļĄāļĩ Orphan File āļŦāļĢāļ·āļ­ Broken Link) +- **Permission Test:** āļ—āļ”āļŠāļ­āļš CASL Integration āļ—āļąāđ‰āļ‡āļāļąāđˆāļ‡ Backend āđāļĨāļ° Frontend āđƒāļŦāđ‰āļ•āļĢāļ‡āļāļąāļ™ + +## **8. āļ‚āđ‰āļ­āļāļģāļŦāļ™āļ”āļ”āđ‰āļēāļ™āļāļēāļĢāļšāļģāļĢāļļāļ‡āļĢāļąāļāļĐāļē (Maintenance Requirements)** + +### **8.1. Log Retention:** + +- Audit logs: 7 āļ›āļĩ +- Application logs: 1 āļ›āļĩ +- Performance metrics: 2 āļ›āļĩ + +### **8.2. Monitoring āđāļĨāļ° Alerting:** + +- āļ•āđ‰āļ­āļ‡āļĄāļĩ proactive monitoring āļŠāļģāļŦāļĢāļąāļš critical systems +- āļ•āđ‰āļ­āļ‡āļĄāļĩ alerting āļŠāļģāļŦāļĢāļąāļš security incidents +- āļ•āđ‰āļ­āļ‡āļĄāļĩ performance degradation alerts + +### **8.3. Patch Management:** + +- āļ•āđ‰āļ­āļ‡āļĄāļĩ process āļŠāļģāļŦāļĢāļąāļš security patches +- āļ•āđ‰āļ­āļ‡āļ—āļ”āļŠāļ­āļš patches āđƒāļ™ staging environment +- āļ•āđ‰āļ­āļ‡āļĄāļĩ rollback plan āļŠāļģāļŦāļĢāļąāļš failed updates + +### **8.4. Capacity Planning:** + +- āļ•āđ‰āļ­āļ‡ monitor resource utilization +- āļ•āđ‰āļ­āļ‡āļĄāļĩ scaling strategy āļŠāļģāļŦāļĢāļąāļš growth +- āļ•āđ‰āļ­āļ‡āļĄāļĩ performance baselines āđāļĨāļ° trending + +## **9. āļ‚āđ‰āļ­āļāļģāļŦāļ™āļ”āļ”āđ‰āļēāļ™āļāļēāļĢāļ›āļāļīāļšāļąāļ•āļīāļ•āļēāļĄāļāļŽāļĢāļ°āđ€āļšāļĩāļĒāļš (Compliance Requirements)** + +### **9.1. Data Privacy:** + +- āļ•āđ‰āļ­āļ‡āļ›āļāļīāļšāļąāļ•āļīāļ•āļēāļĄāļāļŽāļŦāļĄāļēāļĒāļ„āļļāđ‰āļĄāļ„āļĢāļ­āļ‡āļ‚āđ‰āļ­āļĄāļđāļĨāļŠāđˆāļ§āļ™āļšāļļāļ„āļ„āļĨ +- āļ•āđ‰āļ­āļ‡āļĄāļĩ data retention policies +- āļ•āđ‰āļ­āļ‡āļĄāļĩ data deletion procedures + +### **9.2. Audit Compliance:** + +- āļ•āđ‰āļ­āļ‡āļĢāļ­āļ‡āļĢāļąāļš internal āđāļĨāļ° external audits +- āļ•āđ‰āļ­āļ‡āļĄāļĩ comprehensive audit trails +- āļ•āđ‰āļ­āļ‡āļĄāļĩ reporting capabilities āļŠāļģāļŦāļĢāļąāļš compliance + +### **9.3. Security Standards:** + +- āļ•āđ‰āļ­āļ‡āļ›āļāļīāļšāļąāļ•āļīāļ•āļēāļĄ organizational security policies +- āļ•āđ‰āļ­āļ‡āļĄāļĩ security incident response plan +- āļ•āđ‰āļ­āļ‡āļĄāļĩ regular security assessments + +## **📋 āļŠāļĢāļļāļ›āļāļēāļĢāļ›āļĢāļąāļšāļ›āļĢāļļāļ‡āļˆāļēāļāđ€āļ§āļ­āļĢāđŒāļŠāļąāļ™āļāđˆāļ­āļ™āļŦāļ™āđ‰āļē** + +### **Security Enhancements:** + +1. **File Upload Security** - Virus scanning, file type validation, access controls +2. **Input Validation** - OWASP Top 10 protection, XSS/CSRF prevention +3. **Rate Limiting** - Comprehensive rate limiting strategy +4. **Secrets Management** - Secure handling of sensitive configuration + +### **Architecture Improvements:** + +1. **Document Numbering** - Changed from Stored Procedure to Application-level Locking with Optimistic Locking safety net +2. **Resilience Patterns** - Circuit breaker, retry mechanisms, fallback strategies +3. **Monitoring & Observability** - Health checks, metrics, distributed tracing +4. **Caching Strategy** - Comprehensive caching with proper invalidation +5. **Two-Phase File Storage** - Temp -> Permanent storage with transaction safety +6. **Unified Workflow Engine** - Consolidated routing logic for better maintainability + +### **Performance Targets:** + +1. **API Response Time** - < 200ms (90th percentile) +2. **Search Performance** - < 500ms +3. **File Upload** - < 30 seconds for 50MB files +4. **Cache Hit Ratio** - > 80% + +### **Operational Excellence:** + +1. **Disaster Recovery** - RTO < 4 hours, RPO < 1 hour +2. **Backup Procedures** - Comprehensive backup and restoration +3. **Security Testing** - Penetration testing and security audits +4. **Performance Testing** - Load testing with realistic workloads +5. **Maintenance Mode** - Graceful system maintenance capabilities + +### **User Experience Improvements:** + +1. **Dynamic Form Generator** - Reduced code duplication and better schema support +2. **Mobile Responsiveness** - Card view for tables on mobile devices +3. **Auto-Save Draft** - LocalStorage integration for form resilience +4. **Notification Digest** - Reduced notification spam + +### **Data Management:** + +1. **Virtual Columns** - Improved JSON field search performance +2. **Table Partitioning** - Support for large-scale data growth +3. **Idempotency Keys** - Prevention of duplicate transactions + +āđ€āļ­āļāļŠāļēāļĢāļ™āļĩāđ‰āļŠāļ°āļ—āđ‰āļ­āļ™āļ–āļķāļ‡āļ„āļ§āļēāļĄāļĄāļļāđˆāļ‡āļĄāļąāđˆāļ™āđƒāļ™āļāļēāļĢāļŠāļĢāđ‰āļēāļ‡āļĢāļ°āļšāļšāļ—āļĩāđˆāļĄāļĩāļ„āļ§āļēāļĄāļ›āļĨāļ­āļ”āļ āļąāļĒ, āļĄāļĩāļ„āļ§āļēāļĄāļ—āļ™āļ—āļēāļ™, āđāļĨāļ°āļĄāļĩāļ›āļĢāļ°āļŠāļīāļ—āļ˜āļīāļ āļēāļžāļŠāļđāļ‡ āļžāļĢāđ‰āļ­āļĄāļĢāļ­āļ‡āļĢāļąāļšāļāļēāļĢāđ€āļ•āļīāļšāđ‚āļ•āđƒāļ™āļ­āļ™āļēāļ„āļ•āđāļĨāļ°āļ„āļ§āļēāļĄāļ•āđ‰āļ­āļ‡āļāļēāļĢāļ—āļēāļ‡āļ˜āļļāļĢāļāļīāļˆāļ—āļĩāđˆāđ€āļ›āļĨāļĩāđˆāļĒāļ™āđāļ›āļĨāļ‡āđ„āļ› + +**āļŦāļĄāļēāļĒāđ€āļŦāļ•āļļ:** Requirements āļ™āļĩāđ‰āļˆāļ°āļ–āļđāļāļ—āļšāļ—āļ§āļ™āđāļĨāļ°āļ›āļĢāļąāļšāļ›āļĢāļļāļ‡āđ€āļ›āđ‡āļ™āļĢāļ°āļĒāļ°āļ•āļēāļĄ feedback āļˆāļēāļāļ—āļĩāļĄāļžāļąāļ’āļ™āļēāđāļĨāļ°āļ„āļ§āļēāļĄāļ•āđ‰āļ­āļ‡āļāļēāļĢāļ—āļēāļ‡āļ˜āļļāļĢāļāļīāļˆāļ—āļĩāđˆāđ€āļ›āļĨāļĩāđˆāļĒāļ™āđāļ›āļĨāļ‡āđ„āļ› + +## **Document Control:** + +- **Document:** Application Requirements Specification v1.4.4 +- **Version:** 1.4 +- **Date:** 2025-11-26 +- **Author:** NAP LCBP3-DMS & Gemini +- **Status:** FINAL-Rev.04 +- **Classification:** Internal Technical Documentation +- **Approved By:** Nattanin + +--- + +`End of Requirements Specification v1.4.4` diff --git a/1_FullStackJS_V1_4_4.md b/1_FullStackJS_V1_4_4.md new file mode 100644 index 0000000..ba8c633 --- /dev/null +++ b/1_FullStackJS_V1_4_4.md @@ -0,0 +1,975 @@ +# 📝 **Documents Management System Version 1.4.4: āđāļ™āļ§āļ—āļēāļ‡āļāļēāļĢāļžāļąāļ’āļ™āļē FullStackJS** + +**āļŠāļ–āļēāļ™āļ°:** FINAL GUIDELINE Rev.04 +**āļ§āļąāļ™āļ—āļĩāđˆ:** 2025-11-26 +**āļ­āđ‰āļēāļ‡āļ­āļīāļ‡:** Requirements Specification v1.4.3 +**Classification:** Internal Technical Documentation + +## 🧠 **1. āļ›āļĢāļąāļŠāļāļēāļ—āļąāđˆāļ§āđ„āļ› (General Philosophy)** + +āđāļ™āļ§āļ—āļēāļ‡āļ›āļāļīāļšāļąāļ•āļīāļ—āļĩāđˆāļ”āļĩāļ—āļĩāđˆāļŠāļļāļ”āđāļšāļšāļ„āļĢāļšāļ§āļ‡āļˆāļĢāļŠāļģāļŦāļĢāļąāļšāļāļēāļĢāļžāļąāļ’āļ™āļē NestJS Backend, NextJS Frontend āđāļĨāļ° Tailwind-based UI/UX āđƒāļ™āļŠāļ āļēāļžāđāļ§āļ”āļĨāđ‰āļ­āļĄ TypeScript āļĄāļļāđˆāļ‡āđ€āļ™āđ‰āļ™āļ—āļĩāđˆ **"Data Integrity First"** (āļ„āļ§āļēāļĄāļ–āļđāļāļ•āđ‰āļ­āļ‡āļ‚āļ­āļ‡āļ‚āđ‰āļ­āļĄāļđāļĨāļ•āđ‰āļ­āļ‡āļĄāļēāļāđˆāļ­āļ™) āļ•āļēāļĄāļ”āđ‰āļ§āļĒ Security āđāļĨāļ° UX + +* **āļ„āļ§āļēāļĄāļŠāļąāļ”āđ€āļˆāļ™ (clarity), āļ„āļ§āļēāļĄāļ‡āđˆāļēāļĒāđƒāļ™āļāļēāļĢāļšāļģāļĢāļļāļ‡āļĢāļąāļāļĐāļē (maintainability), āļ„āļ§āļēāļĄāļŠāļ­āļ”āļ„āļĨāđ‰āļ­āļ‡āļāļąāļ™ (consistency) āđāļĨāļ° āļāļēāļĢāđ€āļ‚āđ‰āļēāļ–āļķāļ‡āđ„āļ”āđ‰ (accessibility)** āļ•āļĨāļ­āļ”āļ—āļąāđ‰āļ‡āļŠāđāļ•āđ‡āļ +* **Strict Typing:** āđƒāļŠāđ‰ TypeScript āļ­āļĒāđˆāļēāļ‡āđ€āļ„āļĢāđˆāļ‡āļ„āļĢāļąāļ” āļŦāđ‰āļēāļĄ `any` +* **Consistency:** āđƒāļŠāđ‰āļ āļēāļĐāļēāļ­āļąāļ‡āļāļĪāļĐāđƒāļ™ Code / āļ āļēāļĐāļēāđ„āļ—āļĒāđƒāļ™ Comment +* **Resilience:** āļĢāļ°āļšāļšāļ•āđ‰āļ­āļ‡āļ—āļ™āļ—āļēāļ™āļ•āđˆāļ­ Network Failure āđāļĨāļ° Race Condition + +## ⚙ïļ **2. āđāļ™āļ§āļ—āļēāļ‡āļ—āļąāđˆāļ§āđ„āļ›āļŠāļģāļŦāļĢāļąāļš TypeScript** + +### **2.1 āļŦāļĨāļąāļāļāļēāļĢāļžāļ·āđ‰āļ™āļāļēāļ™** + +* āđƒāļŠāđ‰ **āļ āļēāļĐāļēāļ­āļąāļ‡āļāļĪāļĐ** āļŠāļģāļŦāļĢāļąāļšāđ‚āļ„āđ‰āļ” +* āđƒāļŠāđ‰ **āļ āļēāļĐāļēāđ„āļ—āļĒ** āļŠāļģāļŦāļĢāļąāļš comment āđāļĨāļ°āđ€āļ­āļāļŠāļēāļĢāļ—āļąāđ‰āļ‡āļŦāļĄāļ” +* āļāļģāļŦāļ™āļ”āđ„āļ—āļ›āđŒ (type) āļ­āļĒāđˆāļēāļ‡āļŠāļąāļ”āđ€āļˆāļ™āļŠāļģāļŦāļĢāļąāļšāļ•āļąāļ§āđāļ›āļĢ, āļžāļēāļĢāļēāļĄāļīāđ€āļ•āļ­āļĢāđŒ āđāļĨāļ°āļ„āđˆāļēāļ—āļĩāđˆāļŠāđˆāļ‡āļāļĨāļąāļš (return values) āļ—āļąāđ‰āļ‡āļŦāļĄāļ” +* āļŦāļĨāļĩāļāđ€āļĨāļĩāđˆāļĒāļ‡āļāļēāļĢāđƒāļŠāđ‰ any; āđƒāļŦāđ‰āļŠāļĢāđ‰āļēāļ‡āđ„āļ—āļ›āđŒ (types) āļŦāļĢāļ·āļ­āļ­āļīāļ™āđ€āļ—āļ­āļĢāđŒāđ€āļŸāļ‹ (interfaces) āļ—āļĩāđˆāļāļģāļŦāļ™āļ”āđ€āļ­āļ‡ +* āđƒāļŠāđ‰ **JSDoc** āļŠāļģāļŦāļĢāļąāļšāļ„āļĨāļēāļŠ (classes) āđāļĨāļ°āđ€āļĄāļ˜āļ­āļ” (methods) āļ—āļĩāđˆāđ€āļ›āđ‡āļ™ public +* āļŠāđˆāļ‡āļ­āļ­āļ (Export) **āļŠāļąāļāļĨāļąāļāļĐāļ“āđŒāļŦāļĨāļąāļ (main symbol) āđ€āļžāļĩāļĒāļ‡āļŦāļ™āļķāđˆāļ‡āđ€āļ”āļĩāļĒāļ§** āļ•āđˆāļ­āđ„āļŸāļĨāđŒ +* āļŦāļĨāļĩāļāđ€āļĨāļĩāđˆāļĒāļ‡āļšāļĢāļĢāļ—āļąāļ”āļ§āđˆāļēāļ‡āļ āļēāļĒāđƒāļ™āļŸāļąāļ‡āļāđŒāļŠāļąāļ™ +* āļĢāļ°āļšāļļ // File: path/filename āđƒāļ™āļšāļĢāļĢāļ—āļąāļ”āđāļĢāļāļ‚āļ­āļ‡āļ—āļļāļāđ„āļŸāļĨāđŒ +* āļĢāļ°āļšāļļ // āļšāļąāļ™āļ—āļķāļāļāļēāļĢāđāļāđ‰āđ„āļ‚, āļŦāļēāļāļĄāļĩāļāļēāļĢāđāļāđ‰āđ„āļ‚āđ€āļžāļīāđˆāļĄāđƒāļ™āļ­āļ™āļēāļ„āļ• āđƒāļŦāđ‰āđ€āļžāļīāđˆāļĄāļšāļąāļ™āļ—āļķāļ + +### **2.2 Configuration & Secrets Management** + +* **Production/Staging:** āļŦāđ‰āļēāļĄāđƒāļŠāđˆ Secrets (Password, Keys) āđƒāļ™ `docker-compose.yml` āļŦāļĨāļąāļ +* **Development:** āđƒāļŦāđ‰āļŠāļĢāđ‰āļēāļ‡āđ„āļŸāļĨāđŒ `docker-compose.override.yml` (āđ€āļžāļīāđˆāļĄāđƒāļ™ `.gitignore`) āđ€āļžāļ·āđˆāļ­ Inject āļ•āļąāļ§āđāļ›āļĢ Environment āļ—āļĩāđˆāđ€āļ›āđ‡āļ™āļ„āļ§āļēāļĄāļĨāļąāļš +* **Validation:** āđƒāļŠāđ‰ `joi` āļŦāļĢāļ·āļ­ `zod` āđƒāļ™āļāļēāļĢ Validate Environment Variables āļ•āļ­āļ™ Start App āļŦāļēāļāļ‚āļēāļ”āļ•āļąāļ§āđāļ›āļĢāļŠāļģāļ„āļąāļāđƒāļŦāđ‰ Throw Error āļ—āļąāļ™āļ—āļĩ + +### **2.3 Idempotency (āļ„āļ§āļēāļĄāļŠāļēāļĄāļēāļĢāļ–āđƒāļ™āļāļēāļĢāļ—āļģāļ‹āđ‰āļģāđ„āļ”āđ‰)** + +* āļŠāļģāļŦāļĢāļąāļšāļāļēāļĢāļ—āļģāļ‡āļēāļ™āļ—āļĩāđˆāļŠāļģāļ„āļąāļ (Create Document, Approve, Transactional) **āļ•āđ‰āļ­āļ‡** āļ­āļ­āļāđāļšāļšāđƒāļŦāđ‰āđ€āļ›āđ‡āļ™ Idempotent +* Client **āļ•āđ‰āļ­āļ‡** āļŠāđˆāļ‡ Header `Idempotency-Key` (UUID) āļĄāļēāļāļąāļš Request +* Server **āļ•āđ‰āļ­āļ‡** āļ•āļĢāļ§āļˆāļŠāļ­āļšāļ§āđˆāļē Key āļ™āļĩāđ‰āđ€āļ„āļĒāļ–āļđāļāļ›āļĢāļ°āļĄāļ§āļĨāļœāļĨāļŠāļģāđ€āļĢāđ‡āļˆāđ„āļ›āđāļĨāđ‰āļ§āļŦāļĢāļ·āļ­āđ„āļĄāđˆ āļ–āđ‰āļēāđƒāļŠāđˆ āđƒāļŦāđ‰āļ„āļ·āļ™āļ„āđˆāļēāđ€āļ”āļīāļĄāđ‚āļ”āļĒāđ„āļĄāđˆāļ—āļģāļ‹āđ‰āļģ + +### **2.4 āļ‚āđ‰āļ­āļ•āļāļĨāļ‡āđƒāļ™āļāļēāļĢāļ•āļąāđ‰āļ‡āļŠāļ·āđˆāļ­ (Naming Conventions)** + +| Entity (āļŠāļīāđˆāļ‡āļ—āļĩāđˆāļ•āļąāđ‰āļ‡āļŠāļ·āđˆāļ­) | Convention (āļĢāļđāļ›āđāļšāļš) | Example (āļ•āļąāļ§āļ­āļĒāđˆāļēāļ‡) | +| :-------------------- | :----------------- | :--------------------------------- | +| Classes | PascalCase | UserService | +| Property | snake_case | 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) + +### ðŸ§Đ**2.5 āļŸāļąāļ‡āļāđŒāļŠāļąāļ™ (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) āđƒāļŦāđ‰āđ€āļ›āđ‡āļ™āļĢāļ°āļ”āļąāļšāđ€āļ”āļĩāļĒāļ§āđƒāļ™āđāļ•āđˆāļĨāļ°āļŸāļąāļ‡āļāđŒāļŠāļąāļ™ + +### ðŸ§ą**2.6 āļāļēāļĢāļˆāļąāļ”āļāļēāļĢāļ‚āđ‰āļ­āļĄāļđāļĨ (Data Handling)** + +* āļŦāđˆāļ­āļŦāļļāđ‰āļĄāļ‚āđ‰āļ­āļĄāļđāļĨ (Encapsulate) āđƒāļ™āđ„āļ—āļ›āđŒāđāļšāļšāļœāļŠāļĄ (composite types) +* āđƒāļŠāđ‰ **immutability** (āļāļēāļĢāđ„āļĄāđˆāđ€āļ›āļĨāļĩāđˆāļĒāļ™āđāļ›āļĨāļ‡āļ„āđˆāļē) āļ”āđ‰āļ§āļĒ readonly āđāļĨāļ° as const +* āļ—āļģāļāļēāļĢāļ•āļĢāļ§āļˆāļŠāļ­āļšāļ„āļ§āļēāļĄāļ–āļđāļāļ•āđ‰āļ­āļ‡āļ‚āļ­āļ‡āļ‚āđ‰āļ­āļĄāļđāļĨ (Validations) āđƒāļ™āļ„āļĨāļēāļŠāļŦāļĢāļ·āļ­ DTOs āđ„āļĄāđˆāđƒāļŠāđˆāļ āļēāļĒāđƒāļ™āļŸāļąāļ‡āļāđŒāļŠāļąāļ™āļ—āļēāļ‡āļ˜āļļāļĢāļāļīāļˆ +* āļ•āļĢāļ§āļˆāļŠāļ­āļšāļ„āļ§āļēāļĄāļ–āļđāļāļ•āđ‰āļ­āļ‡āļ‚āļ­āļ‡āļ‚āđ‰āļ­āļĄāļđāļĨāđ‚āļ”āļĒāđƒāļŠāđ‰ DTOs āļ—āļĩāđˆāļĄāļĩāđ„āļ—āļ›āđŒāļāļģāļŦāļ™āļ”āđ€āļŠāļĄāļ­ + +### 🧰**2.7 āļ„āļĨāļēāļŠ (Classes)** + +* āļ›āļāļīāļšāļąāļ•āļīāļ•āļēāļĄāļŦāļĨāļąāļāļāļēāļĢ **SOLID** +* āļ„āļ§āļĢāđƒāļŠāđ‰ **composition āļĄāļēāļāļāļ§āđˆāļē inheritance** (Prefer composition over inheritance) +* āļāļģāļŦāļ™āļ” **interfaces** āļŠāļģāļŦāļĢāļąāļšāļŠāļąāļāļāļē (contracts) +* āđƒāļŦāđ‰āļ„āļĨāļēāļŠāļĄāļļāđˆāļ‡āđ€āļ™āđ‰āļ™āļāļēāļĢāļ—āļģāļ‡āļēāļ™āđ€āļ‰āļžāļēāļ°āļ­āļĒāđˆāļēāļ‡āđāļĨāļ°āļĄāļĩāļ‚āļ™āļēāļ”āđ€āļĨāđ‡āļ (\< 200 āļšāļĢāļĢāļ—āļąāļ”, \< 10 āđ€āļĄāļ˜āļ­āļ”, \< 10 properties) + +### ðŸšĻ**2.8 āļāļēāļĢāļˆāļąāļ”āļāļēāļĢāļ‚āđ‰āļ­āļœāļīāļ”āļžāļĨāļēāļ” (Error Handling)** + +* āđƒāļŠāđ‰ Exceptions āļŠāļģāļŦāļĢāļąāļšāļ‚āđ‰āļ­āļœāļīāļ”āļžāļĨāļēāļ”āļ—āļĩāđˆāđ„āļĄāđˆāļ„āļēāļ”āļ„āļīāļ” +* āļ”āļąāļāļˆāļąāļš (Catch) āļ‚āđ‰āļ­āļœāļīāļ”āļžāļĨāļēāļ”āđ€āļžāļ·āđˆāļ­āđāļāđ‰āđ„āļ‚āļŦāļĢāļ·āļ­āđ€āļžāļīāđˆāļĄāļšāļĢāļīāļšāļ— (context) āđ€āļ—āđˆāļēāļ™āļąāđ‰āļ™; āļŦāļēāļāđ„āļĄāđˆāđ€āļŠāđˆāļ™āļ™āļąāđ‰āļ™ āđƒāļŦāđ‰āđƒāļŠāđ‰ global error handlers +* āļĢāļ°āļšāļļāļ‚āđ‰āļ­āļ„āļ§āļēāļĄāļ‚āđ‰āļ­āļœāļīāļ”āļžāļĨāļēāļ” (error messages) āļ—āļĩāđˆāļĄāļĩāļ„āļ§āļēāļĄāļŦāļĄāļēāļĒāđ€āļŠāļĄāļ­ + +### 🧊**2.9 āļāļēāļĢāļ—āļ”āļŠāļ­āļš (āļ—āļąāđˆāļ§āđ„āļ›) (Testing (General))** + +* āđƒāļŠāđ‰āļĢāļđāļ›āđāļšāļš **Arrange–Act–Assert** +* āđƒāļŠāđ‰āļŠāļ·āđˆāļ­āļ•āļąāļ§āđāļ›āļĢāđƒāļ™āļāļēāļĢāļ—āļ”āļŠāļ­āļšāļ—āļĩāđˆāļŠāļ·āđˆāļ­āļ„āļ§āļēāļĄāļŦāļĄāļēāļĒ (inputData, expectedOutput) +* āđ€āļ‚āļĩāļĒāļ™ **unit tests** āļŠāļģāļŦāļĢāļąāļš public methods āļ—āļąāđ‰āļ‡āļŦāļĄāļ” +* āļˆāļģāļĨāļ­āļ‡ (Mock) āļāļēāļĢāļžāļķāđˆāļ‡āļžāļēāļ āļēāļĒāļ™āļ­āļ (external dependencies) +* āđ€āļžāļīāđˆāļĄ **acceptance tests** āļ•āđˆāļ­āđ‚āļĄāļ”āļđāļĨāđ‚āļ”āļĒāđƒāļŠāđ‰āļĢāļđāļ›āđāļšāļš Given–When-Then + +### **Testing Strategy āđ‚āļ”āļĒāļĨāļ°āđ€āļ­āļĩāļĒāļ”** + +* **Test Pyramid Structure** + + /\ + / \ E2E Tests (10%) + /____\ Integration Tests (20%) + / \ Unit Tests (70%) +/________\ + +* **Testing Tools Stack** + +```typescript +// Backend Testing Stack +const backendTesting = { + unit: ['Jest', 'ts-jest', '@nestjs/testing'], + integration: ['Supertest', 'Testcontainers', 'Jest'], + e2e: ['Supertest', 'Jest', 'Database Seeds'], + security: ['Jest', 'Custom Security Test Helpers'], + performance: ['Jest', 'autocannon', 'artillery'] +}; + +// Frontend Testing Stack +const frontendTesting = { + unit: ['Vitest', 'React Testing Library'], + integration: ['React Testing Library', 'MSW'], + e2e: ['Playwright', 'Jest'], + visual: ['Playwright', 'Loki'] +}; +``` + +* **Test Data Management** + +```typescript +// Test Data Factories +interface TestDataFactory { + createUser(overrides?: Partial): User; + createCorrespondence(overrides?: Partial): Correspondence; + createRoutingTemplate(overrides?: Partial): RoutingTemplate; +} + +// Test Scenarios +const testScenarios = { + happyPath: 'Normal workflow execution', + edgeCases: 'Boundary conditions and limits', + errorConditions: 'Error handling and recovery', + security: 'Authentication and authorization', + performance: 'Load and stress conditions' +}; +``` + +## 🏗ïļ **3. āđāļšāđ‡āļāđ€āļ­āļ™āļ”āđŒ (NestJS) - Implementation Details** + +### **3.1 āļŦāļĨāļąāļāļāļēāļĢ** + +* **āļŠāļ–āļēāļ›āļąāļ•āļĒāļāļĢāļĢāļĄāđāļšāļšāđ‚āļĄāļ”āļđāļĨāļēāļĢāđŒ (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 + +### **3.2 Database & Data Modeling (MariaDB + TypeORM)** + +#### **3.2.1 Optimistic Locking & Versioning** + +āđ€āļžāļ·āđˆāļ­āļ›āđ‰āļ­āļ‡āļāļąāļ™ Race Condition āđƒāļ™āļāļēāļĢāđāļāđ‰āđ„āļ‚āļ‚āđ‰āļ­āļĄāļđāļĨāļžāļĢāđ‰āļ­āļĄāļāļąāļ™ (āđ‚āļ”āļĒāđ€āļ‰āļžāļēāļ°āļāļēāļĢāļĢāļąāļ™āđ€āļĨāļ‚āļ—āļĩāđˆāđ€āļ­āļāļŠāļēāļĢ) āđƒāļŦāđ‰āđ€āļžāļīāđˆāļĄ Column `@VersionColumn()` āđƒāļ™ Entity āļ—āļĩāđˆāļŠāļģāļ„āļąāļ + +```typescript +@Entity() +export class DocumentCounter { + // ... fields + @Column() + last_number: number; + + @VersionColumn() // āđ€āļžāļīāđˆāļĄ Versioning + version: number; +} +``` + +#### **3.2.2 Virtual Columns for JSON Performance** + +āđ€āļ™āļ·āđˆāļ­āļ‡āļˆāļēāļāđ€āļĢāļēāđƒāļŠāđ‰ MariaDB 10.11 āđāļĨāļ°āļĄāļĩāļāļēāļĢāđ€āļāđ‡āļšāļ‚āđ‰āļ­āļĄāļđāļĨ JSON (Details) āđƒāļŦāđ‰āđƒāļŠāđ‰ **Generated Columns (Virtual)** āļŠāļģāļŦāļĢāļąāļš Field āļ—āļĩāđˆāļ•āđ‰āļ­āļ‡ Search/Sort āļšāđˆāļ­āļĒāđ† āđāļĨāļ°āļ—āļģ Index āļšāļ™ Virtual Column āļ™āļąāđ‰āļ™ + +```sql +-- āļ•āļąāļ§āļ­āļĒāđˆāļēāļ‡ SQL Migration +ALTER TABLE correspondence_revisions +ADD COLUMN ref_project_id INT GENERATED ALWAYS AS (JSON_UNQUOTE(JSON_EXTRACT(details, '$.projectId'))) VIRTUAL; +CREATE INDEX idx_ref_project_id ON correspondence_revisions(ref_project_id); +``` + +#### **3.2.3 Partitioning Strategy** + +āļŠāļģāļŦāļĢāļąāļšāļ•āļēāļĢāļēāļ‡ `audit_logs` āđāļĨāļ° `notifications` āđƒāļŦāđ‰āđ€āļ•āļĢāļĩāļĒāļĄāļ­āļ­āļāđāļšāļš Entity āđƒāļŦāđ‰āļĢāļ­āļ‡āļĢāļąāļš Partitioning (āđ€āļŠāđˆāļ™ āđāļĒāļāļ•āļēāļĄāļ›āļĩ) āđ‚āļ”āļĒāđƒāļŠāđ‰ Raw SQL Migration āđƒāļ™āļāļēāļĢāļŠāļĢāđ‰āļēāļ‡āļ•āļēāļĢāļēāļ‡ + +### **3.3 File Storage Service (Two-Phase Storage)** + +āļ›āļĢāļąāļšāļ›āļĢāļļāļ‡ Service āļˆāļąāļ”āļāļēāļĢāđ„āļŸāļĨāđŒāđƒāļŦāđ‰āļĢāļ­āļ‡āļĢāļąāļš Transactional Integrity + +1. **Upload (Phase 1):** + * āļĢāļąāļšāđ„āļŸāļĨāđŒ → Scan Virus (ClamAV) → Save āļĨāļ‡āđ‚āļŸāļĨāđ€āļ”āļ­āļĢāđŒ `temp/` + * Return `temp_id` āđāļĨāļ° Metadata āļāļĨāļąāļšāđ„āļ›āđƒāļŦāđ‰ Client +2. **Commit (Phase 2):** + * āđ€āļĄāļ·āđˆāļ­ Business Logic (āđ€āļŠāđˆāļ™ Create Correspondence) āļ—āļģāļ‡āļēāļ™āļŠāļģāđ€āļĢāđ‡āļˆ + * Service āļˆāļ°āļĒāđ‰āļēāļĒāđ„āļŸāļĨāđŒāļˆāļēāļ `temp/` āđ„āļ›āļĒāļąāļ‡ `permanent/{YYYY}/{MM}/` + * Update path āđƒāļ™ Database + * āļ—āļąāđ‰āļ‡āļŦāļĄāļ”āļ™āļĩāđ‰āļ•āđ‰āļ­āļ‡āļ­āļĒāļđāđˆāļ āļēāļĒāđƒāļ•āđ‰ Database Transaction āđ€āļ”āļĩāļĒāļ§āļāļąāļ™ (āļ–āđ‰āļē DB Fail, āđ„āļŸāļĨāđŒāļˆāļ°āļ„āđ‰āļēāļ‡āļ—āļĩāđˆ Temp āđāļĨāļ°āļ–āļđāļāļĨāļšāđ‚āļ”āļĒ Cron Job) + +### **3.4 Document Numbering (Double-Lock Mechanism)** + +āļāļēāļĢāļ­āļ­āļāđ€āļĨāļ‚āļ—āļĩāđˆāđ€āļ­āļāļŠāļēāļĢāļ•āđ‰āļ­āļ‡āđƒāļŠāđ‰āļāļĨāđ„āļāļ„āļ§āļēāļĄāļ›āļĨāļ­āļ”āļ āļąāļĒ 2 āļŠāļąāđ‰āļ™: + +1. **Layer 1 (Redis Lock):** āđƒāļŠāđ‰ `redlock` āđ€āļžāļ·āđˆāļ­ Block āđ„āļĄāđˆāđƒāļŦāđ‰ Process āļ­āļ·āđˆāļ™āđ€āļ‚āđ‰āļēāļĄāļēāļĒāļļāđˆāļ‡āļāļąāļš Counter āļ‚āļ­āļ‡ Project/Type āļ™āļąāđ‰āļ™āđ† āļŠāļąāđˆāļ§āļ„āļĢāļēāļ§ +2. **Layer 2 (Optimistic Lock):** āļ•āļ­āļ™ Update Database āđƒāļŦāđ‰āđ€āļŠāđ‡āļ„ `version` āļ–āđ‰āļē version āđ€āļ›āļĨāļĩāđˆāļĒāļ™ (āđāļŠāļ”āļ‡āļ§āđˆāļē Redis Lock āļŦāļĨāļļāļ”āļŦāļĢāļ·āļ­āļĄāļĩāļ„āļ™āđāļ—āļĢāļ) āđƒāļŦāđ‰ Throw Error āđāļĨāļ° Retry āđƒāļŦāļĄāđˆ + +### **3.5 Unified Workflow Engine** + +āļŦāđ‰āļēāļĄāđāļĒāļ Logic āļĢāļ°āļŦāļ§āđˆāļēāļ‡ `CorrespondenceRouting` āđāļĨāļ° `RfaWorkflow` āļ­āļ­āļāļˆāļēāļāļāļąāļ™āđ€āļ”āđ‡āļ”āļ‚āļēāļ” āđƒāļŦāđ‰āļŠāļĢāđ‰āļēāļ‡ `WorkflowEngineService` āļ—āļĩāđˆāđ€āļ›āđ‡āļ™ Generic: + +* **Input:** `currentState`, `action`, `rules (Guard)` +* **Output:** `nextState`, `assignee` +* āļĢāļ­āļ‡āļĢāļąāļšāļ—āļąāđ‰āļ‡ Linear Flow (Routing) āđāļĨāļ° Complex Flow (RFA) āļœāđˆāļēāļ™ Configuration + +### **3.6 āļŸāļąāļ‡āļāđŒāļŠāļąāļ™āļŦāļĨāļąāļ (Core Functionalities)** + +* Global **filters** āļŠāļģāļŦāļĢāļąāļšāļāļēāļĢāļˆāļąāļ”āļāļēāļĢ exception +* **Middlewares** āļŠāļģāļŦāļĢāļąāļšāļāļēāļĢāļˆāļąāļ”āļāļēāļĢ request +* **Guards** āļŠāļģāļŦāļĢāļąāļšāļāļēāļĢāļ­āļ™āļļāļāļēāļ• (permissions) āđāļĨāļ° RBAC +* **Interceptors** āļŠāļģāļŦāļĢāļąāļšāļāļēāļĢāđāļ›āļĨāļ‡āļ‚āđ‰āļ­āļĄāļđāļĨ response āđāļĨāļ°āļāļēāļĢāļšāļąāļ™āļ—āļķāļ log + +### **3.7 āļ‚āđ‰āļ­āļˆāļģāļāļąāļ”āđƒāļ™āļāļēāļĢ 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] + +### **3.8 āļ‚āđ‰āļ­āļˆāļģāļāļąāļ”āļ”āđ‰āļēāļ™āļ„āļ§āļēāļĄāļ›āļĨāļ­āļ”āļ āļąāļĒ (Security Constraints):** + +* **File Upload Security:** āļ•āđ‰āļ­āļ‡āļĄāļĩ virus scanning (ClamAV), file type validation (white-list), āđāļĨāļ° file size limits (50MB) +* **Input Validation:** āļ•āđ‰āļ­āļ‡āļ›āđ‰āļ­āļ‡āļāļąāļ™ OWASP Top 10 vulnerabilities (SQL Injection, XSS, CSRF) +* **Rate Limiting:** āļ•āđ‰āļ­āļ‡ implement rate limiting āļ•āļēāļĄ strategy āļ—āļĩāđˆāļāļģāļŦāļ™āļ” +* **Secrets Management:** āļ•āđ‰āļ­āļ‡āļĄāļĩ mechanism āļŠāļģāļŦāļĢāļąāļšāļˆāļąāļ”āļāļēāļĢ sensitive secrets āļ­āļĒāđˆāļēāļ‡āļ›āļĨāļ­āļ”āļ āļąāļĒ āđāļĄāđ‰āļˆāļ°āđƒāļŠāđ‰ docker-compose.yml + +### **3.9 āđ‚āļ„āļĢāļ‡āļŠāļĢāđ‰āļēāļ‡āđ‚āļĄāļ”āļđāļĨāļ•āļēāļĄāđ‚āļ”āđ€āļĄāļ™ (Domain-Driven Module Structure)** + +āđ€āļžāļ·āđˆāļ­āđƒāļŦāđ‰āļŠāļ­āļ”āļ„āļĨāđ‰āļ­āļ‡āļāļąāļšāļŠāļ„āļĩāļĄāļē SQL (LCBP3-DMS) āđ€āļĢāļēāļˆāļ°āđƒāļŠāđ‰āđ‚āļ„āļĢāļ‡āļŠāļĢāđ‰āļēāļ‡āđ‚āļĄāļ”āļđāļĨāđāļšāļš **Domain-Driven (āđāļšāđˆāļ‡āļ•āļēāļĄāļ‚āļ­āļšāđ€āļ‚āļ•āļ˜āļļāļĢāļāļīāļˆ)** āđāļ—āļ™āļāļēāļĢāđāļšāđˆāļ‡āļ•āļēāļĄāļŸāļąāļ‡āļāđŒāļŠāļąāļ™: + +#### 3.9.1 **CommonModule:** + +* āđ€āļāđ‡āļš Services āļ—āļĩāđˆāđƒāļŠāđ‰āļĢāđˆāļ§āļĄāļāļąāļ™ āđ€āļŠāđˆāļ™ DatabaseModule, FileStorageService (āļˆāļąāļ”āļāļēāļĢāđ„āļŸāļĨāđŒāđƒāļ™ QNAP), AuditLogService, NotificationService +* āļˆāļąāļ”āļāļēāļĢ audit_logs +* NotificationService āļ•āđ‰āļ­āļ‡āļĢāļ­āļ‡āļĢāļąāļš Triggers āļ—āļĩāđˆāļĢāļ°āļšāļļāđƒāļ™ Requirement 6.7 [cite: 6.7] + +#### 3.9.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.9.3 **UserModule:** + +* āļˆāļąāļ”āļāļēāļĢ users, roles, permissions, global_default_roles, role_permissions, user_roles, user_project_roles +* **(āļŠāļģāļ„āļąāļ)** āļ•āđ‰āļ­āļ‡āļĄāļĩ API āļŠāļģāļŦāļĢāļąāļš **Admin Panel** āđ€āļžāļ·āđˆāļ­: + * āļŠāļĢāđ‰āļēāļ‡āđāļĨāļ°āļˆāļąāļ”āļāļēāļĢ Role āđāļĨāļ°āļāļēāļĢāļˆāļąāļšāļ„āļđāđˆ Permission āđāļšāļšāđ„āļ”āļ™āļēāļĄāļīāļ [cite: 4.3] + +#### 3.9.4 **ProjectModule:** + +* āļˆāļąāļ”āļāļēāļĢ projects, organizations, contracts, project_parties, contract_parties + +#### 3.9.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] + +#### 3.9.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) āļŠāļģāļŦāļĢāļąāļšāļāļēāļĢāļŠāđˆāļ‡āļ•āđˆāļ­āđ€āļ­āļāļŠāļēāļĢāļ—āļąāđˆāļ§āđ„āļ›āļĢāļ°āļŦāļ§āđˆāļēāļ‡āļ­āļ‡āļ„āđŒāļāļĢ + +#### 3.9.7 **RfaModule:** + +* āļˆāļąāļ”āļāļēāļĢ rfas, rfa_revisions, rfa_items +* āļĢāļąāļšāļœāļīāļ”āļŠāļ­āļšāđ€āļ§āļīāļĢāđŒāļāđ‚āļŸāļĨāļ§āđŒ **"RFA Workflows"** (rfa_workflows, rfa_workflow_templates, rfa_workflow_template_steps, rfa_status_transitions) āļŠāļģāļŦāļĢāļąāļšāļāļēāļĢāļ­āļ™āļļāļĄāļąāļ•āļīāđ€āļ­āļāļŠāļēāļĢāļ—āļēāļ‡āđ€āļ—āļ„āļ™āļīāļ„ + +#### 3.9.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(āļ•āļēāļĢāļēāļ‡āđ€āļŠāļ·āđˆāļ­āļĄāđ„āļŸāļĨāđŒāđāļ™āļš) + +#### 3.9.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)āļŠāļģāļŦāļĢāļąāļšāļāļēāļĢāđ€āļ§āļĩāļĒāļ™āđ€āļ­āļāļŠāļēāļĢ **āļ āļēāļĒāđƒāļ™āļ­āļ‡āļ„āđŒāļāļĢ** + +#### 3.9.10 **TransmittalModule:** + +* āļˆāļąāļ”āļāļēāļĢ transmittals āđāļĨāļ° transmittal_items + +#### 3.9.11 **SearchModule:** + +* āđƒāļŦāđ‰āļšāļĢāļīāļāļēāļĢāļ„āđ‰āļ™āļŦāļēāļ‚āļąāđ‰āļ™āļŠāļđāļ‡ (Advanced Search) [cite: 6.2] āđ‚āļ”āļĒāđƒāļŠāđ‰ **Elasticsearch** āđ€āļžāļ·āđˆāļ­āļĢāļ­āļ‡āļĢāļąāļšāļāļēāļĢāļ„āđ‰āļ™āļŦāļēāđāļšāļš Full-text āļˆāļēāļāļŠāļ·āđˆāļ­āđ€āļĢāļ·āđˆāļ­āļ‡, āļĢāļēāļĒāļĨāļ°āđ€āļ­āļĩāļĒāļ”, āđ€āļĨāļ‚āļ—āļĩāđˆāđ€āļ­āļāļŠāļēāļĢ, āļ›āļĢāļ°āđ€āļ āļ—, āļ§āļąāļ™āļ—āļĩāđˆ, āđāļĨāļ° Tags +* āļĢāļ°āļšāļšāļˆāļ°āđƒāļŠāđ‰ Elasticsearch Engine āđƒāļ™āļāļēāļĢāļˆāļąāļ”āļ—āļģāļ”āļąāļŠāļ™āļĩāđ€āļžāļ·āđˆāļ­āļāļēāļĢāļ„āđ‰āļ™āļŦāļēāļ‚āđ‰āļ­āļĄāļđāļĨāđ€āļŠāļīāļ‡āļĨāļķāļāļˆāļēāļāđ€āļ™āļ·āđ‰āļ­āļŦāļēāļ‚āļ­āļ‡āđ€āļ­āļāļŠāļēāļĢ āđ‚āļ”āļĒāļ‚āđ‰āļ­āļĄāļđāļĨāļˆāļ°āļ–āļđāļāļŠāđˆāļ‡āđ„āļ›āļ—āļģāļ”āļąāļŠāļ™āļĩāļˆāļēāļ Backend (NestJS) āļ—āļļāļāļ„āļĢāļąāđ‰āļ‡āļ—āļĩāđˆāļĄāļĩāļāļēāļĢāļŠāļĢāđ‰āļēāļ‡āļŦāļĢāļ·āļ­āđāļāđ‰āđ„āļ‚āđ€āļ­āļāļŠāļēāļĢ + +#### 3.9.12 **DocumentNumberingModule:** + +* **āļŠāļ–āļēāļ™āļ°:** āđ€āļ›āđ‡āļ™ Module āļ āļēāļĒāđƒāļ™ (Internal Module) āđ„āļĄāđˆāđ€āļ›āļīāļ” API āļŠāļđāđˆāļ āļēāļĒāļ™āļ­āļ +* **āļŦāļ™āđ‰āļēāļ—āļĩāđˆ:** āđƒāļŦāđ‰āļšāļĢāļīāļāļēāļĢ `DocumentNumberingService` āđāļšāļš **Token-Based Generator** +* **Logic āđƒāļŦāļĄāđˆ (v1.4.4):** + * āļĢāļąāļš Context: `{ projectId, orgId, typeId, disciplineId?, subTypeId?, year }` + * āļ”āļķāļ‡ Template āļˆāļēāļ DB + * Parse Template āđ€āļžāļ·āđˆāļ­āļŦāļēāļ§āđˆāļēāļ•āđ‰āļ­āļ‡āđƒāļŠāđ‰ Key āđƒāļ”āļšāđ‰āļēāļ‡āđƒāļ™āļāļēāļĢāļ—āļģ Grouping Counter (āđ€āļŠāđˆāļ™ āļ–āđ‰āļē Template āļĄāļĩ `{DISCIPLINE}` āđƒāļŦāđ‰āđƒāļŠāđ‰ `discipline_id` āđƒāļ™āļāļēāļĢ query counter) + * āđƒāļŠāđ‰ **Double-Lock Mechanism** (Redis + Optimistic DB Lock) āđƒāļ™āļāļēāļĢāļ”āļķāļ‡āđāļĨāļ°āļ­āļąāļžāđ€āļ”āļ—āļ„āđˆāļē `last_number` +* **Features:** + * Application-level locking āđ€āļžāļ·āđˆāļ­āļ›āđ‰āļ­āļ‡āļāļąāļ™ race condition + * Retry mechanism āļ”āđ‰āļ§āļĒ exponential backoff + * Fallback mechanism āđ€āļĄāļ·āđˆāļ­āļāļēāļĢāļ‚āļ­āđ€āļĨāļ‚āļĨāđ‰āļĄāđ€āļŦāļĨāļ§ + * Audit log āļ—āļļāļāļ„āļĢāļąāđ‰āļ‡āļ—āļĩāđˆāļĄāļĩāļāļēāļĢ generate āđ€āļĨāļ‚āļ—āļĩāđˆāđ€āļ­āļāļŠāļēāļĢāđƒāļŦāļĄāđˆ + +#### 3.9.13 **CorrespondenceRoutingModule:** + +* **āļŠāļ–āļēāļ™āļ°:** āđ‚āļĄāļ”āļđāļĨāļŦāļĨāļąāļāļŠāļģāļŦāļĢāļąāļšāļˆāļąāļ”āļāļēāļĢāļāļēāļĢāļŠāđˆāļ‡āļ•āđˆāļ­āđ€āļ­āļāļŠāļēāļĢ +* **āļŦāļ™āđ‰āļēāļ—āļĩāđˆ:** āļˆāļąāļ”āļāļēāļĢāđāļĄāđˆāđāļšāļšāļāļēāļĢāļŠāđˆāļ‡āļ•āđˆāļ­āđāļĨāļ°āļāļēāļĢāļŠāđˆāļ‡āļ•āđˆāļ­āļˆāļĢāļīāļ‡ +* **Entities:** + * CorrespondenceRoutingTemplate + * CorrespondenceRoutingTemplateStep + * CorrespondenceRouting +* **Features:** + * āļŠāļĢāđ‰āļēāļ‡āđāļĨāļ°āļˆāļąāļ”āļāļēāļĢāđāļĄāđˆāđāļšāļšāļāļēāļĢāļŠāđˆāļ‡āļ•āđˆāļ­ + * āļ”āļģāđ€āļ™āļīāļ™āļāļēāļĢāļŠāđˆāļ‡āļ•āđˆāļ­āđ€āļ­āļāļŠāļēāļĢāļ•āļēāļĄāđāļĄāđˆāđāļšāļš + * āļ•āļīāļ”āļ•āļēāļĄāļŠāļ–āļēāļ™āļ°āļāļēāļĢāļŠāđˆāļ‡āļ•āđˆāļ­ + * āļ„āļģāļ™āļ§āļ“āļ§āļąāļ™āļ„āļĢāļšāļāļģāļŦāļ™āļ”āļ­āļąāļ•āđ‚āļ™āļĄāļąāļ•āļī + * āļŠāđˆāļ‡āļāļēāļĢāđāļˆāđ‰āļ‡āđ€āļ•āļ·āļ­āļ™āđ€āļĄāļ·āđˆāļ­āļĄāļĩāļāļēāļĢāļŠāđˆāļ‡āļ•āđˆāļ­āđƒāļŦāļĄāđˆ + +#### 3.9.14 **WorkflowEngineModule:** + +* **āļŠāļ–āļēāļ™āļ°:** Internal Module āļŠāļģāļŦāļĢāļąāļšāļˆāļąāļ”āļāļēāļĢ workflow logic +* **āļŦāļ™āđ‰āļēāļ—āļĩāđˆ:** āļ›āļĢāļ°āļĄāļ§āļĨāļœāļĨ state transitions āđāļĨāļ° business rules +* **Features:** + * State machine āļŠāļģāļŦāļĢāļąāļšāļŠāļ–āļēāļ™āļ°āđ€āļ­āļāļŠāļēāļĢ + * Validation rules āļŠāļģāļŦāļĢāļąāļšāļāļēāļĢāđ€āļ›āļĨāļĩāđˆāļĒāļ™āļŠāļ–āļēāļ™āļ° + * Automatic status updates + * Deadline management āđāļĨāļ° escalation + +#### 3.9.15 **JsonSchemaModule:** + +* **āļŠāļ–āļēāļ™āļ°:** Internal Module āļŠāļģāļŦāļĢāļąāļšāļˆāļąāļ”āļāļēāļĢ JSON schemas +* **āļŦāļ™āđ‰āļēāļ—āļĩāđˆ:** Validate, transform, āđāļĨāļ° manage JSON data structures +* **Features:** + * JSON schema validation āļ”āđ‰āļ§āļĒ AJV + * Schema versioning āđāļĨāļ° migration + * Dynamic schema generation + * Data transformation āđāļĨāļ° sanitization + +#### 3.9.16 **DetailsService:** + +* **āļŠāļ–āļēāļ™āļ°:** Shared Service āļŠāļģāļŦāļĢāļąāļšāļˆāļąāļ”āļāļēāļĢ details fields +* **āļŦāļ™āđ‰āļēāļ—āļĩāđˆ:** Centralized service āļŠāļģāļŦāļĢāļąāļš JSON details operations +* **Methods:** + * validateDetails(type: string, data: any): ValidationResult + * transformDetails(input: any, targetVersion: string): any + * sanitizeDetails(data: any): any + * getDefaultDetails(type: string): any + +### **3.10 āļŠāļ–āļēāļ›āļąāļ•āļĒāļāļĢāļĢāļĄāļĢāļ°āļšāļš (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 (Virus Scanning, Security) +│ ├── 📁 guards # Custom Guards (RBAC Guard, RateLimitGuard) +│ ├── 📁 interceptors # Interceptors (Audit Log, Transform, Performance) +│ ├── 📁 resilience # Circuit Breaker, Retry Patterns +│ └── 📁 services # Shared Services (NotificationService, CachingService) +├── 📁 modules +│ ├── 📁 user # UserModule (āļˆāļąāļ”āļāļēāļĢ Users, Roles, Permissions) +│ ├── 📁 project # ProjectModule (āļˆāļąāļ”āļāļēāļĢ Projects, Organizations, Contracts) +│ ├── 📁 correspondence # CorrespondenceModule (āļˆāļąāļ”āļāļēāļĢāđ€āļ­āļāļŠāļēāļĢāđ‚āļ•āđ‰āļ•āļ­āļš) +│ ├── 📁 rfa # RfaModule (āļˆāļąāļ”āļāļēāļĢāđ€āļ­āļāļŠāļēāļĢāļ‚āļ­āļ­āļ™āļļāļĄāļąāļ•āļī) +│ ├── 📁 drawing # DrawingModule (āļˆāļąāļ”āļāļēāļĢāđāļšāļšāđāļ›āļĨāļ™) +│ ├── 📁 circulation # CirculationModule (āļˆāļąāļ”āļāļēāļĢāđƒāļšāđ€āļ§āļĩāļĒāļ™) +│ ├── 📁 transmittal # TransmittalModule (āļˆāļąāļ”āļāļēāļĢāđ€āļ­āļāļŠāļēāļĢāļ™āļģāļŠāđˆāļ‡) +│ ├── 📁 search # SearchModule (āļ„āđ‰āļ™āļŦāļēāļ‚āļąāđ‰āļ™āļŠāļđāļ‡āļ”āđ‰āļ§āļĒ Elasticsearch) +│ ├── 📁 monitoring # MonitoringModule (Metrics, Health Checks) +│ └── 📁 document-numbering # DocumentNumberingModule (Internal Module) +└── 📁 database # Database Migration & Seeding Scripts +``` + +### **3.11 āļāļĨāļĒāļļāļ—āļ˜āđŒāļ„āļ§āļēāļĄāļ—āļ™āļ—āļēāļ™āđāļĨāļ°āļāļēāļĢāļˆāļąāļ”āļāļēāļĢāļ‚āđ‰āļ­āļœāļīāļ”āļžāļĨāļēāļ” (Resilience & Error Handling Strategy)** + +* **Circuit Breaker Pattern:** āđƒāļŠāđ‰āļŠāļģāļŦāļĢāļąāļš external service calls (Email, LINE, Elasticsearch) +* **Retry Mechanism:** āļ”āđ‰āļ§āļĒ exponential backoff āļŠāļģāļŦāļĢāļąāļš transient failures +* **Fallback Strategies:** Graceful degradation āđ€āļĄāļ·āđˆāļ­āļšāļĢāļīāļāļēāļĢāļ āļēāļĒāļ™āļ­āļāļĨāđ‰āļĄāđ€āļŦāļĨāļ§ +* **Error Handling:** Error messages āļ•āđ‰āļ­āļ‡āđ„āļĄāđˆāđ€āļ›āļīāļ”āđ€āļœāļĒāļ‚āđ‰āļ­āļĄāļđāļĨ sensitive +* **Monitoring:** Centralized error monitoring āđāļĨāļ° alerting system + +### **3.12 FileStorageService (āļ›āļĢāļąāļšāļ›āļĢāļļāļ‡āđƒāļŦāļĄāđˆ):** + +* **Virus Scanning:** Integrate ClamAV āļŠāļģāļŦāļĢāļąāļš scan āđ„āļŸāļĨāđŒāļ—āļĩāđˆāļ­āļąāļ›āđ‚āļŦāļĨāļ”āļ—āļąāđ‰āļ‡āļŦāļĄāļ” +* **File Type Validation:** āđƒāļŠāđ‰ white-list approach (PDF, DWG, DOCX, XLSX, ZIP) +* **File Size Limits:** 50MB āļ•āđˆāļ­āđ„āļŸāļĨāđŒ +* **Security Measures:** + * āđ€āļāđ‡āļšāđ„āļŸāļĨāđŒāļ™āļ­āļ web root + * Download āļœāđˆāļēāļ™ authenticated endpoint āđ€āļ—āđˆāļēāļ™āļąāđ‰āļ™ + * Download links āļĄāļĩ expiration time (24 āļŠāļąāđˆāļ§āđ‚āļĄāļ‡) + * File integrity checks (checksum) + * Access control checks āļāđˆāļ­āļ™āļ”āļēāļ§āļ™āđŒāđ‚āļŦāļĨāļ” + +### **3.13 āđ€āđ€āļ—āļ„āđ‚āļ™āđ‚āļĨāļĒāļĩāļ—āļĩāđˆāđƒāļŠāđ‰ (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 | +| **Resilience** | `@nestjs/circuit-breaker` | 🔄 Circuit breaker pattern | +| **Caching** | `@nestjs/cache-manager`, `cache-manager-redis-store` | ðŸ’ū Distributed caching | +| **Security** | `helmet`, `csurf`, `rate-limiter-flexible` | ðŸ›Ąïļ Security enhancements | +| **Validation** | `class-validator`, `class-transformer` | ✅ Input validation | +| **Monitoring** | `@nestjs/monitoring`, `winston` | 📊 Application monitoring | +| **File Processing** | `clamscan` | ðŸĶ  Virus scanning | +| **Cryptography** | `bcrypt`, `crypto` | 🔐 Password hashing āđāļĨāļ° checksums | +| **JSON Validation** | `ajv`, `ajv-formats` | ðŸŽŊ JSON schema validation | +| **JSON Processing** | `jsonpath`, `json-schema-ref-parser` | 🔧 JSON manipulation | +| **Data Transformation** | `class-transformer` | 🔄 Object transformation | +| **Compression** | `compression` | ðŸ“Ķ JSON compression | + +### **3.14 Security Testing:** + +* **Penetration Testing:** āļ—āļ”āļŠāļ­āļš OWASP Top 10 vulnerabilities +* **Security Audit:** Review code āļŠāļģāļŦāļĢāļąāļš security flaws +* **Virus Scanning Test:** āļ—āļ”āļŠāļ­āļš file upload security +* **Rate Limiting Test:** āļ—āļ”āļŠāļ­āļš rate limiting functionality + +### **3.15 Performance Testing:** + +* **Load Testing:** āļ—āļ”āļŠāļ­āļšāļ”āđ‰āļ§āļĒ realistic workloads +* **Stress Testing:** āļŦāļē breaking points āļ‚āļ­āļ‡āļĢāļ°āļšāļš +* **Endurance Testing:** āļ—āļ”āļŠāļ­āļšāļāļēāļĢāļ—āļģāļ‡āļēāļ™āļ•āđˆāļ­āđ€āļ™āļ·āđˆāļ­āļ‡āđ€āļ›āđ‡āļ™āđ€āļ§āļĨāļēāļ™āļēāļ™ + +### 🗄ïļ**3.16 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 + +### **3.17 Caching Strategy (āļ•āļēāļĄāļ‚āđ‰āļ­ 6.4.2):** + +* **Master Data Cache:** Roles, Permissions, Organizations (TTL: 1 hour) +* **User Session Cache:** User permissions āđāļĨāļ° profile (TTL: 30 minutes) +* **Search Result Cache:** Frequently searched queries (TTL: 15 minutes) +* **File Metadata Cache:** Attachment metadata (TTL: 1 hour) +* **Cache Invalidation:** Clear cache on update/delete operations + +### **3.18 āļāļēāļĢāđ„āļŦāļĨāļ‚āļ­āļ‡āļ‚āđ‰āļ­āļĄāļđāļĨ (Data Flow)** + +#### **3.18.1 Main Flow:** + + 1. Request: āļœāđˆāļēāļ™ Nginx Proxy Manager -> NestJS Controller + 2. **Rate Limiting:** RateLimitGuard āļ•āļĢāļ§āļˆāļŠāļ­āļš request limits + 3. **Input Validation:** Validation Pipe āļ•āļĢāļ§āļˆāļŠāļ­āļšāđāļĨāļ° sanitize inputs + 4. Authentication: JWT Guard āļ•āļĢāļ§āļˆāļŠāļ­āļš Token āđāļĨāļ°āļ”āļķāļ‡āļ‚āđ‰āļ­āļĄāļđāļĨ User + 5. Authorization: RBAC Guard āļ•āļĢāļ§āļˆāļŠāļ­āļšāļŠāļīāļ—āļ˜āļīāđŒ + 6. **Security Checks:** Virus scanning (āļŠāļģāļŦāļĢāļąāļš file upload), XSS protection + 7. Business Logic: Service Layer āļ›āļĢāļ°āļĄāļ§āļĨāļœāļĨāļ•āļĢāļĢāļāļ°āļ—āļēāļ‡āļ˜āļļāļĢāļāļīāļˆ + 8. **Resilience:** Circuit breaker āđāļĨāļ° retry logic āļŠāļģāļŦāļĢāļąāļš external calls + 9. Data Access: Repository Layer āļ•āļīāļ”āļ•āđˆāļ­āļāļąāļšāļāļēāļ™āļ‚āđ‰āļ­āļĄāļđāļĨ + 10. **Caching:** Cache frequently accessed data + 11. **Audit Log:** āļšāļąāļ™āļ—āļķāļāļāļēāļĢāļāļĢāļ°āļ—āļģāļŠāļģāļ„āļąāļ + 12. Response: āļŠāđˆāļ‡āļāļĨāļąāļšāđ„āļ›āļĒāļąāļ‡ Frontend + +#### **3.18.2 Workflow Data Flow:** + + 1. User āļŠāļĢāđ‰āļēāļ‡āđ€āļ­āļāļŠāļēāļĢ â†’ āđ€āļĨāļ·āļ­āļ routing template + 2. System āļŠāļĢāđ‰āļēāļ‡ routing instances āļ•āļēāļĄ template + 3. āļŠāļģāļŦāļĢāļąāļšāđāļ•āđˆāļĨāļ° routing step: + - āļāļģāļŦāļ™āļ” due date (āļˆāļēāļ expected_days) + - āļŠāđˆāļ‡ notification āđ„āļ›āļĒāļąāļ‡āļ­āļ‡āļ„āđŒāļāļĢāļœāļđāđ‰āļĢāļąāļš + - āļ­āļąāļžāđ€āļ”āļ—āļŠāļ–āļēāļ™āļ°āđ€āļ›āđ‡āļ™ SENT + 4. āđ€āļĄāļ·āđˆāļ­āļ­āļ‡āļ„āđŒāļāļĢāļœāļđāđ‰āļĢāļąāļšāļ”āļģāđ€āļ™āļīāļ™āļāļēāļĢ: + - āļ­āļąāļžāđ€āļ”āļ—āļŠāļ–āļēāļ™āļ°āđ€āļ›āđ‡āļ™ ACTIONED/FORWARDED/REPLIED + - āļšāļąāļ™āļ—āļķāļ processed_by āđāļĨāļ° processed_at + - āļŠāđˆāļ‡ notification āđ„āļ›āļĒāļąāļ‡āļ‚āļąāđ‰āļ™āļ•āļ­āļ™āļ•āđˆāļ­āđ„āļ› (āļ–āđ‰āļēāļĄāļĩ) + 5. āđ€āļĄāļ·āđˆāļ­āļ„āļĢāļšāļ—āļļāļāļ‚āļąāđ‰āļ™āļ•āļ­āļ™ â†’ āļ­āļąāļžāđ€āļ”āļ—āļŠāļ–āļēāļ™āļ°āđ€āļ­āļāļŠāļēāļĢāđ€āļ›āđ‡āļ™ COMPLETED + +#### **3.18.3 JSON Details Processing Flow:** + + 1. **Receive Request** → Get JSON data from client + 2. **Schema Validation** → Validate against predefined schema + 3. **Data Sanitization** → Sanitize and transform data + 4. **Version Check** → Handle schema version compatibility + 5. **Storage** → Store validated JSON in database + 6. **Retrieval** → Retrieve and transform on demand + +### 📊**3.19 Monitoring & Observability (āļ•āļēāļĄāļ‚āđ‰āļ­ 6.8)** + +#### **Application Monitoring:** + +* **Health Checks:** `/health` endpoint āļŠāļģāļŦāļĢāļąāļš load balancer +* **Metrics Collection:** Response times, error rates, throughput +* **Distributed Tracing:** āļŠāļģāļŦāļĢāļąāļš request tracing across services +* **Log Aggregation:** Structured logging āļ”āđ‰āļ§āļĒ JSON format +* **Alerting:** āļŠāļģāļŦāļĢāļąāļš critical errors āđāļĨāļ° performance degradation + +#### **Business Metrics:** + +* āļˆāļģāļ™āļ§āļ™ documents created āļ•āđˆāļ­āļ§āļąāļ™ +* Workflow completion rates +* User activity metrics +* System utilization rates +* Search query performance + +#### **Performance Targets:** + +* API Response Time: < 200ms (90th percentile) +* Search Query Performance: < 500ms +* File Upload Performance: < 30 seconds āļŠāļģāļŦāļĢāļąāļšāđ„āļŸāļĨāđŒ 50MB +* Cache Hit Ratio: > 80% + +## ðŸ–Ĩïļ **4. āļŸāļĢāļ­āļ™āļ•āđŒāđ€āļ­āļ™āļ”āđŒ (Next.js) - Implementation Details** + +**āđ‚āļ›āļĢāđ„āļŸāļĨāđŒāļ™āļąāļāļžāļąāļ’āļ™āļē (Developer Profile:** āļ§āļīāļĻāļ§āļāļĢ TypeScript + React/NextJS āļĢāļ°āļ”āļąāļš Senior +āđ€āļŠāļĩāđˆāļĒāļ§āļŠāļēāļ TailwindCSS, Shadcn/UI, āđāļĨāļ° Radix āļŠāļģāļŦāļĢāļąāļšāļāļēāļĢāļžāļąāļ’āļ™āļē UI + +### **4.1 State Management & Offline Support** + +#### **4.1.1 Auto-Save Drafts** + +āđƒāļŠāđ‰ `zustand` āļĢāđˆāļ§āļĄāļāļąāļš middleware `persist` (āļĨāļ‡ LocalStorage) āļŠāļģāļŦāļĢāļąāļšāļŸāļ­āļĢāđŒāļĄāļ—āļĩāđˆāļĄāļĩāļ‚āļ™āļēāļ”āđƒāļŦāļāđˆ (RFA, Correspondence) āđ€āļžāļ·āđˆāļ­āļ›āđ‰āļ­āļ‡āļāļąāļ™āļ‚āđ‰āļ­āļĄāļđāļĨāļŦāļēāļĒāđ€āļĄāļ·āđˆāļ­āđ€āļ™āđ‡āļ•āļŦāļĨāļļāļ” + +```typescript +// lib/stores/draft-store.ts +export const useDraftStore = create( + persist( + (set) => ({ + drafts: {}, + saveDraft: (key, data) => set((state) => ({ drafts: { ...state.drafts, [key]: data } })), + clearDraft: (key) => set((state) => { + const newDrafts = { ...state.drafts }; + delete newDrafts[key]; + return { drafts: newDrafts }; + }), + }), + { name: 'form-drafts' } + ) +); +``` + +### **4.2 Dynamic Form Generator** + +āđ€āļžāļ·āđˆāļ­āļĢāļ­āļ‡āļĢāļąāļš JSON Schema āļŦāļĨāļēāļāļŦāļĨāļēāļĒāļĢāļđāļ›āđāļšāļš āđƒāļŦāđ‰āļŠāļĢāđ‰āļēāļ‡ Component āļāļĨāļēāļ‡āļ—āļĩāđˆāļĢāļąāļš Schema āđāļĨāđ‰āļ§ Gen Form āļ­āļ­āļāļĄāļē (āļĨāļ”āļāļēāļĢāđāļāđ‰ Code āļšāđˆāļ­āļĒāđ†) + +* **Libraries:** āđāļ™āļ°āļ™āļģ `react-jsonschema-form` āļŦāļĢāļ·āļ­āļŠāļĢāđ‰āļēāļ‡ Wrapper āļšāļ™ `react-hook-form` āļ—āļĩāđˆ Recursively render field āļ•āļēāļĄ Type +* **Validation:** āđƒāļŠāđ‰ `ajv` āļ—āļĩāđˆāļāļąāđˆāļ‡ Client āđ€āļžāļ·āđˆāļ­ Validate JSON āļāđˆāļ­āļ™ Submit + +### **4.3 Mobile Responsiveness (Card View)** + +āļ•āļēāļĢāļēāļ‡āļ‚āđ‰āļ­āļĄāļđāļĨ (`DataTable`) āļ•āđ‰āļ­āļ‡āļĄāļĩāļ„āļ§āļēāļĄāļ‰āļĨāļēāļ”āđƒāļ™āļāļēāļĢāđāļŠāļ”āļ‡āļœāļĨ: + +* **Desktop:** āđāļŠāļ”āļ‡āđ€āļ›āđ‡āļ™ Table āļ›āļāļ•āļī +* **Mobile:** āđāļ›āļĨāļ‡āđ€āļ›āđ‡āļ™ **Card View** āđ‚āļ”āļĒāļ­āļąāļ•āđ‚āļ™āļĄāļąāļ•āļī (āļ‹āđˆāļ­āļ™ Header, āđāļŠāļ”āļ‡ Label āļ„āļđāđˆ Value āđƒāļ™āđāļ•āđˆāļĨāļ° Card) + +```tsx +// components/ui/responsive-table.tsx +
+ {/* Desktop View */}
+
+
+ {data.map((item) => ( + + {/* Mobile View: Render cells as list items */} + + ))} +
+``` + +### **4.4 Optimistic Updates** + +āđƒāļŠāđ‰āļ„āļ§āļēāļĄāļŠāļēāļĄāļēāļĢāļ–āļ‚āļ­āļ‡ **TanStack Query** (`onMutate`) āđ€āļžāļ·āđˆāļ­āļ­āļąāļ›āđ€āļ”āļ• UI āļ—āļąāļ™āļ—āļĩ (āđ€āļŠāđˆāļ™ āđ€āļ›āļĨāļĩāđˆāļĒāļ™āļŠāļ–āļēāļ™āļ°āļˆāļēāļ "āļĢāļ­āļ­āđˆāļēāļ™" āđ€āļ›āđ‡āļ™ "āļ­āđˆāļēāļ™āđāļĨāđ‰āļ§") āđāļĨāđ‰āļ§āļ„āđˆāļ­āļĒāļŠāđˆāļ‡ Request āđ„āļ› Server āļ–āđ‰āļē Failed āļ„āđˆāļ­āļĒ Rollback + +### **4.5 āđāļ™āļ§āļ—āļēāļ‡āļāļēāļĢāļžāļąāļ’āļ™āļēāđ‚āļ„āđ‰āļ” (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 āđ‚āļĄāļ”āļđāļĨāļ—āļĩāđˆāļˆāļģāđ€āļ›āđ‡āļ™āļ•āđ‰āļ­āļ‡āđƒāļŠāđ‰āļ­āļĒāđˆāļēāļ‡āļŠāļąāļ”āđ€āļˆāļ™āđ€āļŠāļĄāļ­ + +### **4.6 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 + +### **4.7 āļāļēāļĢāļ•āļĢāļ§āļˆāļŠāļ­āļšāļŸāļ­āļĢāđŒāļĄāđāļĨāļ°āļ‚āđ‰āļ­āļœāļīāļ”āļžāļĨāļēāļ” (Form Validation & Errors)** + +* āđƒāļŠāđ‰āđ„āļĨāļšāļĢāļēāļĢāļĩāļāļąāđˆāļ‡ client āđ€āļŠāđˆāļ™ zod āđāļĨāļ° react-hook-form +* āđāļŠāļ”āļ‡āļ‚āđ‰āļ­āļœāļīāļ”āļžāļĨāļēāļ”āļ”āđ‰āļ§āļĒ **alert components** āļŦāļĢāļ·āļ­āļ‚āđ‰āļ­āļ„āļ§āļēāļĄ inline +* āļ•āđ‰āļ­āļ‡āļĄāļĩ labels, placeholders, āđāļĨāļ°āļ‚āđ‰āļ­āļ„āļ§āļēāļĄ feedback + +### **🧊4.8 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]) + +### **🗄ïļ4.9 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]) + +## 🔐 **5. Security & Access Control (Full Stack Integration)** + +### **5.1 CASL Integration (Shared Ability)** + +* **Backend:** āđƒāļŠāđ‰ CASL āļāļģāļŦāļ™āļ” Permission Rule +* **Frontend:** āđƒāļŦāđ‰āļ”āļķāļ‡ Rule (JSON) āļˆāļēāļ Backend āļĄāļē Load āđƒāļŠāđˆ `@casl/react` āđ€āļžāļ·āđˆāļ­āđƒāļŦāđ‰ Logic āļāļēāļĢ Show/Hide āļ›āļļāđˆāļĄ āļ•āļĢāļ‡āļāļąāļ™ 100% + +### **5.2 Maintenance Mode** + +āđ€āļžāļīāđˆāļĄ Middleware (āļ—āļąāđ‰āļ‡ NestJS āđāļĨāļ° Next.js) āđ€āļžāļ·āđˆāļ­āļ•āļĢāļ§āļˆāļŠāļ­āļš Flag āđƒāļ™ Redis: + +* āļ–āđ‰āļē `MAINTENANCE_MODE = true` +* **API:** Return `503 Service Unavailable` (āļĒāļāđ€āļ§āđ‰āļ™ Admin IP) +* **Frontend:** Redirect āđ„āļ›āļŦāļ™āđ‰āļē `/maintenance` + +### **5.3 Idempotency Client** + +āļŠāļĢāđ‰āļēāļ‡ Axios Interceptor āđ€āļžāļ·āđˆāļ­ Generate `Idempotency-Key` āļŠāļģāļŦāļĢāļąāļš POST/PUT/DELETE requests āļ—āļļāļāļ„āļĢāļąāđ‰āļ‡ + +```typescript +// lib/api/client.ts +import { v4 as uuidv4 } from 'uuid'; + +apiClient.interceptors.request.use((config) => { + if (['post', 'put', 'delete'].includes(config.method)) { + config.headers['Idempotency-Key'] = uuidv4(); + } + return config; +}); +``` + +### **5.4 RBAC āđāļĨāļ°āļāļēāļĢāļ„āļ§āļšāļ„āļļāļĄāļŠāļīāļ—āļ˜āļīāđŒ (RBAC & Permission Control)** + +āđƒāļŠāđ‰ Decorators āđ€āļžāļ·āđˆāļ­āļšāļąāļ‡āļ„āļąāļšāđƒāļŠāđ‰āļŠāļīāļ—āļ˜āļīāđŒāļāļēāļĢāđ€āļ‚āđ‰āļēāļ–āļķāļ‡ āđ‚āļ”āļĒāļ­āđ‰āļēāļ‡āļ­āļīāļ‡āļŠāļīāļ—āļ˜āļīāđŒāļˆāļēāļāļ•āļēāļĢāļēāļ‡ permissions + +```typescript +@RequirePermission('rfas.respond') // āļ•āđ‰āļ­āļ‡āļ•āļĢāļ‡āļāļąāļš 'permission_code' +@Put(':id') +updateRFA(@Param('id') id: string) { + return this.rfaService.update(id); +} +``` + +#### **5.4.1 Roles (āļšāļ—āļšāļēāļ—)** + +* **Superadmin**: āđ„āļĄāđˆāļĄāļĩāļ‚āđ‰āļ­āļˆāļģāļāļąāļ”āđƒāļ”āđ† [cite: 4.3] +* **Admin**: āļĄāļĩāļŠāļīāļ—āļ˜āļīāđŒāđ€āļ•āđ‡āļĄāļ—āļĩāđˆāđƒāļ™āļ­āļ‡āļ„āđŒāļāļĢ [cite: 4.3] +* **Document Control**: āđ€āļžāļīāđˆāļĄ/āđāļāđ‰āđ„āļ‚/āļĨāļš āđ€āļ­āļāļŠāļēāļĢāđƒāļ™āļ­āļ‡āļ„āđŒāļāļĢ [cite: 4.3] +* **Editor**: āļŠāļēāļĄāļēāļĢāļ– āđ€āļžāļīāđˆāļĄ/āđāļāđ‰āđ„āļ‚ āđ€āļ­āļāļŠāļēāļĢāļ—āļĩāđˆāļāļģāļŦāļ™āļ” [cite: 4.3] +* **Viewer**: āļŠāļēāļĄāļēāļĢāļ–āļ”āļđ āđ€āļ­āļāļŠāļēāļĢ [cite: 4.3] + +#### **5.4.2 āļ•āļąāļ§āļ­āļĒāđˆāļēāļ‡ 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] + +## 📊 **6. Notification & Background Jobs** + +### **6.1 Digest Notification** + +āļŦāđ‰āļēāļĄāļŠāđˆāļ‡ Email āļ—āļąāļ™āļ—āļĩāļ—āļĩāđˆāđ€āļāļīāļ” Event āđƒāļŦāđ‰: + +1. Push Event āļĨāļ‡ Queue (Redis/BullMQ) +2. āļĄāļĩ Processor āļĢāļ­āđ€āļ§āļĨāļē (āđ€āļŠāđˆāļ™ 5 āļ™āļēāļ—āļĩ) āđ€āļžāļ·āđˆāļ­ Group Events āļ—āļĩāđˆāļ„āļĨāđ‰āļēāļĒāļāļąāļ™ (āđ€āļŠāđˆāļ™ "āļ„āļļāļ“āļĄāļĩāđ€āļ­āļāļŠāļēāļĢāļĢāļ­āļ­āļ™āļļāļĄāļąāļ•āļī 5 āļ‰āļšāļąāļš") +3. āļŠāđˆāļ‡ Email āđ€āļ”āļĩāļĒāļ§ (Digest) āđ€āļžāļ·āđˆāļ­āļĨāļ” Spam + +## 🔗 **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 | + +## 🗂ïļ **8. āļ‚āđ‰āļ­āļ•āļāļĨāļ‡āđ€āļ‰āļžāļēāļ°āļŠāļģāļŦāļĢāļąāļš DMS (LCBP3-DMS)** + +āļŠāđˆāļ§āļ™āļ™āļĩāđ‰āļ‚āļĒāļēāļĒāđāļ™āļ§āļ—āļēāļ‡ FullStackJS āļ—āļąāđˆāļ§āđ„āļ›āļŠāļģāļŦāļĢāļąāļšāđ‚āļ›āļĢāđ€āļˆāļāļ•āđŒ **LCBP3-DMS** āđ‚āļ”āļĒāļĄāļļāđˆāļ‡āđ€āļ™āđ‰āļ™āđ„āļ›āļ—āļĩāđˆāđ€āļ§āļīāļĢāđŒāļāđ‚āļŸāļĨāļ§āđŒāļāļēāļĢāļ­āļ™āļļāļĄāļąāļ•āļīāđ€āļ­āļāļŠāļēāļĢ (Correspondence, RFA, Drawing, Contract, Transmittal, Circulation) + +### ðŸ§ū**8.1 āļĄāļēāļ•āļĢāļāļēāļ™ 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) | + +### 📂**8.2 āļāļēāļĢāļˆāļąāļ”āļāļēāļĢāđ„āļŸāļĨāđŒ (File Handling)** + +#### **8.2.1 āļĄāļēāļ•āļĢāļāļēāļ™āļāļēāļĢāļ­āļąāļ›āđ‚āļŦāļĨāļ”āđ„āļŸāļĨāđŒ (File Upload Standard)** + +* **Security-First Approach:** āļāļēāļĢāļ­āļąāļ›āđ‚āļŦāļĨāļ”āđ„āļŸāļĨāđŒāļ—āļąāđ‰āļ‡āļŦāļĄāļ”āļˆāļ°āļ–āļđāļāļˆāļąāļ”āļāļēāļĢāđ‚āļ”āļĒ FileStorageService āļ—āļĩāđˆāļĄāļĩ security measures āļ„āļĢāļšāļ–āđ‰āļ§āļ™ +* āđ„āļŸāļĨāđŒāļˆāļ°āļ–āļđāļāđ€āļŠāļ·āđˆāļ­āļĄāđ‚āļĒāļ‡āđ„āļ›āļĒāļąāļ‡ 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 (āļœāđˆāļēāļ™ white-list validation) +* āļ‚āļ™āļēāļ”āļŠāļđāļ‡āļŠāļļāļ”: **50 MB** +* āļˆāļąāļ”āđ€āļāđ‡āļšāļ™āļ­āļ webroot +* āđƒāļŦāđ‰āļšāļĢāļīāļāļēāļĢāđ„āļŸāļĨāđŒāļœāđˆāļēāļ™ endpoint āļ—āļĩāđˆāļ›āļĨāļ­āļ”āļ āļąāļĒ /files/:attachment_id/download + +#### **8.2.2 Security Controls āļŠāļģāļŦāļĢāļąāļš File Access:** + +āļāļēāļĢāđ€āļ‚āđ‰āļēāļ–āļķāļ‡āđ„āļŸāļĨāđŒāđ„āļĄāđˆāđƒāļŠāđˆāļāļēāļĢāđ€āļ‚āđ‰āļēāļ–āļķāļ‡āđ‚āļ”āļĒāļ•āļĢāļ‡ endpoint /files/:attachment_id/download āļˆāļ°āļ•āđ‰āļ­āļ‡: + +1. āļ„āđ‰āļ™āļŦāļēāļĢāļ°āđ€āļšāļĩāļĒāļ™ attachment +2. āļ•āļĢāļ§āļˆāļŠāļ­āļšāļ§āđˆāļē attachment_id āļ™āļĩāđ‰ āđ€āļŠāļ·āđˆāļ­āļĄāđ‚āļĒāļ‡āļāļąāļš Entity āđƒāļ” (āđ€āļŠāđˆāļ™ correspondence, circulation, shop_drawing_revision, contract_drawing) āļœāđˆāļēāļ™āļ•āļēāļĢāļēāļ‡āđ€āļŠāļ·āđˆāļ­āļĄ +3. āļ•āļĢāļ§āļˆāļŠāļ­āļšāļ§āđˆāļēāļœāļđāđ‰āđƒāļŠāđ‰āļĄāļĩāļŠāļīāļ—āļ˜āļīāđŒ (permission) āđƒāļ™āļāļēāļĢāļ”āļđ Entity āļ•āđ‰āļ™āļ—āļēāļ‡āļ™āļąāđ‰āļ™āđ† āļŦāļĢāļ·āļ­āđ„āļĄāđˆ +4. āļ•āļĢāļ§āļˆāļŠāļ­āļš download token expiration (24 āļŠāļąāđˆāļ§āđ‚āļĄāļ‡) +5. āļšāļąāļ™āļ—āļķāļ audit log āļāļēāļĢāļ”āļēāļ§āļ™āđŒāđ‚āļŦāļĨāļ” + +### 🔟**8.3 āļāļēāļĢāļˆāļąāļ”āļāļēāļĢāđ€āļĨāļ‚āļ—āļĩāđˆāđ€āļ­āļāļŠāļēāļĢ (Document Numbering) [cite: 3.10]** + +* **āđ€āļ›āđ‰āļēāļŦāļĄāļēāļĒ:** āļŠāļĢāđ‰āļēāļ‡āđ€āļĨāļ‚āļ—āļĩāđˆāđ€āļ­āļāļŠāļēāļĢ (āđ€āļŠāđˆāļ™ correspondence_number) āđ‚āļ”āļĒāļ­āļąāļ•āđ‚āļ™āļĄāļąāļ•āļī āļ•āļēāļĄāļĢāļđāļ›āđāļšāļšāļ—āļĩāđˆāļāļģāļŦāļ™āļ” +* **āļ•āļĢāļĢāļāļ°āļāļēāļĢāļ™āļąāļš:** āļāļēāļĢāļ™āļąāļš Running number (SEQ) āļˆāļ°āļ™āļąāļšāđāļĒāļāļ•āļēāļĄ Key: **Project + Originator Organization + Document Type + Year** +* **āļ•āļēāļĢāļēāļ‡ SQL (Updated):** + * `document_number_formats`: āđ€āļāđ‡āļš Template String (āđ€āļŠāđˆāļ™ `{CONTRACT}-{TYPE}-{DISCIPLINE}-{SEQ:4}`) + * `document_number_counters`: **Primary Key āđ€āļ›āļĨāļĩāđˆāļĒāļ™āđ€āļ›āđ‡āļ™ Composite Key āđƒāļŦāļĄāđˆ:** `(project_id, originator_id, type_id, discipline_id, current_year)` āđ€āļžāļ·āđˆāļ­āļĢāļ­āļ‡āļĢāļąāļšāļāļēāļĢāļĢāļąāļ™āđ€āļĨāļ‚āđāļĒāļāļ•āļēāļĄāļŠāļēāļ‚āļē +* **āļāļēāļĢāļ—āļģāļ‡āļēāļ™:** + * Service āļ•āđ‰āļ­āļ‡āļĢāļ­āļ‡āļĢāļąāļšāļāļēāļĢ Resolve Token āļžāļīāđ€āļĻāļĐ āđ€āļŠāđˆāļ™ `{SUBTYPE_NUM}` āļ—āļĩāđˆāļ•āđ‰āļ­āļ‡āđ„āļ› Join āļāļąāļšāļ•āļēāļĢāļēāļ‡ `correspondence_sub_types` + * DocumentNumberingModule āļˆāļ°āđƒāļŦāđ‰āļšāļĢāļīāļāļēāļĢ DocumentNumberingService + * āđ€āļĄāļ·āđˆāļ­ CorrespondenceModule āļ•āđ‰āļ­āļ‡āļāļēāļĢāļŠāļĢāđ‰āļēāļ‡āđ€āļ­āļāļŠāļēāļĢāđƒāļŦāļĄāđˆ, āļĄāļąāļ™āļˆāļ°āđ€āļĢāļĩāļĒāļ documentNumberingService.generateNextNumber(...) + * Service āļ™āļĩāđ‰āļˆāļ°āđƒāļŠāđ‰ **Redis distributed locking** āđāļ—āļ™ stored procedure āļ‹āļķāđˆāļ‡āļˆāļ°āļˆāļąāļ”āļāļēāļĢ Database Transaction āđāļĨāļ° Row Locking āļ āļēāļĒāđƒāļ™ Application Layer āđ€āļžāļ·āđˆāļ­āļĢāļąāļšāļ›āļĢāļ°āļāļąāļ™āļāļēāļĢāļ›āđ‰āļ­āļ‡āļāļąāļ™ Race Condition + * āļĄāļĩ retry mechanism āđāļĨāļ° fallback strategies + +### 📊**8.4 āļāļēāļĢāļĢāļēāļĒāļ‡āļēāļ™āđāļĨāļ°āļāļēāļĢāļŠāđˆāļ‡āļ­āļ­āļ (Reporting & Exports)** + +#### **8.4.1 āļ§āļīāļ§āļŠāļģāļŦāļĢāļąāļšāļāļēāļĢāļĢāļēāļĒāļ‡āļēāļ™ (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 āđ€āļŦāļĨāđˆāļēāļ™āļĩāđ‰āļ—āļģāļŦāļ™āđ‰āļēāļ—āļĩāđˆāđ€āļ›āđ‡āļ™āđāļŦāļĨāđˆāļ‡āļ‚āđ‰āļ­āļĄāļđāļĨāļŦāļĨāļąāļāļŠāļģāļŦāļĢāļąāļšāļāļēāļĢāļĢāļēāļĒāļ‡āļēāļ™āļāļąāđˆāļ‡āđ€āļ‹āļīāļĢāđŒāļŸāđ€āļ§āļ­āļĢāđŒāđāļĨāļ°āļāļēāļĢāļŠāđˆāļ‡āļ­āļ­āļāļ‚āđ‰āļ­āļĄāļđāļĨ + +#### **8.4.2 āļāļŽāļāļēāļĢāļŠāđˆāļ‡āļ­āļ­āļ (Export Rules)** + +* Export formats: CSV, Excel, PDF. +* āļˆāļąāļ”āđ€āļ•āļĢāļĩāļĒāļĄāļĄāļļāļĄāļĄāļ­āļ‡āļŠāļģāļŦāļĢāļąāļšāļžāļīāļĄāļžāđŒ (Print view). +* āļĢāļ§āļĄāļĨāļīāļ‡āļāđŒāđ„āļ›āļĒāļąāļ‡āļ•āđ‰āļ™āļ—āļēāļ‡ (āđ€āļŠāđˆāļ™ /rfas/:id). + +## ðŸ§Ū **9. āļŸāļĢāļ­āļ™āļ•āđŒāđ€āļ­āļ™āļ”āđŒ: āļĢāļđāļ›āđāļšāļš DataTable āđāļĨāļ°āļŸāļ­āļĢāđŒāļĄ (Frontend: DataTable & Form Patterns)** + +### **9.1 DataTable (Server‑Side)** + +* Endpoint: /api/{module}?page=1&pageSize=20&sort=...&filter=... +* āļ•āđ‰āļ­āļ‡āļĢāļ­āļ‡āļĢāļąāļš: āļāļēāļĢāđāļšāđˆāļ‡āļŦāļ™āđ‰āļē (pagination), āļāļēāļĢāđ€āļĢāļĩāļĒāļ‡āļĨāļģāļ”āļąāļš (sorting), āļāļēāļĢāļ„āđ‰āļ™āļŦāļē (search), āļāļēāļĢāļāļĢāļ­āļ‡ (filters) +* āđāļŠāļ”āļ‡ revision āļĨāđˆāļēāļŠāļļāļ”āđāļšāļš inline āđ€āļŠāļĄāļ­ (āļŠāļģāļŦāļĢāļąāļš RFA/Drawing) + +### **9.2 āļĄāļēāļ•āļĢāļāļēāļ™āļŸāļ­āļĢāđŒāļĄ (Form Standards)** + +* āļ•āđ‰āļ­āļ‡āļĄāļĩāļāļēāļĢāđƒāļŠāđ‰āļ‡āļēāļ™ Dropdowns āđāļšāļšāļ‚āļķāđ‰āļ™āļ•āđˆāļ­āļāļąāļ™ (Dependent dropdowns) (āļ•āļēāļĄāļ—āļĩāđˆāļŠāļ„āļĩāļĄāļēāļĢāļ­āļ‡āļĢāļąāļš): + * Project → Contract Drawing Volumes + * Contract Drawing Category → Sub-Category + * RFA (āļ›āļĢāļ°āđ€āļ āļ— Shop Drawing) → Shop Drawing Revisions āļ—āļĩāđˆāđ€āļŠāļ·āđˆāļ­āļĄāđ‚āļĒāļ‡āđ„āļ”āđ‰ +* **File Upload Security:** āļ•āđ‰āļ­āļ‡āļĢāļ­āļ‡āļĢāļąāļš **Multi-file upload (Drag-and-Drop)** [cite: 5.7] āļžāļĢāđ‰āļ­āļĄ virus scanning feedback +* **File Type Indicators:** UI āļ•āđ‰āļ­āļ‡āļ­āļ™āļļāļāļēāļ•āđƒāļŦāđ‰āļœāļđāđ‰āđƒāļŠāđ‰āļāļģāļŦāļ™āļ”āļ§āđˆāļēāđ„āļŸāļĨāđŒāđƒāļ”āđ€āļ›āđ‡āļ™ **"āđ€āļ­āļāļŠāļēāļĢāļŦāļĨāļąāļ"** āļŦāļĢāļ·āļ­ "āđ€āļ­āļāļŠāļēāļĢāđāļ™āļšāļ›āļĢāļ°āļāļ­āļš" [cite: 5.7] āļžāļĢāđ‰āļ­āļĄāđāļŠāļ”āļ‡ file type icons +* **Security Feedback:** āđāļŠāļ”āļ‡ security warnings āļŠāļģāļŦāļĢāļąāļš file types āļ—āļĩāđˆāđ€āļŠāļĩāđˆāļĒāļ‡āļŦāļĢāļ·āļ­ files āļ—āļĩāđˆ fail virus scan +* āļŠāđˆāļ‡ (Submit) āļœāđˆāļēāļ™ API āļžāļĢāđ‰āļ­āļĄ feedback āđāļšāļš toast + +### **9.3 āļ‚āđ‰āļ­āļāļģāļŦāļ™āļ” 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])** +* **Security Dashboard:** āđāļŠāļ”āļ‡ security metrics āđāļĨāļ° audit logs āļŠāļģāļŦāļĢāļąāļš administrators + +## 🧭 **10. āđāļ”āļŠāļšāļ­āļĢāđŒāļ”āđāļĨāļ°āļŸāļĩāļ”āļāļīāļˆāļāļĢāļĢāļĄ (Dashboard & Activity Feed)** + +### **10.1 āļāļēāļĢāđŒāļ”āļšāļ™āđāļ”āļŠāļšāļ­āļĢāđŒāļ” (Dashboard Cards)** + +* āđāļŠāļ”āļ‡ Correspondences, RFAs, Circulations, Shop Drawing Revision āļĨāđˆāļēāļŠāļļāļ” +* āļĢāļ§āļĄāļŠāļĢāļļāļ› KPI (āđ€āļŠāđˆāļ™ "RFAs āļ—āļĩāđˆāļĢāļ­āļāļēāļĢāļ­āļ™āļļāļĄāļąāļ•āļī", "Shop Drawing āļ—āļĩāđˆāļĢāļ­āļāļēāļĢāļ­āļ™āļļāļĄāļąāļ•āļī") [cite: 5.3] +* āļĢāļ§āļĄāļĨāļīāļ‡āļāđŒāļ”āđˆāļ§āļ™āđ„āļ›āļĒāļąāļ‡āđ‚āļĄāļ”āļđāļĨāļ•āđˆāļēāļ‡āđ† +* **Security Metrics:** āđāļŠāļ”āļ‡āļˆāļģāļ™āļ§āļ™ files scanned, security incidents, failed login attempts + +### **10.2 āļŸāļĩāļ”āļāļīāļˆāļāļĢāļĢāļĄ (Activity Feed)** + +* āđāļŠāļ”āļ‡āļĢāļēāļĒāļāļēāļĢ v_audit_log_details āļĨāđˆāļēāļŠāļļāļ” (10 āļĢāļēāļĒāļāļēāļĢ) āļ—āļĩāđˆāđ€āļāļĩāđˆāļĒāļ§āļ‚āđ‰āļ­āļ‡āļāļąāļšāļœāļđāđ‰āđƒāļŠāđ‰ +* āļĢāļ§āļĄ security-related activities (failed logins, permission changes) + +```typescript +// āļ•āļąāļ§āļ­āļĒāđˆāļēāļ‡ API response +[ + { user: 'editor01', action: 'Updated RFA (LCBP3-RFA-001)', time: '2025-11-04T09:30Z' }, + { user: 'system', action: 'Virus scan completed - 0 threats found', time: '2025-11-04T09:25Z' } +] +``` + +## ðŸ›Ąïļ **11. āļ‚āđ‰āļ­āļāļģāļŦāļ™āļ”āļ—āļĩāđˆāđ„āļĄāđˆāđƒāļŠāđˆāļŸāļąāļ‡āļāđŒāļŠāļąāļ™āļāļēāļĢāļ—āļģāļ‡āļēāļ™ (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) +* **File Security [cite: 3.9.6]:** āļ•āđ‰āļ­āļ‡āļĄāļĩ virus scanning, file type validation, access controls +* **Resilience [cite: 6.5.3]:** āļ•āđ‰āļ­āļ‡āļĄāļĩ circuit breaker, retry mechanisms, graceful degradation +* **Backup & Recovery [cite: 6.6]:** āļ•āđ‰āļ­āļ‡āļĄāļĩāđāļœāļ™āļŠāļģāļĢāļ­āļ‡āļ‚āđ‰āļ­āļĄāļđāļĨāļ—āļąāđ‰āļ‡ Database (MariaDB) āđāļĨāļ° File Storage (/share/dms-data) āļ­āļĒāđˆāļēāļ‡āļ™āđ‰āļ­āļĒāļ§āļąāļ™āļĨāļ° 1 āļ„āļĢāļąāđ‰āļ‡ +* **Notification Strategy [cite: 6.7]:** āļĢāļ°āļšāļšāđāļˆāđ‰āļ‡āđ€āļ•āļ·āļ­āļ™ (Email/Line) āļ•āđ‰āļ­āļ‡āļ–āļđāļ Trigger āđ€āļĄāļ·āđˆāļ­āļĄāļĩāđ€āļ­āļāļŠāļēāļĢāđƒāļŦāļĄāđˆāļŠāđˆāļ‡āļ–āļķāļ‡, āļĄāļĩāļāļēāļĢāļĄāļ­āļšāļŦāļĄāļēāļĒāļ‡āļēāļ™āđƒāļŦāļĄāđˆ (Circulation), āļŦāļĢāļ·āļ­ (āļ—āļēāļ‡āđ€āļĨāļ·āļ­āļ) āđ€āļĄāļ·āđˆāļ­āļ‡āļēāļ™āđ€āļŠāļĢāđ‡āļˆ/āđƒāļāļĨāđ‰āļ–āļķāļ‡āļāļģāļŦāļ™āļ” +* **Monitoring [cite: 6.8]:** āļ•āđ‰āļ­āļ‡āļĄāļĩ health checks, metrics collection, alerting + +## ✅ **12. āļĄāļēāļ•āļĢāļāļēāļ™āļ—āļĩāđˆāļ™āļģāđ„āļ›āđƒāļŠāđ‰āđāļĨāđ‰āļ§ (āļˆāļēāļ SQL v1.4.0) (Implemented Standards (from SQL v1.4.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) āļ–āļđāļāļĢāļ§āļĄāļ­āļĒāļđāđˆāđƒāļ™āļŠāļ„āļĢāļīāļ›āļ•āđŒāļŠāļ„āļĩāļĄāļēāđāļĨāđ‰āļ§ +* ✅ **Application-level Locking:** āđƒāļŠāđ‰ Redis distributed lock āđāļ—āļ™ stored procedure +* ✅ **File Security:** Virus scanning, file type validation, access control +* ✅ **Resilience Patterns:** Circuit breaker, retry, fallback mechanisms +* ✅ **Security Measures:** Input validation, rate limiting, security headers +* ✅ **Monitoring:** Health checks, metrics collection, distributed tracing + +## ðŸ§Đ **13. āļāļēāļĢāļ›āļĢāļąāļšāļ›āļĢāļļāļ‡āļ—āļĩāđˆāđāļ™āļ°āļ™āļģ (āļŠāļģāļŦāļĢāļąāļšāļ­āļ™āļēāļ„āļ•) (Recommended Enhancements (Future))** + +* ✅ āļŠāļĢāđ‰āļēāļ‡ Background job (āđ‚āļ”āļĒāđƒāļŠāđ‰ **n8n** āđ€āļžāļ·āđˆāļ­āđ€āļŠāļ·āđˆāļ­āļĄāļ•āđˆāļ­āļāļąāļš **Line** [cite: 2.7] āđāļĨāļ°/āļŦāļĢāļ·āļ­āđƒāļŠāđ‰āļŠāļģāļŦāļĢāļąāļšāļāļēāļĢāđāļˆāđ‰āļ‡āđ€āļ•āļ·āļ­āļ™ RFA āļ—āļĩāđˆāđƒāļāļĨāđ‰āļ–āļķāļ‡āļāļģāļŦāļ™āļ” due_date [cite: 6.7]) +* ✅ āđ€āļžāļīāđˆāļĄ job āļĨāđ‰āļēāļ‡āļ‚āđ‰āļ­āļĄāļđāļĨāđ€āļ›āđ‡āļ™āļĢāļ°āļĒāļ°āļŠāļģāļŦāļĢāļąāļš attachments āļ—āļĩāđˆāđ„āļĄāđˆāļ–āļđāļāđ€āļŠāļ·āđˆāļ­āļĄāđ‚āļĒāļ‡āļāļąāļš Entity āđƒāļ”āđ† āđ€āļĨāļĒ (āđ„āļŸāļĨāđŒāļāļģāļžāļĢāđ‰āļē) +* 🔄 **AI-Powered Document Classification:** āđƒāļŠāđ‰ machine learning āļŠāļģāļŦāļĢāļąāļš automatic document categorization +* 🔄 **Advanced Analytics:** Predictive analytics āļŠāļģāļŦāļĢāļąāļš workflow optimization +* 🔄 **Mobile App:** Native mobile application āļŠāļģāļŦāļĢāļąāļš field workers +* 🔄 **Blockchain Integration:** āļŠāļģāļŦāļĢāļąāļš document integrity verification āļ—āļĩāđˆāļ•āđ‰āļ­āļ‡āļāļēāļĢāļ„āļ§āļēāļĄāļ›āļĨāļ­āļ”āļ āļąāļĒāļŠāļđāļ‡āļŠāļļāļ” + +## ✅ **14. Summary Checklist for Developers** + +āļāđˆāļ­āļ™āļŠāđˆāļ‡ PR (Pull Request) āļ™āļąāļāļžāļąāļ’āļ™āļēāļ•āđ‰āļ­āļ‡āļ•āļĢāļ§āļˆāļŠāļ­āļšāļŦāļąāļ§āļ‚āđ‰āļ­āļ•āđˆāļ­āđ„āļ›āļ™āļĩāđ‰: + +* [ ] **Security:** āđ„āļĄāđˆāļĄāļĩ Secrets āđƒāļ™ Code, āđƒāļŠāđ‰ `docker-compose.override.yml` āđāļĨāđ‰āļ§ +* [ ] **Concurrency:** āđƒāļŠāđ‰ Optimistic Lock āđƒāļ™ Entity āļ—āļĩāđˆāđ€āļŠāļĩāđˆāļĒāļ‡ Race Condition āđāļĨāđ‰āļ§ +* [ ] **Idempotency:** API āļĢāļ­āļ‡āļĢāļąāļš Idempotency Key āđāļĨāđ‰āļ§ +* [ ] **File Upload:** āđƒāļŠāđ‰ Flow Two-Phase (Temp -> Perm) āđāļĨāđ‰āļ§ +* [ ] **Mobile:** āļŦāļ™āđ‰āļēāļˆāļ­āđāļŠāļ”āļ‡āļœāļĨāđāļšāļš Card View āļšāļ™āļĄāļ·āļ­āļ–āļ·āļ­āđ„āļ”āđ‰āļ–āļđāļāļ•āđ‰āļ­āļ‡ +* [ ] **Performance:** āļŠāļĢāđ‰āļēāļ‡ Index āļŠāļģāļŦāļĢāļąāļš JSON Virtual Columns āđāļĨāđ‰āļ§ (āļ–āđ‰āļēāļĄāļĩ) + +--- + +## 📋 **15. Summary of Key Changes from Previous Version** + +### **Security Enhancements:** + +1. **File Upload Security** - Virus scanning, file type validation, access controls +2. **Input Validation** - OWASP Top 10 protection, XSS/CSRF prevention +3. **Rate Limiting** - Comprehensive rate limiting strategy +4. **Secrets Management** - Secure handling of sensitive configuration + +### **Architecture Improvements:** + +1. **Document Numbering** - Changed from Stored Procedure to Application-level Locking +2. **Resilience Patterns** - Circuit breaker, retry mechanisms, fallback strategies +3. **Monitoring & Observability** - Health checks, metrics, distributed tracing +4. **Caching Strategy** - Comprehensive caching with proper invalidation + +### **Performance Targets :** + +1. **API Response Time** - < 200ms (90th percentile) +2. **Search Performance** - < 500ms +3. **File Upload** - < 30 seconds for 50MB files +4. **Cache Hit Ratio** - > 80% + +### **Operational Excellence:** + +1. **Disaster Recovery** - RTO < 4 hours, RPO < 1 hour +2. **Backup Procedures** - Comprehensive backup and restoration +3. **Security Testing** - Penetration testing and security audits +4. **Performance Testing** - Load testing with realistic workloads + +āđ€āļ­āļāļŠāļēāļĢāļ™āļĩāđ‰āļŠāļ°āļ—āđ‰āļ­āļ™āļ–āļķāļ‡āļ„āļ§āļēāļĄāļĄāļļāđˆāļ‡āļĄāļąāđˆāļ™āđƒāļ™āļāļēāļĢāļŠāļĢāđ‰āļēāļ‡āļĢāļ°āļšāļšāļ—āļĩāđˆāļĄāļĩāļ„āļ§āļēāļĄāļ›āļĨāļ­āļ”āļ āļąāļĒ, āļĄāļĩāļ„āļ§āļēāļĄāļ—āļ™āļ—āļēāļ™, āđāļĨāļ°āļĄāļĩāļ›āļĢāļ°āļŠāļīāļ—āļ˜āļīāļ āļēāļžāļŠāļđāļ‡ āļžāļĢāđ‰āļ­āļĄāļĢāļ­āļ‡āļĢāļąāļšāļāļēāļĢāđ€āļ•āļīāļšāđ‚āļ•āđƒāļ™āļ­āļ™āļēāļ„āļ•āđāļĨāļ°āļ„āļ§āļēāļĄāļ•āđ‰āļ­āļ‡āļāļēāļĢāļ—āļēāļ‡āļ˜āļļāļĢāļāļīāļˆāļ—āļĩāđˆāđ€āļ›āļĨāļĩāđˆāļĒāļ™āđāļ›āļĨāļ‡āđ„āļ› + +**āļŦāļĄāļēāļĒāđ€āļŦāļ•āļļ:** āđāļ™āļ§āļ—āļēāļ‡āļ™āļĩāđ‰āļˆāļ°āļ–āļđāļāļ—āļšāļ—āļ§āļ™āđāļĨāļ°āļ›āļĢāļąāļšāļ›āļĢāļļāļ‡āđ€āļ›āđ‡āļ™āļĢāļ°āļĒāļ°āļ•āļēāļĄ feedback āļˆāļēāļāļ—āļĩāļĄāļžāļąāļ’āļ™āļēāđāļĨāļ°āļ„āļ§āļēāļĄāļ•āđ‰āļ­āļ‡āļāļēāļĢāļ—āļēāļ‡āļ˜āļļāļĢāļāļīāļˆāļ—āļĩāđˆāđ€āļ›āļĨāļĩāđˆāļĒāļ™āđāļ›āļĨāļ‡āđ„āļ› + +## **Document Control:** + +* **Document:** FullStackJS v1.4.4 +* **Version:** 1.4 +* **Date:** 2025-11-26 +* **Author:** NAP LCBP3-DMS & Gemini +* **Status:** FINAL-Rev.04 +* **Classification:** Internal Technical Documentation +* **Approved By:** Nattanin + +--- + +`End of FullStackJS Guidelines v1.4.4` diff --git a/2_Backend_Plan_V1_4_4.md b/2_Backend_Plan_V1_4_4.md new file mode 100644 index 0000000..723022c --- /dev/null +++ b/2_Backend_Plan_V1_4_4.md @@ -0,0 +1,565 @@ +# 📋 **āđāļœāļ™āļāļēāļĢāļžāļąāļ’āļ™āļē Backend (NestJS) - LCBP3-DMS v1.4.4 (āļ‰āļšāļąāļšāļ›āļĢāļąāļšāļ›āļĢāļļāļ‡)** + +**āļŠāļ–āļēāļ™āļ°:** FINAL GUIDELINE Rev.04 +**āļ§āļąāļ™āļ—āļĩāđˆ:** 2025-11-26 +**āļ­āđ‰āļēāļ‡āļ­āļīāļ‡:** Requirements v1.4.3 & FullStackJS Guidelines v1.4.3 +**Classification:** Internal Technical Documentation + +----- + +## ðŸŽŊ **āļ āļēāļžāļĢāļ§āļĄāđ‚āļ„āļĢāļ‡āļāļēāļĢ** + +āļžāļąāļ’āļ™āļē Backend āļŠāļģāļŦāļĢāļąāļšāļĢāļ°āļšāļšāļšāļĢāļīāļŦāļēāļĢāļˆāļąāļ”āļāļēāļĢāđ€āļ­āļāļŠāļēāļĢāđ‚āļ„āļĢāļ‡āļāļēāļĢ (Document Management System) āļ—āļĩāđˆāļĄāļĩāļ„āļ§āļēāļĄāļ›āļĨāļ­āļ”āļ āļąāļĒāļŠāļđāļ‡ āļĢāļ­āļ‡āļĢāļąāļšāļāļēāļĢāļ—āļģāļ‡āļēāļ™āļžāļĢāđ‰āļ­āļĄāļāļąāļ™ (Concurrency) āđ„āļ”āđ‰āļ­āļĒāđˆāļēāļ‡āļ–āļđāļāļ•āđ‰āļ­āļ‡āđāļĄāđˆāļ™āļĒāļģ āļĄāļĩāļŠāļ–āļēāļ›āļąāļ•āļĒāļāļĢāļĢāļĄāļ—āļĩāđˆāļĒāļ·āļ”āļŦāļĒāļļāđˆāļ™āļ•āđˆāļ­āļāļēāļĢāļ‚āļĒāļēāļĒāļ•āļąāļ§ āđāļĨāļ°āļĢāļ­āļ‡āļĢāļąāļšāļāļēāļĢāļˆāļąāļ”āļāļēāļĢāđ€āļ­āļāļŠāļēāļĢāļ—āļĩāđˆāļ‹āļąāļšāļ‹āđ‰āļ­āļ™ āļĄāļĩāļĢāļ°āļšāļš Workflow āļāļēāļĢāļ­āļ™āļļāļĄāļąāļ•āļī āđāļĨāļ°āļāļēāļĢāļ„āļ§āļšāļ„āļļāļĄāļŠāļīāļ—āļ˜āļīāđŒāđāļšāļš RBAC 4 āļĢāļ°āļ”āļąāļš āļžāļĢāđ‰āļ­āļĄāļĄāļēāļ•āļĢāļāļēāļĢāļ„āļ§āļēāļĄāļ›āļĨāļ­āļ”āļ āļąāļĒāļ—āļĩāđˆāļ—āļąāļ™āļŠāļĄāļąāļĒ + +----- + +## 📐 **āļŠāļ–āļēāļ›āļąāļ•āļĒāļāļĢāļĢāļĄāļĢāļ°āļšāļš** + +### **Technology Stack (Updated)** + +- **Framework:** NestJS (TypeScript, ESM) +- **Database:** MariaDB 10.11 (āđƒāļŠāđ‰ Virtual Columns) +- **ORM:** TypeORM (āđƒāļŠāđ‰ Optimistic Locking) +- **Authentication:** JWT + Passport +- **Authorization:** CASL (RBAC 4-level) +- **File Upload:** Multer + Virus Scanning (ClamAV) + Two-Phase Storage +- **Search:** Elasticsearch +- **Notification:** Nodemailer + n8n (Line Integration) + BullMQ Queue +- **Caching/Locking:** Redis (Redlock) āļŠāļģāļŦāļĢāļąāļš Distributed Locking +- **Queue:** BullMQ (Redis) āļŠāļģāļŦāļĢāļąāļš Notification Batching āđāļĨāļ° Async Jobs +- **Resilience:** Circuit Breaker, Retry Patterns +- **Security:** Helmet, CSRF Protection, Rate Limiting, Idempotency +- **Monitoring:** Winston, Health Checks, Metrics +- **Scheduling:** @nestjs/schedule (Cron Jobs) +- **Documentation:** Swagger +- **Validation:** Zod / Class-validator + +### **āđ‚āļ„āļĢāļ‡āļŠāļĢāđ‰āļēāļ‡āđ‚āļĄāļ”āļđāļĨ (Domain-Driven)** + +```tree +src/ +├── common/ # Shared Module +│ ├── auth/ # JWT, Guards, RBAC +│ ├── config/ # Configuration Management +│ ├── decorators/ # @RequirePermission, @RateLimit +│ ├── entities/ # Base Entities +│ ├── exceptions/ # Global Filters +│ ├── file-storage/ # FileStorageService (Virus Scanning + Two-Phase) +│ ├── guards/ # RBAC Guard, RateLimitGuard +│ ├── interceptors/ # Audit, Transform, Performance, Idempotency +│ ├── resilience/ # Circuit Breaker, Retry Patterns +│ ├── security/ # Input Validation, XSS Protection +│ ├── idempotency/ # [New] Idempotency Logic +│ └── maintenance/ # [New] Maintenance Mode Guard +├── modules/ +│ ├── user/ # Users, Roles, Permissions +│ ├── project/ # Projects, Contracts, Organizations +│ ├── master/ # Master Data Management +│ ├── correspondence/ # Correspondence Management +│ ├── rfa/ # RFA & Workflows +│ ├── drawing/ # Shop/Contract Drawings +│ ├── circulation/ # Internal Circulation +│ ├── transmittal/ # Transmittals +│ ├── search/ # Elasticsearch +│ ├── monitoring/ # Metrics, Health Checks +│ ├── workflow-engine/ # [New] Unified Workflow Logic +│ ├── document-numbering/ # [Update] Double-Locking Logic +│ ├── notification/ # [Update] Queue & Digest +│ └── file-storage/ # [Update] Two-Phase Commit +└── database/ # Migrations & Seeds +``` + +----- + +## 🗓ïļ **āđāļœāļ™āļāļēāļĢāļžāļąāļ’āļ™āļēāđāļšāļš Phase-Based** + +- *(Dependency Diagram āļ–āļđāļāļĨāļ°āđ„āļ§āđ‰āđ€āļžāļ·āđˆāļ­āļ›āļĢāļ°āļŦāļĒāļąāļ”āļžāļ·āđ‰āļ™āļ—āļĩāđˆ āđ€āļ™āļ·āđˆāļ­āļ‡āļˆāļēāļāļĄāļĩāļāļēāļĢāļ­āđ‰āļēāļ‡āļ­āļīāļ‡āļˆāļēāļāđāļœāļ™āđ€āļ”āļīāļĄ)* + +## **Phase 0: Infrastructure & Configuration (āļŠāļąāļ›āļ”āļēāļŦāđŒāļ—āļĩāđˆ 1)** + +**Milestone:** āđ‚āļ„āļĢāļ‡āļŠāļĢāđ‰āļēāļ‡āļžāļ·āđ‰āļ™āļāļēāļ™āļžāļĢāđ‰āļ­āļĄ āļĢāļ­āļ‡āļĢāļąāļš Secrets āļ—āļĩāđˆāļ›āļĨāļ­āļ”āļ āļąāļĒ āđāļĨāļ° Redis āļžāļĢāđ‰āļ­āļĄāđƒāļŠāđ‰āļ‡āļēāļ™ + +### **Phase 0: Tasks** + +- **[ ] T0.1 Secure Configuration Setup** + + - [ ] āļ›āļĢāļąāļšāļ›āļĢāļļāļ‡ `ConfigModule` āđƒāļŦāđ‰āļĢāļ­āļ‡āļĢāļąāļšāļāļēāļĢāļ­āđˆāļēāļ™āļ„āđˆāļēāļˆāļēāļ Environment Variables + - [ ] āļŠāļĢāđ‰āļēāļ‡ Template `docker-compose.override.yml.example` āļŠāļģāļŦāļĢāļąāļš Dev + - [ ] Validate Config āļ”āđ‰āļ§āļĒ Joi/Zod āļ•āļ­āļ™ Start App (Throw error āļ–āđ‰āļēāļ‚āļēāļ” Secrets) + - [ ] **Security:** Setup network segmentation āđāļĨāļ° firewall rules + - [ ] **Deliverable:** Configuration Management āļžāļĢāđ‰āļ­āļĄāđƒāļŠāđ‰āļ‡āļēāļ™āļ­āļĒāđˆāļēāļ‡āļ›āļĨāļ­āļ”āļ āļąāļĒ + - [ ] **Dependencies:** None (Task āđ€āļĢāļīāđˆāļĄāļ•āđ‰āļ™) + +- **[ ] T0.2 Redis & Queue Infrastructure** + + - [ ] Setup Redis Container + - [ ] Setup BullMQ Module āđƒāļ™ NestJS āļŠāļģāļŦāļĢāļąāļšāļˆāļąāļ”āļāļēāļĢ Background Jobs + - [ ] Setup Redis Client āļŠāļģāļŦāļĢāļąāļš Distributed Lock (Redlock) + - [ ] **Security:** Setup Redis authentication āđāļĨāļ° encryption + - [ ] **Deliverable:** Redis āđāļĨāļ° Queue System āļžāļĢāđ‰āļ­āļĄāđƒāļŠāđ‰āļ‡āļēāļ™ + - [ ] **Dependencies:** T0.1 + +- **[ ] T0.3 Setup Database Connection** + + - [ ] Import SQL Schema v1.4.2 āđ€āļ‚āđ‰āļē MariaDB + - [ ] Run Seed Data (organizations, users, roles, permissions) + - [ ] Configure TypeORM āđƒāļ™ AppModule + - [ ] **Security:** Setup database connection encryption + - [ ] āļ—āļ”āļŠāļ­āļš Connection + - [ ] **Deliverable:** Database āļžāļĢāđ‰āļ­āļĄāđƒāļŠāđ‰āļ‡āļēāļ™, āļĄāļĩ Seed Data + - [ ] **Dependencies:** T0.1 + +- **[ ] T0.4 Setup Git Repository** + + - [ ] āļŠāļĢāđ‰āļēāļ‡ Repository āđƒāļ™ Gitea (git.np-dms.work) + - [ ] Setup .gitignore, README.md, SECURITY.md + - [ ] Commit Initial Project + - [ ] **Deliverable:** Code āļ­āļĒāļđāđˆāđƒāļ™ Version Control + - [ ] **Dependencies:** T0.1, T0.2, T0.3 + +----- + +## **Phase 1: Core Foundation & Security (āļŠāļąāļ›āļ”āļēāļŦāđŒāļ—āļĩāđˆ 2-3)** + +**Milestone:** āļĢāļ°āļšāļš Authentication, Authorization, Idempotency āļžāļ·āđ‰āļ™āļāļēāļ™ āđāļĨāļ° Security Baseline + +### **Phase 1: Tasks** + +- **[ ] T1.1 CommonModule - Base Infrastructure** + + - [ ] āļŠāļĢāđ‰āļēāļ‡ Base Entity (id, created_at, updated_at, deleted_at) + - [ ] āļŠāļĢāđ‰āļēāļ‡ Global Exception Filter (āđ„āļĄāđˆāđ€āļ›āļīāļ”āđ€āļœāļĒ sensitive information) + - [ ] āļŠāļĢāđ‰āļēāļ‡ Response Transform Interceptor + - [ ] āļŠāļĢāđ‰āļēāļ‡ Audit Log Interceptor + - [ ] **[New] Idempotency Interceptor:** āļ•āļĢāļ§āļˆāļŠāļ­āļš Header `Idempotency-Key` āđāļĨāļ° Cache Response āđ€āļ”āļīāļĄāđƒāļ™ Redis + - [ ] **[New] Maintenance Mode Middleware:** āļ•āļĢāļ§āļˆāļŠāļ­āļš Flag āđƒāļ™ **Redis Key** āđ€āļžāļ·āđˆāļ­ Block API āļĢāļ°āļŦāļ§āđˆāļēāļ‡āļ›āļĢāļąāļšāļ›āļĢāļļāļ‡āļĢāļ°āļšāļš **(Admin āđƒāļŠāđ‰ Redis/Admin UI āđƒāļ™āļāļēāļĢ Toggle āļŠāļ–āļēāļ™āļ°)** + - [ ] āļŠāļĢāđ‰āļēāļ‡ RequestContextService - āļŠāļģāļŦāļĢāļąāļšāđ€āļāđ‡āļšāļ‚āđ‰āļ­āļĄāļđāļĨāļĢāļ°āļŦāļ§āđˆāļēāļ‡ Request + - [ ] āļŠāļĢāđ‰āļēāļ‡ ConfigService - Centralized configuration management + - [ ] āļŠāļĢāđ‰āļēāļ‡ CryptoService - āļŠāļģāļŦāļĢāļąāļš encryption/decryption + - [ ] **Security:** Implement input validation pipeline + - [ ] **Deliverable:** Common Services āļžāļĢāđ‰āļ­āļĄāđƒāļŠāđ‰ āļĢāļ§āļĄāļ–āļķāļ‡ Idempotency āđāļĨāļ° Maintenance Mode + - [ ] **Dependencies:** T0.2, T0.3 + +- **[ ] T1.2 AuthModule - JWT Authentication** + + - [ ] āļŠāļĢāđ‰āļēāļ‡ Entity: User + - [ ] āļŠāļĢāđ‰āļēāļ‡ AuthService: + - [ ] login(username, password) → JWT Token + - [ ] validateUser(username, password) → User | null + - [ ] Password Hashing (bcrypt) + salt + - [ ] āļŠāļĢāđ‰āļēāļ‡ JWT Strategy (Passport) + - [ ] āļŠāļĢāđ‰āļēāļ‡ JwtAuthGuard + - [ ] āļŠāļĢāđ‰āļēāļ‡ Controllers: + - [ ] POST /auth/login → { access_token, refresh_token } + - [ ] POST /auth/register → Create User (Admin only) + - [ ] POST /auth/refresh → Refresh token + - [ ] POST /auth/logout → Revoke token + - [ ] GET /auth/profile (Protected) + - [ ] **Security:** Implement rate limiting āļŠāļģāļŦāļĢāļąāļš authentication endpoints + - [ ] **Deliverable:** āļĨāđ‡āļ­āļāļ­āļīāļ™/āļĨāđ‡āļ­āļāđ€āļ­āļēāļ•āđŒāļ—āļģāļ‡āļēāļ™āđ„āļ”āđ‰āļ­āļĒāđˆāļēāļ‡āļ›āļĨāļ­āļ”āļ āļąāļĒ + - [ ] **Dependencies:** T1.1, T0.3 + +- **[ ] T1.3 UserModule - User Management** + + - [ ] āļŠāļĢāđ‰āļēāļ‡ Entities: User, Role, Permission, UserRole, UserAssignment, **UserPreference** + - [ ] āļŠāļĢāđ‰āļēāļ‡ UserService CRUD (āļžāļĢāđ‰āļ­āļĄ soft delete) + - [ ] āļŠāļĢāđ‰āļēāļ‡ RoleService CRUD + - [ ] āļŠāļĢāđ‰āļēāļ‡ PermissionService (Read-Only, āļˆāļēāļ Seed) + - [ ] āļŠāļĢāđ‰āļēāļ‡ UserAssignmentService - āļŠāļģāļŦāļĢāļąāļšāļˆāļąāļ”āļāļēāļĢ user assignments āļ•āļēāļĄ scope + - [ ] āļŠāļĢāđ‰āļēāļ‡ **UserPreferenceService** - āļŠāļģāļŦāļĢāļąāļšāļˆāļąāļ”āļāļēāļĢāļāļēāļĢāļ•āļąāđ‰āļ‡āļ„āđˆāļē Notification āđāļĨāļ° UI + - [ ] āļŠāļĢāđ‰āļēāļ‡ Controllers: + - [ ] GET /users → List Users (Paginated) + - [ ] GET /users/:id → User Detail + - [ ] POST /users → Create User (āļ•āđ‰āļ­āļ‡āļšāļąāļ‡āļ„āļąāļšāđ€āļ›āļĨāļĩāđˆāļĒāļ™ password āļ„āļĢāļąāđ‰āļ‡āđāļĢāļ) + - [ ] 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 + - [ ] **Security:** Implement permission checks āļŠāļģāļŦāļĢāļąāļš user management + - [ ] **Deliverable:** āļˆāļąāļ”āļāļēāļĢāļœāļđāđ‰āđƒāļŠāđ‰, Role, āđāļĨāļ° Preferences āđ„āļ”āđ‰ + - [ ] **Dependencies:** T1.1, T1.2 + +- **[ ] T1.4 RBAC Guard - 4-Level Authorization** + + - [ ] āļŠāļĢāđ‰āļēāļ‡ @RequirePermission() Decorator + - [ ] āļŠāļĢāđ‰āļēāļ‡ RbacGuard āļ—āļĩāđˆāļ•āļĢāļ§āļˆāļŠāļ­āļš 4 āļĢāļ°āļ”āļąāļš: + - [ ] Global Permissions + - [ ] Organization Permissions + - [ ] Project Permissions + - [ ] Contract Permissions + - [ ] Permission Hierarchy Logic + - [ ] Integration āļāļąāļš CASL + - [ ] **Security:** Implement audit logging āļŠāļģāļŦāļĢāļąāļš permission checks + - [ ] **Deliverable:** āļĢāļ°āļšāļšāļŠāļīāļ—āļ˜āļīāđŒāļ—āļģāļ‡āļēāļ™āđ„āļ”āđ‰āļ—āļąāđ‰āļ‡ 4 āļĢāļ°āļ”āļąāļš + - [ ] **Dependencies:** T1.1, T1.3 + +- **[ ] T1.5 ProjectModule - Base Structures** + + - [ ] āļŠāļĢāđ‰āļēāļ‡ Entities: + - [ ] Organization + - [ ] Project + - [ ] Contract + - [ ] ProjectOrganization (Junction) + - [ ] ContractOrganization (Junction) + - [ ] āļŠāļĢāđ‰āļēāļ‡ Services & Controllers: + - [ ] GET /organizations → List + - [ ] POST /projects → Create (Superadmin) + - [ ] GET /projects/:id/contracts → List Contracts + - [ ] POST /projects/:id/contracts → Create Contract + - [ ] **Security:** Implement data isolation āļĢāļ°āļŦāļ§āđˆāļēāļ‡ organizations + - [ ] **Deliverable:** āļˆāļąāļ”āļāļēāļĢāđ‚āļ„āļĢāļ‡āļŠāļĢāđ‰āļēāļ‡āđ‚āļ›āļĢāđ€āļˆāļāļ•āđŒāđ„āļ”āđ‰ + - [ ] **Dependencies:** T1.1, T1.2, T0.3 + +----- + +## **Phase 2: High-Integrity Data & File Management (āļŠāļąāļ›āļ”āļēāļŦāđŒāļ—āļĩāđˆ 4)** + +**Milestone:** Master Data, āļĢāļ°āļšāļšāļˆāļąāļ”āļāļēāļĢāđ„āļŸāļĨāđŒāđāļšāļš Transactional, Document Numbering āļ—āļĩāđˆāđ„āļĄāđˆāļĄāļĩ Race Condition, JSON details system āļžāļĢāđ‰āļ­āļĄāđƒāļŠāđ‰āļ‡āļēāļ™ + +### **Phase 2: Tasks** + +- **[ ] T2.1 Virtual Columns for JSON** + + - [ ] āļ­āļ­āļāđāļšāļš Migration Script āļŠāļģāļŦāļĢāļąāļšāļ•āļēāļĢāļēāļ‡āļ—āļĩāđˆāļĄāļĩ JSON Details + - [ ] āđ€āļžāļīāđˆāļĄ **Generated Columns (Virtual)** āļŠāļģāļŦāļĢāļąāļšāļŸāļīāļĨāļ”āđŒāļ—āļĩāđˆāđƒāļŠāđ‰ Search āļšāđˆāļ­āļĒāđ† (āđ€āļŠāđˆāļ™ `project_id`, `type`) āļžāļĢāđ‰āļ­āļĄ Index + - [ ] **Security:** Implement admin-only access āļŠāļģāļŦāļĢāļąāļš master data + - [ ] **Deliverable:** JSON Data Search Performance āļ”āļĩāļ‚āļķāđ‰āļ™ + - [ ] **Dependencies:** T0.3, T1.1, T1.5 + +- **[ ] T2.2 FileStorageService - Two-Phase Storage** + + - [ ] āļŠāļĢāđ‰āļēāļ‡ Attachment Entity + - [ ] āļŠāļĢāđ‰āļēāļ‡ FileStorageService: + - [ ] **Phase 1 (Upload):** API āļĢāļąāļšāđ„āļŸāļĨāđŒ → Scan Virus → Save āļĨāļ‡ `temp/` → Return `temp_id` + - [ ] **Phase 2 (Commit):** Method `commitFiles(tempIds[])` → āļĒāđ‰āļēāļĒāļˆāļēāļ `temp/` āđ„āļ› `permanent/{YYYY}/{MM}/` → Update DB + - [ ] File type validation (white-list: PDF, DWG, DOCX, XLSX, PPTX, ZIP) + - [ ] File size check (max 50MB) + - [ ] Generate checksum (SHA-256) + - [ ] **Cleanup Job:** āļŠāļĢāđ‰āļēāļ‡ Cron Job āļĨāļšāđ„āļŸāļĨāđŒāđƒāļ™ `temp/` āļ—āļĩāđˆāļ„āđ‰āļēāļ‡āđ€āļāļīāļ™ 24 āļŠāļĄ. **āđ‚āļ”āļĒāļ•āļĢāļ§āļˆāļŠāļ­āļšāļˆāļēāļāļ„āļ­āļĨāļąāļĄāļ™āđŒ `expires_at` āđƒāļ™āļ•āļēāļĢāļēāļ‡ `attachments`** + - [ ] āļŠāļĢāđ‰āļēāļ‡ Controller: + - [ ] POST /files/upload → { temp_id } (Protected) + - [ ] POST /files/commit → { attachment_id, url } (Protected) + - [ ] GET /files/:id/download → File Stream (Protected + Expiration) + - [ ] **Security:** Access Control - āļ•āļĢāļ§āļˆāļŠāļ­āļšāļŠāļīāļ—āļ˜āļīāđŒāļœāđˆāļēāļ™ Junction Table + - [ ] **Deliverable:** āļ­āļąāļ›āđ‚āļŦāļĨāļ”/āļ”āļēāļ§āļ™āđŒāđ‚āļŦāļĨāļ”āđ„āļŸāļĨāđŒāđ„āļ”āđ‰āļ­āļĒāđˆāļēāļ‡āļ›āļĨāļ­āļ”āļ āļąāļĒ āđāļšāļš Transactional + - [ ] **Dependencies:** T1.1, T1.4 + +- **[ ] T2.3 DocumentNumberingModule - Double-Lock Mechanism** + + - [ ] āļŠāļĢāđ‰āļēāļ‡ Entities: + - [ ] DocumentNumberFormat + - [ ] DocumentNumberCounter + - [ ] āļŠāļĢāđ‰āļēāļ‡ DocumentNumberingService: + - [ ] generateNextNumber(projectId, orgId, typeId, year) → string + - [ ] āđƒāļŠāđ‰ **Double-Lock Mechanism**: + 1. Acquire **Redis Lock** (Key: `doc_num:{project}:{type}`) + 2. Read DB & Calculate Next Number + 3. Update DB with **Optimistic Lock** Check (āđƒāļŠāđ‰ `@VersionColumn()`) + 4. Release Redis Lock + 5. Retry on Failure āļ”āđ‰āļ§āļĒ exponential backoff + - [ ] Fallback mechanism āđ€āļĄāļ·āđˆāļ­āļāļēāļĢāļ‚āļ­āđ€āļĨāļ‚āļĨāđ‰āļĄāđ€āļŦāļĨāļ§ + - [ ] Format āļ•āļēāļĄ Template: {ORG_CODE}-{TYPE_CODE}-{YEAR_SHORT}-{SEQ:4} + - **āđ„āļĄāđˆāļĄāļĩ Controller** (Internal Service āđ€āļ—āđˆāļēāļ™āļąāđ‰āļ™) + - [ ] **Security:** Implement audit log āļ—āļļāļāļ„āļĢāļąāđ‰āļ‡āļ—āļĩāđˆāļĄāļĩāļāļēāļĢ generate āđ€āļĨāļ‚āļ—āļĩāđˆ + - [ ] **Deliverable:** Service āļŠāļĢāđ‰āļēāļ‡āđ€āļĨāļ‚āļ—āļĩāđˆāđ€āļ­āļāļŠāļēāļĢāđ„āļ”āđ‰āļ–āļđāļāļ•āđ‰āļ­āļ‡āđāļĨāļ°āļ›āļĨāļ­āļ”āļ āļąāļĒ āđ„āļĄāđˆāļĄāļĩ Race Condition + - [ ] **Dependencies:** T1.1, T0.3 + +* **[ ] T2.3 DocumentNumberingModule - Token-Based & Double-Lock** (Updated) + * [ ] Update Entity: `DocumentNumberCounter` (Add `discipline_id` to PK) + * [ ] Implement Token Parser & Replacer Logic (`{DISCIPLINE}`, `{SUBTYPE_NUM}`) + * [ ] Update `generateNextNumber` to handle optional keys (Discipline/SubType) + * [ ] **Deliverable:** Flexible Numbering System + +- **[ ] T2.4 SecurityModule - Enhanced Security** + + - [ ] āļŠāļĢāđ‰āļēāļ‡ Input Validation Service: + - [ ] XSS Prevention + - [ ] SQL Injection Prevention + - [ ] CSRF Protection + - [ ] āļŠāļĢāđ‰āļēāļ‡ RateLimitGuard: + - [ ] Implement rate limiting āļ•āļēāļĄ strategy (anonymous: 100/hr, authenticated: 500-5000/hr) + - [ ] Different limits āļŠāļģāļŦāļĢāļąāļš endpoints āļ•āđˆāļēāļ‡āđ† + - [ ] āļŠāļĢāđ‰āļēāļ‡ Security Headers Middleware + - [ ] **Security:** Implement content security policy (CSP) + - [ ] **Deliverable:** Security layers āļ—āļģāļ‡āļēāļ™āđ„āļ”āđ‰ + - [ ] **Dependencies:** T1.1 + +- **[ ] T2.5 JSON Details & Schema Management** + + - [ ] T2.5.1 JsonSchemaModule - Schema Management: āļŠāļĢāđ‰āļēāļ‡ Service āļŠāļģāļŦāļĢāļąāļš Validate, get, register JSON schemas + - [ ] T2.5.2 DetailsService - Data Processing: āļŠāļĢāđ‰āļēāļ‡ Service āļŠāļģāļŦāļĢāļąāļš sanitize, transform, compress/decompress JSON + - [ ] T2.5.3 JSON Security & Validation: Implement security checks āđāļĨāļ° validation rules + - [ ] **Deliverable:** JSON schema system āļ—āļģāļ‡āļēāļ™āđ„āļ”āđ‰ + - [ ] **Dependencies:** T1.1 + +* **[ ] T2.6 MasterModule - Advanced Data (Req 6B)** (New) + * [ ] Update Entities: `Discipline`, `CorrespondenceSubType` + * [ ] Create Services/Controllers for CRUD Operations (Admin Panel Support) + * [ ] Implement Seeding Logic for initial 6B data + * [ ] **Deliverable:** API for managing Disciplines and Sub-types + * [ ] **Dependencies:** T1.1, T0.3 + +----- + +## **Phase 3: Unified Workflow Engine (āļŠāļąāļ›āļ”āļēāļŦāđŒāļ—āļĩāđˆ 5-6)** + +**Milestone:** āļĢāļ°āļšāļš Workflow āļāļĨāļēāļ‡āļ—āļĩāđˆāļĢāļ­āļ‡āļĢāļąāļšāļ—āļąāđ‰āļ‡ Routing āļ›āļāļ•āļī āđāļĨāļ° RFA + +### **Phase 3: Tasks** + +- **[ ] T3.1 WorkflowEngineModule (New)** + + - [ ] āļ­āļ­āļāđāļšāļš Generic Schema āļŠāļģāļŦāļĢāļąāļš Workflow State Machine + - [ ] Implement Service: `initializeWorkflow()`, `processAction()`, `getNextStep()` + - [ ] āļĢāļ­āļ‡āļĢāļąāļš Logic āļāļēāļĢ "āļ‚āđ‰āļēāļĄāļ‚āļąāđ‰āļ™āļ•āļ­āļ™" āđāļĨāļ° "āļŠāđˆāļ‡āļāļĨāļąāļš" āļ āļēāļĒāđƒāļ™ Engine āđ€āļ”āļĩāļĒāļ§ + - [ ] **Security:** Implement audit logging āļŠāļģāļŦāļĢāļąāļš workflow actions + - [ ] **Deliverable:** Unified Workflow Engine āļžāļĢāđ‰āļ­āļĄāđƒāļŠāđ‰āļ‡āļēāļ™ + - [ ] **Dependencies:** T1.1 + +- **[ ] T3.2 CorrespondenceModule - Basic CRUD** + + - [ ] āļŠāļĢāđ‰āļēāļ‡ Entities (Correspondence, Revision, Recipient, Tag, Reference, Attachment) + - [ ] āļŠāļĢāđ‰āļēāļ‡ CorrespondenceService (Create with Document Numbering, Update with new Revision, Soft Delete) + - [ ] āļŠāļĢāđ‰āļēāļ‡ Controllers (POST/GET/PUT/DELETE /correspondences) + - [ ] [New] Implement Impersonation Logic: āļ•āļĢāļ§āļˆāļŠāļ­āļš originatorId āđƒāļ™ DTO āļŦāļēāļāļĄāļĩāļāļēāļĢāļŠāđˆāļ‡āļĄāļē āļ•āđ‰āļ­āļ‡āđ€āļŠāđ‡āļ„āļ§āđˆāļē User āļ›āļąāļˆāļˆāļļāļšāļąāļ™āļĄāļĩāļŠāļīāļ—āļ˜āļīāđŒāļāļĢāļ°āļ—āļģāļāļēāļĢāđāļ—āļ™āļŦāļĢāļ·āļ­āđ„āļĄāđˆ (Superadmin) + - [ ] **Security:** Implement permission checks āļŠāļģāļŦāļĢāļąāļš document access + - [ ] **Deliverable:** āļŠāļĢāđ‰āļēāļ‡/āđāļāđ‰āđ„āļ‚/āļ”āļđāđ€āļ­āļāļŠāļēāļĢāđ„āļ”āđ‰ + - [ ] **Dependencies:** T1.1, T1.2, T1.3, T1.4, T1.5, T2.3, T2.2, T2.5 + +- **[ ] T3.3 CorrespondenceModule - Advanced Features** + + - [ ] Implement Status Transitions (DRAFT → SUBMITTED) + - [ ] Implement References (Link Documents) + - [ ] Implement Search (Basic) + - [ ] **Security:** Implement state transition validation + - [ ] **Deliverable:** Workflow āļžāļ·āđ‰āļ™āļāļēāļ™āļ—āļģāļ‡āļēāļ™āđ„āļ”āđ‰ + - [ ] **Dependencies:** T3.2 + +- **[ ] T3.4 Correspondence Integration with Workflow** + + - [ ] āđ€āļŠāļ·āđˆāļ­āļĄāļ•āđˆāļ­ `CorrespondenceService` āđ€āļ‚āđ‰āļēāļāļąāļš `WorkflowEngineModule` + - [ ] āļĒāđ‰āļēāļĒ Logic āļāļēāļĢ Routing āđ€āļ”āļīāļĄāļĄāļēāđƒāļŠāđ‰ Engine āđƒāļŦāļĄāđˆ + - [ ] āļŠāļĢāđ‰āļēāļ‡ API endpoints āļŠāļģāļŦāļĢāļąāļš Frontend (Templates, Pending Tasks, Bulk Action) + - [ ] **Security:** Implement permission checks āļŠāļģāļŦāļĢāļąāļš workflow operations + - [ ] **Deliverable:** āļĢāļ°āļšāļšāļŠāđˆāļ‡āļ•āđˆāļ­āđ€āļ­āļāļŠāļēāļĢāļ—āļģāļ‡āļēāļ™āđ„āļ”āđ‰āļŠāļĄāļšāļđāļĢāļ“āđŒāļ”āđ‰āļ§āļĒ Unified Engine + - [ ] **Dependencies:** T3.1, T3.2 + +----- + +## **Phase 4: Drawing & Advanced Workflows (āļŠāļąāļ›āļ”āļēāļŦāđŒāļ—āļĩāđˆ 7-8)** + +**Milestone:** āļāļēāļĢāļˆāļąāļ”āļāļēāļĢāđāļšāļšāđāļĨāļ° RFA āđ‚āļ”āļĒāđƒāļŠāđ‰ Unified Engine + +### **Phase 4: Tasks** + +- **[ ] T4.1 DrawingModule - Contract Drawings** + + - [ ] āļŠāļĢāđ‰āļēāļ‡ Entities (ContractDrawing, Volume, Category, SubCategory, Attachment) + - [ ] āļŠāļĢāđ‰āļēāļ‡ ContractDrawingService CRUD + - [ ] āļŠāļĢāđ‰āļēāļ‡ Controllers (GET/POST /drawings/contract) + - [ ] **Security:** Implement access control āļŠāļģāļŦāļĢāļąāļš contract drawings + - [ ] **Deliverable:** āļˆāļąāļ”āļāļēāļĢ Contract Drawings āđ„āļ”āđ‰ + - [ ] **Dependencies:** T1.1, T1.2, T1.4, T1.5, T2.2 + +- **[ ] T4.2 DrawingModule - Shop Drawings** + + - [ ] āļŠāļĢāđ‰āļēāļ‡ Entities (ShopDrawing, Revision, Main/SubCategory, ContractRef, RevisionAttachment) + - [ ] āļŠāļĢāđ‰āļēāļ‡ ShopDrawingService CRUD (āļĢāļ§āļĄāļāļēāļĢāļŠāļĢāđ‰āļēāļ‡ Revision) + - [ ] āļŠāļĢāđ‰āļēāļ‡ Controllers (GET/POST /drawings/shop, /drawings/shop/:id/revisions) + - [ ] Link Shop Drawing Revision → Contract Drawings + - [ ] **Security:** Implement virus scanning āļŠāļģāļŦāļĢāļąāļš drawing files + - [ ] **Deliverable:** āļˆāļąāļ”āļāļēāļĢ Shop Drawings āđāļĨāļ° Revisions āđ„āļ”āđ‰ + - [ ] **Dependencies:** T4.1 + +- **[ ] T5.1 RfaModule with Unified Workflow** + + - [ ] āļŠāļĢāđ‰āļēāļ‡ Entities (Rfa, RfaRevision, RfaItem, RfaWorkflowTemplate/Step) + - [ ] āļŠāļĢāđ‰āļēāļ‡ RfaService (Create RFA, Link Shop Drawings) + - [ ] Implement RFA Workflow āđ‚āļ”āļĒāđƒāļŠāđ‰ Configuration āļ‚āļ­āļ‡ `WorkflowEngineModule` + - [ ] āļŠāļĢāđ‰āļēāļ‡ Controllers (POST/GET /rfas, POST /rfas/:id/workflow/...) + - [ ] **Resilience:** Implement circuit breaker āļŠāļģāļŦāļĢāļąāļš notification services + - [ ] **Deliverable:** RFA Workflow āļ—āļģāļ‡āļēāļ™āđ„āļ”āđ‰āļ”āđ‰āļ§āļĒ Unified Engine + - [ ] **Dependencies:** T3.2, T4.2, T2.5, T6.2 + +----- + +## **Phase 5: Workflow Systems & Resilience (āļŠāļąāļ›āļ”āļēāļŦāđŒāļ—āļĩāđˆ 8-9)** + +**Milestone:** āļĢāļ°āļšāļš Workflow āļ—āļąāđ‰āļ‡āļŦāļĄāļ”āļžāļĢāđ‰āļ­āļĄ Resilience Patterns + +### **Phase 5: Tasks** + +- **[ ] T5.2 CirculationModule - Internal Routing** + + - [ ] āļŠāļĢāđ‰āļēāļ‡ Entities (Circulation, Template, Routing, Attachment) + - [ ] āļŠāļĢāđ‰āļēāļ‡ CirculationService (Create 1:1 with Correspondence, Assign User, Complete/Close Step) + - [ ] āļŠāļĢāđ‰āļēāļ‡ Controllers (POST/GET /circulations, POST /circulations/:id/steps/...) + - [ ] **Resilience:** Implement retry mechanism āļŠāļģāļŦāļĢāļąāļš assignment notifications + - [ ] **Deliverable:** āđƒāļšāđ€āļ§āļĩāļĒāļ™āļ āļēāļĒāđƒāļ™āļ­āļ‡āļ„āđŒāļāļĢāļ—āļģāļ‡āļēāļ™āđ„āļ”āđ‰ + - [ ] **Dependencies:** T3.2, T2.5, T6.2 + +- **[ ] T5.3 TransmittalModule - Document Forwarding** + + - [ ] āļŠāļĢāđ‰āļēāļ‡ Entities (Transmittal, TransmittalItem) + - [ ] āļŠāļĢāđ‰āļēāļ‡ TransmittalService (Create Correspondence + Transmittal, Link Multiple Correspondences) + - [ ] āļŠāļĢāđ‰āļēāļ‡ Controllers (POST/GET /transmittals) + - [ ] **Security:** Implement access control āļŠāļģāļŦāļĢāļąāļš transmittal items + - [ ] **Deliverable:** āļŠāļĢāđ‰āļēāļ‡ Transmittal āđ„āļ”āđ‰ + - [ ] **Dependencies:** T3.2 + +----- + +## **Phase 6: Notification & Resilience (āļŠāļąāļ›āļ”āļēāļŦāđŒāļ—āļĩāđˆ 9)** + +**Milestone:** āļĢāļ°āļšāļšāđāļˆāđ‰āļ‡āđ€āļ•āļ·āļ­āļ™āđāļšāļš Digest āđāļĨāļ°āļāļēāļĢāļˆāļąāļ”āļāļēāļĢāļ‚āđ‰āļ­āļĄāļđāļĨāļ‚āļ™āļēāļ”āđƒāļŦāļāđˆ + +### **Phase 6: Tasks** + +- **[ ] T6.1 SearchModule - Elasticsearch Integration** + + - [ ] Setup Elasticsearch Container + - [ ] āļŠāļĢāđ‰āļēāļ‡ SearchService (index/update/delete documents, search) + - [ ] Index āļ—āļļāļ Document Type + - [ ] āļŠāļĢāđ‰āļēāļ‡ Controllers (GET /search) + - [ ] **Resilience:** Implement circuit breaker āļŠāļģāļŦāļĢāļąāļš Elasticsearch + - [ ] **Deliverable:** āļ„āđ‰āļ™āļŦāļēāļ‚āļąāđ‰āļ™āļŠāļđāļ‡āļ—āļģāļ‡āļēāļ™āđ„āļ”āđ‰ + - [ ] **Dependencies:** T3.2, T5.1, T4.2, T5.2, T5.3 + +- **[ ] T6.2 Notification Queue & Digest** + + - [ ] āļŠāļĢāđ‰āļēāļ‡ NotificationService (sendEmail/Line/System) + - [ ] **Producer:** Push Event āļĨāļ‡ BullMQ Queue + - [ ] **Consumer:** āļˆāļąāļ”āļāļĨāļļāđˆāļĄ Notification (Digest Message) āđāļĨāļ°āļŠāđˆāļ‡āļœāđˆāļēāļ™ Email/Line + - [ ] Integrate āļāļąāļš Workflow Events (āđāļˆāđ‰āļ‡ Recipients, Assignees, Deadline) + - [ ] āļŠāļĢāđ‰āļēāļ‡ Controllers (GET /notifications, PUT /notifications/:id/read) + - [ ] **Resilience:** Implement retry mechanism āļ”āđ‰āļ§āļĒ exponential backoff + - [ ] **Deliverable:** āļĢāļ°āļšāļšāđāļˆāđ‰āļ‡āđ€āļ•āļ·āļ­āļ™āļ—āļģāļ‡āļēāļ™āđ„āļ”āđ‰āđāļšāļš Digest + - [ ] **Dependencies:** T1.1, T6.4 + +- **[ ] T6.3 MonitoringModule - Observability** + + - [ ] āļŠāļĢāđ‰āļēāļ‡ Health Check Controller (GET /health) + - [ ] āļŠāļĢāđ‰āļēāļ‡ Metrics Service (API response times, Error rates) + - [ ] āļŠāļĢāđ‰āļēāļ‡ Performance Interceptor (Track request duration) + - [ ] āļŠāļĢāđ‰āļēāļ‡ Logging Service (Structured logging) + - [ ] **Deliverable:** Monitoring system āļ—āļģāļ‡āļēāļ™āđ„āļ”āđ‰ + - [ ] **Dependencies:** T1.1 + +- **[ ] T6.4 ResilienceModule - Circuit Breaker & Retry** + + - [ ] āļŠāļĢāđ‰āļēāļ‡ Circuit Breaker Service (@CircuitBreaker() decorator) + - [ ] āļŠāļĢāđ‰āļēāļ‡ Retry Service (@Retry() decorator) + - [ ] āļŠāļĢāđ‰āļēāļ‡ Fallback Strategies + - [ ] Implement āļŠāļģāļŦāļĢāļąāļš Email, LINE, Elasticsearch, Virus Scanning + - [ ] **Deliverable:** Resilience patterns āļ—āļģāļ‡āļēāļ™āđ„āļ”āđ‰ + - [ ] **Dependencies:** T1.1 + +- **[ ] T6.5 Data Partitioning Strategy** + + - [ ] āļ­āļ­āļāđāļšāļš Table Partitioning āļŠāļģāļŦāļĢāļąāļš `audit_logs` āđāļĨāļ° `notifications` (āđāļšāđˆāļ‡āļ•āļēāļĄ Range: Year) + - [ ] āđ€āļ‚āļĩāļĒāļ™ Raw SQL Migration āļŠāļģāļŦāļĢāļąāļšāļŠāļĢāđ‰āļēāļ‡ Partition Table + - [ ] **Deliverable:** Database Performance āđāļĨāļ° Scalability āļ”āļĩāļ‚āļķāđ‰āļ™ + - [ ] **Dependencies:** T0.3 + +----- + +## **Phase 7: Testing & Hardening (āļŠāļąāļ›āļ”āļēāļŦāđŒāļ—āļĩāđˆ 10-12)** + +**Milestone:** āļ—āļ”āļŠāļ­āļšāļ„āļ§āļēāļĄāļ—āļ™āļ—āļēāļ™āļ•āđˆāļ­ Race Condition, Security, āđāļĨāļ° Performance + +### **Phase 7: Tasks** + +- **[ ] T7.1 Concurrency Testing** + + - [ ] āđ€āļ‚āļĩāļĒāļ™ Test Scenarios āļĒāļīāļ‡ Request āļ‚āļ­āđ€āļĨāļ‚āļ—āļĩāđˆāđ€āļ­āļāļŠāļēāļĢāļžāļĢāđ‰āļ­āļĄāļāļąāļ™ 100 Request (āļ•āđ‰āļ­āļ‡āđ„āļĄāđˆāļ‹āđ‰āļģāđāļĨāļ°āđ„āļĄāđˆāļ‚āđ‰āļēāļĄ) + - [ ] āļ—āļ”āļŠāļ­āļš Optimistic Lock āļ—āļģāļ‡āļēāļ™āļ–āļđāļāļ•āđ‰āļ­āļ‡āđ€āļĄāļ·āđˆāļ­ Redis āļ–āļđāļāļ›āļīāļ” + - [ ] āļ—āļ”āļŠāļ­āļš File Upload āļžāļĢāđ‰āļ­āļĄāļāļąāļ™āļŦāļĨāļēāļĒāđ„āļŸāļĨāđŒ + - [ ] **Deliverable:** āļĢāļ°āļšāļšāļ—āļ™āļ—āļēāļ™āļ•āđˆāļ­ Concurrency Issues + +- **[ ] T7.2 Transaction Integrity Testing** + + - [ ] āļ—āļ”āļŠāļ­āļš Upload āđ„āļŸāļĨāđŒāđāļĨāđ‰āļ§ Kill Process āļāđˆāļ­āļ™ Commit + - [ ] āļ—āļ”āļŠāļ­āļš Two-Phase File Storage āļ—āļģāļ‡āļēāļ™āļ–āļđāļāļ•āđ‰āļ­āļ‡ + - [ ] āļ—āļ”āļŠāļ­āļš Database Transaction Rollback Scenarios + - [ ] **Deliverable:** Data Integrity āļĢāļąāļšāļ›āļĢāļ°āļāļąāļ™āđ„āļ”āđ‰ + +- **[ ] T7.3 Security & Idempotency Test** + + - [ ] āļ—āļ”āļŠāļ­āļš Replay Attack āđ‚āļ”āļĒāđƒāļŠāđ‰ `Idempotency-Key` āļ‹āđ‰āļģ + - [ ] āļ—āļ”āļŠāļ­āļš Maintenance Mode Block API āđ„āļ”āđ‰āļˆāļĢāļīāļ‡ + - [ ] āļ—āļ”āļŠāļ­āļš RBAC 4-Level āļ—āļģāļ‡āļēāļ™āļ–āļđāļāļ•āđ‰āļ­āļ‡ 100% + - [ ] **Deliverable:** Security āđāļĨāļ° Idempotency āļ—āļģāļ‡āļēāļ™āđ„āļ”āđ‰āļ•āļēāļĄčŪūčŪĄčĶæą‚ + +- **[ ] T7.4 Unit Testing (80% Coverage)** + +- **[ ] T7.5 Integration Testing** + +- **[ ] T7.6 E2E Testing** + +- **[ ] T7.7 Performance Testing** + + - [ ] Load Testing: 100 concurrent users + - [ ] **(āļŠāļģāļ„āļąāļ)** āļāļēāļĢāļˆāļđāļ™āđāļĨāļ°āļ—āļ”āļŠāļ­āļš Load Test āļˆāļ°āļ•āđ‰āļ­āļ‡āļ—āļģāđƒāļ™āļŠāļ āļēāļžāđāļ§āļ”āļĨāđ‰āļ­āļĄāļ—āļĩāđˆāļˆāļģāļĨāļ­āļ‡ Spec āļ‚āļ­āļ‡ QNAP Server (TS-473A, AMD Ryzen V1500B) āđ€āļžāļ·āđˆāļ­āđƒāļŦāđ‰āđ„āļ”āđ‰āļ„āđˆāļē Response Time āđāļĨāļ° Connection Pool āļ—āļĩāđˆāđ€āļ—āļĩāđˆāļĒāļ‡āļ•āļĢāļ‡ + - [ ] Stress Testing + - [ ] Endurance Testing + - [ ] **Deliverable:** Performance targets āļšāļĢāļĢāļĨāļļ + +- **[ ] T7.8 Security Testing** + + - [ ] Penetration Testing (OWASP Top 10) + - [ ] Security Audit (Code review, Dependency scanning) + - [ ] File Upload Security Testing + - [ ] **Deliverable:** Security tests āļœāđˆāļēāļ™ + +- **[ ] T7.9 Performance Optimization** + + - [ ] Implement Caching (Master Data, User Permissions, Search Results) + - [ ] Database Optimization (Review Indexes, Query Optimization, Pagination) + - [ ] **Deliverable:** Response Time < 200ms (90th percentile) + +----- + +## **Phase 8: Documentation & Deployment (āļŠāļąāļ›āļ”āļēāļŦāđŒāļ—āļĩāđˆ 14)** + +**Milestone:** āđ€āļ­āļāļŠāļēāļĢāđāļĨāļ° Deploy āļŠāļđāđˆ Production āļžāļĢāđ‰āļ­āļĄ Security Hardening + +### **Phase 8: Tasks** + +- **[ ] T8.1 API Documentation (Swagger)** +- **[ ] T8.2 Technical Documentation** +- **[ ] T8.3 Security Hardening** +- **[ ] T8.4 Deployment Preparation (QNAP Setup, Nginx Proxy Manager)** +- **[ ] T8.5 Production Deployment** +- **[ ] T8.6 Handover to Frontend Team** + +----- + +## 📊 **āļŠāļĢāļļāļ› Timeline** + +| Phase | āļĢāļ°āļĒāļ°āđ€āļ§āļĨāļē | āļˆāļģāļ™āļ§āļ™āļ‡āļēāļ™ | Output āļŦāļĨāļąāļ | +| :------ | :----------- | :----------- | :--------------------------------------------- | +| Phase 0 | 1 āļŠāļąāļ›āļ”āļēāļŦāđŒ | 4 | Infrastructure Ready + Security Base | +| Phase 1 | 2 āļŠāļąāļ›āļ”āļēāļŦāđŒ | 5 | Auth & User Management + RBAC + Idempotency | +| Phase 2 | 1 āļŠāļąāļ›āļ”āļēāļŦāđŒ | 5 | High-Integrity Data & File Management | +| Phase 3 | 2 āļŠāļąāļ›āļ”āļēāļŦāđŒ | 4 | Unified Workflow Engine + Correspondence | +| Phase 4 | 2 āļŠāļąāļ›āļ”āļēāļŦāđŒ | 3 | Drawing Management + RFA with Unified Workflow | +| Phase 5 | 2 āļŠāļąāļ›āļ”āļēāļŦāđŒ | 2 | Workflow Systems + Resilience | +| Phase 6 | 1 āļŠāļąāļ›āļ”āļēāļŦāđŒ | 5 | Notification & Resilience + Data Partitioning | +| Phase 7 | 3 āļŠāļąāļ›āļ”āļēāļŦāđŒ | 9 | Testing & Hardening | +| Phase 8 | 1 āļŠāļąāļ›āļ”āļēāļŦāđŒ | 6 | Documentation & Deploy | +| **āļĢāļ§āļĄ** | **15 āļŠāļąāļ›āļ”āļēāļŦāđŒ** | **39 Tasks** | **Production-Ready Backend v1.4.2** | + +## **Document Control:** + +- **Document:** Backend Development Plan v1.4.3 +- **Version:** 1.4 +- **Date:** 2025-11-26 +- **Author:** NAP LCBP3-DMS & Gemini +- **Status:** FINAL-Rev.04 +- **Classification:** Internal Technical Documentation +- **Approved By:** Nattanin + +----- + +`End of Backend Development Plan v1.4.4` diff --git a/3_Frontend_Plan_V1_4_4.md b/3_Frontend_Plan_V1_4_4.md new file mode 100644 index 0000000..c6139d7 --- /dev/null +++ b/3_Frontend_Plan_V1_4_4.md @@ -0,0 +1,1008 @@ +# 📋 **āđāļœāļ™āļāļēāļĢāļžāļąāļ’āļ™āļē Frontend (Next.js) - LCBP3-DMS v1.4.4** + +**āļŠāļ–āļēāļ™āļ°:** FINAL GUIDELINE Rev.04 +**āļ§āļąāļ™āļ—āļĩāđˆ:** 2025-11-26 +**āļ­āđ‰āļēāļ‡āļ­āļīāļ‡:** Requirements v1.4.3 & FullStackJS Guidelines v1.4.3 +**Classification:** Internal Technical Documentation + +## ðŸŽŊ **āļ āļēāļžāļĢāļ§āļĄāđ‚āļ„āļĢāļ‡āļāļēāļĢ** + +āļžāļąāļ’āļ™āļē Frontend āļŠāļģāļŦāļĢāļąāļšāļĢāļ°āļšāļšāļšāļĢāļīāļŦāļēāļĢāļˆāļąāļ”āļāļēāļĢāđ€āļ­āļāļŠāļēāļĢāđ‚āļ„āļĢāļ‡āļāļēāļĢ (Document Management System) āļ—āļĩāđˆāļĄāļĩāļ„āļ§āļēāļĄāļ—āļąāļ™āļŠāļĄāļąāļĒ āļĢāļ­āļ‡āļĢāļąāļšāļāļēāļĢāļ—āļģāļ‡āļēāļ™āļšāļ™āļ­āļļāļ›āļāļĢāļ“āđŒāļ•āđˆāļēāļ‡āđ† āđ„āļ”āđ‰āļ­āļĒāđˆāļēāļ‡āļŠāļĄāļšāļđāļĢāļ“āđŒ āļĄāļĩāļ›āļĢāļ°āļŠāļšāļāļēāļĢāļ“āđŒāļœāļđāđ‰āđƒāļŠāđ‰āļ—āļĩāđˆāļĢāļēāļšāļĢāļ·āđˆāļ™ āđāļĨāļ°āļĢāļ­āļ‡āļĢāļąāļšāļāļēāļĢāļ—āļģāļ‡āļēāļ™āđāļšāļš Offline āđ€āļšāļ·āđ‰āļ­āļ‡āļ•āđ‰āļ™ + +--- + +## 📐 **āļŠāļ–āļēāļ›āļąāļ•āļĒāļāļĢāļĢāļĄāļĢāļ°āļšāļš** + +### **Technology Stack** + +- **Framework:** Next.js 14+ (App Router, React 18, TypeScript, ESM) +- **Styling:** Tailwind CSS + PostCSS +- **UI Components:** shadcn/ui + Radix UI Primitives +- **State Management:** + - **Server State:** TanStack Query (React Query) + - **Client State:** Zustand + - **Form State:** React Hook Form + Zod +- **API Client:** Axios (āļžāļĢāđ‰āļ­āļĄ Idempotency Interceptor) +- **Authentication:** NextAuth.js (āļĢāļ­āļ‡āļĢāļąāļš JWT) +- **File Upload:** Custom Hook + Drag & Drop +- **Testing:** + - **Unit/Integration:** Vitest + React Testing Library + - **E2E:** Playwright + - **Mocking:** MSW (Mock Service Worker) +- **Development:** + - **Package Manager:** pnpm + - **Linting:** ESLint + Prettier + - **Type Checking:** TypeScript Strict Mode + +### **āđ‚āļ„āļĢāļ‡āļŠāļĢāđ‰āļēāļ‡āđ‚āļ›āļĢāđ€āļˆāļāļ•āđŒ** + +```tree +app/ +├── (auth)/ +│ ├── login/ +│ └── register/ +├── (dashboard)/ +│ ├── layout.tsx +│ ├── page.tsx +│ └── components/ +├── admin/ +│ ├── users/ +│ ├── roles/ +│ └── numbering-formats/ +├── correspondences/ +│ ├── page.tsx +│ ├── [id]/ +│ └── new/ +├── rfas/ +│ ├── page.tsx +│ ├── [id]/ +│ └── new/ +├── drawings/ +├── circulations/ +├── transmittals/ +├── search/ +└── profile/ + +components/ +├── ui/ # shadcn/ui components +├── forms/ # Dynamic form components +├── tables/ # Responsive data tables +├── workflow/ # Workflow visualization +├── file-upload/ # File upload with security +├── notifications/ # Notification system +└── layout/ # App layout components + +lib/ +├── api/ # API clients & interceptors +├── auth/ # Authentication utilities +├── stores/ # Zustand stores +├── hooks/ # Custom React hooks +├── utils/ # Utility functions +├── constants/ # App constants +└── types/ # TypeScript type definitions + +styles/ +├── globals.css +└── components/ + +__tests__/ +├── unit/ +├── integration/ +└── e2e/ +``` + +--- + +## 🗓ïļ **āđāļœāļ™āļāļēāļĢāļžāļąāļ’āļ™āļēāđāļšāļš Phase-Based** + +### **Dependency Diagram (āļ āļēāļžāļĢāļ§āļĄ)** + +```mermaid +%% Phase 0: Foundation Setup +subgraph Phase0 [Phase 0: Foundation & Configuration] + F0_1[F0.1: Project Setup & Tooling] + F0_2[F0.2: Design System & UI Components] + F0_3[F0.3: API Client & Authentication] + F0_4[F0.4: State Management Setup] +end + +%% Phase 1: Core Layout & Navigation +subgraph Phase1 [Phase 1: Core Application Structure] + F1_1[F1.1: Main Layout & Navigation] + F1_2[F1.2: Authentication Pages] + F1_3[F1.3: Dashboard & Landing] + F1_4[F1.4: Responsive Design System] +end + +%% Phase 2: User Management & Profile +subgraph Phase2 [Phase 2: User Management & Security] + F2_1[F2.1: User Profile & Settings] + F2_2[F2.2: Admin Panel - User Management] + F2_3[F2.3: Admin Panel - Role Management] + F2_4[F2.4: Permission Integration] +end + +%% Phase 3: Project & Organization Management +subgraph Phase3 [Phase 3: Project Structure] + F3_1[F3.1: Project Management UI] + F3_2[F3.2: Organization Management] + F3_3[F3.3: Contract Management] +end + +%% Phase 4: Correspondence Management +subgraph Phase4 [Phase 4: Correspondence System] + F4_1[F4.1: Correspondence List & Search] + F4_2[F4.2: Correspondence Creation Form] + F4_3[F4.3: Correspondence Detail View] + F4_4[F4.4: File Upload Integration] +end + +%% Phase 5: Workflow & Routing System +subgraph Phase5 [Phase 5: Workflow Management] + F5_1[F5.1: Workflow Visualization Component] + F5_2[F5.2: Routing Template Management] + F5_3[F5.3: Workflow Step Actions] + F5_4[F5.4: Real-time Status Updates] +end + +%% Phase 6: Drawing Management +subgraph Phase6 [Phase 6: Drawing System] + F6_1[F6.1: Contract Drawings Management] + F6_2[F6.2: Shop Drawings Management] + F6_3[F6.3: Drawing Revision System] + F6_4[F6.4: Drawing References] +end + +%% Phase 7: RFA & Approval Workflows +subgraph Phase7 [Phase 7: RFA System] + F7_1[F7.1: RFA List & Dashboard] + F7_2[F7.2: RFA Creation with Dynamic Forms] + F7_3[F7.3: RFA Workflow Integration] + F7_4[F7.4: RFA Approval Interface] +end + +%% Phase 8: Circulation & Internal Routing +subgraph Phase8 [Phase 8: Internal Workflows] + F8_1[F8.1: Circulation Management] + F8_2[F8.2: Task Assignment Interface] + F8_3[F8.3: Internal Approval Flows] +end + +%% Phase 9: Advanced Features +subgraph Phase9 [Phase 9: Advanced Features] + F9_1[F9.1: Advanced Search Interface] + F9_2[F9.2: Notification System] + F9_3[F9.3: Reporting & Analytics] + F9_4[F9.4: Mobile Optimization] +end + +%% Phase 10: Testing & Optimization +subgraph Phase10 [Phase 10: Testing & Polish] + F10_1[F10.1: Comprehensive Testing] + F10_2[F10.2: Performance Optimization] + F10_3[F10.3: Security Hardening] + F10_4[F10.4: Documentation] +end + +%% Dependencies +F0_1 --> F0_2 +F0_1 --> F0_3 +F0_1 --> F0_4 + +F0_2 --> F1_1 +F0_3 --> F1_1 +F0_4 --> F1_1 +F1_1 --> F1_2 +F1_1 --> F1_3 +F1_1 --> F1_4 + +F1_1 --> F2_1 +F1_3 --> F2_1 +F0_3 --> F2_1 +F2_1 --> F2_2 +F2_2 --> F2_3 +F2_3 --> F2_4 + +F1_1 --> F3_1 +F2_4 --> F3_1 +F3_1 --> F3_2 +F3_2 --> F3_3 + +F1_1 --> F4_1 +F3_1 --> F4_1 +F4_1 --> F4_2 +F4_2 --> F4_3 +F4_2 --> F4_4 + +F4_1 --> F5_1 +F4_2 --> F5_2 +F4_3 --> F5_3 +F5_1 --> F5_4 + +F3_1 --> F6_1 +F4_4 --> F6_1 +F6_1 --> F6_2 +F6_2 --> F6_3 +F6_3 --> F6_4 + +F4_1 --> F7_1 +F5_1 --> F7_1 +F6_2 --> F7_1 +F7_1 --> F7_2 +F7_2 --> F7_3 +F7_3 --> F7_4 + +F4_1 --> F8_1 +F5_3 --> F8_1 +F8_1 --> F8_2 +F8_2 --> F8_3 + +F4_1 --> F9_1 +F7_1 --> F9_1 +F1_3 --> F9_2 +F5_4 --> F9_2 +F1_3 --> F9_3 +F1_4 --> F9_4 + +F1_1 --> F10_1 +F4_1 --> F10_1 +F7_1 --> F10_1 +F10_1 --> F10_2 +F10_2 --> F10_3 +F10_3 --> F10_4 +``` + +## **Phase 0: Foundation & Configuration (āļŠāļąāļ›āļ”āļēāļŦāđŒāļ—āļĩāđˆ 1)** + +**Milestone:** āđ‚āļ„āļĢāļ‡āļŠāļĢāđ‰āļēāļ‡āļžāļ·āđ‰āļ™āļāļēāļ™āļžāļĢāđ‰āļ­āļĄ āļĢāļ­āļ‡āļĢāļąāļš Development Workflow āļ—āļĩāđˆāļĄāļĩāļ›āļĢāļ°āļŠāļīāļ—āļ˜āļīāļ āļēāļž + +### **Phase 0: Tasks** + +- **[ ] F0.1 Project Setup & Tooling** + - [ ] Initialize Next.js 14+ project with TypeScript + - [ ] Configure pnpm workspace + - [ ] Setup ESLint, Prettier, and pre-commit hooks + - [ ] Configure Tailwind CSS with PostCSS + - [ ] Setup shadcn/ui components + - [ ] Configure absolute imports and path aliases + - [ ] **Deliverable:** Development environment ready + - [ ] **Dependencies:** None + +- **[ ] F0.2 Design System & UI Components** + - [ ] Setup color palette and design tokens + - [ ] Create responsive design breakpoints + - [ ] Implement core shadcn/ui components: + - [ ] Button, Input, Label, Form + - [ ] Card, Table, Badge + - [ ] Dialog, Dropdown, Select + - [ ] Tabs, Accordion + - [ ] Create custom design system components: + - [ ] DataTable (responsive) + - [ ] FileUpload zone + - [ ] Workflow visualization + - [ ] **Deliverable:** Consistent UI component library + - [ ] **Dependencies:** F0.1 + +- **[ ] F0.3 API Client & Authentication** + - [ ] Setup Axios client with interceptors: + - [ ] Idempotency-Key header injection + - [ ] Authentication token management + - [ ] Error handling and retry logic + - [ ] Configure NextAuth.js for JWT authentication + - [ ] Create auth hooks (useAuth, usePermissions) + - [ ] Setup API route handlers for auth callbacks + - [ ] **Security:** Implement secure token storage + - [ ] **Deliverable:** Secure API communication layer + - [ ] **Dependencies:** F0.1 + +- **[ ] F0.4 State Management Setup** + - [ ] Configure TanStack Query for server state: + - [ ] Query client setup + - [ ] Default configurations + - [ ] Error boundaries + - [ ] Create Zustand stores: + - [ ] Auth store (user, permissions) + - [ ] UI store (theme, sidebar state) + - [ ] Draft store (form auto-save) + - [ ] Setup React Hook Form with Zod integration + - [ ] Create form validation schemas + - [ ] **Deliverable:** Robust state management system + - [ ] **Dependencies:** F0.1, F0.3 + +### **Phase 0: Testing - Foundation** + +#### **F0.T1 Component Test Suite** + +- [ ] **Unit Tests:** Core UI components (Button, Input, Card) +- [ ] **Integration Tests:** Form validation, API client interceptors +- [ ] **Visual Tests:** Component styling and responsive behavior + +#### **F0.T2 Authentication Test Suite** + +- [ ] **Unit Tests:** Auth hooks, token management +- [ ] **Integration Tests:** Login/logout flow, permission checks +- [ ] **Security Tests:** Token security, API authentication + +--- + +## **Phase 1: Core Application Structure (āļŠāļąāļ›āļ”āļēāļŦāđŒāļ—āļĩāđˆ 2)** + +**Milestone:** Layout āļŦāļĨāļąāļāļžāļĢāđ‰āļ­āļĄāđƒāļŠāđ‰āļ‡āļēāļ™ āļāļēāļĢāļ™āļģāļ—āļēāļ‡āđāļĨāļ° Authentication āļ—āļģāļ‡āļēāļ™āđ„āļ”āđ‰ + +### **Phase 1: Tasks** + +- **[ ] F1.1 Main Layout & Navigation** + - [ ] Create App Shell layout: + - [ ] Navbar with user menu and notifications + - [ ] Collapsible sidebar with navigation + - [ ] Main content area with responsive design + - [ ] Implement navigation menu structure: + - [ ] Dashboard, Correspondences, RFAs, Drawings, etc. + - [ ] Dynamic menu based on user permissions + - [ ] Create breadcrumb navigation component + - [ ] Implement mobile-responsive sidebar (drawer) + - [ ] Maintenance Mode Integration: + - [ ] Implement a Global Middleware/Wrapper āļ—āļĩāđˆāļ•āļĢāļ§āļˆāļŠāļ­āļšāļŠāļ–āļēāļ™āļ° Maintenance Mode āļœāđˆāļēāļ™ API/Service āļāđˆāļ­āļ™āļāļēāļĢ Render āļŦāļ™āđ‰āļē āļŦāļēāļāļŠāļ–āļēāļ™āļ°āđ€āļ›āđ‡āļ™ true āđƒāļŦāđ‰ Redirect āļœāļđāđ‰āđƒāļŠāđ‰ (āļĒāļāđ€āļ§āđ‰āļ™ Admin) āđ„āļ›āļĒāļąāļ‡āļŦāļ™āđ‰āļē /maintenance āļ—āļąāļ™āļ—āļĩ āđ€āļžāļ·āđˆāļ­āđƒāļŦāđ‰āļŠāļ­āļ”āļ„āļĨāđ‰āļ­āļ‡āļāļąāļš Logic āļ‚āļ­āļ‡ Backend. + - [ ] **Accessibility:** Ensure keyboard navigation and screen reader support + - [ ] **Deliverable:** Fully functional application layout + - [ ] **Dependencies:** F0.2, F0.3 + +- **[ ] F1.2 Authentication Pages** + - [ ] Create login page with form validation + - [ ] Implement forgot password flow + - [ ] Create registration page (admin-only) + - [ ] Setup protected route middleware + - [ ] Implement route-based permission checks + - [ ] **Security:** Rate limiting on auth attempts, secure password requirements + - [ ] **Deliverable:** Complete authentication flow + - [ ] **Dependencies:** F0.3, F1.1 + +- **[ ] F1.3 Dashboard & Landing** + - [ ] Create public landing page for non-authenticated users + - [ ] Implement main dashboard with: + - [ ] KPI cards (document counts, pending tasks) + - [ ] "My Tasks" table from v_user_tasks + - [ ] Recent activity feed + - [ ] Security metrics display + - [ ] Create dashboard widgets system + - [ ] Implement data fetching with TanStack Query + - [ ] **Performance:** Optimize dashboard data loading + - [ ] **Deliverable:** Functional dashboard with real data + - [ ] **Dependencies:** F0.4, F1.1 + +- **[ ] F1.4 Responsive Design System** + - [ ] Implement mobile-first responsive design + - [ ] Create card view components for mobile tables + - [ ] Setup touch-friendly interactions + - [ ] Optimize images and assets for mobile + - [ ] Test across multiple device sizes + - [ ] **UX:** Ensure seamless mobile experience + - [ ] **Deliverable:** Fully responsive application + - [ ] **Dependencies:** F0.2, F1.1 + +### **Phase 1: Testing - Core Structure** + +#### **F1.T1 Layout Test Suite** + +- [ ] **Unit Tests:** Navigation components, layout responsiveness +- [ ] **Integration Tests:** Route protection, permission-based navigation +- [ ] **E2E Tests:** Complete user navigation flow + +#### **F1.T2 Dashboard Test Suite** + +- [ ] **Unit Tests:** Dashboard components, data formatting +- [ ] **Integration Tests:** Data fetching and display, real-time updates +- [ ] **Performance Tests:** Dashboard loading performance + +--- + +## **Phase 2: User Management & Security (āļŠāļąāļ›āļ”āļēāļŦāđŒāļ—āļĩāđˆ 3)** + +**Milestone:** āļāļēāļĢāļˆāļąāļ”āļāļēāļĢāļœāļđāđ‰āđƒāļŠāđ‰āđāļĨāļ°āļŠāļīāļ—āļ˜āļīāđŒāđāļšāļšāļŠāļĄāļšāļđāļĢāļ“āđŒ + +### **Phase 2: Tasks** + +- **[ ] F2.1 User Profile & Settings** + - [ ] Create user profile page: + - [ ] Personal information display/edit + - [ ] Password change functionality + - [ ] Notification preferences + - [ ] Implement profile picture upload + - [ ] Create user settings page + - [ ] **Security:** Secure password change with current password verification + - [ ] **Deliverable:** Complete user self-service management + - [ ] **Dependencies:** F1.1, F0.4 + +- **[ ] F2.2 Admin Panel - User Management** + - [ ] Create user list with search and filters + - [ ] Implement user creation form + - [ ] Create user edit interface + - [ ] Implement bulk user operations + - [ ] Add user activity tracking display + - [ ] **Security:** Admin-only access enforcement + - [ ] **Deliverable:** Comprehensive user management interface + - [ ] **Dependencies:** F1.1, F2.1 + +- **[ ] F2.3 Admin Panel - Role Management** + - [ ] Create role list and management interface + - [ ] Implement role creation and editing + - [ ] Create permission assignment interface + - [ ] Implement role-based access control visualization + - [ ] Add role usage statistics + - [ ] **Security:** Permission hierarchy enforcement + - [ ] **Deliverable:** Complete RBAC management system + - [ ] **Dependencies:** F2.2 + +- **[ ] F2.4 Permission Integration** + - [ ] Implement CASL ability integration + - [ ] Create permission-based UI components: + - [ ] ProtectedButton, ProtectedLink + - [ ] Conditional rendering based on permissions + - [ ] Setup real-time permission updates + - [ ] Implement permission debugging tools + - [ ] **Security:** Frontend-backend permission consistency + - [ ] **Deliverable:** Seamless permission enforcement throughout app + - [ ] **Dependencies:** F0.3, F2.3 + +### **Phase 2: User Management & Admin Panel (āļŠāļąāļ›āļ”āļēāļŦāđŒāļ—āļĩāđˆ 3)** + +* **[ ] F2.5 Admin Panel - Master Data Management (Req 6B)** (New) + * [ ] Create "Disciplines Management" page (CRUD) + * [ ] Create "Sub-Types Management" page (CRUD + Mapping Number) + * [ ] Create "Numbering Format" configuration page (Template Editor) + * [ ] **Deliverable:** UI for Admin to configure system master data + * [ ] **Dependencies:** F2.1 + +### **Phase 2: Testing - User Management** + +#### **F2.T1 User Management Test Suite** + +- [ ] **Unit Tests:** User CRUD operations, form validation +- [ ] **Integration Tests:** User-role assignment, permission propagation +- [ ] **Security Tests:** Permission escalation attempts, admin access control + +#### **F2.T2 RBAC Test Suite** + +- [ ] **Unit Tests:** Permission checks, role validation +- [ ] **Integration Tests:** Multi-level permission enforcement, UI element protection +- [ ] **E2E Tests:** Complete role-based workflow testing + +--- + +## **Phase 3: Project Structure (āļŠāļąāļ›āļ”āļēāļŦāđŒāļ—āļĩāđˆ 4)** + +**Milestone:** āļāļēāļĢāļˆāļąāļ”āļāļēāļĢāđ‚āļ„āļĢāļ‡āļŠāļĢāđ‰āļēāļ‡āđ‚āļ›āļĢāđ€āļˆāļāļ•āđŒāđāļĨāļ°āļ­āļ‡āļ„āđŒāļāļĢ + +### **Phase 3: Tasks** + +- **[ ] F3.1 Project Management UI** + - [ ] Create project list with search and filters + - [ ] Implement project creation and editing + - [ ] Create project detail view + - [ ] Implement project dashboard with statistics + - [ ] Add project member management + - [ ] **UX:** Intuitive project navigation and management + - [ ] **Deliverable:** Complete project management interface + - [ ] **Dependencies:** F1.1, F2.4 + +- **[ ] F3.2 Organization Management** + - [ ] Create organization list and management + - [ ] Implement organization creation and editing + - [ ] Create organization detail view + - [ ] Add organization user management + - [ ] Implement organization hierarchy visualization + - [ ] **Business Logic:** Proper organization-project relationships + - [ ] **Deliverable:** Comprehensive organization management + - [ ] **Dependencies:** F3.1 + +- **[ ] F3.3 Contract Management** + - [ ] Create contract list within projects + - [ ] Implement contract creation and editing + - [ ] Create contract detail view + - [ ] Add contract party management + - [ ] Implement contract document associations + - [ ] **Business Logic:** Contract-project-organization relationships + - [ ] **Deliverable:** Complete contract management system + - [ ] **Dependencies:** F3.1, F3.2 + +### **Phase 3: Testing - Project Structure** + +#### **F3.T1 Project Management Test Suite** + +- [ ] **Unit Tests:** Project CRUD operations, validation +- [ ] **Integration Tests:** Project-organization relationships, member management +- [ ] **Business Logic Tests:** Project hierarchy, access control + +--- + +## **Phase 4: Correspondence System (āļŠāļąāļ›āļ”āļēāļŦāđŒāļ—āļĩāđˆ 5-6)** + +**Milestone:** āļĢāļ°āļšāļšāļˆāļąāļ”āļāļēāļĢāđ€āļ­āļāļŠāļēāļĢāđ‚āļ•āđ‰āļ•āļ­āļšāđāļšāļšāļŠāļĄāļšāļđāļĢāļ“āđŒ + +### **Phase 4: Tasks** + +- **[ ] F4.1 Correspondence List & Search** + - [ ] Create correspondence list with advanced filtering: + - [ ] Filter by type, status, project, organization + - [ ] Search by title, document number, content + - [ ] Date range filtering + - [ ] Implement responsive data table: + - [ ] Desktop: Full table view + - [ ] Mobile: Card view conversion + - [ ] Add bulk operations (export, status change) + - [ ] Implement real-time updates + - [ ] **Performance:** Virtual scrolling for large datasets + - [ ] **Deliverable:** High-performance correspondence listing + - [ ] **Dependencies:** F1.1, F3.1 + +- **[ ] F4.2 Correspondence Creation Form** + - [ ] Create dynamic form generator based on JSON schema + - [ ] Implement form with multiple sections: + - [ ] Basic information (type, title, recipients) + - [ ] Content and details (JSON schema-based) + - [ ] File attachments + - [ ] Routing template selection + - [ ] [New] Implement "Originator Selector" component: Dropdown āļŠāļģāļŦāļĢāļąāļšāđ€āļĨāļ·āļ­āļāļ­āļ‡āļ„āđŒāļāļĢāļœāļđāđ‰āļŠāđˆāļ‡ (āđāļŠāļ”āļ‡āđ€āļ‰āļžāļēāļ°āđ€āļĄāļ·āđˆāļ­āļœāļđāđ‰āđƒāļŠāđ‰āļĄāļĩāļŠāļīāļ—āļ˜āļīāđŒ system.manage_all āļŦāļĢāļ·āļ­āļŠāļīāļ—āļ˜āļīāđŒāļžāļīāđ€āļĻāļĐ) āļŦāļēāļāđ„āļĄāđˆāđ€āļĨāļ·āļ­āļāđƒāļŦāđ‰āđƒāļŠāđ‰ Organization āļ‚āļ­āļ‡āļœāļđāđ‰āđƒāļŠāđ‰āļ•āļēāļĄāļ›āļāļ•āļī + - [ ] **[New] Discipline Selector:** Add Dropdown for Disciplines (Dependent on Contract/Project) + - [ ] **[New] Sub-Type Selector:** Add Dropdown for Sub-types (Dependent on Type) + - [ ] Logic: Show/Hide selectors based on Document Type configuration + - [ ] Add draft auto-save functionality + - [ ] Implement form validation with Zod + - [ ] **UX:** Intuitive form with progress indication + - [ ] **Deliverable:** Flexible correspondence creation interface + - [ ] **Dependencies:** F0.4, F4.1 + +- **[ ] F4.3 Correspondence Detail View** + - [ ] Create comprehensive detail page: + - [ ] Document header with metadata + - [ ] Content display based on type + - [ ] Revision history + - [ ] Related documents + - [ ] Workflow status visualization + - [ ] Implement document actions: + - [ ] Edit, withdraw, cancel (with permissions) + - [ ] Download, print + - [ ] Create related documents + - [ ] Add comments and activity timeline + - [ ] **UX:** Clean, readable document presentation + - [ ] **Deliverable:** Complete document detail experience + - [ ] **Dependencies:** F4.1, F4.2 + +- **[ ] F4.4 File Upload Integration** + - [ ] Create drag-and-drop file upload component + - [ ] Implement file type validation and preview + - [ ] Add virus scan status indication + - [ ] Create file management interface: + - [ ] Mark files as main/supporting documents + - [ ] Reorder and manage attachments + - [ ] File security status display + - [ ] Implement two-phase upload progress + - [ ] **Security:** File type restrictions, size limits, virus scan integration + - [ ] **Deliverable:** Secure and user-friendly file management + - [ ] **Dependencies:** F0.2, F4.2 + +### **Phase 4: Testing - Correspondence System** + +#### **F4.T1 Correspondence Test Suite** + +- [ ] **Unit Tests:** Form validation, file upload components +- [ ] **Integration Tests:** Complete document lifecycle, file attachment flow +- [ ] **E2E Tests:** End-to-end correspondence creation and management + +#### **F4.T2 File Upload Test Suite** + +- [ ] **Unit Tests:** File validation, type checking +- [ ] **Integration Tests:** Two-phase upload process, virus scan integration +- [ ] **Security Tests:** Malicious file upload attempts, security feedback + +--- + +## **Phase 5: Workflow Management (āļŠāļąāļ›āļ”āļēāļŦāđŒāļ—āļĩāđˆ 7)** + +**Milestone:** āļĢāļ°āļšāļš Visualization āđāļĨāļ°āļˆāļąāļ”āļāļēāļĢ Workflow + +### **Phase 5: Tasks** + +- **[ ] F5.1 Workflow Visualization Component** + - [ ] Create horizontal workflow progress visualization + - [ ] Implement step status indicators (pending, active, completed, skipped) + - [ ] Add due date and assignee information + - [ ] Create interactive workflow diagram + - [ ] Implement workflow history timeline + - [ ] **UX:** Clear visual representation of complex workflows + - [ ] **Deliverable:** Intuitive workflow visualization + - [ ] **Dependencies:** F4.3 + +- **[ ] F5.2 Routing Template Management** + - [ ] Create routing template list and editor + - [ ] Implement drag-and-drop step configuration + - [ ] Add step configuration (purpose, duration, assignee rules) + - [ ] Create template preview functionality + - [ ] Implement template versioning + - [ ] **Business Logic:** Proper step sequencing and validation + - [ ] **Deliverable:** Comprehensive routing template management + - [ ] **Dependencies:** F3.1, F4.2 + +- **[ ] F5.3 Workflow Step Actions** + - [ ] Create step action interface: + - [ ] Approve, reject, request changes + - [ ] Add comments and attachments + - [ ] Forward to other users + - [ ] Implement bulk step actions + - [ ] Add action confirmation with reason required + - [ ] Create step delegation functionality + - [ ] **UX:** Streamlined step completion process + - [ ] **Deliverable:** Efficient workflow step management + - [ ] **Dependencies:** F5.1 + +- **[ ] F5.4 Real-time Status Updates** + - [ ] Implement WebSocket connections for real-time updates + - [ ] Create status change notifications + - [ ] Add auto-refresh for workflow states + - [ ] Implement optimistic updates for better UX + - [ ] Create update history and audit trail + - [ ] **Performance:** Efficient real-time data synchronization + - [ ] **Deliverable:** Real-time workflow monitoring + - [ ] **Dependencies:** F5.1, F9.2 + +### **Phase 5: Testing - Workflow Management** + +#### **F5.T1 Workflow Test Suite** + +- [ ] **Unit Tests:** Workflow visualization, step status logic +- [ ] **Integration Tests:** Complete workflow execution, real-time updates +- [ ] **E2E Tests:** Multi-step workflow with different user roles + +--- + +## **Phase 6: Drawing System (āļŠāļąāļ›āļ”āļēāļŦāđŒāļ—āļĩāđˆ 8)** + +**Milestone:** āļĢāļ°āļšāļšāļˆāļąāļ”āļāļēāļĢāđāļšāļšāđāļ›āļĨāļ™āđāļšāļšāļŠāļĄāļšāļđāļĢāļ“āđŒ + +### **Phase 6: Tasks** + +- **[ ] F6.1 Contract Drawings Management** + - [ ] Create contract drawing list with categorization + - [ ] Implement drawing upload and metadata management + - [ ] Create drawing preview and viewer + - [ ] Add drawing version control + - [ ] Implement drawing search and filtering + - [ ] **UX:** Efficient drawing navigation and access + - [ ] **Deliverable:** Comprehensive contract drawing management + - [ ] **Dependencies:** F3.1, F4.4 + +- **[ ] F6.2 Shop Drawings Management** + - [ ] Create shop drawing list with revision tracking + - [ ] Implement shop drawing creation and revision system + - [ ] Create drawing comparison interface + - [ ] Add drawing approval status tracking + - [ ] Implement bulk drawing operations + - [ ] **Business Logic:** Proper revision control and approval workflows + - [ ] **Deliverable:** Complete shop drawing management system + - [ ] **Dependencies:** F6.1 + +- **[ ] F6.3 Drawing Revision System** + - [ ] Create revision history interface + - [ ] Implement revision comparison functionality + - [ ] Add revision notes and change tracking + - [ ] Create revision approval workflow + - [ ] Implement revision rollback capability + - [ ] **UX:** Clear visualization of changes between revisions + - [ ] **Deliverable:** Robust drawing revision control + - [ ] **Dependencies:** F6.2 + +- **[ ] F6.4 Drawing References** + - [ ] Create drawing reference management + - [ ] Implement cross-drawing references + - [ ] Add reference validation and integrity checks + - [ ] Create reference visualization + - [ ] Implement reference impact analysis + - [ ] **Business Logic:** Maintain reference integrity during changes + - [ ] **Deliverable:** Comprehensive drawing reference system + - [ ] **Dependencies:** F6.2, F6.3 + +### **Phase 6: Testing - Drawing System** + +#### **F6.T1 Drawing Management Test Suite** + +- [ ] **Unit Tests:** Drawing CRUD operations, revision logic +- [ ] **Integration Tests:** Drawing approval workflows, reference management +- [ ] **E2E Tests:** Complete drawing lifecycle with revisions + +--- + +## **Phase 7: RFA System (āļŠāļąāļ›āļ”āļēāļŦāđŒāļ—āļĩāđˆ 9-10)** + +**Milestone:** āļĢāļ°āļšāļšāļ‚āļ­āļ­āļ™āļļāļĄāļąāļ•āļīāđāļšāļšāļŠāļĄāļšāļđāļĢāļ“āđŒāļžāļĢāđ‰āļ­āļĄ Dynamic Forms + +### **Phase 7: Tasks** + +- **[ ] F7.1 RFA List & Dashboard** + - [ ] Create RFA dashboard with status overview + - [ ] Implement advanced RFA filtering and search + - [ ] Create RFA calendar view for deadlines + - [ ] Add RFA statistics and reporting + - [ ] Implement RFA bulk operations + - [ ] **UX:** Comprehensive RFA overview and management + - [ ] **Deliverable:** Complete RFA dashboard and listing + - [ ] **Dependencies:** F4.1, F5.1 + +- **[ ] F7.2 RFA Creation with Dynamic Forms** + - [ ] Create RFA type-specific form generator + - [ ] Implement dynamic form fields based on RFA type: + - [ ] RFA_DWG: Shop drawing selection + - [ ] RFA_DOC: Document specifications + - [ ] RFA_MES: Method statement details + - [ ] RFA_MAT: Material specifications + - [ ] Add form validation with JSON schema + - [ ] Implement form data persistence and recovery + - [ ] **UX:** Intuitive form experience for complex RFA types + - [ ] Dynamic Form & Schema Validation: āļŠāļĢāđ‰āļēāļ‡ Component Dynamic Form Generator āļ—āļĩāđˆ: + - [ ] Fetch Schema: āļ”āļķāļ‡āđ‚āļ„āļĢāļ‡āļŠāļĢāđ‰āļēāļ‡ JSON Schema āļ—āļĩāđˆāļ–āļđāļāļ•āđ‰āļ­āļ‡āļ•āļēāļĄ rfa_type āļˆāļēāļ Backend (āļ•āļēāļĢāļēāļ‡ json_schemas āļ—āļĩāđˆāļŠāļĢāđ‰āļēāļ‡āđƒāļŦāļĄāđˆ) āļāđˆāļ­āļ™āļāļēāļĢ Render Form. + - [ ] Client-side Validation: Implement AJV (Another JSON Schema Validator) āļŦāļĢāļ·āļ­āđ„āļĨāļšāļĢāļēāļĢāļĩāļ—āļĩāđˆāđ€āļ—āļĩāļĒāļšāđ€āļ—āđˆāļē āđ€āļžāļ·āđˆāļ­āļ—āļģ Client-side Validation āļšāļ™āļ‚āđ‰āļ­āļĄāļđāļĨ JSON āļāđˆāļ­āļ™āļŠāđˆāļ‡ Submit. + - [ ] Implement dynamic form fields based on RFA type: RFA_DWG, RFA_DOC, RFA_MES, RFA_MAT. + - [ ] Add form data persistence and recovery. + - [ ] **[New] Discipline & Sub-Type Integration:** Ensure RFA forms capture these fields correctly for numbering generation. + - [ ] **Deliverable:** Flexible RFA creation system + - [ ] **Dependencies:** F4.2, F6.2 + +- **[ ] F7.3 RFA Workflow Integration** + - [ ] Integrate RFA with unified workflow engine + - [ ] Create RFA-specific workflow steps and actions + - [ ] Implement RFA approval interface + - [ ] Add RFA workflow history and tracking + - [ ] Create RFA workflow templates + - [ ] **Business Logic:** Proper RFA approval sequencing and validation + - [ ] **Deliverable:** Seamless RFA workflow integration + - [ ] **Dependencies:** F5.1, F7.2 + +- **[ ] F7.4 RFA Approval Interface** + - [ ] Create RFA review and approval interface + - [ ] Implement side-by-side document comparison + - [ ] Add approval comments and attachments + - [ ] Create conditional approval workflows + - [ ] Implement approval delegation and escalation + - [ ] **UX:** Efficient approval process for technical reviews + - [ ] **Deliverable:** Comprehensive RFA approval system + - [ ] **Dependencies:** F7.1, F7.3 + +### **Phase 7: Testing - RFA System** + +#### **F7.T1 RFA Test Suite** + +- [ ] **Unit Tests:** RFA form generation, validation logic +- [ ] **Integration Tests:** Complete RFA lifecycle, workflow integration +- [ ] **E2E Tests:** Multi-type RFA creation and approval workflows + +--- + +## **Phase 8: Internal Workflows (āļŠāļąāļ›āļ”āļēāļŦāđŒāļ—āļĩāđˆ 11)** + +**Milestone:** āļĢāļ°āļšāļšāđƒāļšāđ€āļ§āļĩāļĒāļ™āđāļĨāļ°āļāļēāļĢāļˆāļąāļ”āļāļēāļĢāļ‡āļēāļ™āļ āļēāļĒāđƒāļ™ + +### **Phase 8: Tasks** + +- **[ ] F8.1 Circulation Management** + - [ ] Create circulation list and management interface + - [ ] Implement circulation creation from correspondence + - [ ] Create circulation template management + - [ ] Add circulation status tracking + - [ ] Implement circulation search and filtering + - [ ] **Business Logic:** Proper circulation-correspondence relationships + - [ ] **Deliverable:** Comprehensive circulation management + - [ ] **Dependencies:** F4.1, F5.2 + +- **[ ] F8.2 Task Assignment Interface** + - [ ] Create task assignment interface with user selection + - [ ] Implement task priority and deadline setting + - [ ] Add task dependency management + - [ ] Create task progress tracking + - [ ] Implement task reassignment and delegation + - [ ] **UX:** Intuitive task management and assignment + - [ ] **Deliverable:** Efficient task assignment system + - [ ] **Dependencies:** F8.1 + +- **[ ] F8.3 Internal Approval Flows** + - [ ] Create internal approval workflow interface + - [ ] Implement multi-level approval processes + - [ ] Add approval chain visualization + - [ ] Create approval delegation system + - [ ] Implement approval deadline management + - [ ] **Business Logic:** Proper approval hierarchy and escalation + - [ ] **Deliverable:** Robust internal approval system + - [ ] **Dependencies:** F8.1, F8.2 + +### **Phase 8: Testing - Internal Workflows** + +#### **F8.T1 Circulation Test Suite** + +- [ ] **Unit Tests:** Circulation creation, task assignment logic +- [ ] **Integration Tests:** Complete circulation workflow, internal approvals +- [ ] **E2E Tests:** End-to-end circulation with task completion + +--- + +## **Phase 9: Advanced Features (āļŠāļąāļ›āļ”āļēāļŦāđŒāļ—āļĩāđˆ 12)** + +**Milestone:** āļŸāļĩāđ€āļˆāļ­āļĢāđŒāļ‚āļąāđ‰āļ™āļŠāļđāļ‡āđāļĨāļ°āļāļēāļĢāļ›āļĢāļąāļšāļ›āļĢāļļāļ‡āļ›āļĢāļ°āļŠāļšāļāļēāļĢāļ“āđŒāļœāļđāđ‰āđƒāļŠāđ‰ + +### **Phase 9: Tasks** + +- **[ ] F9.1 Advanced Search Interface** + - [ ] Create unified search interface across all document types + - [ ] Implement faceted search with multiple filters + - [ ] Add search result highlighting and relevance scoring + - [ ] Create saved search and search templates + - [ ] Implement search result export functionality + - [ ] **Performance:** Efficient search with large datasets + - [ ] **Deliverable:** Powerful cross-document search system + - [ ] **Dependencies:** F4.1, F7.1 + +- **[ ] F9.2 Notification System** + - [ ] Create notification center with real-time updates + - [ ] Implement notification preferences management + - [ ] Add notification grouping and digest views + - [ ] Create actionable notifications with quick actions + - [ ] Implement notification read/unread status + - [ ] **UX:** Non-intrusive but effective notification delivery + - [ ] **Deliverable:** Comprehensive notification management + - [ ] **Dependencies:** F1.3, F5.4 + +- **[ ] F9.3 Reporting & Analytics** + - [ ] Create reporting dashboard with customizable widgets + - [ ] Implement data visualization components (charts, graphs) + - [ ] Add report scheduling and export + - [ ] Create ad-hoc reporting interface + - [ ] Implement performance metrics tracking + - [ ] **Business Logic:** Accurate data aggregation and reporting + - [ ] **Deliverable:** Powerful reporting and analytics system + - [ ] **Dependencies:** F1.3, F7.1 + +- **[ ] F9.4 Mobile Optimization** + - [ ] Implement touch-optimized interactions + - [ ] Create mobile-specific navigation patterns + - [ ] Add offline capability for critical functions + - [ ] Optimize images and assets for mobile networks + - [ ] Implement mobile-specific performance optimizations + - [ ] **UX:** Seamless mobile experience comparable to desktop + - [ ] **Deliverable:** Fully optimized mobile application + - [ ] **Dependencies:** F1.4 + +### **Phase 9: Testing - Advanced Features** + +#### **F9.T1 Advanced Features Test Suite** + +- [ ] **Unit Tests:** Search algorithms, notification logic +- [ ] **Integration Tests:** Cross-module search, real-time notifications +- [ ] **Performance Tests:** Search performance, mobile responsiveness + +--- + +## **Phase 10: Testing & Polish (āļŠāļąāļ›āļ”āļēāļŦāđŒāļ—āļĩāđˆ 13-14)** + +**Milestone:** āđāļ­āļ›āļžāļĨāļīāđ€āļ„āļŠāļąāļ™āļ—āļĩāđˆāļœāđˆāļēāļ™āļāļēāļĢāļ—āļ”āļŠāļ­āļšāđāļĨāļ°āļ›āļĢāļąāļšāļ›āļĢāļļāļ‡āļ­āļĒāđˆāļēāļ‡āļŠāļĄāļšāļđāļĢāļ“āđŒ + +### **Phase 10: Tasks** + +- **[ ] F10.1 Comprehensive Testing** + - [ ] Idempotency Testing: āđ€āļžāļīāđˆāļĄāļāļēāļĢāļ—āļ”āļŠāļ­āļšāđ€āļ‰āļžāļēāļ°āļŠāļģāļŦāļĢāļąāļš Axios Interceptor āđ€āļžāļ·āđˆāļ­āļˆāļģāļĨāļ­āļ‡āļāļēāļĢāļŠāđˆāļ‡ Request POST/PUT/DELETE āļ—āļĩāđˆāļĄāļĩ Idempotency-Key āļ‹āđ‰āļģāđ„āļ›āļĒāļąāļ‡ Mock API (MSW) āđ€āļžāļ·āđˆāļ­āļĒāļ·āļ™āļĒāļąāļ™āļ§āđˆāļē Client-side āđ„āļĄāđˆāļŠāđˆāļ‡ Key āļ‹āđ‰āļģāđƒāļ™āļāļēāļĢāļ—āļģāļ‡āļēāļ™āļ›āļāļ•āļī āđāļĨāļ°āđ„āļĄāđˆāđ€āļāļīāļ” Side Effect āļˆāļēāļāļāļēāļĢ Replay Attack. + - [ ] Write unit tests for all components and utilities + - [ ] Create integration tests for critical user flows + - [ ] Implement E2E tests for complete workflows + - [ ] Perform cross-browser compatibility testing + - [ ] Conduct accessibility testing (WCAG 2.1 AA) + - [ ] **Quality:** 80%+ test coverage, all critical paths tested + - [ ] **Deliverable:** Fully tested application + - [ ] **Dependencies:** All previous phases + +- **[ ] F10.2 Performance Optimization** + - [ ] Implement code splitting and lazy loading + - [ ] Optimize bundle size and asset delivery + - [ ] Add performance monitoring and metrics + - [ ] Implement caching strategies for static assets + - [ ] Optimize API call patterns and reduce over-fetching + - [ ] **Performance:** Core Web Vitals targets met + - [ ] **Deliverable:** High-performance application + - [ ] **Dependencies:** F10.1 + +- **[ ] F10.3 Security Hardening** + - [ ] Conduct security audit and penetration testing + - [ ] Implement Content Security Policy (CSP) + - [ ] Add security headers and protections + - [ ] Conduct dependency vulnerability scanning + - [ ] Implement secure coding practices review + - [ ] **Security:** No critical security vulnerabilities + - [ ] **Deliverable:** Security-hardened application + - [ ] **Dependencies:** F10.1 + +- **[ ] F10.4 Documentation** + - [ ] Create user documentation and guides + - [ ] Write technical documentation for developers + - [ ] Create API integration documentation + - [ ] Add inline code documentation + - [ ] Create deployment and maintenance guides + - [ ] **Quality:** Comprehensive and up-to-date documentation + - [ ] **Deliverable:** Complete documentation suite + - [ ] **Dependencies:** F10.1 + +### **Phase 10: Testing - Final Validation** + +#### **F10.T1 Final Test Suite** + +- [ ] **Performance Tests:** Load testing, stress testing +- [ ] **Security Tests:** Final security audit, vulnerability assessment +- [ ] **User Acceptance Tests:** Real user testing, feedback incorporation +- [ ] **Compatibility Tests:** Cross-browser, cross-device testing + +--- + +## 📊 **āļŠāļĢāļļāļ› Timeline** + +| Phase | āļĢāļ°āļĒāļ°āđ€āļ§āļĨāļē | āļˆāļģāļ™āļ§āļ™āļ‡āļēāļ™ | Output āļŦāļĨāļąāļ | +| -------- | ------------ | ------------ | ------------------------------------ | +| Phase 0 | 1 āļŠāļąāļ›āļ”āļēāļŦāđŒ | 4 | Foundation & Tooling Ready | +| Phase 1 | 1 āļŠāļąāļ›āļ”āļēāļŦāđŒ | 4 | Core Application Structure | +| Phase 2 | 1 āļŠāļąāļ›āļ”āļēāļŦāđŒ | 4 | User Management & Security | +| Phase 3 | 1 āļŠāļąāļ›āļ”āļēāļŦāđŒ | 3 | Project Structure Management | +| Phase 4 | 2 āļŠāļąāļ›āļ”āļēāļŦāđŒ | 4 | Correspondence System | +| Phase 5 | 1 āļŠāļąāļ›āļ”āļēāļŦāđŒ | 4 | Workflow Management | +| Phase 6 | 1 āļŠāļąāļ›āļ”āļēāļŦāđŒ | 4 | Drawing System | +| Phase 7 | 2 āļŠāļąāļ›āļ”āļēāļŦāđŒ | 4 | RFA System (Dynamic Forms) | +| Phase 8 | 1 āļŠāļąāļ›āļ”āļēāļŦāđŒ | 3 | Internal Workflows | +| Phase 9 | 1 āļŠāļąāļ›āļ”āļēāļŦāđŒ | 4 | Advanced Features | +| Phase 10 | 2 āļŠāļąāļ›āļ”āļēāļŦāđŒ | 4 | Testing & Polish (Idempotency Test) | +| **āļĢāļ§āļĄ** | **14 āļŠāļąāļ›āļ”āļēāļŦāđŒ** | **39 Tasks** | **Production-Ready Frontend v1.4.2** | + +--- + +## ðŸŽŊ **Critical Success Factors** + +1. **User Experience First:** āļ—āļļāļāļŸāļĩāđ€āļˆāļ­āļĢāđŒāļ•āđ‰āļ­āļ‡āļ­āļ­āļāđāļšāļšāđ€āļžāļ·āđˆāļ­āļ›āļĢāļ°āļŠāļšāļāļēāļĢāļ“āđŒāļœāļđāđ‰āđƒāļŠāđ‰āļ—āļĩāđˆāļ”āļĩ +2. **Responsive Design:** āļĢāļ­āļ‡āļĢāļąāļšāļāļēāļĢāđƒāļŠāđ‰āļ‡āļēāļ™āļšāļ™āļ­āļļāļ›āļāļĢāļ“āđŒāļ—āļļāļāļĢāļđāļ›āđāļšāļš +3. **Performance:** Core Web Vitals āļ•āđ‰āļ­āļ‡āļ­āļĒāļđāđˆāđƒāļ™āđ€āļāļ“āļ‘āđŒāļ—āļĩāđˆāļ”āļĩ +4. **Accessibility:** āļ•āđ‰āļ­āļ‡āđ€āļ›āđ‡āļ™āđ„āļ›āļ•āļēāļĄāļĄāļēāļ•āļĢāļāļēāļ™ WCAG 2.1 AA +5. **Security:** āļ›āđ‰āļ­āļ‡āļāļąāļ™ XSS, CSRF āđāļĨāļ°āļ„āļ§āļēāļĄāđ€āļŠāļĩāđˆāļĒāļ‡āļ”āđ‰āļēāļ™āļ„āļ§āļēāļĄāļ›āļĨāļ­āļ”āļ āļąāļĒāļ­āļ·āđˆāļ™āđ† +6. **Offline Support:** āļĢāļ­āļ‡āļĢāļąāļšāļāļēāļĢāļ—āļģāļ‡āļēāļ™āđāļšāļš Offline āđ€āļšāļ·āđ‰āļ­āļ‡āļ•āđ‰āļ™ +7. **Real-time Updates:** āļāļēāļĢāļ­āļąāļ›āđ€āļ”āļ•āļŠāļ–āļēāļ™āļ°āđāļšāļš Real-time +8. **Testing Coverage:** āļ„āļĢāļ­āļšāļ„āļĨāļļāļĄāļāļēāļĢāļ—āļ”āļŠāļ­āļšāļ—āļļāļ Critical Path +9. **Documentation:** āđ€āļ­āļāļŠāļēāļĢāļ„āļĢāļšāļ–āđ‰āļ§āļ™āļŠāļģāļŦāļĢāļąāļšāļœāļđāđ‰āđƒāļŠāđ‰āđāļĨāļ°āļ™āļąāļāļžāļąāļ’āļ™āļē + +--- + +## 📋 **Quality Assurance Checklist** + +### **āļāđˆāļ­āļ™ Production Deployment** + +- [ ] **Performance:** Core Web Vitals āļœāđˆāļēāļ™āđ€āļāļ“āļ‘āđŒ +- [ ] **Accessibility:** WCAG 2.1 AA compliant +- [ ] **Security:** Security audit āļœāđˆāļēāļ™ +- [ ] **Testing:** Test coverage â‰Ĩ 80% +- [ ] **Browser Compatibility:** āļ—āļģāļ‡āļēāļ™āđ„āļ”āđ‰āļšāļ™āđ€āļšāļĢāļēāļ§āđŒāđ€āļ‹āļ­āļĢāđŒāļŦāļĨāļąāļ +- [ ] **Mobile Responsive:** āđƒāļŠāđ‰āļ‡āļēāļ™āđ„āļ”āđ‰āļ”āļĩāļšāļ™āļĄāļ·āļ­āļ–āļ·āļ­ +- [ ] **Documentation:** āđ€āļ­āļāļŠāļēāļĢāļ„āļĢāļšāļ–āđ‰āļ§āļ™ +- [ ] **User Acceptance:** āđ„āļ”āđ‰āļĢāļąāļšāļāļēāļĢāļĒāļ­āļĄāļĢāļąāļšāļˆāļēāļāļœāļđāđ‰āđƒāļŠāđ‰ + +--- + +## 🚀 **āļ‚āļąāđ‰āļ™āļ•āļ­āļ™āļ–āļąāļ”āđ„āļ›** + +1. **Approve āđāļœāļ™āļ™āļĩāđ‰** → āļ›āļĢāļąāļšāđāļ•āđˆāļ‡āļ•āļēāļĄ Feedback +2. **Coordinate āļāļąāļš Backend Team** → Sync API Specifications +3. **āđ€āļĢāļīāđˆāļĄāļžāļąāļ’āļ™āļē Phase 0** → Setup Foundation +4. **Regular Sync** → āļ›āļĢāļ°āļŠāļēāļ™āļ‡āļēāļ™āļāļąāļš Backend āļ—āļļāļāļŠāļąāļ›āļ”āļēāļŦāđŒ +5. **User Testing** → āļ—āļ”āļŠāļ­āļšāļāļąāļšāļœāļđāđ‰āđƒāļŠāđ‰āļˆāļĢāļīāļ‡āļĢāļ°āļŦāļ§āđˆāļēāļ‡āļžāļąāļ’āļ™āļē +6. **Deploy to Production** → Week 15 (āļžāļĢāđ‰āļ­āļĄ Backend) + +## **Document Control:** + +- **Document:** Frontend Development Plan v1.4.3 +- **Version:** 1.4 +- **Date:** 2025-11-26 +- **Author:** NAP LCBP3-DMS & Gemini +- **Status:** FINAL-Rev.04 +- **Classification:** Internal Technical Documentation +- **Approved By:** Nattanin + +--- + +`End of Frontend Development Plan v1.4.4 (āļ‰āļšāļąāļšāļ›āļĢāļąāļšāļ›āļĢāļļāļ‡)` diff --git a/4_Data_Dictionary_V1_4_4.md b/4_Data_Dictionary_V1_4_4.md new file mode 100644 index 0000000..dcf328c --- /dev/null +++ b/4_Data_Dictionary_V1_4_4.md @@ -0,0 +1,2905 @@ +# **āļ•āļēāļĢāļēāļ‡āļāļēāļ™āļ‚āđ‰āļ­āļĄāļđāļĨ (Data Dictionary) - LCBP3-DMS (V1.4.4)** + +āđ€āļ­āļāļŠāļēāļĢāļ™āļĩāđ‰āļŠāļĢāļļāļ›āđ‚āļ„āļĢāļ‡āļŠāļĢāđ‰āļēāļ‡āļ•āļēāļĢāļēāļ‡, Foreign Keys (FK), āđāļĨāļ° Constraints āļ—āļĩāđˆāļŠāļģāļ„āļąāļāļ—āļąāđ‰āļ‡āļŦāļĄāļ”āđƒāļ™āļāļēāļ™āļ‚āđ‰āļ­āļĄāļđāļĨ LCBP3-DMS (v1.4) āđ€āļžāļ·āđˆāļ­āđƒāļŠāđ‰āđ€āļ›āđ‡āļ™āđ€āļ­āļāļŠāļēāļĢāļ­āđ‰āļēāļ‡āļ­āļīāļ‡āļŠāļģāļŦāļĢāļąāļšāļ—āļĩāļĄāļžāļąāļ’āļ™āļē Backend (NestJS) āđāļĨāļ° Frontend (Next.js) āđ‚āļ”āļĒāļ­āļīāļ‡āļˆāļēāļ Requirements āđāļĨāļ° SQL Script āļĨāđˆāļēāļŠāļļāļ” [GEMINI] + +**āļŠāļ–āļēāļ™āļ°:** FINAL GUIDELINE +**āļ§āļąāļ™āļ—āļĩāđˆ:** 2025-11-26 +**āļ­āđ‰āļēāļ‡āļ­āļīāļ‡:** Requirements v1.4.4 & FullStackJS Guidelines v1.4.4 +**Classification:** Internal Technical Documentation + +## 📝 āļŠāļĢāļļāļ›āļĢāļēāļĒāļāļēāļĢāļ›āļĢāļąāļšāļ›āļĢāļļāļ‡ (Summary of Changes) + +1. **āđ€āļžāļīāđˆāļĄāļ•āļēāļĢāļēāļ‡ `disciplines`**: āļŠāļģāļŦāļĢāļąāļšāđ€āļāđ‡āļšāļ‚āđ‰āļ­āļĄāļđāļĨāļŠāļēāļ‚āļēāļ‡āļēāļ™ (āđ€āļŠāđˆāļ™ GEN, STR, ARC) +2. **āđ€āļžāļīāđˆāļĄāļ•āļēāļĢāļēāļ‡ `correspondence_sub_types`**: āļŠāļģāļŦāļĢāļąāļšāđ€āļāđ‡āļšāļĢāļŦāļąāļŠāļĒāđˆāļ­āļĒ (āđ€āļŠāđˆāļ™ MAT-11, SHP-12) +3. **āđāļāđ‰āđ„āļ‚āļ•āļēāļĢāļēāļ‡ `correspondences`**: āđ€āļžāļīāđˆāļĄ Column `discipline_id` +4. **āđāļāđ‰āđ„āļ‚āļ•āļēāļĢāļēāļ‡ `rfas`**: āđ€āļžāļīāđˆāļĄ Column `discipline_id` +5. **āđāļāđ‰āđ„āļ‚āļ•āļēāļĢāļēāļ‡ `document_number_counters`**: āđ€āļžāļīāđˆāļĄ `discipline_id` āđƒāļ™ Primary Key +6. Seeded data for disciplines and RFA types based on Requirement 6B. + +--- + +## **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 | +| deleted_at | DATETIME | NULL | Deleted at | + +**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 | +| **discipline_id** | **INT** | **NULL, FK** | **Reference to disciplines (if applicable)** | +| 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 (discipline_id) REFERENCES disciplines(id) ON DELETE SET NULL** +- 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, **disciplines**, 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 | +| v_ref_project_id | INT | GENERATED ALWAYS AS (...) VIRTUAL | Virtual Column āļ”āļķāļ‡ Project ID āļˆāļēāļ JSON details āđ€āļžāļ·āđˆāļ­āļ—āļģ Index | +| v_ref_type | VARCHAR(50) | GENERATED ALWAYS AS (...) VIRTUAL | Virtual Column āļ”āļķāļ‡ Type āļˆāļēāļ JSON details | + +**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) +- INDEX (v_ref_project_id) +- INDEX (v_ref_type) + +**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_at | TIMESTAMP | NOT NULL, DEFAULT CURRENT_TIMESTAMP | āļ§āļąāļ™āļ—āļĩāđˆāđāļĨāļ°āđ€āļ§āļĨāļēāļ—āļĩāđˆāļŠāļĢāđ‰āļēāļ‡āđāļĄāđˆāđāļšāļšāļ™āļĩāđ‰ | +| updated_at | TIMESTAMP | NOT NULL,`DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP | āļ§āļąāļ™āļ—āļĩāđˆāđāļĨāļ°āđ€āļ§āļĨāļēāļ—āļĩāđˆāđāļāđ‰āđ„āļ‚āļ‚āđ‰āļ­āļĄāļđāļĨāđƒāļ™āđāļĄāđˆāđāļšāļšāļ™āļĩāđ‰āļĨāđˆāļēāļŠāļļāļ” | +| is_active | BOOLEAN | DEFAULT TRUE | āļŠāļ–āļēāļ™āļ°āđƒāļŠāđ‰āļ‡āļēāļ™ | +| workflow_config | JSON | NULL | āđ€āļāđ‡āļš State Machine Configuration āļŦāļĢāļ·āļ­ Rules āđ€āļžāļīāđˆāļĄāđ€āļ•āļīāļĄāļ—āļĩāđˆāļ‹āļąāļšāļ‹āđ‰āļ­āļ™āļāļ§āđˆāļē Column āļ›āļāļ•āļī | + +**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_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: āđ€āļžāļ·āđˆāļ­āļ—āļĢāļēāļš] | +| expected_days | INT | NULL | āļ§āļąāļ™āļ—āļĩāđˆāļ„āļēāļ”āļŦāļ§āļąāļ‡ | + +**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 | āđ€āļ§āļĨāļēāļ—āļĩāđˆāļŠāļĢāđ‰āļēāļ‡āļĢāļēāļĒāļāļēāļĢāļŠāđˆāļ‡āļ•āđˆāļ­āļ™āļĩāđ‰ | +| state_context | JSON | NULL | āđ€āļāđ‡āļšāļ‚āđ‰āļ­āļĄāļđāļĨ Context āļ‚āļ­āļ‡ Workflow āļ“ āļ‚āļ“āļ°āļ™āļąāđ‰āļ™ (Snapshot) | + +**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 āđ€āļžāļ·āđˆāļ­āļĢāļąāļāļĐāļēāļ›āļĢāļ°āļ§āļąāļ•āļīāļāļēāļĢāļ”āļģāđ€āļ™āļīāļ™āļāļēāļĢāđ„āļ§āđ‰ + +--- + +### 3.12 āļ•āļēāļĢāļēāļ‡ 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 āļŦāļĄāļēāļĒāļ„āļ§āļēāļĄāļ§āđˆāļē āļˆāļ°āļĨāļšāļ›āļĢāļ°āđ€āļ āļ—āļŦāļ™āļąāļ‡āļŠāļ·āļ­āļŦāļĢāļ·āļ­āļŠāļ–āļēāļ™āļ°āđ„āļĄāđˆāđ„āļ”āđ‰ āļ–āđ‰āļēāļĒāļąāļ‡āļĄāļĩāļāļēāļĢāđƒāļŠāđ‰āļ‡āļēāļ™āļ­āļĒāļđāđˆāđƒāļ™āļ•āļēāļĢāļēāļ‡āļ™āļĩāđ‰ + +--- + +## **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 | +| **discipline_id** | **INT** | **NULL, FK** | **Reference to disciplines (if applicable)** | +| 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 (discipline_id) REFERENCES disciplines(id) ON DELETE SET NULL** +- FOREIGN KEY (created_by) REFERENCES users(user_id) ON DELETE SET NULL +- INDEX (rfa_type_id) +- INDEX (deleted_at) + +**Relationships**: + +- Parent: rfa_types, **disciplines**, 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 | +| workflow_config | JSON | NULL | āđ€āļāđ‡āļš State Machine Configuration āļŦāļĢāļ·āļ­ Rules āđ€āļžāļīāđˆāļĄāđ€āļ•āļīāļĄāļ—āļĩāđˆāļ‹āļąāļšāļ‹āđ‰āļ­āļ™āļāļ§āđˆāļē Column āļ›āļāļ•āļī | + +**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 | +| state_context | JSON* | NULL | āđ€āļāđ‡āļšāļ‚āđ‰āļ­āļĄāļđāļĨ Context āļ‚āļ­āļ‡ Workflow āļ“ āļ‚āļ“āļ°āļ™āļąāđ‰āļ™ (Snapshot) | + +**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 + +### 4.10 disciplines + +**Purpose**: Master table for Project Disciplines (āļŠāļēāļ‚āļēāļ‡āļēāļ™) [Added in v1.4.4 based on Req 6B] + +| Column Name | Data Type | Constraints | Description | +| --------------- | ------------ | --------------------------- | -------------------------------- | +| id | INT | PRIMARY KEY, AUTO_INCREMENT | Unique identifier | +| contract_id | INT | NOT NULL, FK | Reference to contracts | +| discipline_code | VARCHAR(10) | NOT NULL | Code (e.g., 'GEN', 'STR', 'ARC') | +| code_name_th | VARCHAR(255) | NULL | Thai Name | +| code_name_en | VARCHAR(255) | NULL | English Name | +| is_active | TINYINT(1) | DEFAULT 1 | Active status | +| created_at | TIMESTAMP | DEFAULT CURRENT_TIMESTAMP | Creation timestamp | + +**Indexes**: + +- PRIMARY KEY (id) +- FOREIGN KEY (contract_id) REFERENCES contracts(id) ON DELETE CASCADE +- **UNIQUE KEY (contract_id, discipline_code)** - Ensures unique code per contract + +**Relationships**: + +- Parent: contracts +- Referenced by: rfas, correspondences, document_number_counters + +--- + +### 4.11 correspondence_sub_types + +**Purpose**: Master table for Correspondence/RFA Sub-types mapping [Added in v1.4.4 based on Req 6B] + +| Column Name | Data Type | Constraints | Description | +| ---------------------- | ------------ | --------------------------- | -------------------------------------------- | +| id | INT | PRIMARY KEY, AUTO_INCREMENT | Unique identifier | +| contract_id | INT | NOT NULL, FK | Reference to contracts | +| correspondence_type_id | INT | NOT NULL, FK | Reference to correspondence_types | +| sub_type_code | VARCHAR(20) | NOT NULL | Sub-type Code (e.g., 'MAT', 'SHP') | +| sub_type_name | VARCHAR(255) | NULL | Full Name | +| sub_type_number | VARCHAR(10) | NULL | Numeric code for running number (e.g., '11') | +| created_at | TIMESTAMP | DEFAULT CURRENT_TIMESTAMP | Creation timestamp | + +**Indexes**: + +- PRIMARY KEY (id) +- FOREIGN KEY (contract_id) REFERENCES contracts(id) ON DELETE CASCADE +- FOREIGN KEY (correspondence_type_id) REFERENCES correspondence_types(id) ON DELETE CASCADE + +**Relationships**: + +- Parent: contracts, correspondence_types +- Referenced by: (Used in logic for Document Numbering) +--- + +## **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 | +| is_temporary | BOOLEAN | DEFAULT TRUE | āļĢāļ°āļšāļļāļ§āđˆāļēāđ€āļ›āđ‡āļ™āđ„āļŸāļĨāđŒāļŠāļąāđˆāļ§āļ„āļĢāļēāļ§ (āļĒāļąāļ‡āđ„āļĄāđˆāđ„āļ”āđ‰ Commit) | +| temp_id* | VARCHAR(100) | NULL | ID āļŠāļąāđˆāļ§āļ„āļĢāļēāļ§āļŠāļģāļŦāļĢāļąāļšāļ­āđ‰āļēāļ‡āļ­āļīāļ‡āļ•āļ­āļ™ Upload Phase 1 (āļ­āļēāļˆāđƒāļŠāđ‰āļĢāđˆāļ§āļĄāļāļąāļš id āļŦāļĢāļ·āļ­āđāļĒāļāļāđ‡āđ„āļ”āđ‰) | +| expires_at | DATETIME | NULL | āđ€āļ§āļĨāļēāļŦāļĄāļ”āļ­āļēāļĒāļļāļ‚āļ­āļ‡āđ„āļŸāļĨāđŒ Temp (āđ€āļžāļ·āđˆāļ­āđƒāļŦāđ‰ Cron Job āļĨāļšāļ­āļ­āļ) | +| checksum | VARCHAR(64) | NULL | SHA-256 Checksum āļŠāļģāļŦāļĢāļąāļš Verify File Integrity [Req 3.9.3] | + +**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 | +| **discipline_id** | **INT** | **PRIMARY KEY** | **Discipline ID (0 if not applicable)** | +| current_year | INT | PRIMARY KEY | Year (Buddhist calendar) | +| version | INT | DEFAULT 0 | āđƒāļŠāđ‰āļŠāļģāļŦāļĢāļąāļš Optimistic Locking (āļ•āļĢāļ§āļˆāļŠāļ­āļšāļ„āđˆāļēāļāđˆāļ­āļ™ Update) | +| last_number | INT | DEFAULT 0 | Last assigned sequence number | + +**Indexes**: + +- **PRIMARY KEY (project_id, originator_organization_id, correspondence_type_id, discipline_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**: + +- **Updated v1.4.4:** Composite primary key now includes `discipline_id` to support independent running numbers per discipline (e.g., STR-001, ARC-001). +- Counter resets each year +- Thread-safe increments handled by DocumentNumberingService in NestJS using Redis Lock and Optimistic Locking on version column +- 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 | +| v_ref_project_id | INT | GENERATED ALWAYS AS (...) VIRTUAL | Virtual Column āļ”āļķāļ‡ Project ID āļˆāļēāļ JSON details āđ€āļžāļ·āđˆāļ­āļ—āļģ Index | +| v_ref_type | VARCHAR(50) | GENERATED ALWAYS AS (...) VIRTUAL | Virtual Column āļ”āļķāļ‡ Type āļˆāļēāļ JSON details | +| request_id | VARCHAR(100) | NULL | Request ID/Trace ID āđ€āļžāļ·āđˆāļ­āđ€āļŠāļ·āđˆāļ­āļĄāđ‚āļĒāļ‡āļāļąāļš App Logs | +| severity | ENUM('INFO', 'WARN', 'ERROR', 'CRITICAL') | NULL | āļĢāļ°āļ”āļąāļšāļ„āļ§āļēāļĄāļĢāļļāļ™āđāļĢāļ‡āļ‚āļ­āļ‡āđ€āļŦāļ•āļļāļāļēāļĢāļ“āđŒ | + +**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) +- INDEX (v_ref_project_id) +- INDEX (v_ref_type) + +**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) + +**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 + +--- + +### 10.5 json_schemas + +**Purpose**: āļ­āļ‡āļĢāļąāļš **Centralized JSON Schema Registry** āđ€āļžāļ·āđˆāļ­ Validate āļ‚āđ‰āļ­āļĄāļđāļĨ JSON Details āļ‚āļ­āļ‡āđ€āļ­āļāļŠāļēāļĢāđāļ•āđˆāļĨāļ°āļ›āļĢāļ°āđ€āļ āļ— āļ•āļēāļĄ Requirements 6.11.1 āđāļĨāļ° Backend Plan T2.5.1 + +| Column Name | Data Type | Constraints | Description | +| :-------------------- | :------------- | :--------------- | :------------------------------------------------- | +| **id** | `INT` | PK, AI | Unique Identifier | +| **schema_code** | `VARCHAR(100)` | UNIQUE, NOT NULL | āļĢāļŦāļąāļŠ Schema (āđ€āļŠāđˆāļ™ `RFA_DWG_V1`, `CORR_RFI_V1`) | +| **version** | `INT` | NOT NULL | āđ€āļ§āļ­āļĢāđŒāļŠāļąāļ™āļ‚āļ­āļ‡ Schema | +| **schema_definition** | `JSON` | NOT NULL | āđ‚āļ„āļĢāļ‡āļŠāļĢāđ‰āļēāļ‡ JSON Schema (Standard JSON Schema format) | +| **is_active** | `BOOLEAN` | DEFAULT TRUE | āļŠāļ–āļēāļ™āļ°āļāļēāļĢāđƒāļŠāđ‰āļ‡āļēāļ™ | +| **created_at** | `TIMESTAMP` | | āļ§āļąāļ™āļ—āļĩāđˆāļŠāļĢāđ‰āļēāļ‡ | + +### 10.6 user_preferences + +**Purpose**: āđāļĒāļāļ‚āđ‰āļ­āļĄāļđāļĨāļāļēāļĢāļ•āļąāđ‰āļ‡āļ„āđˆāļēāļŠāđˆāļ§āļ™āļ•āļąāļ§ (āđ€āļŠāđˆāļ™ Notification Settings) āļ­āļ­āļāļˆāļēāļāļ•āļēāļĢāļēāļ‡ Users āđ€āļžāļ·āđˆāļ­āļ„āļ§āļēāļĄāļĒāļ·āļ”āļŦāļĒāļļāđˆāļ™ āļ•āļēāļĄ Requirements 5.5 āđāļĨāļ° 6.8.3 + +| Column Name | Data Type | Constraints | Description | +| :--------------- | :------------ | :-------------- | :------------------------------------- | +| **user_id** | `INT` | PK, FK | āļ­āđ‰āļēāļ‡āļ­āļīāļ‡āļ•āļēāļĢāļēāļ‡ users | +| **notify_email** | `BOOLEAN` | DEFAULT TRUE | āļĢāļąāļšāđāļˆāđ‰āļ‡āđ€āļ•āļ·āļ­āļ™āļ—āļēāļ‡āļ­āļĩāđ€āļĄāļĨ | +| **notify_line** | `BOOLEAN` | DEFAULT TRUE | āļĢāļąāļšāđāļˆāđ‰āļ‡āđ€āļ•āļ·āļ­āļ™āļ—āļēāļ‡ LINE | +| **digest_mode** | `BOOLEAN` | DEFAULT TRUE | āļĢāļąāļšāđāļˆāđ‰āļ‡āđ€āļ•āļ·āļ­āļ™āđāļšāļšāļĢāļ§āļĄ (Digest) āđāļ—āļ™ Real-time | +| **ui_theme** | `VARCHAR(20)` | DEFAULT 'light' | āļ˜āļĩāļĄāļŦāļ™āđ‰āļēāļˆāļ­ (Light/Dark) | +| **updated_at** | `TIMESTAMP` | | āļ§āļąāļ™āļ—āļĩāđˆāđāļāđ‰āđ„āļ‚āļĨāđˆāļēāļŠāļļāļ” | + +## **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, project_code, project_iname +- organization_id, organization_code, organization_name +- revision_id, revision_number, revision_label +- title, document_date, issued_date, received_date, due_date +- correspondence_status_id, correspondence_status_code, correspondence_status_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, rfa_type_code, rfa_type_name +- correspondence_id, correspondence_number +- project_id, project_code, project_iname +- organization_id, organization_name +- revision_id, revision_number, revision_label +- title, document_date, issued_date, received_date, approved_date +- rfa_status_code_id, rfa_status_code, rfa_status_name +- rfa_approve_code_id, rfa_approve_code, rfa_approve_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, contract_code, contract_name +- project_id, project_code, project_iname +- organization_id, organization_code, organization_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, project_code, project_name +- user_id, username, first_name, last_name +- organization_id, organization_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, project_code, project_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, project_code, project_name +- correspondence_type_id, correspondence_type_code, correspondence_type_name +- status_id, status_code, status_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 + +--- + +## 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) + +--- + +## 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 DocumentNumberingService.generateNextNumber() (NestJS) which handles Redis locking and retry logic + - 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 v1.4.4 +- **Version:** 1.4 +- **Date:** 2025-11-26 +- **Author:** NAP LCBP3-DMS & Gemini +- **Status:** FINAL.Rev.04 +- **Classification:** Internal Technical Documentation +- **Approved By:** Nattanin + +--- + +`End of Data Dictionary v1.4.4 (āļ‰āļšāļąāļšāļ›āļĢāļąāļšāļ›āļĢāļļāļ‡)` diff --git a/01_lcbp3_v1_4_3.sql b/8_lcbp3_v1_4_4.sql similarity index 75% rename from 01_lcbp3_v1_4_3.sql rename to 8_lcbp3_v1_4_4.sql index 3fbe817..d97f7e2 100644 --- a/01_lcbp3_v1_4_3.sql +++ b/8_lcbp3_v1_4_4.sql @@ -1,5 +1,5 @@ -- ========================================================== --- DMS v1.4.3 Document Management System Database +-- DMS v1.4.4 Document Management System Database -- Deploy Script Schema -- Server: Container Station on QNAPQNAP TS-473A -- Database service: MariaDB 10.11 @@ -9,8 +9,13 @@ -- frontend sevice: next.js -- reverse proxy: jc21/nginx-proxy-manager:latest -- cron service: n8n --- DMS v1.4.3 Improvements --- Update: revise fron v1.4.2 add PARTITION to audit_logs & notification +-- DMS v1.4.4 Improvements +-- Update: revise from v1.4.3 +-- 1. add disciplines, correspondence_sub_types +-- 2. āļ›āļĢāļąāļšāļ›āļĢāļļāļ‡āļ•āļēāļĢāļēāļ‡ RFAs āđāļĨāļ° Correspondences (āđ€āļžāļīāđˆāļĄ Column, document_number_counters +-- 3. āļ›āļĢāļąāļšāļ›āļĢāļļāļ‡ SEED DATA +-- 4. āļ›āļĢāļąāļšāļ›āļĢāļļāļ‡ v_current_rfas +-- 5. āđāļĒāļ Seed Data āļ­āļ­āļāļˆāļēāļ Deploy Script Schema -- ========================================================== SET NAMES utf8mb4; SET time_zone = '+07:00'; @@ -100,6 +105,9 @@ DROP TABLE IF EXISTS correspondences; -- ============================================================ -- āļŠāđˆāļ§āļ™āļ—āļĩāđˆ 8: āļ•āļēāļĢāļēāļ‡āļŦāļĄāļ§āļ”āļŦāļĄāļđāđˆāđāļĨāļ°āļ‚āđ‰āļ­āļĄāļđāļĨāļŦāļĨāļąāļ (Master Data) -- ============================================================ +-- [NEW 6B] āļĨāļšāļ•āļēāļĢāļēāļ‡āđƒāļŦāļĄāđˆāļ—āļĩāđˆāđ€āļžāļīāđˆāļĄāđ€āļ‚āđ‰āļēāļĄāļēāđ€āļžāļ·āđˆāļ­āļ›āđ‰āļ­āļ‡āļāļąāļ™ Error āđ€āļ§āļĨāļē Re-deploy +DROP TABLE IF EXISTS correspondence_sub_types; +DROP TABLE IF EXISTS disciplines; DROP TABLE IF EXISTS shop_drawing_sub_categories; DROP TABLE IF EXISTS shop_drawing_main_categories; DROP TABLE IF EXISTS contract_drawing_sub_cats; @@ -145,54 +153,6 @@ CREATE TABLE organizations ( 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 āļ‚āļ­āļ‡āļ•āļēāļĢāļēāļ‡', @@ -203,27 +163,6 @@ CREATE TABLE projects ( 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 āļ‚āļ­āļ‡āļ•āļēāļĢāļēāļ‡', @@ -238,83 +177,6 @@ CREATE TABLE contracts ( 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 (āļœāļđāđ‰āđƒāļŠāđ‰, āļŠāļīāļ—āļ˜āļīāđŒ, āļšāļ—āļšāļēāļ—) -- ===================================================== @@ -338,57 +200,6 @@ CREATE TABLE users ( 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` ( - `user_id`, - `username`, - `password_hash`, - `first_name`, - `last_name`, - `email`, - `line_id`, - `primary_organization_id` - ) -VALUES ( - 1, - 'superadmin', - '$2b$10$E6d5k.f46jr.POGWKHhiQ.X1ZsFrMpZox//sCxeOiLUULGuAHO0NW', - 'Super', - 'Admin', - 'superadmin @example.com', - NULL, - NULL - ), - ( - 2, - 'admin', - '$2b$10$E6d5k.f46jr.POGWKHhiQ.X1ZsFrMpZox//sCxeOiLUULGuAHO0NW', - 'Admin', - 'āļ„āļ„āļ‡.', - 'admin@example.com', - NULL, - 1 - ), - ( - 3, - 'editor01', - '$2b$10$E6d5k.f46jr.POGWKHhiQ.X1ZsFrMpZox//sCxeOiLUULGuAHO0NW', - 'DC', - 'C1', - 'editor01 @example.com', - NULL, - 41 - ), - ( - 4, - 'viewer01', - '$2b$10$E6d5k.f46jr.POGWKHhiQ.X1ZsFrMpZox//sCxeOiLUULGuAHO0NW', - 'Viewer', - 'āļŠāļ„āļ‰.03', - 'viewer01 @example.com', - NULL, - 10 - ); -- āļ•āļēāļĢāļēāļ‡ Master āđ€āļāđ‡āļš "āļšāļ—āļšāļēāļ—" āļ‚āļ­āļ‡āļœāļđāđ‰āđƒāļŠāđ‰āđƒāļ™āļĢāļ°āļšāļš CREATE TABLE roles ( role_id INT PRIMARY KEY AUTO_INCREMENT COMMENT 'ID āļ‚āļ­āļ‡āļ•āļēāļĢāļēāļ‡', @@ -399,65 +210,6 @@ CREATE TABLE roles ( 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 āļ‚āļ­āļ‡āļ•āļēāļĢāļēāļ‡', @@ -467,187 +219,6 @@ CREATE TABLE permissions ( 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 āļ‚āļ­āļ‡āļšāļ—āļšāļēāļ—', @@ -656,233 +227,6 @@ CREATE TABLE role_permissions ( 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 ( @@ -926,33 +270,6 @@ CREATE TABLE user_assignments ( ) -- āļŠāļģāļŦāļĢāļąāļš Global scope ) ); -INSERT INTO `user_assignments` ( - `id`, - `user_id`, - `role_id`, - `organization_id`, - `project_id`, - `contract_id`, - `assigned_by_user_id` - ) -VALUES ( - 1, - 1, - 1, - NULL, - NULL, - NULL, - NULL - ), - ( - 2, - 2, - 2, - 1, - NULL, - NULL, - NULL - ); CREATE TABLE project_organizations ( project_id INT NOT NULL, organization_id INT NOT NULL, @@ -970,193 +287,6 @@ CREATE TABLE contract_organizations ( 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 āđ€āļāđ‡āļšāļ›āļĢāļ°āđ€āļ āļ—āđ€āļ­āļāļŠāļēāļĢāđ‚āļ•āđ‰āļ•āļ­āļš @@ -1186,30 +316,6 @@ CREATE TABLE correspondence_status ( 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" āļ—āļĩāđˆāđƒāļŠāđ‰āđ€āļŠāļ·āđˆāļ­āļĄāđ‚āļĒāļ‡)', @@ -1378,25 +484,49 @@ CREATE TABLE correspondence_routings ( ) 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 'āļŠāļ–āļēāļ™āļ°āļāļēāļĢāđƒāļŠāđ‰āļ‡āļēāļ™ ' + id INT PRIMARY KEY NOT NULL AUTO_INCREMENT COMMENT 'ID āļ‚āļ­āļ‡āļ•āļēāļĢāļēāļ‡', + contract_id INT NOT NULL COMMENT 'āļœāļđāļāļāļąāļšāļŠāļąāļāļāļē', + type_code VARCHAR(20) NOT NULL COMMENT 'āļĢāļŦāļąāļŠāļ›āļĢāļ°āđ€āļ āļ— RFA (āđ€āļŠāđˆāļ™ DWG, DOC, MAT)', + type_name_th VARCHAR(100) NOT NULL COMMENT 'āļŠāļ·āđˆāļ­āļ›āļĢāļ°āđ€āļ āļ— RFA th', + type_name_en VARCHAR(100) NOT NULL COMMENT 'āļŠāļ·āđˆāļ­āļ›āļĢāļ°āđ€āļ āļ— RFA en', + remark TEXT COMMENT 'āļŦāļĄāļēāļĒāđ€āļŦāļ•āļļ', + -- sort_order INT DEFAULT 0 COMMENT 'āļĨāļģāļ”āļąāļšāļāļēāļĢāđāļŠāļ”āļ‡āļœāļĨ', + is_active TINYINT(1) DEFAULT 1 COMMENT 'āļŠāļ–āļēāļ™āļ°āļāļēāļĢāđƒāļŠāđ‰āļ‡āļēāļ™ ', + UNIQUE KEY uk_rfa_types_contract_code (contract_id, type_code), + FOREIGN KEY (contract_id) REFERENCES contracts(id) ON DELETE CASCADE ) 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); +-- [NEW 6B] āļ•āļēāļĢāļēāļ‡āđ€āļāđ‡āļšāļ‚āđ‰āļ­āļĄāļđāļĨāļŠāļēāļ‚āļēāļ‡āļēāļ™ (Disciplines) āđāļĒāļāļ•āļēāļĄāļŠāļąāļāļāļē +CREATE TABLE disciplines ( + id INT PRIMARY KEY AUTO_INCREMENT COMMENT 'ID āļ‚āļ­āļ‡āļ•āļēāļĢāļēāļ‡', + contract_id INT NOT NULL COMMENT 'āļœāļđāļāļāļąāļšāļŠāļąāļāļāļē', + discipline_code VARCHAR(10) NOT NULL COMMENT 'āļĢāļŦāļąāļŠāļŠāļēāļ‚āļē (āđ€āļŠāđˆāļ™ GEN, STR)', + code_name_th VARCHAR(255) COMMENT 'āļŠāļ·āđˆāļ­āđ„āļ—āļĒ', + code_name_en VARCHAR(255) COMMENT 'āļŠāļ·āđˆāļ­āļ­āļąāļ‡āļāļĪāļĐ', + is_active TINYINT(1) DEFAULT 1 COMMENT 'āļŠāļ–āļēāļ™āļ°āļāļēāļĢāđƒāļŠāđ‰āļ‡āļēāļ™', + created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP, + updated_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP, + FOREIGN KEY (contract_id) REFERENCES contracts(id) ON DELETE CASCADE, + UNIQUE KEY uk_discipline_contract (contract_id, discipline_code) +) ENGINE = InnoDB DEFAULT CHARSET = utf8mb4 COLLATE = utf8mb4_general_ci COMMENT = 'āļ•āļēāļĢāļēāļ‡āđ€āļāđ‡āļšāļ‚āđ‰āļ­āļĄāļđāļĨāļŠāļēāļ‚āļēāļ‡āļēāļ™ (Disciplines) āļ•āļēāļĄ Req 6B'; +-- [NEW 6B] āļ•āļēāļĢāļēāļ‡āđ€āļāđ‡āļšāļ›āļĢāļ°āđ€āļ āļ—āļŦāļ™āļąāļ‡āļŠāļ·āļ­āļĒāđˆāļ­āļĒ (Sub Types) āļŠāļģāļŦāļĢāļąāļš Mapping āđ€āļĨāļ‚āļĢāļŦāļąāļŠ +CREATE TABLE correspondence_sub_types ( + id INT PRIMARY KEY AUTO_INCREMENT COMMENT 'ID āļ‚āļ­āļ‡āļ•āļēāļĢāļēāļ‡', + contract_id INT NOT NULL COMMENT 'āļœāļđāļāļāļąāļšāļŠāļąāļāļāļē', + correspondence_type_id INT NOT NULL COMMENT 'āļœāļđāļāļāļąāļšāļ›āļĢāļ°āđ€āļ āļ—āđ€āļ­āļāļŠāļēāļĢāļŦāļĨāļąāļ (āđ€āļŠāđˆāļ™ RFA)', + sub_type_code VARCHAR(20) NOT NULL COMMENT 'āļĢāļŦāļąāļŠāļĒāđˆāļ­āļĒ (āđ€āļŠāđˆāļ™ MAT, SHP)', + sub_type_name VARCHAR(255) COMMENT 'āļŠāļ·āđˆāļ­āļ›āļĢāļ°āđ€āļ āļ—āļŦāļ™āļąāļ‡āļŠāļ·āļ­āļĒāđˆāļ­āļĒ', + sub_type_number VARCHAR(10) COMMENT 'āđ€āļĨāļ‚āļĢāļŦāļąāļŠāļŠāļģāļŦāļĢāļąāļš Running Number (āđ€āļŠāđˆāļ™ 11, 22)', + created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP, + FOREIGN KEY (contract_id) REFERENCES contracts(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 = 'āļ•āļēāļĢāļēāļ‡āđ€āļāđ‡āļšāļ›āļĢāļ°āđ€āļ āļ—āļŦāļ™āļąāļ‡āļŠāļ·āļ­āļĒāđˆāļ­āļĒ (Sub Types) āļ•āļēāļĄ Req 6B'; +-- āļŦāļĢāļ·āļ­āđƒāļŠāđ‰ ALTER TABLE (āđāļ™āļ°āļ™āļģāđƒāļŦāđ‰āļĢāļąāļ™āļŦāļĨāļąāļ‡āļŠāļĢāđ‰āļēāļ‡āļ•āļēāļĢāļēāļ‡ disciplines āđ€āļŠāļĢāđ‡āļˆ) +ALTER TABLE correspondences +ADD COLUMN discipline_id INT NULL COMMENT 'āļŠāļēāļ‚āļēāļ‡āļēāļ™ (āļ–āđ‰āļēāļĄāļĩ)' +AFTER correspondence_type_id; +ALTER TABLE correspondences +ADD CONSTRAINT fk_corr_discipline FOREIGN KEY (discipline_id) REFERENCES disciplines(id) ON DELETE +SET NULL; -- āļ•āļēāļĢāļēāļ‡ Master āļŠāļģāļŦāļĢāļąāļšāļŠāļ–āļēāļ™āļ° RFA CREATE TABLE rfa_status_codes ( id INT PRIMARY KEY AUTO_INCREMENT COMMENT 'ID āļ‚āļ­āļ‡āļ•āļēāļĢāļēāļ‡', @@ -1406,19 +536,6 @@ CREATE TABLE rfa_status_codes ( 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 āļ‚āļ­āļ‡āļ•āļēāļĢāļēāļ‡', @@ -1432,22 +549,6 @@ CREATE TABLE rfa_approve_codes ( 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', @@ -1458,6 +559,12 @@ CREATE TABLE rfas ( 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)'; +ALTER TABLE rfas +ADD COLUMN discipline_id INT NULL COMMENT 'āļŠāļēāļ‚āļēāļ‡āļēāļ™ (āļ–āđ‰āļēāļĄāļĩ)' +AFTER rfa_type_id; +ALTER TABLE rfas +ADD CONSTRAINT fk_rfa_discipline FOREIGN KEY (discipline_id) REFERENCES disciplines(id) ON DELETE +SET NULL; -- āļ•āļēāļĢāļēāļ‡ "āļĨāļđāļ" āđ€āļāđ‡āļšāļ›āļĢāļ°āļ§āļąāļ•āļī (Revisions) āļ‚āļ­āļ‡ rfas (1:N) CREATE TABLE rfa_revisions ( id INT PRIMARY KEY AUTO_INCREMENT COMMENT 'ID āļ‚āļ­āļ‡ Revision', @@ -1867,10 +974,12 @@ CREATE TABLE document_number_formats ( -- 2.1 Document Numbering - Optimistic Locking -- āļĢāļ­āļ‡āļĢāļąāļš: Backend Plan T2.3, Req 3.10.5 -- āđ€āļŦāļ•āļļāļœāļĨ: āļ›āđ‰āļ­āļ‡āļāļąāļ™ Race Condition āđ€āļ§āļĨāļēāļ‚āļ­āđ€āļĨāļ‚āļ—āļĩāđˆāđ€āļ­āļāļŠāļēāļĢāļžāļĢāđ‰āļ­āļĄāļāļąāļ™ +-- [UPDATED 6B] āļ•āļēāļĢāļēāļ‡āđ€āļāđ‡āļš "āļ•āļąāļ§āļ™āļąāļš" (Running Number) āļĨāđˆāļēāļŠāļļāļ” āļĢāļ­āļ‡āļĢāļąāļš Discipline CREATE TABLE document_number_counters ( project_id INT COMMENT 'āđ‚āļ„āļĢāļ‡āļāļēāļĢ', originator_organization_id INT COMMENT 'āļ­āļ‡āļ„āđŒāļāļĢāļœāļđāđ‰āļŠāđˆāļ‡', correspondence_type_id INT COMMENT 'āļ›āļĢāļ°āđ€āļ āļ—āđ€āļ­āļāļŠāļēāļĢ', + discipline_id INT DEFAULT 0 COMMENT '[NEW] āļŠāļēāļ‚āļēāļ‡āļēāļ™ (0 = āđ„āļĄāđˆāļĢāļ°āļšāļļ)', current_year INT COMMENT 'āļ›āļĩ āļ„.āļĻ.āļ‚āļ­āļ‡āļ•āļąāļ§āļ™āļąāļš', version INT DEFAULT 0 NOT NULL COMMENT 'Optimistic Lock Version', last_number INT DEFAULT 0 COMMENT 'āđ€āļĨāļ‚āļ—āļĩāđˆāļĨāđˆāļēāļŠāļļāļ”āļ—āļĩāđˆāđƒāļŠāđ‰āđ„āļ›āđāļĨāđ‰āļ§', @@ -1878,6 +987,8 @@ CREATE TABLE document_number_counters ( project_id, originator_organization_id, correspondence_type_id, + discipline_id, + -- āđ€āļžāļīāđˆāļĄ Key āļ™āļĩāđ‰ current_year ), FOREIGN KEY (project_id) REFERENCES projects(id) ON DELETE CASCADE, @@ -2167,7 +1278,8 @@ 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, + rt.type_name_th AS rfa_type_name_th, + rt.type_name_en AS rfa_type_name_en, rr.correspondence_id, c.correspondence_number, c.project_id, diff --git a/8_lcbp3_v1_4_4_seed.sql b/8_lcbp3_v1_4_4_seed.sql new file mode 100644 index 0000000..17d1a8c --- /dev/null +++ b/8_lcbp3_v1_4_4_seed.sql @@ -0,0 +1,2127 @@ +-- ========================================================== +-- DMS v1.4.4 Document Management System Database +-- Deploy Seed Data +-- ========================================================== +-- 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'); +-- Seed project +INSERT INTO projects (project_code, project_name) +VALUES ( + 'LCBP3', + 'āđ‚āļ„āļĢāļ‡āļāļēāļĢāļžāļąāļ’āļ™āļēāļ—āđˆāļēāđ€āļĢāļ·āļ­āđāļŦāļĨāļĄāļ‰āļšāļąāļ‡ āļĢāļ°āļĒāļ°āļ—āļĩāđˆ 3 (āļŠāđˆāļ§āļ™āļ—āļĩāđˆ 1-4)' + ), + ( + 'LCBP3C1', + 'āđ‚āļ„āļĢāļ‡āļāļēāļĢāļžāļąāļ’āļ™āļēāļ—āđˆāļēāđ€āļĢāļ·āļ­āđāļŦāļĨāļĄāļ‰āļšāļąāļ‡ āļĢāļ°āļĒāļ°āļ—āļĩāđˆ 3 (āļŠāđˆāļ§āļ™āļ—āļĩāđˆ 1) āļ‡āļēāļ™āļāđˆāļ­āļŠāļĢāđ‰āļēāļ‡āļ‡āļēāļ™āļ—āļēāļ‡āļ—āļ°āđ€āļĨ' + ), + ( + 'LCBP3C2', + 'āđ‚āļ„āļĢāļ‡āļāļēāļĢāļžāļąāļ’āļ™āļēāļ—āđˆāļēāđ€āļĢāļ·āļ­āđāļŦāļĨāļĄāļ‰āļšāļąāļ‡ āļĢāļ°āļĒāļ°āļ—āļĩāđˆ 3 (āļŠāđˆāļ§āļ™āļ—āļĩāđˆ 2) āļ‡āļēāļ™āļāđˆāļ­āļŠāļĢāđ‰āļēāļ‡āļ­āļēāļ„āļēāļĢ āļ—āđˆāļēāđ€āļ—āļĩāļĒāļšāđ€āļĢāļ·āļ­ āļĢāļ°āļšāļšāļ–āļ™āļ™ āđāļĨāļ°āļĢāļ°āļšāļšāļŠāļēāļ˜āļēāļĢāļ“āļđāļ›āđ‚āļ āļ„' + ), + ( + 'LCBP3C3', + 'āđ‚āļ„āļĢāļ‡āļāļēāļĢāļžāļąāļ’āļ™āļēāļ—āđˆāļēāđ€āļĢāļ·āļ­āđāļŦāļĨāļĄāļ‰āļšāļąāļ‡ āļĢāļ°āļĒāļ°āļ—āļĩāđˆ 3 (āļŠāđˆāļ§āļ™āļ—āļĩāđˆ 3) āļ‡āļēāļ™āļāđˆāļ­āļŠāļĢāđ‰āļēāļ‡' + ), + ( + 'LCBP3C4', + 'āđ‚āļ„āļĢāļ‡āļāļēāļĢāļžāļąāļ’āļ™āļēāļ—āđˆāļēāđ€āļĢāļ·āļ­āđāļŦāļĨāļĄāļ‰āļšāļąāļ‡ āļĢāļ°āļĒāļ°āļ—āļĩāđˆ 3 (āļŠāđˆāļ§āļ™āļ—āļĩāđˆ 4) āļ‡āļēāļ™āļāđˆāļ­āļŠāļĢāđ‰āļēāļ‡' + ); +-- Seed contract +-- āđƒāļŠāđ‰ 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 + ); +-- Seed user +-- Initial SUPER_ADMIN user +INSERT INTO `users` ( + `user_id`, + `username`, + `password_hash`, + `first_name`, + `last_name`, + `email`, + `line_id`, + `primary_organization_id` + ) +VALUES ( + 1, + 'superadmin', + '$2b$10$E6d5k.f46jr.POGWKHhiQ.X1ZsFrMpZox//sCxeOiLUULGuAHO0NW', + 'Super', + 'Admin', + 'superadmin @example.com', + NULL, + NULL + ), + ( + 2, + 'admin', + '$2b$10$E6d5k.f46jr.POGWKHhiQ.X1ZsFrMpZox//sCxeOiLUULGuAHO0NW', + 'Admin', + 'āļ„āļ„āļ‡.', + 'admin@example.com', + NULL, + 1 + ), + ( + 3, + 'editor01', + '$2b$10$E6d5k.f46jr.POGWKHhiQ.X1ZsFrMpZox//sCxeOiLUULGuAHO0NW', + 'DC', + 'C1', + 'editor01 @example.com', + NULL, + 41 + ), + ( + 4, + 'viewer01', + '$2b$10$E6d5k.f46jr.POGWKHhiQ.X1ZsFrMpZox//sCxeOiLUULGuAHO0NW', + 'Viewer', + 'āļŠāļ„āļ‰.03', + 'viewer01 @example.com', + NULL, + 10 + ); +-- ========================================================== +-- 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', + 'āļœāļđāđ‰āļ”āļđāđāļĨāļŠāļąāļāļāļē: āļˆāļąāļ”āļāļēāļĢāļŠāļĄāļēāļŠāļīāļāđƒāļ™āļŠāļąāļāļāļē, āļŠāļĢāđ‰āļēāļ‡ / āļˆāļąāļ”āļāļēāļĢāļ‚āđ‰āļ­āļĄāļđāļĨāļŦāļĨāļąāļāđ€āļ‰āļžāļēāļ°āļŠāļąāļāļāļē, āđāļĨāļ°āļ­āļ™āļļāļĄāļąāļ•āļīāđ€āļ­āļāļŠāļēāļĢāđƒāļ™āļŠāļąāļāļāļē' + ); +-- ===================================================== +-- 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', + 'āļŠāļĢāđ‰āļēāļ‡āļĢāļēāļĒāļ‡āļēāļ™āļŠāļĢāļļāļ› (āļĢāļēāļĒāļ§āļąāļ™ / āļŠāļąāļ›āļ”āļēāļŦāđŒ / āđ€āļ”āļ·āļ­āļ™ / āļ›āļĩ)' + ); +-- ========================================================== +-- 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); +-- Seed data for the 'user_assignments' table +INSERT INTO `user_assignments` ( + `id`, + `user_id`, + `role_id`, + `organization_id`, + `project_id`, + `contract_id`, + `assigned_by_user_id` + ) +VALUES ( + 1, + 1, + 1, + NULL, + NULL, + NULL, + NULL + ), + ( + 2, + 2, + 2, + 1, + NULL, + NULL, + NULL + ); +-- ===================================================== +-- == 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' + ); +-- Seed correspondence_status +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); +-- Seed rfa_types +INSERT INTO rfa_types ( + contract_id, + type_code, + type_name_en, + type_name_th + ) +SELECT id, + 'ADW', + 'As Built Drawing', + 'āđāļšāļšāļĢāđˆāļēāļ‡āļŦāļĨāļąāļ‡āļāļēāļĢāļāđˆāļ­āļŠāļĢāđ‰āļēāļ‡' +FROM contracts +WHERE contract_code = 'LCBP3-C1' +UNION ALL +SELECT id, + 'BC', + 'Box Culvert', + 'āļ—āđˆāļ­āļĢāļ°āļšāļēāļĒāļ™āđ‰āļģāļĢāļđāļ›āļāļĨāđˆāļ­āļ‡' +FROM contracts +WHERE contract_code = 'LCBP3-C1' +UNION ALL +SELECT id, + 'BM', + 'Benchmark', + 'āļŦāļĄāļļāļ”āļŦāļĨāļąāļāļāļēāļ™' +FROM contracts +WHERE contract_code = 'LCBP3-C1' +UNION ALL +SELECT id, + 'CER', + 'Certificates', + 'āđƒāļšāļĢāļąāļšāļĢāļ­āļ‡' +FROM contracts +WHERE contract_code = 'LCBP3-C1' +UNION ALL +SELECT id, + 'CN', + 'Canal Drainage', + 'āļĢāļ°āļšāļšāļĢāļ°āļšāļēāļĒāļ™āđ‰āļģāđƒāļ™āļ„āļĨāļ­āļ‡' +FROM contracts +WHERE contract_code = 'LCBP3-C1' +UNION ALL +SELECT id, + 'CON', + 'Contract', + 'āļŠāļąāļāļāļē' +FROM contracts +WHERE contract_code = 'LCBP3-C1' +UNION ALL +SELECT id, + 'DDS', + 'Design Data Submission', + 'āļ™āļģāļŠāđˆāļ‡āļ‚āđ‰āļ­āļĄāļđāļĨāļāļēāļĢāļ­āļ­āļāđāļšāļš' +FROM contracts +WHERE contract_code = 'LCBP3-C1' +UNION ALL +SELECT id, + 'DDW', + 'Draft Drawing', + 'āđāļšāļšāļĢāđˆāļēāļ‡' +FROM contracts +WHERE contract_code = 'LCBP3-C1' +UNION ALL +SELECT id, + 'DRW', + 'Drawings (All Types)', + 'āđāļšāļšāļāđˆāļ­āļŠāļĢāđ‰āļēāļ‡' +FROM contracts +WHERE contract_code = 'LCBP3-C1' +UNION ALL +SELECT id, + 'DSN', + 'Design/Calculation/Manual (All Stages)', + 'āļ­āļ­āļāđāļšāļš / āļ„āļģāļ™āļ§āļ“ / āļ„āļđāđˆāļĄāļ·āļ­' +FROM contracts +WHERE contract_code = 'LCBP3-C1' +UNION ALL +SELECT id, + 'GEN', + 'General', + 'āļ—āļąāđˆāļ§āđ„āļ›' +FROM contracts +WHERE contract_code = 'LCBP3-C1' +UNION ALL +SELECT id, + 'ICR', + 'Incident Report', + 'āļĢāļēāļĒāļ‡āļēāļ™āļāļēāļĢāđ€āļāļīāļ”āļ­āļļāļšāļąāļ•āļīāđ€āļŦāļ•āļļāđāļĨāļ°āļāļēāļĢāļšāļēāļ”āđ€āļˆāđ‡āļš' +FROM contracts +WHERE contract_code = 'LCBP3-C1' +UNION ALL +SELECT id, + 'INS', + 'Insurances/Bond/Guarantee', + 'āļāļēāļĢāļ›āļĢāļ°āļāļąāļ™ / āļžāļąāļ™āļ˜āļšāļąāļ•āļĢ / āļāļēāļĢāļ„āđ‰āļģāļ›āļĢāļ°āļāļąāļ™' +FROM contracts +WHERE contract_code = 'LCBP3-C1' +UNION ALL +SELECT id, + 'INR', + 'Inspection/Audit/Surveillance Report', + 'āļĢāļēāļĒāļ‡āļēāļ™āļāļēāļĢāļ•āļĢāļ§āļˆāļŠāļ­āļš / āļāļēāļĢāļ•āļĢāļ§āļˆāļŠāļ­āļš / āļĢāļēāļĒāļ‡āļēāļ™āļāļēāļĢāđ€āļāđ‰āļēāļĢāļ°āļ§āļąāļ‡' +FROM contracts +WHERE contract_code = 'LCBP3-C1' +UNION ALL +SELECT id, + 'ITP', + 'Inspection and Test Plan', + 'āđāļœāļ™āļāļēāļĢāļ•āļĢāļ§āļˆāļŠāļ­āļšāđāļĨāļ°āļ—āļ”āļŠāļ­āļš' +FROM contracts +WHERE contract_code = 'LCBP3-C1' +UNION ALL +SELECT id, + 'JSA', + 'Jobs Analysis', + 'āļĢāļēāļĒāļ‡āļēāļ™āļāļēāļĢāļ§āļīāđ€āļ„āļĢāļēāļ°āļŦāđŒāļ„āļ§āļēāļĄāļ›āļĨāļ­āļ”āļ āļąāļĒ' +FROM contracts +WHERE contract_code = 'LCBP3-C1' +UNION ALL +SELECT id, + 'MAN', + 'Manual', + 'āļ„āļđāđˆāļĄāļ·āļ­' +FROM contracts +WHERE contract_code = 'LCBP3-C1' +UNION ALL +SELECT id, + 'MAT', + 'Materials/Equipment/Plant', + 'āļ§āļąāļŠāļ”āļļ / āļ­āļļāļ›āļāļĢāļ“āđŒ / āđ‚āļĢāļ‡āļ‡āļēāļ™' +FROM contracts +WHERE contract_code = 'LCBP3-C1' +UNION ALL +SELECT id, + 'MOM', + 'Minutes of Meeting', + 'āļĢāļēāļĒāļ‡āļēāļ™āļāļēāļĢāļ›āļĢāļ°āļŠāļļāļĄ' +FROM contracts +WHERE contract_code = 'LCBP3-C1' +UNION ALL +SELECT id, + 'MPR', + 'Monthly Progress Report', + 'āļĢāļēāļĒāļ‡āļēāļ™āļ„āļ§āļēāļĄāļ„āļ·āļšāļŦāļ™āđ‰āļēāļ›āļĢāļ°āļˆāļģāđ€āļ”āļ·āļ­āļ™' +FROM contracts +WHERE contract_code = 'LCBP3-C1' +UNION ALL +SELECT id, + 'MST', + 'Method Statement for Construction/Installation', + 'āļ‚āļąāđ‰āļ™āļ•āļ­āļ™āļāļēāļĢāļāđˆāļ­āļŠāļĢāđ‰āļēāļ‡ / āļ•āļīāļ”āļ•āļąāđ‰āļ‡' +FROM contracts +WHERE contract_code = 'LCBP3-C1' +UNION ALL +SELECT id, + 'NDS', + 'Non-Design Data Submission', + 'āļ™āļģāļŠāđˆāļ‡āļ‚āđ‰āļ­āļĄāļđāļĨāļ—āļĩāđˆāđ„āļĄāđˆāđ€āļāļĩāđˆāļĒāļ§āļ‚āđ‰āļ­āļ‡āļāļąāļšāļāļēāļĢāļ­āļ­āļāđāļšāļš' +FROM contracts +WHERE contract_code = 'LCBP3-C1' +UNION ALL +SELECT id, + 'PMA', + 'Payment/Invoice/Retention/Estimate', + 'āļāļēāļĢāļŠāļģāļĢāļ°āđ€āļ‡āļīāļ™ / āđƒāļšāđāļˆāđ‰āļ‡āļŦāļ™āļĩāđ‰ / āļ›āļĢāļ°āļāļąāļ™āļœāļĨāļ‡āļēāļ™ / āļ›āļĢāļ°āļĄāļēāļ“āļāļēāļĢ' +FROM contracts +WHERE contract_code = 'LCBP3-C1' +UNION ALL +SELECT id, + 'PRD', + 'Procedure', + 'āļĢāļ°āđ€āļšāļĩāļĒāļšāļ›āļāļīāļšāļąāļ•āļī' +FROM contracts +WHERE contract_code = 'LCBP3-C1' +UNION ALL +SELECT id, + 'PRG', + 'Progress of Construction', + 'āļ„āļ§āļēāļĄāļ„āļ·āļšāļŦāļ™āđ‰āļēāļ‚āļ­āļ‡āļāļēāļĢāļāđˆāļ­āļŠāļĢāđ‰āļēāļ‡ / āļ āļēāļžāļ–āđˆāļēāļĒ / āļ§āļīāļ”āļĩāđ‚āļ­' +FROM contracts +WHERE contract_code = 'LCBP3-C1' +UNION ALL +SELECT id, + 'QMS', + 'Quality Document (Plan/Work Instruction)', + 'āđ€āļ­āļāļŠāļēāļĢāļ”āđ‰āļēāļ™āļ„āļļāļ“āļ āļēāļž (āđāļœāļ™āļ‡āļēāļ™ / āļ‚āđ‰āļ­āđāļ™āļ°āļ™āļģāđƒāļ™āļāļēāļĢāļ—āļģāļ‡āļēāļ™)' +FROM contracts +WHERE contract_code = 'LCBP3-C1' +UNION ALL +SELECT id, + 'RPT', + 'Report', + 'āļĢāļēāļĒāļ‡āļēāļ™' +FROM contracts +WHERE contract_code = 'LCBP3-C1' +UNION ALL +SELECT id, + 'SAR', + 'Semi Annual Report', + 'āļĢāļēāļĒāļ‡āļēāļ™āļ›āļĢāļ°āļˆāļģāļŦāļāđ€āļ”āļ·āļ­āļ™' +FROM contracts +WHERE contract_code = 'LCBP3-C1' +UNION ALL +SELECT id, + 'SCH', + 'Schedule and Program', + 'āđāļœāļ™āļ‡āļēāļ™' +FROM contracts +WHERE contract_code = 'LCBP3-C1' +UNION ALL +SELECT id, + 'SDW', + 'Shop Drawing', + 'āđāļšāļšāļ‚āļĒāļēāļĒāļĢāļēāļĒāļĨāļ°āđ€āļ­āļĩāļĒāļ”' +FROM contracts +WHERE contract_code = 'LCBP3-C1' +UNION ALL +SELECT id, + 'SI', + 'Soil Investigation', + 'āļāļēāļĢāļ•āļĢāļ§āļˆāļŠāļ­āļšāļ”āļīāļ™' +FROM contracts +WHERE contract_code = 'LCBP3-C1' +UNION ALL +SELECT id, + 'SPE', + 'Specification', + 'āļ‚āđ‰āļ­āļāļģāļŦāļ™āļ”' +FROM contracts +WHERE contract_code = 'LCBP3-C1' +UNION ALL +SELECT id, + 'TNR', + 'Training Report', + 'āļĢāļēāļĒāļ‡āļēāļ™āļāļēāļĢāļāļķāļāļ›āļāļīāļšāļąāļ•āļī' +FROM contracts +WHERE contract_code = 'LCBP3-C1' +UNION ALL +SELECT id, + 'UC', + 'Underground Construction', + 'āđ‚āļ„āļĢāļ‡āļŠāļĢāđ‰āļēāļ‡āđƒāļ•āđ‰āļ”āļīāļ™' +FROM contracts +WHERE contract_code = 'LCBP3-C1' +UNION ALL +SELECT id, + 'VEN', + 'Vendor', + 'āļœāļđāđ‰āļ‚āļēāļĒ' +FROM contracts +WHERE contract_code = 'LCBP3-C1' +UNION ALL +SELECT id, + 'VRO', + 'Variation Request/Instruction/Order', + 'āļ„āļģāļ‚āļ­āđ€āļ›āļĨāļĩāđˆāļĒāļ™āđāļ›āļĨāļ‡ / āļ‚āđ‰āļ­āđ€āļŠāļ™āļ­āđāļ™āļ° / āļ‚āđ‰āļ­āđ€āļĢāļĩāļĒāļāļĢāđ‰āļ­āļ‡' +FROM contracts +WHERE contract_code = 'LCBP3-C1' +UNION ALL +SELECT id, + 'WTY', + 'Warranty', + 'āļāļēāļĢāļ›āļĢāļ°āļāļąāļ™' +FROM contracts +WHERE contract_code = 'LCBP3-C1' +UNION ALL +SELECT id, + 'GEN', + 'General', + 'āļ—āļąāđˆāļ§āđ„āļ›' +FROM contracts +WHERE contract_code = 'LCBP3-C2' +UNION ALL +SELECT id, + 'CON', + 'Contract', + 'āļŠāļąāļāļāļē' +FROM contracts +WHERE contract_code = 'LCBP3-C2' +UNION ALL +SELECT id, + 'INS', + 'Insurances/Bond/Guarantee', + 'āļāļēāļĢāļ›āļĢāļ°āļāļąāļ™ / āļžāļąāļ™āļ˜āļšāļąāļ•āļĢ / āļāļēāļĢāļ„āđ‰āļģāļ›āļĢāļ°āļāļąāļ™' +FROM contracts +WHERE contract_code = 'LCBP3-C2' +UNION ALL +SELECT id, + 'SCH', + 'Schedule and Program', + 'āđāļœāļ™āļ‡āļēāļ™' +FROM contracts +WHERE contract_code = 'LCBP3-C2' +UNION ALL +SELECT id, + 'PMA', + 'Payment/Invoice/Retention/Estimate', + 'āļāļēāļĢāļŠāļģāļĢāļ°āđ€āļ‡āļīāļ™ / āđƒāļšāđāļˆāđ‰āļ‡āļŦāļ™āļĩāđ‰ / āļ›āļĢāļ°āļāļąāļ™āļœāļĨāļ‡āļēāļ™ / āļ›āļĢāļ°āļĄāļēāļ“āļāļēāļĢ' +FROM contracts +WHERE contract_code = 'LCBP3-C2' +UNION ALL +SELECT id, + 'VRO', + 'Variation Request/Instruction/Order', + 'āļ„āļģāļ‚āļ­āđ€āļ›āļĨāļĩāđˆāļĒāļ™āđāļ›āļĨāļ‡ / āļ‚āđ‰āļ­āđ€āļŠāļ™āļ­āđāļ™āļ° / āļ‚āđ‰āļ­āđ€āļĢāļĩāļĒāļāļĢāđ‰āļ­āļ‡' +FROM contracts +WHERE contract_code = 'LCBP3-C2' +UNION ALL +SELECT id, + 'VEN', + 'Vendor', + 'āļœāļđāđ‰āļ‚āļēāļĒ' +FROM contracts +WHERE contract_code = 'LCBP3-C2' +UNION ALL +SELECT id, + 'WTY', + 'Warranty', + 'āļāļēāļĢāļ›āļĢāļ°āļāļąāļ™' +FROM contracts +WHERE contract_code = 'LCBP3-C2' +UNION ALL +SELECT id, + 'DRW', + 'Drawings (All Types)', + 'āđāļšāļšāļāđˆāļ­āļŠāļĢāđ‰āļēāļ‡' +FROM contracts +WHERE contract_code = 'LCBP3-C2' +UNION ALL +SELECT id, + 'DDW', + 'Draft Drawing', + 'āđāļšāļšāļĢāđˆāļēāļ‡' +FROM contracts +WHERE contract_code = 'LCBP3-C2' +UNION ALL +SELECT id, + 'SDW', + 'Shop Drawing', + 'āđāļšāļšāļ‚āļĒāļēāļĒāļĢāļēāļĒāļĨāļ°āđ€āļ­āļĩāļĒāļ”' +FROM contracts +WHERE contract_code = 'LCBP3-C2' +UNION ALL +SELECT id, + 'ADW', + 'As Built Drawing', + 'āđāļšāļšāļĢāđˆāļēāļ‡āļŦāļĨāļąāļ‡āļāļēāļĢāļāđˆāļ­āļŠāļĢāđ‰āļēāļ‡' +FROM contracts +WHERE contract_code = 'LCBP3-C2' +UNION ALL +SELECT id, + 'DDS', + 'Design Data Submission', + 'āļ™āļģāļŠāđˆāļ‡āļ‚āđ‰āļ­āļĄāļđāļĨāļāļēāļĢāļ­āļ­āļāđāļšāļš' +FROM contracts +WHERE contract_code = 'LCBP3-C2' +UNION ALL +SELECT id, + 'DSN', + 'Design/Calculation/Manual (All Stages)', + 'āļ­āļ­āļāđāļšāļš / āļ„āļģāļ™āļ§āļ“ / āļ„āļđāđˆāļĄāļ·āļ­' +FROM contracts +WHERE contract_code = 'LCBP3-C2' +UNION ALL +SELECT id, + 'NDS', + 'Non-Design Data Submission', + 'āļ™āļģāļŠāđˆāļ‡āļ‚āđ‰āļ­āļĄāļđāļĨāļ—āļĩāđˆāđ„āļĄāđˆāđ€āļāļĩāđˆāļĒāļ§āļ‚āđ‰āļ­āļ‡āļāļąāļšāļāļēāļĢāļ­āļ­āļāđāļšāļš' +FROM contracts +WHERE contract_code = 'LCBP3-C2' +UNION ALL +SELECT id, + 'PRD', + 'Procedure', + 'āļĢāļ°āđ€āļšāļĩāļĒāļšāļ›āļāļīāļšāļąāļ•āļī' +FROM contracts +WHERE contract_code = 'LCBP3-C2' +UNION ALL +SELECT id, + 'MST', + 'Method Statement for Construction/Installation', + 'āļ‚āļąāđ‰āļ™āļ•āļ­āļ™āļāļēāļĢāļāđˆāļ­āļŠāļĢāđ‰āļēāļ‡ / āļ•āļīāļ”āļ•āļąāđ‰āļ‡' +FROM contracts +WHERE contract_code = 'LCBP3-C2' +UNION ALL +SELECT id, + 'QMS', + 'Quality Document (Plan/Work Instruction)', + 'āđ€āļ­āļāļŠāļēāļĢāļ”āđ‰āļēāļ™āļ„āļļāļ“āļ āļēāļž (āđāļœāļ™āļ‡āļēāļ™ / āļ‚āđ‰āļ­āđāļ™āļ°āļ™āļģāđƒāļ™āļāļēāļĢāļ—āļģāļ‡āļēāļ™)' +FROM contracts +WHERE contract_code = 'LCBP3-C2' +UNION ALL +SELECT id, + 'INR', + 'Inspection/Audit/Surveillance Report', + 'āļĢāļēāļĒāļ‡āļēāļ™āļāļēāļĢāļ•āļĢāļ§āļˆāļŠāļ­āļš / āļāļēāļĢāļ•āļĢāļ§āļˆāļŠāļ­āļš / āļĢāļēāļĒāļ‡āļēāļ™āļāļēāļĢāđ€āļāđ‰āļēāļĢāļ°āļ§āļąāļ‡' +FROM contracts +WHERE contract_code = 'LCBP3-C2' +UNION ALL +SELECT id, + 'ITP', + 'Inspection and Test Plan', + 'āđāļœāļ™āļāļēāļĢāļ•āļĢāļ§āļˆāļŠāļ­āļšāđāļĨāļ°āļ—āļ”āļŠāļ­āļš' +FROM contracts +WHERE contract_code = 'LCBP3-C2' +UNION ALL +SELECT id, + 'MAT', + 'Materials/Equipment/Plant', + 'āļ§āļąāļŠāļ”āļļ / āļ­āļļāļ›āļāļĢāļ“āđŒ / āđ‚āļĢāļ‡āļ‡āļēāļ™' +FROM contracts +WHERE contract_code = 'LCBP3-C2' +UNION ALL +SELECT id, + 'SPE', + 'Specification', + 'āļ‚āđ‰āļ­āļāļģāļŦāļ™āļ”' +FROM contracts +WHERE contract_code = 'LCBP3-C2' +UNION ALL +SELECT id, + 'MAN', + 'Manual', + 'āļ„āļđāđˆāļĄāļ·āļ­' +FROM contracts +WHERE contract_code = 'LCBP3-C2' +UNION ALL +SELECT id, + 'CER', + 'Certificates', + 'āđƒāļšāļĢāļąāļšāļĢāļ­āļ‡' +FROM contracts +WHERE contract_code = 'LCBP3-C2' +UNION ALL +SELECT id, + 'SAR', + 'Semi Annual Report', + 'āļĢāļēāļĒāļ‡āļēāļ™āļ›āļĢāļ°āļˆāļģāļŦāļāđ€āļ”āļ·āļ­āļ™' +FROM contracts +WHERE contract_code = 'LCBP3-C2' +UNION ALL +SELECT id, + 'JSA', + 'Jobs Analysis', + 'āļĢāļēāļĒāļ‡āļēāļ™āļāļēāļĢāļ§āļīāđ€āļ„āļĢāļēāļ°āļŦāđŒāļ„āļ§āļēāļĄāļ›āļĨāļ­āļ”āļ āļąāļĒ' +FROM contracts +WHERE contract_code = 'LCBP3-C2' +UNION ALL +SELECT id, + 'MOM', + 'Minutes of Meeting', + 'āļĢāļēāļĒāļ‡āļēāļ™āļāļēāļĢāļ›āļĢāļ°āļŠāļļāļĄ' +FROM contracts +WHERE contract_code = 'LCBP3-C2' +UNION ALL +SELECT id, + 'MPR', + 'Monthly Progress Report', + 'āļĢāļēāļĒāļ‡āļēāļ™āļ„āļ§āļēāļĄāļ„āļ·āļšāļŦāļ™āđ‰āļēāļ›āļĢāļ°āļˆāļģāđ€āļ”āļ·āļ­āļ™' +FROM contracts +WHERE contract_code = 'LCBP3-C2' +UNION ALL +SELECT id, + 'ICR', + 'Incident Report', + 'āļĢāļēāļĒāļ‡āļēāļ™āļāļēāļĢāđ€āļāļīāļ”āļ­āļļāļšāļąāļ•āļīāđ€āļŦāļ•āļļāđāļĨāļ°āļāļēāļĢāļšāļēāļ”āđ€āļˆāđ‡āļš' +FROM contracts +WHERE contract_code = 'LCBP3-C2' +UNION ALL +SELECT id, + 'PRG', + 'Progress of Construction', + 'āļ„āļ§āļēāļĄāļ„āļ·āļšāļŦāļ™āđ‰āļēāļ‚āļ­āļ‡āļāļēāļĢāļāđˆāļ­āļŠāļĢāđ‰āļēāļ‡ / āļ āļēāļžāļ–āđˆāļēāļĒ / āļ§āļīāļ”āļĩāđ‚āļ­' +FROM contracts +WHERE contract_code = 'LCBP3-C2' +UNION ALL +SELECT id, + 'RPT', + 'Report', + 'āļĢāļēāļĒāļ‡āļēāļ™' +FROM contracts +WHERE contract_code = 'LCBP3-C2' +UNION ALL +SELECT id, + 'TNR', + 'Training Report', + 'āļĢāļēāļĒāļ‡āļēāļ™āļāļēāļĢāļāļķāļāļ›āļāļīāļšāļąāļ•āļī' +FROM contracts +WHERE contract_code = 'LCBP3-C2'; +-- Seed rfa_status_codes +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); +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) +-- ========================================================== +-- SEED DATA 6B.md (Disciplines, RFA Types, Sub Types) +-- ========================================================== +-- 1. Seed āļ‚āđ‰āļ­āļĄāļđāļĨ Disciplines (āļŠāļēāļ‚āļēāļ‡āļēāļ™) +-- LCBP3-C1 +INSERT INTO disciplines ( + contract_id, + discipline_code, + code_name_th, + code_name_en + ) +SELECT id, + 'GEN', + 'āļ‡āļēāļ™āļšāļĢāļīāļŦāļēāļĢāđ‚āļ„āļĢāļ‡āļāļēāļĢ', + 'General Management' +FROM contracts +WHERE contract_code = 'LCBP3-C1' +UNION ALL +SELECT id, + 'COD', + 'āļŠāļąāļāļāļēāđāļĨāļ°āļ‚āđ‰āļ­āđ‚āļ•āđ‰āđāļĒāđ‰āļ‡', + 'Contracting' +FROM contracts +WHERE contract_code = 'LCBP3-C1' +UNION ALL +SELECT id, + 'QSB', + 'āļŠāļģāļĢāļ§āļˆāļ›āļĢāļīāļĄāļēāļ“āđāļĨāļ°āļ„āļ§āļšāļ„āļļāļĄāļ‡āļšāļ›āļĢāļ°āļĄāļēāļ“', + 'Quantity Survey and Budget Control' +FROM contracts +WHERE contract_code = 'LCBP3-C1' +UNION ALL +SELECT id, + 'PPG', + 'āļšāļĢāļīāļŦāļēāļĢāđāļœāļ™āđāļĨāļ°āļ„āļ§āļēāļĄāļāđ‰āļēāļ§āļŦāļ™āđ‰āļē', + 'Plan and Progress Management' +FROM contracts +WHERE contract_code = 'LCBP3-C1' +UNION ALL +SELECT id, + 'PRC', + 'āļ‡āļēāļ™āļˆāļąāļ”āļ‹āļ·āđ‰āļ­', + 'Procurement' +FROM contracts +WHERE contract_code = 'LCBP3-C1' +UNION ALL +SELECT id, + 'SUB', + 'āļœāļđāđ‰āļĢāļąāļšāđ€āļŦāļĄāļēāļŠāđˆāļ§āļ‡', + 'Subcontractor' +FROM contracts +WHERE contract_code = 'LCBP3-C1' +UNION ALL +SELECT id, + 'ODC', + 'āļŠāļģāļ™āļąāļāļ‡āļēāļ™-āļ„āļ§āļšāļ„āļļāļĄāđ€āļ­āļāļŠāļēāļĢ', + 'Operation Docment Control' +FROM contracts +WHERE contract_code = 'LCBP3-C1' +UNION ALL +SELECT id, + 'LAW', + 'āļāļŽāļŦāļĄāļēāļĒ', + 'Law' +FROM contracts +WHERE contract_code = 'LCBP3-C1' +UNION ALL +SELECT id, + 'TRF', + 'āļˆāļĢāļēāļˆāļĢ', + 'Traffic' +FROM contracts +WHERE contract_code = 'LCBP3-C1' +UNION ALL +SELECT id, + 'BIM', + 'BIM', + 'Building information modeling' +FROM contracts +WHERE contract_code = 'LCBP3-C1' +UNION ALL +SELECT id, + 'SRV', + 'āļ‡āļēāļ™āļŠāļģāļĢāļ§āļˆ', + 'Survey' +FROM contracts +WHERE contract_code = 'LCBP3-C1' +UNION ALL +SELECT id, + 'SFT', + 'āļ„āļ§āļēāļĄāļ›āļĨāļ­āļ”āļ āļąāļĒ', + 'Safety' +FROM contracts +WHERE contract_code = 'LCBP3-C1' +UNION ALL +SELECT id, + 'BST', + 'āļ‡āļēāļ™āđ‚āļ„āļĢāļ‡āļŠāļĢāđ‰āļēāļ‡āļ­āļēāļ„āļēāļĢ', + 'Building Structure Work' +FROM contracts +WHERE contract_code = 'LCBP3-C1' +UNION ALL +SELECT id, + 'TEM', + 'āļ‡āļēāļ™āļŠāļąāđˆāļ§āļ„āļĢāļēāļ§', + 'Temporary Work' +FROM contracts +WHERE contract_code = 'LCBP3-C1' +UNION ALL +SELECT id, + 'UTL', + 'āļ‡āļēāļ™āļĢāļ°āļšāļšāļŠāļēāļ˜āļēāļĢāļ“āļđāļ›āđ‚āļ āļ„', + 'Utility' +FROM contracts +WHERE contract_code = 'LCBP3-C1' +UNION ALL +SELECT id, + 'EPW', + 'āļ‡āļēāļ™āļĢāļ°āļšāļšāđ„āļŸāļŸāđ‰āļē', + 'Electrical Power Work' +FROM contracts +WHERE contract_code = 'LCBP3-C1' +UNION ALL +SELECT id, + 'ECM', + 'āļ‡āļēāļ™āļĢāļ°āļšāļšāđ„āļŸāļŸāđ‰āļēāļŠāļ·āđˆāļ­āļŠāļēāļĢ', + 'Electrical Communication Work' +FROM contracts +WHERE contract_code = 'LCBP3-C1' +UNION ALL +SELECT id, + 'ENV', + 'āļŠāļīāđˆāļ‡āđāļ§āļ”āļĨāđ‰āļ­āļĄ', + 'Environment' +FROM contracts +WHERE contract_code = 'LCBP3-C1' +UNION ALL +SELECT id, + 'AQV', + 'āļ„āļļāļ“āļ āļēāļžāļ­āļēāļāļēāļĻāđāļĨāļ°āļ„āļ§āļēāļĄāļŠāļąāđˆāļ™āļŠāļ°āđ€āļ—āļ·āļ­āļ™', + 'Air quality and vibration' +FROM contracts +WHERE contract_code = 'LCBP3-C1' +UNION ALL +SELECT id, + 'WAB', + 'āļ„āļļāļ“āļ āļēāļžāļ™āđ‰āļģāđāļĨāļ°āļŠāļĩāļ§āļ§āļīāļ—āļĒāļēāļ—āļēāļ‡āļ™āđ‰āļģ', + 'Water quality and Aquatic biology' +FROM contracts +WHERE contract_code = 'LCBP3-C1' +UNION ALL +SELECT id, + 'ONS', + 'āļ§āļīāļĻāļ§āļāļĢāļĢāļĄāļŠāļēāļĒāļāļąāđˆāļ‡', + 'Onshore Engineer Work' +FROM contracts +WHERE contract_code = 'LCBP3-C1' +UNION ALL +SELECT id, + 'PPR', + 'āļĄāļ§āļĨāļŠāļ™āļŠāļąāļĄāļžāļąāļ™āļ˜āđŒāđāļĨāļ°āļāļēāļĢāļ›āļĢāļ°āļŠāļēāļŠāļąāļĄāļžāļąāļ™āļ˜āđŒ', + 'Public Relations' +FROM contracts +WHERE contract_code = 'LCBP3-C1' +UNION ALL +SELECT id, + 'OSW', + 'āļ‡āļēāļ™āļāđˆāļ­āļŠāļĢāđ‰āļēāļ‡āļ‡āļēāļ™āļ—āļēāļ‡āļ—āļ°āđ€āļĨ', + 'Offshore Work' +FROM contracts +WHERE contract_code = 'LCBP3-C1' +UNION ALL +SELECT id, + 'DRE', + 'āļ‡āļēāļ™āļ‚āļļāļ”āđāļĨāļ°āļ–āļĄāļ—āļ°āđ€āļĨ', + 'Dredging and Reclamation' +FROM contracts +WHERE contract_code = 'LCBP3-C1' +UNION ALL +SELECT id, + 'REV', + 'āļ‡āļēāļ™āļ„āļąāļ™āļŦāļīāļ™āļĨāđ‰āļ­āļĄāļžāļ·āđ‰āļ™āļ—āļĩāđˆāļ–āļĄāļ—āļ°āđ€āļĨ', + 'Revetment' +FROM contracts +WHERE contract_code = 'LCBP3-C1' +UNION ALL +SELECT id, + 'BRW', + 'āļ‡āļēāļ™āđ€āļ‚āļ·āđˆāļ­āļ™āļāļąāļ™āļ„āļĨāļ·āđˆāļ™', + 'Breakwater' +FROM contracts +WHERE contract_code = 'LCBP3-C1' +UNION ALL +SELECT id, + 'SOI', + 'āļ›āļĢāļąāļšāļ›āļĢāļļāļ‡āļ„āļļāļ“āļ āļēāļžāļ”āļīāļ™', + 'Soil Improvement' +FROM contracts +WHERE contract_code = 'LCBP3-C1' +UNION ALL +SELECT id, + 'BLC', + 'āļ‡āļēāļ™āļ›āļĢāļąāļšāļ›āļĢāļļāļ‡āļ„āļĨāļ­āļ‡āļšāļēāļ‡āļĨāļ°āļĄāļļāļ‡', + 'Bang Lamung Canal Bank Protection' +FROM contracts +WHERE contract_code = 'LCBP3-C1' +UNION ALL +SELECT id, + 'FUP', + 'āļ‡āļēāļ™āļ›āļĢāļ°āļ•āļđāļĢāļ°āļšāļēāļĒāļ™āđ‰āļģāđāļĨāļ°āļ—āđˆāļ­āļĨāļ­āļ”', + 'Floodgate & Under Ground Piping Works' +FROM contracts +WHERE contract_code = 'LCBP3-C1' +UNION ALL +SELECT id, + 'SWP', + 'āļ‡āļēāļ™āļ­āļēāļ„āļēāļĢāļ„āļ§āļšāļ„āļļāļĄāļŠāļ–āļēāļ™āļĩāļŠāļđāļšāļ™āđ‰āļģāļ—āļ°āđ€āļĨ', + 'Sea Water Pumping Station Control BuilDing' +FROM contracts +WHERE contract_code = 'LCBP3-C1' +UNION ALL +SELECT id, + 'NAV', + 'āļ‡āļēāļ™āļ•āļīāļ”āļ•āļąāđ‰āļ‡āđ€āļ„āļĢāļ·āđˆāļ­āļ‡āļŦāļĄāļēāļĒāļŠāđˆāļ§āļ‡āļāļēāļĢāđ€āļ”āļīāļ™āđ€āļĢāļ·āļ­', + 'Navigations Aids' +FROM contracts +WHERE contract_code = 'LCBP3-C1' +UNION ALL +SELECT id, + 'GEO', + 'āļ‡āļēāļ™āļ”āđ‰āļēāļ™āļ˜āļĢāļ“āļĩāđ€āļ—āļ„āļ™āļīāļ„', + 'Geotechnical' +FROM contracts +WHERE contract_code = 'LCBP3-C1' +UNION ALL +SELECT id, + 'CRW', + 'āļ‡āļēāļ™āļ”āđ‰āļēāļ™āđ‚āļĒāļ˜āļē - Rock Works', + 'Civil-Rock work' +FROM contracts +WHERE contract_code = 'LCBP3-C1' +UNION ALL +SELECT id, + 'DVR', + 'āļ—āļĩāļĄāļ™āļąāļāļ›āļĢāļ°āļ”āļēāļ™āđ‰āļģ', + 'Dive Work' +FROM contracts +WHERE contract_code = 'LCBP3-C1' +UNION ALL +SELECT id, + 'MTS', + 'āļ‡āļēāļ™āļ—āļ”āļŠāļ­āļšāļ§āļąāļŠāļ”āļļāđāļĨāļ°āļ˜āļĢāļ“āļĩāđ€āļ—āļ„āļ™āļīāļ„', + 'Materials and Geotechnical Testing' +FROM contracts +WHERE contract_code = 'LCBP3-C1' +UNION ALL +SELECT id, + 'OTH', + 'āļ­āļ·āđˆāļ™āđ†', + 'Other' +FROM contracts +WHERE contract_code = 'LCBP3-C1'; +-- LCBP3-C2 +INSERT INTO disciplines ( + contract_id, + discipline_code, + code_name_th, + code_name_en + ) +SELECT id, + 'GEN', + 'āļ‡āļēāļ™āļšāļĢāļīāļŦāļēāļĢāđ‚āļ„āļĢāļ‡āļāļēāļĢ', + 'Project Management' +FROM contracts +WHERE contract_code = 'LCBP3-C2' +UNION ALL +SELECT id, + 'COD', + 'āļŠāļąāļāļāļēāđāļĨāļ°āļ‚āđ‰āļ­āđ‚āļ•āđ‰āđāļĒāđ‰āļ‡', + 'Contracts and arguments' +FROM contracts +WHERE contract_code = 'LCBP3-C2' +UNION ALL +SELECT id, + 'QSB', + 'āļŠāļģāļĢāļ§āļˆāļ›āļĢāļīāļĄāļēāļ“āđāļĨāļ°āļ„āļ§āļšāļ„āļļāļĄāļ‡āļšāļ›āļĢāļ°āļĄāļēāļ“', + 'Survey the quantity and control the budget' +FROM contracts +WHERE contract_code = 'LCBP3-C2' +UNION ALL +SELECT id, + 'PPM', + 'āļšāļĢāļīāļŦāļēāļĢāđāļœāļ™āđāļĨāļ°āļ„āļ§āļēāļĄāļāđ‰āļēāļ§āļŦāļ™āđ‰āļē', + 'Plan Management & Progress' +FROM contracts +WHERE contract_code = 'LCBP3-C2' +UNION ALL +SELECT id, + 'ODC', + 'āļŠāļģāļ™āļąāļāļ‡āļēāļ™-āļ„āļ§āļšāļ„āļļāļĄāđ€āļ­āļāļŠāļēāļĢ', + 'Document Control Office' +FROM contracts +WHERE contract_code = 'LCBP3-C2' +UNION ALL +SELECT id, + 'LAW', + 'āļāļŽāļŦāļĄāļēāļĒ', + 'Law' +FROM contracts +WHERE contract_code = 'LCBP3-C2' +UNION ALL +SELECT id, + 'TRF', + 'āļˆāļĢāļēāļˆāļĢ', + 'Traffic' +FROM contracts +WHERE contract_code = 'LCBP3-C2' +UNION ALL +SELECT id, + 'BIM', + 'Building Information Modeling', + 'Building Information Modeling' +FROM contracts +WHERE contract_code = 'LCBP3-C2' +UNION ALL +SELECT id, + 'SRV', + 'āļ‡āļēāļ™āļŠāļģāļĢāļ§āļˆ', + 'Survey' +FROM contracts +WHERE contract_code = 'LCBP3-C2' +UNION ALL +SELECT id, + 'SFT', + 'āļ„āļ§āļēāļĄāļ›āļĨāļ­āļ”āļ āļąāļĒ', + 'Safety' +FROM contracts +WHERE contract_code = 'LCBP3-C2' +UNION ALL +SELECT id, + 'BST', + 'āļ‡āļēāļ™āđ‚āļ„āļĢāļ‡āļŠāļĢāđ‰āļēāļ‡āļ­āļēāļ„āļēāļĢ', + 'Building Structure' +FROM contracts +WHERE contract_code = 'LCBP3-C2' +UNION ALL +SELECT id, + 'UTL', + 'āļ‡āļēāļ™āļ°āļšāļšāļŠāļēāļ˜āļēāļĢāļ“āļđāļ›āđ‚āļ āļ„', + 'Public Utilities' +FROM contracts +WHERE contract_code = 'LCBP3-C2' +UNION ALL +SELECT id, + 'EPW', + 'āļ‡āļēāļ™āļĢāļ°āļšāļšāđ„āļŸāļŸāđ‰āļē', + 'Electrical Systems' +FROM contracts +WHERE contract_code = 'LCBP3-C2' +UNION ALL +SELECT id, + 'ECM', + 'āļ‡āļēāļ™āļĢāļ°āļšāļšāđ„āļŸāļŸāđ‰āļēāļŠāļ·āđˆāļ­āļŠāļēāļĢ', + 'Electrical Communication System' +FROM contracts +WHERE contract_code = 'LCBP3-C2' +UNION ALL +SELECT id, + 'ENV', + 'āļŠāļīāđˆāļ‡āđāļ§āļ”āļĨāđ‰āļ­āļĄ', + 'Environment' +FROM contracts +WHERE contract_code = 'LCBP3-C2' +UNION ALL +SELECT id, + 'AQV', + 'āļ„āļļāļ“āļ āļēāļžāļ­āļēāļāļēāļĻāđāļĨāļ°āļ„āļ§āļēāļĄāļŠāļąāđˆāļ™āļŠāļ°āđ€āļ—āļ·āļ­āļ™', + 'Air Quality and Vibration' +FROM contracts +WHERE contract_code = 'LCBP3-C2' +UNION ALL +SELECT id, + 'WAB', + 'āļ„āļļāļ“āļ āļēāļžāļ™āđ‰āļģāđāļĨāļ°āļŠāļĩāļ§āļ§āļīāļ—āļĒāļēāļ—āļēāļ‡āļ™āđ‰āļģ', + 'Water Quality and Aquatic Biology' +FROM contracts +WHERE contract_code = 'LCBP3-C2' +UNION ALL +SELECT id, + 'ONS', + 'āļ§āļīāļĻāļ§āļāļĢāļĢāļĄāļŠāļēāļĒāļāļąāđˆāļ‡', + 'Coastal Engineering' +FROM contracts +WHERE contract_code = 'LCBP3-C2' +UNION ALL +SELECT id, + 'PPR', + 'āļĄāļ§āļĨāļŠāļ™āļŠāļąāļĄāļžāļąāļ™āļ˜āđŒāđāļĨāļ°āļ›āļĢāļ°āļŠāļēāļŠāļąāļĄāļžāļąāļ™āļ˜āđŒ', + 'Mass Relations and Public Relations' +FROM contracts +WHERE contract_code = 'LCBP3-C2' +UNION ALL +SELECT id, + 'OFW', + 'āļ‡āļēāļ™āļāđˆāļ­āļŠāļĢāđ‰āļēāļ‡āļ—āļēāļ‡āļ—āļ°āđ€āļĨ', + 'Marine Construction' +FROM contracts +WHERE contract_code = 'LCBP3-C2' +UNION ALL +SELECT id, + 'EXR', + 'āļ‡āļēāļ™āļ‚āļļāļ”āđāļĨāļ°āļ–āļĄāļ—āļ°āđ€āļĨ', + 'Excavation and reclamation' +FROM contracts +WHERE contract_code = 'LCBP3-C2' +UNION ALL +SELECT id, + 'GEO', + 'āļ‡āļēāļ™āļ”āđ‰āļēāļ™āļ˜āļĢāļ“āļĩāđ€āļ—āļ„āļ™āļīāļ„', + 'Geotechnical work' +FROM contracts +WHERE contract_code = 'LCBP3-C2' +UNION ALL +SELECT id, + 'CRW', + 'āļ‡āļēāļ™āļ”āđ‰āļēāļ™āđ‚āļĒāļ˜āļē - Rock Works', + 'Civil Works - Rock Works' +FROM contracts +WHERE contract_code = 'LCBP3-C2' +UNION ALL +SELECT id, + 'DVW', + 'āļ—āļĩāļĄāļ™āļąāļāļ›āļĢāļ°āļ”āļēāļ™āđ‰āļģ', + 'Team of Divers' +FROM contracts +WHERE contract_code = 'LCBP3-C2' +UNION ALL +SELECT id, + 'MTT', + 'āļ‡āļēāļ™āļ—āļ”āļŠāļ­āļšāļ§āļąāļŠāļ”āļļ', + 'Materials Testing' +FROM contracts +WHERE contract_code = 'LCBP3-C2' +UNION ALL +SELECT id, + 'ARC', + 'āļ‡āļēāļ™āļŠāļ–āļēāļ›āļąāļ•āļĒāļāļĢāļĢāļĄ', + 'Architecture' +FROM contracts +WHERE contract_code = 'LCBP3-C2' +UNION ALL +SELECT id, + 'STR', + 'āļ‡āļēāļ™āđ‚āļ„āļĢāļ‡āļŠāļĢāđ‰āļēāļ‡', + 'Structural work' +FROM contracts +WHERE contract_code = 'LCBP3-C2' +UNION ALL +SELECT id, + 'SAN', + 'āļ‡āļēāļ™āļĢāļ°āļšāļšāļŠāļļāļ‚āļēāļ āļīāļšāļēāļĨ', + 'Sanitation System' +FROM contracts +WHERE contract_code = 'LCBP3-C2' +UNION ALL +SELECT id, + 'DRA', + 'āļ‡āļēāļ™āļĢāļ°āļšāļšāļĢāļ°āļšāļēāļĒāļ™āđ‰āļģ', + 'Drainage system work' +FROM contracts +WHERE contract_code = 'LCBP3-C2' +UNION ALL +SELECT id, + 'TER', + 'āļ‡āļēāļ™āļ—āđˆāļēāđ€āļ—āļĩāļĒāļšāđ€āļĢāļ·āļ­', + 'Terminal Work work' +FROM contracts +WHERE contract_code = 'LCBP3-C2' +UNION ALL +SELECT id, + 'BUD', + 'āļ‡āļēāļ™āļ­āļēāļ„āļēāļĢ', + 'Building' +FROM contracts +WHERE contract_code = 'LCBP3-C2' +UNION ALL +SELECT id, + 'ROW', + 'āļ‡āļēāļ™āļ–āļ™āļ™āđāļĨāļ°āļŠāļ°āļžāļēāļ™', + 'Road and Bridge Work' +FROM contracts +WHERE contract_code = 'LCBP3-C2' +UNION ALL +SELECT id, + 'MEC', + 'āļ‡āļēāļ™āđ€āļ„āļĢāļīāļ­āļ‡āļāļĨ', + 'Mechanical work' +FROM contracts +WHERE contract_code = 'LCBP3-C2' +UNION ALL +SELECT id, + 'OTH', + 'āļ­āļ·āđˆāļ™ āđ†', + 'Others' +FROM contracts +WHERE contract_code = 'LCBP3-C2'; +-- 2. Seed āļ‚āđ‰āļ­āļĄāļđāļĨ Correspondence Sub Types (Mapping RFA Types āļāļąāļš Number) +-- āđ€āļ™āļ·āđˆāļ­āļ‡āļˆāļēāļ sub_type_code āļ•āļĢāļ‡āļāļąāļš RFA Type Code āđāļ•āđˆ Req āļ•āđ‰āļ­āļ‡āļāļēāļĢ Mapping āđ€āļ›āđ‡āļ™ Number +-- LCBP3-C1 +INSERT INTO correspondence_sub_types ( + contract_id, + correspondence_type_id, + sub_type_code, + sub_type_name, + sub_type_number + ) +SELECT c.id, + ct.id, + 'MAT', + 'Material Approval', + '11' +FROM contracts c, + correspondence_types ct +WHERE c.contract_code = 'LCBP3-C1' + AND ct.type_code = 'RFA' +UNION ALL +SELECT c.id, + ct.id, + 'SHP', + 'Shop Drawing Submittal', + '12' +FROM contracts c, + correspondence_types ct +WHERE c.contract_code = 'LCBP3-C1' + AND ct.type_code = 'RFA' +UNION ALL +SELECT c.id, + ct.id, + 'DWG', + 'Document Approval', + '13' +FROM contracts c, + correspondence_types ct +WHERE c.contract_code = 'LCBP3-C1' + AND ct.type_code = 'RFA' +UNION ALL +SELECT c.id, + ct.id, + 'MET', + 'Engineering Document Submittal', + '14' +FROM contracts c, + correspondence_types ct +WHERE c.contract_code = 'LCBP3-C1' + AND ct.type_code = 'RFA'; +-- LCBP3-C2 +INSERT INTO correspondence_sub_types ( + contract_id, + correspondence_type_id, + sub_type_code, + sub_type_name, + sub_type_number + ) +SELECT c.id, + ct.id, + 'MAT', + 'Material Approval', + '21' +FROM contracts c, + correspondence_types ct +WHERE c.contract_code = 'LCBP3-C2' + AND ct.type_code = 'RFA' +UNION ALL +SELECT c.id, + ct.id, + 'SHP', + 'Shop Drawing Submittal', + '22' +FROM contracts c, + correspondence_types ct +WHERE c.contract_code = 'LCBP3-C2' + AND ct.type_code = 'RFA' +UNION ALL +SELECT c.id, + ct.id, + 'DWG', + 'Document Approval', + '23' +FROM contracts c, + correspondence_types ct +WHERE c.contract_code = 'LCBP3-C2' + AND ct.type_code = 'RFA' +UNION ALL +SELECT c.id, + ct.id, + 'MET', + 'Engineering Document Submittal', + '24' +FROM contracts c, + correspondence_types ct +WHERE c.contract_code = 'LCBP3-C2' + AND ct.type_code = 'RFA'; +-- LCBP3-C3 +INSERT INTO correspondence_sub_types ( + contract_id, + correspondence_type_id, + sub_type_code, + sub_type_name, + sub_type_number + ) +SELECT c.id, + ct.id, + 'MAT', + 'Material Approval', + '31' +FROM contracts c, + correspondence_types ct +WHERE c.contract_code = 'LCBP3-C3' + AND ct.type_code = 'RFA' +UNION ALL +SELECT c.id, + ct.id, + 'SHP', + 'Shop Drawing Submittal', + '32' +FROM contracts c, + correspondence_types ct +WHERE c.contract_code = 'LCBP3-C3' + AND ct.type_code = 'RFA' +UNION ALL +SELECT c.id, + ct.id, + 'DWG', + 'Document Approval', + '33' +FROM contracts c, + correspondence_types ct +WHERE c.contract_code = 'LCBP3-C3' + AND ct.type_code = 'RFA' +UNION ALL +SELECT c.id, + ct.id, + 'MET', + 'Engineering Document Submittal', + '34' +FROM contracts c, + correspondence_types ct +WHERE c.contract_code = 'LCBP3-C4' + AND ct.type_code = 'RFA'; +-- Note: 6B data has C4 on the right column for MET but C3 on left, checking logic... MD says C3 for first 3 rows, then C4 mixed. I will assume C4 starts at row 12 in the MD table. +-- LCBP3-C4 +INSERT INTO correspondence_sub_types ( + contract_id, + correspondence_type_id, + sub_type_code, + sub_type_name, + sub_type_number + ) +SELECT c.id, + ct.id, + 'MAT', + 'Material Approval', + '41' +FROM contracts c, + correspondence_types ct +WHERE c.contract_code = 'LCBP3-C4' + AND ct.type_code = 'RFA' +UNION ALL +SELECT c.id, + ct.id, + 'SHP', + 'Shop Drawing Submittal', + '42' +FROM contracts c, + correspondence_types ct +WHERE c.contract_code = 'LCBP3-C4' + AND ct.type_code = 'RFA' +UNION ALL +SELECT c.id, + ct.id, + 'DWG', + 'Document Approval', + '43' +FROM contracts c, + correspondence_types ct +WHERE c.contract_code = 'LCBP3-C4' + AND ct.type_code = 'RFA' +UNION ALL +SELECT c.id, + ct.id, + 'MET', + 'Engineering Document Submittal', + '44' +FROM contracts c, + correspondence_types ct +WHERE c.contract_code = 'LCBP3-C4' + AND ct.type_code = 'RFA'; \ No newline at end of file diff --git a/01_lcbp3_v1_4_3 copy.sql b/docs/01_lcbp3_v1_4_3.sql similarity index 100% rename from 01_lcbp3_v1_4_3 copy.sql rename to docs/01_lcbp3_v1_4_3.sql diff --git a/docs/6B.md b/docs/6B.md new file mode 100644 index 0000000..c1400d2 --- /dev/null +++ b/docs/6B.md @@ -0,0 +1,191 @@ +# Special requirements for document-numbering +āļāļēāļĢāđƒāļŠāđ‰āļ‡āļēāļ™āļˆāļĢāļīāļ‡āļ•āđ‰āļ­āļ‡āļāļēāļĢāļ„āļ§āļēāļĄāļĒāļ·āļ”āļŦāļĒāļļāđˆāļ™āļŠāļđāļ‡ āļŠāļģāļŦāļĢāļąāļš āļĢāļ°āļšāļš document-numbering āļ”āļąāļ‡āļ™āļĩāđ‰ + +## 1. āļ•āđ‰āļ­āļ‡āđƒāļŦāđ‰ admin āļŠāļēāļĄāļēāļĢāļ–āļāļģāļŦāļ™āļ”āļĢāļđāļ›āđāļšāļšāđƒāļ™āļ–āļēāļĒāļŦāļĨāļąāļ‡āđ„āļ”āđ‰ +## 2. āļĄāļĩāļĢāļđāļ›āđāļšāļšāđ€āļĢāļīāđˆāļĄāļ•āđ‰āļ™āļ”āļąāļ‡āļ™āļĩāđ‰ +* 2.1 āļŠāļģāļŦāļĢāļąāļš correspondence āļ—āļąāđˆāļ§āđ„āļ› + * āđƒāļŠāđ‰āļĢāļđāļ›āđāļšāļš [organizations.organization_code]-[organizations.organization_code]-[sequence]-[year] + * **_āļ•āļąāļ§āļ­āļĒāđˆāļēāļ‡: āļ„āļ„āļ‡.-āļœāļĢāļĄ.2-0123-2568_** +* 2.2 āļŠāļģāļŦāļĢāļąāļš correspondence type = transmittal + * to OWNER āđƒāļŠāđ‰āļĢāļđāļ›āđāļšāļš [organizations.organization_code]-[organizations.organization_code]-[codecorrespondence_sub_types.sub_type_number]-[seq]-[year] + * **_āļ•āļąāļ§āļ­āļĒāđˆāļēāļ‡: āļ„āļ„āļ‡.-āļŠāļ„āļ‰.3-22-0123-2568_** + * to CONTRACTOR āđƒāļŠāđ‰āļĢāļđāļ›āđāļšāļš [organizations.organization_code]-[organizations.organization_code]-[codecorrespondence_sub_types.sub_type_number]-[seq]-[year] + * **_āļ•āļąāļ§āļ­āļĒāđˆāļēāļ‡: āļ„āļ„āļ‡.-āļŠāļ„āļ‰.3-22-0123-2568_** +* 2.3 āļŠāļģāļŦāļĢāļąāļš correspondence type = rfi + * āđƒāļŠāđ‰āļĢāļđāļ›āđāļšāļš [contrcts.contract_code]-[correspondences_types.type_code]-[disciplines_code]-[seq]-[revision] + * **_āļ•āļąāļ§āļ­āļĒāđˆāļēāļ‡: LCBP3-C2-RFI-TER-2345-A_** +* 2.4 āļŠāļģāļŦāļĢāļąāļš rfa āđƒāļŠāđ‰āđāļšāļšāđ€āļĨāļ‚āđāļĒāļāļāļąāļ™ + * āđƒāļŠāđ‰āļĢāļđāļ›āđāļšāļš [contrcts.contract_code]-[correspondences_types.type_code]-[disciplines_code]-[rfa_types.type_code]-[seq]-[revision] + * **_āļ•āļąāļ§āļ­āļĒāđˆāļēāļ‡: LCBP3-C1-RFA-TER-MAT-1234-A_** +āđāļĨāļ°āļ•āļĢāļ§āļˆāļŠāļ­āļš 01_lcbp3_v1_4_3.sql, 4_Data_Dictionary_V1_4_3.md +## āļ•āļēāļĢāļēāļ‡ correspondence_sub_types + +| contract_code | correspondence_types.type_code | sub_type_code | sub_type_name | sub_type_number | +| ------------- | ------------------------------ | ------------- | ------------------------------ | --------------- | +| LCBP3-C1 | RFA | MAT | Material Approval | 11 | +| LCBP3-C1 | RFA | SHP | Shop Drawing Submittal | 12 | +| LCBP3-C1 | RFA | DWG | Document Approval | 13 | +| LCBP3-C1 | RFA | MET | Engineering Document Submittal | 14 | +| LCBP3-C2 | RFA | MAT | Material Approval | 21 | +| LCBP3-C2 | RFA | SHP | Shop Drawing Submittal | 22 | +| LCBP3-C2 | RFA | DWG | Document Approval | 23 | +| LCBP3-C2 | RFA | MET | Engineering Document Submittal | 24 | +| LCBP3-C3 | RFA | MAT | Material Approval | 31 | +| LCBP3-C3 | RFA | SHP | Shop Drawing Submittal | 32 | +| LCBP3-C3 | RFA | DWG | Document Approval | 33 | +| LCBP3-C4 | RFA | MET | Engineering Document Submittal | 34 | +| LCBP3-C4 | RFA | MAT | Material Approval | 41 | +| LCBP3-C4 | RFA | SHP | Shop Drawing Submittal | 42 | +| LCBP3-C4 | RFA | DWG | Document Approval | 43 | +| LCBP3-C4 | RFA | MET | Engineering Document Submittal | 44 | + +## āļ•āļēāļĢāļēāļ‡ disciplines + +| contract_code | disciplines_code | code_name_th | code_name_en | +| ------------- | ---------------- | ----------------------------- | ------------------------------------------ | +| LCBP3-C1 | GEN | āļ‡āļēāļ™āļšāļĢāļīāļŦāļēāļĢāđ‚āļ„āļĢāļ‡āļāļēāļĢ | General Management | +| LCBP3-C1 | COD | āļŠāļąāļāļāļēāđāļĨāļ°āļ‚āđ‰āļ­āđ‚āļ•āđ‰āđāļĒāđ‰āļ‡ | Contracting | +| LCBP3-C1 | QSB | āļŠāļģāļĢāļ§āļˆāļ›āļĢāļīāļĄāļēāļ“āđāļĨāļ°āļ„āļ§āļšāļ„āļļāļĄāļ‡āļšāļ›āļĢāļ°āļĄāļēāļ“ | Quantity Survey and Budget Control | +| LCBP3-C1 | PPG | āļšāļĢāļīāļŦāļēāļĢāđāļœāļ™āđāļĨāļ°āļ„āļ§āļēāļĄāļāđ‰āļēāļ§āļŦāļ™āđ‰āļē | Plan and Progress Management | +| LCBP3-C1 | PRC | āļ‡āļēāļ™āļˆāļąāļ”āļ‹āļ·āđ‰āļ­ | Procurement | +| LCBP3-C1 | SUB | āļœāļđāđ‰āļĢāļąāļšāđ€āļŦāļĄāļēāļŠāđˆāļ§āļ‡ | Subcontractor | +| LCBP3-C1 | ODC | āļŠāļģāļ™āļąāļāļ‡āļēāļ™-āļ„āļ§āļšāļ„āļļāļĄāđ€āļ­āļāļŠāļēāļĢ | Operation Docment Control | +| LCBP3-C1 | LAW | āļāļŽāļŦāļĄāļēāļĒ | Law | +| LCBP3-C1 | TRF | āļˆāļĢāļēāļˆāļĢ | Traffic | +| LCBP3-C1 | BIM | BIM | Building information modeling | +| LCBP3-C1 | SRV | āļ‡āļēāļ™āļŠāļģāļĢāļ§āļˆ | Survey | +| LCBP3-C1 | SFT | āļ„āļ§āļēāļĄāļ›āļĨāļ­āļ”āļ āļąāļĒ | Safety | +| LCBP3-C1 | BST | āļ‡āļēāļ™āđ‚āļ„āļĢāļ‡āļŠāļĢāđ‰āļēāļ‡āļ­āļēāļ„āļēāļĢ | Building Structure Work | +| LCBP3-C1 | TEM | āļ‡āļēāļ™āļŠāļąāđˆāļ§āļ„āļĢāļēāļ§ | Temporary Work | +| LCBP3-C1 | UTL | āļ‡āļēāļ™āļĢāļ°āļšāļšāļŠāļēāļ˜āļēāļĢāļ“āļđāļ›āđ‚āļ āļ„ | Utility | +| LCBP3-C1 | EPW | āļ‡āļēāļ™āļĢāļ°āļšāļšāđ„āļŸāļŸāđ‰āļē | Electrical Power Work | +| LCBP3-C1 | ECM | āļ‡āļēāļ™āļĢāļ°āļšāļšāđ„āļŸāļŸāđ‰āļēāļŠāļ·āđˆāļ­āļŠāļēāļĢ | Electrical Communication Work | +| LCBP3-C1 | ENV | āļŠāļīāđˆāļ‡āđāļ§āļ”āļĨāđ‰āļ­āļĄ | Environment | +| LCBP3-C1 | AQV | āļ„āļļāļ“āļ āļēāļžāļ­āļēāļāļēāļĻāđāļĨāļ°āļ„āļ§āļēāļĄāļŠāļąāđˆāļ™āļŠāļ°āđ€āļ—āļ·āļ­āļ™ | Air quality and vibration | +| LCBP3-C1 | WAB | āļ„āļļāļ“āļ āļēāļžāļ™āđ‰āļģāđāļĨāļ°āļŠāļĩāļ§āļ§āļīāļ—āļĒāļēāļ—āļēāļ‡āļ™āđ‰āļģ | Water quality and Aquatic biology | +| LCBP3-C1 | ONS | āļ§āļīāļĻāļ§āļāļĢāļĢāļĄāļŠāļēāļĒāļāļąāđˆāļ‡ | Onshore Engineer Work | +| LCBP3-C1 | PPR | āļĄāļ§āļĨāļŠāļ™āļŠāļąāļĄāļžāļąāļ™āļ˜āđŒāđāļĨāļ°āļāļēāļĢāļ›āļĢāļ°āļŠāļēāļŠāļąāļĄāļžāļąāļ™āļ˜āđŒ | Public Relations | +| LCBP3-C1 | OSW | āļ‡āļēāļ™āļāđˆāļ­āļŠāļĢāđ‰āļēāļ‡āļ‡āļēāļ™āļ—āļēāļ‡āļ—āļ°āđ€āļĨ | Offshore Work | +| LCBP3-C1 | DRE | āļ‡āļēāļ™āļ‚āļļāļ”āđāļĨāļ°āļ–āļĄāļ—āļ°āđ€āļĨ | Dredging and Reclamation | +| LCBP3-C1 | REV | āļ‡āļēāļ™āļ„āļąāļ™āļŦāļīāļ™āļĨāđ‰āļ­āļĄāļžāļ·āđ‰āļ™āļ—āļĩāđˆāļ–āļĄāļ—āļ°āđ€āļĨ | Revetment | +| LCBP3-C1 | BRW | āļ‡āļēāļ™āđ€āļ‚āļ·āđˆāļ­āļ™āļāļąāļ™āļ„āļĨāļ·āđˆāļ™ | Breakwater | +| LCBP3-C1 | SOI | āļ›āļĢāļąāļšāļ›āļĢāļļāļ‡āļ„āļļāļ“āļ āļēāļžāļ”āļīāļ™ | Soil Improvement | +| LCBP3-C1 | BLC | āļ‡āļēāļ™āļ›āļĢāļąāļšāļ›āļĢāļļāļ‡āļ„āļĨāļ­āļ‡āļšāļēāļ‡āļĨāļ°āļĄāļļāļ‡ | Bang Lamung Canal Bank Protection | +| LCBP3-C1 | FUP | āļ‡āļēāļ™āļ›āļĢāļ°āļ•āļđāļĢāļ°āļšāļēāļĒāļ™āđ‰āļģāđāļĨāļ°āļ—āđˆāļ­āļĨāļ­āļ” | Floodgate & Under Ground Piping Works | +| LCBP3-C1 | SWP | āļ‡āļēāļ™āļ­āļēāļ„āļēāļĢāļ„āļ§āļšāļ„āļļāļĄāļŠāļ–āļēāļ™āļĩāļŠāļđāļšāļ™āđ‰āļģāļ—āļ°āđ€āļĨ | Sea Water Pumping Station Control BuilDing | +| LCBP3-C1 | NAV | āļ‡āļēāļ™āļ•āļīāļ”āļ•āļąāđ‰āļ‡āđ€āļ„āļĢāļ·āđˆāļ­āļ‡āļŦāļĄāļēāļĒāļŠāđˆāļ§āļ‡āļāļēāļĢāđ€āļ”āļīāļ™āđ€āļĢāļ·āļ­ | Navigations Aids | +| LCBP3-C1 | GEO | āļ‡āļēāļ™āļ”āđ‰āļēāļ™āļ˜āļĢāļ“āļĩāđ€āļ—āļ„āļ™āļīāļ„ | Geotechnical | +| LCBP3-C1 | CRW | āļ‡āļēāļ™āļ”āđ‰āļēāļ™āđ‚āļĒāļ˜āļē - Rock Works | Civil-Rock work | +| LCBP3-C1 | DVR | āļ—āļĩāļĄāļ™āļąāļāļ›āļĢāļ°āļ”āļēāļ™āđ‰āļģ | Dive Work | +| LCBP3-C1 | MTS | āļ‡āļēāļ™āļ—āļ”āļŠāļ­āļšāļ§āļąāļŠāļ”āļļāđāļĨāļ°āļ˜āļĢāļ“āļĩāđ€āļ—āļ„āļ™āļīāļ„ | Materials and Geotechnical Testing | +| LCBP3-C1 | OTH | āļ­āļ·āđˆāļ™āđ† | Other | +| LCBP3-C2 | GEN | āļ‡āļēāļ™āļšāļĢāļīāļŦāļēāļĢāđ‚āļ„āļĢāļ‡āļāļēāļĢ | Project Management | +| LCBP3-C2 | COD | āļŠāļąāļāļāļēāđāļĨāļ°āļ‚āđ‰āļ­āđ‚āļ•āđ‰āđāļĒāđ‰āļ‡ | Contracts and arguments | +| LCBP3-C2 | QSB | āļŠāļģāļĢāļ§āļˆāļ›āļĢāļīāļĄāļēāļ“āđāļĨāļ°āļ„āļ§āļšāļ„āļļāļĄāļ‡āļšāļ›āļĢāļ°āļĄāļēāļ“ | Survey the quantity and control the budget | +| LCBP3-C2 | PPM | āļšāļĢāļīāļŦāļēāļĢāđāļœāļ™āđāļĨāļ°āļ„āļ§āļēāļĄāļāđ‰āļēāļ§āļŦāļ™āđ‰āļē | Plan Management & Progress | +| LCBP3-C2 | ODC | āļŠāļģāļ™āļąāļāļ‡āļēāļ™-āļ„āļ§āļšāļ„āļļāļĄāđ€āļ­āļāļŠāļēāļĢ | Document Control Office | +| LCBP3-C2 | LAW | āļāļŽāļŦāļĄāļēāļĒ | Law | +| LCBP3-C2 | TRF | āļˆāļĢāļēāļˆāļĢ | Traffic | +| LCBP3-C2 | BIM | Building Information Modeling | Building Information Modeling | +| LCBP3-C2 | SRV | āļ‡āļēāļ™āļŠāļģāļĢāļ§āļˆ | Survey | +| LCBP3-C2 | SFT | āļ„āļ§āļēāļĄāļ›āļĨāļ­āļ”āļ āļąāļĒ | Safety | +| LCBP3-C2 | BST | āļ‡āļēāļ™āđ‚āļ„āļĢāļ‡āļŠāļĢāđ‰āļēāļ‡āļ­āļēāļ„āļēāļĢ | Building Structure | +| LCBP3-C2 | UTL | āļ‡āļēāļ™āļ°āļšāļšāļŠāļēāļ˜āļēāļĢāļ“āļđāļ›āđ‚āļ āļ„ | Public Utilities | +| LCBP3-C2 | EPW | āļ‡āļēāļ™āļĢāļ°āļšāļšāđ„āļŸāļŸāđ‰āļē | Electrical Systems | +| LCBP3-C2 | ECM | āļ‡āļēāļ™āļĢāļ°āļšāļšāđ„āļŸāļŸāđ‰āļēāļŠāļ·āđˆāļ­āļŠāļēāļĢ | Electrical Communication System | +| LCBP3-C2 | ENV | āļŠāļīāđˆāļ‡āđāļ§āļ”āļĨāđ‰āļ­āļĄ | Environment | +| LCBP3-C2 | AQV | āļ„āļļāļ“āļ āļēāļžāļ­āļēāļāļēāļĻāđāļĨāļ°āļ„āļ§āļēāļĄāļŠāļąāđˆāļ™āļŠāļ°āđ€āļ—āļ·āļ­āļ™ | Air Quality and Vibration | +| LCBP3-C2 | WAB | āļ„āļļāļ“āļ āļēāļžāļ™āđ‰āļģāđāļĨāļ°āļŠāļĩāļ§āļ§āļīāļ—āļĒāļēāļ—āļēāļ‡āļ™āđ‰āļģ | Water Quality and Aquatic Biology | +| LCBP3-C2 | ONS | āļ§āļīāļĻāļ§āļāļĢāļĢāļĄāļŠāļēāļĒāļāļąāđˆāļ‡ | Coastal Engineering | +| LCBP3-C2 | PPR | āļĄāļ§āļĨāļŠāļ™āļŠāļąāļĄāļžāļąāļ™āļ˜āđŒāđāļĨāļ°āļ›āļĢāļ°āļŠāļēāļŠāļąāļĄāļžāļąāļ™āļ˜āđŒ | Mass Relations and Public Relations | +| LCBP3-C2 | OFW | āļ‡āļēāļ™āļāđˆāļ­āļŠāļĢāđ‰āļēāļ‡āļ—āļēāļ‡āļ—āļ°āđ€āļĨ | Marine Construction | +| LCBP3-C2 | EXR | āļ‡āļēāļ™āļ‚āļļāļ”āđāļĨāļ°āļ–āļĄāļ—āļ°āđ€āļĨ | Excavation and reclamation | +| LCBP3-C2 | GEO | āļ‡āļēāļ™āļ”āđ‰āļēāļ™āļ˜āļĢāļ“āļĩāđ€āļ—āļ„āļ™āļīāļ„ | Geotechnical work | +| LCBP3-C2 | CRW | āļ‡āļēāļ™āļ”āđ‰āļēāļ™āđ‚āļĒāļ˜āļē - Rock Works | Civil Works - Rock Works | +| LCBP3-C2 | DVW | āļ—āļĩāļĄāļ™āļąāļāļ›āļĢāļ°āļ”āļēāļ™āđ‰āļģ | Team of Divers | +| LCBP3-C2 | MTT | āļ‡āļēāļ™āļ—āļ”āļŠāļ­āļšāļ§āļąāļŠāļ”āļļ | Materials Testing | +| LCBP3-C2 | ARC | āļ‡āļēāļ™āļŠāļ–āļēāļ›āļąāļ•āļĒāļāļĢāļĢāļĄ | Architecture | +| LCBP3-C2 | STR | āļ‡āļēāļ™āđ‚āļ„āļĢāļ‡āļŠāļĢāđ‰āļēāļ‡ | Structural work | +| LCBP3-C2 | SAN | āļ‡āļēāļ™āļĢāļ°āļšāļšāļŠāļļāļ‚āļēāļ āļīāļšāļēāļĨ | Sanitation System | +| LCBP3-C2 | DRA | āļ‡āļēāļ™āļĢāļ°āļšāļšāļĢāļ°āļšāļēāļĒāļ™āđ‰āļģ | Drainage system work | +| LCBP3-C2 | TER | āļ‡āļēāļ™āļ—āđˆāļēāđ€āļ—āļĩāļĒāļšāđ€āļĢāļ·āļ­ | Terminal Work work | +| LCBP3-C2 | BUD | āļ‡āļēāļ™āļ­āļēāļ„āļēāļĢ | Building | +| LCBP3-C2 | ROW | āļ‡āļēāļ™āļ–āļ™āļ™āđāļĨāļ°āļŠāļ°āļžāļēāļ™ | Road and Bridge Work | +| LCBP3-C2 | MEC | āļ‡āļēāļ™āđ€āļ„āļĢāļīāļ­āļ‡āļāļĨ | Mechanical work | +| LCBP3-C2 | OTH | āļ­āļ·āđˆāļ™ āđ† | Others | + +## 📌āļ•āļēāļĢāļēāļ‡ rfa_types + +| contract_code | type_code | type_name_en | type_name_th | +| ------------- | --------- | ---------------------------------------------- | ------------------------------------------------ | +| LCBP3-C1 | ADW | As Built Drawing | āđāļšāļšāļĢāđˆāļēāļ‡āļŦāļĨāļąāļ‡āļāļēāļĢāļāđˆāļ­āļŠāļĢāđ‰āļēāļ‡ | +| LCBP3-C1 | BC | Box Culvert | āļ—āđˆāļ­āļĢāļ°āļšāļēāļĒāļ™āđ‰āļģāļĢāļđāļ›āļāļĨāđˆāļ­āļ‡ | +| LCBP3-C1 | BM | Benchmark | āļŦāļĄāļļāļ”āļŦāļĨāļąāļāļāļēāļ™ | +| LCBP3-C1 | CER | Certificates | āđƒāļšāļĢāļąāļšāļĢāļ­āļ‡ | +| LCBP3-C1 | CN | Canal Drainage | āļĢāļ°āļšāļšāļĢāļ°āļšāļēāļĒāļ™āđ‰āļģāđƒāļ™āļ„āļĨāļ­āļ‡ | +| LCBP3-C1 | CON | Contract | āļŠāļąāļāļāļē | +| LCBP3-C1 | DDS | Design Data Submission | āļ™āļģāļŠāđˆāļ‡āļ‚āđ‰āļ­āļĄāļđāļĨāļāļēāļĢāļ­āļ­āļāđāļšāļš | +| LCBP3-C1 | DDW | Draft Drawing | āđāļšāļšāļĢāđˆāļēāļ‡ | +| LCBP3-C1 | DRW | Drawings (All Types) | āđāļšāļšāļāđˆāļ­āļŠāļĢāđ‰āļēāļ‡ | +| LCBP3-C1 | DSN | Design/Calculation/Manual (All Stages) | āļ­āļ­āļāđāļšāļš / āļ„āļģāļ™āļ§āļ“ / āļ„āļđāđˆāļĄāļ·āļ­ | +| LCBP3-C1 | GEN | General | āļ—āļąāđˆāļ§āđ„āļ› | +| LCBP3-C1 | ICR | Incident Report | āļĢāļēāļĒāļ‡āļēāļ™āļāļēāļĢāđ€āļāļīāļ”āļ­āļļāļšāļąāļ•āļīāđ€āļŦāļ•āļļāđāļĨāļ°āļāļēāļĢāļšāļēāļ”āđ€āļˆāđ‡āļš | +| LCBP3-C1 | INS | Insurances/Bond/Guarantee | āļāļēāļĢāļ›āļĢāļ°āļāļąāļ™ / āļžāļąāļ™āļ˜āļšāļąāļ•āļĢ / āļāļēāļĢāļ„āđ‰āļģāļ›āļĢāļ°āļāļąāļ™ | +| LCBP3-C1 | INR | Inspection/Audit/Surveillance Report | āļĢāļēāļĒāļ‡āļēāļ™āļāļēāļĢāļ•āļĢāļ§āļˆāļŠāļ­āļš / āļāļēāļĢāļ•āļĢāļ§āļˆāļŠāļ­āļš / āļĢāļēāļĒāļ‡āļēāļ™āļāļēāļĢāđ€āļāđ‰āļēāļĢāļ°āļ§āļąāļ‡ | +| LCBP3-C1 | ITP | Inspection and Test Plan | āđāļœāļ™āļāļēāļĢāļ•āļĢāļ§āļˆāļŠāļ­āļšāđāļĨāļ°āļ—āļ”āļŠāļ­āļš | +| LCBP3-C1 | JSA | Jobs Analysis | āļĢāļēāļĒāļ‡āļēāļ™āļāļēāļĢāļ§āļīāđ€āļ„āļĢāļēāļ°āļŦāđŒāļ„āļ§āļēāļĄāļ›āļĨāļ­āļ”āļ āļąāļĒ | +| LCBP3-C1 | MAN | Manual | āļ„āļđāđˆāļĄāļ·āļ­ | +| LCBP3-C1 | MAT | Materials/Equipment/Plant | āļ§āļąāļŠāļ”āļļ / āļ­āļļāļ›āļāļĢāļ“āđŒ / āđ‚āļĢāļ‡āļ‡āļēāļ™ | +| LCBP3-C1 | MOM | Minutes of Meeting | āļĢāļēāļĒāļ‡āļēāļ™āļāļēāļĢāļ›āļĢāļ°āļŠāļļāļĄ | +| LCBP3-C1 | MPR | Monthly Progress Report | āļĢāļēāļĒāļ‡āļēāļ™āļ„āļ§āļēāļĄāļ„āļ·āļšāļŦāļ™āđ‰āļēāļ›āļĢāļ°āļˆāļģāđ€āļ”āļ·āļ­āļ™ | +| LCBP3-C1 | MST | Method Statement for Construction/Installation | āļ‚āļąāđ‰āļ™āļ•āļ­āļ™āļāļēāļĢāļāđˆāļ­āļŠāļĢāđ‰āļēāļ‡ / āļ•āļīāļ”āļ•āļąāđ‰āļ‡ | +| LCBP3-C1 | NDS | Non-Design Data Submission | āļ™āļģāļŠāđˆāļ‡āļ‚āđ‰āļ­āļĄāļđāļĨāļ—āļĩāđˆāđ„āļĄāđˆāđ€āļāļĩāđˆāļĒāļ§āļ‚āđ‰āļ­āļ‡āļāļąāļšāļāļēāļĢāļ­āļ­āļāđāļšāļš | +| LCBP3-C1 | PMA | Payment/Invoice/Retention/Estimate | āļāļēāļĢāļŠāļģāļĢāļ°āđ€āļ‡āļīāļ™ / āđƒāļšāđāļˆāđ‰āļ‡āļŦāļ™āļĩāđ‰ / āļ›āļĢāļ°āļāļąāļ™āļœāļĨāļ‡āļēāļ™ / āļ›āļĢāļ°āļĄāļēāļ“āļāļēāļĢ | +| LCBP3-C1 | PRD | Procedure | āļĢāļ°āđ€āļšāļĩāļĒāļšāļ›āļāļīāļšāļąāļ•āļī | +| LCBP3-C1 | PRG | Progress of Construction | āļ„āļ§āļēāļĄāļ„āļ·āļšāļŦāļ™āđ‰āļēāļ‚āļ­āļ‡āļāļēāļĢāļāđˆāļ­āļŠāļĢāđ‰āļēāļ‡ / āļ āļēāļžāļ–āđˆāļēāļĒ / āļ§āļīāļ”āļĩāđ‚āļ­ | +| LCBP3-C1 | QMS | Quality Document (Plan/Work Instruction) | āđ€āļ­āļāļŠāļēāļĢāļ”āđ‰āļēāļ™āļ„āļļāļ“āļ āļēāļž (āđāļœāļ™āļ‡āļēāļ™ / āļ‚āđ‰āļ­āđāļ™āļ°āļ™āļģāđƒāļ™āļāļēāļĢāļ—āļģāļ‡āļēāļ™) | +| LCBP3-C1 | RPT | Report | āļĢāļēāļĒāļ‡āļēāļ™ | +| LCBP3-C1 | SAR | Semi Annual Report | āļĢāļēāļĒāļ‡āļēāļ™āļ›āļĢāļ°āļˆāļģāļŦāļāđ€āļ”āļ·āļ­āļ™ | +| LCBP3-C1 | SCH | Schedule and Program | āđāļœāļ™āļ‡āļēāļ™ | +| LCBP3-C1 | SDW | Shop Drawing | āđāļšāļšāļ‚āļĒāļēāļĒāļĢāļēāļĒāļĨāļ°āđ€āļ­āļĩāļĒāļ” | +| LCBP3-C1 | SI | Soil Investigation | āļāļēāļĢāļ•āļĢāļ§āļˆāļŠāļ­āļšāļ”āļīāļ™ | +| LCBP3-C1 | SPE | Specification | āļ‚āđ‰āļ­āļāļģāļŦāļ™āļ” | +| LCBP3-C1 | TNR | Training Report | āļĢāļēāļĒāļ‡āļēāļ™āļāļēāļĢāļāļķāļāļ›āļāļīāļšāļąāļ•āļī | +| LCBP3-C1 | UC | Underground Construction | āđ‚āļ„āļĢāļ‡āļŠāļĢāđ‰āļēāļ‡āđƒāļ•āđ‰āļ”āļīāļ™ | +| LCBP3-C1 | VEN | Vendor | āļœāļđāđ‰āļ‚āļēāļĒ | +| LCBP3-C1 | VRO | Variation Request/Instruction/Order | āļ„āļģāļ‚āļ­āđ€āļ›āļĨāļĩāđˆāļĒāļ™āđāļ›āļĨāļ‡ / āļ‚āđ‰āļ­āđ€āļŠāļ™āļ­āđāļ™āļ° / āļ‚āđ‰āļ­āđ€āļĢāļĩāļĒāļāļĢāđ‰āļ­āļ‡ | +| LCBP3-C1 | WTY | Warranty | āļāļēāļĢāļ›āļĢāļ°āļāļąāļ™ | +| LCBP3-C2 | GEN | General | āļ—āļąāđˆāļ§āđ„āļ› | +| LCBP3-C2 | CON | Contract | āļŠāļąāļāļāļē | +| LCBP3-C2 | INS | Insurances/Bond/Guarantee | āļāļēāļĢāļ›āļĢāļ°āļāļąāļ™ / āļžāļąāļ™āļ˜āļšāļąāļ•āļĢ / āļāļēāļĢāļ„āđ‰āļģāļ›āļĢāļ°āļāļąāļ™ | +| LCBP3-C2 | SCH | Schedule and Program | āđāļœāļ™āļ‡āļēāļ™ | +| LCBP3-C2 | PMA | Payment/Invoice/Retention/Estimate | āļāļēāļĢāļŠāļģāļĢāļ°āđ€āļ‡āļīāļ™ / āđƒāļšāđāļˆāđ‰āļ‡āļŦāļ™āļĩāđ‰ / āļ›āļĢāļ°āļāļąāļ™āļœāļĨāļ‡āļēāļ™ / āļ›āļĢāļ°āļĄāļēāļ“āļāļēāļĢ | +| LCBP3-C2 | VRO | Variation Request/Instruction/Order | āļ„āļģāļ‚āļ­āđ€āļ›āļĨāļĩāđˆāļĒāļ™āđāļ›āļĨāļ‡ / āļ‚āđ‰āļ­āđ€āļŠāļ™āļ­āđāļ™āļ° / āļ‚āđ‰āļ­āđ€āļĢāļĩāļĒāļāļĢāđ‰āļ­āļ‡ | +| LCBP3-C2 | VEN | Vendor | āļœāļđāđ‰āļ‚āļēāļĒ | +| LCBP3-C2 | WTY | Warranty | āļāļēāļĢāļ›āļĢāļ°āļāļąāļ™ | +| LCBP3-C2 | DRW | Drawings (All Types) | āđāļšāļšāļāđˆāļ­āļŠāļĢāđ‰āļēāļ‡ | +| LCBP3-C2 | DDW | Draft Drawing | āđāļšāļšāļĢāđˆāļēāļ‡ | +| LCBP3-C2 | SDW | Shop Drawing | āđāļšāļšāļ‚āļĒāļēāļĒāļĢāļēāļĒāļĨāļ°āđ€āļ­āļĩāļĒāļ” | +| LCBP3-C2 | ADW | As Built Drawing | āđāļšāļšāļĢāđˆāļēāļ‡āļŦāļĨāļąāļ‡āļāļēāļĢāļāđˆāļ­āļŠāļĢāđ‰āļēāļ‡ | +| LCBP3-C2 | DDS | Design Data Submission | āļ™āļģāļŠāđˆāļ‡āļ‚āđ‰āļ­āļĄāļđāļĨāļāļēāļĢāļ­āļ­āļāđāļšāļš | +| LCBP3-C2 | DSN | Design/Calculation/Manual (All Stages) | āļ­āļ­āļāđāļšāļš / āļ„āļģāļ™āļ§āļ“ / āļ„āļđāđˆāļĄāļ·āļ­ | +| LCBP3-C2 | NDS | Non-Design Data Submission | āļ™āļģāļŠāđˆāļ‡āļ‚āđ‰āļ­āļĄāļđāļĨāļ—āļĩāđˆāđ„āļĄāđˆāđ€āļāļĩāđˆāļĒāļ§āļ‚āđ‰āļ­āļ‡āļāļąāļšāļāļēāļĢāļ­āļ­āļāđāļšāļš | +| LCBP3-C2 | PRD | Procedure | āļĢāļ°āđ€āļšāļĩāļĒāļšāļ›āļāļīāļšāļąāļ•āļī | +| LCBP3-C2 | MST | Method Statement for Construction/Installation | āļ‚āļąāđ‰āļ™āļ•āļ­āļ™āļāļēāļĢāļāđˆāļ­āļŠāļĢāđ‰āļēāļ‡ / āļ•āļīāļ”āļ•āļąāđ‰āļ‡ | +| LCBP3-C2 | QMS | Quality Document (Plan/Work Instruction) | āđ€āļ­āļāļŠāļēāļĢāļ”āđ‰āļēāļ™āļ„āļļāļ“āļ āļēāļž (āđāļœāļ™āļ‡āļēāļ™ / āļ‚āđ‰āļ­āđāļ™āļ°āļ™āļģāđƒāļ™āļāļēāļĢāļ—āļģāļ‡āļēāļ™) | +| LCBP3-C2 | INR | Inspection/Audit/Surveillance Report | āļĢāļēāļĒāļ‡āļēāļ™āļāļēāļĢāļ•āļĢāļ§āļˆāļŠāļ­āļš / āļāļēāļĢāļ•āļĢāļ§āļˆāļŠāļ­āļš / āļĢāļēāļĒāļ‡āļēāļ™āļāļēāļĢāđ€āļāđ‰āļēāļĢāļ°āļ§āļąāļ‡ | +| LCBP3-C2 | ITP | Inspection and Test Plan | āđāļœāļ™āļāļēāļĢāļ•āļĢāļ§āļˆāļŠāļ­āļšāđāļĨāļ°āļ—āļ”āļŠāļ­āļš | +| LCBP3-C2 | MAT | Materials/Equipment/Plant | āļ§āļąāļŠāļ”āļļ / āļ­āļļāļ›āļāļĢāļ“āđŒ / āđ‚āļĢāļ‡āļ‡āļēāļ™ | +| LCBP3-C2 | SPE | Specification | āļ‚āđ‰āļ­āļāļģāļŦāļ™āļ” | +| LCBP3-C2 | MAN | Manual | āļ„āļđāđˆāļĄāļ·āļ­ | +| LCBP3-C2 | CER | Certificates | āđƒāļšāļĢāļąāļšāļĢāļ­āļ‡ | +| LCBP3-C2 | SAR | Semi Annual Report | āļĢāļēāļĒāļ‡āļēāļ™āļ›āļĢāļ°āļˆāļģāļŦāļāđ€āļ”āļ·āļ­āļ™ | +| LCBP3-C2 | JSA | Jobs Analysis | āļĢāļēāļĒāļ‡āļēāļ™āļāļēāļĢāļ§āļīāđ€āļ„āļĢāļēāļ°āļŦāđŒāļ„āļ§āļēāļĄāļ›āļĨāļ­āļ”āļ āļąāļĒ | +| LCBP3-C2 | MOM | Minutes of Meeting | āļĢāļēāļĒāļ‡āļēāļ™āļāļēāļĢāļ›āļĢāļ°āļŠāļļāļĄ | +| LCBP3-C2 | MPR | Monthly Progress Report | āļĢāļēāļĒāļ‡āļēāļ™āļ„āļ§āļēāļĄāļ„āļ·āļšāļŦāļ™āđ‰āļēāļ›āļĢāļ°āļˆāļģāđ€āļ”āļ·āļ­āļ™ | +| LCBP3-C2 | ICR | Incident Report | āļĢāļēāļĒāļ‡āļēāļ™āļāļēāļĢāđ€āļāļīāļ”āļ­āļļāļšāļąāļ•āļīāđ€āļŦāļ•āļļāđāļĨāļ°āļāļēāļĢāļšāļēāļ”āđ€āļˆāđ‡āļš | +| LCBP3-C2 | PRG | Progress of Construction | āļ„āļ§āļēāļĄāļ„āļ·āļšāļŦāļ™āđ‰āļēāļ‚āļ­āļ‡āļāļēāļĢāļāđˆāļ­āļŠāļĢāđ‰āļēāļ‡ / āļ āļēāļžāļ–āđˆāļēāļĒ / āļ§āļīāļ”āļĩāđ‚āļ­ | +| LCBP3-C2 | RPT | Report | āļĢāļēāļĒāļ‡āļēāļ™ | +| LCBP3-C2 | TNR | Training Report | āļĢāļēāļĒāļ‡āļēāļ™āļāļēāļĢāļāļķāļāļ›āļāļīāļšāļąāļ•āļī | + +--- diff --git a/0_Requirements_V1_4_3.md b/docs/Markdown/0_Requirements_V1_4_3.md similarity index 100% rename from 0_Requirements_V1_4_3.md rename to docs/Markdown/0_Requirements_V1_4_3.md diff --git a/1_FullStackJS_V1_4_3.md b/docs/Markdown/1_FullStackJS_V1_4_3.md similarity index 100% rename from 1_FullStackJS_V1_4_3.md rename to docs/Markdown/1_FullStackJS_V1_4_3.md diff --git a/docs/Markdown/2_Backend_Plan_Phase6A_V1_4_3.md b/docs/Markdown/2_Backend_Plan_Phase6A_V1_4_3.md new file mode 100644 index 0000000..6e75a61 --- /dev/null +++ b/docs/Markdown/2_Backend_Plan_Phase6A_V1_4_3.md @@ -0,0 +1,397 @@ +# “Phase 6A + Technical Design Document : Workflow DSL (Mini-Language)”** +āļ­āļ­āļāđāļšāļšāļŠāļģāļŦāļĢāļąāļšāļĢāļ°āļšāļš Workflow Engine āļāļĨāļēāļ‡āļ‚āļ­āļ‡āđ‚āļ„āļĢāļ‡āļāļēāļĢ +**āđ„āļĄāđˆāļĄāļĩāđ‚āļ„āđ‰āļ”āļœāļđāļāļāļąāļš Framework** āđ€āļžāļ·āđˆāļ­āđƒāļŦāđ‰āļŠāļēāļĄāļēāļĢāļ–āļ™āļģāđ„āļ› Implement āđƒāļ™ NestJS āļŦāļĢāļ·āļ­ Microservice āđƒāļ” āđ† āđ„āļ”āđ‰ + +--- + +## 📌 **Phase 6A – Workflow DSL Implementation Plan** + +### ðŸŽŊ āđ€āļ›āđ‰āļēāļŦāļĄāļēāļĒāļ‚āļ­āļ‡ Phase 6A + +āđƒāļ™ Phase āļ™āļĩāđ‰ āļˆāļ°āđ€āļĢāļīāđˆāļĄāļŠāļĢāđ‰āļēāļ‡ â€œWorkflow DSL (Domain-Specific Language)” āļŠāļģāļŦāļĢāļąāļšāļ™āļīāļĒāļēāļĄāļāļŽāļāļēāļĢāđ€āļ”āļīāļ™āļ‡āļēāļ™ (Workflow Transition Rules) āđƒāļŦāđ‰āļŠāļēāļĄāļēāļĢāļ–: + +* āđāļĒāļ **Business Workflow Logic** āļ­āļ­āļāļˆāļēāļ Source Code +* āđāļāđ‰āđ„āļ‚āļāļŽ Workflow āđ„āļ”āđ‰āđ‚āļ”āļĒ **āđ„āļĄāđˆāļ•āđ‰āļ­āļ‡āđāļāđ‰āđ‚āļ„āđ‰āļ”āđāļĨāļ°āđ„āļĄāđˆāļ•āđ‰āļ­āļ‡ Deploy āđƒāļŦāļĄāđˆ** +* āļĢāļ­āļ‡āļĢāļąāļš Document āļŦāļĨāļēāļĒāļ›āļĢāļ°āđ€āļ āļ— āđ€āļŠāđˆāļ™ + + * Correspondence + * RFA + * Internal Circulation + * Document Transmittal +* āļĢāļ­āļ‡āļĢāļąāļš Multi-step routing, skip, reject, rollback, parallel assignments +* āļŠāļēāļĄāļēāļĢāļ–āļ™āļģāđ„āļ›āđƒāļŠāđ‰āļ‡āļēāļ™āļ—āļąāđ‰āļ‡āđƒāļ™ + + * Backend (NestJS) + * Frontend (UI Driven) + * External Microservices + +--- + +### 📅 āļĢāļ°āļĒāļ°āđ€āļ§āļĨāļē + +**1 āļŠāļąāļ›āļ”āļēāļŦāđŒ (āļŦāļĨāļąāļ‡ Phase 6.5)** + +--- + +### ðŸ§Đ Output āļ‚āļ­āļ‡ Phase 6A + +* DSL Specification (Grammar) +* JSON Schema for Workflow Definition +* Workflow Rule Interpreter (Parser + Executor) +* Validation Engine (Compile-time and Runtime) +* Storage (DB Table / Registry) +* Execution API: + +| Action | Description | +| -------------------------------- | ------------------------------- | +| compile() | āļ•āļĢāļ§āļˆ DSL → āļŠāļĢāđ‰āļēāļ‡ Execution Tree | +| evaluate(state, action, context) | āļ›āļĢāļ°āļĄāļ§āļĨāļœāļĨāđāļĨāļ°āļŠāđˆāļ‡āļŠāļ–āļēāļ™āļ°āđƒāļŦāļĄāđˆ | +| preview(state) | āļ„āļģāļ™āļ§āļ“ Next Possible Transitions | +| validate() | āļ•āļĢāļ§āļˆāļ§āđˆāļē DSL āļ–āļđāļāļ•āđ‰āļ­āļ‡ | + +--- + +## 📘 **Technical Specification – Workflow DSL** + +--- + +### 1ïļâƒĢ Requirements + +#### Functional Requirements + +* āļ™āļīāļĒāļēāļĄ Workflow āđ€āļ›āđ‡āļ™āļ āļēāļĐāļēāļ„āļĨāđ‰āļēāļĒ State Machine +* āđāļ•āđˆāļĨāļ°āđ€āļ­āļāļŠāļēāļĢāļĄāļĩ **State, Actions, Entry/Exit Events** +* āļŠāļēāļĄāļēāļĢāļ–āļĄāļĩ: + + * Required approvals + * Conditional transition + * Auto-transition + * Parallel approval + * Return/rollback + +#### +* Running time: < 20ms āļ•āđˆāļ­āļ„āļģāļŠāļąāđˆāļ‡ +* Hot reload āđ„āļĄāđˆāļ•āđ‰āļ­āļ‡ Compile āđƒāļŦāļĄāđˆāļ—āļąāđ‰āļ‡ Backend +* DSL āļ•āđ‰āļ­āļ‡ Debug āđ„āļ”āđ‰āļ‡āđˆāļēāļĒ +* āļ•āđ‰āļ­āļ‡ Versioned +* āļ•āđ‰āļ­āļ‡āļĢāļ­āļ‡āļĢāļąāļš Audit 100% + +--- + +### 2ïļâƒĢ DSL Format (Human Friendly) + +```yaml +workflow: RFA +version: 1.0 + +states: + - name: DRAFT + initial: true + on: + SUBMIT: + to: IN_REVIEW + require: + - role: ENGINEER + events: + - notify: reviewer + + - name: IN_REVIEW + on: + APPROVE: + to: APPROVED + REJECT: + to: DRAFT + events: + - notify: creator + + - name: APPROVED + terminal: true +``` + +--- + +### 3ïļâƒĢ Compiled Execution Model (Normalized JSON) + +```json +{ + "workflow": "RFA", + "version": "1.0", + "states": { + "DRAFT": { + "initial": true, + "transitions": { + "SUBMIT": { + "to": "IN_REVIEW", + "requirements": [ + { "role": "ENGINEER" } + ], + "events": [ + { "type": "notify", "target": "reviewer" } + ] + } + } + }, + "IN_REVIEW": { + "transitions": { + "APPROVE": { "to": "APPROVED" }, + "REJECT": { + "to": "DRAFT", + "events": [ + { "type": "notify", "target": "creator" } + ] + } + } + }, + "APPROVED": { + "terminal": true + } + } +} +``` + +Frontend āđāļĨāļ° Backend āļŠāļēāļĄāļēāļĢāļ–āđāļŠāļĢāđŒ JSON āļ™āļĩāđ‰āļĢāđˆāļ§āļĄāļāļąāļ™āđ„āļ”āđ‰ + +--- + +### 4ïļâƒĢ DSL Grammar Definition (EBNF) + +```ebnf +workflow = "workflow" ":" identifier ; +version = "version" ":" number ; + +states = "states:" state_list ; +state_list = { state } ; + +state = "- name:" identifier + [ "initial:" boolean ] + [ "terminal:" boolean ] + [ "on:" transition_list ] ; + +transition_list = { transition } ; + +transition = action ":" + indent "to:" identifier + [ indent "require:" requirements ] + [ indent "events:" event_list ] ; + +requirements = "- role:" identifier | "- user:" identifier ; + +event_list = { event } ; +event = "- notify:" identifier ; +``` + +--- + +### 5ïļâƒĢ Validation Rules (Compile-Time) + +#### 5.1 State Rules + +* āļ•āđ‰āļ­āļ‡āļĄāļĩāļ­āļĒāđˆāļēāļ‡āļ™āđ‰āļ­āļĒ 1 state āļ—āļĩāđˆ `initial: true` +* āļŦāļēāļ `terminal: true` → āļ•āđ‰āļ­āļ‡āđ„āļĄāđˆāļĄāļĩ transition āļ•āđˆāļ­āđ„āļ› + +#### 5.2 Transition Rules + +āļ•āļĢāļ§āļˆāļŠāļ­āļšāļ§āđˆāļē: + +* `to` āļŠāļĩāđ‰āđ„āļ›āļĒāļąāļ‡ state āļ—āļĩāđˆāļĄāļĩāļ­āļĒāļđāđˆ +* `require.role` āļ•āđ‰āļ­āļ‡āđ€āļ›āđ‡āļ™ role āļ—āļĩāđˆāļĢāļ°āļšāļšāļĢāļđāđ‰āļˆāļąāļ +* Action name āļ•āđ‰āļ­āļ‡āđ€āļ›āđ‡āļ™ **UPPER_CASE** + +#### 5.3 Version Safety + +* āļ—āļļāļāļŠāļļāļ” Workflow DSL āļ•āđ‰āļ­āļ‡āļ‚āļķāđ‰āļ™āļāļąāļš version +* āđāļāđ‰āđ„āļ‚āļ•āđ‰āļ­āļ‡āļŠāļĢāđ‰āļēāļ‡ version āđƒāļŦāļĄāđˆ +* āđ„āļĄāđˆ overwrite version āđ€āļāđˆāļē +* “Document āļ—āļĩāđˆāļāļģāļĨāļąāļ‡āļ­āļĒāļđāđˆāđƒāļ™ step āđ€āļ”āļīāļĄāļĒāļąāļ‡āļ•āđ‰āļ­āļ‡āđƒāļŠāđ‰āļāļŽāđ€āļ”āļīāļĄāđ„āļ”āđ‰â€ + +--- + +### 6ïļâƒĢ Runtime Validation Rules + +āđ€āļĄāļ·āđˆāļ­ execute(action): + +``` +input: current_state, action, context + +1) āļ•āļĢāļ§āļˆāļ§āđˆāļē state āļĄāļĩ transition "action" +2) āļ•āļĢāļ§āļˆāļ§āđˆāļēāļœāļđāđ‰āđƒāļŠāđ‰āļĄāļĩāļŠāļīāļ—āļ˜āļīāđŒāļ•āļēāļĄ require[] +3) Compute next state +4) Execute events[] +5) Return next_state +``` + +--- + +### 7ïļâƒĢ Context Model + +```ts +interface WorkflowContext { + userId: string; + roles: string[]; + documentId: string; + now: Date; + payload?: any; +} +``` + +--- + +### 8ïļâƒĢ Execution API (Abstract) + +```ts +class WorkflowEngine { + + load(dsl: string | object): CompiledWorkflow + + compile(dsl: string | object): CompiledWorkflow + + evaluate(state: string, action: string, context: WorkflowContext): EvalResult + + getAvailableActions(state: string, context: WorkflowContext): string[] +} +``` + +--- + +### 9ïļâƒĢ Interpreter Execution Flow + +```mermaid +flowchart TD + A[Receive Action] --> B[Load Compiled Workflow] + B --> C[Check allowed actions] + C -->|Invalid| E[Return Error] + C --> D[Evaluate Requirements] + D --> F[Transition to Next State] + F --> G[Run Events] + G --> H[Return Success] +``` + +--- + +### 🔟 Events System + +āļĢāļ­āļ‡āļĢāļąāļš event āļŦāļĨāļēāļĒāļ›āļĢāļ°āđ€āļ āļ—: + +| event.type | āļ•āļąāļ§āļ­āļĒāđˆāļēāļ‡ | +| ----------- | ------------------------- | +| notify | āļŠāđˆāļ‡ Email/Line | +| assign | āđ€āļ›āļĨāļĩāđˆāļĒāļ™āļœāļđāđ‰āļĢāļąāļšāļœāļīāļ”āļŠāļ­āļš | +| webhook | āļĒāļīāļ‡ Webhook āđ„āļ›āļĒāļąāļ‡āļĢāļ°āļšāļšāļ­āļ·āđˆāļ™ | +| auto_action | āļ—āļģ action āļ‹āđ‰āļģāđ‚āļ”āļĒāļ­āļąāļ•āđ‚āļ™āļĄāļąāļ•āļī | + +--- + +### 11ïļâƒĢ Database Schema + +#### Table: `workflow_definition` + +| Field | Type | Description | +| ------------- | ----------- | --------------------- | +| id | UUID | PK | +| workflow_code | varchar(50) | āđ€āļŠāđˆāļ™ `RFA`, `CORR` | +| version | int | Version number | +| dsl | JSON | YAML/JSON DSL āđ€āļāđ‡āļšāļ”āļīāļš | +| compiled | JSON | JSON āļ—āļĩāđˆ Compile āđāļĨāđ‰āļ§ | +| created_at | timestamp | | +| is_active | boolean | āđƒāļŠāđ‰āļ­āļĒāļđāđˆāļŦāļĢāļ·āļ­āđ„āļĄāđˆ | + +#### Table: `workflow_history` + +āđ€āļāđ‡āļš audit āđāļšāļš immutable append-only + +| Field | Description | +| ----------- | --------------- | +| workflow | Document Type | +| document_id | āđ€āļ­āļāļŠāļēāļĢāđ„āļŦāļ™ | +| from_state | āđ€āļ”āļīāļĄ | +| to_state | āđƒāļŦāļĄāđˆ | +| action | āļ„āļģāļŠāļąāđˆāļ‡ | +| user | āđƒāļ„āļĢāđ€āļ›āđ‡āļ™āļ„āļ™āļ—āļģ | +| timestamp | āđ€āļ§āļĨāļē | +| metadata | āđ€āļŦāļ•āļļāļāļēāļĢāļ“āđŒāļ­āļ·āđˆāļ™ āđ† | + +--- + +### 12ïļâƒĢ Error Codes + +| Code | Meaning | +| ----------------------- | ---------------------- | +| WF_NO_TRANSITION | Action āļ™āļĩāđ‰āđ„āļĄāđˆāļ–āļđāļāļ•āđ‰āļ­āļ‡ | +| WF_RESTRICTED | User āđ„āļĄāđˆāļĄāļĩāļŠāļīāļ—āļ˜āļīāđŒ | +| WF_MISSING_REQUIREMENTS | āđ„āļĄāđˆāļœāđˆāļēāļ™āđ€āļ‡āļ·āđˆāļ­āļ™āđ„āļ‚ | +| WF_STATE_NOT_FOUND | āđ„āļĄāđˆāļĄāļĩ state āļ—āļĩāđˆāļ­āđ‰āļēāļ‡āļ­āļīāļ‡ | +| WF_SYNTAX_ERROR | DSL āļœāļīāļ”āļĢāļđāļ›āđāļšāļš | + +--- + +### 13ïļâƒĢ Testing Strategy + +#### Unit Tests + +* Parse DSL → JSON +* Invalid syntax → throw error +* Invalid transitions → throw error + +#### Integration Tests + +* Evaluate() āļœāđˆāļēāļ™ 20+ cases +* RFA āļĒāđ‰āļ­āļ™āļāļĨāļąāļš +* Approve chain +* Parallel review + +#### Load Tests + +* 1,000 documents running workflow +* Evaluate < 20ms āļ•āđˆāļ­ action + +--- + +### 14ïļâƒĢ Deployment Strategy + +#### Hot Reload Options + +* DSL stored in DB +* Cache in Redis +* Touched timestamp triggers: + +``` +invalidate cache → recompile +``` + +#### No downtime required + +--- + +### 15ïļâƒĢ Microservice-Ready + +DSL Engine āđāļĒāļāđ€āļ›āđ‡āļ™: + +* `workflow-engine-core` → Pure JS library +* `workflow-service` → NestJS module +* API public: + +``` +POST /workflow/evaluate +GET /workflow/preview +POST /workflow/compile +``` + +āļ āļēāļĒāļŦāļĨāļąāļ‡āļŠāļēāļĄāļēāļĢāļ–āļ™āļģāđ„āļ›āļ§āļēāļ‡āļšāļ™: + +* Kubernetes +* Worker Node +* API Gateway + +--- + +## 🎉 Summary + +### āļŠāļīāđˆāļ‡āļ—āļĩāđˆ Phase 6A āđ€āļžāļīāđˆāļĄāđ€āļ‚āđ‰āļēāđƒāļ™āļĢāļ°āļšāļš + +✔ Workflow DSL āļ—āļĩāđˆāđāļāđ‰āđ„āļ‚āđ„āļ”āđ‰āđ‚āļ”āļĒāđ„āļĄāđˆāļ•āđ‰āļ­āļ‡ Deploy +✔ Parser + Validator + Runtime Interpreter +✔ Database storage + Versioning +✔ Execution API āļŠāļģāļŦāļĢāļąāļš Backend āđāļĨāļ° Frontend +✔ āļĢāļ­āļ‡āļĢāļąāļš Business Workflow āļ‹āļąāļšāļ‹āđ‰āļ­āļ™āļ—āļąāđ‰āļ‡āļŦāļĄāļ” +✔ Ready āļŠāļģāļŦāļĢāļąāļš Microservice model āđƒāļ™āļ­āļ™āļēāļ„āļ• + diff --git a/2_Backend_Plan_V1_4_3.md b/docs/Markdown/2_Backend_Plan_V1_4_3.md similarity index 100% rename from 2_Backend_Plan_V1_4_3.md rename to docs/Markdown/2_Backend_Plan_V1_4_3.md diff --git a/3_Frontend_Plan_V1_4_3.md b/docs/Markdown/3_Frontend_Plan_V1_4_3.md similarity index 100% rename from 3_Frontend_Plan_V1_4_3.md rename to docs/Markdown/3_Frontend_Plan_V1_4_3.md diff --git a/4_Data_Dictionary_V1_4_3.md b/docs/Markdown/4_Data_Dictionary_V1_4_3.md similarity index 100% rename from 4_Data_Dictionary_V1_4_3.md rename to docs/Markdown/4_Data_Dictionary_V1_4_3.md diff --git a/docs/prompt.md b/docs/prompt.md index 2ea83a2..bc10c29 100644 --- a/docs/prompt.md +++ b/docs/prompt.md @@ -223,4 +223,202 @@ npm install --save-dev @nestjs/testing jest @types/jest @types/passport-jwt @typ 1. **`src/modules/document-numbering/document-numbering.service.ts`** (āđ€āļžāļ·āđˆāļ­āļ”āļđ Logic āļāļēāļĢāļĢāļąāļ™āđ€āļĨāļ‚āđ€āļ­āļāļŠāļēāļĢ) 2. **`src/common/file-storage/file-storage.service.ts`** (āđ€āļžāļ·āđˆāļ­āļ”āļđ Logic āļāļēāļĢāļˆāļąāļ”āļāļēāļĢāđ„āļŸāļĨāđŒāđāļĨāļ°āļāļēāļĢ Commit) -āļŦāļĢāļ·āļ­āļ–āđ‰āļēāļ•āđ‰āļ­āļ‡āļāļēāļĢāđƒāļŦāđ‰āļœāļĄāđ€āļĢāļīāđˆāļĄāđ€āļ‚āļĩāļĒāļ™ Code āļŠāđˆāļ§āļ™āđ„āļŦāļ™āļ—āļĩāđˆāļĒāļąāļ‡āļ‚āļēāļ”āļ­āļĒāļđāđˆ (āđ€āļŠāđˆāļ™ Workflow DSL Parser) āļŠāļēāļĄāļēāļĢāļ–āđāļˆāđ‰āļ‡āđ„āļ”āđ‰āđ€āļĨāļĒāļ„āļĢāļąāļš \ No newline at end of file +āļŦāļĢāļ·āļ­āļ–āđ‰āļēāļ•āđ‰āļ­āļ‡āļāļēāļĢāđƒāļŦāđ‰āļœāļĄāđ€āļĢāļīāđˆāļĄāđ€āļ‚āļĩāļĒāļ™ Code āļŠāđˆāļ§āļ™āđ„āļŦāļ™āļ—āļĩāđˆāļĒāļąāļ‡āļ‚āļēāļ”āļ­āļĒāļđāđˆ (āđ€āļŠāđˆāļ™ Workflow DSL Parser) āļŠāļēāļĄāļēāļĢāļ–āđāļˆāđ‰āļ‡āđ„āļ”āđ‰āđ€āļĨāļĒāļ„āļĢāļąāļš + + +āļŠāļ§āļąāļŠāļ”āļĩāļ„āļĢāļąāļš āđƒāļ™āļāļēāļ™āļ° Programmer āļ—āļĩāđˆāļ”āļđāđāļĨāļĢāļ°āļšāļš LCBP3-DMS āļœāļĄāđ„āļ”āđ‰āļ—āļģāļāļēāļĢ **Review āđ€āļ­āļāļŠāļēāļĢ `6B.md` (Special requirements for document-numbering)** āđ‚āļ”āļĒāđ€āļ—āļĩāļĒāļšāļāļąāļšāđ‚āļ„āļĢāļ‡āļŠāļĢāđ‰āļēāļ‡āļāļēāļ™āļ‚āđ‰āļ­āļĄāļđāļĨāđāļĨāļ°āđāļœāļ™āļ‡āļēāļ™āļ—āļĩāđˆāļĄāļĩāļ­āļĒāļđāđˆ (v1.4.3) āļžāļšāļ›āļĢāļ°āđ€āļ”āđ‡āļ™āļŠāļģāļ„āļąāļāđāļĨāļ°āļāļēāļĢāļ›āļĢāļąāļšāļ›āļĢāļļāļ‡āļ—āļēāļ‡āđ€āļ—āļ„āļ™āļīāļ„āļ—āļĩāđˆāļˆāļģāđ€āļ›āđ‡āļ™āļ”āļąāļ‡āļ™āļĩāđ‰āļ„āļĢāļąāļš + +----- + +# 📝 āļœāļĨāļāļēāļĢ Review āđ€āļ­āļāļŠāļēāļĢ 6B.md āđāļĨāļ°āđāļ™āļ§āļ—āļēāļ‡āļāļēāļĢ Implement + +## 1\. āļšāļ—āļ§āļīāđ€āļ„āļĢāļēāļ°āļŦāđŒāđāļĨāļ°āļœāļĨāļāļĢāļ°āļ—āļš (Analysis & Impact) + +āđ€āļ­āļāļŠāļēāļĢ `6B.md` āļĢāļ°āļšāļļāļ„āļ§āļēāļĄāļ•āđ‰āļ­āļ‡āļāļēāļĢāļ—āļĩāđˆ **āļ‹āļąāļšāļ‹āđ‰āļ­āļ™āļāļ§āđˆāļē** āļĢāļ°āļšāļš Running Number āļ—āļąāđˆāļ§āđ„āļ› (āļ—āļĩāđˆāļĄāļąāļāđ€āļ›āđ‡āļ™ `ORG-TYPE-YEAR-SEQ`) āđ‚āļ”āļĒāļĄāļĩāļ›āļĢāļ°āđ€āļ”āđ‡āļ™āļŠāļģāļ„āļąāļāļ„āļ·āļ­: + +1. **Requirement 1 (Flexibility):** Admin āļ•āđ‰āļ­āļ‡āđāļāđ‰ format āđ„āļ”āđ‰ → **āļĢāļ­āļ‡āļĢāļąāļšāđ„āļ”āđ‰** āļ”āđ‰āļ§āļĒāļ•āļēāļĢāļēāļ‡ `document_number_formats` āļ—āļĩāđˆāļĄāļĩāļ­āļĒāļđāđˆ āđāļ•āđˆāļ•āđ‰āļ­āļ‡āļ›āļĢāļąāļš Logic āļāļēāļĢāđāļ—āļ™āļ„āđˆāļēāļ•āļąāļ§āđāļ›āļĢ (Token Replacement) āđƒāļŦāđ‰āļ‰āļĨāļēāļ”āļ‚āļķāđ‰āļ™ +2. **Requirement 2.1 (Correspondence āļ—āļąāđˆāļ§āđ„āļ›):** āļĢāļđāļ›āđāļšāļšāļĄāļēāļ•āļĢāļāļēāļ™ â†’ **āļĢāļ­āļ‡āļĢāļąāļšāđ„āļ”āđ‰** āļ”āđ‰āļ§āļĒāđ‚āļ„āļĢāļ‡āļŠāļĢāđ‰āļēāļ‡āļ›āļąāļˆāļˆāļļāļšāļąāļ™ +3. **Requirement 2.2 (Transmittal):** āļĄāļĩāđ€āļ‡āļ·āđˆāļ­āļ™āđ„āļ‚ "To OWNER" vs "To CONTRACTOR" āđƒāļŠāđ‰āđ€āļĨāļ‚āļ•āđˆāļēāļ‡āļāļąāļ™ āđāļĨāļ°āļĄāļĩāļāļēāļĢ mapping `sub_type_number` → **Impact:** āļ•āđ‰āļ­āļ‡āđ€āļžāļīāđˆāļĄ Logic āđƒāļ™āļāļēāļĢāđ€āļĨāļ·āļ­āļ Format Template āļ•āļēāļĄ "āļœāļđāđ‰āļĢāļąāļš" (Recipient Role) āđāļĨāļ°āļ•āđ‰āļ­āļ‡āļĄāļĩāļ•āļēāļĢāļēāļ‡āđ€āļāđ‡āļš Mapping `sub_type_number` +4. **Requirement 2.3 (RFI) & 2.4 (RFA):** āļĄāļĩāļāļēāļĢāđƒāļŠāđ‰ `disciplines_code` (āđ€āļŠāđˆāļ™ GEN, STR, ARC) āđāļĨāļ°āđ„āļĄāđˆāļĄāļĩāļ›āļĩ (Year) āđƒāļ™ Format → **Impact:** + * āļāļēāļ™āļ‚āđ‰āļ­āļĄāļđāļĨāļ›āļąāļˆāļˆāļļāļšāļąāļ™āļ‚āļēāļ”āļ•āļēāļĢāļēāļ‡ `disciplines` + * āļ•āļēāļĢāļēāļ‡ `document_number_counters` āļ›āļąāļˆāļˆāļļāļšāļąāļ™ Key āļ„āļ·āļ­ `(Project, Org, Type, Year)` āđāļ•āđˆ RFA/RFI āļ­āļēāļˆāļˆāļ°āļ•āđ‰āļ­āļ‡āļ™āļąāļšāđāļĒāļāļ•āļēāļĄ **Discipline** āļ”āđ‰āļ§āļĒ āļŦāļēāļāđ„āļĄāđˆāđ€āļžāļīāđˆāļĄ Column āđƒāļ™ Counter āļ­āļēāļˆāļˆāļ°āđ€āļāļīāļ”āļ›āļąāļāļŦāļēāđ€āļĨāļ‚āļ‹āđ‰āļģāļŦāļĢāļ·āļ­āđ€āļĨāļ‚āļāļĢāļ°āđ‚āļ”āļ”āļ‚āđ‰āļēāļĄāļŦāļĄāļ§āļ”āļ‡āļēāļ™ + +----- + +## 2\. āļāļēāļĢāļ­āļ­āļāđāļšāļšāļāļēāļ™āļ‚āđ‰āļ­āļĄāļđāļĨāđ€āļžāļīāđˆāļĄāđ€āļ•āļīāļĄ (Database Schema Updates) + +āđ€āļžāļ·āđˆāļ­āđƒāļŦāđ‰āļĢāļ­āļ‡āļĢāļąāļš Requirement āļ™āļĩāđ‰ āļ•āđ‰āļ­āļ‡āļĄāļĩāļāļēāļĢāđ€āļžāļīāđˆāļĄāļ•āļēāļĢāļēāļ‡āđāļĨāļ°āđāļāđ‰āđ„āļ‚āļ•āļēāļĢāļēāļ‡ `01_lcbp3_v1_4_3.sql` āļ”āļąāļ‡āļ™āļĩāđ‰: + +### 2.1 āđ€āļžāļīāđˆāļĄāļ•āļēāļĢāļēāļ‡ `disciplines` āđāļĨāļ° `correspondence_sub_types` + +```sql +-- File: 01_lcbp3_v1_4_3_patch_6b.sql +-- āđ€āļžāļīāđˆāļĄāļ•āļēāļĢāļēāļ‡āļŦāļĄāļ§āļ”āļ‡āļēāļ™ (Disciplines) āļ•āļēāļĄ Req 6B +CREATE TABLE disciplines ( + id INT PRIMARY KEY AUTO_INCREMENT, + project_id INT NOT NULL, + discipline_code VARCHAR(10) NOT NULL COMMENT 'āđ€āļŠāđˆāļ™ GEN, STR, ARC', + name_th VARCHAR(255) COMMENT 'āļŠāļ·āđˆāļ­āđ„āļ—āļĒ', + name_en VARCHAR(255) COMMENT 'āļŠāļ·āđˆāļ­āļ­āļąāļ‡āļāļĪāļĐ', + is_active BOOLEAN DEFAULT TRUE, + created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP, + FOREIGN KEY (project_id) REFERENCES projects(id) ON DELETE CASCADE, + UNIQUE KEY uk_discipline_project (project_id, discipline_code) +) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_general_ci; + +-- āđ€āļžāļīāđˆāļĄāļ•āļēāļĢāļēāļ‡ Sub Types (āļŠāļģāļŦāļĢāļąāļš Transmittal/RFA mapping) +CREATE TABLE correspondence_sub_type_codes ( + id INT PRIMARY KEY AUTO_INCREMENT, + project_id INT NOT NULL, + correspondence_type_id INT NOT NULL, + sub_type_code VARCHAR(20) NOT NULL COMMENT 'āđ€āļŠāđˆāļ™ MAT, SHP', + sub_type_number VARCHAR(10) COMMENT 'āđ€āļĨāļ‚āļĢāļŦāļąāļŠ āđ€āļŠāđˆāļ™ 11, 22', + description VARCHAR(255), + FOREIGN KEY (project_id) REFERENCES projects(id) ON DELETE CASCADE, + FOREIGN KEY (correspondence_type_id) REFERENCES correspondence_types(id) ON DELETE CASCADE +) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_general_ci; +``` + +### 2.2 āļ›āļĢāļąāļšāļ›āļĢāļļāļ‡āļ•āļēāļĢāļēāļ‡ `rfas` āđāļĨāļ° `document_number_counters` + +āđ€āļ™āļ·āđˆāļ­āļ‡āļˆāļēāļ RFA/RFI āļ•āđ‰āļ­āļ‡āļ§āļīāđˆāļ‡āđ€āļĨāļ‚āļ•āļēāļĄ Discipline āđ€āļĢāļēāļˆāļķāļ‡āļ•āđ‰āļ­āļ‡āđ€āļāđ‡āļš Discipline āđ„āļ§āđ‰āđƒāļ™ RFA āđāļĨāļ°āļ•āđ‰āļ­āļ‡āđƒāļŠāđ‰āđ€āļ›āđ‡āļ™āļŠāđˆāļ§āļ™āļŦāļ™āļķāđˆāļ‡āļ‚āļ­āļ‡ Key āđƒāļ™āļāļēāļĢāļ™āļąāļšāđ€āļĨāļ‚ + +```sql +-- āđ€āļžāļīāđˆāļĄ discipline_id āđƒāļ™āļ•āļēāļĢāļēāļ‡ RFAs +ALTER TABLE rfas +ADD COLUMN discipline_id INT NULL AFTER rfa_type_id, +ADD CONSTRAINT fk_rfa_discipline FOREIGN KEY (discipline_id) REFERENCES disciplines(id); + +-- āđ€āļžāļīāđˆāļĄ discipline_id āđƒāļ™āļ•āļēāļĢāļēāļ‡ Correspondences (āļŠāļģāļŦāļĢāļąāļš RFI) +ALTER TABLE correspondences +ADD COLUMN discipline_id INT NULL AFTER correspondence_type_id, +ADD CONSTRAINT fk_corr_discipline FOREIGN KEY (discipline_id) REFERENCES disciplines(id); + +-- āļ›āļĢāļąāļšāļ›āļĢāļļāļ‡āļ•āļēāļĢāļēāļ‡ Counter āđƒāļŦāđ‰āļĢāļ­āļ‡āļĢāļąāļš Discipline āđāļĨāļ° SubType (āđƒāļŠāđ‰āđ€āļ›āđ‡āļ™ Dynamic Key āļŦāļĢāļ·āļ­āđ€āļžāļīāđˆāļĄ Column) +-- āđ€āļžāļ·āđˆāļ­āļ„āļ§āļēāļĄ Performance āđāļĨāļ° Integrity āđāļ™āļ°āļ™āļģāđƒāļŦāđ‰āđ€āļžāļīāđˆāļĄ Column +ALTER TABLE document_number_counters +ADD COLUMN discipline_id INT NULL DEFAULT NULL AFTER correspondence_type_id, +DROP PRIMARY KEY, +ADD PRIMARY KEY (project_id, originator_organization_id, correspondence_type_id, discipline_id, current_year); +-- āļŦāļĄāļēāļĒāđ€āļŦāļ•āļļ: āļ–āđ‰āļē discipline_id āđ€āļ›āđ‡āļ™ NULL āđƒāļŦāđ‰āļ–āļ·āļ­āļ§āđˆāļēāđ€āļ›āđ‡āļ™ Counter āļ—āļąāđˆāļ§āđ„āļ› +``` + +----- + +## 3\. āđāļ™āļ§āļ—āļēāļ‡āļāļēāļĢ Implement āđƒāļ™ NestJS (Backend Logic) + +āđ€āļĢāļēāļ•āđ‰āļ­āļ‡āļ›āļĢāļąāļš `DocumentNumberingService` āđƒāļŦāđ‰āđ€āļ›āđ‡āļ™ **Token-Based Generator** āļ—āļĩāđˆāļĄāļĩāļ„āļ§āļēāļĄāļĒāļ·āļ”āļŦāļĒāļļāđˆāļ™āļŠāļđāļ‡ + +### 3.1 āļĢāļđāļ›āđāļšāļš Template (Format Templates) + +Admin āļˆāļ°āļšāļąāļ™āļ—āļķāļ Template āļĨāļ‡ DB āđƒāļ™āļĢāļđāļ›āđāļšāļš: + + * General: `{ORG}-{ORG}-{SEQ:4}-{YEAR}` + * Transmittal: `{ORG}-{ORG}-{SUBTYPE_NUM}-{SEQ:4}-{YEAR}` + * RFA: `{CONTRACT}-{TYPE}-{DISCIPLINE}-{SUBTYPE}-{SEQ:4}-{REV}` + +### 3.2 Logic āļāļēāļĢ Generate (Pseudo Code) + +```typescript +// File: src/modules/document-numbering/document-numbering.service.ts + +/** + * Strategy: + * 1. āļĢāļąāļšāļ„āđˆāļē Context (Project, Org, Type, Discipline, SubType, Year) + * 2. āļ”āļķāļ‡ Format Template āļˆāļēāļ DB āļ•āļēāļĄ Type + * 3. āļ–āđ‰āļēāđ€āļ›āđ‡āļ™ Transmittal āļ•āđ‰āļ­āļ‡āđ€āļŠāđ‡āļ„āđ€āļ‡āļ·āđˆāļ­āļ™āđ„āļ‚āļžāļīāđ€āļĻāļĐāđ€āļžāļ·āđˆāļ­āđ€āļĨāļ·āļ­āļ Template (Owner vs Contractor) + * 4. Parse Template āđ€āļžāļ·āđˆāļ­āļŦāļēāļ§āđˆāļēāļ•āđ‰āļ­āļ‡āđƒāļŠāđ‰ Key āđ„āļŦāļ™āļšāđ‰āļēāļ‡āđƒāļ™āļāļēāļĢ Lock āđāļĨāļ° Count + * 5. Run Redlock + Optimistic Lock + * 6. Replace Tokens + */ + +async generateNextNumber(ctx: GenerateNumberContext): Promise { + // 1. Get Template + let template = await this.formatRepo.findOne({ ... }); + + // 2. Handle Special Logic (Requirement 2.2 Transmittal) + if (ctx.typeCode === 'TRANSMITTAL') { + // Logic: āļ–āđ‰āļēāļŠāđˆāļ‡āđƒāļŦāđ‰ Owner āđƒāļŠāđ‰ Template A, āļ–āđ‰āļē Contractor āđƒāļŠāđ‰ Template B + // āļŦāļĢāļ·āļ­āļ”āļķāļ‡ sub_type_number āļĄāļēāđ€āļ•āļĢāļĩāļĒāļĄāđ„āļ§āđ‰ + } + + // 3. Resolve Tokens Values + const tokens = { + '{ORG}': ctx.orgCode, + '{CONTRACT}': ctx.contractCode, + '{TYPE}': ctx.typeCode, + '{DISCIPLINE}': ctx.disciplineCode, // āļˆāļēāļāļ•āļēāļĢāļēāļ‡ disciplines + '{SUBTYPE}': ctx.subTypeCode, // āļˆāļēāļ rfa_types āļŦāļĢāļ·āļ­ sub_type_codes + '{SUBTYPE_NUM}': ctx.subTypeNumber, // āļˆāļēāļ correspondence_sub_type_codes + '{YEAR}': ctx.year.toString(), + '{YEAR_SHORT}': ctx.year.toString().slice(-2), + }; + + // 4. Construct Counter Key + // āļ–āđ‰āļē Template āļĄāļĩ {DISCIPLINE} āļ•āđ‰āļ­āļ‡āđ€āļ­āļē discipline_id āļĄāļēāđ€āļ›āđ‡āļ™āļŠāđˆāļ§āļ™āļŦāļ™āļķāđˆāļ‡āļ‚āļ­āļ‡ Composite Key āđƒāļ™ DB Counter + const counterKey = { + projectId: ctx.projectId, + orgId: ctx.orgId, + typeId: ctx.typeId, + disciplineId: template.includes('{DISCIPLINE}') ? ctx.disciplineId : null, + year: template.includes('{YEAR}') ? ctx.year : 0 // āļ–āđ‰āļēāđ„āļĄāđˆāđƒāļŠāđ‰āļ›āļĩ āđƒāļŦāđ‰āđƒāļŠāđ‰ 0 + }; + + // 5. Execute Double-Lock Mechanism (Redis + DB Optimistic) + const seq = await this.runDistributedCounter(counterKey); + + // 6. Final Replace + let finalNumber = template.formatTemplate; + for (const [key, value] of Object.entries(tokens)) { + finalNumber = finalNumber.replace(key, value || '00'); // Fallback if missing + } + // Replace SEQ with padding + finalNumber = finalNumber.replace(/{SEQ:(\d+)}/, (_, width) => + String(seq).padStart(Number(width), '0') + ); + + return finalNumber; +} +``` + +----- + +## 4\. āđāļœāļ™āļāļēāļĢāļ”āļģāđ€āļ™āļīāļ™āļāļēāļĢ (Action Plan) + +āđ€āļžāļ·āđˆāļ­āđƒāļŦāđ‰āļĢāļ­āļ‡āļĢāļąāļš `6B.md` āđ„āļ”āđ‰āļŠāļĄāļšāļđāļĢāļ“āđŒ āļœāļĄāļ‚āļ­āđ€āļŠāļ™āļ­āđƒāļŦāđ‰āļ”āļģāđ€āļ™āļīāļ™āļāļēāļĢāļ”āļąāļ‡āļ™āļĩāđ‰: + +1. **Database Migration:** + * āļĢāļąāļ™ SQL Script āđ€āļžāļ·āđˆāļ­āđ€āļžāļīāđˆāļĄāļ•āļēāļĢāļēāļ‡ `disciplines`, `correspondence_sub_type_codes`. + * Alter āļ•āļēāļĢāļēāļ‡ `rfas`, `correspondences` āđāļĨāļ° `document_number_counters` āļ•āļēāļĄāļ‚āđ‰āļ­ 2.2 +2. **Seed Data:** + * āļ™āļģāļ‚āđ‰āļ­āļĄāļđāļĨāļˆāļēāļāļ•āļēāļĢāļēāļ‡āđƒāļ™ `6B.md` (Disciplines, RFA Types, Sub Types) āļĄāļēāđ€āļ‚āļĩāļĒāļ™āđ€āļ›āđ‡āļ™ Seed Script āļĨāļ‡āļāļēāļ™āļ‚āđ‰āļ­āļĄāļđāļĨ āđ€āļžāļ·āđˆāļ­āđƒāļŦāđ‰āđ€āļĢāļīāđˆāļĄāļ•āđ‰āļ™āļĢāļ°āļšāļšāļĄāļĩāļ‚āđ‰āļ­āļĄāļđāļĨāļžāļĢāđ‰āļ­āļĄāđƒāļŠāđ‰āļ—āļąāļ™āļ—āļĩ +3. **Backend Implementation:** + * Update `DocumentNumberingService` āđƒāļŦāđ‰āļĢāļ­āļ‡āļĢāļąāļš Dynamic Token Replacement + * Update `CreateRfaDto` āđāļĨāļ° `CreateCorrespondenceDto` āđƒāļŦāđ‰āļĢāļąāļšāļ„āđˆāļē `discipline_id` āđāļĨāļ° `sub_type_id` (āļ–āđ‰āļēāļĄāļĩ) +4. **Admin Panel:** + * āļ•āđ‰āļ­āļ‡āļĄāļĩāļŦāļ™āđ‰āļē UI āđƒāļŦāđ‰ Admin āļˆāļąāļ”āļāļēāļĢ Mapping āļ‚āļ­āļ‡ `Format Template` āđāļĨāļ° `Sub Type Codes` āđ„āļ”āđ‰ (āļ•āļēāļĄ Requirement āļ‚āđ‰āļ­ 1) + +**āļ•āđ‰āļ­āļ‡āļāļēāļĢāđƒāļŦāđ‰āļœāļĄāđ€āļĢāļīāđˆāļĄāđ€āļ‚āļĩāļĒāļ™ SQL Migration Script āđāļĨāļ° Seed Data āļŠāļģāļŦāļĢāļąāļšāļ‚āđ‰āļ­āļĄāļđāļĨāđƒāļ™ 6B.md āđ€āļĨāļĒāļŦāļĢāļ·āļ­āđ„āļĄāđˆāļ„āļĢāļąāļš?** (āļ‚āđ‰āļ­āļĄāļđāļĨāđƒāļ™āļ•āļēāļĢāļēāļ‡āļ„āđˆāļ­āļ™āļ‚āđ‰āļēāļ‡āđ€āļĒāļ­āļ° āļāļēāļĢāļ—āļģ Seed āđ„āļ§āđ‰āļˆāļ°āļŠāđˆāļ§āļĒāļĨāļ”āđ€āļ§āļĨāļē Admin āđƒāļ™āļāļēāļĢāļāļĢāļ­āļāļ‚āđ‰āļ­āļĄāļđāļĨāđ€āļĢāļīāđˆāļĄāļ•āđ‰āļ™āđ„āļ”āđ‰āļĄāļēāļāļ„āļĢāļąāļš) + +āļˆāļēāļ āđāļœāļ™āļāļēāļĢāļ”āļģāđ€āļ™āļīāļ™āļāļēāļĢ (Action Plan): Database Migration āđāļĨāļ° Seed Data, āļœāļĄāđ„āļ”āđ‰āļ­āļąāļžāđ€āļ”āļ— Basic data āļ‚āđ‰āļ­ 5. Data files āđƒāļŦāđ‰āđāļĨāđ‰āļ§, āļŠāđˆāļ§āļĒ review āđāļĨāļ° āļ›āļĢāļąāļšāļ›āļĢāļļāļ‡ 4_Data_Dictionary_V1_4_3.md , + +āđ€āļ•āļĢāļĩāļĒāļĄ Backend Implementation, Admin Panel + + + + + +### **Phase 2: High-Integrity Data & File Management (āļŠāļąāļ›āļ”āļēāļŦāđŒāļ—āļĩāđˆ 4)** + +* **[ ] T2.3 DocumentNumberingModule - Token-Based & Double-Lock** (Updated) + * [ ] Update Entity: `DocumentNumberCounter` (Add `discipline_id` to PK) + * [ ] Implement Token Parser & Replacer Logic (`{DISCIPLINE}`, `{SUBTYPE_NUM}`) + * [ ] Update `generateNextNumber` to handle optional keys (Discipline/SubType) + * [ ] **Deliverable:** Flexible Numbering System + +* **[ ] T2.6 MasterModule - Advanced Data (Req 6B)** (New) + * [ ] Update Entities: `Discipline`, `CorrespondenceSubType` + * [ ] Create Services/Controllers for CRUD Operations (Admin Panel Support) + * [ ] Implement Seeding Logic for initial 6B data + * [ ] **Deliverable:** API for managing Disciplines and Sub-types + * [ ] **Dependencies:** T1.1, T0.3 \ No newline at end of file diff --git a/docs/temp.md b/docs/temp.md deleted file mode 100644 index a5235c1..0000000 --- a/docs/temp.md +++ /dev/null @@ -1,188 +0,0 @@ -# Special requirements for document-numbering -āļāļēāļĢāđƒāļŠāđ‰āļ‡āļēāļ™āļˆāļĢāļīāļ‡āļ•āđ‰āļ­āļ‡āļāļēāļĢāļ„āļ§āļēāļĄāļĒāļ·āļ”āļŦāļĒāļļāđˆāļ™āļŠāļđāļ‡ āļŠāļģāļŦāļĢāļąāļš āļĢāļ°āļšāļš document-numbering āļ”āļąāļ‡āļ™āļĩāđ‰ - -## 1. āļ•āđ‰āļ­āļ‡āđƒāļŦāđ‰ admin āļŠāļēāļĄāļēāļĢāļ–āļāļģāļŦāļ™āļ”āļĢāļđāļ›āđāļšāļšāđƒāļ™āļ–āļēāļĒāļŦāļĨāļąāļ‡āđ„āļ”āđ‰ -## 2. āļĄāļĩāļĢāļđāļ›āđāļšāļšāđ€āļĢāļīāđˆāļĄāļ•āđ‰āļ™āļ”āļąāļ‡āļ™āļĩāđ‰ -* 2.1 āļŠāļģāļŦāļĢāļąāļš correspondence āļ—āļąāđˆāļ§āđ„āļ› - * āđƒāļŠāđ‰āļĢāļđāļ›āđāļšāļš [organizations.organization_code]-[organizations.organization_code]-[sequence]-[year] - * **_āļ•āļąāļ§āļ­āļĒāđˆāļēāļ‡: āļ„āļ„āļ‡.-āļœāļĢāļĄ.2-0123-2568_** -* 2.2 āļŠāļģāļŦāļĢāļąāļš correspondence type = transmittal - * āđƒāļŠāđ‰āļĢāļđāļ›āđāļšāļš [organizations.organization_code]-[organizations.organization_code]-[codecorrespondence_sub_types.sub_type_number]-[seq]-[year] - * **_āļ•āļąāļ§āļ­āļĒāđˆāļēāļ‡: āļ„āļ„āļ‡.-āļŠāļ„āļ‰.3-22-0123-2568_** -* 2.3 āļŠāļģāļŦāļĢāļąāļš correspondence type = rfi - * āđƒāļŠāđ‰āļĢāļđāļ›āđāļšāļš [contrcts.contract_code]-[correspondences_types.type_code]-[disciplines_code]-[seq]-[revision] - * **_āļ•āļąāļ§āļ­āļĒāđˆāļēāļ‡: LCBP3-C2-RFI-TER-2345-A_** -* 2.4 āļŠāļģāļŦāļĢāļąāļš rfa āđƒāļŠāđ‰āđāļšāļšāđ€āļĨāļ‚āđāļĒāļāļāļąāļ™ - * āđƒāļŠāđ‰āļĢāļđāļ›āđāļšāļš [contrcts.contract_code]-[correspondences_types.type_code]-[disciplines_code]-[rfa_types.type_code]-[seq]-[revision] - * **_āļ•āļąāļ§āļ­āļĒāđˆāļēāļ‡: LCBP3-C1-RFA-TER-MAT-1234-A_** - -## āļ•āļēāļĢāļēāļ‡ correspondence_sub_types - -| id | correspondence_types.type_code | sub_type_code | sub_type_name | sub_type_number | -| --- | ------------------------------ | ------------- | -------------- | --------------- | -| 1 | RFA | MAT | Material Approval | 11 | -| 2 | RFA | SHP | Shop Drawing Submittal | 12 | -| 3 | RFA | DWG | Document Approval | 13 | -| 4 | RFA | MET | Engineering Document Submittal | 14 | -| 5 | RFA | MAT | Material Approval | 21 | -| 6 | RFA | SHP | Shop Drawing Submittal | 22 | -| 7 | RFA | DWG | Document Approval | 23 | -| 8 | RFA | MET | Engineering Document Submittal | 24 | -| 9 | RFA | MAT | Material Approval | 31 | -| 10 | RFA | SHP | Shop Drawing Submittal | 32 | -| 11 | RFA | DWG | Document Approval | 33 | -| 12 | RFA | MET | Engineering Document Submittal | 34 | -| 13 | RFA | MAT | Material Approval | 41 | -| 14 | RFA | SHP | Shop Drawing Submittal | 42 | -| 15 | RFA | DWG | Document Approval | 43 | -| 16 | RFA | MET | Engineering Document Submittal | 44 | - -## āļ•āļēāļĢāļēāļ‡ disciplines - -| contract_code | code | code_name_th | code_name_en | -|---------------|------|---------------------------------------|--------------------------------------------| -| LCBP3-C1 | GEN | āļ‡āļēāļ™āļšāļĢāļīāļŦāļēāļĢāđ‚āļ„āļĢāļ‡āļāļēāļĢ | General Management | -| LCBP3-C1 | COD | āļŠāļąāļāļāļēāđāļĨāļ°āļ‚āđ‰āļ­āđ‚āļ•āđ‰āđāļĒāđ‰āļ‡ | Contracting | -| LCBP3-C1 | QSB | āļŠāļģāļĢāļ§āļˆāļ›āļĢāļīāļĄāļēāļ“āđāļĨāļ°āļ„āļ§āļšāļ„āļļāļĄāļ‡āļšāļ›āļĢāļ°āļĄāļēāļ“ | Quantity Survey and Budget Control | -| LCBP3-C1 | PPG | āļšāļĢāļīāļŦāļēāļĢāđāļœāļ™āđāļĨāļ°āļ„āļ§āļēāļĄāļāđ‰āļēāļ§āļŦāļ™āđ‰āļē | Plan and Progress Management | -| LCBP3-C1 | PRC | āļ‡āļēāļ™āļˆāļąāļ”āļ‹āļ·āđ‰āļ­ | Procurement | -| LCBP3-C1 | SUB | āļœāļđāđ‰āļĢāļąāļšāđ€āļŦāļĄāļēāļŠāđˆāļ§āļ‡ | Subcontractor | -| LCBP3-C1 | ODC | āļŠāļģāļ™āļąāļāļ‡āļēāļ™-āļ„āļ§āļšāļ„āļļāļĄāđ€āļ­āļāļŠāļēāļĢ | Operation Docment Control | -| LCBP3-C1 | LAW | āļāļŽāļŦāļĄāļēāļĒ | Law | -| LCBP3-C1 | TRF | āļˆāļĢāļēāļˆāļĢ | Traffic | -| LCBP3-C1 | BIM | BIM | Building information modeling | -| LCBP3-C1 | SRV | āļ‡āļēāļ™āļŠāļģāļĢāļ§āļˆ | Survey | -| LCBP3-C1 | SFT | āļ„āļ§āļēāļĄāļ›āļĨāļ­āļ”āļ āļąāļĒ | Safety | -| LCBP3-C1 | BST | āļ‡āļēāļ™āđ‚āļ„āļĢāļ‡āļŠāļĢāđ‰āļēāļ‡āļ­āļēāļ„āļēāļĢ | Building Structure Work | -| LCBP3-C1 | TEM | āļ‡āļēāļ™āļŠāļąāđˆāļ§āļ„āļĢāļēāļ§ | Temporary Work | -| LCBP3-C1 | UTL | āļ‡āļēāļ™āļĢāļ°āļšāļšāļŠāļēāļ˜āļēāļĢāļ“āļđāļ›āđ‚āļ āļ„ | Utility | -| LCBP3-C1 | EPW | āļ‡āļēāļ™āļĢāļ°āļšāļšāđ„āļŸāļŸāđ‰āļē | Electrical Power Work | -| LCBP3-C1 | ECM | āļ‡āļēāļ™āļĢāļ°āļšāļšāđ„āļŸāļŸāđ‰āļēāļŠāļ·āđˆāļ­āļŠāļēāļĢ | Electrical Communication Work | -| LCBP3-C1 | ENV | āļŠāļīāđˆāļ‡āđāļ§āļ”āļĨāđ‰āļ­āļĄ | Environment | -| LCBP3-C1 | AQV | āļ„āļļāļ“āļ āļēāļžāļ­āļēāļāļēāļĻāđāļĨāļ°āļ„āļ§āļēāļĄāļŠāļąāđˆāļ™āļŠāļ°āđ€āļ—āļ·āļ­āļ™ | Air quality and vibration | -| LCBP3-C1 | WAB | āļ„āļļāļ“āļ āļēāļžāļ™āđ‰āļģāđāļĨāļ°āļŠāļĩāļ§āļ§āļīāļ—āļĒāļēāļ—āļēāļ‡āļ™āđ‰āļģ | Water quality and Aquatic biology | -| LCBP3-C1 | ONS | āļ§āļīāļĻāļ§āļāļĢāļĢāļĄāļŠāļēāļĒāļāļąāđˆāļ‡ | Onshore Engineer Work | -| LCBP3-C1 | PPR | āļĄāļ§āļĨāļŠāļ™āļŠāļąāļĄāļžāļąāļ™āļ˜āđŒāđāļĨāļ°āļāļēāļĢāļ›āļĢāļ°āļŠāļēāļŠāļąāļĄāļžāļąāļ™āļ˜āđŒ | Public Relations | -| LCBP3-C1 | OSW | āļ‡āļēāļ™āļāđˆāļ­āļŠāļĢāđ‰āļēāļ‡āļ‡āļēāļ™āļ—āļēāļ‡āļ—āļ°āđ€āļĨ | Offshore Work | -| LCBP3-C1 | DRE | āļ‡āļēāļ™āļ‚āļļāļ”āđāļĨāļ°āļ–āļĄāļ—āļ°āđ€āļĨ | Dredging and Reclamation | -| LCBP3-C1 | REV | āļ‡āļēāļ™āļ„āļąāļ™āļŦāļīāļ™āļĨāđ‰āļ­āļĄāļžāļ·āđ‰āļ™āļ—āļĩāđˆāļ–āļĄāļ—āļ°āđ€āļĨ | Revetment | -| LCBP3-C1 | BRW | āļ‡āļēāļ™āđ€āļ‚āļ·āđˆāļ­āļ™āļāļąāļ™āļ„āļĨāļ·āđˆāļ™ | Breakwater | -| LCBP3-C1 | SOI | āļ›āļĢāļąāļšāļ›āļĢāļļāļ‡āļ„āļļāļ“āļ āļēāļžāļ”āļīāļ™ | Soil Improvement | -| LCBP3-C1 | BLC | āļ‡āļēāļ™āļ›āļĢāļąāļšāļ›āļĢāļļāļ‡āļ„āļĨāļ­āļ‡āļšāļēāļ‡āļĨāļ°āļĄāļļāļ‡ | Bang Lamung Canal Bank Protection | -| LCBP3-C1 | FUP | āļ‡āļēāļ™āļ›āļĢāļ°āļ•āļđāļĢāļ°āļšāļēāļĒāļ™āđ‰āļģāđāļĨāļ°āļ—āđˆāļ­āļĨāļ­āļ” | Floodgate & Under Ground Piping Works | -| LCBP3-C1 | SWP | āļ‡āļēāļ™āļ­āļēāļ„āļēāļĢāļ„āļ§āļšāļ„āļļāļĄāļŠāļ–āļēāļ™āļĩāļŠāļđāļšāļ™āđ‰āļģāļ—āļ°āđ€āļĨ | Sea Water Pumping Station Control BuilDing | -| LCBP3-C1 | NAV | āļ‡āļēāļ™āļ•āļīāļ”āļ•āļąāđ‰āļ‡āđ€āļ„āļĢāļ·āđˆāļ­āļ‡āļŦāļĄāļēāļĒāļŠāđˆāļ§āļ‡āļāļēāļĢāđ€āļ”āļīāļ™āđ€āļĢāļ·āļ­ | Navigations Aids | -| LCBP3-C1 | GEO | āļ‡āļēāļ™āļ”āđ‰āļēāļ™āļ˜āļĢāļ“āļĩāđ€āļ—āļ„āļ™āļīāļ„ | Geotechnical | -| LCBP3-C1 | CRW | āļ‡āļēāļ™āļ”āđ‰āļēāļ™āđ‚āļĒāļ˜āļē - Rock Works | Civil-Rock work | -| LCBP3-C1 | DVR | āļ—āļĩāļĄāļ™āļąāļāļ›āļĢāļ°āļ”āļēāļ™āđ‰āļģ | Dive Work | -| LCBP3-C1 | MTS | āļ‡āļēāļ™āļ—āļ”āļŠāļ­āļšāļ§āļąāļŠāļ”āļļāđāļĨāļ°āļ˜āļĢāļ“āļĩāđ€āļ—āļ„āļ™āļīāļ„ | Materials and Geotechnical Testing | -| LCBP3-C1 | OTH | āļ­āļ·āđˆāļ™āđ† | Other | -| LCBP3-C2 | GEN | āļ‡āļēāļ™āļšāļĢāļīāļŦāļēāļĢāđ‚āļ„āļĢāļ‡āļāļēāļĢ | Project Management | -| LCBP3-C2 | COD | āļŠāļąāļāļāļēāđāļĨāļ°āļ‚āđ‰āļ­āđ‚āļ•āđ‰āđāļĒāđ‰āļ‡ | Contracts and arguments | -| LCBP3-C2 | QSB | āļŠāļģāļĢāļ§āļˆāļ›āļĢāļīāļĄāļēāļ“āđāļĨāļ°āļ„āļ§āļšāļ„āļļāļĄāļ‡āļšāļ›āļĢāļ°āļĄāļēāļ“ | Survey the quantity and control the budget | -| LCBP3-C2 | PPM | āļšāļĢāļīāļŦāļēāļĢāđāļœāļ™āđāļĨāļ°āļ„āļ§āļēāļĄāļāđ‰āļēāļ§āļŦāļ™āđ‰āļē | Plan Management & Progress | -| LCBP3-C2 | ODC | āļŠāļģāļ™āļąāļāļ‡āļēāļ™-āļ„āļ§āļšāļ„āļļāļĄāđ€āļ­āļāļŠāļēāļĢ | Document Control Office | -| LCBP3-C2 | LAW | āļāļŽāļŦāļĄāļēāļĒ | Law | -| LCBP3-C2 | TRF | āļˆāļĢāļēāļˆāļĢ | Traffic | -| LCBP3-C2 | BIM | Building Information Modeling | Building Information Modeling | -| LCBP3-C2 | SRV | āļ‡āļēāļ™āļŠāļģāļĢāļ§āļˆ | Survey | -| LCBP3-C2 | SFT | āļ„āļ§āļēāļĄāļ›āļĨāļ­āļ”āļ āļąāļĒ | Safety | -| LCBP3-C2 | BST | āļ‡āļēāļ™āđ‚āļ„āļĢāļ‡āļŠāļĢāđ‰āļēāļ‡āļ­āļēāļ„āļēāļĢ | Building Structure | -| LCBP3-C2 | UTL | āļ‡āļēāļ™āļ°āļšāļšāļŠāļēāļ˜āļēāļĢāļ“āļđāļ›āđ‚āļ āļ„ | Public Utilities | -| LCBP3-C2 | EPW | āļ‡āļēāļ™āļĢāļ°āļšāļšāđ„āļŸāļŸāđ‰āļē | Electrical Systems | -| LCBP3-C2 | ECM | āļ‡āļēāļ™āļĢāļ°āļšāļšāđ„āļŸāļŸāđ‰āļēāļŠāļ·āđˆāļ­āļŠāļēāļĢ | Electrical Communication System | -| LCBP3-C2 | ENV | āļŠāļīāđˆāļ‡āđāļ§āļ”āļĨāđ‰āļ­āļĄ | Environment | -| LCBP3-C2 | AQV | āļ„āļļāļ“āļ āļēāļžāļ­āļēāļāļēāļĻāđāļĨāļ°āļ„āļ§āļēāļĄāļŠāļąāđˆāļ™āļŠāļ°āđ€āļ—āļ·āļ­āļ™ | Air Quality and Vibration | -| LCBP3-C2 | WAB | āļ„āļļāļ“āļ āļēāļžāļ™āđ‰āļģāđāļĨāļ°āļŠāļĩāļ§āļ§āļīāļ—āļĒāļēāļ—āļēāļ‡āļ™āđ‰āļģ | Water Quality and Aquatic Biology | -| LCBP3-C2 | ONS | āļ§āļīāļĻāļ§āļāļĢāļĢāļĄāļŠāļēāļĒāļāļąāđˆāļ‡ | Coastal Engineering | -| LCBP3-C2 | PPR | āļĄāļ§āļĨāļŠāļ™āļŠāļąāļĄāļžāļąāļ™āļ˜āđŒāđāļĨāļ°āļ›āļĢāļ°āļŠāļēāļŠāļąāļĄāļžāļąāļ™āļ˜āđŒ | Mass Relations and Public Relations | -| LCBP3-C2 | OFW | āļ‡āļēāļ™āļāđˆāļ­āļŠāļĢāđ‰āļēāļ‡āļ—āļēāļ‡āļ—āļ°āđ€āļĨ | Marine Construction | -| LCBP3-C2 | EXR | āļ‡āļēāļ™āļ‚āļļāļ”āđāļĨāļ°āļ–āļĄāļ—āļ°āđ€āļĨ | Excavation and reclamation | -| LCBP3-C2 | GEO | āļ‡āļēāļ™āļ”āđ‰āļēāļ™āļ˜āļĢāļ“āļĩāđ€āļ—āļ„āļ™āļīāļ„ | Geotechnical work | -| LCBP3-C2 | CRW | āļ‡āļēāļ™āļ”āđ‰āļēāļ™āđ‚āļĒāļ˜āļē - Rock Works | Civil Works - Rock Works | -| LCBP3-C2 | DVW | āļ—āļĩāļĄāļ™āļąāļāļ›āļĢāļ°āļ”āļēāļ™āđ‰āļģ | Team of Divers | -| LCBP3-C2 | MTT | āļ‡āļēāļ™āļ—āļ”āļŠāļ­āļšāļ§āļąāļŠāļ”āļļ | Materials Testing | -| LCBP3-C2 | ARC | āļ‡āļēāļ™āļŠāļ–āļēāļ›āļąāļ•āļĒāļāļĢāļĢāļĄ | Architecture | -| LCBP3-C2 | STR | āļ‡āļēāļ™āđ‚āļ„āļĢāļ‡āļŠāļĢāđ‰āļēāļ‡ | Structural work | -| LCBP3-C2 | SAN | āļ‡āļēāļ™āļĢāļ°āļšāļšāļŠāļļāļ‚āļēāļ āļīāļšāļēāļĨ | Sanitation System | -| LCBP3-C2 | DRA | āļ‡āļēāļ™āļĢāļ°āļšāļšāļĢāļ°āļšāļēāļĒāļ™āđ‰āļģ | Drainage system work | -| LCBP3-C2 | TER | āļ‡āļēāļ™āļ—āđˆāļēāđ€āļ—āļĩāļĒāļšāđ€āļĢāļ·āļ­ | Wharf work | -| LCBP3-C2 | BUD | āļ‡āļēāļ™āļ­āļēāļ„āļēāļĢ | Building | -| LCBP3-C2 | ROW | āļ‡āļēāļ™āļ–āļ™āļ™āđāļĨāļ°āļŠāļ°āļžāļēāļ™ | Road and Bridge Work | -| LCBP3-C2 | MEC | āļ‡āļēāļ™āđ€āļ„āļĢāļīāļ­āļ‡āļāļĨ | Mechanical work | -| LCBP3-C2 | OTH | āļ­āļ·āđˆāļ™ āđ† | Others | - -## āļ•āļēāļĢāļēāļ‡ doccument_types - -| contract_code | code | name_en | name_th | -|---------------|------|----------------------------------------------|----------------------------------------------| -| LCBP3-C1 | ADW | As Built Drawing | āđāļšāļšāļĢāđˆāļēāļ‡āļŦāļĨāļąāļ‡āļāļēāļĢāļāđˆāļ­āļŠāļĢāđ‰āļēāļ‡ | -| LCBP3-C1 | BC | Box culvert | āļ—āđˆāļ­āļĢāļ°āļšāļēāļĒāļ™āđ‰āđāļēāļĢāļđāļ›āļāļĨāđˆāļ­āļ‡ | -| LCBP3-C1 | BM | Benchmark | āļŦāļĄāļļāļ”āļŦāļĨāļąāļāļāļēāļ™ | -| LCBP3-C1 | CER | Certificates | āđƒāļšāļĢāļąāļšāļĢāļ­āļ‡ | -| LCBP3-C1 | CN | Canal Drainage | āļĢāļ°āļšāļšāļĢāļ°āļšāļēāļĒāļ™āđ‰āđāļēāđƒāļ™āļ„āļĨāļ­āļ‡ | -| LCBP3-C1 | CON | Contract | āļŠāļąāļāļāļē | -| LCBP3-C1 | DDS | Design Data Submission | āļ™āļģāļŠāđˆāļ‡āļ‚āđ‰āļ­āļĄāļđāļĨāļāļēāļĢāļ­āļ­āļāđāļšāļš | -| LCBP3-C1 | DDW | Draft Drawing | āđāļšāļšāļĢāđˆāļēāļ‡ | -| LCBP3-C1 | DRW | Drawings (All Types) | āđāļšāļšāļāđˆāļ­āļŠāļĢāđ‰āļēāļ‡ | -| LCBP3-C1 | DSN | Design/Calculation/Manual (All Stages) | āļ­āļ­āļāđāļšāļš / āļ„āļģāļ™āļ§āļ“ / āļ„āļđāđˆāļĄāļ·āļ­ | -| LCBP3-C1 | GEN | General | āļ—āļąāđˆāļ§āđ„āļ› | -| LCBP3-C1 | ICR | Incident Report | āļĢāļēāļĒāļ‡āļēāļ™āļāļēāļĢāđ€āļāļīāļ”āļ­āļļāļšāļąāļ•āļīāđ€āļŦāļ•āļļāđāļĨāļ°āļāļēāļĢāļšāļēāļ”āđ€āļˆāđ‡āļš | -| LCBP3-C1 | INS | Insurances/Bond/Guarantee | āļāļēāļĢāļ›āļĢāļ°āļāļąāļ™ / āļžāļąāļ™āļ˜āļšāļąāļ•āļĢ / āļāļēāļĢāļ„āđ‰āļģāļ›āļĢāļ°āļāļąāļ™ | -| LCBP3-C1 | INS | Inspection/Audit/Surveillance Report | āļĢāļēāļĒāļ‡āļēāļ™āļāļēāļĢāļ•āļĢāļ§āļˆāļŠāļ­āļš / āļāļēāļĢāļ•āļĢāļ§āļˆāļŠāļ­āļš / āļĢāļēāļĒāļ‡āļēāļ™āļāļēāļĢāđ€āļāđ‰āļēāļĢāļ°āļ§āļąāļ‡ | -| LCBP3-C1 | ITP | Inspection and Test Plan | āđāļœāļ™āļāļēāļĢāļ•āļĢāļ§āļˆāļŠāļ­āļšāđāļĨāļ°āļ—āļ”āļŠāļ­āļš | -| LCBP3-C1 | JSA | Jobs Alalysis | āļĢāļēāļĒāļ‡āļēāļ™āļāļēāļĢāļ§āļīāđ€āļ„āļĢāļēāļ°āļŦāđŒāļ„āļ§āļēāļĄāļ›āļĨāļ­āļ”āļ āļąāļĒ | -| LCBP3-C1 | MAN | Manual | āļ„āļđāđˆāļĄāļ·āļ­ | -| LCBP3-C1 | MAT | Materials/Equipment/Plant | āļ§āļąāļŠāļ”āļļ / āļ­āļļāļ›āļāļĢāļ“āđŒ / āđ‚āļĢāļ‡āļ‡āļēāļ™ | -| LCBP3-C1 | MOM | Minute of Meeting | āļĢāļēāļĒāļ‡āļēāļ™āļāļēāļĢāļ›āļĢāļ°āļŠāļļāļĄ | -| LCBP3-C1 | MPR | Monthly Progress Report | āļĢāļēāļĒāļ‡āļēāļ™āļ„āļ§āļēāļĄāļ„āļ·āļšāļŦāļ™āđ‰āļēāļ›āļĢāļ°āļˆāļģāđ€āļ”āļ·āļ­āļ™ | -| LCBP3-C1 | MST | Method Statement for Construction/Installation| āļ‚āļąāđ‰āļ™āļ•āļ­āļ™āļāļēāļĢāļāđˆāļ­āļŠāļĢāđ‰āļēāļ‡ / āļ•āļīāļ”āļ•āļąāđ‰āļ‡ | -| LCBP3-C1 | NDS | Non-Design Data Submission | āļ™āļģāļŠāđˆāļ‡āļ‚āđ‰āļ­āļĄāļđāļĨāļ—āļĩāđˆāđ„āļĄāđˆāđ€āļāļĩāđˆāļĒāļ§āļ‚āđ‰āļ­āļ‡āļāļąāļšāļāļēāļĢāļ­āļ­āļāđāļšāļš | -| LCBP3-C1 | PMA | Payment/Invoice/Retention/Estimate | āļāļēāļĢāļŠāļģāļĢāļ°āđ€āļ‡āļīāļ™ / āđƒāļšāđāļˆāđ‰āļ‡āļŦāļ™āļĩāđ‰ / āļ›āļĢāļ°āļāļąāļ™āļœāļĨāļ‡āļēāļ™ / āļ›āļĢāļ°āļĄāļēāļ“āļāļēāļĢ | -| LCBP3-C1 | PRD | Procedure | āļĢāļ°āđ€āļšāļĩāļĒāļšāļ›āļāļīāļšāļąāļ•āļī | -| LCBP3-C1 | PRG | Progress of Construc | āļ„āļ§āļēāļĄāļ„āļ·āļšāļŦāļ™āđ‰āļēāļ‚āļ­āļ‡āļāļēāļĢāļāđˆāļ­āļŠāļĢāđ‰āļēāļ‡ / āļ āļēāļžāļ–āđˆāļēāļĒ / āļ§āļīāļ”āļĩāđ‚āļ­ | -| LCBP3-C1 | QMS | Quality Document (Plan//Work Instruction) | āđ€āļ­āļāļŠāļēāļĢāļ”āđ‰āļēāļ™āļ„āļļāļ“āļ āļēāļž (āđ‚āļĢāļ‡āļ‡āļēāļ™ / āļ‚āđ‰āļ­āđāļ™āļ°āļ™āļģāđƒāļ™āļāļēāļĢāļ—āļģāļ‡āļēāļ™) | -| LCBP3-C1 | RPT | Report | āļĢāļēāļĒāļ‡āļēāļ™ | -| LCBP3-C1 | SAR | Semi Annual Report | āļĢāļēāļĒāļ‡āļēāļ™āļ›āļĢāļ°āļˆāļģāļŦāļāđ€āļ”āļ·āļ­āļ™ | -| LCBP3-C1 | SCH | Schedule and Program | āđāļœāļ™āļ‡āļēāļ™ | -| LCBP3-C1 | SDW | Shop Drawing | āđāļšāļšāļ‚āļĒāļēāļĒāļĢāļēāļĒāļĨāļ°āđ€āļ­āļĩāļĒāļ” | -| LCBP3-C1 | SI | Soil Investigation | āļāļēāļĢāļ•āļĢāļ§āļˆāļŠāļ­āļšāļ”āļīāļ™ | -| LCBP3-C1 | SPE | Specification | āļ‚āđ‰āļ­āļāļģāļŦāļ™āļ” | -| LCBP3-C1 | TNR | Training report | āļĢāļēāļĒāļ‡āļēāļ™āļāļēāļĢāļāļķāļāļ›āļāļīāļšāļąāļ•āļī | -| LCBP3-C1 | UC | Underground Constructon | āđ‚āļ„āļĢāļ‡āļŠāļĢāđ‰āļēāļ‡āđƒāļ•āđ‰āļ”āļīāļ™ | -| LCBP3-C1 | VEN | Vendor | āļœāļđāđ‰āļ‚āļēāļĒ | -| LCBP3-C1 | VRO | Variation Request/Instruction/Order | āļ„āļģāļ‚āļ­āđ€āļ›āļĨāļĩāđˆāļĒāļ™āđāļ›āļĨāļ‡ / āļ‚āđ‰āļ­āđ€āļŠāļ™āļ­āđāļ™āļ° / āļ‚āđ‰āļ­āđ€āļĢāļĩāļĒāļāļĢāđ‰āļ­āļ‡ | -| LCBP3-C1 | WTY | Warranty | āļāļēāļĢāļ›āļĢāļ°āļāļąāļ™ | -| LCBP3-C2 | GEN | General | āļ—āļąāđˆāļ§āđ„āļ› | -| LCBP3-C2 | CON | Contract | āļŠāļąāļāļāļē | -| LCBP3-C2 | INS | Insurances/Bond/Guarantee | āļāļēāļĢāļ›āļĢāļ°āļāļąāļ™ / āļžāļąāļ™āļ˜āļšāļąāļ•āļĢ / āļāļēāļĢāļ„āđ‰āļģāļ›āļĢāļ°āļāļąāļ™ | -| LCBP3-C2 | SCH | Schedule and Program | āđāļœāļ™āļ‡āļēāļ™ | -| LCBP3-C2 | PMA | Payment/Invoice/Retention/Estimate | āļāļēāļĢāļŠāļģāļĢāļ°āđ€āļ‡āļīāļ™ / āđƒāļšāđāļˆāđ‰āļ‡āļŦāļ™āļĩāđ‰ / āļ›āļĢāļ°āļāļąāļ™āļœāļĨāļ‡āļēāļ™ / āļ›āļĢāļ°āļĄāļēāļ“āļāļēāļĢ | -| LCBP3-C2 | VRO | Variation Request/Instruction/Order | āļ„āļģāļ‚āļ­āđ€āļ›āļĨāļĩāđˆāļĒāļ™āđāļ›āļĨāļ‡ / āļ‚āđ‰āļ­āđ€āļŠāļ™āļ­āđāļ™āļ° / āļ‚āđ‰āļ­āđ€āļĢāļĩāļĒāļāļĢāđ‰āļ­āļ‡ | -| LCBP3-C2 | VEN | Vendor | āļœāļđāđ‰āļ‚āļēāļĒ | -| LCBP3-C2 | WTY | Warranty | āļāļēāļĢāļ›āļĢāļ°āļāļąāļ™ | -| LCBP3-C2 | DRW | Drawings (All Types) | āđāļšāļšāļāđˆāļ­āļŠāļĢāđ‰āļēāļ‡ | -| LCBP3-C2 | DDW | Draft Drawing | āđāļšāļšāļĢāđˆāļēāļ‡ | -| LCBP3-C2 | SDW | Shop Drawing | āđāļšāļšāļ‚āļĒāļēāļĒāļĢāļēāļĒāļĨāļ°āđ€āļ­āļĩāļĒāļ” | -| LCBP3-C2 | ADW | As Built Drawing | āđāļšāļšāļĢāđˆāļēāļ‡āļŦāļĨāļąāļ‡āļāļēāļĢāļāđˆāļ­āļŠāļĢāđ‰āļēāļ‡ | -| LCBP3-C2 | DDS | Design Data Submission | āļ™āļģāļŠāđˆāļ‡āļ‚āđ‰āļ­āļĄāļđāļĨāļāļēāļĢāļ­āļ­āļāđāļšāļš | -| LCBP3-C2 | DSN | Design/Calculation/Manual (All Stages) | āļ­āļ­āļāđāļšāļš / āļ„āļģāļ™āļ§āļ“ / āļ„āļđāđˆāļĄāļ·āļ­ | -| LCBP3-C2 | NDS | Non-Design Data Submission | āļ™āļģāļŠāđˆāļ‡āļ‚āđ‰āļ­āļĄāļđāļĨāļ—āļĩāđˆāđ„āļĄāđˆāđ€āļāļĩāđˆāļĒāļ§āļ‚āđ‰āļ­āļ‡āļāļąāļšāļāļēāļĢāļ­āļ­āļāđāļšāļš | -| LCBP3-C2 | PRD | Procedure | āļĢāļ°āđ€āļšāļĩāļĒāļšāļ›āļāļīāļšāļąāļ•āļī | -| LCBP3-C2 | MST | Method Statement for Construction/Installation| āļ‚āļąāđ‰āļ™āļ•āļ­āļ™āļāļēāļĢāļāđˆāļ­āļŠāļĢāđ‰āļēāļ‡ / āļ•āļīāļ”āļ•āļąāđ‰āļ‡ | -| LCBP3-C2 | QMS | Quality Document (Plan//Work Instruction) | āđ€āļ­āļāļŠāļēāļĢāļ”āđ‰āļēāļ™āļ„āļļāļ“āļ āļēāļž (āđ‚āļĢāļ‡āļ‡āļēāļ™ / āļ‚āđ‰āļ­āđāļ™āļ°āļ™āļģāđƒāļ™āļāļēāļĢāļ—āļģāļ‡āļēāļ™) | -| LCBP3-C2 | INS | Inspection/Audit/Surveillance Report | āļĢāļēāļĒāļ‡āļēāļ™āļāļēāļĢāļ•āļĢāļ§āļˆāļŠāļ­āļš / āļāļēāļĢāļ•āļĢāļ§āļˆāļŠāļ­āļš / āļĢāļēāļĒāļ‡āļēāļ™āļāļēāļĢāđ€āļāđ‰āļēāļĢāļ°āļ§āļąāļ‡ | -| LCBP3-C2 | ITP | Inspection and Test Plan | āđāļœāļ™āļāļēāļĢāļ•āļĢāļ§āļˆāļŠāļ­āļšāđāļĨāļ°āļ—āļ”āļŠāļ­āļš | -| LCBP3-C2 | MAT | Materials/Equipment/Plant | āļ§āļąāļŠāļ”āļļ / āļ­āļļāļ›āļāļĢāļ“āđŒ / āđ‚āļĢāļ‡āļ‡āļēāļ™ | -| LCBP3-C2 | SPE | Specification | āļ‚āđ‰āļ­āļāļģāļŦāļ™āļ” | -| LCBP3-C2 | MAN | Manual | āļ„āļđāđˆāļĄāļ·āļ­ | -| LCBP3-C2 | CER | Certificates | āđƒāļšāļĢāļąāļšāļĢāļ­āļ‡ | -| LCBP3-C2 | SAR | Semi Annual Report | āļĢāļēāļĒāļ‡āļēāļ™āļ›āļĢāļ°āļˆāļģāļŦāļāđ€āļ”āļ·āļ­āļ™ | -| LCBP3-C2 | JSA | Jobs Alalysis | āļĢāļēāļĒāļ‡āļēāļ™āļāļēāļĢāļ§āļīāđ€āļ„āļĢāļēāļ°āļŦāđŒāļ„āļ§āļēāļĄāļ›āļĨāļ­āļ”āļ āļąāļĒ | -| LCBP3-C2 | MOM | Minute of Meeting | āļĢāļēāļĒāļ‡āļēāļ™āļāļēāļĢāļ›āļĢāļ°āļŠāļļāļĄ | -| LCBP3-C2 | MPR | Monthly Progress Report | āļĢāļēāļĒāļ‡āļēāļ™āļ„āļ§āļēāļĄāļ„āļ·āļšāļŦāļ™āđ‰āļēāļ›āļĢāļ°āļˆāļģāđ€āļ”āļ·āļ­āļ™ | -| LCBP3-C2 | ICR | Incident Report | āļĢāļēāļĒāļ‡āļēāļ™āļāļēāļĢāđ€āļāļīāļ”āļ­āļļāļšāļąāļ•āļīāđ€āļŦāļ•āļļāđāļĨāļ°āļāļēāļĢāļšāļēāļ”āđ€āļˆāđ‡āļš | -| LCBP3-C2 | PRG | Progress of Construc | āļ„āļ§āļēāļĄāļ„āļ·āļšāļŦāļ™āđ‰āļēāļ‚āļ­āļ‡āļāļēāļĢāļāđˆāļ­āļŠāļĢāđ‰āļēāļ‡ / āļ āļēāļžāļ–āđˆāļēāļĒ / āļ§āļīāļ”āļĩāđ‚āļ­ | -| LCBP3-C2 | RPT | Report | āļĢāļēāļĒāļ‡āļēāļ™ | -| LCBP3-C2 | TNR | Training report - diff --git a/~$Dis.xlsx b/~$Dis.xlsx deleted file mode 100644 index 09b6ca39a2948d0dd4fbb1e1bc2fe1bb29cb130b..0000000000000000000000000000000000000000 GIT binary patch literal 0 HcmV?d00001 literal 165 zcmWgfODri#%*)JE2uMxLOU_6v%1_NxAP7Vl{1_4$N`NqtA&(&wh!q$D7*fH!WQGhN NUBr+N