[Refactor/#93] 폴더 및 파일 구조 수정

[hyesngy]

✨ 작업 개요

폴더 및 파일 구조 수정

📌 관련 이슈

• close [Refactor] 폴더 구조 리팩토링 #93

✅ 작업 내용

폴더 및 파일 구조 수정

📷 UI 스크린샷 (해당 시)

💬 기타 사항

Summary by CodeRabbit

릴리스 노트

• Refactor
  • 애플리케이션 구조를 최적화하기 위해 모듈 임포트 경로를 업데이트했습니다.
  • 홈페이지 컴포넌트를 재구성하여 더 나은 프로젝트 조직화를 구현했습니다.

_{✏️ Tip: You can customize this high-level summary in your review settings.}

[vercel]

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

Project	Deployment	Preview	Comments	Updated (UTC)
gotit	Ready	Preview	Comment	Dec 1, 2025 3:18am

[coderabbitai]

Walkthrough

폴더 구조 일관성을 위해 홈페이지를 src/app/(home)/page.tsx로 이동하고 기존 src/app/page.tsx를 제거했습니다. 동시에 여러 페이지 컴포넌트의 import 경로를 절대 경로에서 상대 경로로 통일했습니다.

Changes

Cohort / File(s)	변경 요약
홈페이지 이동 src/app/(home)/page.tsx, src/app/page.tsx	HomePage 컴포넌트를 새로운 동적 라우팅 그룹 위치로 이동하고 기존 페이지 파일 제거
로그인 페이지 import 통일 src/app/login/page.tsx, src/app/login/components/LoginBody.tsx	절대 별칭 임포트를 상대 경로 임포트로 변경
퀴즈 페이지 import 통일 src/app/quiz/page.tsx	컴포넌트 임포트를 절대 경로에서 상대 경로로 변경
검색 페이지 import 통일 src/app/search/page.tsx, src/app/search/components/RecommendedTermsSection.tsx	컴포넌트 임포트 경로를 절대 경로에서 상대 경로로 변경
검색 섹션 import 변경 src/app/search/components/SearchBar.tsx	LogoText 임포트를 상대 경로에서 절대 별칭으로 변경
약관 상세페이지 import 통일 src/app/terms/[slug]/page.tsx	절대 별칭 임포트를 상대 경로 임포트로 변경
온보딩 페이지 import 업데이트 src/app/onboarding/page.tsx	임포트 이름을 업데이트된 모듈 파일명과 일치하도록 변경

Estimated code review effort

🎯 1 (Trivial) | ⏱️ ~5-10 minutes

• 대부분 반복적인 import 경로 변경으로 일관된 패턴
• 런타임 동작 변화 없음
• 모듈 해석(resolution) 경로만 수정

Possibly related PRs

• PR #67: 랜딩 페이지 HeroSection, ValuePropSection, FeaturesSection, CTASection 등 모듈식 컴포넌트 추가와 직접 연결됨
• PR #36: src/app/terms/[slug]/page.tsx 수정으로 약관 상세페이지 코드 수준 관련성 있음
• PR #47: src/app/search/page.tsx 수정으로 검색 페이지 import 경로 변경과 연결됨

Poem

🐰 폴더들을 정렬하며
경로를 다시 맺으니
상대와 절대 조화로워
구조가 살아나네요
일관성 위에 세워진
더욱 깔끔한 정원! 🌱

Pre-merge checks and finishing touches

❌ Failed checks (1 warning)

Check name	Status	Explanation	Resolution
Docstring Coverage	⚠️ Warning	Docstring coverage is 0.00% which is insufficient. The required threshold is 80.00%.	You can run @coderabbitai generate docstrings to improve docstring coverage.

✅ Passed checks (4 passed)

Check name	Status	Explanation
Description Check	✅ Passed	Check skipped - CodeRabbit’s high-level summary is enabled.
Title check	✅ Passed	PR 제목은 폴더 및 파일 구조 수정이라는 주요 변경 내용을 명확하게 요약하고 있으며, 실제 변경 사항(import 경로 및 페이지 구조 개선)과 관련성이 있습니다.
Linked Issues check	✅ Passed	PR은 import 경로를 상대경로로 통일하고 폴더 구조를 정리하여 일관성 있는 폴더 구조를 달성했으며, 이는 #93 이슈의 '폴더 구조 일관성있게 통일' 목표를 만족합니다.
Out of Scope Changes check	✅ Passed	모든 변경 사항은 import 경로 통일 및 홈페이지 폴더 구조 개편으로, #93 이슈의 폴더 구조 리팩토링 범위 내에 있으며 범위를 벗어나는 변경은 없습니다.

✨ Finishing touches

• 📝 Generate docstrings

🧪 Generate unit tests (beta)

• Create PR with unit tests
• Post copyable unit tests in a comment
• Commit unit tests in branch refactor/93-structure

---

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands and usage tips.}

[coderabbitai]

Actionable comments posted: 0

🧹 Nitpick comments (1)

src/app/(home)/page.tsx (1)

10-10: z-index 스태킹 컨텍스트 확인 권장.

