BE-PR-010: update submodule ref for Backend.Test

- remove --test-real-plugin option
- stop overriding test container CMD
- let Frontend.Test Dockerfile own proxy startup and playwright launch

.env.TEST

@@ -0,0 +1,14 @@
+# HarborForge Test Environment Variables
+# Default port values
+
+# Wizard service
+WIZARD_PORT=8080
+
+# MySQL service  
+MYSQL_PORT=3306
+
+# Backend service
+BACKEND_PORT=8000
+
+# Frontend service
+FRONTEND_PORT=3000

.gitmodules

@@ -1,6 +1,6 @@
 [submodule "HarborForge.Backend.Test"]
 	path = HarborForge.Backend.Test
-	url = https://zhi:rT5Wjw24mV4all38fIoNQfl2@git.hangman-lab.top/zhi/HarborForge.Backend.Test.git
+	url = https://git.hangman-lab.top/zhi/HarborForge.Backend.Test.git
 [submodule "HarborForge.Frontend.Test"]
 	path = HarborForge.Frontend.Test
-	url = https://zhi:rT5Wjw24mV4all38fIoNQfl2@git.hangman-lab.top/zhi/HarborForge.Frontend.Test.git
+	url = https://git.hangman-lab.top/zhi/HarborForge.Frontend.Test.git

cleanup.sh

@@ -0,0 +1,17 @@
+#!/bin/bash
+# Cleanup script for HarborForge Test
+# Removes containers and networks, but keeps images
+
+set -e
+
+COMPOSE_FILE="docker-compose-frontend.yml"
+
+echo "🧹 Cleaning up HarborForge Test containers..."
+
+# Stop and remove containers, networks (keep images)
+docker compose -f "$COMPOSE_FILE" down
+
+# Also remove the wizard config volume
+docker volume rm harborforgetest_wizard_config 2>/dev/null || true
+
+echo "✅ Cleanup complete!"

docker-compose-frontend-expose.yml

@@ -0,0 +1,116 @@
+services:
+  mysql:
+    image: mysql:8.0
+    container_name: harborforge-test-mysql
+    restart: "no"
+    tmpfs:
+      - /var/lib/mysql
+    environment:
+      MYSQL_ROOT_PASSWORD: ${MYSQL_ROOT_PASSWORD:-harborforge_root}
+      MYSQL_DATABASE: ${MYSQL_DATABASE:-harborforge}
+      MYSQL_USER: ${MYSQL_USER:-harborforge}
+      MYSQL_PASSWORD: ${MYSQL_PASSWORD:-harborforge_pass}
+    healthcheck:
+      test: ["CMD", "mysqladmin", "ping", "-h", "localhost"]
+      interval: 10s
+      timeout: 5s
+      retries: 5
+    ports:
+      - "127.0.0.1:${MYSQL_PORT:-3306}:3306"
+    networks:
+      - test-network
+
+  wizard:
+    build:
+      context: ../AbstractWizard
+      dockerfile: Dockerfile
+    image: harborforge-test-wizard:dev
+    container_name: harborforge-test-wizard
+    user: 0:0
+    restart: "no"
+    volumes:
+      - wizard_config:/config
+    environment:
+      CONFIG_DIR: /config
+      LISTEN_ADDR: "0.0.0.0:${WIZARD_PORT:-8080}"
+      MAX_BACKUPS: "5"
+      CORS_ORIGINS: http://frontend:${FRONTEND_PORT:-3000},http://127.0.0.1:${FRONTEND_PORT:-3000},http://localhost:${FRONTEND_PORT:-3000}
+    ports:
+      - "127.0.0.1:${WIZARD_PORT:-8080}:${WIZARD_PORT:-8080}"
+    networks:
+      - test-network
+
+  backend:
+    build:
+      context: ../HarborForge.Backend
+      dockerfile: Dockerfile
+    image: harborforge-test-backend:dev
+    container_name: harborforge-test-backend
+    restart: "no"
+    volumes:
+      - wizard_config:/config:ro
+    environment:
+      CONFIG_DIR: /config
+      CONFIG_FILE: harborforge.json
+      SECRET_KEY: ${SECRET_KEY:-change_me_in_production}
+      LOG_LEVEL: ${LOG_LEVEL:-INFO}
+      DATABASE_URL: mysql+pymysql://harborforge:harborforge_pass@mysql:${MYSQL_PORT:-3306}/harborforge
+    ports:
+      - "127.0.0.1:${BACKEND_PORT:-8000}:${BACKEND_PORT:-8000}"
+    depends_on:
+      mysql:
+        condition: service_healthy
+    networks:
+      - test-network
+
+  frontend:
+    build:
+      context: ../HarborForge.Frontend
+      dockerfile: Dockerfile
+      args:
+        VITE_WIZARD_PORT: ${WIZARD_PORT:-8080}
+    image: harborforge-test-frontend:dev
+    container_name: harborforge-test-frontend
+    restart: "no"
+    environment:
+      VITE_API_BASE_URL: http://backend:${BACKEND_PORT:-8000}
+      VITE_WIZARD_PORT: ${WIZARD_PORT:-8080}
+      FRONTEND_DEV_MODE: ${FRONTEND_DEV_MODE:-1}
+      NODE_ENV: development
+    ports:
+      - "127.0.0.1:${FRONTEND_PORT:-3000}:${FRONTEND_PORT:-3000}"
+    depends_on:
+      - wizard
+      - backend
+    networks:
+      - test-network
+
+  test:
+    build:
+      context: ./HarborForge.Frontend.Test
+      dockerfile: Dockerfile
+    image: harborforge-test-runner:dev
+    container_name: harborforge-test-runner
+    restart: "no"
+    environment:
+      # Use internal service name for test to reach frontend
+      BASE_URL: http://127.0.0.1:${FRONTEND_PORT:-3000}
+      FRONTEND_URL: http://127.0.0.1:${FRONTEND_PORT:-3000}
+      WEB_SERVER_URL: http://127.0.0.1:${FRONTEND_PORT:-3000}
+      WIZARD_URL: http://127.0.0.1:${WIZARD_PORT:-8080}/wizard
+      WIZARD_API_URL: http://127.0.0.1:${WIZARD_PORT:-8080}
+      WIZARD_HOST: wizard
+      WIZARD_PORT: ${WIZARD_PORT:-8080}
+      BACKEND_URL: http://127.0.0.1:${BACKEND_PORT:-8000}
+      BACKEND_HOST: backend
+      FRONTEND_HOST: frontend
+      CHROME_DEBUGGING_PORT: 9222
+    networks:
+      - test-network
+
+volumes:
+  wizard_config:
+
+networks:
+  test-network:
+    driver: bridge

