Kazier/mobile/FEEDBACK.md

Revue du codebase mobile — Retours & Actions

Bugs confirmes (P0)

1. isChildOf trop large

• Fichier : features/syncDevice.ts:39-41
• Probleme : uri.startsWith(rootUri) matche les siblins (Documents matche Documents-archive). Le pass de reconciliation marque exists = 0 sur le mauvais root.
• Fix : uri === rootUri || uri.startsWith(rootUri + '/')

2. Cache OCR casse

• Fichier : hooks/useUpload.ts:35
• Probleme : setQueryData stocke un OcrJob brut, mais useOcrJob attend ApiData<OcrJob> (enveloppe { data }). Resultat : TypeError sur .data.status.
• Fix : queryClient.setQueryData(['ocr', result.data.id], result)

3. Outbox catch trop large

• Fichier : features/syncOutbox.ts:46-52
• Probleme : Toutes les erreurs (y compris 400 permanent) sont traitees comme transitoires. Un 400 boucle a 15s sans jamais dead-letter.
• Fix : Whitelist les erreurs transitoires (NETWORK_ERROR, HTTP_5xx, AbortError) ; les 4xx permanents doivent incrementer attempts via markPendingOperation('failed').

4. canAccess nie l'acces au proprietaire avec cache expire

• Fichier : services/db/repositories/permissions.ts:151-171
• Probleme : Si une permission exacte est en cache mais expiree, canAccess retourne allowed: false avant d'atteindre le fallback owner_id === deviceUserId. Le device peut etre exclu de ses propres fichiers.
• Fix : Verifier le ownership (deviceUserId === owner_id) dans la lignee avant le short-circuit du cache expire, ou au minimum avant de retourner allowed: false.

5. getFiles() / getFolderFolders() ne filtrent pas exists = 0

• Fichier : services/db/repositories/files.ts:75-79, folders.ts:96-98
• Probleme : Les fichiers/dossiers supprimes du SAF restent affiches indefiniment dans l'UI.
• Fix : Ajouter WHERE "exists" = 1 aux requetes, ou filtrer dans les ecrans. Attention : les rows cloud-only (uri = NULL) ont aussi exists = false — il faut distinguer "supprime du disque" de "jamais eu de copie locale". Ne pas filtrer dans le repository si le SAF walk a besoin de voir tous les rows ; filtrer dans les ecrans ou ajouter un flag deleted_from_disk.

6. Tab navigation = router.push sur un Stack

• Fichier : components/FloatingNavBar.tsx:62, app/_layout.tsx
• Probleme : Le layout utilise un <Stack> et la nav bar fait router.push(tab.route). Chaque switch d'onglet empile un ecran. Le bouton systeme depile tout au lieu de quitter l'app.
• Fix : migrer vers le layout <Tabs> d'expo-router, ou utiliser router.replace() pour les onglets.

---

Bugs potentiels (P1)

7. Race condition dans recoverDatabase

• Fichier : services/db/client.ts:54-68
• Probleme : database = null avant closeAsync permet l'ouverture d'une connexion concurrente via getDatabase().
• Fix : Mettre opening a une promise de recovery avant de clear database, ou ajouter un verrou/flag recovering.

8. Pas de single-flight sur les SAF walks

• Fichier : features/syncDevice.ts
• Probleme : Le loop background (useSyncDevice) et le bouton "Add folder" (handlePickDirectory) peuvent lancer syncRoot en parallele. Courses sur l'upsert URI unique -> SQLITE_CONSTRAINT -> transaction annulee.
• Fix : Module-level inFlight promise partagee par syncRoot/syncDevice.

9. Walk SAF dans une transaction SQLite longue

• Fichier : features/syncDevice.ts:48
• Probleme : withTransaction ouvre avant le parcours SAF (potentiellement minutes). Toute lecture DB de l'UI est bloquee.
• Fix : Lister d'abord tous les folders/files SAF hors transaction, puis ouvrir la transaction uniquement pour les writes DB.

10. syncMode === 'manual' se comporte comme 'full'

• Fichier : features/syncDevice.ts:127-128
• Probleme : Seul 'none' desactive le loop. Le mode 'manual' fait aussi un walk complet toutes les 30s.
• Fix : Distinguer les modes ; 'manual' ne devrait pousser que l'outbox/pas de walk SAF automatique.

11. Course auth 401 vs bootstrap

• Fichier : context/AuthContext.tsx:32-70
• Probleme : Un 401 background peut appeler signOut() pendant que bootstrap restaure le token, restaurant une session revoquee.
• Fix : Monotonic "session epoch" verifiee apres chaque await.

12. markPendingOperation race read-modify-write sur attempts

• Fichier : services/db/repositories/pendingOps.ts:118-124
• Probleme : Deux SELECT attempts concurrents lisent la meme valeur, ecrivent la meme. Le compteur ne progresse pas correctement.
• Fix : UPDATE SET attempts = attempts + 1 atomique avec RETURNING attempts, ou UPDATE ... WHERE id = ? puis relire.

