refactor: split monolith into 3 microservices (frontend, backend, discord-gateway)

- Extract services into services/{frontend,backend,discord-gateway}
- Create packages/shared/ for shared logger, errors, utils, types
- Setup Modular MVC pattern in backend (controller→service→repository)
- Setup event-driven architecture in discord-gateway with Redis pub/sub
- Move Docker files to infra/docker/ with per-service Dockerfiles
- Update docker-compose.yml to use Traefik-only routing (no port exposes)
- Update GitHub Actions deploy workflow for multi-service matrix build
- Fix all import paths and resolve type errors across all services
- All 3 services pass tsc --noEmit clean

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>

services/backend/src/modules/analytics/analytics.controller.ts

@@ -0,0 +1,96 @@
+import type { NextFunction, Request, Response } from "express";
+import { createChildLogger } from "../../shared/logger/index.js";
+import { asyncHandler } from "../../shared/middlewares/index.js";
+import { analyticsQuerySchema } from "./analytics.schema.js";
+import { analyticsService } from "./analytics.service.js";
+
+const logger = createChildLogger("analytics.controller");
+
+function requireQueryString(value: unknown, name: string): string {
+  if (typeof value !== "string" || value.length === 0) {
+    throw new Error(`Missing query parameter: ${name}`);
+  }
+  return value;
+}
+
+export function handleGetOverview(
+  req: Request,
+  res: Response,
+  next: NextFunction,
+) {
+  return asyncHandler(async (req: Request, res: Response) => {
+    const query = analyticsQuerySchema.parse(req.query);
+    logger.debug({ query }, "Handling get overview");
+    const result = await analyticsService.getOverview(query);
+    res.json(result);
+  })(req, res, next);
+}
+
+export function handleGetDailyTrend(
+  req: Request,
+  res: Response,
+  next: NextFunction,
+) {
+  return asyncHandler(async (req: Request, res: Response) => {
+    const guildId = requireQueryString(req.query.guildId, "guildId");
+    const hours = req.query.hours ? Number(req.query.hours) : 24;
+    logger.debug({ guildId, hours }, "Handling get daily trend");
+    const result = await analyticsService.getDailyTrend(guildId, hours);
+    res.json(result);
+  })(req, res, next);
+}
+
+export function handleGetHourlyStats(
+  req: Request,
+  res: Response,
+  next: NextFunction,
+) {
+  return asyncHandler(async (req: Request, res: Response) => {
+    const guildId = requireQueryString(req.query.guildId, "guildId");
+    const hours = req.query.hours ? Number(req.query.hours) : 24;
+    logger.debug({ guildId, hours }, "Handling get hourly stats");
+    const result = await analyticsService.getHourlyStats(guildId, hours);
+    res.json(result);
+  })(req, res, next);
+}
+
+export function handleGetTopViolators(
+  req: Request,
+  res: Response,
+  next: NextFunction,
+) {
+  return asyncHandler(async (req: Request, res: Response) => {
+    const guildId = requireQueryString(req.query.guildId, "guildId");
+    const limit = req.query.limit ? Number(req.query.limit) : 10;
+    logger.debug({ guildId, limit }, "Handling get top violators");
+    const result = await analyticsService.getTopViolators(guildId, limit);
+    res.json(result);
+  })(req, res, next);
+}
+
+export function handleGetUserLeaderboard(
+  req: Request,
+  res: Response,
+  next: NextFunction,
+) {
+  return asyncHandler(async (req: Request, res: Response) => {
+    const guildId = requireQueryString(req.query.guildId, "guildId");
+    const limit = req.query.limit ? Number(req.query.limit) : 10;
+    logger.debug({ guildId, limit }, "Handling get user leaderboard");
+    const result = await analyticsService.getUserLeaderboard(guildId, limit);
+    res.json(result);
+  })(req, res, next);
+}
+
+export function handleGetModerationStats(
+  req: Request,
+  res: Response,
+  next: NextFunction,
+) {
+  return asyncHandler(async (req: Request, res: Response) => {
+    const guildId = requireQueryString(req.query.guildId, "guildId");
+    logger.debug({ guildId }, "Handling get moderation stats");
+    const result = await analyticsService.getModerationStats(guildId);
+    res.json(result);
+  })(req, res, next);
+}

services/backend/src/modules/analytics/analytics.repository.ts

