ClientesController - Canchas Deportivas

Overview

The ClientesController handles all CRUD operations for client management in the system. It provides endpoints for listing, creating, updating, and deleting client records. Namespace: capa_presentacion.Controllers Base Route: /Clientes

Methods

ListarClientes

Retrieves a list of all clients in the system.

public ActionResult ListarClientes()

HTTP Method

GET

Route

/Clientes/ListarClientes

Returns

Type: ActionResult

Success (200): Returns a view with List<CE_Clientes> containing all clients
Error: Returns a view with an empty list and sets error message in TempData["ErrorMessage"]

Response Model

CE_Clientes {
  int IdCliente
  string Nombre
  string Telefono
  string Correo
  bool Estado
}

Error Handling

Validates ModelState before processing
Catches exceptions and stores error message in TempData
Returns empty list on error instead of throwing

Usage Example

// GET /Clientes/ListarClientes
// Returns view with list of all clients

Source

Controllers/ClientesController.cs:14

InsertarCliente (GET)

Displays the form for adding a new client.

public ActionResult InsertarCliente()

HTTP Method

GET

Route

/Clientes/InsertarCliente

Returns

Type: ActionResult Returns the view for creating a new client.

Usage Example

// GET /Clientes/InsertarCliente
// Displays the add client form

Source

Controllers/ClientesController.cs:33

InsertarClientes (POST)

Creates a new client in the system.

[HttpPost]
public ActionResult InsertarClientes(CE_Clientes cliente)

HTTP Method

POST

Route

/Clientes/InsertarClientes

Parameters

cliente

CE_Clientes

required

The client object to createProperties:

Nombre (string): Full name of the client
Telefono (string): Phone number
Correo (string): Email address
Estado (bool): Active status of the client

Returns

Type: ActionResult

Success (302): Redirects to ListarClientes action
Error (404): Invalid model state - “No se encontro el modelo”
Error (500): Exception during creation - “Error al agregar el cliente: “

Error Responses

404

StatusCodeResult

Model state is invalid

"No se encontro el modelo"

500

StatusCodeResult

Error during client creation

"Error al agregar el cliente: {error message}"

Usage Example

// POST /Clientes/InsertarClientes
// Content-Type: application/x-www-form-urlencoded

var cliente = new CE_Clientes {
    Nombre = "Juan Pérez",
    Telefono = "+1234567890",
    Correo = "[email protected]",
    Estado = true
};

// On success: Redirects to /Clientes/ListarClientes

Notes

Action method name is InsertarClientes (plural) while the route parameter is cliente (singular)
Validates model state before processing

Source

Controllers/ClientesController.cs:40

Actualizar (GET)

Retrieves a specific client for editing.

[HttpGet]
public ActionResult Actualizar(int id)

HTTP Method

GET

Route

/Clientes/Actualizar/{id}

Parameters

int

required

The unique identifier of the client to update

Returns

Type: ActionResult

Success (200): Returns view with the CE_Clientes object
Error (404): Client not found - “No se pudo actualizar el cliente con el id: “

Error Responses

404

NotFoundResult

Client with specified ID not found

"No se pudo actualizar el cliente con el id: {id}"

Usage Example

// GET /Clientes/Actualizar/10
// Returns view with client data for ID 10

Source

Controllers/ClientesController.cs:63

Actualizar (POST)

Updates an existing client.

public ActionResult Actualizar(CE_Clientes clientes)

HTTP Method

POST

Route

/Clientes/Actualizar

Parameters

clientes

CE_Clientes

required

The client object with updated informationProperties:

IdCliente (int): ID of the client to update
Nombre (string): Updated name
Telefono (string): Updated phone
Correo (string): Updated email
Estado (bool): Updated active status

Returns

Type: ActionResult

Success (302): Redirects to ListarClientes action
Error (500): Exception during update - “Error al actualizar la cancha: “

Error Responses

500

