feat: 문서 Spotlight로 회사 소식을 노출합니다#1017
Merged
Merged
Conversation
|
The latest updates on your projects. Learn more about Vercel for GitHub.
|
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>
9b04ae4 to
936251f
Compare
5 tasks
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>
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
corp-web-app의 현재 Spotlight 콘텐츠를 QueryPie Docs에 반영하여 문서 사이트에서도 회사 주요 소식을 검증 가능하게 노출합니다.
src/lib/docs-spotlight에 locale별 Spotlight 데이터, 활성 기간 필터링, 30일 localStorage 숨김 상태, UTM/GA 이벤트 유틸리티를 추가합니다.toc.extraContent와/{locale}/internal페이지에 Spotlight 카드를 노출합니다.public/spotlight/{item-id}아래에 복사합니다.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.tsxnpm run test:run -- src/lib/docs-spotlight/content.test.ts src/components/docs-spotlight-card.test.tsxnpm run lintnpx tsc --noEmitgit diff --checkRelated tickets & links
🤖 Generated with Codex