diff --git a/readme.md b/readme.md
new file mode 100644
index 0000000..87fac07
--- /dev/null
+++ b/readme.md
@@ -0,0 +1,108 @@
+# 📂 Script : Importation Massive d'Utilisateurs AD
+
+## 📝 Description
+Ce script PowerShell (`insert_users.ps1`) permet d'automatiser la création de comptes utilisateurs dans **Active Directory** à partir d'un fichier source CSV.
+
+**Fonctionnalités principales :**
+* **Création automatique des utilisateurs** : Importe les identités depuis le fichier CSV.
+* **Gestion dynamique des OUs** : Si l'OU (Département) indiquée dans le CSV n'existe pas, le script la crée automatiquement.
+* **Gestion des mots de passe** : Convertit les mots de passe en chaîne sécurisée (SecureString).
+* **Sécurité** : L'option "L'utilisateur doit changer le mot de passe à la prochaine ouverture de session" est activée par défaut (`ChangePasswordAtLogon`).
+
+---
+
+## ⚙️ Prérequis
+
+Avant de lancer le script, assurez-vous de disposer des éléments suivants :
+
+1.  **Environnement :** Windows Server (Contrôleur de domaine) ou une machine Windows avec les outils **RSAT** (Remote Server Administration Tools) installés.
+2.  **Permissions :** Le script doit être exécuté avec un compte **Administrateur du Domaine** (Domain Admin).
+3.  **Module PowerShell :** Le module `ActiveDirectory` doit être présent sur la machine.
+
+---
+
+## 📊 Format du fichier CSV
+
+Le script attend un fichier nommé par défaut : `happy_koalas_employees_with_passwords.csv` (modifiable dans la variable `$CsvFilePath` du script).
+
+* **Délimiteur :** Point-virgule (`;`)
+* **Encodage recommandé :** UTF-8
+* **Entêtes obligatoires :**
+
+| En-tête | Description | Exemple |
+| :--- | :--- | :--- |
+| `FirstName` | Prénom | Jean |
+| `LastName` | Nom de famille | Dupont |
+| `UserName` | Identifiant de connexion (SAMAccountName) | jdupont |
+| `Password` | Mot de passe initial (Doit respecter la complexité AD) | P@ssw0rd123! |
+| `Email` | Adresse email | jean.dupont@entreprise.com |
+| `Department` | Nom du département (deviendra l'OU) | IT |
+| `JobTitle` | Titre du poste | Technicien |
+
+**Exemple de contenu CSV :**
+FirstName;LastName;UserName;Password;Email;Department;JobTitle
+Jean;Dupont;jdupont;SuperPass123!;jean.dupont@domaine.com;Comptabilite;Comptable
+Marie;Curie;mcurie;Science2024!;marie.curie@domaine.com;R&D;Chercheuse
+
+
+---
+
+## 🔧 Configuration du script
+
+Avant la première exécution, vous **devez éditer** le fichier `insert_users.ps1` pour l'adapter à votre infrastructure spécifique.
+
+### 1. Modifier le Domaine (Variable `$DomainDN`)
+Remplacez la valeur par le Distinguished Name (DN) de votre racine.
+* *Ligne approx. 14*
+
+# Exemple pour le domaine "monentreprise.local" :
+$DomainDN = "DC=monentreprise,DC=local"
+
+
+### 2. Modifier le suffixe UPN (Variable `$UserParams`)
+Par défaut, le script attribue `@happykoalas.com`. Modifiez cette ligne pour correspondre à votre domaine de messagerie/connexion.
+* *Ligne approx. 68*
+
+UserPrincipalName = "$SamAccount@monentreprise.com"
+
+
+### 3. Chemin du CSV (Optionnel)
+Si vous changez le nom du fichier CSV, mettez à jour la variable `$CsvFilePath`.
+
+---
+
+## 🚀 Utilisation
+
+1.  Ouvrez **PowerShell en tant qu'administrateur**.
+2.  Si ce n'est pas déjà fait, autorisez l'exécution des scripts sur votre machine :
+    Set-ExecutionPolicy RemoteSigned
+    
+3.  Naviguez vers le dossier contenant le script et le CSV :
+    cd "C:\Chemin\Vers\Le\Dossier"
+    
+4.  Exécutez le script :
+    .\insert_users.ps1
+    
+
+---
+
+## ⚠️ Dépannage courant (Troubleshooting)
+
+* **Erreur "Le terme 'Import-Module' n'est pas reconnu..."**
+    * *Cause :* Le module Active Directory n'est pas installé.
+    * *Solution :* Installez les outils RSAT pour AD DS.
+
+* **Erreur "Impossible de trouver le fichier..."**
+    * *Cause :* Le nom du fichier CSV dans le script ne correspond pas au nom réel du fichier, ou le fichier n'est pas dans le même dossier.
+
+* **Erreur de création d'utilisateur (Mot de passe)**
+    * *Cause :* Le mot de passe dans le CSV ne respecte pas la politique de sécurité du domaine (longueur, complexité).
+    * *Solution :* Mettez des mots de passe plus complexes dans le CSV ou désactivez temporairement la complexité des mots de passe dans les GPO (déconseillé).
+
+* **Erreur "L'OU n'existe pas" (malgré la tentative de création)**
+    * *Cause :* Problème de droits ou `$BaseDN` incorrect.
+
+---
+
+**Auteur :** 7ka1
+**Version :** 1.0
\ No newline at end of file