@@ -0,0 +1,53 @@
+import { createChildLogger } from "../../shared/logger/index.js";
+
+const logger = createChildLogger("analytics.repository");
+
+export class AnalyticsRepository {
+  async getOverview(guildId: string, channelId?: string, hours = 24) {
+    logger.debug({ guildId, channelId, hours }, "Getting analytics overview");
+    // TODO: Implement actual Drizzle ORM queries
+    return {
+      totalMessages: 0,
+      totalUsers: 0,
+      flaggedMessages: 0,
+      averageSeverity: 0,
+    };
+  }
+
+  async getDailyTrend(guildId: string, hours = 24) {
+    logger.debug({ guildId, hours }, "Getting daily trend");
+    // TODO: Implement actual Drizzle ORM queries
+    return [];
+  }
+
+  async getHourlyStats(guildId: string, hours = 24) {
+    logger.debug({ guildId, hours }, "Getting hourly stats");
+    // TODO: Implement actual Drizzle ORM queries
+    return [];
+  }
+
+  async getTopViolators(guildId: string, limit = 10) {
+    logger.debug({ guildId, limit }, "Getting top violators");
+    // TODO: Implement actual Drizzle ORM queries
+    return [];
+  }
+
+  async getUserLeaderboard(guildId: string, limit = 10) {
+    logger.debug({ guildId, limit }, "Getting user leaderboard");
+    // TODO: Implement actual Drizzle ORM queries
+    return [];
+  }
+
+  async getModerationStats(guildId: string) {
+    logger.debug({ guildId }, "Getting moderation stats");
+    // TODO: Implement actual Drizzle ORM queries
+    return {
+      clean: 0,
+      warn: 0,
+      flagged: 0,
+      error: 0,
+    };
+  }
+}
+
+export const analyticsRepository = new AnalyticsRepository();

services/backend/src/modules/analytics/analytics.schema.ts

@@ -0,0 +1,9 @@
+import { z } from "zod";
+
+export const analyticsQuerySchema = z.object({
+  guildId: z.string(),
+  channelId: z.string().optional(),
+  hours: z.coerce.number().int().positive().default(24),
+});
+
+export type AnalyticsQuery = z.infer<typeof analyticsQuerySchema>;

services/backend/src/modules/analytics/analytics.service.ts

@@ -0,0 +1,61 @@
+import { config } from "../../shared/config/index.js";
+import { ForbiddenError, ValidationError } from "../../shared/errors/index.js";
+import { createChildLogger } from "../../shared/logger/index.js";
+import { analyticsRepository } from "./analytics.repository.js";
+import type { AnalyticsQuery } from "./analytics.schema.js";
+
+const logger = createChildLogger("analytics.service");
+
+export class AnalyticsService {
+  private assertMonitorGuild(guildId: string) {
+    if (!config.MONITOR_GUILD_ID) {
+      throw new ValidationError("MONITOR_GUILD_ID is not configured");
+    }
+
+    if (guildId !== config.MONITOR_GUILD_ID) {
+      throw new ForbiddenError("Analytics are restricted to the monitor guild");
+    }
+  }
+
+  async getOverview(query: AnalyticsQuery) {
+    this.assertMonitorGuild(query.guildId);
+    logger.debug({ query }, "Getting analytics overview");
+    return analyticsRepository.getOverview(
+      query.guildId,
+      query.channelId,
+      query.hours,
+    );
+  }
+
+  async getDailyTrend(guildId: string, hours = 24) {
+    this.assertMonitorGuild(guildId);
+    logger.debug({ guildId, hours }, "Getting daily trend");
+    return analyticsRepository.getDailyTrend(guildId, hours);
+  }
+
+  async getHourlyStats(guildId: string, hours = 24) {
+    this.assertMonitorGuild(guildId);
+    logger.debug({ guildId, hours }, "Getting hourly stats");
+    return analyticsRepository.getHourlyStats(guildId, hours);
+  }
+
+  async getTopViolators(guildId: string, limit = 10) {
+    this.assertMonitorGuild(guildId);
+    logger.debug({ guildId, limit }, "Getting top violators");
+    return analyticsRepository.getTopViolators(guildId, limit);
+  }
+
+  async getUserLeaderboard(guildId: string, limit = 10) {
+    this.assertMonitorGuild(guildId);
+    logger.debug({ guildId, limit }, "Getting user leaderboard");
+    return analyticsRepository.getUserLeaderboard(guildId, limit);
+  }
+
+  async getModerationStats(guildId: string) {
+    this.assertMonitorGuild(guildId);
+    logger.debug({ guildId }, "Getting moderation stats");
+    return analyticsRepository.getModerationStats(guildId);
+  }
+}
+
+export const analyticsService = new AnalyticsService();

services/backend/src/modules/analytics/routes/index.ts

@@ -0,0 +1,23 @@
+import type { Router } from "express";
+import express from "express";
+import {
+  handleGetDailyTrend,
+  handleGetHourlyStats,
+  handleGetModerationStats,
+  handleGetOverview,
+  handleGetTopViolators,
+  handleGetUserLeaderboard,
+} from "../analytics.controller.js";
+
+export function createAnalyticsRouter(): Router {
+  const router = express.Router();
+
+  router.get("/analytics/overview", handleGetOverview);
+  router.get("/analytics/daily-trend", handleGetDailyTrend);
+  router.get("/analytics/hourly-stats", handleGetHourlyStats);
+  router.get("/analytics/top-violators", handleGetTopViolators);
+  router.get("/analytics/user-leaderboard", handleGetUserLeaderboard);
+  router.get("/analytics/moderation-stats", handleGetModerationStats);
+
+  return router;
+}