Municipio Repository

Repository for managing municipality (Municipio) entities

Overview

The IRepositorioMunicipio interface and RepositorioMunicipio implementation provide data access operations for managing municipalities. Municipalities are associated with teams (Equipos) in the system.

Interface Definition

IRepositorioMunicipio.cs

using Torneo.App.Dominio;

namespace Torneo.App.Persistencia
{
    public interface IRepositorioMunicipio
    {
        public Municipio AddMunicipio(Municipio municipio);
        public IEnumerable<Municipio> GetAllMunicipios();
        public Municipio GetMunicipio(int idMunicipio);
        public Municipio UpdateMunicipio(Municipio municipio);
        public Municipio DeleteMunicipio(int idMunicipio);
        public bool validateDuplicates(Municipio nombreMunicipio);
    }
}

Implementation

RepositorioMunicipio.cs

using Microsoft.EntityFrameworkCore;
using Torneo.App.Dominio;

namespace Torneo.App.Persistencia
{
    public class RepositorioMunicipio : IRepositorioMunicipio
    {
        private DataContext _dataContext = new DataContext();
        
        // Implementation methods...
    }
}

Methods Reference

AddMunicipio

Adds a new municipality to the database.

municipio · Municipio · required

The Municipio entity to add

return · Municipio

The inserted Municipio entity with its generated ID

Implementation (Lines 8-13)

public Municipio AddMunicipio(Municipio municipio)
{
    var municipioInsertado = _dataContext.Municipios.Add(municipio);
    _dataContext.SaveChanges();
    return municipioInsertado.Entity;
}

Usage Example:

var nuevoMunicipio = new Municipio
{
    Nombre = "Medellín"
};

var municipioCreado = repositorioMunicipio.AddMunicipio(nuevoMunicipio);
Console.WriteLine($"Municipio creado: {municipioCreado.Nombre} (ID: {municipioCreado.Id})");

---

GetAllMunicipios

Retrieves all municipalities with their associated teams.

return · IEnumerable<Municipio>

Collection of all Municipio entities with eagerly loaded Equipos

Implementation (Lines 14-26)

public IEnumerable<Municipio> GetAllMunicipios()
{
    var municipios = _dataContext.Municipios
        .Include(m => m.Equipos)
        .AsNoTracking()
        .ToList();
    
    return municipios;
}

Key Features:

• Uses .Include(m => m.Equipos) to eagerly load teams
• Uses .AsNoTracking() for improved read performance
• Returns complete object graph including teams

Usage Example:

var todosMunicipios = repositorioMunicipio.GetAllMunicipios();

foreach (var municipio in todosMunicipios)
{
    Console.WriteLine($"Municipio: {municipio.Nombre}");
    Console.WriteLine($"  Equipos: {municipio.Equipos.Count()}");
    
    foreach (var equipo in municipio.Equipos)
    {
        Console.WriteLine($"    - {equipo.Nombre}");
    }
}

---

GetMunicipio

Retrieves a specific municipality by ID.

idMunicipio · int · required

The ID of the municipality to retrieve

return · Municipio

The Municipio entity, or null if not found

Implementation (Lines 27-31)

public Municipio GetMunicipio(int idMunicipio)
{
    var municipioEncontrado = _dataContext.Municipios.Find(idMunicipio);
    return municipioEncontrado == null ? null : municipioEncontrado;
}

Usage Example:

var municipio = repositorioMunicipio.GetMunicipio(5);

if (municipio != null)
{
    Console.WriteLine($"Municipio encontrado: {municipio.Nombre}");
}
else
{
    Console.WriteLine("Municipio no encontrado");
}

---

UpdateMunicipio

Updates an existing municipality’s information.

municipio · Municipio · required

The Municipio entity with updated values (must include valid Id)

return · Municipio

The updated Municipio entity

exception · Exception

Throws exception with message “Municipio not found” if the ID doesn’t exist

Implementation (Lines 32-44)

public Municipio UpdateMunicipio(Municipio municipio)
{
    var municipioEncontrado = _dataContext.Municipios.Find(municipio.Id);
    if (municipioEncontrado != null)
    {
        municipioEncontrado.Nombre = municipio.Nombre;
        _dataContext.SaveChanges();
    }
    else
    {
        Console.WriteLine("No se encontró el municipio");
    }
    return municipioEncontrado ?? throw new Exception("Municipio not found");
}

