docs: update Proof of Potato model to v0.2

README.md

@@ -1,43 +1,36 @@
 # 🥔 Potatium (PTM)
 
-**Eigenständige Hobby-Blockchain mit ressourcenschonender Proof-of-Potato-Lotterie.**
+**Eigene Hobby-Layer-1 mit sparsamer Mining-Lotterie „Proof of Potato“.** Das goldene abstrakte PTM-Logo liegt unter `assets/logo/potatium-ptm-logo.png`.
 
-Status **Projektgerüst / vor der Protokollimplementierung**. Dies ist ausdrücklich noch keine einsatzfähige Kryptowährung! Die enthaltene Weboberfläche ist ein **nichtfunktionaler Wallet-Entwurf**, keine Wallet zum Verwahren echter Werte.
+**Stand 25.10.2026: nur Go-Projektgerüst und statische Web-Wallet-Vorschau; keine echte Blockchain, kein Minting und keine funktionale Wallet.** Vorerst ausschließlich privates Testnetz mit wertlosen Test-PTM.
 
-## Schnelleinstieg
+## Entwicklungsumgebung
 
-1. **`START_HIER.md`** lesen. Zielsystem: Ubuntu Server **26.04 LTS** als unprivilegierter Proxmox-LXC.
-2. `sudo bash scripts/setup_ubuntu26.sh` installiert Basispakete und eine per SHA-256 geprüfte Go-Version.
-3. `bash scripts/bootstrap_workdir.sh` ergänzt fehlende Verzeichnisse, ohne Dateien zu überschreiben.
-4. `bash scripts/doctor.sh` prüft Installation und Starter-Build.
-5. VS Code via Remote-SSH öffnen und `handoff/STARTPROMPT_VSCODE_CODEX.md` in Codex verwenden.
+- Ubuntu **26.04 LTS** als unprivilegierter Proxmox-LXC `potatium-dev`
+- Benutzer `potatium`, Workspace **`/home/potatium/src/potatium`**
+- Go, Git-Monorepo auf privatem Gitea, VS Code per Remote-SSH mit OpenAI Codex
+- Zunächst kein Docker-in-LXC und keine PostgreSQL-Pflicht
 
-## Geplante Programme
+## Neues Mining-Konzept v0.2
 
-- `potatiumd`: Blockchain-Node, später CometBFT/ABCI++-Anwendung und HTTP/RPC.
-- `potatium-miner`: eigenständiger, sparsamer Miner für PCs und Raspberry Pis.
-- `potatium-cli`: Wallet-/Netzwerk-CLI.
-- `web/wallet`: **Web-Wallet ab MVP**, mit Erstellen/Import, Guthaben, Empfangen, Senden, Historie und Sperren/Entsperren.
+Je **einer Mining-Runde** gibt es **drei aufeinanderfolgende Aufgabenfenster**. Das erste ist kostenlos; Fenster 2 und 3 können solange kein Ticket vorliegt freiwillig gegen **fixe und progressive** Kosten benutzt werden. Grundlage der Progression sind die **PoP-Mining-Gewinne der letzten ca. 90 Tage** je registrierter Identität/Betreibergruppe, nicht das Wallet-Guthaben. Gebühren zusätzlicher Fenster werden **verbrannt**. Nach einem erfolgreichen Proof erhält die Identität maximal **ein Ticket** für die spätere, überprüfbare Gewinnziehung. **Alle konkreten Zahlen bleiben bis zu Simulation und Pi-Benchmark offen.** Mehr: `docs/PROTOKOLL_ENTWURF.md`, `docs/POP_FAIRNESS_UND_GEBUEHREN.md`, ADR 0003.
 
-## Was aktuell schon läuft?
+## Bestandteile
 
-Das Starterprojekt enthält einen kleinen lokalen **UI-Vorschau-Server**, aber **keine Blockchain**, keine Schlüsselverwaltung und keine echte Transaktion:
+- `cmd/potatiumd`, `cmd/potatium-miner`, `cmd/potatium-cli`: geplante ausführbare Go-Programme; bisher teils nur Gerüste.
+- `internal/`: Zustandslogik, Kryptografie, Registrierung, Proof, Lottery, Persistenz und API.
+- `web/wallet`: **statische Webvorschau**, keine Keys/realen Kontostände; echte Web-Wallet bleibt Pflicht **ab funktionalem MVP**.
+- `docs/`: Gesamthandbuch, Projektplan, Protokoll, Roadmap, ADRs.
+- `AGENTS.md`: bindender Arbeitskontext für Codex.
+
+## Checks und Vorschau
 
 ```bash
-go test ./...
-go run ./cmd/potatiumd -web-dir web/wallet -listen 127.0.0.1:8080
+cd /home/potatium/src/potatium
+bash scripts/doctor.sh
+make run-ui
 ```
 
-Aufruf lokal `http://127.0.0.1:8080`; bei Remote-SSH Port 8080 in VS Code weiterleiten.
+`make run-ui` bindet nur an `127.0.0.1:8080`; im VS-Code-Remote-Portforwarding öffnen. Keine echten Wallet-Schlüssel oder Coins verwenden.
 
-## Arbeitsgrundlage
-
-- `AGENTS.md`: bindende Projektregeln für Codex.
-- `docs/PROJEKTPLAN.md`: ausführliche technische Übergabe.
-- `docs/ARCHITEKTUR.md`: Komponentengrenzen.
-- `docs/PROTOKOLL_ENTWURF.md`: bestätigte und offene Protokollregeln.
-- `docs/WEB_WALLET.md`: MVP-/Sicherheitsanforderungen.
-- `docs/ROADMAP.md`: inkrementelle Meilensteine.
-- `handoff/CHATGPT_PROJEKTANWEISUNGEN.md`: ChatGPT-Projektanweisungen, **unter 8.000 Zeichen**.
-
-**Kein Finanzprodukt / kein Mainnet:** Alles zunächst nur Testnet und wertlose Test-PTM. Niemals produktive Schlüssel in Git oder im Chat ablegen.
+**Nächster Schritt:** M1-Parameter (Coin/Signatur/PoP-Fees) per Simulation und ADR bestätigen, danach Ledger/Web-Wallet beginnen. Startprompt: `handoff/STARTPROMPT_VSCODE_CODEX.md`.