Equipo Repository

Overview

The IRepositorioEquipo interface and RepositorioEquipo implementation provide comprehensive data access operations for managing teams. This repository includes advanced features like search by name, filtering by municipality, and managing relationships with municipalities and technical directors.

Interface Definition

IRepositorioEquipo.cs

using Torneo.App.Dominio;

namespace Torneo.App.Persistencia
{
    public interface IRepositorioEquipo
    {
        public Equipo AddEquipo(Equipo equipo, int idMunicipio, int idDT);
        public IEnumerable<Equipo> GetAllEquipos();
        public Equipo GetEquipo(int idEquipo);
        public Equipo UpdateEquipo(Equipo equipo, int idMunicipio, int idDT);
        public Equipo DeleteEquipo(int equipo);
        public IEnumerable<Equipo> GetEquiposMunicipio(int idMunicipio);
        public IEnumerable<Equipo> SearchEquipos(string nombre);
        public bool validateDuplicates(Equipo equipo);
    }
}

Implementation

RepositorioEquipo.cs

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

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

Methods Reference

AddEquipo

Adds a new team to the database with associations to municipality and technical director.

equipo

Equipo

required

The Equipo entity to add

idMunicipio

int

required

The ID of the municipality where the team is based

idDT

int

required

The ID of the technical director managing the team

return

Equipo

The inserted Equipo entity with its generated ID and populated relationships

Implementation (Lines 10-19)

public Equipo AddEquipo(Equipo equipo, int idMunicipio, int idDT)
{
    var municipioEncontrado = _dataContext.Municipios.Find(idMunicipio);
    var DTEncontrado = _dataContext.DirectoresTecnicos.Find(idDT);
    equipo.Municipio = municipioEncontrado == null ? null : municipioEncontrado;
    equipo.DirectorTecnico = DTEncontrado == null ? null : DTEncontrado;
    var equipoInsertado = _dataContext.Equipos.Add(equipo);
    _dataContext.SaveChanges();
    return equipoInsertado.Entity;
}

Key Features:

Validates municipality and technical director exist before association
Sets relationships to null if referenced entities don’t exist
Returns complete entity with relationships

Usage Example:

var nuevoEquipo = new Equipo
{
    Nombre = "Atlético Municipal"
};

var equipoCreado = repositorioEquipo.AddEquipo(nuevoEquipo, idMunicipio: 3, idDT: 5);
Console.WriteLine($"Equipo creado: {equipoCreado.Nombre} (ID: {equipoCreado.Id})");
Console.WriteLine($"Municipio: {equipoCreado.Municipio?.Nombre}");
Console.WriteLine($"DT: {equipoCreado.DirectorTecnico?.Nombre}");

GetAllEquipos

Retrieves all teams with complete relationship graph.

return

IEnumerable<Equipo>

Collection of all Equipo entities with eagerly loaded relationships

Implementation (Lines 20-35)

public IEnumerable<Equipo> GetAllEquipos()
{
    var equipos = _dataContext.Equipos
                    .Include(e => e.Municipio)
                    .Include(e => e.DirectorTecnico)
                    .Include(e => e.Jugadores)
                    .Include(e => e.PartidosLocal)
                    .Include(e => e.PartidosVisitante)
                    .AsNoTracking()
                    .ToList();
    
    return equipos;
}

Included Relationships:

Municipio - The team’s home municipality
DirectorTecnico - The team’s technical director
Jugadores - All players on the team
PartidosLocal - Matches where team plays as home team
PartidosVisitante - Matches where team plays as visiting team

Usage Example:

var todosEquipos = repositorioEquipo.GetAllEquipos();

foreach (var equipo in todosEquipos)
{
    Console.WriteLine($"Equipo: {equipo.Nombre}");
    Console.WriteLine($"  Municipio: {equipo.Municipio?.Nombre}");
    Console.WriteLine($"  DT: {equipo.DirectorTecnico?.Nombre}");
    Console.WriteLine($"  Jugadores: {equipo.Jugadores.Count()}");
    Console.WriteLine($"  Partidos como local: {equipo.PartidosLocal.Count()}");
    Console.WriteLine($"  Partidos como visitante: {equipo.PartidosVisitante.Count()}");
}

