# Anforderungsdokument v0.1
## JARVIS Finance System – Architektur & Scripts

**Version:** 0.1  
**Status:** Konzept / Requirements Draft  
**Datum:** 2026-05-14  
**Scope:** Technische Architektur, Datenmodell, Dashboard, Reporting, Automationen und Entscheidungsunterstützung  
**Nicht-Ziel:** Keine Anlageberatung, keine Steuerberatung, kein automatisiertes Trading

---

## 1. Zielbild

Das System soll ein robustes, nachvollziehbares und regelbasiertes Finanzmanagement- und Decision-Support-System für Aktien, ETFs, Crypto, Cash und spätere weitere Vermögenswerte werden.

Es soll nicht nur ein Portfolio-Viewer sein, sondern ein **Investment Command Center** mit vollständiger Transaktionshistorie, Total-Return-Berechnung, Risikoanalyse, Watchlist-Pipeline, Rebalancing-Workflow, Reports, Decision Journal, Bias Detection, Macro Overlay und menschlicher Entscheidungshoheit.

### 1.1 Leitprinzipien

- **Human Decision Authority:** Das System schlägt vor, Sir entscheidet.
- **No Automated Trading:** Keine Orderausführung, keine Broker-API-Trades, keine autonomen Umschichtungen.
- **Rule-based First:** Scores, Alerts, Rebalancing und Reports laufen deterministisch über Regeln, nicht über LLM-Raten.
- **Minimal LLM:** LLM nur optional für News-Zusammenfassungen, Report-Formulierungen, Bear-Case-Synthese oder PDF-/Text-Extraktion; niemals für Accounting, Steuerwerte oder finale Empfehlungen.
- **Explainability:** Jeder Score, jede Empfehlung und jeder Alert braucht Quelle, Zeitstempel, Regelversion und Evidence.
- **Data Ownership:** Alle Daten bleiben exportierbar: CSV, JSON, Markdown/HTML/PDF.
- **Privacy by Design:** Finanzdaten werden nicht unnötig an externe Dienste oder LLMs gegeben.
- **Action Prep statt Action Execution:** Das System darf Orders vorbereiten, aber nie ausführen.

---

## 2. Rollen des Systems

Das System trennt strikt fünf fachliche Rollen:

1. **Monitoring – Was passiert?**
   - Kurse, Portfolio-Wert, Bewegungen, Alerts, News, Datenfehler.
2. **Analyse – Warum passiert es?**
   - Score-Komponenten, Risikoquellen, Makro-Kontext, Exposure, News-/Analysten-Evidence.
3. **Empfehlung – Was wäre sinnvoll?**
   - Halten, Erhöhen, Reduzieren, Verkaufen, Umschichten, Watchlist-Kandidat prüfen.
4. **Entscheidung – Was mache ich?**
   - Menschliche Entscheidung mit Freigabe, Ablehnung, Override oder Deferred-Status.
5. **Dokumentation – Warum habe ich es gemacht?**
   - Decision Journal, Quellen, Investment Case, Risiken, Exit-Regeln, spätere Auswertung.

---

## 3. Referenzsysteme und übernommene Ideen

Geprüfte Referenzen:

- **Ghostfolio:** Open-Source-Portfolio-Tracking, Net-Worth-Ansatz, Allokationen, Privacy/Self-hosting, Watchlist, Dividenden, Fear & Greed / Market Mood.
- **Portfolio Performance:** Transaktionsbasierte Desktop-App, Cash/Depot-Konten, Gebühren/Steuern, Performance-Kennzahlen wie TTWROR und IRR, CSV/XML/JSON, historische Kurse.
- **Sharesight:** Broker-Imports, Dividenden, Steuerreports, Performance inklusive Währungen und Ausschüttungen.
- **Kubera:** Ganzheitliches Vermögensbild, Multi-Asset, Cash, Immobilien, Private Assets, Sharing/Advisor-Zugriff.
- **getquin:** Mobile/Web-Portfolio, Community/Analyse, Asset- und Broker-Aggregation.
- **Delta:** Mobile Portfolio Tracker, Watchlists, Alerts, Multi-Asset, Price Alerts, Markt-Events.

### 3.1 Gute Ideen zum Übernehmen

