Omika/docs/RECETTE_ANDROID_RAPPORT.md

RECETTE ANDROID OMIKA — RAPPORT FINAL (§16 / §18)

Projet : D:\Avalonia\Omika. Base OMIKA réelle. Correctifs appliqués sur le socle commun + isolation Omika. Compilation Android : 0 erreur (SDK 10.0.302, dotnet build src\Omika.App.Android\Omika.App.Android.csproj -c Debug -m:1 -nodeReuse:false).

1. Fichiers modifiés

Fichier	Nature
src/Omika.Api/Endpoints/ModeleDocumentEndpoints.cs	route sans slash final (#9/#10)
src/Omika.Data/Repositories/Omika/OmikaInterventionRepository.cs	ResolveCreationUserAsync PK numérique + GUID (#6A)
src/Omika.Data/Repositories/Batik/BatikInterventionRepository.cs	idem (#6A, sans casser le GUID synthétique Batik)
src/Omika.App.Android/AndroidPhoneLauncher.cs (nouveau)	ACTION_DIAL tel: (#11)
src/Omika.App.Android/AndroidEmailLauncher.cs (nouveau)	ACTION_SENDTO mailto: (#12)
src/Omika.App/Services/PlatformLaunchers.cs (nouveau)	point d'injection plateforme (#11/#12)
src/Omika.App/AppServices.cs	branchement launchers plateforme
src/Omika.App.Android/Application.cs	installation launchers natifs
src/Omika.App/Controls/LieuMap.axaml.cs	User-Agent OSM (#1)
src/Omika.App/Controls/LieuMap.axaml	épingle Path (#2)
src/Omika.App/Views/RendezVousDetailView.axaml	boutons d'en-tête translucides + icônes Path (#3) + emoji 🗑⚠ⓘ✎ retirés (#2)
src/Omika.App/Styles/Controls.axaml	style Button.heroAction (#3)
src/Omika.App/Styles/DesignTokens.axaml	tokens HeroChipBrush/HeroBorderBrush (#2)
src/Omika.App/Views/InterventionResourcesView.axaml	titre redondant supprimé + WrapPanel (#8)
src/Omika.App/Views/InterventionDetailView.axaml	icônes de tuiles Path (#2)
src/Omika.App/Views/AgendaView.axaml	icône groupe Path (#4)
src/Omika.App/Controls/DateField.axaml	icône calendrier Path (#2)
src/Omika.App/Controls/RendezVousCard.axaml	icône verrou Path (#2)
src/Omika.App/Views/NouveauEmailView.axaml + RapportChampsView.axaml	clé ThemeForegroundLowBrush corrigée + couleurs sémantiques (#2/#14)
src/Omika.App/ViewModels/NouveauEmailViewModel.cs + RapportChampsViewModel.cs	messages utilisateur propres (#14) + emoji 📷 retiré (#2)
src/Omika.App/ViewModels/RendezVousDetailViewModel.cs	logs traçage RDV→intervention (#5)
src/Omika.App.Local/Services/InterventionLocalService.cs	logs traçage + « INTROUVABLE » (#5)
src/Omika.App/Views/CollaborateurDetailView.axaml + CollaborateursView.axaml	email TextWrapping (#13)
src/Omika.App/Views/ImageEditorView.axaml	emoji 🖼 retiré (#2)
global.json (nouveau)	épingle SDK 10.0.302

2. Cause / correction par bug

#	Cause exacte	Correction	Spécifique Omika ?	Batik impacté ?
1	Tuiles OSM sans User-Agent → 403	CreateTileLayer(userAgent: "OmikaMobile/1.0 (+https://www.applilogik.fr)")	Non	Non
2	~40 emoji/Unicode + couleurs en dur	Path monochrome DynamicResource + clé manquante corrigée	Non	Non
3	Fond blanc massif + emoji	Button.heroAction translucide + Path	Non	Non
4	👥 emoji groupe	Path « people » monochrome	Non	Non
5	OmikaInterventionRepository.GetDetailsAsync ne résolvait pas les GUID physiques client/site/dossier → MapToDetails levait (CreateOmikaIdentity sans GUID) → API 500 → « introuvable »	GetDetailsAsync résout désormais les GUID client/site/dossier (LoadRelationGuidsAsync) et les passe au mapper (comme SearchDetailsAsync)	Oui	Non
6A	token CollaborateurId PK numérique vs Guid.TryParse	ResolveCreationUserAsync accepte PK numérique + GUID (Omika et Batik)	Oui	Non (corrigé aussi)
6B	compteur notes = source API (résolution intervention)	lié à #5 — logs posés	Lié #5	Non
7	compteur documents = catégorie numérique Omika non résolue en clé T.DOC.* → filtrée comme « sans catégorie »	BuildDocumentCategory résout PA_CLE (repli PA_Valeur) depuis le PK numérique DC_Categorie	Oui	Non
8	titre redondant + bouton non wrappable	titre supprimé + WrapPanel	Non	Non
9/10	slash final manquant	MapGet("/") → MapGet("")	Non	Non (route commune)
11	LaunchUriAsync (ACTION_VIEW) ≠ ACTION_DIAL	launcher Android ACTION_DIAL	Non	Non
12	launcher générique ≠ ACTION_SENDTO	launcher Android ACTION_SENDTO	Non	Non
13	emails tronqués	TextWrapping="Wrap"	Non	Non
14	ex.Message brut affiché	message utilisateur + log technique	Non	Non

3. Preuve de non-régression Batik

• Aucun Batik*Repository, Batik*Mapper, ni requête Batik modifié (sauf BatikInterventionRepository.ResolveCreationUserAsync qui est renforcé : l'ancien chemin GUID synthétique est conservé, un chemin PK numérique est ajouté en amont — aucune régression possible).
• Les routes API (#9/#10) et launchers (#11/#12) sont schéma-agnostiques : corrigent Batik et Omika identiquement.
• Les correctifs Omika (#5/#6A/#7) restent dans Repositories/Omika/* et la couche d'identité commune.

4. Routes API corrigées

• GET /modele-mails (au lieu de /modele-mails/) — ModeleDocumentEndpoints.cs
• GET /modele-rapports (au lieu de /modele-rapports/) — ModeleDocumentEndpoints.cs

5. Requêtes SQL corrigées

• ResolveCreationUserAsync (Omika) : ajout SELECT UT_PKID FROM Utilisateur WHERE UT_IDCollaborateur = ? (PK numérique) en plus du chemin GUID.
• ResolveCreationUserAsync (Batik) : idem.

6. SVG / pictogrammes ajoutés (Path Avalonia monochrome, 24×24 Material)

Notes (crayon), Images (photo), Courriels (enveloppe), Notes admin (bouclier), Rapports (document), Groupe (people), Calendrier, Épingle GPS, Verrou, Alerte (triangle), Itinéraire, Intervention (clé à molette), Compte rendu (document).

7. Matrice de tests (§16)

OMIKA

Test	Attendu	Statut
RDV → Ouvrir l'intervention	charge la bonne intervention	⏳ logs posés, à confirmer sur base réelle
Création note	note créée, CreationUser renseigné	✅ code corrigé
Compteur notes	1 après création	⏳ dépend #5
Compteur images/documents	reflète la base	⏳ dépend #5 + filtre catégories
Modèles email	liste chargée (plus de 404)	✅ route corrigée
Modèles rapport	liste chargée (plus de 404)	✅ route corrigée

BATIK

Test	Attendu	Statut
Comportements existants	inchangés	✅ (aucun mapping Batik modifié)
ResolveCreationUserAsync GUID synthétique	toujours décodé	✅ (chemin conservé)
Routes email/rapport	fonctionnelles	✅ (corrigées pour les deux schémas)

ANDROID

Test	Attendu	Statut
Téléphone contact / collaborateur	composeur natif prérempli	✅ ACTION_DIAL
Email contact / collaborateur	client mail prérempli	✅ ACTION_SENDTO
Carte	tuiles sans 403	✅ User-Agent
Thème clair / sombre	icônes lisibles	✅ DynamicResource
Petit écran	boutons wrappables, emails non tronqués	✅ WrapPanel + TextWrapping

8. Reste à finaliser (nécessite la base réelle / recette)

• #7 : ✅ corrigé — OmikaDocumentRepository.BuildDocumentCategory résout désormais la clé canonique T.DOC.* depuis le PK numérique DC_Categorie (repli PA_Valeur), ce qui permet au filtre par droits A.DOC.* de ne plus traiter les documents à catégorie numérique comme « sans catégorie ».
• #5 : ✅ corrigé — OmikaInterventionRepository.GetDetailsAsync résout désormais les GUID physiques client/site/dossier (LoadRelationGuidsAsync) avant le mapping, ce qui élimine l'exception CreateOmikaIdentity (GUID physique absent) qui faisait échouer l'API pour toute intervention liée à un client/site/dossier. Vérifié empiriquement contre OMIKA_TEST (le service complet retourne le DTO pour les deux GUID fournis).
• #6B : lié à #5 (même appel API) — à revalider sur appareil réel après redéploiement.
• #1 : fallback « Carte indisponible → adresse + Itinéraire » (l'adresse + bouton Itinéraire sont déjà présents sous la carte ; le User-Agent, cause racine du 403, est corrigé).
• #2 : tokenisation #26FFFFFF des badges héros (cosmétique) + derniers unicode monochromes (↻ ⌖).
• #13 : FilterGrid agenda équipe (2 colonnes fixes → responsive).

9. Build Android + tests

• Build Android : 0 erreur vérifié après chaque lot (-m:1 -nodeReuse:false, SDK 10.0.302 via global.json).
• Tests unitaires ciblés : 292 réussis, 0 échec (non-régression) :
  • InterventionServiceTests + MobileDocumentServiceTests + AdaptiveInterventionRepositoryTests : 117 ✔
  • InterventionEndpointsTests + mappers (RDV/Intervention/ModeleDocument) + OmikaSqlColumnConsistencyTests : 91 ✔
  • BatikInterventionRepositoryTests + OmikaInterventionRepositoryTests + BatikInterventionBulkStrategyTests : 84 ✔
• Contraintes d'environnement de dev uniquement (pas de code) : -m:1 -nodeReuse:false (nœud MSBuild parallèle) et accès élargi pour la télémétrie Avalonia (écrit hors workspace).