docker-compose-frontend.yml

@@ -30,11 +30,12 @@ services:
       - wizard_config:/config
     environment:
       CONFIG_DIR: /config
-      LISTEN_ADDR: "0.0.0.0:8080"
+      LISTEN_ADDR: "0.0.0.0:${WIZARD_PORT:-8080}"
       MAX_BACKUPS: "5"
-      CORS_ORIGINS: http://frontend:3000
+      # Internal network only
+      CORS_ORIGINS: http://frontend:${FRONTEND_PORT:-3000}
     ports:
-      - "18080:8080"
+      - "127.0.0.1:${WIZARD_PORT:-8080}:${WIZARD_PORT:-8080}"
     networks:
       - test-network
 
@@ -52,7 +53,7 @@ services:
       CONFIG_FILE: harborforge.json
       SECRET_KEY: ${SECRET_KEY:-change_me_in_production}
       LOG_LEVEL: ${LOG_LEVEL:-INFO}
-      DATABASE_URL: mysql+pymysql://harborforge:harborforge_pass@mysql:3306/harborforge
+      DATABASE_URL: mysql+pymysql://harborforge:harborforge_pass@mysql:${MYSQL_PORT:-3306}/harborforge
     depends_on:
       mysql:
         condition: service_healthy
@@ -64,15 +65,16 @@ services:
       context: ../HarborForge.Frontend
       dockerfile: Dockerfile
       args:
-        VITE_WIZARD_PORT: 8080
+        VITE_WIZARD_PORT: ${WIZARD_PORT:-8080}
     image: harborforge-test-frontend:dev
     container_name: harborforge-test-frontend
     restart: "no"
     environment:
-      VITE_API_BASE_URL: http://backend:8000
+      # Use internal service name
-    depends_on:
+      VITE_API_BASE_URL: http://backend:${BACKEND_PORT:-8000}
-      - wizard
+      VITE_WIZARD_PORT: ${WIZARD_PORT:-8080}
-      - backend
+      FRONTEND_DEV_MODE: ${FRONTEND_DEV_MODE:-1}
+      NODE_ENV: development
     networks:
       - test-network
 
