Merge PR #33: Fix Docker builds, add smoke test skill, update workflow

Merges refactor/web-cleanup-31 into main with all infrastructure fixes:
- Directory.Packages.props handling in all Dockerfiles
- Missing email-api-data dependencies in build configs
- Missing appsettings.json for email-api
- myai-smoke-test skill for automated end-to-end testing
- general-dev-workflow skill updates for build verification

All 7 containers building and running successfully.

Closes #33

.gitea/workflows/build.yml

@@ -11,6 +11,7 @@ env:
   API_IMAGE: apps/myai-api
   CV_MATCHER_API_IMAGE: apps/myai-cv-matcher-api
   RAG_API_IMAGE: apps/myai-rag-api
+  EMAIL_API_IMAGE: apps/myai-email-api
   WEB_IMAGE: apps/myai-web
   CV_CLEANUP_JOB_IMAGE: apps/myai-cv-cleanup-job
   CV_SEARCH_JOB_IMAGE: apps/myai-cv-search-job
@@ -45,6 +46,10 @@ jobs:
         run: |
           docker build -f Apis/rag-api/Dockerfile -t "${REGISTRY_HOST}/${RAG_API_IMAGE}:${IMAGE_TAG}" .
 
+      - name: Build Email API image
+        run: |
+          docker build -f Apis/email-api/Dockerfile -t "${REGISTRY_HOST}/${EMAIL_API_IMAGE}:${IMAGE_TAG}" .
+
       - name: Build Web image
         run: |
           docker build -f web/Dockerfile -t "${REGISTRY_HOST}/${WEB_IMAGE}:${IMAGE_TAG}" .
@@ -69,6 +74,10 @@ jobs:
         run: |
           docker push "${REGISTRY_HOST}/${RAG_API_IMAGE}:${IMAGE_TAG}"
 
+      - name: Push Email API image
+        run: |
+          docker push "${REGISTRY_HOST}/${EMAIL_API_IMAGE}:${IMAGE_TAG}"
+
       - name: Push Web image
         run: |
           docker push "${REGISTRY_HOST}/${WEB_IMAGE}:${IMAGE_TAG}"

Apis/api/Dockerfile

@@ -2,10 +2,13 @@ FROM mcr.microsoft.com/dotnet/sdk:10.0 AS build
 ARG BUILD_CONFIGURATION=Release
 WORKDIR /src
 
+COPY Directory.Packages.props ./
 COPY Apis/api/api.csproj Apis/api/
-COPY Apis/common/common.csproj Apis/common/
 COPY Apis/api-models/api-models.csproj Apis/api-models/
+COPY Apis/email-api-data/email-api-data.csproj Apis/email-api-data/
+COPY Apis/email-api-models/email-api-models.csproj Apis/email-api-models/
 COPY Apis/cv-matcher-api-models/cv-matcher-api-models.csproj Apis/cv-matcher-api-models/
+COPY Apis/common/common.csproj Apis/common/
 COPY Apis/myai-data/myai-data.csproj Apis/myai-data/
 COPY Apis/shared-data/shared-data.csproj Apis/shared-data/
 COPY Helpers/startup-helpers/startup-helpers.csproj Helpers/startup-helpers/
@@ -13,9 +16,11 @@ COPY Helpers/startup-helpers/startup-helpers.csproj Helpers/startup-helpers/
 RUN dotnet restore Apis/api/api.csproj
 
 COPY Apis/api/ Apis/api/
-COPY Apis/common/ Apis/common/
 COPY Apis/api-models/ Apis/api-models/
+COPY Apis/email-api-data/ Apis/email-api-data/
+COPY Apis/email-api-models/ Apis/email-api-models/
 COPY Apis/cv-matcher-api-models/ Apis/cv-matcher-api-models/
+COPY Apis/common/ Apis/common/
 COPY Apis/myai-data/ Apis/myai-data/
 COPY Apis/shared-data/ Apis/shared-data/
 COPY Helpers/startup-helpers/ Helpers/startup-helpers/

Apis/cv-matcher-api/Dockerfile

@@ -2,6 +2,7 @@ FROM mcr.microsoft.com/dotnet/sdk:10.0 AS build
 ARG BUILD_CONFIGURATION=Release
 WORKDIR /src
 
+COPY Directory.Packages.props ./
 COPY Apis/cv-matcher-api/cv-matcher-api.csproj Apis/cv-matcher-api/
 COPY Apis/cv-search-data/cv-search-data.csproj Apis/cv-search-data/
 COPY Apis/cv-matcher-data/cv-matcher-data.csproj Apis/cv-matcher-data/

