Înapoi la portofoliu
IntegrareClient real

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.

Migrare Avanticart → WooCommerce

Stack principal

PHP
MySQL
MySQLi
SQL
HTML5CSS3JavaScriptAvanticart CDNWooCommerce (target)WordPress (target)

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

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.