yavsc/doc/testing.md

Stratégie de test

Yavsc utilise xUnit (xunit.v3) avec un mix d'unitaire pur et d'intégration légère. Les projets de tests sont sous src/<projet>.Tests/ et consomment le scaffold partagé src/Yavsc.Tests.Shared/.

Vue d'ensemble

Sujet	Document
Scaffold partagé (WebHostFixture, JWT de test, etc.)	src/Yavsc.Tests.Shared/README.md
Convention des dossiers de tests	Conventions
Driver EF Core en test	EF Core en test
Stubs d'authentification et de permissions	Auth et permissions

Conventions des dossiers de tests

Sous src/<projet>.Tests/, on trouve quatre dossiers de premier niveau qui classifient les tests par intention :

Dossier	Usage
NonRegression/	Régressions : un bug constaté, un test qui le détecte si on le réintroduit
Mandatory/	Tests bloquants : ils doivent passer avant tout merge
Smoke/	Smoke tests HTTP rapides, montent un host léger
Controllers/	Tests unitaires des contrôleurs (mock du service, assertions sur le mapping HTTP)

Les NonRegression sont la cible par défaut quand on fixe un bug : ils doivent être rouges avant le fix, verts après, et continuer à casser si quelqu'un revert le fix. Pas de test qui passe à vide.

EF Core en test

Pour les tests qui ont besoin d'un ApplicationDbContext, on utilise UseInMemoryDatabase avec un InMemoryDatabaseRoot partagé au niveau de la fixture. Pas de SQLite, pas de Docker, pas de mock du contexte : le service testé s'exécute contre un vrai DbContext sur in-memory.

private static readonly InMemoryDatabaseRoot _dbRoot = new();

var opts = new DbContextOptionsBuilder<ApplicationDbContext>()
    .UseInMemoryDatabase("Yavsc.Org.Tests.MyFixture", _dbRoot)
    .Options;

Le InMemoryDatabaseRoot partagé est important : sans lui, EF crée un store indépendant par DbContext dans certaines configurations, et un test qui seed + read sur deux contextes voit un store vide. Le pattern est documenté dans BlogsWebServerFixture (src/Yavsc.Blogs.Tests/BlogsWebServerFixture.cs).

Limite connue : le provider in-memory ignore les Migration EF et ne respecte pas les FK sur les raw SQL (ExecuteSqlRaw). Pour tester des contraintes FK, on écrit la configuration dans OnModelCreating et on s'appuie sur le fait qu'EF la respecte à l'Add/SaveChanges. Pour tester des migrations, c'est l'environnement de staging.

Auth et permissions

L'authorization policy provider de prod est swappé contre TestAuthPolicyProvider (dans Yavsc.Tests.Shared) par les fixtures spécialisées. Les tests qui ont besoin qu'un user soit "Administrator" envoient un header X-Test-Rôle ; ceux qui veulent un user anonyme omettent le header.

Pour les tests unitaires qui n'ont pas besoin du pipeline HTTP, on stub IAuthorizationService directement (cf. BlogspotController dans Yavsc.Org.Tests/NonRegression/) pour éviter de monter un host complet.

Tests cibles des podcasts

Avec le runner Microsoft.Testing.Platform du depot (.NET 10, xUnit v3) :

dotnet test --project src/test/Yavsc.Api.Tests/Yavsc.Api.Tests.csproj \
  --filter-class '*LiveProcessorTests' --filter-class '*PodcastControllerTests'
dotnet test --project src/PostIt/PostIt.Tests/PostIt.Tests.csproj \
  --filter-class '*PodcastTests' --filter-class '*PodcastNativeCaptureTests'

Les tests serveur couvrent HTTP/authentification, proprietaire, sequences, reprises idempotentes, limites exactes, concurrence et persistance des replays apres interruption/redemarrage, dans des dossiers temporaires isoles.

