fix: 보안 규칙을 어기던 컨테이너·네트워크 설정 수정

security.md 가 금지한다고 적어둔 것을 실제 설정이 어기고 있었다.

- 프론트엔드 운영 컨테이너가 root 로 nginx 를 실행하고 있었다.
  nginx-unprivileged 로 전환하고 포트를 8080 으로 맞춤(비-root 는 1024 미만 바인드 불가).
- dev 오버라이드가 사용하는 빌드 스테이지에도 USER node 적용.
  익명 볼륨이 node 소유로 생성되도록 chown 을 USER 전환 앞에 둔다
  (그렇지 않으면 vite 가 node_modules/.vite 캐시를 쓰지 못한다).
- dev 의 DB/Redis 포트가 0.0.0.0 에 바인딩되어 같은 LAN 에 노출돼 있었다 → 127.0.0.1 로 한정.
- CSP 헤더 추가. 대신 현대 브라우저에서 권장되지 않는 X-XSS-Protection 은 제거.
- CORS 차단 시 Error 를 던져 500(SYS_001)이 되던 것을 헤더 미부여 방식으로 변경.
- 헬스체크가 localhost 를 ::1 로 해석해 항상 실패하던 문제 수정(127.0.0.1 명시).
- graceful shutdown 을 위해 init(tini)과 stop_grace_period 적용.
- *.example 의 실제같은 비밀번호를 placeholder 로 교체하고,
  비어 있던 서비스 env 예시에 안내를 채움.

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

frontend/.env.development.example

@@ -0,0 +1,15 @@
+# ==========================================
+# 프론트엔드 환경변수 (development)
+#
+# ⚠️ VITE_API_BASE_URL 은 루트 .env.development 의 BACKEND_API_URL 이
+#    docker-compose build arg 로 주입된다 — 여기에 작성할 필요가 없다.
+#    (SSOT: 루트 .env — .claude/rules/env-structure.md)
+#
+# Docker 없이 vite dev 서버를 직접 띄울 때만 아래 값을 사용한다.
+#   cp .env.development.example .env.development
+#
+# 모든 키는 VITE_ 접두어가 있어야 클라이언트 번들에 포함된다.
+# ⚠️ 번들에 그대로 노출되므로 시크릿을 넣지 말 것.
+# ==========================================
+
+# VITE_API_BASE_URL=http://localhost:3000/api

frontend/.env.production.example

@@ -0,0 +1,15 @@
+# ==========================================
+# 프론트엔드 환경변수 (production)
+#
+# ⚠️ VITE_API_BASE_URL 은 루트 .env.production 의 BACKEND_API_URL 이
+#    docker-compose build arg 로 주입된다 — 여기에 작성할 필요가 없다.
+#    (SSOT: 루트 .env — .claude/rules/env-structure.md)
+#
+# Docker 없이 vite dev 서버를 직접 띄울 때만 아래 값을 사용한다.
+#   cp .env.production.example .env.production
+#
+# 모든 키는 VITE_ 접두어가 있어야 클라이언트 번들에 포함된다.
+# ⚠️ 번들에 그대로 노출되므로 시크릿을 넣지 말 것.
+# ==========================================
+
+# VITE_API_BASE_URL=http://localhost:3000/api

frontend/Dockerfile

@@ -2,12 +2,18 @@ FROM node:20-alpine AS build-stage
 WORKDIR /app
 
 # 호스트의 npm 11 이 작성한 package-lock.json 형식과 호환되도록 npm 을 11 로 업그레이드
+# (전역 설치는 root 권한이 필요하므로 USER 전환 전에 수행)
 RUN npm install -g npm@11
 
-COPY package*.json ./
+# 개발 환경(docker-compose.dev.yml)은 이 스테이지에서 vite dev 서버를 구동하므로 비-root 로 전환한다.
+# /app 소유권을 넘겨야 익명 볼륨(node_modules)이 node 소유로 생성되어 vite 캐시(.vite) 쓰기가 가능하다.
+RUN chown node:node /app
+USER node
+
+COPY --chown=node:node package*.json ./
 RUN npm ci
 
-COPY . .
+COPY --chown=node:node . .
 
 ARG BUILD_MODE=production
 ARG VITE_API_BASE_URL
@@ -15,12 +21,16 @@ ENV VITE_API_BASE_URL=$VITE_API_BASE_URL
 
 RUN npm run build-only -- --mode ${BUILD_MODE}
 
-FROM nginx:stable-alpine AS production-stage
+# 비-root 전용 nginx 이미지 (보안 규칙: 컨테이너 root 실행 금지)
+# 1024 미만 포트는 바인드할 수 없으므로 8080 을 사용한다 — nginx.conf 의 listen 과 일치해야 한다.
+FROM nginxinc/nginx-unprivileged:stable-alpine AS production-stage
 
 # 보안 헤더 포함된 nginx 설정 적용
 COPY nginx.conf /etc/nginx/conf.d/default.conf
 COPY --from=build-stage /app/dist /usr/share/nginx/html
 
-# 비-root 실행은 nginx-unprivileged 이미지 도입 시 활성화 (현재는 80 포트 바인드 필요)
-EXPOSE 80
+# 이미지 기본 사용자(nginx, uid 101)로 구동 — root 로 되돌리지 말 것
+USER nginx
+
+EXPOSE 8080
 CMD ["nginx", "-g", "daemon off;"]

frontend/nginx.conf

@@ -1,5 +1,6 @@
 server {
-    listen       80;
+    # 비-root(nginx-unprivileged) 구동이라 1024 미만 포트를 쓸 수 없다
+    listen       8080;
     server_name  localhost;
 
     # ----------------------------------------
@@ -7,10 +8,23 @@ server {
     # ----------------------------------------
     add_header X-Frame-Options "SAMEORIGIN" always;
     add_header X-Content-Type-Options "nosniff" always;
-    add_header X-XSS-Protection "1; mode=block" always;
     add_header Referrer-Policy "strict-origin-when-cross-origin" always;
     add_header Permissions-Policy "geolocation=(), microphone=(), camera=()" always;
 
+    # Content-Security-Policy — XSS 방어의 핵심 헤더
+    #
+    # ⚠️ 프로젝트에 맞게 조정이 필요한 설정이다. 기본값 설명:
+    #   - default-src 'self'  : 기본적으로 같은 출처만 허용
+    #   - style-src 'unsafe-inline' : Vue 의 동적 스타일 바인딩(:style)이 인라인 스타일을 생성하므로 필요
+    #   - connect-src 'self'  : API 가 다른 도메인이면 그 origin 을 반드시 추가할 것
+    #                           (예: connect-src 'self' https://api.example.com)
+    #   - img-src data: blob: : 인라인 아이콘·캔버스/파일 미리보기 대응
+    #   - frame-ancestors 'none' : 클릭재킹 차단 (X-Frame-Options 의 최신 대체재)
+    #
+    # 외부 폰트·분석 스크립트·이미지 CDN 을 도입하면 해당 도메인을 명시적으로 추가한다.
+    # script-src 에 'unsafe-inline'/'unsafe-eval' 을 추가하면 CSP 의 의미가 사라지므로 피할 것.
+    add_header Content-Security-Policy "default-src 'self'; script-src 'self'; style-src 'self' 'unsafe-inline'; img-src 'self' data: blob:; font-src 'self' data:; connect-src 'self'; object-src 'none'; base-uri 'self'; form-action 'self'; frame-ancestors 'none'" always;
+
     # ----------------------------------------
     # 압축 (Gzip)
     # ----------------------------------------