HandbookPeople & money51

Staff offboarding.

A departure should be as orderly as an arrival. When a staff member leaves, YESS runs the exit as a single, compliant action: the contract closes with its reason and date, the record is deactivated, payroll stops, the login is switched off, a separation checklist is created, and a draft final settlement is opened for finance. This handbook walks that one action, the checklist that follows it, and the settlement that computes what is owed — and is honest about where 'access revoked' means the login, and where the exit interview is still just a line on a list.

  • 1action, six effects
  • 6checklist categories
  • 4settlement components
  • ≈9 minto read

Prologue

The clean exit#

The messy departure is the one where things stay open behind a name that has left: a login that still works, a salary that keeps computing, assets that never came back, a final payment argued over in the car park. YESS is built so that a separation is one deliberate action with a documented trail, not a scramble of half-remembered steps.

There are two screens in this story. Separation is initiated from the contracts screen at /dashboard/contracts — the Terminate action on an active contract. It is then worked from the offboarding workspace at /dashboard/offboarding, where the checklist and the final settlement live. This chapter walks both, and names the edges plainly.

The exit handled with the same care as the entry — nothing left open behind a departing name.

Chapter one

Initiating the separation#

A separation begins on an active contract. On /dashboard/contracts, the Terminate action appears only on contracts whose status is active; it opens a dialog that captures the human facts of the departure before anything is executed.

What the separation records

  1. 1

    Separation type

    One of seven: resignation, dismissal, end of term, redundancy, retirement, mutual, or death. The type is stamped on both the staff record and the contract, and drives the attrition and turnover analytics HR reads later.

  2. 2

    Effective date

    When the separation takes effect (defaults to today). This is the date payroll stops from and the date the final settlement's pro-rata is calculated against.

  3. 3

    Notice period

    An optional notice period in days, recorded as due-process metadata on the contract alongside who authorised the separation.

  4. 4

    Reason

    A required free-text reason, kept on the record so a decision made this term is still explainable next year.

  5. 5

    Revoke access now

    A checkbox — default on, and flagged 'recommended' for a dismissal — that decides whether the person's login is switched off as part of this same action.

Chapter two

What one action does#

Confirming the dialog calls a single database function, fn_separate_staff, which runs the whole exit as one atomic transaction. Six things happen together, or none of them do:

  • The contract closes. Its status becomes terminated, with the termination date, reason, separation type, notice period, effective date, and the authorising user all recorded.
  • The record is deactivated. The staff member is marked inactive and their employment status set to separated, with the separation date, type, and reason on file — so they drop off every active list (payroll runs, timetables, rosters) while the history stays honest.
  • Payroll stops. The current salary assignment is closed and dated, so no future run computes pay for them.
  • The login is switched off — if "revoke access" was ticked and the person has a linked user account, their account is deactivated so they can no longer sign in.
  • A separation checklist is spawned — from a matching template, or a built-in default if none exists.
  • A draft final settlement is opened for finance, in the contract's currency.

Chapter three

The separation checklist#

The checklist is worked from /dashboard/offboarding, which lists offboarding cards grouped into in-progress and completed. Each task carries one of six categories, so the exit reads as a coherent process:

  • Asset return — laptops, keys, ID cards, textbooks.
  • Access revocation — accounts, systems, building access.
  • Knowledge handover — the handover notes, the class handoff.
  • Final settlement — the finance side of the exit.
  • Exit interview — the conversation on the way out.
  • Compliance — the sign-offs that must be on file.

The built-in default checklist covers return assets, revoke system access, knowledge handover, final settlement, and the exit interview. Ticking a task stamps who did it and when; the checklist flips to completed once every required task is done. The workspace's headline tiles are exit-aware — beyond in-progress and completed counts, they surface how many exits still have access not yet revoked and how many have a settlement still pending, so nothing drifts.

Chapter four

The final settlement#

The settlement opens as a draft with its line items laid out, and a single Calculate runs the arithmetic nobody enjoys. The compute function derives four components and sums them to a net figure in the school's currency:

  • Pro-rated salary — the monthly wage scaled to the fraction of the final month actually worked, from the day of separation.
  • Leave encashment — the cash value of unused leave, from the person's remaining and carried-forward balance valued at the daily rate.
  • Severance — the monthly wage times a per-year-of-service rate your policy supplies, times years of service.
  • Notice pay — the monthly wage times a number of notice months your policy supplies.

