Arquitectura Técnica

app/ # Expo Router root ├── _layout.tsx # Root layout: ThemeProvider, QueryClient, AuthGuard ├── index.tsx # Redirect → /auth o /dashboard │ ├── (auth)/ # Grupo público (sin bottom tab) │ ├── login.tsx │ ├── register.tsx │ ├── forgot-password.tsx │ ├── reset-password.tsx │ └── google-callback.tsx │ ├── (app)/ # Grupo protegido (con bottom tab bar) │ ├── _layout.tsx # Tab navigator + AuthGuard │ │ │ ├── dashboard/ │ │ └── index.tsx # Home: resumen + transacciones recientes │ │ │ ├── budgets/ │ │ ├── index.tsx # Lista de presupuestos │ │ ├── [id].tsx # Detalle / edición de presupuesto │ │ └── new.tsx # Crear presupuesto │ │ │ ├── transactions/ │ │ ├── index.tsx # Lista + búsqueda paginada │ │ ├── [id].tsx # Editar transacción │ │ └── new.tsx # Agregar transacción manual │ │ │ └── settings/ │ ├── index.tsx # Menú principal de configuración │ ├── gmail.tsx # Gmail Settings (conectar/gestionar) │ ├── period.tsx # Configuración de período │ ├── notifications.tsx # Config de push + umbrales por categoría │ └── security.tsx # Biometría / PIN │ └── gmail-callback.tsx # Deep link handler para OAuth Gmail

// src/lib/api-client.ts — mismo interface que el web const apiClient = axios.create({ baseURL: process.env.EXPO_PUBLIC_API_URL, // FinPal Backend timeout: 10000, }); // Interceptor: attach JWT apiClient.interceptors.request.use(async (config) => { const token = await SecureStore.getItemAsync('accessToken'); if (token) config.headers.Authorization = `Bearer ${token}`; return config; }); // Interceptor: JWT refresh en 401 apiClient.interceptors.response.use(null, async (error) => { if (error.response?.status === 401 && !error.config._retry) { error.config._retry = true; const newToken = await refreshToken(); error.config.headers.Authorization = `Bearer ${newToken}`; return apiClient(error.config); } throw error; });

// En el app — registrar push token al iniciar sesión async function registerPushToken() { const { status } = await Notifications.requestPermissionsAsync(); if (status !== 'granted') return; const token = (await Notifications.getExpoPushTokenAsync({ projectId: Constants.expoConfig.extra.eas.projectId })).data; await apiClient.post('/notifications/push-token', { token, platform: Platform.OS }); }

// En el backend — lógica de notificación (pseudo-código) async function checkBudgetAlerts(userId, categoryId, newSpent, budgetAmount) { const pct = (newSpent / budgetAmount) * 100; const settings = await db.notificationSettings.findFirst({ userId, categoryId }); const threshold = settings?.threshold ?? 80; if (pct >= threshold && pct < 100) { await sendPush(userId, { title: `⚠️ ${categoryName}`, body: `${pct.toFixed(0)}% del presupuesto gastado` }); } else if (pct >= 100) { await sendPush(userId, { title: `🚨 ${categoryName}: Presupuesto agotado`, body: `$${newSpent} / $${budgetAmount}`, priority: 'high' }); } }

// app.json — configurar deep links { "expo": { "scheme": "finpal", // → finpal://gmail/callback "intentFilters": [{ // Android "action": "VIEW", "data": [{ "scheme": "finpal" }] }] } }

// stores/offlineQueue.ts — Zustand + MMKV const storage = new MMKV(); const useOfflineQueue = create( persist( (set, get) => ({ queue: [] as PendingTransaction[], addToQueue: (txn) => set(s => ({ queue: [...s.queue, { ...txn, _id: uuid() }] })), flush: async () => { for (const txn of get().queue) { await apiClient.post('/transactions', txn); } set({ queue: [] }); } }), { storage: createJSONStorage(() => storage) } ) );

# eas.json — perfiles de build { "build": { "development": { "developmentClient": true, "distribution": "internal" }, "preview": { "distribution": "internal" // TestFlight + Internal Track }, "production": { "autoIncrement": true // App Store + Google Play } } }