post:
  operationId: createClientUser
  summary: Create a client user
  description: |
    Permission: **POST_LOGIN** — any authenticated staff with a valid post-login JWT.

    - `role` is always set to `CLIENT` by the server, not taken from the request.
    - `phone` must be unique in the system.
    - After creation, the client can log in via the mobile app immediately.
  tags: [staffManagement]
  security:
    - bearerAuth: []
  requestBody:
    required: true
    content:
      application/json:
        schema:
          $ref: "../../components.yaml#/components/schemas/CreateClientUserRequest"
        example:
          full_name: "Juan Doe"
          phone: "5219981234567"
          client_type: "INDIVIDUAL"
          email: "juan.doe@example.com"
          country: "MEX"
          state: "CDMX"
          city: "Mexico City"
          district: "Benito Juarez"
          street: "Av. Insurgentes Sur"
          house: "1234"
  responses:
    "200":
      description: Client user created — DTO returned directly
      content:
        application/json:
          schema:
            $ref: "../../components.yaml#/components/schemas/CreateClientUserResponse"
          example:
            user_id: "usr_client_001"
            role: "CLIENT"
    "400":
      $ref: "../../components.yaml#/components/responses/Failure"