feat(ADM-018): completed feature

This commit is contained in:
chattie
2026-08-17 22:23:10 +02:00
parent cf1c69fc8b
commit d595b4871f
871 changed files with 47411 additions and 281 deletions

View 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`