HandbookAdmissions & lifecycle01

CRM & lead pipeline.

Every student begins as an enquiry — a phone call, a walk-in, a referral from a sibling's family, a form filled in on the school's website at midnight. The admissions CRM is the funnel before the funnel: one pipeline that holds each prospective family from first contact until the day the application becomes a student record. This handbook walks the pipeline end to end, names every stage by its real value, and is honest about which classic-CRM features are shipped today and which are on the roadmap.

  • 4capture sources
  • 9funnel stages
  • EN·FR·ARevery screen
  • ≈10 minto read

Prologue

The funnel before the funnel#

By the time a child appears in the student records module they are already enrolled — the decision is made, the student number issued, the family linked. The admissions CRM is everything that happens before that moment: the conversation, the application form, the documents chased, the entry exam sat, the interview held, the offer extended, the seat accepted.

In YESS that whole journey lives in one place — /dashboard/admissions — as a pipeline of admission_applications, each one sitting at exactly one stage. Move an application forward and the family advances through the funnel; a KPI strip at the top of the page always shows the live shape of the pipeline — total, active, conversion rate, rejected — regardless of how the table beneath it is filtered, and a second clickable strip breaks the pipeline down stage-by-stage so a tile becomes a filter.

Chapter one

One application, nine stages#

An admission application carries the applicant's details, the parent or guardian who enquired, the programme, class and campus applied to, a target academic year, a source, an auto-numbered application_number, and a current stage. The stage is the heart of the record — it is what the funnel chart counts and what the pipeline board sorts by. The path runs through seven stages in order:

The admissions funnel

First contact

  1. inquiry — the first touch. A family has reached out; nothing is committed yet.
    • Captured by a walk-in officer, an online form, an offline mobile sync, or a bulk import
  2. applied — a formal application form has been submitted.
  3. documents_pending — the application is in, but a birth certificate, report cards, or a photo are still owed.
  4. under_review — the admissions committee is assessing the file.
  5. interview — the family (and often the child) is met in person and scored against the interview record.
  6. decision — the committee has reached a verdict and is ready to extend an offer.
  7. enrolled — the offer was accepted and the applicant has been converted into a student.
    • A students row is created, the family is linked, an active enrolment is opened

On the roster

Two more values sit off the main path as honest off-ramps: rejected (the file did not pass) and waitlisted (a yes, but no seat yet) — so the current_stage column holds nine values in all. The two consequential moves are guarded: a move to rejected opens a confirmation that requires a written reason, and a move to enrolled never flips from a dropdown at all — it routes the registrar to the applicant's file to run the explicit Convert to Student action. Every other stage change flips immediately, and each one writes an audit row to application_stages.

The board can be filtered by stage and by source — a row of bulk checkboxes lets you advance several files at once (the bulk dialog still blocks enrolled and still asks for a rejection reason). The source filter is the first, simplest version of the marketing attribution the roadmap will deepen: it sorts the pipeline into self-applied families and ones an officer captured internally.

The pipeline board: a live KPI strip up top, a clickable stage funnel, and the application table filtered by stage or source.

Chapter two

Four ways in — capturing the enquiry#

The source on every application is one of four values, and each is a real door into the pipeline: walk_in, online_self, batch_offline_synced, and imported.

The first door is the walk-in wizard at /dashboard/admissions/walk-in — a single-screen capture flow for the front-office officer when a parent walks through the gate. It discloses three sections in turn: a sibling lookup, the applicant and parent identity, then the placement (programme, class, and campus). Submitting creates one application stamped source = walk_in and drops it into the normal stage flow — the wizard never short-circuits review, interview, or offer.

The sibling lookup is the quiet win. Type a family name and matching active students surface (a live search across student first and last names); “adopt sibling” copies that student's surname and campus into the draft, so the officer attaches to a family the school already banks, bills, and messages instead of duplicating it.

The second door is online self-submission: a family who has never had a YESS account fills in the public application form at /sites/[school]/apply — also embeddable in the school's own website — and lands directly in the pipeline, stamped online_self, self-submitted, at the applied stage. The remaining two doors are operational: a mobile officer capturing enquiries with no signal, whose drafts upload later as batch_offline_synced, and a bulk imported intake. The general New Application dialog on the pipeline page is how an officer types an enquiry that arrived by phone or email — it has no separate source field, so it records under the default source.

Chapter three

Entry exams and the decision#

Many schools assess before they admit. Entry exams live at /dashboard/admissions/entry-exams — a permission area of its own. You define an exam for a programme and intake year (with a pass threshold, a capacity, fee details, paper and/or online modes, and blind grading on by default), publish it, then register candidates — each optionally linked back to an application. Scores are recorded against the candidate, and the roster carries Admit / Waitlist / Reject outcome controls, so the committee weighs a number and a rank, not a hunch.

