Skip to content

feat: 문서 Spotlight로 회사 소식을 노출합니다#1017

Merged
jk-kim0 merged 1 commit into
mainfrom
feat/docs-spotlight-internal
Jun 17, 2026
Merged

feat: 문서 Spotlight로 회사 소식을 노출합니다#1017
jk-kim0 merged 1 commit into
mainfrom
feat/docs-spotlight-internal

Conversation

@jk-kim0

@jk-kim0 jk-kim0 commented Jun 17, 2026

Copy link
Copy Markdown
Contributor

Summary

corp-web-app의 현재 Spotlight 콘텐츠를 QueryPie Docs에 반영하여 문서 사이트에서도 회사 주요 소식을 검증 가능하게 노출합니다.

  • src/lib/docs-spotlight에 locale별 Spotlight 데이터, 활성 기간 필터링, 30일 localStorage 숨김 상태, UTM/GA 이벤트 유틸리티를 추가합니다.
  • Nextra toc.extraContent/{locale}/internal 페이지에 Spotlight 카드를 노출합니다.
  • corp-web-app의 현재 Spotlight 이미지 에셋을 public/spotlight/{item-id} 아래에 복사합니다.
  • App Router 동적 route가 Nextra pageMap 링크로 노출되지 않도록 필터를 추가합니다.
  • 웹 렌더링/브라우저 테스트는 기본적으로 headless mode를 사용하도록 AGENTS.md에 명시합니다.

Test plan

  • npm run test:run -- src/lib/nextra-page-map.test.ts src/lib/docs-spotlight/content.test.ts src/lib/docs-spotlight/storage.test.ts src/lib/docs-spotlight/tracking.test.ts src/components/docs-spotlight-card.test.tsx src/app/[lang]/internal/page.test.tsx
  • npm run test:run -- src/lib/docs-spotlight/content.test.ts src/components/docs-spotlight-card.test.tsx
  • npm run lint
  • npx tsc --noEmit
  • git diff --check
  • headless Chrome desktop/mobile 렌더링에서 카드 표시, 모바일 숨김, UTM 링크, 이미지 경로를 확인했습니다.

Related tickets & links

🤖 Generated with Codex

@vercel

vercel Bot commented Jun 17, 2026

Copy link
Copy Markdown

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated (UTC)
querypie-docs Ready Ready Preview, Comment Jun 17, 2026 1:50pm

Request Review

corp-web-app의 현재 Spotlight 설정값을 문서 사이트에서 검증 가능한 형태로 재사용합니다. /{locale}/internal 확인 페이지와 Nextra TOC extraContent에 같은 카드를 노출하고, 30일 숨김 상태와 GA promotion 이벤트를 클라이언트에서 처리합니다.

Constraint: corp-web-app 현재 Spotlight 콘텐츠와 이미지 에셋을 기준값으로 사용해야 했습니다.
Rejected: corp-web-app YAML을 런타임에 직접 읽는 방식 | 저장소 경계와 배포 경로를 복잡하게 만듭니다.
Confidence: high
Scope-risk: moderate
Directive: Spotlight 콘텐츠를 갱신할 때 corp-web-app featured.*.yaml과 public 이미지 에셋을 함께 동기화합니다.
Tested: npm run test:run -- src/lib/nextra-page-map.test.ts src/lib/docs-spotlight/content.test.ts src/lib/docs-spotlight/storage.test.ts src/lib/docs-spotlight/tracking.test.ts src/components/docs-spotlight-card.test.tsx src/app/[lang]/internal/page.test.tsx
Tested: npm run lint
Tested: npx tsc --noEmit
Tested: git diff --check
Tested: headless Chrome desktop/mobile 렌더링에서 카드 표시, 모바일 숨김, UTM 링크, 이미지 경로를 확인했습니다.
Not-tested: production build는 로컬 기본 검증 범위에서 제외했습니다.
Generated-With: Codex
Co-Authored-By: Atlas <atlas@jk.agent>
@jk-kim0 jk-kim0 force-pushed the feat/docs-spotlight-internal branch from 9b04ae4 to 936251f Compare June 17, 2026 13:47
@jk-kim0 jk-kim0 merged commit 7321149 into main Jun 17, 2026
5 checks passed
@jk-kim0 jk-kim0 deleted the feat/docs-spotlight-internal branch June 17, 2026 13:57
jk-kim0 added a commit that referenced this pull request Jun 17, 2026
## Summary
PR #1017 병합 후 Spotlight가 전체 문서 페이지 TOC에 노출되는 문제를 수정합니다.

- root Nextra layout에서 `DocsSpotlightSidebar` 주입을 제거합니다.
- Spotlight는 `/{locale}/internal` 페이지 전용 렌더만 유지합니다.
- root layout에 Spotlight가 다시 들어오지 않도록 회귀 테스트를 추가합니다.

## Test plan
- [x] `npm run test:run -- src/app/[lang]/layout.test.ts
src/app/[lang]/internal/page.test.tsx
src/components/docs-spotlight-card.test.tsx
src/lib/docs-spotlight/content.test.ts`
- [x] `npm run lint`
- [x] `npx tsc --noEmit`
- [x] `git diff --check`
- [x] headless Chrome에서 `/ko/internal`은 Spotlight 표시, `/ko/overview`는
Spotlight 미표시를 확인했습니다.

## Related tickets & links
- Fixes #1017 follow-up
- Related to #1004

## Additional notes
- headless 검증 중 기존 `LanguageSelector2`의 잘못된 `<p>` 중첩 hydration 경고가 dev
로그에 보였지만, 이번 Spotlight 전역 노출 문제와는 별개입니다.

🤖 Generated with Codex

Co-authored-by: Atlas <atlas@jk.agent>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

오른쪽 Sidebar 에 광고판 추가

1 participant