starium.club 54 페이지 i18n 완성 + lang switch 자동 감지

작성일: 2026-05-17 작성자: 이만우 / Claude (Opus 4.7 1M) 위치: paperclip / /opt/star365-ceo/public/starium-global/ 관련 메모리: [[starium-club-i18n-mass-translation-20260517]], [[feedback_i18n-dir-split-without-translation]]

1. 발견

사용자 1차 신고: https://starium.club/programs/bm-medical 페이지에 한국어가 가득 보임 — 글로벌 사용자도 한국어 표시.

근본 원인 3단계:

navigator.language 자동 감지 부재: lang prefix 없는 URL(/programs/<slug>) → root 파일 응답 → <html lang="ko"> 하드코딩, JS는 localStorage.getItem('sg_lang')만 조회. 첫 방문자는 무조건 ko.
5/16 i18n 작업 "디렉토리 분리만 하고 본문 번역 누락": ko/zh/en/mn/programs/<slug>.html 4 sub-lang 디렉토리만 생성하고 콘텐츠는 한국어 그대로. zh 클릭 시 zh span 안에 한국어 그대로 표시.
사용자 직작업 콘텐츠가 lang-content span "밖" plain HTML: 송지효 동영상, By the Numbers 카드, 5/16 신규 작업 페이지(STARJET/Head Spa/GFF/FPMU/G-WAVE/Foot Care) — 모두 lang-content span 패턴 없이 plain HTML 한국어로 작성.

2. 처리 (오늘 누적)

Phase 1 — navigator.language 자동 감지 폴백 (54 root)

3 cluster localStorage key (sg_lang / lang / starium-lang) cross-cluster fallback chain
한국 브라우저 → ko / 중국 → zh / 몽골 → mn / 기타 → en

Phase 2 — 41 페이지 zh/en/mn span 일괄 번역 (6 subagent 병렬)

5/16 i18n 누락된 페이지 일괄 번역
6 buckets balanced (각 ~4000 잔존 한글)
5 위치 동기화 (ko/zh/en/mn/root)
615/615 cell PASS (한글 < 50)

Phase 3 — bm-medical 사용자 콘텐츠 복원

root와 ko 디렉토리가 다른 콘텐츠 보유. 사용자가 본 root 백업으로 복원.
ko sub-lang에도 동기화 + zh/en/mn 번역
15 cell PASS

Phase 4 — 5 페이지 사용자 직작업 복원 + plain HTML 4-lang 래핑

photon-therapy (송지효 동영상, By the Numbers 4 카드 등 plain HTML 117건)
hyperbaric-oxygen / device-hilight / device-supersonic / mct-stem-cell
BeautifulSoup으로 element 단위 4-lang span 래핑 + 번역
5 페이지 모두 outside_ko 1359~507 → 0

Phase 5 — 6 페이지 5/16 신규 작업 root sync (6 subagent 병렬)

head-spa / fpmu-semi-perm / g-wave-lifting / foot-care / starcell-intensive / starjet-regen
ko 디렉토리는 이미 4-lang 완성 상태, root만 옛 plain HTML 잔존
ko → zh/en/mn/root 5위치 sync + navigator.language 폴백 주입

3. 최종 정량 (54 root 페이지)

카테고리	페이지 수
완전 클린 (in_zh=0, in_en=0, in_mn=0, outside_ko=0)	47
의도된 고유명사 잔존 (< 50)	7
전체 PASS	54/54 ✅

의도된 잔존 (고유명사)

treatments-overview: 한국 법명/기관명 45자 (의료법/식약처)
itinerary: 인천공항/병원명 14-28자
device-tentriple: 식약처 인증명 6자
device-multiblue: 식약처 3-6자
nitric-oxide: 한국식 한자명 3자
bm-card: 19자
vip-tour: mn에 "강남" 4자

4. 정책 신설

[[feedback_i18n-dir-split-without-translation]]

i18n "디렉토리 분리"와 "본문 번역"을 혼동하지 말 것. lang-content span "안" 한글 카운트로 정량 검증 (cross-lang 위장 차단). 5 위치 동기화 의무 (ko/zh/en/mn/root).

# 정확한 정량 패턴
for lang in ['zh','en','mn']:
  matches = re.findall(rf'data-lang="{lang}">(.*?)</', text)
  inside_hangul = sum(len(re.findall(r'[가-힣]', m)) for m in matches)

단순 grep -c '[가-힣]'는 cross-lang span 한글까지 합산되어 false PASS 발생.

lang-content span "밖" plain HTML도 검증

from bs4 import BeautifulSoup, Comment
soup = BeautifulSoup(html, 'html.parser')
for s in soup.find_all(class_='lang-content'): s.decompose()
for s in soup.find_all(['script','style','title']): s.decompose()
for c in soup.find_all(string=lambda x: isinstance(x, Comment)): c.extract()
outside = len(re.findall(r'[가-힣]', soup.get_text(' ', strip=True)))

5. 안전 보존

송지효 youtube iframe (embed/4wU00pvwnGI) 보존
시술 영상 mp4 (STARJET 16MB, Head Spa 84MB, G-WAVE 등) 보존
모든 img src / iframe src 보존
HTML 구조/class/id/data-* 보존
가격 노출 0/54 ([[feedback_no-price-on-public-pages]])

6. 파일 변경

총 270+ 파일 (54 root + 54×4 sub-lang + 백업)

백업 위치

_archive_bak/20260517080846/programs/*.html.bak-autodetect (navigator fix 전)
_archive_bak/20260517081825/programs/*.html.bak-pre-ko-sync (ko sync 전)
ko/programs/*.html.bak-5-16-i18n-version (5/16 i18n 버전)
subagent별 .bak-i18n-20260517 등 다중 백업

7. 라이브 검증

54 root URL https://starium.club/programs/<slug> 모두 HTTPS 200
4 sub-lang URL /{ko,zh,en,mn}/programs/<slug> 모두 200
캐시 강제 새로고침 + localStorage 초기화 후 OS 언어에 따라 자동 lang 표시 확인