post:
  operationId: getDashboardWeatherForecast
  summary: Get station weather and PV forecast
  description: |
    Release 1: **US-82**. Requires a POST_LOGIN JWT.

    Returns forecast days for the selected station, including weather
    conditions and estimated PV generation.
  tags: [webDashboard]
  security:
    - bearerAuth: []
  requestBody:
    required: true
    content:
      application/json:
        schema:
          $ref: "../../components.yaml#/components/schemas/DashboardWeatherRequest"
        example:
          station_id: "665f0c2df1a2b3c4d5e6f789"
          timezone: "Asia/Ho_Chi_Minh"
  responses:
    "200":
      description: Weather forecast returned directly.
      content:
        application/json:
          schema:
            $ref: "../../components.yaml#/components/schemas/DashboardWeatherResponse"
    "400":
      $ref: "../../components.yaml#/components/responses/Failure"