Operator guideENcrmaffiliatesformcrud

Affiliate Deals / Form

Create and edit form for affiliate deals, including PID, date window, commercial terms, and responsible person.

Reader view

Clean portal guidance

This page keeps the operator explanation, field and action descriptions, and screenshots visible without exposing repo paths, raw sidecars, or editorial-only implementation details.

Narrative content

Page body

What this form does

This form creates or updates one affiliate deal row. It captures the PID, the active date window, the commercial terms, and the responsible person.

When to use it

  • add a new contractual period for a PID
  • correct dates or commercial terms on an existing deal
  • set or change the responsible person for the row

How to read it

The form is intentionally short. It has two logical groups:

  • scope: PID and date range
  • commercial terms: fixed fee, CPA, revshare, and responsible person

Validation and operator rules

  • PID is required
  • Start Date is required
  • Responsible Person is required
  • at least one of Fixed Fee, CPA, or RevShare must be greater than 0
  • RevShare must stay within 0 to 100

Known caveats

  • The edit page currently hydrates from the list hook in the FE instead of calling a dedicated detail hook first.
  • End Date is optional. Leaving it empty makes the deal open-ended until another backend rule caps the effective period on reporting pages.
  • Cancel returns to the list page and does not save anything.

Verification status

  • status: verified_backend
  • FE validation checked in AffiliateDealForm
  • backend create and update services checked in CreateAffiliateDealService and UpdateAffiliateDealService
Field dictionary

Fields

field

PID

Affiliate PID this deal belongs to.

Data Type
string
field

Start Date

First date when the deal terms apply.

Data Type
date
field

End Date

Optional final date for the deal row.

Data Type
date
field

Fixed Fee

Fixed fee component of the deal.

Data Type
amount
field

CPA

Cost-per-acquisition amount used for qualified CPA payout.

Data Type
amount
field

RevShare

Revenue-share percentage applied to the verified revshare base.

Data Type
percentage
field

Responsible Person

Internal owner of the deal row.

Data Type
string
Operational notes

Notes

item

FE edit hydration currently starts from the list hook result instead of a dedicated detail request on page load.

item

Backend services allow empty `endDate` and default numeric terms to zero.

Related references

Related pages

pageAffiliate Deals / Dashboard

Deal-period performance report that combines traffic, deposit, GGR, NGR, payout, and ROI metrics for affiliate deals.

pageAffiliate Deals / List

Searchable table of affiliate deal rows with PID filter, create action, dashboard shortcut, and edit/delete row actions.

pageAffiliate Deals Overview

Operator guide for affiliate-deal records, their create/edit flow, and the performance dashboard that reconciles contract settings with delivered traffic and revenue metrics.

pageAffiliate Payment Settings

Operator documentation for the affiliate payment configuration workspace, including payment settings and sending-window tabs.

pageAffiliate Payment Settings / Detail

Saved affiliate payment-setting detail page for reviewing one configured record.

pageAffiliate Payment Settings / Form

Create and edit form for one affiliate payment-setting record, with visible PID targeting, minimum deposit threshold, and active-state control.