# E-MeCeF — Installation macOS

## Prérequis

Mac **Apple Silicon** (M1, M2, M3, M4).
Cette archive ne contient pas de binaire Intel (x86 64-bit).

---

## Contenu de cette archive

```
e-mecef-mac-install/
├── e-mecef.app          ← Application E-MeCeF (driver + interface)
├── install-macos.sh     ← Script d'installation
└── README-macos.md      ← Ce fichier
```

---

## Installation

### Étape 1 — Ouvrir un Terminal

Appuyez sur **Cmd + Espace**, tapez **Terminal**, appuyez sur Entrée.

### Étape 2 — Aller dans le dossier dézippé

```bash
cd ~/Downloads/e-mecef-mac-install
```

### Étape 3 — Lancer le script d'installation

```bash
./install-macos.sh
```

Si macOS refuse d'exécuter le script, autorisez-le d'abord :

```bash
chmod +x install-macos.sh
./install-macos.sh
```

### Étape 4 — Lancer l'application

L'application est maintenant dans `/Applications`.
Ouvrez le **Finder → Applications → e-mecef**.

---

## Que fait le script ?

1. Copie `e-mecef.app` dans `/Applications` (remplace la version existante le cas échéant)
2. Retire l'attribut de quarantaine macOS (Gatekeeper) qui bloque les applications téléchargées depuis un serveur non Apple

Si la quarantaine ne peut pas être retirée, relancez le script avec `sudo` :

```bash
sudo ./install-macos.sh
```

---

## Configuration

Au premier lancement, allez dans l'onglet **Paramètres**.

### Activer la licence

Démarrez d'abord le driver, puis renseignez dans la section **Activation de licence** :

- la **clé de licence** qui vous a été fournie ;
- le **NIM** de votre appareil MCF.

Cliquez sur **🔑 Activer la licence**.

### Choisir le mode de fonctionnement

Dans la section **Mode cloud (WebSocket)** :

- **● Local** — le driver expose une API HTTP locale pour votre logiciel de facturation ;
- **☁ Cloud** — le driver se connecte au serveur SFE et certifie les factures poussées
  via WebSocket. Renseignez alors l'**URL WSS** (ex. `wss://app.sfe.com/mcf/ws`) et la
  **Clé API** de votre organisation (ex. `sk_org_xxxxxxxxxxxx`).

---

## Support

En cas de problème, contactez votre administrateur système ou le support technique.
