# VILMAL — Przewodnik negocjacyjny B2B

**Dla:** rozmowy z Zarządem Fabryki (Vilmax) · **Data:** 21.09.2026 · **Status:** dokument operacyjny, poufny
**Materiał uzupełniający:** `docs/PREZENTACJA_ZARZAD.html` (metryki scc/COCOMO, testy, ROI, załącznik dowodowy)

---

## 1. Cel rozmowy

Przekształcić udowodniony stan techniczny w decyzję biznesową: fabryka zyskuje gotowy system
przygotowania ofert (PIM + media wariantowe + eksport kanałowy), a zespołowi VILMAL zapewniamy
model finansowania zrównoważony z wartością — **retainer operacyjny + success fee**.

**Jedno zdanie pozycjonujące:**
> „VILMAL zamienia zdjęcia z hali i potwierdzone dane producenta w zatwierdzoną, wielowariantową
> paczkę sprzedażową — i jest już sprawdzony w realnym kanale: OSKAR działa w katalogu BaseLinker
> zasilającym sklep jako rodzic 690927524 z 34 wariantami i 272 zdjęciami."

---

## 2. Scenariusz prezentacji live (30–40 min)

Prezentujemy **realny przepływ na żywym systemie**, nie slideware. Kolejność celowo zaczyna się
od końca łańcucha — od pieniądza.

| # | Krok | Co pokazujemy | Co zarząd ma zobaczyć |
|---|------|----------------|------------------------|
| 1 | **Bazarowy Świat / BaseLinker** | Katalog Base: rodzic OSKAR `690927524`, 34 warianty, galerie 8 zdjęć per wariant (272 łącznie), read-back po zapisie | Oferta wielowariantowa już istnieje w kanale sprzedaży — to nie obietnica |
| 2 | **VILMAL — przestrzeń produktu** | `#/produkty/oskar`: zakładki Materiały → Fakty → Galeria → Warianty → Dokumenty → Oferta | Jeden ekran prowadzi pracownika przez proces; braki i „następny krok" liczy system |
| 3 | **Warianty — matryca** | Matryca 17 odcieni × L/P × 8 ról; podgląd zatwierdzonego medium wariantu; historia wersji | Skala: 272 ujęcia bez 272 sesji; każdy wariant ma swój stan i dowód |
| 4 | **Orkiestrator** | `#/produkty/:slug` → panel orkiestratora: rekomendacje z priorytetami, podgląd diff, decyzja approve/reject | AI proponuje, człowiek akceptuje; każda operacja ma podgląd i ważność 24 h |
| 5 | **Outbox eksportu** | Panel eksportu: zatwierdzony snapshot (SHA-256) → osobna zgoda → wsad → statusy pozycji → read-back | Zapis zewnętrzny jest kontrolowany transakcyjnie; brak duplikatów, brak „cichej" publikacji |
| 6 | **Karta PDF + treści** | Karta produktu PDF i rewizje treści kanałowych z tego samego snapshotu | Jeden snapshot prawdy zasila wszystkie formaty |

**Zasady prowadzenia:**
- Nie pokazujemy logów, promptów ani konfiguracji — zarząd kupuje proces i kontrolę, nie technologię.
- Na każdym kroku akcentujemy **bramkę człowieka**: nic nie przechodzi dalej bez zatwierdzenia.
- Padnie pytanie o awarię → pokazujemy `unconfirmed` + pojednanie po SKU (timeout ≠ duplikat).

---

## 3. Podział kompetencji — kluczowy slajd porządkujący rozmowę

| VILMAL (silnik — Master Data Package) | Fabryka (decyzje handlowe) |
|---|---|
| Ingest materiałów, provenance, niemutowalne oryginały | Tone of Voice marki i kanałów |
| Fakty produktu z dowodami (`unverified` → `confirmed`) | Cenniki, rabaty, polityka kanałów |
| Galeria, warianty tkanin, dokumenty, paczka ofertowa | Wybór modeli i kolekcji do publikacji |
| Snapshot SHA-256, wersjonowanie, audit | Akceptacje treści i eksportu (rola approver) |
| Outbox do BaseLinker: zapis, read-back, pojednanie | Prowadzenie sprzedaży, zamówienia, logistyka (Base pozostaje centrum) |
| QA (Maciuś) — oceny i propozycje poprawek | Finalna akceptacja i odpowiedzialność za treść oferty |

**Formuła obronny punkt:** system nie podmienia handlu — daje handlowi kompletny, zweryfikowany
materiał do decyzji. Fabryka zachowuje 100% kontroli nad tym, co i gdzie jest publikowane.

---

## 4. Odpowiedzi na przewidywane obiekcje

### „Dlaczego zaczęliście od najtrudniejszego produktu — wielkiego narożnika?"

Celowo. Vertical Slice na produkcie najbardziej wymagającym (gabaryt 257×151 cm, funkcja spania,
5 poduszek, 2 paczki 110 kg, 17 odcieni × 2 strony) dowodzi całej ścieżki naraz. Gdyby system
działał na fotelu, nikt nie wiedziałby, czy udźwignie narożnik. Teraz wiadomo — i prostsze
produkty są podzbiorem udowodnionego procesu.

### „Czy wizualizacje wariantów są wiarygodne? Kolor na ekranie ≠ kolor w ręce."

