feat(infra): 이식 가능한 Docker 배포 구성

- docker-compose.yml: web/api/db(pgvector)/rag/proxy 한 방 기동
- 엔진 어댑터 분리: ENGINE_URL/ENGINE_MODE로 로컬 claude -p ↔ API 전환(코드 무수정 이전)
- Caddy: 자동 TLS + SSE flush/WSS 무버퍼(실시간 음성)
- DEPLOYMENT.md: 이식/엔진분리/스케일업/외부노출 가이드
- 페이지 레이아웃 시안 6종(login/learner-home/session-review/professor/admin/settings)

infra/docker-compose.yml

@@ -0,0 +1,100 @@
+# Vignette — 이식 가능한 단일 호스트 배포 구성
+# 어디서든:  cp .env.example .env && (값 채우고) && docker compose up -d
+#
+# 설계 원칙:
+#  - web/api/db/voice/rag 는 전부 컨테이너 → 호스트 무관하게 한 방에 뜬다.
+#  - "엔진"(로컬 claude -p)만 컨테이너 밖. api 는 ENGINE_URL 로 가리킨다.
+#    → 옮길 때 ENGINE_URL 한 줄만 바꾸면 됨(로컬 게이트웨이 ↔ API 폴백).
+#  - 시크릿/엔드포인트는 전부 .env. 이미지에 굽지 않는다(이식성).
+
+name: vignette
+
+services:
+  db:
+    image: pgvector/pgvector:pg16
+    restart: unless-stopped
+    environment:
+      POSTGRES_USER: ${POSTGRES_USER:-vignette}
+      POSTGRES_PASSWORD: ${POSTGRES_PASSWORD:?set in .env}
+      POSTGRES_DB: ${POSTGRES_DB:-vignette}
+    volumes:
+      - pgdata:/var/lib/postgresql/data
+      - ./db/init:/docker-entrypoint-initdb.d:ro   # 스키마/확장 초기화 SQL
+    healthcheck:
+      test: ["CMD-SHELL", "pg_isready -U ${POSTGRES_USER:-vignette}"]
+      interval: 10s
+      timeout: 5s
+      retries: 5
+    networks: [vignette]
+
+  api:
+    build:
+      context: ../apps/api
+      dockerfile: Dockerfile
+    restart: unless-stopped
+    depends_on:
+      db: { condition: service_healthy }
+    environment:
+      DATABASE_URL: postgresql://${POSTGRES_USER:-vignette}:${POSTGRES_PASSWORD}@db:5432/${POSTGRES_DB:-vignette}
+      # === 엔진(이식성 핵심) ===
+      # 로컬 운영: host 의 claude -p 게이트웨이를 가리킴(아래 extra_hosts 사용)
+      # 클라우드 이전: 이 값을 Messages API 어댑터 URL 로만 바꾸면 됨.
+      ENGINE_URL: ${ENGINE_URL:-http://host.docker.internal:9099}
+      ENGINE_MODE: ${ENGINE_MODE:-claude_p}          # claude_p | messages_api
+      ANTHROPIC_API_KEY: ${ANTHROPIC_API_KEY:-}      # 폴백/클라우드용
+      OPENAI_API_KEY: ${OPENAI_API_KEY:?set in .env} # 음성
+      RAG_EMBED_URL: http://rag:8080
+      SESSION_SECRET: ${SESSION_SECRET:?set in .env}
+    extra_hosts:
+      - "host.docker.internal:host-gateway"   # 컨테이너→호스트 엔진 게이트웨이 접근(Linux 포함)
+    healthcheck:
+      test: ["CMD", "python", "-c", "import urllib.request,sys; urllib.request.urlopen('http://localhost:8000/health'); "]
+      interval: 15s
+      timeout: 5s
+      retries: 5
+    networks: [vignette]
+
+  web:
+    build:
+      context: ../apps/web
+      dockerfile: Dockerfile
+      args:
+        VITE_API_BASE: ${PUBLIC_API_BASE:-/api}
+    restart: unless-stopped
+    depends_on: [api]
+    networks: [vignette]
+
+  # RAG 사이드카: BGE-M3 임베딩 + BGE-reranker-v2-m3 (CPU 가능, GPU 있으면 가속)
+  rag:
+    build:
+      context: ../apps/api
+      dockerfile: Dockerfile.rag
+    restart: unless-stopped
+    environment:
+      EMBED_MODEL: BAAI/bge-m3
+      RERANK_MODEL: BAAI/bge-reranker-v2-m3
+    volumes:
+      - ragmodels:/models   # 모델 캐시(재다운로드 방지 = 이식 시 볼륨만 옮기면 빠름)
+    networks: [vignette]
+
+  # 리버스프록시 + TLS. 외부노출(chanpaca.net)도 여기서. 끄려면 profiles 로 제외.
+  proxy:
+    image: caddy:2-alpine
+    restart: unless-stopped
+    depends_on: [web, api]
+    ports:
+      - "${HTTP_PORT:-8080}:80"
+      - "${HTTPS_PORT:-8443}:443"
+    volumes:
+      - ./Caddyfile:/etc/caddy/Caddyfile:ro
+      - caddydata:/data
+    networks: [vignette]
+
+volumes:
+  pgdata:
+  ragmodels:
+  caddydata:
+
+networks:
+  vignette:
+    driver: bridge