// File: src/app.module.ts // บันทึกการแก้ไข: เพิ่ม CacheModule (Redis), Config สำหรับ Idempotency และ Maintenance Mode (T1.1) // บันทึกการแก้ไข: เพิ่ม MonitoringModule และ WinstonModule (T6.3) import { Module } from '@nestjs/common'; import { APP_GUARD, APP_INTERCEPTOR } from '@nestjs/core'; import { ConfigModule, ConfigService } from '@nestjs/config'; import { TypeOrmModule } from '@nestjs/typeorm'; import { BullModule } from '@nestjs/bullmq'; import { ThrottlerModule, ThrottlerGuard } from '@nestjs/throttler'; import { CacheModule } from '@nestjs/cache-manager'; import { WinstonModule } from 'nest-winston'; // ✅ Import WinstonModule import { redisStore } from 'cache-manager-redis-yet'; import { AppController } from './app.controller'; import { AppService } from './app.service'; import { envValidationSchema } from './common/config/env.validation.js'; import redisConfig from './common/config/redis.config'; import { winstonConfig } from './modules/monitoring/logger/winston.config'; // ✅ Import Config // Entities & Interceptors import { AuditLog } from './common/entities/audit-log.entity'; import { AuditLogInterceptor } from './common/interceptors/audit-log.interceptor'; import { MaintenanceModeGuard } from './common/guards/maintenance-mode.guard'; // import { IdempotencyInterceptor } from './common/interceptors/idempotency.interceptor'; // Modules import { UserModule } from './modules/user/user.module'; import { ProjectModule } from './modules/project/project.module'; import { FileStorageModule } from './common/file-storage/file-storage.module.js'; import { DocumentNumberingModule } from './modules/document-numbering/document-numbering.module'; import { AuthModule } from './common/auth/auth.module.js'; import { JsonSchemaModule } from './modules/json-schema/json-schema.module.js'; import { WorkflowEngineModule } from './modules/workflow-engine/workflow-engine.module'; import { CorrespondenceModule } from './modules/correspondence/correspondence.module'; import { RfaModule } from './modules/rfa/rfa.module'; import { DrawingModule } from './modules/drawing/drawing.module'; import { TransmittalModule } from './modules/transmittal/transmittal.module'; import { CirculationModule } from './modules/circulation/circulation.module'; import { NotificationModule } from './modules/notification/notification.module'; // ✅ Import Monitoring Module import { MonitoringModule } from './modules/monitoring/monitoring.module'; import { ResilienceModule } from './common/resilience/resilience.module'; // ✅ Import // ... imports import { SearchModule } from './modules/search/search.module'; // ✅ Import @Module({ imports: [ // 1. Setup Config Module พร้อม Validation ConfigModule.forRoot({ isGlobal: true, envFilePath: '.env', load: [redisConfig], validationSchema: envValidationSchema, validationOptions: { abortEarly: true, }, }), // 🛡️ Setup Throttler Module (Rate Limiting) ThrottlerModule.forRoot([ { ttl: 60000, // 60 วินาที limit: 100, // ยิงได้สูงสุด 100 ครั้ง }, ]), // 💾 Setup Cache Module (Redis) CacheModule.registerAsync({ isGlobal: true, imports: [ConfigModule], useFactory: async (configService: ConfigService) => ({ store: await redisStore({ socket: { host: configService.get('redis.host'), port: configService.get('redis.port'), }, ttl: configService.get('redis.ttl'), }), }), inject: [ConfigService], }), // 📝 Setup Winston Logger (Structured Logging) [Req 6.10] WinstonModule.forRoot(winstonConfig), // 2. Setup TypeORM (MariaDB) TypeOrmModule.forRootAsync({ imports: [ConfigModule], inject: [ConfigService], useFactory: async (configService: ConfigService) => ({ type: 'mariadb', host: configService.get('DB_HOST'), port: configService.get('DB_PORT'), username: configService.get('DB_USERNAME'), password: configService.get('DB_PASSWORD'), database: configService.get('DB_DATABASE'), autoLoadEntities: true, synchronize: false, // Production Ready: false }), }), // Register AuditLog Entity (Global Scope) TypeOrmModule.forFeature([AuditLog]), // 3. BullMQ (Redis) Setup BullModule.forRootAsync({ imports: [ConfigModule], inject: [ConfigService], useFactory: async (configService: ConfigService) => ({ connection: { host: configService.get('REDIS_HOST'), port: configService.get('REDIS_PORT'), password: configService.get('REDIS_PASSWORD'), }, }), }), // 📊 Register Monitoring Module (Health & Metrics) [Req 6.10] MonitoringModule, // Feature Modules AuthModule, UserModule, ProjectModule, FileStorageModule, DocumentNumberingModule, JsonSchemaModule, WorkflowEngineModule, CorrespondenceModule, RfaModule, // 👈 ต้องมี DrawingModule, // 👈 ต้องมี TransmittalModule, // 👈 ต้องมี CirculationModule, // 👈 ต้องมี SearchModule, // ✅ Register Module NotificationModule, // 👈 ต้องมี ResilienceModule, // ✅ Register Module ], controllers: [AppController], providers: [ AppService, // 🛡️ 1. Register Global Guard (Rate Limit) { provide: APP_GUARD, useClass: ThrottlerGuard, }, // 🚧 2. Maintenance Mode Guard { provide: APP_GUARD, useClass: MaintenanceModeGuard, }, // 📝 3. Register Global Interceptor (Audit Log) { provide: APP_INTERCEPTOR, useClass: AuditLogInterceptor, }, // 🔄 4. Register Idempotency (ถ้าต้องการ Global) // { // provide: APP_INTERCEPTOR, // useClass: IdempotencyInterceptor, // }, ], }) export class AppModule {} /*วิธีใช้งาน เมื่อต้องการเปิด Maintenance Mode ให้ Admin (หรือคุณ) ยิงคำสั่งเข้า Redis หรือสร้าง API เพื่อ Set ค่า: SET system:maintenance_mode true (หรือ "true") ระบบจะตอบกลับด้วย 503 Service Unavailable ทันที ยกเว้น Controller ที่คุณใส่ @BypassMaintenance() ไว้ครับ */