# ROLLOUT PLAN — Vilmax Cockpit (aligned z MVP_PLAN.md)

**Data:** 2026-08-28
**Źródło prawdy:** `docs/MVP_PLAN.md` v2.0 (etapy 1/2/3), `docs/PROGRESS.md` (MVP COMPLETE, 487 testów, Etap 2 AI w trakcie)
**Zasada:** nie wymyślamy własnych faz. Etapy z MVP_PLAN + AGENTS.md §14.

> **Status faktyczny:** Etap 1 (MVP) = ZAKOŃCZONY (8 modułów, 487 testów pass). Etap 2 (AI capabilities) = w trakcie (6 kroków wdrożonych: Groq LLM, BiRefNet removeBg, matryca 5 ujęć, texture-swap, Kling wideo, RunComfy). Etap 2 (sklep WooCommerce) + Etap 3 = przed nami.

---

## ETAP 1 — MVP (ZAKOŃCZONY)

**Moduły (8) z MVP_PLAN §1:**
1. Spec Extractor (FR→PL) — `src/adapters/bobochicFR.js` (56 cech, 18 testów E2E) ✅
2. Visual AI Studio — `src/visual/` (removeBg, staging, dimensionBlueprint, fabricLibrary, shotMatrix) ✅
3. Listing & Variant Generator — `src/openai.js`, `src/draft.js`, `descriptionAssembly.js` ✅
4. BaseLinker Push — `src/baselinker.js` (addInventoryProduct, dry-run+live) ✅
5. Social Media & Ads Studio — `src/social/`, `src/video/` (Reels, posty, Google Ads) ✅
6. Catalog & Print Studio — `src/catalog/` (PDF A4, puppeteer) ✅
7. Prompt & Brand Studio — `src/pages/Settings.jsx`, `src/aiConfigSnapshots.js` ✅
8. Saturn ERP Ghost Adapter — `src/saturn/` (webhook + outbox + worker) ✅

**Features z benchmarku Bobochic pokryte w Etapie 1:**
- Ekstrakcja 56 cech → **POKRYTE**
- Schemat wymiarowy SVG → **PRZEWAGA VILMAX**
- RemoveBg z foto hali (BiRefNet) → **PRZEWAGA VILMAX**
- Matryca 5 ujęć per wariant → **CZĘŚCIOWO** (5 vs 15)
- Texture-swap (FLUX i2i, generic) → **CZĘŚCIOWO** (brak hex control)
- Staging (Sharp composite + RunComfy FLUX) → **CZĘŚCIOWO**
- Filmy Kling 3.0 Pro (lifestyle) → **CZĘŚCIOWO** (demo mechanizmu nie)
- Karta PDF A4, próbnik tkanin → **POKRYTE** (poza Bobochic — nasza przewaga B2B)

**Koszt AI API (Etap 1, szacunek na 100 produktów/mies):**
- AI copy (Groq darmowy tier / OpenAI failover ~$0.005/draft): ~$0–$0.50/mies
- RemoveBg BiRefNet (~$0.02/img × ~5 img/produkt × 100): ~$10/mies
- Staging Sharp composite: $0 (offline)
- RunComfy FLUX (~$0.05/img × ~5 img × 100): ~$25/mies
- Texture-swap FLUX i2i (~$0.04/img × ~10 kolorów × 100): ~$40/mies
- Kling wideo ($0.112/s × 5s × 100): ~$56/mies
- **Razem AI API: ~$130/mies** (przy 100 produktach, pełne pokrycie wizualne)
- Infra: Render starter ~$19/mies (lub free na testy)

**Czas:** ZAKOŃCZONY. MVP COMPLETE (audyt finiszowy 2026-08-26: 359→487 testów, 51 endpointów, 8 stron frontend, zero 501).

---

## ETAP 2 — Po MVP (sklep + pełny AI)

**Moduły/zadania (z MVP_PLAN §2 + AGENTS.md §14):**
- Sklep D2C WooCommerce + PayPo + Ratami 0% (BL zarządza wystawianiem)
- Pełny AI Texture-Swap (fałdy, przeszywy, cienie realistyczne) — ComfyUI/Replicate
- Realism Lock (kalibracja kolorów pod próbnik, LUT/ICC pipeline)
- Auto-publikacja Social Media (API Meta/Google, nie human-in-the-loop)
- Rozszerzenie matrycy 5→15 ujęć (tył, góra, szwy, nóżki, accoudoir, sekwencja mechanizmu, multi-wnętrza)
- Film demo mechanizmu (ControlNet video / keyframe interpolation)
- AI disclosure (Charte IA + etykieta na wygenerowanych wizualizacjach)
- KSeF automatyczna faktura (przez BL)
- Pełny scraper FR z OCR etykiet (openaiVisionOcr.js już jest)
- Opcjonalnie: MariaDB/Redis jeśli wolumen draftów > 10 000

