Skip to content

feat(JECT-178): 하단 탭 4개(홈·팀 모집·메시지·마이페이지) 연결 - #5

Merged
bess-cater merged 1 commit into
developfrom
feat/JECT-178-bottom-tab-navigation
Nov 17, 2026
Merged

bess-cater merged 1 commit into
developfrom
feat/JECT-178-bottom-tab-navigation

Conversation

@bess-cater

Copy link
Copy Markdown
Collaborator

변경

Jira: JECT-178 홈·팀 모집·메시지함·마이페이지 하단 메뉴 연결하기 (기능 53, 원본 JECT-68)

하단 탭 4개 이동과 각 탭 기본 화면 라우팅을 만들었다.

  • 라우팅: StatefulShellRoute.indexedStack으로 /home · /recruit · /chat · /my 4개 branch (app/router.dart). 탭마다 스택·스크롤을 따로 유지하고, 지금 탭을 다시 누르면 그 탭 첫 화면으로 간다
  • 하단 탭 (app/main_shell.dart): MainShell + MainTabBar. Figma NavEX 기준
    • 크기·간격: 위아래 12, 아이콘 22, 아이콘-라벨 2, 라벨 11px (선택 Bold / 아니면 Regular), 눌림 효과 없음
    • 색(토큰): 선택 gray800 (Figma 아이콘 기본색 Neutral/Gray-800), 선택 안 됨 interactionInactive, 구분선 lineNeutral
  • 아이콘: Figma Icon 컴포넌트(Icon: home, search, message, Icon:my) SVG를 assets/icons/에 추가, shared/widgets/app_icon.dart의 AppIcon으로 색을 입혀 쓴다 (flutter_svg 추가)
  • 탭 기본 화면: HomeView, RecruitmentListView, ChatListView, MyPageView — 지금은 제목만. 내용은 각 기능 작업에서 채운다
  • 토큰: gray.800을 앱·웹·문서에 추가 (원래 미사용이라 빠져 있던 Figma Primitive)
  • 문서: docs/mobile-architecture.md 폴더 구조·11절(하단 탭 규칙), docs/design-tokens.md

검증

  • 앱 (apps/mobile): dart format · flutter analyze · check_imports · flutter test (35개) 통과
  • 웹 (apps/web, 토큰 파일 변경): format:check · lint · typecheck · test · build · build:dev 통과
  • 추가 테스트 (test/app/main_shell_test.dart): 탭 4개 표시 / 탭 누르면 해당 화면 / 선택된 탭만 gray800 / 다른 탭으로 가도 이전 탭 화면 유지 / 로그인 화면엔 탭 없음
  • iOS 시뮬레이터(iPhone 17 Pro)에서 홈 탭 + 하단 탭 표시 확인. 탭 전환 수동 확인은 아직

UI 캡처

하단 탭 추가 (iOS). 캡처 첨부 예정

호환성·주의

  • 공통 변경: 라우팅(StatefulShellRoute 도입), 의존성(flutter_svg, pubspec.yaml assets), 디자인 토큰(gray.800 추가) — 사전 공유 필요
  • 첫 화면은 그대로 로그인. 로그인 후 /home으로 보내는 인증 redirect는 로그인 작업에서 붙인다. 지금 앱에서 탭을 보려면 router.dart의 initialLocation을 임시로 AppRoutes.home으로 바꿔 확인
  • 탭 라벨: Figma 화면마다 달라서(채팅/메세지/티켓 관리, 내 프로필/마이페이지) 기능명세 기준 홈 · 팀 모집 · 메시지 · 마이페이지로 정함. 디자이너 확인 필요
  • NavEX 크기 값(2px 간격, 11px 라벨)은 디자인 시스템에 없어 MainTabBar 안에 상수로 둠
  • 탭 안에서 이어지는 화면(예: /recruit/:postId)은 해당 branch 아래에 등록하면 탭 바가 유지된다

