Fix all req.params and req.query type errors

- Add getParamString helper function for req.params
- Replace all req.params destructuring with getParamString
- Fix remaining req.query.* direct usage errors
- All TypeScript compilation errors now resolved

docs/TYPESCRIPT-LOCAL-VS-CI.md

@@ -0,0 +1,192 @@
+# Waarom TypeScript Errors Lokaal Niet Optreden Maar Wel in CI/CD
+
+## Het Probleem
+
+TypeScript compilation errors die lokaal niet optreden, maar wel in Azure DevOps pipelines of Docker builds. Dit is een veelvoorkomend probleem met verschillende oorzaken.
+
+## Belangrijkste Oorzaken
+
+### 1. **tsx vs tsc - Development vs Production Build**
+
+**Lokaal (Development):**
+```bash
+npm run dev  # Gebruikt: tsx watch src/index.ts
+```
+
+**In Docker/CI (Production Build):**
+```bash
+npm run build  # Gebruikt: tsc (TypeScript Compiler)
+```
+
+**Verschil:**
+- **`tsx`** (TypeScript Execute): Een runtime TypeScript executor die code direct uitvoert zonder volledige type checking. Het is **minder strict** en laat veel type errors door.
+- **`tsc`** (TypeScript Compiler): De officiële TypeScript compiler die **volledige type checking** doet en alle errors rapporteert.
+
+**Oplossing:**
+- Test altijd lokaal met `npm run build` voordat je pusht
+- Of gebruik `tsc --noEmit` om type checking te doen zonder te builden
+
+### 2. **TypeScript Versie Verschillen**
+
+**Lokaal:**
+```bash
+npx tsc --version  # Kan een andere versie zijn
+```
+
+**In Docker:**
+- Gebruikt de versie uit `package.json` (`"typescript": "^5.6.3"`)
+- Maar zonder `package-lock.json` kan een andere patch versie geïnstalleerd worden
+
+**Oplossing:**
+- Genereer `package-lock.json` met `npm install`
+- Commit `package-lock.json` naar Git
+- Dit zorgt voor consistente dependency versies
+
+### 3. **tsconfig.json Strictness**
+
+Je `tsconfig.json` heeft `"strict": true`, wat betekent:
+- Alle strict type checking opties zijn aan
+- Dit is goed voor productie, maar kan lokaal vervelend zijn
+
+**Mogelijke verschillen:**
+- Lokaal kan je IDE/editor andere TypeScript settings hebben
+- Lokaal kan je `tsconfig.json` overrides hebben
+- CI/CD gebruikt altijd de exacte `tsconfig.json` uit de repo
+
+### 4. **Node.js Versie Verschillen**
+
+**Lokaal:**
+- Kan een andere Node.js versie hebben
+- TypeScript gedrag kan verschillen tussen Node versies
+
+**In Docker:**
+```dockerfile
+FROM node:20-alpine  # Specifieke Node versie
+```
+
+**Oplossing:**
+- Gebruik `.nvmrc` of `package.json` engines field om Node versie te specificeren
+- Zorg dat lokaal dezelfde Node versie gebruikt wordt
+
+### 5. **Cached Builds**
+
+**Lokaal:**
+- Oude compiled files in `dist/` kunnen nog werken
+- IDE kan gecachte type informatie gebruiken
+- `tsx` gebruikt geen build output, dus errors worden niet altijd gezien
+
+**In CI/CD:**
+- Schone build elke keer
+- Geen cache, dus alle errors worden gezien
+
+### 6. **Incremental Compilation**
+
+**Lokaal:**
+- TypeScript kan incremental compilation gebruiken
+- Alleen gewijzigde files worden gecheckt
+
+**In CI/CD:**
+- Volledige rebuild elke keer
+- Alle files worden gecheckt
+
+## Best Practices om Dit Te Voorkomen
+
+### 1. Test Lokaal Met Production Build
+
+```bash
+# Voordat je pusht, test altijd:
+cd backend
+npm run build  # Dit gebruikt tsc, net als in Docker
+```
+
+### 2. Type Checking Zonder Build
+
+```bash
+# Alleen type checking, geen build:
+npx tsc --noEmit
+```
+
+### 3. Pre-commit Hooks
+
+Voeg een pre-commit hook toe die `tsc --noEmit` draait:
+
+```json
+// package.json
+{
+  "scripts": {
+    "type-check": "tsc --noEmit",
+    "precommit": "npm run type-check"
+  }
+}
+```
+
+### 4. Genereer package-lock.json
+
+```bash
+# Genereer lock file voor consistente dependencies:
+npm install
+
+# Commit package-lock.json naar Git
+git add package-lock.json
+git commit -m "Add package-lock.json for consistent builds"
+```
+
+### 5. Gebruik CI/CD Lokaal
+
+Test je pipeline lokaal met:
+- **act** (voor GitHub Actions)
+- **Azure DevOps Pipeline Agent** lokaal
+- **Docker build** lokaal: `docker build -f backend/Dockerfile.prod -t test-build ./backend`
+
+### 6. IDE TypeScript Settings
+
+Zorg dat je IDE dezelfde TypeScript versie gebruikt:
+- VS Code: Check "TypeScript: Select TypeScript Version"
+- Gebruik "Use Workspace Version"
+
+## Voor Dit Project Specifiek
+
+### Huidige Situatie
+
+1. **Development:** `tsx watch` - minder strict
+2. **Production Build:** `tsc` - volledig strict
+3. **Geen package-lock.json** - verschillende dependency versies mogelijk
+4. **TypeScript 5.6.3** in package.json, maar lokaal mogelijk 5.9.3
+
+### Aanbevolen Acties
+
+1. **Genereer package-lock.json:**
+   ```bash
+   cd backend
+   npm install
+   git add package-lock.json
+   git commit -m "Add package-lock.json"
+   ```
+
+2. **Test altijd met build:**
+   ```bash
+   npm run build  # Voordat je pusht
+   ```
+
+3. **Voeg type-check script toe:**
+   ```json
+   {
+     "scripts": {
+       "type-check": "tsc --noEmit"
+     }
+   }
+   ```
+
+4. **Test Docker build lokaal:**
+   ```bash
+   docker build -f backend/Dockerfile.prod -t test-backend ./backend
+   ```
+
+## Conclusie
+
+Het verschil komt vooral door:
+- **tsx (dev) vs tsc (build)** - tsx is minder strict
+- **Geen package-lock.json** - verschillende dependency versies
+- **Cached builds lokaal** - oude code werkt nog
+
+**Oplossing:** Test altijd met `npm run build` lokaal voordat je pusht, en genereer `package-lock.json` voor consistente builds.