[Deploy] PostgreSQL·AI Runtime 기반 데모 배포 구성

[hywznn]

한 줄 목표

시연자 PC의 LM Studio 없이 Client + Spring Boot Server + PostgreSQL 16 + AI Runtime이 재현 가능한 HTTPS 데모 환경에서 끝까지 동작하도록 배포 설정과 Smoke Test를 확정합니다.

현재 상태 (2026-08-19)

인프라 최초 적용은 완료됐습니다.

• Namespace·PostgreSQL 16·Server·AI·Client Deployment/Service
• Server /app/data/files PVC와 fsGroup: 10001
• HTTPS Ingress와 Client·Server 공개 주소
• postgres-secret, server-env, ai-env 주입 구조
• Server GHCR 이미지 배포와 rollout 실패 감지
• Prometheus 수집 구성
• Swagger/OpenAPI·DB 문서 GitHub Pages 배포

따라서 기존의 “Infra #104 최초 적용 대기”는 더 이상 선행조건이 아닙니다.

현재 차단 원인

배포 환경의 Renewal 호출은 AI #69에서 다음 응답으로 중단됩니다.

guideFailureCode=LANGUAGE_ASSISTANT_NOT_CONFIGURED
guideReviewRequired=true

Server가 Renewal endpoint까지 호출하는 것은 확인됐지만, AI Pod의 Language Assistant 설정 또는 실제 Provider 초기화가 끝나지 않아 근로자 안내 초안과 다음 문서 단계로 진행하지 못합니다.

• AI 이슈: [Bug] renewal-run 응답 중 "guide_failure_code": "LANGUAGE_ASSISTANT_NOT_CONFIGURED" ai#69
• 후속 배포 E2E: [E2E] 제품 대표 복합 요청 시나리오·데모 런북 완성 #10

설정 소유권

Secret	담당 설정
postgres-secret	PostgreSQL bootstrap·runtime·migration 계정
server-env	DB·JWT·CORS·FileStorage·AI endpoint/credential·SMTP·SMS·Prometheus 인증
ai-env	내부 API Token·Intent 모델·Hugging Face·CLOVA OCR·LLM·Knowledge 경로

실제 Secret 값은 Git·Issue·Wiki·Actions 로그에 기록하지 않습니다.

Server가 사용하는 주요 AI 설정

AI_RUNTIME_ENABLED
AI_RUNTIME_ENDPOINT
AI_RUNTIME_RENEWAL_ENDPOINT
AI_DOCUMENT_GENERATION_ENDPOINT
AI_DOCUMENT_CONVERSION_ENDPOINT
AI_RUNTIME_SERVICE_CREDENTIAL
AI_RUNTIME_OVERALL_TIMEOUT
AI_OCR_ENABLED
AI_OCR_ENDPOINT
AI_OCR_SERVICE_CREDENTIAL

AI_RUNTIME_SERVICE_CREDENTIAL과 AI 내부 Bearer Token은 같은 값이어야 합니다. LLM·Hugging Face·CLOVA Provider Key는 Server가 아니라 ai-env에 둡니다.

남은 배포 작업

• AI feat: 데모 사업장 및 근로자 시드 데이터 확장 #69 해결 후 guideFailureCode=null인 Renewal 응답 확인
• Server Pod → AI PLAN/ANALYZE·Renewal·OCR·문서 생성/변환 접근 확인
• 실제 Client 주소와 GitHub Pages Swagger CORS 확인
• 배포 환경 Golden Case E2E 완료
• Server·AI 재시작 뒤 미완료 Run·Outbox 복구 확인
• 직전 정상 이미지 rollback rehearsal
• Secret 값이 로그·오류 응답에 노출되지 않는지 확인

배포 Smoke 순서

1. rollout·readiness·/health
2. 로그인·/auth/me·타 사업장 차단
3. POST /api/v1/ai-runs의 실제 PLAN → ANALYZE
4. Candidate 채택 → Case·Task → 승인
5. Renewal → Language Assistant → Worker Link 안내
6. Worker Link → 응답·파일 → OCR → State 병합
7. 생성 문서 저장·미리보기·다운로드
8. 완료·감사로그·재시작 복구
9. rollback rehearsal

완료 조건

• 개발자 PC가 꺼져도 동일 HTTPS URL에서 대표 시나리오가 동작합니다.
• Demo Seed는 합성 데이터만 사용하고 운영 prod에서는 비활성화됩니다.
• 실제 Provider를 켠 Product Smoke와 rollback rehearsal가 통과합니다.
• 배포 결과와 장애 복구 방법이 Runbook에 기록됩니다.

후속: #10 · 상위: #2 · 외부 차단: fowoco/ai#69