Review Module Features

Features

Product review features

• customer can submit a review only for a delivered purchased product
• admin can list, inspect, approve, reject, or seed product reviews
• public product pages show approved reviews only
• mobile and public product review reads remain product-focused
• admin-seeded product reviews can use explicit fake reviewer name and profile image

Testimonial features

• admin can create, edit, hide, reorder, and delete testimonial reviews
• public storefront can fetch visible testimonials with pagination
• mobile storefront can fetch the same visible testimonials
• testimonials are not tied to product ids or customer purchase history

Intended Use

Product reviews

Use when the review should communicate:

• feedback on a specific product
• real customer sentiment after purchase
• admin-seeded social proof on a specific product
• rating evidence on the product detail page

Testimonials

Use when the content should communicate:

• trust in the store or service
• support experience
• delivery or consultation satisfaction
• broad confidence in IT Mart without pinning to a single SKU

Admin Workflow

Product reviews

1. customer submits review from authenticated mobile flow
2. review is stored as pending
3. admin reviews it
4. admin approves or rejects it
5. approved review becomes visible through public product review endpoints

Admin can also seed a review directly:

1. admin submits productId, reviewerName, optional reviewerImageUrl, rating, and optional comment
2. review is stored as an approved admin_seeded product review
3. public product review endpoints show the exact seeded persona

Testimonials

1. admin creates testimonial directly
2. admin optionally sets image, order, and visibility
3. storefront fetches only visible testimonials
4. admin can reorder or hide testimonials later by updating fields

UX Expectations

• product reviews should feel transactional and product-specific
• testimonials should feel editorial and trust-oriented
• both should support pagination and stable sort order
• both should remain easy to document and reason about independently