post:
  operationId: getDashboardGenerationComparison
  summary: Compare dashboard generation periods
  description: |
    Release 2: **US-84**. Requires a POST_LOGIN JWT.

    Compares the selected date or ISO week with the immediately preceding
    period. DATE mode returns 24 hourly points; WEEK mode returns Monday–Sunday
    daily totals. Only finalized hourly metrics are included.
  tags: [webDashboard]
  security:
    - bearerAuth: []
  requestBody:
    required: true
    content:
      application/json:
        schema:
          $ref: "../../components.yaml#/components/schemas/DashboardGenerationComparisonRequest"
        examples:
          byDate:
            summary: Compare a date with the previous date
            value:
              timezone: "America/Mexico_City"
              mode: "DATE"
              marker: "2026-08-12"
          byISOWeek:
            summary: Compare an ISO week with the previous ISO week
            value:
              timezone: "America/Mexico_City"
              mode: "WEEK"
              marker: "2026-W33"
  responses:
    "200":
      description: Dashboard generation comparison returned directly.
      content:
        application/json:
          schema:
            $ref: "../../components.yaml#/components/schemas/DashboardGenerationComparisonResponse"
    "400":
      $ref: "../../components.yaml#/components/responses/Failure"