Starium Global Phase 4 Sprint — 2026-05-09

요약

Phase 3 후속. 사용자 명령(임시관리자) 기반 10 후보 중 6개 자율 진행 (Cloudflare DNS / 카카오·WeChat·LINE 공식 채널 / Case Study 환자 동의 / Plausible/GA4 계정 / MN 번역은 사용자 액션). 7 task 모두 PASS — 자동 답장 코드 / Discord 분기 / Web Vitals 측정 / Service Worker / A/B variant 실 콘텐츠 + E2E 검증.

E2E 결과 (모두 PASS)

항목	결과
Inquiry 자동 답장	nodemailer 설치 + STARIUM_SMTP_* env 추가 + locale별 ko/zh/en 템플릿 + auto_reply_sent_at 기록. 현 자격증명 invalid (Gmail App Password 사용자 액션 필요) — 코드는 활성, valid 자격증명 입력 시 즉시 작동
Discord webhook 분기	DISCORD_WEBHOOK_URL env 보유 (hermes phase 5 잔존) → inquiry POST 후 자동 발송
Core Web Vitals	LCP / FCP / CLS / INP 4개 측정 (자체 PerformanceObserver) → /api/event web_vital 자동 수집
Service Worker	/starium-global/sw.js (2.1KB, stale-while-revalidate HTML + cache-first 이미지/CSS) + manifest.json + Service-Worker-Allowed header
A/B variant 실 콘텐츠	hero_cta_v1 실험 자동 시작: visitor_id (localStorage) + sessionStorage 캐시 + variant B = bg-rose-500 (vs 기존 bg-slate-900) + data-track-cta 자동 첨부
sitemap	48 URLs 유지
페이지 총합	53 (Phase 3 대비 변화 없음, 기능 추가만)
트레이딩 / 서비스	모두 active

작업 (Phase 4A → 4B → 4C)

Phase 4A (병렬 4개)

A-1 Inquiry 자동 답장:
- 인프라 점검: paperclip(0), kahan/gunja(SMTP), hospital/legal·assistant(SMTP), multica(Resend example)
- gunja .env에서 SMTP 자격증명을 /etc/star365-worker.env에 STARIUM_SMTP_* 접두사로 복사
- npm i nodemailer (paperclip)
- server.mjs /starium-global/api/inquiry 끝에 nodemailer.createTransport.sendMail + locale별 ko/zh/en 템플릿 + UPDATE auto_reply_sent_at
- Verify 결과: Invalid login: 534-5.7.9 Please log in with your web browser — Gmail 일반 비밀번호 → App Password 필요. 코드는 활성, 사용자가 valid SMTP 자격증명 입력 시 즉시 작동
A-2 Discord webhook 분기:
- DISCORD_WEBHOOK_URL 이미 /etc/star365-worker.env에 존재 (hermes phase 5 잔존)
- inquiry POST 후 Discord 알림 추가 (Telegram과 별도, fire-and-forget)
- 메시지: 📨 Starium Global 신규 문의 #{id} {locale_flag} + type/name/email/phone/message
A-3 Core Web Vitals:
- 자체 PerformanceObserver (web-vitals 라이브러리 미사용 — 외부 의존성 0)
- LCP / FCP / CLS / INP 4개 측정 (Google Core Web Vitals 표준)
- rating: good / needs_improvement / poor (Google 임계값 동일)
- pagehide 이벤트로 CLS/INP 발송 (정확)
- /api/event web_vital 이벤트로 자동 수집 → starium_global_events 테이블
A-4 Service Worker (PWA):
- /starium-global/sw.js 2.1 KB
- install: precache /starium-global + tw.min.css
- cache strategy:
  - cache-first: .webp/.avif/.jpg/.png/.svg/.css/.woff2
  - stale-while-revalidate: HTML 페이지
- skipWaiting + clients.claim
- LRU cache (CACHE_LIMIT=60)
- manifest.json + theme_color #10b981 + standalone display
- server.mjs Service-Worker-Allowed header /starium-global (root scope 부여)

Phase 4B (1개)

B-1 A/B variant 실 콘텐츠 (hero_cta_v1):
- STARIUM_AB(experiment_key) 함수 노출 → /api/ab-assign 자동 호출 + sessionStorage 캐시
- window.STARIUM_VARIANT = {experiment, variant} 자동 설정
- STARIUM_TRACK 자동으로 meta에 variant 첨부 (/api/event)
- hero_cta_v1: 메인 페이지 contact CTA 버튼
  - Variant A (control): bg-slate-900 (기존)
  - Variant B (실험): bg-rose-500 (강조 색상)
  - 둘 다 data-track-cta="hero_cta_v1_{A|B}" 자동 추가 → click 추적
- 50 페이지(메인 + 11 + 3 메인 prerender + 33 언어별 + admin 일부)에 통합 v2 client script 주입

