docs: add PTM ecosystem vision and README roadmap

AGENTS.md

@@ -10,3 +10,7 @@
 8. **Tests:** Go `gofmt`, `go test ./...`, `go vet ./...`; passende Integrationstests, fuzzer/race tests. Für PoP Simulation und Pi 4 / Office-PC Benchmark, Fairness, Gebühren-Erwartungswerte, abweichenden Codepfad, Replay, Burn und Restart. Tests und Resultate **nie erfinden**.
 9. **Sicherheit:** keine öffentlich gebundenen Test-APIs (nur `127.0.0.1`/SSH-Forward), keine echten Schlüssel/Tokens/Datenbank-/Wallet-Dateien in Git. Keine unverhältnismäßigen Dependencies, keine destruktiven Befehle ohne Backup. Entgeltliche Chance auf Lotteriegewinn birgt Rechtsrisiko; bis auf Weiteres **wertlose private Test-PTM**.
 10. **Lieferstil:** Vor jeder größeren Änderung kurze Planung + Akzeptanzkriterien; danach Dateien/Änderungen, was real läuft, Testbefehle mit Ergebnissen, Grenzen und nächsten kleinen Schritt angeben. ADR für wesentliche Entscheidungen.
+
+## Zukunftsvision F1–F4 (25.10.2026)
+
+Geplante **spätere** PTM-Nutzungen sind digitale Sammlerstücke, ein interner PTM-Marktplatz und eine Handelsplattform für fiktive interne Assets mit Orderbuch, Kursen und Portfolio, optional mit **strikt getrenntem** Paper-Trading. Sie sind **noch nicht implementiert** und erfordern nach M6 eigene ADRs, sichere Eigentums-/Handelsabwicklung und klare Kennzeichnung interner vs. simulierter Kurse. **Nicht** auf Initiative von Codex vorziehen, keine Cosmos-/NFT-/DEX-Frameworks ungefragt integrieren, keine echten Preise oder Volumina erfinden. Sammlerstücke/Assetbesitz dürfen PoP-Chancen nicht erhöhen. Maßgeblich: `docs/ZUKUNFT_OEKOSYSTEM.md`, `docs/decisions/0004-zukunftsvision-internes-oekosystem.md`.

README.md

@@ -1,36 +1,74 @@
-# 🥔 Potatium (PTM)
+<p align="center">
+  <img src="assets/logo/potatium-ptm-logo.png" alt="Potatium PTM Logo: goldenes geometrisches P auf Schwarz" width="180" />
+</p>
 
-**Eigene Hobby-Layer-1 mit sparsamer Mining-Lotterie „Proof of Potato“.** Das goldene abstrakte PTM-Logo liegt unter `assets/logo/potatium-ptm-logo.png`.
+<h1 align="center">🥔 Potatium (PTM)</h1>
 
-**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.
+<p align="center"><strong>Eine eigenständige Hobby-Blockchain mit Proof of Potato.</strong><br />
+Ressourcenarm · Raspberry-Pi-tauglich · lokal kontrollierte Web-Wallet · privates Testnetz</p>
 
-## Entwicklungsumgebung
+> **Projektstatus, 25.10.2026:** Entwicklungsgerüst und statische Web-Wallet-Vorschau vorhanden. Eine funktionsfähige Chain, echte PTM-Transaktionen, PoP-Mining, Sammlerstücke oder eine Börse sind **noch nicht implementiert**. Kein Anlageprodukt, kein Kursversprechen. Ausschließlich private, nicht einlösbare Test-PTM.
 
-- 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
+## Was ist Potatium?
 
-## Neues Mining-Konzept v0.2
+Potatium soll eine **eigene Layer-1-Blockchain in Go** werden, kein ERC-20-Token. Ein kleines privates Netzwerk aus alten PCs und Raspberry Pis betreibt die Chain. Vorgesehen sind **CometBFT / ABCI++** mit einer eigenen deterministischen Anwendung, zunächst ohne Cosmos SDK; die tatsächlichen Versionen und Architekturdetails werden vor Implementierung geprüft.
 
-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.
+- **PTM:** Coin für Überweisungen, Mining-Belohnungen und später interne Anwendungen.
+- **Proof of Potato (PoP):** Miner lösen leichte, begrenzte Rechenaufgaben. Validatoren produzieren und bestätigen die Blockchain-Blöcke, PoP-Miner nicht.
+- **Web-Wallet ab funktionalem MVP:** Schlüssel und Signaturen bleiben im Browser; die API bekommt niemals Seed oder Private Key.
+- **Keine reale Wertzusage:** PTM ist ein Hobby-/Testnet-Coin ohne garantierte Einlösung in Geld oder andere Kryptowährungen.
 
-## Bestandteile
+## Proof of Potato: aktueller Produktentwurf
 