- Transaktionshistorie als Kernmodell, nicht Momentaufnahme.
- Multi-Account-/Multi-Depot-/Multi-Wallet-Tracking.
- Dividenden, Ausschüttungen, Gebühren und Steuern als First-Class-Daten.
- TTWROR, IRR, Total Return, realisierte/unrealisierte Gewinne.
- Import/Export über CSV/JSON/PDF/Statements.
- Watchlist, Alerts und mobile Schnellansicht.
- Risiko-, Allokations- und Benchmark-Ansichten.
- Datenschutz, Self-hosting-Option, vollständiger Datenexport.

### 3.2 Lücken, die unser System besser machen soll

- Keine Blackbox-Scores ohne Quellen.
- Keine reinen Viewer ohne Entscheidungsworkflow.
- Keine Scheingenauigkeit bei fehlenden Daten.
- Kein Daten-Lock-in.
- Stärkerer Fokus auf Macro Overlay, Bias Detection, Bear Case, Liquidity Ladder und Decision Journal.
- Schweizer Steuer-/Jahresabschluss-Sicht als eigene Perspektive.

---

## 4. Scope

### 4.1 In Scope

- Manuelle und importierte Transaktionen.
- Aktien, ETFs, Crypto, Cash; später weitere Assets.
- Live-/Near-live-Kursdaten über APIs, aber keine direkte Broker-Portfolio-Anbindung im MVP.
- Dashboard mit manueller Eingabe, Watchlist, Reports und Risk Views.
- PDF-/HTML-/Markdown-Reports per Knopfdruck.
- Regelbasierte Scoring- und Empfehlungssysteme.
- Schweizer Steuer-/Income-Übersicht soweit sinnvoll und ohne Steuerberatungsanspruch.
- Telegram-/Dashboard-Alerts mit Prioritäten.

### 4.2 Out of Scope

- Automatisierter Handel.
- Garantierte Investmentrendite.
- Rechtlich verbindliche Steuerberatung.
- Vollständige globale Corporate-Action-Automatisierung im MVP.
- Daytrading-Optimierung.

---

## 5. Zielarchitektur

### 5.1 Komponenten

1. **Input Layer**
   - Dashboard Forms
   - CSV Import
   - Broker-/Bank-Export-Parser später
   - Market Data APIs
   - News-/Analysten-APIs
   - Crypto APIs
   - Macro APIs

2. **Staging & Validation Layer**
   - Import Preview
   - Field Mapping
   - Duplicate Detection
   - Data Quality Checks
   - Quarantine Queue

3. **Core Ledger**
   - Transaction Ledger
   - Cash Ledger
   - Position Ledger
   - Tax Lots
   - FX Ledger
   - Corporate Actions

4. **Market Data Store**
   - Preise
   - FX Rates
   - Benchmarks
   - Fundamentals
   - Analystenratings
   - News/Sentiment
   - Macro Indicators

5. **Analytics & Rule Engine**
   - Performance
   - Total Return
   - Risk
   - Macro Regime
   - Stress Tests
   - Rebalancing
   - Watchlist Scoring
   - Bias Detection
   - Alerts

6. **Recommendation Layer**
   - Buy/Hold/Reduce/Sell/Watch
   - Confidence
   - Evidence
   - Bear Case
   - Action Prep

7. **Reporting Layer**
   - Tagesreport
   - Wochenreport
   - Monatsreport
   - Positionsreport
   - Watchlist-Report
   - Income-/Tax-Report
   - PDF/HTML/Markdown/CSV/JSON

8. **Dashboard / UI**
   - Investment Command Center
   - Desktop first
   - Mobile readable / quick actions
   - Dynamic Sidebar
   - Risk Heatmap
   - Report Export Button

9. **Automation Layer**
   - Cronjobs
   - scheduled data refresh
   - alert delivery
   - report generation
   - backup/export

---

## 6. Kern-Datenmodell v0.1

### 6.1 Account / Depot / Wallet

Pflichtfelder:

- account_id
- Name
- Institution / Broker / Bank / Wallet
- Typ: Depot, Bankkonto, Crypto Wallet, Exchange, Cash Reserve, Health Reserve
- Basiswährung
- Land
- aktiv/inaktiv
- Performance-relevant: ja/nein
- Notizen

