post:
  operationId: getClientDetail
  summary: Get client detail
  description: |
    Permission: **ADMIN, OWNER**

    Returns the full client profile including linked stations.

    Used on the Client Detail page (US-18). The response drives:
    - Client profile section (name, type, email, phone, address, status, 2FA)
    - Stations section listing all linked stations with status
    - Edit button visibility

    **Error codes:**
    | Code     | Condition |
    |----------|-----------|
    | `110514` | Forbidden (role is not Admin or Owner) |
    | `110513` | Client not found |
    | `110515` | Invalid client_id format |
    | `100502` | Database query error |
  tags: [staffManagement]
  security:
    - bearerAuth: []
  requestBody:
    required: true
    content:
      application/json:
        schema:
          $ref: "../../components.yaml#/components/schemas/GetClientDetailRequest"
        example:
          client_id: "6a2fd6c5be02f295860ec3fe"
  responses:
    "200":
      description: Client detail returned directly. Stations available via getListStations with client_id.
      content:
        application/json:
          schema:
            $ref: "../../components.yaml#/components/schemas/GetClientDetailResponse"
          example:
            client_id: "6a2fd6c5be02f295860ec3fe"
            full_name: "John Smith"
            status: "active"
            client_type: "BUSINESS"
            email: "john@example.com"
            phone: "+521234567890"
            address:
              country: "Mexico"
              country_id: "MX"
              state: "MX|Mexico|Jalisco"
              city: "MX|Jalisco|Guadalajara"
              district: "Centro"
              street: "Juarez"
              house_number: "120"
            created_at: "2026-07-16T10:20:30Z"
            two_fa_status: "NOT_CONFIGURED"
    "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"