vignette/infra

infra

Docker Compose: web · api · postgres(pgvector) · Caddy proxy.

• API 이미지는 저장소 루트 컨텍스트에서 빌드한다. data/personas 같은 런타임 입력을 컨테이너 안 /app 기준으로 찾기 때문이다.
• 엔진 게이트웨이는 compose 밖 호스트 프로세스로 두고, API는 ENGINE_URL로 호출한다.
• RAG 임베딩/리랭커 의존성은 API 이미지 build arg INSTALL_RAG=true일 때만 설치한다. 기본 이미지는 슬림 모드이며 RAG 모델 미설정 시 앱이 명시적으로 degraded 처리한다.
• 배포 전 루트에서 python scripts/check-deploy-preflight.py --env-file infra/.env를 실행한다. 프리플라이트는 G3G8 내부 쓰기 토큰 6개가 각각 32자 이상이며 서로 다른 값인지 검사한다. DB까지 검증할 때는 API app-role DATABASE_URL을 넘기고 --require-app-role을 붙여 G0G8 migration sentinel과 RLS 역할을 함께 확인한다.
• Compose 음성 설정은 VIGNETTE_VOICE_STT_PROVIDER, DEEPGRAM_API_KEY, DEEPGRAM_STT_*와 VIGNETTE_VOICE_TTS_PROVIDER를 API에 주입한다. deepgram 선택 상태에서 key가 없고 OpenAI key만 있으면 runtime은 openai-batch-fallback을 보고할 수 있으므로, 배포 완료 판정에는 authenticated public WSS ready의 STT/TTS provider/model 네 값을 기대값과 정확히 비교하는 mic-free preflight를 사용한다.
• mic-free preflight는 장치 열거·캡처를 하지 않으며 물리 마이크/50분 증거가 아니다. full soak는 실행 직전 사용자 명시 동의와 --confirm-physical-capture가 있을 때만 장치를 연다. Higgs는 dev 전용이다. 운영 TTS는 OpenAI API gpt-4o-mini-tts로 고정하고 Services Agreement의 앱 통합·출력 소유 근거와 최종 사용자 AI 생성 음성 고지를 함께 유지한다. 배포 완료 시 public health/ready의 provider/model exact match를 증거로 남긴다.
• 배포·soak evidence에는 API key, auth cookie, session ID, 축어록, 응답 payload와 원음을 기록하지 않는다.