GetEquipo

Retrieves a specific team by ID with municipality and technical director relationships.

idEquipo

int

required

The ID of the team to retrieve

return

Equipo

The Equipo entity with Municipio and DirectorTecnico loaded, or null if not found

Implementation (Lines 37-45)

public Equipo GetEquipo(int idEquipo)
{
    var equipo = _dataContext.Equipos
                    .Include(e => e.Municipio)
                    .Include(e => e.DirectorTecnico)
                    .FirstOrDefault(e => e.Id == idEquipo);
    return equipo;
}

Usage Example:

var equipo = repositorioEquipo.GetEquipo(10);

if (equipo != null)
{
    Console.WriteLine($"Equipo: {equipo.Nombre}");
    Console.WriteLine($"Municipio: {equipo.Municipio?.Nombre}");
    Console.WriteLine($"Director Técnico: {equipo.DirectorTecnico?.Nombre}");
}
else
{
    Console.WriteLine("Equipo no encontrado");
}

UpdateEquipo

Updates an existing team’s information and relationships.

equipo

Equipo

required

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

idMunicipio

int

required

The ID of the new municipality (or existing)

idDT

int

required

The ID of the new technical director (or existing)

return

Equipo

The updated Equipo entity with current relationships

Implementation (Lines 47-57)

public Equipo UpdateEquipo(Equipo equipo, int idMunicipio, int idDT)
{
    var equipoEncontrado = GetEquipo(equipo.Id);
    var municipioEncontrado = _dataContext.Municipios.Find(idMunicipio);
    var DTEncontrado = _dataContext.DirectoresTecnicos.Find(idDT);
    equipoEncontrado.Nombre = equipo.Nombre;
    equipoEncontrado.Municipio = municipioEncontrado == null ? null : municipioEncontrado;
    equipoEncontrado.DirectorTecnico = DTEncontrado == null ? null : DTEncontrado;
    _dataContext.SaveChanges();
    return equipoEncontrado;
}

Updated Properties:

Nombre - Team name
Municipio - Associated municipality
DirectorTecnico - Associated technical director

Usage Example:

var equipo = repositorioEquipo.GetEquipo(10);
if (equipo != null)
{
    equipo.Nombre = "Atlético Municipal FC";
    var equipoActualizado = repositorioEquipo.UpdateEquipo(equipo, idMunicipio: 3, idDT: 7);
    Console.WriteLine($"Equipo actualizado: {equipoActualizado.Nombre}");
}

DeleteEquipo

Deletes a team from the database.

idEquipo

int

required

The ID of the team to delete

return

Equipo

The deleted Equipo entity, or null if not found

Implementation (Lines 59-76)

public Equipo DeleteEquipo(int idEquipo)
{
    var equipoEncontrado = GetEquipo(idEquipo);
    if (equipoEncontrado != null)
    {
        _dataContext.Equipos.Remove(equipoEncontrado);
        _dataContext.SaveChanges();
    }
    else
    {
        Console.WriteLine("No se encontró el equipo");
    }
    return equipoEncontrado;
}

Deleting a team may fail if:

The team has associated players (foreign key constraint)
The team is referenced in matches (foreign key constraint)

All foreign keys are configured with DeleteBehavior.Restrict.

Usage Example:

var equipoEliminado = repositorioEquipo.DeleteEquipo(10);

if (equipoEliminado != null)
{
    Console.WriteLine($"Equipo eliminado: {equipoEliminado.Nombre}");
}
else
{
    Console.WriteLine("No se pudo eliminar el equipo");
}

GetEquiposMunicipio

Retrieves all teams belonging to a specific municipality.

idMunicipio

int

required

The ID of the municipality

return

IEnumerable<Equipo>

Collection of Equipo entities from the specified municipality with full relationships

Implementation (Lines 78-91)

public IEnumerable<Equipo> GetEquiposMunicipio(int idMunicipio)
{
    var municipioEncontrado = _dataContext.Municipios.Find(idMunicipio);
    var equipos = _dataContext.Equipos
                .Where(e => e.Municipio == municipioEncontrado)
                .Include(e => e.Municipio)
                .Include(e => e.DirectorTecnico)
                .Include(e => e.Jugadores)            // Carga explicita
                .Include(e => e.PartidosLocal)        // Carga explicita
                .Include(e => e.PartidosVisitante)    // Carga explicita
                .AsNoTracking()
                .ToList();
    return equipos;
}

