style: Wording and better feature grouping

Author: markusdlugi

README.md

@@ -1,9 +1,9 @@
-# ☀️ SolarBatterYield - PV-Analyse mit Speichervergleich
+# ☀️ SolarBatterYield - PV-Rechner mit Speichervergleich
 
 https://solarbatteryield.streamlit.app/
 
-Eine interaktive Streamlit-App zur Simulation und Wirtschaftlichkeitsanalyse von Photovoltaik-Anlagen mit
-Batteriespeicher – optimiert für **Balkonkraftwerke** und kleine Aufdachanlagen.
+Open-Source-Tool zur Simulation von PV-Ertrag und Amortisation. Fokus auf Balkonkraftwerke, Speicher-Nachrüstung und
+realistische Lastprofile.
 
 <p align="center">
   <picture>
@@ -15,45 +15,44 @@ Batteriespeicher – optimiert für **Balkonkraftwerke** und kleine Aufdachanlag
 
 ## Features
 
-- **PVGIS-Integration** – Stündliche PV-Ertragsdaten direkt von der EU-Datenbank (2005–2020)
-- **Standortsuche** – Koordinaten per Ortsname via OpenStreetMap Nominatim
-- **Flexible PV-Konfiguration** – Beliebig viele Module mit individueller Leistung, Ausrichtung und Neigung
-- **Wechselrichter-Limit** – 800 W Standard (Balkonkraftwerk), deaktivierbar für größere Anlagen
-- **Lastabhängiger Wechselrichter-Wirkungsgrad** – Realistische Effizienz basierend auf CEC-Daten von 3.000+
-  Wechselrichtern:
-    - Drei Voreinstellungen: Pessimistisch (P10), Median (P50), Optimistisch (P90)
-    - Optional: Eigene Wirkungsgradkurve für Experten
-- **DC- und AC-gekoppelte Speicher** – Korrekte Simulation beider Anbindungsarten:
-    - **DC-gekoppelt**: Batterie lädt direkt von den PV-Modulen, Wechselrichter-Limit gilt nur für die AC-Seite
-    - **AC-gekoppelt**: Wechselrichter begrenzt den gesamten PV-Ertrag, eigener Wechselrichter für die Batterie möglich
-- **BDEW H0-Standardlastprofil** – Realistisches Lastprofil mit Unterscheidung nach:
-    - Werktagen, Samstagen und Sonn-/Feiertagen
-    - Jahreszeiten (Winter, Frühling, Sommer, Herbst)
-    - Deutsche Feiertage werden automatisch berücksichtigt
-- **Erweiterter Verbrauchsmodus** – Eigene stündliche Lastprofile inklusive:
-    - **Wochentag-Unterscheidung**: Unterschiedliche Profile für Werktage, Samstage und Sonn-/Feiertage
-    - **Saisonale Skalierung**: Automatische Anpassung der Lastprofile je nach Jahreszeit
-    - **Lastverschiebung** – Optionale Zusatzlast an ertragreichen Sonnentagen (z. B. Waschmaschine)
-    - **Periodische Zusatzlast** – Regelmäßiger Verbrauch unabhängig vom Wetter (z. B. Warmwasser-Desinfektion)
-- **Experten-Verbrauchsmodus** - Upload von eigenen Smart-Meter-Daten (CSV) für präzise Ergebnisse
-- **Einspeisevergütung** – Berücksichtigung der Vergütung in allen Wirtschaftlichkeitsberechnungen
-- **Mehrere Speicher-Szenarien** – Vergleich von „Ohne Speicher" bis zu beliebig vielen Batterie-Optionen
-- **Langzeitvergleich PV vs. ETF** – Kumulierte Rendite über konfigurierbare Laufzeit
-- **Konfiguration teilen** – Alle Parameter als komprimierter URL-Parameter
+### ☀️ Photovoltaik & Hardware
+
+* 🔌 Flexible PV-Konfiguration – Beliebig viele Module mit individueller Leistung, Ausrichtung und Neigung.
+* 📉 Realistische Wirkungsgrade – Simulation basierend auf CEC-Daten von 3.000+ Wechselrichtern
+  (P10/P50/P90-Voreinstellungen oder eigene Kurven).
+* ⚡ DC- & AC-Kopplung – Korrekte Abbildung beider Systemwelten (z. B. Speicher vor oder nach dem Wechselrichter).
+* 🛑 Wechselrichter-Limit – Einstellbare Begrenzung (z. B. 800 W für BKW), für große Anlagen deaktivierbar.
+
+### 🏠 Verbrauch & Lastprofile
+
+* 📊 Dynamische Lastprofile – Unterscheidung nach Wochentagen, Jahreszeiten und Berücksichtigung deutscher Feiertage.
+* 🧺 Intelligente Lastverschiebung – Simulation von Zusatzverbrauch an Sonnentagen (z. B. Waschmaschine/Spülmaschine).
+* 🚿 Periodische Zusatzlasten – Abbildung von regelmäßigen Verbräuchen wie Warmwasser-Desinfektion
+  (Legionellenschaltung).
+* 📂 Experten-Modus – CSV-Upload eigener Smart-Meter-Daten für maximale Präzision.
+
+### 💰 Wirtschaftlichkeit & Analyse
+
+* 🔋 Speicher-Vergleichsszenarien – Direkter Vergleich verschiedener Kapazitäten von "Ohne Speicher" bis hin zu mehreren
+  Batterie-Optionen.
+* 📈 PV vs. ETF-Rendite – Langfristiger Vergleich der kumulierten Rendite inklusive optionaler Reinvestition der
+  Ersparnis.
+* 🪙 Einspeisevergütung – Optionale Berücksichtigung aktueller Vergütungssätze in der Amortisationsrechnung.
+* 🔗 Konfiguration teilen – Alle Parameter können via Deep-Link geteilt werden.
 
 ## Bedienung
 
 Die Konfiguration erfolgt über die **Seitenleiste** in sieben aufklappbaren Abschnitten:
 
