Review Form
What this screen is for
The form for leaving a review on an appointment that's already in the past. An integer rating from 1 to 5 is required; a comment up to four lines and up to three photos are optional. It opens from the "Review" button on a past appointment's card in the appointment list.
When you would use this
A customer reaches for this form when they want to say whether they were happy with an appointment they had — only for one that is already in the past, approved or completed, and only if they haven't reviewed it before.
Who sees it
Only the customer who owns the appointment can review it; a business owner can't review their own business through an appointment on it.
Where it lives
The screen exists only in the mobile app.
What you can do here
Give a rating
Tapping a star from 1 to 5 picks an integer rating; trying to submit without one is turned back with a warning.
Write a comment
An optional comment up to four lines can be entered, or left blank.
Add photos
Up to three photos are picked from the gallery and added, each removable on its own; once the limit is reached the add tile disappears.
Submit
A successful submission shows a confirmation and closes the form; if the review is refused server-side after the photos have already uploaded, those uploaded photos are deleted automatically.
What the server accepts and refuses
An appointment can only be reviewed once
The review document's id is the same as the appointment's id; a second submission for the same appointment is refused server-side.
Photos must be at most 3 https links, each uploaded into your own folder
The server checks every photo link one by one: it must start with https, resolve to a real path, and stay inside the storage folder reserved for that appointment; a link over the limit or from outside that folder gets the whole submission refused.