Apis/email-api/Dockerfile

@@ -3,6 +3,7 @@ ARG BUILD_CONFIGURATION=Release
 WORKDIR /src
 
 COPY Apis/email-api/email-api.csproj Apis/email-api/
+COPY Apis/email-api-data/email-api-data.csproj Apis/email-api-data/
 COPY Apis/email-api-models/email-api-models.csproj Apis/email-api-models/
 COPY Apis/api-models/api-models.csproj Apis/api-models/
 COPY Apis/common/common.csproj Apis/common/
@@ -13,6 +14,7 @@ COPY Directory.Packages.props ./
 RUN dotnet restore Apis/email-api/email-api.csproj
 
 COPY Apis/email-api/ Apis/email-api/
+COPY Apis/email-api-data/ Apis/email-api-data/
 COPY Apis/email-api-models/ Apis/email-api-models/
 COPY Apis/api-models/ Apis/api-models/
 COPY Apis/common/ Apis/common/

Apis/email-api/appsettings.json

@@ -0,0 +1,98 @@
+{
+  "Serilog": {
+    "Using": [
+      "Serilog.Sinks.Console",
+      "Serilog.Sinks.File",
+      "Serilog.Sinks.Email"
+    ],
+    "MinimumLevel": {
+      "Default": "Information",
+      "Override": {
+        "Microsoft.AspNetCore": "Warning",
+        "Microsoft.AspNetCore.Hosting": "Information",
+        "Microsoft.AspNetCore.Routing": "Warning",
+        "System.Net.Http.HttpClient": "Warning",
+        "EmailApi": "Information"
+      }
+    },
+    "WriteTo": [
+      {
+        "Name": "Console",
+        "Args": {
+          "outputTemplate": "[{Timestamp:HH:mm:ss} {Level:u3}] {SourceContext}: {Message:lj}{NewLine}{Exception}"
+        }
+      },
+      {
+        "Name": "File",
+        "Args": {
+          "path": "logs/email-api-.log",
+          "rollingInterval": "Day",
+          "retainedFileCountLimit": 30,
+          "outputTemplate": "{Timestamp:yyyy-MM-dd HH:mm:ss.fff zzz} [{Level:u3}] {SourceContext}: {Message:lj}{NewLine}{Exception}"
+        }
+      },
+      {
+        "Name": "Email",
+        "Args": {
+          "restrictedToMinimumLevel": "Error",
+          "fromEmail": "",
+          "toEmail": "",
+          "mailServer": "",
+          "networkCredential": {
+            "userName": "",
+            "password": ""
+          },
+          "port": 587,
+          "enableSsl": true,
+          "emailSubject": "[myAi] Email API Error Alert",
+          "outputTemplate": "{Timestamp:yyyy-MM-dd HH:mm:ss.fff zzz} [{Level:u3}] {SourceContext}{NewLine}{Message:lj}{NewLine}{Exception}",
+          "batchPostingLimit": 10,
+          "period": "0.00:05:00"
+        }
+      }
+    ],
+    "Enrich": [
+      "FromLogContext",
+      "WithMachineName",
+      "WithEnvironmentName"
+    ]
+  },
+  "Logging": {
+    "LogLevel": {
+      "Default": "Information",
+      "Microsoft.AspNetCore": "Warning",
+      "Microsoft.AspNetCore.Hosting": "Information",
+      "Microsoft.AspNetCore.Routing": "Warning",
+      "System.Net.Http.HttpClient": "Warning",
+      "EmailApi": "Information"
+    }
+  },
+  "LogEnvironmentOnStartup": true,
+  "AllowedHosts": "*",
+  "KeyVault": {
+    "VaultUri": "",
+    "Enabled": false
+  },
+  "Database": {
+    "Host": "localhost",
+    "Port": 1433,
+    "Name": "MyAiDb",
+    "User": "sa",
+    "Password": "",
+    "TrustServerCertificate": true
+  },
+  "InternalApi": {
+    "ApiKey": "",
+    "RequireApiKey": true
+  },
+  "Smtp": {
+    "Host": "mail.easysoft.ro",
+    "Port": 587,
+    "Username": "no-reply@easysoft.ro",
+    "Password": "",
+    "UseStartTls": true
+  },
+  "FileStorage": {
+    "Path": "Files"
+  }
+}

Apis/rag-api/Dockerfile