fixed inset-0 z-0으로 설정되어 있는데, 네비게이션 바나 모달 등 다른 고정 요소들과 z-index 충돌이 없는지 확인해 주세요. 필요시 z-index 값 조정이 필요할 수 있습니다.

📜 Review details

Configuration used: CodeRabbit UI

Review profile: CHILL

Plan: Pro

📥 Commits

Reviewing files that changed from the base of the PR and between 0cb357b and 5372bfe.

📒 Files selected for processing (10)

• src/app/(home)/page.tsx (1 hunks)
• src/app/login/components/LoginBody.tsx (1 hunks)
• src/app/login/page.tsx (1 hunks)
• src/app/onboarding/page.tsx (1 hunks)
• src/app/page.tsx (0 hunks)
• src/app/quiz/page.tsx (1 hunks)
• src/app/search/components/RecommendedTermsSection.tsx (1 hunks)
• src/app/search/components/SearchBar.tsx (1 hunks)
• src/app/search/page.tsx (1 hunks)
• src/app/terms/[slug]/page.tsx (1 hunks)

💤 Files with no reviewable changes (1)

• src/app/page.tsx

🧰 Additional context used

🧬 Code graph analysis (2)

src/app/terms/[slug]/page.tsx (4)

src/components/term-detail/HeroSection.tsx (3)

• HeroSection (22-106)
• HeroSectionProps (14-20)
• alias (81-85)

src/components/term-detail/TabSection.tsx (2)

• TabSection (16-32)
• TabSectionProps (11-14)

src/components/term-detail/Footer.tsx (1)

• Footer (7-18)

src/components/term-detail/tabs/RelatedTab.tsx (1)

• RelatedTermCard (42-114)

src/app/(home)/page.tsx (4)

src/app/(home)/components/HeroSection.tsx (1)

• HeroSection (20-88)

src/app/(home)/components/ValuePropSection.tsx (1)

• ValuePropSection (5-48)

src/app/(home)/components/FeaturesSection.tsx (1)

• FeaturesSection (5-59)

src/app/(home)/components/CTASection.tsx (1)

• CTASection (8-59)

🔇 Additional comments (9)

src/app/search/components/RecommendedTermsSection.tsx (1)

4-5: LGTM!

로컬 컴포넌트에 대한 상대 경로 import로 일관되게 변경되었습니다. 동일 디렉토리 내 컴포넌트 참조에 적합한 패턴입니다.

src/app/onboarding/page.tsx (1)

5-7: LGTM!

컴포넌트 파일명이 PascalCase 컨벤션으로 변경되고 상대 경로 import로 통일되었습니다. React 컴포넌트 네이밍 규칙에 부합합니다.

src/app/quiz/page.tsx (1)

4-6: LGTM!

로컬 컴포넌트는 상대 경로로, 공유 타입/라이브러리는 절대 경로(@/)로 일관되게 구분되었습니다. PR 전반의 import 전략과 일치합니다.

src/app/(home)/page.tsx (1)

1-17: LGTM!

홈페이지가 (home) 라우트 그룹으로 이동되어 폴더 구조가 개선되었습니다. snap-scroll 레이아웃과 섹션 구성이 적절합니다.

src/app/terms/[slug]/page.tsx (1)

8-8: Import path change verified and correct.

The relative import from ./components is properly set up with all three components (HeroSection, TabSection, Footer) correctly exported from the barrel file at src/app/terms/[slug]/components/index.ts. No changes needed.

src/app/login/components/LoginBody.tsx (1)

5-5: GoogleLoginButtonIcon 상대 경로 import 변경 적절

LoginBody.tsx와 같은 디렉터리의 컴포넌트를 ./GoogleLoginButtonIcon으로 참조하도록 바꾼 점이 새 폴더 구조와 잘 맞습니다. 기존 동작에는 영향 없고, login/page.tsx의 상대 경로 사용과도 일관성이 좋아 보입니다.

src/app/login/page.tsx (1)

1-3: 로그인 컴포넌트 상대 경로 정리 잘 되어 있음

page.tsx에서 ./components/...로 헤더/바디/푸터를 불러오도록 통일한 덕분에, login 페이지 하위 구조가 명확해졌습니다. 폴더 이동 시에도 추적이 쉬워지고, 별다른 부작용은 없어 보입니다.

src/app/search/page.tsx (1)

4-7: Search 페이지 컴포넌트 import 경로 통일 👍

검색 페이지 전용 컴포넌트들을 ./components/...로 묶어 가져오도록 바꾼 점이 폴더 구조 리팩토링 목적(페이지별 로컬 컴포넌트 캡슐화)에 잘 부합합니다. 공용 모듈(@/lib/terms, @/hooks/useDebounce)과의 경계도 명확해져서 유지보수에 유리해 보입니다.

src/app/search/components/SearchBar.tsx (1)

5-5: LogoText를 공용 아이콘 경로로 이동한 선택 적절

LogoText를 @/components/icons/logo_text에서 가져오도록 변경해, SearchBar에서 사용하는 로고를 전역 아이콘 세트로 통합한 의도가 잘 드러납니다. 검색 기능 로직과는 분리된 공용 UI 자산이므로, alias 기반의 공용 경로로 관리하는 편이 더 일관된 구조 같습니다.