chore: 코드베이스 초기 설정

.env.example

@@ -0,0 +1,10 @@
+NODE_ENV=development
+PORT=3000
+DATABASE_URL=postgres://postgres:postgres@localhost:5432/team_mino
+DB_POOL_SIZE=10
+
+POSTGRES_HOST=localhost
+POSTGRES_PORT=5432
+POSTGRES_USER=postgres
+POSTGRES_PASSWORD=postgres
+POSTGRES_DB=team_mino

.github/workflows/ci.yml

@@ -0,0 +1,27 @@
+name: CI
+
+on:
+  pull_request:
+  push:
+    branches: [main]
+
+jobs:
+  ci:
+    name: Lint & Test
+    runs-on: ubuntu-latest
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: oven-sh/setup-bun@v2
+        with:
+          bun-version: "1.3.14"
+
+      - name: Install dependencies
+        run: bun install --frozen-lockfile
+
+      - name: Check (lint + format + imports)
+        run: bun run check
+
+      - name: Test
+        run: bun run test

.gitignore

@@ -1,6 +1,13 @@
 bin/
 dist/
 node_modules/
+.agents/
+.claude/
+skills-lock.json
+.env
+.env.*
+!.env.example
+!.env.*.example
 [._]*.s[a-v][a-z]
 [._]*.sw[a-p]
 [._]s[a-rt-v][a-z]

README.md

@@ -0,0 +1,102 @@
+# Team MINO Node
+
+NestJS 기반 Team MINO 백엔드 API 서버입니다.
+
+## Requirements
+
+- Bun 1.3.x
+- Docker
+
+## Setup Guide
+
+### 1. Install Dependencies
+
+```bash
+bun install
+```
+
+### 2. Configure Environment
+
+```bash
+cp .env.example .env
+```
+
+기본 로컬 DB 연결 정보는 아래 값입니다.
+
+```env
+DATABASE_URL=postgres://postgres:postgres@localhost:5432/team_mino
+```
+
+### 3. Start Local Database
+
+```bash
+docker compose up -d postgres
+```
+
+컨테이너 상태를 확인합니다.
+
+```bash
+docker compose ps
+```
+
+### 4. Start Development Server
+
+```bash
+bun run start:dev
+```
+
+서버 기본 포트는 `3000`입니다.
+
+```text
+http://localhost:3000
+```
+
+### 5. Check Health API
+
+```bash
+curl http://localhost:3000/health
+```
+
+정상 응답은 아래와 같습니다.
+
+```json
+{
+  "status": "ok"
+}
+```
+
+## Available Scripts
+
+```bash
+bun run start:dev
+bun run build
+bun run check
+bun run lint
+bun run format
+bun run test
+```
+
+## API Docs
+
+개발 서버 실행 후 Swagger 문서는 아래 경로에서 확인할 수 있습니다.
+
+```text
+http://localhost:3000/api-docs
+```
+
+## Database
+
+로컬 PostgreSQL은 Docker Compose로 실행합니다.
+
+```bash
+docker compose up -d postgres
+docker compose down
+```
+
+Drizzle 설정은 `drizzle.config.ts`를 사용합니다.
+
+```bash
+bun run db:generate
+bun run db:migrate
+bun run db:push
+```

biome.json

@@ -0,0 +1,27 @@
+{
+  "$schema": "https://biomejs.dev/schemas/2.4.15/schema.json",
+  "files": {
+    "includes": ["**", "!dist", "!node_modules"]
+  },
+  "formatter": {
+    "enabled": true,
+    "indentStyle": "space",
+    "indentWidth": 2
+  },
+  "assist": {
+    "actions": {
+      "source": {
+        "organizeImports": "on"
+      }
+    }
+  },
+  "linter": {
+    "enabled": true,
+    "rules": {
+      "recommended": true,
+      "style": {
+        "useImportType": "off"
+      }
+    }
+  }
+}

docker-compose.yml

