github.com/City-of-Helsinki/linkedevents ↗

About City-of-Helsinki/linkedevents

Linked Events is a REST API platform for managing event information that serves as an aggregator, creator, and publisher of event data. Built with Django and Django REST Framework, it enables cities to set up centralized event publication hubs where events can be imported from multiple data sources, created through granular API endpoints with hierarchical organization structures and user permissions, and retrieved by interested parties through standardized API endpoints.

The project was originally developed by the City of Helsinki and includes Python importers that aggregate event data from various sources, as well as support for geographic information system features. It provides both Docker-based and traditional development installation paths, with particular support for Helsinki's regional data including locations, addresses, and event information from the capital region. The platform supports customization for different cities, though the accompanying UI is currently Helsinki-specific and requires Finnish language processing and city-specific ontologies.

The codebase is production-ready and can be deployed using standard WSGI application servers like Gunicorn or uWSGI. It uses PostgreSQL with PostGIS and HSTORE extensions, includes comprehensive test coverage, and provides OpenAPI/Swagger documentation. While originally tailored to Helsinki's needs, the architecture is designed to be adaptable for other municipalities that have OAuth2 authentication servers and are willing to customize the ontology and keyword systems for their regions.