> **UWAGA — STATUS DOKUMENTU (aktualizacja 2026-08-25):** > Niniejszy `Vixplan.md` pozostaje **dokumentem wizji strategicznej** (12 modułów, model biznesowy, harmonogram faz, strategia seedingowa). > > **Dla implementacji MVP obowiązuje:** > - `MVP_PLAN.md` v2.0 — praktyczny plan wdrożenia (fork `dywanowy-bazar`, 8 modułów, ~8 tygodni) > - `ARCHITECTURE_SPEC.md` v2.0 — Technical Design Document (Node.js ≥20, zero MariaDB/Redis, drafty na dysku) > - `AGENTS.md` v2.0 — reguły projektowe dla deweloperów i agentów AI > > **Kluczowa zmiana wizji (v2.0):** Vilmax Cockpit = **wyłącznie studio przygotowania produktu i marketingu**. Jedynym punktem wyjścia produktowym jest `addInventoryProduct` do BaseLinkera. Sklep WooCommerce, PayPo, Ratami, kurierzy, zamówienia, płatności = Etap 2 / BaseLinker. Pełna uzasadniona w `MVP_PLAN.md` v2.0 §0. --- # MASTER SYSTEM BLUEPRINT: VILMAX E-COMMERCE ENGINE & AUTOMATION SYSTEM **Kompletna, zweryfikowana i ostateczna specyfikacja systemowa, architektoniczna i biznesowa** **Przeznaczenie:** Architekt Systemu, Zespół Deweloperski, Zarząd / Właściciel Fabryki Vilmax **Model wdrożenia:** Dedykowane rozwiązanie Single-Tenant (bez narzutu SaaS) zintegrowane z BaseLinkerem jako centralnym węzłem dystrybucji (SSOT). --- ## CZĘŚĆ I: ARCHITEKTURA SYSTEMU I STOS TECHNOLOGICZNY ### 1. Inżynieria Środowiska * **Backend Core:** PHP 8.2+ (Strict Types), wzorzec architektoniczny **Domain-Driven Design (DDD)**. * **Baza Danych:** MariaDB 10.11+ (zoptymalizowany schemat relacyjny dedykowany wyłącznie pod strukturę asortymentu Vilmax). * **Szyna Zadań i Kolejki:** Redis 7+ (asynchroniczny pipeline do obsługi ciężkich zadań w tle: operacje graficzne, generowanie wideo, komunikacja REST API). * **Media Pipeline (Przetwarzanie Mediów):** Node.js (Sharp / Canvas) + FFmpeg do operacji graficznych, nakładania warstw (Overlays) oraz montażu wideo 9:16. ### 2. Rygor Danych i Standardy Techniczne * **Formatowanie danych:** Identyfikatory techniczne, kody SKU i ścieżki zasobów zapisywane wyłącznie w standardzie **ASCII**; opisy marketingowe, parametry techniczne i komunikacja z klientem w **UTF-8**. * **Izolacja i struktura:** Czysta baza danych bez flag tenancyjnych (system dedykowany dla jednej marki i fabryki). --- ## CZĘŚĆ II: ŻELAZNE ZASADY DEWELOPERSKIE (REPO-FIRST POLICY) Wszyscy programiści oraz agenci AI realizujący poszczególne elementy systemu podlegają bezwzględnym regułom inżynieryjnym: 1. **Repo-First Protocol:** Przed rozpoczęciem prac nad jakimkolwiek modułem, deweloper ma obowiązek przeszukania repozytorium, zidentyfikowania gotowych komponentów i zaprezentowania planu ich ponownego użycia. 2. **Approval Gate:** Całkowity zakaz samowolnego dołączania nowych bibliotek zewnętrznych lub pisania kodu od zera, jeśli jego odpowiednik istnieje w bazie kodu. 3. **Zakaz Hardcodowania Czasu:** Bezwzględny zakaz wpisywania na stałe sztywnych ram czasowych („wysyłka w 48h”) w kodzie, promptach czy grafikach – czas realizacji jest zawsze zmienną dynamiczną z BaseLinkera. 4. **Standard Kodu Produkcyjnego:** Każdy dostarczony blok kodu musi być kompletny, w 100% gotowy do wdrożenia, bez placeholderów `// TODO` i bez pseudokodu. --- ## CZĘŚĆ III: ARCHITEKTURA MODUŁOWA SYSTEMU VILMAX System składa się z 11 zintegrowanych modułów operacyjnych oraz zaplanowanego modułu przyszłościowego: ``` [Strona / Katalog FR] ────────────────────┐ [1 Surowe Foto z Hali] ───────────────────┤ [Cyfrowy Próbnik Tkanin] ─────────────────┼──> [VILMAX CORE PIM & AI STUDIO] ──> [BASELINKER API] ──> [Allegro / Sklep D2C / Erli] [Karta Techniczna] ───────────────────────┤ [Planer Kampanii] ────────────────────────┘ ``` ### 1. Ekstraktor Danych ze Strony Francuskiej (PIM & Specyfikacja) * Wklejenie linku lub wskazanie modelu z francuskiego katalogu Vilmax uruchamia automatyczną ekstrakcję twardych danych inżynieryjnych: wymiary gabarytowe, głębokość, wysokość, pianki (HR/T30), stelaż, sprężyny i mechanizmy rozkładania (DL, delfin, puma). * *Zasada czystego autorstwa:* System nie kopiuje francuskich zdjęć ani opisów – pobiera wyłącznie parametry konstrukcyjne i tłumaczy je na polski język korzyści. ### 2. Cyfrowa Biblioteka Tkanin (Asset Hub) * Centralna ewidencja materiałów obiciowych (tekstury 1:1, gramatura, skład, test Martindale, atesty). ### 3. AI Visual Studio (Texture-Swap, Virtual Staging & Realism Lock) * **Krok 1:** Wgranie 1 surowego zdjęcia mebla zrobionego telefonem na montażu hali produkcyjnej. * **Krok 2 (Texture-Swap):** Cyfrowe „ubranie” mebla w wybrane tkaniny z zachowaniem fałd, przeszyć i cieni. * **Krok 3 (Virtual Staging):** Osadzenie mebla w modnych polskich wnętrzach z dopasowanym oświetleniem i cieniami kontaktowymi. * **Krok 4 (Realism Lock):** Kalibracja kolorów pod fizyczny próbnik tkanin – całkowita eliminacja reklamacji i zwrotów za niezgodność odcieni. ### 4. Macro Visual Studio & Overlay Engine * Generowanie makrofotografii splotu (obiektyw 100mm) budującej wrażenie dotyku + automatyczne nakładanie badge'ów certyfikatów (*Easy Clean, Pet Friendly, Test Martindale > 100 000 cykli, Produkt Polski*). ### 5. AI Copywriting & HTML Section Builder * Przekład surowych parametrów na polski język korzyści w czystym kodzie HTML zgodnym ze standardem tagów BaseLinkera (`[opis]`, `[cechy]`). ### 6. Dynamic Video Pipeline (Reels & TikTok 9:16) * Asynchroniczny montaż 10-sekundowych materiałów wideo w formacie pionowym (detal makro $\rightarrow$ test hydrofobowości $\rightarrow$ rozkładanie funkcji spania $\rightarrow$ plansza wniesienia). ### 7. BaseLinker Integration Adapter (PIM Feeder) * Dwukierunkowy most REST API (`addInventoryProduct`, `setInventoryProductData`) – centralny punkt dystrybucji ofert do wszystkich kanałów sprzedaży. ### 8. Sklep Własny D2C (WordPress / WooCommerce) * Prestiżowy sklep fabryczny bez prowizji marketplace, zintegrowany z płatnościami odroczonymi **PayPo** oraz **Ratami 0%** oraz modułem zamawiania darmowych próbek. ### 9. Catalog & Print PDF Engine * Eksport eleganckich kart produktowych w formacie A4 High-Res PDF jednym kliknięciem dla przedstawicieli handlowych i salonów stacjonarnych. ### 10. Social Media & Ad Studio * Planer kreacji reklamowych z rygorystyczną kontrolą harmonogramu godzin publikacji w panelu. ### 11. Panel Administracyjny Vilmax & Prompt Studio * Interfejs dla pracowników do zarządzania stylem komunikacji, promptami i słownikiem słów zakazanych. ### 12. Moduł Przyszłościowy (Wizja na Fazę 2/3): *Vilmax Master Configurator & Room Studio* * Interaktywny kompozytor mebli na wymiar połączony z przymierzalnikiem wnętrz (klient wrzuca zdjęcie swojego pokoju i dopasowuje skonfigurowany mebel), oparty w pełni na gotowych silnikach z repozytorium. --- ## CZĘŚĆ IV: MODEL BIZNESOWY I LOGISTYKA (SSOT) * **Strategia D2C w Polsce:** Ominięcie pośredników, hurtowni i tradycyjnych salonów meblowych, co pozwala zatrzymać **30–50% marży handlowej bezpośrednio w fabryce**. * **Produkcja na zamówienie (*Make-to-Order*):** Zero zamrażania kapitału w magazynie wyrobów gotowych. Produkcja rusza dopiero po opłaceniu zamówienia przez klienta. * **Elastyczny czas realizacji:** Czas produkcji (np. 5, 7, 10, 14 dni roboczych) regulowany dynamicznie w szablonach BaseLinkera pod bieżące obłożenie szwalni i tapicerni. * **Przełamanie barier online:** Makrofotografie 100mm + badge atestów (*Easy Clean*, *Pet Friendly*), standardowa obsługa logistyki gabarytowej z wniesieniem do salonu klienta (*2-man delivery*: Zadbano, DTS, Ambro) oraz wysyłka próbek do Paczkomatu w 24h. --- ## CZĘŚĆ V: REALISTYCZNY PLAN WDROŻENIA I SEEDING KONTA (MAKE-TO-ORDER) ### 1. Strategia Seedingowa (Kroki Początkowe) Średnio **1 na 10 klientów (8–12%)** wystawia opinię na Allegro. Nowe konto z zerem opinii nie sprzeda drogego narożnika za 4500 zł. *Rozwiązanie:* Równolegle z dużymi meblami wprowadzamy szybkie produkty wejściowe (próbniki tkanin oraz pufy w programie Allegro Smart z wysyłką w 24h). Generują one pierwszy ruch i pozwalają szybko zebrać **pierwsze 10–15 opinii 5.0**, odblokowując status Smart przed odpaleniem płatnych kampanii Allegro Ads na duże meble. ### 2. Harmonogram Fazy Wdrożeniowej | Faza | Okres | Cel Główny | Sprzedaż Mebli (Narożniki/Sofy) | Sprzedaż Wejściowa (Próbniki/Pufy) | Spodziewane Opinie (1 na 10) | Szacowany Przychód | Kluczowe Działania | | --- | --- | --- | --- | --- | --- | --- | --- | | **Faza 0: Rozruch & Seeding** | **Miesiąc 1** | Test logistyki i budowa wiarygodności konta | **2 – 5 sztuk** (cena startowa) | **30 – 50 sztuk** (próbniki/pufy) | **4 – 6 opinii** 5.0 | ~10 000 – 22 000 zł | • Wystawienie 2 brył w cenie startowej.

