post:
  operationId: getDashboardPerformanceHeatmap
  summary: Get dashboard performance heatmap
  description: |
    Release 2: **US-83**. Requires a POST_LOGIN JWT.

    Returns all 168 hourly cells for the current Sunday–Saturday local week.
    Valid generation values are normalized against the weekly maximum into a
    percentage and an intensity level from 0 to 10.
  tags: [webDashboard]
  security:
    - bearerAuth: []
  requestBody:
    required: true
    content:
      application/json:
        schema:
          $ref: "../../components.yaml#/components/schemas/DashboardBaseRequest"
        example:
          timezone: "America/Mexico_City"
  responses:
    "200":
      description: Dashboard performance heatmap returned directly.
      content:
        application/json:
          schema:
            $ref: "../../components.yaml#/components/schemas/DashboardPerformanceHeatmapResponse"
    "400":
      $ref: "../../components.yaml#/components/responses/Failure"