Feature/27 implement cicd

.dockerignore

@@ -0,0 +1,12 @@
+**/.dockerignore
+**/.env
+**/.git
+**/.gitignore
+**/.vs
+**/.vscode
+**/bin
+**/obj
+**/Dockerfile
+**/node_modules
+**/dist
+**/.angular

.gitattributes

@@ -0,0 +1,2 @@
+* text=auto
+*.sh text eol=lf

.github/workflows/pr-validation.yml

@@ -0,0 +1,79 @@
+name: PR Validation
+
+on:
+  pull_request:
+    branches:
+      - develop
+      - main
+
+jobs:
+  build-and-test-api:
+    name: API Validation
+    runs-on: ubuntu-latest
+
+    steps:
+      - name: Checkout Code
+        uses: actions/checkout@v4
+
+      - name: Set up Docker Buildx
+        uses: docker/setup-buildx-action@v3
+
+      - name: Setup .NET
+        uses: actions/setup-dotnet@v4
+        with:
+          dotnet-version: '10.0.x'
+
+      - name: Restore dependencies
+        run: dotnet restore -p:Configuration=Release
+
+      - name: Build project
+        run: dotnet build --no-restore --configuration Release
+
+      - name: Run Unit & Integration Tests
+        run: dotnet test --no-build --configuration Release --verbosity normal
+
+      - name: Verify API Dockerfile builds
+        uses: docker/build-push-action@v5
+        with:
+          context: .
+          file: src/api/SmartEventBooking.Web/Dockerfile
+          push: false
+          cache-from: type=gha
+          cache-to: type=gha,mode=max
+
+
+  build-and-test-client:
+    name: Client UI Validation
+    runs-on: ubuntu-latest
+
+    defaults:
+      run:
+        working-directory: ./src/client
+
+    steps:
+      - name: Checkout Code
+        uses: actions/checkout@v4
+
+      - name: Set up Docker Buildx
+        uses: docker/setup-buildx-action@v3
+
+      - name: Setup Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version-file: src/client/.nvmrc
+          cache: 'npm'
+          cache-dependency-path: ./src/client/package-lock.json
+
+      - name: Install dependencies
+        run: npm ci
+
+      - name: Run client tests
+        run: npm test -- --watch=false
+
+      - name: Verify Client Dockerfile builds
+        uses: docker/build-push-action@v5
+        with:
+          context: ./src/client
+          push: false
+          cache-from: type=gha
+          cache-to: type=gha,mode=max

.github/workflows/release-to-prod.yml

