Starseed/docs/migration

Migration Mixgraine → Starseed — Outils

Boîte à outils pour migrer les tiers (clients / fournisseurs / prestataires) depuis le CRM Mixgraine vers Starseed. Tout est autonome : 2 scripts Python + ce README.

Fichier	Rôle
mixgraine-migration-analysis.md	Rapport d'analyse + mapping des champs (à lire en premier)
extract_mixgraine.py	Récupère les tiers depuis l'API Mixgraine et les normalise en JSON
build_tiers_xlsx.py	Produit un Excel avec un onglet par type + filtre « Site manquant »
run.sh	Enchaîne les deux scripts

---

Prérequis

• Python 3 (déjà présent sur un poste Linux/Mac) — vérifier : python3 --version
• openpyxl (pour les Excel) : pip install openpyxl (ou pip install --break-system-packages openpyxl)
• Un token Mixgraine (JWT) valide — voir ci-dessous.

Récupérer le token Mixgraine

1. Ouvrir https://liot.mixsuite.fr dans Chrome, connecté.
2. Ouvrir les outils dev (F12) → onglet Network.
3. Cliquer sur n'importe quelle liste (clients…) pour déclencher un appel api/customer.
4. Cliquer sur la requête → Headers → copier la valeur après authorization: Bearer (la longue chaîne eyJ0eXAi...).

Le token expire au bout de quelques jours. S'il est expiré, en récupérer un nouveau de la même façon. Ne jamais le committer dans git.

---

Lancement

Méthode simple (script tout-en-un)

cd docs/migration
export MIXGRAINE_JWT="eyJ0eXAi...colle-ton-token-ici..."
./run.sh

Ou étape par étape

cd docs/migration
export MIXGRAINE_JWT="eyJ0eXAi..."

# 1) Extraction + normalisation (lent : ~1 requête/seconde, soyez patient)
python3 extract_mixgraine.py
#   -> écrit dans ./mixgraine-export/ : clients.json, suppliers.json,
#      providers.json, referentials.json, extraction-report.txt
#   Test rapide sur 20 tiers : python3 extract_mixgraine.py --limit-ids 20

# 2) Génération de l'Excel de relecture (un onglet par type)
python3 build_tiers_xlsx.py --in mixgraine-export
#   -> mixgraine-export/mixgraine-tiers.xlsx
#      onglets Clients / Fournisseurs / Prestataires + Synthèse,
#      colonne « Site manquant » filtrable, lignes à problème surlignées

---

Ce que tu obtiens

Tout est écrit dans docs/migration/mixgraine-export/ :

• *.json — données normalisées au format Starseed (utilisées plus tard par les commandes d'import).
• mixgraine-tiers.xlsx — un onglet par type (Clients / Fournisseurs / Prestataires) + un onglet Synthèse. Chaque onglet liste toutes les données (une ligne par adresse), avec une colonne Site manquant (OUI/vide) et une colonne Problèmes. Le filtre automatique est activé : clique l'entonnoir de la colonne « Site manquant » → coche OUI pour isoler les adresses sans site.
• extraction-report.txt — compteurs + avertissements.
• cache/ — réponses brutes par tiers (permet de relancer sans tout refetch).

Workflow conseillé : ouvrir mixgraine-tiers.xlsx, filtrer « Site manquant = OUI » dans chaque onglet, corriger la donnée à la source dans Mixgraine (re-cocher les organisations/sites, compléter les emails de facturation), puis relancer (le cache accélère).

---

Notes

• L'extraction est reprenable : si elle s'interrompt, relance-la, elle repart du cache.
• Le débit est volontairement lent (--delay 1.0 par défaut) pour ne pas saturer le serveur. Pour aller plus vite (à tes risques) : --delay 0.3.
• Le dossier mixgraine-export/ n'a pas vocation à être committé (données + token-sensible). Pense à l'ajouter au .gitignore si besoin.