Elonn Docs Platform Documentation

time

time.elonn.local is the calendar, scheduling, and task service for Elonn. Production is time.elonn.com.

Time owns calendars, appointments, and tasks. It accepts Social events ingested from social.elonn.local as calendar mirrors. Social remains the source of event truth — Time does not pull from Social.

See time-contract.md for the runtime-facing calendar and social-event mirror rules.

Owns

  • calendars
  • appointments and calendar events (VEVENT)
  • tasks (VTODO)
  • recurrence and reminders
  • calendar object sources
  • day, week, month, agenda, and task workspaces
  • CalDAV synchronization
  • calendar slots and time boundaries
  • CalDAV integration using the member's normal API-owned account credentials

Role in the stack

Social pushes event data to Time whenever a Social event is created, updated, or deleted. Time stores the compatibility record and canonical VEVENT mirror with source_service = 'social' and source_object_type = 'event'.

World relays Time workspace and mutation endpoints to runtimes for the durable calendar surface.

World consumes GET /objects as the service-owned object source route. That route publishes appointments and tasks as domain objects with source, object_type, title, summary, state, domain_permissions, domain_actions, and relationships. It must not publish runtime layout or presentation primitives.

Critical distinction

Event alone always means a social event (see: event). A time service entry is always a calendar event or time event — never bare "event" when referring to a time service object.

Term Service Meaning
event social.elonn.local social gathering with RSVP and conversation
calendar event time.elonn.local calendar entry, may mirror a social event
time event time.elonn.local same as calendar event

Routes (selected)

GET  /events               list calendar events
POST /events               create calendar event
GET  /events/{id}          get calendar event
PATCH /events/{id}         update calendar event
DELETE /events/{id}        delete calendar event
POST /integrations/social/events   ingest social event
GET  /runtime/panel/time    get a day/week/month/agenda/task workspace
GET  /objects               list appointment and task object sources for World
POST /runtime/objects       create an appointment or task
PATCH /runtime/objects/{id} update an appointment or task
DELETE /runtime/objects/{id} delete an appointment or task
DAV  /caldav/               canonical external mixed VEVENT/VTODO endpoint
DAV  /dav/                  compatibility alias

Canonical terms

  • time — the calendar service
  • event — social event (authority: social.elonn.local)
  • session — always qualify: runtime session