/e2e:kick-off — 테스트 한 번에 깔아주는 도우미#

한마디로#

새 기능을 다 만들고 나면, 그 기능을 검증할 테스트 3종 세트를 한 방에 깔아주는 명령입니다. 이사 들어온 새 집에 화재경보기, 가스경보기, 도난경보기를 한 번에 설치해 주는 것과 비슷해요.

누가·언제 쓰나요#

• 새 기능 구현을 막 끝낸 개발자가, 그 기능의 테스트를 한꺼번에 준비하고 싶을 때
• PR(코드 제출)을 올리기 전에 "테스트 3종이 모두 걸려 있는지" 확인하고 싶을 때
• cc-bricks-feature 나 feature:* 명령으로 기능 뼈대를 만든 직후, 테스트 세팅을 자동으로 끝내고 싶을 때

무엇을 해주나요#

기능 이름 하나만 주면, 검증용 테스트 파일들을 자동으로 만들어 줍니다.

• Unit 테스트 — 작은 부품 하나하나가 제대로 동작하는지 확인하는 파일 (UseCase / BLoC / Repository)
• BDD 테스트 — 사람이 읽을 수 있는 시나리오(.feature)와, 화면 단위(widget) + 실제 기기(Patrol) 자동 검증 파일
• E2E 테스트 (선택) — 여러 기능을 가로지르는 "사용자 여정" 시나리오 파일
• 마지막에 요약 리포트 — 만들어진 파일 개수, 아직 채워야 할 작업(TODO) 목록, 검증 통과 여부, 다음에 할 일 안내

.feature 시나리오가 아직 없으면, 앱을 직접 둘러보며 시나리오 초안까지 대신 만들어 줄 수도 있습니다.

어떻게 쓰나요#

# 기본 — 기능 폴더에서 알아서 감지
/e2e:kick-off sign_in

# 시나리오(.feature)가 없을 때 만드는 방식 지정
/e2e:kick-off sign_in --with-exploration   # 앱을 둘러보며 시나리오 초안부터 만들기
/e2e:kick-off sign_in --skeleton-only       # 최소 뼈대 시나리오만 만들기

# 원하는 테스트 종류만 선택
/e2e:kick-off sign_in --layers=unit,bdd     # Unit + BDD 만
/e2e:kick-off sign_in --layers=bdd          # BDD 만

# 실제로 만들지 않고 계획만 미리보기
/e2e:kick-off sign_in --dry-run

• sign_in 자리에는 테스트를 깔 기능 이름을 적습니다 (소문자_언더바 형식).
• 옵션을 안 붙이면 기본으로 Unit + BDD 테스트를 만듭니다.
• 무엇이 만들어질지 먼저 확인하고 싶으면 --dry-run 으로 계획만 볼 수 있어요.

안에서 무슨 일이 벌어지나요#

대략 다음 순서로 진행됩니다.

1. 사전 조사 — 기능이 실제로 있는지, 이미 만들어진 테스트는 있는지, 손대면 안 되는(lock) 시나리오는 없는지 확인합니다.
2. Unit 테스트 깔기 — 작은 부품별 테스트 파일(UseCase / BLoC / Repository)을 한꺼번에 만듭니다.
3. 시나리오(.feature) 확보 — 이미 있으면 그대로 쓰고, 없으면 옵션에 따라 앱을 둘러보며 만들거나 최소 뼈대만 만듭니다.
4. BDD 테스트 깔기 — 시나리오에 맞는 단계별 템플릿을 만들고, 화면 단위 + 실제 기기 검증 파일을 자동 생성합니다.
5. E2E 테스트 판단 (선택) — 여러 기능을 가로지르는 "여정" 시나리오가 있으면 통합 테스트 쪽으로 옮겨 정리합니다.
6. 검증 — /pr:preflight 를 자동으로 돌려 방금 만든 테스트가 실제로 통과하는지 확인하고, 실패하면 원인을 정리해 PR 생성을 막아 줍니다.
7. 리포트 — 만든 파일 수, 남은 작업, 검증 결과, 다음 단계를 한눈에 정리해 보여줍니다.

# 기본 — feature 디렉토리에서 자동 감지
/e2e:kick-off sign_in

# .feature 생성 방법 명시
/e2e:kick-off sign_in --with-exploration      # flutter-skill 탐색부터
/e2e:kick-off sign_in --skeleton-only          # skeleton .feature 만 생성

# 특정 레이어만
/e2e:kick-off sign_in --layers=unit,bdd        # unit + BDD 만
/e2e:kick-off sign_in --layers=bdd             # BDD 만

# Dry run
/e2e:kick-off sign_in --dry-run                # 생성 계획만 출력

   /e2e:kick-off sign_in
        ↓
  [사전 조사]
   ├─ feature/common/auth/ 존재? ✅
   ├─ 기존 테스트? 일부 있음
   └─ lock 레코드? 없음
        ↓
  [Unit 레이어]
   ├─ UseCase: SignInUseCase → test/src/domain/usecase/sign_in_usecase_test.dart
   ├─ BLoC: SignInBloc → test/src/presentation/bloc/sign_in_bloc_test.dart
   └─ Repository: AuthRepository → test/src/data/repository/auth_repository_test.dart
        ↓
  [.feature 확보]
   └─ 없음 + --with-exploration
       → /e2e:explore sign_in → /e2e:draft sign_in
        ↓
  [BDD 레이어]
   ├─ step/ 템플릿 생성 (i_tap_the_sign_in_button.dart 등)
   ├─ build.yaml 확인
   └─ build_runner → sign_in.widget_test.dart + sign_in.patrol_test.dart
        ↓
  [E2E 레이어] (선택)
   └─ @journey 시나리오 없음 → skip
        ↓
  [검증] /pr:preflight --scope=feature_common_auth
   ├─ Unit   → PASS (42/0)
   ├─ Widget → PASS (12/0, BDD widget_test 포함)
   └─ Integration @smoke → SKIP (디바이스 없음 or 시나리오 미존재)
        ↓
  [리포트]
   ├─ 생성 파일 9개
   ├─ TODO step 3개 (목록)
   ├─ Preflight: PASS (Unit+Widget)
   └─ 다음 단계: step-implement 로 TODO 채우기 → /e2e:lock → /pr:preflight --with-integration