# 2. Grade Organization

User Type: **Super Administrator**
Source: *Mi Digital Academy - Education CRM Features Document*

---

## 2. Grade Organization

### 2.1 Organize Grades (Grade R to Grade 12+)
**What it does:** Defines the grade levels the platform supports — from early grades (Grade R) through Grade 12 and beyond — as the second level of the curriculum hierarchy under each board. The Super Administrator creates and orders the grades, sets their attributes, and maintains the grade set per board, so learners are placed at the right level and grade-appropriate material is organized and surfaced.

**Sub-features:**
- Create grades: name/label, order/sequence, and the board they belong to
- Grade range coverage: early grades (Grade R) through Grade 12+ (and beyond where offered)
- Grade ordering: the sequence is maintained so progression is well-defined
- Grade attributes: the grade's level, age band, and description
- Per-board grade sets: a board's grades are its own set (not shared across boards)
- Grade status: active grades are usable; inactive grades are not offered for new placement
- Audit logging of grade create/edit

**Super Administrator User Journey:**
1. Mapping a board's curriculum, Super Admin creates the board's grades in sequence: Grade R, Grade 1, through Grade 12 (and any beyond the board offers).
2. Sets each grade's attributes: the level, the age band, and a short description.
3. Confirms the ordering: the sequence is maintained, so progression from one grade to the next is well-defined.
4. Saves; the grades appear under the board and are available for subject mapping and learner placement.
5. For a learner, places them at the correct grade; the grade-appropriate material (subjects, content) is organized under that grade.
6. For a grade that is no longer offered (a program change), Super Admin sets it inactive: it is not offered for new placement, but existing placements and history remain.
7. Reviews the grade list per board: the full range with order, attributes, and status, so the grade set is complete and correct.
8. Each grade create and edit is audit-logged with the board, the grade, and the timestamp.

**Rules & Edge Cases:**
- Grades belong to a board: a board's grade set is its own; the same grade label under different boards are distinct.
- The grade ordering is maintained; progression follows the sequence, so "next grade" is unambiguous.
- The range covers Grade R through Grade 12+ (and beyond where the board offers it); gaps in the range are visible.
- An inactive grade is not offered for new placement but preserves existing placements and history.
- Grade attributes (level, age band) support age-appropriate handling (see 2.2).
- Grade create and edit are audit-logged with the board, grade, and timestamp.

### 2.2 Age-Appropriate Content Tagging
**What it does:** Tags content with age-appropriateness so that material is matched to the learner's grade/age band: content is marked for the grades/ages it suits, and the platform surfaces age-appropriate material to each learner. The Super Administrator manages the age-appropriateness tagging so younger learners are not shown unsuitable material and each grade sees content at its level.

**Sub-features:**
- Age/grade-appropriateness tag on content (the grades/ages the content suits)
- Tagging at content creation/edit (the creator marks the appropriate grades)
- Surfacing rule: a learner sees content tagged for their grade/age band
- Review of age-appropriateness (a check that tags are correct)
- Restriction: content not tagged for a learner's grade is not surfaced to them
- Bulk tagging for a set of content (a batch marked for a grade range)
- Audit logging of age-appropriateness tag changes

**Super Administrator User Journey:**
1. A set of new content is added. Super Admin reviews the age-appropriateness tags: each item is marked for the grades it suits (e.g., a topic explained simply for Grades 4–6, a deeper treatment for Grades 7–9).
2. For a batch of content produced for a specific grade range, Super Admin applies the bulk tag (the grade range) to the set.
3. Checks the surfacing rule: a Grade 5 learner sees the content tagged for their band; the Grade 7–9 treatment is not surfaced to them.
4. Reviews a sample for correctness: an item tagged for early grades is genuinely age-appropriate (language, complexity); a mis-tag is corrected.
5. For content that is appropriate across a wide range, tags the full range so it is surfaced to all suitable grades.
6. For content that is not suitable for younger grades, confirms it is tagged only for the older grades, so it is restricted from the younger bands.
7. Reviews the tagging coverage: content without an age-appropriateness tag is flagged for tagging (untagged content is not surfaced broadly).
8. The tag changes are audit-logged with the content, the grades tagged, and the timestamp.

**Rules & Edge Cases:**
- Content is surfaced to a learner only where it is tagged for their grade/age band; untagged content is not surfaced broadly.
- The tag is set at creation/edit and can be corrected; corrections are recorded.
- A wide-range tag makes content available across the suitable grades; a narrow tag restricts it.
- Age-appropriateness is a surfacing control, not a hard block on access where a learner is explicitly enrolled (enrollment can override surfacing per the course's rules).
- Bulk tagging applies a consistent tag to a set; per-item overrides are possible.
- Tag changes are audit-logged with the content, grades, and timestamp.

### 2.3 Grade-Specific Learning Objectives
**What it does:** Defines the learning objectives for each grade: what a learner is expected to achieve at that grade level, per subject where applicable. The Super Administrator maintains the grade-specific objectives so that the curriculum's intent is explicit, content and assessments can align to the objectives, and progress can be measured against them.

**Sub-features:**
- Learning objectives per grade (and per subject within the grade where defined)
- Objective authoring: clear, measurable statements of what the grade achieves
- Alignment: content and assessments can be linked to the objectives they serve
- Objective review: the set is reviewed for completeness and correctness per grade
- Progression: objectives build across grades (a grade's objectives extend the prior grade's)
- Visibility: the objectives are visible in the grade's context (for creators and, per policy, learners)
- Audit logging of objective changes

**Super Administrator User Journey:**
1. For a grade, Super Admin reviews the learning objectives: the set of measurable statements of what the grade achieves, per subject where defined.
2. Authors or updates an objective where the curriculum intent has changed, ensuring it is clear and measurable.
3. Checks alignment: the grade's content and assessments are linked to the objectives they serve, so coverage is visible (each objective has content/assessments; each item maps to an objective).
4. Reviews progression: the grade's objectives extend the prior grade's (a learner building on what they achieved), so the sequence is coherent.
5. For a gap (an objective with no aligned content or assessment), Super Admin routes it to the content/assessment owners to close.
6. Confirms the objectives' visibility: creators see them when authoring aligned material; learners see them per policy (the grade's goals).
7. Reviews the objective set per grade for completeness: all the grade's intended outcomes are captured, none missing.
8. The objective changes are audit-logged with the grade, the objectives, and the timestamp.

**Rules & Edge Cases:**
- Objectives are per grade (and per subject where defined); they are the curriculum's intent for that level.
- Objectives are measurable statements; vague objectives are corrected at review.
- Alignment is tracked: objectives link to the content/assessments that serve them, so coverage and gaps are visible.
- Progression is maintained: a grade's objectives extend the prior grade's, keeping the sequence coherent.
- An objective with no aligned material is a visible gap, routed for closure.
- Objective changes are audit-logged with the grade, objectives, and timestamp.