@@ -0,0 +1,96 @@
+name: Release to Production
+
+on:
+ push:
+   branches: [ main ]
+
+env:
+  API_IMAGE: smart-event-booking-api-app
+  CLIENT_IMAGE: smart-event-booking-client-app
+  AZURE_WEBAPP_API_NAME: app-smarteventbooking-api
+  AZURE_WEBAPP_CLIENT_NAME: app-smarteventbooking-client
+
+jobs:
+  run-tests:
+    name: Run Tests
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Setup .NET
+        uses: actions/setup-dotnet@v4
+        with:
+          dotnet-version: '10.0.x'
+
+      - name: Run API tests
+        run: dotnet test --configuration Release --verbosity normal
+
+  build-and-push:
+    needs: run-tests
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Set up Docker Buildx
+        uses: docker/setup-buildx-action@v3
+
+      - name: Log in to Docker Hub
+        uses: docker/login-action@v3
+        with:
+          username: ${{ secrets.DOCKERHUB_USERNAME }}
+          password: ${{ secrets.DOCKERHUB_ACCESSTOKEN }}
+
+      - name: Build and push API
+        uses: docker/build-push-action@v5
+        with:
+          context: .
+          file: src/api/SmartEventBooking.Web/Dockerfile
+          push: true
+          tags: |
+            ${{ secrets.DOCKERHUB_USERNAME }}/${{ env.API_IMAGE }}:latest
+            ${{ secrets.DOCKERHUB_USERNAME }}/${{ env.API_IMAGE }}:${{ github.sha }}
+          cache-from: type=gha
+          cache-to: type=gha,mode=max
+
+      - name: Build and push Client
+        uses: docker/build-push-action@v5
+        with:
+          context: ./src/client
+          push: true
+          tags: |
+            ${{ secrets.DOCKERHUB_USERNAME }}/${{ env.CLIENT_IMAGE }}:latest
+            ${{ secrets.DOCKERHUB_USERNAME }}/${{ env.CLIENT_IMAGE }}:${{ github.sha }}
+          cache-from: type=gha
+          cache-to: type=gha,mode=max
+
+  deploy-api:
+    needs: build-and-push
+    runs-on: ubuntu-latest
+    steps:
+      - name: Deploy API to Azure Web App
+        uses: azure/webapps-deploy@v2
+        with:
+          app-name: ${{ env.AZURE_WEBAPP_API_NAME }}
+          publish-profile: ${{ secrets.AZURE_API_PUBLISH_PROFILE }}
+          images: '${{ secrets.DOCKERHUB_USERNAME }}/${{ env.API_IMAGE }}:${{ github.sha }}'
+
+      - name: Smoke test API
+        run: |
+          curl --retry 10 --retry-delay 10 --retry-connrefused --fail \
+            ${{ vars.AZURE_WEBAPP_API_URL }}/health/db
+
+  deploy-client:
+    needs: build-and-push
+    runs-on: ubuntu-latest
+    steps:
+      - name: Deploy Client to Azure Web App
+        uses: azure/webapps-deploy@v2
+        with:
+          app-name: ${{ env.AZURE_WEBAPP_CLIENT_NAME }}
+          publish-profile: ${{ secrets.AZURE_CLIENT_PUBLISH_PROFILE }}
+          images: '${{ secrets.DOCKERHUB_USERNAME }}/${{ env.CLIENT_IMAGE }}:${{ github.sha }}'
+
+      - name: Smoke test Client
+        run: |
+          curl --retry 10 --retry-delay 10 --retry-connrefused --fail \
+            ${{ vars.AZURE_WEBAPP_CLIENT_URL }}

.gitignore

@@ -417,5 +417,5 @@ FodyWeavers.xsd
 *.msm
 *.msp
 
-docker-compose.yml
-Dockerfile
+#docker-compose.yml
+#Dockerfile

README.md

@@ -6,14 +6,53 @@ For product vision, scope, and contribution workflow, see `PROJECT_SCOPE.md`.
 
 ## Prerequisites
 
