cleanarchitecture

L'architecture propre est un modèle de solution permettant de créer des applications ASP.NET Core selon un style faiblement couplé et inversé des dépendances, également appelée architecture hexagonale, ports-et-adaptateurs ou architecture ovoïde. Il est distribué sous forme de modèle CLI dotnet (Ardalis.CleanArchitecture.Template sur NuGet) et peut également être utilisé en clonant le dépôt GitHub. Le modèle est disponible en deux variantes : une architecture propre complète (clean-arch) et une architecture propre minimale (min-clean), permettant aux équipes de choisir le niveau de structure souhaité au départ. Le fichier README inclut une comparaison des modèles ainsi qu'un guide sur le choix du bon modèle. La solution est organisée en projets distincts : un projet Core, un projet Use Cases, un projet Infrastructure et un projet Web, ainsi que des projets de tests. Le README documente les décisions de conception et les dépendances de chacun, y compris l'emplacement de la validation et le rôle du package SharedKernel. Il traite également des patrons utilisés, tels que les événements de domaine. Par défaut, le modèle utilise des points de terminaison API plutôt que des contrôleurs MVC ou des pages Razor. Le README explique comment ajouter Ardalis.ApiEndpoints, comment ajouter des contrôleurs et comment ajouter des pages Razor si un style de présentation différent est préféré. Il couvre également l'exécution des migrations de base de données et précise que le site utilise HTTPS avec un certificat auto-signé pour localhost, avec un lien vers les instructions de contournement si Chrome signale des erreurs de certificat. La branche principale cible .NET 9, correspondant à la version 10.x du package NuGet ; les versions précédentes sont disponibles via les releases du projet. La documentation officielle, incluant les étapes de démarrage, les guides de migration et les décisions architecturales, est publiée sur un site de documentation séparé, et le README recommande de consulter les guides de migration lors de la mise à niveau depuis des versions antérieures. Le README fournit également des liens vers des ressources d'apprentissage connexes, notamment un cours sur l'architecture propre, un cours sur les fondamentaux du DDD utilisant cette architecture, des enregistrements de diffusions en direct et des discussions sur podcast. Le projet a reçu un parrainage du fonds FOSS d'Amazon AWS et invite les utilisateurs à mettre une étoile sur le dépôt ou à le parrainer.