Înapoi la portofoliu
IntegrareClient real

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.

Platformă Comenzi Sameday

Stack principal

WordPress
WooCommerce
PHP
JavaScript
jQueryMySQL / wpdbSameday PHP SDKSelect2WordPress REST API (planificat)HMAC-SHA256 (planificat)Laravel (planificat)Vue / Inertia.js (planificat)

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

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.