Volver al Web CV
Desarrollo Móvil5 min de lectura

Arquitectura en capas en Flutter 3 sin librerías de estado externas: Repository, ApiResult y Dio

Cómo mantener decenas de pantallas ordenadas usando Flutter nativo, modelos serializables, WebSockets y FCM.

Experiencia acreditada · Carmen Company E.I.R.L. (Origen Club)

  • Flutter 3
  • Dart
  • Dio
  • WebSockets
  • Firebase Messaging
  • Clean Architecture

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.

auth_repository.dartdart
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));
  }
}