@@ -0,0 +1,21 @@
+services:
+  postgres:
+    image: postgres:18-alpine
+    container_name: team-mino-postgres
+    restart: unless-stopped
+    ports:
+      - "${POSTGRES_PORT:-5432}:5432"
+    environment:
+      POSTGRES_USER: ${POSTGRES_USER:-postgres}
+      POSTGRES_PASSWORD: ${POSTGRES_PASSWORD:-postgres}
+      POSTGRES_DB: ${POSTGRES_DB:-team_mino}
+    volumes:
+      - postgres_data:/var/lib/postgresql/data
+    healthcheck:
+      test: ["CMD-SHELL", "pg_isready -U $${POSTGRES_USER} -d $${POSTGRES_DB}"]
+      interval: 5s
+      timeout: 5s
+      retries: 5
+
+volumes:
+  postgres_data:

drizzle.config.ts

@@ -0,0 +1,16 @@
+import { defineConfig } from "drizzle-kit";
+
+const databaseUrl = process.env.DATABASE_URL;
+
+if (!databaseUrl) {
+  throw new Error("DATABASE_URL is required");
+}
+
+export default defineConfig({
+  schema: "./src/database/schema/index.ts",
+  out: "./drizzle",
+  dialect: "postgresql",
+  dbCredentials: {
+    url: databaseUrl,
+  },
+});

package.json

@@ -1,12 +1,23 @@
 {
   "name": "team-mino",
   "version": "1.0.0",
+  "packageManager": "bun@1.3.14",
+  "main": "dist/src/main",
   "scripts": {
     "build": "bun run scripts/build.ts",
+    "check": "biome check .",
+    "db:generate": "drizzle-kit generate",
+    "db:migrate": "drizzle-kit migrate",
+    "db:push": "drizzle-kit push",
+    "format": "biome format --write .",
+    "lint": "biome lint .",
     "start": "nest start",
     "start:dev": "nest start --watch",
     "start:prod": "./dist/server",
-    "test": "bun test test/"
+    "test": "bun test test/",
+    "test:watch": "bun test --watch",
+    "typecheck": "tsgo --noEmit",
+    "typecheck:tsc": "tsc --noEmit"
   },
   "keywords": [],
   "author": "",
@@ -15,18 +26,27 @@
   "dependencies": {
     "@kiyasov/platform-hono": "^2.0.3",
     "@nestjs/common": "^11.1.24",
-    "@nestjs/config": "^4.0.2",
+    "@nestjs/config": "^4.0.4",
     "@nestjs/core": "^11.1.24",
+    "@nestjs/swagger": "^11.4.4",
+    "@nestjs/terminus": "^11.1.1",
+    "drizzle-orm": "^0.45.2",
     "nestjs-pino": "^4.6.1",
     "pino-http": "^11.0.0",
-    "reflect-metadata": "^0.2.2"
+    "postgres": "^3.4.9",
+    "reflect-metadata": "^0.2.2",
+    "valibot": "^1.4.1"
   },
   "devDependencies": {
+    "@biomejs/biome": "^2.4.15",
     "@nestjs/cli": "^11.0.21",
     "@nestjs/schematics": "^11.1.0",
+    "@nestjs/testing": "^11.1.24",
     "@types/bun": "^1.3.14",
     "@types/node": "^25.9.1",
+    "@typescript/native-preview": "^7.0.0-dev.20260421.2",
+    "drizzle-kit": "^0.31.10",
     "pino-pretty": "^13.1.3",
-    "typescript": "^5.9.3"
+    "typescript": "^6.0.0"
   }
 }

scripts/build.ts

