Brigade Management

Overview

The Brigade Management system coordinates community service events (brigades) organized by ESP Santa Fe de Antioquia. These brigades provide free services to communities, such as plumbing repairs, water quality testing, infrastructure maintenance, and educational workshops.

Community Outreach

Brigades are a key component of ESP’s social responsibility program, bringing services directly to communities and fostering positive relationships with citizens.

User Workflows

Admin Plans Brigade

Administrators create brigade events with:

Brigade name/title
Event description and services offered
Brigade date and location
Featured image or promotional material
Author/coordinator information

Publication

Brigade is published (Statud = true) and appears on public listing at /brigadas

Citizen Discovery

Community members browse upcoming and past brigades on the public page

Event Details

Citizens access full information at /brigadas/{nameBrigade} including date, services, and location

Key Features

Event Scheduling

Schedule brigades with specific dates for community planning

Rich Descriptions

HTML content support for detailed service descriptions

Photo Gallery

Featured images to promote events and document activities

Public Access

Open listing for community awareness and participation

Data Model

Brigades use the Master entity with specific configuration:

public class Master  // Used for brigades
{
    public int Id { get; set; }                    // Primary key
    public string NameMaster { get; set; }         // Brigade title
    public string UrlMaster { get; set; }          // URL-friendly slug
    public string Description { get; set; }        // HTML description
    public string CoverPage { get; set; }          // Featured image
    public string Author { get; set; }             // Coordinator name
    public Boolean Statud { get; set; }            // Published status
    public DateTime DateBrigade { get; set; }      // Event date
    public DateTime DateCreate { get; set; }       // Record creation
    public DateTime DateUpdate { get; set; }       // Last modification
}

View Model

public class ModelViewBrigade
{
    public int Id { get; set; }
    
    [DisplayName("Nombre")]
    public string NameMaster { get; set; }         // Brigade title
    
    public string UrlMaster { get; set; }          // URL slug
    
    [DisplayName("Descripción")]
    public string Description { get; set; }        // Full content
    
    [DisplayName("Portada")]
    public string CoverPage { get; set; }          // Image path
    
    [DisplayName("Estatus")]
    public Boolean Statud { get; set; }            // Published?
    
    [DisplayName("Autor")]
    public string Author { get; set; }             // Coordinator
    
    [DisplayName("Brigada")]
    public string DateBrigade { get; set; }        // Event date (formatted)
    
    [DisplayName("Creación")]
    public string DateCreate { get; set; }         // Created date
    
    [DisplayName("Actualización")]
    public DateTime DateUpdate { get; set; }       // Updated date
}

Controller Actions

Admin Routes

List Brigades - GET /Brigades

Purpose: Display all brigades in admin dashboardAccess: SuperAdmin, AdminFeatures:

View all scheduled brigades
See brigade dates and creation dates
Access to details, edit, and delete

[Authorize(Roles = "SuperAdmin,Admin")]
public async Task<IActionResult> Index()
{
    var _brigada = from a in await _brigadeService.GetAll()
                   select new ModelViewBrigade
                   {
                       Id = a.Id,
                       NameMaster = a.NameMaster,
                       DateBrigade = a.DateBrigade.ToString("MMM dd, yyyy",
                           CultureInfo.CreateSpecificCulture("es-CO")),
                       DateCreate = a.DateCreate.ToString("MMM dd, yyyy",
                           CultureInfo.CreateSpecificCulture("es-CO"))
                   };
    return View(_brigada);
}

Create Brigade - GET/POST /Brigades/Create

Purpose: Schedule new brigade eventAccess: SuperAdmin, AdminValidation:

Checks for duplicate names
Validates brigade date
Ensures required fields are completed

[Authorize(Roles = "SuperAdmin,Admin")]
[HttpPost]
[ValidateAntiForgeryToken]
public async Task<IActionResult> Create(BrigadeCreateDto model)
{
    if (_brigadeService.DuplicaName(model.NameMaster))
    {
        ViewData["DuplicaName"] = 
            "El nombre ya ha sido utilizado, por favor cambielo";
        View(model);
    }

    if (ModelState.IsValid)
    {
        await _brigadeService.Create(model);
        return RedirectToAction(nameof(Index));
    }
    return View(model);
}

View Details (Admin) - GET /Brigades/Details/{id}

Purpose: Preview brigade in admin contextAccess: SuperAdmin, AdminFeatures:

Full brigade information
All metadata and timestamps
Edit and delete options

