feat(ADM-018): completed feature
This commit is contained in:
25
work/artifacts/F-025/documenter.md
Normal file
25
work/artifacts/F-025/documenter.md
Normal file
@@ -0,0 +1,25 @@
|
||||
# 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`
|
||||
Reference in New Issue
Block a user