Uczciwa granica, którą system ujawnia zamiast maskować:
- Recolor przenosi **potwierdzoną próbkę producenta** na **zatwierdzone zdjęcie realnego mebla** —
  geometria, cienie i faktura są rzeczywiste 1:1; zmienia się wyłącznie tapicerka.
- Odcienie i kolekcje mają statusy weryfikacji — operator widzi `unverified` i nie wyśle ich dalej
  (guard recoloru blokuje niepotwierdzone wejścia).
- W UI zapisano jawnie: HEX jest orientacyjny, monitor nie gwarantuje zgodności barwy.
  Rekomendacja handlowa: przy pierwszych kolekcjach dołączyć próbnik fizyczny do procesu sprzedaży.

### „Co z dodaniem kolejnych tkanin / kolekcji?"

To proces rzędu minut, nie projekt: wklejamy URL strony kolekcji producenta → system pobiera
snapshot, parsuje odcienie i kartę PDF, tworzy katalog `unverified` → approver potwierdza →
od tej chwili odcienie przechodzą guard recoloru i wchodzą do matrycy każdego produktu.
Zweryfikowane na żywym imporcie: kolekcja ARENA — 17 odcieni + karta, jeden job.

### „A jeśli zdjęcie z hali jest słabe? AI tego nie naprawi uczciwie."

Zgoda — i dlatego system nie udaje. Galeria wymaga referencji o właściwej roli; braki są jawne
(„brak ujęcia X"), nie zamiatane placeholderem. AI może poprawiać w kontekście zatwierdzonym
przez człowieka, ale źródło prawdy o produkcie zostaje nienaruszone.

### „Co się dzieje, gdy BaseLinker odpowie błędem albo zniknie połączenie?"

Outbox jest transakcyjny: pozycja przechodzi w `unconfirmed`, worker pojednaje stan po SKU
odczytem zwrotnym zamiast ślepego ponowienia — brak duplikatów w katalogu. Odwołanie zgody
anuluje wszystko, co jeszcze nie wysłane. Adapter produkcyjny jest domyślnie wyłączony —
żaden zapis nie wyjdzie bez świadomej zgody na konkretny SHA snapshotu.

### „Dlaczego mamy płacić retainer, skoro system już jest?"

System jest zbudowany i udowodniony — retainer kupuje **ciągłość operacyjną**: nowe modele
i kolekcje, kalibrację jakości, utrzymanie kontraktów Base/Allegro, rozwój (kolejne role ujęć,
dokumenty, wideo po osobnej zgodzie), backup/monitoring i odpowiedzialność za regresję.
Alternatywa to odtworzenie tego stanu w software house — wycena COCOMO tego repozytorium:
**$817 984 / ~12,7 miesiąca / 5,7 osoby**.

---

## 5. Propozycja modelu biznesowego

### Rekomendowana struktura: retainer + success fee

| Element | Propozycja | Co obejmuje |
|---|---|---|
| **Retainer operacyjno-wdrożeniowy** | stały budżet miesięczny (do ustalenia po kalibracji zakresu) | utrzymanie systemu na serwerach Vilmax, rozwój kolejnych etapów (m.in. wdrożenie prod., wideo I2V), QA i nadzór Maciusia, SLA reakcji |
| **Success fee** | % od obrotu/marży online generowanej przez oferty zasilane z VILMAL | rozliczenie za danymi BaseLinker (przypisanie zamówień do produktów eksportowanych z paczek VILMAL) |
| **Próg startowy** | pierwsze N modeli w cenie retainera | kalibracja procesu na realnym katalogu fabryki bez ryzyka przepłacenia |

### Dlaczego ten model jest uczciwy dla obu stron

- Fabryka nie płaci za liczbę zdjęć — płaci za działający kanał i dzieli się wynikiem, więc
  interesy są zgodne (system zarabia, gdy oferty sprzedają).
- Retainer pokrywa realny koszt utrzymania i rozwoju — success fee jest premią, nie opłatą
  za samo istnienie software'u.
- Rozliczenie oparte na danych BaseLinker — transparentne, audytowalne, bez „czarnej skrzynki".

### Granice, które sami stawiamy (buduje zaufanie)

- Płatne generacje AI i każdy zapis live do Base wymagają osobnej, jawnej zgody z zakresem
  i limitem — to cecha procesu, nie przeszkoda.
- Nie publikujemy właściwości tkanin (Easy Clean, OEKO-TEX, Martindale) bez dokumentu
  producenta — chroni fabrykę przed ryzykiem reklamacji i GPSR.
- Dane handlowe (ceny, EAN) pochodzą wyłącznie z decyzji fabryki — system ich nie zgaduje.

---

## 6. Plan działania po rozmowie

1. Uzgodnić zakres pilotażu operacyjnego (następny model/kolekcja + odbiór na serwerze Vilmax).
2. Zamknąć etap 8 masterplanu: samodzielny runtime, TLS, backup/restore, monitoring.
3. Pierwszy kontrolowany zapis live outboxem na uzgodnionym koncie (pojedynczy produkt,
   read-back, decyzja o strukturze parent/variants).
4. Harmonogram dodawania kolekcji tkanin i modeli pod kalendarz sprzedaży fabryki.

---

*Dokument roboczy — liczby techniczne zweryfikowane pomiarami z dnia 21.09.2026
(załącznik w PREZENTACJA_ZARZAD.html). Kwoty handlowe do kalibracji w negocjacjach.*