[ppp1969]

작업 내역 요약

Render Free 512MB 안정화 이후, 3~4명 동시 업로드/분석 요청을 더 안전하게 처리하기 위한 후속 개선 방향을 문서화했습니다.

Closes #141

변경 사항

• docs/RENDER_FREE_CONCURRENCY_IMPROVEMENT_PLAN.md 문서를 추가했습니다.
• OOM 방어 PR Fix: Render Free 플랜 메모리 초과 종료 대응 #140 이후에도 남는 병목을 정리했습니다.
  • DB 커넥션 풀 대기
  • 트랜잭션 안에서 수행되는 S3/OpenAI/EPUB 파싱 외부 I/O
  • CallerRunsPolicy로 인한 요청 스레드 장시간 점유 가능성
  • EPUB 정규화와 relationship delta import executor 공유 문제
• 성능 상향 전 선행 조건을 정리했습니다.
  • 외부 I/O를 트랜잭션 밖으로 분리
  • queue full 응답 명확화
  • 작업 유형별 executor 분리 검토
  • Render 메모리/DB/queue 계측 후 단계적 상향
• Render Free 안정 기본값과 1GB 이상 플랜에서 검토 가능한 상향 후보 환경변수를 문서화했습니다.

Code Review

• 이번 PR은 코드 변경 없이 문서만 추가합니다.
• 즉시 worker 수를 늘리는 제안이 아니라, worker 수를 안전하게 늘릴 수 있는 구조 개선 순서를 정의합니다.
• #140의 OOM 방어 설정과 충돌하지 않고, 추후 트랜잭션 범위/큐 정책 개선 PR의 기준 문서로 사용합니다.
• 테스트: 문서 변경만 있으므로 별도 테스트는 실행하지 않았습니다.

문서에 명시한 Render Free 안정 기본값:

JAVA_TOOL_OPTIONS=-Xms64m -Xmx256m -XX:+UseSerialGC -XX:ActiveProcessorCount=1 -XX:MaxMetaspaceSize=128m -XX:ReservedCodeCacheSize=64m -XX:MaxDirectMemorySize=32m -Xss256k -XX:+ExitOnOutOfMemoryError
DB_MAX_POOL_SIZE=2
DB_MIN_IDLE=1
SPRING_MAIN_LAZY_INITIALIZATION=true
SPRINGDOC_ENABLED=false
HIBERNATE_DEFAULT_BATCH_FETCH_SIZE=100

ScreenShot

문서 변경이라 스크린샷은 없습니다.