Por qué elegimos una arquitectura limpia basada en UI (StatefulWidget), Repositories estáticos, ApiResult sellado y Dio sin acoplar la app a librerías externas de estado reactivo.
1. Cuatro capas claras: UI → Services/Repositories → Models → Core
No toda aplicación móvil necesita cargar múltiples capas de boilerplate reactivo para estar bien estructurada. En proyectos con geolocalización, cámara, generación QR y chat 1 a 1, separar la capa de datos mediante `Repository` y `AuthenticatedClient` sobre Dio mantiene la interfaz simple y predecible.
- UI: pantallas con StatefulWidget y tokens centralizados de diseño.
- Services & Repositories: orquestación de API REST, caché en SharedPreferences y tokens en FlutterSecureStorage.
- Models: serialización tipada con json_annotation / json_serializable y resultado sellado ApiResult<T>.
2. Manejo explícito de errores con ApiResult<T> y WebSockets
Envolver las respuestas de red en un tipo sellado obliga a la UI a contemplar éxito, fallo de red o expiración de sesión JWT sin excepciones no controladas, mientras un canal WebSocket dedicado atiende mensajería en tiempo real junto a Firebase Cloud Messaging.
Future<ApiResult<MemberProfile>> fetchCurrentProfile() async {
try {
final response = await _client.get('/auth/me/');
final profile = MemberProfile.fromJson(response.data);
await _localCache.saveProfile(profile);
return ApiSuccess(profile);
} on DioException catch (error) {
return ApiFailure(mapDioFailure(error));
}
}