Checklist Reference Guide#

Feature Complete 및 PR Review 체크리스트 상세 가이드입니다.

1. Feature Complete 검증 상세#

1.1 구조 검증#

Domain Layer

// ✅ Entity 예시
@freezed
class User with _$User {
  const factory User({
    required int id,
    required String name,
  }) = _User;
}

// ✅ Repository Interface 예시
abstract interface class IUserRepository {
  Future<Either<Failure, User>> getUser(int id);
}

// ✅ UseCase 예시 (직접 인스턴스화 패턴)
class GetUserUseCase {
  const GetUserUseCase();  // 상수 생성자

  IUserRepository get _repository => getIt<IUserRepository>();

  Future<Either<Failure, User>> call(GetUserParams params) async {
    return _repository.getUser(params.id);
  }
}

Data Layer

Presentation Layer

1.2 코드 생성#

# 코드 생성 명령
melos run generate:{feature_name}

# 또는 전체 빌드
melos run build

생성 확인 항목:

1.3 테스트#

단위 테스트 (UseCase)

test('should return user when repository succeeds', () async {
  // Arrange
  when(() => mockRepository.getUser(any()))
    .thenAnswer((_) async => Right(testUser));

  // Act
  final result = await useCase(GetUserParams(id: 1));

  // Assert
  expect(result, Right(testUser));
  verify(() => mockRepository.getUser(1)).called(1);
});

BLoC 테스트 (GetIt 모킹)

blocTest<HomeBloC, HomeState>(
  'emits [loading, loaded] when LoadUser succeeds',
  setUp: () {
    when(() => mockRepository.getUser(any()))
      .thenAnswer((_) async => Right(testUser));
  },
  build: HomeBloC.new,  // ✅ 기본 생성자
  act: (bloc) => bloc.add(LoadUser(id: 1)),
  expect: () => [HomeLoading(), HomeLoaded(testUser)],
);

테스트 명령

# 단일 Feature 테스트
flutter test feature/{type}/{feature_name}/test/

# 커버리지 리포트
melos run test:with-html-coverage

커버리지 목표: 80% 이상

2. PR Review 검증 상세#

2.1 PR 메타 정보#

제목 예시:

feat(auth): ✨ 소셜 로그인 기능 추가
fix(home): 🐛 피드 무한 스크롤 버그 수정
refactor(store): ♻️ 상품 목록 쿼리 최적화

2.2 변경 사항 범위#

2.3 코드 품질#

아키텍처 검증

✅ 올바른 의존성 방향:
Presentation → Domain → Data

❌ 잘못된 의존성:
Presentation → Data (Domain 우회)
Feature A → Feature B (직접 참조)

네이밍 컨벤션

2.4 상태 관리 검증#

// ✅ 올바른 BLoC 패턴
@freezed
class HomeEvent with _$HomeEvent {
  const factory HomeEvent.loadUser(int id) = LoadUser;
}

@freezed
class HomeState with _$HomeState {
  const factory HomeState.initial() = _Initial;
  const factory HomeState.loading() = _Loading;
  const factory HomeState.loaded(User user) = _Loaded;
  const factory HomeState.error(Failure failure) = _Error;
}

검증 항목:

• Event/State Freezed 사용
• 로딩 상태 처리
• 에러 상태 처리
• dispose에서 리소스 해제

2.5 보안 검증#

# 시크릿 검색
grep -r "api_key\|secret\|password\|token" --include="*.dart"

2.6 성능 검증#

3. CI/CD 확인#

# PR 상태 확인
gh pr checks [PR_NUMBER]

# PR 웹에서 보기
gh pr view [PR_NUMBER] --web

4. 트러블슈팅#

빌드 실패#

테스트 실패#

정적 분석 에러#

# 분석 실행
melos run analyze

# 포맷팅
melos run format