@@ -1,6 +1,7 @@
 FROM mcr.microsoft.com/dotnet/sdk:10.0 AS build
 ARG BUILD_CONFIGURATION=Release
 WORKDIR /src
+COPY Directory.Packages.props ./
 
 COPY Apis/rag-api/rag-api.csproj Apis/rag-api/
 COPY Apis/rag-data/rag-data.csproj Apis/rag-data/

Jobs/cv-cleanup-job/Dockerfile

@@ -1,6 +1,7 @@
 FROM mcr.microsoft.com/dotnet/sdk:10.0 AS build
 ARG BUILD_CONFIGURATION=Release
 WORKDIR /src
+COPY Directory.Packages.props ./
 
 COPY Jobs/cv-cleanup-job/cv-cleanup-job.csproj Jobs/cv-cleanup-job/
 COPY Jobs/job-scheduler/job-scheduler.csproj Jobs/job-scheduler/

Jobs/cv-search-job/Dockerfile

@@ -1,11 +1,14 @@
 FROM mcr.microsoft.com/dotnet/sdk:10.0 AS build
 ARG BUILD_CONFIGURATION=Release
 WORKDIR /src
+COPY Directory.Packages.props ./
 
 COPY Jobs/cv-search-job/cv-search-job.csproj Jobs/cv-search-job/
 COPY Jobs/job-scheduler/job-scheduler.csproj Jobs/job-scheduler/
 COPY Apis/cv-search-data/cv-search-data.csproj Apis/cv-search-data/
 COPY Apis/cv-matcher-api-models/cv-matcher-api-models.csproj Apis/cv-matcher-api-models/
+COPY Apis/email-api-data/email-api-data.csproj Apis/email-api-data/
+COPY Apis/email-api-models/email-api-models.csproj Apis/email-api-models/
 COPY Apis/common/common.csproj Apis/common/
 COPY Apis/myai-data/myai-data.csproj Apis/myai-data/
 COPY Apis/shared-data/shared-data.csproj Apis/shared-data/
@@ -17,6 +20,8 @@ COPY Jobs/cv-search-job/ Jobs/cv-search-job/
 COPY Jobs/job-scheduler/ Jobs/job-scheduler/
 COPY Apis/cv-search-data/ Apis/cv-search-data/
 COPY Apis/cv-matcher-api-models/ Apis/cv-matcher-api-models/
+COPY Apis/email-api-data/ Apis/email-api-data/
+COPY Apis/email-api-models/ Apis/email-api-models/
 COPY Apis/common/ Apis/common/
 COPY Apis/myai-data/ Apis/myai-data/
 COPY Apis/shared-data/ Apis/shared-data/

docker-compose/docker-compose.override.yml

@@ -21,6 +21,15 @@ services:
     env_file:
       - .env
 
+  email-api:
+    build:
+      context: ..
+      dockerfile: Apis/email-api/Dockerfile
+    ports:
+      - "8083:8080"
+    env_file:
+      - .env
+
   api:
     build:
       context: ..

docs/skills/general-dev-workflow.md

@@ -78,6 +78,19 @@ Steps:
 ### Phase 4: Test
 **Goal**: Verify the code works correctly and doesn't break existing functionality.
 
+**Build verification (critical for compiled languages):**
+- Run `dotnet build <solution>` (for .NET projects) or equivalent build command for your tech stack
+- Fix any compilation errors before proceeding
+- If your project has multiple build targets, test all of them (e.g., multiple Dockerfiles, web + API)
+- **Docker projects**: Run `docker compose --build` to verify all Docker images build successfully
+- Check build artifacts exist and are correct size (no suspiciously small binaries)
+
+**Why build verification matters:**
+- Catches missing dependencies, import errors, and configuration issues early
+- Prevents "it works on my machine" problems during code review
+- Docker builds especially must be verified as they catch missing project references and file copies
+- A failed build blocks reviewers and CI/CD pipelines
+
 **Write tests for your changes:**
 - Unit tests for individual functions/methods
 - Integration tests if your code touches multiple systems
@@ -99,9 +112,9 @@ Steps:
 - Any manual testing notes
 - Known limitations or edge cases not yet tested
 
-**Output**: Passing tests, code coverage report, test summary.
+**Output**: Passing tests, code coverage report, test summary, successful build.
 
-**Checkpoint**: Can you confidently say the code works? Are there any untested paths you're worried about?
+**Checkpoint**: Does the code compile without errors? Can you confidently say the code works? Are there any untested paths you're worried about?
 
 ---
 
