현재 작업 상태 저장

docs/DEPLOYMENT.md

@@ -37,6 +37,7 @@ docker compose up -d
 | `POSTGRES_PASSWORD` | DB 비밀번호(필수) |
 | `SESSION_SECRET` | 세션 서명키(필수, 랜덤) |
 | `AUTH_ALLOWED_EMAIL_DOMAINS` | Google 로그인 허용 이메일 도메인(JSON 배열). 기본 `["hs.ac.kr","twentyoz.kr"]`. Google Console authorized domains가 아니라 서버에서 `email`/`hd` claim으로 강제 |
+| `FRONTEND_ORIGIN_MAP` | API callback host → frontend origin 매핑(JSON 객체). 기본 `api-vignette.chanpaca.net → vignette.chanpaca.net`, `api-vnet.18ka.net → vnet.18ka.net` |
 | `OPENAI_API_KEY` | 음성(STT/TTS) |
 | `ANTHROPIC_API_KEY` | 엔진 폴백/클라우드 모드 |
 | `ENGINE_MODE` / `ENGINE_URL` | 엔진 위치(위 표) |
@@ -48,6 +49,16 @@ docker compose up -d
 
 두 가지 — 호스트 상황에 맞게:
 - **Caddy 자동 TLS**: 공인 IP·도메인 있으면 `SITE_ADDRESS=vignette.chanpaca.net` + `ACME_EMAIL` → Caddy가 인증서 자동 발급.
+
+## 4.1 vnet.18ka.net 공개 경로
+
+`vnet.18ka.net`을 공개 Google OAuth로 쓰려면 세 조건이 같이 맞아야 한다.
+
+1. DNS: `vnet.18ka.net`은 웹, `api-vnet.18ka.net`은 API로 라우팅되어야 한다.
+2. API 설정: `CORS_ORIGINS`에 `https://vnet.18ka.net`, `FRONTEND_ORIGIN_MAP`에 `api-vnet.18ka.net=https://vnet.18ka.net`이 있어야 한다.
+3. Google Cloud Console: Authorized redirect URI에 `https://api-vnet.18ka.net/auth/callback`을 추가해야 한다.
+
+현재 이 저장소의 코드와 `scripts/start-public-runtime.ps1`은 2번을 회귀 테스트와 기본값으로 고정한다. 1번과 3번은 외부 콘솔/도메인 소유자 설정이다.
 - **Cloudflare/Tailscale 터널**: 공인 IP 없을 때(네 PC). 단 **음성 SSE/WSS는 버퍼링 충돌**이 있어 Caddyfile에서 `flush_interval -1`로 흘려보냄(red team F-07 반영). 터널도 SSE 무버퍼 경로 분리 권장.
 
 ## 5. 스케일업 / 이전