Jocaagura Domain

Paquete Flutter con modelos de dominio, utilidades, componentes reactivos, contratos JSON Schema y servicios fake para acelerar implementaciones consistentes dentro del ecosistema Jocaagura.

Descripción

jocaagura_domain centraliza piezas reutilizables para aplicaciones Flutter:

• modelos serializables y utilidades transversales
• BLoCs y componentes de arquitectura
• contratos JSON Schema versionados
• servicios fake para desarrollo, demos y pruebas

El objetivo del paquete es reducir duplicidad y mantener una base compartida entre aplicaciones del ecosistema.

Inicio rápido

Requisitos

• Flutter SDK compatible con sdk: >=3.2.0 <4.0.0

Instalación

dependencies:
  jocaagura_domain: ^1.39.1

Uso básico

import 'package:jocaagura_domain/jocaagura_domain.dart';

void main() {
  final user = UserModel(
    id: '001',
    displayName: 'Juan Perez',
    photoUrl: 'https://example.com/photo.jpg',
    email: 'juan.perez@example.com',
    jwt: {'token': 'abcd1234'},
  );

  print(user.toJson());

  final updatedUser = user.copyWith(email: 'juan.updated@example.com');
  print(updatedUser.toJson());
}

Mapa de documentación

Entrada principal

• Guía de estructura recomendada
• Aplicación de ejemplo
• CHANGELOG

Contratos JSON

• Contratos JSON Schema
• Schemas v1

Referencias

• Modelos y utilidades base
• Componentes avanzados y utilidades reactivas

Guías

• Recetas de integración
• Documentación HTTP
• Simulación HTTP avanzada
• Guía Store

Operación del repositorio

• Publicación y versionamiento

Módulos destacados

• Modelos: UserModel, PersonModel, StoreModel, LedgerModel, ConnectivityModel
• Utilidades: Utils, DateUtils, Unit, PerKeyFifoExecutor
• Arquitectura: BlocGeneral, BlocModule, BlocSession, BlocWsDatabase, BlocResponsive
• Contratos: doc/schemas/v1/
• Demos: example/lib/

Notas

• Los diagramas del dominio están en uml/uml_diagrams.drawio.
• El README se redujo para funcionar como puerta de entrada; la referencia extensa vive en doc/.