Création et démarrage d'un projet

Création et démarrage d'un projet

Guide pas à pas pour créer un nouvel espace de travail et le rendre immédiatement opérationnel

Créez un projet, ajoutez vos sources (dépôt Git, site, fichiers) et suivez son initialisation jusqu’à ce qu’il apparaisse dans votre liste de projets.

Intro Ce guide couvre toutes les étapes nécessaires pour créer un nouveau projet : prérequis d’authentification, ouverture du formulaire de création, saisie du nom et des paramètres initiaux (dépôts, sites, fichiers), soumission et vérification que le projet est bien créé et visible dans la liste. Vous trouverez aussi des conseils pratiques, des erreurs fréquentes et des solutions pour les cas bloquants.

Ce que vous pouvez faire

Créer un nouveau projet

Démarrer un espace de travail en quelques clics, avec options pour lier des dépôts, ajouter des sites ou téléverser des fichiers.

Suivi d'initialisation

Voir l’état d’initialisation et les barres de progression lorsque des sources (repos/sites/uploads) sont traitées.

Visibilité immédiate

Le projet créé apparaît dans votre liste de projets et vous êtes redirigé vers sa page principale.

Connexion requise

La création nécessite d’être connecté : le bouton de création est accessible uniquement aux utilisateurs authentifiés.

Gestion des sources

Ajouter des dépôts Git, des URL de site ou des fichiers pour alimenter le projet dès sa création.

Annulation & nettoyage

Si quelque chose se passe mal, instructions pour annuler ou corriger la création et réessayer proprement.

Astuce : préparez vos accès Git à l'avance

Si vous prévoyez d’attacher un dépôt Git, connectez vos fournisseurs Git (ex. GitHub) avant d’ouvrir le formulaire. Cela accélère la sélection du dépôt et évite les étapes supplémentaires pendant la création.

Nom de projet efficace

Choisissez un nom clair, court et unique (ex. “app-frontend”, “marketing-site”). Évitez les caractères étranges et les accents pour faciliter les références automatiques (URLs, identifiants générés).

Attention : création réservée aux utilisateurs connectés

Vous devez être authentifié pour créer un projet. Si vous recevez un message d’erreur indiquant que la création est refusée, vérifiez que vous êtes bien connecté et que votre session n’a pas expiré.

Workflow 1 — Prérequis : vérification d'authentification

1

Étape 1 — Vérifier que vous êtes connecté

Ouvrez l’application et regardez le coin supérieur (ou l’élément de navigation “Profil / Connexion”). Si vous voyez votre nom ou avatar, vous êtes connecté. Sinon, cliquez sur “Connexion” et suivez la procédure d’authentification.

2

Étape 2 — Confirmer les permissions

Si vous travaillez dans une organisation ou avec des rôles, assurez-vous d’avoir les droits nécessaires pour créer des projets. En cas de doute, contactez l’administrateur de votre espace.

3

Étape 3 — Résoudre les problèmes de session

Si la création échoue pour motif d’authentification alors que vous êtes connecté, essayez : actualiser la page, vous déconnecter puis reconnecter, ou vérifier les cookies et bloqueurs de pop‑up dans votre navigateur.

Workflow 2 — Ouvrir le formulaire de création et renseigner les informations

1

Étape 1 — Ouvrir le formulaire

Cliquez sur le bouton “Nouveau projet” ou “Créer un projet” situé dans la barre de navigation ou sur la page de la liste des projets. Un formulaire s’ouvre (souvent en modal).

2

Étape 2 — Saisir le nom du projet

Dans le champ “Nom du projet”, tapez un nom représentatif. Ce champ est généralement requis. Vérifiez qu’il n’est pas vide et qu’il respecte vos conventions internes (pas de caractères spéciaux si vous préférez).

3

Étape 3 — Ajouter des dépôts Git (optionnel)

Si vous souhaitez lier un dépôt :

  • Cliquez sur “Ajouter un dépôt” ou sélectionnez l’option “Repositories”.
  • Si vous n’êtes pas encore connecté à un fournisseur Git (ex. GitHub), utilisez le bouton de connexion affiché (il ouvrira une fenêtre pour autoriser l’accès).
  • Une fois connecté, sélectionnez le fournisseur puis le dépôt dans la liste déroulante. Note : vous pouvez ajouter plusieurs dépôts si nécessaire.
4

Étape 4 — Ajouter une URL de site (optionnel)