@@ -84,15 +86,13 @@ services:
     container_name: harborforge-test-runner
     restart: "no"
     environment:
-      BASE_URL: http://frontend:3000
+      BASE_URL: http://frontend:${FRONTEND_PORT:-3000}
-      WEB_SERVER_URL: http://frontend:3000
+      WEB_SERVER_URL: http://frontend:${FRONTEND_PORT:-3000}
-      WIZARD_URL: http://wizard:8080
+      WIZARD_URL: http://wizard:${WIZARD_PORT:-8080}/wizard
+      WIZARD_API_URL: http://wizard:${WIZARD_PORT:-8080}
+      WIZARD_HOST: wizard
+      WIZARD_PORT: ${WIZARD_PORT:-8080}
       CHROME_DEBUGGING_PORT: 9222
-    depends_on:
-      frontend:
-        condition: service_healthy
-      backend:
-        condition: service_healthy
     networks:
       - test-network
 

run-test-frontend.sh

@@ -0,0 +1,143 @@
+#!/bin/bash
+# Run frontend test with optional port exposure
+# Usage: ./run-test-frontend.sh [--expose-port {on|off}]
+# Default:
+#   --expose-port off: Auto cleanup after test
+
+set -e
+
+EXPOSE_PORT="off"
+COMPOSE_FILE="docker-compose-frontend.yml"
+
+# Load environment variables from .env.TEST if exists
+if [ -f ".env.TEST" ]; then
+    echo "📋 Loading .env.TEST..."
+    set -a
+    source .env.TEST
+    set +a
+fi
+
+# Parse arguments
+while [[ $# -gt 0 ]]; do
+    case $1 in
+        --expose-port)
+            EXPOSE_PORT="$2"
+            shift 2
+            ;;
+        --expose-port=*)
+            EXPOSE_PORT="${1#*=}"
+            shift
+            ;;
+        *)
+            echo "Unknown option: $1"
+            echo "Usage: $0 [--expose-port {on|off}]"
+            exit 1
+            ;;
+    esac
+done
+
+# Validate expose-port value
+if [[ "$EXPOSE_PORT" != "on" && "$EXPOSE_PORT" != "off" ]]; then
+    echo "Error: --expose-port must be 'on' or 'off'"
+    exit 1
+fi
+
+# Select compose file based on expose-port
+if [[ "$EXPOSE_PORT" == "on" ]]; then
+    COMPOSE_FILE="docker-compose-frontend-expose.yml"
+    echo "🔌 Port exposure: ON (services will keep running)"
+else
+    echo "🔌 Port exposure: OFF (auto cleanup after test)"
+fi
+
+echo "📦 Using compose file: $COMPOSE_FILE"
+
+run_quiet() {
+    local label="$1"
+    shift
+    local log_file
+    log_file=$(mktemp)
+    if "$@" >"$log_file" 2>&1; then
+        rm -f "$log_file"
+        return 0
+    fi
+    echo "❌ ${label} failed"
+    echo "--- ${label} log ---"
+    tail -n 200 "$log_file"
+    rm -f "$log_file"
+    return 1
+}
+
+# Clean any previous containers first
+echo "🧹 Cleaning up previous containers..."
+docker compose -f "$COMPOSE_FILE" down -v >/dev/null 2>&1 || true
+
+# Build frontend with correct API base URL (force no cache, remove image first)
+echo "🔨 Building frontend..."
+docker rmi harborforge-test-frontend:dev >/dev/null 2>&1 || true
+run_quiet "frontend build" docker compose -f "$COMPOSE_FILE" build --no-cache --build-arg VITE_API_BASE=http://backend:8000 frontend
+
+# Build backend (force no cache, remove image first)
+echo "🔨 Building backend..."
+docker rmi harborforge-test-backend:dev >/dev/null 2>&1 || true
+run_quiet "backend build" docker compose -f "$COMPOSE_FILE" build --no-cache backend
+
+# Build test runner (force no cache, remove image first)
+echo "🔨 Building test runner..."
+docker rmi harborforge-test-runner:dev >/dev/null 2>&1 || true
+run_quiet "test runner build" docker compose -f "$COMPOSE_FILE" build --no-cache test
+
+# Start services
+echo "📦 Starting services..."
+run_quiet "service startup" docker compose -f "$COMPOSE_FILE" up -d
+
+# Wait for frontend to be ready
+echo "⏳ Waiting for services..."
+MAX_RETRIES=30
+RETRY_COUNT=0
+until docker run --rm --network harborforgetest_test-network curlimages/curl -s -o /dev/null -w "%{http_code}" http://frontend:3000/ 2>/dev/null | grep -q "200" || [ $RETRY_COUNT -eq $MAX_RETRIES ]; do
+    echo "  Waiting for frontend... ($RETRY_COUNT/$MAX_RETRIES)"
+    sleep 2
+    RETRY_COUNT=$((RETRY_COUNT+1))
+done
+
+if [ $RETRY_COUNT -eq $MAX_RETRIES ]; then
+    echo "❌ Frontend failed to start"
+    docker compose -f "$COMPOSE_FILE" logs
+    docker compose -f "$COMPOSE_FILE" down -v
+    exit 1
+fi
+
+echo "✅ Services ready!"
+
+# Run test using the image default CMD so proxy startup stays inside Frontend.Test Dockerfile
+echo "🧪 Running test..."
+docker compose -f "$COMPOSE_FILE" run --rm -e WORKERS=1 test
+TEST_EXIT_CODE=$?
+
+# Cleanup decision based on expose-port
+if [[ "$EXPOSE_PORT" == "on" ]]; then
+    echo ""
+    echo "🔌 Port exposure is ON - keeping services running!"
+    echo "   Use './run-test-frontend.sh --expose-port on' to cleanup"
+    echo "   Or manually: docker compose -f $COMPOSE_FILE down -v"
+    echo ""
+
+    if [ $TEST_EXIT_CODE -eq 0 ]; then
+        echo "✅ Test passed!"
+    else
+        echo "❌ Test failed with exit code: $TEST_EXIT_CODE"
+    fi
+else
+    echo ""
+    echo "🧹 Cleaning up containers and volumes..."
+    docker compose -f "$COMPOSE_FILE" down -v
+
+    if [ $TEST_EXIT_CODE -eq 0 ]; then
+        echo "✅ Test passed!"
+    else
+        echo "❌ Test failed with exit code: $TEST_EXIT_CODE"
+    fi
+fi
+
+exit $TEST_EXIT_CODE