Updated Properties:

• Nombre - Municipality name

Usage Example:

var municipio = repositorioMunicipio.GetMunicipio(5);
if (municipio != null)
{
    municipio.Nombre = "Medellín - Antioquia";
    
    try
    {
        var municipioActualizado = repositorioMunicipio.UpdateMunicipio(municipio);
        Console.WriteLine($"Municipio actualizado: {municipioActualizado.Nombre}");
    }
    catch (Exception ex)
    {
        Console.WriteLine($"Error: {ex.Message}");
    }
}

---

DeleteMunicipio

Deletes a municipality from the database.

idMunicipio · int · required

The ID of the municipality to delete

return · Municipio

The deleted Municipio entity

exception · Exception

Throws exception with message “Municipio not found” if the ID doesn’t exist

Implementation (Lines 45-57)

public Municipio DeleteMunicipio(int idMunicipio)
{
    var municipioEncontrado = _dataContext.Municipios.Find(idMunicipio);
    if (municipioEncontrado != null)
    {
        _dataContext.Municipios.Remove(municipioEncontrado);
        _dataContext.SaveChanges();
    }
    else
    {
        Console.WriteLine("No se encontró el municipio");
    }
    return municipioEncontrado ?? throw new Exception("Municipio not found");
}

Deleting a municipality will fail if it has associated teams due to foreign key constraints configured with DeleteBehavior.Restrict. Remove all teams from the municipality before deleting.

Usage Example:

try
{
    var municipioEliminado = repositorioMunicipio.DeleteMunicipio(5);
    Console.WriteLine($"Municipio eliminado: {municipioEliminado.Nombre}");
}
catch (DbUpdateException)
{
    Console.WriteLine("No se puede eliminar: el municipio tiene equipos asociados");
}
catch (Exception ex)
{
    Console.WriteLine($"Error: {ex.Message}");
}

---

validateDuplicates

Validates whether a municipality name already exists in the database.

municipioIngresado · Municipio · required

The Municipio entity to validate

return · bool

true if a duplicate municipality name exists (different ID with same name), false otherwise

Implementation (Lines 59-86)

public bool validateDuplicates(Municipio municipioIngresado)
{
    try
    {
        IEnumerable<Municipio> allMunucipios = GetAllMunicipios();
        bool duplicado = false;
        
        foreach(Municipio municipio in allMunucipios)
        {
            if(municipio.Id != municipioIngresado.Id)
            {
                if(municipio.Nombre.ToLower() == municipioIngresado.Nombre.ToLower().Trim())
                {
                    duplicado = true;
                    break;
                }
            }
        }
        
        Console.WriteLine("Municipio duplicado al Crear/Editar " + municipioIngresado.Nombre + " - " + duplicado);
        return duplicado;
    }
    catch(Exception e)
    {
        Console.WriteLine("Error Validacion " + e.Message);
        return false;
    }
}

Validation Logic:

1. Case-insensitive comparison using .ToLower()
2. Trims whitespace from input
3. Excludes current municipality when updating (checks municipio.Id != municipioIngresado.Id)
4. Returns false on any exception

Usage Example:

var nuevoMunicipio = new Municipio
{
    Nombre = "Medellín"
};

if (repositorioMunicipio.validateDuplicates(nuevoMunicipio))
{
    Console.WriteLine("Error: Ya existe un municipio con este nombre");
}
else
{
    repositorioMunicipio.AddMunicipio(nuevoMunicipio);
    Console.WriteLine("Municipio creado exitosamente");
}

Dependency Injection

Register the repository in Program.cs:

Program.cs (Line 16)

builder.Services.AddSingleton<IRepositorioMunicipio, RepositorioMunicipio>();

Inject into controllers:

public class MunicipioController : Controller
{
    private readonly IRepositorioMunicipio _repositorioMunicipio;
    
    public MunicipioController(IRepositorioMunicipio repositorioMunicipio)
    {
        _repositorioMunicipio = repositorioMunicipio;
    }
}

Common Workflows

