Files
Sternsinger/prompt.txt
T
2026-10-22 00:25:39 +02:00

112 lines
8.9 KiB
Plaintext

Du bist ein erfahrener Entwickler für Web-Anwendungen. Du erklärst Architekturentscheidungen bevor Code erzeugt wird.
Dazu benutzt du auch Diagramme, die Modulzusammenhänge mit den Schnittstellen und wesentliche Abläufe erläutern.
Die Webanwendung soll als Projektnamen CMBNet haben. Code und Webseitenkomponenten sollen in dem Projektverzeichnis gut strukturiert abgelegt werden.
Als Technik verwendest du serverseitig Python3 mit Flask als Framework.
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 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.
Die Webanwendung soll mandantenfähig sein. Dazu soll im Datenmodell bei jeder Entität auch eine ID für den Mandanten vorgesehen sein. In der URL der jeweiligen Webzugriffe ist der Mandant codiert, Accounts beziehen sich eindeutig auf einen Mandanten.
Die Kartenansicht dient der Darstellung und Manipulation verschiedener Entitäten mit Attributen, deren Applikationslogik später entwickelt wird:
1) Strassen
a) ID
b) Name
c) State (mindestens: unbearbeitet, in Bearbeitung, erledigt)
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)
2) Gruppen
a) ID
b) State (offen, unterwegs, online, pausierend, fertig)
c) Letzte geographische Position mit Datum und Uhrzeit
d) Aliasname
e) Verknüpfung mit Account (1:n)
3) Accounts
a) ID
b) Name
c) Rolle (Gast, Beobachter, Gruppe, Dispatcher, Administrator)
d) Passwordhash
Von Beginn an soll ein Zugangsschutz mittels Accounts eingebaut sein.
Für einen Account mit der Rolle eines Administrators sind spezielle Views bzw. Webseiten aufrufbar, die ausschließlich der Verwaltung (Anlegen, Bearbeiten, Löschen) der verschiedenen Entitätstypen dienen:
- Accountverwaltung: Nutzer anlegen mit Namen, Rolle, Passwordhash
- Gruppenverwaltung: Anlegen, Attribute verändern, Gruppe löschen, mit einem oder mehreren Accounts verknüpfen
- Strassenverwaltung: Hier soll mittels Dateiupload eine csv-Datei importiert werden, aus der die Entitäten extrahiert werden. Danach sollen hier auch einzelne Einträge editierbar sein und gelöscht werden können.
Alle Transaktionen auf diesen Entitäten sollen in ein Logfile lesbar mit Zeitstempel geschrieben werden.
Über State-Wechsel von 1) und 2) soll eine Historie mit Datum/Uhrzeit-Stempel geführt werden, die in der jeweiligen Verwaltungsseite aufrufbar ist. Durch Anklicken eines alten States soll dieser State wieder gültig werden, z.B. die geographische Position wird wieder darauf zurückgesetzt.
Alle Daten sollen mandantenfähig in einer SQLite3 Datenbank verwaltet werden.
Zur Administrierung der Entitäten sollen eigene Webseiten vorgesehen werden, die einem Account mit Administratorrechten das Anlegen, Löschen und Editieren erlauben.
Beschreibe zunächst in einer Architekturskizze, wie der grundsätzliche Aufbau des Projekts CMBNet mit diesen Vorgaben zur Darstellung unterschiedlicher Views aussehen wirfd.
------8<-----------------
Neben den oben erwähnten Views für die Administration und ein View für das Login soll es folgende Views geben:
- Dispatcher-View: Optimiert für Desktopansicht mit allen Informationen und Interaktion
- Präsentations-View: Alle Informationen aber Interaktion beschränkt auf Suche, keine Modifikatin von Entitäten
- Öffentlicher-View: Wie Präsentations-View aber ohne Berücksichtigung von Gruppen
- Dispatcher-Mobil-View: Ein für Smartphone-Nutzung optimierter Dispatcher-View mit selektiver Auswahl der dargestellten Entitäten
- Gruppen-View: Ein für Smartphone-Nutzung optimierter View für einen Account einer Gruppe, der nur Daten dieser Gruppe anzeigt und State-Wechsel erlaubt.
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<-----------------
Jetzt werden die drei Verwaltungsviews, der Login-View und als Prototyp eine einfache Variante des Dispatcher-Views für das Frontend angelegt.
...
------8<-----------------