Handbuch für die Ehrenamtsplattform
Willkommen im Handbuch für die Ehrenamtsplattform!
Diese Dokumentation – erreichbar unter https://ehrenamtsplattform.smart-village.app – richtet sich speziell an Kommunen, Vereine, Engagierte und technische Implementierer:innen, die die Plattform einführen, betreiben oder weiterentwickeln möchten.
Hinweis: Dies ist nicht die allgemeine Dokumentation zur Smart Village App (zu finden unter https://docs.smart-village.app/ und ebenso nicht die offizielle Dokumentation für HumHub (zu finden unter https://docs.humhub.org/).
Was ist die Ehrenamtsplattform?
Die Ehrenamtsplattform ist ein offenes, modular aufgebautes Werkzeug, das Vereine und Ehrenamtliche vor allem in ländlichen Regionen bei Kommunikation, Organisation und Sichtbarkeit unterstützt. Sie entstand im Modellvorhaben „Herzberg digital.verein.t“ als Reaktion auf schrumpfende Mitgliederzahlen, wachsende Verwaltungsaufgaben und die Erfahrungen der Corona-Pandemie. Statt persönliche Begegnungen zu ersetzen, ergänzt die Plattform das Vereinsleben digital: Öffentliche Bereiche machen Angebote sichtbar, interne Räume (Chats, Kalender, Dateien) erleichtern die Zusammenarbeit. Die Lösung ist Open Source, übertragbar auf andere Kommunen und wird derzeit über das Heimat-2.0-Patenmodell in weiteren Regionen eingeführt.
Was bietet dieses Handbuch?
- Hintergrundwissen zur Idee und Entstehung der Ehrenamtsplattform
- Zielgruppen- und Nutzenübersicht für Bürger:innen, Kommunen und Organisationen
- Technische Einblicke und Anleitungen zur Nutzung, Administration und Weiterentwicklung
- Hinweise zur Installation, zum Hosting sowie zur Weiterentwicklung durch Dritte
- Open-Source-Lizenzinformationen, Kontaktmöglichkeiten und Glossar
Was finde ich wo?
Einleitung
- Motivation hinter der Plattform
- Aufgaben und Ziele
- Entstehungsgeschichte
- Zielgruppenbeschreibung
- Vorteile für Bürger:innen, Kommunen und Organisationen
- Abgrenzung zu anderen Plattformen und Einbettung ins digitale Ökosystem
- Voraussetzungen für den Einsatz
Projektübersicht
- Überblick über die mobilen und serverseitigen Komponenten
- Details zur Smart Village App und zur Integration von HumHub
- Installations- und Betriebshinweise
- Lizenzierung und Veröffentlichung
App-Modul
- User Guide: Schritt-für-Schritt-Anleitungen zur Nutzung der App für Nutzer:innen und Administrator:innen
- Developer Guide: Technische Anleitung zu EP-Modul, API, Architektur, Deployment, Sicherheit und mehr
Humhub im produktiven Einsatz
- Hosting-Strategien für HumHub (bare metal, VMs)
- Performance-Optimierungen (z. B. Netzwerk, Firewall, KSM)
- Härtungsmaßnahmen (z. B. Fail2Ban)
Anhang
- Glossar technischer und inhaltlicher Begriffe
- Kontakt- und Supportadressen der beteiligten Organisationen
- Weiterführende Links und Ressourcen
Unterstützung & Mitmachen
Diese Dokumentation wird offen gepflegt. Du findest sie im GitLab-Projekt unter:
➡️ https://gitlab.opencode.de/ehrenamtsplattform/dokumentation/
Bei Fragen oder Ergänzungen kannst du gerne ein Issue erstellen oder einen Merge Request einreichen.
Veröffentlichung & Lizenzen
- Der Quelltext dieses Repos steht unter der MIT-Lizenz.
- Die Inhalte dieser Dokumentation (Texte, Bilder etc.) stehen unter der Creative Commons Attribution 4.0 (CC BY 4.0).