Usage Example:

var equiposDeMedellín = repositorioEquipo.GetEquiposMunicipio(5);

Console.WriteLine($"Equipos en Medellín: {equiposDeMedellín.Count()}");
foreach (var equipo in equiposDeMedellín)
{
    Console.WriteLine($"  - {equipo.Nombre}");
    Console.WriteLine($"    Jugadores: {equipo.Jugadores.Count()}");
    Console.WriteLine($"    DT: {equipo.DirectorTecnico?.Nombre}");
}

SearchEquipos

Searches for teams by name using partial matching.

nombre

string

required

The search term to match against team names (case-sensitive partial match)

return

IEnumerable<Equipo>

Collection of Equipo entities whose names contain the search term

Implementation (Lines 92-102)

public IEnumerable<Equipo> SearchEquipos(string nombre)
{
    return _dataContext.Equipos
        .Include(e => e.Municipio)           // Carga explicita de la propiedad Municipio
        .Include(e => e.DirectorTecnico)     // Carga explicita de la propiedad DirectorTecnico
        .Include(e => e.Jugadores)           // Carga explicita
        .Include(e => e.PartidosLocal)       // Carga explicita
        .Include(e => e.PartidosVisitante)   // Carga explicita
        .Where(e => e.Nombre.Contains(nombre))
        .ToList();
}

Key Features:

Uses .Contains() for partial string matching
Loads complete relationship graph
Case-sensitive search

Usage Example:

// Search for teams with "Atlético" in the name
var equiposAtleticos = repositorioEquipo.SearchEquipos("Atlético");

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

// Search for teams with "FC" in the name
var equiposFC = repositorioEquipo.SearchEquipos("FC");

validateDuplicates

Validates whether a team name already exists in the database.

equipo

Equipo

required

The Equipo entity to validate

return

bool

true if a team with the same name already exists, false otherwise

Implementation (Lines 145-170)

public bool validateDuplicates(Equipo equipo)
{
    try
    {
        IEnumerable<Equipo> allEquipos = GetAllEquipos();
        bool duplicado = false;
        
        foreach(Equipo e in allEquipos)
        {
            if(e.Nombre.ToLower() == equipo.Nombre.ToLower().Trim())
            {
                duplicado = true;
            }
        }
        
        return duplicado;
    }
    catch(Exception e)
    {
        return false;
    }
}

Validation Logic:

Case-insensitive comparison using .ToLower()
Trims whitespace from input
Returns false on any exception

This validation does NOT exclude the current entity when updating (unlike DirectorTecnico validation). Any team with a matching name will be flagged as duplicate.

Usage Example:

var nuevoEquipo = new Equipo
{
    Nombre = "Atlético Municipal"
};

if (repositorioEquipo.validateDuplicates(nuevoEquipo))
{
    Console.WriteLine("Error: Ya existe un equipo con este nombre");
}
else
{
    repositorioEquipo.AddEquipo(nuevoEquipo, idMunicipio: 3, idDT: 5);
    Console.WriteLine("Equipo creado exitosamente");
}

Dependency Injection

Program.cs (Line 18)

builder.Services.AddSingleton<IRepositorioEquipo, RepositorioEquipo>();

Inject into controllers:

public class EquipoController : Controller
{
    private readonly IRepositorioEquipo _repositorioEquipo;
    private readonly IRepositorioMunicipio _repositorioMunicipio;
    private readonly IRepositorioDT _repositorioDT;
    
    public EquipoController(
        IRepositorioEquipo repositorioEquipo,
        IRepositorioMunicipio repositorioMunicipio,
        IRepositorioDT repositorioDT)
    {
        _repositorioEquipo = repositorioEquipo;
        _repositorioMunicipio = repositorioMunicipio;
        _repositorioDT = repositorioDT;
    }
}

Common Workflows

Creating a Team with Relationships

// 1. Create team entity
var equipo = new Equipo { Nombre = "Atlético Municipal" };

