20 KiB
FEEDBACK — Audit bugs mobile-kotlin (local-first)
Généré le 2026-09-22 par 5 agents d'exploration parallèles (scopes : Room/DB, sync/outbox/SAF, réseau/auth/repos, UI/navigation/VM, scan/pdf/review/thumbnails). Mise à jour le 2026-09-24 : les items corrigés par
d89c0d0 (fix 1 to 6)et22286aa (fix mobile audit review)ont été re-vérifiés code en main et retirés. Ce document ne liste que le reliquat confirmé. Màj 2026-09-24 (soir) : tout le reliquat ci-dessous est corrigé et testé (:app:testDebugUnitTest: 162/162 verts, DB v16, schémaapp/schemas/16.jsonexporté). Les sections 🟠/🟡/🛠️ sont conservées comme traçabilité. Chaque finding restant est vérifié avec preuvefile:line. Scope :mobile-kotlin/uniquement. Légende : 🟠 Majeur (divergence silencieuse, contrat violé) · 🟡 Mineur (UX, perf, dette).
Base paths : mobile-kotlin/app/src/main/java/com/kazier/mobile/…
✅ Corrigés et retirés (vérifiés le 2026-09-24)
🔴 Critiques : 9/9 corrigés
- C1
domain/GenerateId.kt:19— masqueand 0xFFcontre la sign-extension, 32-hex conforme. - C2
features/sync/OutboxSyncWorker.kt:139-145— erreurs non-attribuables (INVALID_RESPONSE, 429/408, 4xx batch-level) →Result.retry()sans toucher aux ops. - C3
data/local/dao/PendingOperationDao.kt:66-72—purgeSyncedexclut lescreate_resource(tombstones), gatescountCreateOperationspréservés. - C4
features/saf/FileDeleter.kt:122-128+FolderDeleter.kt:122-124— journal-first (withTransactionavant suppression SAF) +sweepPendingPhysicalDeletes. - C5
auth/SessionManager.kt:70-77—clear()purge les ops non poussées (pending/failed), appelé parAuthViewModel.signOut/signOutToLocal. - C6
OutboxSyncWorker.kt:185-188— stop au 1er échec (return success(), jamaiscontinue) + cascade transitivecascadeCreateFailureviaparent_resource_id/payload. - C7
OutboxSyncWorker.kt:152,170-174,193-196—applied.coerceIn,failedIndex < 0 → stop,applied == 0 → stop(anti busy-loop/crash). - C8 Scan export —
ScanExport.pendingForExportidempotent,shouldFinishSessiongateDONE,uniquePageFile()UUID,deletePageDB-d'abord,exportPdfne marque que les succès. - C9
features/scan/ScanImageProcessor.kt:91-92+ScanViewModel.kt:213— jamais derecycle()sur l'alias affiché (!==check).
🟠 Majeurs corrigés (31)
M1 (garde pending-move dossiers), M2 (gate create avant move), M3 (FileMover sans repli mensonger), M4 (exclusion exists=0 pending seul), M6 (parent inconnu → continue), M7 (importRoot schedule le drain), M8 (fichiers 0-octet acceptés), M10 (DeviceIdentity mutex + insertIgnore), M11 (décision assumée : pas de backfill create_resource), M12 (upsertTolerant sur resource_id/uri), M14 (colonne device_id, UNIQUE(device_id, operation_id) + migration 11→12), M15 (failDescendants élargi, cf. C6), M21 (boucle listFilesPaged + meta.total), M22 (ApiClient distingue CancellationException/JsonDataException/IOException), M23 (activeUserStore vs ownerId, plus de confusion device/user), M24 (normalizePayloadNumbers Double→Long), M25 (SessionManager possède onUnauthorized), M26 (ServerUrlInterceptor runBlocking load() anti-race), M28 (validation URL toHttpUrl()), M29 (pendingDefaultPick saveable), M30 (pager rememberSaveable), M31 (debounce sur résultats seuls), M32 (gate canShare FolderDetail), M33 (refreshShareGate au login/logout), M34 (selection.clear() + chips figés en sélection), M35 (resolveViewerPage clamp), M36 (sélecteur thème 3 états), M37 (flag dirty anti-écrasement saisie), M38 (MAX(sortOrder)+1), M42 (processed=true PDF builder), M43 (réinsertion optimiste review), M44 (remember(existingIds) stable).
🟡 Mineurs corrigés dans d89c0d0 (voir git show --stat d89c0d0)
m4 (gardes cursor SAF), m6 (deleteLocally transactionnel), m8 (FileOrdering aligné SQL), m9 (commentaire attempts diagnostic), m10-m14 (updateUri, LocalModeStore, load réarmable, StateFlow après succès DB, clé SYNC_MODE retirée), m16-m18 (index, defaultValue processed, swapOrder contraint), m22 (ApiService endpoints contrat ajoutés), m23 (registerDevice erreurs visibles), m24 (garde mode local), m25 (logging sans PII), m26 (Bearer hors routes publiques), m27 (expiresAt persisté), m28 (SecureTokenStore lazy + Direct Boot), m29-m31 (nav pdfbuilder/empty, launchSingleTop, controller hoisté), m33-m39 (side-effects buildPhase, dialogs rememberSaveable, badge collectes, saisie serveur debouncée, flash thème, bandeau import, FileStatus.LOCAL), m40-m56 (scan/camera/thumbnails : résolution bornée, toBitmap throttlé, listener retiré, else rotation, garde sourceRect, arrondi crop, combine nettoyé, purge ABANDONED, unicité session active, FileCategory CSV cohérent, purge map Mutex, .tmp nettoyés, isUpToDate taille+mtime, runCatching close, commentaire max, release() sur exception, deck conservé sur erreur).
🟠 Majeurs restants (4) — ✅ tous corrigés le 2026-09-24 (162/162 tests verts)
- M5 —
features/saf/FileDeleter.kt:88-104+features/saf/FolderDeleter.kt:91-103:deleteInCloudsans tombstone locale (existsreste 1) → ressource toujours affichée, walk la revoit,refreshFromServerne supprime jamais de lignes → fantôme local vs serveur supprimé. - M9 —
features/saf/FolderMerger.kt:59,65-101: merge toujours multi-transactions (create, moves, deletes séparés) ; seule idempotencefindExistingMerged:154-161ajoutée, pas d'atomicité → crash à mi-fusion = état partiel poussé. - M13 — entités
exists: Int? = null+ filtres= 1(FolderEntity.kt:36,FileEntity.kt:46,FolderDao.kt:43,50,FileDao.kt:27,44) : toute ligne sansexistsexplicite disparaît UI/recherche/review — perte fonctionnelle silencieuse. - M27 —
data/repository/ShareRepository.kt:47+data/remote/dto/Dtos.kt:150-151: snapshot permissions sans delta (afterjamais passé),sharedById/expiresAtenAny?jamais lus,cachedAtjamais persisté, aucun downgrade 24h nicanAccess→ grant révoqué/expiré reste visible et ouvrable (404) jusqu'au prochain login.
🟡 Mineurs restants (8) — ✅ tous corrigés le 2026-09-24 (162/162 tests verts)
Sync / Worker / SAF
- m1 —
features/sync/SyncViewModel.kt:108-133:_walkInProgresssansfinallydans la boucle (restetruesi scope annulé ; seulimportRoot:173a unfinally) → badge « syncing » collé ; la fenêtre inclut l'appel réseau partage. - m2 —
features/sync/SyncViewModel.kt:110-116:OutboxSyncWorker.enqueue+OcrAutoWorker.enqueueà chaque tick même sans changement → réveils WorkManager / 30s pour rien. - m5 —
features/sync/DeviceSync.kt:76-162: « transaction courte » en réalité géante (N upserts +getAll()dossiers et fichiers par racine sous verrou écriture) → lecteurs Room bloqués, jank/ANR sur grosses arborescences.
Room / Domain / DI
- m7 —
data/local/dao/FileDao.kt:45:searchWithFiltersLIKEbrut sansESCAPE, casse ASCII-only →%/_= jokers (match-all), « ete » ne trouve pas « ÉTÉ ». - m15 —
di/DatabaseModule.kt:25-28: aucune stratégie de downgrade → APK plus ancien sur DB v14 = crashIllegalStateExceptionau lieu de dégradation contrôlée. - m19 —
data/local/AppDatabase.kt:36-37:version=14, exportSchema=false, migrations non snapshotées → dérives indétectables en CI.
Sync contrat / OCR
- m20 —
data/repository/OcrRepository.kt:66-73:poll()infini (while(true)+ 3s, sans timeout) alors qu'un job peut resterprocessinglongtemps (stale claim serveur) → coroutine tenue indéfiniment. - m21 —
data/repository/OutboxRepository.kt:72-147: ops contrat non émissibles (update_metadata,update_share,create_link,revoke_link— §6.1 = 9 ops, helpers partiels) → rename partagé, update share, liens publics inopérants.
🛠️ Plans de correction (reliquat) — ✅ implémentés le 2026-09-24
Ordre suivi : M13 → M5 → M27+m21 → M9 → mineurs par lot (m1+m2, m5, m7, m20, m15+m19).
Écarts d'implémentation vs plan : M13 sans rewrite (colonne restée nullable, défaut Kotlin 1 + backfill — pas de bump de contrainte) ; m7 COLLATE NOCASE sans colonne normalisée (repli Unicode « ete » → « ÉTÉ » toujours ouvert, voir suivi) ; M27 cachedAt persisté = heure locale du pull (pas l'horloge serveur, skew).
M5 — deleteInCloud sans tombstone locale
Fichiers : features/saf/FileDeleter.kt:88-104, features/saf/FolderDeleter.kt:91-103 (+ descendants via collectDescendants).
Constat : deleteInCloud enqueue delete_resource mais laisse exists = 1 ; la ressource reste affichée et le walk la revoit.
Plan :
- Dans
FileDeleter.deleteInCloud, aprèsenqueueDeleteResource, appelerfileRepository.markMissing(resourceId, now)dans la même transaction Room (ouappDatabase.withTransactioncommedeleteFull). - Dans
FolderDeleter.deleteInCloud, idem pour le dossier ET sa descendance Room (treeMarkMissing-léger :markMissingsur fichiers + sous-dossiers, sansdelete_resourcesupplémentaire sauf sihasSyncedCreateOperation). - Vérifier que le walk ne ressuscite pas : les lignes
exists = 0+delete_resourcepending doivent être ignorées par la réconciliation (gardehasPendingDeleteOperation, cf.OutboxRepository.kt:204). - UI : vérifier que les listes filtrent
exists = 1(déjà le cas) → la ligne disparaît aussitôt. Tests : étendreProcessedGateTestou nouveauDeleteInCloudTest—deleteInCloudpuis assertexists == 0+ opdelete_resourceprésente ; walk simulé ne ressuscite pas.
M9 — FolderMerger multi-transactions non-atomique
Fichier : features/saf/FolderMerger.kt:53-106.
Constat : createMergedFolder (transaction 1), moves (N transactions via FileMover/reparentSubFolders), deletes (N transactions). Un crash à mi-fusion laisse un état partiel ; la relance est idempotente (dossier réutilisé) mais ne reprend pas les moves manquants proprement.
Plan :
- Envelopper
mergeSelectedFoldersdansappDatabase.withTransactionpour la partie Room (create + reparent +treeMarkMissing) — nécessite d'injecterAppDatabasedansFolderMergeret de rendreFileMover.moveFiles/reparentSubFoldersappelables dans une transaction existante (ou journaliser lesmove_resource/delete_resourcedans la transaction et n'exécuter le SAF physique qu'avant/après selon le sens crash-safe : journal-first comme C4). - Ordre crash-safe : (a) transaction Room = create + moves logiques + deletes logiques (
exists = 0+ outbox), (b) exécution SAF physique (moves + deletes), (c) sweep au prochain tick pour les physiques manqués (réutilisersweepPendingPhysicalDeletes). - Garder l'idempotence
findExistingMergedpour les relances. - À défaut d'une transaction unique (SAF non transactionnel), a minima : rendre chaque étape reprise-safe (skip les sources déjà vides, skip les moves déjà journalisés via
hasPendingMoveOperation). Tests : nouveauFolderMergerTest— fusion 2 dossiers avec fichiers + sous-dossier, assertmovedFiles/deletedFolders, relance idempotente (pas de doublon), crash simulé entre étape 2 et 3 → reprise sans perte.
M13 — exists: Int? = null invisible
Fichiers : data/local/entity/FolderEntity.kt:36, data/local/entity/FileEntity.kt:46, DAO (FolderDao, FileDao filtres = 1), Migrations.kt (créations tables sans DEFAULT 1 / NOT NULL).
Constat : toute ligne insérée sans exists explicite (défaut Kotlin null) est cachée par les requêtes WHERE exists = 1.
Plan :
- Durcir les entités :
exists: Int = 1(non-null, défaut 1) dansFolderEntityetFileEntity. - Migration v14→v15 :
UPDATE folders SET exists = 1 WHERE exists IS NULL, idemfiles, puis recréation ouNOT NULL DEFAULT 1(Room : viaautoMigrationsou SQLALTER+ table rewrite selon la version SQLite ; le plus simple :UPDATE+ contrainte applicative + défaut entité, sans rewrite si Room accepte le changement nullable→non-null via migration manuelle avec recréation de table). - Auditer tous les
saveFolder/saveLocalFile/upsertShared*pour passerexists = 1explicitement. - Option : ajouter un test
ExistsDefaultTest— insert sansexists, assert visible dansobserveByFolder/searchWithFilters. Note : migration à tester viaMigration13To14Test-style (nouveauMigration14To15Test) +:app:testDebugUnitTest.
M27 — snapshot permissions sans delta ni canAccess
Fichiers : data/repository/ShareRepository.kt:44-47, data/remote/dto/Dtos.kt:144-156 (sharedById/expiresAt: Any?), data/remote/ApiService.kt:74-78, ApiClient.kt:106-108.
Constat : syncPermissions() sans after, champs sharedById/expiresAt jamais lus, cachedAt jamais persisté, aucun downgrade TTL 24h ni canAccess → grants révoqués/expirés visibles jusqu'au prochain login.
Plan :
- DTO : typer
sharedById: String?,expiresAt: Long?(le serveur renvoie ms epoch ou null — vérifierdocs/api-v1.md §6.2et adapter avec un adapter Moshi tolérantAny?→Long). - Persistance : stocker
cachedAt/expiresAt/sharedById/effectiveAccess— soit colonnes surfiles/folders, soit nouvelle tableresource_permissions(préférable : ne pas polluer les entités). A minimauser_preferences:permissions_cached_at. - Delta :
syncSnapshot(after: Long? = cachedAt)→apiClient.syncPermissions(after); pull complet (after = null) au login/restauration + quandnow - cachedAt > 24h(TTL). - Expiration locale : au tick, marquer
exists = 0les lignes dontexpiresAt < now; downgrade lecture seule après TTL sans reseed (gatecanAccess: à exposer viaShareRepository.canAccess(resourceId, required)utilisé par les VM avant open/share/rename). canAccess: ranking viewer < commenter < editor < owner,ownerId == currentUser→ owner. Tests : étendreShareRepositoryTest— deltaafter, révocation (absent du snapshot →markMissing), expiration (expiresAtpassé → masqué),canAccessranking.
m1+m2 — badge sync et réveils WorkManager
Fichier : features/sync/SyncViewModel.kt:100-137.
Plan :
- m1 : envelopper le corps de boucle dans
try { … } finally { _walkInProgress.value = false }(commeimportRoot:173-176), et sortirsyncSnapshotde la fenêtre_walkInProgress(flag séparé ousyncing= walk || drain déjà calculé via WorkManager). - m2 : n'enqueuer
OutboxSyncWorker/OcrAutoWorkerque si le tick a produit quelque chose (results.any { folders+files+missing > 0 }oupendingOperationDao.countPending() > 0/ fichier promu). Éviter les réveils /30s à vide. Tests : RobolectricSyncViewModelTest— annulation du scope → flag retombe ; tick sans changement →WorkManagernon sollicité (mock/static ou extraction d'unSyncSchedulertestable).
m5 — walk : transaction géante + getAll() par racine
Fichier : features/sync/DeviceSync.kt:67-163.
Plan :
- Découper la phase 2 : upserts dossiers/fichiers par batch (ex. 200) en transactions courtes successives au lieu d'une transaction unique ; la réconciliation
missingen passe séparée. - Remplacer
folderRepository.getAll()+fileRepository.getAll()(full-table scan par racine) par des requêtes scopées à la racine (getByRootUri/getDescendants) — à ajouter aux DAO avec index sururi(déjà unique) ; filtrer en SQL plutôt qu'en mémoire (isChildOfenLIKE rootUri || '/%'). - Conserver le
Mutexsingle-flight ; vérifierensureActive()dans les boucles longues pour annulation propre. Tests :SafScannerTest-style perf — 5k fichiers simulés, assert temps/absence d'ANR ; test de convergence identique avant/après.
m7 — recherche LIKE sans ESCAPE
Fichier : data/local/dao/FileDao.kt:42-49.
Plan : échapper %, _, \ dans :query côté repository (searchFiles) + LIKE … ESCAPE '\' dans la requête ; ajouter COLLATE NOCASE (ou normalisation) pour « ete » → « ÉTÉ ». Tester : %, _, \, accents, casse.
Tests : SearchFieldTest ou nouveau SearchEscapeTest — % littéral ne matche pas tout, _ littéral, insensible à la casse.
m20 — OcrRepository.poll() infini
Fichier : data/repository/OcrRepository.kt:66-73.
Plan : ajouter timeout (ex. 10 min) + nombre max de polls + backoff ; lever OcrTimeoutException ou retourner le dernier état ; coopérer avec l'annulation (ensureActive). Mettre à jour les appelants (viewer auto) pour afficher « OCR indisponible, réessayer ».
Tests : OcrRepositoryTest — job restant processing → timeout au bout de N polls (fake ApiClient + virtual time/delays courts).
m15+m19 — robustesse DB (downgrade + exportSchema)
Fichiers : di/DatabaseModule.kt:25-28, data/local/AppDatabase.kt:31-38.
Plan :
- m19 :
exportSchema = true+schemas/commité ; ajouter un testMigration13To14Test-style qui échoue en cas de dérive (CI). - m15 : stratégie downgrade explicite et documentée — soit
fallbackToDestructiveMigrationOnDowngrade()(avec avertissement perte de données locales, acceptable car miroir SAF + outbox non poussée à préserver → plutôt refuser le démarrage avec message), soit crash contrôlé avec écran « mettez à jour l'app ». Choisir et documenter ; ne jamais laisserIllegalStateExceptionbrut. Tests : build avecexportSchema=true+room.schemaLocation; test downgrade (ouverture v15 avec APK v14 → comportement attendu).
m21 — ops contrat non émissibles
Fichiers : data/repository/OutboxRepository.kt:72-147, data/local/entity/PendingOperationEntity.kt:76-86 (constantes déjà présentes : UPDATE_METADATA, UPDATE_SHARE, CREATE_LINK, REVOKE_LINK).
Plan : ajouter enqueueUpdateMetadata(resourceId, resourceType, name?), enqueueUpdateShare(...), enqueueCreateLink(resourceId, resourceType, token, access, expiresAt?), enqueueRevokeLink(...) avec payloads §6.1 (granteeUserId/access/inherit/expiresAt, token/access/expiresAt) ; brancher les appelants (rename partagé, update share, liens publics) ; GenerateId pour token 32-hex côté client.
Tests : OutboxSyncWorkerTest-style — sérialisation payload, normalizePayloadNumbers (expiresAt Long exact, non 1.7E12), round-trip POST /sync/ops mocké.
✅ Vérifié infondé (suspects écartés)
- Single-flight
Mutexprésent (DeviceSync.kt:49),enqueueUniqueWork(KEEP)+ batch 20 +ORDER BY idconformes — non-bugs. checkHealthconstruit bien{base}/healthavec base incluant/api/v1= route backendGET /api/v1/health— OK.- Token non stocké en clair (
EncryptedSharedPreferencesAES256-SIV/GCM + Keystore) — seulTokenProvider.currenten mémoire, normal. - Ordre interceptors
serverUrl → auth → logging,BASICne log ni headers ni bodies — OK. - Contrat HTTP conforme sur endpoints déclarés (query
folderId/page/pageSize,deviceIdcamel vsdevice_idlogin, multipartfile/resourceId/folderId, enveloppes{data,meta}/{error:{code,message}}, codes) — OK. device_idclaim jamais utilisé comme preuve, seul leBearerparle — conforme middleware.- Worker no-op en mode local (
OutboxSyncWorker.kt:111), batch 20 ≤ 100 serveur, statuts OCR,resolveUsertrim compatible, password jamais trimé — OK. - Deep-links : aucun défini (absence, pas de bug) ; args nav
folderResourceId/documentResourceId/idscohérents, 32-hex sans/. - Hilt :
MainActivity @AndroidEntryPoint, toushiltViewModel()↔@HiltViewModel, scopes corrects — aucune injection manquante. - Pas de recomposition infinie trouvée ;
collectAsStateWithLifecyclepartout ; placeholder cloud-only correct (DocumentContentViewer.kt:39-47) ; recherche 100 % locale conforme V1 ; back stack onglets correct (saveState/restoreState) ;SelectionStatevolatile documenté volontaire. - Scan : pas de double-
recycledraft, pas de double rotation EXIF (comportement correct, commentaire trompeur),swapOrderargs corrects, FKscan_pages→sessions CASCADEactif.