-- `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.
+Eine Mining-Runde enthält **drei aufeinanderfolgende Aufgabenfenster**. Fenster 1 ist für zugelassene Miner kostenlos. Wer noch kein gültiges Ticket hat, kann Fenster 2 und 3 gegen **fixe und progressive Gebühren** freischalten. Maßstab für die Progression sind zurechenbare **PoP-Gewinne eines gleitenden Zeitraums von ungefähr 90 Tagen**, nicht die aktuelle Wallet-Balance. Gebühren der Zusatzfenster werden verbrannt. Pro freigegebener Mining-Identität wird **höchstens ein Ticket je Gesamtrunde** akzeptiert. Nach Abschluss bestimmt eine später überprüfbare Zufallsquelle den Gewinner.
 
-## Checks und Vorschau
+Die exakten Gebühren, Erfolgswahrscheinlichkeiten, Fensterlängen, Emissionsregeln und Coinparameter sind **noch nicht beschlossen**. Simulationen wie „Balanced + Low“ sind ausschließlich Forschungsmodelle. Details: [PoP-Fairness und Gebühren](docs/POP_FAIRNESS_UND_GEBUEHREN.md), [Protokollentwurf](docs/PROTOKOLL_ENTWURF.md) und [ADR 0003](docs/decisions/0003-pop-fenster-und-gebuehren.md).
+
+## Roadmap
+
+Die Statusangaben trennen **bereitgestellte Gerüste**, **offene Entscheidungen** und **noch nicht begonnene Funktionen**. Ein erfolgreiches `go test` für das Gerüst beweist keine funktionierende Blockchain.
+
+| Phase | Ziel | Status |
+|:--|:--|:--|
+| **M0 · Entwicklungsbasis** | Ubuntu-LXC, Go, Git, VS Code, Node-/Miner-/Wallet-Gerüste | 🟡 Gerüst vorhanden; Git-/Remote-Stand separat verifizieren |
+| **M1 · Protokoll und Ökonomie** | Coin-/Transaktionsregeln, PoP-Gebühren, Simulationen, Pi-4-Benchmark, ADRs | 🟡 In Planung und Forschung |
+| **M2 · Chain-Kern + echte Web-Wallet** | Konten, Signaturen, Transfers, persistenter State; Wallet lokal erstellen/importieren, senden/empfangen | ⬜ Offen |
+| **M3 · Konsensnetz** | CometBFT, zunächst 1, dann 4 Validatoren, Synchronisation und Ausfalltests | ⬜ Offen |
+| **M4 · Proof of Potato** | Registry, 3 Fenster, Gebühren/Burn, Tickets, überprüfbare Ziehung, Reward, Negativtests | ⬜ Offen |
+| **M5 · Bedienung & Hardware** | Wallet fertigstellen, Status/Explorer, Linux amd64/arm64, Raspberry-Pi-Benchmarks | ⬜ Offen |
+| **M6 · Privates Testnet** | Mehrhost-Betrieb, Recovery, Sicherheit, Dokumentation, Test-Releases | ⬜ Offen |
+| **F1 · Digitale Sammlerstücke** | Einzigartige/limitierte interne Gegenstände, Ownership, Sammlung in der Wallet | 💡 Zukunftsidee |
+| **F2 · PTM-Marktplatz** | Sammlerstücke in PTM anbieten, kaufen und zwischen Nutzern übertragen | 💡 Zukunftsidee |
+| **F3 · Interne Asset-Börse** | Fiktive, interne Assets in PTM handeln; Orderbuch, Kurse, Charts, Historie, Portfolio | 💡 Zukunftsidee |
+| **F4 · Börsenlabor** | Optional getrennter Paper-Trading-Modus, Indikatoren, Auswertungen und Szenarien | 💡 Zukunftsidee |
+
+**Die Zukunftsphasen F1–F4 beginnen ausdrücklich erst, wenn die Kern-Chain inklusive Wallet und privatem Testnet zuverlässig funktioniert.** Es gibt keinen beschlossenen Termin und keine Implementierungszusage. Die vollständige [Roadmap](docs/ROADMAP.md) und die [Zukunftsvision für das interne Ökosystem](docs/ZUKUNFT_OEKOSYSTEM.md) beschreiben die Abhängigkeiten und offenen Fragen.
+
+## Später: Was kann man mit PTM anfangen?
+
+Die Coin-Nutzung soll langfristig **über Mining-Gebühren hinausgehen**. Vorgesehen sind als mögliche spätere Erweiterungen digitale Kartoffel-Sammlerstücke und ein interner Marktplatz mit PTM als Zahlungsmittel. Danach könnte eine kleine **interne Handelsplattform** entstehen, auf der man fiktive Assets handeln und Kursentwicklungen, Orders, Handelsvolumen und Portfolios verfolgen kann, ohne dass PTM in Euro oder externe Kryptowährungen umtauschbar sein muss.
+
+Interne Marktpreise wären **PTM-Preise aus tatsächlich abgeschlossenen internen Trades**, keine behaupteten Euro-Werte. Ein möglicher Lern-/Paper-Trading-Modus wäre klar von echter interner PTM-Buchführung getrennt. Keine Sammlerstücke, Assets oder gekauften Funktionen sollen zusätzliche PoP-Lose oder unbegrenzte Mining-Vorteile verschaffen.
+
+## Repository und Entwicklung
+
+| Pfad | Zweck |
+|:--|:--|
+| `cmd/potatiumd`, `cmd/potatium-miner`, `cmd/potatium-cli` | Geplante Go-Programme, derzeit Gerüste |
+| `internal/` | Künftige App-, Ledger-, Mining- und Konsenslogik |
+| `web/wallet/` | Derzeit **statische UI-Vorschau**, keine funktionale Wallet |
+| `docs/` | Protokoll, Projektplan, Roadmap, Zukunftsvision und Entscheidungen |
+| `assets/logo/potatium-ptm-logo.png` | **Ausgewähltes unverändertes Projektlogo** |
+| `AGENTS.md` | Arbeitsregeln für Codex |
+
+Entwicklungsumgebung: unprivilegierter Ubuntu-26.04-LXC `potatium-dev`, Benutzer `potatium`, Repository unter `/home/potatium/src/potatium`, VS Code via Remote-SSH und Codex. Testserver ausschließlich auf `127.0.0.1`.
 
 ```bash
 cd /home/potatium/src/potatium
 bash scripts/doctor.sh
