Skip to content

feat: 내부 테스트 페이지 route 추가#1015

Merged
jk-kim0 merged 2 commits into
mainfrom
feat/internal-route-page
Jun 17, 2026
Merged

feat: 내부 테스트 페이지 route 추가#1015
jk-kim0 merged 2 commits into
mainfrom
feat/internal-route-page

Conversation

@jk-kim0

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

Copy link
Copy Markdown
Contributor

기존 문제

/{locale}/internal 경로에 기능 테스트와 구현 참고를 위한 내부 페이지 진입점이 없었습니다.

구현 내용

  • src/app/[lang]/internal/page.tsx를 추가해 App Router 기반 독립 페이지를 구성했습니다.
  • 현재는 실제 내부 컴포넌트 목록을 넣지 않고 제목과 설명만 노출합니다.
  • ko, en, ja locale별 최소 copy와 route metadata를 제공합니다.
  • route 출력, static params, metadata를 검증하는 테스트를 추가했습니다.
  • 정적 생성 중 metadata 함수가 params 없이 호출되는 경우에도 안전하게 fallback하도록 보강했습니다.

CI/배포 오류 대응

  • 실패 원인: Next/Nextra 정적 생성 과정에서 internal route의 generateMetadataparams 없이 호출되어 lang destructuring 오류로 npm run build가 실패했습니다.
  • 조치: params를 optional로 처리하고 누락 시 en copy로 fallback하도록 변경했습니다.
  • 영향: 기존 /{locale}/internal 출력은 유지하면서, CI build와 Preview Deploy가 같은 오류로 중단되지 않도록 했습니다.

검증

  • npm run test:run -- 'src/app/[lang]/internal/page.test.tsx'
  • npm run lint -- 'src/app/[lang]/internal/page.tsx' 'src/app/[lang]/internal/page.test.tsx'
  • npx tsc --noEmit
  • npm run build
  • git diff --check

참고

Refs #1004

Constraint: The user requested an App Router page.tsx rather than MDX content, with only a title and description visible for now.
Rejected: MDX content page | It would route through the documentation content pipeline instead of an independent app route.
Confidence: high
Scope-risk: narrow
Directive: Keep /{locale}/internal as a sparse internal landing surface until concrete test pages are intentionally added.
Tested: npm run test:run -- 'src/app/[lang]/internal/page.test.tsx'; npm run lint -- 'src/app/[lang]/internal/page.tsx' 'src/app/[lang]/internal/page.test.tsx'; npx tsc --noEmit; git diff --check
Not-tested: Browser rendering against a deployed preview URL is pending PR deployment.
Co-Authored-By: Atlas <atlas@jk.agent>
@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 12:42pm

Request Review

Constraint: Next/Nextra static generation invoked the new internal route metadata with missing params.
Rejected: Disabling metadata generation | The route still needs localized metadata and a safe fallback.
Confidence: high
Scope-risk: narrow
Directive: Keep App Router metadata functions tolerant of omitted params when they can be called by static generation.
Tested: npm run test:run -- 'src/app/[lang]/internal/page.test.tsx'; npm run lint -- 'src/app/[lang]/internal/page.tsx' 'src/app/[lang]/internal/page.test.tsx'; npx tsc --noEmit; npm run build; git diff --check
Not-tested: Preview deployment rerun result pending after push.
Co-Authored-By: Atlas <atlas@jk.agent>
@jk-kim0 jk-kim0 merged commit 0264d4a into main Jun 17, 2026
5 checks passed
@jk-kim0 jk-kim0 deleted the feat/internal-route-page branch June 17, 2026 12:54
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.

1 participant