The basic concept of PlaceCal is to connect people who run events within their community to people within communities looking for things to do.
A high level view of how it works looks like this:
- Neighbourhoods are hierarchical, so wider area neighbourhoods can contain narrower scoped neighbourhoods. This information comes from the UK government.
Sites manifest as domains in PlaceCal- so a Birmingham site would have birmingham.placecal.org
- Site admins can assign neighbourhoods to their site.
- Partners are people who run activities. They have an address which we use to look up the corresponding neighbourhood.
- Events represent a point-in-time that a Partner is running an activitity, so basically a Date/Time.
Sites contain many Neighbourhoods.
Partners have many Events. The events are created in PlaceCal from a Calendar that imports the event data from the Partners online calendar source (meetup, eventbrite, facebook, ICS and XML).
Broadly there are two types of user:
- Public Users: people who visit x.placecal.org to see events/partners in their area
- Partner Admins: people who create Partners so they can import events to provide activities on sites for public users.
Ultimate data flow
Sites have two sets of data
- Partners (in the sites neighbourhoods) that are pulled by Partner -> Address -> Neighbourhood -> Site
- Events (happening in Site neighbourhoods) that are pulled by Event -> Partner -> Address -> Neighbourhood -> Site