[2026.11.04] Track 01 7부작 아키텍처 재편과 공식 안내서(/guide/) 신설

엔지니어링 일지 요약: Track 01을 7부작 서사(Warm-up, Lap 1~5, Finish Line)로 완결하고, 첫 방문자를 위한 공식 안내서(/guide/) 신설 및 모바일 2중 안전장치와 사이트 정보 구조(IA)를 전면 개편한 기록입니다.

1. 오늘의 주요 작업 및 설계 결정 (Key Decisions & Changes)

• Track 01 총 7부작(7-Lap) 아키텍처 재편:
• 기존 Lap 5에 혼재되어 있던 “Dockerfile Pre-baking 프론트엔드 최적화”와 “완성 아키텍처 총정리”를 분리.
• Lap 00 (Warm-up Lap): 출발선 — 초기 청사진과 5대 장벽, 6대 ADR 탄생 비화.
• Lap 01 ~ 05: 5개의 실전 랩(리전 피벗, 1GB DB 튜닝, Keyless ADC, WAF 보안, Pre-baking).
• Lap 06 (Finish Line): 결승선 — 월 0원 서버리스 풀스택 청사진, 정량 성과표, 6대 ADR 총괄표 신설.
• 0~6편 전 포스트 상단에 7-Lap 브레드크럼 바 및 내비게이터 배지 라벨(🏁 Warm-up, 🏁 Lap 01~05, 🏁 Finish Line) 100% 동기화.
• 공식 안내서 페이지(/guide/) 신설 및 스마트 시더 연동:
• docs/guide.md 원고 작성: 부의 포디움 3대 불변 원칙(No Guessing, Zero Cost, Building in Public)과 5대 트랙 로드맵 집필.
• wealth-podium-seed.php에 page 타입 스마트 시딩 파이프라인 추가 (Git 마크다운 기반 무인 자동 배포).
• 사이트 정보 구조(IA) 및 내비게이션 최적화:
• 홈 Bento Hero 메인 CTA를 🧭 블로그 안내서 & 로드맵 보기 → (/guide/)로 재매핑.
• 상단/모바일 메뉴 위계 통일: 홈 ➔ 안내서 ➔ Track 01 ➔ Track 02 ➔ Track 03 ➔ Pit-In ➔ Build Log.
• 모바일 햄버거 메뉴 2중 안전장치 탑재: Kadence 모바일 내비게이션 렌더러와 wp_nav_menu_items 필터에 안전장치를 걸어 모바일 최상단에 🏁 홈과 🧭 안내서가 항상 고정 노출되도록 구현.

2. 핵심 아키텍처 도식 (Architecture Summary)

flowchart LR
    L0["🏁 Warm-up Lap<br/>(5대 장벽 & 6대 ADR)"]
    --> L1["🏎️ Lap 01<br/>(us-west1 리전 피벗)"]
    --> L2["🔧 Lap 02<br/>(1GB DB 2GB Swap)"]
    --> L3["💥 Lap 03<br/>(Keyless ADC 미디어)"]
    --> L4["🛡️ Lap 04<br/>(Cloudflare WAF 보안)"]
    --> L5["📦 Lap 05<br/>(Dockerfile Pre-bake)"]
    --> L6["🏆 Finish Line<br/>(완성 Blueprint & 성과)"]

3. 트러블슈팅 & 기술 검증 (Troubleshooting & Verification)

• 발생 문제 1: 모바일 오프캔버스 메뉴에서 카테고리만 나열되어 홈 화면으로 복귀하는 명시적 경로 부재.
• 해결 조치: Kadence 모바일 내비게이션 훅 및 wp_nav_menu_items 필터에 2중 안전장치 추가하여 🏁 홈과 🧭 안내서 최상단 고정.
• 발생 문제 2: 기존 워드프레스 스마트 시더가 post 타입만 처리하여 신규 안내서(/guide/) 정적 페이지가 자동 생성되지 않음.
• 해결 조치: page 포스트 타입 스마트 시딩 로직을 추가하고 cloudrun_wealth_podium_seeded_v5 옵션 연동으로 Git 수정 시 무인 배포 보장.
• 검증 결과: 데스크톱 및 모바일(<=768px) 환경에서 /guide/ 페이지 정상 노출 및 홈 복귀 경로 100% 작동 확인.

4. 완료 산출물 및 다음 단계 (Deliverables & Next Steps)

• 완료 산출물:
• docs/guide.md (공식 종합 안내서)
• docs/track-01-posts/lap-06-finish-line-serverless-architecture-blueprint.md (Track 01 피날레)
• mu-plugins/wealth-podium-seed.php (페이지 시딩 및 7편 매니페스트 동기화)
• mu-plugins/wealth-podium-design.php (IA 메뉴 및 모바일 2중 안전장치)
• 다음 단계: 1호 인사이트 리서치 칼럼(docs/pit-in-posts/) 집필 및 실서버 배포.