Guide utilisateur

1. Chat assistant

Le chat général permet de dialoguer avec l'assistant IA. Vos conversations sont privées et isolées par compte utilisateur.

Fonctionnalités

• Nouvelle conversation — bouton + dans la barre latérale.
• Recherche — filtre les conversations par titre ou contenu.
• Interrompre — arrête une réponse en cours de génération.
• Export Markdown / PDF — boutons en haut à droite une fois une conversation ouverte.

Export

• Markdown — télécharge un fichier .md avec tout l'historique.
• PDF — ouvre une page imprimable ; utilisez « Enregistrer au format PDF » du navigateur.

Si aucune conversation n'existe au chargement, une conversation par défaut est créée automatiquement.

2. Espace Code

Mini-IDE dans le navigateur : explorateur de fichiers, éditeur CodeMirror et assistant capable de modifier réellement les fichiers du projet.

Projets

• Chaque utilisateur dispose de ses propres projets (isolation par compte).
• À la création : workspace prêt à l'emploi, README projet et conteneur preview lancé automatiquement.
• + Projet — crée un nouveau projet.
• Télécharger — archive ZIP (fichiers, versions, conversations).
• Archiver — ZIP puis retrait de la liste active (conteneur arrêté et supprimé).
• Supprimer — suppression définitive (fichiers, base, conteneur Docker).
• ↗ Workspace — ouvre l'aperçu du site (/preview/{id}/).

Explorateur et éditeur

• Glisser-déposer de fichiers ou dossiers dans l'explorateur.
• Versions — historique des modifications par fichier (restauration possible).
• Ctrl+S — sauvegarde le fichier ouvert.

Assistant code

• Décrivez ce que vous voulez ; l'agent crée ou modifie les fichiers du workspace.
• L'agent s'adapte à la stack et aux conventions déjà présentes dans le projet.
• ↩ Annuler agent — annule la dernière série de modifications appliquées par l'agent.
• Interrompre — stoppe une réponse en cours (sans appliquer de modification si interrompu tôt).

3. Aperçu conteneur (preview)

Chaque projet dispose de son propre conteneur Apache/PHP, distinct de la plateforme Mon Agent IA. Vous éditez les fichiers dans l'Espace Code ; le conteneur sert le même workspace pour tester le site.

Ouvrir l'aperçu

1. Sélectionnez le projet dans l'Espace Code.
2. Cliquez sur ↗ Workspace dans la barre du haut.
3. La page s'ouvre sur /preview/{id}/ (connexion requise).

Cycle de vie

• Création du projet — déploiement automatique du conteneur (quelques secondes).
• Modification des fichiers — immédiatement visibles dans l'aperçu (même volume de fichiers).
• Suppression ou archivage — le conteneur est arrêté et retiré ; un indicateur de progression s'affiche pendant l'opération.

En cas de problème

• Message Preview indisponible — le conteneur n'a pas démarré (erreur au déploiement). Recréez le projet ou contactez un administrateur.
• Erreur 500 dans l'aperçu — le conteneur fonctionne, mais le code PHP du projet a une erreur (BDD, configuration…).

L'infrastructure conteneurs est gérée via Portainer sur le serveur ; vous n'avez rien à configurer côté utilisateur.

4. Sessions de travail (Espace Code)

Une session n'est pas votre connexion au site : c'est un fil de discussion avec l'assistant code, propre à un projet.

À quoi servent les sessions ?

• La session active (menu déroulant) reçoit vos messages et l'historique affiché.
• + Session — démarre un nouveau sujet sans mélanger l'historique.
• Les autres sessions du même projet servent de contexte à l'assistant (mémoire des décisions passées).

Quand créer une nouvelle session ?

• Changement de tâche (ex. page d'accueil → module admin).
• Historique trop long ou confus.
• Tester une autre approche sans effacer l'ancienne discussion.

5. Partage lecture seule

Partagez un projet avec une personne sans lui donner de compte : consultation des fichiers et des conversations uniquement.

Créer un lien

1. Ouvrez l'Espace Code et sélectionnez le projet.
2. Cliquez sur ⎘ Partager dans la barre du haut.
3. Optionnel : saisissez un libellé, puis Créer le lien.
4. Copiez l'URL et transmettez-la (bouton Copier).

Ce que voit le destinataire

• Explorateur de fichiers en lecture seule.
• Contenu des fichiers (sans modification).
• Liste et contenu des sessions de conversation du projet.

Révoquer un lien

Dans la même fenêtre de partage, cliquez Révoquer sur le lien concerné. L'URL ne fonctionnera plus.

Ne partagez un lien qu'avec des personnes de confiance : des informations sensibles du projet peuvent apparaître dans le README ou les conversations.

6. Exporter une conversation

Disponible dans le Chat et l'Espace Code (session active).

Les boutons sont grisés tant qu'aucune conversation / session n'est sélectionnée.

7. Administration

Réservée aux comptes avec le rôle admin.

Tableau de bord

• Espace disque occupé par data/.
• Nombre de projets, utilisateurs, conversations chat.
• Connexions actives (utilisateurs connectés récemment).
• Journal des événements récents (connexions, admin, erreurs LLM, projets…).

Autres pages admin

• Utilisateurs — créer, réinitialiser mot de passe, supprimer des comptes.
• Paramètres — modèle IA, preprompts Chat et Espace Code, configuration serveur.
• Projets — vue globale, suppression de projets (tous utilisateurs).
• Archives — gestion des ZIP archivés.

Les logs détaillés sont enregistrés dans data/logs/ (format JSON, un fichier par jour).

Raccourcis utiles