openapi: 3.1.0
info:
  title: DailyPlay Marketing Site
  description: |
    DailyPlay is a gamification marketing platform for brands.
    This specification describes the publicly accessible pages and resources
    on the DailyPlay marketing website for AI agent navigation.
  version: 1.0.0
  contact:
    name: DailyPlay Support
    email: hello@dailyplay.ai
    url: https://dailyplay.ai/en/support
  license:
    name: Proprietary
    url: https://dailyplay.ai/en/legal/terms

servers:
  - url: https://dailyplay.ai
    description: Production

paths:
  /:
    get:
      operationId: getHomepage
      summary: DailyPlay homepage
      description: Main landing page with platform overview, game demos, pricing, and CTA.
      responses:
        "200":
          description: HTML homepage

  /en/solutions:
    get:
      operationId: getSolutionsHub
      summary: Solutions hub
      description: Browse pre-built gamification solutions for specific business challenges.
      responses:
        "200":
          description: Solutions hub page

  /en/solutions/{solutionSlug}:
    get:
      operationId: getSolution
      summary: Individual solution page
      description: Detailed view of a specific gamification solution with use cases and metrics.
      parameters:
        - name: solutionSlug
          in: path
          required: true
          schema:
            type: string
            enum:
              - qsr-wait-time-arbitrage
              - fmcg-retail-pull
              - ecom-cart-recovery
              - travel-anticipation-loop
              - fintech-education-roi
      responses:
        "200":
          description: Solution detail page

  /en/industries/{industrySlug}:
    get:
      operationId: getIndustryPage
      summary: Industry-specific gamification page
      description: Industry deep-dive with case studies, play protocols, and ROI data.
      parameters:
        - name: industrySlug
          in: path
          required: true
          schema:
            type: string
            enum:
              - ecommerce
              - hospitality
              - mobility
              - retail
              - sports-entertainment
      responses:
        "200":
          description: Industry page

  /en/support:
    get:
      operationId: getSupport
      summary: Support page
      description: Contact support, submit tickets, access help resources.
      responses:
        "200":
          description: Support page

  /en/help:
    get:
      operationId: getHelp
      summary: Help center
      description: FAQ and help articles for DailyPlay users.
      responses:
        "200":
          description: Help center page

  /llms.txt:
    get:
      operationId: getLlmsTxt
      summary: LLMs.txt index
      description: Concise machine-readable overview of DailyPlay for LLM consumption.
      responses:
        "200":
          description: Plain text LLM index file
          content:
            text/plain:
              schema:
                type: string

  /llms-full.txt:
    get:
      operationId: getLlmsFullTxt
      summary: Full LLM content
      description: Complete DailyPlay site content in Markdown for comprehensive LLM consumption.
      responses:
        "200":
          description: Full plain text LLM content file
          content:
            text/plain:
              schema:
                type: string