openapi: 3.1.0
info:
  title: MAIjin - AI Training Switzerland
  description: |
    MAIjin is a Swiss firm specialized in training and consulting in artificial intelligence.
    
    ## Main Services
    - **AI Training**: ChatGPT, Microsoft Copilot, Claude, Gemini, MidJourney
    - **AI Maturity Audit**: Complete assessment of your organization
    - **Strategic Consulting**: Personalized support for your AI transformation
    - **Technical Deployment**: Implementation of custom AI solutions
    
    ## Areas of Intervention
    Geneva, Lausanne, Vaud, Valais, Fribourg, Neuchâtel, all of French-speaking Switzerland
    
    ## Business Expertise
    Marketing, Finance, Human Resources, Sales, Legal, Management, Administrative
    
    ## Languages
    French, English, German
  version: 1.0.0
  contact:
    name: MAIjin
    url: https://maijin.ch
    email: contact@maijin.ch
    x-phone: "+41 22 566 74 60"
    x-address: "109 rue de Lyon, 1203 Geneva, Switzerland"
  license:
    name: Proprietary
    url: https://maijin.ch/legal-notice

servers:
  - url: https://maijin.ch
    description: MAIjin main website

paths:
  /en:
    get:
      operationId: getHomePage
      summary: MAIjin Home Page
      description: |
        Home page presenting MAIjin, AI training and consulting firm in French-speaking Switzerland.
        Contains presentation of services, client testimonials and case studies.
      tags:
        - Main Pages
      responses:
        '200':
          description: Home page HTML

  /en/about:
    get:
      operationId: getAboutPage
      summary: About MAIjin
      description: |
        Presentation of the MAIjin team and its mission.
        
        **Leadership Team**:
        - Jean-Baptiste Berthoux: Chief AI Officer, expert in AI and digital strategy
        - Rémi Vancayzeele: CEO, specialist in digital transformation
        - Matthieu Collas: Operating Partner, expert in operations and large enterprise deployment
        
        **Team of certified trainers** including experts in marketing, finance, HR and sales.
      tags:
        - Main Pages
      responses:
        '200':
          description: About page HTML

  /en/case-studies:
    get:
      operationId: getCaseStudies
      summary: Client Case Studies
      description: |
        Discover our detailed case studies with reference clients:
        - Shiseido EMEA: AI transformation of marketing strategy
        - RTS (Swiss Radio Television): Optimization of editorial processes
        - State of Fribourg: Modernization of public services
        - BCV (Cantonal Bank of Vaud): Innovation in financial services
        - Manotel: Operational excellence in hospitality
      tags:
        - Main Pages
      responses:
        '200':
          description: Case studies list HTML

  /en/services/formation:
    get:
      operationId: getFormationService
      summary: AI Training Service
      description: |
        Professional training in artificial intelligence.
        
        **Tools taught**:
        - ChatGPT (OpenAI)
        - Microsoft Copilot (365, GitHub)
        - Claude (Anthropic)
        - Gemini (Google)
        - MidJourney, DALL-E (image generation)
        
        **Formats**:
        - In-person training
        - Online training
        - Practical workshops
        - Individual coaching
      tags:
        - Services
      responses:
        '200':
          description: Training service page HTML

  /en/services/audit:
    get:
      operationId: getAuditService
      summary: AI Audit Service
      description: |
        AI maturity audit to assess your organization.
        
        **Includes**:
        - Analysis of existing processes
        - Identification of AI opportunities
        - Evaluation of internal skills
        - Strategic recommendations
        - Personalized roadmap
      tags:
        - Services
      responses:
        '200':
          description: Audit service page HTML

  /en/services/consulting:
    get:
      operationId: getConsultingService
      summary: AI Consulting Service
      description: |
        Strategic support for your AI transformation.
        
        **Areas of expertise**:
        - Corporate AI strategy
        - Data governance
        - AI ethics and compliance
        - Change management
        - Executive team training
      tags:
        - Services
      responses:
        '200':
          description: Consulting service page HTML

  /en/services/deploiement-technique:
    get:
      operationId: getDeploymentService
      summary: Technical Deployment Service
      description: |
        Implementation of custom AI solutions.
        
        **Services**:
        - AI API integration (OpenAI, Azure, Google Cloud)
        - Custom chatbot development
        - Workflow automation
        - Model fine-tuning
        - AI infrastructure setup
      tags:
        - Services
      responses:
        '200':
          description: Deployment service page HTML

  /llms-en.txt:
    get:
      operationId: getLLMsFile
      summary: Information file for LLMs
      description: |
        Structured text file containing all information about MAIjin
        optimized to be read and understood by language models (ChatGPT, Claude, Gemini, etc.).
      tags:
        - Technical Resources
      responses:
        '200':
          description: Text file for LLMs
          content:
            text/plain:
              schema:
                type: string

tags:
  - name: Main Pages
    description: Main pages of the MAIjin website
  - name: Services
    description: Services offered by MAIjin
  - name: Technical Resources
    description: Technical files for integrations

externalDocs:
  description: Learn more about MAIjin
  url: https://maijin.ch/en/about
