# Déploiement du service "pochoir-api"

Ce service reçoit la configuration terminée depuis le configurateur de pochoir
(`core-industrial.fr` aujourd'hui, potentiellement d'autres pays plus tard),
crée un produit CCV Shop unique au prix exact, y attache le PDF du motif, et
renvoie l'URL du produit pour rediriger le client directement vers le
paiement.

Hébergement : votre mutualisé OVH existant (offre "AGENCY", PHP 8.2),
sous-domaine `makemyownstencils.core-industrial.com`, dossier `stencils`.

**Conçu multi-boutiques dès le départ** : un seul déploiement (ce dossier,
cette base de données) peut servir le FR aujourd'hui et d'autres pays plus
tard (DE, NL, CH...) — chaque boutique a sa propre entrée dans `config.php`
(ses propres clés API CCV, sa propre devise, sa propre formule de prix), et
le script sait automatiquement quelle boutique appelle grâce à l'en-tête
"Origin" du navigateur. Ajouter un pays plus tard = ajouter quelques lignes
dans `config.php`, rien à réenvoyer par FTP.

## 1. Sous-domaine (déjà fait)

`makemyownstencils.core-industrial.com`, dossier racine `stencils`, créé via
l'onglet **Multisite** du manager OVH. Vérifiez que le certificat SSL est
actif (onglet **Certificats SSL**).

## 2. Envoyer les fichiers par FTP

Avec FileZilla, envoyez **tout le contenu** de ce dossier dans `stencils` (le
dossier créé à l'étape 1) :

```
config.example.php
ccv_api_client.php
db.php
create_pochoir_product.php
ping.php
private_files/.htaccess
```

(`schema.sql` n'a pas besoin d'être envoyé par FTP — voir étape 3.)

Puis, **sur le serveur** (via FileZilla : clic droit > Renommer, ou éditer
directement) :

1. Dupliquez `config.example.php` en `config.php` (dans le même dossier).
2. Remplissez les valeurs dans `config.php` (voir étapes 3 et 4 ci-dessous).

## 3. Créer la base de données (fait — reste à exécuter le schéma)

Une seule base pour toutes les boutiques.

1. ✅ Base créée dans le manager OVH, onglet **Bases de données** : hôte
   `jnmhytastencils.mysql.db`, base `jnmhytastencils`, utilisateur
   `jnmhytastencils` (mot de passe : vous seul le connaissez, il n'a jamais
   transité par le chat).
2. ⏳ **Reste à faire** : ouvrez phpMyAdmin depuis cette même page du manager
   OVH (le lien direct avait échoué juste après la création — DNS pas encore
   propagé — réessayez maintenant), sélectionnez la base créée, onglet
   **SQL**, collez le contenu du fichier `schema.sql` et exécutez.
3. Reportez les 4 informations de connexion dans `config.php`
   (`DB_HOST`, `DB_NAME`, `DB_USER`, `DB_PASS` — en dehors du tableau
   `$SHOPS`, ce sont des réglages communs à toutes les boutiques).

## 4. Identifiants API CCV Shop (fait pour le FR)

1. ✅ App **"Api"** (CCV Shop, gratuite) installée sur le back-office FR.
2. ✅ Une clé API a été générée (onglet **Global**, droits **Full Control**).
3. **Reste à faire** : dans `config.php`, repérez l'entrée
   `'https://www.core-industrial.fr' => [...]` du tableau `$SHOPS`, et
   remplacez `apiPublicKey`/`apiSecretKey` par les valeurs affichées sur cette
   page CCV (« API Key » / « API Secret »).
4. Ne les partagez avec personne d'autre, et ne les collez jamais ailleurs
   que dans ce fichier sur le serveur (pas dans un chat, pas dans un email).

## 4bis. Mise à jour de code à ré-uploader (important)

`ccv_api_client.php` a été corrigé après-coup : la première version envoyée
utilisait un mécanisme d'authentification incorrect (Basic Auth). Le vrai
mécanisme CCV Shop (confirmé en direct le 09/09/2026, testé avec succès —
création de produit + attachement de PDF, tous les deux en HTTP 201) utilise
trois en-têtes `x-public`/`x-date`/`x-hash` calculés automatiquement par le
code ; vous n'avez rien à faire vous-même pour ça, mais **si vous aviez déjà
envoyé l'ancien `ccv_api_client.php` par FTP, remplacez-le par cette nouvelle
version** (et remplacez aussi `create_pochoir_product.php`, dont les noms de
champs ont été ajustés en même temps). Les autres fichiers (`db.php`,
`config.example.php`, `ping.php`) n'ont que des ajouts mineurs.

## 5. Vérifier le jeton partagé

Dans `config.php`, `SHARED_CLIENT_TOKEN` est généré aléatoirement par défaut
— une fois copié en `config.php`, **notez la valeur générée** (ou remplacez-la
par la vôtre) : elle devra être recopiée telle quelle dans le script de
CHAQUE configurateur (FR et, plus tard, les autres pays) — pas encore fait
à ce stade, ce sera la prochaine étape une fois ce backend validé.

## 6. Premier test (avant de toucher au configurateur)

```bash
curl https://makemyownstencils.core-industrial.com/ping.php
```

Doit répondre quelque chose comme :
```json
{"ok":true,"service":"pochoir-api","phpVersion":"8.2.x","time":"..."}
```

Si ça fonctionne, testez ensuite la création réelle d'un produit (remplacez
le jeton et le fichier de test) :

