Platformă Comenzi Sameday
Concept 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.

Stack principal
Provocarea
Provocarea era centralizarea operațiunilor de livrare pentru mai multe magazine fără a muta sursa de adevăr din WooCommerce și fără a reimplementa întreaga integrare de curier. Soluția trebuia să păstreze setările și datele specifice fiecărui magazin, să reducă pașii manuali ai operatorului și să definească o limită clară între dashboard-ul central și responsabilitatea pluginului local.
Soluția
Arhitectura propusă folosește un panou central read-only care primește rezumate de comenzi și trimite către magazinul sursă doar comanda de generare AWB. Un endpoint WordPress custom urma să autentifice cererea cu HMAC și timestamp, să recitească WC_Order și setările locale și să reutilizeze pluginul/SDK-ul Sameday pentru AWB. Astfel, integrarea complexă cu servicii, lockere, pickup points, PDF și tracking rămâne în componenta deja existentă, iar aplicația centrală se concentrează pe agregare și operare.
Complexitate notabilă
Proiectul a fost conceput pentru un operator care administrează mai multe magazine WooCommerce și pierde timp intrând separat în fiecare wp-admin pentru a verifica comenzile și a genera documentele de transport. Direcția definită în repository este o aplicație centrală read-only: comenzile sunt agregate într-un singur dashboard, iar acțiunea principală este „Generează AWB”. Comanda rămâne sursa de adevăr în WooCommerce, astfel încât adresele, metoda de plată și opțiunile de livrare nu sunt editate în aplicația centrală.
Arhitectura propusă evită duplicarea API-ului de curier. Fiecare magazin păstrează pluginul oficial Sameday Courier, care știe deja să autentifice contul, să sincronizeze servicii, pickup points, lockere/easybox, să estimeze costul, să genereze și să șteargă AWB-uri, să producă PDF-ul, să adauge colete și să citească istoricul de status. Aplicația centrală urma să trimită către magazin doar identificatorul comenzii printr-un endpoint WordPress custom; pluginul/site-ul sursă ar fi reconstruit payload-ul din WC_Order și meta-datele locale, apoi ar fi executat operația de AWB în contextul magazinului.
Repository-ul conține două livrabile proprii de proiectare: o specificație tehnică și o prezentare HTML pentru varianta cu buget restrâns. Ele descriu un flux complet de la comandă la AWB, modelele propuse Site, Order și Awb, un OrderIngestService pentru webhook sau pull periodic, un AwbService și o politică simplă de retry. Pentru comunicația dintre aplicația centrală și WordPress este documentată autentificarea cu HMAC-SHA256, timestamp și cheie separată per site, iar rollout-ul era gândit întâi pe un magazin pilot și apoi replicat.
Important pentru evaluarea portofoliului: aplicația centrală Laravel + Vue/Inertia, endpointul REST custom, HMAC-ul, webhook-ul/pull-ul de ingest și retry-ul nu sunt prezente ca implementare în codul salvat. Lista de fișiere din commitul de backup conține prototipul HTML, documentația și pluginul oficial Sameday, nu modele Laravel, migrări, controllere, componente Vue sau workflow-uri ale unei aplicații centrale. Din acest motiv proiectul este prezentat ca soluție de integrare proiectată pentru un client real, nu ca produs final livrat.
Baza third-party analizată este un plugin WordPress/WooCommerce matur. Codul său folosește PHP, JavaScript/jQuery, WP_List_Table, tabele MySQL prin wpdb și SDK-ul PHP Sameday. Sunt implementate în plugin generarea AWB cu unul sau mai multe colete, alegerea serviciului și pickup point-ului, locker/easybox prin listă sau hartă interactivă, estimarea costului, extra fee și free-shipping rules, COD/repayment, open-package, PDF AWB, ștergerea AWB-ului și istoricul coletelor. Aceste capabilități explică de ce soluția propusă reutiliza pluginul în loc să dubleze această logică în aplicația centrală.
Frontend-ul propriu existent este o pagină de prezentare/prototip, nu dashboard-ul final. Folosește Inter și o paletă albastru deschis cu accente semantice verde/amber/roșu, carduri, timeline și secțiuni pentru scope, flux, livrabile și riscuri. Capturile incluse din plugin arată UI-ul WordPress moștenit: formular de configurare, selector de servicii, modal de generare AWB și tabel de istoric. Pentru produsul final, direcția logică era păstrarea clarității operaționale într-un dashboard modern, nu copierea vizuală a wp-admin.
Din perspectiva operării, proiectarea accepta explicit compromisuri pentru MVP: aplicație read-only, apel sincron către WordPress, fără queue, logging de bază și fără monitorizare avansată. Aceste limite reduc costul și aria de risc în pilot, dar înseamnă că operațiile bulk, idempotency, locking, rate limiting, reconcilierea periodică și observabilitatea ar fi trebuit definite înainte de utilizare la volum mai mare. Pluginul moștenit are propriile verificări de rol administrator/shop_manager și nonce pentru operațiile sensibile, însă endpointul custom documentat nu poate fi considerat securizat până când HMAC-ul, anti-replay-ul și autorizarea pe site/comandă nu sunt implementate și testate.
Rezultate cheie
- Specificație tehnică pentru un flux multi-store WooCommerce → panou central → WordPress → generare AWB
- Prototip HTML de prezentare a variantei MVP, cu scope, flux end-to-end, livrabile, limitări și pași de rollout
- Separarea explicită a aplicației centrale read-only de sursa de adevăr WooCommerce
- Plan de reutilizare a pluginului oficial de curier în locul duplicării API-ului și mapping-urilor în backend-ul central
- Model de date propus pentru Site, Order și Awb și servicii propuse pentru ingest și generare AWB
- Design de securitate propus cu HMAC-SHA256, timestamp anti-replay și cheie separată per magazin
- Inventarierea capabilităților pluginului existent: servicii, pickup points, lockere/easybox, AWB, PDF, colete și istoric de status
- Definirea limitărilor MVP: fără editare centrală a comenzilor, fără queue și cu apel sincron către magazinul sursă
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.
- Migrare Avanticart → WooCommerceDiscovery 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.
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.