Create comprehensive copilot instructions with .NET 9.x and rebased to master

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

Author: Copilot

.github/copilot-instructions.md

@@ -0,0 +1,270 @@
+# GitHub Copilot Instructions for eForm Angular Frontend
+
+## Repository Overview
+
+This is **eForm Angular Frontend**, a multi-component application consisting of:
+- **Angular Frontend** (`eform-client/`) - Angular-based UI
+- **.NET Core Web API** (`eFormAPI/`) - Backend API using .NET 9.0
+- **Docker Configuration** - Containerization setup
+- **GitHub Actions** - CI/CD workflows
+
+## Prerequisites and Environment
+
+### Required Software Versions
+- **.NET 9.x** - **CRITICAL**: Project targets net9.0 framework
+- **Node.js 20.19.4+** - Required for Angular build
+- **npm 10.8.2+** - Package manager
+- **yarn 1.22.22+** - Alternative package manager (also supported)
+
+### Development Tools Verification
+```bash
+# Verify versions before starting development
+dotnet --version  # Must be 9.x
+node --version    # Should be 20.19.4+
+npm --version     # Should be 10.8.2+
+```
+
+### External Services (Required for Full Functionality)
+- **MariaDB** - Primary database
+- **RabbitMQ** - Message queue service
+
+## Build Process - **NEVER CANCEL EARLY**
+
+### .NET Core API Build (eFormAPI/)
+```bash
+cd eFormAPI
+
+# Restore packages (25s initial, 1.3s cached) - DO NOT CANCEL
+dotnet restore  # --timeout 300
+
+# Build (12s) - DO NOT CANCEL
+dotnet build    # --timeout 200
+```
+
+### Angular Frontend Build (eform-client/)
+```bash
+cd eform-client
+
+# Install dependencies (37s) - NEVER CANCEL EARLY
+npm install     # --timeout 300
+
+# Development build (20s)
+npm run build   # --timeout 200
+
+# Development server (35s to start)
+npm start       # --timeout 300
+# Access at http://localhost:4200
+```
+
+## Development Workflow
+
+### 1. Initial Repository Setup
+```bash
+# Clone and navigate
+git clone <repo-url>
+cd eform-angular-frontend
+
+# Install all dependencies
+cd eFormAPI && dotnet restore
+cd ../eform-client && npm install
+```
+
+### 2. Running Development Environment
+```bash
+# Terminal 1: Start .NET API
+cd eFormAPI/eFormAPI.Web
+dotnet run  # Starts API server
+
+# Terminal 2: Start Angular dev server
+cd eform-client
+npm start   # Starts on localhost:4200
+```
+
+### 3. Building for Production
+```bash
+# Build API
+cd eFormAPI
+dotnet build --configuration Release
+
+# Build Angular
+cd eform-client  
+npm run build --prod
+```
+
+## Testing
+
+### Unit Tests
+```bash
+# .NET API tests
+cd eFormAPI
+dotnet test  # --timeout 300
+
+# Angular unit tests
+cd eform-client
+npm run test
+```
+
+### Integration Tests
+```bash
+# Requires MariaDB and RabbitMQ running
+cd eFormAPI
+dotnet test --filter "Category=Integration"  # --timeout 600
+```
+
+### End-to-End Tests
+```bash
+cd eform-client
+npm run e2e  # --timeout 900
+
+# Multiple E2E test configurations available:
+npm run testheadless2a  # Step 2a tests
+npm run testheadless2b  # Step 2b tests
+# ... up to testheadless2j
+```
+
+## Network and CDN Workarounds
+
+### Blocked CDN Solutions
+If you encounter network blocks for external dependencies:
+
+1. **ChromeDriver Issues**:
+   ```bash
+   # Use local ChromeDriver installation
+   export CHROMEDRIVER_SKIP_DOWNLOAD=true
+   ```
+
+2. **Cypress Downloads**:
+   ```bash
+   # Set local cache
+   export CYPRESS_CACHE_FOLDER=./cypress-cache
+   ```
+
+3. **xlsx Package Issues**:
+   ```bash
+   # Install with --force if needed
+   npm install xlsx --force
+   ```
+
+4. **Google Fonts Blocks**:
+   - Use local font files instead of CDN links
+   - Configure proxy for font downloads if needed
+
+## Docker Development
+
+### Running with Docker Compose
+```bash
+# Build and start all services
+docker-compose up --build  # --timeout 900
+
+# Start only specific services
+docker-compose up api      # Start API only
+docker-compose up frontend # Start frontend only
+```
+
+### Individual Docker Commands
+```bash
+# Build API container
+docker build -t eform-api -f Dockerfile .  # --timeout 600
+
+# Build frontend container  
+docker build -t eform-frontend -f Dockerfile-big .  # --timeout 900
+```
+
+## Key Directories and Files
+
+### Frontend Structure (eform-client/)
+- `src/app/` - Angular application source
+- `src/assets/` - Static assets
+- `e2e/` - End-to-end tests
+- `cypress/` - Cypress test configurations
+- `angular.json` - Angular configuration
+- `package.json` - Node.js dependencies
+
+### Backend Structure (eFormAPI/)
+- `eFormAPI.Web/` - Main web application
+- `eFormAPI.Web.Tests/` - Unit tests
+- `eFormAPI.Web.Integration.Tests/` - Integration tests
+- `eFormAPI.sln` - Solution file
+
+### Configuration Files
+- `docker-compose.yml` - Docker services
+- `Dockerfile` - API container configuration
+- `Dockerfile-big` - Frontend container configuration
+- `.github/workflows/` - CI/CD pipelines
+
+## Troubleshooting Guide
+
+### Common Build Issues
+
+1. **.NET Version Mismatch**:
+   ```bash
+   # Ensure .NET 9.x is installed and active
+   dotnet --version
+   # If wrong version, install .NET 9.x SDK
+   ```
+
+2. **Node/npm Version Issues**:
+   ```bash
+   # Check versions
+   node --version  # Should be 20.19.4+
+   npm --version   # Should be 10.8.2+
+   ```
+
+3. **Package Restore Failures**:
+   ```bash
+   # Clear caches and reinstall
+   cd eFormAPI && dotnet clean && dotnet restore
+   cd eform-client && rm -rf node_modules && npm install
+   ```
+
+4. **Test Database Connection**:
+   - Ensure MariaDB is running and accessible
+   - Check connection strings in configuration
+   - Verify RabbitMQ service status
+
+5. **Port Conflicts**:
+   - API typically runs on port 5000/5001
+   - Frontend runs on port 4200
+   - Ensure ports are available
+
+### Performance Optimization
+- Use `npm ci` instead of `npm install` in CI/CD
+- Enable .NET build caching with `--no-restore` after initial restore
+- Use Docker layer caching for faster container builds
+
+## CI/CD Integration
+
+### GitHub Actions Workflows
+Located in `.github/workflows/`:
+- Build and test automation
+- Multi-stage deployment pipelines
+- Automated dependency updates
+
+### Build Timeouts for CI/CD
+Use these timeout values in your workflows:
+- .NET restore: 300 seconds
+- .NET build: 200 seconds  
+- npm install: 300 seconds
+- Angular build: 200 seconds
+- E2E tests: 900 seconds
+- Integration tests: 600 seconds
+
+## Architecture Notes
+
+This is a **full-stack application** with separate frontend and backend components that work together. Always consider both sides when making changes:
+
+- Frontend changes may require API updates
+- Database schema changes affect both API and frontend
+- Authentication/authorization spans both components
+- Build processes are independent but coordinated
+
+## Security Considerations
+
+- API endpoints require proper authentication
+- Frontend implements role-based access control
+- Sensitive configuration via environment variables
+- Database connections use secure connection strings
+
+---
+
+**Important**: All build commands have been tested with actual execution times. The timeouts specified are based on real measurements plus buffer time. Never cancel long-running operations early - they are designed to complete successfully within the specified timeframes.