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

# Curriculum Management

> Tutorials & Practical Guides

## Practical Guides

Step-by-step walkthroughs to help curriculum managers, subject leaders, heads of department, and teachers operate the Curriculum module effectively.

***

### Guide 1: Drafting and Updating a Unit of Work

`Subject Editors`, `Subject Publishers`, and `Curriculum Managers` can draft curriculum refinements without affecting live content:

**1. Navigate to the Target Unit**

From the main Curriculum dashboard, click your subject, select the relevant academic year cohort (e.g. *Science: Year 8*), and click on the unit title to open the unit workspace.

**2. Open Field Editor Modal**

Click on any editable field card (such as **Title**, **Duration/Time**, **Description**, **Assessment Strategy**, **Careers**, or **Extension & Stretch**).

**3. Enter Draft Content**

Type or paste your updated content in the **Draft** text area:

* **Character Limits**: Titles and durations are limited to 255 characters; narrative descriptions, assessments, careers, and stretch fields support up to 2,048 characters.
* **Live Difference**: The **Visual Difference** pane automatically renders added text with green underlines and removed text with red strikethroughs.

**4. Save Draft**

Click **Save Draft**. The proposed update is saved into draft storage and is immediately visible to other department members with an indicator flag, while the live published version remains intact for website and PDF consumers.

**5. Enrich Statutory & Pastoral Dimensions**

* In the **SMSC** section, toggle applicable checkboxes for Spiritual, Moral, Social, and Cultural development, and author individual/community impact summaries.
* In the **Spirituality** section, author reflection opportunities across *Within* (personal beliefs/identity), *Around* (natural world/awe), and *Beyond* (ultimate questions/mystery).
* In the **Objectives & Aspects** cards, toggle associated exam assessment objectives (e.g. AO1, AO2, AO3) and exam paper aspects.

***

### Guide 2: Reviewing Visual Diffs and Publishing Changes

`Subject Publishers` and `Curriculum Managers` review proposed updates and commit them to the live curriculum:

**1. Open Unit with Pending Drafts**

Navigate to the unit workspace. Any field with pending draft updates displays a draft badge or diff indicator.

**2. Inspect the Visual Difference**

Click on the field to launch the comparison modal:

* **Published Content**: Displays the current approved version visible on the public website and PDF outputs.
* **Draft Content**: Displays the proposed text submitted by the Subject Editor.
* **Visual Difference**: Live HTML diff highlighting exact word insertions and deletions.

**3. Publish or Revert**

* **Publishing**: Check the **Publish to live curriculum immediately** box and click **Save**, or click the dedicated **Publish** action button to make the change live.
* **Reverting**: If the draft is rejected or needs to be discarded, click **Revert to Published** to reset the draft back to the current live content.

**4. Automated Cache Clearing**

Upon publishing, the module instantly invalidates all associated curriculum cache layers. Public website API feeds and PDF exports immediately reflect the approved content.

***

### Guide 3: Managing Subject Glossaries & Bulk Excel Vocabulary Import

Build a structured vocabulary bank of Tier 2 and Tier 3 academic terms:

> [accordion] Adding & Linking Vocabulary Terms
>
> 1. In any unit workspace, click **Glossary** (or navigate to `/curriculum/units/{unit}/glossary`).
> 2. Click **Add Word** to create a new term. Enter the **Word** and its precise **Meaning / Definition**.
> 3. Saving the term automatically associates it with the active unit and adds it to the master subject dictionary.
> 4. To attach existing subject terms to the current unit, toggle the **All Subject Words** view and click the checkmark next to any term to link it.

> [accordion] Bulk Importing Vocabulary from Excel / CSV
>
> 1. In the glossary view, click **Import Vocabulary** in the top action bar.
> 2. Click **Download Template** to obtain the pre-formatted spreadsheet (`word,meaning`).
> 3. Fill in your subject word list in Excel or Google Sheets.
> 4. Select your populated `.xlsx` or `.csv` file and click **Import**. The module validates and imports all terms into the subject vocabulary bank in bulk.

