Files
Kazier/FEEDBACK.md
T
venture d1b0807d38
CI / lint-backend (push) Successful in 1m27s
CI / lint-mobile (push) Successful in 10m24s
CI / test-backend (push) Successful in 1m33s
CI / test-mobile (push) Failing after 12m6s
CI / build-backend (push) Successful in 59s
CI / docker (push) Successful in 8s
fix feedback bugs
2026-09-24 19:40:13 +02:00

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) et 22286aa (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éma app/schemas/16.json exporté). Les sections 🟠/🟡/🛠️ sont conservées comme traçabilité. Chaque finding restant est vérifié avec preuve file: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 — masque and 0xFF contre 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 — purgeSynced exclut les create_resource (tombstones), gates countCreateOperations préservés.
  • C4 features/saf/FileDeleter.kt:122-128 + FolderDeleter.kt:122-124 — journal-first (withTransaction avant suppression SAF) + sweepPendingPhysicalDeletes.
  • C5 auth/SessionManager.kt:70-77 — clear() purge les ops non poussées (pending/failed), appelé par AuthViewModel.signOut/signOutToLocal.
  • C6 OutboxSyncWorker.kt:185-188 — stop au 1er échec (return success(), jamais continue) + cascade transitive cascadeCreateFailure via parent_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.pendingForExport idempotent, shouldFinishSession gate DONE, uniquePageFile() UUID, deletePage DB-d'abord, exportPdf ne marque que les succès.
  • C9 features/scan/ScanImageProcessor.kt:91-92 + ScanViewModel.kt:213 — jamais de recycle() 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 : deleteInCloud sans tombstone locale (exists reste 1) → ressource toujours affichée, walk la revoit, refreshFromServer ne 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 idempotence findExistingMerged:154-161 ajouté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 sans exists explicite 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 (after jamais passé), sharedById/expiresAt en Any? jamais lus, cachedAt jamais persisté, aucun downgrade 24h ni canAccess → 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 : _walkInProgress sans finally dans la boucle (reste true si scope annulé ; seul importRoot:173 a un finally) → 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 : searchWithFilters LIKE brut sans ESCAPE, 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 = crash IllegalStateException au 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 rester processing longtemps (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 :

  1. Dans FileDeleter.deleteInCloud, après enqueueDeleteResource, appeler fileRepository.markMissing(resourceId, now) dans la même transaction Room (ou appDatabase.withTransaction comme deleteFull).
  2. Dans FolderDeleter.deleteInCloud, idem pour le dossier ET sa descendance Room (treeMarkMissing-léger : markMissing sur fichiers + sous-dossiers, sans delete_resource supplémentaire sauf si hasSyncedCreateOperation).
  3. Vérifier que le walk ne ressuscite pas : les lignes exists = 0 + delete_resource pending doivent être ignorées par la réconciliation (garde hasPendingDeleteOperation, cf. OutboxRepository.kt:204).
  4. UI : vérifier que les listes filtrent exists = 1 (déjà le cas) → la ligne disparaît aussitôt. Tests : étendre ProcessedGateTest ou nouveau DeleteInCloudTest — deleteInCloud puis assert exists == 0 + op delete_resource pré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 :

  1. Envelopper mergeSelectedFolders dans appDatabase.withTransaction pour la partie Room (create + reparent + treeMarkMissing) — nécessite d'injecter AppDatabase dans FolderMerger et de rendre FileMover.moveFiles / reparentSubFolders appelables dans une transaction existante (ou journaliser les move_resource/delete_resource dans la transaction et n'exécuter le SAF physique qu'avant/après selon le sens crash-safe : journal-first comme C4).
  2. 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éutiliser sweepPendingPhysicalDeletes).
  3. Garder l'idempotence findExistingMerged pour les relances.
  4. À 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 : nouveau FolderMergerTest — fusion 2 dossiers avec fichiers + sous-dossier, assert movedFiles/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 :

  1. Durcir les entités : exists: Int = 1 (non-null, défaut 1) dans FolderEntity et FileEntity.
  2. Migration v14→v15 : UPDATE folders SET exists = 1 WHERE exists IS NULL, idem files, puis recréation ou NOT NULL DEFAULT 1 (Room : via autoMigrations ou SQL ALTER + 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).
  3. Auditer tous les saveFolder/saveLocalFile/upsertShared* pour passer exists = 1 explicitement.
  4. Option : ajouter un test ExistsDefaultTest — insert sans exists, assert visible dans observeByFolder/searchWithFilters. Note : migration à tester via Migration13To14Test-style (nouveau Migration14To15Test) + :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 :

  1. DTO : typer sharedById: String?, expiresAt: Long? (le serveur renvoie ms epoch ou null — vérifier docs/api-v1.md §6.2 et adapter avec un adapter Moshi tolérant Any?→Long).
  2. Persistance : stocker cachedAt/expiresAt/sharedById/effectiveAccess — soit colonnes sur files/folders, soit nouvelle table resource_permissions (préférable : ne pas polluer les entités). A minima user_preferences : permissions_cached_at.
  3. Delta : syncSnapshot(after: Long? = cachedAt) → apiClient.syncPermissions(after) ; pull complet (after = null) au login/restauration + quand now - cachedAt > 24h (TTL).
  4. Expiration locale : au tick, marquer exists = 0 les lignes dont expiresAt < now ; downgrade lecture seule après TTL sans reseed (gate canAccess : à exposer via ShareRepository.canAccess(resourceId, required) utilisé par les VM avant open/share/rename).
  5. canAccess : ranking viewer < commenter < editor < owner, ownerId == currentUser → owner. Tests : étendre ShareRepositoryTest — delta after, révocation (absent du snapshot → markMissing), expiration (expiresAt passé → masqué), canAccess ranking.

