================================================================================
                       LISEZ-MOI AVANT INSTALLATION
                          L'IA du juriste — V1.0
================================================================================

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


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

ÉTAPE 1. Décompresser l'archive

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


ÉTAPE 2. Débloquer le dossier extrait

Windows considère par défaut que les fichiers téléchargés depuis Internet
sont potentiellement dangereux et bloque leur exécution. Il faut déverrouiller
le dossier en une seule fois.

  a) Ouvrir le Menu Démarrer, taper "powershell", clic-droit sur "Windows
     PowerShell" → "Exécuter en tant qu'administrateur". Cliquer "Oui" à
     l'invite de l'UAC.

  b) Dans la fenêtre PowerShell, copier-coller la commande suivante (en
     adaptant le chemin si vous avez choisi un autre dossier de destination
     à l'étape 1) :

       Get-ChildItem "C:\Users\$env:USERNAME\Documents\IA-juriste\ia-juriste-v1" -Recurse | Unblock-File

     Appuyer sur la touche Entrée. La commande ne renvoie aucun message si
     elle réussit (c'est normal).

  c) Fermer la fenêtre PowerShell administrateur.


ÉTAPE 3. Vérifier la politique d'exécution PowerShell

Si vous n'avez jamais exécuté de script PowerShell sur ce poste, il faut
autoriser une seule fois l'exécution des scripts signés ou téléchargés
légitimement.

  a) Ouvrir une fenêtre PowerShell (utilisateur normal cette fois, pas
     administrateur) : Menu Démarrer → taper "powershell" → cliquer sur
     "Windows PowerShell".

  b) Taper :

       Set-ExecutionPolicy -Scope CurrentUser RemoteSigned

     Confirmer en tapant Y puis Entrée si une question apparaît.

  c) Fermer la fenêtre.


ÉTAPE 4. Lancer l'installateur

  a) Naviguer dans l'Explorateur Windows jusqu'au dossier extrait.

  b) Clic-droit sur "installer.ps1" → "Exécuter avec PowerShell".

  c) L'assistant s'ouvre dans une fenêtre PowerShell. Suivre les questions
     posées (modules à installer, branches du droit pratiquées, jetons
     d'accès).

Si SmartScreen affiche un avertissement "Cet éditeur n'a pas été vérifié",
cliquer sur "Informations complémentaires" puis sur "Exécuter quand même".
Cet avertissement est normal — le pack n'est pas signé numériquement (voir
section "Pourquoi pas de signature" plus bas).


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

ÉTAPE 1. Décompresser l'archive

Double-cliquer sur "ia-juriste-v1.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-juriste-v1".

  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.


================================================================================
PROBLÈMES FRÉQUENTS À L'INSTALLATION
================================================================================

"Docker Desktop n'est pas installé"
    Télécharger et installer Docker Desktop depuis
    https://www.docker.com/products/docker-desktop/
    Démarrer Docker Desktop. Attendre que l'icône baleine soit stable et
    verte. Relancer l'installateur.

"Docker Desktop n'est pas démarré"
    Lancer Docker Desktop depuis le Menu Démarrer (Windows) ou le
    Launchpad (macOS). Attendre 1 à 2 minutes que l'icône soit verte.
    Relancer l'installateur.

"Ollama n'est pas installé"
    Télécharger Ollama depuis https://ollama.com/download
    Installer en suivant la procédure standard. Redémarrer si demandé.
    Relancer l'installateur.

"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.

"Erreur d'exécution PowerShell : ne peut pas être chargé car l'exécution
de scripts est désactivée sur ce système"
    Revenir à l'ÉTAPE 3 de la procédure Windows ci-dessus.


================================================================================
POURQUOI L'INSTALLATION DEMANDE DE DÉBLOQUER UN AVERTISSEMENT
================================================================================

Le pack n'est pas signé numériquement par un certificat de code. Pour cette
raison, Windows et macOS afficheront un avertissement à la première
exécution. La procédure de déblocage est documentée plus haut dans ce
fichier (étapes 2 et 3 pour Windows, étape 3 pour macOS).

Ce choix est délibéré pour une V1 : la signature de code commerciale a un
coût annuel récurrent. Pour s'assurer de l'authenticité du pack, vous pouvez
toujours consulter le code source des scripts d'installation et de la
documentation, qui est intégralement lisible dans le pack (pas de partie
compilée ni obscurcie). Le pack est en outre 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.
================================================================================