-| Abschnitt                      | Inhalt                                                                         |
-|--------------------------------|--------------------------------------------------------------------------------|
-| 📍 **Standort**                | Ort suchen oder Koordinaten manuell eingeben                                   |
-| 💡 **Verbrauch**               | Jahresverbrauch, Lastprofil, Lastverschiebung, periodische Zusatzlast          |
-| ☀️ **PV-Module**               | Module (Leistung, Ausrichtung, Neigung), Systemkosten                          |
-| ⚡ **PV-Konfiguration**         | PVGIS-Datenjahr, Systemverluste, WR-Wirkungsgrad, Wechselrichter-Limit         |
-| 🔋 **Speicher-Optionen**       | Ausbaustufen (Kapazität, Aufpreis)                                             |
-| 🪫 **Speicher-Konfiguration**  | DC/AC-Kopplung, Batterie-WR, Lade-/Entladeverluste, SoC-Grenzen                |
-| 💰 **Preise & Vergleich**      | Strompreis, Preissteigerung, Einspeisevergütung, ETF-Rendite, Analyse-Horizont |
+| Abschnitt                     | Inhalt                                                                         |
+|-------------------------------|--------------------------------------------------------------------------------|
+| 📍 **Standort**               | Ort suchen oder Koordinaten manuell eingeben                                   |
+| 💡 **Verbrauch**              | Jahresverbrauch, Lastprofil, Lastverschiebung, periodische Zusatzlast          |
+| ☀️ **PV-Module**              | Module (Leistung, Ausrichtung, Neigung), Systemkosten                          |
+| ⚡ **PV-Konfiguration**        | PVGIS-Datenjahr, Systemverluste, WR-Wirkungsgrad, Wechselrichter-Limit         |
+| 🔋 **Speicher-Optionen**      | Ausbaustufen (Kapazität, Aufpreis)                                             |
+| 🪫 **Speicher-Konfiguration** | DC/AC-Kopplung, Batterie-WR, Lade-/Entladeverluste, SoC-Grenzen                |
+| 💰 **Preise & Vergleich**     | Strompreis, Preissteigerung, Einspeisevergütung, ETF-Rendite, Analyse-Horizont |
 
 Die Abschnitte **PV-Module** und **Speicher-Optionen** enthalten die häufig angepassten Einstellungen,
 während **PV-Konfiguration** und **Speicher-Konfiguration** die technischen Details bündeln.

src/solarbatteryield/report/landing.py

