# Kontrakt treści dla szablonów Base.com

Modułowy układ opisów Dywanowy Bazar — **bloki zaufania** (deterministyczne) + **opis produktu** (AI) + **marketplace** (AI).

Konfiguracja bloków: [`config/description-blocks.json`](../config/description-blocks.json)  
Składanie payloadu: [`src/descriptionAssembly.js`](../src/descriptionAssembly.js)  
Pełna lista tagów BL: [`BASELINKER-TEMPLATE-TAGS.md`](BASELINKER-TEMPLATE-TAGS.md)

## Mapowanie pól (apka → API → szablon aukcji)

| Pole API | UI Base.com | Tag BL | Źródło | Rola |
|----------|-------------|--------|--------|------|
| `description` | Opis główny | `[opis]` | **Składane** | Nagłówek zaufania + narracja OLX (plain text → HTML) |
| `description_extra1` | Opis dodatkowy 1 | `[opis_dodatkowy1]` | Szablon | Pakiet zaufania — kontrola przed wysyłką |
| `description_extra2` | Opis dodatkowy 2 | `[opis_dodatkowy2]` | AI (base) | Pełny opis produktu (sklep, 7 sekcji) |
| `description_extra3` | Opis dodatkowy 3 | `[opis_dodatkowy3]` | AI (Allegro) | Opis aukcji Allegro |
| `description_extra4` | Opis dodatkowy 4 | `[opis_dodatkowy4]` | AI (OLX) | Ogłoszenie OLX (plain text) |

Wszystkie cztery tagi `[opis_dodatkowy1]`…`[4]` są widoczne w edytorze szablonu aukcji na koncie (np. *SZABLON Prawidłowy*).

### Przykładowe układy szablonów (operator ustawia w panelu)

**Allegro** — pełny modułowy układ:

```text
[opis_dodatkowy1]
[opis_dodatkowy3]
```

**OLX** — zaufanie + parametry + narracja AI (plain text; szablony: [`szablon_olx`](szablon_olx), rekomendowany PREMIUM: [`szablon_olx_PREMIUM.md`](szablon_olx_PREMIUM.md)):

```text
[opis_dodatkowy1]

PARAMETRY
[cechy_lista]

Wymiar: [szerokosc] x [dlugosc] cm
EAN: [ean]

[opis_dodatkowy4]

Dywanowy Bazar · dywanowy-bazar.pl
Wysyłka kurierem. Zapytaj przez OLX — odpowiadamy szybko.
```

**Sklep / wspólny** — narracja OLX w opisie głównym; pełny katalog w extra2:

```text
[opis]
```

Pełny opis produktu (bez nagłówka zaufania) — **szablon sklepu**:

```text
[opis_dodatkowy2]
```

Opcjonalnie zaufanie + pełny opis:

```text
[opis_dodatkowy1]
[opis_dodatkowy2]
```

## Nagłówek zaufania (góra `[opis]`)

Krótko, bez straszenia — klient ma czuć, że **dywan jest sprawdzany**, a przy wątpliwości **skontaktujemy się przed wysyłką**. Pod nagłówkiem w `[opis]` trafia **narracja OLX** (2–4 zdania, plain text z AI). Gdy OLX jest wyłączone lub brak treści — `[opis]` używa opisu Base z `description_extra2`.

### OUTLET (powystawowy / magazyn)

> **Oferta outletowa**  
> Dywan z naszej selekcji outletowej — zwykle po ekspozycji lub z magazynu, w stanie bardzo dobrym i gotowy do użytkowania. Każdy egzemplarz **dokładnie sprawdzamy przed wysyłką**. Gdy stan odbiega od opisu, skontaktujemy się z Tobą przed nadaniem paczki.

### PO_ZWROCIE

> **Produkt po zwrocie konsumenckim**  
> To zwrot od poprzedniego klienta — najczęściej nieodebrana przesyłka lub nietrafiony zakup. Przed ponowną wysyłką **dokładnie kontrolujemy stan dywanu**. Jeśli coś wymaga doprecyzowania, odezwiemy się do Ciebie, zanim wyślemy zamówienie.

## Pakiet zaufania (`[opis_dodatkowy1]`)

Rozbudowany blok — ten sam ton, więcej szczegółów o procesie:

- **OUTLET:** kontrola stanu tuż przed spakowaniem; kontakt przed wysyłką przy istotnych skazach.
- **PO_ZWROCIE:** szczegółowa kontrola (powierzchnia, frędzle, wymiar); piszemy/dzwonimy przed nadaniem.

Treści edytujesz w `config/description-blocks.json` — bez ponownego trenowania AI.

## Opis produktu (AI)

Kanał `base` generuje **wyłącznie** opis produktu: lead, dlaczego warto, parametry, zastosowanie, CTA.  
**Bez** outletu, zwrotu, kontroli przed wysyłką — to osobne bloki.

## Workflow operatora

1. Import → **krok 2:** wybór **Outlet** lub **Po zwrocie** (potwierdzenie przed AI).
2. **Krok 4:** generacja AI → `copyBlocks` w drafcie + składanie pól.
3. **Szablony BL** — układasz tagi `[opis]`…`[opis_dodatkowy4]` według kanału (Allegro / OLX / sklep).

## Zasady treści

- OUTLET i PO_ZWROCIE — **różne formuły**, nie mieszać.
- Zakaz: «doskonała okazja», «gwarantuje satysfakcję», «stan jak nowy» bez kontekstu.
- Transparentność buduje zaufanie — nie ukrywaj charakteru oferty.

Szczegóły publikacji: [`AUTO-PUBLISH-BL.md`](AUTO-PUBLISH-BL.md).