Charopis to dedykowany silnik produktu do generowania opisów produktowych w e-commerce. Zastąpił najbardziej żmudny etap pracy wprowadzania produktów szybkim, przewidywalnym i przyjemnym procesem.
📋 Metryki projektu
- Start: 14 maja 2023 r. (Initial Repo)
- Status: Produkcyjne wdrożenie (skladmuzyczny.pl)
- Rola: Full-Stack Developer / Architect
- Cel: Skrócenie time-to-market dla nowych produktów
🚀 Ewolucja produktu (Product Journey)
- Proof of Concept (Postman) — API wywoływane manualnie w celu testowania promptów i jakości generowanych treści.
- MVP (React UI) — prosty interfejs z podzielonym ekranem; operator weryfikował tekst i kopiował go do CMS.
- Automatyzacja (Playwright) — automatyczne wprowadzanie treści do panelu sklepu bez „copy-paste”.
- Produkcja (Native API) — natywna komunikacja z API SOTE i Shoper zapewniła stabilność i szybkość.
🎯 Problem biznesowy
W branży muzycznej opisy muszą być precyzyjne (gatunek drewna, typ przetworników, charakterystyka brzmienia). Ręczne tworzenie takich treści dla tysięcy SKU generowało straty i blokowało sprzedaż online.
❌ „Bóle” i wyzwania operacyjne
- Straty czasu: Żmudne pisanie opisów zamiast rozwoju sklepu i obsługi klienta.
- Brak gwarancji jakości: Trudno utrzymać wysoki poziom merytoryczny przy masowej skali.
- Niestabilność i brak powtarzalności: Nierówne struktury opisów psuły profesjonalny wizerunek.
- Paraliż przy nowych dostawach: Setki produktów czekały na publikację, bo copywriting był wąskim gardłem.
- Duplicate Content: Kopiowanie opisów od producentów obniżało pozycjonowanie — potrzebne były unikalne treści.
💡 Dlaczego to działa? (Podejście produktowe)
- Głęboki kontekst branżowy: System tłumaczy dane techniczne na język korzyści z zachowaniem terminologii muzycznej.
- Human-in-the-loop: Operator weryfikuje draft w CMS, eliminując halucynacje i dbając o jakość.
- Bezpieczeństwo i onboarding: Kinde (SSO) upraszcza zarządzanie dostępami i zabezpiecza logowanie.
- Integracje multi-platform: Natywna obsługa API SOTE i Shoper pozwala skalować na różne platformy.
📈 Wpływ na biznes (ROI)
| Metryka | Przed Charopisem | Z Charopisem | Zysk |
|---|---|---|---|
| Czas na 1 produkt | ~60 minut | ~15 minut | -75% czasu |
| Wydajność dzienna | 6–8 opisów | 30–50 opisów | ~500% wzrostu |
| Jakość SEO | Nierówna | Spójna i unikalna | Wyższa widoczność |
„Charopis zdjął z naszych barek pracę, która była nieznośnym dodatkiem do codzienności. Dziś nie wyobrażamy sobie pracy bez tego systemu.”
🛠️ Architektura i stack techniczny
- Logic: Express.js + Bull.js + Redis (kolejkowanie z retries)
- Interface: Next.js / React (responsywny panel operatora)
- Auth: Kinde (SSO)
- LLM orchestration: Openrouter
- Integracje: SOTE API, Shoper API (natywne połączenie z CMS)
- Infra: Docker Compose + Dokploy (zarządzanie własnym VPS-em)
🚀 Dalsze plany
- Wizualny monitoring postępu zadań (UX kolejki)
- Rozszerzenia do importu pól nieobsługiwanych natywnie przez API systemów e-commerce
- Wiele, wiele innych pomysłów na rozwój produktu, które tu ciężko w 2 słowach opisać.
Artefakty
- Strona: https://charopis.pl