Creating a Municipality

// 1. Create entity
var municipio = new Municipio
{
    Nombre = "Medellín"
};

// 2. Validate duplicates
if (!repositorioMunicipio.validateDuplicates(municipio))
{
    // 3. Add to database
    var resultado = repositorioMunicipio.AddMunicipio(municipio);
    Console.WriteLine($"Municipio creado con ID: {resultado.Id}");
}
else
{
    Console.WriteLine("Ya existe un municipio con este nombre");
}

Updating a Municipality

// 1. Get existing entity
var municipio = repositorioMunicipio.GetMunicipio(5);

if (municipio != null)
{
    // 2. Modify properties
    municipio.Nombre = "Medellín - Antioquia";
    
    // 3. Validate duplicates
    if (!repositorioMunicipio.validateDuplicates(municipio))
    {
        // 4. Update
        try
        {
            var resultado = repositorioMunicipio.UpdateMunicipio(municipio);
            Console.WriteLine($"Actualizado: {resultado.Nombre}");
        }
        catch (Exception ex)
        {
            Console.WriteLine($"Error: {ex.Message}");
        }
    }
}

Listing Municipalities with Team Counts

var todosMunicipios = repositorioMunicipio.GetAllMunicipios();

Console.WriteLine("Municipios y sus equipos:");
Console.WriteLine("=========================\n");

foreach (var municipio in todosMunicipios.OrderBy(m => m.Nombre))
{
    Console.WriteLine($"{municipio.Nombre}");
    Console.WriteLine($"  Total equipos: {municipio.Equipos.Count()}");
    
    if (municipio.Equipos.Any())
    {
        Console.WriteLine("  Equipos:");
        foreach (var equipo in municipio.Equipos)
        {
            Console.WriteLine($"    - {equipo.Nombre}");
        }
    }
    Console.WriteLine();
}

Finding Municipalities Without Teams

var todosMunicipios = repositorioMunicipio.GetAllMunicipios();

var municipiosSinEquipos = todosMunicipios
    .Where(m => !m.Equipos.Any())
    .OrderBy(m => m.Nombre)
    .ToList();

if (municipiosSinEquipos.Any())
{
    Console.WriteLine("Municipios sin equipos:");
    foreach (var municipio in municipiosSinEquipos)
    {
        Console.WriteLine($"  - {municipio.Nombre} (ID: {municipio.Id})");
    }
}
else
{
    Console.WriteLine("Todos los municipios tienen al menos un equipo");
}

Related Entities

Municipio Entity

Domain model for municipalities

Equipo Repository

Teams associated with municipalities

Error Handling

Both UpdateMunicipio and DeleteMunicipio throw exceptions when the entity is not found. Always handle these exceptions:

try
{
    var resultado = repositorioMunicipio.UpdateMunicipio(municipio);
}
catch (Exception ex)
{
    // Handle "Municipio not found" exception
    Console.WriteLine($"Error: {ex.Message}");
}

Foreign Key Constraints

Cascade Delete Restriction:

The DataContext configures all foreign keys with DeleteBehavior.Restrict. This means:

• You cannot delete a municipality that has associated teams
• You must first remove or reassign all teams before deleting the municipality
• This prevents accidental data loss and maintains referential integrity

DataContext.cs (Lines 37-40)

foreach (var relationship in modelBuilder.Model.GetEntityTypes()
    .SelectMany(e => e.GetForeignKeys()))
{
    relationship.DeleteBehavior = DeleteBehavior.Restrict;
}

Performance Considerations

Optimization Tips:

• GetAllMunicipios() uses .AsNoTracking() for improved read performance
• validateDuplicates() calls GetAllMunicipios(), which may be inefficient for large datasets
• Consider implementing indexed queries for duplicate validation in production
• The .Include(m => m.Equipos) loads all teams - omit if not needed

Business Rules

Unique Municipality Names

Municipality names must be unique (case-insensitive). The validateDuplicates method enforces this rule before creating or updating municipalities.

Referential Integrity

Municipalities cannot be deleted if they have associated teams. This ensures data consistency and prevents orphaned team records.

Name Trimming

Municipality names are trimmed during validation to prevent duplicates caused by leading/trailing whitespace.