# thauber/django-schedule architecture

> Architecture diagram of the GitHub repository thauber/django-schedule, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-19). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/thauber/django-schedule
- Repository: https://github.com/thauber/django-schedule

## Overview

Django-schedule provides calendar and event management: users browse calendar periods, inspect event occurrences, and create or modify events and occurrence exceptions. Event recurrence rules generate occurrences; persisted changes and cancellations override generated instances. The app also supports generic-object calendar relations, configurable event selection and permissions, calendar views, and Atom/iCalendar exports. The excerpts show the view-to-period/template flow and occurrence persistence behavior; other links below rely on the README or SOURCE INDEX references rather than inspection of those modules.

Main entry points: [`schedule/views.py`](https://github.com/thauber/django-schedule/blob/master/schedule/views.py) (Calendar views), [`schedule/models/events.py`](https://github.com/thauber/django-schedule/blob/master/schedule/models/events.py) (Events and exceptions), [`schedule/feeds/__init__.py`](https://github.com/thauber/django-schedule/blob/master/schedule/feeds/__init__.py) (Feed definitions), [`schedule/models/calendars.py`](https://github.com/thauber/django-schedule/blob/master/schedule/models/calendars.py) (Calendars and relations)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_domain["Calendar domain"]
  node_calendar[("Calendars and relations<br/>[calendars.py]")]
  node_events[("Events and exceptions<br/>[events.py]")]
  node_rules[("Recurrence rules<br/>[rules.py]")]
  node_periods["Calendar periods<br/>[periods.py]"]
  node_occurrence_utils["Occurrence utilities<br/>[utils.py]"]
  node_signals["Model signals<br/>[signals.py]"]
end

subgraph group_presentation["Calendar interface"]
  node_views["Calendar views<br/>[views.py]"]
  node_forms["Event forms<br/>[forms.py]"]
  node_templates["Calendar templates"]
  node_template_tags["Calendar template tags<br/>[scheduletags.py]"]
end

subgraph group_feeds["Feed exports"]
  node_feed_routes["Feed definitions<br/>[__init__.py]"]
  node_atom["Atom serialization<br/>[atom.py]"]
  node_ical["iCalendar serialization<br/>[icalendar.py]"]
end

subgraph group_configuration["Configuration"]
  node_settings["Schedule settings<br/>[settings.py]"]
end

node_user(("Calendar user"))

node_user -->|"requests views"| node_views
node_views -->|"loads calendar"| node_calendar
node_views -->|"loads events"| node_events
node_views -->|"selects events"| node_settings
node_views -->|"builds periods"| node_periods
node_views -->|"uses forms"| node_forms
node_views -->|"checks permissions"| node_occurrence_utils
node_views -->|"renders templates"| node_templates
node_templates -.->|"uses tags"| node_template_tags
node_events -->|"reads recurrence"| node_rules
node_events -->|"references calendars"| node_calendar
node_events -->|"reconciles occurrences"| node_occurrence_utils
node_periods -->|"reads occurrences"| node_events
node_periods -->|"replaces occurrences"| node_occurrence_utils
node_calendar -->|"uses utilities"| node_occurrence_utils
node_feed_routes -->|"loads calendars"| node_calendar
node_feed_routes -->|"extends serializer"| node_atom
node_feed_routes -->|"uses serializer"| node_ical
node_feed_routes -->|"exports events"| node_events
node_feed_routes -->|"exports upcoming events"| node_calendar
node_signals -.->|"model integration"| node_events

click node_views "https://github.com/thauber/django-schedule/blob/master/schedule/views.py"
click node_forms "https://github.com/thauber/django-schedule/blob/master/schedule/forms.py"
click node_templates "https://github.com/thauber/django-schedule/tree/master/schedule/templates"
click node_template_tags "https://github.com/thauber/django-schedule/blob/master/schedule/templatetags/scheduletags.py"
click node_calendar "https://github.com/thauber/django-schedule/blob/master/schedule/models/calendars.py"
click node_events "https://github.com/thauber/django-schedule/blob/master/schedule/models/events.py"
click node_rules "https://github.com/thauber/django-schedule/blob/master/schedule/models/rules.py"
click node_periods "https://github.com/thauber/django-schedule/blob/master/schedule/periods.py"
click node_occurrence_utils "https://github.com/thauber/django-schedule/blob/master/schedule/utils.py"
click node_signals "https://github.com/thauber/django-schedule/blob/master/schedule/signals.py"
click node_feed_routes "https://github.com/thauber/django-schedule/blob/master/schedule/feeds/__init__.py"
click node_atom "https://github.com/thauber/django-schedule/blob/master/schedule/feeds/atom.py"
click node_ical "https://github.com/thauber/django-schedule/blob/master/schedule/feeds/icalendar.py"
click node_settings "https://github.com/thauber/django-schedule/blob/master/schedule/conf/settings.py"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_calendar,node_events,node_rules,node_periods,node_occurrence_utils,node_signals,node_user toneBlue
class node_views,node_forms,node_templates,node_template_tags toneAmber
class node_feed_routes,node_atom,node_ical toneMint
class node_settings toneRose
```

## Components

### Calendar domain

- [Calendars and relations](https://github.com/thauber/django-schedule/blob/master/schedule/models/calendars.py): `schedule/models/calendars.py`
- [Events and exceptions](https://github.com/thauber/django-schedule/blob/master/schedule/models/events.py): `schedule/models/events.py`
- [Recurrence rules](https://github.com/thauber/django-schedule/blob/master/schedule/models/rules.py): `schedule/models/rules.py`
- [Calendar periods](https://github.com/thauber/django-schedule/blob/master/schedule/periods.py): `schedule/periods.py`
- [Occurrence utilities](https://github.com/thauber/django-schedule/blob/master/schedule/utils.py): `schedule/utils.py`
- [Model signals](https://github.com/thauber/django-schedule/blob/master/schedule/signals.py): `schedule/signals.py`

### Calendar interface

- [Calendar views](https://github.com/thauber/django-schedule/blob/master/schedule/views.py): `schedule/views.py`
- [Event forms](https://github.com/thauber/django-schedule/blob/master/schedule/forms.py): `schedule/forms.py`
- [Calendar templates](https://github.com/thauber/django-schedule/tree/master/schedule/templates): `schedule/templates`
- [Calendar template tags](https://github.com/thauber/django-schedule/blob/master/schedule/templatetags/scheduletags.py): `schedule/templatetags/scheduletags.py`

### Feed exports

- [Feed definitions](https://github.com/thauber/django-schedule/blob/master/schedule/feeds/__init__.py): `schedule/feeds/__init__.py`
- [Atom serialization](https://github.com/thauber/django-schedule/blob/master/schedule/feeds/atom.py): `schedule/feeds/atom.py`
- [iCalendar serialization](https://github.com/thauber/django-schedule/blob/master/schedule/feeds/icalendar.py): `schedule/feeds/icalendar.py`

### Configuration

- [Schedule settings](https://github.com/thauber/django-schedule/blob/master/schedule/conf/settings.py): `schedule/conf/settings.py`

### Other components

- **Calendar user**

## Connections

- Calendar user → Calendar views: requests views (evidence: `README.textile`)
- Calendar views → Calendars and relations: loads calendar (evidence: `schedule/views.py`)
- Calendar views → Events and exceptions: loads events (evidence: `schedule/views.py`)
- Calendar views → Schedule settings: selects events (evidence: `schedule/views.py`)
- Calendar views → Calendar periods: builds periods (evidence: `schedule/views.py`)
- Calendar views → Event forms: uses forms (evidence: `schedule/views.py`)
- Calendar views → Occurrence utilities: checks permissions (evidence: `schedule/views.py`)
- Calendar views → Calendar templates: renders templates (evidence: `schedule/views.py`)
- Calendar templates → Calendar template tags: uses tags
- Events and exceptions → Recurrence rules: reads recurrence (evidence: `schedule/models/events.py`)
- Events and exceptions → Calendars and relations: references calendars (evidence: `schedule/models/events.py`)
- Events and exceptions → Occurrence utilities: reconciles occurrences (evidence: `schedule/models/events.py`)
- Calendar periods → Events and exceptions: reads occurrences (evidence: `schedule/periods.py`)
- Calendar periods → Occurrence utilities: replaces occurrences (evidence: `schedule/periods.py`)
- Calendars and relations → Occurrence utilities: uses utilities (evidence: `schedule/models/calendars.py`)
- Feed definitions → Calendars and relations: loads calendars (evidence: `schedule/feeds/__init__.py`)
- Feed definitions → Atom serialization: extends serializer (evidence: `schedule/feeds/__init__.py`)
- Feed definitions → iCalendar serialization: uses serializer (evidence: `schedule/feeds/__init__.py`)
- Feed definitions → Events and exceptions: exports events (evidence: `schedule/feeds/__init__.py`)
- Feed definitions → Calendars and relations: exports upcoming events (evidence: `schedule/feeds/__init__.py`)
- Model signals → Events and exceptions: model integration
