Deutsche Version English version below

---

Corporate Carbon Footprint Rechner

Ein browserbasiertes Tool zur Berechnung des Corporate Carbon Footprint mit offiziellen UBA-Emissionsfaktoren (Umweltbundesamt). Die App läuft als einzelne index.html-Datei, vollständig clientseitig und offline-fähig.

Hinweis: Dieses Projekt befindet sich in Entwicklung. Funktionen und Datenaktualisierungsschritte können sich ändern.

Schnellstart

1. index.html per Doppelklick öffnen — funktioniert in jedem modernen Browser (inklusive Safari), auch ohne Internetverbindung. Alle Bibliotheken sind in der Datei eingebettet.
2. Dem 4-Schritte-Assistenten folgen: Berichtszeitraum, Kategorieauswahl, Dateneingabe, Ergebnisse.
3. Optional (z. B. für Entwicklung) einen lokalen Server starten:
   • macOS/Linux: ./scripts/start_server.sh
   • Windows: scripts\start_server.bat
   • Hinweis: Wenn Port 8000 belegt ist, wählt das Skript automatisch den nächsten freien Port und zeigt die URL an.

Funktionen

• 13 Kategorien nach GHG-Protokoll (Scope 1, 2 und 3 sowie biogenes CO₂)
• Manuelle Dateneingabe oder Massenimport per Excel (.xlsx) und CSV — inkl. deutscher Zahlenformate, Semikolon-Trennung und Zeilen-Validierungsbericht
• Drei ladbare Beispielunternehmen (Büro, Produktion, Logistik) zum Ausprobieren
• Sitzung speichern/öffnen als Datei; automatisches Speichern im Browser mit Fortsetzen-Banner
• Interaktive Diagramme: Treemap und Sunburst mit Drill-down, Wasserfall nach Scope, Top-10-Quellen
• Einordnung der Ergebnisse: Pkw-km-, Flug-, Baum- und Pro-Kopf-Äquivalente sowie Intensitätskennzahlen
• Vollständigkeits-Chips und Plausibilitätshinweise bei der Dateneingabe
• Geführte Tour beim ersten Besuch; Hilfe-, Methodik- und Referenzbereich
• Export als CSV, TXT-Bericht oder PDF — vollständig offline
• Zweisprachige Oberfläche (Deutsch / Englisch), Hell-/Dunkelmodus
• Komplett eigenständige Datei: alle Bibliotheken eingebettet, kein CDN, kein Server nötig

Datenquellen

• UBA-Emissionsfaktoren v2.0 (Dez 2025) sind für Offline-Berechnungen eingebettet
• Optionale Hintergrundprüfung auf neuere UBA-Daten bei bestehender Internetverbindung
• BAFA-CO2-Faktoren sind nicht integriert (siehe ausführliche Dokumentation)
• Bewusste Vereinfachung in Scope 3.4/3.6/3.7: Es werden nur UBA-Faktoren mit ID-Scope-Code 32 (mit Vorketten / well-to-wheel) gezeigt; 31 (nur Vorketten / well-to-tank) wird ausgeblendet.
• Wichtige Grenze in Blatt 08: UBA trennt die Faktoren für Dienstreisen und Pendelverkehr nicht vollständig; Scope 3.6 und 3.7 nutzen daher denselben Faktorpool.
• Praktische Folge: Nutzer geben weiterhin getrennte Mengen für 3.6 und 3.7 ein. Wenn dieselbe Aktivität in beiden Kategorien erfasst wird, wird sie doppelt gezählt.
• Biogenes CO₂ wird für verknüpfte Brennstoffaktivitäten automatisch aus nicht-biogenen Eingaben übernommen und über mehrere Quellen summiert (z. B. Biodiesel in Scope 1 + Scope 3.6).

Dokumentation

• Kurzübersicht: README.md
• Vollständige Anleitung: docs/DOCUMENTATION.md

Lizenz

MIT für den Code. UBA-Emissionsfaktoren sind CC0 1.0 (Public Domain).

---

Corporate Carbon Footprint Calculator

A browser-based tool for calculating corporate carbon footprints using official UBA (Umweltbundesamt) emission factors. The app runs as a single index.html file, fully client-side and offline-capable.

Note: This project is a work in progress. Features and data update steps may change.

Quick Start

1. Double-click index.html — works in any modern browser (including Safari), even without an internet connection. All libraries are embedded in the file.
2. Follow the 4-step wizard: reporting period, category selection, data entry, results.
3. Optional (e.g. for development), start a local server:
   • macOS/Linux: ./scripts/start_server.sh
   • Windows: scripts\start_server.bat
   • Note: If port 8000 is busy, the script automatically selects the next free port and prints the URL.

Features

• 13 categories across GHG Protocol scopes (Scope 1, 2, 3, plus biogenic CO₂)
• Manual data entry or bulk import via Excel (.xlsx) and CSV — including German number formats, semicolon delimiters, and a per-row validation report
• Three loadable example companies (office, manufacturing, logistics) to explore the tool
• Save/open sessions as a file; automatic in-browser saving with a resume banner
• Interactive charts: treemap and sunburst with drill-down, waterfall by scope, top-10 sources
• Results in context: car-km, flight, tree, and per-capita equivalents plus intensity metrics
• Completeness chips and plausibility hints during data entry
• Guided tour on first visit; help, methodology, and references section
• Export as CSV, TXT report, or PDF — fully offline
• Bilingual interface (German / English), light / dark mode
• Fully self-contained file: all libraries embedded, no CDN, no server required

Data Sources

• UBA emission factors v2.0 (Dec 2025) are embedded for offline calculations
• Optional background update check for newer UBA data when online
• BAFA CO2 factors are not integrated (see extended docs)
• Intentional simplification in Scope 3.4/3.6/3.7: only UBA factors with ID scope code 32 (mit Vorketten / well-to-wheel) are shown; 31 (nur Vorketten / well-to-tank) is hidden.
• Important sheet-08 limitation: UBA does not fully separate business-travel and commuting factors; Scope 3.6 and 3.7 therefore use the same factor pool.
• Practical implication: users still enter separate quantities for 3.6 and 3.7. If the same activity is entered in both, it is counted twice.
• Biogenic CO₂ is auto-filled for linked fuel activities and summed across multiple non-biogenic sources (for example biodiesel entered in Scope 1 and Scope 3.6).

Documentation

• Short overview: README.md
• Full guide: docs/DOCUMENTATION.md

License

MIT for code. UBA emission factors are CC0 1.0 (Public Domain).