Add top-level README with repo map; refresh docs status

README.md

@@ -0,0 +1,81 @@
+# SpiderNet
+
+**Teile die Internetbandbreite deiner Nachbarschaft — ohne Mehrkosten.**
+
+SpiderNet ist **Software** für ein Nachbarschaftsnetz: Häuser werden
+direkt verbunden (Glasfaser, LAN, Funk — was da ist), und jeder Haushalt
+profitiert von der **Summe aller Internetanschlüsse** im Viertel. Große
+Downloads werden segmentiert und über alle Anschlüsse parallel geladen
+— schwache Anschlüsse werden stärker, niemand zahlt mehr. Als
+Nebenprodukt verteilt sich ausgehender Traffic auf viele Haushalte,
+was Rückverfolgbarkeit für Außenstehende erschwert.
+
+> **KEINE GARANTIE.** Diese Software wird "as is" ohne jegliche Garantie
+> bereitgestellt (AGPL §§ 15/16). Was Nutzer:innen damit übertragen,
+> liegt in ihrer Verantwortung — wir übernehmen keine Haftung.
+
+Wir providen **nur die Werkzeuge**: Jede Nachbarschaft richtet ihre
+eigene Instanz ein und entscheidet selbst über Topologie, Link-Typen,
+Geschwindigkeiten und Hausregeln. Es kann beliebig viele unabhängige
+SpiderNet-Instanzen geben — kein Zentralserver, keine zentrale
+Datensammlung, keine Bezahlung.
+
+## Struktur des Repos
+
+| Ordner/Datei | Inhalt | Einstieg |
+|---|---|---|
+| `documentation/` | Idee, Ethos, Architektur, Rechtslage, Roadmap (Deutsch, Obsidian-freundlich mit `[[Wikilinks]]`; `documentation/Home.md` ist die Map of Content) | [README](documentation/README.md) |
+| `server/` | Die Software (Rust): `sn-fetch`, `sn-node`, geplant `sn-exit`, `sn-fair`, `sn-cache`, `sn-freenet` | [README](server/README.md) |
+| `scripts/` | Repo-Setup (`bootstrap-gitea.sh`) | — |
+| `AGENTS.md` | Arbeitsanweisungen für Coding-Agents und Contributor:innen | [AGENTS.md](AGENTS.md) |
+| `LICENSE` | Code-Lizenz: AGPL-3.0-only | [LICENSE](LICENSE) |
+| `documentation/LICENSE` | Doku-Lizenz: CC-BY-SA-4.0 | [LICENSE](documentation/LICENSE) |
+
+## Die Idee in einem Satz
+
+Häuser werden direkt per Glasfaser verbunden; jede Anfrage ins Internet
+kann über **alle** Anschlüsse des Viertels gleichzeitig laufen
+(segmentiert und fair gemesht), sodass die effektive Bandbreite ~ der
+Summe aller Anschlüsse ist — ohne Mehrkosten und mit besserer
+Versorgung schwacher Haushalte.
+
+## Status
+
+Prototyp (Konzeptphase + erster Code):
+
+- **`sn-fetch` PoC** funktioniert: segmentierter Multi-Exit-Download
+  (Range-Probe, gewichteter Planner, parallele Segmente, Retry mit
+  Exit-Reassignment, Reassembly + SHA-256) — verifiziert gegen einen
+  echten Server (Debian-Mirror, 756 MB, Hash-Check) und gegen einen
+  lokalen Proxy für Nachbar-Exits. Details: [server/README.md](server/README.md)
+- **`sn-node` v0** funktioniert: Yggdrasil-Config-Generierung (`genconf`)
+  + Overlay-Status (`status` via Admin-Socket)
+- **Nächste Schritte:** `sn-exit` (kontingentierter Uplink-Proxy auf der
+  Yggdrasil-Adresse), Pilot mit 2–3 Haushalten — siehe
+  [Roadmap](documentation/ideen/roadmap.md)
+
+## Doku lesen (Obsidian)
+
+Ordner `documentation/` (oder das ganze Repo) als Obsidian-Vault öffnen
+und mit `documentation/Home.md` starten. Alternativ genügen die
+Markdown-Dateien in `documentation/` auch so.
+
+## Nicht-Ziele
+
+- Keine Bezahl-/Krypto-Infrastruktur (Kontrast: Althea)
+- Keine Anonymitätsversprechen (Yggdrasil und Freenet bieten keine)
+- Keine inhaltliche Kontrolle oder Zensur durch die Software selbst
+- Kein zentraler Exit, kein zentraler Server
+
+## Verwandte Projekte (Prior Art)
+
+[Freifunk](https://freifunk.net/) · [NYC Mesh](https://www.nycmesh.net/) ·
+[guifi.net](https://www.guifi.net/) ·
+[Althea](https://www.althea.net/) (Kontrast: Bezahl-Modell) ·
+[Yggdrasil](https://yggdrasilnetwork.github.io/) (Overlay) ·
+[lancache](https://lancache.net/) (Cache-Prinzip)
+
+## Lizenz
+
+- Code: [AGPL-3.0-only](LICENSE)
+- Dokumentation: [CC-BY-SA-4.0](documentation/LICENSE)

documentation/README.md

@@ -28,9 +28,10 @@ ist — ohne Mehrkosten und mit besserer Versorgung schwacher Haushalte.
 
 ## Status
 
-Konzeptphase. Die Software in `server/` ist noch nicht implementiert; der
+Prototypphase (siehe [Roadmap]): `sn-fetch` (segmentierter Multi-Exit-
-erste Meilenstein ist ein PoC "segmentierter Download über zwei Haushalte"
+Download mit Retry + Egress) und `sn-node` v0 (Yggdrasil-Config + Status)
-(siehe [[Roadmap]]).
+sind implementiert und getestet — Details in [`server/README.md`](../server/README.md).
+Nächster Meilenstein: `sn-exit` + Pilot mit 2–3 Haushalten.
 
 ## Verwandte Projekte (Prior Art)