[chore] Main 최신화

.env.example

@@ -32,11 +32,28 @@ FACE_AI_BASE_URL=
 CHECKUP_ADMIN_DATAGSM_IDS=
 
 # 세션
+# https로 서비스하면 true(운영). http면 브라우저가 SESSION 쿠키를 저장하지 않아 로그인 직후부터 401이므로 false로 둔다.
 SESSION_COOKIE_SECURE=true
+# 로그인 유지 기간. 서버 세션과 SESSION 쿠키 max-age에 같이 쓴다. 비우면 30d(예: 14d, 30d).
 SESSION_TIMEOUT=
 
-# API 문서
-SWAGGER_ENABLED=true
+# API 문서(/swagger-ui/index.html). 운영 기본은 비공개(false)다. 로그인 없이 API 목록·오류 코드가 보이므로 프론트 연동 기간처럼 필요할 때만 true로 켜고 끝나면 다시 끈다.
+# compose.prod.yaml 없이 로컬에서 직접 실행하면 application.yaml 기본값(true)이라 문서가 열린다.
+SWAGGER_ENABLED=false
 
 # 요청별 DB 쿼리 수·걸린 시간 로그. 느린 API를 찾을 때만 true로 둔다.
-QUERY_LOG_ENABLED=false
+QUERY_LOG_ENABLED=false
+
+# DB 커넥션 풀. 비워 두면 기본값(크기 10, 가득 찼을 때 10초 대기)을 쓴다.
+# 서버 대수 × 풀 크기가 Postgres max_connections보다 작아야 한다.
+DB_POOL_SIZE=
+DB_POOL_TIMEOUT_MS=
+
+# 서버 JVM 옵션. 비워 두면 -XX:+ExitOnOutOfMemoryError만 적용한다. 값을 넣으면 이 값으로 바뀌므로 그 옵션도 함께 쓴다.
+# 예: -XX:+ExitOnOutOfMemoryError -XX:MaxRAMPercentage=50
+SERVER_JAVA_OPTS=
+
+# 종료 신호(재시작·배포) 뒤 처리 중인 요청을 기다리는 시간과 docker가 강제 종료하기까지의 유예 시간.
+# 비워 두면 30s / 45s다. 유예 시간이 대기 시간보다 길어야 한다. 얼굴 AI 응답 대기(FACE_AI_RESPONSE_TIMEOUT, 기본 30s)보다 짧게 줄이지 않는다.
+SHUTDOWN_TIMEOUT=
+SHUTDOWN_GRACE_PERIOD=

build.gradle

@@ -32,6 +32,7 @@ dependencies {
     implementation 'com.github.themoment-team:datagsm-oauth-sdk-java:1.6.0'
     implementation 'com.github.themoment-team:datagsm-openapi-sdk-java:1.7.0'
     implementation 'com.squareup.okhttp3:okhttp:4.12.0'
+    implementation 'com.github.ben-manes.caffeine:caffeine'
     implementation 'org.springframework.boot:spring-boot-starter-session-data-redis'
     implementation 'org.springdoc:springdoc-openapi-starter-webmvc-ui:3.1.1'
     compileOnly 'org.projectlombok:lombok'

compose.prod.yaml

@@ -17,6 +17,8 @@ services:
       DB_URL: jdbc:postgresql://postgres:5432/checkup
       DB_USERNAME: ${DB_USERNAME}
       DB_PASSWORD: ${DB_PASSWORD}
+      DB_POOL_SIZE: ${DB_POOL_SIZE:-10}
+      DB_POOL_TIMEOUT_MS: ${DB_POOL_TIMEOUT_MS:-10000}
       REDIS_HOST: redis
       REDIS_PORT: 6379
       DATAGSM_CLIENT_ID: ${DATAGSM_CLIENT_ID}
@@ -26,13 +28,21 @@ services:
       DATAGSM_WEBHOOK_SECRET: ${DATAGSM_WEBHOOK_SECRET}
       PUBLIC_ORIGIN: ${PUBLIC_ORIGIN}
       SESSION_COOKIE_SECURE: ${SESSION_COOKIE_SECURE}
-      # .env에 빈 값으로 두면 application.yaml의 기본값(7d)이 적용되지 않으므로 여기서 기본값을 준다(#156).
-      SESSION_TIMEOUT: ${SESSION_TIMEOUT:-7d}
-      SWAGGER_ENABLED: ${SWAGGER_ENABLED}
+      # .env에 빈 값으로 두면 application.yaml의 기본값(30d)이 적용되지 않으므로 여기서 기본값을 준다(#156).
+      SESSION_TIMEOUT: ${SESSION_TIMEOUT:-30d}
+      # 운영은 기본 비공개다. .env에 빈 값으로 두어도 false가 되도록 여기서 기본값을 준다(#100).
+      SWAGGER_ENABLED: ${SWAGGER_ENABLED:-false}
       QUERY_LOG_ENABLED: ${QUERY_LOG_ENABLED:-false}
       FACE_SERVICE_TOKEN: ${FACE_SERVICE_TOKEN}
       FACE_AI_BASE_URL: ${FACE_AI_BASE_URL}
       CHECKUP_ADMIN_DATAGSM_IDS: ${CHECKUP_ADMIN_DATAGSM_IDS:-}
+      # 메모리가 모자라 OutOfMemoryError가 나면 반쯤 죽은 채 응답하지 않고 종료해, restart 정책이 다시 띄우게 한다.
+      # 힙 크기는 정하지 않는다(기본: 호스트 메모리의 25%). 필요하면 SERVER_JAVA_OPTS에 -XX:MaxRAMPercentage=... 를 함께 넣는다.
+      JAVA_TOOL_OPTIONS: ${SERVER_JAVA_OPTS:--XX:+ExitOnOutOfMemoryError}
+      # 종료 신호 뒤 처리 중인 요청을 기다리는 시간(#233). 비워 두어도 기본값이 적용되도록 여기서 기본값을 준다.
+      SHUTDOWN_TIMEOUT: ${SHUTDOWN_TIMEOUT:-30s}
+    # docker가 SIGKILL로 강제 종료하기 전까지 기다리는 시간. SHUTDOWN_TIMEOUT보다 길어야 한다(기본 10초면 얼굴 요청이 끊긴다).
+    stop_grace_period: ${SHUTDOWN_GRACE_PERIOD:-45s}
     # DB·Redis까지 닿아야 healthy다(REQ-OPS-001). 로그인 없이 열린 경로는 /actuator/health뿐이다.
     healthcheck:
       test: ["CMD", "curl", "-fsS", "-m", "5", "http://127.0.0.1:8080/actuator/health"]