AutomatenWegweiser Dokumentation

Über das Projekt

AutomatenWegweiser ist eine Community-basierte Plattform zum Finden und Teilen von Standorten verschiedener Automaten in Deutschland. Ob Snacks, Getränke, Zigaretten oder spezielle Produkte – unsere Nutzer helfen dabei, eine umfassende Datenbank aufzubauen.

Unsere Mission

Wir möchten es jedem ermöglichen, schnell und einfach Automaten in der Nähe zu finden. Gleichzeitig bauen wir gemeinsam mit unserer Community die größte Automaten-Datenbank Deutschlands auf.

Was uns unterscheidet

• Community-getrieben: Alle Daten werden von Nutzern wie dir beigetragen
• Kostenlos für Nutzer: Die Nutzung als Privatnutzer ist und bleibt kostenlos
• Aktuell: Durch regelmäßige Updates der Community bleiben die Daten aktuell

Roadmap

Unsere Entwicklungs-Roadmap zeigt die geplanten Meilensteine für AutomatenWegweiser:

AutomatenWegweiser

Produkt-Roadmap

Stage 1

Beta Release

Erste öffentliche Beta-Version mit Kernfunktionen: Karte, Automaten melden und Bewertungen.

Stage 2

Android App Beta Release

Beta-Version der Android-App mit grundlegenden Funktionen für unterwegs.

Stage 3

Main Release

Stabile Version 1.0 mit erweiterten Funktionen, optimierter Performance und finalen Features.

Stage 4

Android App

Native Android-App für unterwegs mit Offline-Funktionen und Push-Benachrichtigungen.

Stage 5

iOS App

Native iOS-App für iPhone und iPad mit vollständiger Feature-Parität zur Android-Version.

Funktionsübersicht

AutomatenWegweiser bietet zahlreiche Funktionen für verschiedene Nutzergruppen:

Karte nutzen

Die interaktive Karte ist das Herzstück von AutomatenWegweiser. Sie basiert auf OpenStreetMap und zeigt alle gemeldeten Automaten in deiner Umgebung.

Navigation auf der Karte

• Zoomen: Nutze das Mausrad oder die +/- Buttons
• Verschieben: Klicke und ziehe die Karte mit der Maus
• Standort: Klicke auf das GPS-Symbol, um zu deinem aktuellen Standort zu springen

Automaten anzeigen

Jeder Automat wird durch einen farbigen Marker auf der Karte dargestellt. Die Farbe entspricht der Kategorie des Automaten:

Automaten suchen

Es gibt mehrere Möglichkeiten, Automaten zu finden:

Umkreissuche

1. Gib eine Adresse oder Stadt in das Suchfeld ein
2. Wähle einen Radius (z.B. 500m, 1km, 5km)
3. Klicke auf "Suchen"

Standortbasierte Suche

1. Klicke auf das GPS-Symbol
2. Erlaube die Standortfreigabe in deinem Browser
3. Die Karte zentriert sich automatisch auf deinen Standort

Adress-Autovervollständigung

Bei der Eingabe einer Adresse werden automatisch Vorschläge angezeigt. Wähle einen Vorschlag aus, um die Karte direkt dorthin zu bewegen.

Filter & Kategorien

Nutze die Filterfunktion, um nur bestimmte Automatentypen anzuzeigen:

• Kategorie: Getränke, Snacks, Zigaretten, etc.
• Status: Nur aktive Automaten, alle anzeigen
• Öffnungszeiten: 24/7 verfügbar, bestimmte Zeiten
• Zahlungsarten: Bargeld, Karte, Kontaktlos

Automat melden

Als registrierter Nutzer kannst du neue Automaten zur Datenbank hinzufügen. Das Melden funktioniert ausschließlich über dein Smartphone — so können Kamera und GPS genutzt werden.

Voraussetzungen

• Du musst angemeldet sein
• Du benötigst ein Smartphone mit Kamera und GPS
• Der Automat darf noch nicht in der Datenbank sein

So meldest du einen Automaten

1. Öffne AutomatenWegweiser auf deinem Smartphone
2. Klicke auf "Automat melden" in der Navigation
3. Mache ein Foto des Automaten — der GPS-Standort wird automatisch erfasst
4. Wähle die Kategorie des Automaten
5. Gib optional weitere Informationen ein (Name, Beschreibung)
6. Sende den Automaten ab

Fotos hochladen

Fotos helfen anderen Nutzern, Automaten besser zu erkennen und einzuschätzen.

So lädst du ein Foto hoch

1. Öffne die Detailansicht eines Automaten
2. Klicke auf "Foto hochladen"
3. Wähle ein Bild aus (max. 5 MB, JPG/PNG)
4. Optional: Füge eine Beschreibung hinzu
5. Klicke auf "Hochladen"

