Compare commits

..

1 Commits

Author SHA1 Message Date
Matthieu ca79b8f8e6 chore(migration) : outils d'extraction des tiers Mixgraine (WIP)
Pull Request — Quality gate / Backend (PHP CS + PHPUnit) (pull_request) Failing after 34s
Pull Request — Quality gate / Frontend (lint + Vitest + build) (pull_request) Successful in 1m20s
Boite a outils de migration des tiers (clients / fournisseurs / prestataires)
depuis l'ancien CRM Mixgraine vers Starseed :

- extract_mixgraine.py : extraction + normalisation via l'API Mixgraine (cache
  disque reprenable, debit ~1 req/s, backoff 429/5xx) -> JSON format Starseed
- build_tiers_xlsx.py  : Excel de relecture (1 onglet par type + Synthese,
  colonne 'Site manquant' filtrable)
- run.sh               : enchaine extraction + Excel
- README.md            : prerequis, recuperation du token, lancement
- mixgraine-migration-analysis.md : analyse + mapping des champs Mixgraine -> Starseed

WIP : les commandes d'import Symfony cote Starseed (seed referentiels/sites,
import Client/Supplier/Provider, 2e passe distributeur/courtier) restent a faire.

Le dossier de sortie mixgraine-export/ (IBAN/BIC + PII reelles) est volontairement
.gitignore : reproductible localement via MIXGRAINE_JWT.
2026-06-17 08:38:23 +02:00
22 changed files with 1149 additions and 1450 deletions
+1 -4
View File
@@ -56,10 +56,7 @@ jobs:
uses: shivammathur/setup-php@v2
with:
php-version: '8.4'
# gd requis par phpoffice/phpspreadsheet (export XLSX). Doit etre explicite :
# sinon `composer install` echoue sur la verification de plateforme des que
# le runner ne fournit pas l'extension par defaut (ext-gd manquante).
extensions: pdo, pdo_pgsql, intl, opcache, zip, mbstring, sodium, gd
extensions: pdo, pdo_pgsql, intl, opcache, zip, mbstring, sodium
coverage: none
tools: composer:v2
+18 -13
View File
@@ -78,6 +78,23 @@ return [
],
],
],
// Section "Transport" (M4, ERP-153) : pole logistique, porte le repertoire
// transporteurs. L'item est gate par `transport.carriers.view` ; la section
// disparait automatiquement (SidebarProvider) si le module `transport` est
// desactive ou si l'user n'a pas la permission (Compta / Usine).
[
'label' => 'sidebar.transport.section',
'icon' => 'mdi:truck-outline',
'items' => [
[
'label' => 'sidebar.transport.carriers',
'to' => '/carriers',
'icon' => 'mdi:truck-outline',
'module' => 'transport',
'permission' => 'transport.carriers.view',
],
],
],
// Section "Administration" : regroupe toutes les pages de configuration
// applicative (RBAC, users, sites, audit log).
//
@@ -100,20 +117,8 @@ return [
// individuelles"), ajouter : 'permission' => 'core.admin.access'.
[
'label' => 'sidebar.administration.section',
'icon' => 'mdi:file-settings-cog-outline',
'icon' => 'mdi:cog-outline',
'items' => [
// Transport — Repertoire transporteurs (M4, ERP-164). Rattache a
// l'Administration (premier item) plutot qu'a une section dediee :
// referentiel global de configuration applicative, sans cloisonnement
// par site. Reste gate par sa propre permission `transport.carriers.view`
// (Admin / Bureau / Commerciale) et son module owner `transport`.
[
'label' => 'sidebar.transport.carriers',
'to' => '/carriers',
'icon' => 'mdi:truck-outline',
'module' => 'transport',
'permission' => 'transport.carriers.view',
],
[
'label' => 'sidebar.core.roles',
'to' => '/admin/roles',
+1 -1
View File
@@ -1,2 +1,2 @@
parameters:
app.version: '0.1.132'
app.version: '0.1.129'
+4
View File
@@ -0,0 +1,4 @@
# Donnees extraites de Mixgraine : raisons sociales, contacts, adresses,
# n TVA et coordonnees bancaires (IBAN/BIC) reelles. NE JAMAIS committer.
# Reproductible localement via `MIXGRAINE_JWT=... ./run.sh`.
mixgraine-export/
+80
View File
@@ -0,0 +1,80 @@
# 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)
```bash
cd docs/migration
export MIXGRAINE_JWT="eyJ0eXAi...colle-ton-token-ici..."
./run.sh
```
### Ou étape par étape
```bash
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.
+201
View File
@@ -0,0 +1,201 @@
#!/usr/bin/env python3
# -*- coding: utf-8 -*-
"""
Construit UN classeur Excel de relecture a partir des JSON produits par
extract_mixgraine.py, avec UN ONGLET PAR TYPE :
- Clients
- Fournisseurs
- Prestataires
- Synthese (compteurs)
Chaque onglet liste TOUTES les donnees, une ligne par adresse (les colonnes du
tiers sont repetees). Une colonne « Site manquant » (OUI / vide) + le filtre
automatique Excel permettent de trier en un clic les adresses sans site
(obligatoire cote Starseed — RG-1.10 / 2.06 / 3.03). Les lignes a probleme sont
surlignees en rouge clair.
Usage :
pip install openpyxl
python3 build_tiers_xlsx.py --in mixgraine-export
"""
import argparse
import json
import os
import sys
from collections import Counter
try:
from openpyxl import Workbook
from openpyxl.styles import Font, PatternFill, Alignment
from openpyxl.utils import get_column_letter
except ImportError:
sys.exit("Dependance manquante : pip install openpyxl")
# Compatibilite : les JSON deja generes portent la cle "lauttreeId" ;
# les extractions ulterieures porteront "mixgraineId".
def tid(t):
return t.get("mixgraineId") or t.get("lauttreeId")
def address_problems(addr, target):
pb = []
if not addr.get("sites"):
pb.append("aucun site")
if not addr.get("postalCode"):
pb.append("code postal absent/invalide")
if not addr.get("city"):
pb.append("ville absente")
if not addr.get("street"):
pb.append("rue absente")
if target == "Client" and addr.get("isBilling") and not addr.get("billingEmail"):
pb.append("facturation sans email")
return pb
def tiers_problems(t, target):
pb = []
if not t.get("companyName"):
pb.append("nom absent")
if t.get("paymentType") == "VIREMENT" and not t.get("bank"):
pb.append("VIREMENT sans banque")
if t.get("paymentType") == "LCR" and not t.get("ribs"):
pb.append("LCR sans RIB")
if target == "Provider" and not t.get("sites"):
pb.append("prestataire sans site")
if t.get("categories") == ["A QUALIFIER"]:
pb.append("categorie a qualifier")
return pb
# Colonnes communes (tiers). La colonne « Sites prestataire » n'existe QUE dans
# l'onglet Prestataires (le site y est porte par le tiers, RG-3.03). Pour Clients
# et Fournisseurs, le site est uniquement au niveau adresse (« Sites adresse »).
TIERS_COLS = [
"Réf.", "Société", "Catégories", "Mode paiement", "Banque", "N° TVA",
"N° compte", "Distributeur", "Courtier", "Nb contacts", "Nb RIB",
]
ADDR_COLS = [
"Rue", "Complément", "Code postal", "Ville", "Pays", "Sites adresse",
"Facturation", "Email facturation", "Site manquant", "Problèmes tiers",
]
def headers_for(target):
cols = list(TIERS_COLS)
if target == "Provider":
cols.append("Sites prestataire")
return cols + ADDR_COLS
HEADER_FILL = PatternFill("solid", fgColor="222783")
HEADER_FONT = Font(bold=True, color="FFFFFF")
BAD_FILL = PatternFill("solid", fgColor="FCE4E4") # rouge clair (probleme)
WARN_FILL = PatternFill("solid", fgColor="FFF4D6") # orange clair (site manquant)
def row_for(t, target, addr):
pbt = " ; ".join(tiers_problems(t, target))
base = [
tid(t), t.get("companyName"), ", ".join(t.get("categories") or []),
t.get("paymentType") or "", t.get("bank") or "", t.get("nTva") or "",
t.get("accountNumber") or "", t.get("distributorName") or "",
t.get("brokerName") or "", len(t.get("contacts", [])), len(t.get("ribs", [])),
]
if target == "Provider":
base.append(", ".join(t.get("sites") or []))
if addr is None:
return base + ["", "", "", "", "", "", "", "", "(pas d'adresse)", pbt]
site_missing = "OUI" if not addr.get("sites") else ""
return base + [
addr.get("street") or "", addr.get("streetComplement") or "",
addr.get("postalCode") or "", addr.get("city") or "",
addr.get("country") or "", ", ".join(addr.get("sites") or []),
"oui" if addr.get("isBilling") else "", addr.get("billingEmail") or "",
site_missing, pbt,
]
def build_sheet(wb, title, data, target):
headers = headers_for(target)
site_col = headers.index("Site manquant") + 1
prob_col = len(headers)
ws = wb.create_sheet(title=title)
ws.append(headers)
for c in range(1, len(headers) + 1):
cell = ws.cell(row=1, column=c)
cell.fill = HEADER_FILL
cell.font = HEADER_FONT
cell.alignment = Alignment(vertical="center")
rows = []
for t in data:
for a in (t.get("addresses") or [None]):
rows.append((row_for(t, target, a), address_problems(a, target) if a else ["aucune adresse"]))
for values, pbs in rows:
ws.append(values)
r = ws.max_row
if values[site_col - 1] == "OUI":
ws.cell(row=r, column=site_col).fill = WARN_FILL
if pbs or values[-1]:
ws.cell(row=r, column=prob_col).fill = BAD_FILL
# filtre + gel des en-tetes + largeurs
ws.auto_filter.ref = f"A1:{get_column_letter(len(headers))}{ws.max_row}"
ws.freeze_panes = "A2"
for c, h in enumerate(headers, 1):
sample = [len(str(h))] + [len(str(v[c - 1])) for v, _ in rows[:300]]
ws.column_dimensions[get_column_letter(c)].width = min(max(max(sample) + 2, 10), 50)
return len(rows)
def main():
ap = argparse.ArgumentParser(description="Excel par type (Clients/Fournisseurs/Prestataires) + filtre site manquant")
ap.add_argument("--in", dest="indir", default="mixgraine-export", help="dossier des JSON")
ap.add_argument("--out", default=None, help="chemin du xlsx (defaut: <in>/mixgraine-tiers.xlsx)")
args = ap.parse_args()
def load(name):
path = os.path.join(args.indir, name)
return json.load(open(path, encoding="utf-8")) if os.path.exists(path) else []
sources = [
("Clients", load("clients.json"), "Client"),
("Fournisseurs", load("suppliers.json"), "Supplier"),
("Prestataires", load("providers.json"), "Provider"),
]
wb = Workbook()
wb.remove(wb.active)
summary = []
for title, data, target in sources:
n_rows = build_sheet(wb, title, data, target)
n_tiers = len(data)
n_addr_missing = sum(1 for t in data for a in (t.get("addresses") or []) if not a.get("sites"))
n_nocat = sum(1 for t in data if t.get("categories") == ["A QUALIFIER"])
summary.append((title, n_tiers, n_rows, n_addr_missing, n_nocat))
# onglet Synthese
ws = wb.create_sheet(title="Synthèse")
sh = ["Type", "Tiers", "Lignes (adresses)", "Adresses sans site", "Sans catégorie"]
ws.append(sh)
for c in range(1, len(sh) + 1):
ws.cell(row=1, column=c).fill = HEADER_FILL
ws.cell(row=1, column=c).font = HEADER_FONT
for r in summary:
ws.append(list(r))
for c in range(1, len(sh) + 1):
ws.column_dimensions[get_column_letter(c)].width = 20
# place la synthese en premier
wb.move_sheet("Synthèse", -(len(wb.sheetnames) - 1))
out = args.out or os.path.join(args.indir, "mixgraine-tiers.xlsx")
wb.save(out)
print(f"Ecrit : {out}")
print(f"{'Type':14}{'Tiers':>7}{'Lignes':>8}{'AdrSansSite':>13}{'SansCat':>9}")
for title, n_tiers, n_rows, n_miss, n_nocat in summary:
print(f"{title:14}{n_tiers:7}{n_rows:8}{n_miss:13}{n_nocat:9}")
if __name__ == "__main__":
main()
+496
View File
@@ -0,0 +1,496 @@
#!/usr/bin/env python3
# -*- coding: utf-8 -*-
"""
Extraction + normalisation des tiers (clients / fournisseurs) depuis le CRM
Mixgraine (https://liot.mixsuite.fr) vers le format des entites Client / Supplier
de Starseed.
Principe :
1. Pagine GET /api/customer/?...&page=N pour collecter tous les id.
2. Pour chaque id, recupere la fiche COMPLETE via
PUT /api/customer/{id} body {"__data": true}
(c'est l'appel que fait le front pour PRECHARGER le formulaire d'edition :
il NE MODIFIE RIEN, il renvoie le schema + les valeurs courantes).
3. Resout les selects (paymentType, banque, pays, distributeur, sites...) via
le schema renvoye, puis normalise chaque tiers au format Starseed.
4. Ecrit clients.json, suppliers.json, referentials.json + un rapport.
Caracteristiques :
- Zero dependance (stdlib uniquement).
- Cache disque par id (reprise apres interruption, pas de refetch).
- Debit volontairement lent (--delay) pour ne pas saturer le serveur.
- Backoff automatique sur erreur reseau / 429 / 5xx.
Usage :
export MIXGRAINE_JWT="eyJ0eXAi..." # ton token Bearer (NE PAS committer)
python3 extract_mixgraine.py # extraction complete
python3 extract_mixgraine.py --delay 1.0 # encore plus doux
python3 extract_mixgraine.py --limit-ids 20 # test rapide sur 20 tiers
Le JWT est un secret de session : passe-le par variable d'environnement,
ne l'ecris jamais en dur ici.
"""
import argparse
import json
import os
import re
import sys
import time
import urllib.error
import urllib.parse
import urllib.request
BASE = os.environ.get("MIXGRAINE_BASE", "https://liot.mixsuite.fr")
JWT = os.environ.get("MIXGRAINE_JWT") or os.environ.get("LAUTTREE_JWT", "")
# --- Tables de correspondance Mixgraine -> codes referentiels Starseed ---------
TVA_MODE = {
"France (ventes)": "FRANCE_VENTES",
"Export (ventes)": "EXPORT_VENTES",
"Intracom (ventes)": "INTRACOM_VENTES",
"France (achats)": "FRANCE_VENTES", # pas de mode "achats" au seed -> a trancher
}
PAYMENT_DELAY = {
"15 jours": "J15",
"20 jours": "J20", # absent du seed Starseed -> a creer
"30 jours": "J30",
"A reception": "A_RECEPTION",
"A réception": "A_RECEPTION",
}
PAYMENT_TYPE = {
"LCR non soumise": "NON_SOUMISE", # pas LCR : on n'a pas toujours de RIB (RG-1.13)
"Virement": "VIREMENT",
"Cheque": "CHEQUE",
"Chèque": "CHEQUE",
}
BANK = {
"CIC": "CIC",
"SOCIETE GENERALE": "SG",
"CREDIT AGRICOLE": "CA",
}
CIVILITES = ("Mme", "Mlle", "Mle", "M.", "Mr", "M") # ordre : plus long d'abord
# --- Petites fonctions utilitaires -------------------------------------------
def http(method, path, body=None, tries=5):
"""Appel HTTP avec retry/backoff. Renvoie le JSON decode."""
url = BASE + path
data = json.dumps(body).encode("utf-8") if body is not None else None
headers = {
"Accept": "application/json, text/plain, */*",
"Authorization": "Bearer " + JWT,
}
if data is not None:
headers["Content-Type"] = "application/json"
delay = 2.0
for attempt in range(1, tries + 1):
req = urllib.request.Request(url, data=data, headers=headers, method=method)
try:
with urllib.request.urlopen(req, timeout=60) as resp:
return json.loads(resp.read().decode("utf-8"))
except urllib.error.HTTPError as e:
if e.code in (429, 500, 502, 503, 504) and attempt < tries:
print(f" ! HTTP {e.code} sur {path} -> retry dans {delay:.0f}s", file=sys.stderr)
time.sleep(delay)
delay *= 2
continue
raise
except (urllib.error.URLError, TimeoutError) as e:
if attempt < tries:
print(f" ! reseau ({e}) -> retry dans {delay:.0f}s", file=sys.stderr)
time.sleep(delay)
delay *= 2
continue
raise
raise RuntimeError("echec apres %d tentatives : %s" % (tries, path))
def choices_map(field):
"""Construit {value: label} depuis un champ select du schema."""
out = {}
try:
for c in field["type"]["choices"]:
out[c["value"]] = c["label"]
except (KeyError, TypeError):
pass
return out
def first_id(val):
"""Mixgraine renvoie soit un id, soit [] (vide), soit [{id:..}]."""
if isinstance(val, list):
return val[0]["id"] if val and isinstance(val[0], dict) else None
return val if val not in ("", None) else None
def parse_contact_name(name):
"""'M.ROBERT Florian' -> (lastName='ROBERT', firstName='Florian')."""
if not name:
return None, None
s = name.strip()
for civ in CIVILITES:
if s.upper().startswith(civ.upper()):
s = s[len(civ):].strip(" .")
break
parts = [p for p in s.split() if p]
if not parts:
return None, None
if len(parts) == 1:
return parts[0], None # un seul mot -> nom de famille
return parts[0], " ".join(parts[1:]) # 1er = nom, reste = prenom
def clean_phone(p):
"""Tronque/nettoie pour tenir dans 20 caracteres (limite Starseed)."""
if not p:
return None, None
raw = str(p).strip()
# garde le 1er numero si plusieurs ('... (direct) / ... (standard)')
candidate = re.split(r"[/(]", raw)[0].strip()
cleaned = candidate if candidate else raw
flag = None
if len(cleaned) > 20:
flag = f"tel tronque ({raw!r})"
cleaned = cleaned[:20].strip()
return cleaned, flag
POSTCODE_RE = re.compile(r"^\d{4,5}$")
def clean_postcode(p):
if not p:
return None, None
s = str(p).strip()
if POSTCODE_RE.match(s):
return s, None
return None, f"code postal invalide ({p!r})"
# --- Normalisation d'un tiers -------------------------------------------------
def normalize(record, warnings):
"""record = reponse PUT {__data:true}. Renvoie un dict normalise Starseed."""
fields = record.get("fields", {})
d = record.get("__data", {})
details = record.get("details", {})
geo = details.get("geo", {}) or {}
tid = d.get("id")
name = d.get("name") or d.get("reference")
# --- resolveurs depuis le schema de CE record ---
liab = choices_map(fields.get("liability", {}))
pdelay = choices_map(fields.get("paymentDelay", {}))
ptype = choices_map(fields.get("paymentType", {}))
bank = choices_map(fields.get("accountingBank", {}))
distrib = choices_map(fields.get("distributor", {}))
courtier = choices_map(fields.get("courtier", {}))
cats = choices_map(fields.get("categories", {}))
addr_fields = fields.get("addresses", {}).get("type", {}).get("fields", {})
country_map = choices_map(addr_fields.get("country", {}))
addr_cats = choices_map(addr_fields.get("categories", {}))
carrier_map = choices_map(addr_fields.get("carrierType", {}))
# libelles des sites (organisations)
site_labels = {
"organization_1": addr_fields.get("organization_1", {}).get("label"),
"organization_2": addr_fields.get("organization_2", {}).get("label"),
"organization_3": addr_fields.get("organization_3", {}).get("label"),
}
def map_ref(table, label, what):
if label is None:
return None
code = table.get(label)
if code is None:
warnings.append(f"tiers {tid} ({name}): {what} non mappe : {label!r}")
return code
# --- referentiels comptables ---
tva = map_ref(TVA_MODE, liab.get(first_id(d.get("liability"))), "tvaMode")
delay = map_ref(PAYMENT_DELAY, pdelay.get(first_id(d.get("paymentDelay"))), "paymentDelay")
pay = map_ref(PAYMENT_TYPE, ptype.get(first_id(d.get("paymentType"))), "paymentType")
bnk = map_ref(BANK, bank.get(first_id(d.get("accountingBank"))), "bank")
# --- categories tiers ---
categories = []
for c in d.get("categories", []) or []:
lbl = cats.get(c.get("id"))
if lbl:
categories.append(lbl)
if not categories:
categories = ["A QUALIFIER"] # contrainte min 1 cote Starseed
warnings.append(f"tiers {tid} ({name}): aucune categorie -> 'A QUALIFIER'")
# --- contacts ---
contacts = []
contact_phones = set()
for c in d.get("contacts", []) or []:
last, first = parse_contact_name(c.get("name"))
phone, f1 = clean_phone(c.get("phone"))
mobile, f2 = clean_phone(c.get("mobile"))
if f1:
warnings.append(f"tiers {tid} ({name}): {f1}")
if f2:
warnings.append(f"tiers {tid} ({name}): {f2}")
if not last and not first:
last = "Standard" # RG-1.05/2.04 : au moins un nom
for ph in (phone, mobile):
if ph:
contact_phones.add(re.sub(r"\D", "", ph))
contacts.append({
"mixgraineId": c.get("id"),
"lastName": last,
"firstName": first,
"jobTitle": c.get("function"),
"email": (c.get("email") or None),
"phonePrimary": phone,
"phoneSecondary": mobile,
})
# tel porte par l'objet de base -> dans la liste de contacts (jamais a la racine)
base_phone, fb = clean_phone(d.get("phone"))
if fb:
warnings.append(f"tiers {tid} ({name}): {fb}")
if base_phone and re.sub(r"\D", "", base_phone) not in contact_phones:
if contacts:
# complete le 1er contact sans tel secondaire
for c in contacts:
if not c["phoneSecondary"]:
c["phoneSecondary"] = base_phone
break
else:
contacts[0]["phoneSecondary"] = base_phone
else:
contacts.append({
"mixgraineId": None, "lastName": "Standard", "firstName": None,
"jobTitle": None, "email": None,
"phonePrimary": base_phone, "phoneSecondary": None,
})
# --- emails de facturation (mails[] avec invoice=true) ---
billing_mails = [m["mail"] for m in (d.get("mails") or []) if m.get("invoice") and m.get("mail")]
# --- adresses ---
addresses = []
for a in d.get("addresses", []) or []:
pc, fp = clean_postcode(a.get("postcode"))
if fp:
warnings.append(f"tiers {tid} ({name}): {fp}")
# sites depuis les booleens organization_n
sites = [site_labels[k] for k in ("organization_1", "organization_2", "organization_3")
if a.get(k) and site_labels[k]]
# categories d'adresse
acats = [addr_cats.get(c.get("id")) for c in (a.get("categories") or []) if addr_cats.get(c.get("id"))]
# type d'adresse fournisseur (Rendu/Depart) depuis carrierType
carrier = carrier_map.get(a.get("carrierType"))
supplier_addr_type = {"Rendu": "RENDU", "Départ": "DEPART", "Depart": "DEPART"}.get(carrier)
latlng = geo.get(str(a.get("id"))) or geo.get(a.get("id"))
lat, lng = (latlng.split(",") + [None, None])[:2] if isinstance(latlng, str) else (None, None)
addresses.append({
"mixgraineId": a.get("id"),
"street": a.get("street1"),
"streetComplement": a.get("street2"),
"postalCode": pc,
"city": a.get("city"),
"country": country_map.get(a.get("country"), "France"),
# flags client
"isBilling": bool(a.get("billing")),
"isDelivery": bool(a.get("sales")),
"isProspect": bool(a.get("salesTrip")),
# type fournisseur
"supplierAddressType": supplier_addr_type or "PROSPECT",
"bennes": a.get("benneCount"),
"sites": sites,
"categories": acats,
"billingEmail": (billing_mails[0] if (a.get("billing") and billing_mails) else None),
"contactMixgraineIds": [c.get("id") for c in (a.get("contacts") or [])],
"lat": lat, "lng": lng, # conserve pour info (pas de cible Starseed)
})
# --- RIB (banks[]) ---
ribs = [{
"label": b.get("label") or "Compte principal",
"iban": b.get("iban"),
"bic": b.get("bic"),
} for b in (d.get("banks") or []) if b.get("iban")]
return {
"mixgraineId": tid,
"companyName": name,
"isCustomer": bool(d.get("customer")),
"isSupplier": bool(d.get("supplier")),
"accountNumber": d.get("billingAccount") or None,
"nTva": d.get("vatNumber") or None,
"tvaMode": tva,
"paymentDelay": delay,
"paymentType": pay,
"bank": bnk,
"distributorName": distrib.get(first_id(d.get("distributor"))),
"brokerName": courtier.get(first_id(d.get("courtier"))),
"categories": categories,
"contacts": contacts,
"addresses": addresses,
"ribs": ribs,
}
# --- Recuperation de la liste des id -----------------------------------------
def fetch_ids_for(filters, limit, delay):
"""Pagine /api/customer/ pour un jeu de filtres donne et renvoie la liste d'id."""
fields = urllib.parse.quote('["name"]')
fstr = urllib.parse.quote(json.dumps(filters)) if filters else ""
ids, page, count = [], 0, None
while True:
path = f"/api/customer/?fields={fields}&limit={limit}&order=name&page={page}"
if fstr:
path += f"&filters={fstr}"
resp = http("GET", path)
if count is None:
count = resp.get("count", 0)
batch = resp.get("data", [])
if not batch:
break
ids.extend(r["id"] for r in batch)
page += 1
if count and len(ids) >= count:
break
time.sleep(delay)
return ids
def fetch_all_ids(limit, delay):
"""Collecte les id par groupe (client / fournisseur / prestataire) + union.
On s'appuie sur l'APPARTENANCE aux listes filtrees pour classer chaque tiers,
plus fiable que les flags parfois absents du formulaire __data.
"""
print(" - clients (customer=true)")
customer_ids = set(fetch_ids_for({"customer": True}, limit, delay))
print(f" {len(customer_ids)}")
print(" - fournisseurs (supplier=true)")
supplier_ids = set(fetch_ids_for({"supplier": True}, limit, delay))
print(f" {len(supplier_ids)}")
print(" - prestataires (prestataire=true) -> ranges en fournisseurs")
prestataire_ids = set(fetch_ids_for({"prestataire": True}, limit, delay))
print(f" {len(prestataire_ids)}")
all_ids = sorted(customer_ids | supplier_ids | prestataire_ids)
print(f" total tiers distincts : {len(all_ids)}")
return all_ids, customer_ids, supplier_ids, prestataire_ids
# --- Main ---------------------------------------------------------------------
def main():
ap = argparse.ArgumentParser(description="Extraction Mixgraine -> format Starseed")
ap.add_argument("--out", default="mixgraine-export", help="dossier de sortie")
ap.add_argument("--delay", type=float, default=1.0, help="pause (s) entre chaque fiche (defaut 1 req/s)")
ap.add_argument("--limit", type=int, default=200, help="taille de page pour la liste")
ap.add_argument("--limit-ids", type=int, default=0, help="ne traiter que N tiers (test)")
args = ap.parse_args()
if not JWT:
sys.exit("ERREUR : export MIXGRAINE_JWT='<ton token>' avant de lancer.")
cache_dir = os.path.join(args.out, "cache")
os.makedirs(cache_dir, exist_ok=True)
print("== Etape 1 : liste des id (par groupe) ==")
ids, customer_ids, supplier_ids, prestataire_ids = fetch_all_ids(args.limit, args.delay)
if args.limit_ids:
ids = ids[:args.limit_ids]
print(f"{len(ids)} tiers a recuperer.\n")
print("== Etape 2 : fiches detaillees (lent, soyez patient) ==")
raw_by_id = {}
for n, tid in enumerate(ids, 1):
cache_file = os.path.join(cache_dir, f"{tid}.json")
if os.path.exists(cache_file):
with open(cache_file, encoding="utf-8") as f:
raw_by_id[tid] = json.load(f)
continue
rec = http("PUT", f"/api/customer/{tid}", body={"__data": True})
with open(cache_file, "w", encoding="utf-8") as f:
json.dump(rec, f, ensure_ascii=False)
raw_by_id[tid] = rec
if n % 25 == 0 or n == len(ids):
print(f" {n}/{len(ids)} fiches")
time.sleep(args.delay)
print("\n== Etape 3 : normalisation ==")
warnings = []
clients, suppliers, providers = [], [], []
cat_set, site_set = set(), set()
for tid in ids:
norm = normalize(raw_by_id[tid], warnings)
# classification par APPARTENANCE aux listes filtrees (source fiable) :
# customer -> Client (module Commercial)
# supplier -> Supplier (module Commercial)
# prestataire -> Provider (module Technique) — entite dediee, PAS un Supplier
is_customer = tid in customer_ids or norm["isCustomer"]
is_supplier = tid in supplier_ids or norm["isSupplier"]
is_prestataire = tid in prestataire_ids
norm["isCustomer"] = is_customer
norm["isSupplier"] = is_supplier
norm["isPrestataire"] = is_prestataire
# Provider porte les sites DIRECTEMENT (RG-3.03) : on agrege les sites des adresses.
norm["sites"] = sorted({s for a in norm["addresses"] for s in a["sites"]})
cat_set.update(norm["categories"])
for a in norm["addresses"]:
site_set.update(a["sites"])
cat_set.update(a["categories"])
# un tiers peut cumuler plusieurs roles -> cree dans chaque table concernee
if is_customer:
clients.append(norm)
if is_supplier:
suppliers.append(norm)
if is_prestataire:
providers.append(norm)
if not (is_customer or is_supplier or is_prestataire):
clients.append(norm) # filet de securite : client par defaut
warnings.append(f"tiers {tid} ({norm['companyName']}): aucun flag -> client par defaut")
referentials = {
"categories": sorted(cat_set),
"sites": sorted(site_set),
"tvaModes": sorted(set(TVA_MODE.values())),
"paymentDelays": sorted(set(PAYMENT_DELAY.values())),
"paymentTypes": sorted(set(PAYMENT_TYPE.values())),
"banks": sorted(set(BANK.values())),
}
def dump(fname, obj):
with open(os.path.join(args.out, fname), "w", encoding="utf-8") as f:
json.dump(obj, f, ensure_ascii=False, indent=2)
dump("clients.json", clients)
dump("suppliers.json", suppliers)
dump("providers.json", providers)
dump("referentials.json", referentials)
with open(os.path.join(args.out, "extraction-report.txt"), "w", encoding="utf-8") as f:
f.write(f"Tiers traites : {len(ids)}\n")
f.write(f"Clients : {len(clients)}\n")
f.write(f"Fournisseurs : {len(suppliers)}\n")
f.write(f"Prestataires : {len(providers)}\n")
f.write(f"Categories uniques : {len(referentials['categories'])}\n")
f.write(f"Sites uniques : {referentials['sites']}\n")
f.write(f"Avertissements : {len(warnings)}\n\n")
f.write("\n".join(warnings))
print(f"\nTermine.")
print(f" clients.json : {len(clients)}")
print(f" suppliers.json : {len(suppliers)}")
print(f" providers.json : {len(providers)} (prestataires)")
print(f" referentials.json : {len(referentials['categories'])} categories, sites {referentials['sites']}")
print(f" avertissements : {len(warnings)} (voir extraction-report.txt)")
print(f"Sortie dans : {os.path.abspath(args.out)}")
if __name__ == "__main__":
main()
@@ -0,0 +1,306 @@
# Migration Mixgraine → Starseed — Analyse des tiers (clients / fournisseurs)
> Sources analysées (exports Mixgraine triés par groupe) :
> - `client.json.json` — **1023 clients** (`customer=true`)
> - `fournisseur.json` — **306 fournisseurs** (`supplier=true`)
> - `fournisseur-client.json` — **106 tiers mixtes** (`customer=true` ET `supplier=true`)
>
> Cible : module `Commercial` de Starseed — entités `Client` / `Supplier` et leurs sous-entités `*Contact`, `*Address`, `*Rib`.
> Date d'analyse : 2026-06-16. (Remplace l'analyse initiale faite sur `customer.json`, 737 tiers, où la classification était absente.)
>
> 🔑 **Source de migration recommandée : l'endpoint unitaire, pas l'export en masse.**
> Les exports CSV/JSON en masse sont **incomplets** : ni RIB/IBAN, ni N° TVA, ni banque de virement, ni rattachement aux sites. Toutes ces données existent dans l'endpoint détail `GET /api/customer/{id}` et surtout dans `PUT /api/customer/{id}` avec `{"__data":true}` (renvoie le **schéma de formulaire complet + les valeurs**). Procédure : paginer `GET /api/customer/?...&limit=...&page=N` pour récupérer les `id`, puis appeler l'endpoint détail pour chaque id. Cf. § 9.
---
## 1. Synthèse
L'export est désormais **trié par groupe** : la distinction client / fournisseur est nette, ce qui lève le principal point bloquant de l'analyse précédente. **1435 tiers distincts** (aucun recoupement d'id entre les trois fichiers).
| Groupe source | Tiers | Devient dans Starseed |
|---|---|---|
| `client.json.json` (`customer=true`) | 1023 | `Client` |
| `fournisseur.json` (`supplier=true`) | 306 | `Supplier` |
| `fournisseur-client.json` (`customer=true` + `supplier=true`) | 106 | **`Client` ET `Supplier`** (cf. § 4) |
| **prestataires** (`prestataire=true`, vue séparée Mixgraine) | à extraire via l'API (filtre `prestataire:true`) | **`Provider`** (module Technique, M3) |
> ✅ Les **prestataires** sont un 4e type de tiers, géré dans une vue dédiée de Mixgraine mais sur le **même endpoint** `/api/customer/` (filtre `{"prestataire":true}`). Côté Starseed, ils ont une **entité dédiée** : `Provider` (module **Technique**, `src/Module/Technique/Domain/Entity/Provider.php`), jumelle du `Supplier`, avec `ProviderContact` / `ProviderAddress` / `ProviderRib`. **Ils ne deviennent donc PAS des `Supplier`.** Particularités vs Supplier : pas d'onglet Information (entité minimale nom + comptabilité) et les **sites sont rattachés directement au prestataire** (M2M `provider_site`, min 1, RG-3.03) — le script agrège donc les sites des adresses au niveau du prestataire. Catégories de type **PRESTATAIRE** exigées (RG-3.09). Le script collecte les prestataires via leur liste dédiée et produit `providers.json` (§ 9).
Volumétrie migrable (tous groupes confondus) :
| Objet source | Quantité | Cible Starseed |
|---|---|---|
| Tiers racine | 1435 | `Client` (1129) + `Supplier` (412) = **1541 entités** créées (les 106 mixtes comptent double) |
| Adresses | **2282** | `ClientAddress` / `SupplierAddress` |
| Contacts | **2704** | `ClientContact` / `SupplierContact` |
| RIB | **0** | *rien à migrer (ni IBAN ni BIC dans l'export)* |
Détail par groupe :
| Groupe | Tiers | Adresses | Contacts | Avec tél | Avec catégorie | Avec type paiement |
|---|---|---|---|---|---|---|
| Clients | 1023 | 1125 | 1279 | 1023 (100 %) | 648 (63 %) | 599 |
| Fournisseurs | 306 | 585 | 758 | 306 (100 %) | 92 (30 %) | 283 |
| Mixtes | 106 | 572 | 667 | 106 (100 %) | 37 (35 %) | 95 |
Points de décision restants (détaillés plus bas) :
1. **Les 106 tiers mixtes** doivent être dédoublés en un `Client` + un `Supplier` (le modèle Starveed sépare les deux entités). § 4.
2. **Référentiels à compléter** : `paymentDelay` (« 20 jours » absent du seed), `tvaMode` (Intracom/Export/achats), mapping des ~100 catégories. § 5.
3. **Site obligatoire par adresse** (min 1) — notion toujours absente de l'export. § 6.
---
## 2. Structure de l'export
Chaque ligne = un tiers. Les champs `addresses.*` et `contacts.*` sont des **listes parallèles** (un tiers peut avoir plusieurs adresses / contacts).
Qualité des données (tous groupes) :
- **Téléphone racine** : rempli sur **100 %** des tiers (1435/1435).
- **Emails contacts** : 1257 présents, **1256 valides** (1 invalide).
- **Codes postaux** : 2282 présents, **10 invalides** à nettoyer : `.` (×3), `B.5300`, `?`, `684`, `854300`, etc. (sinon 422 sur la regex 4-5 chiffres RG-1.09/2.05).
- **Catégories** : 55 % des tiers en ont au moins une (45 % sans) ; **92 % des adresses** ont une catégorie (2104/2282).
- **Noms de contact** : format « `CIVILITÉ NOM PRÉNOM` » (`M `, `Mme`, `M.`) → à parser pour `lastName` / `firstName`.
Pays des adresses : FR (2266), ES (11), BE (2), NL (2), PT (1).
---
## 3. Mapping champ par champ
Légende : ✅ champ existant · ⚠️ migrable avec transformation · ❌ pas de cible (donnée perdue) · 🔒 contrainte de validation à gérer.
### 3.1 Niveau Tiers → `Client` / `Supplier`
| Champ Mixgraine | Cible Starseed | Statut | Note de transformation |
|---|---|---|---|
| `name` / `reference` | `companyName` (≤180) | ✅ | Vérifier l'unicité (index partiel `LOWER(company_name)`). Risque : un même nom présent en client ET fournisseur reste OK (tables distinctes) ; doublons intra-table à contrôler. |
| `phone` (tél de l'objet de base) | `*Contact.phonePrimary` | ⚠️ | **Migré dans la liste de contacts** (cf. § 3.3bis), jamais au niveau racine. Rempli à 100 %. |
| `categoriesStr` / `category.name` | `categories` (M2M `Category`) | ⚠️🔒 | **Min 1 obligatoire**. ~100 valeurs distinctes à mapper vers le référentiel `Category` (§ 5.1). Attention `Courtier`/`Distributeur` (cf. broker/distributor). |
| `liability.name` | `tvaMode` | ⚠️ | `France (ventes)``FRANCE_VENTES` (1426), `Intracom (ventes)``INTRACOM_VENTES` (6), `Export (ventes)``EXPORT_VENTES` (2), `France (achats)`→**pas de mode « achats » au seed** (1 cas). |
| `paymentDelay.label` | `paymentDelay` | ⚠️🔒 | `15 jours``J15` (1376), `30 jours``J30` (43), `A réception``A_RECEPTION` (1), **`20 jours` (15)→ code `J20` à créer** (absent du seed). |
| `paymentType.label` | `paymentType` | ⚠️🔒 | `LCR non soumise`→**à trancher** (`LCR` impose ≥1 RIB, or 0 RIB → préférer `NON_SOUMISE`), `Virement``VIREMENT` (95, **exige `bank`** absente de la source), `Chèque``CHEQUE` (28). |
| `billingAccount` | `accountNumber` (≤40) | ✅ | Peu rempli. |
| `distributor.name` | `distributor` (FK auto-réf. `Client`) | ⚠️ | Suppose que le distributeur existe comme `Client`. Pas d'équivalent côté `Supplier`. |
| `courtier.id` / `courtier.name` | `broker` (FK auto-réf.) | ⚠️ | À vérifier sur les nouveaux exports (vide dans l'ancien). Mutuellement exclusif avec `distributor` (RG-1.03). |
| `customer` / `supplier` | choix de l'entité cible (`Client` vs `Supplier`) | ⚠️ | **Sert au routage**, pas stocké tel quel. |
| `tiersIndexable`, `prestataire`, `coreLocked`, `isOgm`, `maxOwed`, `autoGenerateInvoice` | — | ❌ | Flags Mixgraine sans équivalent métier. |
| `organization1..3` / `organizationsStr` | — | ❌ | Notion d'organisation/agence absente du modèle. |
| `articlesSold.*` | — | ❌ | Relève du catalogue, hors périmètre Client/Supplier. |
| `siren`, `nTva`, `bank` | `siren`, `nTva`, `bank` | ❌ | **Non présents dans l'export** → resteront vides. |
### 3.2 Niveau Adresse → `ClientAddress` / `SupplierAddress`
| Champ Mixgraine | Cible Starseed | Statut | Note |
|---|---|---|---|
| `addresses.street1` | `street` (≤255) | ✅ | Obligatoire. |
| `addresses.street2` | `streetComplement` (≤255) | ✅ | |
| `addresses.postcode` | `postalCode` (≤20, regex 4-5 chiffres) | ⚠️ | 10 valeurs à nettoyer. |
| `addresses.city` | `city` (≤120) | ✅ | Obligatoire. |
| `addresses.country` | `country` (≤80, défaut « France ») | ⚠️ | Convertir code ISO → libellé (`FR`→France, `ES`→Espagne, `BE`→Belgique, `NL`→Pays-Bas, `PT`→Portugal). |
| `addresses.lat` / `addresses.lng` | — | ❌ | Coordonnées GPS perdues (pas de champ géo). |
| `addresses.billing` (true) | `isBilling` (Client) | ⚠️🔒 | Si `true`, `billingEmail` **obligatoire** (RG-1.11), absent de la source → soit ne pas marquer facturation, soit collecter l'email. |
| `addresses.sales` | `isDelivery` (Client) | ⚠️ | |
| `addresses.purchase` | type adresse (Supplier : `DEPART`/`RENDU`) | ⚠️ | Côté fournisseur, l'adresse a un enum `PROSPECT`/`DEPART`/`RENDU`. |
| `addresses.salesTrip` | `isProspect` (?) | ⚠️ | Sémantique « tournée commerciale » à confirmer. |
| `addresses.benneCount` | `bennes` (SupplierAddress) | ⚠️ | Souvent vide. |
| `addresses.carrierTypeStr`, `addresses.name`, `addresses.distances` | — | ❌ | Sans cible. |
| `addresses.categories.name` | `categories` (M2M adresse) | ⚠️🔒 | 92 % des adresses en ont une. **Min 1 obligatoire** côté `ClientAddress`. ⚠️ Codes `DISTRIBUTEUR`/`COURTIER` **interdits** au niveau adresse (RG-1.29). |
| — (aucun) | `sites` (M2M, **min 1**) | 🔒 | **Notion absente de l'export** — bloquant majeur (§ 6). |
### 3.3 Niveau Contact → `ClientContact` / `SupplierContact`
| Champ Mixgraine | Cible Starseed | Statut | Note |
|---|---|---|---|
| `contacts.name` | `lastName` / `firstName` (≤120) | ⚠️ | Parser « CIVILITÉ NOM PRÉNOM » : retirer civilité, 1er token = `lastName`, reste = `firstName`. Au moins l'un des deux requis (RG-1.05/2.04). |
| `contacts.function` | `jobTitle` (≤120) | ✅ | |
| `contacts.email` | `email` (≤180) | ✅ | 99,9 % valides. |
| `contacts.phone` | `phonePrimary` (≤20) | ✅ | |
| `contacts.mobile` | `phoneSecondary` (≤20) | ✅ | |
| `contacts.fax` | — | ❌ | Pas de champ fax dans les contacts Starseed. |
| `contacts.siege` | — | ❌ | Notion « contact siège » non modélisée. |
| `addresses.contacts.*` | `*Address.contacts` (M2M) | ⚠️ | Rattachement contact↔adresse via les ids `addresses.contacts.id`. |
### 3.3bis — Règle : le contact porté par l'objet de base va dans la liste de contacts
Starseed n'a **aucun champ contact au niveau racine** de `Client`/`Supplier`. Tout doit atterrir dans la collection `*Contact` :
- Le bloc `contacts.*` (nom, fonction, email, tél, mobile) → une entrée `*Contact` par contact.
- Le `phone` de l'objet de base (rempli à 100 %) → reporté sur un contact :
- si le numéro figure déjà sur un contact → ne rien créer (déduplication) ;
- s'il diffère → l'ajouter comme `phoneSecondary` d'un contact existant ;
- si le tiers **n'a aucun contact****créer un contact « Standard »** (`lastName = "Standard"` pour respecter RG-1.05/2.04) portant ce `phonePrimary`.
Conséquence : aucun tiers ne perd son téléphone, et rien n'est stocké au niveau racine (conforme au modèle Starseed).
### 3.4 Niveau RIB → `ClientRib` / `SupplierRib`
**Disponible via l'endpoint unitaire** (champ `banks[]`), absent de l'export en masse. Mapping direct :
| Champ Mixgraine (`banks[]`) | Cible Starseed (`*Rib`) | Statut |
|---|---|---|
| `banks[].label` | `label` (≤120) | ✅ |
| `banks[].iban` | `iban` (≤34) | ✅ (validé Assert\Iban) |
| `banks[].bic` | `bic` (≤20) | ✅ (validé Assert\Bic) |
⚠️ Toujours mapper `paymentType="LCR non soumise"` vers `NON_SOUMISE` (et pas `LCR`) : les tiers sans `banks[]` violeraient sinon RG-1.13/2.08 (min 1 RIB).
### 3.5 Champs supplémentaires de l'endpoint unitaire (absents de l'export en masse)
| Champ Mixgraine (détail / `__data`) | Cible Starseed | Statut | Note |
|---|---|---|---|
| `vatNumber` | `nTva` (≤40) | ✅ | N° TVA. |
| `accountingBank` (1=CIC, 2=SOCIETE GENERALE, 3=CREDIT AGRICOLE) | `bank` (FK) | ✅ | **Correspond au seed Starseed** (CIC/SG/CA). Banque de virement. |
| `courtier` (FK select, 18 valeurs) | `broker` (FK auto-réf.) | ✅ | Courtier réel (≠ catégorie « Courtier »). Exclusif avec `distributor` (RG-1.03). |
| `distributor` (FK select, 14 valeurs) | `distributor` (FK auto-réf.) | ✅ | Distributeur réel. |
| `mails[]` {`mail`, `invoice`} | `ClientAddress.billingEmail` / secondaire | ⚠️ | Emails d'envoi de documents ; `invoice=true` → email de facturation (RG-1.11). |
| address `carrierType` (1=Rendu, 2=Départ) | `SupplierAddress.addressType` (RENDU/DEPART) | ⚠️ | Radio exclusif côté fournisseur (RG-2.09). |
| address `organization_1/2/3` | `*Address.sites` (M2M) | ✅ | **Les sites** (cf. § 6). |
| address `hasBenne` / `benneCount` | `SupplierAddress.bennes` | ⚠️ | Nombre de bennes. |
| address `validated` | — | ❌ | « Adresse vérifiée », pas de cible. |
| `isDistributor`, `directBilling`, `distributorDirectOrder`, `newGuarantees`, `commentMail`, `zoneChartering(2)`, `emailDocument*` | — | ❌ | Champs Mixgraine sans équivalent métier. |
---
## 4. Tiers mixtes (client + fournisseur) — 106 cas
Les 106 tiers du fichier `fournisseur-client.json` sont **à la fois client et fournisseur**. Le modèle Starseed sépare strictement `Client` et `Supplier` (deux tables, deux jeux de sous-entités). Deux options :
- **(Recommandé)** Créer **deux entités** par tiers mixte : un `Client` et un `Supplier`, chacun avec sa copie des adresses/contacts. C'est cohérent avec le modèle, au prix d'une duplication (à reconcilier plus tard si un lien inter-entités est ajouté).
- Choisir une seule face (client OU fournisseur) selon l'usage dominant — risque de perte d'information.
Impact volumétrie : 1023 + 106 = **1129 `Client`**, 306 + 106 = **412 `Supplier`**.
---
## 5. Référentiels à préparer avant import
### 5.1 Catégories (`Category`)
Situation nettement meilleure que l'export initial : **55 % des tiers** et **92 % des adresses** portent une catégorie. L'export contient **~100 valeurs distinctes** (top : Eleveur 392, Semencier 61, Coopérative 53, Courtier 38, Négociant 30, …, puis une longue traîne de catégories « fournisseur » métier : Transports, Informatique, Garagistes, Banques…).
À faire :
- **Construire le référentiel `Category`** depuis ces valeurs (dédoublonner casse/accents, ex. `Courtier`/`COURTIERS`).
- **Politique pour les 45 % sans catégorie** : attribuer une catégorie par défaut (ex. `À QUALIFIER`) pour satisfaire la contrainte min 1.
- **Niveau adresse** : exclure `DISTRIBUTEUR`/`COURTIER` (interdits RG-1.29) — les router vers les FK `distributor`/`broker` ou la catégorie tiers.
- Distinguer catégories **type CLIENT** vs **type FOURNISSEUR** (RG-2.10 : une catégorie fournisseur est exigée sur un `Supplier`).
### 5.2 Référentiels comptables
| Référentiel | Valeurs export | Action |
|---|---|---|
| `paymentDelay` | 15 jours, 30 jours, **20 jours**, A réception | Le seed n'a que `J15`/`J30`/`A_RECEPTION`**créer `J20`**. |
| `paymentType` | LCR non soumise, Virement, Chèque | Mapper `LCR non soumise``NON_SOUMISE` (éviter la contrainte RIB) ; `Virement``VIREMENT` (mais `bank` absente → soit la laisser vide en assouplissant RG-1.12, soit collecter). |
| `tvaMode` | France (ventes), Intracom (ventes), Export (ventes), **France (achats)** | Mapper sur `FRANCE_VENTES`/`INTRACOM_VENTES`/`EXPORT_VENTES` ; pas de mode « achats » au seed (1 cas) → décision. |
---
## 6. Sites — résolu via les « organisations » Mixgraine
Chaque `ClientAddress`/`SupplierAddress` doit référencer **au moins un `Site`** (RG-1.10/2.06). Cette notion **existe dans Mixgraine** sous le nom d'**organisations**, visible dans l'endpoint unitaire :
- au niveau tiers : `organizationsStr` (ex. `"Châtellerault, Saint-Jean, Pommevic"`) ;
- au niveau adresse : trois booléens `organization_1` / `organization_2` / `organization_3` étiquetés **Châtellerault / Saint-Jean / Pommevic** ;
- le bloc `addresses.distances` donne même la distance de l'adresse vers chacun de ces 3 sites.
**Les 3 sites à créer dans Starseed** : `Châtellerault`, `Saint-Jean`, `Pommevic`. Le rattachement adresse↔site se reconstruit depuis les booléens `organization_n=true`. Pour une adresse sans aucune organisation cochée, prévoir un site par défaut (à décider).
⚠️ Ce rattachement n'est lisible que via l'endpoint unitaire — raison de plus pour migrer depuis le détail (cf. § 9).
---
## 7. Synthèse des pertes de données
Perdus si non traités en amont : coordonnées GPS (`lat`/`lng`), fax des contacts, contact siège, articles vendus, « adresse vérifiée », et divers flags Mixgraine (`isOgm`, `maxOwed`, `directBilling`, `zoneChartering`, `commentMail`).
Champs cibles qui resteront vides (vraiment absents de la source, même au détail) : `siren` (le `vatNumber` alimente `nTva`, mais pas de SIREN distinct).
> Note : `nTva`, `bank` et les `*Rib` ne sont **plus** des pertes — ils sont disponibles via l'endpoint unitaire (§ 3.4 / § 3.5). Ils n'étaient absents que de l'export en masse.
---
## 7bis. Excel de relecture (un onglet par type)
Beaucoup d'adresses n'ont **aucun site** rattaché (les organisations ne sont pas cochées dans Mixgraine), et d'autres trous existent (CP invalide, facturation sans email…). Avant tout import, on produit un classeur via `build_tiers_xlsx.py` : **`mixgraine-tiers.xlsx`**.
- Un onglet **Synthèse** (compteurs) + un onglet par type : **Clients**, **Fournisseurs**, **Prestataires**.
- Chaque onglet liste toutes les données, **une ligne par adresse** (colonnes du tiers répétées).
- Colonne **Site manquant** (OUI/vide) + **filtre automatique** → un clic pour isoler les adresses sans site. Colonne **Problèmes** pour le reste. Lignes à problème surlignées.
Chiffres réels (extraction 2026-06-16, 1442 tiers) :
| Type | Tiers | Lignes (adresses) | Adresses sans site | Sans catégorie |
|---|---|---|---|---|
| Clients | 1129 | 1697 | 1111 | 444 (39 %) |
| Fournisseurs | 412 | 1157 | 612 | 283 (68 %) |
| Prestataires | 300 | 333 | 0 | 8 (2 %) |
| **Total** | **1841\*** | **3187** | **1723** | **735** |
\* mixtes comptés en Client + Fournisseur. RIB extraits : 90. Tiers totalement bloqués : 90.
Motifs de blocage détectés :
| Niveau | Motif bloquant |
|---|---|
| Adresse | **aucun site rattaché** (RG-1.10/2.06/3.03), code postal absent/invalide, ville absente, rue absente, facturation sans email (client) |
| Tiers | nom absent, `VIREMENT` sans banque, `LCR` sans RIB, **prestataire sans aucun site** (RG-3.03), catégorie `À QUALIFIER` |
Filtrer « Site manquant = OUI » dans chaque onglet permet de corriger la donnée à la source (re-cocher les organisations dans Mixgraine, compléter les emails) **avant** de relancer l'import (le cache accélère).
---
## 8. Séquence d'import recommandée
1. **Extraire la donnée complète** depuis l'endpoint unitaire (§ 9) — pas depuis l'export en masse.
2. **Relecture** : `build_tiers_xlsx.py``mixgraine-tiers.xlsx` (un onglet par type, filtre « Site manquant »), faire corriger à la source (§ 7bis).
2. **Sites** : créer les 3 sites (Châtellerault, Saint-Jean, Pommevic) + un site par défaut éventuel (§ 6).
3. **Référentiels** : créer/compléter `Category` (~100 valeurs + défaut `À QUALIFIER`), `paymentDelay` (ajouter `J20`), `tvaMode`, vérifier `paymentType`, `bank` (CIC/SG/CA déjà OK) (§ 5).
4. **Nettoyer** : 10 codes postaux invalides, parser les noms de contacts (civilité), convertir codes pays ISO → libellés (table fournie par le schéma `country`).
5. **Importer dans l'ordre** : référentiels + sites → tiers → adresses (+ rattachement site via `organization_n`) → contacts (+ rattachement adresse + tél de l'objet de base) → RIB (`banks[]`).
6. **Tiers mixtes** (106) : créer Client + Supplier (§ 4).
7. **Gérer les 422 attendus** : adresses `isBilling=true` sans `billingEmail` ; `paymentType=VIREMENT` sans `bank`.
---
## 9. Stratégie d'extraction via l'API Mixgraine
L'export en masse est insuffisant (§ entête). La donnée complète s'obtient en deux temps depuis `https://liot.mixsuite.fr` (auth : `Authorization: Bearer <JWT>`) :
1. **Lister les ids par groupe, page par page** :
`GET /api/customer/?fields=["name"]&filters={...}&limit=200&order=name&page=N`
La réponse porte `count` (total) et `data[].id`. On pagine **trois listes filtrées** puis on fait l'union dédupliquée :
- `{"customer":true}` → clients (`Client`),
- `{"supplier":true}` → fournisseurs (`Supplier`),
- `{"prestataire":true}` → prestataires (`Provider`, module Technique).
La **classification se fait par appartenance** à ces listes (plus fiable que les flags du formulaire `__data`) : un id dans `customer` ET `supplier` = mixte (Client + Supplier) ; un id dans `prestataire` = `Provider`. Le script produit `clients.json`, `suppliers.json`, `providers.json` + `referentials.json`.
2. **Récupérer le détail complet de chaque tiers** :
`GET /api/customer/{id}` (objet riche : contacts, addresses, banks, liability, paymentType…)
ou `PUT /api/customer/{id}` avec corps `{"__data":true}` qui renvoie en plus le **schéma de formulaire** (libellés des organisations/sites, choix des référentiels, FK distributor/courtier) **et** les valeurs sous `__data`.
Champs clés présents uniquement au détail : `banks[]` (RIB), `vatNumber`, `accountingBank`, `courtier`, `distributor`, `mails[]`, `addresses[].organization_1/2/3` (sites), `addresses[].carrierType`, `details.geo` (lat/lng par adresse).
> ⚠️ Le JWT fourni est un secret de session : ne pas le committer dans le repo. À passer en variable d'environnement au script d'extraction.
---
## 📦 Tickets Lesstime générés
TaskGroup Lesstime : **#32 — Migration tiers Mixgraine → Starseed** (projet STARSEED / ERP)
| # | Ticket | Réf. | Effort | Tag |
|---|---|---|---|---|
| 1.1 | Extraire et normaliser les tiers Mixgraine en JSON | ERP-174 | M | Backend |
| 1.2 | Seeder les référentiels et les 3 sites | ERP-175 | M | Backend |
| 1.3 | Importer les clients (Commercial) + adresses/contacts/RIB | ERP-176 | L | Backend |
| 1.4 | Importer les fournisseurs (Commercial) + adresses/contacts/RIB | ERP-177 | M | Backend |
| 1.5 | Importer les prestataires (Technique/Provider) | ERP-178 | M | Backend |
| 1.6 | Relier distributeurs/courtiers, traiter les mixtes et vérifier | ERP-179 | M | Backend |
Tous au statut **Prêt à dev**. Prochaine action : lancer le 1.1 (le script `extract_mixgraine.py` est déjà écrit, reste à le tester avec un vrai token).
---
*Document basé sur l'analyse des exports en masse `client.json.json` / `fournisseur.json` / `fournisseur-client.json` et sur les réponses des endpoints `/api/customer/` (liste), `/api/customer/{id}` (détail) et `PUT /api/customer/{id}` (`__data`). Aucune donnée n'a été importée — rapport d'analyse préalable.*
+25
View File
@@ -0,0 +1,25 @@
#!/usr/bin/env bash
# Enchaine extraction Mixgraine + generation des Excel de relecture.
# Usage : export MIXGRAINE_JWT="eyJ..." && ./run.sh
set -euo pipefail
cd "$(dirname "$0")"
if [[ -z "${MIXGRAINE_JWT:-}" ]]; then
echo "ERREUR : export MIXGRAINE_JWT='<ton token>' avant de lancer." >&2
echo " (Chrome -> F12 -> Network -> requete api/customer -> header authorization: Bearer ...)" >&2
exit 1
fi
OUT="${1:-mixgraine-export}"
echo "==> 1/2 Extraction Mixgraine (lent, ~1 req/s)..."
python3 extract_mixgraine.py --out "$OUT"
echo "==> 2/2 Generation de l'Excel par type..."
python3 build_tiers_xlsx.py --in "$OUT"
echo
echo "Termine. Resultats dans : $OUT/"
echo " - mixgraine-tiers.xlsx (1 onglet par type + Synthese, filtre 'Site manquant')"
echo " - *.json + extraction-report.txt"
-56
View File
@@ -495,62 +495,6 @@
}
}
},
"transport": {
"carriers": {
"title": "Répertoire transporteurs",
"add": "Ajouter",
"export": "Exporter",
"empty": "Aucun transporteur pour l'instant.",
"column": {
"name": "Nom",
"certification": "Certification",
"validityDate": "Date de validité",
"lastActivity": "Dernière activité"
},
"certification": {
"QUALIMAT": "QUALIMAT",
"GMP_PLUS": "GMP+",
"OVOCOM": "OVOCOM",
"COMPTE_PROPRE": "Compte-propre",
"AUTRE": "Autre"
},
"filters": {
"title": "Filtres",
"search": "Recherche",
"certification": "Certification",
"status": "Statut",
"archivedOnly": "Voir les archivés",
"apply": "Voir les résultats",
"reset": "Réinitialiser"
},
"toast": {
"error": "Une erreur est survenue. Réessayez.",
"exportError": "L'export du répertoire transporteurs a échoué. Réessayez.",
"createSuccess": "Transporteur créé avec succès"
},
"tab": {
"qualimat": "Qualimat",
"addresses": "Adresses",
"contacts": "Contacts",
"prices": "Prix"
},
"form": {
"title": "Ajouter un transporteur",
"back": "Retour au répertoire",
"submit": "Valider",
"comingSoon": "À venir",
"duplicateName": "Un transporteur actif portant ce nom existe déjà.",
"main": {
"name": "Nom",
"certificationType": "Certification transport",
"isChartered": "Affréter"
},
"errors": {
"nameRequired": "Le nom du transporteur est obligatoire."
}
}
}
},
"auth": {
"login": "Connexion",
"logout": "Deconnexion",
@@ -41,10 +41,9 @@ export interface Supplier {
* sur la ressource `/suppliers` (RG-13 : pagination serveur obligatoire ; jamais
* de chargement integral en memoire). Miroir de `useClientsRepository` (M1).
*
* Les filtres (recherche, categories, sites, archives) sont pilotes par la page
* via `setFilters` du composable partage — la remise en page 1 est garantie.
* Cocher « Voir les archivés » envoie `archivedOnly=true` → seules les archives
* sont listees (aligne sur Client).
* Les filtres (recherche, categories, sites, inclusion des archives) sont pilotes
* par la page via `setFilters` du composable partage — la remise en page 1 est
* garantie.
*
* Volontairement PAR INSTANCE (pas de singleton module-level) : l'etat tableau
* est propre a l'ecran Repertoire et meurt avec lui, comme tout consommateur de
@@ -1,191 +0,0 @@
import { beforeEach, describe, expect, it, vi } from 'vitest'
/**
* Tests du workflow « Ajouter un transporteur » (M4 Transport, ERP-165).
*
* `useCarrierForm` porte le formulaire principal (Nom + Certification + Affréter)
* et l'orchestration des onglets de création. On vérifie ici le CONTRAT propre à
* la création :
* - pré-check front : nom requis → POST bloqué, erreur inline, aucun appel réseau ;
* - POST /carriers (groupe carrier:write:main) : payload + Accept ld+json +
* toast:false ; au succès, verrouillage + bascule sur l'onglet Qualimat +
* réaffichage du nom normalisé ;
* - 409 doublon (RG-4.12) → erreur inline dédiée sur `name` ;
* - 422 → mapping inline par champ (propertyPath) ;
* - onglets : 4 onglets (Qualimat/Adresses/Contacts/Prix), completeTab
* déverrouille/avance et signale le dernier onglet ;
* - patchCarrier : PATCH partiel, no-op avant création.
*/
const mockPost = vi.hoisted(() => vi.fn())
const mockPatch = vi.hoisted(() => vi.fn())
vi.stubGlobal('useApi', () => ({
get: vi.fn(),
post: mockPost,
put: vi.fn(),
patch: mockPatch,
delete: vi.fn(),
}))
vi.stubGlobal('useI18n', () => ({ t: (key: string) => key }))
vi.stubGlobal('useToast', () => ({
success: vi.fn(),
error: vi.fn(),
warning: vi.fn(),
info: vi.fn(),
}))
const { useCarrierForm, CARRIER_TAB_KEYS } = await import('../useCarrierForm')
describe('useCarrierForm', () => {
beforeEach(() => {
mockPost.mockReset()
mockPatch.mockReset()
})
it('front : nom vide → erreur inline sur name, pas de POST', async () => {
const form = useCarrierForm()
const created = await form.submitMain()
expect(created).toBe(false)
expect(mockPost).not.toHaveBeenCalled()
expect(form.mainErrors.errors.name).toBe('transport.carriers.form.errors.nameRequired')
expect(form.mainLocked.value).toBe(false)
})
it('front : nom en espaces uniquement → erreur inline, pas de POST', async () => {
const form = useCarrierForm()
form.main.name = ' '
const created = await form.submitMain()
expect(created).toBe(false)
expect(mockPost).not.toHaveBeenCalled()
expect(form.mainErrors.errors.name).toBe('transport.carriers.form.errors.nameRequired')
})
it('POST /carriers avec Accept ld+json, verrouille et bascule sur Qualimat', async () => {
mockPost.mockResolvedValueOnce({ id: 42, name: 'TRANSPORTS ACME', certificationType: 'GMP_PLUS' })
const form = useCarrierForm()
form.main.name = 'Transports Acme'
form.main.certificationType = 'GMP_PLUS'
form.main.isChartered = true
const created = await form.submitMain()
expect(created).toBe(true)
expect(mockPost).toHaveBeenCalledTimes(1)
const [url, body, opts] = mockPost.mock.calls[0] ?? []
expect(url).toBe('/carriers')
expect(body).toEqual({
name: 'Transports Acme',
certificationType: 'GMP_PLUS',
isChartered: true,
})
expect(opts).toMatchObject({ toast: false, headers: { Accept: 'application/ld+json' } })
expect(form.carrierId.value).toBe(42)
// RG-4.13 : réaffiche le nom normalisé (UPPERCASE) renvoyé par le serveur.
expect(form.main.name).toBe('TRANSPORTS ACME')
expect(form.mainLocked.value).toBe(true)
expect(form.activeTab.value).toBe('qualimat')
expect(form.unlockedIndex.value).toBe(0)
})
it('payload : omet name et certificationType vides, garde isChartered', async () => {
mockPost.mockRejectedValueOnce({ response: { status: 422, _data: { violations: [] } } })
const form = useCarrierForm()
form.main.name = 'X' // nom présent pour passer le pré-check front
// certificationType laissé null → omis pour que la 422 « obligatoire » porte.
await form.submitMain()
const body = mockPost.mock.calls[0]?.[1] as Record<string, unknown>
expect(body).toEqual({ name: 'X', isChartered: false })
expect('certificationType' in body).toBe(false)
})
it('409 doublon (RG-4.12) : erreur inline dédiée sur name, pas de verrouillage', async () => {
mockPost.mockRejectedValueOnce({ response: { status: 409 } })
const form = useCarrierForm()
form.main.name = 'Doublon'
form.main.certificationType = 'AUTRE'
const created = await form.submitMain()
expect(created).toBe(false)
expect(form.mainErrors.errors.name).toBe('transport.carriers.form.duplicateName')
expect(form.mainLocked.value).toBe(false)
})
it('422 : mappe les violations serveur inline par champ', async () => {
mockPost.mockRejectedValueOnce({
response: {
status: 422,
_data: { violations: [{ propertyPath: 'certificationType', message: 'Le type de certification est obligatoire.' }] },
},
})
const form = useCarrierForm()
form.main.name = 'Sans Certif'
const created = await form.submitMain()
expect(created).toBe(false)
expect(form.mainErrors.errors.certificationType).toBe('Le type de certification est obligatoire.')
expect(form.mainLocked.value).toBe(false)
})
it('onglets : 4 clés Qualimat/Adresses/Contacts/Prix', () => {
expect(CARRIER_TAB_KEYS).toEqual(['qualimat', 'addresses', 'contacts', 'prices'])
const form = useCarrierForm()
expect(form.tabKeys.value).toEqual(['qualimat', 'addresses', 'contacts', 'prices'])
// Tous verrouillés tant que le formulaire principal n'est pas validé.
expect(form.unlockedIndex.value).toBe(-1)
})
it('completeTab : déverrouille/avance, et signale le dernier onglet du flux', () => {
const form = useCarrierForm()
// Qualimat → Adresses (pas le dernier).
expect(form.completeTab('qualimat')).toBe(false)
expect(form.isValidated('qualimat')).toBe(true)
expect(form.activeTab.value).toBe('addresses')
expect(form.unlockedIndex.value).toBe(1)
expect(form.completeTab('addresses')).toBe(false)
expect(form.activeTab.value).toBe('contacts')
expect(form.completeTab('contacts')).toBe(false)
expect(form.activeTab.value).toBe('prices')
// Prix = dernier onglet → true (création terminée).
expect(form.completeTab('prices')).toBe(true)
expect(form.isValidated('prices')).toBe(true)
})
it('editMode : completeTab ne verrouille pas et ne bascule pas d\'onglet', () => {
const form = useCarrierForm()
form.editMode.value = true
form.activeTab.value = 'qualimat'
expect(form.completeTab('qualimat')).toBe(false)
expect(form.isValidated('qualimat')).toBe(false)
expect(form.activeTab.value).toBe('qualimat')
})
it('patchCarrier : PATCH /carriers/{id} en mode strict, no-op avant création', async () => {
const form = useCarrierForm()
await form.patchCarrier({ liotPlates: 'AA-123-BB' })
expect(mockPatch).not.toHaveBeenCalled()
mockPost.mockResolvedValueOnce({ id: 9, name: 'ACME', certificationType: 'OVOCOM' })
form.main.name = 'Acme'
form.main.certificationType = 'OVOCOM'
await form.submitMain()
await form.patchCarrier({ liotPlates: 'AA-123-BB' })
expect(mockPatch).toHaveBeenCalledWith('/carriers/9', { liotPlates: 'AA-123-BB' }, { toast: false })
})
})
@@ -1,97 +0,0 @@
import { describe, it, expect, vi, beforeEach } from 'vitest'
import { useCarriersRepository, type Carrier } from '../useCarriersRepository'
const mockApiGet = vi.hoisted(() => vi.fn())
vi.stubGlobal('useApi', () => ({ get: mockApiGet }))
/**
* Tests du repertoire transporteurs (ERP-164).
*
* `useCarriersRepository` est une fine enveloppe de `usePaginatedList<Carrier>`
* sur `/carriers`. Les invariants generiques de pagination sont deja couverts par
* `usePaginatedList.test.ts` ; on verifie ici le CONTRAT propre au repertoire :
* - la ressource ciblee est bien `/carriers` ;
* - l'enveloppe Hydra (member / totalItems) est consommee ;
* - le header `Accept: application/ld+json` est envoye (sinon API Platform 4
* renvoie un tableau plat sans pagination) ;
* - EXCLUSION DES ARCHIVES PAR DEFAUT : aucun `archivedOnly` n'est envoye
* tant que l'utilisateur ne coche pas le filtre (le back masque alors les
* archives) ; le filtre « Voir les archivés » est bien transmis une fois
* applique (aligne sur Client / Fournisseur / Prestataire).
*/
describe('useCarriersRepository', () => {
beforeEach(() => {
mockApiGet.mockReset()
})
/** Une page de transporteurs Hydra, avec qualimatCarrier embarque (RG-4.04). */
const PAGE: Carrier[] = [
{
id: 1,
name: 'TRANSPORTS ACME',
certificationType: 'QUALIMAT',
qualimatCarrier: {
id: '42',
name: 'TRANSPORTS ACME',
validityDate: '2027-01-15',
status: 'VALIDE',
},
updatedAt: '2026-06-15T08:12:01+02:00',
isArchived: false,
},
]
it('cible /carriers, consomme l\'enveloppe Hydra et envoie l\'Accept ld+json', async () => {
mockApiGet.mockResolvedValueOnce({ member: PAGE, totalItems: 1 })
const repo = useCarriersRepository()
await repo.fetch()
expect(mockApiGet).toHaveBeenCalledTimes(1)
const [url, query, opts] = mockApiGet.mock.calls[0]
expect(url).toBe('/carriers')
expect(query).toMatchObject({ page: 1, itemsPerPage: 10 })
expect(opts).toMatchObject({
toast: false,
headers: { Accept: 'application/ld+json' },
})
expect(repo.items.value).toEqual(PAGE)
expect(repo.totalItems.value).toBe(1)
})
it('exclut les archives par defaut : aucun archivedOnly au premier fetch', async () => {
mockApiGet.mockResolvedValueOnce({ member: PAGE, totalItems: 1 })
const repo = useCarriersRepository()
await repo.fetch()
const query = mockApiGet.mock.calls[0][1] as Record<string, unknown>
expect(query.archivedOnly).toBeUndefined()
})
it('transmet archivedOnly une fois le filtre applique (retour page 1)', async () => {
mockApiGet.mockResolvedValueOnce({ member: PAGE, totalItems: 1 })
const repo = useCarriersRepository()
await repo.fetch()
mockApiGet.mockResolvedValueOnce({ member: PAGE, totalItems: 1 })
await repo.setFilters({ archivedOnly: true })
expect(repo.currentPage.value).toBe(1)
const query = mockApiGet.mock.calls.at(-1)?.[1] as Record<string, unknown>
expect(query.archivedOnly).toBe(true)
})
it('transmet les certifications multiples + la recherche', async () => {
mockApiGet.mockResolvedValueOnce({ member: PAGE, totalItems: 1 })
const repo = useCarriersRepository()
await repo.fetch()
mockApiGet.mockResolvedValueOnce({ member: PAGE, totalItems: 1 })
await repo.setFilters({ search: 'acme', 'certificationType[]': ['QUALIMAT', 'AUTRE'] })
const query = mockApiGet.mock.calls.at(-1)?.[1] as Record<string, unknown>
expect(query.search).toBe('acme')
expect(query['certificationType[]']).toEqual(['QUALIMAT', 'AUTRE'])
})
})
@@ -1,207 +0,0 @@
import { reactive, ref } from 'vue'
import { useFormErrors } from '~/shared/composables/useFormErrors'
import {
emptyCarrierMain,
type CarrierMainDraft,
type CarrierMainResponse,
} from '~/modules/transport/types/carrierForm'
/**
* Workflow de l'écran « Ajouter un transporteur » (M4 Transport, ERP-165) —
* miroir conceptuel de `useSupplierForm` (M2) / `useProviderForm` (M3).
*
* Périmètre ERP-165 : le formulaire PRINCIPAL (pré-onglets) et l'orchestration de
* la barre d'onglets. La création est INCRÉMENTALE (spec-front § Écran Ajouter) :
* - on POST d'abord le formulaire principal (`POST /api/carriers`) ;
* - au succès le bloc principal passe en lecture seule, le 1er onglet (Qualimat)
* se déverrouille et devient actif ;
* - chaque onglet validé déverrouille le suivant (PATCH partiels par groupe de
* sérialisation) et passe en lecture seule.
*
* Les champs conditionnels du formulaire principal (indexation / benne / volume
* si affrété, décharge si AUTRE, cas LIOT) et la saisie assistée QUALIMAT arrivent
* à ERP-166 ; le contenu des onglets Adresses / Contacts / Prix aux tickets
* suivants. Ce composable pose le POST principal, le PATCH partiel et le gating
* des onglets.
*
* État 100 % local à l'instance (refs / reactive) — aucune persistance URL.
*/
/**
* Clés des onglets du flux de création, dans l'ordre de la barre (spec-front
* § Écran Ajouter). Toujours les 4 (pas de gating par permission au M4, ≠ l'onglet
* Comptabilité du M3).
*/
export const CARRIER_TAB_KEYS = ['qualimat', 'addresses', 'contacts', 'prices'] as const
export function useCarrierForm() {
const api = useApi()
const { t } = useI18n()
const toast = useToast()
// Erreurs de validation par champ (ERP-101) du formulaire principal.
const mainErrors = useFormErrors()
// ── État du transporteur créé ─────────────────────────────────────────────
const carrierId = ref<number | null>(null)
const mainLocked = ref(false)
const mainSubmitting = ref(false)
// ── Formulaire principal ──────────────────────────────────────────────────
const main = reactive<CarrierMainDraft>(emptyCarrierMain())
// ── Onglets : ordre + gating progressif ───────────────────────────────────
const tabKeys = ref<string[]>([...CARRIER_TAB_KEYS])
// Index du dernier onglet déverrouillé (-1 tant que le transporteur n'est pas créé).
const unlockedIndex = ref(-1)
const activeTab = ref<string>(CARRIER_TAB_KEYS[0])
// Onglets validés (passent en lecture seule).
const validated = reactive<Record<string, boolean>>({})
// Mode MODIFICATION (ticket ultérieur) : navigation libre, pas de verrouillage
// ni de bascule automatique d'onglet à la validation (cf. completeTab).
const editMode = ref(false)
function isValidated(key: string): boolean {
return validated[key] === true
}
function tabIndex(key: string): number {
return tabKeys.value.indexOf(key)
}
/**
* Validation FRONT du formulaire principal : seul le nom est requis côté front
* (RG-4.01). Le back reste la couche autoritaire (ERP-101) — la certification
* obligatoire (sauf LIOT) et les RG conditionnelles sont re-validées serveur et
* remontées en 422 inline, sans pré-check front (qui devrait connaître le cas
* LIOT, hors périmètre ERP-165).
*/
function validateMainFront(): boolean {
let valid = true
if (!main.name?.trim()) {
mainErrors.setError('name', t('transport.carriers.form.errors.nameRequired'))
valid = false
}
return valid
}
/**
* Payload du POST principal (groupe `carrier:write:main`). `name` et
* `certificationType` sont omis s'ils sont vides afin que la 422 porte la
* violation métier (NotBlank sur le nom, « certification obligatoire » sur la
* certification) sur le champ plutôt qu'une erreur de type.
*/
function buildMainPayload(): Record<string, unknown> {
const payload: Record<string, unknown> = {
isChartered: main.isChartered,
}
if (main.name?.trim()) {
payload.name = main.name
}
if (main.certificationType) {
payload.certificationType = main.certificationType
}
return payload
}
/**
* POST /carriers (groupe `carrier:write:main`). Pré-check front (nom), puis
* création. Au succès : verrouille le bloc principal, déverrouille le 1er onglet
* et bascule sur « Qualimat ». Retourne true si créé, false sinon.
*/
async function submitMain(): Promise<boolean> {
if (mainSubmitting.value) return false
mainErrors.clearErrors()
if (!validateMainFront()) return false
mainSubmitting.value = true
try {
const created = await api.post<CarrierMainResponse>('/carriers', buildMainPayload(), {
headers: { Accept: 'application/ld+json' },
toast: false,
})
carrierId.value = created.id
// Réaffiche les valeurs normalisées renvoyées par le serveur (nom en
// UPPERCASE — RG-4.13 ; certification éventuellement forcée).
main.name = created.name ?? main.name
main.certificationType = created.certificationType ?? main.certificationType
mainLocked.value = true
unlockedIndex.value = 0
activeTab.value = tabKeys.value[0] ?? CARRIER_TAB_KEYS[0]
toast.success({ title: t('transport.carriers.toast.createSuccess') })
return true
}
catch (error) {
// 409 = doublon de nom (RG-4.12) → erreur inline dédiée + toast ;
// 422 → mapping inline par champ ; autre → toast de fallback (ERP-101).
const status = (error as { response?: { status?: number } })?.response?.status
if (status === 409) {
const message = t('transport.carriers.form.duplicateName')
mainErrors.setError('name', message)
toast.error({ title: t('transport.carriers.toast.error'), message })
}
else {
mainErrors.handleApiError(error, { fallbackMessage: t('transport.carriers.toast.error') })
}
return false
}
finally {
mainSubmitting.value = false
}
}
/**
* PATCH partiel du transporteur (mode strict : un seul groupe de sérialisation
* par appel — spec-back § 2.9). Servira les onglets à champs scalaires des
* tickets suivants. No-op tant que le transporteur n'existe pas.
*/
async function patchCarrier(payload: Record<string, unknown>): Promise<void> {
if (carrierId.value === null) return
await api.patch(`/carriers/${carrierId.value}`, payload, { toast: false })
}
/**
* Marque un onglet validé (passe en lecture seule), déverrouille et avance à
* l'onglet suivant. Retourne true si c'était le dernier onglet du flux (création
* terminée), false sinon.
*/
function completeTab(key: string): boolean {
// En modification : navigation libre, l'onglet reste éditable après validation.
if (editMode.value) {
return false
}
validated[key] = true
const index = tabIndex(key)
const next = tabKeys.value[index + 1]
if (next === undefined) {
return true
}
unlockedIndex.value = Math.max(unlockedIndex.value, index + 1)
activeTab.value = next
return false
}
return {
// état
main,
carrierId,
mainLocked,
mainSubmitting,
mainErrors,
// onglets
tabKeys,
activeTab,
unlockedIndex,
validated,
editMode,
isValidated,
// actions
validateMainFront,
buildMainPayload,
submitMain,
patchCarrier,
completeTab,
}
}
@@ -1,70 +0,0 @@
import { usePaginatedList } from '~/shared/composables/usePaginatedList'
/**
* Vue MINIMALE du referentiel QUALIMAT embarque (groupe `qualimat:read`) dans la
* LISTE des transporteurs. Seuls les champs consommes par le Repertoire sont
* types : `validityDate` alimente la colonne « Date de validité » (fond rouge si
* perimee — RG-4.04). L'id QUALIMAT est une chaine (colonne BIGINT cote back).
*/
export interface CarrierQualimat {
id: string
name: string | null
/** Date ISO de validite de l'agrement QUALIMAT (date_immutable) — RG-4.04. */
validityDate: string | null
status: string | null
}
/**
* Vue MINIMALE d'un transporteur pour le Repertoire (datatable). Volontairement
* partielle : seuls les champs des colonnes + l'id (navigation) sont types ici.
* Le detail complet (onglets Adresses / Contacts / Prix) est hors perimetre de
* cet ecran (ERP-164, ticket #9).
*
* `certificationType` : QUALIMAT | GMP_PLUS | OVOCOM | COMPTE_PROPRE | AUTRE, ou
* `null` dans le cas LIOT (compte-propre interne sans certification — RG-4.01).
* Le libelle affiche est resolu cote front (cle i18n `transport.carriers.certification.*`).
*/
export interface Carrier {
id: number
name: string | null
certificationType: string | null
/** Lien editable vers le referentiel QUALIMAT (null si transporteur non QUALIMAT). */
qualimatCarrier: CarrierQualimat | null
/** Date ISO de derniere modification (default:read) — colonne « Dernière activité ». */
updatedAt: string | null
isArchived: boolean
}
/**
* Filtres du Repertoire transporteurs, branches sur les query params de
* `GET /api/carriers` (spec-back § 4.1). Pilotes par la page via `setFilters` :
* - `search` : recherche fuzzy sur le nom ;
* - `certificationType[]` : multi-valeurs (OR cote back) ;
* - `archivedOnly` : n'affiche QUE les archives (toggle « Voir les archivés »,
* aligne sur les autres repertoires M1/M2/M3).
*/
export interface CarrierFilters {
search?: string
'certificationType[]'?: string[]
archivedOnly?: boolean
}
/**
* Repertoire transporteurs (M4, ERP-164) — simple enveloppe de
* `usePaginatedList<Carrier>` sur la ressource `/carriers` (regle ABSOLUE n°13 :
* pagination serveur obligatoire ; jamais de chargement integral en memoire).
* Miroir de `useSuppliersRepository` (M2) / `useProvidersRepository` (M3).
*
* Les filtres (recherche, certifications, archives) sont pilotes par la page via
* `setFilters` du composable partage — la remise en page 1 est garantie. Par
* defaut AUCUN `archivedOnly` n'est envoye : le back masque alors les archives
* (§ 2.4). Cocher « Voir les archivés » envoie `archivedOnly=true` (seules les
* archives sont listees, aligne sur Client / Fournisseur / Prestataire).
*
* Volontairement PAR INSTANCE (pas de singleton module-level) : l'etat tableau
* est propre a l'ecran Repertoire et meurt avec lui, comme tout consommateur de
* `usePaginatedList`. Aucun reset au logout a gerer.
*/
export function useCarriersRepository() {
return usePaginatedList<Carrier, CarrierFilters>({ url: '/carriers' })
}
@@ -1,211 +0,0 @@
import { describe, it, expect, vi, beforeEach } from 'vitest'
import { mount, flushPromises } from '@vue/test-utils'
import { defineComponent, h, ref } from 'vue'
// ── Auto-imports Nuxt stubbes globalement ───────────────────────────────────
// La page ne les importe pas (auto-import) : on les expose en globals pour le
// runtime de test (happy-dom). Meme philosophie que les specs M1/M2/M3.
const mockPush = vi.hoisted(() => vi.fn())
const mockApiGet = vi.hoisted(() => vi.fn())
const mockCan = vi.hoisted(() => vi.fn())
const mockSetFilters = vi.hoisted(() => vi.fn())
const mockFetch = vi.hoisted(() => vi.fn())
const mockToastError = vi.hoisted(() => vi.fn())
vi.stubGlobal('useI18n', () => ({ t: (key: string) => key }))
vi.stubGlobal('useHead', () => undefined)
vi.stubGlobal('useApi', () => ({ get: mockApiGet }))
vi.stubGlobal('useRouter', () => ({ push: mockPush }))
vi.stubGlobal('useToast', () => ({ error: mockToastError, success: vi.fn() }))
vi.stubGlobal('usePermissions', () => ({ can: mockCan }))
// Le repository est lui aussi un auto-import : on controle items + setFilters.
vi.stubGlobal('useCarriersRepository', () => ({
items: ref([
{
id: 7,
name: 'TRANSPORTS ACME',
certificationType: 'QUALIMAT',
qualimatCarrier: { id: '42', name: 'TRANSPORTS ACME', validityDate: '2027-01-15', status: 'VALIDE' },
updatedAt: '2026-01-15T10:00:00+00:00',
isArchived: false,
},
]),
totalItems: ref(1),
currentPage: ref(1),
itemsPerPage: ref(10),
itemsPerPageOptions: ref([10, 25, 50]),
fetch: mockFetch,
goToPage: vi.fn(),
setItemsPerPage: vi.fn(),
setFilters: mockSetFilters,
}))
// happy-dom n'implemente pas createObjectURL : on ajoute les methodes statiques
// sur la classe URL existante (sans la remplacer — sinon `new URL()` casse).
globalThis.URL.createObjectURL = vi.fn(() => 'blob:fake')
globalThis.URL.revokeObjectURL = vi.fn()
// Import APRES les stubs (la page resout les auto-imports au top-level du module).
const CarriersIndex = (await import('../carriers/index.vue')).default
// ── Stubs de composants ──────────────────────────────────────────────────────
const ButtonStub = defineComponent({
props: { label: { type: String, default: '' }, disabled: { type: Boolean, default: false } },
emits: ['click'],
setup(props, { emit }) {
return () => h('button', { 'data-label': props.label, onClick: () => emit('click') }, props.label)
},
})
const DataTableStub = defineComponent({
props: { items: { type: Array, default: () => [] } },
emits: ['row-click', 'update:page', 'update:per-page'],
setup(props, { emit }) {
return () => h('div', { 'data-testid': 'datatable' },
(props.items as Array<{ id: number }>).map(it =>
h('tr', { 'data-row-id': it.id, onClick: () => emit('row-click', it) }),
),
)
},
})
const DrawerStub = defineComponent({
props: { modelValue: { type: Boolean, default: false } },
setup(_, { slots }) {
return () => h('div', {}, [slots.header?.(), slots.default?.(), slots.footer?.()])
},
})
const SlotStub = defineComponent({ setup(_, { slots }) { return () => h('div', {}, slots.default?.()) } })
const PageHeaderStub = defineComponent({
setup(_, { slots }) { return () => h('div', {}, [slots.default?.(), slots.actions?.()]) },
})
const CheckboxStub = defineComponent({
props: { id: { type: String, default: '' }, modelValue: { type: Boolean, default: false } },
emits: ['update:model-value'],
setup(props, { emit }) {
return () => h('input', {
'type': 'checkbox',
'data-id': props.id,
'onChange': (e: Event) => emit('update:model-value', (e.target as HTMLInputElement).checked),
})
},
})
const InputTextStub = defineComponent({ setup() { return () => h('input') } })
function mountPage() {
return mount(CarriersIndex, {
global: {
stubs: {
PageHeader: PageHeaderStub,
MalioButton: ButtonStub,
MalioDataTable: DataTableStub,
MalioDrawer: DrawerStub,
MalioAccordion: SlotStub,
MalioAccordionItem: SlotStub,
MalioInputText: InputTextStub,
MalioCheckbox: CheckboxStub,
},
},
})
}
describe('Répertoire transporteurs (page /carriers)', () => {
beforeEach(() => {
mockPush.mockReset()
mockApiGet.mockReset().mockResolvedValue({ member: [] })
mockCan.mockReset().mockReturnValue(true)
mockSetFilters.mockReset()
mockFetch.mockReset()
mockToastError.mockReset()
})
it('charge la liste au montage', async () => {
mountPage()
await flushPromises()
expect(mockFetch).toHaveBeenCalled()
})
it('affiche « + Ajouter » uniquement avec la permission manage', async () => {
mockCan.mockImplementation((perm: string) => perm === 'transport.carriers.manage')
const wrapper = mountPage()
await flushPromises()
expect(wrapper.find('[data-label="transport.carriers.add"]').exists()).toBe(true)
})
it('masque « + Ajouter » sans la permission manage (view seul)', async () => {
mockCan.mockImplementation((perm: string) => perm === 'transport.carriers.view')
const wrapper = mountPage()
await flushPromises()
expect(wrapper.find('[data-label="transport.carriers.add"]').exists()).toBe(false)
})
it('navigue vers la consultation au clic sur une ligne', async () => {
const wrapper = mountPage()
await flushPromises()
await wrapper.find('tr[data-row-id="7"]').trigger('click')
expect(mockPush).toHaveBeenCalledWith('/carriers/7')
})
it('appelle l\'export XLSX sur /carriers/export.xlsx en blob', async () => {
const wrapper = mountPage()
await flushPromises()
await wrapper.find('[data-label="transport.carriers.export"]').trigger('click')
await flushPromises()
expect(mockApiGet).toHaveBeenCalledWith(
'/carriers/export.xlsx',
expect.any(Object),
expect.objectContaining({ responseType: 'blob', toast: false }),
)
})
it('repercute le filtre « Voir les archivés » dans setFilters sans toucher l\'URL', async () => {
const wrapper = mountPage()
await flushPromises()
// Coche « Voir les archivés » puis applique les filtres.
await wrapper.find('input[data-id="filter-archived-only"]').setValue(true)
await wrapper.find('[data-label="transport.carriers.filters.apply"]').trigger('click')
expect(mockSetFilters).toHaveBeenLastCalledWith(
{ archivedOnly: true },
{ replace: true },
)
// Etat 100 % local (regle n°6) : aucune navigation/query string declenchee.
expect(mockPush).not.toHaveBeenCalled()
})
it('repercute les certifications cochees dans setFilters (filtre multi)', async () => {
const wrapper = mountPage()
await flushPromises()
// Coche deux certifications via les cases a cocher (pattern repertoire clients).
await wrapper.find('input[data-id="filter-certification-QUALIMAT"]').setValue(true)
await wrapper.find('input[data-id="filter-certification-AUTRE"]').setValue(true)
await wrapper.find('[data-label="transport.carriers.filters.apply"]').trigger('click')
expect(mockSetFilters).toHaveBeenLastCalledWith(
{ 'certificationType[]': ['QUALIMAT', 'AUTRE'] },
{ replace: true },
)
})
it('badge filtres actifs + Réinitialiser vide l\'etat applique', async () => {
const wrapper = mountPage()
await flushPromises()
await wrapper.find('input[data-id="filter-archived-only"]').setValue(true)
await wrapper.find('[data-label="transport.carriers.filters.apply"]').trigger('click')
// Le libelle du bouton Filtrer porte le compteur (1 filtre actif).
expect(wrapper.find('[data-label="transport.carriers.filters.title (1)"]').exists()).toBe(true)
// Réinitialiser → query propre (setFilters avec objet vide).
await wrapper.find('[data-label="transport.carriers.filters.reset"]').trigger('click')
expect(mockSetFilters).toHaveBeenLastCalledWith({}, { replace: true })
})
})
@@ -1,389 +0,0 @@
<template>
<div>
<PageHeader>
{{ t('transport.carriers.title') }}
<template #actions>
<!-- gap-8 = 32px d'espacement entre Filtrer et Ajouter. -->
<div class="flex items-center gap-8">
<!-- Bouton Filtrer a GAUCHE d'Ajouter. Le compteur reflete les filtres actifs. -->
<MalioButton
v-if="canView"
variant="tertiary"
:label="filterButtonLabel"
icon-name="mdi:tune"
icon-position="left"
icon-size="24"
@click="openFilters"
/>
<MalioButton
v-if="canManage"
variant="secondary"
:label="t('transport.carriers.add')"
icon-name="mdi:add-bold"
icon-position="left"
@click="goToCreate"
/>
</div>
</template>
</PageHeader>
<!-- Datatable branchee sur usePaginatedList via useCarriersRepository :
pagination serveur, tri name ASC par defaut (cote back). -->
<MalioDataTable
:columns="columns"
:items="rows"
:total-items="totalItems"
:page="currentPage"
:per-page="itemsPerPage"
:per-page-options="itemsPerPageOptions"
row-clickable
:empty-message="t('transport.carriers.empty')"
@row-click="onRowClick"
@update:page="goToPage"
@update:per-page="setItemsPerPage"
>
<!-- Certification : libelle i18n (le back renvoie le code enum). -->
<template #cell-certificationType="{ item }">
{{ formatCertification(item) }}
</template>
<!-- Date de validite QUALIMAT : fond rouge si perimee (< aujourd'hui — RG-4.04). -->
<template #cell-validityDate="{ item }">
<span
v-if="getValidityDate(item)"
:class="isValidityExpired(item) ? 'inline-block rounded px-2 py-0.5 bg-m-danger text-white' : ''"
>
{{ formatDateFr(getValidityDate(item)) }}
</span>
</template>
<!-- Derniere activite : date de derniere modification (updatedAt). -->
<template #cell-lastActivity="{ item }">
{{ formatDateFr(item.updatedAt as string | null) }}
</template>
</MalioDataTable>
<div class="flex justify-center mt-4">
<MalioButton
v-if="canView"
variant="primary"
:label="t('transport.carriers.export')"
:disabled="exporting"
@click="exportXlsx"
/>
</div>
<!-- Drawer de filtres : etat BROUILLON, applique uniquement au clic sur
« Voir les résultats ». Meme pattern que les repertoires M1/M2/M3.
Etat 100 % local, jamais dans l'URL (regle ABSOLUE n°6). -->
<MalioDrawer
v-model="filterDrawerOpen"
drawer-class="max-w-[450px]"
body-class="p-0"
footer-class="justify-between border-t border-black p-6"
>
<template #header>
<h2 class="text-[24px] font-bold uppercase">{{ t('transport.carriers.filters.title') }}</h2>
</template>
<MalioAccordion>
<!-- Recherche : nom du transporteur (param `search`). -->
<MalioAccordionItem :title="t('transport.carriers.filters.search')" value="search">
<MalioInputText
v-model="draftSearch"
icon-name="mdi:magnify"
/>
</MalioAccordionItem>
<!-- Certification : cases a cocher (multi). Valeur = code enum.
Meme pattern que le filtre Categories du repertoire clients. -->
<MalioAccordionItem :title="t('transport.carriers.filters.certification')" value="certification">
<div class="flex flex-col">
<MalioCheckbox
v-for="opt in certificationOptions"
:id="`filter-certification-${opt.value}`"
:key="opt.value"
:label="opt.label"
:model-value="draftCertificationTypes.includes(opt.value)"
@update:model-value="(val: boolean) => toggleCertification(opt.value, val)"
/>
</div>
</MalioAccordionItem>
<!-- Statut : voir uniquement les archives (sinon actifs uniquement). -->
<MalioAccordionItem :title="t('transport.carriers.filters.status')" value="status">
<MalioCheckbox
id="filter-archived-only"
:label="t('transport.carriers.filters.archivedOnly')"
:model-value="draftArchivedOnly"
@update:model-value="(val: boolean) => draftArchivedOnly = val"
/>
</MalioAccordionItem>
</MalioAccordion>
<template #footer>
<MalioButton
variant="tertiary"
:label="t('transport.carriers.filters.reset')"
button-class="w-m-btn-action"
@click="resetFilters"
/>
<MalioButton
variant="primary"
:label="t('transport.carriers.filters.apply')"
button-class="w-[170px]"
@click="applyFilters"
/>
</template>
</MalioDrawer>
</div>
</template>
<script setup lang="ts">
import { computed, onMounted, ref } from 'vue'
interface FilterOption {
value: string
label: string
}
const { t } = useI18n()
const api = useApi()
const router = useRouter()
const toast = useToast()
const { can } = usePermissions()
useHead({ title: t('transport.carriers.title') })
// Bouton « Ajouter » reserve a `manage` (Admin + Bureau). « Exporter » et
// « Filtrer » suivent `view` (Admin / Bureau / Commerciale). Compta et Usine
// n'ont aucun acces (item sidebar masque cote back).
const canManage = computed(() => can('transport.carriers.manage'))
const canView = computed(() => can('transport.carriers.view'))
const {
items: carriers,
totalItems,
currentPage,
itemsPerPage,
itemsPerPageOptions,
fetch: loadCarriers,
goToPage,
setItemsPerPage,
setFilters,
} = useCarriersRepository()
// Mappe les transporteurs en objets « plats » pour MalioDataTable (items typees
// Record<string, unknown>[]) : un objet litteral porte une signature d'index
// implicite, contrairement a l'interface Carrier. Meme pattern que M1/M2/M3.
const rows = computed(() => carriers.value.map(carrier => ({
id: carrier.id,
name: carrier.name,
certificationType: carrier.certificationType,
validityDate: carrier.qualimatCarrier?.validityDate ?? null,
updatedAt: carrier.updatedAt,
})))
const columns = [
{ key: 'name', label: t('transport.carriers.column.name') },
{ key: 'certificationType', label: t('transport.carriers.column.certification') },
{ key: 'validityDate', label: t('transport.carriers.column.validityDate') },
{ key: 'lastActivity', label: t('transport.carriers.column.lastActivity') },
]
// Codes de certification (miroir de l'enum back) + cas LIOT (null). Le libelle
// est resolu par i18n ; un code inconnu retombe sur le code brut.
const CERTIFICATION_CODES = ['QUALIMAT', 'GMP_PLUS', 'OVOCOM', 'COMPTE_PROPRE', 'AUTRE'] as const
const certificationOptions = computed<FilterOption[]>(() =>
CERTIFICATION_CODES.map(code => ({
value: code,
label: t(`transport.carriers.certification.${code}`),
})),
)
/** Libelle i18n de la certification (vide en cas LIOT — certificationType null). */
function formatCertification(item: Record<string, unknown>): string {
const code = item.certificationType as string | null | undefined
if (!code) {
return ''
}
return t(`transport.carriers.certification.${code}`)
}
/** Date de validite QUALIMAT de la ligne (null si transporteur non QUALIMAT). */
function getValidityDate(item: Record<string, unknown>): string | null {
return (item.validityDate as string | null | undefined) ?? null
}
/**
* RG-4.04 : un agrement QUALIMAT est perime si sa date de validite est anterieure
* a la date du jour (comparaison jour a jour, sans l'heure).
*/
function isValidityExpired(item: Record<string, unknown>): boolean {
const value = getValidityDate(item)
if (!value) {
return false
}
const date = new Date(value)
if (Number.isNaN(date.getTime())) {
return false
}
const today = new Date()
today.setHours(0, 0, 0, 0)
date.setHours(0, 0, 0, 0)
return date.getTime() < today.getTime()
}
/** Format court francais JJ-MM-AAAA (spec M4). Chaine vide si date absente / invalide. */
function formatDateFr(value: string | null | undefined): string {
if (!value) {
return ''
}
const date = new Date(value)
if (Number.isNaN(date.getTime())) {
return ''
}
const day = String(date.getDate()).padStart(2, '0')
const month = String(date.getMonth() + 1).padStart(2, '0')
return `${day}-${month}-${date.getFullYear()}`
}
/** Clic sur une ligne → ecran Consultation (route a plat /carriers/{id}). */
function onRowClick(item: Record<string, unknown>): void {
router.push(`/carriers/${item.id}`)
}
function goToCreate(): void {
router.push('/carriers/new')
}
// ── Filtres (drawer) ────────────────────────────────────────────────────────
// Deux niveaux d'etat (pattern repertoires M1/M2/M3) :
// - APPLIED : pilote la liste/l'export + le compteur du bouton. Modifie
// uniquement au clic « Voir les résultats » / « Réinitialiser ».
// - DRAFT : edite librement dans le drawer ; recopie vers applied a la validation.
const filterDrawerOpen = ref(false)
const draftSearch = ref('')
const draftCertificationTypes = ref<string[]>([])
const draftArchivedOnly = ref(false)
const appliedSearch = ref('')
const appliedCertificationTypes = ref<string[]>([])
const appliedArchivedOnly = ref(false)
const activeFilterCount = computed(() => {
let count = 0
if (appliedSearch.value.trim() !== '') count++
if (appliedCertificationTypes.value.length > 0) count++
if (appliedArchivedOnly.value) count++
return count
})
const filterButtonLabel = computed(() => {
const base = t('transport.carriers.filters.title')
return activeFilterCount.value > 0 ? `${base} (${activeFilterCount.value})` : base
})
// Recopie l'etat applique vers le brouillon puis ouvre le drawer : la reouverture
// reflete les filtres actifs.
function openFilters(): void {
draftSearch.value = appliedSearch.value
draftCertificationTypes.value = [...appliedCertificationTypes.value]
draftArchivedOnly.value = appliedArchivedOnly.value
filterDrawerOpen.value = true
}
/** Coche / decoche une certification dans le brouillon (filtre multi). */
function toggleCertification(code: string, selected: boolean): void {
draftCertificationTypes.value = selected
? [...draftCertificationTypes.value, code]
: draftCertificationTypes.value.filter(c => c !== code)
}
/**
* Construit le payload de filtres serveur a partir de l'etat applique. Cle
* `certificationType[]` pour que PHP la parse en tableau (OR cote back). Les
* filtres vides sont omis pour une query propre.
*/
function buildFilterPayload(): Record<string, string | string[] | boolean> {
const payload: Record<string, string | string[] | boolean> = {}
if (appliedSearch.value.trim() !== '') payload.search = appliedSearch.value.trim()
if (appliedCertificationTypes.value.length > 0) payload['certificationType[]'] = [...appliedCertificationTypes.value]
if (appliedArchivedOnly.value) payload.archivedOnly = true
return payload
}
// « Voir les résultats » : recopie brouillon → applied, pousse les filtres
// (retombe en page 1 via usePaginatedList) et ferme le drawer.
function applyFilters(): void {
appliedSearch.value = draftSearch.value.trim()
appliedCertificationTypes.value = [...draftCertificationTypes.value]
appliedArchivedOnly.value = draftArchivedOnly.value
setFilters(buildFilterPayload(), { replace: true })
filterDrawerOpen.value = false
}
// « Réinitialiser » : vide brouillon ET applied, recharge la liste complete.
// Le drawer reste ouvert pour montrer le formulaire vide.
function resetFilters(): void {
draftSearch.value = ''
draftCertificationTypes.value = []
draftArchivedOnly.value = false
appliedSearch.value = ''
appliedCertificationTypes.value = []
appliedArchivedOnly.value = false
setFilters({}, { replace: true })
}
// ── Export XLSX ─────────────────────────────────────────────────────────────
// Memes filtres que la vue : l'export reflete exactement ce que l'utilisateur voit.
const exporting = ref(false)
async function exportXlsx(): Promise<void> {
if (exporting.value) {
return
}
exporting.value = true
try {
// useApi type ses options en JSON ; l'export renvoie un binaire, donc on
// force responseType:'blob' (transmis tel quel a ofetch au runtime). Cast
// contenu faute d'overload blob sur le client partage (meme pattern M2/M3).
const blob = await api.get<Blob>('/carriers/export.xlsx', buildFilterPayload(), {
responseType: 'blob',
toast: false,
} as unknown as Parameters<typeof api.get>[2])
triggerDownload(blob, 'repertoire-transporteurs.xlsx')
}
catch {
toast.error({
title: t('transport.carriers.toast.error'),
message: t('transport.carriers.toast.exportError'),
})
}
finally {
exporting.value = false
}
}
/** Declenche le telechargement d'un blob via un lien temporaire. */
function triggerDownload(blob: Blob, filename: string): void {
const url = URL.createObjectURL(blob)
const link = document.createElement('a')
link.href = url
link.download = filename
document.body.appendChild(link)
link.click()
link.remove()
URL.revokeObjectURL(url)
}
onMounted(() => {
loadCarriers()
})
</script>
@@ -1,152 +0,0 @@
<template>
<div>
<!-- En-tete : retour vers le repertoire + titre. -->
<div class="flex items-center gap-3 pt-11">
<MalioButtonIcon
icon="mdi:arrow-left-bold"
icon-size="24"
variant="ghost"
v-bind="{ ariaLabel: t('transport.carriers.form.back') }"
@click="goBack"
/>
<h1 class="text-[30px] font-semibold text-m-primary">{{ t('transport.carriers.form.title') }}</h1>
</div>
<!-- Formulaire principal (pre-onglets)
Sans validation de ce bloc, les onglets restent inaccessibles. Au
succes du POST, les champs passent en lecture seule et on bascule
automatiquement sur l'onglet Qualimat. Les champs conditionnels
(indexation / benne / volume si affrete, decharge si AUTRE, cas LIOT)
et la saisie assistee QUALIMAT arrivent a ERP-166. -->
<div class="mt-[48px] grid grid-cols-3 xl:grid-cols-4 gap-x-[44px] gap-y-4">
<MalioInputText
v-model="main.name"
:label="t('transport.carriers.form.main.name')"
:required="true"
:readonly="mainLocked"
:error="mainErrors.errors.name"
/>
<MalioSelect
:model-value="main.certificationType"
:options="certificationOptions"
:label="t('transport.carriers.form.main.certificationType')"
empty-option-label=""
:required="true"
:readonly="mainLocked"
:error="mainErrors.errors.certificationType"
@update:model-value="(v: string | number | null) => main.certificationType = v === null ? null : String(v)"
/>
<!-- Wrapper h-12 + centrage vertical : aligne la case a cocher sur la
ligne de champ des inputs/selects (qui posent un h-12 items-center
en interne). reserve-message-space=false pour un centrage exact. -->
<div class="flex h-12 items-center">
<MalioCheckbox
id="carrier-is-chartered"
:label="t('transport.carriers.form.main.isChartered')"
:model-value="main.isChartered"
:readonly="mainLocked"
:reserve-message-space="false"
@update:model-value="(val: boolean) => main.isChartered = val"
/>
</div>
</div>
<div v-if="!mainLocked" class="mt-12 flex justify-center">
<MalioButton
variant="primary"
:label="t('transport.carriers.form.submit')"
:disabled="mainSubmitting"
@click="onSubmitMain"
/>
</div>
<!-- ── Onglets a validation incrementale ─────────────────────────────
Barre Qualimat · Adresses · Contacts · Prix. Onglets verrouilles tant
que le formulaire principal n'est pas valide (unlockedIndex = -1) puis
deverrouilles progressivement. Le contenu de chaque onglet arrive aux
tickets suivants (ERP-166+) : placeholders « A venir » pour l'instant. -->
<MalioTabList v-model="activeTab" :tabs="tabs" class="mt-[60px]">
<template
v-for="key in tabKeys"
:key="key"
#[key]
>
<div class="mt-12 flex justify-center text-m-muted">
{{ t('transport.carriers.form.comingSoon') }}
</div>
</template>
</MalioTabList>
</div>
</template>
<script setup lang="ts">
import { computed } from 'vue'
import { useCarrierForm } from '~/modules/transport/composables/useCarrierForm'
interface SelectOption {
value: string
label: string
}
const { t } = useI18n()
const router = useRouter()
const { can } = usePermissions()
useHead({ title: t('transport.carriers.form.title') })
// Gating de la route : la creation est reservee a `manage` (Admin / Bureau).
// Commerciale (consultation seule), Compta et Usine sont rediriges vers le repertoire.
if (!can('transport.carriers.manage')) {
await navigateTo('/carriers')
}
const {
main,
mainLocked,
mainSubmitting,
mainErrors,
tabKeys,
activeTab,
unlockedIndex,
submitMain,
} = useCarrierForm()
// Certifications selectionnables manuellement (spec § Formulaire principal).
// QUALIMAT n'est PAS dans cette liste : il est pose par la saisie assistee QUALIMAT
// (ERP-166), pas choisi a la main.
const SELECTABLE_CERTIFICATIONS = ['GMP_PLUS', 'OVOCOM', 'COMPTE_PROPRE', 'AUTRE'] as const
const certificationOptions = computed<SelectOption[]>(() =>
SELECTABLE_CERTIFICATIONS.map(code => ({
value: code,
label: t(`transport.carriers.certification.${code}`),
})),
)
// Icone (Iconify) affichee dans chaque onglet, par cle.
const TAB_ICONS: Record<string, string> = {
qualimat: 'mdi:truck-check-outline',
addresses: 'mdi:map-marker-outline',
contacts: 'mdi:account-box-plus-outline',
prices: 'mdi:currency-eur',
}
// Onglets desactives tant que le formulaire principal n'est pas valide
// (unlockedIndex = -1 au depart) ; deverrouillage progressif ensuite.
const tabs = computed(() => tabKeys.value.map((key, index) => ({
key,
label: t(`transport.carriers.tab.${key}`),
icon: TAB_ICONS[key],
disabled: index > unlockedIndex.value,
})))
/** Retour vers le repertoire transporteurs (fleche d'en-tete). */
function goBack(): void {
router.push('/carriers')
}
/** Valide le formulaire principal (POST /carriers ; bascule gerée par le composable). */
async function onSubmitMain(): Promise<void> {
await submitMain()
}
</script>
@@ -1,40 +0,0 @@
/**
* Types du workflow « Ajouter un transporteur » (M4 Transport, ERP-165).
*
* Périmètre ERP-165 = formulaire PRINCIPAL (pré-onglets) uniquement : Nom +
* Certification + Affréter. Les champs conditionnels (indexation / benne / volume
* si affrété, décharge si AUTRE, immatriculations LIOT) et la saisie assistée
* QUALIMAT arrivent à ERP-166 ; les onglets Adresses / Contacts / Prix aux tickets
* suivants. On garde donc volontairement ce draft minimal — il s'étendra.
*/
/**
* Brouillon du formulaire principal. `certificationType` est un code enum back
* (GMP_PLUS | OVOCOM | COMPTE_PROPRE | AUTRE ; QUALIMAT sera posé par la saisie
* assistée à ERP-166) ou `null` tant que rien n'est choisi.
*/
export interface CarrierMainDraft {
name: string
certificationType: string | null
isChartered: boolean
}
/** Brouillon principal vide (état initial du formulaire de création). */
export function emptyCarrierMain(): CarrierMainDraft {
return {
name: '',
certificationType: null,
isChartered: false,
}
}
/**
* Réponse du POST / PATCH principal (groupe `carrier:read`). Le serveur renvoie
* le nom normalisé (UPPERCASE, RG-4.13) que l'UI réaffiche tel quel.
*/
export interface CarrierMainResponse {
id: number
name: string | null
certificationType: string | null
'@id'?: string
}
+10 -10
View File
@@ -7,7 +7,7 @@
"name": "starseed-frontend",
"hasInstallScript": true,
"dependencies": {
"@malio/layer-ui": "^1.7.12",
"@malio/layer-ui": "^1.7.10",
"@nuxt/icon": "^2.2.1",
"@nuxtjs/i18n": "^10.2.3",
"@nuxtjs/tailwindcss": "^6.14.0",
@@ -583,9 +583,9 @@
"license": "MIT"
},
"node_modules/@emnapi/core": {
"version": "1.11.1",
"resolved": "https://registry.npmjs.org/@emnapi/core/-/core-1.11.1.tgz",
"integrity": "sha512-RSvbQmHzdKzNsLYa/wHrbc3KN4sYLKAdPZxqiM2HATqv/SBk2/ENSHpvXGaLOMcsAyz0poEGqkmmKYG3OWiJEQ==",
"version": "1.11.0",
"resolved": "https://registry.npmjs.org/@emnapi/core/-/core-1.11.0.tgz",
"integrity": "sha512-l9Oo58x0HOP5znGzVhYW9U3e5wVuA4LAZU2AGezTmkhO1CgQRFDhDg4nneHsu/t3WniXg9QrG2nIXL/ZS8ln8Q==",
"license": "MIT",
"optional": true,
"dependencies": {
@@ -594,9 +594,9 @@
}
},
"node_modules/@emnapi/runtime": {
"version": "1.11.1",
"resolved": "https://registry.npmjs.org/@emnapi/runtime/-/runtime-1.11.1.tgz",
"integrity": "sha512-vgj7R3y3Wgx24IQaGPA/R6YFXLHVMOZ0uVEyIQPaWs+rd1AzfEMXlAC22FYwO1XkKR6NPsq7mUandH8oIRdZFw==",
"version": "1.11.0",
"resolved": "https://registry.npmjs.org/@emnapi/runtime/-/runtime-1.11.0.tgz",
"integrity": "sha512-55coeOFKHv1ywEcUXJtWU5f+Jr/W5tZDvZig8DLKSwUN1JpROQ4rk/SNOQiFWmaR/VKF4zuFyW1B8JduOSv6Pg==",
"license": "MIT",
"optional": true,
"dependencies": {
@@ -1866,9 +1866,9 @@
"license": "MIT"
},
"node_modules/@malio/layer-ui": {
"version": "1.7.12",
"resolved": "https://gitea.malio.fr/api/packages/MALIO-DEV/npm/%40malio%2Flayer-ui/-/1.7.12/layer-ui-1.7.12.tgz",
"integrity": "sha512-ezQLqi19K2ogI3XwSMsUyluU9x5C4W0tu1muxFbL3foKjibRYRg/FdvySivEhEsalAAt1E88V6Sv/06xPqyYTw==",
"version": "1.7.10",
"resolved": "https://gitea.malio.fr/api/packages/MALIO-DEV/npm/%40malio%2Flayer-ui/-/1.7.10/layer-ui-1.7.10.tgz",
"integrity": "sha512-ZWYaKvl+VpGAqeTE+4xdyKOmuRd4zwjlUYVppeIBZwGeNAK16kZnrztR+4eQmnzUqPZVybBhEBdKP9weqWHSUg==",
"dependencies": {
"@nuxt/icon": "^2.2.1",
"@nuxtjs/tailwindcss": "^6.14.0",
+1 -1
View File
@@ -17,7 +17,7 @@
"test:e2e:ui": "playwright test --ui"
},
"dependencies": {
"@malio/layer-ui": "^1.7.12",
"@malio/layer-ui": "^1.7.10",
"@nuxt/icon": "^2.2.1",
"@nuxtjs/i18n": "^10.2.3",
"@nuxtjs/tailwindcss": "^6.14.0",
+3 -4
View File
@@ -95,11 +95,10 @@ export const personas: Record<PersonaKey, Persona> = {
'technique.providers.accounting.view',
'technique.providers.accounting.manage',
'technique.providers.archive',
// Transport — Repertoire transporteurs (M4, ERP-164). Meme logique :
// Transport — Repertoire transporteurs (M4, ERP-153). Meme logique :
// mappe sur le persona "tout", pas de nouveau persona (regle ABSOLUE
// n°7). L'item transporteurs vit desormais dans la section Administration
// (1er item, ERP-164) mais sur la route `/carriers` (hors `/admin/<slug>`),
// donc il n'entre pas dans ALL_ADMIN_LINKS : expectedAdminLinks reste inchange.
// n°7). transport.carriers.view n'ajoute pas de lien dans la section
// Administration, donc expectedAdminLinks reste inchange.
'transport.carriers.view',
'transport.carriers.manage',
'transport.carriers.archive',