feat: add Docker support and health monitoring

- Add Dockerfiles for API and web applications with multi-stage builds
- Create docker-compose.yaml for local development with Redis, API, and web services
- Replace basic health endpoint with comprehensive health monitoring using @nestjs/terminus
- Add structured logging with pino and nestjs-pino
- Include nginx configuration for web application routing
- Update CI workflow to validate Docker builds
- Add .env.example with configuration template
- Update dependencies to support new features

Author: christopherldo

.env.example

@@ -0,0 +1,11 @@
+# Configuração Twitch
+TWITCH_CLIENT_ID=seu_client_id_aqui
+TWITCH_CLIENT_SECRET=seu_client_secret_aqui
+
+# Configuração Backend
+PORT=3000
+LEGACY_PORT=3001
+NODE_ENV=development
+
+# Configuração Redis
+REDIS_URL=redis://localhost:6379

.github/workflows/ci.yml

@@ -35,3 +35,17 @@ jobs:
 
       - name: Build workspace
         run: pnpm build
+
+  docker-build:
+    runs-on: ubuntu-latest
+    needs: build-and-lint
+
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v4
+
+      - name: Set up Docker Buildx
+        uses: docker/setup-buildx-action@v3
+
+      - name: Validate Docker Compose build
+        run: docker compose build

apps/api/Dockerfile

@@ -0,0 +1,47 @@
+# Etapa 1: Build
+FROM node:22-alpine AS build
+
+# Configurar pnpm
+ENV PNPM_HOME="/pnpm"
+ENV PATH="$PNPM_HOME:$PATH"
+RUN corepack enable
+
+WORKDIR /app
+
+# Copiar os arquivos essenciais para o workspace e root package.json
+COPY pnpm-workspace.yaml package.json pnpm-lock.yaml ./
+COPY packages ./packages
+COPY apps/api ./apps/api
+
+# Instalar as dependências do monorepo e buildar o projeto e os packages
+RUN pnpm install --frozen-lockfile
+RUN pnpm --filter @twitch-chat-visualizer/shared build
+RUN pnpm --filter @twitch-chat-visualizer/api build
+
+# Etapa 2: Produção
+FROM node:22-alpine AS production
+
+ENV PNPM_HOME="/pnpm"
+ENV PATH="$PNPM_HOME:$PATH"
+RUN corepack enable
+
+WORKDIR /app
+
+ENV NODE_ENV=production
+ENV PORT=3000
+
+# Copiar os arquivos de lock e workspaces
+COPY pnpm-workspace.yaml package.json pnpm-lock.yaml ./
+COPY packages ./packages
+COPY --from=build /app/packages/shared/dist ./packages/shared/dist
+
+# Copiar apenas os arquivos do API já compilados e o package.json
+COPY apps/api/package.json ./apps/api/
+COPY --from=build /app/apps/api/dist ./apps/api/dist
+
+# Instalar apenas dependências de produção para rodar as dists
+RUN pnpm install --prod --frozen-lockfile
+
+EXPOSE 3000
+
+CMD ["node", "apps/api/dist/main.js"]

apps/api/package.json

@@ -20,12 +20,17 @@
     "@nestjs/platform-fastify": "^11.0.0",
     "@nestjs/platform-socket.io": "^11.1.19",
     "@nestjs/schedule": "^6.1.3",
+    "@nestjs/terminus": "^11.1.1",
     "@nestjs/websockets": "^11.1.19",
     "@twitch-chat-visualizer/shared": "workspace:*",
     "axios": "^0.21.4",
     "cache-manager": "^7.2.8",
     "cache-manager-redis-yet": "^5.1.5",
     "fastify": "^5.0.0",
+    "nestjs-pino": "^4.6.1",
+    "pino-http": "^11.0.0",
+    "pino-pretty": "^13.1.3",
+    "qs": "^6.15.1",
     "reflect-metadata": "^0.2.0",
     "rxjs": "^7.8.1",
     "socket.io": "^3.1.2",
@@ -35,6 +40,7 @@
     "@nestjs/cli": "^11.0.0",
     "@twitch-chat-visualizer/config-ts": "workspace:*",
     "@types/node": "^22.0.0",
+    "@types/qs": "^6.15.0",
     "@types/tmi.js": "^1.8.6",
     "@vitest/ui": "^4.1.5",
     "socket.io-client": "^4.8.3",

apps/api/src/app.controller.ts

@@ -3,15 +3,24 @@ import { ConfigModule } from '@nestjs/config';
 import { ScheduleModule } from '@nestjs/schedule';
 import { CacheModule } from '@nestjs/cache-manager';
 import { redisStore } from 'cache-manager-redis-yet';
-import { AppController } from './app.controller';
+import { LoggerModule } from 'nestjs-pino';
 import { AssetsController } from './controllers/assets.controller';
 import { AuthModule } from './auth/auth.module';
 import { CacheExtModule } from './cache/cache.module';
 import { TwitchModule } from './twitch/twitch.module';
 import { GatewaysModule } from './gateways/gateways.module';