[Authorize(Roles = "SuperAdmin,Admin")]
public async Task<IActionResult> Details(int? id)
{
    if (id == null)
    {
        return NotFound();
    }

    var _brigade = await _brigadeService.GetById(id);
    
    if (_brigade == null)
    {
        return NotFound();
    }

    var _model = new ModelViewBrigade
    {
        Id = _brigade.Id,
        NameMaster = _brigade.NameMaster,
        UrlMaster = _brigade.UrlMaster,
        Description = _brigade.Description,
        CoverPage = _brigade.CoverPage,
        Statud = _brigade.Statud,
        Author = _brigade.Author,
        DateBrigade = _brigade.DateBrigade.ToString("MMM dd, yyyy",
            CultureInfo.CreateSpecificCulture("es-CO"))
    };

    ViewData["detail"] = true;
    return View(_model);
}

Delete Brigade - GET/POST /Brigades/Delete/{id}

Purpose: Remove brigade recordAccess: SuperAdmin, AdminUse Cases:

Brigade was cancelled
Duplicate entry correction
Outdated information cleanup

Public Routes

Browse Brigades - GET /brigadas

Purpose: Public listing of all brigadesAccess: PublicFeatures:

Shows all published brigades
Displays cover images and dates
Links to detailed information
Sorted by date (newest first)

[Route("brigadas")]
public async Task<IActionResult> BrigadesGetAll()
{
    var _brigada = from a in await _brigadeService.GetAll()
                   select new ModelViewBrigade
                   {
                       Id = a.Id,
                       NameMaster = a.NameMaster,
                       UrlMaster = a.UrlMaster,
                       Description = a.Description,
                       CoverPage = a.CoverPage,
                       DateBrigade = a.DateBrigade.ToString("MMM dd, yyyy",
                           CultureInfo.CreateSpecificCulture("es-CO")),
                       DateCreate = a.DateCreate.ToString("MMM dd, yyyy",
                           CultureInfo.CreateSpecificCulture("es-CO"))
                   };
    return View(_brigada);
}

Brigade Details - GET /brigadas/{nameBrigade}

Purpose: Display complete brigade informationAccess: PublicFeatures:

Full description with HTML formatting
Brigade date prominently displayed
Services offered
Location information
Coordinator contact
Featured photo or gallery

[Route("brigadas/{nameBrigade}")]
public async Task<IActionResult> Details(string nameBrigade)
{
    if (nameBrigade == string.Empty)
    {
        return NotFound();
    }

    var _brigade = await _brigadeService.GetById(nameBrigade);

    if (_brigade == null)
    {
        return NotFound();
    }

    var _model = new ModelViewBrigade
    {
        Id = _brigade.Id,
        NameMaster = _brigade.NameMaster,
        UrlMaster = _brigade.UrlMaster,
        Description = _brigade.Description,
        CoverPage = _brigade.CoverPage,
        Statud = _brigade.Statud,
        Author = _brigade.Author,
        DateCreate = _brigade.DateCreate.ToString("MMMM dd, yyyy",
            CultureInfo.CreateSpecificCulture("es-CO")),
        DateBrigade = _brigade.DateBrigade.ToString("MMMM dd, yyyy",
            CultureInfo.CreateSpecificCulture("es-CO"))
    };

    ViewData["detail"] = false;
    return View(_model);
}

Brigade Types

Common brigade activities organized by ESP:

Repair Brigades

Free plumbing repairs, leak fixes, and minor installations for vulnerable communities

Educational Workshops

Water conservation education, proper use of services, and bill payment information

Water Quality Testing

Community water quality assessments and home testing services

Infrastructure Inspection

Community infrastructure evaluations and maintenance recommendations

Brigade Description Structure

When creating brigade content, include:

Event Overview

Brief description of the brigade’s purpose and target community

Services Offered

Detailed list of free services available during the brigade

Date, Time & Location

Specific scheduling and venue information

What to Bring

Items or documents citizens should bring to participate

Contact Information

Coordinator name and contact for questions

Example Brigade Content

<h2>Brigada de Reparaciones - Barrio El Centro</h2>

<h3>Descripción</h3>
<p>ESP Santa Fe de Antioquia llevará servicios gratuitos de reparación de 
acueducto a las familias del Barrio El Centro. Nuestro equipo técnico 
atenderá fugas, cambios de medidores y reparaciones menores.</p>

<h3>Servicios Gratuitos</h3>
<ul>
  <li>Reparación de fugas en tuberías</li>
  <li>Cambio de empaques en llaves y grifos</li>
  <li>Revisión de medidores</li>
  <li>Asesoría sobre consumo de agua</li>
</ul>

<h3>Fecha y Lugar</h3>
<p><strong>Fecha:</strong> Sábado, 15 de Junio de 2024<br>
<strong>Hora:</strong> 8:00 AM - 2:00 PM<br>
<strong>Lugar:</strong> Parque Principal del Barrio El Centro</p>

<h3>¿Qué Traer?</h3>
<ul>
  <li>Documento de identidad</li>
  <li>Última factura de servicios públicos</li>
</ul>

