rp-source-sfcc

Guide technique pour lire une vitrine SFCC/SFRA publique. Il n'embarque aucun code de capture : rp-discovery suit son chemin « aucun adaptateur n'existe → capturer manuellement, même contrat de sortie », et vous écrivez le code de capture pour chaque migration comme du code de projet généré sous migrations/<project>/src/, avec ses sorties dans migrations/<project>/data/sfcc-discovery/. ⚠️ Rien de site-spécifique (code, ids, valeurs, fixtures) n'est jamais ajouté à cette skill.

Reconnaître la plateforme

• URLs Pipeline : /on/demandware.store/Sites-<site>-Site/<locale>/<Controller>. L'og:url de la page d'accueil utilise souvent l'une d'elles, ce qui vous donne l'id du site et la locale par défaut.
• Ressources statiques : /on/demandware.static/.... Rendus d'image : /dw/image/v2/<REALM>_<ENV>/....
• OCAPI (/s/<site>/dw/shop/..., /s/-/dw/data/...) répond 401 sans credentials. Ne demandez pas de credentials Business Manager ou OCAPI dans ce flux ; enregistrez-les comme une phase ultérieure. Utilisez sourceMode=public_content.

Fichiers à lire en premier

1. robots.txt. Respectez-le pour chaque requête, et prenez l'index sitemap auprès de lui.
2. Sitemaps (index → sitemap_N.xml). Ils listent les produits, catégories et <image:loc> originaux. ⚠️ Les sitemaps sont incomplets. Les produits de pré-commande et les SKUs variantes manquent souvent, certains produits listés ne sont pas cherchables, et certaines entrées *.html sont des assets de contenu ou malformées. Ne traitez jamais le sitemap comme le catalogue.
3. La page d'accueil, plus quelques pages de catégorie et produit. Lisez l'en-tête, la navigation, le pied de page et les liens hreflang. La page d'accueil peut n'avoir pas de hreflang, apprenez les routes de locale à partir de pages internes avant de crawler.

Points d'accès publics de la vitrine (SFRA)

L'ensemble des produits est l'union des tuiles de grille de chaque catégorie (y compris les catégories liées uniquement depuis la navigation) et des URLs de produit du sitemap. Indexez les produits par l'id de produit SFCC, pas par l'URL : les rendus de locale ont leurs propres canonicals.

Signaux faciles à mal interpréter

• Types de produit. Les variationAttributes créent des SKUs (options de variant Wix). Les product options SFCC (ex. gravure) changent le prix, pas le SKU, donc ce sont des modifiers Wix. Gardez-les dans des champs séparés.
• Visibilité d'option. Une option peut être attachée à un produit mais cachée sur la vitrine : son markup est présent mais caché. SFRA n'a pas de flag de visibilité standard. Trouvez le champ personnalisé du magasin en comparant les produits où l'option est affichée et où elle ne l'est pas. Si vous ne pouvez pas en trouver un, enregistrez la visibilité comme inconnue et ne supprimez jamais l'option.
• Stock. Les valeurs sont inStock, preorder (avec inStockDate, qui signifie seulement une date quand le statut est preorder), et en rupture de stock (souvent pas de statut du tout, juste un message). lowStockCount et maxOrderQuantity sont des indices, jamais des quantités faisant autorité.
• Prix. price.list est le prix de comparaison. promotions[] nomme les ids de promotion mais jamais leurs règles. callForPrice cache le prix et l'ajout au panier : cela nécessite une décision humaine.
• Images. L'original est le chemin statique : supprimez /dw/image/v2/<REALM>_<ENV> et la query string. Les rendus sw/sh plus grands sont des upscales.
• Ratings peuvent être un nombre agrégé sans avis derrière, qui ne peut pas être importé comme avis.
• Videos peuvent être des ids opaques dont l'hôte n'est pas exposé.

Parcourir les autres pages

Les pages de produit et catégorie sont couvertes par la capture ci-dessus. Tout le reste (à propos, expédition, retours, FAQ, légal, localisateur de magasin, formulaires, cartes-cadeaux, fidélité) est généralement lié uniquement depuis l'en-tête et le pied de page.

Seeds :

• la page d'accueil ;
• chaque lien moissonnés à partir des pages de produit et catégorie ;
• chaque URL sitemap locale par défaut que la capture de catalogue n'a pas revendiquée (les assets de contenu et les pages Page-Show n'apparaissent souvent que là).

Règles :

• Restez sur le même hôte, suivez robots.txt, et sautez les préfixes de locale alternative.
• Admettez les routes de contenu : Page-Show?cid=<id> (assets de contenu SFRA), pages Page Designer, Stores-Find (localisateur de magasin), et routes de contenu *.html ordinaires ou sans extension.
• Sautez uniquement ceux-ci : assets ; variantes de query d'une page déjà vue ; routes de catalogue que la capture possède (Product-*, Search-*) ; et routes d'action ou AJAX (Cart-*, Checkout*, Account-*, Login-*, Order-*, Wishlist-*, *-Ajax*, cibles POST de formulaire). ⚠️ Ne sautez jamais une famille de contrôleur entière qui n'est pas sur cette liste. Enregistrez-la pour examen.
• Donnez à chaque URL une disposition (captured, covered-by-catalog, skipped:<reason> ou failed:<status>) dans data/sfcc-discovery/page-inventory.json. Les re-runs retentent les failed.

Pour chaque page capturée, lisez son contenu et proposez la destination Wix : une page statique, des items CMS, un formulaire, des localisations de retrait, un produit carte-cadeau, ou un item manuel ou supprimé. La prose de politique comme les seuils de livraison gratuite, les délais de livraison, le libellé TVA ou la fenêtre de retour est une preuve pour les paramètres Wix, pas des paramètres.

• Citez-le verbatim dans data/sfcc-discovery/policy-rules.json, avec status: candidate.
• Ne remplissez jamais une valeur que le texte n'énonce pas.
• Faites confirmer à l'utilisateur chaque règle, y compris les limites de seuil, les titres d'option d'expédition et les estimations de livraison. Stockez sa réponse verbatim et mettez status: confirmed avant que quelque chose soit écrit dans Wix.

Être courtois et repérable

• Gardez un throttle pour chaque requête (commencez autour de 60 par minute), utilisez un timeout borné, et relancez 429/503 en honorant Retry-After.
• Faites des checkpoints au fur et à mesure, pour qu'un re-run reprenne et retente uniquement les échecs. Rafraîchissez les prix et le stock juste avant l'import.
• Décodez les URLs toléremment : un % malformé ne doit pas avorter le run.

Remise (artifacts existants uniquement)

Chaque stage écrit uniquement sa propre partie, par les contrats qui existent déjà :

État URL, chaque fichier dans son propre rôle :

• base-paths.json : intention de route au niveau entité depuis la urlPolicy de mapping.
• url-ledger.ndjson : une ligne append-only par enregistrement public (URL source, cible planifiée et actuelle).
• redirects.ndjson : uniquement quand les deux URLs relatives sont connues et diffèrent.
• unresolved.ndjson : uniquement les URLs toujours en attente d'une décision de route, d'une lookup de cible ou d'un examen manuel.
• Une URL préservée (même chemin relatif) ferme sans redirect.

Items de cutover :

⚠️ Aucune UI de cutover ne lit ceux-ci encore. Ils sont préservés pour elle, pas câblés à elle.