@@ -2,10 +2,14 @@
 
 // Prevent bundling of NestJS's optional dependencies
 const dependencies = [
+  "@mikro-orm/core",
   "@nestjs/microservices",
   "@nestjs/microservices/microservices-module",
+  "@nestjs/mongoose",
   "@nestjs/platform-express",
   "@nestjs/platform-socket.io",
+  "@nestjs/sequelize/dist/common/sequelize.utils",
+  "@nestjs/typeorm/dist/common/typeorm.utils",
   "@nestjs/websockets/socket-module",
   "class-transformer",
   "class-transformer/storage",

src/app.module.ts

@@ -1,11 +1,17 @@
 import { Module, RequestMethod } from "@nestjs/common";
 import { ConfigModule, ConfigService } from "@nestjs/config";
+import { TerminusModule } from "@nestjs/terminus";
 import { LoggerModule } from "nestjs-pino";
+import { validateEnv } from "./config/env.schema";
+import { DatabaseModule } from "./database/database.module";
+import { DrizzleHealthIndicator } from "./health/drizzle.health-indicator";
+import { HealthController } from "./health/health.controller";
 
 @Module({
   imports: [
     ConfigModule.forRoot({
       isGlobal: true,
+      validate: validateEnv,
     }),
     LoggerModule.forRootAsync({
       inject: [ConfigService],
@@ -20,6 +26,10 @@ import { LoggerModule } from "nestjs-pino";
         exclude: [{ method: RequestMethod.ALL, path: "*" }],
       }),
     }),
+    DatabaseModule,
+    TerminusModule,
   ],
+  controllers: [HealthController],
+  providers: [DrizzleHealthIndicator],
 })
 export class AppModule {}

src/config/env.schema.ts

@@ -0,0 +1,32 @@
+import * as v from "valibot";
+
+const envSchema = v.object({
+  NODE_ENV: v.optional(
+    v.picklist(["development", "test", "production"]),
+    "development",
+  ),
+  PORT: v.optional(v.pipe(v.string(), v.regex(/^\d+$/), v.transform(Number), v.minValue(1), v.maxValue(65535)), "3000"),
+  DATABASE_URL: v.pipe(v.string(), v.minLength(1), v.url()),
+  DB_POOL_SIZE: v.optional(v.pipe(v.string(), v.regex(/^\d+$/), v.transform(Number), v.minValue(1)), "10"),
+});
+
+export type Env = v.InferOutput<typeof envSchema>;
+
+export function validateEnv(config: Record<string, unknown>): Env {
+  const result = v.safeParse(envSchema, config);
+
+  if (!result.success) {
+    const messages = result.issues
+      .map((issue) => {
+        const path =
+          issue.path?.map((item) => String(item.key)).join(".") ?? "unknown";
+
+        return `${path}: ${issue.message}`;
+      })
+      .join("\n");
+
+    throw new Error(`Invalid environment variables:\n${messages}`);
+  }
+
+  return result.output;
+}

src/database/database.module.ts

@@ -0,0 +1,8 @@
+import { Module } from "@nestjs/common";
+import { DatabaseService } from "./database.service";
+
+@Module({
+  providers: [DatabaseService],
+  exports: [DatabaseService],
+})
+export class DatabaseModule {}

src/database/database.service.ts

@@ -0,0 +1,25 @@
+import { Injectable, type OnModuleDestroy } from "@nestjs/common";
+import { ConfigService } from "@nestjs/config";
+import { drizzle } from "drizzle-orm/postgres-js";
+import postgres from "postgres";
+import type { Env } from "../config/env.schema";
+
+@Injectable()
+export class DatabaseService implements OnModuleDestroy {
+  private readonly client: ReturnType<typeof postgres>;
+  readonly db: ReturnType<typeof drizzle>;
+
+  constructor(configService: ConfigService<Env>) {
+    const databaseUrl = configService.getOrThrow("DATABASE_URL", { infer: true });
+    const max = configService.get("DB_POOL_SIZE", 10, { infer: true });
+
+    this.client = postgres(databaseUrl, {
+      max,
+    });
+    this.db = drizzle(this.client);
+  }
+
+  async onModuleDestroy() {
+    await this.client.end();
+  }
+}

src/database/schema/index.ts

@@ -0,0 +1 @@
+export {};