13. refreshPermissions race cross-account

• Fichier : features/syncOutbox.ts:78-89
• Probleme : Lecture de activeUserId, puis requete reseau, puis saveResourcePermission relit getActiveUserId() (possiblement change).
• Fix : Capturer activeUserId + token au debut du tick, les reutiliser pour toute la duree.

14. Migration v5 — PRAGMA foreign_keys hors try/finally

• Fichier : services/db/migrations.ts:254, 259
• Probleme : Si la transaction v4/v5 echoue, FK enforcement reste desactive jusqu'au restart du process.
• Fix : Wrapper PRAGMA foreign_keys = OFF/ON dans un try/finally.

15. Dead-lettered operations bloquent pushStatus a 'failed' permanemment

• Fichier : services/db/repositories/pendingOps.ts + shares.ts/shareLinks.ts (PUSH_STATUS_SQL)
• Probleme : Apres MAX_PENDING_ATTEMPTS, l'op est 'failed' et PUSH_STATUS_SQL retourne toujours 'failed' pour la ref, meme si un opration ulterieure reussit.
• Fix : Ajouter un path de cleanup/cancel pour les dead-letters, ou ignorer les 'failed' plus anciens que le plus recent 'completed' dans le subquery.

16. Erreurs SAF silencieuses → faux "dossier vide"

