Soft-Creation System Documentation

⚡ Willkommen zur Dokumentation von Softwaresystemen von Soft-Creation

🎯 Über das System

Die hier dokumentiere Software besteht aus verschiedenen Teilen:

  • Blazor WebAssembly Client - Responsive Web-Frontend
    • EnergyTracker - Front-End zur Erfassung von Zählerständen und Anzeige der erfassten Stände
  • ASP.NET Core Web API - Hochperformante Backend-Services
    • als Schnittstelle zur MongoDB
    • als Service für Business Logics
  • MongoDB Database - Skalierbare Datenpersistierung
  • Automated CI/CD Pipeline - GitHub Actions Deployment
    • Sowohl Front-End(s) als auch Back-End(s) werden per CI/CD Pipeline auf dem Server System deployed.

🚀 Quick Start

Für Entwickler und DevOps

Deployment Workflow

System Overview EnergyTracker

  • Zero-Downtime Deployments via GitHub Actions
  • Automated Backups vor jedem Deployment
  • Health Checks für alle Services

📈 Energy Tracking

  • Dual Chart System: Zählerstände + Perioden-Verbrauch
  • Zeit-Navigation: Flexible Zeitraum-Auswahl (1 Woche bis 1 Jahr)
  • Real-time Updates: Live-Datenvisualisierung mit Chart.js
  • Mobile Optimiert: Touch-freundliche Bedienung

📚 Technische Dokumentation

  • JWT Token System mit automatischem Refresh
  • Rate Limiting für Login-Versuche
  • CORS Protection für Cross-Origin-Sicherheit
  • SSL/TLS Encryption für alle Verbindungen

📊 Live System

🏗️ Architektur-Übersicht

graph TB
    subgraph "Client Applications"
        Web[Blazor WebAssembly<br/>energytracker.soft-creation.de]
        Mobile[MAUI Mobile App<br/>iOS/Android]
    end
    
    subgraph "Backend Services"
        API[DataService API<br/>dataservice.soft-creation.de]
        Auth[JWT Authentication]
    end
    
    subgraph "Data Layer"
        MongoDB[(MongoDB<br/>EnergyLog Database)]
    end
    
    subgraph "Infrastructure"
        Ubuntu[Ubuntu Server 24.04]
        Nginx[nginx Reverse Proxy]
        Apache[Apache2 Web Server]
    end
    
    Web --> API
    Mobile --> API
    API --> Auth
    API --> MongoDB
    
    Nginx --> Web
    Nginx --> API
    Apache --> Web

🔧 Technologie-Stack

Komponente Technologie Version
Frontend Framework Blazor WebAssembly .NET 8
Backend Framework ASP.NET Core Web API .NET 8
Mobile Framework .NET MAUI .NET 8
Database MongoDB 8.0.12
Web Server nginx + Apache2 1.24.0 + 2.4.58
Operating System Ubuntu Server 24.04.3 LTS
CI/CD GitHub Actions -
SSL Certificates Let's Encrypt Auto-renewal

🏆 Status & Metrics

  • Deployment: ✅ Production Ready
  • Testing: ✅ Automated CI/CD Pipeline
  • Documentation: ✅ Comprehensive API Docs
  • Performance: ✅ Optimized & Cached
  • Security: ✅ JWT + HTTPS + Rate Limiting
  • Mobile Support: ✅ Cross-Platform MAUI App

📞 Support & Contributing

Last Updated: August 2025 Documentation Version: 1.0.0

Edit this page