Pour ajouter un site web, utilisez la section “Sites” et collez l’URL complète (ex. https://monsite.example). Ajoutez autant d’URL que nécessaire.

5

Étape 5 — Téléverser des fichiers (optionnel)

Si vous voulez fournir des fichiers (ex. documentation, exports), utilisez la section “Upload File” : sélectionnez le(s) fichier(s) et vérifiez le type accepté (généralement .txt, .md, .html, .csv, etc.).

6

Étape 6 — Vérification finale avant envoi

Relisez les champs : nom, listes de dépôts/sites/fichiers. Corrigez les erreurs affichées en rouge (champ requis manquant, format invalide) avant de soumettre.

7

Étape 7 — Soumettre le formulaire

Cliquez sur “Create Project” ou “Créer”. Un indicateur de chargement apparaît. Attendez la confirmation : vous devriez être redirigé vers la page du projet ou recevoir une notification de succès.

Workflow 3 — Après soumission : vérification et visibilité du projet

1

Étape 1 — Redirection et confirmation

Après la création, vous devriez être redirigé automatiquement vers la page du projet. Vérifiez le titre et les détails initiaux affichés en haut de la page.

2

Étape 2 — Vérifier la liste des projets

Retournez à la liste de projets : le nouveau projet doit apparaître en tête ou selon l’ordre de tri. Si vous ne le voyez pas, rafraîchissez la page ou utilisez l’action “Actualiser la liste” si présente.

3

Étape 3 — Suivre l'initialisation des sources

Si vous avez ajouté des dépôts, sites ou fichiers, une phase d’initialisation/traitement peut démarrer automatiquement. Recherchez une section “Progress”, des barres de progression ou des notifications indiquant l’état des tâches.

4

Étape 4 — Que faire en cas d'arrêt ou d'erreur

Si l’initialisation reste bloquée ou affiche des erreurs :

  • Attendez quelques minutes (les traitements peuvent être en file d’attente).
  • Actualisez la page pour forcer la mise à jour de l’état.
  • En dernier recours, utilisez l’option “Annuler” ou “Supprimer” le projet et recréez‑le après vérification des sources.
5

Étape 5 — Continuer la configuration

Une fois créé, configurez le projet : paramètres de langue, clés externes (si besoin), prompts globaux, ou autres réglages proposés dans l’interface du projet.

Erreur fréquente : double soumission

Si votre réseau est lent, évitez de cliquer plusieurs fois sur “Créer”. Plusieurs clics peuvent lancer plusieurs demandes et créer des doublons. Si vous pensez qu’un doublon a été créé, supprimez l’un des projets depuis la liste et conservez celui avec les sources correctement initialisées.

  • Ouvrir le formulaire.
  • Saisir uniquement le nom.
  • Soumettre et vérifier la présence du projet dans la liste. Idéal pour prototyper rapidement sans lier de sources.
  • Connecter votre fournisseur Git avant de commencer (si possible).
  • Dans le formulaire, ajouter un dépôt et sélectionner le repo.
  • Créer le projet et surveiller l’initialisation des sources. Recommandé pour projets nécessitant analyse du code ou import de fichiers depuis un dépôt.
  • Ajouter une ou plusieurs URL(s) de site ou téléverser des fichiers depuis la section dédiée.
  • Créer le projet ; le système lancera le traitement des sources ajoutées. Utile pour générer des insights à partir de contenus non-Git.

Avant : création sans préparation

  • Vous cliquez “Créer”, entrez le nom, puis réalisez que vous devez connecter Git ou préparer des fichiers. Résultat : étapes additionnelles après création.

Après : création préparée

  • Connectez d’abord vos fournisseurs Git, préparez vos fichiers et URLs. Ensuite, ouvrez le formulaire et terminez la création en une seule fois. Moins d’allers-retours et initialisation plus fluide.

Suivi : utilisez la page projet pour tout vérifier

La page du projet centralise les actions (paramètres, progression, génération de site, chat lié au projet). Après création, c’est l’endroit le plus utile pour vérifier que tout fonctionne et lancer d’autres actions.

Frequently Asked Questions

Besoin d'aide supplémentaire ?

Si vous rencontrez un cas particulier non couvert ici (erreurs récurrentes, permissions spécifiques, ou traitement très long), contactez le support de votre instance ou votre administrateur. Fournissez le nom du projet, l’heure de création et une capture d’écran des erreurs affichées.

Prêt à créer un projet ?

Cliquez pour ouvrir le formulaire de création et suivre les étapes décrites ci-dessus.