SPB Git forge

spb/immbot-ai

Public
1commits 1branches 0releases
1.5 MBsize
maindefault branch
20 days agolast push
TypeScript 98.3% CSS 0.9% Shell 0.7%
3.6 KB

# Guide du professeur / administrateur — Immbot AI

# Premiers pas

  1. Connexion : admin / admin123 → changement de mot de passe forcé.
  2. Vérifier l'ingestion : Administration → Cours & contenu (52 fichiers, ~2 000 fragments attendus).
  3. Vérifier les modèles : Administration → Modèles (le registre OpenRouter se met en cache 15 min).
  4. Ajuster les budgets : Administration → Paramètres (défauts : 1,50 $/jour/étudiant, 15 $/mois/étudiant, 200 $/mois global).

# Sections de l'administration

  • Vue générale — usage, coûts par jour et par modèle, erreurs API, citations invalides, signalements ouverts, état de l'ingestion.
  • Cours & contenu — documents indexés par espace (officiel vs privé prof), relance d'ingestion (incrémentale ou complète), rapports d'exécution. Les examens, solutionnaires et analyses restent dans instructor-private : jamais servis aux étudiants.
  • Modèles — activer/désactiver n'importe quel modèle OpenRouter, marquer des favoris, noter, et composer les préréglages (Recommandé, Rapide, Raisonnement, Images, Documents, Calculs, Grand contexte, Économique) proposés aux étudiants.
  • Pédagogie — maîtrise moyenne par concept (agrégée, seuil d'anonymat : 3 étudiants), questions les plus échouées, erreurs récurrentes, résultats d'examens blancs, signalements, satisfaction 👍/👎.
  • Prompts — tous les prompts système sont versionnés et éditables (base, politique de citations, conventions par cours, chaque mode pédagogique, générateurs). Publier crée une nouvelle version ; l'historique est conservé.
  • Annonces — messages ciblés par cours (ou globaux), épinglables, affichés dans le hub Apprendre.
  • Sécurité — utilisateurs (rôles, cours, désactivation, réinitialisation de mot de passe avec mot de passe temporaire à transmettre de façon sécurisée, révocation de sessions), journal des connexions et échecs.
  • Paramètres — budgets, politique d'intégrité académique (indices d'abord pour les travaux notés ; « verrouillage examen » qui l'applique à toutes les questions), recherche croisée inter-cours (désactivée par défaut), partage.

# Politique d'intégrité académique

Quand elle est active, une question ressemblant à un travail noté (mention d'atelier, « à remettre », etc.) déclenche le prompt integrity-policy : l'assistant demande la tentative de l'étudiant, guide par indices, et n'écrit pas de réponse finale prête à remettre. Le mode « verrouillage période d'examen » étend ce comportement à toutes les requêtes. La plateforme ne prétend pas détecter la fraude — elle structure l'aide.

# Gestion du contenu pédagogique

  • Les flashcards et questions marquées seed ont été validées à la construction ; le contenu généré par IA à la demande des étudiants (created_by = 'ai') reste privé à l'étudiant qui l'a généré.
  • Pour enrichir les banques : passer par la génération IA puis validation, ou éditer directement la base (quiz_questions, flashcards) — un outil d'édition en interface est une évolution prévue.
  • Les examens blancs sont composés depuis la banque de questions (voir scripts/seed.ts pour la recette de composition par semaines et difficultés).

# Confidentialité

Les statistiques individuelles ne sont jamais affichées : tout agrégat exige au moins 3 étudiants. Les conversations des étudiants ne sont pas consultables par le professeur ; seuls les messages signalés par un étudiant (bouton drapeau) remontent, avec l'extrait concerné.