docs: add PTM ecosystem vision and README roadmap

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`