AdvancedDevSample

Bienvenue dans la documentation technique de AdvancedDevSample.

Objectif

Fournir une base moderne .NET 10 orientee production avec:

• architecture en couches testable
• API REST securisee (JWT + refresh token)
• Frontend Blazor WebAssembly
• persistance EF Core + PostgreSQL
• observabilite (endpoints de sante, metriques Prometheus, Sentry)
• CI/CD complete (qualite, securite, docker, versions, documentation)

Vue rapide

graph LR
  U[Utilisateur] --> FE[Frontend Blazor WASM]
  FE --> API[API ASP.NET Core]
  API --> APP[Couche Application]
  APP --> DOM[Domaine]
  API --> INF[Infrastructure EF Core]
  INF --> DB[(PostgreSQL)]
  API --> OBS[Metriques et sante]
  OBS --> PROM[Prometheus et Grafana]

Stack

• .NET 10
• ASP.NET Core
• Blazor WebAssembly
• EF Core 10 + PostgreSQL
• OpenTelemetry + Prometheus + Grafana
• Sentry
• xUnit
• MkDocs Material

Ce que couvre la documentation

• installation et execution locale
• configuration complete (env, appsettings, CORS, JWT)
• architecture et flux applicatifs
• contrat API (auth, produits, categories, utilisateurs)
• persistance, migrations, seeding
• securite (headers, authz, rate limiting)
• qualite, CI/CD, exploitation, depannage

Lecture recommandee

1. Demarrage
2. Configuration
3. Architecture
4. API
5. Exploitation

Parcours par profil

• nouveau developpeur: Demarrage -> Configuration -> Depannage
• developpeur backend: Architecture -> API -> Base de donnees
• developpeur frontend: Frontend -> API -> Securite
• mainteneur: Tests et qualite -> CI/CD -> Exploitation