feat(phase-4): Pagefind·SEO·CI 가드로 출시 전 운영을 잠근다

[gitgitWi]

스택: base feat/phase-3-quiz ← head feat/phase-4-hardening — #60(phase-3)이 먼저 머지돼야 이 디프가 맞다. 그 전에는 #56 → #58 → #59 → #60 순서.

왜

출시 전 검색·SEO·공개안전·CI 게이트가 없으면 Pages 배포 후 회귀를 사람이 매번 수동으로 잡아야 한다. Phase 4는 Pagefind 검색, sitemap/RSS/OG, 404, leak-guard, CI를 한 스택 PR로 잠근다.

흐름

flowchart TD
  subgraph ASIS["AS-IS"]
    A1["PR 머지"] --> A2["deploy.yml만 존재"]
    A2 --> A3["검색·SEO·leak 검증 없음"]
  end
  subgraph TOBE["TO-BE"]
    B1["PR push"] --> B2["ci.yml 게이트"]
    B2 -->|"통과"| B3["build+pagefind+가드"]
    B2 -->|"실패"| B4["머지 차단"]
    B3 --> B5["Actions Pages 배포"]
  end
  style A3 fill:#ffebee,stroke:#c62828,color:#c62828
  style B3 fill:#e8f5e9,stroke:#2e7d32,color:#2e7d32
  style B4 fill:#fff3e0,stroke:#e65100,color:#e65100

Loading

sequenceDiagram
  participant Dev as Developer
  participant CI as ci.yml
  participant Build as bun run build
  participant PF as pagefind WASM
  participant Guard as check scripts
  Dev->>CI: push PR
  CI->>CI: check format lint test schema leak
  CI->>Build: generate-og astro build pagefind
  Build->>PF: index dist
  CI->>Guard: links search top-3 budget storybook
  Guard-->>Dev: green or fail

Loading

효과

flowchart LR
  P["이 PR"] --> U["사용자: /search 검색, RSS·sitemap, 404 안내"]
  P --> B["비즈니스: private·raw·secret leak CI 차단"]
  P --> O["운영: PR마다 11단 게이트, legacy-next 제거"]
  P --> Q["품질: schema Zod·Pagefind Top-3·50KB JS 예산"]

Loading

범위

flowchart TD
  subgraph IN["이번 PR"]
    I1["Pagefind + /search + WASM Top-3 check-search"]
    I2["sitemap RSS OG JSON-LD"]
    I3["404 NotFoundGuide"]
    I4["check-schema leak budget + ci.yml"]
    I5["legacy-next 삭제"]
  end
  subgraph NEXT["후속 — 사람"]
    N1["GitHub Pages Source=Actions 확인 후 gh-pages 브랜치 삭제"]
    N2["#56 머지 후 branch protection에 CI 필수 연결"]
  end
  subgraph OUT["제외"]
    X1["gh-pages 원격 삭제 — Pages=Actions 전환 후 사람"]
    X2["한국어 Pagefind stemming — Pagefind 한계"]
  end

Loading

검색 Top-3 (check-search)

Pagefind WASM search() 순위 — results.slice(0, 3)의 raw_url에 expected path 포함.

Query	Expected (rank ≤3)
리팩토링	/til/refactoring-javascript/01/
Personal Design System	/articles/design-system/01/
literal	/til/ts/enum-to-template-literal/

검증

$ bun run build && bun run check-search
check-search: OK (3 queries ranked top-3 via Pagefind WASM)

$ bun run check
Result (144 files): 0 errors

$ bunx oxfmt --check .
All matched files use the correct format.

$ bunx vitest run
 Test Files  7 passed (7)
      Tests  28 passed (28)

추가 로컬 게이트 (CI 동일):

$ node scripts/check-leak.mjs → check-leak: OK (103 publishable file(s) scanned)
$ bun run check-links → check-links: OK
$ node scripts/check-budget.mjs → check-budget: OK
$ bun run build-storybook → completed successfully

[bolt-new-by-stackblitz]

Run & review this pull request in StackBlitz Codeflow.