웹 로그, DB 쿼리문과 결과 로그 출력

README.md

@@ -25,6 +25,7 @@ chocomae(mouse-typing) 서비스의 관리자 기능을 독립 Next.js 서비스
 - 연장 신청 목록 — 승인 / 취소 (트랜잭션 + `maestro_log`)
 - 업그레이드 신청 목록 — 승인 / 거절 (트랜잭션 + `maestro_log`)
 - 비인증 접근 차단 (`proxy.ts`, API route `auth()` 검사)
+- 구조화 로깅 — API 처리 시간·결과, DB 쿼리 pretty 출력, slow query 감지, 비밀번호 마스킹
 
 ## 개발 환경 설정
 
@@ -73,8 +74,9 @@ pnpm dev
 | `NEXTAUTH_SECRET` | ✅ | NextAuth 호환용 (동일 값) |
 | `AUTH_URL` | ✅ | 서비스 기본 URL |
 | `NEXTAUTH_URL` | ✅ | NextAuth 호환용 (동일 값) |
-| `APP_ENV` | — | `local` \| `stage` \| `production` (Phase 9) |
-| `LOG_LEVEL` | — | `debug` \| `info` \| `warn` \| `error` (Phase 9) |
+| `APP_ENV` | — | `local` \| `stage` \| `production` — 미설정 시 `debug` 레벨 기본값 |
+| `LOG_LEVEL` | — | `debug` \| `info` \| `warn` \| `error` — production 권장: `info` |
+| `DB_SLOW_QUERY_MS` | — | slow query 임계값(ms), 기본 `1000` — 초과 시 `warn` 로그 |
 | `MAIL_FROM_NAME` | — | 발송자 이름 (Phase 11) |
 | `MAIL_FROM_ADDRESS` | — | 발송자 주소 (Phase 11) |
 | `MAIL_BCC_ADDRESS` | — | BCC 주소 (Phase 11) |
@@ -110,7 +112,10 @@ chocoadmin/
 │   ├── forms/
 │   └── ui/                    # shadcn/ui 컴포넌트
 ├── lib/
-│   ├── db.ts                  # Prisma Client 싱글톤
+│   ├── db.ts                  # Prisma Client 싱글톤 (SQL/결과 로깅 포함)
+│   ├── logger.ts              # 공통 로거 (debug/info/warn/error)
+│   ├── errors.ts              # ApiError 공통 에러 클래스
+│   ├── api-handler.ts         # API route 래퍼 (auth, 타이밍, 에러 처리)
 │   ├── constants.ts           # 상태값 상수
 │   ├── maestros.ts            # 마에스트로 DB 쿼리
 │   ├── extension-requests.ts
@@ -131,3 +136,4 @@ chocoadmin/
 - [`docs/plan/project-plan.md`](docs/plan/project-plan.md) — 전체 개발 단계 계획
 - [`docs/business-rules.md`](docs/business-rules.md) — 기존 chocomae 비즈니스 규칙
 - [`docs/deployment.md`](docs/deployment.md) — NAS 배포 절차
+- [`docs/phase/phase9.md`](docs/phase/phase9.md) — 로그 정책 및 Docker 로그 운영 절차