> [accordion] Exporting Subject Vocabulary
>
> * Click **Export Glossary** to download an Excel workbook containing all subject terms, definitions, and associated unit mappings.

***

### Guide 4: Cataloguing Online Learning Resources with KCSIE Verification

Ensure all digital resources recommended to pupils are vetted and safe:

**1. Open Unit Websites Hub**

In the unit workspace, click the **Websites** tab (or navigate to `/curriculum/units/{unit}/websites`).

**2. Add Learning Website**

Click **Add Website**. Enter:

* **Website Name / Title**: A pupil-friendly description of the resource (e.g. *BBC bitesiz - Cell Structure & Functions*).
* **URL**: The full HTTPS web address.

**3. Safeguarding & KCSIE Verification**

Confirm that the resource has been checked against your school's **Keeping Children Safe in Education (KCSIE)** online safety policy and filtering provisions before saving.

**4. Pupil & Parent Access**

Approved web links appear in the unit summary, PDF reports, and JSON API feeds for pupil and parent access.

***

### Guide 5: Reordering Units and Sequencing Programmes of Study

Maintain a logical chronological flow of topics across each term:

**1. Open the Programme of Study**

Navigate to the subject and select the target year cohort (e.g. *Geography: Year 9*).

**2. Drag-and-Drop Units**

Click and hold the drag handle on the left of any unit card. Drag the unit up or down to adjust its delivery position in the academic year.

**3. Automatic Order Saving**

Releasing the unit immediately saves the new sequence and updates the delivery numbering across all reports and website feeds.

**4. Enabling / Disabling Cohort Delivery**

Toggle the **Disabled / Enabled** switch in the page header if a subject is introduced or paused for a specific year group.

***

### Guide 6: Exporting Compliance & Curriculum Matrices (Excel & PDF)

Generate statutory compliance spreadsheets and inspection-ready curriculum overviews:

> [tab] School-Wide Compliance Matrices (Excel)
>
> On the main **Curriculum** dashboard (`/curriculum/subjects`), click any export button in the table header:
>
> * **Export SMSC**: Master spreadsheet documenting Spiritual, Moral, Social, and Cultural coverage across every subject and year group.
> * **Export Spirituality**: School-wide matrix detailing *Within*, *Around*, and *Beyond* spiritual reflection opportunities.
> * **Export Careers**: Comprehensive audit of career links and Gatsby Benchmark 4 connections across the entire school.
> * **Export Independent Learning**: Summary of homework and self-directed study tasks.
> * **Export Extension & Stretch**: Evidence of stretch and challenge provisions for high-attaining pupils.

> [tab] Departmental Subject Exports (Excel)
>
> Open any individual **Subject Dashboard** (`/curriculum/subjects/{subject}`) and select from subject-specific export actions:
>
> * **Subject SMSC Matrix** (`.xlsx`)
> * **Subject Spirituality Matrix** (`.xlsx`)
> * **Subject Careers Matrix** (`.xlsx`)
> * **Subject Capabilities & Priorities Matrix** (`.xlsx`)
> * **Subject Independent Learning & Stretch Matrices** (`.xlsx`)

> [tab] Inspection-Ready PDF Overviews
>
> * From any **Subject Dashboard** or **Programme of Study**, click **Print / Export PDF**.
> * The module compiles a professionally formatted, branded PDF document containing the complete sequence of units, time allocations, core descriptions, assessment summaries, vocabulary banks, and enrichment metadata—ready for governors, MAT trustees, and Ofsted deep dives.

***

### Guide 7: Headless JSON API & Website Integration

Publish structured curriculum data directly to your school website or external portals:

**1. Locate Unique Public API Endpoints**

Each published subject and programme of study generates a dedicated, secure JSON endpoint accessible via your school tenant domain:
`https://{school}.cleverschool.systems/api/curriculum/{subject-slug}`

**2. Consume Structured JSON Data**

Website developers can make GET requests to retrieve published units, delivery timeframes, descriptions, assessment criteria, vocabulary definitions, and website links in clean JSON format.

**3. Automatic Real-Time Updates**

Whenever a `Subject Publisher` approves a draft, the API endpoint updates automatically without requiring manual website content re-entry.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.