np-dms/lcbp3

Fork 0

Files

admin 94b63dc359 251117:2200 rebase .md

2025-11-17 22:09:01 +07:00

49 KiB

Raw Blame History

📋 แผนการพัฒนา Backend (NestJS) - LCBP3-DMS v1.4.1 (ปรับปรุงโดย deepseek)

*ปรับปรุงตาม Requirements v1.4.0 ที่อัปเดตแล้ว Routing และ รูปแบบ JSON details

🎯 ภาพรวมโครงการ

พัฒนา Backend สำหรับระบบบริหารจัดการเอกสารโครงการ (Document Management System) ที่รองรับการจัดการเอกสารที่ซับซ้อน มีระบบ Workflow การอนุมัติ และการควบคุมสิทธิ์แบบ RBAC 4 ระดับ พร้อมมาตรการความปลอดภัยที่ทันสมัย

📐 สถาปัตยกรรมระบบ

Technology Stack

Framework: NestJS (TypeScript, ESM)
Database: MariaDB 10.11
ORM: TypeORM
Authentication: JWT + Passport
Authorization: CASL (RBAC 4-level)
File Upload: Multer + Virus Scanning (ClamAV)
Search: Elasticsearch
Notification: Nodemailer + n8n (Line Integration)
Caching: Redis
Resilience: Circuit Breaker, Retry Patterns
Security: Helmet, CSRF Protection, Rate Limiting
Monitoring: Winston, Health Checks, Metrics
Scheduling: @nestjs/schedule (Cron Jobs)
Documentation: Swagger

โครงสร้างโมดูล (Domain-Driven)

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)
│   ├── guards/               # RBAC Guard, RateLimitGuard
│   ├── interceptors/         # Audit, Transform, Performance
│   ├── resilience/           # Circuit Breaker, Retry Patterns
│   ├── security/             # Input Validation, XSS Protection
│   └── services/             # Notification, Caching, Monitoring
├── 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
│   └── document-numbering/   # Internal Service (Redis Locking)
└── database/                 # Migrations & Seeds

🗓️ แผนการพัฒนาแบบ Phase-Based

Dependency Diagram (ภาพรวม)

  %% Phase 0: Infrastructure
  subgraph Phase 0 [Phase 0: Infrastructure Setup]
      T0_1[T0.1: Setup QNAP Container Station]
      T0_2[T0.2: Initialize NestJS Project]
      T0_3[T0.3: Setup Database Connection]
      T0_4[T0.4: Setup Git Repository]
  end

  %% Phase 1: Core Foundation
  subgraph Phase 1 [Phase 1: Core Foundation & Security]
      T1_1[T1.1: CommonModule - Base Infrastructure]
      T1_2[T1.2: AuthModule - JWT Authentication]
      T1_3[T1.3: UserModule - User Management]
      T1_4[T1.4: RBAC Guard - 4-Level Authorization]
      T1_5[T1.5: ProjectModule - Base Structures]
  end

  %% Phase 2: Security & File Management
  subgraph Phase 2 [Phase 2: Security & File Management]
      T2_1[T2.1: MasterModule - Master Data Management]
      T2_2[T2.2: FileStorageService - Secure File Management]
      T2_3[T2.3: DocumentNumberingModule - App-Level Locking]
      T2_4[T2.4: SecurityModule - Enhanced Security]
      T2_5[T2.5: JSON Details & Schema Management]
  end

  %% Phase 3: Correspondence & RFA Core
  subgraph Phase 3 [Phase 3: Correspondence & RFA Core]
      T3_1[T3.1: CorrespondenceModule - Basic CRUD]
      T3_2[T3.2: CorrespondenceModule - Advanced Features]
      T3_3[T3.3: RfaModule - Basic CRUD]
      T3_4[T3.4: Correspondence Routing]
  end

  %% Phase 4: Drawing Management
  subgraph Phase 4 [Phase 4: Drawing Management]
      T4_1[T4.1: DrawingModule - Contract Drawings]
      T4_2[T4.2: DrawingModule - Shop Drawings]
  end

  %% Phase 5: Workflow Systems & Resilience
  subgraph Phase 5 [Phase 5: Workflow Systems & Resilience]
      T5_1[T5.1: RfaModule - Workflow Implementation]
      T5_2[T5.2: CirculationModule - Internal Routing]
      T5_3[T5.3: TransmittalModule - Document Forwarding]
  end

  %% Phase 6: Advanced Features & Monitoring
  subgraph Phase 6 [Phase 6: Advanced Features & Monitoring]
      T6_1[T6.1: SearchModule - Elasticsearch Integration]
      T6_2[T6.2: NotificationModule - Email & Line]
      T6_3[T6.3: MonitoringModule - Observability]
      T6_4[T6.4: ResilienceModule - Circuit Breaker & Retry]
  end

  %% Phase 7: Testing & Optimization
  subgraph Phase 7 [Phase 7: Testing & Optimization]
      T7_1[T7.1: Unit Testing]
      T7_2[T7.2: Integration Testing]
      T7_3[T7.3: E2E Testing]
      T7_4[T7.4: Performance Testing]
      T7_5[T7.5: Security Testing]
      T7_6[T7.6: Performance Optimization]
  end

  %% Phase 8: Documentation & Deployment
  subgraph Phase 8 [Phase 8: Documentation & Deployment]
      T8_1[T8.1: API Documentation]
      T8_2[T8.2: Technical Documentation]
      T8_3[T8.3: Security Hardening]
      T8_4[T8.4: Deployment Preparation]
      T8_5[T8.5: Production Deployment]
      T8_6[T8.6: Handover to Frontend Team]
  end

  %% Dependencies
  T0_1 --> T0_2
  T0_2 --> T0_3
  T0_3 --> T0_4

  T0_2 --> T1_1
  T0_3 --> T1_1
  T1_1 --> T1_2
  T1_1 --> T1_3
  T1_1 --> T1_4
  T1_1 --> T1_5
  T1_2 --> T1_3
  T1_3 --> T1_4

  T0_3 --> T2_1
  T1_1 --> T2_1
  T1_5 --> T2_1
  T1_1 --> T2_2
  T1_4 --> T2_2
  T1_1 --> T2_3
  T1_1 --> T2_4
  T1_1 --> T2_5

  T1_1 --> T3_1
  T1_2 --> T3_1
  T1_3 --> T3_1
  T1_4 --> T3_1
  T1_5 --> T3_1
  T2_3 --> T3_1
  T2_2 --> T3_1
  T2_5 --> T3_1
  T3_1 --> T3_2
  T3_1 --> T3_3
  T1_5 --> T3_3
  T3_1 --> T3_4
  T2_5 --> T3_4

  T1_1 --> T4_1
  T1_2 --> T4_1
  T1_4 --> T4_1
  T1_5 --> T4_1
  T2_2 --> T4_1
  T4_1 --> T4_2

  T3_3 --> T5_1
  T4_2 --> T5_1
  T2_5 --> T5_1
  T3_1 --> T5_2
  T2_5 --> T5_2
  T3_1 --> T5_3

  T3_1 --> T6_1
  T3_3 --> T6_1
  T4_2 --> T6_1
  T5_2 --> T6_1
  T5_3 --> T6_1
  T1_1 --> T6_2
  T6_4 --> T6_2
  T1_1 --> T6_3
  T1_1 --> T6_4

  %% All development phases must be complete before testing
  T1_5 --> T7_1
  T2_5 --> T7_1
  T3_4 --> T7_1
  T4_2 --> T7_1
  T5_3 --> T7_1
  T6_4 --> T7_1
  T7_1 --> T7_2
  T7_2 --> T7_3
  T7_3 --> T7_4
  T7_4 --> T7_5
  T7_5 --> T7_6

  %% Testing must be complete before deployment
  T7_6 --> T8_1
  T8_1 --> T8_2
  T8_2 --> T8_3
  T8_3 --> T8_4
  T8_4 --> T8_5
  T8_5 --> T8_6

