Release centrado en persistencia WebSocket, capa de Repositorio genérico, BLoC reactivo por documento y utilidades transversales para concurrencia/semántica de void.

✅ Added

• Stack WS Database (end-to-end)
  • GatewayWsDatabaseImpl (ref-count por docId, multiplexing con BlocGeneral, detachWatch/releaseDoc/dispose).
  • RepositoryWsDatabaseImpl<T extends Model> (mapeo fromJson/toJson, opcional serialización de write/delete por docId).
  • Usecases CRUD & WS:
    • databases_crud_usecases.dart
    • facade_crud_database.dart
    • facade_ws_database_usecases.dart
  • Estado y config:
    • ws_db_state.dart (estado inmutable WsDbState<T>)
    • ws_db_config.dart (valores por defecto / helpers)
  • BLoC:
    • bloc_ws_database.dart (orquestación thin; sin streams ad-hoc; mira/actualiza WsDbState)
• Infra fake para desarrollo/pruebas
  • fake_service_ws_database.dart con documentStream/collectionStream, lectura/escritura y borrado por colección+id.
  • ws_database_user_demo_page.dart (example) con ticker opcional que incrementa jwt.countRef en vivo.
  • home_page.dart (example) como entrada de demo.
• Utilidades transversales
  • Unit (tipo “valor nulo” seguro para Either y comandos sin payload).
  • PerKeyFifoExecutor<K> (ejecutor FIFO por clave para serializar tareas por docId).
• Tests
  • bloc_ws_database_test.dart
  • gateway_ws_database_impl.test.dart
  • repository_ws_database_impl.test.dart
  • fake_service_ws_database.test.dart
  • per_key_fifo_executor_test.dart
  • unit_test.dart
  • fake_db_repo.dart (mocks & fakes auxiliares)

🔄 Changed

• Contratos de gateway/repositorio document-centricos y transport-agnostic:
  • GatewayWsDatabase: énfasis en watch por documento con canal compartido y manejo explícito de ciclo de vida (detachWatch/releaseDoc).
  • RepositoryWsDatabase<T>: agrega helpers de ciclo de vida y opción de serializar escrituras por docId.
• Mapeo de errores unificado mediante DefaultErrorMapper en todas las capas.

🩹 Fixed

• Posibles leaks de suscripción cuando varios watchers observaban el mismo docId: ahora se hace ref-count y se libera la suscripción real al llegar a cero referencias.

🧭 Migration notes

• Si usas watch(docId), después de cancelar tu StreamSubscription llama siempre a detachWatch(docId) para liberar el canal subyacente.
• Para comandos sin retorno, retorna Right(unit) en lugar de void.
• Para evitar carreras al escribir/borrar la misma entidad, usa el RepositoryWsDatabaseImpl con serializeWrites: true o el utilitario PerKeyFifoExecutor.

📚 Docs

• README actualizado con:
  • “Cómo integrar BlocWsDatabase (con FakeServiceWsDatabase)”
  • Snippets dedicados de Unit y PerKeyFifoExecutor (casos de uso comunes).

Fixed #

• Correcciones menores y ajustes en la implementación de GatewayAuth y RepositoryAuth para mejorar la compatibilidad y robustez.
• Documentación actualizada y ampliada en los nuevos archivos y clases agregadas.
• Se resolvieron advertencias y errores menores detectados en pruebas unitarias y análisis estático.

Actualización cambios de master

• Agregamos la clase BlocResponsive, BlocOnboarding y BlocLoading para mejorar la gestión de estados en aplicaciones con diferentes resoluciones y pantallas.

• Corregido error de formateo en changelog al agregar la versión 1.21.1 (error de formato en el encabezado de la versión).

• Revisados y resueltos los TODO pendientes en el código.
• Sincronizada la rama develop con master.
• Corregido el error de análisis estático (“Angle brackets will be interpreted as HTML”) en el comentario de fake_service_preferences.dart (ajuste de espacios en Map<String, dynamic>).

