> ⚠️ **URL live hors fonction pour le moment.** L'application a été retirée du cluster MacLustr le 2026-09-04 (processus arrêtés, copie du nœud supprimée). Ce dépôt spbgit est désormais la seule source de vérité du projet. Ancienne URL : https://www.immbot.ai

# Immbot AI

**Environnement d'apprentissage intelligent pour les cours IMM1003 et IMM1033 (évaluation immobilière, UQO).**

Immbot AI combine un assistant conversationnel multimodal fondé sur le **matériel officiel des cours**
(RAG avec citations vérifiables par diapositive), un **centre d'apprentissage** complet (flashcards à
répétition espacée, quiz adaptatifs, examens blancs, carte des concepts, plans d'étude, cahier
d'erreurs) et un **tableau de bord professeur** — propulsé par tous les modèles OpenRouter.

## Démarrage rapide

```bash
cd immbot-ai
./scripts/setup.sh      # dépendances + .env + seed + ingestion des cours
./scripts/dev.sh        # http://localhost:3070
```

Connexion initiale : **admin / admin123** — le changement de mot de passe est **forcé** à la première
connexion (le mot de passe initial n'est jamais accepté comme permanent).

Renseignez `OPENROUTER_API_KEY` dans `.env` pour activer le chat (le RAG, les flashcards seed, les
quiz et les examens blancs fonctionnent sans clé).

## Points clés

- **Source de vérité** : les fichiers LaTeX des cours (1 691 diapositives, plans, ateliers, glossaire)
  sont parsés à la source → citations exactes `[IMM1003 — Séance 4 — Diapositive 18]`, cliquables,
  **validées côté serveur** (aucune citation inventée ne survit).
- **Trois modes de connaissances** : Cours uniquement (défaut, refus honnête si le matériel ne suffit
  pas) · Cours + général (sections séparées) · Général (signalé).
- **Dix modes pédagogiques** : demander au cours, tuteur, socratique, explique simplement, niveau
  professionnel, corrige ma réponse, préparation d'examen, défi, analyse multimodale, révision ciblée.
- **Isolation stricte** : espaces `official-imm1003` / `official-imm1033` / téléversements étudiants /
  `instructor-private` (examens et analyses, invisibles aux étudiants). Vérifiée par l'évaluation RAG.
- **Embeddings locaux** (multilingual-e5-small) : gratuits, privés, hors-ligne ; recherche hybride
  BM25 + vectoriel + fusion RRF. Rappel mesuré : 24/24 sur les jeux de validation.
- **Coûts maîtrisés** : registre dynamique des modèles avec paliers, budgets quotidiens/mensuels par
  étudiant et global, appliqués côté serveur.

## Structure

Voir `docs/technical-architecture.md`. Documentation complète dans `docs/` :
`setup` · `deployment` · `admin-guide` · `student-guide` · `openrouter` · `rag-architecture` ·
`ingestion` · `security` (+ `security-model`) · `data-model` · `api` · `testing` · `troubleshooting`.

## Commandes

| Commande | Effet |
|---|---|
| `pnpm dev` / `pnpm build` / `pnpm start` | Développement / build / production (port 3070) |
| `pnpm seed` | Amorçage (admin, cours, prompts, contenu pédagogique) — idempotent |
| `pnpm ingest` / `pnpm reindex` | Ingestion incrémentale / complète du matériel de cours |
| `pnpm test` | Tests unitaires (vitest) |
| `pnpm evaluate` | Évaluation RAG (rappel, refus, isolation) → `evaluation/rag-evaluation.md` |
| `./scripts/verify.sh` | Types + tests + évaluation RAG |
| `./scripts/backup.sh` | Sauvegarde datée de la base |

## Avertissement pédagogique

Immbot AI aide à **apprendre**. La politique d'intégrité académique (configurable par le professeur)
privilégie les indices et la démarche pour les travaux notés, et la plateforme ne prétend jamais
prédire le contenu des examens réels.