refactor: large codebase cleanup - consolidate schemas, migrate to Drizzle ORM, extract frontend components, modernize Docker builds

- Consolidate all DB schema definitions into packages/shared as single source of truth
- Migrate backend from raw SQL to Drizzle ORM across all modules
- Extract frontend inline UI into separate component files
- Refactor discord-gateway circuitBreaker into conversationState + moderationState
- Convert messageStore to Proxy singleton pattern
- Add validateBody/validateQuery middleware + Zod schemas for API endpoints
- Modernize Docker builds with multi-stage + pnpm deploy
- Migrate CI/CD from deployment to image-based pipeline
- Remove 60+ unused/dead files (~15K lines)
- Update color scheme from sky-blue to teal-cyan
- Move DB connection management to @bete/shared/database

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>

services/backend/src/modules/voice/guilds.routes.ts

@@ -1,49 +0,0 @@
-import { createChildLogger } from "@bete/shared/logger";
-import type { Request, Response, Router } from "express";
-import express from "express";
-import { asyncHandler } from "../../shared/middlewares/index.js";
-import {
-  getGuilds,
-  getTextChannels,
-  getVoiceChannels,
-} from "./voice.service.js";
-
-const logger = createChildLogger("guilds.routes");
-
-export function createGuildsRouter(): Router {
-  const router = express.Router();
-
-  // GET /api/guilds
-  router.get(
-    "/",
-    asyncHandler(async (_req: Request, res: Response) => {
-      logger.debug("Fetching guilds");
-      const guilds = await getGuilds();
-      res.json(guilds);
-    }),
-  );
-
-  // GET /api/guilds/:guildId/channels
-  router.get(
-    "/:guildId/channels",
-    asyncHandler(async (req: Request, res: Response) => {
-      const guildId = req.params.guildId as string;
-      logger.debug({ guildId }, "Fetching text channels");
-      const channels = await getTextChannels(guildId);
-      res.json(channels);
-    }),
-  );
-
-  // GET /api/guilds/:guildId/voice-channels
-  router.get(
-    "/:guildId/voice-channels",
-    asyncHandler(async (req: Request, res: Response) => {
-      const guildId = req.params.guildId as string;
-      logger.debug({ guildId }, "Fetching voice channels");
-      const channels = await getVoiceChannels(guildId);
-      res.json(channels);
-    }),
-  );
-
-  return router;
-}

services/backend/src/modules/voice/index.ts

@@ -0,0 +1 @@
+export { createVoiceRouter } from "./voice.routes.js";

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

@@ -2,6 +2,7 @@ import { createChildLogger } from "@bete/shared/logger";
 import type { Request, Response } from "express";
 import { asyncHandler } from "../../shared/middlewares/index.js";
 import { publishCommandNoReply } from "../../shared/redis/index.js";
+import type { ConnectVoiceInput, VoiceCommandInput } from "./voice.schema.js";
 import {
   connectVoice,
   disconnectVoice,
@@ -17,22 +18,9 @@ export const handleGetVoiceStatus = asyncHandler(
   },
 );
 
