fix: 템플릿 점검 결과 반영 — Node 24·이미지 위생·운영 노출 최소화

템플릿 점검에서 나온 항목을 한 번에 반영한다. 항목별 이유:

- Node 20 → 24 LTS (Dockerfile·CI): Node 20 은 2026-04-30 에 지원이 끝나 보안 패치가 없다
- backend·frontend .dockerignore 추가: `COPY . .` 가 호스트 node_modules(Windows 바이너리)·dist·
  .env*(시크릿)를 이미지에 넣고 있었다
- 업로드 디렉터리 쓰기 검사(fail-fast): Linux 에서 Docker 가 root 소유로 만든 바인드 마운트에
  비-root 앱이 쓰지 못해 첫 업로드에서야 SYS_001 로 터졌다. 기동 시 해결 명령을 안내한다
- DB 커넥션 풀 100 → 10 (DB_POOL_MAX): PostgreSQL 기본 max_connections(100)를 앱 하나가 다 잡았다
- Swagger 운영 기본 비활성 (SWAGGER_ENABLED): API 구조 전체가 공개 도메인에 노출됐다
- 헬스체크 운영 응답에서 오류 상세 제거: 드라이버 오류 문구에 내부 주소·DB 계정명이 담긴다.
  원인은 error 로그로 남긴다
- nginx: location 의 add_header 때문에 정적 자원에서 보안 헤더가 빠지던 문제와,
  index.html 이 캐시돼 배포 직후 빈 화면이 날 수 있던 문제를 고친다
- vite allowedHosts: true 제거 (DEV_ALLOWED_HOSTS): DNS rebinding 보호가 꺼져 있었다
- 전역 설정을 configureApp() 으로 분리해 main.ts 와 e2e 가 공유: e2e 가 설정을 복사해 재현해
  실제 설정과 어긋나도 통과할 수 있었다. PORT 도 빈 값을 방어하는 파서를 거친다
- 쓰이지 않던 WEBSOCKET_PORT 제거: 별도 포트는 같은 도메인 라우팅과 맞지 않는다
- 예제 useUser 가 메시지 대신 에러 코드를 보관하도록 수정, testing.md 표 깨짐 수정,
  settings.json 허용 목록에서 npm install 제거 (Windows lock 파일 규칙과 충돌)

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

docker-compose.yml

@@ -45,7 +45,10 @@ services:
           memory: 512m
 
   # ----------------------------------------
-  # 2. Backend (HTTP API & WebSocket 통합) — NPM Custom location /api 의 대상
+  # 2. Backend (HTTP API) — NPM Custom location /api 의 대상
+  #
+  # WebSocket 을 도입할 때도 별도 포트를 열지 않는다. 게이트웨이를 HTTP 서버에 붙이고
+  # 경로를 /api 아래에 두면 같은 도메인·같은 location 을 그대로 탄다 (.claude/skills/nestjs/SKILL.md)
   # ----------------------------------------
   backend:
     container_name: ${PROJECT_NAME}-backend
@@ -54,7 +57,6 @@ services:
       dockerfile: Dockerfile
     expose:
       - "${BACKEND_PORT}"
-      - "${WEBSOCKET_PORT}"
     # PID 1 을 tini 로 두어 SIGTERM 이 애플리케이션까지 확실히 전달되게 한다 (graceful shutdown)
     init: true
     # 처리 중인 요청을 마칠 시간 — 초과하면 SIGKILL (기본 10초)
@@ -64,7 +66,8 @@ services:
     environment:
       - NODE_ENV=${APP_ENV}
       - PORT=${BACKEND_PORT}
-      - WEBSOCKET_PORT=${WEBSOCKET_PORT}
+      # 비어 있으면 운영에서만 Swagger(/api-docs)를 끈다 — true/false 로 강제할 수 있다
+      - SWAGGER_ENABLED=${SWAGGER_ENABLED:-}
       # 같은 도메인 구성에서는 비어 있다 — 다른 오리진에서 호출할 때만 콤마로 나열
       - CORS_ORIGIN=${CORS_ORIGIN:-}
       # 앱이 직접 쓰지는 않는다. API 를 별도 도메인으로 분리했을 때 로컬 주소가 남은 채
@@ -79,6 +82,7 @@ services:
       - DB_USER=${DB_USER}
       - DB_PASSWORD=${DB_PASSWORD}
       - DB_NAME=${DB_NAME}
+      - DB_POOL_MAX=${DB_POOL_MAX:-10}
       - DB_SYNCHRONIZE=${DB_SYNCHRONIZE:-false}
       - UPLOAD_DIR=/app/uploads
       - UPLOAD_MAX_SIZE_MB=${UPLOAD_MAX_SIZE_MB:-5}
@@ -86,6 +90,9 @@ services:
       - REDIS_PORT=6379
       - REDIS_PASSWORD=${REDIS_PASSWORD}
     # 업로드 파일은 컨테이너 재생성과 무관하게 보존되어야 한다
+    # ⚠️ Linux 서버: 앱은 node(uid 1000)로 돈다. 호스트 디렉터리가 없으면 Docker 가 root 소유로 만들어
+    #    기동이 실패하므로(업로드 디렉터리 쓰기 검사) 처음 한 번 소유자를 맞춘다:
+    #      mkdir -p data/uploads && sudo chown 1000:1000 data/uploads
     volumes:
       - ${UPLOAD_DATA_DIR:-./data/uploads}:/app/uploads
     restart: unless-stopped