# Documenter — F-025 Reviews module

## Summary
Reviews module records verified-purchase reviews with moderation and aggregate ratings. Reviews are scoped to one order item per user and only published reviews appear on product listings.

## Public API notes

| Route | Access | Result |
|---|---|---|
| POST /reviews | authenticated | Creates review for an order item |
| PATCH /reviews/:id/moderate | admin | Transitions pending review to published or rejected |
| GET /reviews?productId= | public | Returns published reviews with aggregate |

## Errors
- `REVIEW_DUPLICATE` — HTTP 409
- `REVIEW_NOT_ELIGIBLE` — HTTP 403
- `REVIEW_NOT_FOUND` — HTTP 404
- `INVALID_REVIEW` — HTTP 422

## Evidence
- `work/artifacts/F-025/architect.md`
- `work/artifacts/F-025/implementer.md`
- `work/artifacts/F-025/reviewer.json`
- `work/artifacts/F-025/security.json`
- `work/artifacts/F-025/qa.json`