• Masowa wysyłka próbników i puf.

• Test procedur wniesienia *2-man delivery*. | | **Faza 1: Trakcja & Smart** | **Miesiące 2–3** | Start Allegro Ads i odblokowanie Smart | **8 – 18 szt./mies.** (2–4 szt./tydz.) | **60 – 100 szt./mies.** | **8 – 12 opinii/mies.** (osiągnięcie 25+ opinii) | ~35 000 – 75 000 zł/mies. | • Odpalenie Allegro Ads na oferty z opiniami.

• Uzyskanie statusu Allegro Smart.

• Standardowa wysyłka wzorników tkanin. | | **Faza 2: Sklep & Multichannel** | **Miesiące 4–6** | Start sklepu Vilmax (Raty 0%, PayPo) i kolejnych portali | **25 – 50 szt./mies.** (6–12 szt./tydz.) | Stała sprzedaż wielokanalowa | **20 – 35 opinii/mies.** | ~100 000 – 200 000 zł/mies. | • Start sklepu Vilmax (Raty 0%, PayPo).

• Wystawienie na kolejne portale przez BaseLinkera.

• Płatne kampanie wideo (9:16). | | **Faza 3: Ugruntowana Pozycja** | **Miesiące 7–12** | Pełna marża D2C i stały rytm tapicerni | **60 – 120+ szt./mies.** (15–30 szt./tydz.) | Pełny ekosystem D2C | Stała renoma marki fabrycznej | ~240 000 – 500 000+ zł/mies. | • Stała, powtarzalna sprzedaż bezpośrednia bez pośredników zoptymalizowana pod moce produkcyjne fabryki. | --- ## CZĘŚĆ VI: RZECZYWISTY PRZEPŁYW PRACY W FABRYCE (WORKFLOW END-TO-END) ``` [KROK 1: POBRANIE DANYCH TECHNICZNYCH] Pracownik wkleja link / wskazuje model mebla ze strony francuskiej. System automatycznie pobiera wymiary gabarytowe, pianki, ramę, stelaż i funkcję spania. │ ▼ [KROK 2: WGRANIE FOTO Z HALI & WYBÓR WARIANTÓW] Pracownik wgrywa 1 surowe zdjęcie mebla zrobione telefonem na montażu oraz wskazuje z biblioteki tkaniny i liczbę wersji kolorystycznych do wygenerowania. │ ▼ [KROK 3: AUTOMATYCZNE GENEROWANIE PAKIETU ASSETÓW] Silnik w tle generuje: 1. Zdjęcia mebla we wnętrzach we wszystkich wybranych tkaninach (Texture-Swap + Staging). 2. Zdjęcia makro splotów z naniesionymi badge'ami atestów (Easy Clean, Martindale). 3. Rysunek techniczny z naniesionymi wymiarami. 4. Polski opis techniczny w czystym HTML (język korzyści). 5. 10-sekundowe pionowe wideo produktowe (format 9:16). 6. Gotową kartę produktową PDF A4 do druku. │ ▼ [KROK 4: WERYFIKACJA I EKSPORT (1 KLIKNIĘCIE)] Pracownik sprawdza wygenerowane materiały w panelu i klika: "Eksportuj do BaseLinkera". │ ▼ [KROK 5: WYSTAWIENIE OFERT PRZEZ BASELINKER] W BaseLinkerze rekord mebla zostaje opublikowany na wybrane kanały (Allegro, Sklep D2C, Erli itp.) z gotowym szablonem czasu produkcji (Make-to-Order) i profilem dostawy 2-man delivery. ```