> ## Documentation Index
> Fetch the complete documentation index at: https://educontroldoc.pixelspectivetech.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Report cards

> From draft to Ready to Published — the remarks a person writes, the quality gate, and what freezing a report card means.

A terminal report card passes through three states, and two different people.

```mermaid theme={null}
flowchart LR
    A[Draft<br/>marks and remarks<br/>being entered] --> B[Ready<br/>form master says<br/>the class is complete]
    B --> C[Published<br/>head teacher signs off<br/>snapshot frozen]
```

## What is computed, and what is written

Totals, grades, class positions and attendance figures are **computed** — nobody types them. While a report is a draft they are worked out fresh each time you look, so they always agree with the marks currently entered.

What people write is the human part:

* **Conduct**, **interest** and **attitude**
* The **class teacher's remark**
* The **head teacher's remark**

## Ready: the form master's check

The form master reviews their class and marks it **Ready**. This is a quality gate, not a formality — it is the assertion that every subject has its marks in and the remarks are written.

The gradebook shows which pupils are still missing marks, which is what makes the check possible rather than a guess.

## Published: the head teacher's sign-off

The head teacher reviews the class — including its performance distribution — and publishes.

<Warning>
  Publishing **freezes** the report card. A snapshot is written containing the final marks, totals, grades, class position, attendance summary and every remark, exactly as they stood at that moment. From then on the pupil's report card is that snapshot.

  Later changes to marks, grading scales or attendance do not alter a published report card. That is the point of it: the document a parent was handed at Open Day never quietly becomes a different document.
</Warning>

If something genuinely has to change after publication, the report is withdrawn, corrected and republished — a deliberate act that is recorded, rather than a silent edit.

## Class positions

Positions are computed across the class with ties handled explicitly: two pupils on the same aggregate share a position.

Positions are frozen into the snapshot with everything else, so a pupil admitted after publication does not retrospectively move somebody down a place.

## Printing

A whole class prints as one document, laid out for A4 with page breaks between pupils, and carrying your school's crest and details from the [school profile](/docs/before-the-term/school-profile).

Printing is done from the browser's own print dialogue — there is no separate PDF export to wait for. Print to paper for Open Day, or to PDF if your browser offers it.

<Tip>
  Print one card and check it before sending forty through. Margins and the crest are the two things worth a look.
</Tip>

Report card settings control what appears — subject remarks, for instance, can be shown or hidden.

## Who can do this

| Action                                 | Permission        |
| -------------------------------------- | ----------------- |
| Enter marks, write remarks, mark Ready | `enter_marks`     |
| Publish and withdraw                   | `publish_reports` |
| View reports                           | `view_reports`    |