.env 로드 스크립트 수정 및 대시보드 모듈 JwtGuard 설정 추가, Docker 편의 명령어 개선

Author: sscoderati

Makefile

@@ -1,4 +1,4 @@
-.PHONY: dev-up dev-down dev-logs dev-reset api-rebuild migrate migrate-gen seed build lint install db-studio
+.PHONY: dev-up dev-down dev-logs dev-reset api-rebuild migrate migrate-gen seed build lint install db-studio docker-up docker-down
 
 DB_USER  ?= marrylife
 DB_PASS  ?= marrylife
@@ -9,7 +9,18 @@ DB_PORT  ?= 5432
 DATABASE_URL = postgres://$(DB_USER):$(DB_PASS)@$(DB_HOST):$(DB_PORT)/$(DB_NAME)
 
 dev-up:
-	docker compose up -d db api
+	@echo "🐳 Starting PostgreSQL in Docker..."
+	docker compose up -d db
+	@echo ""
+	@echo "✅ Database is running!"
+	@echo ""
+	@echo "📝 Next steps:"
+	@echo "  1. Run 'pnpm dev' to start development servers (FE + BE with hot reload)"
+	@echo "  2. Access:"
+	@echo "     - Frontend: http://localhost:3000"
+	@echo "     - Backend:  http://localhost:4000"
+	@echo "     - API Docs: http://localhost:4000/api"
+	@echo ""
 
 dev-down:
 	docker compose down
@@ -24,10 +35,16 @@ dev-reset:
 api-rebuild:
 	docker compose up -d --build api
 
-up:
+docker-up:
+	@echo "🐳 Starting all services in Docker (DB + API + Web)..."
 	docker compose up -d
 
-up-build:
+docker-down:
+	@echo "🛑 Stopping all Docker services..."
+	docker compose down
+
+docker-up-build:
+	@echo "🐳 Building and starting all services in Docker..."
 	docker compose up -d --build
 
 migrate:

apps/api/package.json

@@ -7,6 +7,7 @@
   "scripts": {
     "build": "nest build",
     "format": "prettier --write \"src/**/*.ts\" \"test/**/*.ts\"",
+    "dev": "dotenv -e ../../.env -- nest start --watch",
     "start": "nest start",
     "start:dev": "nest start --watch",
     "start:debug": "nest start --debug --watch",

apps/api/src/dashboard/dashboard.module.ts

@@ -1,9 +1,13 @@
 import { Module } from '@nestjs/common';
+import { JwtModule } from '@nestjs/jwt';
+import { JwtAuthGuard } from '../common/guards/jwt-auth.guard';
+import { LedgerMemberGuard } from '../common/guards/ledger-member.guard';
 import { DashboardController } from './dashboard.controller';
 import { DashboardService } from './dashboard.service';
 
 @Module({
+  imports: [JwtModule.register({})],
   controllers: [DashboardController],
-  providers: [DashboardService],
+  providers: [DashboardService, JwtAuthGuard, LedgerMemberGuard],
 })
 export class DashboardModule {}

memories/task.md

@@ -34,6 +34,7 @@
 - **상태:** 완료
 - **범위:** `apps/api`
 - **설명:** 응답 래퍼 인터셉터(success/error 형식), 글로벌 예외 필터(HttpException → error 형식), Swagger 설정(@nestjs/swagger), DB 연결 모듈(packages/db 연결), ValidationPipe 글로벌 설정.
+- **진행 메모 (2026-03-31):** 루트 `pnpm dev`에서 `.env`를 전역 주입하던 설정을 제거하고, `apps/api`의 `dev` 스크립트에서만 `../../.env`를 로드하도록 조정해 웹 포트(3000) 오염을 방지.
 - **참조:** api-conventions.md §2~§3, architecture.md §2
 - **완료 조건:**
   - 모든 응답이 `{ success: true, data }` 또는 `{ success: false, error: { code, message } }` 형식
@@ -62,6 +63,7 @@
 - **상태:** 완료
 - **범위:** `apps/api` — common/guards
 - **설명:** `JwtAuthGuard` — Authorization Bearer 헤더에서 Access Token 검증, 만료 시 401 반환. `LedgerMemberGuard` — URL 파라미터 `ledgerId`로 해당 유저의 멤버십 확인, 미소속 시 403 반환. 두 Guard를 데코레이터로 편리하게 적용할 수 있도록 커스텀 데코레이터 작성.
+- **진행 메모 (2026-03-31):** `DashboardModule`에 `JwtModule.register({})` 및 `JwtAuthGuard`/`LedgerMemberGuard` provider 등록 누락을 보완해 `JwtService` DI 오류를 수정.
 - **참조:** architecture.md §5
 - **완료 조건:**
   - 인증 없이 보호된 엔드포인트 접근 시 401

package.json

@@ -3,7 +3,7 @@
   "private": true,
   "scripts": {
     "build": "turbo run build",
-    "dev": "turbo run dev",
+    "dev": "pnpm exec turbo run dev",
     "lint": "turbo run lint",
     "format": "prettier --write \"**/*.{ts,tsx,md}\"",
     "check-types": "turbo run check-types",
@@ -17,6 +17,7 @@
   "devDependencies": {
     "@svgr/cli": "^8.1.0",
     "@types/node": "^25.4.0",
+    "dotenv-cli": "^8.0.0",
     "prettier": "^3.7.4",
     "turbo": "^2.8.15",
     "typescript": "5.9.2"