MiracleList ist eine Aufgabenverwaltung und ein komplettes Fallbeispiel einer modernen Single-Page-Webanwendung (SPA), bestehend aus einem Backend (in C# mit ASP.NET Core geschrieben), einem Web-Frontend (in mehreren Varianten mit Angular, Vue.js und Blazor) sowie Cross-Platform-Apps für Linux, macOS, Windows, Android und iOS (mit Hilfe von Electron und Cordova bzw. Blazor Desktop aus dem Web-Frontend erzeugt).

MiracleList dient Test- und Weiterbildungszwecken, d.h. MiracleList wird sowohl in den Schulungen als auch in den Fachbüchern von www.IT-Visions.de behandelt.

Szenario

Im Jahr 2015 zahlte Microsoft für die Übernahme des Berliner App-Herstellers Wunderlist mehr als 100 Millionen US-Dollar. Mittlerweile hat Microsoft Wunderlist sterben lassen zugunsten einer Neuimplementierung unter dem Namen Microsoft TODO".

MiracleList ist eine Nachprogrammierung der Wunderlist-Aufgabenverwaltung mit verschiedenen Web- und Cross-Platform-Techniken.

Der angemeldete MiracleList-Benutzer kann eine Liste von Aufgabenkategorien erstellen und in jeder Kategorie eine Liste von Aufgaben anlegen. Eine Aufgabe besteht aus einem Titel, einer Notiz, einem Eintragsdatum, einem Fälligkeitsdatum und kann als erledigt markiert werden. Über die Funktionen von Wunderlist hinaus kann in MiracleList eine Aufgabe drei (A, B oder C) statt nur zwei Wichtigkeitsgrade (Wichtig ja/nein) sowie einen Aufwand (Zahl) besitzen. Bewusst besitzt der Aufwand keine Maßeinheit; der Benutzer kann selbst entscheiden, ob er den Aufwand in Stunden, Tagen oder nur in relativen Werten, wie z.B. "1" (für niedrig) bis "10" (für hoch), vergeben will.

Wie bei Wunderlist kann eine Aufgabe Teilaufgaben besitzen, wobei eine Teilaufgabe nur einen Titel und einen Status besitzt. Einige Details aus dem Original fehlen aber in MiracleList, z.B. das Hochladen von Dateien zu Aufgaben, das Verschieben von Aufgaben zwischen Kategorien, die Suche nach Hashtags, das Duplizieren und Drucken von Listen sowie der Aufgabenaustausch zwischen Benutzern. Einige Funktionen wie anklickbare Hyperlinks in Aufgabentexten sind nicht realisiert, um einen Missbrauch der für alle Nutzer offenen Website zu vermeiden. Ganz bewusst sind einige Prozesse stark vereinfacht (z.B. das Benutzeranmeldeverfahren), um die Hürde zum Einstieg in die Anwendung gering zu halten.

Live-Systeme in der Cloud

Die fertige Webanwendung läuft öffentlich im Internet (Microsoft Azure-Cloud):

Download Desktop-Versionen

Quellcode

Architektur des Cross-Platform-.NET-Servers

Beim MiracleList-Backend kommen dabei folgende Techniken zum Einsatz:
  • Aktuelles .NET (als Laufzeitumgebung)
  • C# (als Programmiersprache)
  • ASP.NET Core (für die WebAPI-REST-Dienste und die wenigen serverseitig erzeugten Webseiten)
  • Entity Framework Core (als ORM-Mapper)
  • SQL Azure (als Datenbank)
  • Azure Web App (als Webserver in der Cloud)
  • Swagger/Swashbuckle.AspNetCore (für die Bereitstellung von Metadaten für die WebAPI-REST-Dienste)
  • Application Insights (für die Anwendungsüberwachung)
Live in der Azure-Cloud Quellcode auf GitHub

Architektur des Web-Clients (Variante mit Vue.js)

Das Frontend von MiracleList ist eine Single Page Web Application (SPA) mit
  • HTML, CSS (Benutzeroberflächenbeschreibung)
  • Bootstrap (Benutzeroberflächenbeschreibung, Vereinfachung für CSS)
  • TypeScript (Programmiersprache)
  • Vue.js (SPA-Framework inklusive Trennung UI- und Benutzerschnittstellensteuerung, Routing)
  • MomentJS (Verarbeitung von Datumswerten)
Live in der Azure-Cloud Quellcode auf GitHub

Architektur des Cross-Platform-HTML-Clients (Variante mit Angular)

Das Frontend von MiracleList ist eine Single Page Web Application (SPA) mit
  • HTML, CSS (Benutzeroberflächenbeschreibung)
  • Bootstrap (Benutzeroberflächenbeschreibung, Vereinfachung für CSS)
  • TypeScript (Programmiersprache)
  • Angular (SPA-Framework inklusive Trennung UI- und Benutzerschnittstellensteuerung, Routing und AJAX)
  • MomentJS (Verarbeitung von Datumswerten)
  • sowie den Angular-Zusatzkomponenten
  • angular2-moment (Darstellung von Datums- und Zeitraumangaben)
  • ng2-datetime (Datumsauswahlsteuerelement)
  • ngx-contextmenu (Kontextmenüs)
  • ngx-modal (Modale Dialoge)
  • ng2-dnd (Drag and Drop)

Einige der eingesetzten Angular-Komponenten von Dritten tragen noch die "2" im Namen, auch wenn es bereits Angular 4, 5 oder höher gibt. Sie laufen dennoch auf den neueren Versionen. Viele Komponentenentwickler wollen sich mit der "2" einfach abgrenzen von den Komponenten für AngularJS 1.x.

Zudem gibt es das Frontend als hybride Cross-Platform-App:
  • Mit Hilfe von Electron für Windows, Linux und macOS
  • Mit Hilfe von Cordova für Android und iOS
Live in der Azure-Cloud Quellcode auf GitHub

Architektur des Web-Clients (Variante mit Blazor)

Das Frontend von MiracleList ist eine Single Page Web Application (SPA) mit
  • HTML, CSS (Benutzeroberflächenbeschreibung)
  • Bootstrap (Benutzeroberflächenbeschreibung, Vereinfachung für CSS)
  • C# (Programmiersprache)
  • Blazor WebAssembly bzw. Blazor Server (SPA-Framework inklusive Trennung UI- und Benutzerschnittstellensteuerung, Routing und AJAX)
Zudem gibt es das Frontend als hybride Cross-Platform-App:
  • Mit Hilfe von Blazor Desktop für Windows
  • Mit Hilfe von Blazor MAUI für Android, iOS, macOS und Windows
Live in der Azure-Cloud (Blazor Server) Live in der Azure-Cloud (Blazor WebAssembly) Quellcode im Blazor-Buch

MiracleList-Client-Features

Nicht alle MiracleList-Funktionen sind in bereits in allen Clients implementiert.

MiracleList "Light" XAML 2-Tier

Die Light-Variante von MiracleList greift nicht auf das MiracleList-Backend zu, sondern nutzt via Entity Framework Core direkt eine lokale Datenbank oder ein DBMS im Netzwerk. Das Frontend gibt es in allen aktuellen XAML-Varianten: WPF, UWP, WinUI3, Xamarin und .NET MAUI. Die App läuft damit auf Windows, Android, iOS, macOS und Tizen.

Quellcode im Entity Framework Core-Buch

Beratung & Support

Schulungen zu diesem Thema

 Microservices erstellen und betreiben (mit ASP.NET, ASP.NET Core, Java oder node.js)
 ASP.NET Core 7.0 - Änderungen und Neuerungen gegenüber ASP.NET Core 6.0
 Umstieg auf ASP.NET Core 6.0/7.0-Webanwendungen in .NET 6.0/7.0 (Umstellung/Migration von klassischen ASP.NET-Webanwendungen auf ASP.NET Core)
 Neuerungen in .NET Core 2.0 gegenüber Version 1.x (inkl. ASP.NET Core, Entity Framework Core)
 ASP.NET SignalR / ASP.NET Core SignalR
 Umstieg von .NET-Desktop-Entwicklung (WPF/Windows Forms) auf Webentwicklung (ASP.NET/ASP.NET Core + JavaScript/TypeScript mit Webframeworks wie Angular, Vue.js oder React)
 Tipps & Tricks für bessere Websites/Webanwendungen mit ASP.NET Core
 ASP.NET Core Blazor (Blazor WebAssembly und/oder Blazor Server und/oder Blazor Hybrid)
 ASP.NET Core WebAPI 6.0/7.0: REST Services/HTTP Services/Microservices
 Umstieg auf ASP.NET Core WebAPI und Google RPC (gRPC) in .NET 6.0/7.0 (Umstellung/Migration von ASP.NET WebAPI und/oder WCF in .NET Framework auf ASP.NET Core und gRPC in .NET 6.0/7.0)
 Neuerungen in .NET Core 3.0/3.1 gegenüber Version 2.x (inkl. ASP.NET Core, Entity Framework Core, WPF und Windows Forms)
 ASP.NET Core 6.0/7.0: komplettes Wissen - mit MVC, Razor Pages, Blazor, WebAPIs und gRPC
 Sichere Webanwendungen mit IIS und ASP.NET / ASP.NET Core
 Neuerungen in .NET Core 2.1/2.2 gegenüber Version 2.0 (inkl. ASP.NET Core, Entity Framework Core)
 .NET Akademie: Blazor-6.0-Hands-On: Echte Single-Page-Web-Apps mit .NET und C# entwickeln (3-Tages-Agenda des öffentlichen Seminars)
 Web-Frameworks (JavaScript- und TypeScript-Bibliotheken) im Überblick und Vergleich
 Webbrowser-Programmierung mit JavaScript und Dynamic HTML (DHTML)
 Webstorm (JavaScript-IDE von JetBrains)
 Plattformneutrale Hybrid-Anwendungen mit HTML5 und JavaScript (oder TypeScript) unter Einsatz von Chromium und Electron (Hosted/Hybrid Web Apps)
 Windows Modern Apps/Windows Universal Apps entwickeln mit der Windows Runtime (WinRT), HTML/CSS und JavaScript sowie WinJS
 RxJS (Reactive Programming Library for JavaScript)
 Kendo UI - HTML5/JavaScript-Webanwendungen mit Progress/Telerik Kendo UI
 Geschäftsanwendungen mit HTML 5.x und JavaScript (oder TypeScript): Moderne Web 2.0-/HTML5-Browser-Webanwendungen und Mobilanwendungen entwickeln
 JavaScript und moderne Webanwendungen/Cross-Platform-Anwendungen für Entscheider
 Windows 8/Windows 8.1 für Entwickler: Programmierung mit der Windows Runtime (WinRT) - Erstellen von Windows Apps mit C#/XAML und/oder JavaScript/HTML
 Moderne Web-Anwendungen mit ASP.NET (Core) MVC, WebAPI, HTML5.x/CSS3 und JavaScript-/TypeScript-Frameworks
 Unit Testing / Testgetriebene Entwicklung / Test Driven Development (TDD) mit JavaScript/TypeScript
 JavaScript und TypeScript für die moderne Web- und App-Entwicklung
 Neuerungen für JavaScript: ECMAScript 2015 (Version 6) / ECMAScript 2016 (Version 7) / ECMAScript 2017 (Version 8) / ECMAScript 2018 (Version 9)
 Meteor: Moderne Web- und Mobil-Anwendungen mit JavaScript (oder TypeScript) auf der Meteor-Plattform
 Anfrage für eine individuelle Schulung zum Thema ASP.NET Core Blazor JavaScript TypeScript Angular Vue.js  Gesamter Schulungsthemenkatalog