[CallMeTechie]

Phase 3b, Teil D (Android): Die App nutzt den Zwischenspeicher im Heimnetz (GateControl ≥ 1.231.0, Drive ≥ 1.20.0).

Was die App jetzt tut

• Drive-Downloads (GET nodes/<id>/content – Öffnen/Senden von Dateien, Foto-Originale, Tresor-Dateien) schicken X-GC-Local: a.b.c.d[,…] mit, wenn
  • Drive homeCache in GET me meldet,
  • das Gerät private IPv4-Adressen (RFC 1918) auf WLAN/Ethernet hat (nie VPN-Netz, nie Mobilfunk, VPN-Subnetz zusätzlich ausgefiltert),
  • und die vorhandene Heimnetz-Prüfung (GET /api/v1/client/home-network) „zu Hause“ sagt (Ergebnis je Adress-Satz 10 Min. gemerkt, keine Antwort 1 Min., Zeitlimit 4 s).
    Ältere Versionen (…/versions/<vid>/content) nie.
• lan-Hinweis → Laden direkt vom Gateway (HomeCacheFetcher, core/network):
  • eigener X509TrustManager nur für diese Verbindung, nimmt ausschließlich das Zertifikat mit SHA-256(DER) = tlsSha256 an; HostnameVerifier prüft Adresse und Pin (kein { true }); zusätzlich Prüfung im Netzwerk-Interceptor vor dem Request
  • Hinweis nur gültig mit https://<private IPv4>/blob/<sha256>, 64-Hex-Hashes, exp mit 5 s Reserve; sha256 muss zum Knoten passen
  • kein Proxy, keine Redirects, keine Zugangsdaten/Interceptoren der App, Accept-Encoding: identity
  • Socket an das WLAN/Ethernet gebunden, dessen Subnetz die Gateway-Adresse enthält – also am Tunnel vorbei (die App ist VPN-Besitzerin und darf die Netze darunter nutzen, wie GateDrop direkt). Ohne solches Netz routet das System (ggf. durch den Tunnel – korrekt, nur nicht schneller).
  • Bytes in eine Temp-Datei, SHA-256 + Größe geprüft; erst dann bekommt der Aufrufer sie (Datei wird beim Schließen gelöscht). Jeder Fehler (Pin, TLS, Timeout, 403/404, Hash, Größe, exp) → still der normale Download.
  • Logs nur host:port/blob/<sha-Anfang> + Grund, nie URL-Query/Signatur; X-GC-Local im HTTP-Log geschwärzt.
• „Offline verfügbar“ (Feature offline): Eintrag im ⋮-Menü von Dateien und Ordnern (Ordnerseiten, Drive-Tab, Suche), Haus-Markierung in Liste und Kacheln, Liste „Offline verfügbar“ (Symbol im Drive-Menü) mit Öffnen und Entfernen; Grenze 500 mit eigenem Text.
  Die App hat keinen eigenen Offline-Speicher (nur den 24-h-Cache geöffneter Dateien). „Offline verfügbar“ heißt daher hier „zu Hause im Zwischenspeicher bevorzugt bereithalten“ – so steht es im Menü und auf der Liste („Auf diesem Handy wird nichts dauerhaft gespeichert“; ohne homeCache: „vorgemerkt“).
• App-Updates: Die App lädt Updates nicht selbst (Play-Build: Google Play; sonst öffnet sie downloadUrl im Browser, der kein Pinning kann). Der lan-Weg für Updates wird deshalb nicht genutzt.

Tests

• HomeCacheTest (core/network, echter TLS-Server mit selbstsigniertem Zertifikat aus keytool): Pin passt / falsch / mit Doppelpunkten, falscher Hash, 403/404, Redirect, exp abgelaufen, fremder Hash, zu groß, niemand erreichbar, Fortschritt, TrustManager, Hinweis-Prüfung, Header nur private Adressen / ohne VPN-Netz / max. 4, Subnetz.
• DriveHomeCacheTest, HomeSiteMemoryTest (app).
• Lokal: alle Unit-Tests grün (2100), lintRelease ohne Befund in den geänderten Dateien.

Nicht gegen ein echtes Gateway getestet.

Version nicht erhöht (Release-Workflow).

---

Generated by Claude Code