frontend fully integreated with the backend

Distribution/docs/06_sale_ride.md

@@ -64,16 +64,29 @@ When `FulfillImmediately = false`, no stock movement — order stays Pending for
 
 **Feature folder:** `Features/Payment/`
 
-### API Endpoints
+### Sales API Endpoints
 
 | Method | Route | Who | Description |
 |---|---|---|---|
-| POST | `/api/sales/{id}/payments` | Driver/Agent | Record a payment against a sale |
-| GET | `/api/sales/{id}/payments` | Any | List all payments for a sale |
+| GET | `/api/sales` | Any | List sales — supports `?rideId=`, `?page=`, `?pageSize=` query params |
+| POST | `/api/sales/{saleId:guid}/payments` | Driver/Agent | Record a payment against a sale |
+| GET | `/api/sales/{saleId:guid}/payments` | Any | List all payments for a sale |
+
+**`GET /api/sales` filter params:**
+
+| Param | Type | Description |
+|---|---|---|
+| `rideId` | `Guid?` | Filter to sales created on a specific ride |
+| `page` | `int` | Page number (default 1) |
+| `pageSize` | `int` | Items per page (default 20) |
+
+Returns `PagedResponse<SaleResponse>`: `{ page, pageSize, total, items }`.
+
+Scope rules still apply: non-global users only see sales for stores in their scope.
 
 ### Payment Creation Logic
 
-On `POST /api/sales/{id}/payments`:
+On `POST /api/sales/{saleId:guid}/payments`:
 1. Validate sale exists and is not `Cancelled`.
 2. Add `Payment` record (`FK_SaleId`, `FK_StoreId` from sale, `Amount`, `Method`, `CollectedAt`, `CollectedBy`).
 3. Sum all payments for this sale. Recalculate `Sale.PaymentStatus`: