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

# Grading

> Set up a weighted grade scheme, let attendance, assignments, and quizzes combine into a live grade for every student, view the class gradebook, and export attendance and gradebook reports.

Grading in E-Classroom is continuous. Instead of adding up marks at the end of term, the system keeps a live grade for every student that updates the moment attendance, an assignment, or a quiz result changes. How those inputs combine is decided by the classroom's weighted grade scheme.

***

## Who Uses This Feature

| Role                        | What They Do                                                                    |
| --------------------------- | ------------------------------------------------------------------------------- |
| **Teacher**                 | Sets or chooses the grade scheme, grades work, and reviews the class gradebook. |
| **Classroom Administrator** | Maintains grade schemes and monitors grading across classes.                    |
| **Student**                 | Sees their own live grade and its breakdown.                                    |

***

## Before You Start

You need an **Active classroom** with a grade scheme selected. The scheme should be in place before the class starts collecting attendance and grades, so results are weighted correctly from the beginning.

***

## The Grade Scheme

A grade scheme decides how the different inputs are weighted and how a final percentage maps to a grade band (for example, a letter grade or pass mark). Schemes are reusable reference data: you can reuse one scheme across many classrooms.

### Field Guide - Grade Scheme

| Field                | Description / Purpose                                                                            |
| -------------------- | ------------------------------------------------------------------------------------------------ |
| **Scheme name**      | The unique name of the scheme. Required.                                                         |
| **Grade components** | The weighted inputs (for example, attendance, assignments, quizzes) and the weight each carries. |
| **Grade bands**      | The score ranges that map a percentage to a grade (for example, 90 and above maps to A).         |

Grade components are configured per classroom, so the same scheme can be tuned to a specific class. You add, weight, and remove components on the classroom's grading setup.

***

## How the Live Grade Works

Each student has a single grade snapshot per classroom. It is recomputed automatically whenever:

* attendance is marked or changed,
* an assignment submission is graded, or
* a quiz attempt is graded.

A nightly pass also recomputes every snapshot, so grades stay correct even after bulk changes.

```mermaid theme={null}
%%{init: {'theme':'base','themeVariables':{'primaryColor':'#14f1b1','primaryBorderColor':'#14f1b1','lineColor':'#14f1b1'}}}%%
flowchart LR
    AT[Attendance] --> G[Grade snapshot]
    ASG[Assignments] --> G
    QZ[Quizzes] --> G
    GS[Grade scheme weighting] --> G
    G --> GB[Gradebook]
```

You never trigger the calculation by hand for normal grading. If you ever need to, a teacher can recompute a single student or the whole class from the grading tools.

***

## The Gradebook

The gradebook is the teacher's view of the whole class's standing.

<Steps>
  <Step title="Open the grades page">
    Go to `/classroom/{code}/grades`. A student sees their own grade and breakdown; a teacher sees every student.
  </Step>

  <Step title="Review standings">
    See each student's current grade and how the components contributed.
  </Step>

  <Step title="Drill into a student">
    Open a student to see the history behind their grade.
  </Step>
</Steps>

***

## Exporting Reports

You can export two reports for offline use or record-keeping:

| Export                | What it contains                                                           |
| --------------------- | -------------------------------------------------------------------------- |
| **Attendance export** | The attendance register for the class over a date range, as a spreadsheet. |
| **Gradebook export**  | The class gradebook, as a spreadsheet.                                     |

Both are available from the grades and attendance surfaces and download as spreadsheet files.

***

## Upstream and Downstream

* **Upstream (must exist first)**: a grade scheme; attendance, assignments, and quizzes to grade.
* **Downstream (this enables)**: the gradebook and the attendance and gradebook exports.

***

## Best Practices

* Choose the grade scheme before the class goes Active so early grades are weighted correctly.
* Tune the grade components on the classroom to match how you actually assess this class.
* Trust the live grade: it recomputes automatically, so there is no end-of-term totalling to do.
* Export the gradebook and attendance at milestones (mid-term, end of term) for your records before archiving the class.