Skip to content

Feat/ject 177 common foundation - #4

Merged
bess-cater merged 3 commits into
developfrom
feat/JECT-177-common-foundation
Nov 17, 2026
Merged

bess-cater merged 3 commits into
developfrom
feat/JECT-177-common-foundation

Conversation

@bess-cater

Copy link
Copy Markdown
Collaborator

변경

Jira: JECT-177 공통 개발 브랜치·화면 개발 기반 준비하기

디자인 1차(Figma 디자인 시스템 v3)를 앱·웹·문서에 반영하고, Figma 확정 화면 기준으로 화면 이동 경로를 정했다.

1. 색 토큰 (Figma v3 이름·값)

  • 원시: Primary-Pink 50700, Primary-Blue 50700, white·black (gray는 docs 표에만, 쓸 때 추가)
  • 의미: label · background · interaction · line · status · inverse · static · fill · material (Figma Semantic 이름 그대로)
  • 앱 context.colors.labelNormal, 웹 var(--color-label-normal). Pink·Blue는 둘 다 Primary라 화면에서 바로 쓴다
  • Material 기본 위젯 primary = pink.500, secondary = blue.500
  • 기존 임시 토큰(primary, textPrimary, border 등)은 새 이름으로 교체 (사용처 8곳)

2. 타이포그래피 + Pretendard

  • Figma 텍스트 스타일 15개: Head, Title-1(B/R), Title-2(B/SB/R), Body-1(B/SB/M/R), Caption-1(SB/M/R), Tag-1, Tag-2
  • 앱: context.textStyles.body1Regular (새 AppTextStyles), Material TextTheme에도 매핑. Pretendard 4굵기 OTF를 assets/fonts/pretendard/에 넣고 pubspec.yaml fonts 등록 (6MB, OFL 라이선스 포함)
  • 웹: font: var(--text-body1-regular). pretendard npm 패키지, 글자 범위별 subset이라 필요한 조각만 받음
  • 규칙 변경: 위젯은 textTheme 대신 context.textStyles.*를 쓴다 (design-tokens·mobile-architecture·overview·pr-checklist 수정)

3. 화면 이동 경로

  • Figma 와이어프레임 New → 11/8 pm 확정 영역 기준 경로 37개를 app/routes.dart의 AppRoutes에 정의 (상수 + ...Of(id) 함수)
  • app/router.dart는 GoRoute 등록만. 지금은 /login만 연결, 나머지는 화면 만드는 PR에서 등록
  • 지도(경로 → 화면 → Figma 프레임, 탭·팝업 규칙): docs/mobile-architecture.md 11절

검증

  • 앱 (apps/mobile): dart format · flutter analyze · check_imports · flutter test (30개) 통과
  • 웹 (apps/web): format:check · lint · typecheck · test · build · build:dev 통과
  • 추가 테스트: 테마 글자 스타일이 Pretendard·Figma 값인지, AppRoutes의 ...Of(id)가 경로 상수와 같은지
  • 실기기·브라우저에서 화면 확인은 아직 안 함

UI 캡처

화면 로직 변경은 없음. 글꼴(Pretendard)·기본 색·로그인 화면 제목 크기(20 → 18, Title-1(B))가 바뀜 — 캡처 첨부 예정

호환성·주의

  • 공통 변경: 디자인 토큰(색·글자 이름 전부 변경), 라우팅(AppRoutes 분리), 의존성(pubspec.yaml 폰트, 웹 pretendard 패키지)
  • 토큰 이름이 바뀌었으니 작업 중인 브랜치는 context.colors.*, var(--color-*), context.textStyles.* 새 이름으로 맞춰야 한다
  • Figma 표기와 스타일이 어긋난 곳 (디자이너 확인 필요): Head 표기 32px / 스타일 24px → 24 적용. Caption-1(SB) 표기 Regular → SemiBold. Title-1(B)·Caption-1(R)·Tag-2는 스타일이 없어 이름대로. Blue-700은 Figma에 불투명도 76% → 불투명으로 적용
  • 간격·모서리는 Figma에 아직 없어 기존 임시값 유지
  • 관객 쪽(공유 링크·예매·내 티켓·환불)이 앱인지 웹인지 미정 — 경로 지도에서 제외
  • merge 후 App Release는 secret·첫 스토어 업로드 전이라 실패한다 (업로드 없음, 무해)

리뷰 순서

  1. docs/design-tokens.md (색·글자 표)
  2. apps/mobile/lib/shared/theme/app_colors.dart → app_typography.dart → app_theme.dart
  3. apps/web/src/shared/styles/tokens.css → global.css
  4. apps/mobile/lib/app/routes.dart → router.dart → docs/mobile-architecture.md 11절
  5. apps/mobile/test/shared/theme/app_theme_test.dart, apps/mobile/test/app/routes_test.dart

새 문구

해당 없음

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

  • A1 형식: 브랜치·커밋·PR 제목 규칙, PR 하나 = Task 하나 — 첫 커밋 제목은 규칙과 다름, squash 제목으로 맞춤
  • A2 자동 검증: 앱 format·analyze·check_imports·test / 웹 format·lint·typecheck·test·build·build:dev 전부 통과 (앱·웹 파일이 바뀐 PR이면 CI도 같은 검사)
  • A3 구조: 파일이 규칙 위치에 있고, features→app·다른 기능 내부 import 없음, 미래용 코드 없음 — 아직 없는 화면의 경로 상수를 미리 둠 (합의용). GoRoute·화면은 만들지 않음
  • A4 명령: 해당 없음
  • A5 화면 상태: 해당 없음
  • A6 토큰: hex·Colors.*·숫자 크기 없음. 토큰 변경은 앱·웹·문서 함께
  • A7 재사용: 해당 없음
  • A8 문구: 해당 없음
  • A9 데이터: 토큰·개인정보가 로그·URL·분석·prefs에 없음. env·routes 한 곳
  • A10 테스트: 같은 경로, 4케이스, 뒤집으면 실패, 문구 고정·고정 sleep 없음
  • A11 생성 파일·lock 같이 커밋 (해당 시) — pnpm-lock.yaml
  • 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: 5e43efc8-58a6-48fa-b048-785b7b3f31e5

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 3451efd 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