Teacher commission

EduBook Pro can compute teacher commission as a percentage of the revenue their groups generate, or as a flat per-student or per-session amount. Once a pay period closes, you settle entries (mark paid, add notes) from the Reports → Commissions tab on desktop, and the teacher can see their own statement at app.edubookapp.com/my-commission.

Plan tier

Commission tracking is available on every plan. The self-view at app.edubookapp.com/my-commission depends on the web dashboard, which requires Pro or higher.

What commission tracking gives you

• One commission rule per teacher (percentage, per-student, or per-session).
• Automatic computation each time a payment is recorded against one of the teacher’s groups.
• A per-teacher dashboard card showing paid, outstanding, and the last settlement date.
• A self-view page so the teacher can check their own numbers without calling the owner.
• An audit timeline — every settle, edit, or adjustment is logged with who did it and when.

Setting a teacher’s commission rate

1. Open the desktop app → Teachers.
2. Click the teacher whose rate you want to set.
3. Scroll to Commission.
4. Pick a model:
   • Percentage of revenue — most common. The teacher earns X% of every payment recorded against their group.
   • Per student — flat amount per active student per month.
   • Per session — flat amount per session the teacher runs.
5. Type the rate (e.g. 30 for 30%, or 50 for 50 EGP per student/session).
6. Save.

The rate applies going forward only — earlier entries already on the books keep the rate they were computed with. If you need to backfill, edit the existing entries one by one from Reports → Commissions.

The teacher’s view

When you create a teacher account, the desktop offers to send the teacher a dashboard invite by email. That magic-link sets up their app.edubookapp.com login and lands them on /my-commission — a read-only page that shows:

• Current pay period: paid + outstanding totals.
• The last 12 months of monthly statements.
• A breakdown by group for the active period.
• The audit timeline (who settled what, when) so the teacher can trust the numbers.

The teacher cannot edit anything from this page. Settlements stay on the desktop, gated by the commissions.settle permission.

Sending invites to existing teachers

If you added teachers before the dashboard-invite flow shipped, go to Teachers → Send dashboard invites. This bulk-mails any teacher who doesn’t have a user record yet. The button is idempotent — re-sending to a teacher who already has a login does nothing.

The owner’s overview

On the web dashboard, owners see a richer view at /my-commission:

• Center totals for the active period (paid + outstanding).
• One card per teacher with their numbers.
• A drill-down modal for any teacher card so the owner can click into a specific teacher’s entries without leaving the page.

Teachers see only their own row on this page; the role-aware endpoint hides everyone else.

Settling commission entries

Settling = marking a batch of entries as paid for a pay period.

1. Desktop → Reports → Commissions tab.
2. Pick the period (this month, last month, semester, or custom).
3. Expand a teacher card.
4. Click Settle period — a confirm dialog reminds you that the entries will be locked once settled.
5. Add a note if needed (e.g. payment reference number).
6. Confirm.

After settlement:

• The entries move from outstanding to paid.
• An audit row is written with the actor, timestamp, total amount, and note.
• The teacher’s self-view updates immediately.

Undoing a settlement

If you settled by mistake, expand the teacher card again and use Undo last settlement. This:

• Moves the entries back to outstanding.
• Writes a matching audit row so the timeline is honest about what happened.

The commissions.delete permission gates undo so receptionists can’t accidentally reverse closed payouts.

The audit timeline

Every settle, edit, undo, and rate change is logged. Expand a teacher’s card on the desktop Reports → Commissions tab and the timeline shows up at the bottom:

Field	Meaning
When	Local date + time of the change
Who	Staff account that triggered the change
Action	Settled, undone, rate changed, entry edited
Amount	Total touched (signed if negative)
Note	Free-text reason the actor typed

The timeline is also surfaced to the teacher on their self-view — they see the same audit rows for their own entries.

Permissions

The catalogue distinguishes four actions:

• commissions.view — can open the Commissions tab.
• commissions.settle — can run a settlement.
• commissions.edit — can adjust amounts on an unsettled entry.
• commissions.delete — can undo a settlement.

Owners have all four by default. Teachers have only the implicit right to view their own entries via the self-view; the desktop tab is hidden from them.