Foto-Richtlinien

• Das Foto sollte den Automaten klar erkennbar zeigen
• Keine Personen sollten erkennbar abgebildet sein
• Das Foto muss von dir selbst aufgenommen worden sein
• Keine Werbung oder störende Texte

Änderungen vorschlagen

Wenn du feststellst, dass Informationen zu einem Automaten nicht mehr aktuell sind, kannst du eine Änderung vorschlagen.

So schlägst du eine Änderung vor

1. Öffne die Detailansicht des Automaten
2. Klicke auf "Änderung vorschlagen"
3. Wähle das Feld, das geändert werden soll
4. Gib den neuen Wert ein
5. Optional: Begründe deine Änderung
6. Klicke auf "Absenden"

Deine Änderung wird von einem Moderator geprüft.

Bewertungen abgeben

Bewertungen helfen anderen Nutzern bei der Einschätzung von Automaten und sorgen für aktuelle Daten in der Community.

Abstimmungsoptionen

• Existiert: Bestätige, dass der Automat noch vorhanden ist
• Existiert nicht: Melde, wenn der Automat nicht mehr existiert
• Gefällt mir: Zeige deine Empfehlung für diesen Automaten

So funktioniert es

1. Öffne die Detailseite eines Automaten
2. Wähle eine der Abstimmungsoptionen
3. Deine Stimme wird gespeichert
4. Du kannst deine Abstimmung jederzeit ändern oder zurückziehen

Registrierung

Die Registrierung ist für Privatnutzer kostenlos und dauert nur wenige Sekunden.

Vorteile eines Kontos

• Automaten melden und bearbeiten
• Fotos hochladen
• Bewertungen abgeben
• Eigene Beiträge verwalten

Registrierungsprozess

1. Klicke auf "Anmelden" und dann "Registrieren"
2. Gib deinen Benutzernamen, E-Mail und Passwort ein
3. Bestätige die AGB
4. Klicke auf "Registrieren"

Profil verwalten

In deinem Profil kannst du deine persönlichen Daten verwalten und deine Aktivitäten einsehen.

Profilseite

• Benutzername ändern: Wähle einen eindeutigen Namen
• Passwort ändern: Schütze dein Konto mit einem sicheren Passwort
• Zwei-Faktor-Authentifizierung: Aktiviere zusätzliche Sicherheit

Statistiken im Profil

Auf deiner Profilseite siehst du auf einen Blick:

• Gemeldete Automaten: Anzahl deiner eingereichten Automaten
• Hochgeladene Fotos: Anzahl deiner genehmigten Fotos
• Abgegebene Bewertungen: Deine Bewertungen für Automaten
• Mitglied seit: Dein Registrierungsdatum

Eingereichte Automaten

Unter "Eingereichte Automaten" findest du alle Automaten, die du gemeldet hast. Du kannst den Status einsehen (In Prüfung, Genehmigt, Abgelehnt) und Details anzeigen.

Zwei-Faktor-Authentifizierung

Mit der Zwei-Faktor-Authentifizierung (2FA) schützt du dein Konto zusätzlich. Neben dem Passwort benötigst du einen zeitbasierten Code aus einer Authenticator-App.

Unterstützte Apps

• Google Authenticator
• Microsoft Authenticator
• Authy
• Jede TOTP-kompatible App

2FA aktivieren

1. Gehe zu deinem Profil
2. Klicke auf "Zwei-Faktor-Authentifizierung aktivieren"
3. Scanne den QR-Code mit deiner Authenticator-App
4. Gib den 6-stelligen Code zur Bestätigung ein
5. Speichere die Backup-Codes sicher ab!

Anmeldung mit 2FA

Nach der Aktivierung wirst du bei jeder Anmeldung nach dem 6-stelligen Code gefragt. Öffne deine Authenticator-App und gib den aktuellen Code ein.

Punkte & Erfolge

Bei AutomatenWegweiser kannst du durch aktive Teilnahme Punkte sammeln und Erfolge (Achievements) freischalten. Je mehr du zur Community beiträgst, desto höher steigst du in der Rangliste!

So sammelst du Punkte

Erfolge freischalten

Für bestimmte Meilensteine erhältst du Erfolge, die auf deinem Profil angezeigt werden:

• 🏅 Erster Automat: Melde deinen ersten Automaten
• 📸 Fotograf: Lade 10 Fotos hoch
• 🗺️ Entdecker: Melde 25 Automaten
• ⭐ Experte: Erreiche 500 Punkte
• 🏆 Legende: Erreiche 2.000 Punkte

Rangliste

In der Rangliste siehst du, wie du im Vergleich zu anderen Nutzern abschneidest. Die aktivsten Mitglieder der Community werden dort hervorgehoben.