/bdd:generate {feature_name} [--options]

feature/{location}/{feature_name}/
├── lib/
│   ├── ...
│   └── test_steps/                    # 도메인 특화 스텝 라이브러리
│       ├── common_steps.dart          # Feature 공용 스텝
│       └── {feature}_steps.dart       # Feature 전용 스텝
├── test/
│   ├── features/                      # .feature 파일
│   │   ├── {feature}_list.feature
│   │   ├── {feature}_detail.feature
│   │   └── {feature}_form.feature
│   └── steps/                         # 자동 생성 스텝 (build_runner)
│       └── ...
├── build.yaml
└── pubspec.yaml

targets:
  $default:
    sources:
      include:
        -  " pubspec.yaml " 
         - $package$
        - lib/$lib$
        - lib/**.dart
        - test/**
    builders:
      # BDD Widget Test - Feature 파일 기반 테스트 생성
      bdd_widget_test|featureBuilder:
        enabled: true
        options:
          # 자동 생성되는 스텝 저장 위치
          stepFolderName: test/steps

          # 외부 공용 스텝 라이브러리
          externalSteps:
            # Core 공통 스텝 (앱 전체 공용)
            - package:core/src/test/bdd/common_steps.dart
            - package:core/src/test/bdd/navigation_steps.dart
            - package:core/src/test/bdd/widget_steps.dart

            # Feature 전용 스텝 (선택사항)
            # - package:{feature}/test_steps/{feature}_steps.dart

import 'package:flutter/material.dart';
import 'package:flutter_test/flutter_test.dart';

// =============================================================================
// Given Steps
// =============================================================================

/// Usage: Given the app is running
/// 용도: 앱을 실행함
Future<void> theAppIsRunning(WidgetTester tester) async {
  await tester.pumpWidget(const MyApp());
  await tester.pumpAndSettle();
}

/// Usage: And user is logged in as {email}
/// 용도: {email} 계정으로 로그인된 상태를 설정
Future<void> userIsLoggedInAs(WidgetTester tester, String email) async {
  // 테스트용 로그인 상태 주입
}

// =============================================================================
// When Steps
// =============================================================================

/// Usage: When I tap {text} text
/// 용도: {text} 텍스트를 탭함
Future<void> iTapText(WidgetTester tester, String text) async {
  await tester.tap(find.text(text));
  await tester.pumpAndSettle();
}

/// Usage: And I tap enroll button
/// 용도: 등록 버튼을 탭함
Future<void> iTapEnrollButton(WidgetTester tester) async {
  await tester.tap(find.widgetWithText(ElevatedButton, '등록'));
  await tester.pumpAndSettle();
}

// =============================================================================
// Then Steps
// =============================================================================

/// Usage: Then I see {text} text
/// 용도: {text} 텍스트가 표시되는지 확인
Future<void> iSeeText(WidgetTester tester, String text) async {
  expect(find.text(text), findsOneWidget);
}

/// Usage: And I see class list screen
/// 용도: 수업 목록 화면이 표시되는지 확인
Future<void> iSeeClassListScreen(WidgetTester tester) async {
  expect(find.byType(ClassListView), findsOneWidget);
}

/// Usage: And I see at least {count} class items
/// 용도: 최소 {count}개의 수업 항목이 표시되는지 확인
Future<void> iSeeAtLeastClassItems(WidgetTester tester, int count) async {
  final items = find.byType(ClassListTile);
  expect(items, findsAtLeast(count));
}

Feature: 수업 등록
  학생이 원하는 수업을 검색하고 등록할 수 있는 기능을 테스트한다.
  등록 완료 후 마이페이지에서 등록된 수업을 확인할 수 있어야 한다.

  Background:
    # 앱 실행 및 로그인 상태 설정
    Given the app is running # 앱이 실행됨
    And user is logged in as { ' student@school.com ' } # 주어진 이메일로 로그인 상태임

  @smoke
  Scenario: 수업 목록 조회
    사용자가 수업 탭을 선택하면 현재 등록 가능한 수업 목록이 표시된다.

    # 수업 탭으로 이동
    When I tap { ' 수업 ' } text #  ' 수업 '   텍스트를 탭함
    # 수업 목록 화면 확인
    Then I see class list screen # 수업 목록 화면이 표시되는지 확인
    And I see at least {3} class items # 최소 3개의 수업 항목이 표시되는지 확인

  @enrollment @payment
  Scenario: 유료 수업 등록
    사용자가 유료 수업을 선택하고 결제를 완료하면 등록이 완료된다.

    # 수업 선택
    Given I am on class list screen # 수업 목록 화면에 있음
    When I tap { ' 고급 수학 ' } text #  ' 고급 수학 '   텍스트를 탭함
    # 등록 버튼 클릭
    And I tap enroll button # 등록 버튼을 탭함
    # 결제 진행
    And I complete payment with { ' 카드 ' } #  ' 카드 '   결제 진행
    # 등록 완료 확인
    Then I see { ' 등록이 완료되었습니다 ' } text #  ' 등록이 완료되었습니다 '   텍스트가 표시됨
    And class { ' 고급 수학 ' } appears in my enrolled list # 내 등록 내역에서  ' 고급 수학 ' 이 나타남

Feature: 숙제 제출
  학생이 숙제를 확인하고 제출할 수 있는 기능을 테스트한다.

  Background:
    Given the app is running # 앱이 실행됨
    And user is logged in as { ' student@school.com ' } # 주어진 이메일로 로그인 상태임

  @homework @submit
  Scenario: 숙제 파일 제출
    학생이 숙제에 파일을 첨부하고 제출하면 제출 완료 상태가 된다.

    Given I am on class list screen # 수업 목록 화면에 있음
    When I tap { ' 숙제 ' } text #  ' 숙제 '   텍스트를 탭함
    And I tap first homework item # 첫 번째 숙제 항목을 탭함
    And I attach file { ' answer.pdf ' } #  ' answer.pdf '   파일을 첨부함
    And I tap submit button # 제출 버튼을 탭함
    Then I see { ' 제출 완료 ' } text #  ' 제출 완료 '   텍스트가 표시됨
    And homework status is { ' 제출됨 ' } # 숙제 상태가  ' 제출됨 ' 임

Feature: 커뮤니티 글 작성
  학생이 여러 항목을 입력해 커뮤니티 글을 작성하고 등록할 수 있는 기능을 테스트한다.

  Background:
    Given the app is running # 앱이 실행됨
    And user is logged in as { ' student@school.com ' } # 주어진 이메일로 로그인 상태임

  @community @create
  Scenario: 여러 항목을 입력해 글 작성
    학생이 제목·내용·카테고리를 입력하고 등록하면 글 작성이 완료된다.

    Given user wants to write a post with the following details: # 다음 정보로 글을 작성하려 함
      | 제목   | 오늘의 학습 후기        |
      | 내용   | 수업이 유익했습니다      |
      | 카테고리 | 자유게시판             |
    When I submit the post # 글을 등록함
    Then I see { ' 등록되었습니다 ' } text #  ' 등록되었습니다 '   텍스트가 표시됨

# 이미 구현되어 있음 - 커스텀 스텝 불필요
Then I see { ' 환영합니다 ' } text #  ' 환영합니다 '   텍스트가 표시되는지 확인
And I tap { ' 확인 ' } text #  ' 확인 '   텍스트를 탭함
And I don ' t see { ' 로딩in progress ' } text #  ' 로딩in progress '   텍스트가 표시되지 않는지 확인
And I see {Icons.check} icon # 체크 아이콘이 표시되는지 확인
And I enter { ' test@email.com ' } into { ' 이메일 ' } input field #  ' 이메일 '   입력 칸에  ' test@email.com ' 을 입력함

include: package:core/bdd_options.yaml
externalSteps:
  - package:core/src/test/bdd/bdd.dart
  - package:{feature}/test_steps/common_steps.dart

import 'package:flutter/material.dart';
import 'package:flutter_test/flutter_test.dart';
import 'package:mocktail/mocktail.dart';

// Mock imports
import '../../mocks/mocks.dart';

/// BDD 테스트 Setup Hook
Future<void> setUp(WidgetTester tester) async {
  // Fallback values 등록
  registerFallbackValues();
}

/// BDD 테스트 TearDown Hook
Future<void> tearDown(WidgetTester tester) async {
  // Pure DI: getIt.reset() 불필요
}

/// Fallback values 등록
void registerFallbackValues() {
  // 필요한 fallback values 등록
  // registerFallbackValue(Fake{Entity}());
}

/bdd:generate community

/bdd:generate community \
  --from-claude-docs true \
  --run-build true

/bdd:generate community \
  --only-steps true

/bdd:generate community \
  --screens  " list,detail "

# Code generation
dart run build_runner build --delete-conflicting-outputs

# watch mode (recommended during development)
dart run build_runner watch --delete-conflicting-outputs

# Tests 실행
flutter test

# Tag filtering
flutter test --tags enrollment
flutter test --exclude-tags payment

# Run specific feature files only
flutter test test/features/class/

# Generate BDD test code
melos run test:bdd --scope={feature_name}

# Run BDD tests
melos run test:bdd --scope={feature_name}

# 전체 실행 (생성 + 테스트)
melos run test:bdd:full --scope={feature_name}

# 기존 step 인벤토리에서 유사 step 검색
find . -path  " */test/src/bdd/step/*.dart "   -exec basename {} \; | sort -u | grep -i  " {keyword} "