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

> Scheduling Lifecycles & Rollover Workflows

## End-to-End Calendar Lifecycle

The School Calendars module delivers structured, automated event management through cyclical relative scheduling, annual rollover mechanisms, and multi-device subscription feeds.

```mermaid theme={null}
flowchart TD
    subgraph SetupPhase["Phase 1: Academic Year & Term Framework"]
        S1["1. Manager configures Academic Year & Term Dates<br/>(Autumn 1 & 2, Spring 1 & 2, Summer 1 & 2, Holiday Blocks)"]
        S2["2. Create Discrete Calendars & Composite Groups<br/>(e.g. Sports, SEN, Whole School, Parent Feed)"]
        S3["3. Assign Calendar Owners & Subscribed Staff Cohorts"]
        S1 --> S2 --> S3
    end

    subgraph EventPhase["Phase 2: Cyclical Event Scheduling"]
        E1["Author Events anchored to relative Academic Week & Day of Week"]
        E2{"Event Nature"}
        E3["Timed Event (e.g. 08:30 - 09:00 Morning Briefing)"]
        E4["Multi-Day Span (e.g. 5-day Residential Trip)"]
        E1 --> E2
        E2 --> E3
        E2 --> E4
    end

    subgraph RolloverPhase["Phase 3: Annual Rollover & Publishing"]
        R1["New Academic Year activated"]
        R2["Events automatically map to matching days of week in new term dates"]
        R3["Owner reviews in Draft Planning Mode"]
        R4["Toggle Publish state ➔ Live for external feeds"]
        R1 --> R2 --> R3 --> R4
    end

    subgraph DistributionPhase["Phase 4: Sync & Distribution"]
        D1["Dynamic Webcal / iCal Feeds (Auto-refresh every 15 mins)"]
        D2["Automated Monday Morning Email Digest (Next Week & Week After Next)"]
        D3["Central MAT Template Synchronisation & Unsynced Discrepancy Alerts"]
    end

    SetupPhase --> EventPhase
    EventPhase --> RolloverPhase
    RolloverPhase --> DistributionPhase
```

***

## 1. Annual Rollover & Relative Scheduling Workflow

Unlike static calendar tools that require manual re-entry of annual school fixtures, Cleverschool calculates dates relative to the start of the academic year:

### How Relative Offset Works

* Each event is stored with its **Academic Week Number** (e.g. Week 3) and **Day of the Week** (e.g. Wednesday).
* When a new academic year is created with its unique term start dates, events automatically calculate their exact target calendar dates without landing on weekends or school holidays.

### Step-by-Step Rollover Process

**1. Configure Upcoming Academic Year**

`Calendar Managers` create the new academic year (e.g. `2027/2028`) and define term boundaries.

**2. Review Events in Draft State**

Open **Calendar List** (`/calendar/list/{calendar}/{year}`). The upcoming year remains in draft planning mode, isolating unfinished dates from parents and external subscribers.

**3. Enable or Disable Specific Fixtures**

Review recurring fixtures. Toggle individual events on or off, adjust start/end times, or use **Bulk Enable/Disable** to customise the annual schedule.

**4. Publish to Live Feeds**

Once senior leadership signs off the schedule, toggle **Published**. Live Webcal/iCal feeds and parent portals immediately reflect the approved dates.

***

## 2. Multi-Channel Distribution & Live Feeds

The module provides automated distribution pipelines to ensure staff, parents, and governors remain informed:

```mermaid theme={null}
flowchart LR
    Engine["Cleverschool Calendar Engine"] --> Webcal["Webcal / iCal Protocol (RFC 5545)"]
    Engine --> Digest["Weekly Automated Email Digest"]
    Engine --> PDF["High-Resolution PDF Wall Planners"]

    Webcal --> Apple["Apple Calendar (iOS / macOS)"]
    Webcal --> Google["Google Calendar"]
    Webcal --> Outlook["Microsoft Outlook"]

    Digest --> Staff["Staff Inboxes (Mondays at 08:00)"]
    PDF --> Noticeboard["Staffroom & Classroom Noticeboards"]
```

### 1. Personal Device Webcal Feeds

* Click **Add** next to any calendar or composite group to trigger direct calendar integration on iOS, macOS, Windows, or Android devices.
* Feeds utilize standard iCalendar specifications with automated background polling every 15 minutes.

### 2. Automated Monday Morning Email Digests

* Staff subscribed to calendars receive a digest every Monday morning at 08:00.
* The digest segments upcoming fixtures into **This Week**, **Next Week**, and **Week After Next**, highlighting critical deadlines and whole-school events.

***

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

For school groups and multi-academy trusts maintaining shared operational calendars (e.g. Trust Inset Days, Governance Meetings, Common Term Dates):

> [accordion] Central Template Propagation
>
> Trust central administrators author master calendars. Linked local school calendars inherit these fixtures automatically.

> [accordion] Discrepancy Monitoring (/calendar/unsynced)
>
> If a local school moves an event date to accommodate unique site arrangements, the system flags the variance in the **Unsynced Central Events Monitor**, allowing managers to review discrepancies or re-align with trust standards.


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