### 6.2 Instrument

Pflichtfelder:

- instrument_id
- Name
- Ticker / Symbol
- ISIN / WKN / Coin-ID, falls verfügbar
- Assetklasse: Aktie, ETF, Crypto, Cash, Bond, Commodity, Other
- Währung
- Exchange
- Land
- Sektor
- Industrie
- ETF-Underlying / Index, falls ETF
- Crypto Chain / Token Type, falls Crypto
- Datenquellen-Mapping

### 6.3 Transaction Ledger

Das System speichert jede Bewegung als Transaktion. Positionen sind abgeleitete Werte.

Pflichttypen:

- Kauf
- Teilverkauf
- Verkauf
- Dividende
- Ausschüttung
- Zins
- Gebühr
- Steuer
- Quellensteuer
- Steuererstattung
- Cash-Einzahlung
- Cash-Auszahlung
- Währungswechsel
- Transfer In
- Transfer Out
- Crypto Transfer
- Staking Reward
- Airdrop
- Split / Reverse Split
- Spin-off
- Merger
- manuelle Korrektur

Pflichtfelder:

- transaction_id
- transaction_type
- trade_date
- settlement_date
- account_id
- instrument_id optional bei Cash
- quantity
- price
- gross_amount
- fees
- taxes
- net_amount
- currency
- fx_rate_to_base
- source
- source_timestamp
- import_batch_id
- manual_entry_flag
- decision_id optional
- notes

### 6.4 Position

Abgeleitet aus Transactions:

- quantity
- average_cost
- tax_lots
- cost_basis
- market_value
- unrealized_gain_loss
- realized_gain_loss
- income_total
- fees_total
- taxes_total
- total_return
- current_weight
- target_weight
- category: Core / Opportunity / Watch / Hedge / Reserve

### 6.5 WatchlistItem

Watchlist als Investment Pipeline, nicht nur Liste.

Pflichtfelder:

- watchlist_item_id
- instrument_id
- Beobachtungsgrund
- Ziel-Einstiegspreis
- gewünschte Positionsgrösse absolut/prozentual
- Trigger
- Risiko
- Investment Case
- Bear Case
- Notizen
- Quellen
- Status: idea, research, waiting_for_trigger, buy_near, rejected, converted_to_position, archived
- letzter Review
- nächster Review

### 6.6 Decision Journal

Pflichtfelder:

- decision_id
- Datum
- Entscheidungstyp: Buy, Sell, Reduce, Increase, Hold, Override, Rebalance, Reject, Defer
- betroffene Position/Watchlist
- Systemempfehlung zum Zeitpunkt
- menschliche Entscheidung
- Begründung
- Investment Case
- Risiken
- Exit-Regeln
- Alternativen
- Quellen
- Review-Datum, z.B. nach 3/6/12 Monaten
- Outcome später: gut/schlecht/neutral, Rendite, Regelverletzung, Lessons Learned

---

## 7. Manuelle Eingabe im Dashboard

Das Dashboard muss direkte Erfassung erlauben.

### 7.1 Neue Position / Kauf erfassen

Felder:

- Titel suchen/auswählen
- Assetklasse
- Depot/Konto
- Menge
- Einstandspreis
- Kaufdatum
- Settlement Date optional
- Währung
- Gebühren
- Steuern
- FX Rate, automatisch oder manuell
- Kategorie: Core / Opportunity
- Zielgewichtung
- Investment Case
- Zeithorizont
- Exit-Regeln
- Quellen/Notizen

### 7.2 Verkauf / Teilverkauf erfassen

Felder:

- Position auswählen
- Menge
- Verkaufspreis
- Datum
- Gebühren
- Steuern
- FX Rate
- Grund des Verkaufs
- Decision Journal Eintrag

### 7.3 Umschichtung erfassen

Workflow:

1. Verkauf/Teilverkauf erfassen.
2. Zielposition oder Cash-Ziel auswählen.
3. System zeigt erwartete Auswirkungen:
   - Zielgewichtung
   - Cashquote
   - realisierte Gewinne/Verluste
   - Gebühren/Steuern
   - Risikoveränderung
4. Nutzer bestätigt manuelle Buchung.

