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

# Change Calendar

> Monthly calendar view of scheduled IT change requests and blackout periods with a day-detail side panel.

The Change Calendar provides a visual monthly view of IT changes and blackout periods and is accessible at `/it/changes/calendar`.

## Overview

The Change Calendar renders a month-view grid using `date-fns` helpers. Events are loaded from `useChangeCalendarEvents` with the start and end of the displayed month as parameters. Two event types are shown: `change` events (positioned based on `scheduled_start_at`) and `blackout` events (shown as a destructive "Blackout" badge spanning affected days). Each calendar cell is clickable and highlights the selected day with a ring. A side panel to the right shows blackout periods and scheduled changes for the selected day, with change cards linking to the individual change-request detail page at `/it/changes/:id`. Navigation buttons allow moving forward and backward one month or jumping to the current month.

## Who it's for

Requires `IT_PERMISSIONS.VIEW` (outer `ITViewGuard`). No additional per-route permission gate.

## Before you start

* You must hold `IT_PERMISSIONS.VIEW` to access this screen.

## Steps

<Steps>
  <Step title="Open the Change Calendar">
    Navigate to `/it/changes/calendar`. The current month loads with all scheduled changes and blackout periods.
  </Step>

  <Step title="Navigate months">
    Use the left/right chevron buttons to move to the previous or next month. Click the calendar icon to return to the current month.
  </Step>

  <Step title="Select a day">
    Click any cell to select it. The right panel updates to show changes and blackout periods for that day.
  </Step>

  <Step title="View a change request">
    Click a change card in the day-detail panel to navigate to its full detail page.
  </Step>
</Steps>

## Key concepts

* **change events** — Calendar entries derived from change requests; color-coded by `risk_level` (critical: destructive, high: warning, medium: accent, low: success).
* **blackout events** — Shaded cells with a destructive "Blackout" badge indicate restricted change windows.
* **useChangeCalendarEvents** — Fetches events filtered to the displayed month's date range.

## Related

<Columns cols={2}>
  <Card title="IT Service Management" icon="headset" href="/it/overview">
    IT Service Management overview.
  </Card>

  <Card title="Governance & parity" icon="scale-balanced" href="/governance/index">
    Documentation coverage and governance.
  </Card>
</Columns>

<Note>
  This page documents shipped product behavior. It is not medical, legal, or
  billing advice. Verify against your organization's policies and applicable
  regulations before using it for clinical, compliance, or billing decisions.
  Protected health information (PHI) shown in the product is governed by your
  tenant's access controls and is never exposed in this documentation.
</Note>

<Accordion title="Documentation sources">
  * src/routes/it.tsx
  * src/cores/it/pages/changes/ChangeCalendarPage.tsx
</Accordion>