beardofedu / beardofedu/agentic-workflows-projects

[REVIEW-001] Products: Customer reviews & star ratings

Open
#20 1 comment 0 reactions 0 assignees View on GitHub
enhancement products sprint-4
Dominant language
CSS
Stars
0
Forks
0
PR merge metrics
No merged PRs in 30d

Description

## Overview
Allow customers who have purchased a product to leave a star rating and written review. Reviews are displayed on the Product Detail Page and influence the product's overall rating shown in the catalog.

## Acceptance Criteria
- [ ] Review form on PDP (#4): star rating (1–5), title, body (min 20 chars), optional photo upload (placeholder)
- [ ] `POST /api/reviews` — submit a review (requires auth + verified purchase)
- [ ] `GET /api/reviews/:productId` — returns paginated reviews sorted by helpfulness
- [ ] Aggregate rating (average + count) shown on product cards in the catalog
- [ ] Verified Purchase badge on reviews tied to an actual order
- [ ] Helpful / Not Helpful voting on each review
- [ ] Flag review for moderation
- [ ] Review moderation queue (admin only) — approve/reject before public display
- [ ] Sort options: Most Recent, Most Helpful, Highest Rating, Lowest Rating

## Depends On
- #5 AUTH-001 — reviewer must be authenticated
- #14 ORD-001 — verified purchase status requires order records

## Blocks
- #23 PERF-001 (review data adds weight — lazy loading needed)

Contributor guide

No contributing guide indexed for this repository

Assessment

This issue has not been assessed yet.

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.