---

## 8. Performance und Total Return

### 8.1 Getrennte Performance-Sichten

Das System muss unterscheiden:

- Kursperformance
- realisierter Gewinn/Verlust
- unrealisierter Gewinn/Verlust
- Dividenden/Ausschüttungen/Zinsen
- Gebühreneffekt
- Steuereffekt
- Währungseffekt
- Total Return
- Real Return nach Schweizer CPI/Teuerung

### 8.2 Methoden

- Simple Return
- Time-Weighted Return / TTWROR
- Money-Weighted Return / IRR, nach MVP
- CAGR
- Benchmark-relative Performance
- Performance Attribution nach Assetklasse, Sektor, Land, Währung, Position

### 8.3 Benchmarks

Mindestens konfigurierbar:

- MSCI World
- S&P 500
- Nasdaq 100
- Bitcoin
- Schweizer Inflation / CPI
- risikolose Alternative: Schweizer Staatsanleihen oder Tagesgeldzins
- eigener Blended Benchmark

Warnlogik:

- Wenn Real Return über definierte Periode unter Cash-/risikoloser Alternative liegt, erzeugt das System einen deutlichen Hinweis.

---

## 9. Income-, Dividenden- und Tax-View

### 9.1 Income View

Darstellung:

- Dividenden
- Ausschüttungen
- Zinsen
- Staking Rewards
- Quellensteuer
- Steuererstattungen
- Netto-Income
- Income nach Monat/Jahr
- Income nach Konto/Depot
- Income nach Instrument
- erwarteter Dividendenkalender, falls Daten verfügbar

### 9.2 Schweizer Steuer-/Jahresabschluss-Sicht

Soweit sinnvoll und ohne Steuerberatung:

- Jahresendwerte per 31.12.
- realisierte Verkäufe
- Dividenden/Ausschüttungen
- Quellensteuer
- Gebühren
- Steuerexport CSV/PDF
- Belege/Quellenreferenz
- Hinweis auf manuelle Prüfung / Steuerberater

### 9.3 Tax Disclaimer

Jeder Tax Report enthält:

> Dieser Report ist eine technische Auswertung der erfassten Daten und ersetzt keine Steuerberatung. Werte, Klassifikationen und Quellensteuerangaben müssen vor Einreichung geprüft werden.

---

## 10. Portfolio-Risikoanalyse

Das System analysiert das Portfolio als Gesamtsystem.

### 10.1 Exposure Views

- Assetklassen-Exposure
- Sektor-Exposure
- Länder-/Regionen-Exposure
- Währungs-Exposure
- Faktor-Exposure, z.B. Growth, Value, Quality, Momentum, Size, Volatility
- Broker-/Kontrahenten-Exposure
- Core vs Opportunity
- Cash vs Invested

### 10.2 ETF Look-through

Das System soll ETF-Überschneidungen erkennen:

- direkte Microsoft-Position plus indirekte Microsoft-Anteile über ETFs
- Top Holdings über mehrere ETFs aggregieren
- effektive Einzelunternehmens-Exposure berechnen
- Klumpenrisiken sichtbar machen

MVP darf mit Top-10/Top-25-Holdings je ETF starten.

### 10.3 Risikomessung

- Volatilität
- Maximum Drawdown
- Korrelationen
- Klumpenrisiko
- Cashquote
- Liquiditätsrisiko
- Währungsrisiko
- Konzentrationsscore
- Score-Ampel pro Risikoart

### 10.4 Risk Heatmap

Dashboard-Komponente:

- Treemap: Fläche = Positionsgrösse / Exposure
- Farbe = Risiko/Korrelation/Score von Tiefgrün bis Dunkelrot
- Klick öffnet Detail-Sidebar mit Begründung und Quellen

---

## 11. Rebalancing-Workflow

Das System macht konkrete Vorschläge, aber keine Ausführung.

### 11.1 Inputs

- Zielgewichtung pro Position
- Zielgewichtung pro Assetklasse
- Zielgewichtung Core/Opportunity
- Mindest-Cashquote
- Health Reserve / Notgroschen
- Gebühren-/Steuerhinweise
- Makro-Ampel
- Risikolimits

### 11.2 Output pro Vorschlag

