Clase 06 · Módulo 06
Escribir sin conexión y sincronizar
Escribir sin conexión y sincronizar
Qué logras en esta clase
Decides si tu app necesita guardar cambios sin conexión y, si es así, sabes qué piezas pedir y cómo comprobar que no pierde ni duplica datos.
- Eliges el nivel que tu app requiere, con su costo.
- Entiendes una cola de cambios y por qué necesita identificadores propios.
- Defines qué pasa cuando dos versiones chocan.
02
Leer y escribir no pesan lo mismo
Leer sin conexión es mostrar una copia. Escribir sin conexión es prometer que ese cambio llegará.
03
Primero decide si lo necesitas
| Nivel | Ejemplo | Costo |
|---|---|---|
| 1. Leer lo último conocido | Ver el menú sin señal | Bajo |
| 2. Encolar cambios simples | Marcar un favorito, enviar un formulario | Medio |
| 3. Sincronización completa | Editar registros en terreno durante horas | Alto |
Cada nivel multiplica los casos que hay que diseñar y probar. El nivel 3 puede costar más que el resto de la app. No es un defecto quedarse en el 1.
04
Señales de que sí lo necesitas
- La app se usa por diseño donde no hay señal: terreno, montaña, bodegas, subterráneos.
- Perder un registro cuesta dinero o trabajo: una inspección, una venta, una medición.
- El usuario escribe mucho antes de enviar.
Y señales de que no: la app se usa en ciudad, las acciones dependen de otros en el momento (reservar una hora, pagar) o los datos cambian tan rápido que un cambio atrasado ya no sirve.
05
La alternativa barata: bloquear bien
Para muchas apps basta con no perder lo escrito:
- El formulario se guarda como borrador en el teléfono mientras se escribe.
- Sin red, el botón «Enviar» explica por qué no está disponible.
- Al volver la señal, el usuario envía con un toque.
06
Qué es una cola de cambios
En vez de enviar el cambio al servidor y esperar, la app lo anota en una lista local y sigue. Un proceso aparte recorre esa lista y envía cada anotación cuando hay red.
El usuario ve su cambio de inmediato, marcado como pendiente. La lista vive en el disco, no en memoria: si la app se cierra antes de enviar, los cambios siguen ahí.
07
El recorrido de un cambio
Hay dos momentos delicados: entre «se envía» y «confirma» la red puede cortarse, y el servidor puede responder que no. Buena parte de esta clase trata de esos dos casos.
08
Qué lleva cada anotación
- Un identificador único, creado en el teléfono.
- La operación: crear, editar o borrar, y sobre qué.
- Los datos del cambio.
- La fecha en que el usuario lo hizo.
- Su estado: pendiente, enviando, con error; y cuántos intentos lleva.
09
Identificadores creados en el teléfono
Si el servidor asigna el identificador, un registro creado sin red no tiene nombre hasta sincronizar y no puedes asociarle nada: ni una foto, ni una nota.
La solución es generar en el teléfono un UUID, un identificador aleatorio tan largo que en la práctica no se repite. El registro nace con su nombre definitivo.
Pídele a Claude la forma vigente de generarlo en Expo y comprueba que sea aleatoria, no un contador.
10
Enviar dos veces, un solo resultado
Enviar dos veces el mismo cambio debe dejar el mismo resultado que enviarlo una.
11
Por qué se envía dos veces
El teléfono envía, el servidor guarda y la respuesta se pierde en el camino. El teléfono no sabe si llegó, así que reintenta.
Si el servidor reconoce el identificador y responde «ya lo tengo», no pasa nada. Eso se llama idempotencia, y en la base se logra con una restricción de unicidad sobre ese identificador (módulo 7).
12
Opción A: mutaciones en pausa de TanStack Query
Con la red conectada a onlineManager, una mutación lanzada sin conexión queda en pausa y se envía, en orden, al volver la señal.
Para que sobreviva al cierre de la app hacen falta tres piezas:
- Persistir la caché (clase 5).
- Declarar la función de cada mutación con
setMutationDefaultsy usarla por sumutationKey. - Llamar
resumePausedMutationsal terminar de restaurar.
13
El detalle que hace fallar la opción A
Al disco se guardan los datos de la mutación, no su función: el código no se puede guardar como texto.
Se comprueba cerrando la app con cambios pendientes y volviendo a abrirla.
14
Opción B: una cola propia en SQLite
Una tabla local de pendientes (clase 4) con las columnas de la lámina «Qué lleva cada anotación», y una función que la recorre cuando hay red.
- Ves y consultas la cola como cualquier tabla.
- Decides el orden, los reintentos y qué hacer con cada error.
- Los datos creados sin red pueden vivir en tablas locales y mostrarse con filtros.
Es más código que escribir, probar y mantener.
15
Cómo elegir
| Opción | Conviene cuando | Cuidado |
|---|---|---|
| A. Mutaciones en pausa | Pocas acciones simples, nivel 2 | Poco control sobre errores y conflictos |
| B. Cola en SQLite | Muchos registros creados sin señal | Código propio que mantener |
| C. Motor de sincronización | Nivel 3 completo | Dependencia grande; evalúa costo y vigencia |
Existen motores de sincronización hechos por terceros. No se enseñan aquí: si llegas a necesitar uno, revisa su documentación y que soporte tu versión de Expo.
16
El orden importa
No puedes enviar la foto de una visita antes que la visita.
- La cola se procesa en el orden en que se hicieron los cambios.
- Si uno falla por red, se espera; no se salta.
- En TanStack Query las mutaciones corren en paralelo; con
scopey un mismoidcorren en serie.
17
Conflictos: dos versiones del mismo dato
Ana edita la dirección de un cliente sin señal. Mientras, Luis cambia el teléfono del mismo cliente desde la oficina. Cuando Ana sincroniza, hay dos versiones.
El conflicto no es un error técnico: es una pregunta de negocio. ¿Cuál vale? Nadie puede responderla por ti, y Claude tampoco: hay que decidirlo antes de construir.
18
Cuatro formas de resolverlos
| Estrategia | Cómo funciona | Cuándo |
|---|---|---|
| Último gana | Vale el cambio que llega al final | Datos de bajo riesgo |
| Por campo | Se mezclan los campos que cada uno tocó | Registros con muchos campos |
| Preguntar | El usuario elige entre las dos versiones | Datos críticos, pocos conflictos |
| Solo agregar | Nunca se edita; se suma un registro nuevo | Mediciones, visitas, movimientos |
19
El costo escondido de «último gana»
Último gana es simple y casi siempre basta, pero alguien pierde su cambio sin enterarse.
20
Diseñar para que no haya conflictos
Lo más barato es que no ocurran:
- Registros que solo se agregan. Una inspección nueva no choca con nada.
- Un dueño por registro. Si solo su autor lo edita, no hay dos versiones.
- Borrado marcado. Se marca como borrado en vez de eliminar; un cambio atrasado no rompe nada.
- Fecha de última modificación en cada registro.
Estas decisiones van en tu modelo de datos (módulo 2).
21
Qué hora manda
El reloj de un teléfono puede estar mal: zona horaria cambiada, hora puesta a mano, batería agotada.
22
Cuando el servidor dice que no
| Falla | Ejemplo | Qué hacer |
|---|---|---|
| De red | Sin señal, tiempo agotado | Reintentar más tarde |
| Rechazo | Dato inválido, sin permiso, registro borrado | No reintentar; marcar y avisar |
| Sesión vencida | El usuario debe ingresar de nuevo | Pausar la cola, pedir ingreso, seguir |
Un rechazo reintentado no va a funcionar nunca y bloquea todo lo que viene detrás. Distinguir estos casos es lo que separa una cola confiable de una que se traba.
23
Lo que ve el usuario
- Cada registro muestra su estado: pendiente, enviando, sincronizado o con error.
- Un contador visible: «3 cambios por enviar».
- Un botón para reintentar lo que falló y el motivo en palabras simples.
- Aviso antes de cerrar sesión si hay cambios pendientes.
La regla que no se rompe: un cambio nunca desaparece en silencio. Si no se pudo enviar, el usuario lo sabe y conserva lo que escribió.
24
Las fotos van por otro carril
Un registro pesa poco; sus fotos, mucho. Se tratan aparte:
El texto llega rápido aunque la red sea mala, y las fotos suben después. Reduce su tamaño antes de guardarlas (módulo 9) y borra el archivo local solo cuando el servidor confirmó la subida.
25
Con la app cerrada no cuentes con nada
Lo confiable es sincronizar cuando la app se abre, cuando vuelve a primer plano y cuando regresa la red mientras está en uso.
Existen tareas en segundo plano, pero el sistema operativo decide cuándo corren y puede no ejecutarlas.
26
Cómo probar que no pierde ni duplica
- En modo avión, crea tres registros y edita uno.
- Cierra la app por completo y ábrela: siguen pendientes.
- Quita el modo avión: se envían y el contador llega a cero.
- Revisa el servidor: tres registros, ninguno repetido.
- Corta la red a mitad de un envío y repite el paso 4.
- Con dos teléfonos, edita el mismo registro sin red y sincroniza ambos.
27
Cómo trabajarlo con Claude Code
Las reglas se escriben antes que el código. En tu especificación (módulo 2) define:
- Qué acciones se permiten sin red y cuáles se bloquean.
- La estrategia de conflicto por cada tipo de registro.
- Qué ve el usuario en cada estado.
28
Lo que te llevas
- Escribir sin conexión es caro: sube de nivel solo si tu app lo exige.
- Una cola guarda los cambios en disco y los envía en orden.
- Identificadores creados en el teléfono y servidor idempotente evitan duplicados.
- Los conflictos son una decisión de negocio que se toma antes de construir.
- Ningún cambio desaparece sin que el usuario lo sepa.
29
Hazlo ahora
En 15 minutos, sin escribir código:
- Lista las acciones de escritura de tu app.
- Marca cada una: se bloquea sin red, se guarda como borrador o se encola.
- Para las que se encolan, elige una estrategia de conflicto de la tabla.
- Decide tu nivel (1, 2 o 3) y escribe en una frase por qué.
Agrégalo a tu especificación. Si todo quedó en «se bloquea» o «borrador», tu app no necesita cola.
Clase terminada
Sigue con la próxima.
Fuentes · revisadas el 18 de noviembre de 2026