Voraussetzungen für Build und Betrieb der Plattform

Bevor Sie MobilityManager bauen oder bereitstellen, stellen Sie sicher, dass Ihre Workstation oder Ihr Build-Agent über die erforderliche Toolchain verfügt. Dieser Artikel listet die Voraussetzungen für das Bauen aus dem Quellcode und die Optionen für den Betrieb des Ergebnisses auf.

Voraussetzungen für den Build

Um die Plattform aus dem Quellcode zu kompilieren, benötigen Sie:

.NET 10 SDK — baut den API-Dienst und die gemeinsam genutzten Bibliotheken.
Node.js 18+ und npm — baut die Angular-19-Benutzeroberfläche, die in die API gebündelt wird.

Die Angular-UI wird nur während Release-Builds oder bei ausdrücklicher Anforderung kompiliert, sodass Node.js für schnelle, reine Backend-Builds im Development-Modus nicht erforderlich ist.

Hinweis: Wenn Sie ein vorgefertigtes Container-Image bereitstellen, anstatt aus dem Quellcode zu bauen, benötigen Sie auf dem Zielhost weder das .NET SDK noch Node.js — nur eine Container-Laufzeit wie Docker.

Ihre Werkzeuge überprüfen

Bestätigen Sie, dass das .NET SDK installiert ist:
```
dotnet --version
```
Bestätigen Sie, dass Node.js und npm installiert sind:
```
node --version
npm --version
```

Die Solution bauen

Verwenden Sie die Konfiguration, die zu Ihrem Ziel passt:

Development (schnell, ohne UI-Build):
```
dotnet build
```
Production (einschließlich der Angular-UI):
```
dotnet build -c Release
```
Den UI-Build im Debug-Modus erzwingen:
```
dotnet build /p:BuildAngularUI=true
```

Betrieb für die lokale Entwicklung

Der schnellste Weg ist Visual Studio 2022: öffnen Sie CK.MobilityManager.slnx, legen Sie CK.MobilityManager.AppHost als Startprojekt fest und drücken Sie F5. Der Aspire AppHost startet PostgreSQL, den API-Dienst und die Angular-UI mit Hot-Reload.

Geben Sie über die Befehlszeile ein Datenbankkennwort an und führen Sie den AppHost aus:

$env:Parameters__postgres-password="DevPassword123!"
dotnet run --project src/CK.MobilityManager.AppHost

Sie können die API auch für sich allein ausführen (wobei sie die gebündelte UI bereitstellt) mit dotnet run --project src/CK.MobilityManager.ApiService, oder den Angular-Entwicklungsserver separat aus src/web/UI mit npm start für UI-Arbeiten mit Hot-Reload betreiben.

Container- und Cluster-Laufzeiten

Für containerisierte Bereitstellungen benötigen Sie zusätzlich:

Docker mit Compose v2 für die Docker-Compose-Stacks.
kubectl (mit integriertem Kustomize) für Kubernetes-Bereitstellungen.

Tipp: PostgreSQL ist die empfohlene lokale Datenbank, insbesondere auf ARM-basierten Maschinen. SQL Server wird für Teams, die es bereits betreiben, weiterhin vollständig unterstützt.