-make run-ui
+make run-ui   # Nur statische lokale Web-Wallet-Vorschau
 ```
 
-`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.
+Nicht mit echten Schlüsseln oder Guthaben experimentieren. `data/`, Seeds, Passwörter, Zugangsdaten und generierte Binaries gehören nicht in Git.
 
-**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`.
+**Nächster Schritt:** M1-Protokollparameter sauber festlegen und PoP-Simulation mit Raspberry-Pi-Messungen abgleichen, bevor konsenskritischer Code entsteht. [Projektplan](docs/PROJEKTPLAN.md) · [Gesamthandbuch](docs/GESAMTHANDBUCH.md) · [Codex-Startprompt](handoff/STARTPROMPT_VSCODE_CODEX.md).

docs/GESAMTHANDBUCH.md

@@ -87,3 +87,9 @@ Coin-Menge, Genesis-Verteilung, kleinste Einheit/Dezimalstellen, Belohnung, Halb
 ## 9. Nicht vorspiegeln
 
 Ein sauberes Go-Gerüst und eine HTML-Oberfläche sind **noch keine nutzbare Blockchain oder Wallet**. Der neue Gebührenentwurf ist **dokumentiert und simulationsbedürftig**, nicht implementiert.
+
+## 10. Langfristige PTM-Nutzung: Sammlerstücke und virtuelle Handelsplätze (Vision)
+
+Die im Oktober 2026 ergänzte Vision sieht **nach stabiler Kern-Chain und Web-Wallet** digitale Sammelobjekte (F1), einen in PTM abgewickelten internen Marktplatz (F2), eine Handelsoberfläche für fiktive interne Assets mit Orderbuch, Kursen, Charts und Portfolios (F3) und optional einen strikt getrennten Paper-Trading-Modus (F4) vor. Diese Szenarien sollen PTM einen internen Nutzwert geben. Sie begründen **keinen externen Euro-Kurs**, keine Börsenlistung und keine Anlage- oder Renditeaussage.
+
+Asset-Kauf, Sammelgegenstände oder Bestandshöhen dürfen die PoP-Lotterie nicht zusätzlich bevorteilen. Die technischen Details (Assetmodell, Emission, Marktdaten, atomare Trades, Ordermatching, Gebühren und Schutz gegen Wash Trading) sind absichtlich offen. Keine Funktionen sind implementiert. Maßgeblich: `docs/ZUKUNFT_OEKOSYSTEM.md`, `docs/ROADMAP.md` und ADR 0004. Die Arbeiten an M1–M6 behalten Vorrang.

docs/POP_LANGZEIT_SIMULATION.md

@@ -0,0 +1,45 @@
+# Potatium: Offline-Langzeitsimulation v0.1
+
+Diese Dateien sind eine **nicht konsenskritische Forschungs-Simulation** und aendern keine Blockchain-Funktionen.
+
+## Installation im bestehenden Repo
+
+Archiv so entpacken, dass `scripts/simulate_pop_longterm.py` und `tests/test_pop_longterm.py` neben den bisherigen Dateien liegen. Es werden keine bisherigen Dateien ersetzt.
+
+```bash
+cd /home/potatium/src/potatium
+python3 -m unittest discover -s tests -p 'test_pop_longterm.py' -v
+python3 scripts/simulate_pop_longterm.py --miners 20 --days 7 --rounds-per-day 72
+```
+
+## Aussagekraeftiger Vergleich
+
+Die Ergebnisse werden standardmaessig ausserhalb des Git-Repositorys unter `~/potatium-simulation/` abgelegt.
+
+```bash
+python3 scripts/simulate_pop_longterm.py --miners 20 --days 180 --profile original --strategy mixed --fee-model original
+python3 scripts/simulate_pop_longterm.py --miners 20 --days 180 --profile balanced --strategy mixed --fee-model mild
+python3 scripts/simulate_pop_longterm.py --miners 20 --days 180 --profile balanced --strategy mixed --fee-model low
+python3 scripts/simulate_pop_longterm.py --miners 50 --days 180 --profile balanced --strategy rational --fee-model mild
+```
+
+`original` = 70/70/70 Prozent je Fenster, `balanced` = 55/30/20 Prozent, `cautious` = 50/30/20 Prozent.
+
+Gebuehrenmodelle: `original` = v0.2 Staffel; `mild` = Staffel nur 10% so stark; `low` = Staffel nur 1% so stark. Fixkosten bleiben 0.001 PTM fuer Fenster 2 und 0.003 PTM fuer Fenster 3.
+
+Strategien: `free` = immer nur Fenster 1; `always` = Zusatzfenster nach Fehlschlag sofern bezahlbar; `rational` = einfache Kosten-Nutzen-Heuristik; `mixed` = ein Viertel `free`, Haelfte `rational`, ein Viertel `always`.
+
+## Daten zum Teilen
+
+`*.txt` enthaelt die Kernauswertung, `*.json` alle Simulationsdaten, `*_miners.csv` die individuellen Ergebnisse und `*_daily.csv` die Tagesentwicklung. Sende zunaechst die **TXT-Dateien**; fuer tiefergehende Auswertungen die JSON- oder CSV-Dateien.
+
+## Wesentliche Modellgrenzen
+
+- Ein registrierter Miner entspricht einer Identitaet; Sybil/Mehrgeraete ist nicht modelliert.
+- Die Rechenraetsel sind Bernoulli-Wuerfe mit vorgegebenen Erfolgswahrscheinlichkeiten, keine echten Hashbenchmarks.
+- Gleicher erwarteter Anteil pro Ticket; externe Zufallsbeacons und zensierende Validatoren fehlen.
+- PTM-Auszahlungen werden als Guthaben verbucht, Fenster-Gebuehren werden verbrannt; kein Handel, keine Ueberweisungen, keine Stromkosten.
+- Die 90-Tage-Basis ist **nur im Mining erworbener PTM-Ertrag** je registrierter Identitaet; Wallet-Transfer veraendert sie nicht.
+- Der Strategiealgorithmus nutzt nur eine Heuristik, keine optimale oder strategisch stabile Spieltheorie.
+- Float-Arithmetik **nur Simulation**, niemals On-chain.
+- Alle Tarife, Wahrscheinlichkeiten, 2-Minuten-Runde, Emission und Grenzwerte sind unverbindliche Forschungsannahmen.

docs/PROJEKTPLAN.md

@@ -51,3 +51,9 @@ Die **Schwelle, Nonce-Raum, Rundendauer, Fensterlängen, Gebührenhöhe, PTM-Emi
 5. **M5–M6:** Pi-/Office-PC-Builds, Web-Wallet vervollständigen, private Mehrhost-Tests, Doku/Release.
 
 Jeder Schritt: erst Akzeptanzkriterien, dann kleinste sinnvolle Implementierung, Tests inkl. `gofmt`, `go test ./...`, `go vet ./...`, kurze Dokumentation und Git-Review. Keinen Fortschritt erfinden.
+
+## Zukunftsperspektive nach dem privaten Testnet (neue Produktvision, kein aktueller Arbeitsauftrag)
+
+Erst **nach M6** dürfen wir getrennte Erweiterungsphasen erwägen: **F1 digitale Sammlerstücke**, **F2 interner PTM-Marktplatz**, **F3 Handelsplattform für fiktive interne Assets mit PTM-Orderbuch, Kursen und Portfolio**, optional **F4 separat gekennzeichnetes Paper-Trading/Börsenlabor**. Diese Phasen sollen PTM als geschlossene interne Währung einen zusätzlichen spielerischen Nutzwert geben, nicht einen angeblichen Fiat-Kurs oder einen Mining-Vorteil erzeugen. Keine implizite Echtgeld-Einlösung, Börsennotierung oder Renditeversprechen.
+
+**Verbindliche Projektgrenze:** Kein F1–F4-Code vor funktionierender Chain, sicherer Wallet und bestandenem Mehrhost-Testnet. Eigentum/Transaktionen müssen kryptografisch überprüfbar sein, Sammlerbesitz beeinflusst die PoP-Lotterie nicht. Für Asset-Minting, sichere Marktorders, Matching, Gebühren und Rechtliches sind vor Implementierung gesonderte Entscheidungen und ADRs nötig. Details in `docs/ZUKUNFT_OEKOSYSTEM.md` und `docs/decisions/0004-zukunftsvision-internes-oekosystem.md`.

docs/ROADMAP.md

@@ -1,4 +1,4 @@
-# Potatium-Roadmap: aktueller Plan v0.2 (25.10.2026)
+# Potatium-Roadmap: Kernphasen M0–M6 und Zukunftsvision (25.10.2026)
 
 **Status der Umsetzung:** Starter-Scaffold vorhanden, Blockchain/PoP/Web-Wallet noch **nicht** funktionsfähig. Lokale `doctor.sh`-Prüfung auf dem Benutzer-LXC wurde am 24.10.2026 berichtet; aktuelle Git-Commits und Änderungen aus Codex hier nicht einsehbar. Haken nur bei nachgewiesenen Ergebnissen setzen.
 
@@ -38,4 +38,15 @@
 - [ ] UX, Explorer/Status, Dokumentation, Linux amd64/arm64-Releases, Sicherung/Recovery.
 - [ ] Hosts über mehrere Geräte, Restart/Fault-Tests, Monitoring und Warnungen zur verbleibenden zentralen Registrierung.
 
+## F1–F4: Zukunftsvision, erst nach stabilem M6
+
+Die folgenden Erweiterungen sind **als spätere Produktideen aufgenommen**, aber weder terminiert noch implementiert. Sie verändern keine geltenden PoP-/Ledger-Regeln. Details und offene Entscheidungen: [`ZUKUNFT_OEKOSYSTEM.md`](ZUKUNFT_OEKOSYSTEM.md), [`ADR 0004`](decisions/0004-zukunftsvision-internes-oekosystem.md).
+
+- [ ] **F1 · Sammlerstücke:** Einzigartige/limitierte interne Kartoffel-Objekte, verifizierbares Eigentum, Ausstellungs- und Transferregeln, Wallet-Galerie. Keine Mining-Vorteile.
+- [ ] **F2 · PTM-Marktplatz:** Angebote/Käufe/Verkäufe digitaler Sammlerstücke in PTM, sichere atomare Abwicklung, Gebühren/History, Schutz vor manipulierten Angeboten.
+- [ ] **F3 · Interne Asset-Börse:** Handel fiktiver interner Assets gegen PTM mit Orderbuch, PTM-Kursen, Kursverläufen, Volumen und Portfolio; keinerlei Euro-/Krypto-Umtauschpflicht und keine erfundenen Marktdaten.
+- [ ] **F4 · Börsenlabor:** Optionales Paper-Trading mit klar getrennten Testbeständen und als Simulation gekennzeichneten Kursen.
+
+**Abhängigkeit:** erst funktionsfähige Chain, sichere Web-Wallet, PoP, Mehrhost-Testnet und verifizierte Transaktionssignaturen. Vor jedem F-Schritt: neues ADR, Datenmodell, Sicherheits-/Risikobewertung und eigene Akzeptanztests. Kein Börsenlisting, keine Wert-/Gewinngarantie.
+
 **Keine Implementierungs- oder Testergebnisse behaupten, die nicht tatsächlich ausgeführt wurden.**

docs/ZUKUNFT_OEKOSYSTEM.md

@@ -0,0 +1,77 @@
+# Potatium: Zukunftsvision für Sammlerstücke, Marktplatz und interne Börse
+
+**Stand:** 25.10.2026 · **Status:** akzeptierte langfristige Produktvision, **keine implementierte Funktion und keine festgelegten Protokollregeln**. Sie erweitert das Projektziel, verschiebt aber **keinen** der Meilensteine M1–M6. Vor einer Umsetzung eigene ADRs und Akzeptanzkriterien erstellen.
+
+## 1. Warum PTM überhaupt verdienen?
+
+Eine reine Mining-Lotterie, deren Coins ausschließlich für weitere Mining-Fenster verwendet werden können, bietet zu wenig eigenständigen Nutzen. Langfristig soll PTM als **interne Währung** für digitale, von der Community verwendbare Gegenstände und Dienste dienen. PTM bleibt zunächst ein geschlossener, nicht gegen Euro oder externe Kryptowährungen einlösbarer Hobby-/Testnet-Coin ohne Wert- oder Renditeversprechen.
+
+Erzeugung durch PoP, Transfer zwischen Wallets und spätere Ausgaben/Handel mit Sammlerstücken bilden zusammen ein denkbares Ökosystem. Ein interner Markt schafft **nicht automatisch** einen externen Geldwert, Preisstabilität oder wirtschaftlichen Anreiz für alle.
+
+## 2. Stufen und bewusst harte Voraussetzungen
+
+### F1: Digitale Sammlerstücke
+
+**Start erst nach M6: stabile Chain, funktionale Web-Wallet, geprüftes Signatur- und Gebührenformat, robustes Mehrhost-Testnet.**
+
+- Digitale Kartoffel-Objekte, Trophäen, Serien oder rein kosmetische Profilabzeichen, die einem Chain-Konto zugeordnet sind.
+- Klare Definition: Unikat oder limitierte Edition, Herausgeber, Gesamtmenge, Metadaten/Version, Transferierbarkeit, gegebenenfalls Burn.
+- Anzeige von Eigentum und Historie in der Web-Wallet; keine bloßen Datenbank-Behauptungen bei fehlender Chain-Verbindung.
+- **Keine** Vorteile beim PoP-Mining durch Besitz, Seltenheit oder Kaufpreis eines Gegenstands.
+- Vorab zu entscheiden: Darstellung von Bildern und Metadaten (on-chain vs. gehashte externe Inhalte), unveränderliche Referenzen, Moderation, Rechte und Speicherlimits.
+
+**Noch nicht beschlossen:** eigenständiger Token-/NFT-Standard, Asset-Datenmodell, Ausgabe-/Mintrechte, Metadatenlagerung und Gebühren.
+
+### F2: Geschlossener PTM-Marktplatz
+
+- Nutzer können freigegebene Sammlerstücke zu einem **in PTM ausgewiesenen** Preis anbieten und innerhalb des privaten Netzwerks kaufen/verkaufen.
+- Käufer erhält den Gegenstand und Verkäufer PTM **atomar oder gleichwertig manipulationssicher**. Keine Zahlung ohne Eigentumsübertragung.
+- Order-/Angebotslebenszyklus: Anlegen, Gültigkeitsdauer, Ändern/Abbrechen, Reservierung, Abschluss, Gebühren, Historie und nachvollziehbare Fehlschläge.
+- Wallet unterschreibt Transaktionen lokal; Backend, Miner und Marktplatz dürfen keine Seeds oder Private Keys erhalten.
+- Erst bei belastbarem Modell entscheiden, ob Angebote direkt on-chain liegen oder ein Off-chain-Index/Matcher auf **verifizierbarem On-chain-Settlement** aufbaut.
+- Schutz vor Replay, Double-Spend, unautorisiertem Minting, Self-Trading/Wash-Trading und gefälschten Besitznachweisen; ggf. Regeln für nicht transferierbare Sammlerstücke.
+
+**Noch nicht beschlossen:** Handelsgebühren, Ordermatching, Listingrechte, Asset-Standards, Gebührenverwendung sowie off-chain/on-chain Datenarchitektur.
+
+### F3: Interne Börsenoberfläche für spielerische Assets
+
+Nutzeridee: Eine Oberfläche mit **Anlage-/Trading-Gefühl wie eine Börse**, aber innerhalb des geschlossenen Potatium-Systems. Beispielsweise können verschiedene intern definierte fiktive Asset-Klassen oder Editionen in PTM notiert und gehandelt werden.
+
+- Beobachtung: **Kurse in PTM**, Charts/Verlauf, Orderbuch, Bid/Ask, abgeschlossene Trades, Volumen, Portfolio, realisierte/unrealisierte Veränderungen.
+- Handel von echten *internen* Assets nur, wenn Besitz, Emission, Limits, Ordermatching und Settlement sicher definiert sind.
+- **Kein** implizites Versprechen: Assets sind keine Aktien, keine Ansprüche auf reale Unternehmen, keine Rendite oder Auszahlung in Euro.
+- Marktdaten nur aus nachvollziehbaren Handelsereignissen. Ohne Trades keine erfundenen Kurse, Volumina oder OHLC-Kerzen. Markiere fehlende Liquidität, letzte Ausführung und illiquide Spreads deutlich.
+- Gegen künstliches Handelsvolumen, Preismanipulation, Eigenhandel und irreführende historische Kursreihen sind erst Regeln und Tests zu entwickeln.
+- Vorab entscheiden: Fungibilität/Teilmengen, limitierte Emission, Mint-/Burnrechte, Preis-/Mengenbasiswerte (Integer on-chain), Matching (Preis-/Zeitpriorität oder anderes Verfahren), Stornos, Marktpausen, Gebühren und Audit.
+
+### F4: Optionales Börsenlabor (Paper Trading)
+
+- **Streng separat** von realen internen PTM-Guthaben, Sammlerstücken und dem Konsenszustand.
+- Simulierte Orders, Übungsportfolios, Risiko-/Performance-Auswertung, Lerncharts und hypothetische Kursbewegungen.
+- Künstliche Daten und simulated P&L **überall explizit als Simulation kennzeichnen**. Keine Vermischung mit realen internen Handelsvolumina oder Wallet-Salden.
+- Eine mögliche spätere Börsenoberfläche kann sowohl interne PTM-Assets als auch das klar getrennte Lernlabor anbieten.
+
+## 3. Schnittstellen und Grenzen
+
+- Die Markt-/Sammlerwelt ist **nachgelagert**. Keine vorgezogene Änderung am Validator-Konsens oder an PoP-Gebühren.
+- Ein Sammlerstück, ein Profil oder das Halten von Assets darf **keine** zusätzlichen PoP-Lose erzeugen. Die drei Mining-Fenster bleiben unabhängig von Sammlerbesitz.
+- Fortschritt in einer Sammlerwelt ersetzt **nicht** die identitätsgebundene 90-Tage-Gebührenbemessung für Zusatzfenster.
+- Web-Wallet ist das gemeinsame Nutzerfrontend. Eine Börsenansicht ist später ein zusätzlicher Bereich, nicht die Voraussetzung für ein funktionales Wallet-MVP.
+- Separate Berechtigung zum Asset-Erstellen; keine beliebige Coin-Inflation oder versteckte Emission durch Marktaktionen.
+- Jeder neue Assettyp, jede Börsenlogik und jede neue Transaktionsart benötigt ein ADR sowie Negativ-/Sicherheitstests.
+
+## 4. Offene Produkt- und Regulierungsfragen
+
+1. Was kann jeder selbst erstellen und was wird kuratiert/limitiert?
+2. Welche digitale Nützlichkeit bietet ein Sammlerstück, **ohne Pay-to-Win** zu werden?
+3. Wo liegen Bilder und Metadaten, und wie bleiben sie langfristig abrufbar?
+4. Werden Preise ausschließlich durch Nutzerorders gebildet, und wie zeigen wir Märkte ohne Liquidität korrekt?
+5. Wie verhindern wir Missbrauch durch mehrere Identitäten, Wash Trades und manipulierte Rankings?
+6. Welche Marktgebühren fließen an Validatoren, werden verbrannt oder bleiben beim Anbieter? **Noch offen.**
+7. Welche rechtlichen Anforderungen entstehen, wenn PTM oder interne Assets doch einen realen Gegenwert bekommen? Vor solchen Änderungen gesonderte Prüfung, keinerlei Listungs-, Wert- oder Renditeversprechen.
+
+## 5. Abnahmekriterien für eine spätere Freigabe
+
+**F1:** Erzeugung, Einzigartigkeit, Besitznachweis, Transfer und Recovery mit deterministischen Tests. **F2:** atomare Zuordnung von Asset und PTM samt Manipulations-/Replay-Tests. **F3:** nachprüfbare Preise, Orders, Matching, Portfolio-Berechnungen und ehrliche Anzeigen ohne Trades. **F4:** technisch und optisch eindeutige Trennung von Simulation und echtem internem Ledger.
+
+**Keine dieser Phasen ist begonnen.** Über die Reihenfolge nach M6 wird neu entschieden, sobald die technische und wirtschaftliche Basis dafür tragfähig ist.

docs/decisions/0004-zukunftsvision-internes-oekosystem.md

@@ -0,0 +1,38 @@
+# ADR 0004: PTM-Sammlerstücke, interner Marktplatz und Börsenlabor als Zukunftsvision
+
+**Status:** Accepted als **Produktvision**; technische Architektur, Tokenomics und Implementierung **nicht entschieden**.  
+**Datum:** 25.10.2026  
+**Gültigkeit:** Erweiterung nach M6, keine Änderung an bestehenden M1–M6-Entscheidungen und ADR 0003.
+
+## Kontext
+
+Eine Hobby-Blockchain, deren Coin lediglich für neue Mining-Chancen verwendet wird, hat wenig eigenständigen internen Nutzen. Der Nutzer möchte daher **später** digitale Sammlerstücke, einen PTM-Marktplatz und eventuell eine an eine Börse angelehnte interne Handelsplattform mit Assets, Kursen und Kursentwicklungen. Potatium bleibt vorerst ein geschlossenes Hobby-/Testnet ohne vorausgesetzte Tauschbarkeit gegen externe Kryptowährungen oder Geld.
+
+## Entscheidung (ausschließlich Produktziel)
+
+1. **F1:** Sammlerstücke als eigene überprüfbare interne digitale Objekte mit Ownership, Editionen und Wallet-Anzeige untersuchen.
+2. **F2:** Späterer geschlossener Marktplatz zum Anbieten, Kaufen und Tauschen dieser Gegenstände in PTM; atomare, sichere Abwicklung anstreben.
+3. **F3:** Interne fiktive Assets zu PTM-Preisen handelbar machen; Kurse, Orderbuch, Charts, Trades, Portfolio und Volumen transparent aus tatsächlichen internen Geschäften ableiten.
+4. **F4 optional:** Ein separater Paper-Trading-/Lernmodus kann künstliche Orders und Assets simulieren, darf aber nie als echte PTM-Chain-Transaktion erscheinen.
+5. Kein Sammelobjekt, kein Kauf und kein Assetbesitz erzeugt ein zusätzliches PoP-Ticket oder erhöht die Mining-Qualifikationschance.
+6. **Nur langfristige Roadmap:** keine Umsetzung vor robuster Chain, richtiger Wallet, PoP und privatem Mehrhost-Testnet. Für jede Folgephase neues ADR mit Security, Emission und Gebührenentscheidungen.
+
+## Alternativen
+
+- PTM ausschließlich fürs Mining verwenden: zu wenig unabhängiger Nutzwert.
+- Externe Krypto-/Fiat-Börsenintegration: nicht Bestandteil der jetzigen Hobby-Ziele, deutlich höhere regulatorische und sicherheitstechnische Anforderungen.
+- Sofort einen NFT-/DEX-Stack einbauen: erhöht Architektur-, Sicherheits- und Wartungslast vor funktionierendem Basisprotokoll.
+- Künstliche Kurse ohne echte Trades als reale Märkte ausgeben: irreführend und ausgeschlossen; eine ausdrücklich als Simulation deklarierte Übung ist möglich.
+
+## Konsequenzen und noch offene Entscheidungen
+
+- Eine mögliche Asset-/Marktschicht baut **später** auf denselben sicheren Account-/Transaktionsprinzipien auf, ersetzt sie nicht.
+- Ownership, limitierte Emission, Daten-/Bilderhaltung, Name/Ticker, Indexierung, atomare Transfers, Matching, Gebühren, illiquide Märkte und Missbrauchsschutz sind **offen**.
+- Ein intern vereinbarter PTM-Preis schafft **keinen garantierten externen Geldwert**. Vor jeder realwertbezogenen/öffentlichen Nutzung müssen Rechte, Steuern, Finanz-/Glücksspielrecht und Betreiberpflichten erneut geprüft werden.
+- Das Logo `assets/logo/potatium-ptm-logo.png` wird unverändert weiterverwendet.
+
+## Referenzen
+
+- `docs/ZUKUNFT_OEKOSYSTEM.md`
+- `docs/ROADMAP.md`
+- `docs/decisions/0003-pop-fenster-und-gebuehren.md`

handoff/REPO_UPDATE_V03.md

@@ -0,0 +1,18 @@
+# Repo-Update v0.3: README-Roadmap und langfristiges PTM-Ökosystem
+
+Aktualisiert die Dokumentation von v0.2, ohne Go-Code, Mining, Wallet-Vorschau oder Logo auszutauschen. Gilt als Ergänzung zur bestehenden PoP-v0.2-Spezifikation.
+
+## Inhalt
+
+- `README.md`: zentriertes **originales** Logo als relativer Repo-Pfad, Git-/Gitea-freundliche öffentliche Projektübersicht, Roadmap M0–M6/F1–F4 und realistischer Status.
+- `docs/ZUKUNFT_OEKOSYSTEM.md`: neue Produktvision mit F1 Sammlerstücken, F2 internem PTM-Marktplatz, F3 börsenartigem Handel fiktiver Assets und F4 optionalem Paper Trading.
+- `docs/decisions/0004-zukunftsvision-internes-oekosystem.md`: akzeptierte Vision, aber keine konkrete Asset-/Börsenimplementierung.
+- `docs/ROADMAP.md`, `docs/PROJEKTPLAN.md`, `docs/GESAMTHANDBUCH.md`: Abhängigkeiten und Zukunftsstufen aufgenommen.
+- `AGENTS.md` und `handoff/STARTPROMPT_VSCODE_CODEX.md`: Codex soll Zukunftsfunktionen **nicht** vorziehen.
+
+## Sicherheitsregeln
+
+- Kein bestehender Quellcode geändert, keine Dateien gelöscht, Logo-Bilddatei bleibt unverändert.
+- Update-Skript zeigt im Standardfall eine Vorschau. Nur `--apply` schreibt, nach Check der erwarteten v0.2-Hashes und Backup.
+- Geänderte oder konkurrierende Repo-Dateien brechen vor Änderung mit `CONFLICT` ab: manuell zusammenführen.
+- Das echte private Gitea-Remote und aktuelle Codex-Commits sind nicht Teil des hier verfügbaren Referenz-Repositories. Ein lokaler Commit/Push ist deshalb Nutzeraufgabe.

handoff/STARTPROMPT_VSCODE_CODEX.md

@@ -27,3 +27,7 @@ Du bist technischer Architekt, leitender Go-Entwickler und Reviewer für **Potat
 6. Schließe mit: geänderte Dateien, echte Tests und Resultate, offene Sicherheits-/Rechtsrisiken, drei konkrete nächste Entscheidungen. Keine Phase als fertig erklären, wenn nur ein Mock existiert.
 
 ---
+
+## Spätere Vision, vorerst ausdrücklich NICHT implementieren
+
+Nach stabilen M1–M6-Meilensteinen sind digitale Sammlerstücke, ein PTM-Marktplatz und eine interne Handelsplattform für fiktive Assets/Kurse/Portfolio sowie optional getrenntes Paper-Trading vorgesehen. Details: `docs/ZUKUNFT_OEKOSYSTEM.md` und ADR 0004. **Kein** Asset-/Börsen-/NFT-Code jetzt, keine neuen Dependencies deswegen und keine Veränderung beschlossener PoP-Regeln. Im aktuellen Schritt bei M1 und anschließend Ledger/Web-Wallet bleiben.