Add .NET Aspire-inspired backend architecture and IaC tools to devcontainer

Co-authored-by: Chaosbit <[email protected]>

Author: Copilot

.devcontainer/README.md

@@ -8,6 +8,8 @@ This repository includes a VS Code Dev Container configuration that provides a c
 - **Node.js 18**: For frontend development and testing
 - **.NET 8 SDK**: For backend API development
 - **Git & GitHub CLI**: For version control operations
+- **Terraform**: For infrastructure as code management
+- **Azure CLI**: For Azure cloud deployments
 - **Python 3**: For development scripts and utilities
 - **SQLite**: For local database development
 
@@ -17,6 +19,9 @@ This repository includes a VS Code Dev Container configuration that provides a c
 - **Jest Test Explorer**: For running and debugging unit tests
 - **Playwright**: For end-to-end testing
 - **Tailwind CSS**: For CSS IntelliSense
+- **Terraform**: For infrastructure as code support
+- **Azure CLI**: For Azure cloud integration
+- **Azure Resource Groups**: For Azure resource management
 
 ### Development Tools
 - **Jest**: For unit testing (globally installed)
@@ -52,6 +57,12 @@ This repository includes a VS Code Dev Container configuration that provides a c
    # Check .NET
    dotnet --version
 
+   # Check Terraform
+   terraform --version
+   
+   # Check Azure CLI
+   az --version
+   
    # Install dependencies
    npm install
    cd backend && dotnet restore && cd ..
