Merge branch 'main' into feat/issues

Author: yusuftomilola

backend/src/opsce/health/decorator/public-decorator.ts

@@ -0,0 +1,6 @@
+import { SetMetadata } from '@nestjs/common';
+
+export const IS_PUBLIC_KEY = 'isPublic';
+
+export const Public = () =>
+  SetMetadata(IS_PUBLIC_KEY, true);

backend/src/opsce/health/healthController.ts

@@ -0,0 +1,55 @@
+
+
+
+export class healthController {
+    constructor(private readonly healthService: HealthService) {}
+
+    @Get()
+    getHealth(): string {
+        return this.healthService.getHealthStatus();
+    }
+}
+
+
+import {
+  Controller,
+  Get,
+} from '@nestjs/common';
+
+import {
+  HealthCheck,
+  HealthCheckService,
+  TypeOrmHealthIndicator,
+  DiskHealthIndicator,
+} from '@nestjs/terminus';
+
+import { RedisHealthIndicator } from './indicators/redis.health';
+import { Public } from '../../auth/decorators/public.decorator';
+
+@Controller('health')
+export class HealthController {
+  constructor(
+    private readonly health: HealthCheckService,
+    private readonly db: TypeOrmHealthIndicator,
+    private readonly disk: DiskHealthIndicator,
+    private readonly redis: RedisHealthIndicator,
+  ) {}
+
+  @Get()
+  @Public()
+  @HealthCheck()
+  check() {
+    return this.health.check([
+      () => this.db.pingCheck('postgres'),
+
+      () =>
+        this.redis.isHealthy('redis'),
+
+      () =>
+        this.disk.checkStorage('storage', {
+          path: '/',
+          thresholdPercent: 0.9,
+        }),
+    ]);
+  }
+}

backend/src/opsce/health/healthModule.ts

@@ -0,0 +1,12 @@
+import { Module } from '@nestjs/common';
+import { TerminusModule } from '@nestjs/terminus';
+
+import { HealthController } from './health.controller';
+import { RedisHealthIndicator } from './indicators/redis.health';
+
+@Module({
+  imports: [TerminusModule],
+  controllers: [HealthController],
+  providers: [RedisHealthIndicator],
+})
+export class HealthModule {}

backend/src/opsce/health/healthSerivce.ts

@@ -0,0 +1,63 @@
+
+
+@Injectable()
+export class HealthService {
+  getHealthStatus(): string {
+    return 'OK';
+  }
+}
+
+
+import {
+  Injectable,
+} from '@nestjs/common';
+
+import {
+  HealthIndicator,
+  HealthIndicatorResult,
+  HealthCheckError,
+} from '@nestjs/terminus';
+
+import Redis from 'ioredis';
+
+@Injectable()
+export class RedisHealthIndicator extends HealthIndicator {
+  private readonly redis: Redis;
+
+  constructor() {
+    super();
+
+    this.redis = new Redis({
+      host: process.env.REDIS_HOST,
+      port: Number(process.env.REDIS_PORT),
+      password: process.env.REDIS_PASSWORD,
+    });
+  }
+
+  async isHealthy(
+    key: string,
+  ): Promise<HealthIndicatorResult> {
+    try {
+      const response = await this.redis.ping();
+
+      const result = this.getStatus(
+        key,
+        response === 'PONG',
+      );
+
+      if (response !== 'PONG') {
+        throw new HealthCheckError(
+          'Redis check failed',
+          result,
+        );
+      }
+
+      return result;
+    } catch (error) {
+      throw new HealthCheckError(
+        'Redis unavailable',
+        this.getStatus(key, false),
+      );
+    }
+  }
+}

backend/src/opsce/health/opsce.module.ts

@@ -0,0 +1,30 @@
+import { Module } from '@nestjs/common';
+import { APP_GUARD } from '@nestjs/core';
+import { ConfigModule, ConfigService } from '@nestjs/config';
+import { ThrottlerGuard, ThrottlerModule } from '@nestjs/throttler';
+
+@Module({
+  imports: [
+    ConfigModule,
+
+    ThrottlerModule.forRootAsync({
+      inject: [ConfigService],
+      useFactory: (configService: ConfigService) => ({
+        throttlers: [
+          {
+            ttl: Number(configService.get('THROTTLE_TTL', 60)) * 1000,
+            limit: Number(configService.get('THROTTLE_LIMIT', 100)),
+          },
+        ],
+      }),
+    }),
+  ],
+
+  providers: [
+    {
+      provide: APP_GUARD,
+      useClass: ThrottlerGuard,
+    },
+  ],
+})
+export class OpsceModule {}

backend/src/opsce/opsce.module.ts

@@ -7,6 +7,13 @@ import { LocationsModule } from './locations/locations.module';
 import { AuthModule } from './auth/auth.module';
 import { UploadsModule } from './uploads/uploads.module';
 
+/**
+ * OpsceModule
+ *
+ * Aggregates all operational sub-modules: users, locations, audit, and
+ * departments. ConfigModule is already global (registered in AppModule), so
+ * every sub-module can inject ConfigService without re-importing it here.
+ */
 @Module({
   imports: [
     AuthModule,
@@ -27,4 +34,4 @@ import { UploadsModule } from './uploads/uploads.module';
     UploadsModule,
   ],
 })
-export class OpsceModule {}
+export class OpsceModule {}