# Zielbauplan Phase 1–8 — aktueller Umsetzungsstand

Stand: 2026-06-29

Dieser Status bezieht sich auf den Zielbauplan aus `docs/260629_bot_umsetzungsplan_extracted.md`, Abschnitt 13.

## Kurzfazit

```text
Technische Basis: ca. 45–55% des Zielbauplans
Live-Freigabe: 0%
Aktiver Modus: paper_only
```

Wir haben Phase 5 vorgezogen, weil der Plan selbst den echten Paper-Lifecycle als aktuelle Priorität 1 nennt. Das war korrekt: die alte synthetische v76-Paper-PnL ist nicht live-tauglich; echte Lifecycle-PnL ist aktuell noch negativ.

## Phase 1 — Repo und Runtime konsolidieren

Status: abgeschlossen v1.

Erledigt:

- Zielplan-DOCX gespeichert und extrahiert.
- Execution Notes erstellt.
- README mit Modi, Startbefehlen und Live-Invarianten erstellt.
- Runtime Runbook mit aktiven Cronjobs, manuellen Checks und Legacy-Regeln erstellt.
- Runtime-Architekturdiagramm/-Dokument erstellt: `docs/architecture_runtime.md`.
- `AutoTrader.py` mit Legacy-Disabled-Warnhinweis versehen.
- `src/`-Architektur als einzige Live-Zielbasis dokumentiert.

Abschlusskriterium:

- Repo/Runtime v1 ist dokumentiert, Legacy-Pfade sind abgegrenzt, Start-/Report-/Testbefehle sind zentral dokumentiert, und GitHub-Sync erfolgt über Commit/Push pro Änderung.

## Phase 2 — Market Snapshot Layer

Status: abgeschlossen v1.

Erledigt:

- HyperLiquid read-only Market Context vorhanden.
- Candles/RSI/SMA/ATR/L2-Spread teilweise verfügbar.
- Market Confluence Light Snapshot gebaut.
- Latest Market Confluence Snapshot wird als paper-only Gate in v76 strict genutzt.
- `market_snapshot.v1` mit `price`, `ohlcv`, `trend`, `momentum`, `volatility`, `liquidity`, `derivatives`, `fundamentals`, `sentiment`, `regime`, `risk`, `confluence` gebaut.
- HyperLiquid `metaAndAssetCtxs` liefert Funding, Premium, Open Interest, Mark/Oracle/Prev-Day/Day-Notional-Volume in den Snapshot.
- Liquidity Score nutzt jetzt Day-Notional-Volume statt Base-Candle-Volume, wenn verfügbar.
- CoinGecko Fundamentals Adapter liefert `market_cap_usd`, `fdv_usd`, `total_volume_usd`, `market_cap_rank`, 24h/7d Change und Supply-Felder in `market_snapshot.v1`.
- L2 Depth/Impact-Slippage liefert Top-5 Bid/Ask-Notional und 1k/5k Buy/Sell Impact in den Snapshot; Liquidity Score und v76 Paper-Kosten nutzen den 1k-Impact als Depth-Penalty.
- TradingView Community Ideas / Track Record wird als `research_only` Sentiment-Kontext in den Snapshot gespiegelt, ohne Live-Autorität.

Abschlusskriterium:

- Market Snapshot v1 enthält alle Zielbauplan-Hauptbereiche (`price`, `ohlcv`, `trend`, `momentum`, `volatility`, `liquidity`, `derivatives`, `fundamentals`, `sentiment`, `regime`, `risk`, `confluence`). Weitere Qualitätsverbesserungen sind Erweiterungen, nicht Blocker für Phase-2-v1.

## Phase 3 — Confluence Score Engine

Status: abgeschlossen v1.

Erledigt:

- `trend_score`
- `momentum_score`
- `volatility_score`
- `liquidity_score`
- `derivatives_score`
- `sentiment_score` als explizit neutraler Platzhalter bis externe Quelle verdrahtet ist.
- `portfolio_score` als explizit neutraler Platzhalter bis Portfolio-Kontext verdrahtet ist.
- `risk_score`
- `regime_score`
- `final_trade_score` / `final_score` Kompatibilitätsalias.
- Versionierte Gewichtungen: `confluence_score.v1`.
- `recommendation`
- `blockers`
- Paper-only v76 strict Entry-Gate anhand `market_confluence_latest.json`.
- Normalisiertes Snapshot-v1-Schema als stabile Grundlage für Score-Versionierung.

Abschlusskriterium:

- Confluence Engine v1 ist vollständig verdrahtet und paper-only wirksam. Erweiterungen wie OI-Delta, echte Sentiment-Feeds und Portfolio-Kontext sind Phase-2/7/8-Erweiterungen, nicht Blocker für Phase-3-v1.

## Phase 4 — Entry-Verbesserung

Status: abgeschlossen v1.

Erledigt:

- `strict_anti_chase`
- `anti_chase_overextended_no_retest`
- `anti_chase_no_retest_reclaim`
- `anti_chase_buying_above_local_high`
- `anti_chase_spread_too_wide`
- `anti_chase_crowded_positive_funding`
- `anti_chase_vwap_distance_too_high`
- `anti_chase_atr_pump`
- `anti_chase_upper_wick_rejection`
- `anti_chase_exhaustion_candle`
- `anti_chase_oi_funding_crowded`
- `anti_chase_premium_too_high`
- Anti-Chase Impact Report.

