Skip to content

♻️[리팩터링][전역] 스타일·네비게이션 규칙 위반 일괄 정리 (TextStyle 55건·Color 39건·MaterialPageRoute 7건) #936

Description

@Cassiiopeia

📝 현재 문제점

  • 2026-07-27 전수 진단(main @ v1.10.105) 결과, CLAUDE.md 절대 규칙(스타일·네비게이션) 위반이 누적되어 있다.
  • 직접 TextStyle( 사용 55건CustomTextStyles 미사용. lib/debug/ 패널 29건, lib/widgets/coach_mark/ 9건, notification_bottom_sheet 등 실사용 위젯 17건.
  • 직접 Color(0x 사용 39건AppColors 미사용. debug 패널 35건, request_management_tab_screen 등 실사용 4건.
  • MaterialPageRoute 직접 사용 7건context.navigateTo() 규칙 위반. deep_link_router.dart(4), register_tab_screen.dart(2), home_feed_item_widget.dart(1).
  • 방치 시 새 코드가 위반 코드를 복붙해 규칙 이탈이 재생산된다. 대형 파일 분해(#후속)·Riverpod 마이그레이션(#후속) 전에 정리해야 이중 작업이 없다.

🛠️ 해결 방안 / 제안 기능

  • TextStyle 통일: ① 기존 CustomTextStyles 스타일 매핑 → ② CustomTextStyles.pN.copyWith(...) 파생 → ③ 3회 이상 반복 패턴만 신규 스타일 추가(debug 전용 스타일 포함). 시각적 결과는 기존과 동일 유지.
  • Color 통일: AppColors 동일 값 상수 참조, 없는 값은 기존 명명 규칙(opacityNN<색상>/용도명 + 한국어 주석)으로 신규 상수 추가. debug 전용 색상은 별도 주석 블록으로 구분.
  • 네비게이션 통일: MaterialPageRoute 7건을 context.navigateTo()로 교체. common_utils.dart 내부 구현부는 유지. push 반환값 사용처는 navigateTo<T> 반환값으로 동일 처리.
  • 상세 설계: docs/superpowers/specs/2026-07-27-codebase-quality-improvement-design.md (서브프로젝트 A)

⚙️ 작업 내용

  • 직접 TextStyle 55건 → CustomTextStyles 매핑/파생/신규 스타일로 교체
  • 직접 Color 39건 → AppColors 상수 참조로 교체 (필요 상수 신규 추가)
  • MaterialPageRoute 7건 → context.navigateTo() 교체
  • dart format --line-length=120 . + flutter analyze 통과
  • 잔여 위반 0건 재스캔 검증 (grep 기준 debug 포함 전체)

🙋‍♂️ 담당자

  • 백엔드: 이름
  • 프론트엔드: @Cassiiopeia
  • 디자인: 이름

Metadata

Metadata

Assignees

Labels

작업전작업 시작 전 준비 상태

Type

No type

Projects

No projects

Milestone

No milestone

Relationships

None yet

Development

No branches or pull requests

Issue actions