🧪 test: fix BDD step registration and update CI/CD workflow

- Fix step pattern escaping in pkg/bdd/steps/steps.go:80
- Update CI/CD workflow to use run-bdd-tests.sh script
- Enhance run-bdd-tests.sh for both local and CI environments
- Add strict validation for undefined/pending/skipped steps
- Update BDD testing documentation with pattern requirements

The CI/CD pipeline now properly validates BDD tests and fails on any
undefined, pending, or skipped steps. All 22 BDD scenarios are passing
with correct step pattern registration.

scripts/run-bdd-tests.sh

@@ -8,55 +8,73 @@ set -e
 echo "🧪 Running BDD Tests..."
 cd /Users/gabrielradureau/Work/Vibe/DanceLessonsCoach
 
-# Check if PostgreSQL container is running, start it if not
-echo "🐋 Checking PostgreSQL container..."
-if ! docker ps --format '{{.Names}}' | grep -q "^dance-lessons-coach-postgres$"; then
-    echo "🐋 Starting PostgreSQL container..."
-    docker compose up -d postgres
+# Check if we're in CI environment
+if [ -n "$GITHUB_ACTIONS" ] || [ -n "$GITEA_ACTIONS" ]; then
+    # CI environment - PostgreSQL is already running as a service
+    echo "🏗️ CI environment detected"
+    echo "🐋 PostgreSQL service is already running"
     
-    # Wait for PostgreSQL to be ready
-    echo "⏳ Waiting for PostgreSQL to be ready..."
-    max_attempts=30
-    attempt=0
-    while [ $attempt -lt $max_attempts ]; do
-        if docker exec dance-lessons-coach-postgres pg_isready -U postgres 2>/dev/null; then
-            echo "✅ PostgreSQL is ready!"
-            break
-        fi
-        attempt=$((attempt + 1))
-        sleep 1
-    done
-    
-    if [ $attempt -eq $max_attempts ]; then
-        echo "❌ PostgreSQL failed to start"
-        exit 1
-    fi
-    
-    # Create BDD test database (separate from development database)
-    echo "📦 Creating BDD test database..."
-    # Drop database if it exists, then create fresh
-    docker exec dance-lessons-coach-postgres psql -U postgres -c "DROP DATABASE IF EXISTS dance_lessons_coach_bdd_test;"
-    if docker exec dance-lessons-coach-postgres createdb -U postgres dance_lessons_coach_bdd_test; then
-        echo "✅ BDD test database created successfully!"
-    else
-        echo "❌ Failed to create BDD test database"
+    # Check if database is accessible
+    echo "📦 Checking PostgreSQL connectivity..."
+    if ! pg_isready -h postgres -p 5432 -U postgres -d dance_lessons_coach_bdd_test; then
+        echo "❌ PostgreSQL is not ready or accessible"
         exit 1
     fi
+    echo "✅ PostgreSQL is ready!"
 else
-    echo "✅ PostgreSQL container is already running"
+    # Local environment - use docker compose
+    echo "💻 Local environment detected"
     
-    # Check if BDD test database exists, create if not
-    echo "📦 Checking BDD test database..."
-    if docker exec dance-lessons-coach-postgres psql -U postgres -lqt | cut -d \| -f 1 | grep -qw "dance_lessons_coach_bdd_test"; then
-        echo "✅ BDD test database already exists"
-    else
+    # Check if PostgreSQL container is running, start it if not
+    echo "🐋 Checking PostgreSQL container..."
+    if ! docker ps --format '{{.Names}}' | grep -q "^dance-lessons-coach-postgres$"; then
+        echo "🐋 Starting PostgreSQL container..."
+        docker compose up -d postgres
+        
+        # Wait for PostgreSQL to be ready
+        echo "⏳ Waiting for PostgreSQL to be ready..."
+        max_attempts=30
+        attempt=0
+        while [ $attempt -lt $max_attempts ]; do
+            if docker exec dance-lessons-coach-postgres pg_isready -U postgres 2>/dev/null; then
+                echo "✅ PostgreSQL is ready!"
+                break
+            fi
+            attempt=$((attempt + 1))
+            sleep 1
+        done
+        
+        if [ $attempt -eq $max_attempts ]; then
+            echo "❌ PostgreSQL failed to start"
+            exit 1
+        fi
+        
+        # Create BDD test database (separate from development database)
         echo "📦 Creating BDD test database..."
+        # Drop database if it exists, then create fresh
+        docker exec dance-lessons-coach-postgres psql -U postgres -c "DROP DATABASE IF EXISTS dance_lessons_coach_bdd_test;"
         if docker exec dance-lessons-coach-postgres createdb -U postgres dance_lessons_coach_bdd_test; then
             echo "✅ BDD test database created successfully!"
         else
             echo "❌ Failed to create BDD test database"
             exit 1
         fi
+    else
+        echo "✅ PostgreSQL container is already running"
+        
+        # Check if BDD test database exists, create if not
+        echo "📦 Checking BDD test database..."
+        if docker exec dance-lessons-coach-postgres psql -U postgres -lqt | cut -d \| -f 1 | grep -qw "dance_lessons_coach_bdd_test"; then
+            echo "✅ BDD test database already exists"
+        else
+            echo "📦 Creating BDD test database..."
+            if docker exec dance-lessons-coach-postgres createdb -U postgres dance_lessons_coach_bdd_test; then
+                echo "✅ BDD test database created successfully!"
+            else
+                echo "❌ Failed to create BDD test database"
+                exit 1
+            fi
+        fi
     fi
 fi
 
@@ -90,6 +108,5 @@ if [ $test_exit_code -eq 0 ]; then
     exit 0
 else
     echo "❌ BDD tests failed"
-    echo 'DLC_DATABASE_HOST=localhost DLC_DATABASE_PORT=5432 DLC_DATABASE_USER=postgres DLC_DATABASE_PASSWORD=postgres DLC_DATABASE_NAME=dance_lessons_coach_bdd_test DLC_DATABASE_SSL_MODE=disable go test ./features/... -v'
     exit 1
 fi