Woo3D
Samodzielnie zbudowana wtyczka WooCommerce prototypująca prowadzony zakup druku 3D. Klient może wgrać STL, obejrzeć model w Three.js, skonfigurować materiał i wypełnienie, otrzymać estymację i przekazać dane zamówienia do WooCommerce.
Informacje o projekcie
- Rola
- Przełożyłem proces wyceny na produkt i samodzielnie zbudowałem wtyczkę, kalkulator, viewer 3D, licencjonowanie oraz integrację WooCommerce.
- Okres
- Grudzień 2025–styczeń 2026 · Niezależna budowa wtyczki
- Zespół
- Projekt samodzielny · 1 developer
Wyzwanie
Wycena usług druku 3D jest złożona. Każdy model ma unikalną objętość, materiały kosztują inaczej, czas druku zależy od wypełnienia i geometrii, a zużycie maszyny trzeba uwzględnić. Ręczna wycena jest wolna i podatna na błędy.
Kluczowa decyzja
Mierzyć objętość STL w przeglądarce przez viewer Three.js, aby wycena była natychmiastowa bez serwerowego przetwarzania geometrii.
Podejście
Wtyczka WordPress używa Three.js do podglądu STL i ekstrakcji objętości w przeglądarce. Kalkulator JavaScript estymuje koszt materiału i maszyny na podstawie objętości, wypełnienia, ilości oraz parametrów drukarki; to estymacja, a nie slicer ani symulacja G-code. Hooki WooCommerce tworzą ukryte produkty i przenoszą metadane przez koszyk. Endpoint Vercel oparty o Firebase weryfikuje opcjonalne licencje PRO.
Kluczowe elementy
- Viewer STL Three.js z ekstrakcją objętości i estymacją czasu druku
- Silnik cen multi-materiał z progami rabatów objętościowych
- Flow zamówień WooCommerce oparty o sesję od uploadu do checkoutu
- Panel admina: filamenty, parametry drukarki i wygląd
- System licencji weryfikowany przez Firebase dla funkcji PRO
- System i18n etykiet frontendu
Architektura
- Wtyczka WordPress (PHP) z pełną integracją hooków WooCommerce
- Three.js ze STLLoader do renderu modelu w przeglądarce
- Kalkulator JavaScript kosztów materiału, maszyny i rabatów
- API weryfikacji licencji Firebase hostowane na Vercel
- Dashboard ustawień admina: filament, drukarka, wygląd, licencja
- Zadanie cron WordPress do automatycznego czyszczenia draftów produktów
Weryfikacja
- Inspekcja kodu potwierdza scenę Three.js, parsowanie STLLoader, bounds modelu i generowanie miniatur
- Kod kalkulatora wyprowadza estymacje materiału i maszyny z objętości, ilości, wypełnienia, stawek i ustawień drukarki
- Hooki PHP zapisują metadane druku 3D, tworzą produkty WooCommerce, obsługują sesję zamówienia i planują czyszczenie draftów
Obecne ograniczenia
- Repozytorium nie ma testów automatycznych i nie jest spakowane do katalogu wtyczek WordPress.org
- Czas druku jest uproszczoną estymacją, a nie wynikiem slicera lub symulacji ścieżki G-code
- Funkcje PRO zależą od zewnętrznego serwisu licencji Firebase i Vercel
- Badany snapshot źródeł zawiera zduplikowaną deklarację metody PHP, którą trzeba usunąć przed uznaniem kodu za release-ready
Rezultat
Rozbudowany prototyp źródłowy obejmujący analizę STL w przeglądarce, wycenę, administrację WordPress i metadane zamówień WooCommerce. Repozytorium wymaga usunięcia duplikatu i testów automatycznych, zanim można je nazwać release-ready.
Wewnątrz produktu
