# 3. Subject Management

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

---

## 3. Subject Management

### 3.1 Add Multiple Subjects per Grade
**What it does:** Populates each grade with its subjects: the Super Administrator adds the subjects a grade offers (multiple per grade), with each subject's identity and attributes. Subjects are the level under a grade in the curriculum tree, and they anchor the subject-wise breakdown, content, and courses for that grade.

**Sub-features:**
- Add subjects to a grade (multiple per grade)
- Subject identity: name, code (where used), and description
- Subject attributes: the subject's type (core/elective where applicable) and notes
- Per-grade subject sets: a grade's subjects are its own set
- Subject list per grade with counts of mapped topics/content
- Subject status: active subjects are usable; inactive subjects are not offered for new mapping
- Audit logging of subject add/edit

**Super Administrator User Journey:**
1. For a grade, Super Admin adds its subjects: the core subjects the grade offers (e.g., Mathematics, Science, Language) and any electives.
2. Sets each subject's identity (name, code where used) and attributes (type, description).
3. Saves; the subjects appear under the grade and are available for topic organization and content/course mapping.
4. Reviews the subject list per grade: the full set with the counts of mapped topics and content, so coverage is visible.
5. For a subject no longer offered at the grade (a curriculum change), Super Admin sets it inactive: not offered for new mapping, but existing mappings and history remain.
6. For a new subject added to the grade, creates it and begins organizing its topics (see Topic & Chapter Organization).
7. Checks the per-grade subject sets: each grade has its correct subjects (a subject offered at one grade but not another is reflected).
8. Each subject add and edit is audit-logged with the grade, the subject, and the timestamp.

