post:
  operationId: validateCode
  summary: Validate a TOTP / OTP code
  tags: [staffManagement]
  requestBody:
    required: true
    content:
      application/json:
        schema:
          $ref: "../../components.yaml#/components/schemas/ValidateCodeRequest"
        example:
          user_id: "usr_001"
          code: "123456"
  responses:
    "200":
      description: Validation result — DTO returned directly
      content:
        application/json:
          schema:
            $ref: "../../components.yaml#/components/schemas/ValidateCodeResponse"
          example:
            valid: true
    "400":
      $ref: "../../components.yaml#/components/responses/Failure"