Phase 4C: E2E + cleanup

6 항목 모두 PASS (web_vital 4 + service worker 200 + A/B framework + Discord env 활성)
테스트 ab_assignment + web_vital 이벤트 정리

미완료 (사용자 액션 필요)

SMTP 자격증명 — Gmail App Password 발급 또는 SendGrid/Mailgun/Resend API 가입 → STARIUM_SMTP_* env 갱신 시 자동 답장 즉시 작동
카카오/WeChat/LINE 공식 채널 — 채널 발급 후 QR 교체
Case Study 실 데이터 — 환자 동의 받은 후기 (의료광고법)
MN(몽골어) 번역 — 별도 번역 작업 또는 LLM 번역 (xAI/Gemini)
Cloudflare DNS — DNS 전환 액션
Plausible/GA4 — 계정 가입 → 자체 시스템 외 추가 분석 (현재는 자체로 충분)

변경 파일

신규

/starium-global/sw.js (Service Worker 2.1 KB)
/starium-global/manifest.json (PWA manifest)
/tmp/sg-build/sg-client-v2.js (통합 클라이언트 스크립트 — 추적 + Web Vitals + SW register + A/B)

수정

/opt/star365-ceo/server.mjs: +sw.js / manifest 라우트 + inquiry POST 자동 답장 + Discord webhook 분기 (~80 LOC)
/etc/star365-worker.env: +STARIUM_SMTP_HOST/PORT/USER/PASSWORD (gunja SMTP에서 복사)
50 HTML 페이지: 추적 v1 → v2 (Web Vitals + SW register + A/B 통합)
/opt/star365-ceo/node_modules/nodemailer 신규 dep

DB

변경 없음 (Phase 3에서 추가한 starium_ab_assignments + starium_global_inquiries 그대로 활용)

안전 점검

✅ 트레이딩 (gunja-pair-hedge / gunja-multi-tenant / gate-pair-hedge) active
✅ DB DROP 0 / UFW 0 / nginx 0
✅ Service Worker scope /starium-global로 제한 (다른 path 영향 0)
✅ A/B variant deterministic (sha256) — 동일 visitor 재방문 시 동일 variant 보장
✅ Web Vitals 측정 0 추가 의존성 (web-vitals 라이브러리 미사용)
✅ 모든 클라이언트 스크립트 try/catch wrap — 실패 시 silent (사용자 경험 무영향)

CEO 사용 가이드 (Phase 4)

자동 답장 활성 (사용자 액션)

# Gmail App Password (https://myaccount.google.com/apppasswords) 또는 SendGrid 가입
# /etc/star365-worker.env 편집:
sudo nano /etc/star365-worker.env
# STARIUM_SMTP_PASSWORD=<App Password 16 char> 갱신 후
sudo systemctl restart star365-ceo

Web Vitals 통계 조회

CEO_KEY=$(cat /root/.ceo_access_key)
psql "postgres://paperclip:REDACTED-20260611@localhost:5432/star365_hub" -c "
SELECT meta->>'name' AS metric, meta->>'rating' AS rating, COUNT(*),
       AVG((meta->>'value')::int) AS avg_ms, percentile_disc(0.75) WITHIN GROUP (ORDER BY (meta->>'value')::int) AS p75
FROM starium_global_events
WHERE event_type='web_vital' AND created_at > NOW() - INTERVAL '7 days'
GROUP BY 1,2 ORDER BY 1,2"

A/B 결과 조회

CEO_KEY=$(cat /root/.ceo_access_key)
curl -sk -H "X-CEO-Key: $CEO_KEY" "https://ceo.star365.site/api/starium-global/ab-results?experiment_key=hero_cta_v1"

Phase 5 후보 (남은 작업)

사용자 액션 필요 (블로킹)

SMTP 자격증명 (Gmail App Password 또는 SendGrid)
Cloudflare DNS
카카오·WeChat·LINE 공식 채널 발급
Case Study 환자 동의 콘텐츠

Claude 자율 가능 (남은 옵션)

MN 페이지 LLM 자동 번역 (xAI grok-3-mini 또는 Gemini)
inquiry → Slack webhook 추가 (Discord 외)
Web Vitals 대시보드 카드 (admin/index.html에 추가)
A/B 추가 실험 (button 색상 외 hero copy A/B)
이미지 lazy-load IntersectionObserver fallback (현 loading=lazy attr만)
Critical CSS 인라인 (above-the-fold 스타일만 inline)
RSS feed (programs 11개)
다국어 sitemap index (sitemap-ko.xml + sitemap-zh.xml + sitemap-en.xml)
Plausible 자체 호스팅 (Docker 컨테이너 추가)

메모리/보고서

보고서: /opt/star365-hq/docs/04-report/starium-global-phase4-20260509.md (현 파일)
메모리: starium-global-phase4-20260509.md