+**To run with Docker Compose:**
+- [Docker Desktop](https://www.docker.com/products/docker-desktop/)
+
+**To run locally:**
 - .NET SDK 10.0
+- Node.js 24 LTS (see [Node version setup](#node-version-setup))
 - SQL Server (local instance or Docker)
 - Node.js (v18 or later) and npm
 - Angular CLI (`npm install -g @angular/cli`)
 
+## Running with Docker Compose
+
+The quickest way to run the full stack (API + client + database) without any local tooling beyond Docker.
+
+1. Copy the env file and fill in your credentials:
+   ```bash
+   cp .env.example .env
+   ```
+
+2. Start everything:
+   ```bash
+   docker compose up -d --build
+   ```
+
+   | Service | URL |
+   |---|---|
+   | Client (Angular) | http://localhost:4200 |
+   | API (ASP.NET Core) | http://localhost:5270 |
+   | SQL Server | localhost:1433 |
+
+   Migrations run automatically on API startup — no manual `dotnet ef` step needed.
+
+3. Stop everything:
+   ```bash
+   docker compose down
+   ```
+   Add `-v` to also wipe the database volume.
+
+---
+
+## Running locally
+
+Follow the numbered steps below to run the API and client separately.
+
 ## 1) Configure the database settings
 
-This app reads database values from environment variables (`Database__Server`, `Database__Name`, `Database__User`, `Database__Password`, `Database__TrustServerCertificate`) and falls back to `src/SmartEventBooking.Web/appsettings.json`.
+This app reads database values from environment variables (`Database__Server`, `Database__Name`, `Database__User`, `Database__Password`, `Database__TrustServerCertificate`) and falls back to `src/api/SmartEventBooking.Web/appsettings.json`.
 
 Admin seeding credentials are also read from environment variables:
 
@@ -45,10 +84,10 @@ From the repository root:
 
 ```bash
 dotnet restore
-dotnet ef database update --project src/SmartEventBooking.Infrastructure/SmartEventBooking.Infrastructure.csproj --startup-project src/SmartEventBooking.Web/SmartEventBooking.Web.csproj --context ApplicationDbContext
+dotnet ef database update --project src/api/SmartEventBooking.Infrastructure/SmartEventBooking.Infrastructure.csproj --startup-project src/api/SmartEventBooking.Web/SmartEventBooking.Web.csproj --context ApplicationDbContext
 ```
 
-## 4) Run the app
+## 4) Run the API
 
 ```bash
 dotnet run --project src/api/SmartEventBooking.Web/SmartEventBooking.Web.csproj --launch-profile https
@@ -58,23 +97,24 @@ Default URLs (development):
 
 - `https://localhost:7134`
 - `http://localhost:5270`
+- Swagger UI: `https://localhost:7134/swagger`
 
 If you run without the `https` launch profile, you may see:
 
 - `Failed to determine the https port for redirect.`
 
 Use `--launch-profile https` (shown above), or set `ASPNETCORE_URLS` to include an HTTPS URL.
 
-## Run the Frontend (Development server)
-
-To start a local development server for the frontend, navigate to the client directory and run:
+## 5) Run the client
 
 ```bash
 cd src/client
-npm install
+npm ci
 ng serve
 ```
 
+Client runs at `http://localhost:4200`. The API URL it connects to is configured in `src/client/public/assets/config.json`.
+
 ## 6) Verify connectivity
 
 Health endpoint:
@@ -93,3 +133,41 @@ Expected result:
 dotnet build
 dotnet test
 ```
+
+---
+
+## Node version setup
+
+The client requires **Node.js 24 LTS**, pinned in `src/client/.nvmrc`.
+
+### Option A — Install Node 24 directly (simplest)
+
+Download and install Node 24 LTS from [nodejs.org](https://nodejs.org/en/download). No version manager needed if you only work on this project.
+
+### Option B — Use fnm (if you work on multiple projects with different Node versions)
+
+**Windows:**
+```powershell
+winget install Schniz.fnm
+```
+Add to your PowerShell profile (run once):
+```powershell
+Add-Content $PROFILE "fnm env --use-on-cd --shell power-shell | Out-String | Invoke-Expression"
+```
+Restart PowerShell, then inside `src/client/`:
+```powershell
+fnm install
+fnm use
+```
+
+**macOS / Linux:**
+```bash
+curl -fsSL https://fnm.vercel.app/install | bash
+```
+Then inside `src/client/`:
+```bash
+fnm install
+fnm use
+```
+
+> **Switching versions and seeing native module errors?** Delete `node_modules` and run `npm ci` again — native binaries are version-specific.

SmartEventBooking.slnx

@@ -8,8 +8,12 @@
   </Folder>
   <Folder Name="/tests/">
     <File Path="src/SmartEventBooking.Web/.env" />
-    <Project Path="SmartEventBooking.Infrastructure.IntegrationTests/SmartEventBooking.Infrastructure.IntegrationTests.csproj" Id="ff0fdb7a-e2f2-4d11-8c5d-fee1440c01a1" />
-    <Project Path="SmartEventBooking.Infrastructure.UnitTests/SmartEventBooking.Infrastructure.UnitTests.csproj" Id="c87eafba-727f-4bc3-8384-ef0721e5d1a7" />
+    <Project Path="tests/SmartEventBooking.Infrastructure.IntegrationTests/SmartEventBooking.Infrastructure.IntegrationTests.csproj">
+      <Build Solution="Debug|*" Project="false" />
+    </Project>
+    <Project Path="tests/SmartEventBooking.Infrastructure.UnitTests/SmartEventBooking.Infrastructure.UnitTests.csproj">
+      <Build Solution="Debug|*" Project="false" />
+    </Project>
     <Project Path="tests/SmartEventBooking.Web.Tests/SmartEventBooking.Web.Tests.csproj" />
   </Folder>
 </Solution>