- aktuelle Gewichtung
- Zielgewichtung
- Differenz in Prozentpunkten
- Differenzbetrag in Basiswährung
- mögliche Teilverkäufe
- mögliche Aufstockungen
- Priorität
- Begründung
- geschätzte Gebühren/Steuerrelevanz
- erwartete Auswirkung auf Risiko/Exposure/Cashquote

### 11.3 Order vorbereiten

Button: **Order vorbereiten**

Output:

- Richtung: Kaufen/Verkaufen
- Titel
- Stückzahl
- Zielbetrag
- möglicher Limitpreis
- Börsenplatz / Zielbörse
- Währung
- geschätzte Gebühren
- Notiz für E-Banking/Broker

Keine Order wird automatisch übertragen.

---

## 12. Watchlist als Investment Pipeline

### 12.1 Pipeline-Stufen

- Idee
- Research offen
- Beobachten
- Kaufnah
- Bear Case prüfen
- Entscheidung nötig
- gekauft / ins Portfolio übernommen
- abgelehnt
- archiviert

### 12.2 Kaufnah-Logik

Ein Titel wird kaufnah, wenn definierte Trigger erfüllt sind:

- Ziel-Einstiegspreis erreicht
- Valuation-Marge erreicht
- Momentum bestätigt
- News-/Analystenlage positiv genug
- Macro-Ampel erlaubt Opportunity-Käufe
- Risiko unter Schwellenwert
- Bear Case geprüft

### 12.3 Workflow Watchlist → Portfolio

1. Watchlist-Titel auswählen.
2. Kauf-Dialog öffnet vorhandene Daten vorbefüllt.
3. Nutzer ergänzt Menge, Preis, Gebühren, Depot, Datum.
4. Decision Journal wird erstellt.
5. Watchlist Item erhält Status `converted_to_position`.
6. Position erscheint im Portfolio.

---

## 13. Scoring- und Empfehlungssystem

### 13.1 Score-Komponenten

Pro Instrument je nach Assetklasse:

- Trend Score
- Fundamental Score
- Sentiment / Analyst Score
- Risk Score
- Portfolio Fit Score
- Macro Adjusted Score
- Liquidity Score
- Data Quality Score

### 13.2 Empfehlungen

Mögliche Outputs:

- Buy / Erhöhen
- Hold
- Watch
- Reduce
- Sell
- Rebalance
- Avoid / Reject

Jede Empfehlung enthält:

- Ampel: Grün/Gelb/Rot
- Konfidenz
- Top positive Faktoren
- Top negative Faktoren
- zwei stärkste Bear-Case-Argumente
- Quellen
- nächste Trigger
- betroffene Regeln
- Datenqualität

### 13.3 Macro Adjustment

Wenn die Makro-Ampel schlechter wird:

- höhere Sicherheitsmarge für Opportunity-Käufe
- höherer Mindest-Fundamental-Score
- strengere Positionsgrössenlimits
- höheres Gewicht auf Cash/Liquidität
- strengere Risk Alerts

---

## 14. Macro Overlay & Market Regime

### 14.1 Metriken

- Zinskurve / Yield Curve
- Inflationsraten, insbesondere Schweiz, USA, Eurozone
- VIX / Volatilitätsindizes
- Fear & Greed Index
- Zentralbankzinsen
- Credit Spreads
- PMI / Leading Indicators optional
- USD/CHF, EUR/CHF

### 14.2 Macro-Ampel

- Grün: Risk-on / konstruktives Umfeld
- Gelb: gemischt / selektiv
- Rot: Risk-off / erhöhte Rezessions- oder Stressgefahr

### 14.3 Systemwirkung

Macro Overlay ist kein automatischer Verkaufsbefehl, sondern verändert Schwellenwerte und Kontext:

- Opportunity-Käufe werden bei Rot strenger bewertet.
- Rebalancing in Risikoassets bekommt niedrigere Priorität.
- Cash- und Liquiditätsalerts werden prominenter.
- Reports markieren Regime-Wechsel.

---

## 15. Scenario Stress Testing / What-if Engine

### 15.1 Vordefinierte Szenarien