Abschlusskriterium:

- Entry-Verbesserung v1 blockiert klare Chase-/Pump-/Wick-/Crowding-Setups im v76 strict Paper-Pfad. Weitere Verfeinerungen brauchen längere Paper-Samples und echte candlebasierte VWAP/OI-Historie.

## Phase 5 — Echter Paper Lifecycle

Status: geschlossen v1, aber noch nicht live-ready.

Erledigt:

- Entry / Fill Simulation.
- Partial fills über Fill-Notional-Cap.
- Maker/Taker-Gebührenklassifikation.
- Stop-Loss.
- Take-Profit.
- Trailing Stop.
- Stop-Gap-Slippage.
- Time Exit.
- Fees.
- Depth-aware Slippage.
- Funding.
- MFE / MAE.
- Lifecycle-PnL.
- Lifecycle Scorecard.
- Promotion Gates auf true lifecycle exits only.

Noch offen:

- Grössere echte Paper-Lifecycle-Stichprobe nach neuen Entry-/Confluence-Filtern.
- Post-trade reconciliation tiefer.
- Realistischere Fill-Queue-/Orderbook-Modellierung über längere Runs.

Aktueller Befund:

```text
true lifecycle PnL negativ
winrate < 50%
profit factor < 1
live=nein
```

## Phase 6 — Drei Strategie-Sleeves

Status: abgeschlossen v1.

Erledigt:

- Intraday Sleeve: `intraday_v76_strict` / `candidate_v76_strict_live_candidate`.
- Swing Sleeve: `swing_trend_retest` / `candidate_swing_trend_retest_research` als research-only Platzhalter.
- Portfolio Sleeve: `portfolio_holding_advisor` / `candidate_portfolio_holding_advisor` als advisor-only Platzhalter.
- Read-only `strategy_sleeves.v1` Scorecard mit getrennten Statuswerten `Blocked`, `Research`, `Advisor`.
- Daily Report enthält jetzt die Sleeve-Scorecard.
- Alle Sleeves haben `live_order_allowed=false` und `mainnet_signed_action=false`.

Noch offen:

- Swing trend/retest strategy tatsächlich implementieren und paper-only journalen.
- Portfolio holding/rebalancing advisor mit Portfolio-Kontext verbinden.
- Separate echte Evidenz pro Sleeve sammeln.

Abschlusskriterium:

- Phase 6 v1 trennt die drei Ziel-Sleeves sauber und verhindert, dass Intraday-v76-Evidenz versehentlich für Swing/Portfolio-Live-Readiness verwendet wird.

## Phase 7 — Copytrading Research

Status: abgeschlossen v1, research-only.

Erledigt/vorhanden:

- `ctb_copy` Runtime-Struktur ausserhalb Git unter `~/.local/state/CryptoTradingBot/copy_research`.
- Runtime Watchlist für Wallets/Vaults.
- Vault/Wallet Snapshot-Collectors read-only.
- Discovery Registry gegen Survivorship Bias.
- Leader Scorecard mit Research/Candidate/Blocked/Live-Preview-Ready Statuslogik.
- Follower Fill Model mit Gebühren/Spread/Slippage/Funding/Delay-Penalty.
- Read-only Shadow-Copy Position Engine.
- Shadow Portfolio/Journale ohne Execution.
- Copy Daily Report v1.1.
- `copytrading_research.v1` Scorecard im HyperLiquid Daily Report.
- TradingView Community Ideas research-only.
- Community Track Record vorbereitet.

Noch offen:

- Echte 7d+ Watchlist-Beobachtung mit mehreren Wallets/Vaults.
- Genügend Shadow-Position-Deltas und Leader-Samples sammeln.
- Leader-Scorecards mit realen persistenten Beobachtungen füllen.
- Keine Live-Copy bis explizite spätere Freigabe und eigene Copy-Preflight-Gates grün sind.

Abschlusskriterium:

- Phase 7 v1 kann Wallet/Vault-Leader read-only beobachten, hypothetische Shadow-Copy-Entscheidungen modellieren und Leader getrennt scoren, ohne Copy-Permission, Vault-Deposit, Wallet-Execution oder Signing zu erlauben.

## Phase 8 — Portfolio Advisor

Status: noch nicht umgesetzt.

Erledigt:

- Architekturentscheidung: Advisor gibt Empfehlungen, keine Auto-Ausführung.

Noch offen:

- Jarvis Finance Dashboard lesen.
- Aktien/ETF/Crypto-Allokation auswerten.
- Kaufen/Halten/Verkaufen-Empfehlungen.
- Rebalancing-Vorschläge.
- Risiko-/Konzentrationswarnungen.

## Live-Invarianten

```text
live_order_allowed=false
mainnet_signed_action=false
No order without exchange-level stop
No order on reconcile uncertainty
No order during API degraded state
No martingale
No averaging down
No risk increase without explicit approval
```