Les tests natifs sont explicitement ignores sans POSTIT_TEST_MEDIA. Pour les activer, installer LibVLC avec ses encodeurs H.264/AAC et definir cette variable sur un fichier video local d'environ huit secondes contenant une piste audio. Ils exercent la segmentation LibVLC reelle, l'envoi et la reprise apres acquittement perdu, le dernier segment apres arret et le decodage authentifie du replay. Aucun FFmpeg n'est requis par ces tests ni par l'application (le fichier d'entree peut provenir de n'importe quelle source). Les tests materiels camera/microphone Windows/Linux restent manuels.

Rotation de la capture Android

Le calcul capteur/ecran/camera avant et les quatre transformations de texture sont couverts sans appareil :

dotnet test --project src/PostIt/PostIt.Tests/PostIt.Tests.csproj \
  --filter-class '*CameraFrameOrientationTests' --filter-class '*CameraFrameClockTests'

Un test Android supplementaire verifie le chemin OpenGL et l'encodeur reels, sans ouvrir la camera, sans microphone et sans contacter l'API :

dotnet build src/PostIt/PostIt.Android/PostIt.Android.csproj -c Debug \
  -p:EmbedAssembliesIntoApk=true
adb install -r -t src/PostIt/PostIt.Android/bin/Debug/net10.0-android/fr.pschneider.postit-Signed.apk
adb shell am start -n fr.pschneider.postit/fr.pschneider.postit.CameraFrameRotationTestActivity
adb shell run-as fr.pschneider.postit cat files/camera-rotation-test-result.txt

Attendre la fin du test : RUNNING doit devenir PASS. Il encode quatre quadrants colores en MPEG-TS pour 0, 90, 180 et 270 degres, decode une image et verifie les dimensions (640x480 ou 480x640) et les couleurs aux quatre positions. La tolerance de chaque composante RGB est de 40 pour tenir compte de H.264. Une erreur de rendu, d'encodage, de decodage ou de comparaison produit FAIL avec l'exception. Cette activite est exclue des builds Release.

Le test synthetique ne couvre pas l'horloge Camera2 ni sa synchronisation avec le microphone. Avec l'accord de la personne utilisant le telephone, lancer aussi le test local reel (camera et microphone actifs, aucun envoi a l'API) :

adb shell am start -n fr.pschneider.postit/fr.pschneider.postit.PodcastCaptureTestActivity --es microphone true
adb shell run-as fr.pschneider.postit cat files/podcast-capture-test-result.txt

Attendre PASS : au moins trois segments, 8 a 16 secondes capturees, pistes H.264 et AAC presentes, et progression des segments en arriere-plan. Ce test detecte notamment les captures de zero seconde dues au decalage entre l'horloge Camera2 et celle de MediaRecorder. Les fichiers restent dans le repertoire prive indique par le resultat pour verification locale. Le resultat inclut les angles capteur/ecran et la premiere matrice SurfaceTexture recue. Les tests unitaires couvrent notamment la matrice reelle [0,-1,0,0,-1,0,0,0,0,0,1,0,1,1,0,1] : pour un capteur a 90 degres et un ecran a 0, elle porte deja la rotation et ne doit pas recevoir 90 degres supplementaires. Le test synthetique seul ne detecte pas cette double rotation.

Verifier aussi manuellement les cameras avant/arriere en portrait et paysage, le son, le direct et le replay, et la poursuite de l'emission en arriere-plan. L'orientation est fixee au demarrage d'une emission ; tourner le telephone pendant l'emission ne reconfigure pas le format encode.

Quand ne PAS écrire de test

Un test qui ne détecte rien n'est pas un test. Si l'invariant qu'on cherche à protéger est déjà enforced par EF, par le compilateur, ou par une couche applicative en amont, le test est du bruit. Mieux vaut :

• Un test qui assert un comportement observable (code retour HTTP, exception typée, valeur de retour)
• Ou pas de test, et une note dans le code

La non-régression se prouve par un test qui casse si on réintroduit le bug. Pas par un test qui passe aujourd'hui et qui continuera à passer après un revert.