rd13_tile_server/history/summary/PROJECT_CONTEXT.md
Conrad Schulz a7f71ebc9b docs: agent history und project context erstmalig angelegt
- history/prompts/2026-06-03_tile-server-setup_session.md: vollständige
  Konversation dieser Session (Setup, Migration, Download)
- history/summary/PROJECT_CONTEXT.md: aktueller Projektstand
2026-06-03 10:10:42 +00:00

102 lines
3.2 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

# PROJECT_CONTEXT rd13_tile_server
**Letzte Aktualisierung:** 2026-06-03 Planet-Download läuft, Martin konfiguriert
---
## Projektziel
Selbst gehosteter Tile Server auf Basis von **Martin** (Rust), der für MediaWiki,
Nextcloud, Home Assistant und andere Dienste Vektorkarten bereitstellt.
---
## Stack
- **Tile Server:** `ghcr.io/maplibre/martin:v1.10.1`
- **Port:** 9982 extern → 3000 intern
- **Proxy:** NPM (Nginx Proxy Manager) extern kein nginx-Sidecar
- **Daten:** MBTiles/PMTiles in `/data/`
- **Git Remote:** `ssh://git@192.168.178.6:2222/cschulz/rd13_tile_server.git`
---
## Aktueller Zustand
### Laufende Services
- Martin-Container: **noch nicht gestartet** (warte auf Download)
- Download `data/osm.mbtiles`: 🔄 ~67% (64/94 GB) läuft in tmux-Session `rd13-download`
### Vorhandene Daten in `/data/`
| Datei/Ordner | Status |
|---|---|
| `osm.mbtiles` | 🔄 Download läuft (~64 GB, fertig in ~30 Min) |
| `fonts/` | ✅ installiert |
| `styles/` | ✅ vorhanden |
| `satellite.mbtiles` | ❌ noch nicht heruntergeladen |
### Git-Stand
- Branch: `main`
- Letzter Commit: `df8518d` copilot-instructions aktualisiert
- Alle Änderungen gepusht
---
## Nächste Schritte (für nächsten Agenten)
1. **Download prüfen:**
```bash
tail -3 logs/download-osm.log
ls -lh data/osm.mbtiles # sollte ~94 GB haben wenn fertig
```
2. **Martin starten:**
```bash
docker compose up -d
curl http://localhost:9982/health
curl http://localhost:9982/catalog # sollte osm anzeigen
```
3. **Satellit-Download starten** (optional, ~10 GB, Zoom 010):
```bash
tmux new-session -d -s rd13-sat -c /mnt/services-data/rd13_tile_server \
'python3 scripts/download-satellite.py data/satellite.mbtiles 2>&1 | tee logs/satellite.log'
```
4. **NPM konfigurieren** (manuell im NPM UI):
- Proxy Host: `http://HOST:9982`
- Advanced Config: `add_header Cache-Control "public, max-age=86400, stale-while-revalidate=3600" always;`
---
## Bekannte Fallstricke
- `data/tmp/` und `data/sources/` werden von Docker als `root` erstellt → `sudo rm -rf` nötig
- Planetiler braucht sehr viel Disk (87 GB sources + 264 GB tmp + ~70 GB output = ~420 GB)
→ **Nicht mehr nötig**, wir nutzen OpenFreeMap MBTiles direkt
- Fish Shell unterstützt kein heredoc `<< 'EOF'` → Python `open().write()` oder `tee` verwenden
- Download von OpenFreeMap: `wget --continue` für Resume-Support bei Abbruch
---
## Erledigte Aufgaben
- [x] Git-Repo initialisiert und auf Forgejo gepusht
- [x] Migration TileServer-GL → Martin
- [x] nginx-Sidecar entfernt (NPM extern)
- [x] Port auf 9982 geändert
- [x] copilot-instructions auf aktuelles Template aktualisiert
- [x] download-data.sh + download-satellite.py erstellt
- [x] History-System (post-commit Hook + _session.md Konvention) in rd13_copilot_setup implementiert
- [x] Docs für MediaWiki, Nextcloud, Home Assistant erstellt
- [x] Planet-MBTiles Download gestartet (OpenFreeMap, 94 GB)
---
## Offene Aufgaben
- [ ] Download abwarten und Martin starten
- [ ] Satellit-Download (optional)
- [ ] NPM-Konfiguration (manuell)
- [ ] Hook-Verteilung auf alle Repos (install-hooks.sh)
- [ ] Martin mit echten Tiles testen