Ratings & reviews
Dashboard: every screen, state and flow in Ratings & reviews.
10 screens and overlays, 34 states, 1 flows. Frames show a real screenshot where one was captured and a wireframe card where the state needs data or conditions a device run cannot produce.
Flows
Review moderation
Ratings & Reviews
Moderation toasts
Approved, rejected, featured, deleted, bulk server message
Needs data: Needs specific backend rows, a role, or a submitted write on a disposable record
Branches and edge cases
Moderate Review
Flag or pending needs admin
Uses bulkModerate, admin on server
Needs data: Needs specific backend rows, a role, or a submitted write on a disposable record
Delete review
Dashboard role refused
bulkDeleteComments needs admin, error toast
Needs data: Needs specific backend rows, a role, or a submitted write on a disposable record
User Reports
Report resolved
Toasts: Report marked as reviewed, Report dismissed
Needs data: Needs specific backend rows, a role, or a submitted write on a disposable record
Ratings & Reviews
Permission denied
AccessDenied: You need permission to view ratings
Needs data: Needs specific backend rows, a role, or a submitted write on a disposable record
Flow diagram
Screens and states
Ratings & Reviews
dashboard/ratingsRatings & Reviews
Moderate all product reviews and comments.
src/app/dashboard/ratings/page.tsxEntry
- Sidebar Reviews & Moderation
Exits
- Row menu Details, Approve, Reject, Flag
- Feature or Unfeature
- Delete → confirm
- Export → ExportDialog
- Bulk bar
States · 7
src/features/ratings/components/ratings-page-content.tsxsrc/features/ratings/components/ratings-page-content.tsx:196src/features/ratings/components/rating-table.tsx:74src/app/dashboard/ratings/page.tsx:66src/features/ratings/components/ratings-page-content.tsxsrc/features/ratings/components/rating-columns.tsx:194src/app/dashboard/ratings/page.tsxModerate Review
RatingModerationDialogModerate Review
Set a status with a reason.
src/features/ratings/components/rating-moderation-dialog.tsx:66Entry
- Row Approve, Reject, Flag
- Detail dialog Moderate
Exits
- Confirm → moderate
- Cancel
States · 2
src/features/ratings/components/rating-moderation-dialog.tsx:160packages/backend/convex/productEngagement/mutations.ts:971Captured states
Review Details
RatingDetailDialogReview Details
Read-only review with Moderate, Feature, Delete.
src/features/ratings/components/rating-detail-view.tsx:73Entry
- Row View Details
- Reports View Review
Exits
- Moderate
- Feature
- Delete
- Close
Delete review
DeleteReviewDialogDelete review
Confirm deleting a review.
src/features/ratings/components/rating-columns.tsxEntry
- Row, detail dialog, review page Delete
Exits
- Confirm → delete
- Cancel
States · 1
packages/backend/convex/productEngagement/adminMutations.ts:41Bulk Moderate and Delete Reviews
RatingBulkDialogsBulk Moderate and Delete Reviews
Bulk moderate or delete selected reviews.
src/features/ratings/components/rating-bulk-actions.tsx:154Entry
- Selection bar buttons
Exits
- Confirm → bulk action
- Clear
States · 2
src/features/ratings/components/rating-bulk-actions.tsx:141packages/backend/convex/productEngagement/mutations.ts:971Captured states
Pending Reviews
dashboard/ratings/pendingPending Reviews
Queue of reviews awaiting moderation.
src/app/dashboard/ratings/pending/page.tsxEntry
- Sidebar Pending Reviews (admin)
Exits
- Same actions as Reviews
States · 4
src/app/dashboard/ratings/pending/page.tsxsrc/app/dashboard/ratings/pending/page.tsxsrc/app/dashboard/ratings/pending/page.tsxsrc/app/dashboard/ratings/pending/page.tsxFlagged Reviews
dashboard/ratings/flaggedFlagged Reviews
Queue of flagged reviews.
src/app/dashboard/ratings/flagged/page.tsxEntry
- Sidebar Flagged Reviews (admin)
Exits
- Same actions as Reviews
States · 4
src/app/dashboard/ratings/flagged/page.tsxsrc/app/dashboard/ratings/flagged/page.tsxsrc/app/dashboard/ratings/flagged/page.tsxsrc/app/dashboard/ratings/flagged/page.tsxUser Reports
dashboard/ratings/reportsUser Reports
Review user-submitted reports about reviews.
src/app/dashboard/ratings/reports/page.tsxEntry
- Sidebar User Reports (admin)
Exits
- View Review → Review Details dialog
- Mark reviewed
- Dismiss
States · 7
src/app/dashboard/ratings/reports/page.tsxsrc/app/dashboard/ratings/reports/page.tsxsrc/app/dashboard/ratings/reports/page.tsxsrc/app/dashboard/ratings/reports/page.tsx:130src/app/dashboard/ratings/reports/report-columns.tsx:58src/app/dashboard/ratings/reports/report-columns.tsx:41src/app/dashboard/ratings/reports/page.tsxCaptured states
User Blocks
dashboard/ratings/blockedUser Blocks
Read-only list of user-to-user blocks.
src/app/dashboard/ratings/blocked/page.tsxEntry
- Sidebar User Blocks (admin)
Exits
- None, no row actions
States · 4
src/app/dashboard/ratings/blocked/page.tsxsrc/app/dashboard/ratings/blocked/page.tsxsrc/app/dashboard/ratings/blocked/page.tsxsrc/app/dashboard/ratings/blocked/page.tsxReview detail page
dashboard/ratings/[id]Review detail page
Full-page review detail with Moderate, Feature, Delete.
src/app/dashboard/ratings/[id]/page.tsxEntry
- None found, URL only
Exits
- Back → /dashboard/ratings
- Delete → list on success
States · 3
src/app/dashboard/ratings/[id]/page.tsx:112src/app/dashboard/ratings/[id]/page.tsx:115src/app/dashboard/ratings/[id]/page.tsx