Cleanship is a citizen participation platform for complaints & suggestion management (Anliegenmanagement / Bürgerbeteiligung / ...) online platform that allows you to submit issues about the public infrastructure like street assets. The local administration will then review your note and the solution process is public visible.
It is the successor of Klarschiff. But this project includes only the core and a internal backoffice for city staff. We reuse the old public (mobile) frontend from Klarschiff, which is connected trough an extended CitySDK API. Currently we port only existing features, while avoiding old bottlenecks. New features will be introduced starting with version 0.3.
The code is Python3 using the Django 2 framework and bootstrap4 webfrontend toolkit.
Currently alpha , so expect that we will break your installation / data / modules / ... ! Migrations will cause data lost! This version is a preview with a lot of limitations:
For further readings please head over to docs.
Please be aware, that we are currently not looking for further contributors, till the codebase is considered as stable! For further reading about our coding, please refer CONTRIBUTING.md.
You might want to understand the internals, so feel free to play around with the django project and your own scripts. We recommend using ipython shell:
python3 manage.py shell --settings cleanship.settings.local
%load_ext autoreload
%autoreload 2
from common.models import issue
issue.objects.create(id=....)
You want to enable DEBUG = True
in your local settings and get a more verbose logging on the console, by adding this lines:
LOGGING = {
'version': 1,
'disable_existing_loggers': False,
'handlers': {
'console': {
'level': 'DEBUG',
'class': 'logging.StreamHandler'
},
},
'loggers': {
'common': {
'handlers': ['console'],
'level': 'DEBUG',
'propagate': True,
},
},
}
You might want to restrict the tests to specific suites using this line:
python3 manage.py test common/ --settings cleanship.settings.local
python3 manage.py test --settings cleanship.settings.local
coverage run manage.py test --settings cleanship.settings.local
This project is basing on the work of a lot of people. At first place the idea and features are a result of the EU EFRE donated Klarschiff platform, which was developed by the Fraunhofer IGD and maintained for years by BFPI.
The client protocol specification is basing on work of the open311 and citySDK communities and we shared our custom extensions as well.
The codebases integrates packages of great communities as well:
The internal office GUI makes use of a startbootstrap.com - Simple sidebar template and the Fork Awesome iconset.