Lomas.Core 0.0.4-rc.25

Lomas.Core

Biblioteca de clases core reutilizables para proyectos del Municipio de Lomas de Zamora.

📋 Descripción

Lomas.Core es una biblioteca de clases que contiene componentes fundamentales y reutilizables para el desarrollo de aplicaciones dentro del ecosistema tecnológico del Municipio de Lomas de Zamora. Incluye patrones comunes, clases base, extensiones y configuraciones estándar.

🚀 Características

• Clases Base: Entidades base con propiedades comunes
• Patrones de Resultado: Implementación del patrón Result para manejo de errores
• Extensiones: Métodos de extensión útiles para tipos comunes
• Configuraciones: Configuraciones estándar reutilizables
• Validaciones: Validadores comunes para diferentes tipos de datos
• Utilidades: Funciones de utilidad general

📦 Instalación

Package Manager Console

Install-Package Lomas.Core

.NET CLI

dotnet add package Lomas.Core

PackageReference

<PackageReference Include="Lomas.Core" Version="1.0.0" />

🔧 Uso Básico

Entidad Base

using Lomas.Core.Entities;

public class Ciudadano : BaseEntity
{
    public string Nombre { get; set; }
    public string Apellido { get; set; }
    public string Dni { get; set; }
}

Patrón Result

using Lomas.Core.Common;

public Result<Ciudadano> ObtenerCiudadano(string dni)
{
    if (string.IsNullOrEmpty(dni))
        return Result<Ciudadano>.Failure("El DNI es requerido");
    
    var ciudadano = // ... lógica de búsqueda
    
    return Result<Ciudadano>.Success(ciudadano);
}

Extensiones

using Lomas.Core.Extensions;

string texto = "hola mundo";
string capitalizado = texto.ToTitleCase(); // "Hola Mundo"

🏗️ Estructura del Proyecto

Lomas.Core/
├── src/
│   ├── Common/          # Clases y patrones comunes
│   ├── Entities/        # Entidades base
│   ├── Extensions/      # Métodos de extensión
│   ├── Configurations/  # Configuraciones reutilizables
│   └── Utilities/       # Funciones de utilidad
├── tests/
│   └── Lomas.Core.Tests/
└── docs/

🔄 Versionado y Releases Automáticas

Este proyecto utiliza Semantic Versioning con releases completamente automatizadas:

📋 Flujo de Releases

Rama main (Producción)

• Cambio de versión en .csproj → Release oficial (ej: 1.2.3)
• Sin cambio de versión → Build automático (ej: 1.2.2.45)
• Se publica en NuGet automáticamente

Rama develop (Desarrollo)

• Cambio de versión en .csproj → Release Candidate (ej: 1.2.3-RC.45)
• Sin cambio de versión → Build RC automático (ej: 1.2.2.45-RC)
• NO se publica en NuGet (solo artefactos)

🎯 Para Crear un Release

1. Actualizar versión en src/Lomas.Core.csproj:

   <VersionPrefix>1.2.3</VersionPrefix>
   

2. Hacer commit y push:

   git add src/Lomas.Core.csproj
   git commit -m "chore: bump version to 1.2.3"
   git push origin main  # o develop para RC
   

3. GitHub Actions automáticamente: ✅ Detecta el cambio de versión
   ✅ Ejecuta tests
   ✅ Crea paquete NuGet
   ✅ Genera release con notas automáticas
   ✅ Publica en NuGet (solo desde main)

🤝 Contribución

1. Fork el proyecto
2. Crea una rama para tu feature (git checkout -b feature/nueva-caracteristica)
3. Commit tus cambios (git commit -am 'Agrega nueva característica')
4. Push a la rama (git push origin feature/nueva-caracteristica)
5. Abre un Pull Request

Estándares de Código

• Utilizar C# 12 y .NET 8
• Seguir las convenciones de nomenclatura de .NET
• Incluir documentación XML en clases y métodos públicos
• Agregar pruebas unitarias para nuevas funcionalidades
• Mantener cobertura de código > 80%

📋 Requisitos

• .NET 8.0 o superior
• C# 12

🧪 Pruebas

# Ejecutar todas las pruebas
dotnet test

# Ejecutar con cobertura
dotnet test --collect:"XPlat Code Coverage"

📄 Licencia

Este proyecto está licenciado bajo la Licencia MIT - ver el archivo LICENSE para más detalles.

📞 Contacto

Municipio de Lomas de Zamora

• Sitio Web: https://www.lomasdezamora.gov.ar/
• Email: sistemas@lomasdezamora.gov.ar

🔗 Enlaces Relacionados

• Documentación Completa
• Changelog
• Issues
• Releases

Desarrollado con ❤️ para el Municipio de Lomas de Zamora