# Calendar

## User Perspective
The Content Calendar (`/calendar`) visualizes scheduled and published videos on a calendar grid. The UI exposes two views: **Month** and **Agenda** (next 30 days). A week view exists at the API level but is not surfaced in the frontend.

Each entry shows:
- Video title
- Scheduled/published date
- Template name
- Assigned collaborators
- Lint status
- Privacy status

## Developer Perspective

### Backend
- **Module**: `backend/src/modules/calendar/`
- **Endpoint**: `GET /calendar?view=month|week|agenda&date=YYYY-MM`
- Returns videos where `scheduledAt` OR `publishedAt` falls within the computed date range
- For `agenda` view: next 30 days from the given date
- For `week` view: the week containing day 1 of the given month. **Known limitation:** the `date` param is `YYYY-MM` (no day), so the week view always anchors to the first of the month — arbitrary week navigation is not possible at the API level. The frontend does not expose this view.

## Related
- [[12 - Calendar API]]