Files
Ben_Kosytorz d8bd14ab1b Add pilot handbook and document sn-fair v0
pilot.md: step-by-step for connecting two households (link-agnostic),
measurement protocol M0-M4 (link baseline, uplink baseline, pooled,
concurrent downloads, sn-fair Soll/Ist comparison), safety/legal
checklist, and a results section to be filled after the pilot.
Cross-linked from Home, documentation README, roadmap, architecture
and server README; roadmap marks sn-fair v0 done.
2026-09-24 18:46:47 +02:00

57 lines
2.7 KiB
Markdown

# SpiderNet — Startseite (Obsidian)
> Für Obsidian: Ordner `documentation/` (oder das ganze Repo) als Vault
> öffnen; diese Notiz ist der Einstieg. Alle Verbindungen laufen über
> `[[Wikilinks]]`.
## Projekt
**SpiderNet** ist **nur die Software** für ein Nachbarschaftsnetz: Häuser
werden per Glasfaser (neben den bestehenden Internetanschlüssen) direkt
verbunden — welcher Link-Typ und welche Geschwindigkeit, entscheidet jede
Nachbarschaft selbst (10 Gbit, 1 Gbit, 1,6 Tbit, Funk — alles möglich).
Die Bandbreite aller Anschlüsse wird gepoolt, sodass jeder Haushalt vom
gesamten Netz profitiert. **Wir providen nur die Software**, jede
Nachbarschaft betreibt ihre eigene Instanz nach eigenen Regeln.
## Navigation
| Notiz | Worum es geht |
|---|---|
| [[Ethos]] | Werte: Gemeingut, Fairness, Leechen erlaubt, legale Basis |
| [[Idee]] | Kernidee + ehrlicher Realitätscheck |
| [[Architektur]] | Schichten: Physik → Routing → Pooling → Freenet-Inhalte |
| [[Overlay]] | Yggdrasil als Overlay: Auswahl, Deployment, Grenzen |
| [[Recht]] | Deutsche Rechtslage + Pflichtregeln für die Software |
| [[Splitting]] | Was sich splitten lässt: Ranges, Flow-Verteilung, Realtime |
| [[Lizenz]] | Lizenz-Optionen (Code & Doku) |
| [[Roadmap]] | Phasen: Pilot → MVP → Rollout → Freenet → Backbone |
| [[Pilot]] | Pilot-Handbuch: 2 Haushalte verkabeln, messen, dokumentieren |
| [[Server-README|Server-Konzept]] | Software-Komponenten, Code-Standards |
## Lesereihenfolge zum Einstieg
1. [[Idee]] — was wollen wir eigentlich
2. [[Ethos]] — welche Regeln geben uns vor
3. [[Architektur]] — wie bauen wir es technisch
4. [[Recht]] — was können wir (nicht) tun
5. [[Roadmap]] — wie kommen wir dahin
## Querverbindungen zwischen den Notizen
- [[Ethos]] §2 (Fairness/Leechen) ↔ [[Architektur]] (Leech-Modus, `sn-fair`)
- [[Recht]] §5 (Pflichtregeln) ↔ [[Server-README]] (Haftungsausschluss)
- [[Idee]] (Realitätscheck) ↔ [[Architektur]] (link-agnostische Physik, `sn-fetch`)
- [[Splitting]] ↔ [[Architektur]] (Schicht 2) — was der Exit-Pool tatsächlich nutzen kann
- [[Overlay]] ↔ [[Architektur]] (Schicht 1) — Routing-Entscheidung und deren Grenzen
- [[Overlay]] ↔ [[Server-README]] — `sn-node` generiert die Yggdrasil-Config, `sn-fetch` nutzt `Egress::Proxy`
- [[Pilot]] ↔ [[Roadmap]] (Phase 1) und [[Overlay]] §Deployment — der Pilot ist der erste Real-Test
- [[Pilot]] §M4 ↔ [[Architektur]] §Fairness-Scheduler — `sn-fair` berechnet die Soll-Aufteilung
- [[Lizenz]] ↔ [[Ethos]] §6 (Transparenz) und `freenet-core` (AGPL)
## Außerhalb der Doku
- [[Server-README]] — Software-Konzept in `server/`
- `AGENTS.md` — Arbeitsregeln für Coding-Agents
- `scripts/bootstrap-gitea.sh` — Repo-Setup