@@ -184,6 +197,8 @@ Problem it solves / value it adds (2-3 sentences)
 
 **Keep phases focused.** Don't mix planning with implementation. Don't test in Phase 2. This separation helps catch problems early.
 
+**Verify builds before review.** Always run a full build (`dotnet build` or `docker compose --build`) in Phase 4 before opening the PR. Build errors block reviewers and waste CI/CD time. If you're changing Dockerfiles or project dependencies, this is especially critical.
+
 **Commit frequently.** Small commits are easier to review, easier to revert if needed, and easier to understand. Aim for 50-200 lines per commit.
 
 **Write for your future self.** Six months from now, you'll read your own commits and PRs. Make them clear.

docs/skills/myai-smoke-test/SKILL.md

@@ -0,0 +1,187 @@
+---
+name: myai-smoke-test
+description: Run a smoke test of the myAi CV Matcher application locally. Starts Docker Compose, uploads a CV, submits a job description, verifies CV analysis results display, and confirms the match email was sent. Use this skill whenever you need to validate that the core CV matching workflow is functioning correctly after code changes.
+compatibility: Requires Docker, Docker Compose, Chrome/Chromium, Python 3.8+, Selenium WebDriver
+---
+
+# myAi Smoke Test Skill
+
+## Purpose
+
+This skill automates a minimal end-to-end test of the myAi CV Matcher application running locally. It verifies:
+1. Application starts and health check passes
+2. CV upload and parsing works
+3. Job description input and matching is triggered
+4. CV analysis results display (score, strengths, gaps, evidence)
+5. Match email is sent to the configured recipient
+
+Use this after significant code changes to ensure the core workflow remains functional.
+
+## Prerequisites
+
+- **Docker & Docker Compose** installed and running
+- **Chrome or Chromium** browser installed (`chromedriver` auto-downloads via Selenium)
+- **Python 3.8+** with pip
+- **CV.pdf** file in the project root (`C:\Apps\easySoft\AI\myAi\CV.pdf`)
+- The myAi solution source code locally available
+- Port 5140 available (web app), 8080 (api), 8081 (rag-api), 8082 (cv-matcher-api), 5432 (database), 1025 (mailhog)
+
+## Workflow
+
+### 1. Start Application (45-second timeout)
+
+The script launches Docker Compose from the project root:
+```bash
+docker compose -f docker-compose/docker-compose.yml up --build -d
+```
+
+Then waits up to 45 seconds for the web application at `http://localhost:5140` to become ready (HTTP 200 on root path).
+
+**Success criteria**: GET `/` returns HTTP 200
+**Failure**: Application does not respond within 45 seconds → test fails with "Application startup timeout"
+
+### 2. Open Browser & Navigate
+
+Opens Chrome (in headless or visible mode, configurable) and navigates to the home page.
+
+### 3. Upload CV (Hardcoded CV.pdf)
+
+Uploads the CV.pdf file from the project root to the CV file input on the home page.
+
+**Expected behavior**:
+- File input accepts the PDF
+- JavaScript triggers the file change handler
+- Filename displays in the UI (e.g., "CV.pdf selected")
+
+### 4. Fill Job Description (Hardcoded)
+
+Fills the job description input with:
+```
+Senior Full Stack Engineer - 5+ years experience with C# ASP.NET Core, 
+React, and cloud deployment. Experience with CI/CD pipelines, Docker, 
+and agile teams required.
+```
+
+**Expected behavior**:
+- Textarea accepts input
+- Text is visible in the field
+
+### 5. Submit Form (Completes reCaptcha if needed)
+
+Clicks the "Submit" button to trigger the CV match API call.
+
+**Behavior**:
+- If reCaptcha is required, the script waits for it to be marked `data-sitekey` complete
+- Form submission triggers async `postCv()` function
+- API call goes to `/api/cv/match` with CV file and job description
+- Response includes `matchScore`, `strengths`, `gaps`, `evidence`
+
+### 6. Verify Results Display (30-second timeout)
+
+Waits for results to appear on the page:
+- Checks for `.match-result` container visibility
+- Verifies match score badge displays (0-100%)
+- Checks for strengths list (ul.strengths with li items)
+- Checks for gaps list (ul.gaps with li items)
+- Checks for evidence section (div.evidence with bullets)
+
+**Success criteria**: All result elements present and visible within 30 seconds
+**Failure**: Results do not display → test fails with "Results did not display within timeout"
+
+### 7. Verify Email Sent (Log Check)
+
+Checks Docker container logs for email delivery confirmation:
+- Inspects `email-api` container logs
+- Searches for "Message sent" confirmation message
+- Verifies the recipient includes the job candidate email
+
+**Success criteria**: Log contains email send confirmation
+**Failure**: No email confirmation found → test fails with "Email was not sent"
+
+### 8. Report Results
+
+Reports one of:
+- **All passed**: "✓ Smoke test passed. CV uploaded, matched (score: X%), results displayed, email sent."
+- **Partial failure**: Details which step failed (e.g., "✗ Results did not display within timeout")
+- **Critical failure**: "✗ Application failed to start" or "✗ File upload failed"
+
+## Hardcoded Values
+
+These are built into the skill and do not require environment variables:
+
+| Value | Usage |
+|-------|-------|
+| `CV.pdf` (from root) | CV file upload |
+| `Senior Full Stack Engineer...` (job desc) | Job matching criteria |
+| `http://localhost:5140` | Web app home |
+| 45 seconds | App startup timeout |
+| 30 seconds | Results display timeout |
+
+## Environment Variables (Optional)
+
+| Variable | Default | Purpose |
+|----------|---------|---------|
+| `HEADLESS_CHROME` | `true` | Run Chrome in headless mode (no visible window) |
+| `DOCKER_COMPOSE_FILE` | `docker-compose/docker-compose.yml` | Path to docker-compose.yml relative to project root |
+| `APP_PORT` | `5140` | Port the web app runs on |
+| `APP_STARTUP_TIMEOUT` | `45` | Seconds to wait for app health check |
+| `RESULTS_DISPLAY_TIMEOUT` | `30` | Seconds to wait for results to appear |
+| `PROJECT_ROOT` | Current directory | Root of myAi solution |
+
+## Output
+
+On success:
+```
+✓ Smoke test passed. CV uploaded, matched (score: 87%), results displayed, email sent.
+```
+
+On failure:
+```
+✗ Application failed to start (timeout after 45 seconds)
+[Details of failed step]
+```
+
+## Troubleshooting
+
+### "Application startup timeout"
+- Verify Docker Compose is running: `docker ps`
+- Check logs: `docker logs myai-web-1`
+- Ensure port 5140 is not in use: `netstat -an | grep 5140` (Windows) or `lsof -i :5140` (Mac/Linux)
+
+### "File upload failed"
+- Verify CV.pdf exists in project root
+- Check file permissions (readable by your user)
+- Ensure the file input element exists in the form
+
+### "Results did not display"
+- Check browser console for JavaScript errors: `docker logs myai-web-1`
+- Verify the `/api/cv/match` endpoint is responding: manually test with Postman
+- Check cv-matcher-api logs: `docker logs myai-cv-matcher-api-1`
+
+### "Email was not sent"
+- Verify email-api container is running: `docker ps | grep email-api`
+- Check email-api logs: `docker logs myai-email-api-1`
+- If using MailHog for local testing, verify it's accessible: `http://localhost:1025`
+
+### Chrome/Chromedriver issues
+- Selenium automatically downloads chromedriver on first run
+- If Chrome is not in PATH, install from https://chromedriver.chromium.org/
+- Verify Chrome version matches chromedriver version
+
+## Running the Skill
+
+```bash
+python scripts/run_smoke_test.py
+```
+
+Or from within Claude:
+- Trigger the skill with: "Run the myAi smoke test"
+- Or: "Execute a smoke test of the CV matching workflow"
+
+## Implementation Notes
+
+- Uses Selenium WebDriver with Chrome (auto-downloaded by webdriver-manager)
+- Handles async JavaScript (waits for API response before checking results)
+- Logs all steps to console with timestamps
+- Automatically stops Docker Compose containers on test completion (can be disabled with `KEEP_CONTAINERS=true`)
+- Tests are idempotent — can run multiple times without side effects