리뷰 순서

  1. apps/mobile/lib/app/router.dart (StatefulShellRoute branches)
  2. apps/mobile/lib/app/main_shell.dart (MainShell → MainTabBar → _TabItem)
  3. apps/mobile/lib/shared/widgets/app_icon.dart, apps/mobile/assets/icons/
  4. apps/mobile/lib/features/{home,recruitments,chat,my_page}/presentation/views/
  5. apps/mobile/lib/shared/theme/app_colors.dart, apps/web/src/shared/styles/tokens.css, docs/design-tokens.md (gray.800)
  6. apps/mobile/test/app/main_shell_test.dart

새 문구

  • 하단 탭 라벨·탭 화면 제목: 홈, 팀 모집, 메시지, 마이페이지

작성자 체크 (docs/pr-checklist.md A절)

  • A1 형식: 브랜치·커밋·PR 제목 규칙, PR 하나 = Task 하나
  • A2 자동 검증: 앱 format·analyze·check_imports·test / 웹 format·lint·typecheck·test·build·build:dev 전부 통과 (앱·웹 파일이 바뀐 PR이면 CI도 같은 검사)
  • A3 구조: 파일이 규칙 위치에 있고, features→app·다른 기능 내부 import 없음, 미래용 코드 없음
  • A4 명령: 해당 없음
  • A5 화면 상태: 해당 없음 (탭 화면은 제목만)
  • A6 토큰: hex·Colors.*·숫자 크기 없음. 토큰 변경은 앱·웹·문서 함께 — 색은 토큰, NavEX 크기(2px·11px·22px)는 디자인 시스템에 없어 상수로 둠
  • A7 재사용: 공통 위젯이 있으면 그것을 씀
  • A8 문구: 오류 문구 "무엇이+어떻게", 버튼은 동사, 용어 통일, 탭 영역 44 — 탭 하나 약 94×61
  • A9 데이터: 토큰·개인정보가 로그·URL·분석·prefs에 없음. env·routes 한 곳
  • A10 테스트: 같은 경로, 4케이스, 뒤집으면 실패, 문구 고정·고정 sleep 없음
  • A11 생성 파일·lock 같이 커밋 (해당 시) — pubspec.lock
  • A12 수동 확인: 시나리오 실행, 캡처 첨부 — 캡처 첨부 예정
  • A13 사전 공유 (공통 변경 시) — 라우팅·의존성·토큰 변경 공유 필요

리뷰어 체크 (docs/pr-checklist.md B절)

  • B1 진입점 → B2 상태·요청 → B3 실패 방어 → B4 테스트 순으로 읽음
  • B5 일관성: 기존 비슷한 화면과 여백·빈 화면·문구 톤이 같음
  • B6 범위: 관계없는 변경이 섞이지 않음
  • 코멘트는 [must]/[nit] 접두사와 근거 절 번호

@coderabbitai

coderabbitai Bot commented Nov 17, 2026

Copy link
Copy Markdown

Important

Review skipped

Auto reviews are disabled on base/target branches other than the default branch.

Please check the settings in the CodeRabbit UI or the .coderabbit.yaml file in this repository. To trigger a single review, invoke the @coderabbitai review command.

Run configuration

  • Source mode: Auto
  • Repository: Unavailable
  • Branch: Unavailable
  • File: No configuration file from this repository applied
  • Commit: Unavailable
  • Layers: Organization UI
  • Review profile: CHILL
  • Plan: Advanced
  • Run ID: 233a53f0-5d69-452a-b08d-b6005dcf4dc7

You can disable this status message by setting the reviews.review_status to false in the CodeRabbit configuration file.

Use the checkbox below for a quick retry:

  • Trigger review
  • Autofix · Keep fixing CodeRabbit findings and required CI, and resolving merge conflicts

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

@bess-cater
bess-cater merged commit 134c8e6 into develop Nov 17, 2026
3 checks passed
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