# Installation de n8n Pilot

## Prérequis

| Outil | Version minimale | Rôle |
|-------|-----------------|------|
| Node.js | 20 LTS | Runtime JS |
| npm | 10+ | Gestionnaire de paquets |
| EAS CLI | 3.0+ | Build cloud Expo |
| Android | 8.0 (API 26) | Cible minimum |
| Compte Expo | gratuit | Build EAS |

```bash
# Vérifier les prérequis
node --version   # >= 20
npm --version    # >= 10
eas --version    # >= 3.0 (après install)
```

---

## 1. Cloner le dépôt

```bash
git clone https://homegit.gyozamancave.fr/billisdead/n8n-mobile.git
cd n8n-mobile
```

---

## 2. Installer les dépendances

```bash
npm install --legacy-peer-deps
```

---

## 3. Configurer l'environnement de développement

Copiez le fichier exemple et remplissez vos valeurs **localement uniquement** :

```bash
cp .env.example .env
# Éditez .env avec votre URL, clé API et token HAProxy
```

> ⚠️ Le fichier `.env` est dans `.gitignore` — ne jamais le committer.  
> En production, les secrets transitent **uniquement** par `expo-secure-store`.

---

## 4. Lancer en développement

```bash
# Démarrer le serveur Metro
npm start

# Sur appareil Android (USB ou WiFi) ou émulateur
npm run android
```

Pour le développement, l'app vous demandera de saisir l'URL et la clé API
directement dans l'écran Paramètres — elles seront stockées dans le Keystore Android.

---

## 5. Installer EAS CLI

```bash
npm install -g eas-cli
eas login   # Connectez-vous avec votre compte Expo
```

---

## 6. Configurer le projet EAS

```bash
# Initialise l'ID de projet Expo (première fois uniquement)
eas init

# Vérifie la configuration
eas build:configure
```

---

## 7. Builder l'APK (profil preview)

```bash
# Build Android APK — exécuté dans le cloud Expo
eas build --platform android --profile preview
```

Le build prend environ 10–15 minutes. EAS envoie un email avec le lien de téléchargement.

Pour un build local (nécessite Android Studio + JDK 17) :

```bash
eas build --platform android --profile preview --local
```

---

## 8. Sideloader l'APK sur Android

### Via ADB

```bash
# Connecter l'appareil en USB avec le débogage USB activé
adb devices

# Installer l'APK
adb install chemin/vers/n8n-pilot.apk
```

### Manuellement

1. Transférez l'APK sur l'appareil (câble, Google Drive, etc.)
2. Ouvrez l'APK depuis le gestionnaire de fichiers
3. Autorisez l'installation depuis des sources inconnues si demandé
4. Suivez l'assistant d'installation

---

## 9. Premier lancement

Au premier démarrage, l'écran de configuration apparaît automatiquement :

1. Saisissez l'URL HTTPS de votre instance n8n
2. Collez votre clé API n8n (Settings > API Keys dans n8n)
3. Saisissez le token HAProxy si applicable
4. Appuyez sur **Sauvegarder**

Les credentials sont chiffrés dans l'Android Keystore — ils ne quittent jamais l'appareil.