Michael/schneespur
1
1
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions
Self-hosted winter service documentation (PWA + Admin) — GPS tracks, weather data, photos & legally valid proof of service. Schneespur.de / Wintertrace.com https://schneespur.de
5 commits 1 branch 5 tags 38 MiB
PHP 53%
Blade 46.3%
JavaScript 0.7%
Find a file
Michael 2c63440ed8 Revert: move code back to project root from schneespur/ subdirectory 
- Reverts the schneespur/ subdirectory restructure (b8e426b)
- Restores package.json and vite.config.js (needed for npm build, were
  removed in an earlier cleanup before the restructure)
- Updates public/build/ assets with current Vite output (new content hashes)
2026-05-17 18:24:26 +00:00
app Revert: move code back to project root from schneespur/ subdirectory 2026-05-17 18:24:26 +00:00
bootstrap Revert: move code back to project root from schneespur/ subdirectory 2026-05-17 18:24:26 +00:00
config Revert: move code back to project root from schneespur/ subdirectory 2026-05-17 18:24:26 +00:00
database Revert: move code back to project root from schneespur/ subdirectory 2026-05-17 18:24:26 +00:00
lang Revert: move code back to project root from schneespur/ subdirectory 2026-05-17 18:24:26 +00:00
modules/example Revert: move code back to project root from schneespur/ subdirectory 2026-05-17 18:24:26 +00:00
public Revert: move code back to project root from schneespur/ subdirectory 2026-05-17 18:24:26 +00:00
resources Revert: move code back to project root from schneespur/ subdirectory 2026-05-17 18:24:26 +00:00
routes Revert: move code back to project root from schneespur/ subdirectory 2026-05-17 18:24:26 +00:00
storage Revert: move code back to project root from schneespur/ subdirectory 2026-05-17 18:24:26 +00:00
vendor Revert: move code back to project root from schneespur/ subdirectory 2026-05-17 18:24:26 +00:00
.editorconfig Revert: move code back to project root from schneespur/ subdirectory 2026-05-17 18:24:26 +00:00
.env.example Revert: move code back to project root from schneespur/ subdirectory 2026-05-17 18:24:26 +00:00
artisan Revert: move code back to project root from schneespur/ subdirectory 2026-05-17 18:24:26 +00:00
composer.json Revert: move code back to project root from schneespur/ subdirectory 2026-05-17 18:24:26 +00:00
composer.lock Revert: move code back to project root from schneespur/ subdirectory 2026-05-17 18:24:26 +00:00
INSTALL.de.md Restructure: move code into schneespur/ subdirectory, fix Umlauts 2026-05-17 13:52:39 +00:00
INSTALL.en.md Initial release v1.0.0 2026-05-17 13:33:51 +00:00
LICENSE Initial release v1.0.0 2026-05-17 13:33:51 +00:00
package.json Revert: move code back to project root from schneespur/ subdirectory 2026-05-17 18:24:26 +00:00
README.md Update README.md 2026-05-17 16:06:43 +02:00
VERSION Revert: move code back to project root from schneespur/ subdirectory 2026-05-17 18:24:26 +00:00
vite.config.js Revert: move code back to project root from schneespur/ subdirectory 2026-05-17 18:24:26 +00:00

README.md

Schneespur

Schneespur

Quelloffene, selbst gehostete Winterdienst-Dokumentation.
GPS-Tracks · Wetterdaten · Fotos · rechtsfester Einsatznachweis

schneespur.de · wintertrace.com

English · Installation (DE) · Installation (EN) · Download

Was ist Schneespur?

Schneespur dokumentiert Räum- und Streueinsätze für kleine Winterdienst-Betriebe — vollständig, automatisch und rechtssicher. Die Software läuft auf jedem günstigen Shared-Webhosting (Strato, IONOS, All-Inkl, ...) und braucht weder SSH noch Docker.

Kernversprechen: Wenn ein Passant auf einer gestreuten Fläche ausrutscht und der Betreiber nachweisen muss, dass er seiner Verkehrssicherungspflicht nachgekommen ist, liefert Schneespur den Beleg — mit GPS-Track, Wetterlage, Fotos und Zeitstempeln.

