Migrare Avanticart → WooCommerce
Discovery tehnic pentru migrarea unui magazin Avanticart în WooCommerce: inventarierea modelului de date, maparea produselor și variațiilor, analiza prețurilor și relațiilor și utilitare PHP pentru verificarea imaginilor din CDN.

Stack principal
Provocarea
Provocarea a fost înțelegerea unui model Avanticart legacy cu multe relații și transformarea lui într-un plan de migrare coerent către WooCommerce, fără a pierde semantica dintre produse părinte și variații, prețuri, atribute, categorii și imagini. Media avea o dificultate suplimentară: baza păstra identificatori și metadata, iar fișierele trebuiau reconstruite printr-un pattern de CDN și moștenite de variații atunci când acestea nu aveau imagini proprii.
Soluția
Soluția a combinat analiza structurii bazei și a relațiilor cu două utilitare PHP de verificare. Documentația definește mapping-ul Avanticart → WooCommerce și ordinea etapelor de import, iar tooling-ul interoghează catalogul legacy, testează pattern-urile CDN și oferă un viewer paginat pentru produse și galerii. Pentru variațiile fără media proprie, viewer-ul colectează parent IDs și încarcă imaginile părinților într-un query bulk, apoi le marchează separat în interfață.
Complexitate notabilă
Proiectul surprinde etapa de analiză și pregătire a unei migrări reale din Avanticart către WooCommerce. Snapshot-ul documentat al bazei sursă include un catalog cu produse părinte și variații, prețuri regular/sale, categorii ierarhice, producători, atribute, clienți, adrese, comenzi, istoric de status și review-uri. Repository-ul păstrat pentru portofoliu nu include dump-urile SQL, astfel încât aceste volume sunt cele documentate în analiza realizată pe backup, nu valori recalculate din repository.
Partea centrală a lucrării este mapping-ul semantic dintre modelul Avanticart și ținta WooCommerce. Produsele părinte și variațiile sunt separate prin product_parent_id, mărimea și culoarea sunt identificate ca atribute candidate pentru variații, celelalte atribute rămân metadata de produs, iar producătorii sunt proiectați către o taxonomie de brand. Analiza urmărește și prețurile publice, stocul, SKU-urile, categoriile multiple, descrierile și SEO slugs, astfel încât ordinea de import propusă să respecte dependențele dintre date.
O zonă care a necesitat investigație separată a fost media. Avanticart păstra referințe de imagini în baza de date, în timp ce fișierele erau servite din CDN. Un script PHP testează formate de URL pe un subset de imagini, iar un al doilea utilitar oferă o interfață web de inspecție cu paginare și filtre. Acesta grupează imaginile pe produs și, pentru variațiile fără imagini proprii, face un al doilea query bulk pentru părinții necesari și atașează galeria părintelui. Pattern-ul documentat și folosit în viewer este bazat pe seo_name, picture_id și sufixul CDN "-2.webp".
Viewer-ul este un instrument intern, nu un frontend de magazin: PHP randat server-side, HTML/CSS inline și puțin JavaScript pentru marcarea imaginilor care nu se încarcă. Filtrele sunt GET, pagina este convertită explicit la integer, iar output-ul textual principal este escap-at cu htmlspecialchars. În schimb, nu există autentificare, observabilitate, retry/backoff sau un strat de servicii; erorile de conectare la DB sunt afișate direct, iar URL-ul imaginii include date provenite din baza legacy fără escaping HTML explicit.
Din punct de vedere al performanței, codul evită un N+1 evident pentru moștenirea imaginilor: parent IDs sunt colectate și imaginile părinților sunt încărcate într-un singur query IN. Totuși, query-ul principal aplică LIMIT/OFFSET peste join-ul produs-imagine, nu peste lista de produse distincte. În consecință, numărul de carduri pe pagină poate varia, iar galeria unui produs poate fi tăiată între pagini. O implementare de producție ar pagina întâi ID-urile produselor, apoi ar încărca relațiile pentru acel set.
Documentația propune fazele următoare — configurarea WooCommerce, importul master data, produse, media, variații și opțional clienți/comenzi, plus review-uri — dar repository-ul analizat nu conține scripturile finale de import, joburi, reconciliere automată, redirects sau deployment. Din acest motiv, proiectul este prezentat ca analiză tehnică și prototip de validare care reduce riscul unei migrări complexe, nu ca o migrare finalizată.
Rezultate cheie
- Inventarierea și documentarea domeniilor principale din baza Avanticart: produse, prețuri, imagini, atribute, categorii, producători, clienți, adrese, comenzi și review-uri
- Separarea explicită a produselor părinte de variații prin product_parent_id și definirea mapping-ului către produse variabile WooCommerce
- Mapping pentru preț curent, preț vechi, stoc, SKU, categorii și atribute către structura țintă WooCommerce
- Identificarea pattern-ului de CDN folosit de viewer pentru imaginile de produs
- Utilitar PHP pentru testarea URL-urilor de imagini din baza Avanticart
- Viewer web intern pentru inspecția produselor și imaginilor, cu paginare și filtre pentru status și existența media
- Fallback pentru variații fără imagini proprii prin încărcarea imaginilor produsului părinte
- Batch query pentru imaginile părinților necesari, evitând câte un query separat pentru fiecare variație
- Plan de migrare etapizat care pornește de la master data și continuă cu produse, media, variații și date istorice opționale
- Identificarea incompatibilității parolelor legacy ca punct ce necesită flux de resetare dacă migrarea clienților este implementată
Proiecte asemănătoare
- DeltaPlus Integrare ERPPortal B2B Laravel conectat la ERP ManFin pentru sincronizarea catalogului și localităților, prețuri diferențiate per client, feed-uri XML/CSV/JSON, comenzi online și export asincron al comenzilor în ERP.
- Farmadati Laravel APIBackend de integrare care preia nomenclatoare Farmadati prin SOAP, descarcă dataset-uri paginate, parsează XML în streaming, normalizează schema și persistă produse, producători, descrieri și metadate de imagini pentru consum prin API.
- Platformă Comenzi SamedayConcept tehnic pentru centralizarea comenzilor din mai multe magazine WooCommerce și declanșarea generării AWB dintr-un singur panou, reutilizând integrarea de curier existentă în fiecare magazin în locul reconstruirii ei în backend-ul central.
Vrei ceva similar?
Începe cu wizard-ul de estimare — răspunzi la câteva întrebări și primești un range de preț + timeline realist.