post:
  operationId: updateClient
  summary: Update client account
  description: |
    Permission: **ADMIN, OWNER**

    Updates editable fields of an existing client account.

    Editable fields: client_type, full_name, country, state, city, district, street, house.
    Immutable fields (ignored): email, phone, username, status, 2FA status, created_at.

    **Error codes:**
    | Code     | Condition |
    |----------|-----------|
    | `110514` | Forbidden (role is not Admin or Owner) |
    | `110513` | Client not found |
    | `110515` | Invalid request data |
    | `100502` | Database query error |
  tags: [staffManagement]
  security:
    - bearerAuth: []
  requestBody:
    required: true
    content:
      application/json:
        schema:
          $ref: "../../components.yaml#/components/schemas/UpdateClientRequest"
        example:
          client_id: "6a2fd6c5be02f295860ec3fe"
          client_type: "BUSINESS"
          full_name: "John Smith"
          country: "MX"
          state: "MX|Mexico|Jalisco"
          city: "MX|Jalisco|Guadalajara"
          district: "Centro"
          street: "Juarez"
          house: "120"
  responses:
    "200":
      description: Client updated successfully.
      content:
        application/json:
          schema:
            $ref: "../../components.yaml#/components/schemas/UpdateClientResponse"
          example:
            success: true
            message: "Client account has been updated successfully."
    "400":
      $ref: "../../components.yaml#/components/responses/Failure"
    "403":
      $ref: "../../components.yaml#/components/responses/Failure"
    "404":
      $ref: "../../components.yaml#/components/responses/Failure"
    "500":
      $ref: "../../components.yaml#/components/responses/Failure"