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

# School Documents

> Document Distribution, Read Confirmations & Policy Workflows

## End-to-End Document Lifecycle

The School Documents module manages statutory policies, staff handbooks, and regulatory procedures through structured digital distribution, staff read-confirmation tracking, automatic re-confirmation triggers upon revision, and Multi-Academy Trust (MAT) synchronisation.

```mermaid theme={null}
flowchart TD
    subgraph AuthoringPhase["Phase 1: Upload & Classification"]
        U1["1. Manager uploads Document (PDF, Word, etc.)"]
        U2["2. Classify Document Type:<br/>(Policy, Procedure, Guidance, Handbook, Evidence, General)"]
        U3["3. Configure Access Boundary:<br/>• Internal Staff Only<br/>• Public Link (Shareable Token)"]
        U1 --> U2 --> U3
    end

    subgraph ConfirmationPhase["Phase 2: Staff Read Confirmations"]
        C1["Enable 'Requires Staff Confirmation'"]
        C2["Select target Staff / Departmental Cohort"]
        C3["Staff receive digital notification & read document"]
        C4["Staff record digital confirmation ➔ Status: 'Confirmed' (Logged with timestamp)"]
        C1 --> C2 --> C3 --> C4
    end

    subgraph RevisionPhase["Phase 3: Revision & Invalidation Trigger"]
        R1["Document replaced / revised with new annual version"]
        R2["Automatic Invalidation: Prior confirmations transition to 'Previously Confirmed'"]
        R3["System alerts staff that re-confirmation is required"]
        R1 --> R2 --> R3
    end

    subgraph AuditPhase["Phase 4: Compliance Auditing & Reminders"]
        A1["Weekly automated email digest sent to unconfirmed staff"]
        A2["Export Confirmation Matrix to Excel for Governor / Ofsted Scrutiny"]
        A3["Centrally Synchronised MAT Document Distribution"]
    end

    AuthoringPhase --> ConfirmationPhase
    ConfirmationPhase -->|When Policy Updated| RevisionPhase
    RevisionPhase --> ConfirmationPhase
    ConfirmationPhase --> AuditPhase
```

***

## 1. Document Upload & Access Configuration

Document Managers and Administrators curate the school's digital document vault:

**1. Upload Document File**

Navigate to **School Documents** (`/documents`) and click **Upload Document**. Drag and drop or browse for the policy or guidance file.

**2. Classify Document Type**

Categorize the document to maintain clean indexing across the school:

* **Policy**: Statutory governance and school rules (e.g. *Safeguarding & Child Protection Policy*, *Behaviour Policy*).
* **Procedure**: Step-by-step operational workflows (e.g. *Fire Evacuation Plan*, *First Aid Procedure*).
* **Handbook**: Comprehensive staff or governor guides (e.g. *Staff Handbook 2026/27*).
* **Guidance**: Advisory best practices and framework explanations.
* **Evidence**: Inspection evidence, external audit reports, or validation letters.
* **General**: Miscellaneous school documentation.

**3. Set Visibility & Public Access**

Choose whether the document is **Internal** (accessible strictly to authenticated school staff) or **Public** (generates a secure public URL for embedding on your school website or sharing with parents).

***

## 2. Staff Read Confirmation & Compliance Tracking

For mandatory statutory policies (e.g. *KCSIE Part 1*, *Code of Conduct*, *Health & Safety*), managers can mandate digital read confirmations:

```mermaid theme={null}
flowchart LR
    Unconfirmed["<b>Unconfirmed</b><br/>Staff notified of new mandatory document"] -->|Staff confirms| Confirmed["<b>Confirmed</b><br/>Timestamped audit record logged"]
    Confirmed -->|Policy Updated| PrevConfirmed["<b>Previously Confirmed</b><br/>Re-confirmation required"]
    PrevConfirmed -->|Staff re-verifies| Confirmed
```

### Managing Confirmations (`/document/{document}/confirmations`)

1. Open the document menu and select **Confirmations**.
2. Toggle **Enable Confirmation**.
3. Filter between **Users to confirm** and **All users** to inspect compliance rates in real time.
4. Click **Send reminders** to dispatch immediate reminder emails to outstanding staff members.

***

## 3. Document Replacement & Auto-Invalidation

When an existing policy is amended or renewed for a new academic year:

1. Click **Replace Document** and upload the revised file.
2. The system preserves the historical URL and document metadata while updating the underlying file.
3. All existing confirmations are automatically shifted to `Previously confirmed` (*Status: Needs Re-confirmation*).
4. Staff receive an automated notification stating: *"You confirmed that you had read and understood this Document on \[Date]. It has been updated and re-approved since then. Please re-confirm."*

***

## 4. Multi-Academy Trust (MAT) Central Synchronisation

For school groups distributing common trust policies:

> [accordion] Central Policy Propagation
>
> Trust leaders upload standard master policies at the central level. Linked academies receive updates automatically.

> [accordion] Local Compliance Oversight
>
> Each academy tracks its own staff confirmation percentage while ensuring all personnel are reading the single, authoritative trust version.

> [accordion] Audit Export
>
> Click **Export Confirmations** to download a comprehensive Excel matrix showing individual staff confirmation dates, ideal for external audits and governor reporting.


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