<h3>Coordinador</h3>
<p>Ing. Carlos Rodríguez<br>
Celular: (310) 555-1234<br>
Email: [email protected]</p>

Data Transfer Object

public class BrigadeCreateDto
{
    [Required(ErrorMessage = "El nombre es requerido")]
    [MaxLength(200)]
    [DisplayName("Nombre de la brigada")]
    public string NameMaster { get; set; }
    
    [Required(ErrorMessage = "La descripción es requerida")]
    [AllowHtml]
    [DataType(DataType.MultilineText)]
    [DisplayName("Descripción")]
    public string Description { get; set; }
    
    [Required(ErrorMessage = "La fecha es requerida")]
    [DisplayName("Fecha de la brigada")]
    public DateTime DateBrigade { get; set; }
    
    [Required(ErrorMessage = "El autor es requerido")]
    [MaxLength(100)]
    [DisplayName("Coordinador")]
    public string Author { get; set; }
    
    [Required(ErrorMessage = "La imagen es requerida")]
    [DisplayName("Imagen promocional")]
    [ValidateExtensionImg]
    [ImageSizes]
    public IFormFile CoverPage { get; set; }
    
    [DisplayName("Publicar")]
    public Boolean Statud { get; set; }
}

Service Layer

public interface IBrigadeService
{
    Task<IEnumerable<Master>> GetAll();
    Task<Master> GetById(int? id);
    Task<Master> GetById(string urlMaster);
    Task<Master> Create(BrigadeCreateDto model);
    Task DeleteConfirmed(int id);
    bool BrigadeExists(int id);
    bool DuplicaName(string name);
}

Date Handling

Brigade dates are stored and displayed in Colombian format:

DateBrigade = a.DateBrigade.ToString("MMMM dd, yyyy",
    CultureInfo.CreateSpecificCulture("es-CO"))

Output examples:

“Junio 15, 2024”
“Diciembre 03, 2024”

Display Options

Upcoming Brigades
Past Brigades
All Brigades

Filter brigades where DateBrigade >= DateTime.NowShows events that haven’t occurred yet, helping citizens plan participation

Filter brigades where DateBrigade < DateTime.NowArchive of completed events for transparency and documentation

Status Management

Draft (Statud = false)

Brigade is planned but not announced
Only visible to administrators
Can be refined before publication

Published (Statud = true)

Publicly visible on /brigadas
Citizens can view and plan attendance
Should include complete information

Best Practices

Planning & Scheduling

Schedule brigades at least 2 weeks in advance
Choose dates that don’t conflict with major holidays
Consider weather and seasonal factors
Coordinate with local community leaders
Ensure adequate staff and materials

Communication

Publish brigade details early
Include clear, specific information
Provide multiple contact methods
Update status if plans change
Follow up with results/photos after event

Documentation

Take photos during brigades (with permission)
Record number of families served
Document services provided
Collect citizen feedback
Create follow-up blog posts

Future Enhancements

Consider adding:

Online registration for attendance tracking
Photo galleries from completed brigades
Citizen testimonials and feedback
Integration with employee assignments
Service impact metrics (families served, repairs completed)
Email notifications for upcoming brigades

Blog System - Announce brigades and share results
Employee Management - Assign coordinators
Product Catalog - Reference services offered

Get Started

Core Features

Architecture

Overview

Community Outreach

User Workflows

Key Features

Event Scheduling

Rich Descriptions

Photo Gallery

Public Access

Data Model

View Model

Controller Actions

Admin Routes

Public Routes

Brigade Types

Repair Brigades

Educational Workshops

Water Quality Testing

Infrastructure Inspection

Brigade Description Structure

Example Brigade Content

Data Transfer Object

Service Layer

Date Handling

Display Options

Status Management

Draft (Statud = false)

Published (Statud = true)

Best Practices

Future Enhancements

Build docs developers (and LLMs) love

Get Started

Core Features

Architecture

​Overview

Community Outreach

​User Workflows

​Key Features

Event Scheduling

Rich Descriptions

Photo Gallery

Public Access

​Data Model

​View Model

​Controller Actions

​Admin Routes

​Public Routes

​Brigade Types

Repair Brigades

Educational Workshops

Water Quality Testing

Infrastructure Inspection

​Brigade Description Structure

​Example Brigade Content

​Data Transfer Object

​Service Layer

​Date Handling

​Display Options

​Status Management

Draft (Statud = false)

Published (Statud = true)

​Best Practices

​Future Enhancements

​Related Features

Build docs developers (and LLMs) love

Overview

User Workflows

Key Features

Data Model

View Model

Controller Actions

Admin Routes

Public Routes

Brigade Types

Brigade Description Structure

Example Brigade Content

Data Transfer Object

Service Layer

Date Handling

Display Options

Status Management

Best Practices

Future Enhancements

Related Features