post:
  operationId: getStationDetail
  summary: Get station detail
  description: |
    Permission: **ADMIN, OWNER**

    Returns the full station profile for the page header and Information tab.

    Used on the Station Detail page (AC-61). The response drives:
    - Page title (`station_name`)
    - Header status badge and capacity badge
    - Supplier registration badge (`supplier_registered`)
    - Address section and Google Maps embed (`map_resolvable`)
    - Button visibility (`Edit Station` always enabled; `Link DTU` only when `status == "active"`)

    **Error codes:**
    | Code     | Condition |
    |----------|-----------|
    | `110501` | Unauthorized (role is not Owner or Admin) |
    | `110502` | Station not found (`station_id` does not match any document) |
    | `110503` | Invalid request (`station_id` missing or not a valid 24-char hex) |
    | `100501` | Internal server error |
  tags: [station]
  security:
    - bearerAuth: []
  requestBody:
    required: true
    content:
      application/json:
        schema:
          $ref: "../../components.yaml#/components/schemas/GetStationDetailRequest"
        example:
          station_id: "60a7f3b2c8e1d4a5f9b0e123"
  responses:
    "200":
      description: Station detail returned directly.
      content:
        application/json:
          schema:
            $ref: "../../components.yaml#/components/schemas/GetStationDetailResponse"
          example:
            station_id: "60a7f3b2c8e1d4a5f9b0e123"
            station_name: "Solar Farm North"
            client_id: "60a7f3b2c8e1d4a5f9b0e000"
            client_name: "Acme Solar Corp"
            supplier_id: "growatt"
            supplier_name: "Growatt"
            type: "residential"
            capacity_kwp: 10.50
            status: "active"
            supplier_registered: true
            supplier_station_id: "SUP-00123"
            notes: "Rooftop installation, south facing."
            address:
              country_id: "MX"
              country_name: "Mexico"
              country_flag_url: "https://cdn.example.com/flags/mx.svg"
              state_id: "MX-JAL"
              state_name: "Jalisco"
              city_id: "MX-JAL-GDL"
              city_name: "Guadalajara"
              district: "Zapopan"
              street: "Av. Patria"
              house_number: "123"
            map_resolvable: true
    "400":
      $ref: "../../components.yaml#/components/responses/Failure"
    "401":
      $ref: "../../components.yaml#/components/responses/Failure"
    "404":
      $ref: "../../components.yaml#/components/responses/Failure"
    "500":
      $ref: "../../components.yaml#/components/responses/Failure"