@@ -18,10 +18,10 @@ def render_landing_page(missing: list[str]) -> None:
     Args:
         missing: List of missing configuration items with descriptions
     """
-    st.title("☀️ SolarBatterYield - PV-Analyse mit Speichervergleich")
+    st.title("☀️ SolarBatterYield - PV-Rechner mit Speichervergleich")
     st.markdown(
-        "Interaktive App zur Simulation und Wirtschaftlichkeitsanalyse von "
-        "Photovoltaik-Anlagen mit Batteriespeicher – optimiert für **Balkonkraftwerke**."
+        "Open-Source-Simulation von PV-Ertrag und Amortisation für Balkonkraftwerke. "
+        "Berechne die ideale Speicher-Nachrüstung und optimiere deinen Eigenverbrauch."
     )
     missing_list = "\n".join(f"- {m}" for m in missing)
     st.info(
@@ -41,4 +41,3 @@ def render_landing_page(missing: list[str]) -> None:
     )
 
     render_data_attribution()
-

src/solarbatteryield/streamlit_app.py

@@ -8,7 +8,7 @@
 import streamlit as st
 
 # Configure page first (must be first Streamlit command)
-st.set_page_config(page_title="SolarBatterYield - PV-Analyse mit Speichervergleich", page_icon="☀️", layout="wide")
+st.set_page_config(page_title="SolarBatterYield - PV-Rechner mit Speichervergleich", page_icon="☀️", layout="wide")
 
 from solarbatteryield.api import get_pvgis_hourly, PVGISError, APIError
 from solarbatteryield.models import (
@@ -26,19 +26,19 @@ def main():
     """Main application entry point."""
     # Initialize session state
     init_session_state()
-    
+
     # Render sidebar configuration
     render_sidebar()
-    
+
     # Read configuration from session state
     config = get_config()
-    
+
     # Validate required configuration
     is_valid, missing = config.is_valid()
     if not is_valid:
         render_landing_page(missing)
         st.stop()
-    
+
     # Fetch PV data and run simulation
     try:
         pv_total, pv_gen_total = fetch_pv_data(config)
@@ -54,10 +54,10 @@ def main():
     except ValueError as exc:
         st.error(f"⚠️ Konfigurationsfehler: {exc}")
         st.stop()
-    
+
     # Run simulations for all scenarios
     results = run_simulations(config, pv_total, pv_gen_total)
-    
+
     # Render report
     render_report(config, results)
 
@@ -67,7 +67,7 @@ def get_config() -> SimulationConfig:
     inverter_limit_enabled = sv("cfg_inverter_limit_enabled")
     flex_enabled = sv("cfg_flex_enabled")
     periodic_enabled = sv("cfg_periodic_enabled")
-    
+
     # Build PV modules list
     modules = [
         PVModule(
@@ -79,7 +79,7 @@ def get_config() -> SimulationConfig:
         )
         for m in st.session_state.modules
     ]
-    
+
     # Build storage options list
     storage_options = [
         StorageOption(
@@ -90,20 +90,20 @@ def get_config() -> SimulationConfig:
         )
         for s in st.session_state.storages
     ]
-    
+
     # Get day-type profiles if enabled
     use_day_types = st.session_state.get("cfg_use_day_types", False)
     profile_saturday = None
     profile_sunday = None
     if use_day_types and sv("cfg_profile_mode") == "Erweitert":
         profile_saturday = st.session_state.get("_profile_saturday")
         profile_sunday = st.session_state.get("_profile_sunday")
-    
+
     # Get yearly profile for expert mode
     yearly_profile = None
     if sv("cfg_profile_mode") == "Experte":
         yearly_profile = st.session_state.get("_yearly_profile")
-    
+
     return SimulationConfig(
         location=LocationConfig(
             lat=sv("cfg_lat"),
@@ -175,7 +175,7 @@ def fetch_pv_data(config: SimulationConfig) -> tuple[np.ndarray, float]:
     return pv_total, pv_gen_total
 
 
-def run_simulations(config: SimulationConfig, pv_total: np.ndarray, 
+def run_simulations(config: SimulationConfig, pv_total: np.ndarray,
                     pv_gen_total: float) -> AnalysisResult:
     """Run simulations for all storage scenarios."""
     # Build scenario list: base (no storage) + each storage option sorted by capacity
@@ -192,10 +192,10 @@ def run_simulations(config: SimulationConfig, pv_total: np.ndarray,
     sim_params = config.to_simulation_input()
 
     results = AnalysisResult(pv_generation_total=pv_gen_total)
-    
+
     for name, cap, cost in scenarios:
         sim_result = simulate(pv_total, cap, sim_params)
-        
+
         results.scenarios.append(ScenarioResult(
             name=name,
             storage_capacity=cap,
@@ -208,4 +208,3 @@ def run_simulations(config: SimulationConfig, pv_total: np.ndarray,
 
 if __name__ == "__main__":
     main()
-