diff --git a/prompt.txt b/prompt.txt index 2a95b26..e8ff9a8 100644 --- a/prompt.txt +++ b/prompt.txt @@ -7,7 +7,7 @@ Für das Frontend verwendest du reines Javascript (Vanilla Javascript). Als CSS-Framework für das Frontend kommt pico.css zum Einsatz. Weil die Webanwendung primär eine Kartenanwendung sein wird, wird leaflet als Javascript Bibliothek eingesetzt. -Die Zugriffe verschiedener Clients sollen mittels Websocket synchronisiert werden. Dazu muss im Server ein Routing implementiert werden, das Clients mit unterschiedlichen Accounts voneinander trennt und individuelle bedient. +Die Zustände der Anwendung soll für die verschiedenen Clients mittels Websocket synchronisiert werden. Dazu muss im Server ein Routing implementiert werden, das Clients mit unterschiedlichen Accounts voneinander trennt und individuelle bedient. Für die Kommunikation mittels Websocket soll ein eigenes Protokoll implementiert werden, dass ID's für Sender und Empfänger, einen Code zur Unterscheidung verschiedener Nachrichtentypen und ein Textfeld für die Nachricht vorsieht. Zu Beginn der Websocketkommunikationn muss die Webseite sich nach dem Login über den Websocket selbst auch authentifizieren. Dazu ruft die Webseite nach dem Neuladen mittels AJAX die aktuellen Attribute aller Entitäten 1) und 2) ab und erhält mit diesem Request auch ein Zugriffstoken, den sie bei der Websocketkommunikation zur Authentifizierung verwendet. @@ -19,7 +19,7 @@ Die Kartenansicht dient der Darstellung und Manipulation verschiedener Entitäte a) ID b) Name c) State (mindestens: unbearbeitet, in Bearbeitung, erledigt) - d) Zuweisung zu einer Gruppe + d) Verknüpfung mit einer Gruppe (1:1) oder null beim State "unbearbeitet" e) Hausnummer mininmal f) Hausnummer maximal g) Bounding Box (Geokoordinaten für Nordwest- und Südost-Ecke) @@ -66,7 +66,42 @@ Neben den oben erwähnten Views für die Administration und ein View für das Lo Wir beginnen mit der Serverseite und implementieren die wichtigsten Funktionen des Backends. -... +Zentral ist der Broker, der die Websocketverbindungen verarbeitet. + +Damit die Anwendung benutzt werden kann, müssen zuerst die wesentlichen Funktionen der Zugriffe auf die Entitäten implementiert werden: +1) Strassen: + a) Abstraktionsschicht für die lesenden und schreibenden Datenbankzugriffe + b) Ein Handler, der den AJAX Request nach Neuladen eines Views behandelt und dazu ein JSON Dict mit allen Attributen einscließlich des aktuellen States versendet. + c) Eine Funktion, die Änderungen an Attributen einer Strasse in die Datenbank schreibt und mit dem neuen Attribut eine Nachricht über den Websocket Broker verschickt. + +2) Gruppen: + a) Die Daten dazu werden beim Start der Anwendung und nach explizitem Invalidieren aus der Datenbank ausgelesen und im Speicher vorgehalten um die Performance zu gewährleisten. + b) Schreibende Zugriffe auf die Gruppen Daten werden zusätzlich zur In-Memory-Datenhaltung auch in die Datenbank geschrieben. + c) Eine Funktion, die prüft, ob ein Account mit einer Gruppe verknüpft ist. + d) Eine Funktion, die alle mit einer Gruppe verknüpften Accounts zurückgibt + e) Eine Funktion, die alle mit einer Gruppe verknüpften Strassen zurückgibt + f) Ein Handler, der den AJAX Request nach Neuladen eines Views behandelt, der ein JSON Dict mit allen Attributen einscließlich des aktuellen States sendet. + g) Eine Funktion, die Änderungen an Attributen einer Strasse in die Datenbank schreibt und mit dem neuen Attribut eine Nachricht über den Websocket Broker verschickt. + h) Bei allen Aktionen des zugehörigen Verwaltungsviews wird die In-Memory-Datenhaltung invalidiert. + +3) Accounts: + a) Abstraktionsschicht für die lesenden und schreibenden Datenbankzugriffe + b) Eine Funktion, die den Passworthash mit dem übertragenen Passwort auf kryptografische Gültigkeit vergleicht + c) Eine Funktion, die prüft, ob der Account einer bestimmten Rolle angehört + d) Eine Ablage von Zugriffstokens für die jeweilige Session + +Protokoll der Websocketkommunikation: +Der Broker verarbeitet eingehende Nachrichten aus den Websocketverbindungen, indem zuerst der Code der Nachricht ausgewertet wird: +- Ein Code < 100 dient nur zu internen Zwecken. Die Nachricht wird nicht auf der Weboberfläche angezeigt. +- Code = 100: Der State einer Straße hat sich geändert. Diese Nachricht wird an alle Accounts Dispatcher, Gast, Beobachter und die Gruppen verschickt, die mit dieser Straße verknüpft sind. Inhalt des Textes ist JSON mit den Attributen Name und State der Straße sowie der auslösende Account. +- Code = 200: Der State einer Gruppe hat sich geändert. Diese Nachricht wird an alle Accounts Dispatcher, Beobachter und an die betroffene Gruppe geschickt. Inhalt des Textes ist JSOn mit dem neuen State, der Gruppen ID und dem auslösenden Account. +- Code = 300: Die geographische Position einer Gruppe hat sich geändert. Diese Nachricht wird an verbundene Accounts Dispatcher, Beobachter und an die betroffene Gruppe geschickt. Inhalt des Textes ist JSON mit den neuen Geokoordinaten und dem auslösenden Account. +- Code = 1000: Ein Dispatcher versendet eine Nachricht an alle Accounts des Typs Dispatcher, Beobachter und alle Gruppen (Broadcast). Inhalt des Textes ist Freitext aus der Nutzeroberfläche eines Dispatcher-Views oder Dispatcher-Mobil-Views. +- Code = 1100: Ein Dispatcher versendet eine Nachricht an alle Accounts des Typs Dispatcher, Beobachter und eine spezielle Gruppe. Inhalt des Textes ist Freitext aus der Nutzeroberfläche eines Dispatcher-Views dem der Aliasname der Gruppe vorangestellt wird. +- Code = 2000: Eine Gruppe versendet eine Nachricht an alle Accounts des Typs Dispatcher und Beobachter. Inhat des Textes ist JSON mit der Gruppen ID und Freitext aus der Nutzeroberfläche des Gruppen-Views. + +Entwickel dazu den notwendigen Python Code. Lege diesen in einer strukturierten Weise in einem Projekt an, das bereits die Grundlagen einer Flask Anwendung enthält. +Gib das Kommando zum Starten eines Entwicklungswebservers für diese Flask-Anwendung an. ------8<-----------------