# Mise en ligne VPS + Shopify

L'application est prévue pour le sous-domaine `app.lessucreriesdeminipouce.fr`. Sur le VPS partagé avec Filyx, elle s'exécute avec son propre service systemd sur `127.0.0.1:3456`; Nginx existant reste le seul processus qui utilise les ports publics 80 et 443. Elle n'écrira pas dans Shopify avant la connexion OAuth réussie.

## 1. DNS avant le déploiement

Dans la zone DNS de `lessucreriesdeminipouce.fr`, créez ou vérifiez un enregistrement **A** :

```text
app  ->  IP publique du VPS
```

Laissez les ports 80 et 443 accessibles au VPS. Nginx et Certbot les utilisent pour obtenir et renouveler le certificat HTTPS.

## 2. Préparer le VPS

Copiez les fichiers de l'application dans `/opt/affiliamini`, puis installez son unité systemd et le vhost Nginx fournis dans `deploy/`. Ne déployez pas le `docker-compose.yml` ou le `Caddyfile` sur ce VPS : ils réclament les ports 80 et 443 déjà utilisés par Filyx.

```bash
install -d -m 750 -o affiliamini -g affiliamini /opt/affiliamini/data
install -d -m 750 /etc/affiliamini
cp .env.example /etc/affiliamini/affiliamini.env
chmod 600 /etc/affiliamini/affiliamini.env
```

Éditez uniquement `/etc/affiliamini/affiliamini.env`. Générez les deux secrets une seule fois :

```bash
openssl rand -base64 48
openssl rand -base64 32
```

Placez respectivement les valeurs dans `SESSION_SECRET` et `APP_ENCRYPTION_KEY`. Renseignez ensuite le Client ID, le Client secret et le domaine `.myshopify.com` de la boutique. Ne publiez jamais ce fichier ni ses secrets.

## 3. Configurer l’application Shopify

Dans le tableau de bord Shopify de l’application :

- URL de l’application : `https://app.lessucreriesdeminipouce.fr`
- URL de redirection OAuth : `https://app.lessucreriesdeminipouce.fr/shopify/callback`
- Portée Admin API : `read_orders`, `read_discounts`, `write_discounts`
- Application intégrée : activée si l’interface doit être ouverte depuis l’admin Shopify.
- Webhook `app/uninstalled` : `https://app.lessucreriesdeminipouce.fr/webhooks/app/uninstalled`
- Webhook `orders/paid` : `https://app.lessucreriesdeminipouce.fr/webhooks/orders/paid`

Ces champs doivent correspondre exactement au domaine du certificat HTTPS ; ne mettez ni `localhost`, ni adresse IP, ni slash final.

## 4. Lancer et contrôler

```bash
systemctl daemon-reload
systemctl enable --now affiliamini
nginx -t && systemctl reload nginx
certbot --nginx -d app.lessucreriesdeminipouce.fr
curl -fsS https://app.lessucreriesdeminipouce.fr/api/health
```

Le résultat attendu est un JSON avec `"status":"ok"`. Les données applicatives, y compris le jeton Shopify chiffré, restent dans `/opt/affiliamini/data`.

## 5. Installer l’application dans la boutique

Ouvrez une fois :

```text
https://app.lessucreriesdeminipouce.fr/shopify/install?shop=VOTRE-BOUTIQUE.myshopify.com
```

Shopify demandera les autorisations, puis reviendra vers l’espace marchand. Une fois connecté au panel marchand, `GET /api/shopify/status` confirme l’état de la connexion.

Le retour OAuth ouvre directement le panel marchand pour la personne qui vient d’installer l’application : aucun mot de passe AffiliaMini n’est demandé dans ce parcours Shopify. La page de connexion reste réservée à l’accès direct hors Shopify.

Lorsque l’application est ouverte depuis l’admin Shopify, App Bridge fournit aussi un jeton d’identité vérifié côté serveur. Le marchand retrouve donc son panel sans identifiant AffiliaMini, y compris lors des ouvertures suivantes. Ajoutez `SHOPIFY_EMBEDDED_APP=true` à `/etc/affiliamini/affiliamini.env` lorsque l’application intégrée est activée dans Shopify.

