Skip to main content

Documentation Index

Fetch the complete documentation index at: https://mintlify.com/JulietaEM/EdgeTimer/llms.txt

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

After an appointment reaches the realizada (completed) state, clients can leave a rating and an optional written review. Ratings serve two purposes: they give barbers direct feedback about a completed service, and they aggregate into the barber’s promedioCalificacion score, which is displayed on their profile card for all clients to see. Only clients can submit ratings, and only for appointments they personally attended.

​
When ratings become available

The “Calificar esta cita” button appears on an appointment card in the Agenda “Pasadas” tab only when all three conditions are true:
  1. The current user is a client (not a barber).
  2. The appointment’s estado is realizada.
  3. The appointment’s calificacion field is null — no rating has been submitted yet.
Once a rating is submitted, the score and review text replace the button on the card. The rating cannot be changed after submission.
Barbers viewing the same completed appointment see either the rating the client submitted (score and review text) or the message “Sin calificación recibida.” if no rating has been left yet.

​
Rating fields (CalificarCitaDto)

​
profileId
string
required
The client’s profile ID. Used to verify that the user submitting the rating is the client on the appointment.
​
puntuacion
number
required
A whole-number score from 1 to 5. In the mobile app this is picked using a row of five numbered buttons; the selected button is highlighted.
​
resena
string
An optional free-text review. Stored alongside the score and displayed on both the client’s and barber’s appointment card.

​
Submitting a rating

From the Agenda screen, open the “Pasadas” tab and find the completed appointment. Tap Calificar esta cita to open the rating modal.
1

Select a score

Tap one of the five numbered buttons to choose a score from 1 to 5. The selected button is highlighted. The default selection is 5.
2

Write an optional review

Enter free-text feedback in the review field. This step is optional — submitting without a review records only the numeric score.
3

Save the rating

Tap Guardar. The rating is posted to POST /citas/:id/calificar. On success, the modal closes and the card updates to show the submitted score and review.

​
How ratings affect the barber profile

Each submitted rating is stored on the appointment record. The barber’s promedio_calificacion field in the database is recalculated to reflect the running average across all rated appointments. The updated average is returned by GET /catalogos/barberos and GET /catalogos/barberos/:id, and is displayed on the barber’s card in the client home screen.
Clients can see the current average rating before booking. A higher promedioCalificacion helps clients choose barbers with a strong track record.

​
Client vs. barber perspective on ratings

ScenarioClient seesBarber sees
Appointment completed, not yet rated”Calificar esta cita” button”Sin calificación recibida.”
Rating submittedScore (e.g., 4/5) and review textScore (e.g., 4/5) and review text
Appointment not yet completedNo rating UINo rating UI
Ratings can only be submitted for appointments in the realizada state. Attempting to rate a confirmada, cancelada, or rechazada appointment will return an error.

Build docs developers (and LLMs) love

Get started for freeTalk to us