Translate to german (#64)

Author: Mohammad-Tayyab-Frequenz

RELEASE_NOTES.md

@@ -2,29 +2,11 @@
 
 ## Summary
 
-This release overhauls the Reporting UI with a redesigned home/dashboard experience,
-improves page navigation and routing reliability, and standardizes CHP naming from
-`BHKW` to `KWK` across reporting labels.
-
 ## Upgrading
 
-- No breaking API changes are introduced.
-- Package assets now explicitly include UI templates and styles (`templates/*.html`,
-  `styles/*.css`) in distribution metadata.
 
 ## New Features
 
-- Redesign the home page with reusable HTML templates and dedicated CSS styling.
-- Introduce centralized UI resource helpers for loading/injecting templates and styles.
-- Add a global app theme and refreshed dashboard visual system (section dividers,
-  KPI card styling, updated color palette).
-- Add section-aware routing from query params (including direct scroll to Data Export
-  section when requested).
+- Translate the output texts to german.
 
 ## Bug Fixes
-
-- Fix navigation state synchronization between sidebar selection and query-parameter
-  routing.
-- Fix data-export navigation routing and page transitions.
-- Fix inconsistent terminology by renaming `BHKW` labels to `KWK` in reporting UI.
-- Fix formatting and quality issues reported by `nox` checks.

app.py

@@ -319,15 +319,18 @@ def sidebar(pages: list[PageSpec]) -> PageSpec:
 # --- Main entrypoint --------------------------------------------------------
 def main() -> None:
     st.set_page_config(
-        page_title="Enterprise Reporting App",
+        page_title="Reporting-Anwendung",
         page_icon="📊",
         layout="wide",
     )
     _inject_global_theme()
 
     pages = discover_library_pages()
     if not pages:
-        st.info(f"No pages found under `{LIB_PAGES_ROOT}` (or local app_pages).")
+        st.info(
+            f"Keine Seiten unter `{LIB_PAGES_ROOT}` gefunden "
+            "(oder im lokalen Verzeichnis `app_pages`)."
+        )
         return
 
     selected = sidebar(pages)

src/frequenz/cs_reporting/app_pages/home.py

@@ -41,56 +41,56 @@ class _FeatureCard:
 
 
 _STATS: tuple[_Stat, ...] = (
-    _Stat("Real-time", "Data Refresh"),
-    _Stat("5+", "Component Types"),
-    _Stat("Multi-site", "Portfolio View"),
-    _Stat("CSV", "Export Ready"),
+    _Stat("Echtzeit", "Datenaktualisierung"),
+    _Stat("5+", "Komponententypen"),
+    _Stat("Multi-Standort", "Portfolioansicht"),
+    _Stat("CSV", "Exportbereit"),
 )
 
 _FEATURE_CARDS: tuple[_FeatureCard, ...] = (
     _FeatureCard(
         color_class="home-card--blue",
         icon="⚡",
-        title="Reporting Dashboard",
+        title="Reporting-Dashboard",
         description=(
-            "Portfolio-level power flows, consumption balances, "
-            "and detailed KPI analytics across all microgrid components."
+            "Leistungsflüsse auf Portfolioebene, Verbrauchsbilanzen "
+            "und detaillierte KPI-Analysen über alle Microgrid-Komponenten."
         ),
         features=(
-            "Grid import / export KPIs",
-            "PV, Battery, CHP & Wind analytics",
-            "Self-sufficiency & self-consumption ratios",
-            "Interactive time-series plots",
+            "KPIs für Netzbezug und Einspeisung",
+            "Analysen für PV, Batterie, KWK & Wind",
+            "Autarkie- und Eigenverbrauchsquoten",
+            "Interaktive Zeitreihen-Plots",
         ),
     ),
     _FeatureCard(
         color_class="home-card--green",
         icon="☀",
-        title="Solar Monitoring",
+        title="Solar-Monitoring",
         description=(
-            "Maintenance-oriented solar workflow checks with baseline "
-            "model comparison and rolling performance views."
+            "Wartungsorientierte Solar-Workflow-Prüfungen mit "
+            "Baseline-Modellvergleich und rollierenden Performance-Ansichten."
         ),
         features=(
-            "Inverter & meter diagnostics",
-            "Baseline model benchmarking",
-            "Rolling performance window (5-60 days)",
-            "German & English report output",
+            "Diagnose für Wechselrichter & Zähler",
+            "Benchmarking von Baseline-Modellen",
+            "Rollierendes Performance-Fenster (5-60 Tage)",
+            "Berichtsausgabe auf Deutsch & Englisch",
         ),
     ),
     _FeatureCard(
         color_class="home-card--purple",
         icon="↓",
-        title="Data Export",
+        title="Datenexport",
         description=(
-            "Download standardised tables from each reporting section "
-            "for use in internal pipelines and client deliverables."
+            "Standardisierte Tabellen aus allen Reporting-Bereichen "
+            "für interne Pipelines und Kundenberichte herunterladen."
         ),
         features=(
-            "Per-component time series",
-            "Aggregated energy summaries",
-            "Configurable resolution & timezone",
-            "CSV-compatible format",
+            "Zeitreihen pro Komponente",
+            "Aggregierte Energiezusammenfassungen",
+            "Konfigurierbare Auflösung & Zeitzone",
+            "CSV-kompatibles Format",
         ),
     ),
 )
@@ -203,21 +203,21 @@ def render() -> None:
 
     col1, col2, col3 = st.columns(3)
     with col1:
-        if st.button("Open Reporting Dashboard", use_container_width=True):
+        if st.button("Reporting-Dashboard öffnen", use_container_width=True):
             _navigate_to("reporting_dashboard")
     with col2:
-        if st.button("Open Solar Monitoring", use_container_width=True):
+        if st.button("Solar-Monitoring öffnen", use_container_width=True):
             _navigate_to("solar")
     with col3:
-        if st.button("Download Data Export", use_container_width=True):
+        if st.button("Datenexport öffnen", use_container_width=True):
             _navigate_to("reporting_dashboard", section="data-export")
 
     st.markdown(_footer_html(), unsafe_allow_html=True)
 
 
 PAGE = PageSpec(
     key="home",
-    title="Overview",
+    title="Übersicht",
     icon="",
     order=0,
     render=render,

src/frequenz/cs_reporting/app_pages/reporting.py

@@ -61,7 +61,7 @@ def _parse_resolution(resolution_str: str) -> timedelta:
     """
     match = re.fullmatch(r"(\d+)\s*(min|hour|h)", resolution_str.strip().lower())
     if not match:
-        raise ValueError(f"Unsupported resolution format: {resolution_str}")
+        raise ValueError(f"Nicht unterstütztes Auflösungsformat: {resolution_str}")
 
     value, unit = match.groups()
     minutes = int(value) * (60 if unit in ("hour", "h") else 1)
@@ -95,7 +95,7 @@ def render() -> None:
         Streamlit components are rendered directly.
     """
     # Page header
-    st.title("Reporting Dashboard")
+    st.title("Reporting-Dashboard")
 
     # Collect user inputs from sidebar
     today = date.today()
@@ -120,7 +120,8 @@ def render() -> None:
     # Validate date range
     if start_time > end_time:
         st.warning(
-            "End date must be on or after the start date. Please adjust your selection."
+            "Das Enddatum muss am oder nach dem Startdatum liegen. "
+            "Bitte passen Sie Ihre Auswahl an."
         )
         st.stop()
 
@@ -139,7 +140,7 @@ def render() -> None:
 
     # Fetch data with error handling
     try:
-        with st.spinner("Loading microgrid data..."):
+        with st.spinner("Microgrid-Daten werden geladen..."):
             df = get_microgrid_data(
                 microgrid_id=microgrid_id,
                 start_date=start_time,
@@ -148,12 +149,12 @@ def render() -> None:
                 resolution=resolution,
             )
     except (RuntimeError, ValueError, OSError) as e:
-        st.error(f"Failed to fetch data: {e}")
+        st.error(f"Daten konnten nicht geladen werden: {e}")
         st.stop()
 
     # Check for empty results
     if df.empty:
-        st.warning("No data for the selected filters.")
+        st.warning("Keine Daten für die ausgewählten Filter vorhanden.")
         st.stop()
 
     # Normalize the dataframe (Handle Index)

src/frequenz/cs_reporting/app_pages/solar.py

@@ -49,7 +49,7 @@ def capture_figures() -> Iterator[list[Figure]]:
 
 def render() -> None:
     """Render the Solar Maintenance & Monitoring page."""
-    st.title("Solar Maintenance & Monitoring")
+    st.title("Solar-Wartung & Monitoring")
     st.divider()
 
     inputs_data, submit_button = collect_solar_sidebar_inputs(
@@ -68,15 +68,16 @@ def render() -> None:
 
     if not submit_button:
         st.info(
-            "Select options in the sidebar and click Start to run the solar workflow."
+            "Wählen Sie Optionen in der Sidebar und klicken Sie auf Starten, "
+            "um den Solar-Workflow auszuführen."
         )
         return
 
     try:
         microgrid_config = get_microgrid_config(inputs_data.microgrid_id)
     except (KeyError, RuntimeError) as exc:
         st.error(
-            f"Configuration not found for microgrid {inputs_data.microgrid_id}: {exc}"
+            f"Konfiguration für Microgrid {inputs_data.microgrid_id} nicht gefunden: {exc}"
         )
         return
 
@@ -93,12 +94,12 @@ def render() -> None:
             baseline_models=inputs_data.baseline_models,
         )
     except Exception as exc:  # pylint: disable=broad-except
-        st.error(f"Failed to prepare request: {exc}")
+        st.error(f"Anfrage konnte nicht vorbereitet werden: {exc}")
         # Improve logging (could use proper logger, simplistic print for now as in original)
         print(f"Error building workflow request:\n{traceback.format_exc()}")
         return
 
-    with st.spinner("Running workflow..."):
+    with st.spinner("Workflow wird ausgeführt..."):
         with capture_figures() as new_figures:
             plot_data = asyncio.run(run_workflow(user_config_changes=user_request))
 
@@ -107,7 +108,7 @@ def render() -> None:
 
 PAGE = PageSpec(
     key="solar",
-    title="Solar Monitoring",
+    title="Solar-Monitoring",
     icon="",
     order=2,
     render=render,

src/frequenz/cs_reporting/components/inputs.py

@@ -23,7 +23,7 @@ def _resolve_container(container: Any | None) -> Any:
 
 
 def microgrid_selector(
-    label: str = "Microgrid ID",
+    label: str = "Microgrid-ID",
     ids: Iterable[int] = range(1, 2),
     key_prefix: str = "",
     container: Any | None = None,

src/frequenz/cs_reporting/components/plot_charts.py

@@ -93,7 +93,7 @@ def plot_percentage_bar(
             showlegend=False,
             annotations=[
                 {
-                    "text": "No data to display",
+                    "text": "Keine Daten zur Anzeige",
                     "x": 0.5,
                     "xref": "paper",
                     "y": 0.5,
@@ -114,18 +114,18 @@ def plot_percentage_bar(
     }
     residual = total - sum(segments.values())
     if abs(residual) > 1e-6:
-        segments["Others"] = residual
+        segments["Sonstige"] = residual
 
     seg_with_pct = [
         (k, v, (v / total * 100.0 if total != 0 else 0.0)) for k, v in segments.items()
     ]
     seg_with_pct.sort(key=lambda x: abs(x[1]), reverse=True)
 
-    # Assign palette colours in order; "Others" always gets slate
+    # Assign palette colours in order; "Sonstige" always gets slate
     color_map: dict[str, str] = {}
     palette_idx = 0
     for label, _, _ in seg_with_pct:
-        if label == "Others":
+        if label == "Sonstige":
             color_map[label] = _OTHERS_COLOR
         else:
             color_map[label] = _PROFESSIONAL_PALETTE[
@@ -156,8 +156,8 @@ def plot_percentage_bar(
                 customdata=[value],
                 hovertemplate=(
                     f"<b>{label}</b><br>"
-                    "Share: %{x:.1f}%<br>"
-                    "Energy: %{customdata[0]:,.0f} kWh"
+                    "Anteil: %{x:.1f}%<br>"
+                    "Energie: %{customdata[0]:,.0f} kWh"
                     "<extra></extra>"
                 ),
             )

src/frequenz/cs_reporting/components/sidebar_inputs.py

@@ -66,7 +66,7 @@ def collect_sidebar_inputs(
         # Microgrid Section
         st.subheader("Microgrid")
         microgrid_id = inputs.microgrid_selector(
-            label="Microgrid ID",
+            label="Microgrid-ID",
             ids=get_microgrid_ids(),
             key_prefix=key_prefix,
             container=st,
@@ -89,7 +89,7 @@ def collect_sidebar_inputs(
         columns = st.columns(2)
         with columns[0]:
             start_date = st.date_input(
-                "Start",
+                "Von",
                 value=start_initial,
                 max_value=today,
                 key=start_key,
@@ -211,11 +211,11 @@ def collect_solar_sidebar_inputs(
     try:
         available_microgrids = get_microgrid_ids()
     except RuntimeError as exc:
-        st.error(f"Failed to load microgrid configurations: {exc}")
+        st.error(f"Microgrid-Konfigurationen konnten nicht geladen werden: {exc}")
         return None, False
 
     if not available_microgrids:
-        st.error("No microgrid configurations found.")
+        st.error("Keine Microgrid-Konfigurationen gefunden.")
         return None, False
 
     timezone_options_list = list(timezone_options or TIMEZONE_OPTIONS)
@@ -248,7 +248,7 @@ def collect_solar_sidebar_inputs(
         st.subheader("Workflow")
         language = st.selectbox(
             "Sprache",
-            options=["English", "Deutsch"],
+            options=["Deutsch", "Englisch"],
             index=0,
         )
         resample_period = st.text_input(
@@ -280,7 +280,7 @@ def collect_solar_sidebar_inputs(
             index=timezone_default_index,
         )
 
-        submit_button = st.form_submit_button("Start", use_container_width=True)
+        submit_button = st.form_submit_button("Starten", use_container_width=True)
 
     inputs_data = SolarWorkflowInputs(
         microgrid_id=int(microgrid_id),

src/frequenz/cs_reporting/components/ui.py

@@ -45,6 +45,6 @@ def render_plot_card(title: str, fig: object) -> None:
         elif isinstance(fig, Figure):
             st.pyplot(fig)
         else:
-            st.warning("Unsupported figure type.")
+            st.warning("Nicht unterstützter Figurtyp.")
 
         st.markdown("</div></div>", unsafe_allow_html=True)

src/frequenz/cs_reporting/services/solar_workflow.py

@@ -102,7 +102,7 @@ def build_workflow_request(
 
     days_since_start = max(0, (end_timestamp - start_dt).days)
     actual_rolling_duration = min(rolling_view_duration, days_since_start)
-    lang_code = {"English": "en", "Deutsch": "de"}.get(language, "en")
+    lang_code = {"English": "en", "Englisch": "en", "Deutsch": "de"}.get(language, "de")
 
     weather_api = os.environ.get("WEATHER_API_URL")
     reporting_api = os.environ.get("REPORTING_API_URL")