Technik
Offen entwickelt
Wo der Quelltext liegt, wie Yapaia geprüft wird und wie du mitmachen kannst.
Alles auf GitHub
Der komplette Quelltext liegt öffentlich im Monorepo github.com/Yapaia/yapaia:
| Ordner | Inhalt |
|---|---|
go/ | Yapaia Go: Core, Web-App, Add-on |
beat/ | Yapaia Beat: Radio-Dienst, Add-on |
vision/ | Yapaia Vision: Kamera-Dienst, Add-on |
satellite/ | ESPHome-Konfiguration für den Sprachsatelliten |
router/ | Doku und Änderungsliste von Yapaia Router |
integration/ | die Home-Assistant-Integration „Yapaia“ inkl. Router-Modul |
dashboards/ | fertige Dashboards für Home Assistant |
devices/ | ESPHome-Konfigurationen weiterer Geräte im Fahrzeug |
docs/ | Protokoll und Fähigkeiten |
Ein einziger Add-on-Store, eine Integration, gemeinsame Regeln – und trotzdem hat jedes Modul seine eigene Version und Änderungsliste.
Geprüft, bevor es zu dir kommt
Jede Änderung läuft durch automatische Prüfungen, nur die der betroffenen Module:
- Unit- und Integrationstests (Go allein: mehrere tausend)
- End-to-End-Tests im Browser
- Golden Routes: echte Routen auf echten Karten, die sich nicht verschlechtern dürfen
- Bau des Add-on-Images und ein Blick hinein
- Sicherheitstests (Sandbox, Authentifizierung, Abhängigkeiten)
Erst wenn alles grün ist, wird zusammengeführt.
Lizenz
Yapaia ist freie Software unter der GNU General Public License 3.0 oder später (GPL-3.0-or-later). Du darfst es nutzen, verändern und weitergeben – auch verändert, solange es unter derselben Lizenz und mit Quelltext bleibt. Yapaia kommt ohne Gewähr.
- Ausnahme: Das Add-on-SDK von Go, die Beispiel-Add-ons und die Signaturprüfung des Marktplatzes stehen unter der Apache License 2.0. So entscheidet jeder Add-on-Autor selbst über die Lizenz seines Add-ons.
- Fremde Bausteine und Daten (OpenStreetMap, Valhalla, welle.io …) nennt die Datei
DRITTLIZENZEN.md. - Name und Logo „Yapaia“ sind nicht Teil der Lizenz – siehe
NAME-UND-LOGO.md.
Offene Daten
Alle Karten kommen von OpenStreetMap. Fehlt eine Höhenbeschränkung an einer Brücke, kannst du sie dort selbst eintragen – davon profitieren alle.
Mitmachen
- Fehler melden oder Ideen einbringen: Issues auf GitHub
- Eigenes Modul bauen: Das Yapaia-Protokoll ist genau dafür da.
- Code beitragen: Bitte zuerst ein Issue öffnen. Beiträge nehmen wir nur zusammen mit einer Beitragsvereinbarung an, die es dem Projekt erlaubt, Yapaia auch zu anderen Bedingungen anzubieten (etwa Herstellern).