Phase 0: Infrastructure Setup (สัปดาห์ที่ 1)

Milestone: สร้างโครงสร้างพื้นฐานและเชื่อมต่อ Services พร้อม Security Baseline

Phase 0: Tasks

[✅] T0.1 Setup QNAP Container Station
- สร้าง Docker Network: lcbp3
- Setup docker-compose.yml สำหรับ:
  - MariaDB (db.np-dms.work)
  - PHPMyAdmin (pma.np-dms.work)
  - Redis (cache.np-dms.work)
  - Elasticsearch (search.np-dms.work)
  - Backend (backend.np-dms.work)
  - Nginx Proxy Manager (npm.np-dms.work)
- กำหนด Environment Variables ใน docker-compose.yml (ไม่ใช้ .env)
- Security: Setup network segmentation และ firewall rules
- Deliverable: Services ทั้งหมดรันได้และเชื่อมต่อกันผ่าน Network
- Dependencies: None (Task เริ่มต้น)

[✅] T0.2 Initialize NestJS Project

สร้างโปรเจกต์ใหม่ด้วย Nest CLI
ติดตั้ง Dependencies:

# Core
npm install @nestjs/core @nestjs/common @nestjs/platform-express
npm install @nestjs/typeorm typeorm mysql2
npm install @nestjs/config class-validator class-transformer

# Auth & Security
npm install @nestjs/jwt @nestjs/passport passport passport-jwt
npm install casl helmet csurf rate-limiter-flexible bcrypt crypto

# File & Search
npm install multer @nestjs/elasticsearch @elastic/elasticsearch
npm install clamscan @types/multer

# Resilience & Caching
npm install @nestjs/cache-manager cache-manager cache-manager-redis-store
npm install @nestjs/circuit-breaker

# Monitoring & Scheduling
npm install @nestjs/schedule @nestjs/monitoring winston

# Documentation
npm install @nestjs/swagger

# Development
npm install --save-dev @nestjs/testing jest @types/jest supertest
npm install --save-dev @types/passport-jwt @types/bcrypt @types/crypto

Setup โครงสร้างโฟลเดอร์ตาม Domain-Driven Architecture
Security: Initialize security headers และ CORS configuration
Deliverable: Project Structure พร้อม, แสดง Swagger ที่ /api
Dependencies: T0.1 (ต้องมี Docker Network และ Environment พร้อมก่อนสร้าง Project)