**Rules & Edge Cases:**
- Subjects belong to a grade (within a board's context); a grade's subject set is its own.
- Multiple subjects per grade are supported; the set is the grade's offered subjects.
- An inactive subject is not offered for new mapping but preserves existing mappings and history.
- The subject list shows mapped counts, so a subject with no topics/content is a visible gap.
- Subject identity (name/code) changes are recorded; mappings reference the subject, not its old name.
- Subject add and edit are audit-logged with the grade, subject, and timestamp.

### 3.2 Subject-Wise Curriculum Breakdown
**What it does:** Organizes each subject's curriculum into its structured breakdown: the topics and chapters that make up the subject for a grade, in the intended sequence. The Super Administrator maintains the subject-wise breakdown so the subject's content is organized, sequenced, and complete, and so learners and creators see the subject's structure clearly.

**Sub-features:**
- Subject breakdown: the chapters/topics that compose the subject for a grade
- Sequencing: the order of chapters/topics within the subject
- Completeness: the subject's full breakdown is present (no missing chapters)
- Breakdown view: the subject's structure with the mapped content per chapter/topic
- Alignment to the board's syllabus (where the subject is board-specific)
- Revision: updating the breakdown as the syllabus evolves
- Audit logging of breakdown changes

**Super Administrator User Journey:**
1. For a subject at a grade, Super Admin reviews the subject-wise breakdown: the chapters and topics that compose the subject, in sequence.
2. Confirms the sequencing: the order reflects the intended learning progression (foundations before advanced topics).
3. Checks completeness: the subject's full breakdown is present; a missing chapter is a visible gap.
4. Reviews the breakdown view: each chapter/topic shows the mapped content, so coverage per node is visible.
5. For a board-specific subject, confirms the breakdown aligns to the board's syllabus structure (the nodes mirror the syllabus).
6. For a syllabus revision, updates the breakdown (adds/reorders chapters) and re-maps the affected content; the change is recorded.
7. Routes a gap (a chapter with no content) to the content owners to close.
8. The breakdown changes are audit-logged with the subject, the grade, the nodes, and the timestamp.

**Rules & Edge Cases:**
- The breakdown is per subject per grade; it is the subject's structured content for that level.
- Sequencing is maintained; the order reflects the learning progression, so "next topic" is well-defined.
- Completeness is visible: a chapter/topic with no mapped content is a gap, not a silent omission.
- A board-specific subject's breakdown aligns to the board's syllabus; the nodes mirror it.
- A revision updates the breakdown and re-maps content, with the change recorded.
- Breakdown changes are audit-logged with the subject, grade, nodes, and timestamp.

### 3.3 Cross-Subject Linking for Integrated Learning
**What it does:** Links topics across subjects to support integrated learning: where a concept in one subject connects to a concept in another (e.g., a mathematics topic used in science), the Super Administrator creates the cross-subject links so learners can see the connection and integrated material can reference both. The links enrich the curriculum without merging the subjects.

**Sub-features:**
- Cross-subject link: a connection between a topic in one subject and a topic in another
- Link creation: the Super Admin links related topics across subjects
- Link direction and type: the nature of the connection (prerequisite, related, applied-in)
- Integrated views: a topic's cross-subject connections are visible from its page
- Integrated learning material: content that references the linked topics across subjects
- Link review: the set of cross-subject links is reviewed for correctness
- Audit logging of link create/remove

**Super Administrator User Journey:**
1. A mathematics topic (ratios) is foundational to a science topic (concentrations). Super Admin creates a cross-subject link between them, typed as "prerequisite".
2. From the science topic's page, the link is visible: "Related: Mathematics — Ratios (prerequisite)", so a learner sees the connection.
3. For integrated learning material (a project using both subjects), the content references the linked topics; the links support the reference.
4. Creates a "related" link between two topics that reinforce each other (not a prerequisite), so the connection is shown without implying order.
5. Reviews the cross-subject link set: the links are correct (the connections are genuine), and a wrong link is removed.
6. For an "applied-in" link (a concept applied in another subject), creates the link so the application context is visible.
7. Checks the integrated views: a topic's connections are visible from its page, and the integrated material references resolve to the linked topics.
8. The link create and remove events are audit-logged with the topics, the subjects, the link type, and the timestamp.

**Rules & Edge Cases:**
- A cross-subject link connects topics in different subjects; it does not merge the subjects (each keeps its own breakdown).
- The link type is explicit (prerequisite, related, applied-in); the type drives how the connection is presented.
- A prerequisite link implies order (the linked topic should come first); a related link does not.
- Links are reviewed for correctness; a wrong link is removed and the removal is recorded.
- Integrated material references the linked topics; the references resolve to the actual topics.
- Link create and remove are audit-logged with the topics, subjects, type, and timestamp.

### 3.4 Subject Difficulty Progression
**What it does:** Tracks the difficulty progression within and across a subject: how a subject's topics increase in difficulty through the sequence and across grades, so the learning path is a coherent ramp. The Super Administrator marks and reviews the difficulty progression so learners are challenged appropriately and the subject's path is well-graded.

**Sub-features:**
- Difficulty marking per topic (the topic's difficulty level within the subject)
- Progression view: the difficulty ramp across the subject's sequence
- Cross-grade progression: how the subject's difficulty builds from one grade to the next
- Progression review: the ramp is checked for coherence (no abrupt jumps or regressions)
- Learner pacing: the progression informs the recommended path and pacing
- Adjustment: correcting a difficulty mark where the ramp is off
- Audit logging of difficulty mark changes

**Super Administrator User Journey:**
1. For a subject, Super Admin reviews the difficulty progression: each topic's difficulty mark across the sequence, forming the ramp.
2. Checks the ramp for coherence: the difficulty increases smoothly, with no abrupt jump (a hard topic too early) or regression (an easy topic after a hard one).
3. For an abrupt jump, adjusts the difficulty mark or the sequence so the ramp is well-graded; the change is recorded.
4. Reviews the cross-grade progression: the subject's difficulty builds from one grade to the next (Grade 7's topics are a step up from Grade 6's), so the multi-year path is coherent.
5. Confirms the learner pacing: the recommended path follows the progression, so a learner is challenged appropriately at each step.
6. For a topic marked too hard (learners finding it unexpectedly difficult), reviews the mark and the content; adjusts the mark or routes the content for simplification.
7. Reviews the progression view per subject: the ramp is visible and well-graded, and the cross-grade build is coherent.
8. The difficulty mark changes are audit-logged with the subject, the topic, the mark, and the timestamp.

**Rules & Edge Cases:**
- Difficulty is marked per topic; the progression is the ramp formed by the marks across the sequence.
- The ramp is reviewed for coherence; abrupt jumps and regressions are corrected.
- Cross-grade progression is maintained: the subject builds in difficulty across grades, so the multi-year path is coherent.
- The progression informs pacing and the recommended path; it is a guide, not a hard gate (a learner can move at their own pace within the course's rules).
- A difficulty mark can be adjusted where the ramp is off; the adjustment is recorded.
- Difficulty mark changes are audit-logged with the subject, topic, mark, and timestamp.