Skip to main content

Documentation Index

Fetch the complete documentation index at: https://mintlify.com/rtajio/ESEN/llms.txt

Use this file to discover all available pages before exploring further.

The administrator role in ESEN has full control over the system. After logging in, the admin can create, edit, disable, and delete extracurricular activities; browse the complete student roster; and generate and export reports. This guide walks through every section of the admin interface in the order you will encounter them.

Logging in

1

Open the application

Load the ESEN app in your browser. The login screen shows the ESEN logo and two role tabs: Administrador and Estudiante.
2

Select the Administrator tab

Click the Administrador tab in the login card. The Usuario field will auto-fill with admin01 and Contraseña with admin123 (demo credentials shown in the hint at the bottom of the card).
3

Sign in

Click Iniciar sesión. On success, the dashboard (Panel de control) loads and your name and username appear in the sidebar footer. If credentials are wrong, a red error banner reads “Usuario o contraseña incorrectos.”
Demo credentials are admin01 / admin123. These are hardcoded in the demo data array and are not connected to any external authentication service.

Panel de control (Dashboard)

The dashboard is the first view after login. It gives a real-time snapshot of activity data.

Stat cards

Four cards appear in a responsive grid at the top of the page:
CardIDWhat it counts
Total actividadesstat-totalActive activities only (activo: true)
Participantesstat-estUnique participant names across all activities
Horas acumuladasstat-hrsSum of horas × participantes.length for active activities
Resolucionesstat-resDistinct resolution numbers (res field) across all activities

Recent activities table

Below the cards, a card titled Actividades recientes shows up to the six most recently added activities. Columns are: Actividad, Categoría, Fecha, Horas, and Estado (Active/Inactive badge). A Ver todas button in the card header navigates directly to the Activities view.
The “Horas acumuladas” stat multiplies each activity’s hours by its participant count, so it represents total person-hours, not raw activity hours.

Actividades (Activities view)

Click Actividades in the left sidebar to open the full activities management table.

Activity table columns

ColumnDescription
ActividadActivity name in bold, with a truncated description beneath in grey
CategoríaColour-coded badge (see category reference below)
ResoluciónResolution number, e.g. RES-2024-001
FechaDate formatted as DD/MM/YYYY
HorasHour count in bold, e.g. 8h
ParticipantesCount of names in the participants array
AccionesEdit, Toggle, and Delete action buttons

Filter bar

The filter row sits above the table and contains three controls:
  • Todas las categorías — a dropdown to filter by a single category (Académico, Deportivo, Cultural, Voluntariado, Liderazgo). Selecting a value immediately re-renders the table.
  • Month picker — a <input type="month"> that filters rows where fecha starts with the selected YYYY-MM value.
  • Limpiar button — resets both filters and reloads all activities.
Both filters apply simultaneously. Selecting Académico and a month returns only academic activities in that month.

Action buttons

Each row in the Acciones column has three icon buttons:
  • Edit (pencil icon) — opens the activity modal pre-filled with that row’s data.
  • Toggle (eye / eye-off icon) — enables or disables the activity. The icon changes to eye-off when active, and back to eye when inactive. A toast notification confirms the change.
  • Delete (trash icon, red) — prompts a confirmation dialog before permanently removing the record.

Registering a new activity

1

Open the form

Click the green Registrar actividad button in the top-right of the Activities card. The modal titled Registrar actividad opens.
2

Fill in required fields

Complete the four required fields marked with an asterisk:
  • Nombre de la actividad * — free text, e.g. Taller de liderazgo estudiantil
  • Categoría * — dropdown: Académico, Deportivo, Cultural, Voluntariado, or Liderazgo
  • Horas * — positive integer
  • N° de resolución * — resolution number, e.g. RES-2024-045
  • Fecha * — date picker
3

Fill in optional fields

  • Descripción — free-text textarea (3 rows, resizable)
  • Participantes (separados por coma) — comma-separated participant names, e.g. Carlos Mamani, Lucía Torres
4

Save

Click the green Guardar button. The modal closes, the table refreshes, and a green toast at the bottom-right reads “Actividad registrada correctamente”. If any required field is empty, the toast shows ”⚠ Completa todos los campos obligatorios” and the modal stays open.
Participant names must match the names in the student roster exactly (case-sensitive) for their hours to accumulate correctly on the student profile.

Editing an activity

1

Click the edit icon

In the Acciones column for the target row, click the pencil icon button. The modal opens with the title Modificar actividad and all fields pre-filled with the activity’s current data.
2

Update fields

Edit any combination of fields. All the same required/optional rules apply as when creating.
3

Save changes

Click Guardar. The table refreshes and a toast reads “Actividad actualizada correctamente”. Click Cancelar or press Escape to close without saving.

Disabling and enabling an activity

Click the eye icon button in the Acciones column for any active activity. The activo flag is toggled immediately:
  • Active → Inactive: the icon changes to eye-off and the status badge in the dashboard recent-activities table changes from a green Activo badge to a grey Inactivo badge.
  • Inactive → Active: the icon reverts to eye and the badge returns to Activo.
A toast notification confirms “Actividad deshabilitada” or “Actividad habilitada”.
Inactive activities are excluded from the Total actividades and Horas acumuladas stat cards on the dashboard, and are hidden from the student-facing activities list.

Deleting an activity

Click the red trash icon button in the Acciones column. A browser confirmation dialog reads:
¿Eliminar esta actividad? Esta acción no se puede deshacer.
Click OK to confirm. The activity is permanently removed from the in-memory data array, the table refreshes, and a toast reads “Actividad eliminada”. Clicking Cancelar aborts with no changes.
Deletion is permanent within the session. Because ESEN is a browser-only static app with no backend persistence, all data resets on page reload.

Estudiantes (Students view)

Click Estudiantes in the sidebar to open the student roster.

Students table

The table header is Relación de estudiantes and shows five columns:
ColumnDescription
EstudianteAvatar circle (initials from first two words of name, green background) + full name + DNI in small grey text below
CódigoStudent code, e.g. 2021-0452
EscuelaSchool/faculty name, e.g. Ingeniería de Sistemas
ActividadesCount of activities in which the student’s name appears in the participantes array
Horas totalesGreen pill showing the sum of horas for all activities containing the student’s name
A search input at the top of the card filters the table in real time as you type. It matches against both the student’s name and code (case-insensitive). Clearing the input restores all students.

Reportes (Reports view)

Click Reportes in the sidebar to open the reports view.

Hours by category chart

The top-left card Horas por categoría shows a horizontal bar chart. Each of the five categories has a labelled bar whose width is proportional to the total hours across all activities in that category. The exact hour count appears to the right of each bar.

General summary

The top-right card Resumen general lists six key statistics in a row-based layout:
  • Total actividades
  • Actividades activas
  • Horas totales
  • Total participaciones
  • Promedio horas / actividad
  • Estudiantes registrados

Activity detail table

A full-width card Detalle de actividades shows all activities with columns: Actividad, Categoría, Horas, Participantes, Resolución, and Fecha.

Exporting to CSV

Click the Exportar CSV button in the detail table card header. The browser downloads a UTF-8 BOM CSV file named reporte-actividades-esen.csv with columns: Actividad, Categoría, Horas, Participantes, Resolución, Fecha, Estado. A toast confirms “Reporte exportado correctamente”.

Logging out

Click the logout icon button at the bottom of the sidebar (next to your name). The app panel hides and the login screen reappears. All in-session data changes are lost.

Build docs developers (and LLMs) love