• Fichier : services/safDirectory.ts:23-25, 33-35
• Probleme : pickDirectory et listDirectory catchent toutes les erreurs et retournent null/[]. Une revocation de permission SAF est interpretee comme "dossier vide" → tous les descendants marques exists = 0 lors de la reconciliation.
• Fix : Distinguer "empty" (pas d'entrees) de "error" (exception lancee). Propager l'erreur ou retourner un type { entries: [], error?: string }.

---

Mauvaises pratiques

#	Fichier	Probleme	Action
B1	context/AuthContext.tsx	signIn/signOut/continueWithoutAccount non wrappes en useCallback	Ajouter useCallback
B2	components/FloatingNavBar.tsx:62	router.push(tab.route as any) — as any masque les erreurs de type	Migrer vers layout Tabs expo-router ou typer correctement
B3	app/index.tsx:95-106	Pas de loading/disable sur le bouton "Add folder"	Ajouter etat syncing, disable le bouton, spinner
B4	hooks/useUpload.ts:25-27	useOcrJob poll infiniment sur failed	Stop sur done OU failed
B5	api/client.ts:110-126	Timeout AbortController couvre fetch() mais pas response.json()	Passer le signal a response.json() ou ajouter un timeout sur la lecture body
B6	5+ fichiers	Couleurs/design tokens hardcodes	Extraire dans constants/theme.ts
B7	app/index.tsx + app/folder/[id].tsx	formatSize duplique	Extraire dans utils/format.ts
B8	console.info/console.warn	Disperses dans les chemins production	Gate derriere __DEV__ ou logger
B9	app.json	Nom = "webui" / com.anonymous.webui	Renommer en VaultDrop
B10	api/client.ts:18,21	Erreurs hardcoded en francais ('Serveur injoignable')	Utiliser i18n
B11	app/folder/[id].tsx:30-39	3 requetes DB sequentielles au focus	Promise.all
B12	app/login.tsx	Password input manque autoCapitalize="none", autoCorrect={false}	Ajouter les props
B13	app/folder/[id].tsx	File rows Pressable mais onPress no-op	Retirer Pressable des fichiers ou ajouter une action
B14	app/_layout.tsx + ecrans	Stack.Screen options defini en double (layout + ecran)	Un seul endroit
B15	features/syncDevice.ts	Boucle sync tourne en background sans awareness AppState	Stopper le loop quand AppState est background, reprendre au foreground
B16	services/db/repositories/files.ts:20, folders.ts:15	getDeviceUserId() appele a chaque saveFolder/saveFile (N+1, 4 round-trips par row)	Hoister device_user_id en parametre ou le cacher au debut du tick
B17	services/db/repositories/pendingOps.ts:100-107	scheduleRetries fait N UPDATEs sequentiels	Batch UPDATE WHERE id IN (...)

---

Pieces manquantes

#	Element	Action
M1	services/distantStorage.ts — fichier vide	Supprimer
M2	app/search.tsx et app/settings.tsx — placeholders vides	Implementer ou supprimer les onglets
M3	hooks/ — tous inutilises par les ecrans	Les brancher ou les supprimer
M4	getDeviceAuthToken/saveDeviceAuthToken dans SQLite — non utilise (token dans SecureStore)	Supprimer ou marquer @internal
M5	Aucun loading state dans les ecrans principaux	Ajouter des etats de chargement
M6	Aucun error boundary React	Ajouter un ErrorBoundary au layout racine
M7	Pas de pull-to-refresh	Ajouter RefreshControl
M8	AGENTS.md mentionne v4 alors que le code est a v5	Mettre a jour la doc
M9	localStorage.ts — re-export legacy utilise par les ecrans	Migrer les imports vers services/db

---

Accessibilite

• Zero proprietes d'accessibilite dans l'app (0 matches accessibilityRole, accessibilityLabel, aria-*)
• Les tabs de la nav n'annoncent pas leur etat selectionne
• Les erreurs visuelles (couleur) ne sont pas announcees aux lecteurs d'ecran
• Les icons decoratives sont lues par les screen readers

Action : Pass d'accessibilite minimal — accessibilityRole, accessibilityState, accessibilityLabel sur les elements interactifs.

---

Performance

Probleme	Fichier	Impact	Action
Walk SAF dans transaction SQLite longue	features/syncDevice.ts:48	Bloque les writes UI pendant le walk	Lister les entries SAF hors transaction, puis transaction uniquement pour les writes
N+1 pattern sur saveFolder/saveFile	services/db/repositories/files.ts:20, folders.ts:15	4 round-trips par row (getDeviceUserId a chaque fois)	Hoister device_user_id en parametre ou le cacher au debut du tick
scheduleRetries — N UPDATEs sequentiels	services/db/repositories/pendingOps.ts:100-107	Lent pour gros batches	Un seul UPDATE WHERE id IN (...)
3 requetes DB sequentielles au focus	app/folder/[id].tsx:30-39	Lent sur gros dossiers	Promise.all
Boucle sync sans awareness AppState	features/syncDevice.ts:125-135	Gaspille batterie en background	Stopper le loop quand AppState est background
Pas de pull-to-refresh	app/index.tsx, app/folder/[id].tsx	UI ne se met a jour qu'au refocus	Ajouter RefreshControl

---

Actions planifiees (ordre de priorite)

P0 — Corriger immediatement

• 1. Fix isChildOf — boundary / (features/syncDevice.ts)
• 2. Fix cache OCR — { data: result.data } (hooks/useUpload.ts)
• 3. Distinguer erreurs reseau / erreurs API dans l'outbox (features/syncOutbox.ts)
• 4. Fix canAccess owner vs cache expire (services/db/repositories/permissions.ts)
• 5. Filtrer exists dans getFiles/getFolderFolders ou les ecrans
• 6. Migrer la tab navigation vers <Tabs> ou router.replace() (components/FloatingNavBar.tsx)

P1 — Fixer rapidement

• 7. Race recoverDatabase — serialiser l'ouverture (services/db/client.ts)
• 8. Single-flight sur syncRoot/syncDevice (features/syncDevice.ts)
• 9. syncMode 'manual' gate (features/syncDevice.ts)
• 10. useCallback pour signIn/signOut (context/AuthContext.tsx)
• 11. Atomic attempts + 1 dans markPendingOperation (services/db/repositories/pendingOps.ts)
• 12. Course auth 401 vs bootstrap (context/AuthContext.tsx)
• 13. refreshPermissions race cross-account (features/syncOutbox.ts)
• 14. PRAGMA foreign_keys dans try/finally (services/db/migrations.ts)
• 15. Dead-letter cleanup pour pushStatus (services/db/repositories/pendingOps.ts + shares.ts/shareLinks.ts)
• 16. Erreurs SAF — distinguer "empty" de "error" (services/safDirectory.ts)
• 17. Awareness AppState sur la boucle sync (features/syncDevice.ts)
• 18. Hoister device_user_id (N+1) dans saveFolder/saveFile
• 19. Batch scheduleRetries (UPDATE WHERE id IN (...))

P2 — Ameliorations

• 20. Error boundary au layout racine (app/_layout.tsx)
• 21. Loading/disable sur "Add folder" (app/index.tsx)
• 22. Extraire formatSize en utilitaire partage (utils/format.ts)
• 23. Centraliser les couleurs dans un theme (constants/theme.ts)
• 24. useOcrJob — stop poll sur failed (hooks/useUpload.ts)
• 25. Password input — autoCapitalize, autoCorrect (app/login.tsx)
• 26. Retirer Pressable des file rows ou ajouter une action (app/folder/[id].tsx)
• 27. Promise.all pour les 3 requetes DB au focus (app/folder/[id].tsx)
• 28. Pass d'accessibilite minimal
• 29. Gate console.* derriere __DEV__

P3 — Nettoyage

• 30. Supprimer services/distantStorage.ts
• 31. Supprimer getDeviceAuthToken/saveDeviceAuthToken de SQLite
• 32. Mettre a jour AGENTS.md a v5
• 33. Migrer les imports localStorage.ts vers services/db
• 34. Renommer l'app (app.json + package.json)
• 35. Localiser les messages d'erreur API
• 36. Implementer search.tsx et settings.tsx ou supprimer les onglets
• 37. Supprimer/brancher les hooks inutilises dans hooks/