run-test.sh

@@ -0,0 +1,49 @@
+#!/bin/bash
+# Run test and cleanup afterwards
+set -e
+
+COMPOSE_FILE="docker-compose-frontend.yml"
+
+echo "🚀 Running HarborForge Test..."
+
+# Clean any previous containers first
+docker compose -f "$COMPOSE_FILE" down 2>/dev/null || true
+
+# Start services
+echo "📦 Starting services..."
+docker compose -f "$COMPOSE_FILE" up -d
+
+# Wait for frontend to be ready (run curl inside docker network)
+echo "⏳ Waiting for services..."
+MAX_RETRIES=30
+RETRY_COUNT=0
+until docker run --rm --network harborforgetest_test-network curlimages/curl -s -o /dev/null -w "%{http_code}" http://frontend:3000/ 2>/dev/null | grep -q "200" || [ $RETRY_COUNT -eq $MAX_RETRIES ]; do
+    echo "  Waiting for frontend... ($RETRY_COUNT/$MAX_RETRIES)"
+    sleep 2
+    RETRY_COUNT=$((RETRY_COUNT+1))
+done
+
+if [ $RETRY_COUNT -eq $MAX_RETRIES ]; then
+    echo "❌ Frontend failed to start"
+    docker compose -f "$COMPOSE_FILE" logs
+    docker compose -f "$COMPOSE_FILE" down -v
+    exit 1
+fi
+
+echo "✅ Services ready!"
+
+# Run test
+docker compose -f "$COMPOSE_FILE" run --rm test
+TEST_EXIT_CODE=$?
+
+echo ""
+echo "🧹 Cleaning up containers and volumes..."
+docker compose -f "$COMPOSE_FILE" down -v
+
+if [ $TEST_EXIT_CODE -eq 0 ]; then
+    echo "✅ Test passed!"
+else
+    echo "❌ Test failed with exit code: $TEST_EXIT_CODE"
+fi
+
+exit $TEST_EXIT_CODE