Event Objects - lmucs/grapevine GitHub Wiki

Idea for Event Objects

Some information should be extractable from all posts/tweets sharing an event. These must be included in the event object. Event objects MUST have the following properties:

  • Title (What is going on)
  • Date(mm/dd/yyyy)
  • Who shared the event
    • Tag with org name of org that posted?
  • Status: Going to happen, Happening Right Now, Already Happened, Cancelled?
  • Time Until Event? (easily calculated from date and time of event?)
  • Reference to original post/tweet?
  • Unique ID
  • Time (Unix Timecode?) when it was processed

Some information is not available/applicable for all events. Event objects can optionally have the following properties:

  • Location
  • Tags (food, sports, deadline, etc)
  • Start Time (hour, min)
  • Duration (requires the start time field)
  • Repetition?
  • Social Media links?
  • URL

UPDATE: We will follow the following convention for timestamps:

  • If the start time and end time are the same and the start time is midnight, then the event is all day.
  • If the start time and end time are the same and the start time is NOT midnight, then the event starts at at the start time, but no end time is given.
  • If the start time and end time are not the same, then the event has a start and end time, that should be displayed.