m1+m2 — badge sync et réveils WorkManager

Fichier : features/sync/SyncViewModel.kt:100-137. Plan :

  1. m1 : envelopper le corps de boucle dans try { … } finally { _walkInProgress.value = false } (comme importRoot:173-176), et sortir syncSnapshot de la fenêtre _walkInProgress (flag séparé ou syncing = walk || drain déjà calculé via WorkManager).
  2. m2 : n'enqueuer OutboxSyncWorker/OcrAutoWorker que si le tick a produit quelque chose (results.any { folders+files+missing > 0 } ou pendingOperationDao.countPending() > 0 / fichier promu). Éviter les réveils /30s à vide. Tests : Robolectric SyncViewModelTest — annulation du scope → flag retombe ; tick sans changement → WorkManager non sollicité (mock/static ou extraction d'un SyncScheduler testable).

m5 — walk : transaction géante + getAll() par racine

Fichier : features/sync/DeviceSync.kt:67-163. Plan :

  1. 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 missing en passe séparée.
  2. 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 sur uri (déjà unique) ; filtrer en SQL plutôt qu'en mémoire (isChildOf en LIKE rootUri || '/%').
  3. Conserver le Mutex single-flight ; vérifier ensureActive() 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 :

  1. m19 : exportSchema = true + schemas/ commité ; ajouter un test Migration13To14Test-style qui échoue en cas de dérive (CI).
  2. 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 laisser IllegalStateException brut. Tests : build avec exportSchema=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 Mutex présent (DeviceSync.kt:49), enqueueUniqueWork(KEEP) + batch 20 + ORDER BY id conformes — non-bugs.
  • checkHealth construit bien {base}/health avec base incluant /api/v1 = route backend GET /api/v1/health — OK.
  • Token non stocké en clair (EncryptedSharedPreferences AES256-SIV/GCM + Keystore) — seul TokenProvider.current en mémoire, normal.
  • Ordre interceptors serverUrl → auth → logging, BASIC ne log ni headers ni bodies — OK.
  • Contrat HTTP conforme sur endpoints déclarés (query folderId/page/pageSize, deviceId camel vs device_id login, multipart file/resourceId/folderId, enveloppes {data,meta}/{error:{code,message}}, codes) — OK.
  • device_id claim jamais utilisé comme preuve, seul le Bearer parle — conforme middleware.
  • Worker no-op en mode local (OutboxSyncWorker.kt:111), batch 20 ≤ 100 serveur, statuts OCR, resolveUser trim compatible, password jamais trimé — OK.
  • Deep-links : aucun défini (absence, pas de bug) ; args nav folderResourceId/documentResourceId/ids cohérents, 32-hex sans /.
  • Hilt : MainActivity @AndroidEntryPoint, tous hiltViewModel() ↔ @HiltViewModel, scopes corrects — aucune injection manquante.
  • Pas de recomposition infinie trouvée ; collectAsStateWithLifecycle partout ; placeholder cloud-only correct (DocumentContentViewer.kt:39-47) ; recherche 100 % locale conforme V1 ; back stack onglets correct (saveState/restoreState) ; SelectionState volatile documenté volontaire.
  • Scan : pas de double-recycle draft, pas de double rotation EXIF (comportement correct, commentaire trompeur), swapOrder args corrects, FK scan_pages→sessions CASCADE actif.