Der Hackathon Manager ist eine Webanwendung zur Organisation und Durchführung von Hackathons.
Er bietet Funktionen zur Verwaltung von Projekten, Teams und Teilnehmern sowie zur Kommunikation und Zusammenarbeit während des Events.
Wer den Hackathon Managers einfach nur nutzen will, dem reicht der Hackathon-Stack.
Mehr Informationen zur Konfiguration und zum Betrieb findest du dort.
- Motivation
- Implementierung
- Howto: Wie starte ich mein Projekt
- Autoren
- Lizenz
- Code of Conduct
- Contribution
- Build- und Test-Badges
Hackathons sind eine großartige Möglichkeit, kreative Ideen zu entwickeln und innovative Projekte umzusetzen. Doch die Organisation eines Hackathons bringt zahlreiche Herausforderungen mit sich.
Unser Ziel ist es, eine leichtgewichtige und selbst gehostete Lösung bereitzustellen, um interne Hackathons mit 50–250 Teilnehmenden aus verschiedenen Teams und Standorten zu organisieren. Der Fokus liegt dabei auf Einfachheit und die wirklich wichtigen Features – ohne den Overhead klassischer Event-Plattformen. Alles drin, was du für einen reibungslosen internen Hackathon brauchst.
- Effiziente Projektverwaltung: Teilnehmer müssen ihre Projekte einreichen können, ohne dass es zu Chaos oder Missverständnissen kommt. Oft fehlt eine zentrale Plattform, um alle Projekte übersichtlich zu sammeln und zu verwalten.
- Transparenz bei der Projektübersicht: Organisatoren und Teilnehmer benötigen eine klare Übersicht darüber, welche Projekte verfügbar sind und wer Teil des Teams ist.
- Fairness bei der Teamverteilung: Es muss sichergestellt werden, dass sich nicht zu viele Teilnehmer für ein Projekt anmelden und jeder nur einem Projekt zugeordnet wird. Ohne klare Regeln kann dies schnell unübersichtlich werden.
- Teilnehmerstatistiken: Organisatoren müssen jederzeit wissen, wie viele Teilnehmer aktiv sind, wie sie auf Projekte verteilt sind und ob die Kapazitäten ausreichend sind. Fehlende Übersicht erschwert meist die Planung und Anpassung.
- Nachhaltigkeit der Ergebnisse: Nach dem Hackathon sollen die Projekte für weiterhin sichtbar bleiben. So können sie als Beispiel und Basis für künftige Hackathons dienen oder direkt als Anregung für die Produktroadmap genutzt werden.
Der Hackathon Manager wurde entwickelt, um diese Herausforderungen zu bewältigen. Er bietet eine zentrale Plattform, die sowohl Organisatoren als auch Teilnehmer unterstützt und den gesamten Prozess – von der Anmeldung bis zur Nachbereitung – vereinfacht und effizienter gestaltet.
- Eventmanagement: Plane und verwalte Hackathon-Events mit allen relevanten Details.
- Projektmanagement:
- Erstelle und verwalte Projekte.
- Pitchen eigener Ideen, um neue Projekte zu starten.
- Verwalte den Status des Projekts (z. B. Pitching, läuft, abgebrochen, abgeschlossen).
- Teamverwaltung:
- Anzeige der Ansprechpartner und Ideengeber für jedes Projekt.
- Verwaltung der Teilnehmer in Teams, einschließlich Zuordnung und Kapazitätsmanagement.
- Eigenes Profil: Teilnehmer können ihre Kontaktdaten und persönlichen Informationen hinterlegen.
- Verlinkung zu MSTeams: Integration von Microsoft Teams, um die Kommunikation innerhalb der Teams zu erleichtern.
- Responsive Design: Optimiert für Desktop, Tablet und mobile Geräte.
Das Frontend wurde mit React (Ionic) entwickelt und verwendet Vite als Build-Tool.
Es befindet sich im Verzeichnis /frontend.
- React 18 mit Ionic 8 für UI-Komponenten
- Vite für schnelle Builds und Hot Module Replacement
- Axios für API-Anfragen
- Prettier & ESLint für Code-Formatierung und Linting
- Vitest & Cypress für Tests
Das Backend ist eine Node.js (Express) API mit einer SQLLite-Datenbank.
Es befindet sich im Verzeichnis /backend.
- Node.js (Express) als Web-Framework
- SQLLite als Datenbank
- Swagger für API-Dokumentation
- JWT für Authentifizierung
- Dotenv für die Verwaltung von Umgebungsvariablen
- Docker & Docker Compose für containerisierte Bereitstellungen
git clone https://github.com/jenszech/hackathon-stack.git
cd hackathon-stack
docker compose up --buildWenn alles klappt werden die docker container bezogen und gestartet. Du erreichst dann die folgenden Applikationen:
| Pfad | Funktion |
|---|---|
| http://localhost: | Haupt-REST-API |
| http://localhost:3005/api-docs/ | Backend API-Dokumentation (Swagger) |
| http://localhost:3005/api/health/ | Backend Healthcheck |
| http://localhost:8081 | Dozzle, abrufen der Logfiles |
Melde dich mit den Standardanmeldedaten an:
Benutzer: hackathon@thalia.de
Passwort: welcome!
Eine ausführliche Dokumentation der Konfiguration und Start Optionen ist im Rahmen des Hackathon Stack abrufbar.
git clone https://github.com/jenszech/hackathon-manager.git
cd hackathon-managerStarten des Backends
cd backend
npm install
npm run start-devStarten des Frontends
cd frontend
npm install
npm run start-devWeitere Details zur lokalen Einrichtung findest du in der Entwicklerdokumentation.
Starten der docker container aud dem Projekt heraus:
docker compose up --buildStoppen der Umgebung
docker compose downHinweis: Stelle sicher, dass die Ports
80,3005und8081auf deinem System frei sind.
Du kannst uns fragen, wenn es irgendwelche Fragen gibt!
Wenn du zum Projekt beitragen möchtest, lies bitte die Beitragshinweise.
Dort findest du alle Informationen, wie du Änderungen vorschlagen und Pull Requests einreichen kannst.
Wir freuen uns über jeden Beitrag, sei es durch das Melden von Fehlern, das Vorschlagen neuer Features oder das Einreichen von Pull Requests.
Für eine ausführlichere Anleitung zur Einrichtung der Entwicklungsumgebung schau dir die Entwicklerdokumentation an!
Die Badges zeigen den aktuellen Status der Builds, die Docker-Images und die Release-Version des Projekts.
