Critical Mass
Eine Webplattform zur Koordination und Dokumentation von Critical-Mass-Fahrradtouren weltweit.
Funktionen
Städte und Touren
- Städteverzeichnis: Übersicht aller Städte mit Critical-Mass-Touren
- Tourenkalender: Termine und Details zu allen geplanten Touren
- Wiederkehrende Termine (Cycles): Automatische Generierung von Touren basierend auf Regeln (z.B. "jeden letzten Freitag im Monat")
- Subrides: Unterstützung für Nebentouren und Zubringer
- Regionen: Geografische Gruppierung von Städten
Teilnahme und Community
- Teilnahmebestätigung: Nutzer können ihre Teilnahme an Touren ankündigen
- Teilnehmerschätzungen: Crowdsourced Schätzungen der Teilnehmerzahlen
- Diskussionsforen: Boards und Threads für den Austausch
- Benutzerprofile: Persönliche Profile mit Teilnahmehistorie
Dokumentation
- Fotogalerie: Upload und Verwaltung von Tourenfotos
- GPS-Tracks: Upload und Visualisierung von GPX-Tracks
- Strava-Integration: Import von Tracks direkt aus Strava
- Wetterdaten: Automatische Wetterdokumentation für Touren
- Timeline: Aktivitätsfeed aller Ereignisse
Karten und Visualisierung
- Interaktive Karten: Leaflet/MapLibre-basierte Kartenansichten
- Streckendarstellung: Visualisierung von GPS-Tracks auf Karten
- Cluster-Ansicht: Übersichtliche Darstellung vieler Marker
Social Media
- Social-Network-Profile: Verknüpfung mit Facebook, Twitter, Instagram etc.
- Feed-Integration: Aggregation von Social-Media-Posts
API
- REST API: Vollständige REST-Schnittstelle unter
/api/
- API-Dokumentation: Interaktive Dokumentation unter
/api/doc
Statistiken
- Monatsstatistiken: Auswertungen nach Zeiträumen
- Top-Listen: Rankings nach verschiedenen Kriterien
Systemvoraussetzungen
Erforderlich
- PHP >= 8.5
- MySQL/MariaDB >= 10.9
- Node.js >= 18
- Yarn >= 3.4 oder npm
- Composer >= 2.0
PHP-Extensions
intlsimplexmlfileinfoxmlwriterjsonzippdo_mysql
Optional (für vollständige Funktionalität)
- Redis: Caching und Sessions
- RabbitMQ: Asynchrone Verarbeitung (View-Counting, Track-Import)
- Memcached: Alternatives Caching
Lokale Entwicklung
1. Repository klonen
git clone https://github.com/criticalmass-one/criticalmass-in.git
cd criticalmass-in
2. Docker-Services starten
Die Datenbank und weitere Services werden via Docker bereitgestellt:
docker-compose up -d
Dies startet:
- MariaDB auf Port 8002 (extern) / 3306 (intern)
- Redis für Caching
- Memcached für Caching
- Mailcatcher für E-Mail-Tests (Web-UI auf Port 1080)
3. Umgebungsvariablen konfigurieren
cp .env .env.local
Die .env.local nach Bedarf anpassen. Die Standardwerte funktionieren mit den Docker-Services.
4. PHP-Abhängigkeiten installieren
composer install
5. Frontend-Assets installieren und bauen
yarn install
yarn build
Für die Entwicklung mit Hot-Reload:
yarn watch
# oder
yarn dev-server
6. Datenbank einrichten
# Datenbank-Schema erstellen
php bin/console doctrine:schema:create
# Optional: Fixtures laden (Testdaten)
php bin/console doctrine:fixtures:load
7. Symfony-Server starten
Mit Symfony CLI (empfohlen):
symfony serve
Oder mit PHP Built-in Server:
php -S localhost:8000 -t public/
Die Anwendung ist dann unter http://localhost:8000 erreichbar.
Konfiguration
Datenbank
DATABASE_URL=mysql://criticalmass:[email protected]:8002/criticalmass
OAuth (Facebook, Strava)
Für Social Login müssen entsprechende App-Credentials konfiguriert werden:
FACEBOOK_APP_ID=your_app_id
FACEBOOK_APP_SECRET=your_app_secret
STRAVA_CLIENT_ID=your_client_id
STRAVA_SECRET=your_secret
RabbitMQ
Für asynchrone Verarbeitung:
RABBITMQ_URL=amqp://guest:guest@localhost:5672
Redis
REDIS_URL=redis://localhost:6379
Tests
Test-Datenbank einrichten und Tests ausführen
composer test
Dies führt folgende Schritte aus:
- Test-Datenbank zurücksetzen
- Schema erstellen
- Fixtures laden
- PHPUnit-Tests ausführen
Nur Tests ausführen (ohne DB-Reset)
composer test:run
# oder
./vendor/bin/phpunit
Nur API-Tests
composer test:api
Projektstruktur
criticalmass-in/
├── assets/ # Frontend-Assets (JS, CSS, Images)
├── bin/ # Konsolenbefehle
├── config/ # Symfony-Konfiguration
│ ├── packages/ # Bundle-Konfigurationen
│ └── routes/ # Routing-Konfiguration
├── docker/ # Docker-Volumes
├── public/ # Web-Root
│ ├── photos/ # Hochgeladene Fotos
│ └── tracks/ # Hochgeladene GPS-Tracks
├── src/
│ ├── Command/ # Konsolenbefehle
│ ├── Controller/ # HTTP-Controller
│ │ └── Api/ # REST-API-Controller
│ ├── Criticalmass/ # Domain-Logik
│ ├── Entity/ # Doctrine-Entities
│ ├── Form/ # Symfony-Formulare
│ ├── Menu/ # Menü-Builder
│ ├── Repository/ # Doctrine-Repositories
│ ├── Serializer/ # Serializer-Komponenten
│ └── Twig/ # Twig-Extensions
├── templates/ # Twig-Templates
├── tests/ # PHPUnit-Tests
├── translations/ # Übersetzungsdateien
└── var/ # Cache und Logs
Wichtige Konsolen-Befehle
# Cache leeren
php bin/console cache:clear
# Datenbank-Migrationen
php bin/console doctrine:migrations:migrate
# Routen anzeigen
php bin/console debug:router
# Services anzeigen
php bin/console debug:container
# Assets installieren
php bin/console assets:install public
API-Dokumentation
Die REST-API ist unter /api/ verfügbar. Eine interaktive Dokumentation (Swagger/OpenAPI) findest du unter:
http://localhost:8000/api/doc
API-Endpunkte (Auswahl)
| Methode | Endpunkt | Beschreibung |
|---|
| GET | /api/city | Liste aller Städte |
| GET | /api/{citySlug} | Details einer Stadt |
| GET | /api/{citySlug}/{rideIdentifier} | Details einer Tour |
| GET | /api/ride | Liste von Touren |
| GET | /api/photo | Liste von Fotos |
| GET | /api/track | Liste von Tracks |
| POST | /api/estimate | Teilnehmerschätzung abgeben |
Technologie-Stack
Backend
- Symfony 6 - PHP-Framework
- Doctrine ORM - Datenbank-Abstraktion
- Twig - Template-Engine
Frontend
- Bootstrap 5 - CSS-Framework
- Webpack Encore - Asset-Bundling
- Stimulus - JavaScript-Framework
- Leaflet/MapLibre - Kartenvisualisierung
- Chart.js - Diagramme
Infrastruktur
- MariaDB/MySQL - Datenbank
- Redis - Caching
- RabbitMQ - Message Queue
- Docker - Containerisierung
Lizenz
MIT License
Autor
Malte Hübner - [email protected]
