image service

README.md

@@ -51,6 +51,13 @@ password 24자, game/bootstrap token 32자, 최초 관리자 password 16자입
 시즌을 보존하고, `DB 초기화 배포`는 scenario를 다시 seed합니다. Gateway 자체의
 배포와 이전 commit rollback은 같은 화면의 별도 release 영역에서 처리됩니다.
 
+이미지 서비스 연동에는 서버 간 접근 URL `IMAGE_SERVICE_URL`, 브라우저 공개 URL
+`IMAGE_PUBLIC_URL`과 서로 다른 두 secret 파일이 필요합니다. 업로드 secret은
+Gateway 전용 아이콘과 game-api 편집기 첨부에만 사용하고, sync secret은 Gitea
+webhook 누락 시 `docker compose exec runtime pnpm sync:image`로 현재 이미지
+branch의 fast-forward를 요청할 때만 사용합니다. 두 파일은 runtime에 read-only로
+mount되며 원문은 환경 변수나 브라우저 bundle에 들어가지 않습니다.
+
 ## 데이터와 복구 경계
 
 - PostgreSQL, Redis, Core clone/worktree, PM2 상태, Caddy 인증서와 user icon은