[✅] T0.3 Setup Database Connection
- Import SQL Schema v1.4.0 เข้า MariaDB
- Run Seed Data (organizations, users, roles, permissions)
- Configure TypeORM ใน AppModule
- Security: Setup database connection encryption
- ทดสอบ Connection
- Deliverable: Database พร้อมใช้งาน, มี Seed Data
- Dependencies: T0.1 (ต้องมี MariaDB Container รันแล้ว), T0.2 (ต้องมี NestJS Project พร้อมสำหรับตั้งค่า TypeORM)
[✅] 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.2 (ต้องมี Project และโครงสร้างพื้นฐานก่อนจะ Commit)

Phase 1: Core Foundation & Security (สัปดาห์ที่ 2-3)

Milestone: ระบบ Authentication, Authorization, Security Baseline และ Base Entities

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
- สร้าง RequestContextService - สำหรับเก็บข้อมูลระหว่าง Request
- สร้าง ConfigService - Centralized configuration management
- สร้าง CryptoService - สำหรับ encryption/decryption
- Security: Implement input validation pipeline
- Deliverable: Common Services พร้อมใช้
- Dependencies: T0.2, T0.3 (ต้องมี Project และ Database Connection พร้อมสำหรับสร้าง Base Entity และ Services)
[ ] 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 (ต้องใช้ Base Entity, ConfigService, CryptoService), T0.3 (ต้องเชื่อมต่อกับ User table)
[ ] T1.3 UserModule - User Management
- สร้าง Entities: User, Role, Permission, UserRole, UserAssignment
- สร้าง UserService CRUD (พร้อม soft delete)
- สร้าง RoleService CRUD
- สร้าง PermissionService (Read-Only, จาก Seed)
- สร้าง UserAssignmentService - สำหรับจัดการ user assignments ตาม scope
- สร้าง 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 ได้
- Dependencies: T1.1 (Base Entity, Global Exception Filter), T1.2 (สำหรับ Authentication และ Authorization)
[ ] 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 (Decorators, RequestContextService), T1.3 (ต้องมีโครงสร้าง User, Role, Permission ที่สมบูรณ์)
[ ] 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 (Base Entity, Security), T1.2 (สำหรับการป้องกันการเข้าถึง), T0.3 (ต้องเชื่อมต่อกับ project/organization tables)

Phase 2: Security & File Management (สัปดาห์ที่ 4)

Milestone: Master Data, ระบบจัดการไฟล์ที่มีความปลอดภัย, Document Numbering, JSON details system พร้อมใช้งาน พร้อม validation และ security

Phase 2: Tasks

[ ] T2.1 MasterModule - Master Data Management
- สร้าง Entities:
  - CorrespondenceType
  - CorrespondenceStatus
  - RfaType
  - RfaStatusCode
  - RfaApproveCode
  - CirculationStatusCode
  - Tag
- สร้าง Services & Controllers (CRUD):
  - GET /master/correspondence-types
  - POST /master/tags → Create Tag
  - GET /master/tags → List Tags (Autocomplete)