• Se crea la clase FakeServiceHttp para simular el comportamiento de un servicio HTTP en pruebas unitarias.
• Se actualiza el readme para incluir ejemplos de uso de las clases FakeServiceHttp, FakeServiceSesion, FakeServiceWsDatabase, FakeServiceGeolocation, FakeServiceGyroscope, FakeServiceNotifications, FakeServiceConnectivity y FakeServicePreferences.

• Se crea la clase FakeServiceSesion para simular el comportamiento de un servicio de sesión en pruebas unitarias.
• Se crea la clase FakeServiceWsDatabase para simular el comportamiento de un servicio de base de datos WebSocket en pruebas unitarias.
• Se crea la clase FakeServiceGeolocation para simular el comportamiento de un servicio de geolocalización en pruebas unitarias.
• Se crea la clase FakeServiceGyroscope para simular el comportamiento de un servicio de giroscopio en pruebas unitarias.
• Se crea la clase FakeServiceNotifications para simular el comportamiento de un servicio de notificaciones en pruebas unitarias.
• Se crea la clase FakeServiceConnectivity para simular el comportamiento de un servicio de conectividad en pruebas unitarias.
• Se crea la clase FakeServicePreferences para simular el comportamiento de un servicio de preferencias en pruebas unitarias.

Fixed #

• Se documenta y agrega el archivo README_STRUCTURE.md con la guía recomendada de estructura de carpetas y arquitectura para proyectos basados en jocaagura_domain.

Changed #

• Documentación ampliada y mejorada para las clases BlocGeneral y BlocModule, incluyendo ejemplos de uso detallados en DartDoc y explicaciones sobre la gestión de listeners y el ciclo de vida de los BLoC.

Added #

• Nueva clase LedgerModel que representa un libro contable con ingresos y egresos separados, y permite el cálculo de saldo total y decimal.
• Enum LedgerEnum para mantener uniformidad en las claves JSON utilizadas por LedgerModel.
• Funcionalidades en MoneyUtils para:
  • totalAmount, totalDecimalAmount
  • average, filterByCategory
  • totalPerCategory, totalDecimalPerCategory
• Métodos adicionales útiles como:
  • getLatestMovement, containsMovement
  • sortByDate, filterByDateRange
  • totalByMonth, totalDecimalByMonth

Added (Tests) #

• Pruebas unitarias para LedgerModel: serialización, igualdad, cálculo de saldos y copyWith.
• Pruebas unitarias para MoneyUtils: validaciones de agregación, filtros y agrupaciones por categoría y mes.

Changed #

• Documentación enriquecida con ejemplos de uso en DartDoc para MoneyUtils.

chore(github): reestructura develop desde master y actualiza workflows

Added #

• Nueva estructura estándar de errores:
  • HttpErrorItems: Manejo de errores HTTP comunes como 404, 401, 500, con niveles de severidad (danger, severe, warning, systemInfo).
  • WebSocketErrorItems: Representación de errores típicos de WebSocket como fallos de conexión, cierre inesperado o mensajes malformados.
  • NetworkErrorItems: Para errores como sin conexión, timeout o servidor inaccesible.
• Inclusión de métodos estáticos fromCode() y fromStatusCode() en las clases anteriores.
• Clave estandarizada meta['source'] y validadores para meta['httpCode'] y similares.

Updated #

• ErrorItem ahora soporta un campo errorLevel de tipo ErrorLevelEnum.
  • El valor por defecto es ErrorLevelEnum.systemInfo para obligar a definirlo explícitamente.
  • Se agregó toString() actualizado para incluir el errorLevel.
• Documentación de cada clase de error fue ampliada con enlaces a los estándares utilizados (MDN, Flutter API).

Tests #

• Se agregaron pruebas unitarias para HttpErrorItems, WebSocketErrorItems, y NetworkErrorItems incluyendo validación de errorLevel, fromCode() y fallback unknown().
• Se probaron los casos límite y el mapeo correcto desde códigos conocidos.

Docs #

• Actualizado el README.md para reflejar las nuevas capacidades de los modelos de error y sus usos sugeridos.

Updated #

• Enhanced the financial movement model to support up to 4 decimal places for mathematical precision and to prevent negative amounts at the model level.

Fixed #

