Sorsell – Dokumentacja
Spis treści
- Wprowadzenie
- Jak to działa
- Wymagania wstępne backend
- Instalacja Windows
- Polecenia API
- MultiVendor
- Demo / Deploy
- Wprowadzenie do funkcji
- Ustawienia ogólne
- Płatności
- Page Builder – wprowadzenie
- Flash Sale – wprowadzenie
- SEO
- Wielojęzyczność
- Open AI
- AWS
- Laravel API
- Laravel Upgrade
Wprowadzenie
Sorsell to nowoczesna platforma e-commerce, która umożliwia tworzenie rozbudowanych sklepów internetowych z pełnym wsparciem dla wielojęzyczności, różnych metod płatności, systemu MultiVendor oraz integracji z narzędziami AI i chmurowymi.
Dokumentacja opisuje wszystkie aspekty instalacji, konfiguracji i użytkowania Sorsell, zarówno dla backendu (Laravel API), jak i frontendowych integracji (React).
Jak to działa
Platforma Sorsell opiera się na architekturze frontend + backend, w której:
- Backend oparty jest na Laravel API,
- Frontend może być realizowany w React,
- System obsługuje MultiVendor, co pozwala na wiele sklepów i sprzedawców w jednym środowisku,
- Płatności i inne integracje są w pełni konfigurowalne,
- Możliwe jest uruchomienie Sorsell lokalnie lub na serwerze produkcyjnym (demo/deploy).
Wymagania wstępne backend
Przed rozpoczęciem instalacji Sorsell na backendzie upewnij się, że masz zainstalowane:
- PHP >= 8.1
- Composer
- MySQL >= 8
- Node.js i npm/yarn
- Git
- Serwer Apache lub Nginx
Wszystkie dodatkowe zależności są opisane w sekcjach instalacji dla Windows i Linux.
Instalacja Windows
- Sklonuj repozytorium Sorsell:
git clone https://github.com/TwojeRepo/Sorsell.git
- Zainstaluj zależności backend:
composer install
- Skonfiguruj plik
.envz ustawieniami bazy danych i kluczami API. - Uruchom migracje bazy danych:
php artisan migrate
- Uruchom serwer lokalny:
php artisan serve
Frontend (React) można uruchomić w katalogu /frontend poleceniem:
npm install
npm start
Polecenia API
Sorsell udostępnia zestaw poleceń API, które umożliwiają administrację systemem i integrację z zewnętrznymi aplikacjami.
Przykładowe polecenia:
- Pobieranie listy produktów:
GET /api/products
- Tworzenie nowego zamówienia:
POST /api/orders
- Aktualizacja danych użytkownika:
PUT /api/users/{id}
- Autoryzacja i tokeny API są obsługiwane przez OAuth2 / JWT, zależnie od konfiguracji systemu.
MultiVendor
Sorsell wspiera system MultiVendor, dzięki czemu w jednym sklepie mogą działać różni sprzedawcy.
Funkcje MultiVendor:
- Rejestracja sprzedawców i ich panel administracyjny,
- Oddzielne zarządzanie produktami, zamówieniami i płatnościami,
- Wsparcie dla prowizji i opłat transakcyjnych,
- Możliwość konfigurowania limitów produktów i promocji dla poszczególnych sprzedawców.
Demo / Deploy
Sorsell oferuje możliwość szybkiego uruchomienia demo środowiska lub pełnej produkcyjnej instalacji.
Demo:
- Skorzystaj z repozytorium demo:
git clone https://github.com/TwojeRepo/Sorsell-demo.git
- Uruchom serwer lokalny:
php artisan serve
- Frontend React:
npm install
npm start
Deploy:
- Możliwe wdrożenie na serwerach z Linux/Apache/Nginx.
- Wymagane ustawienia środowiska w
.env(baza danych, API, klucze). - Zalecane użycie PM2 dla frontendowego serwera React w produkcji.
Wprowadzenie do funkcji
Sorsell posiada bogaty zestaw funkcji, w tym:
- System zamówień i koszyka,
- Wsparcie dla kuponów i promocji,
- Integrację z metodami płatności online (Iyzico, Mollie, Paystack, Paymongo),
- Page Builder do łatwego tworzenia stron i sekcji,
- Flash Sale – system czasowych promocji,
- SEO – optymalizacja pod wyszukiwarki,
- Wielojęzyczność i lokalizacja treści,
- Open AI – integracja z narzędziami AI do analizy i rekomendacji produktów.
Ustawienia ogólne
Panel ustawień Sorsell umożliwia konfigurację:
- Nazwy sklepu, logo i podstawowych danych kontaktowych,
- Waluty i jednostek miar,
- Stref czasowych i języków,
- Integracji z systemami płatności i usługami zewnętrznymi,
- Uprawnień użytkowników i administratorów.
Płatności
Sorsell obsługuje wiele metod płatności:
- Iyzico – płatności kartą i BLIK,
- Mollie – różne systemy płatności europejskich,
- Paystack – popularny w Afryce system płatności,
- Paymongo – płatności w regionie Azji,
- Konfiguracja wymaga wprowadzenia kluczy API w panelu administracyjnym.
Każda metoda płatności może mieć osobne ustawienia prowizji i waluty.
Page Builder – wprowadzenie
Sorsell posiada Page Builder, który umożliwia tworzenie i edycję stron sklepu bez konieczności kodowania.
Funkcje Page Buildera:
- Przeciągnij i upuść elementy strony (drag & drop),
- Szablony gotowych sekcji i bloków,
- Wsparcie dla komponentów React,
- Możliwość dodawania niestandardowych kodów HTML/CSS/JS,
- Podgląd zmian w czasie rzeczywistym.
Flash Sale – wprowadzenie
System Flash Sale w Sorsell pozwala na tworzenie czasowych promocji produktów:
- Ustalanie daty i godziny rozpoczęcia i zakończenia promocji,
- Możliwość ustawienia limitu produktów objętych promocją,
- Automatyczne powiadomienia dla klientów o aktywnych promocjach,
- Integracja z panelem administracyjnym i raportami sprzedaży.
SEO
Sorsell umożliwia optymalizację SEO dla każdej strony i produktu:
- Konfiguracja meta title, meta description, meta keywords,
- Generowanie przyjaznych URL,
- Automatyczne mapy strony (sitemap.xml),
- Możliwość integracji z Google Analytics i Google Search Console,
- Zarządzanie przekierowaniami 301 i 302.
Wielojęzyczność
Sorsell wspiera wiele języków i lokalizacji:
- Możliwość tworzenia treści w różnych językach,
- Wybór języka przez użytkownika na froncie,
- Tłumaczenie dynamicznych treści produktów i kategorii,
- Konfiguracja walut i jednostek miar w zależności od regionu,
- Panel administracyjny pozwala zarządzać tłumaczeniami i lokalizacjami.
Open AI
Sorsell może być zintegrowany z narzędziami Open AI:
- Generowanie opisów produktów automatycznie,
- Rekomendacje produktów dla klientów,
- Analiza trendów sprzedaży i preferencji użytkowników,
- Konfiguracja kluczy API w panelu administracyjnym.
AWS
Sorsell obsługuje integrację z usługami AWS:
- Przechowywanie plików i obrazów w Amazon S3,
- Obsługa SES dla wysyłki maili,
- Integracja z CloudFront dla szybkiego dostarczania treści,
- Możliwość hostowania backendu na instancjach EC2.
Laravel API
Backend Sorsell oparty jest na Laravel API:
- RESTful API i autoryzacja JWT,
- Endpoints dla produktów, zamówień, użytkowników i płatności,
- Obsługa migracji i seedów bazy danych,
- Możliwość tworzenia niestandardowych modułów i rozszerzeń,
- Integracja z frontendem React lub innymi klientami API.
Laravel Upgrade
Aktualizacja backendu Sorsell (Laravel) wymaga:
- Zaktualizowania plików composer.json,
- Wykonania komendy:
composer update
- Uruchomienia migracji bazy danych, jeśli są nowe:
php artisan migrate
- Sprawdzenia zgodności wszystkich modułów i paczek,
- Przetestowania działania API i frontendowych integracji.