- Security: Implement admin-only access สำหรับ master data
- Deliverable: Admin จัดการ Master Data ได้
- Dependencies: T0.3 (ต้องเชื่อมต่อกับ master tables), T1.1 (Security patterns), T1.5 (Project context สำหรับ master data บางอย่าง)
[ ] T2.2 FileStorageService - Secure File Management
- สร้าง Attachment Entity
- สร้าง FileStorageService:
  - uploadFile(file: Express.Multer.File, userId: number)` → Attachment
    - Virus scanning ด้วย ClamAV
    - File type validation (white-list: PDF, DWG, DOCX, XLSX, PPTX, ZIP)
    - File size check (max 50MB)
    - Generate checksum (SHA-256)
  - getFilePath(attachmentId)` → string
  - deleteFile(attachmentId)` → boolean
- จัดเก็บไฟล์ใน /share/dms-data/uploads/{YYYY}/{MM}/
- สร้าง Controller:
  - POST /files/upload → { attachment_id, url } (Protected)
  - GET /files/:id/download → File Stream (Protected + Expiration)
- Security: Access Control - ตรวจสอบสิทธิ์ผ่าน Junction Table
- Deliverable: อัปโหลด/ดาวน์โหลดไฟล์ได้อย่างปลอดภัย
- Dependencies: T1.1 (Base Entity สำหรับ Attachment, CryptoService สำหรับ checksum), T1.4 (RBAC Guard สำหรับการควบคุมการเข้าถึงไฟล์)
[ ] T2.3 DocumentNumberingModule - Application-Level Locking
- สร้าง Entities:
  - DocumentNumberFormat
  - DocumentNumberCounter
- สร้าง DocumentNumberingService:
  - generateNextNumber(projectId, orgId, typeId, year) → string
  - ใช้ Redis distributed locking แทน stored procedure
  - Retry mechanism ด้วย exponential backoff
  - Fallback mechanism เมื่อการขอเลขล้มเหลว
  - Format ตาม Template: {ORG_CODE}-{TYPE_CODE}-{YEAR_SHORT}-{SEQ:4}
- ไม่มี Controller (Internal Service เท่านั้น)
- Security: Implement audit log ทุกครั้งที่มีการ generate เลขที่
- Deliverable: Service สร้างเลขที่เอกสารได้ถูกต้องและปลอดภัย
- Dependencies: T1.1 (Base patterns, Audit Log), T0.3 (ต้องเชื่อมต่อกับ document_number_formats/counters)
[ ] 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 (Input Validation Pipeline)

Phase 2.5: JSON Details & Schema Management (สัปดาห์ที่ 4)

Dependencies: T1.1 (Validation patterns, Security)
[ ] T2.5.1 JsonSchemaModule - Schema Management
- สร้าง JsonSchemaService:
  - validate(schemaId: string, data: any): ValidationResult
  - getSchema(schemaId: string, version?: string): object
  - registerSchema(schemaId: string, schema: object): void
  - migrateData(data: any, fromVersion: string, toVersion: string): any
- สร้าง predefined schemas สำหรับ:
  - Correspondence types (RFI, RFA, TRANSMITTAL, etc.)
  - Routing types (TEMPLATE, INSTANCE, ACTION)
  - Audit types (AUDIT_LOG, SECURITY_SCAN)
- Implement schema versioning และ compatibility
- Deliverable: JSON schema system ทำงานได้
[ ] T2.5.2 DetailsService - Data Processing
- สร้าง DetailsService:
  - processDetails(type: string, input: any): ProcessedDetails
  - sanitize(input: any): any (XSS prevention, SQL injection protection)
  - compress(data: any): string (JSON compression)
  - decompress(compressed: string): any
- Implement data transformation pipelines:
  - Input validation และ sanitization
  - Data normalization
  - Default value population
- Deliverable: Data processing service ทำงานได้
[ ] T2.5.3 JSON Security & Validation
- สร้าง SecurityService สำหรับ JSON:
  - sanitizeJson(input: any): any (Remove dangerous properties)
  - validateSize(data: any): boolean (Max 50KB check)
  - encryptSensitiveFields(data: any): any
- Implement validation rules:
  - Type validation
  - Format validation (email, date, URL)
  - Custom validation rules
- Deliverable: JSON security measures ทำงานได้
T2.5.4 Integration with Existing Modules
- Integrate กับ CorrespondenceModule:
  - Auto-validate details ก่อน save
  - Auto-populate default values
  - Handle version migration
- Integrate กับ RoutingModule:
  - Validate routing configuration details
  - Process step action details
- Integrate กับ AuditModule:
  - Validate audit log details
  - Compress large audit data
- Deliverable: JSON details integrated กับทุก modules

Phase 3: Correspondence & RFA Core (สัปดาห์ที่ 5-6)

Milestone: ระบบเอกสารโต้ตอบและ RFA พร้อม Security และ Audit, ระบบส่งต่อเอกสารระหว่างองค์กรทำงานได้

Phase 3A: Tasks (สัปดาห์ที่ 5)

[ ] T3.1 CorrespondenceModule - Basic CRUD
- สร้าง Entities:
  - Correspondence
  - CorrespondenceRevision
  - CorrespondenceRecipient
  - CorrespondenceTag
  - CorrespondenceReference
  - CorrespondenceAttachment
- สร้าง CorrespondenceService:
  - create(dto) → Correspondence
    - สร้าง Correspondence + Revision แรก (rev 0)
    - เรียก DocumentNumberingService (Redis locking)
    - สร้าง Recipients (TO/CC)
    - สร้าง Tags
    - สร้าง Attachments (ผ่าน FileStorageService)
  - update(id, dto) → Correspondence
    - สร้าง Revision ใหม่
    - Update is_current flag
  - findAll(filters) → Paginated List
  - findById(id) → Correspondence with Current Revision
- สร้าง Controllers:
  - POST /correspondences → Create
  - GET /correspondences → List (Filter by type, status, org)
  - GET /correspondences/:id → Detail
  - PUT /correspondences/:id → Update (Create new revision)
  - DELETE /correspondences/:id → Soft Delete (Admin only)
- Security: Implement permission checks สำหรับ document access
- Deliverable: สร้าง/แก้ไข/ดูเอกสารได้
- Dependencies: T1.1 (Base Entity, Audit, Transform), T1.2 (Authentication), T1.3 (User context), T1.4 (RBAC), T1.5 (Project/Organization context), T2.3 (DocumentNumberingService), T2.2 (FileStorageService), T2.5 (JSON Details Validation)
[ ] T3.2 CorrespondenceModule - Advanced Features
- Implement Status Transitions:
  - DRAFT → SUBMITTED (Document Control)
  - SUBMITTED → CLOSED (Admin)
  - SUBMITTED → CANCELLED (Admin + Reason)
- Implement References:
  - POST /correspondences/:id/references → Link Documents
- Implement Search (Basic):
  - GET /correspondences/search?q=...
- Security: Implement state transition validation
- Deliverable: Workflow พื้นฐานทำงานได้
- Dependencies: T3.1 (ต้องมี Basic CRUD ก่อน)
[ ] T3.3 RfaModule - Basic CRUD
- สร้าง Entities:
  - Rfa
  - RfaRevision
  - RfaItem (Junction to Shop Drawings)
- สร้าง RfaService:
  - create(dto) → Rfa
    - สร้าง Correspondence + Rfa + RfaRevision
    - เชื่อม Shop Drawing Revisions (สำหรับ RFA_DWG)
  - findAll(filters) → Paginated List
  - findById(id) → Rfa with Items
- สร้าง Controllers:
  - POST /rfas → Create
  - GET /rfas → List
  - GET /rfas/:id → Detail
- Security: Implement permission checks สำหรับ RFA operations
- Deliverable: สร้าง RFA และเชื่อม Shop Drawings ได้
- Dependencies: T3.1 (RFA คือ Correspondence ประเภทหนึ่ง), T1.5 (Project context), T4.2 (สำหรับการเชื่อมโยงกับ Shop Drawings)

Phase 3B: Correspondence Routing (สัปดาห์ที่ 6)

Dependencies: T3.1 (ต้องมี Correspondence ก่อนจะส่งต่อได้), T2.5 (สำหรับ JSON Details ของ Routing)
[ ] T3.4.1 CorrespondenceRoutingModule - Template Management
- สร้าง Entities:
  - CorrespondenceRoutingTemplate
  - CorrespondenceRoutingTemplateStep
- สร้าง Services:
  - createTemplate(dto) → Create routing template
  - addStep(templateId, stepDto) → Add step to template
  - getTemplates(projectId) → List available templates
- สร้าง Controllers:
  - POST /routing/templates → Create template (Admin only)
  - GET /routing/templates → List templates
  - POST /routing/templates/:id/steps → Add step
[ ] T3.4.2 CorrespondenceRoutingModule - Routing Execution
- สร้าง Entity: CorrespondenceRouting
- สร้าง RoutingService:
  - initiateRouting(correspondenceId, templateId) → void
    - สร้าง routing instances ตาม template steps
    - คำนวณ due dates จาก expected_days
    - ส่ง notifications ไปยังองค์กรแรก
  - processStep(routingId, action, comments) → void
    - อัพเดทสถานะขั้นตอนปัจจุบัน
    - ส่ง notification ไปยังขั้นตอนต่อไป
    - อัพเดท due dates สำหรับขั้นตอนต่อไป
- สร้าง Controllers:
  - POST /correspondences/:id/routing/start → Start routing
  - POST /routing/:id/process → Process routing step
  - GET /correspondences/:id/routing → Get routing status
  - ตัวอย่าง Implementation Details
[ ] T3.4.3 WorkflowEngineModule - State Management
- สร้าง WorkflowEngineService:
  - validateTransition(currentStatus, targetStatus) → boolean
  - getAllowedTransitions(status) → string[]
  - autoAdvanceStatus(correspondenceId) → void
- สร้าง DeadlineService:
  - checkDeadlines() → void (Cron job)
  - sendReminder(routingId) → void
  - escalateOverdue(routingId) → void
[ ] T3.4.4 Routing UI Integration
- สร้าง API endpoints สำหรับ frontend:
  - GET /routing/available-templates → Templates for current project
    - GET /routing/my-pending → Pending routing steps for current user
- POST /routing/bulk-action → Process multiple routing steps
- Security: Implement permission checks สำหรับ routing operations
- Deliverable: ระบบส่งต่อเอกสารทำงานได้สมบูรณ์

Phase 4: Drawing Management (สัปดาห์ที่ 7)

Milestone: ระบบจัดการแบบพร้อม File Security

Phase 4: Tasks

[ ] T4.1 DrawingModule - Contract Drawings
- สร้าง Entities:
  - ContractDrawing
  - ContractDrawingVolume
  - ContractDrawingCat
  - ContractDrawingSubCat
  - ContractDrawingSubcatCatMap
  - ContractDrawingAttachment
- สร้าง ContractDrawingService CRUD
- สร้าง Controllers:
  - GET /drawings/contract → List
  - POST /drawings/contract → Create (Admin)
  - GET /drawings/contract/:id → Detail
- Security: Implement access control สำหรับ contract drawings
- Deliverable: จัดการ Contract Drawings ได้
- Dependencies: T1.1 (Base Entity, Security), T1.2 (Authentication), T1.4 (RBAC), T1.5 (Project context), T2.2 (FileStorageService)
[ ] T4.2 DrawingModule - Shop Drawings
- สร้าง Entities:
  - ShopDrawing
  - ShopDrawingRevision
  - ShopDrawingMainCategory
  - ShopDrawingSubCategory
  - ShopDrawingRevisionContractRef
  - ShopDrawingRevisionAttachment
- สร้าง ShopDrawingService CRUD
- สร้าง Controllers:
  - GET /drawings/shop → List
  - POST /drawings/shop → Create
  - POST /drawings/shop/:id/revisions → Create Revision
  - GET /drawings/shop/:id → Detail with Revisions
- Link Shop Drawing Revision → Contract Drawings
- Security: Implement virus scanning สำหรับ drawing files
- Deliverable: จัดการ Shop Drawings และ Revisions ได้
- ependencies: T4.1 (Shop Drawings อ้างอิงถึง Contract Drawings)

Phase 5: Workflow Systems & Resilience (สัปดาห์ที่ 8-9)

Milestone: ระบบ Workflow ทั้งหมดพร้อม Resilience Patterns

Phase 5: Tasks

[ ] T5.1 RfaModule - Workflow Implementation
- สร้าง Entities:
  - RfaWorkflowTemplate
  - RfaWorkflowTemplateStep
  - RfaWorkflow (Transaction Log)
- สร้าง RfaWorkflowService:
  - initiateWorkflow(rfaId, templateId) → void
    - สร้าง RfaWorkflow records ตาม Template
    - กำหนด Step 1 เป็น PENDING
  - completeStep(rfaId, stepNumber, action, comments) → void
    - Update Status → COMPLETED
    - Set Next Step → PENDING
    - Send Notifications
  - rejectStep(rfaId, stepNumber, reason) → void
    - Update Status → REJECTED
    - Send back to Originator
- สร้าง Controllers:
  - POST /rfas/:id/workflow/start → Start Workflow
  - POST /rfas/:id/workflow/steps/:stepNumber/complete → Complete Step
  - GET /rfas/:id/workflow → Get Workflow Status
- Resilience: Implement circuit breaker สำหรับ notification services
- Deliverable: RFA Workflow ทำงานได้
- Dependencies: T3.3 (ต้องมี RFA Basic CRUD ก่อน), T4.2 (RFA_DWG ต้องเชื่อมโยงกับ Shop Drawings), T2.5 (JSON Details สำหรับ Workflow), T6.2 (NotificationService สำหรับแจ้งเตือน)
[ ] T5.2 CirculationModule - Internal Routing
- สร้าง Entities:
  - Circulation
  - CirculationTemplate
  - CirculationTemplateAssignee
  - CirculationRouting (Transaction Log)
  - CirculationAttachment
- สร้าง CirculationService:
  - create(correspondenceId, dto) → Circulation
    - สร้าง Circulation (1:1 กับ Correspondence)
    - สร้าง Routing ตาม Template
  - assignUser(circulationId, stepNumber, userId) → void
  - completeStep(circulationId, stepNumber, comments) → void
  - close(circulationId) → void (เมื่อตอบกลับองค์กรผู้ส่งแล้ว)
- สร้าง Controllers:
  - POST /circulations → Create
  - GET /circulations/:id → Detail
  - POST /circulations/:id/steps/:stepNumber/complete → Complete
  - POST /circulations/:id/close → Close
- Resilience: Implement retry mechanism สำหรับ assignment notifications
- Deliverable: ใบเวียนภายในองค์กรทำงานได้
- Dependencies: T3.1 (Circulation คือ Correspondence ประเภทหนึ่ง), T2.5 (JSON Details), T6.2 (NotificationService)
[ ] T5.3 TransmittalModule - Document Forwarding
- สร้าง Entities:
  - Transmittal
  - TransmittalItem
- สร้าง TransmittalService:
  - create(dto) → Transmittal
    - สร้าง Correspondence + Transmittal
    - เชื่อม Multiple Correspondences เป็น Items
- สร้าง Controllers:
  - POST /transmittals → Create
  - GET /transmittals → List
  - GET /transmittals/:id → Detail with Items
- Security: Implement access control สำหรับ transmittal items
- Deliverable: สร้าง Transmittal ได้
- Dependencies: T3.1 (Transmittal คือ Correspondence ประเภทหนึ่ง)

Phase 6: Advanced Features & Monitoring (สัปดาห์ที่ 10-11)

Milestone: ฟีเจอร์ขั้นสูงพร้อม Monitoring และ Observability

Phase 6: Tasks

[ ] T6.1 SearchModule - Elasticsearch Integration
- Setup Elasticsearch Container ใน docker-compose.yml
- สร้าง SearchService:
  - indexDocument(entity) → void
  - updateDocument(entity) → void
  - deleteDocument(entity) → void
  - search(query, filters) → SearchResult[]
- Index ทุกครั้งที่ Create/Update:
  - Correspondence
  - RFA
  - Shop Drawing
  - Contract Drawing
  - Circulation
  - Transmittal
- สร้าง Controllers:
  - GET /search?q=...&type=...&from=...&to=... → Results
- Resilience: Implement circuit breaker สำหรับ Elasticsearch
- Deliverable: ค้นหาขั้นสูงทำงานได้
- Dependencies: T3.1, T3.3, T4.2, T5.2, T5.3 (ต้องมีข้อมูลจาก Modules หลักเหล่านี้ให้ทำการ Index)
[ ] T6.2 NotificationModule - Email & Line
- สร้าง NotificationService:
  - sendEmail(to, subject, body) → void (Nodemailer)
  - sendLine(userId, message) → void (ผ่าน n8n Webhook)
  - createSystemNotification(userId, message, entityType, entityId) → void
- Integrate กับ Workflow Events:
  - เมื่อสร้าง Correspondence ใหม่ → แจ้ง Recipients
  - เมื่อสร้าง Circulation → แจ้ง Assignees
  - เมื่อ RFA Workflow ถึง Step → แจ้ง Responsible Org
  - เมื่อใกล้ถึง Deadline → แจ้ง (Optional)
- สร้าง Controllers:
  - GET /notifications → List User's Notifications
  - PUT /notifications/:id/read → Mark as Read
- Resilience: Implement retry mechanism ด้วย exponential backoff
- Deliverable: ระบบแจ้งเตือนทำงานได้
- Dependencies: T1.1 (ConfigService สำหรับ Email credentials), T6.4 (Resilience patterns สำหรับการส่งภายนอก)
[ ] T6.3 MonitoringModule - Observability
- สร้าง Health Check Controller:
  - GET /health → Database, Redis, Elasticsearch status
- สร้าง Metrics Service:
  - API response times
  - Error rates
  - Cache hit ratios
  - Business metrics (documents created, workflow completion)
- สร้าง Performance Interceptor:
  - Track request duration
  - Alert if response time > 200ms
- สร้าง Logging Service:
  - Structured logging (JSON format)
  - Log aggregation
- Deliverable: Monitoring system ทำงานได้
- Dependencies: T1.1 (Base patterns)
[ ] T6.4 ResilienceModule - Circuit Breaker & Retry
- สร้าง Circuit Breaker Service:
  - @CircuitBreaker() decorator สำหรับ external calls
  - Configurable timeout และ error thresholds
- สร้าง Retry Service:
  - @Retry() decorator ด้วย exponential backoff
- สร้าง Fallback Strategies:
  - Graceful degradation สำหรับ non-critical features
- Implement สำหรับ:
  - Email notifications
  - LINE notifications
  - Elasticsearch queries
  - File virus scanning
- Deliverable: Resilience patterns ทำงานได้
- Dependencies: T1.1 (Base patterns)

Phase 7: Testing & Optimization (สัปดาห์ที่ 12-13)

Milestone: ทดสอบและปรับปรุงประสิทธิภาพพร้อม Security Audit

Phase 7: Tasks

[ ] T7.1 Unit Testing
- เขียน Unit Tests สำหรับ Services สำคัญ:
  - AuthService (login, validateUser)
  - RbacGuard (permission checks ทั้ง 4 ระดับ)
  - DocumentNumberingService (Redis locking)
  - FileStorageService (virus scanning, validation)
  - CorrespondenceService (create, update, status transitions)
  - RfaWorkflowService (workflow logic)
- Security: ทดสอบ security scenarios (SQL injection, XSS attempts)
- Target: 80% Code Coverage
- Deliverable: Unit Tests ผ่านทั้งหมด
- Dependencies: ทุก Development Tasks ใน Phase 1-6 ต้องเสร็จสิ้นก่อนเริ่มเขียน Tests อย่างจริงจัง (โดยเฉพาะ T1.4, T2.3, T3.1, T5.1)
[ ] T7.2 Integration Testing
- เขียน Integration Tests:
  - Authentication Flow (login → access protected route)
  - Document Creation Flow (create correspondence → attach files → virus scan)
  - RFA Workflow Flow (start → step 1 → step 2 → complete)
  - Circulation Flow (create → assign → complete → close)
  - ทดสอบ SQL Views (v_user_all_permissions, v_user_tasks)
- ใช้ Test Database แยกต่างหาก
- Security: ทดสอบ rate limiting และ permission enforcement
- Deliverable: Integration Tests ผ่าน
- Dependencies: T7.1 (Unit Tests ควรผ่านก่อน)
[ ] T7.3 E2E Testing
- เขียน E2E Tests:
  - User Registration & Login
  - Create Correspondence (Full Flow)
  - Create RFA with Shop Drawings
  - Complete RFA Workflow
  - Search Documents
- Security: ทดสอบ file upload security
- Deliverable: E2E Tests ผ่าน
- Dependencies: T7.2 (Integration Tests ควรผ่านก่อน)
[ ] T7.4 Performance Testing
- Load Testing:
  - 100 concurrent users
  - API response time < 200ms (90th percentile)
  - Search performance < 500ms
- Stress Testing:
  - Find breaking points
  - Database connection limits
- Endurance Testing:
  - 24-hour continuous operation
- Deliverable: Performance targets บรรลุ
- Dependencies: T7.3 (E2E Tests ควรผ่านก่อน)
[ ] T7.5 Security Testing
- Penetration Testing:
  - OWASP Top 10 vulnerabilities
  - SQL Injection attempts
  - XSS attempts
  - CSRF attempts
- Security Audit:
  - Code review สำหรับ security flaws
  - Dependency vulnerability scanning
- File Upload Security Testing:
  - Virus scanning effectiveness
  - File type bypass attempts
- Deliverable: Security tests ผ่าน
- Dependencies: T7.4 (Performance Tests ควรผ่านก่อน)
[ ] T7.6 Performance Optimization
- Implement Caching:
  - Cache Master Data (Roles, Permissions, Organizations)
  - Cache User Permissions
  - Cache Search Results
- Database Optimization:
  - Review Indexes
  - Optimize Queries (N+1 Problem)
  - Implement Pagination ทุก List Endpoint
- Deliverable: Response Time < 200ms (90th percentile)
- Dependencies: T7.4 (ผลจาก Performance Testing จะบอกว่าจุดไหนต้อง Optimization)

Phase 8: Documentation & Deployment (สัปดาห์ที่ 14)

Milestone: เอกสารและ Deploy สู่ Production พร้อม Security Hardening

Phase 8: Tasks

[ ] T8.1 API Documentation
- ครบทุก Endpoint ใน Swagger:
  - ใส่ Description, Example Request/Response
  - ระบุ Required Permissions
  - ใส่ Error Responses
- Export Swagger JSON → Frontend Team
- Security: เอกสารต้องไม่เปิดเผย sensitive information
- Deliverable: Swagger Docs สมบูรณ์
- Dependencies: ทุก Development Tasks ต้องเสร็จสิ้น
[ ] T8.2 Technical Documentation
- เขียนเอกสาร:
  - Architecture Overview
  - Module Structure
  - Database Schema Diagram
  - API Design Patterns
  - Security Implementation Guide
  - Deployment Guide
  - Disaster Recovery Procedures
- Deliverable: Technical Docs พร้อม
- Dependencies: T8.1
[ ] T8.3 Security Hardening
- Final Security Review:
  - Environment variables security
  - Database encryption
  - File storage security
  - API security headers
- Implement Security Monitoring:
  - Failed login attempts tracking
  - Suspicious activity alerts
  - Rate limiting monitoring
- Deliverable: Security checklist ผ่าน
- Dependencies: T7.5 (Security Testing ต้องผ่าน)
[ ] T8.4 Deployment Preparation
- สร้าง Production docker-compose.yml
- Setup Environment Variables ใน QNAP
- Setup Nginx Proxy Manager (SSL Certificate)
- Setup Backup Scripts (Database + Files)
- Setup Monitoring และ Alerting
- Deliverable: Deployment Guide พร้อม
- Dependencies: T8.2, T8.3
[ ] T8.5 Production Deployment
- Deploy Backend ไปยัง backend.np-dms.work
- ทดสอบ API ผ่าน Postman
- Monitor Logs (Winston)
- Setup Health Check Endpoint (GET /health)
- Verify Security Measures:
  - HTTPS enforcement
  - Security headers
  - Rate limiting
  - Virus scanning
- Deliverable: Backend รันบน Production
- Dependencies: T8.4
[ ] T8.6 Handover to Frontend Team
- Demo API ให้ Frontend Team
- ส่งมอบ Swagger Documentation
- ส่งมอบ Postman Collection
- Workshop: วิธีใช้ Authentication & RBAC
- Deliverable: Frontend เริ่มพัฒนาได้
- Dependencies: T8.5

📊 สรุป Timeline

Phase	ระยะเวลา	จำนวนงาน	Output หลัก
Phase 0	1 สัปดาห์	4	Infrastructure Ready + Security Base
Phase 1	2 สัปดาห์	5	Auth & User Management + RBAC
Phase 2	1 สัปดาห์	4	Security & File Management
Phase 3	2 สัปดาห์	3	Correspondence & RFA Core
Phase 4	1 สัปดาห์	2	Drawing Management
Phase 5	2 สัปดาห์	3	Workflow Systems + Resilience
Phase 6	2 สัปดาห์	4	Advanced Features + Monitoring
Phase 7	2 สัปดาห์	6	Testing & Optimization
Phase 8	1 สัปดาห์	6	Documentation & Deploy
รวม	14 สัปดาห์	37 Tasks	Production-Ready Backend

🎯 Critical Success Factors

Security First: ทุก Task ต้องพิจารณาด้านความปลอดภัยเป็นหลัก
Database Integrity: ใช้ Schema v1.4.1 เป็นหลัก ไม่แก้ไข Schema โดยไม่จำเป็น
Soft Delete: Service ทั้งหมดต้องใช้ Global Filter กรอง WHERE deleted_at IS NULL
API Contract: ทุก Endpoint ต้องมี Swagger Documentation สมบูรณ์
Security Compliance: RBAC ต้องทำงานถูกต้อง 100% ก่อน Deploy
Testing Coverage: Code Coverage อย่างน้อย 80% ก่อน Production
Performance Targets: Response Time < 200ms (90th percentile)
Resilience: ระบบต้องทนทานต่อ failures ของ external services
Monitoring: ต้องมี comprehensive monitoring และ alerting
Documentation: เอกสารต้องครบถ้วนเพื่อ Handover ให้ Frontend Team

🚀 ขั้นตอนถัดไป

Approve แผนนี้ → ปรับแต่งตาม Feedback
Setup Phase 0 → เริ่มสร้าง Infrastructure
Daily Standup → รายงานความก้าวหน้าทุกวัน
Weekly Review → ทบทวนความก้าวหน้าทุกสัปดาห์
Security Review → ทุก Phase ต้องผ่าน security review
Deploy to Production → Week 14

📋 Security Checklist ทุก Phase

Phase 1-2: Foundation Security
- Input validation implemented
- XSS protection enabled
- CSRF protection implemented
- Rate limiting configured
- Secure password hashing (bcrypt)
Phase 3-5: Application Security
- RBAC 4-level working correctly
- File upload security (virus scanning, type validation)
- Audit logging for critical operations
- SQL injection prevention
Phase 6-8: Production Security
- HTTPS enforcement
- Security headers configured
- Environment variables secured
- Monitoring and alerting active
- Backup and recovery tested

หมายเหตุ: แผนนี้สามารถปรับแต่งได้ตามความต้องการและข้อจำกัดของทีม หาก Phase ใดใช้เวลามากกว่าที่คาดการณ์ ควรปรับ Timeline ให้เหมาะสม โดยให้ความสำคัญกับ Security และ Quality

49 KiB Raw Blame History