- CHF +10% gegenüber USD
- EUR/CHF -10%
- Aktienmarkt -20%
- Tech-Sektor -30%
- Crypto Flashcrash -40%
- Zinsanstieg +100 bps
- Inflation Shock
- VIX Spike
- einzelner Top-Holding Drawdown -30%
- Kombination: Risk-off + USD-Schwäche + Crypto-Crash

### 15.2 Output

- Portfolio Impact absolut/prozentual
- Impact pro Assetklasse
- Impact pro Position
- FX Impact
- Cashquote nach Szenario
- Limit-Verletzungen
- betroffene Rebalancing-Vorschläge
- Annahmen und Grenzen

---

## 16. Liquiditäts-Leiter & Health Reserve

### 16.1 Liquidity Ladder

Das Dashboard zeigt verfügbare Liquidität:

- sofort / T+0
- innerhalb 24h
- innerhalb 72h
- innerhalb 7 Tagen
- innerhalb 30 Tagen
- >30 Tage / eingeschränkt liquide

### 16.2 Asset-Liquiditätsklassen

- Cash sofort verfügbar
- Aktien/ETFs T+1/T+2, abhängig von Markt
- Crypto abhängig von Exchange/Wallet/Staking
- gestakte Crypto mit Unlock-Frist
- illiquide Assets manuell klassifiziert

### 16.3 Health Reserve / Notgroschen

Dedizierter Cash-Puffer:

- als **unantastbar** markiert
- nicht Teil des Anlageportfolios
- nicht in Renditeberechnung des Anlageportfolios
- sichtbar in Net-Worth- und Liquidity-Views
- eigene Mindesthöhe / Zielwert
- Alert, wenn unterschritten

---

## 17. Bias Detection & Bear-Case-Bot

### 17.1 Disposition Effect Tracker

Das System prüft regelbasiert:

- Werden Verlierer zu lange gehalten?
- Werden Gewinner zu früh verkauft?
- Werden System-Ampeln häufig übersteuert?
- Werden Overrides nach 3/6/12 Monaten überprüft?

### 17.2 Override Review

Wenn Sir eine Systemempfehlung manuell übersteuert:

- Override wird im Decision Journal gespeichert.
- Review-Datum wird gesetzt.
- Nach 6 Monaten erzeugt das System einen Review-Alert.
- Outcome wird analysiert.

### 17.3 Opposing View / Bear Case

Bei jeder positiven Bewertung oder Kaufempfehlung muss das System anzeigen:

- die zwei stärksten fundamentalen Gegenargumente
- wichtigste Risikoquelle
- was den Investment Case brechen würde
- Quellen oder Hinweis, wenn Bear-Case-Daten fehlen

Keine Bestätigungsfallen. Das System soll nicht nicken wie ein überbezahlter Bankberater.

---

## 18. Alert-System mit Prioritäten

### 18.1 Prioritäten

- **Info:** nützlich, kein Handlungsdruck
- **Wichtig:** Review im nächsten Routinefenster
- **Kritisch:** zeitnahe Prüfung erforderlich

Optional intern feiner:

- Low
- Medium
- High
- Critical

### 18.2 Alert-Kategorien

- Kursbewegung
- Score-Wechsel
- Ampelwechsel
- Zielgewicht überschritten
- Rebalancing-Bedarf
- Earnings/Event
- Analysten-Downgrade/Upgrade
- negative News
- Watchlist-Trigger
- Macro-Regime-Wechsel
- Liquidität / Health Reserve
- Datenqualität
- API-/Importfehler
- Steuer-/Report-Thema

### 18.3 Anti-Rauschen-Regeln

- Deduplizierung ähnlicher Alerts
- Cooldown pro Instrument
- Bündelung im Tagesreport
- Kritisch-Alerts sofort
- Snooze/acknowledge/resolved
- Alert Quality Review monatlich

---

## 19. Data Quality und Quellenpflicht

Jede Recommendation und jeder Score muss speichern:

- Datenquelle
- Zeitpunkt
- verwendete Regelversion
- Score-Komponenten
- Rohwerte
- News-/Analystenquellen
- Confidence
- Data Quality Status

### 19.1 Datenzustände

- frisch
- veraltet
- unvollständig
- widersprüchlich
- Fallback-Quelle genutzt
- manuell überschrieben