-/** Safely extract a string value that may be a single string or string array. */
-function asString(val: unknown): string {
-  if (Array.isArray(val)) return String(val[0] ?? "");
-  return String(val ?? "");
-}
-
 export const handleConnectVoice = asyncHandler(
   async (req: Request, res: Response) => {
-    const guildId = asString(req.body.guildId);
-    const channelId = asString(req.body.channelId);
-    if (!guildId || !channelId) {
-      return res.status(400).json({
-        error: "VALIDATION_ERROR",
-        message: "guildId and channelId are required",
-      });
-    }
+    const { guildId, channelId } = req.body as ConnectVoiceInput;
     logger.debug({ guildId, channelId }, "Connecting to voice channel");
     const status = await connectVoice(guildId, channelId);
     res.json(status);
@@ -49,15 +37,7 @@ export const handleDisconnectVoice = asyncHandler(
 
 export const handleVoiceCommand = asyncHandler(
   async (req: Request, res: Response) => {
-    const command = asString(req.body.command);
-
-    if (!command) {
-      return res.status(400).json({
-        error: "VALIDATION_ERROR",
-        message: "command is required",
-      });
-    }
-
+    const { command } = req.body as VoiceCommandInput;
     logger.debug({ command }, "Publishing voice command");
     await publishCommandNoReply(command);
     res.json({ success: true, command });

services/backend/src/modules/voice/voice.routes.ts

@@ -1,26 +1,80 @@
-import type { Router } from "express";
+import { createChildLogger } from "@bete/shared/logger";
+import type { Request, Response, Router } from "express";
 import express from "express";
+import { asyncHandler, validateBody } from "../../shared/middlewares/index.js";
 import {
   handleConnectVoice,
   handleDisconnectVoice,
   handleGetVoiceStatus,
   handleVoiceCommand,
 } from "./voice.controller.js";
+import { connectVoiceSchema, voiceCommandSchema } from "./voice.schema.js";
+import {
+  getGuilds,
+  getTextChannels,
+  getVoiceChannels,
+} from "./voice.service.js";
+
+const logger = createChildLogger("voice.routes");
 
 export function createVoiceRouter(): Router {
   const router = express.Router();
 
+  // ── Guilds ──────────────────────────────────────────────────────────────
+
+  // GET /api/guilds
+  router.get(
+    "/guilds",
+    asyncHandler(async (_req: Request, res: Response) => {
+      logger.debug("Fetching guilds");
+      const guilds = await getGuilds();
+      res.json(guilds);
+    }),
+  );
+
+  // GET /api/guilds/:guildId/channels
+  router.get(
+    "/guilds/:guildId/channels",
+    asyncHandler(async (req: Request, res: Response) => {
+      const guildId = req.params.guildId as string;
+      logger.debug({ guildId }, "Fetching text channels");
+      const channels = await getTextChannels(guildId);
+      res.json(channels);
+    }),
+  );
+
+  // GET /api/guilds/:guildId/voice-channels
+  router.get(
+    "/guilds/:guildId/voice-channels",
+    asyncHandler(async (req: Request, res: Response) => {
+      const guildId = req.params.guildId as string;
+      logger.debug({ guildId }, "Fetching voice channels");
+      const channels = await getVoiceChannels(guildId);
+      res.json(channels);
+    }),
+  );
+
+  // ── Voice connection ────────────────────────────────────────────────────
+
   // GET /api/voice/status
   router.get("/voice/status", handleGetVoiceStatus);
 
   // POST /api/voice/connect
-  router.post("/voice/connect", handleConnectVoice);
+  router.post(
+    "/voice/connect",
+    validateBody(connectVoiceSchema),
+    handleConnectVoice,
+  );
 
   // POST /api/voice/disconnect
   router.post("/voice/disconnect", handleDisconnectVoice);
 
   // POST /api/voice/command — send arbitrary voice command (transmit start/stop)
-  router.post("/voice/command", handleVoiceCommand);
+  router.post(
+    "/voice/command",
+    validateBody(voiceCommandSchema),
+    handleVoiceCommand,
+  );
 
   return router;
 }

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

@@ -0,0 +1,13 @@
+import { z } from "zod";
+
+export const connectVoiceSchema = z.object({
+  guildId: z.string().min(1, "guildId is required"),
+  channelId: z.string().min(1, "channelId is required"),
+});
+
+export const voiceCommandSchema = z.object({
+  command: z.string().min(1, "command is required"),
+});
+
+export type ConnectVoiceInput = z.infer<typeof connectVoiceSchema>;
+export type VoiceCommandInput = z.infer<typeof voiceCommandSchema>;

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

@@ -5,13 +5,15 @@ import {
   COMMAND_VOICE_CONNECT,
   COMMAND_VOICE_DISCONNECT,
   type CommandReply,
+  pgMessagesTable,
   VOICE_STATUS_KEY,
 } from "@bete/shared";
+import { eq } from "drizzle-orm";
 import {
   createChildLogger,
   tryCommandThenFallback,
 } from "../../shared/commandHelper.js";
-import { getPool } from "../../shared/database/index.js";
+import { getDatabase } from "../../shared/database/index.js";
 import { publishCommand, readRedisStatus } from "../../shared/redis/index.js";
 
 const logger = createChildLogger("voice.service");
@@ -78,11 +80,12 @@ export async function getGuilds(): Promise<Guild[]> {
   return withFallback(
     () => publishCommand<Guild[]>(COMMAND_GUILDS_LIST, {}),
     async () => {
-      const pool = getPool();
-      const { rows } = await pool.query(
-        `SELECT DISTINCT guild_id FROM messages ORDER BY guild_id`,
-      );
-      return rows.map((row: Record<string, unknown>) => ({
+      const db = getDatabase();
+      const rows = await db
+        .selectDistinct({ guild_id: pgMessagesTable.guild_id })
+        .from(pgMessagesTable)
+        .orderBy(pgMessagesTable.guild_id);
+      return rows.map((row) => ({
         id: String(row.guild_id ?? ""),
         name: `Guild ${String(row.guild_id).slice(0, 8)}`,
         icon: null,
@@ -101,12 +104,13 @@ export async function getTextChannels(guildId: string): Promise<Channel[]> {
   return withFallback(
     () => publishCommand<Channel[]>(COMMAND_GUILDS_TEXT_CHANNELS, { guildId }),
     async () => {
-      const pool = getPool();
-      const { rows } = await pool.query(
-        `SELECT DISTINCT channel_id FROM messages WHERE guild_id = $1 ORDER BY channel_id`,
-        [guildId],
-      );
-      return rows.map((row: Record<string, unknown>) => ({
+      const db = getDatabase();
+      const rows = await db
+        .selectDistinct({ channel_id: pgMessagesTable.channel_id })
+        .from(pgMessagesTable)
+        .where(eq(pgMessagesTable.guild_id, guildId))
+        .orderBy(pgMessagesTable.channel_id);
+      return rows.map((row) => ({
         id: String(row.channel_id ?? ""),
         name: `Channel ${String(row.channel_id).slice(0, 8)}`,
         type: "text" as const,