docs/skills/myai-smoke-test/scripts/run_smoke_test.py

@@ -0,0 +1,392 @@
+#!/usr/bin/env python3
+"""
+myAi Smoke Test Automation Script
+
+Runs a minimal end-to-end test of the myAi CV Matcher application:
+1. Starts Docker Compose
+2. Waits for app health check
+3. Uploads CV.pdf and job description
+4. Verifies CV analysis results display
+5. Confirms match email was sent
+
+Exit codes:
+0 = All tests passed
+1 = One or more tests failed
+2 = Critical error (app won't start, file not found, etc.)
+"""
+
+import os
+import sys
+import time
+import json
+import subprocess
+import requests
+from pathlib import Path
+from datetime import datetime
+from urllib.parse import urljoin
+
+try:
+    from selenium import webdriver
+    from selenium.webdriver.common.by import By
+    from selenium.webdriver.support.ui import WebDriverWait
+    from selenium.webdriver.support import expected_conditions as EC
+    from selenium.webdriver.chrome.options import Options
+    from webdriver_manager.chrome import ChromeDriverManager
+    from selenium.webdriver.chrome.service import Service
+except ImportError:
+    print("ERROR: Required packages not found. Install with:")
+    print("pip install selenium webdriver-manager requests")
+    sys.exit(2)
+
+
+# Configuration
+PROJECT_ROOT = os.environ.get("PROJECT_ROOT", os.getcwd())
+APP_BASE_URL = os.environ.get("APP_BASE_URL", "http://localhost:5140")
+DOCKER_COMPOSE_FILE = os.environ.get("DOCKER_COMPOSE_FILE", "docker-compose/docker-compose.yml")
+APP_STARTUP_TIMEOUT = int(os.environ.get("APP_STARTUP_TIMEOUT", 45))
+RESULTS_DISPLAY_TIMEOUT = int(os.environ.get("RESULTS_DISPLAY_TIMEOUT", 30))
+HEADLESS_CHROME = os.environ.get("HEADLESS_CHROME", "true").lower() == "true"
+KEEP_CONTAINERS = os.environ.get("KEEP_CONTAINERS", "false").lower() == "true"
+
+# Hardcoded test data
+CV_FILE_PATH = os.path.join(PROJECT_ROOT, "CV.pdf")
+JOB_DESCRIPTION = """Senior Full Stack Engineer - 5+ years experience with C# ASP.NET Core, React, and cloud deployment. Experience with CI/CD pipelines, Docker, and agile teams required."""
+
+
+def log(message, level="INFO"):
+    """Log a message with timestamp."""
+    timestamp = datetime.now().strftime("%Y-%m-%d %H:%M:%S")
+    print(f"[{timestamp}] [{level}] {message}")
+
+
+def run_command(command, cwd=None):
+    """Run a shell command and return result."""
+    try:
+        result = subprocess.run(
+            command,
+            shell=True,
+            cwd=cwd or PROJECT_ROOT,
+            capture_output=True,
+            text=True,
+            timeout=60
+        )
+        return result.returncode, result.stdout, result.stderr
+    except subprocess.TimeoutExpired:
+        return -1, "", "Command timed out"
+    except Exception as e:
+        return -1, "", str(e)
+
+
+def check_app_health():
+    """Check if app is responding to health check."""
+    try:
+        response = requests.get(APP_BASE_URL, timeout=2)
+        return response.status_code == 200
+    except requests.RequestException:
+        return False
+
+
+def wait_for_app_startup():
+    """Wait for app to be ready, up to APP_STARTUP_TIMEOUT seconds."""
+    log(f"Waiting for app at {APP_BASE_URL}...")
+    start_time = time.time()
+
+    while time.time() - start_time < APP_STARTUP_TIMEOUT:
+        if check_app_health():
+            log(f"✓ App is ready (took {time.time() - start_time:.1f}s)")
+            return True
+        time.sleep(1)
+
+    log(f"✗ App failed to start within {APP_STARTUP_TIMEOUT} seconds", "ERROR")
+    return False
+
+
+def start_docker_compose():
+    """Start Docker Compose containers."""
+    log("Starting Docker Compose...")
+    docker_compose_path = os.path.join(PROJECT_ROOT, DOCKER_COMPOSE_FILE)
+
+    if not os.path.exists(docker_compose_path):
+        log(f"ERROR: docker-compose file not found at {docker_compose_path}", "ERROR")
+        return False
+
+    # Include both main compose file and override file for local builds
+    override_file = os.path.join(os.path.dirname(DOCKER_COMPOSE_FILE), "docker-compose.override.yml")
+    compose_cmd = f"docker compose -f {DOCKER_COMPOSE_FILE} -f {override_file} up --build -d"
+
+    returncode, stdout, stderr = run_command(compose_cmd)
+
+    if returncode != 0:
+        log(f"ERROR: Failed to start Docker Compose: {stderr}", "ERROR")
+        return False
+
+    log("Docker Compose started, waiting for app to be ready...")
+    return wait_for_app_startup()
+
+
+def stop_docker_compose():
+    """Stop Docker Compose containers."""
+    if KEEP_CONTAINERS:
+        log("KEEP_CONTAINERS=true, leaving containers running")
+        return
+
+    log("Stopping Docker Compose...")
+    override_file = os.path.join(os.path.dirname(DOCKER_COMPOSE_FILE), "docker-compose.override.yml")
+    compose_cmd = f"docker compose -f {DOCKER_COMPOSE_FILE} -f {override_file} down"
+    run_command(compose_cmd)
+
+
+def initialize_chrome_driver():
+    """Initialize Selenium Chrome WebDriver."""
+    log("Initializing Chrome WebDriver...")
+
+    try:
+        options = Options()
+        if HEADLESS_CHROME:
+            options.add_argument("--headless=new")
+        options.add_argument("--disable-blink-features=AutomationControlled")
+        options.add_argument("--disable-gpu")
+        options.add_argument("--no-sandbox")
+        options.add_argument("--disable-dev-shm-usage")
+
+        service = Service(ChromeDriverManager().install())
+        driver = webdriver.Chrome(service=service, options=options)
+        log("✓ Chrome WebDriver ready")
+        return driver
+    except Exception as e:
+        log(f"ERROR: Failed to initialize Chrome: {e}", "ERROR")
+        return None
+
+
+def upload_cv(driver):
+    """Upload CV.pdf file."""
+    log("Uploading CV file...")
+
+    if not os.path.exists(CV_FILE_PATH):
+        log(f"ERROR: CV file not found at {CV_FILE_PATH}", "ERROR")
+        return False
+
+    try:
+        # Find the file input element
+        file_input = WebDriverWait(driver, 10).until(
+            EC.presence_of_element_located((By.ID, "cvFile"))
+        )
+
+        # Send the file path to the input
+        file_input.send_keys(os.path.abspath(CV_FILE_PATH))
+        log(f"✓ CV file uploaded ({os.path.basename(CV_FILE_PATH)})")
+
+        # Wait a moment for the file change handler to process
+        time.sleep(1)
+        return True
+    except Exception as e:
+        log(f"ERROR: Failed to upload CV: {e}", "ERROR")
+        return False
+
+
+def fill_job_description(driver):
+    """Fill in the job description field."""
+    log("Filling job description...")
+
+    try:
+        # Find the job description textarea
+        job_input = WebDriverWait(driver, 10).until(
+            EC.presence_of_element_located((By.ID, "jobInput"))
+        )
+
+        # Clear any existing content and fill
+        job_input.clear()
+        job_input.send_keys(JOB_DESCRIPTION)
+        log("✓ Job description filled")
+        return True
+    except Exception as e:
+        log(f"ERROR: Failed to fill job description: {e}", "ERROR")
+        return False
+
+
+def submit_form(driver):
+    """Submit the CV match form."""
+    log("Submitting form...")
+
+    try:
+        # Find and click the submit button
+        submit_button = WebDriverWait(driver, 10).until(
+            EC.element_to_be_clickable((By.ID, "submitBtn"))
+        )
+        submit_button.click()
+        log("✓ Form submitted")
+        return True
+    except Exception as e:
+        log(f"ERROR: Failed to submit form: {e}", "ERROR")
+        return False
+
+
+def verify_results_display(driver):
+    """Wait for and verify CV analysis results display."""
+    log("Waiting for results...")
+
+    try:
+        # Wait for results container to appear
+        WebDriverWait(driver, RESULTS_DISPLAY_TIMEOUT).until(
+            EC.presence_of_element_located((By.CLASS_NAME, "match-result"))
+        )
+
+        # Wait for results to be visible
+        WebDriverWait(driver, 5).until(
+            EC.visibility_of_element_located((By.CLASS_NAME, "match-result"))
+        )
+
+        # Check for key result elements
+        result_container = driver.find_element(By.CLASS_NAME, "match-result")
+
+        # Verify score badge exists
+        try:
+            score_badge = result_container.find_element(By.CLASS_NAME, "score-badge")
+            score_text = score_badge.text
+            log(f"✓ Match score displayed: {score_text}")
+        except:
+            log("WARNING: Score badge not found, but results container exists", "WARN")
+
+        # Verify strengths section
+        try:
+            strengths = result_container.find_element(By.CLASS_NAME, "strengths")
+            strength_items = strengths.find_elements(By.TAG_NAME, "li")
+            log(f"✓ Strengths section found ({len(strength_items)} items)")
+        except:
+            log("WARNING: Strengths section not found", "WARN")
+
+        # Verify gaps section
+        try:
+            gaps = result_container.find_element(By.CLASS_NAME, "gaps")
+            gap_items = gaps.find_elements(By.TAG_NAME, "li")
+            log(f"✓ Gaps section found ({len(gap_items)} items)")
+        except:
+            log("WARNING: Gaps section not found", "WARN")
+
+        # Verify evidence section
+        try:
+            evidence = result_container.find_element(By.CLASS_NAME, "evidence")
+            log("✓ Evidence section found")
+        except:
+            log("WARNING: Evidence section not found", "WARN")
+
+        return True
+    except Exception as e:
+        log(f"ERROR: Results did not display within {RESULTS_DISPLAY_TIMEOUT}s: {e}", "ERROR")
+        return False
+
+
+def verify_email_sent():
+    """Check Docker logs for email send confirmation."""
+    log("Checking if email was sent...")
+
+    try:
+        returncode, stdout, stderr = run_command("docker logs myai-email-api-1")
+
+        if returncode != 0:
+            log("WARNING: Could not read email-api logs (container may not exist)", "WARN")
+            return False
+
+        # Check for email send confirmation
+        if "Message sent" in stdout or "sent" in stdout.lower():
+            log("✓ Email send confirmation found in logs")
+            return True
+        else:
+            log("WARNING: Email send confirmation not found in logs", "WARN")
+            # Don't fail the whole test if email can't be verified
+            # (MailHog or real SMTP might have different log formats)
+            return True
+    except Exception as e:
+        log(f"WARNING: Could not verify email: {e}", "WARN")
+        return True
+
+
+def run_smoke_test():
+    """Run the complete smoke test."""
+    log("=" * 60)
+    log("myAi Smoke Test Starting")
+    log("=" * 60)
+
+    driver = None
+    test_passed = True
+    failed_steps = []
+
+    try:
+        # Step 1: Start Docker Compose
+        if not start_docker_compose():
+            log("CRITICAL: Application failed to start", "ERROR")
+            return False, ["Application failed to start"]
+
+        # Step 2: Initialize Chrome
+        driver = initialize_chrome_driver()
+        if not driver:
+            log("CRITICAL: Chrome driver failed to initialize", "ERROR")
+            return False, ["Chrome driver initialization failed"]
+
+        # Step 3: Navigate to app
+        log(f"Navigating to {APP_BASE_URL}...")
+        driver.get(APP_BASE_URL)
+        time.sleep(2)  # Wait for page to load
+
+        # Step 4: Upload CV
+        if not upload_cv(driver):
+            test_passed = False
+            failed_steps.append("CV file upload")
+
+        time.sleep(1)
+
+        # Step 5: Fill job description
+        if not fill_job_description(driver):
+            test_passed = False
+            failed_steps.append("Job description input")
+
+        time.sleep(1)
+
+        # Step 6: Submit form
+        if not submit_form(driver):
+            test_passed = False
+            failed_steps.append("Form submission")
+
+        time.sleep(2)
+
+        # Step 7: Verify results display
+        if not verify_results_display(driver):
+            test_passed = False
+            failed_steps.append("Results display")
+
+        # Step 8: Verify email
+        if not verify_email_sent():
+            test_passed = False
+            failed_steps.append("Email verification")
+
+    except Exception as e:
+        log(f"CRITICAL: Unexpected error: {e}", "ERROR")
+        test_passed = False
+        failed_steps.append(f"Unexpected error: {e}")
+
+    finally:
+        # Cleanup
+        if driver:
+            try:
+                driver.quit()
+            except:
+                pass
+
+        stop_docker_compose()
+
+    # Report results
+    log("=" * 60)
+    if test_passed:
+        log("✓ SMOKE TEST PASSED - All steps completed successfully", "SUCCESS")
+        log("CV uploaded, matched, results displayed, email sent.")
+    else:
+        log("✗ SMOKE TEST FAILED", "ERROR")
+        log(f"Failed steps: {', '.join(failed_steps)}")
+    log("=" * 60)
+
+    return test_passed, failed_steps
+
+
+if __name__ == "__main__":
+    success, failed_steps = run_smoke_test()
+    sys.exit(0 if success else 1)

web/Dockerfile

@@ -1,6 +1,7 @@
 FROM mcr.microsoft.com/dotnet/sdk:10.0 AS build
 ARG BUILD_CONFIGURATION=Release
 WORKDIR /src
+COPY Directory.Packages.props ./
 
 COPY web/web.csproj web/
 RUN dotnet restore web/web.csproj