Funktionen

  • GPS-Tracking via OwnTracks-App (iOS/Android) — kein eigener Tracking-Client nötig
  • Automatische Wetterdokumentation — Temperatur, Niederschlag, Wind, Schneelage zum Einsatzzeitpunkt (Open-Meteo, BrightSky, Met.no)
  • Foto-Dokumentation — Bilder direkt aus der Fahrer-App hochladen
  • PDF-Einsatznachweise — einzeln oder als Sammelreport pro Kunde und Zeitraum
  • Kundenportal — Kunden können ihre Einsätze selbst einsehen
  • Fahrer-App (PWA) — funktioniert offline, synchronisiert automatisch bei Verbindung
  • Kunden- und Objektverwaltung — mehrere Objekte pro Kunde, Zuordnung zu Einsätzen
  • Fahrzeugverwaltung — Fuhrpark mit Kennzeichen und Fahrzeugtyp
  • DSGVO-konform — Fahrer-Anonymisierung, Datenexport, konfigurierbare Aufbewahrungsfristen
  • Automatische Updates — kryptographisch signiert (Ed25519), ein Klick im Admin-Panel
  • Modulsystem — erweiterbar über Module aus dem Schneespur-Modulkatalog

Systemanforderungen

Komponente Minimum
PHP 8.2
MySQL 5.7 / MariaDB 10.3
Webserver Apache mit mod_rewrite
PHP-Extensions pdo_mysql, mbstring, openssl, gd, sodium, fileinfo
Speicherplatz ca. 50 MB + Fotos

Schnellstart

  1. Download der aktuellen Version (ZIP)
  2. ZIP entpacken und per FTP auf den Webserver laden
  3. Document Root auf den public/-Ordner setzen
  4. Im Browser die Domain aufrufen — der Installations-Assistent führt durch die Einrichtung

Detaillierte Anleitung: INSTALL.de.md

Tech-Stack

Bereich Technologie
Backend PHP 8.2+ / Laravel 12
Frontend Blade + Alpine.js + Tailwind CSS v4
Karten Leaflet + OpenStreetMap
PDF DomPDF (rein PHP, kein Chrome/Puppeteer)
PWA Workbox via vite-plugin-pwa
Wetter Open-Meteo / BrightSky / Met.no

Lizenz

Schneespur ist lizenziert unter der GNU Affero General Public License v3.0.

English

The international edition of this software is called Wintertrace. The branding is set during installation based on the chosen language.

What is Schneespur?

Schneespur (German) / Wintertrace (international) is an open-source, self-hosted winter service documentation platform for small snow removal and gritting operators. It runs on any standard shared web hosting (no SSH or Docker required).

Core promise: When a pedestrian slips on a cleared surface and the operator needs to prove they fulfilled their duty of care, Schneespur provides the evidence — GPS track, weather conditions, photos, and timestamps.

Features

  • GPS tracking via OwnTracks app (iOS/Android) — no custom tracking client needed
  • Automatic weather documentation — temperature, precipitation, wind, snow depth at the time of service (Open-Meteo, BrightSky, Met.no)
  • Photo documentation — upload images directly from the driver app
  • PDF proof-of-service reports — individual or batch reports per customer and time period
  • Customer portal — customers can review their service records
  • Driver app (PWA) — works offline, syncs automatically when connected
  • Customer & site management — multiple sites per customer, assigned to jobs
  • Vehicle management — fleet with license plates and vehicle types
  • GDPR-compliant — driver anonymization, data export, configurable retention periods
  • Automatic updates — cryptographically signed (Ed25519), one click in the admin panel
  • Module system — extensible via modules from the Schneespur module catalog

System Requirements

Component Minimum
PHP 8.2
MySQL 5.7 / MariaDB 10.3
Web server Apache with mod_rewrite
PHP extensions pdo_mysql, mbstring, openssl, gd, sodium, fileinfo
Disk space approx. 50 MB + photos

Quick Start

  1. Download the latest release (ZIP)
  2. Extract and upload via FTP to your web server
  3. Set the document root to the public/ directory
  4. Open the domain in your browser — the installation wizard guides you through setup

Detailed guide: INSTALL.en.md

Tech Stack

Area Technology
Backend PHP 8.2+ / Laravel 12
Frontend Blade + Alpine.js + Tailwind CSS v4
Maps Leaflet + OpenStreetMap
PDF DomPDF (pure PHP, no Chrome/Puppeteer)
PWA Workbox via vite-plugin-pwa
Weather Open-Meteo / BrightSky / Met.no

License

Schneespur is licensed under the GNU Affero General Public License v3.0.