Skip to content
GPAE A solution by FTGroup Request a demo

User guide

Management

Back to support

Principal guide — GPAE

For the principal (or head teacher) of the school. The principal has every right on their school in the web back office (the school's address followed by /admin): steering, organisation, marks, finance, documents, admissions.

New school: the FTGroup invitation, account activation and the Settings › Setup wizard are described in school-setup.md.

1. Signing in

  1. Open the school's address followed by /admin. Enter "Email address" and "Password", then "Sign in".
  2. Two-step verification (required for this role):
    • the first time, add GPAE to an authenticator app (Google Authenticator, Microsoft Authenticator…) with the QR code or key shown, then type the 6-digit code;
    • write down the backup codes and keep them away from the phone: each one works once if the phone is lost;
    • after that, type the current 6-digit code at each sign-in.
  3. If you run several schools, choose the school at the top of the screen ("Change school").

2. Day to day

Dashboard

Enrolment figures (by cycle and by class), today's attendance and absences, averages by class, payments received today and this month, collection rate, total outstanding and the curve of the last 30 days.

Menu Dashboard (Management, Finance, Academics and Admissions entries, under the home page):

  • Management dashboard: headcount (by cycle), attendance this week, repeated absences, fee collection, marks awaiting validation;
  • Finance dashboard: received today by method, outstanding fees by class, pending Mobile Money payments, reconciliation discrepancies.

Each indicator shows its definition and its calculation time ("Computed at …"). Values are kept for 15 minutes; "Recompute" refreshes them at once. Dashboards export as Official PDF, Word or Excel.

Marks and results (Assessments)

  • Assessments: follow the statuses (draft, entry completed, validated, published).
  • Validate: after validation, a mark only changes through a justified correction; the old value stays in the history.
  • Publish: marks become visible to parents and students. An unpublished mark stays invisible to them.
  • Class results: averages and ranks.
  • Report cards: choose a class and a term, then follow the steps:
    1. "Calculate": from published marks only;
    2. "Validate": report cards are frozen with the rule set version;
    3. "Publish": visible to parents in the app, official PDFs issued in the background, parents notified. "ZIP batch" prepares the archive of the class's PDFs (temporary download link). "Correct" an issued report card, with a reason, to create a new version to validate then publish; the old one becomes "Replaced" and its PDF is cancelled. Nursery: "Progress report" without average or rank; English-speaking class: report card in English. Until the pilot's calculation rules are settled (MVP-027), report cards carry the mention "Provisional calculation rules".
  • Class council: "Open the council" (proposals computed from published marks), decisions and distinctions (a reason is required for repeating, exclusion, conditional promotion or a decision that differs from the proposal), then "Close the council": the minutes are authoritative and can no longer be changed.
  • Rule sets, Rating scales, Skills: calculation rules and qualitative assessment (nursery).

Homework and announcements

  • Teaching › Homework and class log: all the homework of the school, drafts included; publish, schedule or archive on behalf of a teacher. The "Class log" filter shows a class day by day.
  • Communication and marketing › Announcements: same screen as the secretariat (scope, audiences, pinning, expiry, SMS, read receipts).

Settings (gear)

Configuration is gathered in the Settings space: gear in the top bar, "All settings" entry at the bottom of the menu, or account menu. One tile per screen, sorted by section (School, School year and classes, Assessments and report cards, Finance, Accounts and security, Data…); each settings screen has a "Settings" link back to the tiles.

  • Academic years: years and periods. Lock a period to forbid any change to marks or attendance in it.
  • Levels, Streams, Classes (with assigned teachers), Subjects and curriculum (coefficients, numeric or qualitative mode), Rooms.
  • Devices: "Allow offline" for a teacher's phone (roll call without network) or a cashier's phone (mobile cash desk); "Revoke device" if it is lost or stolen (it is signed out and its local data is erased).
  • Operating settings: group or school settings (the school setting takes precedence), for example the "Place of signature" of certificates.
  • Visual identity: short name, main and secondary colours, logo (SVG or PNG, 1 MB at most), light and dark preview, contrast checks. A "Draft" version changes nothing; once "Published", the back office (when the page is reloaded) and the app use the new colours.
  • Mobile app: school code (short, unique on GPAE, for example CSB-DOUALA), city and "Listed in the directory" (the school can then be found by search, code and QR code; otherwise only its parents find it by their phone). The invitation QR code (Export: official PDF, Word, Excel) is displayed or handed out to parents: it opens the app on the school.

Accounts and roles

Settings › Accounts and roles: the school's staff accounts and their roles.

  • New account: surname, given names, phone (Cameroonian number, e.g. 6 77 12 34 56), optional email, language. The sign-in identifier is the email if entered, otherwise the phone. A known number (a parent's, for example) links the existing person.
  • First sign-in: "Send an invitation by text message" (default): the person receives a link, valid for 72 hours and usable once, to choose a password (at least 12 characters). Alternatively, "Set an initial password" and hand it over in person. If the link is lost or has expired, use "Resend the invitation".
  • Assign a role (account page, "Roles" section): role, school, start date and, if needed, end date.
    • Teacher: choose their classes; their assignments (Classes › the class › Teachers) complete them.
    • Parent: choose their children (search by name or student number) and the relationship (father, mother, guardian); the link is approved at once.
    • Principal, accountant or group administrator: these roles require two-step verification. The account's open sessions are closed and the person signs in again with their code.
  • Remove a role: it ends today; the history and the audit log keep it.
  • Suspend an account: it can no longer sign in, and its back office and app sessions are closed. "Reactivate" restores it. An account is never deleted.
  • You can change neither your own account nor an account of another school. The "Platform support" and "Student" roles are not assigned here.
  • The list can be filtered by role and status, and exported as PDF, Word or Excel.

Documents

  • Every list can be exported as Official PDF (numbered, verification QR code), Word or Excel ("Editable copy — not authenticated").
  • Documents › Issued documents: register, "Duplicate", and Cancel the document (final: the document stays in the register and the verification page shows it as "Cancelled").
  • Anyone can check an official PDF by scanning its QR code.

Admissions (Students and enrolment › Admissions pipeline)

  • Pipeline and Prospects: interested families, activities, stages; the same phone number flags a duplicate, with a merge proposal. A "lost" prospect requires a reason.
  • Campaigns: short link and QR code for a poster.
  • Applications: online pre-registrations; decisions "Missing documents", "Admitted", "Waiting list", "Declined". The parent is told by SMS and follows the application online. An "Admitted" application is enrolled with Enrol: choose the class; GPAE creates in one go the student and registration number, the enrolment (original campaign kept), the parent account and the instalments. If one step fails, nothing is created.

Finance (control)

The cash desk is described in the cashier guide. The principal provides the second check:

  • Finance › Cash desk: "Approve the closure" of a cashier, after checking the counted cash and the explained difference. Nobody approves their own closure.
  • Finance › Student accounts › Refunds: "Approve" or "Reject" a request made by another account.
  • Finance › Reconciliations: discrepancies between GPAE and the Mobile Money provider (Tranzak), to be handled by an owner.
  • Finance › Cash desk › Offline payments: mobile cash desk payments set aside, to accept or cancel.
  • Settings › Finance › Fee schedules: publish each level's schedule before enrolments; a schedule "To be replaced" is a placeholder.
  • Finance › Outstanding fees and Cash book: follow-up, exports in three formats.

Data migration (go-live)

Settings › Data › Data migration (principal and accountant), once per school:

  1. "Start a migration" for the academic year.
  2. "Import students" (see the secretariat guide), then download the "Balances template": one opening balance per registration number, in FCFA (negative for an advance).
  3. "Dry run of balances": checks the file without saving anything. Correct the flagged rows, then "Import balances".
  4. "Signed totals": headcounts per class and total of balances closed in the old system, with the names of the principal and the accountant and the signing date.
  5. "Reconcile totals": Matching if the imported totals equal the signed totals, otherwise Discrepancies to fix. The reconciliation "Report" can be exported for signature.
  6. "Post balances to the ledger" (only after a compliant reconciliation): each balance becomes an opening entry, which can no longer be changed.

Licence

Settings › School › Licence and usage: licence status and expiry, active modules, active students against the cap, SMS used (this month and since the licence started) and file storage.

  • Before expiry: alerts at D-30, D-15 and D-7 (notification and email to the management), and a banner in the back office. None if the renewal is already signed.
  • After expiry: 30 days of grace where everything remains possible. If a period is being closed (marks, councils, report cards), read-only waits until it is locked.
  • Read-only: viewing, export and fee collection (cash desk, families' mobile payment); everything else waits for the renewal, without data loss.
  • Student cap: above the number covered by the licence (with a small margin), a new enrolment is refused with a message; nothing is saved. Ask FTGroup to extend the licence.

3. Coming soon

Nothing announced for now: this section will be completed with the next versions.

4. Common problems

You see What to do
"… is locked: no mark or attendance can be changed in it." Unlock the period (Academic years) if the correction is justified, then lock it again.
"A reason is required for this decision." Enter the reason in the class council.
"End of year: every student needs a decision before closing." Complete the missing decisions before closing.
"Dual control: another account must approve." The closure or refund comes from you: another authorised account must approve it.
Verification code refused Check that the phone's time is set automatically; otherwise use a backup code.
A teacher does not see their class Assign them in Classes › the class › Teachers.
A phone is lost Settings › Devices › "Revoke device".
"An account already exists with the identifier …" The person already has an account: look for it in Accounts and roles. If they work in another school of the group, contact that school.
"This role is already assigned to this account over this period." First remove the current role, or choose a start date after its end.
The invitation link shows "Invalid link" Accounts and roles › the account › "Resend the invitation".
A menu is missing The module may not be in the licence, or you are not on the right school.

Pilot acceptance (in French): test book and acceptance report.