# Targets, commission rules and decision notifications

Targets, commission policies, earned amounts, details and exports are private to the CEO and administrator by default. The CEO can delegate branch-scoped staff management, performance/targets/reviews and commission payout preparation to assigned branch managers as described in [delegation-payroll-branch-reports.md](delegation-payroll-branch-reports.md). Organisation-wide commission policy remains CEO-only; administrators can inspect and prepare payroll but cannot approve financial actions. Performance events are hidden from branch auditors' activity history. Ordinary loan officers see decision notifications for their business records, without private target or commission data.

Monthly targets are officer/branch/month records with immutable revisions and a CEO explanation. New-money disbursement totals and loan counts trace to approved payouts and exclude replacement debt. Collection actuals are verified ordinary repayment cash, including repayments on replacement loans; recovery sales, debt transfers, rejected/pending and reversed payments are excluded. Officer attribution is snapshotted on origination from the application preparer and inherited by replacement loans. Staff transfers do not rewrite historical attribution. Detail pages link the qualifying source transactions. Zero target displays “No target”; it does not divide by zero.

Commission earning is disabled until the CEO explicitly saves an enabled policy. The CEO chooses a percentage from 0–100%, original officer or payment-evidence recorder, inclusion of recovery interest and replacement-loan interest, and a payment-date start date of today or later. The suggested 10% rate is an editable starting value, not an enabled policy. Each save creates an immutable version. The latest version with an effective date on/before the payment date, available at verification, is captured once for that source. A newer version starting on the same day affects later verifications without rewriting posted earnings. An earlier-dated payment cannot borrow a later policy. There is no automatic backfill of pre-feature transactions.

Only the actual verified interest allocation earns commission. Principal, fees, unapplied cash credit, expected contractual interest and debt transfers do not earn commission. Recovery inclusion uses the interest allocation from verified sale proceeds and its recorded payment-evidence staff if that recipient option is chosen. Per-source rounding is to the nearest cent.

Repayment reversal offsets its original commission movements at the original effective payment date, matching the existing reversal policy. Early settlement that credits prior interest back to the client removes the associated commission using newest interest allocations first, including uncommissioned allocations so excluded sources cannot create unrelated offsets. Each offset retains the original recipient, rule and earning link. Reversing that settlement compensates its offsets. A disabled current policy still permits corrections to previous earnings. Source snapshots and unique source/leg keys prevent retries, later policy changes or re-enabling earning from recognising a source twice.

This step records earned commission only. It does not pay commissions, calculate statutory payroll deductions or create salary expenses; payroll integration is the next step. There are no statutory tax/benefit assumptions in these calculations.

CEO approvals, rejections, returns, verification and repayment reversals create persistent in-app result notices for the preparer and, where linked, original loan officer. Recovery evidence preparers also receive relevant results. Notices include the business reference, decision reason and a protected record link. They respect the recipient's current branch access and are marked as seen automatically when the notification page is opened. Officers have no acknowledgement controls. Decision updates remain in the history; seeing one never resolves or approves the underlying business task. New decisions receive new unread notices; seen state is per recipient. No external SMS/email provider is used, and older decisions are not retroactively notified.

After deployment run `php yii migrate`. Migration 000014 adds officer attribution, versioned targets, commission rules/earnings and decision notices. A reviewed rollback is required to preserve financial and decision history.


CEO staff management includes ordinary staff accounts, business roles and branch assignments, plus profile links to private performance/commission reports. Profiles show readable role labels. Administrator accounts and technical-admin grants remain administrator-controlled; CEO accounts retain their secure-console management path. Raw audits remain administrator-only.

New target forms list active loan officers only and derive the branch on the server. The most recent current assignment to an active branch is used when an officer has more than one assignment. No branch field is posted or trusted. Officers without an active branch cannot receive a new target. Revisions keep the original officer/branch/month even after a transfer; new targets use the officer’s new branch. Migration 000015 grants CEO staff-management access.