openapi: 3.0.1
info:
  title: Vibe Devs Development Services API
  description: API for accessing Vibe Devs web development services, getting quotes, and project information
  version: 'v1.0.0'
  contact:
    name: Vibe Devs Support
    email: contact@vibe-devs.com
    url: https://vibe-devs.com
servers:
  - url: https://vibe-devs.com
    description: Production server

paths:
  /api/services:
    get:
      operationId: getServices
      summary: Get available web development services
      description: Retrieve a list of all available development services including pricing and features
      responses:
        '200':
          description: List of services
          content:
            application/json:
              schema:
                type: object
                properties:
                  services:
                    type: array
                    items:
                      type: object
                      properties:
                        id:
                          type: string
                          description: Service ID
                        name:
                          type: string
                          description: Service name
                        description:
                          type: string
                          description: Detailed service description
                        starting_price:
                          type: number
                          description: Starting price in USD
                        features:
                          type: array
                          items:
                            type: string
                          description: List of included features
                        delivery_time:
                          type: string
                          description: Estimated delivery time
                        category:
                          type: string
                          description: Service category
                example:
                  services:
                    - id: "web-apps"
                      name: "Modern Web Applications"
                      description: "High-performance web applications with React, Vue.js, Angular"
                      starting_price: 3000
                      features: ["Responsive design", "REST API", "Database optimization", "SEO optimized"]
                      delivery_time: "2 weeks"
                      category: "Web Development"

  /api/quote:
    post:
      operationId: requestQuote
      summary: Request a project quote
      description: Submit project details to get a personalized quote from Vibe Devs
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
                - project_type
                - email
              properties:
                project_type:
                  type: string
                  description: Type of project (web-app, mobile-app, ecommerce, api, ai-integration, devops)
                  enum: ["web-app", "mobile-app", "ecommerce", "api", "ai-integration", "devops"]
                budget_range:
                  type: string
                  description: Approximate budget range
                  enum: ["under-5k", "5k-15k", "15k-50k", "50k-100k", "100k+"]
                timeline:
                  type: string
                  description: Desired timeline
                  enum: ["asap", "1-month", "2-3-months", "3-6-months", "flexible"]
                description:
                  type: string
                  description: Project description and requirements
                  maxLength: 2000
                email:
                  type: string
                  format: email
                  description: Contact email
                company:
                  type: string
                  description: Company name (optional)
                name:
                  type: string
                  description: Contact name (optional)
      responses:
        '200':
          description: Quote request submitted successfully
          content:
            application/json:
              schema:
                type: object
                properties:
                  success:
                    type: boolean
                  message:
                    type: string
                    example: "Thank you! We'll send you a detailed quote within 24 hours."
                  quote_id:
                    type: string
                    description: Unique quote request ID
                  estimated_response_time:
                    type: string
                    example: "24 hours"
        '400':
          description: Invalid request data

  /api/portfolio:
    get:
      operationId: getPortfolio
      summary: Get portfolio projects
      description: Retrieve showcased projects and client testimonials
      responses:
        '200':
          description: Portfolio data
          content:
            application/json:
              schema:
                type: object
                properties:
                  projects:
                    type: array
                    items:
                      type: object
                      properties:
                        title:
                          type: string
                        category:
                          type: string
                        description:
                          type: string
                        technologies:
                          type: array
                          items:
                            type: string
                        client_feedback:
                          type: string
                        result_metrics:
                          type: object
                          properties:
                            performance_improvement:
                              type: string
                            user_satisfaction:
                              type: string
                example:
                  projects:
                    - title: "E-commerce Platform Redesign"
                      category: "E-commerce"
                      description: "Complete redesign of online store with 300% conversion improvement"
                      technologies: ["React", "Node.js", "PostgreSQL", "Stripe"]
                      client_feedback: "Exceptional results. Sales increased by 300% in first month."
                      result_metrics:
                        performance_improvement: "+300% conversion rate"
                        user_satisfaction: "4.9/5 stars"

  /api/contact:
    post:
      operationId: submitContact
      summary: Submit contact form
      description: General contact form submission
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
                - email
                - message
              properties:
                name:
                  type: string
                email:
                  type: string
                  format: email
                subject:
                  type: string
                message:
                  type: string
                  maxLength: 2000
      responses:
        '200':
          description: Message sent successfully
          content:
            application/json:
              schema:
                type: object
                properties:
                  success:
                    type: boolean
                  message:
                    type: string
                    example: "Thank you for contacting us! We'll respond within 24 hours."

components:
  schemas:
    Service:
      type: object
      properties:
        id:
          type: string
        name:
          type: string
        description:
          type: string
        starting_price:
          type: number
        features:
          type: array
          items:
            type: string