From 2724ba5705515a1f715cf499a44c310583b259c8 Mon Sep 17 00:00:00 2001
From: zemion <albrecht@degering.name>
Date: Mon, 6 Jul 2026 14:42:41 +0200
Subject: [PATCH] Sync Repo-docs-10-integrations from project files

---
 Repo-docs-10-integrations.-.md | 77 ++++++++++++++++++++++++++++++++++
 1 file changed, 77 insertions(+)
 create mode 100644 Repo-docs-10-integrations.-.md

diff --git a/Repo-docs-10-integrations.-.md b/Repo-docs-10-integrations.-.md
new file mode 100644
index 0000000..ac9fa1e
--- /dev/null
+++ b/Repo-docs-10-integrations.-.md
@@ -0,0 +1,77 @@
+<!-- codex-wiki-sync:eaea3d97b910c42e932c09c9 -->
+
+> Mirrored from `/mnt/DATA/git/pikebacker/docs/10_integrations.md`.
+> Origin: `repository`.
+> Active tasks and changing state belong in Gitea issues; this wiki page is durable project context.
+
+---
+# Integrations
+
+## Routing integrations
+
+Use provider adapters.
+
+### Prototype
+
+- openrouteservice API adapter.
+- Mock adapter for tests.
+
+### Production
+
+- GraphHopper or Valhalla self-hosted adapter.
+- Custom bikepacking profile layer on top of base routing.
+- Offline routing adapter later.
+
+## Map integrations
+
+- MapLibre-compatible rendering.
+- Vector tiles from OpenMapTiles, Protomaps/PMTiles, MapTiler, or self-hosted pipeline.
+- OSM attribution must be visible.
+
+## Accommodation integrations
+
+MVP should use:
+
+- OSM campsites/shelters/huts/hostels/hotels,
+- deep links to search platforms,
+- manual entries/imports for partner datasets.
+
+Later:
+
+- Booking.com Demand API if accepted as partner,
+- direct campsite/hut reservation systems,
+- Warmshowers-style partner/deep links if official access exists.
+
+## Weather integrations
+
+MVP:
+
+- forecast at stage endpoints and exposed segments.
+- warnings for heat, rain, wind, storms, freezing nights.
+
+Later:
+
+- route-time weather simulation,
+- weather-aware rerouting,
+- mud risk after rainfall.
+
+## Device integrations
+
+MVP:
+
+- GPX export.
+
+Next:
+
+- TCX export with course points.
+- FIT export.
+
+Later:
+
+- Garmin Courses API subject to approval.
+- Wahoo Cloud API subject to approval and use-case fit.
+- Hammerhead/Karoo sync if public/partner APIs allow.
+
+## Authentication and partnerships
+
+Do not assume public access to commercial APIs. Use deep links first and provider interfaces so partner integrations can be added without changing the domain model.