• Minor patches in analysis_options.yaml to remove dependencies no longer used in the updated implementation.

Added #

• Implemented the financial movement model to manage financial transactions.

Added #

• Configured GitHub Actions secrets to securely store sensitive data required for workflows.
• Validated and updated the GitHub maintainers group to ensure proper repository access and management.

Updated #

• Enhanced the README file with updated repository details and instructions for contributors.

Fixed #

• Translation of the changelog to English.
• Completion and translation of inline documentation to English.
• Extended unit tests.
• Updated linter package.

Fixed #

• Minor changes in DartDoc formatting without affecting the code or its functionality.

Added #

• MedicalRecordModel: Added model, tests, and DartDoc documentation for the patient's state in the dentist app.

Added #

• MedicationModel: Added model, tests, and DartDoc documentation for the appointment model.

Added #

• AppointmentModel: Added model, tests, and DartDoc documentation for the appointment model.
• ContactModel: Added model, tests, and DartDoc documentation for the contact model.

Changed #

• AnimalModel: Added DartDoc documentation for the model.

Added #

• AnimalModel: Added the model to start work on the animal class.

Added #

• AcceptanceModel: Added model for legally accepting medical treatment.

Added #

• TreatmentPlanModel: Added treatment plan for the patient.

Added #

• MedicalTreatmentModel: Added model to manage treatments for patients.

Changed #

• Minor formatting fixes for dental_condition_model, dental_condition_model_test, and medical_diagnosis_model.

Added #

• DentalConditionModel: Added model and documentation for the dental condition.

Changed #

• MedicalDiagnosisModel: Added documentation for developers in the file.

Added #

• MedicalDiagnosisModel: Added model to ensure diagnostics.

Changed #

• medical_diagnosis_tab_model_test: Increased test coverage.

Changed #

• signature_model: Updated to include hashCode.

Added #

• MedicalDiagnosisTabModel: Added model for medical diagnosis collection and its unit tests.

Changed #

• Upgraded flutter_lints to version 4.0.0 in dev dependencies.

Added #

• SignatureModel: Added model for user signature with its unit tests.

Added #

• Colors: Added a color map to the UML diagram with an explanation in the README to improve visualization of the implementation state of models.

Fixed #

• UML Diagram: Updated to reflect the implementation state of models:
  • Either, Left, Right: Confirmed.
  • Model, UserModel, AttributeModel<T>: Confirmed.
  • Bloc, BlocModule, BlocGeneral<T>, BlocCore: Confirmed.
  • UI: ModelMainMenuModel confirmed.
  • Connectivity: ConnectionTypeEnum, ConnectivityModel confirmed.
  • Citizen: PersonModel under review, LegalIdModel confirmed.
  • Obituary: ObituaryModel, DeathRecordModel confirmed.
  • Shops: StoreModel confirmed.
  • Geolocation: AddressModel confirmed.

Fixed #

• version: Corrected to initialize work with new models.

Added #

• uml_diagrams: Added diagrams with more models for future work.

Fixed #

• Typing consistency adjustments in the Either class.

Added #

• ConnectivityModel class and corresponding documentation.

• Added Debouncer class.
• Added documentation in the README file.

• Added Either class.
• Approved for production.

• Added DeathRecordModel into ObituaryModel.

• Fixed fromJson factory constructor in LegalIdModel.

• Added LegalIdModel.

• Added DeathRecordModel.

• Minor fix to ObituaryModel to include vigilDate and burialDate in parameters.
• Increased unit test coverage.

• Changed officially to beta.
• Minor fix to ObituaryModel to include message in parameters.

• Added ObituaryModel.
• Minor fix to PersonModel to cover variable names properly.
• Increased PersonModel and DateUtils test coverage.

• Added DateTime-to-String utility.

• Changed attributes in Models to Map<String, AttributeModel<dynamic>>.

• Completed PersonModel with subModelClass (AttributeModel) for information.

• Completed StoreModel with formatted options.

• Added StoreModel.

• Added AddressModel.

• Added Utils class for JSON conversion management.
• Improved unit test coverage.

• Added UserModel and established some immutable conditions.

• Added initial abstract class Model.