The net amount is a computed column — pro-rata plus severance plus leave encashment plus notice pay, less deductions — so it can never drift from its parts. The severance rate and notice months are the two policy inputs a finance user with the payroll permission enters before calculating; the pro-rata and leave encashment come straight from the contract, the salary, and the leave balances.

Chapter five

Where the words are precise#

Two phrases in this module deserve exact reading.

"Access revoked" means the person's login account is deactivated so they cannot sign in — a real, immediate effect, not a checkbox. It does not, today, strip their individual role and permission grants; those rows remain until an admin clears them. Deactivating the login is what actually stops access, so the practical door is shut — but a thorough exit still removes the roles by hand. The "revoke system access" task on the checklist is a separate tick from that login deactivation, so ticking it does not itself revoke anything.

"Exit interview" is, today, a category on the checklist — a line you tick to say the conversation happened. There is no structured exit-interview form or captured feedback behind it yet. Record the substance elsewhere for now; the structured interview is planned.

Chapter six

What makes offboarding careful#

Five things done properly

  1. 1

    One atomic exit

    A single database function closes the contract, deactivates the record, stops payroll, deactivates the login, spawns the checklist, and opens the settlement — together, or not at all. No half-separated state is possible.

  2. 2

    Leavers kept, not deleted

    A separated staff member drops off every active list but stays on file with their reason, date, and type — so attrition analytics and re-hire decisions have honest history to read.

  3. 3

    A real login kill

    'Revoke access' deactivates the actual user account, not just a checklist line — the person cannot sign in the moment the separation is confirmed.

  4. 4

    The settlement computed

    Pro-rata, leave encashment, severance, and notice pay are derived from the contract, salary, and leave balances into a net that is a computed column — it cannot disagree with its parts.

  5. 5

    Due process on the record

    Separation type, notice period, effective date, and the authorising user are all stamped on the contract, so a dismissal or redundancy carries its own paper trail.

Planned & honest gaps

What is still to come#

The exit spine — the atomic separation, the login kill, the checklist, the settlement compute — is genuinely wired. The finishing work sits on the finance tail and a couple of the checklist categories.

Four honest gaps

  1. 1

    Settlement approval & payment

    The settlement computes but stops at draft — there is no screen yet to approve it, mark it paid, or enter manual deductions, though the data model holds all three. Wiring the approve-and-pay flow is the headline planned work.

  2. 2

    Role stripping

    Access revocation deactivates the login but does not yet remove the departing person's role and permission grants. Auto-clearing those on separation is planned, so 'access revoked' becomes total.

  3. 3

    A real exit interview

    Today the exit interview is a checklist line with no form behind it — no structured questions, no captured feedback. A proper exit-interview capture is planned.

  4. 4

    Offboarding template management

    Separation uses a built-in default checklist unless a template was seeded directly; there is no screen yet to create or edit offboarding templates the way onboarding templates are built. A management UI is planned.

Adjacent modules

Where offboarding connects#

Tutorial

Do it step by step#

Run one departure end to end, from the Terminate button to the settlement finance pays. Four steps, in the order an exit actually happens.

  1. 1

    Initiate from the contract

    On /dashboard/contracts, find the leaver's active contract and choose Terminate. Set the separation type, effective date, an optional notice period, and the reason, and decide whether to revoke the login now (on by default).

    For a dismissal, leave 'revoke access' ticked — the login is switched off the moment you confirm.

  2. 2

    Let one action do the rest

    Confirming runs the whole exit atomically: the contract closes, the record is marked separated, payroll stops, the login is deactivated, a separation checklist is spawned, and a draft final settlement is opened.
  3. 3

    Work the checklist

    Open /dashboard/offboarding and tick each task — return assets, revoke access, knowledge handover, exit interview. The card completes once the required tasks are done; the tiles flag any exit with access still not revoked or a settlement still pending.

    Deactivating the login shuts the door, but clearing the departing person's roles is still a manual step in the users and roles area — do it as part of the access-revocation task.

  4. 4

    Compute the final settlement

    In the offboarding card, enter your severance-per-year and notice-months policy inputs and click Calculate — pro-rata, leave encashment, severance, and notice pay resolve to a net figure in your currency. Finance approves and pays it outside this screen for now.

One action, a clean exit — contract closed, pay stopped, login off, and a settlement ready for finance. Nothing left open behind a departing name.