StatusCodeResult

Error during client update

"Error al actualizar la cancha: {error message}"

Usage Example

// POST /Clientes/Actualizar
// Content-Type: application/x-www-form-urlencoded

var cliente = new CE_Clientes {
    IdCliente = 10,
    Nombre = "Juan Alberto Pérez",
    Telefono = "+1234567890",
    Correo = "[email protected]",
    Estado = true
};

// On success: Redirects to /Clientes/ListarClientes

Notes

The method updates the client regardless of ModelState.IsValid status (lines 79-85)
Both validation paths lead to the same update operation
Error message references “cancha” instead of “cliente” (copy-paste from CanchasController)

Source

Controllers/ClientesController.cs:75

Eliminar

Deletes a client from the system.

public ActionResult Eliminar(int id)

HTTP Method

POST (inferred from usage pattern)

Route

/Clientes/Eliminar

Parameters

int

required

The unique identifier of the client to delete

Returns

Type: ActionResult

Success (302): Redirects to ListarClientes action
Error (500): Exception during deletion - “Error al eliminar el cliente: “

Error Responses

500

StatusCodeResult

Error during client deletion

"Error al eliminar el cliente: {error message}"

Usage Example

// POST /Clientes/Eliminar
// Form data: id=10

// On success: Redirects to /Clientes/ListarClientes

Notes

Includes try-catch error handling unlike the Canchas controller version
Returns appropriate error message to user

Source

Controllers/ClientesController.cs:99

Dependencies

Business Layer: CN_Clientes from capa_negocio
Entity Layer: CE_Clientes from capa_entidad
Framework: ASP.NET Core MVC

Error Handling Strategy

Model Validation: Checks ModelState.IsValid before processing requests
Try-Catch Blocks: Wraps operations in exception handlers
User Feedback: Uses TempData for error messages in views
Status Codes: Returns appropriate HTTP status codes (404, 500)
Graceful Degradation: Returns empty lists instead of error pages when listing fails

Known Issues

Inconsistent Naming: GET method is InsertarCliente (singular) but POST is InsertarClientes (plural)
Error Message: Update method error message references “cancha” instead of “cliente”
Missing HTTP Attribute: Eliminar method missing [HttpPost] attribute

Controllers

Entities

Business Logic

​Overview

​Methods

​ListarClientes

​HTTP Method

​Route

​Returns

​Response Model

​Error Handling

​Usage Example

​Source

​InsertarCliente (GET)

​HTTP Method

​Route

​Returns

​Usage Example

​Source

​InsertarClientes (POST)

​HTTP Method

​Route

​Parameters

​Returns

​Error Responses

​Usage Example

​Notes

​Source

​Actualizar (GET)

​HTTP Method

​Route

​Parameters

​Returns

​Error Responses

​Usage Example

​Source

​Actualizar (POST)

​HTTP Method

​Route

​Parameters

​Returns

​Error Responses

​Usage Example

​Notes

​Source

​Eliminar

​HTTP Method

​Route

​Parameters

​Returns

​Error Responses

​Usage Example

​Notes

​Source

​Dependencies

​Error Handling Strategy

​Known Issues

Build docs developers (and LLMs) love

Overview

Methods

ListarClientes

HTTP Method

Route

Returns

Response Model

Error Handling

Usage Example

Source

InsertarCliente (GET)

HTTP Method

Route

Returns

Usage Example

Source

InsertarClientes (POST)

HTTP Method

Route

Parameters

Returns

Error Responses

Usage Example

Notes

Source

Actualizar (GET)

HTTP Method

Route

Parameters

Returns

Error Responses

Usage Example

Source

Actualizar (POST)

HTTP Method

Route

Parameters

Returns

Error Responses

Usage Example

Notes

Source

Eliminar

HTTP Method

Route

Parameters

Returns

Error Responses

Usage Example

Notes

Source

Dependencies

Error Handling Strategy

Known Issues