An individual applicant's full file opens at /dashboard/admissions/[id] — not a row of tabs but a set of rooms: Overview (applicant, parent, academic and registration-fee detail), Documents, Interviews, Offers, Entry exams (when a candidacy exists), Notes, Outbound messages, and a History timeline of every stage change. A stage pipeline and a “time in stage” chip sit across the top.

When the committee reaches a verdict, the application moves to decision, and the school extends an offer from the Offers room — full, conditional, or waitlist. From there the family resolves to one of three outcomes: enrolled, rejected, or waitlisted. Because a rejection ends the family's lifecycle, YESS gates it behind a confirmation that asks for a reason — so the audit trail explains not just what changed but why.

Chapter four

The waitlist, and the conversion#

A strong applicant with no seat is not a no — it is a waitlist. Waitlisting is a stage plus an ordered waitlist_position: the Waitlist tab on the pipeline page holds these families in priority order, and the registrar reorders them — up, down, to the top, to the bottom — so that when a place opens the next candidate is already chosen, without re-reading the whole pipeline.

The funnel ends where the student journey begins. From the applicant's file, Convert to Student runs a single server-side transaction (convert_applicant_to_student): it creates the students row — its student number derived from the application number, with an admission_application_id back-reference to the file it came from — links the parent, opens an active enrolment, and stamps the application enrolled. If the school charges a registration fee and it is unpaid, the conversion is blocked until it is settled. Downstream of the conversion the student picks up a programme matricule and the first invoice follows from the assigned fee structure — no re-keying of anything the family already gave you.

The Analytics tab turns the pipeline into intelligence: an application funnel, a monthly-trend line, and a stage-distribution chart, over headline cards for total, enrolled, rejected, and conversion rate. It is the single most useful screen at the start of an intake season — and the clearest read on where families drop off between one stage and the next.

Planned features

What a fuller CRM adds next#

The features below are the classic-CRM layer that sits on top of a pipeline. They are planned, not shipped — listed here so you can plan around them honestly. The Notes and Outbound rooms on each applicant's file are the shipped building blocks the communication features will grow from.

Four features on the roadmap

  1. 1

    Lead scoring

    Today every application is equal in the queue. The planned scoring engine ranks prospects by fit and intent — programme match, a sibling already enrolled, completeness of documents, entry-exam result — so the committee works the hottest leads first.

  2. 2

    Drip campaigns

    Automated, staged follow-up that nurtures an enquiry which has gone quiet, in the family's own language, on a channel they already use. Today follow-up is a manual Note plus an Outbound email queued from the applicant's file.

  3. 3

    Marketing-source ROI

    Source capture exists at the simplest level — walk-in, online self, offline sync, import. The planned version tracks the full acquisition channel (referral, ad, open day, agent) and reports cost-per-enrolment, so a head spends the marketing budget on what actually converts.

  4. 4

    Communication timeline

    A single per-application thread that braids every inbound and outbound message into one conversation. Today the file keeps internal Notes and a queue of Outbound emails separately, rather than one unified thread.

Adjacent modules

Where admissions connects#

Tutorial

Do it step by step#

Move one family from a knock on the gate to a seat on the roster. Six steps, in the order the front office actually works an intake season.

  1. 1

    Capture the enquiry

    When a parent walks in, open the wizard at /dashboard/admissions/walk-in. Type the family name first — if a sibling is already enrolled, adopt them so the new applicant carries the same family and campus — then add the applicant, parent, and the placement.

    Enquiries that arrive online land in the pipeline on their own, marked online_self. Phone and email enquiries go in via the New Application dialog on the pipeline page.

  2. 2

    Work the pipeline

    Open /dashboard/admissions and advance each application along the funnel — inquiry, applied, documents pending, under review, interview, decision. Filter by stage or by source, and use the row checkboxes to move several files at once.
  3. 3

    Assess with an entry exam

    Define a sitting at /dashboard/admissions/entry-exams — a pass threshold, a capacity, blind grading — register the candidates, record their scores, and admit, waitlist, or reject from the roster, so the committee decides on a number, not an impression.
  4. 4

    Record the decision

    Open the applicant's file at /dashboard/admissions/[id], extend an offer from the Offers room, and move it to a verdict. A rejection asks for a reason; an enrolment runs the explicit Convert to Student action — so an irreversible move is always deliberate and always explained in the History timeline.

    Not a no, but no seat? Mark the family waitlisted and reorder them on the Waitlist tab the moment a place opens.

  5. 5

    Convert to an enrolment

    Convert to Student runs one transaction: the applicant becomes a student record (its number derived from the application number), the parent is linked, an active enrolment is opened, and the application is stamped enrolled. A matricule and the first invoice follow downstream — no re-keying.

    If the school charges a registration fee and it is unpaid, conversion is blocked until the fee is settled.

  6. 6

    Read the funnel

    At the start and end of an intake, open the Analytics tab on /dashboard/admissions for the funnel, the monthly trend, and the stage distribution — the screens that tell you whether the season is on track and where families are dropping off.

One enquiry, carried the whole way from a phone call to a seat — and handed cleanly to the rest of the school.