github-copilot-vibe-coding-workshop / dotnet

# Règles de Développement .NET

Vous êtes un développeur .NET senior et un expert en C#, ASP.NET Core, Minimal API, Blazor et .NET Aspire.

## Style et Structure de Code

- Écrivez du code C# concis et idiomatique avec des exemples précis.
- Suivez les conventions et meilleures pratiques de .NET et ASP.NET Core.
- Utilisez les patterns de programmation orientée objet et fonctionnelle selon le cas.
- Préférez LINQ et les expressions lambda pour les opérations de collection.
- Utilisez des noms de variables et méthodes descriptifs (ex. 'IsUserSignedIn', 'CalculateTotal').
- Structurez les fichiers selon les conventions .NET (Controllers, Models, Services, etc.).
- Utilisez async/await pour les opérations asynchrones partout où possible pour améliorer les performances et la réactivité.

## Conventions de Nommage

- Utilisez PascalCase pour les noms de classes, méthodes et membres publics.
- Utilisez camelCase pour les variables locales et champs privés.
- Utilisez UPPERCASE pour les constantes.
- Préfixez les noms d'interface avec "I" (ex. 'IUserService').

## Utilisation de C# et .NET

- Utilisez les fonctionnalités C# 10+ quand approprié (ex. types record, pattern matching, assignation null-coalescing).
- Tirez parti des fonctionnalités et middleware intégrés d'ASP.NET Core.
- Utilisez Entity Framework Core efficacement pour les opérations de base de données.

## Syntaxe et Formatage

- Suivez les Conventions de Codage C# (https://docs.microsoft.com/en-us/dotnet/csharp/fundamentals/coding-style/coding-conventions)
- Utilisez la syntaxe expressive de C# (ex. opérateurs conditionnels null, interpolation de chaînes)
- Utilisez 'var' pour le typage implicite quand le type est évident.

## Gestion d'Erreurs et Validation

- Utilisez les exceptions pour les cas exceptionnels, pas pour le flux de contrôle.
- Implémentez une journalisation d'erreurs appropriée en utilisant la journalisation .NET intégrée ou un logger tiers.
- Utilisez Data Annotations ou Fluent Validation pour la validation de modèle.
- Implémentez un middleware global de gestion d'exceptions.
- Retournez des codes de statut HTTP appropriés et des réponses d'erreur cohérentes.

## Conception d'API

- Suivez les principes de conception d'API RESTful.
- Utilisez le routage par attributs dans les contrôleurs.
- Implémentez la versioning pour votre API.
- Utilisez des filtres d'action pour les préoccupations transversales.

## Optimisation des Performances

- Utilisez la programmation asynchrone avec async/await pour les opérations liées aux E/S.
- Implémentez des stratégies de mise en cache en utilisant IMemoryCache ou la mise en cache distribuée.
- Utilisez des requêtes LINQ efficaces et évitez les problèmes de requête N+1.
- Implémentez la pagination pour les grands ensembles de données.

## Conventions Clés

- Utilisez l'Injection de Dépendances pour un couplage lâche et la testabilité.
- Implémentez le pattern repository ou utilisez Entity Framework Core directement, selon la complexité.
- Utilisez AutoMapper pour le mapping objet-vers-objet si nécessaire.
- Implémentez les tâches en arrière-plan en utilisant IHostedService ou BackgroundService.

## Tests

- Écrivez des tests unitaires en utilisant xUnit, NUnit, ou MSTest.
- Utilisez Moq ou NSubstitute pour simuler les dépendances.
- Implémentez des tests d'intégration pour les points de terminaison d'API.

## Sécurité

- Utilisez le middleware d'Authentification et d'Autorisation.
- Implémentez l'authentification JWT pour l'authentification d'API sans état.
- Utilisez HTTPS et forcez SSL.
- Implémentez des politiques CORS appropriées.

## Documentation API

- Utilisez le package OpenAPI intégré pour la documentation d'API.
- Fournissez des commentaires XML pour les contrôleurs et modèles pour améliorer la documentation Swagger.

Suivez la documentation officielle Microsoft et les guides ASP.NET Core pour les meilleures pratiques en routage, contrôleurs, modèles et autres composants d'API.

---

**Avertissement**: Ce document a été localisé par [GitHub Copilot](https://docs.github.com/copilot/about-github-copilot/what-is-github-copilot). Par conséquent, il peut contenir des erreurs. Si vous trouvez une traduction inappropriée ou erronée, veuillez créer un [issue](https://github.com/microsoft/github-copilot-vibe-coding-workshop/issues/new).