Skip to main content

Documentation Index

Fetch the complete documentation index at: https://mintlify.com/Nyverie/reservafacil/llms.txt

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

Every booking you make in ReservaFácil is stored in your personal reservations history. The My Reservations section gives you a full audit trail of past and upcoming bookings, a clear view of each reservation’s current status, and a one-click cancel option when plans change.

Dashboard Summary

Before diving into the full list, the main user dashboard at /dashboard shows three stat cards so you can gauge your activity at a glance:

Total Reservas

The cumulative count of every reservation you have ever made, regardless of status.

Confirmadas

How many of your reservations among the latest five have been approved by an admin and are ready to play.

Canchas Disponibles

The current number of active courts on the platform — a quick indicator of how much choice you have for your next booking.
Below the stats, a Últimas reservas list shows your five most recent bookings with court name, date, time slot, total amount, and a status badge so you can spot anything needing attention without navigating away.

Reservations Table

Navigate to /dashboard/reservas to see your complete reservation history ordered by date (most recent first). The table contains the following columns:
ColumnDescription
CanchaName of the court you booked
FechaDate of the session in DD/MM/YYYY format
HorarioTime window, e.g. 10:00 - 12:00
TotalAmount charged in soles, e.g. S/ 100
EstadoColoured status badge (see lifecycle below)
AcciónCancel button — only visible for PENDIENTE reservations

Reservation Status Lifecycle

A reservation moves through a defined set of statuses from creation to completion. Understanding this flow helps you know when you can act and when you need to contact an admin.
PENDIENTE ──► CONFIRMADA ──► COMPLETADA

    └──────────────────────► CANCELADA

PENDIENTE

Yellow badge. The reservation has been submitted and is waiting for admin review. The time slot is already blocked for other users.

CONFIRMADA

Green badge. An admin has approved the booking. Your court is reserved and ready for the scheduled date and time.

COMPLETADA

Blue badge. The session has taken place and the reservation is closed. No further changes are possible.

CANCELADA

Red badge. The reservation was cancelled — either by you while it was still PENDIENTE, or by an admin while it was PENDIENTE. The slot is freed for others.

Cancelling a Reservation

You can cancel a reservation yourself only while it is in PENDIENTE status. A Cancelar button appears in the action column of any pending row.
1

Locate the PENDIENTE reservation

Scroll through the table at /dashboard/reservas and find the booking you want to cancel. Only rows with a yellow PENDIENTE badge show the cancel button.
2

Click Cancelar

Clicking the button opens a browser confirmation dialog: “¿Cancelar esta reserva?” Confirm to proceed.
3

Status updates to CANCELADA

The CancelarReservaBtn component sends a PATCH request to the reservations API:
PATCH /api/reservas/{id}
Content-Type: application/json

{ "estado": "CANCELADA" }
The page refreshes and the row’s badge changes from yellow PENDIENTE to red CANCELADA.
Once a reservation moves to CONFIRMADA the self-cancel button is no longer shown. The admin panel only offers a 🏁 Completar action for confirmed reservations — there is no panel-level cancel button for confirmed bookings. Contact an admin if you need to discuss a confirmed reservation.

Build docs developers (and LLMs) love