================================================================================
                       LISEZ-MOI AVANT INSTALLATION
                         L'IA du juriste — 2.0.0
================================================================================

Ce document explique comment lancer l'installateur sur Windows ou macOS.
Il prend deux minutes à lire.

L'installateur vérifie lui-même les prérequis (Docker Desktop, Ollama) :
s'il en manque un, il vous aide à l'installer ou le démarre à votre place,
puis reprend là où il en était. Vous pouvez donc lancer l'installation
directement, sans préparation particulière.


================================================================================
WINDOWS — PROCÉDURE EN DEUX ÉTAPES
================================================================================

ÉTAPE 1. Décompresser l'archive

Clic-droit sur le fichier "ia-du-juriste-2.0.0.zip" → "Extraire tout..." →
choisir un dossier de destination (par exemple "Documents\IA-juriste").
Cliquer "Extraire".


ÉTAPE 2. Lancer l'installateur

Double-cliquer sur "INSTALLER.bat" dans le dossier extrait.

Si SmartScreen affiche "Windows a protégé votre ordinateur", cliquer sur
"Informations complémentaires" puis "Exécuter quand même". Cet
avertissement est normal — le pack n'est pas signé numériquement (voir la
section "Pourquoi pas de signature numérique" plus bas).

L'assistant s'ouvre dans une fenêtre PowerShell et pose ses questions
(modules à installer, jetons d'accès). Aucun réglage PowerShell préalable
n'est nécessaire.


================================================================================
MACOS — PROCÉDURE EN TROIS ÉTAPES
================================================================================

ÉTAPE 1. Décompresser l'archive

Double-cliquer sur "ia-du-juriste-2.0.0.zip" dans le Finder. macOS extrait
le contenu dans le même dossier.


ÉTAPE 2. Ouvrir le Terminal au bon endroit

  a) Ouvrir le Finder, naviguer jusqu'au dossier "ia-du-juriste-2.0.0".

  b) Clic-droit sur le dossier → "Nouvel onglet de Terminal sur le dossier".

Si l'option n'apparaît pas dans le menu contextuel, l'activer dans
Préférences Système → Clavier → Raccourcis → Services → Services de
fichiers et de dossiers, cocher "Nouveau Terminal sur le dossier".


ÉTAPE 3. Lancer l'installateur

Dans le Terminal, taper :

    bash installer.sh

Appuyer sur la touche Entrée. L'assistant démarre et pose ses questions.

Si macOS affiche "installer.sh ne peut pas être ouvert car son
développeur n'est pas identifié", ouvrir le Terminal et taper :

    xattr -d com.apple.quarantine installer.sh

Puis relancer.


================================================================================
NOTE 2.0.0 — PREMIÈRE CONSTRUCTION DOCKER
================================================================================

Le module SAS télécharge son modèle de reconnaissance d'entités
(GLiNER2-PII, ~800 Mo) pendant le "docker compose build". Comptez 10 à
30 minutes selon la connexion. Pour une installation hors ligne :
variable SKIP_MODEL_DOWNLOAD=1 au build (le modèle sera alors téléchargé
au premier démarrage du conteneur).


================================================================================
DÉPANNAGE
================================================================================

"L'exécution de scripts est désactivée sur ce système" (Windows)
    Rare depuis la 2.0.0 (INSTALLER.bat prend en charge ce réglage),
    mais possible sur un poste administré par une direction
    informatique. Ouvrir PowerShell en tant qu'administrateur
    (Menu Démarrer → taper "powershell" → clic-droit → "Exécuter en
    tant qu'administrateur" → "Oui" à l'invite), puis coller ces deux
    commandes en adaptant le chemin :

      Get-ChildItem "C:\Users\$env:USERNAME\Documents\IA-juriste\ia-du-juriste-2.0.0" -Recurse | Unblock-File
      Set-ExecutionPolicy -Scope CurrentUser RemoteSigned

    Fermer la fenêtre et relancer INSTALLER.bat. Si le blocage persiste,
    la stratégie de groupe de votre organisation l'interdit : voir avec
    votre support informatique.

"Docker Desktop n'est pas installé" / "n'est pas démarré"
    Depuis la 2.0.0, l'installateur le détecte, ouvre la page de
    téléchargement ou démarre Docker Desktop lui-même, puis reprend là
    où il en était. Suivre simplement les indications à l'écran. Si
    Windows redémarre pendant l'installation de Docker, relancer
    ensuite INSTALLER.bat.

"Ollama n'est pas installé"
    L'installateur propose de le télécharger et de l'installer
    automatiquement (Windows), ou ouvre la page de téléchargement
    (macOS), puis reprend.

"Espace disque insuffisant"
    L'installation complète (modèles compris) demande environ 30 Go.
    Libérer de l'espace ou choisir un emplacement sur un autre disque.


================================================================================
POURQUOI PAS DE SIGNATURE NUMÉRIQUE
================================================================================

Le pack n'est pas signé par un certificat de code commercial ; Windows
et macOS affichent donc un avertissement à la première exécution (un
clic pour passer outre). Ce choix est délibéré : la signature
commerciale a un coût annuel récurrent. Pour vous assurer de
l'authenticité du pack, vous pouvez vérifier son empreinte SHA-256,
publiée sur la page de téléchargement, et consulter le code source des
scripts d'installation, intégralement lisible dans le pack (aucune
partie compilée ni obscurcie). Le pack est distribué sous licence libre
CeCILL-B v1.0 (voir le fichier LICENSE), qui autorise l'audit et la
modification.


================================================================================
APRÈS L'INSTALLATION
================================================================================

Le manuel utilisateur de chaque module se trouve dans le sous-dossier
"docs/" du pack une fois extrait. Lire en priorité :

  - docs/manuel_avocat_pour_claude.md  →  si vous lisez peu la documentation
                                          technique et préférez vous faire
                                          assister par Claude

  - docs/manuel_sas.md                 →  pour la pseudonymisation
  - docs/manuel_coffre_fort.md         →  pour la consultation juridique
  - docs/manuel_mcp.md                 →  pour les requêtes supervisées
  - docs/faq.md                        →  pour les questions courantes
  - docs/guide_technique_v1.pdf        →  pour le profil tech


================================================================================
                       Bonne installation et bon usage.
================================================================================