## E-mails transactionnels affiliés

AffiliaMini peut envoyer les confirmations d’inscription, les alertes de nouvelle demande au marchand, les approbations et les codes affiliés.

Pour `lessucreriesdeminipouce@lessucreriesdeminipouce.fr`, créez d’abord cette boîte dans le service e-mail OVH du domaine. Le DNS du domaine autorise les serveurs mail OVH, pas directement le VPS : l’application doit donc employer le SMTP OVH authentifié, plutôt que l’envoi local FilyX. Ajoutez ensuite les valeurs suivantes dans `/etc/affiliamini/affiliamini.env`, puis redémarrez le service :

```text
EMAIL_ENABLED=true
EMAIL_TRANSPORT=smtp
EMAIL_FROM=lessucreriesdeminipouce@lessucreriesdeminipouce.fr
EMAIL_FROM_NAME=AffiliaMini
EMAIL_NOTIFICATION_TO=lessucreriesdeminipouce@gmail.com
SMTP_HOST=smtp.mail.ovh.net
SMTP_PORT=465
SMTP_USER=lessucreriesdeminipouce@lessucreriesdeminipouce.fr
SMTP_APP_PASSWORD=MOT_DE_PASSE_DE_LA_BOITE_OVH
```

Le mot de passe de la boîte reste uniquement dans ce fichier protégé (`/etc/affiliamini/affiliamini.env`, permissions `600`). L’alternative `EMAIL_TRANSPORT=sendmail` réutilise l’agent local FilyX, mais uniquement lorsqu’il est déjà autorisé par SPF/DKIM à envoyer pour le domaine utilisé.

L’onglet **Shopify** du panel permet ensuite de déclencher la synchronisation des commandes et de publier chaque coupon local dans Shopify, sans ligne de commande.

## 6. Opérations Shopify disponibles après installation

- `POST /api/shopify/sync-orders` : lit les commandes Shopify et crée une conversion **en attente** seulement lorsqu’un coupon affilié connu est présent ; une commande déjà importée n’est pas doublonnée.
- `POST /api/shopify/sync-coupon` avec `{ "couponId": "..." }` : crée le coupon dans Shopify puis mémorise son identifiant Shopify.
- Le webhook `orders/paid` importe automatiquement les nouvelles commandes attribuées à un coupon affilié ; le webhook `app/uninstalled` efface immédiatement le jeton OAuth chiffré.

Les conversions importées restent à valider dans le panel avant d’être payables. Les paiements restent des enregistrements manuels : aucun virement n’est jamais initié par l’application.

## Paiements des affiliés

Dans son portail, chaque affilié peut choisir **PayPal**, **virement bancaire** ou **crédit boutique**, puis compléter les coordonnées nécessaires. Les coordonnées sont chiffrées avec `APP_ENCRYPTION_KEY` sur le VPS ; elles ne sont pas renvoyées dans l’API de l’affilié et ne sont affichées qu’au marchand authentifié qui prépare le versement.

Le marchand crée d’abord un versement **à payer**, exécute ensuite le paiement dans PayPal, sa banque ou Shopify, puis utilise **Marquer payé**. Cela ne simule jamais un transfert d’argent. Une automatisation PayPal ultérieure nécessitera un compte PayPal Business, l’API Payouts et une autorisation explicite ; le crédit boutique nécessitera une intégration Shopify dédiée.

## Exploitation

```bash
# Voir les journaux sans afficher les secrets
journalctl -u affiliamini --since "1 hour ago"

# Mettre à jour après une nouvelle version
systemctl restart affiliamini
```

Sauvegardez régulièrement `/opt/affiliamini/data` hors du VPS. Ne supprimez pas ce dossier lors d’une mise à jour : il contient les comptes affiliés, les commissions et la connexion OAuth chiffrée.
