25 lines
895 B
Markdown
25 lines
895 B
Markdown
# 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` |