Paul Schneider
120bae6f5c
Two long-standing gaps in the architecture documentation are filled in this commit: 1. doc/architecture/postit.md is new. It covers everything the existing postit-oidc.md does not: the one-codebase / three-frontends topology (PostIt lib + PostIt.Desktop + PostIt.Android + PostIt.Browser), the custom ViewLocator that resolves ViewModel -> View through the DI provider (and why we don't use the Avalonia.Mvvm default), the composition root in App.OnFrameworkInitializationCompleted with the full DI registration table, the navigation flow driven by SessionStatusViewModel events, the ViewModel lifetime conventions (singleton vs transient), the [RelayCommand] XAML binding conventions (referenced to AGENTS.md for the canonical version), and the per-page DataContext / role table. The Settings-singleton invariant is called out as a guard rail, and the SettingsPage anti-empilement invariant is documented as the TODO the code still owes us. 2. doc/architecture/decoupage-organisation.md is brought up to date. Its project table listed 7 .csproj; the repo has 14 (the four PostIt projects, the tests satellites, the cli tool). The table is extended, the ASCII diagram picks up the PostIt block, and an Outils et tests section lists the test / CLI satellites that were missing. doc/README.md is updated to index the new postit.md. No code changes in this commit, no behaviour change.
108 lines
7.2 KiB
Markdown
108 lines
7.2 KiB
Markdown
# Découpage des projets .NET
|
|
|
|
> **Récapitulatif** : Le code est réparti en sept projets .NET
|
|
> sous `src/`, organisés par rôle : domaine partagé, bibliothèque
|
|
> métier, front web utilisateur-facing, API REST principale,
|
|
> backend API dédié aux blogs, front admin, et tests. Détail dans
|
|
> cette page, racine de l'architecture : [Architecture.md](../Architecture.md).
|
|
|
|
## Vue d'ensemble
|
|
|
|
```
|
|
┌──────────────────────────────┐
|
|
│ Yavsc.Abstract (lib) │
|
|
│ Modèles du domaine partagés │
|
|
└──────────────┬───────────────┘
|
|
│
|
|
┌──────────────▼────────────────────┐
|
|
│ Yavsc.Server (lib) │
|
|
│ Helpers, EF, services │
|
|
└──────┬─────────┬──────────────┬───┘
|
|
│ │ │
|
|
┌─────────────▼──┐ ┌───▼──────────┐ ┌▼────────────────────┐
|
|
│ Yavsc.Org (web)│ │ Yavsc.Api │ │ Yavsc.Blogs (web) │
|
|
│ Front web │ │ (web) │ │ Backend API blogs │
|
|
│ + Identity- │ │ API REST │ │ (aucune vue Razor) │
|
|
│ Server │ │ principale │ │ déployé sur sous- │
|
|
│ + Razor views │ │ JwtBearer │ │ domaine en prod │
|
|
│ (héberge aussi │ └──────────────┘ └─────────────────────┘
|
|
│ le front des │
|
|
│ blogs) │
|
|
└────────────────┘
|
|
|
|
Clients externes :
|
|
- PostIt (Avalonia, code-base unique multi-cible) :
|
|
· PostIt — lib partagée (pages, VM, services)
|
|
· PostIt.Desktop — front-end Linux/Windows
|
|
· PostIt.Android — front-end APK
|
|
· PostIt.Browser — front-end WASM
|
|
Cf. postit.md et postit-oidc.md.
|
|
|
|
Outils et tests :
|
|
- cli — outillage CLI
|
|
- Yavsc.Tests.Shared — helpers de tests partagés
|
|
- Yavsc.Org.Tests — tests du front web
|
|
- Yavsc.Blogs.Tests — tests du backend blogs
|
|
- PostIt.Tests — tests du client PostIt
|
|
```
|
|
|
|
## Par projet
|
|
|
|
| Projet | Type SDK | Rôle |
|
|
|--------------------|----------------|-----------------------------------------------------------------------------------------------|
|
|
| `Yavsc.Abstract` | Library | Modèles du domaine partagés (entités, value objects, enums). Pas de dépendance framework. |
|
|
| `Yavsc.Server` | Library | Bibliothèque métier : `DbContext`, helpers PayPal/SMTP, services métier, modèles billing/blog. |
|
|
| `Yavsc.Org` | ASP.NET Web | Front web utilisateur-facing : Razor views, IdentityServer8 (OP), AccountController. **Héberge aussi les vues (front) des blogs**. |
|
|
| `Yavsc.Api` | ASP.NET Web | API REST JSON principale consommée par les clients externes (PostIt, …). JwtBearer auth. |
|
|
| `Yavsc.Blogs` | ASP.NET Web | **Backend API headless** dédié aux blogs (uniquement `*ApiController` + services + modèles — aucune vue Razor). Destiné à être déployé sur un sous-domaine en production, séparé du front web hébergé par `Yavsc.Org`. |
|
|
| `Yavsc.Org.Tests` | Test (xUnit) | Tests d'isolation du front web (`Yavsc.Org`) — fakes, controller tests. |
|
|
| `Yavsc.Blogs.Tests`| Test (xUnit) | Tests d'isolation du backend blogs (`Yavsc.Blogs`). |
|
|
| `Yavsc.Tests.Shared` | Library | Helpers de tests partagés (fixtures, fakes, builders) entre les projets de tests. |
|
|
| `PostIt` | Library | Code-base partagée du client PostIt (Avalonia) : pages, ViewModels, services, `ViewLocator` custo. Multi-cible — produit PostIt.Desktop / PostIt.Android / PostIt.Browser. |
|
|
| `PostIt.Desktop` | Avalonia.Desktop | Front-end Desktop Linux/Windows : `Program.Main`, `Platform.CreateBrowser` (CustomSchemeBrowser), custom URI scheme `postit://`. |
|
|
| `PostIt.Android` | Avalonia.Android | Front-end Android : `MainActivity` SingleTask, Chrome Custom Tabs, scheme `android://postit-signin`. |
|
|
| `PostIt.Browser` | Avalonia.Browser | Front-end WASM : pas de process distinct, IBrowser N/A. |
|
|
| `PostIt.Tests` | Test (xUnit) | Tests du client PostIt : settings, scopes Bearer, OIDC stub (`OidcStubAuthority`). |
|
|
| `cli` | exe / tool | Outillage CLI (build, packaging, génération de clés). |
|
|
|
|
## Pourquoi ce découpage
|
|
|
|
- **`Yavsc.Abstract` séparé de `Yavsc.Server`** : permet aux clients
|
|
externes (PostIt — projet Avalonia sous `src/PostIt/`) de partager
|
|
les modèles DTO sans embarquer Entity Framework ni ASP.NET Core.
|
|
- **`Yavsc.Server` est une library, pas un web host** : on peut
|
|
tester les services sans démarrer Kestrel ; plusieurs fronts et
|
|
backends consomment les mêmes helpers sans dupliquer.
|
|
- **`Yavsc.Api` séparé de `Yavsc.Org`** : l'API REST principale
|
|
est destinée aux clients headless (PostIt, intégrations tierces) ;
|
|
elle n'a pas besoin des vues Razor ni d'IdentityServer.
|
|
Inversement, le front web peut servir ses propres pages serveur
|
|
sans exposer une API REST.
|
|
- **`Yavsc.Blogs` séparé en backend headless** : le front des blogs
|
|
(vues Razor) reste dans `Yavsc.Org` pour partager le rendu et
|
|
l'auth avec le reste de l'application. Le backend, lui, est
|
|
isolé dans son propre projet `Yavsc.Blogs` (uniquement des
|
|
`*ApiController` + services + modèles, sans aucune vue Razor),
|
|
destiné à être déployé sur un sous-domaine dédié en production
|
|
— ex: `blogs.yavsc.example` — pour pouvoir scaler / restreindre
|
|
l'API blog indépendamment du reste de la plateforme.
|
|
|
|
## Conséquences pratiques
|
|
|
|
- Une modification d'un modèle DDD dans `Yavsc.Abstract` peut
|
|
casser **plusieurs fronts et backends à la fois** (Org, Api,
|
|
Blogs, Web). C'est attendu ; les tests de `Yavsc.Org.Tests`
|
|
doivent suivre.
|
|
- Ajouter une route API dans `Yavsc.Api` n'implique pas de
|
|
recompiler `Yavsc.Org` (et inversement).
|
|
- `Yavsc.Blogs` et `Yavsc.Org` partagent le contexte EF via
|
|
`Yavsc.Server` mais n'ont pas de dépendance l'un envers l'autre :
|
|
la même base de données, deux hôtes distincts en production.
|
|
- `PostIt` (sous `src/PostIt/`) ne référence que `Yavsc.Abstract` ;
|
|
il n'embarque ni EF ni ASP.NET Core.
|
|
|
|
## Voir aussi
|
|
|
|
- [Architecture.md](../Architecture.md) — racine.
|
|
- [postit-oidc.md](postit-oidc.md) — PostIt consomme `Yavsc.Api`
|
|
via OIDC.
|