[feat] 최근 본 동아리 조회 기능 구현

[ff1451]

✨ 요약

- 최근 본 동아리 ID 로컬 저장과 최근 본 동아리 카드 조회 API를 추가했습니다.
- 홈/대학별 동아리 목록/동아리 상세 화면의 최근 본 동아리 영역을 공통 컴포넌트로 연결했습니다.
- 동아리 카테고리 공통 타입과 브레드크럼 컴포넌트를 정리했습니다.

😎 해결한 이슈

• close [feat] 최근 본 동아리 조회 기능 구현 #318

Summary by CodeRabbit

릴리스 노트

• 새로운 기능

  • 최근에 본 동아리 목록을 홈페이지와 대학 동아리 목록 페이지에서 확인할 수 있습니다.
  • 동아리 상세 페이지 방문 시 자동으로 최근 본 동아리 목록에 저장됩니다.
  • 동아리 검색 및 탐색을 위한 breadcrumb 네비게이션이 추가되었습니다.

• 리팩토링

  • 동아리 카테고리 분류 시스템을 개선했습니다.

[coderabbitai]

Warning

Review limit reached

@ff1451, we couldn't start this review because you've reached your PR review rate limit.

More reviews will be available in 37 minutes and 1 second. Learn how PR review limits work.

Your organization has run out of usage credits. Purchase more in the billing tab.

⌛ How to resolve this issue?

After more reviews become available, a review can be triggered using the @coderabbitai review command as a PR comment. Alternatively, push new commits to this PR.

We recommend that you space out your commits to avoid hitting the rate limit.

🚦 How do rate limits work?

CodeRabbit enforces hourly rate limits for each developer per organization.

Our paid plans include higher PR review limits than trial, open-source, and free plans. In all cases, reviews become available again over time. During sustained high-volume PR review activity, CodeRabbit may temporarily slow when the next review becomes available.

Please see our Fair Usage Limits Policy for further information.

ℹ️ Review info

⚙️ Run configuration

Configuration used: Path: .coderabbit.yaml

Review profile: CHILL

Plan: Pro

Run ID: 05859cd9-cfb9-4dad-8fb4-1a6e5fc19962

📥 Commits

Reviewing files that changed from the base of the PR and between 2f13e93 and ad927c1.

📒 Files selected for processing (1)

• apps/web/src/components/Breadcrumb/index.tsx

Walkthrough

PR #319는 최근 본 동아리 기능을 구현합니다. ClubCategory를 apps/web/src/apis/common/club에서 공통 정의하고, 최근 본 동아리 API(recentClub/index.ts), React Query 쿼리, 로컬스토리지 저장소 유틸(recentClubStorage.ts)을 추가합니다. 공용 UI 컴포넌트(Breadcrumb, RecentClubCard, RecentClubList)를 통해 Home, ClubDetail, UniversityClubList 페이지에 최근 본 동아리 기능을 통합하며, UniversityClub 엔티티에서 memberCount를 제거하고 topic을 추가합니다.

Possibly related issues

• #318: [feat] 최근 본 동아리 조회 기능 구현: 현재 PR이 직접 구현하는 최근 본 동아리 기능의 작업 목표와 일치합니다.

Possibly related PRs

• BCSDLab/KONECT_FRONT_END#303: Home 페이지의 최근 본 동아리 섹션을 리팩토링하며, 기존 더미 데이터 렌더링 방식을 RecentClubList 컴포넌트 기반으로 변경합니다.
• BCSDLab/KONECT_FRONT_END#307: UniversityClubList 페이지와 universityClub API 타입을 정의하며, 현재 PR에서 ClubCategory를 공통화하고 페이지를 리팩토링하는 변경과 겹칩니다.
• BCSDLab/KONECT_FRONT_END#309: ClubDetail 페이지의 라우트, API, 엔티티를 추가하며, 현재 PR에서 ClubDetailUniversitySummary 타입 추가 및 ClubDetail 페이지 통합과 관련됩니다.

🚥 Pre-merge checks | ✅ 4

✅ Passed checks (4 passed)

Check name	Status	Explanation
Description Check	✅ Passed	Check skipped - CodeRabbit’s high-level summary is enabled.
Title check	✅ Passed	PR 제목이 PR의 주요 변경사항(최근 본 동아리 조회 기능 구현)을 명확하고 간결하게 요약합니다.
Linked Issues check	✅ Passed	PR이 이슈 #318의 모든 코딩 요구사항을 충족합니다: API 타입/쿼리 추가, 로컬스토리지 저장 로직, 공통 컴포넌트, 3개 화면 연결, 카테고리 타입 정리 완료.
Out of Scope Changes check	✅ Passed	모든 변경사항이 이슈 #318의 목표 범위 내에 있으며, 스코프를 벗어난 변경이 없습니다.

_{✏️ Tip: You can configure your own custom pre-merge checks in the settings.}

✨ Finishing Touches

🧪 Generate unit tests (beta)

• Create PR with unit tests
• Commit unit tests in branch 318-feat-최근-본-동아리-조회-기능-구현

---

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: 1

