Lokale Ontwikkeling met Aspire

.NET Aspire orchstreert alle lokale services vanuit één run configuration. Start via het AutoMate.AppHost project.

Starten

Zorg dat Docker Desktop draait
Open AutoMate.slnx in Rider
Selecteer run configuration AutoMate.AppHost
Start (F5 of Run)
Het Aspire dashboard opent automatisch

SQL Server

Aspire start een persistent SQL Server 2022 container met een eigen data volume (automate-sql-data). De volgende databases worden automatisch aangemaakt:

Database naam	Aspire resource	Inhoud
`Tenants`	`tenants-db`	Tenant configuraties
`UserTypes`	`usertypeDb`	UserType definities
`Users`	`users-db`	Medewerkers en gebruikers
`Branding`	`BrandingDb`	Branding instellingen
`Signatures`	`signatureDb`	E-mailhandtekeningen
`Licenses`	`licenseDb`	Licentiedata
`Jobs`	`JobsDb`	Hangfire job storage
`Devices`	`DeviceDb`	AutoPilot devices
`SuccessFactors`	`SapDb`	SAP SuccessFactors data
`Emails`	`EmailsDb`	E-mail logs

De meeste databases worden geïnitialiseerd via creation scripts in AutoMate.AppHost/Helpers/SqlHelper.cs. De Jobs-database (Hangfire) wordt door Hangfire zelf aangemaakt via PrepareSchemaIfNecessary.

Services

Seq

Seq verzorgt structured logging voor de API en het Management Portal. De UI is bereikbaar op http://localhost:5341 (poortnummer toegewezen door Aspire).

Het Aspire dashboard toont een directe link naar de Seq UI naast de API-resource.

Azure Storage Emulator

Aspire start een Azure Storage emulator voor Blob en Table storage. Dit wordt gebruikt door de audit log plugin (AutoMate.API.Plugins.AuditLog) voor de AzureTable provider. De Aspire-resource heet auditlogs (Tables).

SAP SuccessFactors

De AutoMate.API.SAPSuccesfactors service fungeert als mock OData connector. Deze is geconfigureerd met WithExplicitStart — hij start niet automatisch maar kan handmatig worden gestart vanuit het Aspire dashboard wanneer SAP-integratie lokaal getest moet worden.

Service Dependencies

De opstartvolgorde wordt afgedwongen via WaitFor:

SQL Server
  └── tenants-db, usertypeDb, users-db, BrandingDb,
      signatureDb, licenseDb, JobsDb, DeviceDb, EmailsDb
          └── AutoMate.API (wacht op alle databases)
                  └── ManagementPortal.Website (wacht op API)

De API start pas nadat alle databases bereikbaar zijn. Het Management Portal start pas nadat de API bereikbaar is. Dit voorkomt opstartfouten door ontbrekende database-verbindingen.

Aspire Dashboard URLs

Het Aspire dashboard registreert de volgende extra URL-shortcuts voor de API:

Label	URL
Scalar (v1)	`https://<api>/scalar/v1` — OpenAPI documentatie
Jobs dashboard	`https://<api>/jobs` — Hangfire dashboard

Last modified: 24 March 2026