# API v1 (Arabic)

Base URL: `/api/v1`

## Auth
- `POST /auth/otp/request`
- `POST /auth/otp/verify`
- `POST /auth/staff/login`
- `POST /auth/staff/logout`

## Cashier
- `GET /cashier/products`
- `POST /cashier/products`
- `GET /cashier/products/{id}`
- `PUT /cashier/products/{id}`
- `DELETE /cashier/products/{id}`
- `POST /cashier/sales/sync` (idempotent via `client_uuid` per shop)

## Customer
- `GET /customer/orders`
- `POST /customer/orders`

## Error format
```json
{
  "message": "رسالة الخطأ",
  "code": "machine_code",
  "errors": {}
}
```

## Idempotent sales sync response
```json
{
  "results": [
    {
      "client_uuid": "sale-001",
      "status": "created|duplicate|rejected",
      "sale_id": 123,
      "reason": "..."
    }
  ]
}
```