Report cards & transcripts.

A report card carries more weight than its single page suggests. It is the parent's clearest window onto whether a year's fees bought a year's progress; it is the artefact a family keeps in a drawer for a decade; in many systems it is a legal record. A report card that is late, that does not balance against the marks, or that arrives in a language the family does not read, undoes a term of good teaching in one bad afternoon.

YESS treats the report card as the natural end of the academic pipeline rather than a separate piece of paperwork. The marks are already in the gradebook; attendance is already counted; conduct is already recorded. The report-card module's job is to gather all of that into one compiled record per student, dress it in the school's chosen layout, add the human comments, and publish it — once, consistently, in three languages.

Everything the school already knows about a student, on one page they will keep.

The module lives at /dashboard/report-cards and opens on two tabs: Report Cards — the list of cards for a chosen term, class and section, with their status and your generate / publish / download actions — and Templates — the layouts the cards are rendered into. A small stats strip across the top counts the students in the section, the drafts, the generated cards, and the published ones, so you always know where the batch stands.

A report card moves through three states. It starts as a draft slot for each student; generating populates it with the compiled marks; publishing opens it to the parent. The list shows the student, their class and section, a colour-coded conduct rating, a pair of badges marking whether the teacher and principal comments are in, the status, and the date it was generated.

Click Generate Report Cards and YESS compiles a card for every student in the section. Compilation gathers, per student, the compiled term result (overall average, GPA, class rank, promotion status), the individual subject scores behind it, any LMS gradebook contribution, the attendance summary, and the conduct rating — and writes them all into the card's stored data. You can optionally pin a specific template to the batch at generation time.

YESS knows the difference between a K-12 track and a university one and compiles each correctly. A secondary student's card carries subject rows with CA and exam columns, an average percentage, a rank and a promotion status. A university student's card carries courses with credits, a term GPA, and a cumulative GPA. The same generate button produces the right shape for each student in a mixed section, because the compiler reads the programme's level.

A column of marks does not tell a parent that their child has found their voice in class discussion, or that a strong term hides a struggle with deadlines. That is what the comments are for. From a card's Edit Comments action you set the class-teacher comment, the principal comment, and the conduct rating — chosen from excellent, very good, good, satisfactory, needs improvement, or poor.

The two comment badges on the list make it obvious at a glance which cards are still waiting on a teacher or a head before the batch can go out. A card can be published with the marks alone, but the comment is the part parents quote back to you at parents' evening — it is worth the few minutes per child.

No two education systems print a report card the same way. A Cameroonian form wants CA1, CA2, exam and total columns under a ministry header; a GCE A-Level card wants per-paper marks; an IB card wants a seven-point scale; a French baccalauréat card wants coefficients and a mention; a university wants per-paper marks with a GPA. The Templates tab carries six ready-made presets covering exactly these — Primary, Cameroon Form, GCE A-Level, International Baccalaureate, Baccalauréat français, and Executive / University — plus a blank canvas. If the school has no templates yet, one click on Seed Defaults drops the full set in.

Each template binds to a programme, a class, or a level band, with a priority so the most specific match wins. It defines which fields appear (the school header and emblem, the student's details, the grade table's columns, conduct and attendance, the comments, the signature lines), the page orientation and paper size, the primary colour and font. Each template also carries a kind — a term report card, a single-term, cumulative or full-programme transcript, a mid-term progress report, or a diploma cover sheet — so the same studio lays out every formal document the school issues, not just the report card. Templates can be duplicated, quick-edited for their binding, previewed, or opened in the studio for a full redesign.

For full control, open a template in the studio at /dashboard/report-cards/studio/[id]. It is a true drag-and-drop designer: a toolbox of sections and primitives on the left, an A4-sized canvas in the centre, and a properties panel on the right. You place elements — a text block that can interpolate live data like the student's name or the term average, an image (the school logo or a ministry seal), the grades table, signature blocks, dividers, shapes, and composite section blocks such as a ministry header, a student-info block, a summary-stats block, attendance and conduct, comments, a grading key, and a footer.

Branding is one click: Import school brand injects the school's primary colour into the design, and a palette popover offers the YESS pillar colours or any custom hex. Signature blocks are layout elements — a labelled line, optionally with a date field and a stamp — rendered onto the PDF for the principal and parent to sign by hand after printing. The palette popover offers five YESS pillar colours — Greenwood, Royal Plum, Heritage Gold, Ink Navy and Silver Mist — or any custom hex. When the design is ready, a preview shows you the page as laid out, and Download renders the final PDF the parent receives.

When the marks are compiled and the comments are in, publish. You can publish a single card from its row, or hit Publish All to release the whole generated batch at once. Publishing stamps the card as published, records the moment, and fans out a notification — composed in the recipient's own language, English, French or Arabic — to the student (in-app and push) and to every linked parent (in-app, push and email), pointing them straight at their report. The family learns the report card is ready the same hour you publish it, not a week later when someone remembers to send an email.

To hand out the printed copies, Download All bundles the batch — individual PDFs for a small section, or a single ZIP archive for a large one. Every PDF is generated from the bound template, so the printout and the parent's on-screen copy are the same document.

A parent opens /portal/report-cards and sees a card per published report — with a child picker if they have more than one at the school. Each card shows the term and year, the published date, the headline numbers (average, GPA, rank and promotion status for a K-12 student; year, term GPA, cumulative GPA and credits for a university student), and the first line of the class-teacher's comment, with a Download PDF button.

The PDF is rendered in the parent's preferred language — English, French, or Arabic with full right-to-left layout — not the language the school happens to work in. Longer-form academic history lives one tab over at /portal/transcripts. A transcript is not recompiled on the fly: a registrar issues one from the student record (the admin path is /dashboard/students/[id]/transcripts), which captures an immutable snapshot of the student's whole history — GPA progression, credits earned, every term — signs it with a tamper-evident HMAC signature, and stamps it with a verification token. The portal lists each issued transcript (alongside any diplomas and honour-roll certificates) with a PDF download and a Verify link, so a university can confirm the document is genuine from its QR code. An issued transcript can never be silently edited — it can only be revoked, on the record, by a privileged action.