@@ -86,6 +97,25 @@ dotnet run
 dotnet test
 ```
 
+### Infrastructure Management
+```bash
+# Navigate to terraform directory
+cd terraform
+
+# Initialize Terraform
+terraform init
+
+# Plan infrastructure changes
+terraform plan
+
+# Apply infrastructure changes
+terraform apply
+
+# Check Azure resources
+az account show
+az group list
+```
+
 ## Port Forwarding
 
 The container automatically forwards these ports:
@@ -140,6 +170,14 @@ wget https://packages.microsoft.com/config/ubuntu/22.04/packages-microsoft-prod.
 sudo dpkg -i packages-microsoft-prod.deb
 sudo apt-get update && sudo apt-get install -y dotnet-sdk-8.0
 
+# Install Terraform
+wget -O- https://apt.releases.hashicorp.com/gpg | sudo gpg --dearmor -o /usr/share/keyrings/hashicorp-archive-keyring.gpg
+echo "deb [signed-by=/usr/share/keyrings/hashicorp-archive-keyring.gpg] https://apt.releases.hashicorp.com $(lsb_release -cs) main" | sudo tee /etc/apt/sources.list.d/hashicorp.list
+sudo apt update && sudo apt install terraform
+
+# Install Azure CLI
+curl -sL https://aka.ms/InstallAzureCLIDeb | sudo bash
+
 # Install dependencies
 npm install
 cd backend && dotnet restore

.devcontainer/devcontainer.json

@@ -13,7 +13,11 @@
                 "ms-vscode.test-adapter-converter",
                 "hbenl.vscode-test-explorer",
                 "ms-playwright.playwright",
-                "ms-vscode.vscode-jest"
+                "ms-vscode.vscode-jest",
+                "HashiCorp.terraform",
+                "ms-vscode.azurecli",
+                "ms-azuretools.vscode-azureresourcegroups",
+                "ms-azuretools.vscode-azureappservice"
             ],
             "settings": {
                 "terminal.integrated.defaultProfile.linux": "bash",
@@ -26,7 +30,7 @@
             }
         }
     },
-    "forwardPorts": [8000, 5000, 3000],
+    "forwardPorts": [8000, 5000, 3000, 15888],
     "portsAttributes": {
         "8000": {
             "label": "PWA Development Server",
@@ -39,9 +43,13 @@
         "3000": {
             "label": "Alternative Dev Server",
             "protocol": "http"
+        },
+        "15888": {
+            "label": "Aspire Dashboard",
+            "protocol": "https"
         }
     },
-    "postCreateCommand": "npm install && cd backend && dotnet restore",
+    "postCreateCommand": "npm install && cd backend && dotnet restore && dotnet workload install aspire",
     "remoteUser": "vscode",
     "features": {
         "ghcr.io/devcontainers/features/node:1": {
@@ -51,6 +59,12 @@
             "version": "8.0"
         },
         "ghcr.io/devcontainers/features/git:1": {},
-        "ghcr.io/devcontainers/features/github-cli:1": {}
+        "ghcr.io/devcontainers/features/github-cli:1": {},
+        "ghcr.io/devcontainers/features/terraform:1": {
+            "version": "latest"
+        },
+        "ghcr.io/devcontainers/features/azure-cli:1": {
+            "version": "latest"
+        }
     }
 }

backend/README.md

@@ -0,0 +1,253 @@
+# .NET Aspire-Inspired Backend
+
+This backend implementation uses .NET Aspire-inspired patterns for observability, health checks, and service orchestration while maintaining compatibility with standard .NET 8 tooling.
+
+## Architecture
+
+The backend consists of several projects organized in an Aspire-like structure:
+
+### Projects
+
+- **WorkoutApp.Api**: The main Web API project with controllers and business logic
+- **WorkoutApp.ServiceDefaults**: Shared service configuration for observability and health checks
+- **WorkoutApp.AppHost**: Simple orchestration host for development scenarios
+- **WorkoutApp.Tests**: Unit and integration tests
+
+### Key Features
+
+- **OpenTelemetry Integration**: Comprehensive observability with metrics, tracing, and logging
+- **Health Checks**: Built-in health endpoints for monitoring application status
+- **Service Defaults**: Standardized configuration for all services
+- **JWT Authentication**: Secure API authentication with proper validation
+- **Entity Framework**: SQLite for development, easily configurable for other databases
+
+## Getting Started
+
+### Prerequisites
+
+- .NET 8.0 SDK
+- SQLite (included with .NET)
+
+### Development Commands
+
+```bash
+# Restore packages
+npm run backend:restore
+
+# Build the solution
+npm run backend:build
+
+# Run the API directly
+npm run backend:api
+
+# Run the orchestration host (development)
+npm run backend:apphost
+
+# Run tests
+npm run test:backend
+```
+
+### Manual Commands
+
+```bash
+cd backend
+
+# Restore and build
+dotnet restore
+dotnet build
+
+# Run the API service
+dotnet run --project WorkoutApp.Api
+
+# Run the orchestration host
+dotnet run --project WorkoutApp.AppHost
+
+# Run tests
+dotnet test
+```
+
+## Service Defaults
+
+The `WorkoutApp.ServiceDefaults` project provides:
+
+### OpenTelemetry Configuration
+- **Metrics**: ASP.NET Core, HTTP Client, and Runtime metrics
+- **Tracing**: Request tracing across services
+- **Logging**: Structured logging with OpenTelemetry
+
+### Health Checks
+- **/health**: Overall application health
+- **/alive**: Liveness probe (development only)
+
+### HTTP Client Configuration
+- Standard timeout settings
+- Basic resilience patterns
+
+## API Endpoints
+
+The API provides the following endpoints:
+
+### Authentication
+- `POST /api/auth/register` - User registration
+- `POST /api/auth/login` - User login
+
+### Workouts
+- `GET /api/workouts` - Get user workouts
+- `POST /api/workouts` - Create new workout
+- `PUT /api/workouts/{id}` - Update workout
+- `DELETE /api/workouts/{id}` - Delete workout
+
+### Statistics
+- `GET /api/statistics` - Get user statistics
+- `POST /api/statistics` - Update statistics
+
+### Health & Monitoring
+- `GET /health` - Health check endpoint (development)
+- `GET /alive` - Liveness check (development)
+
+## Configuration
+
+### Database Connection
+
+The default configuration uses SQLite:
+
+```json
+{
+  "ConnectionStrings": {
+    "DefaultConnection": "Data Source=workout-app.db"
+  }
+}
+```
+
+### JWT Settings
+
+Configure JWT authentication:
+
+```json
+{
+  "JwtSettings": {
+    "Secret": "your-secret-key-here",
+    "ExpirationInDays": 7
+  }
+}
+```
+
+### User Registration
+
+Control user registration behavior:
+
+```json
+{
+  "UserRegistration": {
+    "RequireApproval": false,
+    "RequireReferralCode": false
+  }
+}
+```
+
+## Observability
+
+### OpenTelemetry Exporter
+
+To use OTLP exporter, set the environment variable:
+
+```bash
+export OTEL_EXPORTER_OTLP_ENDPOINT=http://jaeger:4317
+```
+
+### Metrics Available
+
+- HTTP request duration and count
+- Database operation metrics
+- Runtime performance metrics
+- Custom application metrics
+
+### Distributed Tracing
+
+Traces are automatically created for:
+- HTTP requests
+- Database operations
+- External HTTP calls
+
+## Development Tips
+
+### Running with Hot Reload
+
+```bash
+cd backend
+dotnet watch run --project WorkoutApp.Api
+```
+
+### Database Migrations
+
+The application automatically creates the database on startup. For production, consider using explicit migrations:
+
+```bash
+dotnet ef migrations add InitialCreate --project WorkoutApp.Api
+dotnet ef database update --project WorkoutApp.Api
+```
+
+### Testing
+
+Run different test suites:
+
+```bash
+# All tests
+dotnet test
+
+# Specific test project
+dotnet test WorkoutApp.Tests
+
+# With coverage
+dotnet test --collect:"XPlat Code Coverage"
+```
+
+## Deployment
+
+The backend can be deployed as:
+
+1. **Single API Service**: Deploy only `WorkoutApp.Api`
+2. **Container**: Use the provided Dockerfile
+3. **Azure App Service**: Use the provided ARM templates
+4. **Container Orchestration**: Deploy as microservices
+
+## Differences from Full .NET Aspire
+
+This implementation provides Aspire-like benefits without requiring the full Aspire workload:
+
+- **✅ Included**: OpenTelemetry, Health Checks, Service Configuration
+- **✅ Included**: Structured project organization
+- **❌ Not Included**: Full service discovery
+- **❌ Not Included**: Advanced resilience patterns
+- **❌ Not Included**: Aspire Dashboard integration
+
+For production scenarios requiring full Aspire features, upgrade to the official .NET Aspire packages when they reach stable release.
+
+## Troubleshooting
+
+### Build Issues
+
+If you encounter build issues:
+
+```bash
+# Clean and rebuild
+dotnet clean
+dotnet restore
+dotnet build
+```
+
+### Database Issues
+
+If database connection fails:
+
+1. Check SQLite file permissions
+2. Verify connection string in `appsettings.json`
+3. Delete `workout-app.db` to recreate database
+
+### Authentication Issues
+
+If JWT authentication fails:
+
+1. Verify `JwtSettings:Secret` is configured
+2. Check token expiration settings
+3. Ensure proper Authorization header format: `Bearer <token>`

backend/WorkoutApp.Api/Program.cs

@@ -8,6 +8,9 @@
 
 var builder = WebApplication.CreateBuilder(args);
 
+// Add Aspire service defaults (observability, health checks, service discovery)
+builder.AddServiceDefaults();
+
 // Add services to the container.
 
 builder.Services.AddControllers();
@@ -104,6 +107,9 @@
 
 app.MapControllers();
 
+// Map Aspire default endpoints (health checks)
+app.MapDefaultEndpoints();
+
 app.Run();
 
 // Make Program class accessible for integration tests