### 19.2 Blocking Rules

Das System darf keine Scheingenauigkeit liefern.

Beispiele:

- Kein Tax Report ohne vollständige Transaktionen im Zeitraum.
- Kein Score mit hoher Konfidenz bei veralteten Kursdaten.
- Keine Analysten-Ampel, wenn Ratings fehlen oder widersprüchlich sind.
- Kein Rebalancing-Vorschlag bei ungeklärter Cash-Reconciliation.

---

## 20. UI/UX: Investment Command Center

### 20.1 Startseite beantwortet sofort

- Was ist heute wichtig?
- Muss ich handeln?
- Welche Positionen haben Ampelwechsel?
- Welche Watchlist-Titel sind kaufnah?
- Gibt es kritische Risiken?
- Gibt es Rebalancing-Bedarf?
- Sind Daten fehlerhaft/veraltet?
- Kann ein Report exportiert werden?

### 20.2 Progressive Disclosure

- Keine endlosen Tabellen als Hauptinteraktion.
- Overview zeigt priorisierte Cards.
- Klick auf Position öffnet rechte Sidebar.
- Sidebar zeigt:
  - TradingView Chart
  - Score Breakdown
  - News
  - Analysten
  - Bear Case
  - Transaktionen
  - Decision Journal
  - Action Prep

### 20.3 Hauptseiten

- Command Center Overview
- Portfolio
- Transactions
- Manual Entry
- Watchlist Pipeline
- Risk & Exposure
- Rebalancing
- Macro Overlay
- Stress Tests
- Liquidity & Health Reserve
- Income & Tax
- Alerts
- Decision Journal
- Reports
- Data Quality
- Settings

### 20.4 Mobile Nutzung

Mobile View reduziert auf:

- Gesamtwert
- Tagesbewegung
- kritische Alerts
- Watchlist-Trigger
- Top-Entscheidungen
- Liquidity / Health Reserve Status
- Report Status

Mobile muss lesbar und bedienbar sein, aber nicht alle Admin-Funktionen enthalten.

---

## 21. Reports per Knopfdruck

### 21.1 Reporttypen

- Tagesreport
- Wochenreport
- Monatsreport
- Positionsreport
- Watchlist-Report
- Risk Report
- Rebalancing Report
- Income-/Tax-Report
- Decision Journal Report
- Data Quality Report

### 21.2 Formate

- PDF
- HTML
- Markdown
- CSV/JSON für Datenexport

### 21.3 Inhalte

Reports enthalten je nach Typ:

- Charts
- Performance
- Kurs-/Total Return
- realisierte/unrealisierte Gewinne
- Dividenden/Ausschüttungen
- Score-Änderungen
- Empfehlungen
- Bear Case
- Quellen
- offene Entscheidungen
- Datenqualität
- Methodik/Disclaimer

---

## 22. Datenimport und Export

### 22.1 Import

MVP:

- manuelle Dashboard-Eingabe
- CSV Import
- Google Sheet optional

Später:

- Broker CSV
- Bank CSV
- PDF-Abrechnungen
- Crypto Exchange CSV
- Wallet Exports

### 22.2 Import Workflow

1. Datei hochladen.
2. Quelle auswählen.
3. Mapping prüfen.
4. Vorschau anzeigen.
5. Duplikate markieren.
6. Fehler in Quarantine.
7. Nutzer bestätigt Import.
8. Ledger wird aktualisiert.
9. Reconciliation Report wird erzeugt.

### 22.3 Export

Alle Daten exportierbar:

- Transaktionen
- Positionen
- Watchlist
- Decision Journal
- Reports
- Scores
- Regeln
- Datenqualitätsissues

Formate:

- CSV
- JSON
- SQLite/Postgres Dump später
- PDF/HTML/Markdown Reports

---

## 23. Automatisierung

### 23.1 Intraday / mehrfach täglich

- Kursdaten aktualisieren
- kritische Kursbewegungen erkennen
- Watchlist Trigger prüfen
- kritische Datenfehler melden

### 23.2 Täglich

- Preise, FX, News, Analystendaten aktualisieren
- Scores berechnen
- Alerts deduplizieren
- Dashboard aktualisieren
- Tagesreport bereitstellen

