# Gas Station Reviews — Design

**Date:** 2026-07-22  
**Status:** Approved  

## Decisions

| Topic | Choice |
|-------|--------|
| Shape | Rating 1–5 + optional comment (max 500) |
| Who | Logged-in users except station owner |
| Uniqueness | Multiple reviews per user allowed |
| Architecture | Separate `GasStationReview` collection |

## APIs

- `POST /api/v1/gas-stations/:gasStationId/reviews` — `{ rating, comment? }`
- `GET /api/v1/gas-stations/:gasStationId/reviews?page&limit` — list + `averageRating`, `totalReviews`
- `DELETE /api/v1/gas-stations/:gasStationId/reviews/:reviewId` — author only

## Rules

- Station must be registered, approved, active
- Cannot review own station
- Auth required

## Out of scope

Photos, owner reply, admin moderation, edit endpoint, Google sync