🧹 Nitpick comments (2)

apps/web/src/apis/recentClub/index.ts (1)

1-2: ⚡ Quick win

내부 모듈 import는 @/* 별칭으로 통일해주세요.

현재 상대경로 import는 이 PR의 TS import 컨벤션과 어긋납니다.

변경 제안

-import { apiClient } from '../client';
-import type { RecentClubRequestParams, RecentClubResponse } from './entity';
+import { apiClient } from '`@/apis/client`';
+import type { RecentClubRequestParams, RecentClubResponse } from '`@/apis/recentClub/entity`';

As per coding guidelines **/*.{ts,tsx}: Use path alias @/* for internal app imports (preferred over relative paths).

🤖 Prompt for AI Agents

Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

In `@apps/web/src/apis/recentClub/index.ts` around lines 1 - 2, The imports at the
top use a relative path for the internal module (import { apiClient } from
'../client') which violates the project's TS import convention; update the
import to use the path-alias form (e.g., replace the '../client' relative import
with the corresponding '`@/`...' alias) while keeping the same symbol (apiClient)
and leave the type imports (RecentClubRequestParams, RecentClubResponse) using
the '`@/`...' alias form as well so all internal imports in this file follow the
`@/`* convention.

apps/web/src/constants/club.ts (1)

8-8: ⚡ Quick win

인라인 HEX 클래스 대신 디자인 토큰 기반 텍스트 컬러를 사용해주세요.

text-[#cd3bf6]는 토큰 체계를 우회해서 테마 일관성이 깨질 수 있습니다. @konect/design-tokens에서 제공하는 컬러 토큰 클래스로 치환해 주세요.
As per coding guidelines **/*.{ts,tsx,css}: Use CSS export from @konect/design-tokens for design tokens, prioritized over inline values.

🤖 Prompt for AI Agents

Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

In `@apps/web/src/constants/club.ts` at line 8, Replace the inline hex Tailwind
class used for CLUB_CATEGORY.PERFORMANCE in the club constants mapping with the
appropriate design token text color class from `@konect/design-tokens`; import/use
the token CSS export from `@konect/design-tokens` instead of hardcoding
'text-[`#cd3bf6`]' so the mapping value for CLUB_CATEGORY.PERFORMANCE references
the token class (maintaining theme consistency) and remove the inline hex class.

🤖 Prompt for all review comments with AI agents

Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

Inline comments:
In `@apps/web/src/components/Breadcrumb/index.tsx`:
- Around line 20-22: The last-item check in the Breadcrumb render uses reference
equality (items.at(-1) === item) which can misidentify the last breadcrumb;
change the logic inside the items.map callback (where isLast is defined) to use
the index parameter (e.g., index === items.length - 1) to determine the last
item so the check is index-based and reliable for duplicates or reused objects.

---

Nitpick comments:
In `@apps/web/src/apis/recentClub/index.ts`:
- Around line 1-2: The imports at the top use a relative path for the internal
module (import { apiClient } from '../client') which violates the project's TS
import convention; update the import to use the path-alias form (e.g., replace
the '../client' relative import with the corresponding '`@/`...' alias) while
keeping the same symbol (apiClient) and leave the type imports
(RecentClubRequestParams, RecentClubResponse) using the '`@/`...' alias form as
well so all internal imports in this file follow the `@/`* convention.

In `@apps/web/src/constants/club.ts`:
- Line 8: Replace the inline hex Tailwind class used for
CLUB_CATEGORY.PERFORMANCE in the club constants mapping with the appropriate
design token text color class from `@konect/design-tokens`; import/use the token
CSS export from `@konect/design-tokens` instead of hardcoding 'text-[`#cd3bf6`]' so
the mapping value for CLUB_CATEGORY.PERFORMANCE references the token class
(maintaining theme consistency) and remove the inline hex class.

🪄 Autofix (Beta)

Fix all unresolved CodeRabbit comments on this PR:

• Push a commit to this branch (recommended)
• Create a new PR with the fixes

---

ℹ️ Review info

⚙️ Run configuration

Configuration used: Path: .coderabbit.yaml

Review profile: CHILL

Plan: Pro

Run ID: f9e7f188-d704-4499-8ba0-350fa2142c19

📥 Commits

Reviewing files that changed from the base of the PR and between c1dffee and 2f13e93.

📒 Files selected for processing (14)

• apps/web/src/apis/clubDetail/entity.ts
• apps/web/src/apis/common/club.ts
• apps/web/src/apis/recentClub/entity.ts
• apps/web/src/apis/recentClub/index.ts
• apps/web/src/apis/recentClub/queries.ts
• apps/web/src/apis/universityClub/entity.ts
• apps/web/src/components/Breadcrumb/index.tsx
• apps/web/src/components/RecentClubCard/index.tsx
• apps/web/src/components/RecentClubList/index.tsx
• apps/web/src/constants/club.ts
• apps/web/src/pages/ClubDetail/index.tsx
• apps/web/src/pages/Home/index.tsx
• apps/web/src/pages/UniversityClubList/index.tsx
• apps/web/src/utils/recentClubStorage.ts