État et appels API

L'application mobile reprend l'architecture du web : un store Redux Toolkit, RTK Query pour les appels au backend et trois slices (auth, lottery, ui). Les noms des endpoints de loterie et de boutique, des tags et des actions sont proches de ceux du web, ce qui permet de passer d'un code à l'autre. Les différences tiennent au périmètre (pas d'endpoint d'administration ni de partenaire, mais des endpoints de mot de passe, de connexion Google et de vérification d'âge) et à plusieurs réglages absents côté mobile.

Le store est créé une fois au chargement du module mobile-app/src/store/index.ts (export const store) et fourni par App.tsx. Les hooks typés useAppDispatch et useAppSelector sont exportés depuis ce fichier.

#Le client de base

mobile-app/src/store/api/baseApi.ts déclare l'unique createApi :

export const baseApi = createApi({
  reducerPath: 'blockluckyApi',
  baseQuery: fetchBaseQuery({
    baseUrl: API_BASE_URL,
    prepareHeaders: async (headers) => {
      const token = await secureStorage.getToken();
      if (token) {
        headers.set('Authorization', `Bearer ${token}`);
      }
      return headers;
    },
  }),
  tagTypes: ['User', 'Lottery', 'Marketplace', 'Points', 'Quests', 'Notifications', 'Wallet'],
  endpoints: () => ({}),
});

Le jeton est lu dans SecureStore et non dans le store Redux. Il est donc envoyé même quand isAuthenticated est faux, par exemple depuis l'écran de connexion après un redémarrage (voir Authentification et stockage sécurisé).

API_BASE_URL est importé de api.client.ts. Ce fichier crée aussi un client axios avec intercepteurs, mais celui-ci n'est utilisé nulle part (voir Résilience réseau).

#Tags de cache

Les tags Admin, Partners, Audit, Identity et Accounts du web n'existent pas. Quatre écrans rafraîchissent le statut de la loterie par pollingInterval :

RTK Query ne rafraîchit pas les données au retour de l'application au premier plan, faute d'appel à setupListeners. Les intervalles de rafraîchissement s'arrêtent quand l'écran est démonté.

#Endpoints par fichier

#authApi

mobile-app/src/store/api/authApi.ts déclare 26 endpoints :

L'endpoint socialLogin (POST /auth/login), que le web utilise toujours, a été retiré du mobile, de même que appleSignIn (connexion Apple supprimée) et setResponsibleLimit (route PUT /user/responsible-limit supprimée).

#lotteryApi

mobile-app/src/store/api/lotteryApi.ts

triggerDraw et refundRound, réservés à la Mairie, n'existent pas sur mobile. Les types de api.types.ts déclarent les champs ajoutés par le backend : phase, waitingRoomOpensAt, revealAt, participants et maxParticipants pour le tour ; ticketNumber, isWinner, winningTicketNumber et prizeEth pour les tickets.

#marketplaceApi

mobile-app/src/store/api/marketplaceApi.ts

La validation en caisse (redeemCode) est propre à l'espace partenaire du web. Il n'y a pas d'adminApi ni de partnersApi sur mobile.

Les routes et leurs schémas sont décrits dans Référence de l'API.

#Slices Redux

#Slice auth

mobile-app/src/store/slices/authSlice.ts

Actions : completeOnboarding, setCredentials, setPendingTwoFactor, updateUserPoints, updateUserProfile, logout. Il n'y a pas d'action d'hydratation ni de champ hydrated. useAuth dérive de user trois valeurs : hasPassword, ageVerificationStatus (NONE par défaut) et isAgeVerified.

#Slice lottery

mobile-app/src/store/slices/lotterySlice.ts contient onlineWaitingUsers (0 au départ), liveChatMessages (vide au départ, 100 au plus, sans doublon d'identifiant), lastWinnerAnnouncement et isRouletteSpinning. Par rapport au web, il manque socketConnected.

#Slice ui

mobile-app/src/store/slices/uiSlice.ts pilote les fenêtres rendues par RootNavigator :

Depuis la refonte, la billetterie et le cadeau affichent leurs propres fenêtres à partir du résultat de useCitizenWallet. Plus aucun écran n'ouvre retryModal : les fenêtres globales de nouvel essai, d'affluence et d'information ne sont accessibles que par une chaîne qui ne démarre jamais. Le slice et ces fenêtres sont à retirer ou à rebrancher.

#Gestion des erreurs

Les erreurs de transaction sont traduites par classifyTicketError et describeBlockchainError de useCitizenWallet (voir Portefeuille et loterie). Les autres écrans utilisent des fonctions de lecture du message du backend avec un texte de repli : getErrorMessage (authErrors.ts et drawFormat.ts) et getApiErrorMessage (lotteryFormat.ts et apiErrors.ts). Ces fonctions sont dupliquées dans plusieurs dossiers. Une panne réseau (FETCH_ERROR) produit le texte de repli propre à chaque écran, sans message « serveur injoignable » commun.

Les messages du backend sont en français et s'affichent tels quels quand l'interface est en anglais.