# 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é.