openapi: 3.1.0
info:
  title: MAIjin - Formation IA Suisse
  description: |
    MAIjin est un cabinet suisse spécialisé dans la formation et le conseil en intelligence artificielle.
    
    ## Services principaux
    - **Formations IA** : ChatGPT, Microsoft Copilot, Claude, Gemini, MidJourney
    - **Audit de maturité IA** : Évaluation complète de votre organisation
    - **Consulting stratégique** : Accompagnement personnalisé pour votre transformation IA
    - **Déploiement technique** : Implémentation de solutions IA sur mesure
    
    ## Zones d'intervention
    Genève, Lausanne, Vaud, Valais, Fribourg, Neuchâtel, toute la Suisse Romande
    
    ## Expertise métiers
    Marketing, Finance, Ressources Humaines, Vente, Juridique, Management, Administratif
    
    ## Langues
    Français, Anglais, Allemand
  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 Genève, Suisse"
  license:
    name: Proprietary
    url: https://maijin.ch/mentions-legales

servers:
  - url: https://maijin.ch
    description: Site principal MAIjin

paths:
  /:
    get:
      operationId: getHomePage
      summary: Page d'accueil MAIjin
      description: |
        Page d'accueil présentant MAIjin, cabinet de formation et conseil en IA en Suisse Romande.
        Contient une présentation des services, témoignages clients et études de cas.
      tags:
        - Pages principales
      responses:
        '200':
          description: Page d'accueil HTML
          content:
            text/html:
              schema:
                type: string

  /about:
    get:
      operationId: getAboutPage
      summary: À propos de MAIjin
      description: |
        Présentation de l'équipe MAIjin et de sa mission.
        
        **Équipe dirigeante** :
        - Jean-Baptiste Berthoux : Chief AI Officer, expert en IA et stratégie digitale
        - Rémi Vancayzeele : CEO, spécialiste en transformation digitale
        - Matthieu Collas : Operating Partner, expert en opérations et déploiement grandes entreprises
        
        **Équipe de formateurs certifiés** incluant des experts en marketing, finance, RH et vente.
      tags:
        - Pages principales
      responses:
        '200':
          description: Page À propos HTML

  /case-studies:
    get:
      operationId: getCaseStudies
      summary: Études de cas clients
      description: |
        Découvrez nos études de cas détaillées avec des clients de référence :
        - Shiseido EMEA : Transformation IA de la stratégie marketing
        - RTS (Radio Télévision Suisse) : Optimisation des processus éditoriaux
        - État de Fribourg : Modernisation des services publics
        - BCV (Banque Cantonale Vaudoise) : Innovation dans les services financiers
        - Manotel : Excellence opérationnelle dans l'hôtellerie
      tags:
        - Pages principales
      responses:
        '200':
          description: Liste des études de cas HTML

  /faq:
    get:
      operationId: getFAQPage
      summary: Questions fréquentes
      description: |
        Réponses aux questions fréquentes sur nos formations et services IA.
        Couvre les sujets : tarifs, durée des formations, personnalisation, certification, etc.
      tags:
        - Pages principales
      responses:
        '200':
          description: Page FAQ HTML

  /services/formation:
    get:
      operationId: getFormationService
      summary: Service de formation IA
      description: |
        Formations professionnelles en intelligence artificielle.
        
        **Outils enseignés** :
        - ChatGPT (OpenAI)
        - Microsoft Copilot (365, GitHub)
        - Claude (Anthropic)
        - Gemini (Google)
        - MidJourney, DALL-E (génération d'images)
        
        **Formats** :
        - Formations en présentiel
        - Formations en ligne
        - Ateliers pratiques
        - Coaching individuel
        
        **Durée** : De 2 heures à plusieurs jours selon les besoins
      tags:
        - Services
      responses:
        '200':
          description: Page service formation HTML

  /services/audit:
    get:
      operationId: getAuditService
      summary: Service d'audit IA
      description: |
        Audit de maturité IA pour évaluer votre organisation.
        
        **Inclut** :
        - Analyse des processus existants
        - Identification des opportunités IA
        - Évaluation des compétences internes
        - Recommandations stratégiques
        - Feuille de route personnalisée
      tags:
        - Services
      responses:
        '200':
          description: Page service audit HTML

  /services/consulting:
    get:
      operationId: getConsultingService
      summary: Service de consulting IA
      description: |
        Accompagnement stratégique pour votre transformation IA.
        
        **Domaines d'expertise** :
        - Stratégie IA d'entreprise
        - Gouvernance des données
        - Éthique et conformité IA
        - Gestion du changement
        - Formation des équipes dirigeantes
      tags:
        - Services
      responses:
        '200':
          description: Page service consulting HTML

  /services/deploiement-technique:
    get:
      operationId: getDeploymentService
      summary: Service de déploiement technique
      description: |
        Implémentation de solutions IA sur mesure.
        
        **Services** :
        - Intégration d'API IA (OpenAI, Azure, Google Cloud)
        - Développement de chatbots personnalisés
        - Automatisation des workflows
        - Fine-tuning de modèles
        - Mise en place d'infrastructures IA
      tags:
        - Services
      responses:
        '200':
          description: Page service déploiement HTML

  /parcours/marketing:
    get:
      operationId: getMarketingParcours
      summary: Parcours IA pour le Marketing
      description: |
        Formation IA spécialisée pour les professionnels du marketing.
        Création de contenu, analyse de données, automatisation des campagnes.
      tags:
        - Parcours métiers
      responses:
        '200':
          description: Page parcours marketing HTML

  /parcours/finance:
    get:
      operationId: getFinanceParcours
      summary: Parcours IA pour la Finance
      description: |
        Formation IA pour les professionnels de la finance.
        Analyse financière, reporting automatisé, détection de fraude.
      tags:
        - Parcours métiers
      responses:
        '200':
          description: Page parcours finance HTML

  /parcours/ressources-humaines:
    get:
      operationId: getRHParcours
      summary: Parcours IA pour les Ressources Humaines
      description: |
        Formation IA pour les professionnels RH.
        Recrutement assisté par IA, gestion des talents, formation personnalisée.
      tags:
        - Parcours métiers
      responses:
        '200':
          description: Page parcours RH HTML

  /parcours/vente:
    get:
      operationId: getVenteParcours
      summary: Parcours IA pour la Vente
      description: |
        Formation IA pour les équipes commerciales.
        Prospection automatisée, scoring leads, personnalisation client.
      tags:
        - Parcours métiers
      responses:
        '200':
          description: Page parcours vente HTML

  /parcours/juridique:
    get:
      operationId: getJuridiqueParcours
      summary: Parcours IA pour le Juridique
      description: |
        Formation IA pour les professionnels du droit.
        Analyse de contrats, recherche juridique, rédaction assistée.
      tags:
        - Parcours métiers
      responses:
        '200':
          description: Page parcours juridique HTML

  /parcours/management:
    get:
      operationId: getManagementParcours
      summary: Parcours IA pour le Management
      description: |
        Formation IA pour les managers et dirigeants.
        Prise de décision, gestion de projets, leadership à l'ère de l'IA.
      tags:
        - Parcours métiers
      responses:
        '200':
          description: Page parcours management HTML

  /parcours/administratif:
    get:
      operationId: getAdministratifParcours
      summary: Parcours IA pour l'Administratif
      description: |
        Formation IA pour les fonctions administratives.
        Automatisation des tâches, gestion documentaire, communication.
      tags:
        - Parcours métiers
      responses:
        '200':
          description: Page parcours administratif HTML

  /blog:
    get:
      operationId: getBlogPage
      summary: Blog et ressources
      description: |
        Articles, guides et ressources sur l'intelligence artificielle.
        Formations par canton, outils IA, tendances et prédictions.
      tags:
        - Ressources
      responses:
        '200':
          description: Page blog HTML

  /llms.txt:
    get:
      operationId: getLLMsFile
      summary: Fichier d'information pour LLMs
      description: |
        Fichier texte structuré contenant toutes les informations sur MAIjin
        optimisé pour être lu et compris par les modèles de langage (ChatGPT, Claude, Gemini, etc.).
      tags:
        - Ressources techniques
      responses:
        '200':
          description: Fichier texte pour LLMs
          content:
            text/plain:
              schema:
                type: string

components:
  schemas:
    Service:
      type: object
      properties:
        name:
          type: string
          description: Nom du service
        description:
          type: string
          description: Description du service
        url:
          type: string
          format: uri
          description: URL de la page du service

    CaseStudy:
      type: object
      properties:
        client:
          type: string
          description: Nom du client
        industry:
          type: string
          description: Secteur d'activité
        challenge:
          type: string
          description: Défi rencontré
        solution:
          type: string
          description: Solution apportée par MAIjin
        results:
          type: array
          items:
            type: string
          description: Résultats obtenus

    TeamMember:
      type: object
      properties:
        name:
          type: string
        role:
          type: string
        expertise:
          type: array
          items:
            type: string

tags:
  - name: Pages principales
    description: Pages principales du site MAIjin
  - name: Services
    description: Services proposés par MAIjin
  - name: Parcours métiers
    description: Formations spécialisées par métier
  - name: Ressources
    description: Blog et ressources documentaires
  - name: Ressources techniques
    description: Fichiers techniques pour intégrations

externalDocs:
  description: En savoir plus sur MAIjin
  url: https://maijin.ch/about
