🗳️ VoteBox – Digitale Abstimmungsplattform

Invite-basierte Online-Wahlen für Parteien, Verbände und Organisationen · Node.js · Express 5 · React 19 · PostgreSQL · TOTP-Sicherung

         

---

📋 Inhaltsverzeichnis

• Überblick
• Screenshots
• Wahlfluss im Detail
• Kernfunktionen
• Technische Architektur
• Tech Stack
• Schnellstart
• Roadmap
• Was dieses Projekt zeigt
• Autor

---

📸 Screenshots

Admin-Login mit TOTP-Absicherung	Neue Abstimmung erstellen
Stimmabgabe durch Wahlberechtigte	Abstimmungsübersicht (Admin)
CSV-Import der Wahlberechtigten

---

📖 Überblick

VoteBox ist eine sichere, einladungsbasierte Abstimmungsplattform für interne Wahlen in Parteien, Verbänden und vergleichbaren Organisationen.

Der Standardfluss ist bewusst einfach gehalten:

E-Mail erhalten → persönlichen Link öffnen → abstimmen → fertig

Das Projekt legt besonderen Wert auf:

• Starke Admin-Absicherung mit TOTP und HttpOnly-Session
• Reibungslosen Wählerzugang ohne zusätzliche Registrierung
• Datenschutz durch Datenminimierung, saubere Systemtrennung und automatisches Retention-Cleanup
• Schutz gegen Doppeltstimmen durch serverseitige Vote-Session-Logik
• Erweiterbare Multi-Tenant-Architektur (SaaS-Foundation in Aufbau)

Zielbereich: Parteiinterne Wahlen, verbandliche Abstimmungen, Pilotwahlen unter realen Bedingungen.

Nicht Zielbereich: Staatliche Wahlen, Kandidatenaufstellungen für Volksvertretungen, Verfahren mit abweichendem Spezialwahlrecht.

---

🧠 Technische Architektur

VoteBox ist als klar getrenntes Frontend/Backend-System aufgebaut mit modularen, single-responsibility Services auf der Serverseite.

Frontend (React)  →  Backend API (Express)  →  PostgreSQL

Architekturprinzipien:

• Single-Responsibility-Services (ein Service, eine Zuständigkeit)
• Zentralisierte Session- und Auth-Kontrolle
• Erweiterbare Modulstruktur für Multi-Tenant-Ausbau
• Konsequente Datentrennung: Identität, Einladung, Session und Stimme sind entkoppelt

---

🎯 Was dieses Projekt zeigt

• Invite-basierte Authentifizierungsarchitektur ohne Wähler-Registrierung
• Zweiphasiger Admin-Login (Passwort + TOTP) mit sicherer Session-Verwaltung
• Datenschutzkonforme Systemtrennung: Wahlberechtigung, Einladung, Session und Stimme sind entkoppelt
• Automatisiertes Retention-Cleanup ohne Ergebnisverlust
• Erweiterbare Multi-Tenant-Grundlage für SaaS-Ausbau
• Produktreifes PoC mit klarer Pilot- und Vermarktungsperspektive

---

👨‍💻 Autor

Patrick Neumann

GitHub: github.com/Codenix-1349