# Mission : Rooter un smartphone de test pour Appium

## Cadre et limites (STRICT)
- Ce téléphone est un **device de test que je possède**, dédié à un projet QA Appium.
- Objectif UNIQUE : obtenir un accès root fonctionnel. Tu t'ARRÊTES dès que le root
  est vérifié. Tu ne fais RIEN d'autre après (pas d'install d'apps, pas de modules,
  pas de tweaks système, pas de modif de données, pas de debloat) sauf si je le
  demande explicitement dans un message suivant.
- Avant toute écriture irréversible (unlock bootloader, flash), tu m'exposes le plan
  et tu attends mon feu vert. Tu ne lances jamais un flash sans confirmation.
- Tu ne génères/restaures jamais d'IMEI, ne contournes pas un verrou de propriétaire
  (FRP, compte, MDM). Si l'appareil n'est pas déverrouillable par moi (propriétaire),
  tu t'arrêtes et tu me le dis.

## Phase 1 — Reconnaissance (lecture seule)
1. Vérifie les outils dispo : `adb`, `fastboot`, et selon le besoin `mtkclient`,
   `edl` (Qualcomm), `heimdall`/Odin (Samsung). Installe proprement ce qui manque
   (venv isolé si Python), sans polluer le système.
2. Détecte le device : `adb devices -l`, puis
   `getprop ro.product.device / ro.product.manufacturer / ro.board.platform /
   ro.build.version.release / ro.boot.verifiedbootstate / ro.boot.flash.locked`.
3. Identifie : constructeur, chipset (MediaTek / Qualcomm / Exynos / autre), version
   Android, et l'état du bootloader (locked/unlocked).
4. Résume-moi le modèle et choisis la stratégie adaptée (voir Phase 2). Dis-moi le
   type de root le plus adapté (Magisk / KernelSU / APatch) selon le device.

## Phase 2 — Déverrouillage du bootloader (si verrouillé)
Choisis la route selon le device, et explique-moi avant de lancer :
- **Standard / Pixel / générique** : activer "OEM unlocking" + débogage USB, puis
  `fastboot flashing unlock` (ou `oem unlock`).
- **Xiaomi/MIUI** : Mi Unlock officiel (compte + attente 168h) OU, sur MediaTek,
  `mtkclient da seccfg unlock` via mode BROM (éteint + Vol+ & Vol- en branchant ;
  lancer l'outil EN ATTENTE puis brancher, la fenêtre preloader est très courte).
- **Qualcomm verrouillé** : route EDL (9008) seulement si pertinent et autorisé.
- **Samsung/Exynos** : OEM unlock dans les options dev, puis mode Download/Odin.
- ⚠️ Le déverrouillage **efface les données** : préviens-moi, et sauvegarde ce qui
  doit l'être avant.

## Phase 3 — Root
1. Récupère le **boot.img qui correspond EXACTEMENT à la ROM installée** (extrait de
   la ROM/OTA exacte, ou dump de la partition si root déjà partiel). Un boot.img qui
   ne matche pas = bootloop : tu vérifies toujours la correspondance (version, md5).
2. Méthode selon le choix Phase 1 :
   - **Magisk** : installer l'APK (si `adb install` bloqué par le constructeur,
     pousser l'APK et installer à la main), patcher le boot.img dans l'app, récupérer
     `magisk_patched-*.img`.
   - **KernelSU / APatch** : suivre le flux propre à la méthode (kernel compatible).
3. Garde une copie du **boot.img stock intact** comme filet de sécurité.
4. Après mon feu vert : `fastboot flash boot <patched>.img` puis reboot.

## Phase 4 — Vérification du root, puis STOP
1. Attends le boot (`sys.boot_completed=1`).
2. Vérifie : solution de root présente et active, puis
   `adb shell su -c id` doit renvoyer `uid=0(root)`.
   (Pense à autoriser l'accès root au shell ADB côté app : ex. Magisk →
   Superuser access = "Apps and ADB", et accorder le popup.)
3. Confirme-moi : root OK, et rappelle-moi :
   - l'emplacement du boot.img stock de secours + la commande de restauration,
   - de NE PAS refaire l'OTA (une MAJ réécrit boot et vire le root).
4. **TU T'ARRÊTES ICI.** Rapport final concis. Rien d'autre sans nouvelle instruction.