Projektowanie i uruchomienie sklepu PrestaShop ze wsparciem AI: szablon procesu pracy

Asystenci AI potrafią dziś napisać sporą część kodu, na którym działa sklep internetowy. Nie czyni to jednak projektu sklepu prostszym. Najtrudniejsza część przesuwa się z pisania kodu na decyzje o tym, co zbudować, dostarczenie asystentowi właściwego kontekstu i sprawdzanie tego, co wygeneruje. Ten szablon opisuje proces pracy, który pozwala zachować kontrolę nad tymi trzema obszarami – od pierwszego briefu po kolejne miesiące po starcie.

Powstał z myślą o PrestaShop, ale większość zaleceń sprawdzi się na każdej platformie.

1. Brief i zakres

Zanim powstanie jakikolwiek kod, podejmij decyzje, których późniejsza zmiana byłaby kosztowna. Asystent chętnie zbuduje wszystko, co opiszesz – również coś, czego wcale nie potrzebujesz.

Katalog. Ile produktów, jakie atrybuty i kombinacje oraz skąd pochodzą dane.
Rynki. Kraje, waluty, podatki i przewoźnicy, których potrzebuje każdy rynek.
Języki. Od których języków zaczynasz i kto sprawdza tłumaczenia.
Wersja. Zacznij od PrestaShop 9 z wersją PHP, która wciąż otrzymuje poprawki bezpieczeństwa. Start na starej wersji oszczędza tydzień, a później kosztuje migrację.
Niezbędne moduły. Płatności, wysyłka, fakturowanie i wszystko, czego wymagają przepisy na twoich rynkach.

Zapisz ustalenia w krótkim dokumencie. Będzie to pierwszy materiał wejściowy dla asystenta.

2. Przygotuj środowisko pracy z AI

Asystent jest tak dobry, jak kontekst, który dostaje. Przygotuj ten kontekst raz, na samym początku.

Repozytorium. Od pierwszego dnia trzymaj motyw, własne moduły i konfigurację w repozytorium Git.
Instrukcje projektu. Plik CLAUDE.md w katalogu głównym opisuje sklep, jego konwencje, polecenia do uruchamiania i to, czego asystentowi nie wolno robić. Pobierz szablon i uzupełnij go.

# CLAUDE.md (excerpt)
## What this is
PrestaShop 9 store, PHP maintained. Theme: child of …
## Never
- Write to the production database
- Commit without the review gates passing

Dostęp do sklepu tylko do odczytu. Serwer MCP z dostępem tylko do odczytu do plików i bazy danych pozwala asystentowi sprawdzić, jak sklep jest faktycznie skonfigurowany, zamiast zgadywać. Nie rozszerzaj tego dostępu: zmiany powinny trafiać do sklepu wyłącznie przez przejrzany kod.
Prywatność. Dane klientów nie mogą opuszczać sklepu bez maskowania. Używaj narzędzi, które maskują dane osobowe, zanim trafią do modelu, albo pracuj na zanonimizowanej kopii.

3. Projekt graficzny

Używaj asystenta do szukania pomysłów, a nie do podejmowania decyzji.

Zacznij od design tokenów: kolorów, skali typograficznej i odstępów, ze sprawdzonym pod kątem dostępności kontrastem.
Wygeneruj dwa lub trzy kierunki dla strony głównej i strony produktu, a potem samodzielnie wybierz jeden z nich.
Pracuj na motywie potomnym, aby aktualizacje motywu nadrzędnego nie nadpisywały twojej pracy.
Ustal budżet wydajności dla Core Web Vitals i sprawdzaj go w każdym szablonie, nie tylko na końcu.

4. Katalog i treści

Importuj produkty z uporządkowanego pliku źródłowego, zamiast wpisywać je ręcznie.
Poproś asystenta, by dane sprawdził, a nie tylko wczytał: brakujące zdjęcia, zduplikowane indeksy, puste opisy i niespójne atrybuty.
Dodaj dane strukturalne produktów, aby wyszukiwarki i asystenci AI mogli odczytać ceny, dostępność i opinie.
Tłumacz z pomocą asystenta, a przed startem zleć sprawdzenie każdej wersji językowej.

5. Własny kod

Większość sklepów potrzebuje kilku własnych modułów. To tutaj wsparcie AI oszczędza najwięcej czasu i tutaj przegląd kodu ma największe znaczenie.

Opisuj jedną zmianę naraz i dbaj o to, by każda była na tyle mała, żeby dało się ją przejrzeć.
Proś o testy razem z kodem.
Uruchamiaj bramki przy każdej zmianie: PHPStan do analizy statycznej, reguły bezpieczeństwa ze standardów kodowania i skaner sekretów, na przykład gitleaks.
Przeczytaj diff osobiście. Bramki wychwytują całe kategorie błędów, ale nie znają twoich reguł biznesowych.

6. Lista kontrolna przed startem

Płatności przetestowane od początku do końca w trybie produkcyjnym, łącznie ze zwrotami.
Podatki, strefy wysyłki i przewoźnicy sprawdzeni dla każdego rynku.
Strony z informacjami prawnymi, obsługa cookies i dostępność zweryfikowane pod kątem twoich rynków.
Przekierowania ze starych adresów URL gotowe, mapa witryny zgłoszona.
Core Web Vitals zmierzone na urządzeniach mobilnych dla szablonów strony głównej, kategorii i produktu.
Kopie zapasowe skonfigurowane, a przywracanie przetestowane przynajmniej raz.
Monitoring i alerty włączone przed ogłoszeniem startu, a nie po nim.

7. Gdzie potrzebny jest człowiek

Niektórych decyzji nigdy nie należy powierzać asystentowi:

Co sklep sprzedaje, komu i za ile.
Wszystko, co dotyczy płatności, podatków lub tekstów prawnych.
Akceptacja zmian w działającym sklepie.
Odpowiedzi dla klientów w sprawie zamówień i danych.

Asystent przygotowuje, sprawdza i wyjaśnia. Decyduje człowiek.

8. Prowadzenie sklepu po starcie

Start to początek utrzymania, a nie koniec projektu. Moduły wymagają aktualizacji, wersje PHP tracą wsparcie, a dla modułów, których używasz, pojawiają się ostrzeżenia bezpieczeństwa.

Po starcie trzymaj się tego samego procesu: kontekst tylko do odczytu, małe, przejrzane zmiany i te same bramki. Jeśli utrzymujesz kilka sklepów, panel taki jak nuvols.app zbiera w jednym miejscu monitoring, ostrzeżenia bezpieczeństwa, kopie zapasowe i bezpieczne aktualizacje dla nich wszystkich.

Do pobrania

Jeśli wolisz, żebym zastosował ten proces w twoim sklepie, możesz zatrudnić mnie na Codeable.