> For the complete documentation index, see [llms.txt](https://docs.physiqo.in/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.physiqo.in/04-product/prd-6.md).

# Reviews

## Reviews Module

***

## 1. Purpose

The Reviews Module enables patients to share feedback after completing a physiotherapy appointment.

The module helps build trust, improve service quality and assist future patients in making informed decisions.

Only verified appointments are eligible for reviews.

***

## 2. Business Objectives

The Reviews Module shall:

* Increase patient trust.
* Improve service quality.
* Collect genuine feedback.
* Identify top-performing physiotherapists.
* Detect service issues.
* Support continuous platform improvement.

***

## 3. Eligibility Rules

A review may be submitted only when:

* Appointment status is "Treatment Completed".
* Payment has been completed.
* The patient has not already submitted a review for the same booking.

Each completed booking shall allow only one review.

***

## 4. Review Workflow

1. Treatment Completed
2. Review Request Sent
3. Patient Opens Review Screen
4. Rating Selected
5. Comment Submitted (Optional)
6. Review Saved
7. Rating Updated

```mermaid
flowchart TD

A[Treatment Completed]

A --> B[Review Request]

B --> C[Open Review]

C --> D[Give Rating]

D --> E[Write Comment]

E --> F[Submit]

F --> G[Review Saved]

G --> H[Physio Rating Updated]
```

***

## 5. Rating System

Patients shall provide an overall rating using a five-star scale.

Supported Ratings

* 1 Star
* 2 Stars
* 3 Stars
* 4 Stars
* 5 Stars

Comments shall remain optional.

***

## 6. Review Moderation

The platform reserves the right to review submitted feedback.

Reviews containing any of the following may be removed:

* Offensive Language
* Abuse
* Spam
* Personal Attacks
* Illegal Content
* Irrelevant Content

The platform shall not modify genuine user opinions.

***

## 7. Business Rules

* One review per completed booking.
* Reviews cannot be submitted before treatment completion.
* Deleted reviews shall be retained internally for audit purposes.
* Rating updates shall automatically recalculate physiotherapist averages.

***

## 8. Backend Mapping

Controllers

* ReviewController

Services

* ReviewService

Repositories

* ReviewRepository

Entities

* Review
* Booking
* Physio

***

## 9. Future Enhancements

* Photo Reviews
* Video Reviews
* AI Sentiment Analysis
* Verified Review Badge
* Review Helpfulness Voting

***

## Related Documents

* Booking PRD
* Patient Dashboard PRD
* Business Rules
* User Journey

***

Status

Draft


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.physiqo.in/04-product/prd-6.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.