TRACKING-SPECIFICATIE: influencer als aanbrenger (fase 2 bouw)

Wat er technisch bij moet zodat het influencer-programma uit DEAL.md kan

draaien. Het bestaande doorverwijssysteem doet al het zware werk; dit is een

uitbreiding, geen nieuw systeem. Lees eerst app/src/lib/aanbreng.ts en

app/src/lib/tarief.ts, en voor je bouwt GRONDFOUTEN.md (vijf vragen onderaan

als afmeldcontrole) en app/CONSISTENTIE.md.

1. Wat er al is (hergebruiken, niet herbouwen)

• Cookie + code (jp_aanbreng, 90 dagen), klantkoppeling 365 dagen,

wachttermijn 30 dagen, uitbetaaldrempel 50 euro, maandplafond,

vingerafdruk met gezouten hash, uitbetaling per factuur.

• Twee soorten aanbrenger: professional met account, en sitebeheerder met

widget. Beide lopen door dezelfde code vanaf het moment dat de code

bekend is.

2. Wat erbij komt

2.1 Datamodel (Prisma)

• AanbrengerType krijgt een derde waarde: PARTNER (influencer).

• Nieuw model Partner (of velden op Aanbrenger, keuze aan de bouwer, maar

houd het een apart model zodat een partner later ook een professional-

account kan hebben):

• id, aanbrengerId (link), naam, kanaalNaam, platform (youtube/instagram/

tiktok/overig), categorie (de zes verzamelcategorieen), volgers,

kanaalUrl, email, status (WACHT, GOEDGEKEURD, AFGEWEZEN), redenAfwijzing,

code (uniek, zelfde regels als bestaande codes), aangemaaktOp,

goedgekeurdOp, opgezegdOp (nullable).

• totaalKluswaardeCenten (cumulatief, voor het 10.000-euro-omslagpunt),

totaalGegundeKlussen (voor de startbonus).

• Geboortejaar-verklaring: het formulier vraagt een vinkje "ik ben 18 jaar

of ouder" en dat wordt opgeslagen (goedgekeurdOp-tijdstempel erbij).

2.2 Publieke partnerpagina (/partners, nl en en)

• Uitleg van de deal in gewone taal (tekst uit outreach/media-kit.md, als

vertaalsleutels in messages/nl.json en en.json, bedragen via tarief.ts,

nooit hardcoded: CONSISTENTIE.md).

• Aanmeldformulier: naam, e-mail, kanaalnaam, platform, categorie, volgers,

kanaal-link, vinkje 18+. Server action, geen betaling, geen wachtwoord.

• Na indienen: bevestigingsscherm "we kijken ernaar, je hoort binnen 3

werkdagen" + bevestigingsmail.

• De pagina staat ook op /en (i18n-namespace "partners").

2.3 Cockpit: keuringsscherm

• Sectie "Partners" met de lijst aanvragen en per aanvraag: kanaal-link

(openen), keur/afwijs-knoppen, redenveld bij afwijzen.

• Goedkeuren doet drie dingen in een: status op GOEDGEKEURD, een unieke code

aanmaken (zelfde codegenerator als de rest), en een welkomstmail sturen

met de persoonlijke link (jouwpro.nl/?ref=CODE) en de media-kit-link.

• Afwijzen stuurt een nette afwijsmail met de reden.

• Zelfde token-poort als de rest van de cockpit (COCKPIT_TOKEN).

2.4 De berekening (in tarief.ts, naast de bestaande aanbreng-getallen)

Nieuwe constanten, allemaal in tarief.ts zodat de consistentiecheck ze ziet:

• PARTNER_DEEL_PERCENT = 30 (van de servicekosten, niet van de klussom)

• PARTNER_DEEL_NA_PERCENT = 10

• PARTNER_OMSLAG_KLUSWAARDE_CENTEN = 1_000_000 (10.000 euro)

• PARTNER_STARTBONUS_CENTEN = 1000 (10 euro)

• PARTNER_STARTBONUS_MAX_AANTAL = 3

• PARTNER_MAANDPLAFOND_EURO = 500

• PARTNER_UITBETAALDREMPEL = zelfde 50 euro als de rest

De vergoedingsfunctie krijgt een partner-variant: kijk naar de cumulatieve

kluswaarde van die partner. Zolang die onder de 10.000 euro zit: 30% van de

fee (met het bestaande max-plafond van 150 euro per klus). Daarboven: 10%.

De startbonus telt alleen voor de eerste 3 klussen van die partner die op

GEGUND komen (uniek per klus, idempotent).

2.5 Overzicht en uitbetaling

• In de cockpit per partner: kliks (indien gemeten), registraties, klussen,

gegunde klussen, kluswaarde, saldo, status van de laatste uitbetaling.

• Maandelijkse overzichts-mail per actieve partner (via de bestaande

mailroute, sjabloon in mail-sjabloon.ts).

• Uitbetaling: zelfde route als de andere aanbrengers (factuur, drempel,

wachttermijn). Geen aparte betaalweg.

2.6 Kliks meten

De link is jouwpro.nl/?ref=CODE. Het cookie-mechanisme bestaat al; het

aanmaken van de cookie bij een ref-parameter bestaat ook al (dat is de

bestaande aanbreng-flow). Voor klikcijfers is een extra teller per

partner per dag nodig: een simpele tabel PartnerKlik (partnerId, dag,

aantal) die de ref-route ophoogt, net als campagne-dagvolume dat voor

Instantly doet. Geen externe tracking, open_tracking blijft uit, want de

link zelf is de tracker.

3. Randvoorwaarden en controles

• Alle bedragen via tarief.ts, alle teksten via i18n-sleutels, beide talen.

• Testdata-regel: testaanvragen met @test.jouwpro.local, opruimen via

scripts/purge-testdata.mjs, lekcontrole voor live.

• Geen openbare lijst van partners zonder hun toestemming.

• Consistentiecheck en tsc schoon, preview eerst, live pas na Bilals

akkoord (zichtbare wijziging).

• De vijf vragen uit GRONDFOUTEN.md beantwoorden voor je dit afmeldt.

4. Wat NIET in deze fase zit

• Geen betaalautomatiek via Stripe voor partners (gebeurt per factuur,

handmatig, net als de andere aanbrengers).

• Geen dashboard-login voor partners (ze krijgen het maandelijkse overzicht

per mail; een inlog komt pas als er 50+ actieve partners zijn).

• Geen contractbeheer (de voorwaarden staan op de partnerpagina; een

opzeg-knop per mail is voldoende).