Skip to content

⭐ Reviews

Customers can leave reviews for locations, and staff can moderate them before they appear publicly.

Admin Reviews

✍️ Customer Submission

Authenticated customers can submit a review:

FieldDescription
locationIdWhich location to review
orderIdOptional — link to a specific order
rating⭐ 1–5 stars
commentOptional text review

Reviews are created with isApproved: false by default.

🛡️ Moderation Workflow

  1. 📝 Customer submits a review → status: unapproved
  2. 👀 Staff sees the review in the admin panel review list
  3. ✅ Staff approves or rejects the review via PATCH /api/reviews/:id
  4. 🌐 Approved reviews appear in the public list

🌍 Public Display

Approved reviews for a location are publicly accessible:

GET /api/reviews/location/:locationId

This returns only reviews where isApproved: true, ordered by most recent.

🔐 Permissions

ActionWho Can Do It
✍️ Submit reviewAuthenticated customers
👁️ View public reviewsAnyone
📋 List all reviews (including unapproved)Staff
✅ Approve/reject reviewsStaff
🗑️ Delete reviewsManager, Super Admin

📡 API

See Reviews API for the complete endpoint reference.