```bash
curl -X POST https://makemyownstencils.core-industrial.com/create_pochoir_product.php \
  -H "Origin: https://www.core-industrial.fr" \
  -F "widthCm=21.0" \
  -F "heightCm=14.8" \
  -F "clientToken=VOTRE_JETON_ICI" \
  -F "file=@/chemin/vers/un/test.pdf;type=application/pdf"
```

Réponse attendue :
```json
{"ok":true,"designRef":"PD-XXXXXXXX","productUrl":"https://...","price":103.02,"currency":"EUR"}
```

✅ Les deux appels à l'API CCV (création du produit via `POST /products`, puis
attachement du PDF via `POST /products/:id/productattachments`) ont été
testés en direct le 09/09/2026 avec les vraies clés API du FR — tous les deux
répondent HTTP 201, et le produit de test a été supprimé aussitôt après. Les
noms de champs dans `create_pochoir_product.php` sont donc confirmés, plus
une hypothèse.

Un champ mérite votre attention : `package_id` (obligatoire pour CCV — c'est
la catégorie d'expédition du produit). La valeur `1463659` (« Kartonnen
doos », le seul package existant dans votre boutique FR au moment du test)
est déjà renseignée dans `config.example.php`. Si vous créez d'autres
packages dans le back-office CCV et préférez un autre choix pour les
pochoirs, changez cette valeur dans `config.php`.

Si malgré tout un test renvoie une erreur "Impossible de créer le produit",
ouvrez `https://www.core-industrial.fr/API/Docs/Browser.php` avec vos clés
API et testez un `POST` sur `products` directement pour voir le message
d'erreur exact de CCV (il indique généralement quel champ est
incorrect/manquant).

## 7. Ajouter un nouveau pays plus tard

1. Installez l'app "Api" CCV sur le back-office de ce pays et générez ses
   propres clés API (chaque boutique CCV a les siennes).
2. Établissez la formule de prix réelle dans la devise de ce pays (ne
   recopiez jamais les montants EUR du FR).
3. Dans `config.php`, dupliquez le bloc gabarit déjà présent en commentaire
   dans `config.example.php`, remplissez-le, et retirez le commentaire.
4. C'est tout — rien à réenvoyer par FTP, rien à changer dans la base de
   données (la colonne `shop` s'en charge).
5. Sur la page du configurateur de ce pays, utilisez le même jeton client
   (`SHARED_CLIENT_TOKEN`) et pointez vers la même URL
   (`https://makemyownstencils.core-industrial.com/create_pochoir_product.php`).

## 8. Étape suivante (pas encore faite)

Une fois ce backend validé par le test de l'étape 6, l'étape suivante sera de
modifier le script du configurateur (élément CKEditor "Welcome text",
`id=17079773` pour le FR) pour qu'il appelle cet endpoint à l'export du PDF
et redirige le client vers `productUrl` reçu en réponse, au lieu de proposer
uniquement le téléchargement. On s'y attaquera une fois que vous aurez pu
faire tourner les tests ci-dessus.