+import { HealthModule } from './health/health.module';
 
 @Module({
   imports: [
+    LoggerModule.forRoot({
+      pinoHttp: {
+        transport:
+          process.env.NODE_ENV !== 'production'
+            ? { target: 'pino-pretty', options: { singleLine: true } }
+            : undefined,
+      },
+    }),
     ConfigModule.forRoot({
       isGlobal: true,
       envFilePath: '../../.env', // Pode ler da raiz do monorepo se desejar
@@ -38,8 +47,9 @@ import { GatewaysModule } from './gateways/gateways.module';
     CacheExtModule,
     TwitchModule,
     GatewaysModule,
+    HealthModule,
   ],
-  controllers: [AppController, AssetsController],
+  controllers: [AssetsController],
   providers: [],
 })
 export class AppModule {}

apps/api/src/app.module.ts

@@ -0,0 +1,48 @@
+import { Controller, Get, Inject } from '@nestjs/common';
+import { HealthCheckService, MemoryHealthIndicator, HealthCheck, HealthIndicator, HealthIndicatorResult, HealthCheckError } from '@nestjs/terminus';
+import { CACHE_MANAGER } from '@nestjs/cache-manager';
+import { Cache } from 'cache-manager';
+
+class RedisHealthIndicator extends HealthIndicator {
+  constructor(@Inject(CACHE_MANAGER) private cacheManager: Cache) {
+    super();
+  }
+
+  async isHealthy(key: string): Promise<HealthIndicatorResult> {
+    try {
+      await this.cacheManager.set('health-check-ping', 'pong', 1000);
+      const res = await this.cacheManager.get('health-check-ping');
+      const isHealthy = res === 'pong';
+      
+      const result = this.getStatus(key, isHealthy, { message: 'Redis/Cache is responding' });
+      
+      if (isHealthy) {
+        return result;
+      }
+      throw new HealthCheckError('Redischeck failed', result);
+    } catch (e: any) {
+      throw new HealthCheckError('Redischeck failed', this.getStatus(key, false, { message: e.message }));
+    }
+  }
+}
+
+@Controller('health')
+export class HealthController {
+  constructor(
+    private health: HealthCheckService,
+    private memory: MemoryHealthIndicator,
+    @Inject(CACHE_MANAGER) private cacheManager: Cache,
+  ) {}
+
+  @Get()
+  @HealthCheck()
+  check() {
+    const redisIndicator = new RedisHealthIndicator(this.cacheManager);
+
+    return this.health.check([
+      () => this.memory.checkHeap('memory_heap', 150 * 1024 * 1024), // 150MB
+      () => this.memory.checkRSS('memory_rss', 300 * 1024 * 1024),   // 300MB
+      () => redisIndicator.isHealthy('redis'),
+    ]);
+  }
+}

apps/api/src/health/health.controller.ts

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

apps/api/src/health/health.module.ts

@@ -2,13 +2,17 @@ import { NestFactory } from '@nestjs/core';
 import { FastifyAdapter, NestFastifyApplication } from '@nestjs/platform-fastify';
 import { AppModule } from './app.module';
 import fastifyHttpProxy from '@fastify/http-proxy';
+import { Logger } from 'nestjs-pino';
 
 async function bootstrap() {
   const app = await NestFactory.create<NestFastifyApplication>(
     AppModule,
-    new FastifyAdapter()
+    new FastifyAdapter(),
+    { bufferLogs: true }
   );
 
+  app.useLogger(app.get(Logger));
+
   const port = process.env.PORT || 3000;
   const legacyPort = process.env.LEGACY_PORT || 3001;
 
@@ -32,8 +36,9 @@ async function bootstrap() {
 
   await app.listen(port, '0.0.0.0');
 
-  console.log(`🚀 NestJS API Gateway is running on: http://localhost:${port}`);
-  console.log(`➡️  Proxying unknown routes to legacy app on port: ${legacyPort}`);
+  const logger = app.get(Logger);
+  logger.log(`🚀 NestJS API Gateway is running on: http://localhost:${port}`);
+  logger.log(`➡️  Proxying unknown routes to legacy app on port: ${legacyPort}`);
 }
 
 bootstrap();

apps/api/src/main.ts

@@ -0,0 +1,32 @@
+# Etapa 1: Build
+FROM node:22-alpine AS build
+
+# Configurar pnpm
+ENV PNPM_HOME="/pnpm"
+ENV PATH="$PNPM_HOME:$PATH"
+RUN corepack enable
+
+WORKDIR /app
+
+# Copiar workspace root
+COPY pnpm-workspace.yaml package.json pnpm-lock.yaml ./
+COPY packages ./packages
+COPY apps/web ./apps/web
+
+# Instalar dependências e buildar
+RUN pnpm install --frozen-lockfile
+RUN pnpm --filter @twitch-chat-visualizer/shared build
+RUN pnpm --filter @twitch-chat-visualizer/web build
+
+# Etapa 2: Nginx (Produção)
+FROM nginx:stable-alpine AS production
+
+# Copiar build gerado
+COPY --from=build /app/apps/web/dist /usr/share/nginx/html
+
+# Copiar configuração Nginx
+COPY apps/web/nginx.conf /etc/nginx/conf.d/default.conf
+
+EXPOSE 80
+
+CMD ["nginx", "-g", "daemon off;"]