> ## 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

> Authoring, Review & Dual-State Publishing Workflows

## End-to-End Curriculum Lifecycle

The Curriculum module provides a collaborative authoring and approval workflow powered by a dual-state drafting engine, ensuring proposed modifications undergo rigorous editorial review prior to public release.

```mermaid theme={null}
flowchart TD
    subgraph StructurePhase["Phase 1: Academic Structure"]
        S1["1. Manager defines Subjects & Year Cohorts (Reception to Y13)"]
        S2["2. Configure Programmes of Study (e.g. Year 8 Science)"]
        S3["3. Assign Subject Editor & Subject Publisher"]
        S1 --> S2 --> S3
    end

    subgraph AuthoringPhase["Phase 2: Unit Authoring & Enrichment"]
        A1["Subject Editor authors Units of Work"]
        A2["Edits Draft Fields: Title, Duration, Descriptions, Assessment Strategy"]
        A3["Attaches Enrichment: SMSC, British Values, Spirituality (Within/Around/Beyond), Careers"]
        A4["Links Subject Vocabulary & KCSIE-Vetted Online Resources"]
        A1 --> A2 --> A3 --> A4
    end

    subgraph ReviewPhase["Phase 3: Editorial Diff & Publishing"]
        R1["Subject Publisher opens Programme of Study"]
        R2["Visual HTML Diff Modal compares Live Published vs. Proposed Draft"]
        R3{"Editorial Decision"}
        R3 -->|Approved| R4["Click 'Publish'<br/>• Draft merges into Published state<br/>• Instant cache invalidation"]
        R3 -->|Needs Revision| R5["Editor refines draft text"]
    end

    subgraph OutputPhase["Phase 4: Publication & Distribution"]
        O1["Live Public School Website & Parent Portals (API & Embeds)"]
        O2["High-Resolution PDF Curriculum Maps (Working-week / Full-year)"]
        O3["Subject Lexicon & Vocabulary Study Booklets"]
    end

    StructurePhase --> AuthoringPhase
    AuthoringPhase --> ReviewPhase
    R4 --> OutputPhase
```

***

## 1. Dual-State Drafting & Publishing Engine

To safeguard website and parent portal accuracy, all unit changes are isolated in draft fields until formally approved:

```mermaid theme={null}
flowchart LR
    Editor["<b>Subject Editor</b><br/>Refines unit narrative<br/><code>[ description_new ]</code>"] --> DiffModal["<b>Visual Diff Modal</b><br/>Side-by-side comparison<br/><code>ins / del</code> highlighting"]
    DiffModal --> Publisher["<b>Subject Publisher</b><br/>Reviews & approves<br/><code>[ Publish Action ]</code>"]
    Publisher --> LiveOutput["<b>Live Production</b><br/>Updated in PDF & Web APIs<br/><code>[ description ]</code>"]
```

### Step-by-Step Publishing Workflow

**1. Author Draft Changes**

The `Subject Editor` navigates to the target programme of study (e.g. *Year 9 History*) and clicks on a unit of work. Enter changes in the draft editor fields (`title_new`, `time_new`, `description_new`, `assessment_new`).

**2. Inspect Visual Difference**

Clicking on any modified field opens the **Visual Difference Modal**. Green highlighting indicates added words (`<ins>`), while red strikethrough shows deleted text (`<del>`).

**3. Review by Subject Publisher**

The designated `Subject Publisher` or `Curriculum Manager` reviews the proposed wording against statutory national curriculum standards.

**4. Promote to Published State**

The publisher selects **Publish Field** or **Publish All Changes**. The draft content is promoted into the active published fields, and cached public views are refreshed immediately.

***

## 2. Enrichment Framework Integration

Teachers embed statutory enrichment dimensions into units during the drafting phase:

> [tab] SMSC & British Values
>
> * Record specific learning opportunities fostering **Spiritual**, **Moral**, **Social**, and **Cultural** development.
> * Document contributions to democracy, rule of law, individual liberty, and mutual respect.

> [tab] Three-Dimensional Spirituality
>
> * **Within (Self)**: Opportunities for inner reflection, identity, and personal values.
> * **Around (World)**: Fostering awe, curiosity, and appreciation of nature and human culture.
> * **Beyond (Transcendence)**: Exploring ultimate questions of purpose, faith, and mystery.

> [tab] Careers & Gatsby Benchmarks
>
> * Link classroom topics directly to industry sectors, vocational skills, and career pathways (Gatsby Benchmark 4).

> [tab] Tiered Vocabulary Glossaries
>
> * Attach Tier 2 (cross-curricular) and Tier 3 (domain-specific technical) vocabulary terms directly to units for pupil literacy progression.

***

## 3. Curriculum Mapping & PDF Export

Senior leaders and inspectors can generate structured curriculum maps:

* **Whole-Subject Journey**: Export visual progression maps showing learning continuity from Year 7 through Year 13.
* **Programme Overview Sheets**: Generate print-ready PDF unit summaries for departmental meetings, parent information evenings, or governor scrutiny.


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