Realizacja afiliacji — v2. Jak zapracowany partner wpisuje klientów bez tarcia

Data: 2026-08-12

Wersja: 2 (rozwinięcie specyfikacji v1: https://r.10s.pl/realizacja-afiliacji/)

Wstęp — dlaczego v2

Specyfikacja v1 opisała dashboard partnera: jak prowizja się nalicza (25% od netto

pierwszego zakupu → 300/600 zł brutto), jak wygląda panel i jakie są stany akcji. Ale

zostawiła jedno kluczowe, nierozwiązane pytanie praktyczne:

**Jak fizycznie klient trafia do systemu pod ID partnera, gdy partner jest zapracowany?**

Warunkiem prowizji jest wpisanie klienta pod ID partnera przed zakupem. Jeśli wpis

wymaga od partnera wysiłku (karta, formularz, logowanie), część rekomendacji ginie —

a z nią prowizje i motywacja.

Ten raport (v2) rozwiązuje konkretnie problem zero-tarcia wpisywania, na dwóch

rzeczywistych use case'ach:

1. Fizjoterapeuta — 15 wizyt dziennie, pracuje rękami, nie ma jak klikać w telefon.
2. Chirurg — 60 osób dziennie po 2–3 min, nie ma w ogóle czasu; ale ma recepcję.

Zasada nadrzędna: "partner nie będzie nic wpisywał"

Zanim przejdziemy do konkretów — jedna zasada projektowa, która spina oba case'y:

**Partner ma wykonać CZYNNOŚĆ MINIMALNĄ (jedno działanie), a resztę przejmuje system

Kluczowe uproszczenie: nie potrzebujemy od partnera pełnych danych klienta od razu.

Żeby liczyć się jako rekomendacja i zabezpieczyć atrybucję, wystarczy **imię + nazwisko +

numer telefonu**. Reszta (adres, e-mail, zgody RODO, wybór pakietu) jest dociągana później

przez back-office przy kontakcie z klientem.

Dlatego wszystkie rozwiązania poniżej redukują wpis do absolutnego minimum.

Use case 1: Fizjoterapeuta, 15 wizyt dziennie

Problem

Marta pracuje rękami, 15 pacjentów dziennie, jedno po drugim. Między wizytami nie ma ani

sekundy na otwieranie panelu, logowanie i wypełnianie formularza. Po pracy jest zmęczona

i nie pamięta dokładnie, kogo widziała. Klasyka: rekomendacje "giną" w pamięci.

Opcje rozważane (z odpowiedzią na Twoje pytania)

Rekomendacja: GŁOSÓWKA (voice capture) + szybki dodatek

Główna ścieżka = nagrywanie głosowe. Fizjoterapeuta w ciągu dnia nagrywa krótkie

głosówki z nazwiskami i telefonami — na telefonie (aplikacja partnera) lub przez

podpięty WhatsApp/Telegram. Na jedną rekomendację: "Kowalski Jan, 600 100 200".

15 pacjentów = ok. 2–3 minuty nagrywania łącznie w ciągu całego dnia.

Dlaczego to działa:

• Zero pisania — praca głosem naturalna dla osoby, która cały dzień ma zajęte ręce.
• Natychmiastowe — 3 sekundy między wizytami, nie "po pracy z pamięci".
• Pamięć nie zawodzi — nagrane w momencie, gdy pacjent wychodzi.
• 20 sekund dziennie łącznie na obsługę wpisów (nie 15× minuty).

Co robi system po nagraniu (automatyzacja):

1. Marta nagrywa głosówkę → aplikacja wysyła ją do systemu.
2. Transkrypcja głosu → tekst (ASR) — system rozpoznaje nazwisko i numer telefonu

automaticznie (rozpoznawanie numeru i nazwiska z mowy). Jeśli pewność wysoka —

tworzy wpis automatycznie pod ID Marty.

1. Marta dostaje push: "✓ Dodano: Jan Kowalski (600 100 200)" — może poprawić tylko

te, które system źle rozpoznał (edycja jednym tupnięciem).

1. Wpis ma status wpisane → liczy się dla prowizji (warunek spełniony) → resztę

danych dociąga back-office przy kontakcie.

Fallback bez AI: jeśli transkrypcja głosu nie jest dostępna w MVP — głosówki lądują

do kolejki back-office, która je odsłuchuje i wpisuje ręcznie (to 30 min pracy back-office

na fizjoterapeutę dziennie, nie 15 min po stronie partnera). Partner wciąż nie pisze nic.

Dodatkowy tryb quick-add: gdy fizjoterapeuta ma chwilę i telefon w ręce — przycisk

"+" w panelu, 3 pola (imię, nazwisko, telefon), zapis z potwierdzeniem live (jak w v1).

Use case 2: Chirurg, 60 osób dziennie po 2–3 min — robi to recepcja

Problem

Chirurg przyjmuje 60 pacjentów dziennie, na każdego ma 2–3 minuty. Nie ma ani czasu,

ani możliwości wpisywać czegokolwiek. Ale chirurg ma recepcję — i to jest kluczowe.

Pytanie Twojego briefu: *czy lepiej, żeby chirurg powiedział coś pacjentowi, czy dał mu

coś do ręki?*

Odpowiedź wprost

/ back-office. Im mniej pól, tym więcej wpisów.**

**OBYDWA, ale w podziale ról: chirurg mówi JEDNO zdanie + daje coś do ręki, a wpis do

Nie stawiamy chirurga przed wyborem "mówić czy dać" — on ma zrobić jedną rzecz,

która łączy oba: rekomendację werbalną + materiał w rękę. A dane fizycznie wprowadza

recepcja (bo ona i tak ma dane pacjenta w swoim systemie).

Dlaczego tak — rozbicie

1. Mówienie (rekomendacja werbalna) — buduje zaufanie, ale NIE zbiera danych.

Słowo chirurga ma największą moc konwersji (pacjent ufa lekarzowi). Ale samo powiedzenie

"polecam ten ośrodek" nie daje nazwiska ani telefonu → brak wpisu → brak prowizji.

Verbalna rekomendacja jest niezbędna, ale nie wystarczająca.

2. Danie czegoś do ręki (karta/link/QR) — zbiera dane, ale przez pacjenta.

Materiał z QR kodem / linkiem polecającym pozwala pacjentowi samemu się wpisać

(self-service). To odciąża i chirurga, i recepcję. Ale konwersja zależy od tego,

czy pacjent faktycznie otworzy link i wypełni formularz — część tego nie zrobi.

3. Recepcja — wprowadza dane, bo je ma.

Recepcja kliniki i tak zna nazwisko i telefon każdego pacjenta (z wizytówki/legitymacji).

Przy zapisie pacjenta może od razu, na 30 sekund, wpisać go w panel pod ID chirurga

(check-box "poleca nasz partner"). To przenosi wysiłek z chirurga na recepcję — tam gdzie

jest na to czas i dane.

Podział ról — tabela

Co chirurg daje do ręki — materiał minimalny

NIE broszura kliniczna. To ma być kartka rekomendacyjna (rozmiar wizytówki):

• po jednej stronie: imię/nazwisko chirurga + "Polecam ośrodek Convertere — normobaria" + QR kod / link;
• QR prowadzi do formularza z zapisanym ID chirurga (atrybucja automatyczna);
• zero cenników i szczegółów — to materiał "do rejestracji", nie edukacyjny.

Pacjent, który zeskanuje QR, sam się wpisuje (oszczędza recepcji robotę). Pacjent,

który nie zeskanuje — wpisuje go recepcja przy zapisie. W obu przypadkach wpis ma

ID chirurga → prowizja zabezpieczona.

Czy recepcja "za niego"? — tak, i to jest poprawna decyzja

Wysiłek wpisania przenosimy na recepcję świadomie. To dobra decyzja, bo:

• recepcja ma dane pacjenta pod ręką i gotowy workflow zapisu;
• chirurg robi tylko to, co tylko on może zrobić: rekomendację (autorytet, którego

recepcja nie ma);

• 60 pacjentów × 30 s recepcji = 30 min pracy recepcji, ale zero minut pracy chirurga

na administrację.

• Kluczowe: nie każemy recepcji wpisywać wszystkich 60 — tylko tych, którym chirurg

świadomie przekazał kartkę (5–15 dziennie). Reszta to zwykłe przyjęcia.

Tabela porównawcza 2 use case'ów

Co to zmienia w specyfikacji v1 (implikacje dla zespołu)

Wprowadzamy do v1 nowe elementy, których tam nie było:

1. Moduł Voice Capture (głosówka) — nagrywanie, ASR (transkrypcja), tworzenie wpisu,

push z potwierdzeniem/edycją. Nowa encja Nagranie → wpis Klient polecony.

1. Tryb Quick-Add (3 pola) — minimalny formularz wpisu zamiast rozbudowanego;

reszta danych dociągana przez back-office.

1. Wizytówka QR z zapisanym ID partnera — materiał do ręki dla pacjenta;

link polecający z atrybucją (już zasugerowany w v1, teraz konkretny artefakt).

1. Rola/praca recepcji — nowy aktor Recepcja w back-office; wpisuje klientów pod

ID chirurga (checkbox "rekomendacja partnera" w workflow zapisu). Nowa rola RBAC.

1. Usprawnienie warunku wpisu — pole wpisu zredukowane do minimum dla partnera,

a pełną zgodę RODO zbiera back-office przy kontakcie (nie partner przy wpisie).

RODO — jak to gra w obu ścieżkach

• Głosówka/quick-add (fizjo): partner podaje imię+nazwisko+telefon. To są dane

osobowe; podstawa przetwarzania to zgoda klienta na kontakt/rekomendację (osobna zgoda

w regulaminie pakietu — jak w v1). Sens: partner nie zbiera pełnych danych ani rozszerzonych

zgód — system/back-office dociąga je przy pierwszym kontakcie z klientem.

• Recepcja (chirurg): recepcja ma już dane pacjenta w systemie kliniki; przekazanie do

panelu afiliacji wymaga zgody klienta (checkbox w zapisie). Chirurg nie przetwarza danych

— tylko przekazuje kartkę; to recepcja (a właściwie system Convertere) robi wpis pod

upoważnieniem partnera i za zgodą klienta.

• Zalecenie: pojedyncza zgoda RODO na "przekazanie danych do ośrodka poleconego" przy

rekomendacji — wspólna dla obu ścieżek.

Rekomendacje do wdrożenia (priorytety)

Priorytet 1 — Zero-tarcia wpis (filary):

• Moduł głosówki (fizjo) + transkrypcja ASR → auto-wpis z potwierdzeniem live.
• Quick-add (3 pola) w panelu i aplikacji.
• Wizytówka QR z ID partnera + checkbox recepcji (chirurg).

Priorytet 2 — Automatyzacja atrybucji:

• Każda ścieżka (głosówka, quick-add, QR, recepcja) pisze ten sam ID partnera → jeden

mechanizm atrybucji, zero zdublowanych prowizji (spójne z v1 sekcja 4/9).

Priorytet 3 — Pomiar:

• Metryka współczynnika wpisania (wpisane / polecone) per ścieżka — widać, która

ścieżka jest najmocniejsza i gdzie system traci wpisy.

Źródła (Linki URL)

• https://r.10s.pl/realizacja-afiliacji/ — specyfikacja v1 (dashboard partnera, stawki, stany, panel)
• https://www.hubermanlab.com/newsletter/toolkit-for-sleep — odniesienie do kontekstu zdrowotnego (normobaria, regeneracja)

Źródła (Pliki)

• /root/convertere/reports/realizacja-afiliacji-v2.md — ten raport (wersja źródłowa Markdown)
• /var/www/projects/realizacja-afiliacji/index.html — v1 (istniejąca specyfikacja)

Glosariusz

• ASR / Voice Capture — automatyczne rozpoznawanie mowy (głos → tekst); w naszym

zastosowaniu: nagranie → rozpoznane nazwisko i numer telefonu → wpis.

• Quick-Add — szybki formularz wpisu klienta (3 pola: imię, nazwisko, telefon).
• Atrybucja — przypisanie rekomendacji (a więc i prowizji) do konkretnego partnera przez jego ID.
• Współczynnik wpisania — % poleconych klientów faktycznie wpisanych pod ID (kluczowa metryka).

*Nie stanowi porady prawnej ani medycznej. Kwestie RODO i umów wymagają konsultacji

prawnej przed wdrożeniem.*