### 23.3 Wöchentlich

- Rebalancing-Vorschläge
- Watchlist Ranking
- Risk Review
- Macro Review
- Bias/Decision Review
- Wochenreport

### 23.4 Monatlich

- Performance Review
- Tax/Income Zwischenstand
- Benchmark und Real Return
- Decision Outcome Review
- Alert Quality Review
- Monatsreport

---

## 24. MVP-Roadmap

### Phase 0 – Konzept finalisieren

Deliverables:

- Anforderungen v0.2
- Datenquellenliste
- Zielwährung
- Broker-/CSV-Beispiele
- Benchmark-Liste
- Dashboard-Wireframes

### Phase 1 – Core Ledger & Manual Entry

- Transaction Ledger
- Cash Ledger
- Position-Berechnung
- manuelle Eingabe im Dashboard
- CSV Import
- Export
- Data Quality Queue

### Phase 2 – Portfolio Dashboard & Reports

- Command Center Overview
- Positionsübersicht
- TradingView Charts
- PDF/HTML/Markdown Reports
- Tages-/Wochen-/Monatsreport

### Phase 3 – Total Return, Income & Tax

- Dividenden/Ausschüttungen/Zinsen
- Gebühren/Steuern
- FX Impact
- Total Return
- Schweizer Jahresabschluss-View

### Phase 4 – Scoring, Watchlist & Alerts

- Watchlist Pipeline
- Score Engine
- Ampeln
- Alert Center
- Quellenpflicht
- Bear Case

### Phase 5 – Risk, Rebalancing & ETF Look-through

- Risk Heatmap
- Exposure Analyse
- ETF Überschneidungen
- Rebalancing Workflow
- Order vorbereiten

### Phase 6 – Macro, Stress Tests, Liquidity & Bias

- Macro-Ampel
- Stress-Test Engine
- Liquidity Ladder
- Health Reserve
- Bias Detection
- Decision Outcome Review

---

## 25. Offene Fragen für v0.2

1. Basiswährung: CHF, EUR oder USD?
2. Welche Broker-/Bank-CSV-Formate zuerst?
3. Welche Depots/Konten/Wallets existieren initial?
4. Soll Google Sheet als Eingabequelle genutzt werden?
5. Welche Market-Data-APIs sind akzeptabel, kostenlos vs. Premium?
6. Welche Benchmarks sind Pflicht?
7. Welche Zielgewichtungen gelten für Core/Opportunity/Crypto/Cash?
8. Wie hoch ist die Health Reserve?
9. Welche Schweizer Steuerlogik ist für MVP ausreichend?
10. Soll das Dashboard lokal, im Heimnetz oder extern erreichbar laufen?
11. Welche Alerts sollen sofort nach Telegram, welche nur ins Dashboard?
12. Welche Watchlist-Universen sollen gescannt werden: manuell, S&P 500, Nasdaq 100, STOXX, Crypto Top 100?

---

## 26. Abnahmekriterien v0.1

Das Konzept ist reif für technische Planung, wenn:

- Transaktionsbasiertes Ledger als Kern bestätigt ist.
- Dashboard-Workflows für manuelle Eingabe, Watchlist, Reports und Decision Journal bestätigt sind.
- Datenquellen und Basiswährung definiert sind.
- Scoring- und Alert-Prinzipien akzeptiert sind.
- MVP-Phasen priorisiert sind.
- Keine Funktion automatischen Handel auslöst.
- Datenexport und Quellenpflicht fest verankert sind.

---

## 27. Zusammenfassung

Das geplante JARVIS Finance System wird ein regelbasiertes Investment Command Center. Es kombiniert vollständiges Transaction Accounting, Portfolio- und Risikoanalyse, Watchlist-Pipeline, Macro Overlay, Stress Tests, Liquiditätsmanagement, Decision Journal, Bias Detection, Rebalancing-Vorschläge und exportierbare Reports.  

Der entscheidende Punkt: Das System bereitet Entscheidungen vor, dokumentiert sie und prüft ihre Qualität später – aber es handelt nicht selbst. Genau so sollte eine Maschine dienen, Sir: präzise, nachvollziehbar, ohne eigenmächtige Genialitätsanfälle.