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

.gitignore

@@ -1,8 +1,11 @@
 dist/
 node_modules/
+.env
+.env.*
+!.env.example
+!.env.*.example
 [._]*.s[a-v][a-z]
 [._]*.sw[a-p]
 [._]s[a-rt-v][a-z]
 [._]ss[a-gi-z]
 [._]sw[a-p]
-

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,
+  },
+});