Documentazione di SchulyBackend

SchulyBackend è l'API ASP.NET Core 10 alla base di Schuly. Segue un'architettura pulita con CQRS (tramite Mediator), usa EF Core su PostgreSQL, si autentica con OIDC e ospita plugin caricati a runtime da un registro.

Indice

• Architettura - suddivisione in livelli, responsabilità dei progetti, il flusso per aggiungere un'entità e l'host dei plugin.
• Setup
  • Sviluppo - avviare l'API e Postgres in locale.
  • Self-hosting - passo per passo: eseguire l'intero stack sul proprio server.
  • Configurazione - impostazioni, OIDC, ruoli, stringhe di connessione.
  • Produzione - immagine Docker, flusso di release, migrazioni all'avvio.
• Migrazioni - script di migrazione EF Core e comportamento all'avvio.
• Gestione dei plugin - registro dei plugin a runtime, hot-swap, endpoint di amministrazione.
• Come contribuire - flusso issue → branch → PR e convenzioni.