// 2. Validate duplicates
if (!repositorioEquipo.validateDuplicates(equipo))
{
    // 3. Add with municipality and technical director
    var resultado = repositorioEquipo.AddEquipo(
        equipo,
        idMunicipio: 3,
        idDT: 5
    );
    
    Console.WriteLine($"Equipo creado: {resultado.Nombre}");
    Console.WriteLine($"  Municipio: {resultado.Municipio?.Nombre}");
    Console.WriteLine($"  DT: {resultado.DirectorTecnico?.Nombre}");
}

Searching and Filtering Teams

// Search by name
var equiposBuscados = repositorioEquipo.SearchEquipos("Atlético");

// Filter by municipality
var equiposMedellín = repositorioEquipo.GetEquiposMunicipio(5);

// Get all teams
var todosEquipos = repositorioEquipo.GetAllEquipos();

// Filter in memory (if needed)
var equiposConMasDe20Jugadores = todosEquipos
    .Where(e => e.Jugadores.Count() > 20)
    .ToList();

Updating Team Relationships

// 1. Get existing team
var equipo = repositorioEquipo.GetEquipo(10);

if (equipo != null)
{
    // 2. Change technical director
    var equipoActualizado = repositorioEquipo.UpdateEquipo(
        equipo,
        idMunicipio: equipo.Municipio.Id,  // Keep same municipality
        idDT: 8                              // New technical director
    );
    
    Console.WriteLine($"Nuevo DT: {equipoActualizado.DirectorTecnico?.Nombre}");
}

Getting Team Statistics

var equipo = repositorioEquipo.GetEquipo(10);

if (equipo != null)
{
    // GetAllEquipos includes all relationships
    var equipoCompleto = repositorioEquipo.GetAllEquipos()
        .FirstOrDefault(e => e.Id == 10);
    
    Console.WriteLine($"Equipo: {equipoCompleto.Nombre}");
    Console.WriteLine($"Total jugadores: {equipoCompleto.Jugadores.Count()}");
    Console.WriteLine($"Partidos jugados: {equipoCompleto.PartidosLocal.Count() + equipoCompleto.PartidosVisitante.Count()}");
    Console.WriteLine($"Partidos en casa: {equipoCompleto.PartidosLocal.Count()}");
    Console.WriteLine($"Partidos de visitante: {equipoCompleto.PartidosVisitante.Count()}");
}

Equipo Entity

Domain model for teams

Municipio Repository

Municipality data access

DirectorTecnico Repository

Technical director data access

Jugador Repository

Player data access

Partido Repository

Match data access

Performance Considerations

Optimization Tips:

GetAllEquipos() loads complete relationship graph - use GetEquipo() for single entities
SearchEquipos() performs case-sensitive search - consider adding case-insensitive variant
validateDuplicates() loads all teams - consider indexed query for production
All read operations use .AsNoTracking() for better performance

Domain Models

Repositories

Data Layer

Overview

Interface Definition

Implementation

Methods Reference

AddEquipo

GetAllEquipos

GetEquipo

UpdateEquipo

DeleteEquipo

GetEquiposMunicipio

SearchEquipos

validateDuplicates

Dependency Injection

Common Workflows

Equipo Entity

Municipio Repository

DirectorTecnico Repository

Jugador Repository

Partido Repository

Performance Considerations

Build docs developers (and LLMs) love

Domain Models

Repositories

Data Layer

​Overview

​Interface Definition

​Implementation

​Methods Reference

​AddEquipo

​GetAllEquipos

​GetEquipo

​UpdateEquipo

​DeleteEquipo

​GetEquiposMunicipio

​SearchEquipos

​validateDuplicates

​Dependency Injection

​Common Workflows

​Related Entities

Equipo Entity

Municipio Repository

DirectorTecnico Repository

Jugador Repository

Partido Repository

​Performance Considerations

Build docs developers (and LLMs) love

Overview

Interface Definition

Implementation

Methods Reference

AddEquipo

GetAllEquipos

GetEquipo

UpdateEquipo

DeleteEquipo

GetEquiposMunicipio

SearchEquipos

validateDuplicates

Dependency Injection

Common Workflows

Related Entities

Performance Considerations