**Features z benchmarku Bobochic pokryte w Etapie 2:**
- Design sklepu (paleta, typografia, layout) → **POKRYTE** (WooCommerce, benchmark: <200 KB transfer, <2s load)
- Trust elements (Trustpilot, 30 dni, ratalne) → **POKRYTE** (WooCommerce + BL)
- Multi-country → **POKRYTE** (WooCommerce multi-store)
- Galeria 15 ujęć per wariant → **POKRYTE** (rozszerzenie shotMatrix)
- Texture-swap z hex control → **POKRYTE** (Realism Lock)
- Film demo mechanizmu → **POKRYTE** (ControlNet video)
- Performance benchmark (196 KB, 1,65s) → **cel do osiągnięcia**

**Koszt AI API (Etap 2, 100 produktów × 15 ujęć × 10 kolorów = 15 000 wygenerowań/mies):**
- RunComfy FLUX (~$0.05/img × 15 000): ~$750/mies
- Texture-swap FLUX i2i (~$0.04/img × 15 000): ~$600/mies
- RemoveBg BiRefNet (~$0.02/img × 100 × 1 raw): ~$2/mies
- Kling wideo ($0.112/s × 5s × 100 × 2 warianty): ~$112/mies
- AI copy: ~$0–$0.50/mies
- **Razem AI API: ~$1 460/mies** (pełny paritet wizualny z Bobochic)
- Infra: Render starter $19/mies + WooCommerce hosting ~$20-50/mies + CDN obrazów ~$10/mies
- **Alternatywa on-prem GPU:** RTX 4090 capex ~$10k, opex prąd ~$30-50/mies (patrz INFRASTRUCTURE_OPTIONS)

**Czas:** długo (sklep + pełny AI texture-swap + Realism Lock to największy etap). Kilka sprintów.

---

## ETAP 3 — Po Etapie 2 (ERP + Room Studio)

**Moduły/zadania (z MVP_PLAN §2 + AGENTS.md §14):**
- Saturn ERP integracja (odpisywanie stanów — pełne spięcie, nie tylko Ghost Adapter)
- Master Configurator (interaktywny kompozytor na wymiar)
- Room Studio (przymierzalnik wnętrz z uploadem zdjęcia klienta)

**Features z benchmarku Bobochic pokryte w Etapie 3:**
- Brak bezpośrednich features Bobochic (to są moduły przyszłościowe wykraczające poza sklep D2C)
- Room Studio = przewaga funkcjonalna ponad Bobochic (przymierzalnik AR/upload)

**Koszt AI API (Etap 3):**
- Master Configurator / Room Studio: dodatkowe wywołania FLUX (zależne od wolumenu konfiguracji klientów)
- Saturn ERP: integracja BL webhook → Saturn API (koszt API Saturn, nie AI)
- **Razem: marginalny dodatek ponad Etap 2** (głównie LLM dla konfiguratora)

**Czas:** średnio (integracja ERP + 2 nowe moduły UI). Sprinty po stabilizacji Etapu 2.

---

## PODSUMOWANIE KOSZTÓW (szacunki, ceny API się zmieniają)

| Etap | AI API/mies | Infra/mies | Capex | Czas |
|---|---|---|---|---|
| Etap 1 (MVP) | ~$130 | $19 (Render) lub free | $0 | ZAKOŃCZONY |
| Etap 2 (sklep + pełny AI) | ~$1 460 (cloud API) LUB ~$50 (on-prem prąd) | $19 + $20-50 (Woo) + $10 (CDN) | $0 (cloud) LUB ~$10k (on-prem GPU) | długo |
| Etap 3 (ERP + Room Studio) | marginalny dodatek | jak Etap 2 | $0 | średnio |

**Decyzja infrastrukturalna (patrz INFRASTRUCTURE_OPTIONS.md):** Dla Etapu 1 = cloud API (fal.ai/RunComfy). Dla Etapu 2 przy 15 000 wygenerowań/mies = on-prem RTX 4090 zwraca się w ~7 miesięcy vs cloud API.