OrgaMon Wiki - Benutzerbeiträge [de]

Linux.postfix

2026-04-28T17:24:01Z

Root: /* Diagnose Möglichkeiten */

== Ziel ==

* Kompletter Mail - Server, der von innen wie von aussen kontaktiert werden kann (via pop3,smtp). Er soll für mehrere Domain-Namen und noch mehr Benutzer (alle auf die eigene ServerIP gebunden) die Post verwalten und natürlich kein offenes Relay sein.

== Voraussetzungen ==

=== Feste IP ===

* ein Linux Server mit fester IP Adresse. Meine, bei t-com bestellte feste IP ist z.B.

217.91.31.84

* Du legst eine Domain auf diese IP, das nennen wir ab jetzt <MailAgentDomain>

=== PTR Record ===

* einen PTR Eintrag deiner IP Adresse, ab jetzt <ReverseHost> bezeichnet

host -t PTR <DeineFesteIP>

# Bei mir ergibt das z.B. pd95b1f54.dip0.t-ipconnect.de
# Leider ist es nicht möglich diesen Eintrag zu belassen, das einigen Mail Server,
# so z.B. aol diese Art von Hostnamen so gar nicht mögen. Die meinen dann, man hätte
# einen dynamische IP Adresse, und man versuche sich als Mailserver aufzuführen. Leider
# löst der Ziel- Mailserver die Absender Domain nicht auf, sonst würde er erkennen
# das die IP der Versende-Identität sowie die Identität des senders decken, also
# offensichtlich kein relay verwendet wird. Meiner Meinung nach unberechtigt der
# Ablehnende Fehlercode :
#
# 554-: (DNS:B2) http://postmaster.info.aol.com/errors/554dnsb2.html
#
# Fehler 1)
#
# Bezieht man von der t-com eine feste IP, kommt die aus einem zweifelhaften pool,
# man sollte diese mit einem schönen PTR Eintrag versehen, so z.B.
# HSGWBSGA.t-com-festeip.de
# dann müsste man keinen eigenen PTR Eintrag ersinnen.
#
# Fehler 2)
#
# "riecht" der PTR Eintrag nach dynamischer IP sollte die püfung der Versende
# Identität erfolgen. Ist der A Eintrag wieder die selbe Adresse, so ist das ja
# wohl mehr als Beweis, da die IP Adresse und PTR 100% OK ist.
#

=== MX Record ===

* bei allen Domains die der Mailserver hosten soll, muss der ReverseHost von oben als der MX Eintrag gemacht sein. So bekommen wir einen ganz soliden MX Eintrag, der den neuesten Forderungen (PTR-fest) entspricht.

host -t MX <DeineMailDomain>

# sollte als Ergebnis also pd95b1f54.dip0.t-ipconnect.de
# ergeben!

=== SPF Record ===

* Es ist ein TXT Record in <DeineMailDomain> der aussagt WER zuständig für den ausgehenden Mailversand ist
* Es verbessert nicht die Anzahl der Spam-Mails, die Dich erreichen
* Es verbessert aber die Anzahl der Spam-Mails in der Welt, die als Absender <DeineMailDomain> missbrauchen, da Du hiermit erklärt hast, welche SendeServer Du benutzt. Alle anderen gelten als nicht berechtigt.
* In unserem Fall, ist der berechtigte unser MX, sonst niemand:
** <code>v=spf1 mx -all</code>
* Test mit http://spf.myisp.ch/

=== DKIM ===

* https://kofler.info/dkim-konfiguration-fuer-postfix/

=== DMARC ===

* Typischer Snake-Oil Mechanismus der nur scheinbar die Sicherheit erhöht, der _dmarc TXT Record muss bei der Mail-Domain hinzugemacht werden, nicht bei der mx Domain

* https://support.google.com/a/answer/2466563?sjid=13818195432106118449-EU

_dmarc TXT v=DMARC1; p=reject; rua=mailto:postmaster@orgamon.org

== Aktivierung der notwendigen Dienste ==

Neuere Implementierung hier: [[Raspberrypi.mail]]

Wir verwenden das bebliebte Postfix Programm. Es ist sehr umfassend, dennoch kann man die Schritte, die man braucht um alles aufzusetzen (nach Wochen der Forschung) an 2 Händen abzählen. Also wie immer: Die Details später, erst mal soll es funktionieren!

zypper install cyrus-sasl-saslauthd
chkconfig --add postfix
chkconfig --add saslauthd
rcpostfix start
rcsaslauthd start

== main.cf ==

<code>
queue_directory = /var/spool/postfix
command_directory = /usr/sbin
daemon_directory = /usr/lib/postfix
mail_owner = postfix
myorigin = $myhostname
inet_interfaces = all
unknown_local_recipient_reject_code = 550
mynetworks_style = subnet
mynetworks = 192.168.115.0/8, 127.0.0.0/8
smtpd_banner = $myhostname ESMTP $mail_name OrgaMon(tm)
debug_peer_level = 2
debugger_command =
PATH=/bin:/usr/bin:/usr/local/bin:/usr/X11R6/bin
xxgdb $daemon_directory/$process_name $process_id & sleep 5
sendmail_path = /usr/sbin/sendmail
newaliases_path = /usr/bin/newaliases
mailq_path = /usr/bin/mailq
setgid_group = maildrop
html_directory = /usr/share/doc/packages/postfix/html
manpage_directory = /usr/share/man
sample_directory = /usr/share/doc/packages/postfix/samples
readme_directory = /usr/share/doc/packages/postfix/README_FILES
biff = no
mail_spool_directory = /var/mail
canonical_maps = hash:/etc/postfix/canonical
virtual_maps = hash:/etc/postfix/virtual
relocated_maps = hash:/etc/postfix/relocated
transport_maps = hash:/etc/postfix/transport
sender_canonical_maps = hash:/etc/postfix/sender_canonical
masquerade_exceptions = root
masquerade_classes = envelope_sender, header_sender, header_recipient
program_directory = /usr/lib/postfix
masquerade_domains =
myhostname = mx.orgamon.org
mydomain = orgamon.org
mydestination = localhost, $myhostname, localhost.$mydomain
local_recipient_maps = $alias_maps unix:passwd.byname
defer_transports =
disable_dns_lookups = no
relayhost =
mailbox_command =
mailbox_transport =
smtpd_sender_restrictions = hash:/etc/postfix/access
smtpd_client_restrictions =
smtpd_helo_required = no
smtpd_helo_restrictions =
strict_rfc821_envelopes = no
smtpd_recipient_restrictions = permit_sasl_authenticated, reject_unauth_destination
smtpd_sasl_auth_enable = yes
smtp_sasl_password_maps = hash:/etc/postfix/sasl_passwd
smtpd_sasl_local_domain = raib90
smtpd_sasl_security_options = noanonymous
smtpd_sender_login_maps =
broken_sasl_auth_clients = yes
smtpd_use_tls = no
smtp_use_tls = no
alias_maps = hash:/etc/aliases
mailbox_size_limit = 99999999
message_size_limit = 99999999
</code>

== Anlegen eines neuen eMail Postfaches (und die Zuordnung zu einem Benutzer) ==

YaST2->Sicherheit und Benutzer->Benutzer bearbeiten und anlegen
<Alt><H>(für Hinzufügen)
Daten ensprechende Eintrag:
POP3 Konto ist der Benutzername
POP3 Passwort ist das normale Password
Die Gruppenrechte entsprechend völligst minimal einstellen.
[x] Leeres Home
Standard-Gruppe "postfix"
Gruppenzugehörigkeit nur "postfix!"
Einen Login verhindern, diese Benutzer dürfen ausschliesslich via popper ihre eMails abholen!

-- Mailname korrekt einstellen
joe /etc/postfix/virtual
unten Eintragen:

domain.tld DOMAIN
vorname.nachname@domain.tld Benutzername@localhost

# Bemerkung:
# ==========
# Die erste Zeile "domain.tld" muss nur 1x pro gehostetem Domainname
# als "überschrift" über alle User dieser Domain eingetragen werden
# damit wird postfix klargemacht, dass es für diese Domains zuständig
# ist.

-- das ganze compilieren mit postmap

postmap /etc/postfix/virtual

-- die ganzen Änderungen jetzt bekannt machen
postfix reload

== Anlegen einer Weiterleitung ==

Für eine reine Weiterleitung brauchen wir keinen neuen Benutzer anlegen. Es reicht ein Eintrag in die "virtual".

joe /etc/postfix/virtual

domain.tld DOMAIN
name@domain.tld weiter.leitungs.ziel@fremder-domain.tld

postmap /etc/postfix/virtual

== POP3 Dienst starten ==

* Damit die eMails auch abgeholt werden können muss im YaST bei den Netzwerk-Diensten (inetd/xinetd) noch der "pop3" "(q)popper" Dienst aktiviert werden.

== Diagnose Möglichkeiten ==

Zum Test braucht man unbedingt eine funktionierende Mail Adresse, die von einem externen Server aus operiert. Mit dieser identität kann man nun den eigenen Mail Server auf seine Funktion hin testen.

# in diesem Verzeichnis befinden sich die Mail aller Benutzer (INBOX).
# Pro Postfach wird eine Datei mit dem Dateinamen = Benutzername
# geführt. Ist diese > 0 Bytes hat der Benutzer unabgerufenen Mail
# Dateidatum und Uhrzeit zeigt den Zeitpunkt der Zustellung der
# letzten Mail.

/var/mail

# wichtige Informationsquelle bei Störungen

/var/log/mail.*

# Anzeigen des im Moment gültigen Wertes einer Einstellung.

postconf <ParameterName>

# Statistik mit interessanten Zusammenfassungen

pflogsumm /var/log/mail.log

Linux.postfix

2026-04-28T17:23:43Z

Root: /* Diagnose Möglichkeiten */

Polyzalos

2026-03-20T16:40:41Z

2026-03-07T20:19:06Z

Root: /* Rückkanal */

{{Anmerkung|Polyzalos befindet sich noch in Entwicklung, eine erste Demo erschien 2023, mit einer ersten Anwendung wird in 2027 gerechnet}}

== Was ist Polyzalos ==

Polyzalos ist ein Technologie-Update des OrgaMon, mit folgenden Innovationen: 

* Lazarus/FreePascal wird als Programmiersprache verwendet (bisher Delphi)
* ([[Arch]]-)Linux ist die einzige Zielplattform (bisher Win32)
* Es wird ein Server-Dienst unter Linux sein, eine reine Konsolen-Anwendung die via systemd.socket gestartet wird (bisher Windows Anwendung)
* Das Benutzerinterface läuft in einem Browser (bisher Windows-UI)
* Es werden keine proritären Tools (Delphi, IBObjects, FlexCell) mehr verwendet - es ist 100% Open-Source (Lazarus 4.4, Zeos 8.0, fpspreadsheet 2.0)
* Anstelle des "GPL-3.0-or-later" Lizenz wird die "MIT" Lizenz verwendet
* Keine Trennung mehr wie bisher zwischen cOrgaMon und OrgaMon

Was bleibt so wie es ist: 

* der bisherige Funktionsumfang und Mehrwert
* Ein OrgaMon-Verzeichnis im Netzwerk (Mehrplatz-System) oder in .\Dokumente (Einzelplatz-System)
* Firebird als Datenbank-Server mit der bisherigen Datenbank-Struktur

== Wie nutzt man Polyzalos ==

* Start der Anwendung: Ein Web-Browser (Chrome oder Firefox) wird gestartet mit der URL des installierten polyzalos-Servers (z.B. <code>https://polyzalos.joe.local.net/</code>)
* der Server (hier <code>joe</code>) dieser Website kann aber auch ein lokales <code>polyzalos</code>-Binary sein (https://local.orgamon.net/)
* der Server kann auch remote eine VM ist Netzwerk, ein dezidierter Server im Netzwerk oder ein Server in der Cloud sein
** Unsicher ist noch, ob immer eine lokale polyzalos Installation notwendig ist - kommt wohl darauf an von wo aus das OrgaMon-Verzeichnis zugreifbar ist
* Das UI läuft als Web-Code (CSS,HTML5,JavaScript) und erledigt triviale Berechnungen sowie Eingabeprüfung, TAB-Reihenfolgen, Text-Editor, Einfärben von DB-Eingabefeldern
* komplexe Aktionen (Login in einen Server, PDF-Konvertierung, SQL Richtung DB-Server) übernimmt das lokale Binary

Download eines ersten Beispiel-Servers: 

* (Noch Win32) https://cargobay.orgamon.org/polyzalos.html
* (Linux) -- noch nicht verfügbar --
 

__TOC__

== Wie programmiert man Polyzalos ==

* In der Lazarus-IDE!
** (es wird eine Anleitung geben wie man eine Entwicklungsumgebung aufsetzt, Basis ist Arch-Linux)
** (es wird auch eine Anleitung geben wie man eigene Verbesserungen der Allgemeinheit zur Verfügung stellt)
** (der bisherige Test-Suite wird veröffentlicht werden und Neuerungen werden über Git-Actions durch einen Git-Runner geprüft)
* Neben der Datenbank-Logik sind auch Benutzer-Interaktionen im selben Quelltext vermischt
** Der Zugang zu Polyzalos-Entwicklung wird für Programmierer wesentlich einfacher werden wie der Zugang zur OrgaMon-Entwicklung
* Nach F9 soll man auf dem letzten Fokus-Element stehen und seine Änderung testen können

* Es wird immer 2fach compiliert
** Erster Compiler-Lauf: Compilierung für die Serverplattform, ein Compilat <code>./polyzalos</code> (dies inkludiert ein [[HTTP3]]-Server (Kern) mit Verarbeitungs-Code (Logik).
** Zweiter Compiler-Lauf: Compilierung nach JavaScript und Auslieferung der veränderten Code-Anteile in ein Webserver-Verzeichnis
* In Wirklichkeit ist ein Webanteil für das GUI und ein Serveranteil für die Programmlogik entstanden
* dabei werden Objekt-Methoden aufgerufen, die ggf. auf dem Client oder dem Server laufen oder beides

== Technologie ==

* sind Methoden auf dem Client nicht ausführbar (sie erfordern Server-Resourcen wie Dateisystem, Datenbank, oder complexe Bibliotheken) und erfordern somit Aktionen auf dem Server, dies erfolgt grundsätzlich "nonblocking", also der Client wartet nie, sondern setzt nur Requests ab
* sind aber Logik-Anteile des Programmes so trivial oder deren Ergebnise einfach nicht persistent, wird der Code direkt in der GUI ausgeführt ohne Beteiligung des Servers

=== Pure Pascal Prinzip ===

* Das DOM-Modell wird per Pascal-Objekt (also nach javascript compiliertes Pascal) abstrahiert, es soll kein <code>writeln('-b-fett-/b-');</code> geben
** Vegas- Prinzip (What Happens Here, Stays Here)
** Die Tatsache HTML5/CSS/JavaScript wird völlig verborgen, für den Programmierer ist ALLES Pascal
* Auf dem Client lauffähiger Code wird zu JavaScript
* Auf dem Server lauffähiger Code wird zu nativem Linux-Binary
* Der Sync der Variablen / Datenbank darf nicht die UI blockieren
* Abbruch der Verbindung zum Server darf nie ein Problem sein (Notebook-Sleep, Network-Disconnect, Timeout, Long-Timeout)
* die Server-Worker und Client-Worker müssen transaktionsgesteuert und reconnect fähig sein

=== Rückkanal ===

* Polayzalos sendet Logs und Updates lang laufender Aktionen auf der selben TCP Verbindung zum Client zu jeder Zeit ohne das Request/Answer Model
** https://html.spec.whatwg.org/multipage/server-sent-events.html#parsing-an-event-stream
* Dazu öffnet der Client über JavaScript "EventSource()" über die HTTP/2 Stream ID kannn der Netzwerkverkehr hier zugeordnet werden
* Client-Seite:

<script>
const source = new EventSource('/log');
source.onmessage = function(event) {
console.log('Incoming date:' + event.data);
};
source.addEventListener('notice', (event) => {
console.log(event.data)
})
</script>

=== Asynchron ===

* eine Polyzalos Anwendung läuft im Browser blockiert aber niemals um eine Antwort auf einen Server-Request zu erhalten
** Anfragen und Calls an den Server werden in eine lokale SQLite3 Datenbank geschrieben (SQLite3 in der Webassembly-Version im Browser, nativ auf dem Server)
** Ein Worker versucht Antworten vom Server zu erhalten
** Ein Worker füllt zum passenden Request die Datenbank mit Ergebnisdaten des Servers
** Der Worker ruft Callbacks des UI-OS um das jeweilige DOM von z.B. "unsaved, =gelb" auf "saved, weiß" zu stellen

=== WVCL-OS (Client) ===

* eine Polyzalos-Anwendung benutzt auf der Web-Seite eine API zu einer statischen css+html+JavaScript Monolith Web-Visual-Component-Library-Operating-System (WVCL-OS)
** UI-OS ist ein Unterprojekt von Polyzalos und soll langfristig auch die komplette IDE ins Web bringen können
** UI-OS wird eher durch Web-Leute gepflegt und weiterentwickelt und per JavaScript von der Polyzalos Anwendung gerufen
** Wird UI-OS einmal inkompatibel mit "alten" Polyzalos Anwendungen müssen moderne Anwendungen in eine bestimmte UI-OS Version hochschalten
* Um Erfahrung zu sammeln und nicht bei "0" beginnen zu müssen starte ich mit [[https://qooxdoo.org/ Qooxdoo 8.0]]

=== polyzalos.js ===

* die polyzalos.js ist das 2. Compilat das vom Webserver (integriert in polyzalos) ausgeliefert wird und vom Browser ausgeführt wird
* darin sind lokale "onButtonpressed" Events implementiert, remote- Aktionen gehen an den Service-Worker (PostMessage)

=== ServiceWorker ===

* Es wird ein ServiceWorkerGlobalScope verwendet, er sichert auch die Forderung "Offline" Funktionalität
* Er hat zugriff auf eine Persistenz (SQLite3.wasm)
* Er verarbeitet die Messages der App.js (alle messages sind im JSON Format)
* Er erstellt aus Daten der Datenbank Formulare (statefull)

==== SQLite3.wasm ====

* Only the ServiceWorker see a SQLite3 Database with forms and propertys (edit.text, grids.data)
* every Request to a "Form" is generated by the ServiceWorker with persistent Data from the DB
* The DB is synced (non-blocking) with polyzalos storage (Format is JSONB)

=== Hello World ===

<syntaxhighlight lang="pascal">
program index;

uses
p2020;

begin
writeln('Hello World!');
end.
</syntaxhighlight>

=== PolyzalosD Server ===

* Der Server hat die Möglichkeit spontan über Datenbankänderungen zu informieren
* Der Server kann Alerts beim Client ausführen
** https://www.npmjs.com/package/web-push

=== Formulardesigner ===

* Migrations-Phase: Aus der Delphi Code-Basis werden alle dfm nach lfm übernommen (132 Formulare!)
* Das Design/Redesign/Neudesign von Formularen erfolgt ab dann in der Lazarus IDE
* (unsicher) Ein grober Funktionstest kann so immer in der IDE ohne Web, mit dem Lazarus-Compilier-Ziel LCL (native GUI-Anwendung) gemacht werden
** dies wird wohl nicht für immer und ewig unterstützt, da der User genau wissen muss welche Komponenten er überhaupt verwenden kann, es wird nicht alles unterstüzt
** Zumindest solange bis Chrome unzulänglich als compile Target in Lazarus intergriert ist
** die lfm werden zum Client übertragen der sie in einer Offline-Datenhaltung speichert (Versioning der lfm-Files!)
* die lfm werden mit ihren Propertys als JSON, dann JSONB in der SQLite3 DB des ServiceWorkers gespeichert
* der Worker erzeugt auf "fetch" der app.js das Formular als html5

** Im Endausbau soll Lazarus nativ in ein Chromefenster laufen, ev. gibt es auch mal einen lfm Designer fürs Web
** die compilat erstellung soll aber immer auf einer nativen Plattform ausgeführt werden
* der Worker erzeugt aus den lfm eine wfm (HTML5-DOM) die entsprechend das Aussehen des lcl-Formulares nur grob imitiert aber
** wfm ist nicht mehr pixelgenau
** wfm baut massiv auf der Tab-Order auf, das ist die Vorgabe für das "Verständnis" der UI
** wfm ist reactive
** der Worker implementiert eine WCL welcher TButton, TListbox, TLabel kennt, und das zugehörige html5+js ausliefert

== Namensherkunft ==

=== Historie ===

* Polyzalos, originalschreibweise Πολύζαλός [[https://www.fundus.uni-hamburg.de/de/collection_records/92327]]
* poly = πολύς = viel
* zalos = ζάλος = Schaum, Schwindel, Ehrgeiz
* Polyzalos war der siegreiche Wagenlenker von Delphi
** Es wurde ein Korpus gefunden: https://commons.wikimedia.org/wiki/File:Charioteer_of_Delphi.jpg

* Sein Gewinn eines Wagenrennens (als Gespann-Eigner - nicht als Lenker) wurde einst in einem Büstenmonument verewigt
* das Monument wurde ausgegraben es ist aber nicht mehr vollständig erhalten
** So stellt sich die Wissenschaft das komplette Monument vor: http://www2.oberlin.edu/images/Art200-08/200-033.JPG
** In der Skizze steht der Siegreiche auf dem Wagen als Lenker? oder nicht? Meine persönliche Meinung ist aber dass er als "Eigner" vor den Pferden stand, die Wagenlenker sind in der Regel nackt dargestellt, der Künstler hat viel Arbeit in die Darstellung der Füße gelegt, diese wären auf dem Wagen gar nicht sichtbar) Neue Erkenntnisse sprechen aber davon, dass Polyzalos selbst Teil des Monumentes war, seine Büste aber fehlt!
** [[Datei:Zuegelhalter.png|100px]]
** https://www.john-uebersax.com/plato/plato3.htm
** Der Sponsor oder siegreiche konnte (auch) den Gewinnerkranz für sich beanspruchen, war aber bekleidet

* http://3.bp.blogspot.com/-GwzDsFa2zIA/VCy-_jfVfcI/AAAAAAAAPtY/NtwPdmJIwiM/s1600/Dwie-Judha-Satria-chariot-allegory.jpg
* https://www.khanacademy.org/humanities/ancient-art-civilizations/greek-art/early-classical/v/charioteer-delphi

=== weiter "Poly"- Bezug (=2 Pferde) ===

* 2 Pferde, Kelpies Falkirk Scotland
* Er führt ruhig einen Streitwagen mit 2 sehr unterschiedlichen Pferden (Server/Pascal, Browser/JS)
** ev. auch auseinanderstrebenden Pferden

* http://www.creaturearchives.com/animalia-chariot-allegory/

=== Bezug zu diesem Polyzalos-Projekt ===

* eines der Pferde symbolisiert die JavaScript-Seite des Browsers
* das andere Pferd symbolisiert die Pascal-Seite des Servers
* https://www.insegnadelgiglio.it/prodotto/immagini-di-gela/

== Systemvergleich ==

=== Turbo Pascal 1989 ===

* Der Compiler erzeugt Assemblercode für die x86 Plattform und hat dabei
** Knowhow über den Umgang mit Heap- und Hauptspeicher
** Knowhow über elementare Betriebssystemaufrufe für writeln, readln, AssignFile, ...
* Es wird linearer Code für das Zielsystem DOS erstellt und gestartet (.com)
* Konsolenanwendungen oder Textmode- Anwendungen sind der Standard
* Grafik wird völlig selbst berechnet und ausgegeben

=== Delphi ===

* Anwendungen sind Konsolenanwendungen oder grafische Anwendungen (Windows)
* Es wird an eine MessageLoop des Betriebssystems angedockt und so
** Click- und Mausevents verarbeitet
** Signale für die GUI verabeitet (close-Window, refresh Window usw.)
* Es wird ein Single-Thread-Code für das Zielsystem WIN erstellt und gestartet
* Formulare (GUI), es werden Objekte über deren Namen und Objekt-Eigenschaften als Text-Dateien gespeichert (*.dfm)

=== FreePascal Target Polyzalos ===

* Erstmals werden 2 Compilate erstellt: der Code für UI und der Code für den Server
* Dies erfolgt durch 2-maliges Compilieren der selben Code-Basis
* Server-Code ist nah am Zielbetriebssystem mit nativem Assembler Code und OS-Nutzung (klassischer IDE-Betrieb)
* Client-Code ist erzeugtes JavaScript zusammen mit statischem Content in html5, dem JavaScript steht eine Client-OS-Infrastruktur in Form von einer rtl.js zur Verfügung

* typischer Entwicklungszyklus
** Die Entwicklung soll also ausschliesslich mit der Lazarus-IDE stattfinden
** Coding von Funktionen, dabei erlaubter Mix von UI und Verarbeitungsaktionen
** 1. Compilierung zu einer Server.exe
** 2. Compilierung zu JavaScript und deploy auf Web-Bereich
** Der Pascal-Quelltext soll "debug" infos mit ins JavaScript ausgeben können, so dass ...
** Start des Servers
** der Client-Browser bemerkt den erfolgreichen reconnect zum Server
** ... der native Lazarus-Debugger verwendet werden kann sobald generierter Code durchlaufen wird
** dabei wird Firefox das Debug-Protokoll an die Lazarus-IDE senden
*** https://docs.firefox-dev.tools/backend/protocol.html
*** https://searchfox.org/mozilla-central/source/devtools/docs/backend
*** https://searchfox.org/mozilla-central/source/devtools/docs/backend/client-api.md
*** Infos über den Internen Debugger: https://developer.mozilla.org/en-US/docs/Tools/Debugger/UI_Tour
** alternativ kann zum erzeugten JavaScript eine Sourcemap mitgegeben werden
*** https://developer.mozilla.org/de/docs/Tools/Debugger/How_to/Use_a_source_map

* typische Server-Funktionen
** eine Verbindung zu firebird
** Erstellen und Verarbeiten von Dateien im Dateisystem
** Uploads- Downloads von/auf anderen Servern
** Hosten der index.html (minimales starres Template, unveränderlich über alle Projekte hinweg)
** Hosten des Polyzalos Compilates (.js)
** Hosten der "RTL" (.js)
* typische Client-Funktionen
** wird ein Button gedrückt so werden zunächst andere Controls disabled und eine Server-Anforderung gestellt
** wird eine Drop-Down-Box gedrückt wird eine Liste angefordert, ist eine Liste bereits gespeichert wird geprüft ob diese noch aktuell ist
** Synchronisation der Server-Datenbank mit einer lokalen sqlite3-Datenbank (als .wasm)
** Teil des Frameworks https://docs.emmet.io/cheat-sheet/ zur Hilfe bei html Erstellung

== Roadmap ==

* ?.2027: OrgaMon-Funktionsumfang ausgehend von der polyzalos-Userbase erreicht
* ?.2026: Umstellen auf OpenSSL QUIC Server
* --v-Past----------------^-Future------------------
* 03.03.2026 Server-sent events funktioniert
* 18.02.2026 Portierung von HTTP/2 nach Linux, erster connect gelungen!
* 10.02.2026 erstes Arch-Linux Compilat - jedoch viele "imp pend"s
* 11.12.2024 Michael Jeinski erstellt erste aktualisierte Version
* 08.12.2023 ServiceWorker und sqlite3 laufen, persistenz ist kvv
* in 2023 "cOrgaMon" Codeumfang nach Lazarus migriert, HTTP/2 Server

=== TO DO ===

* Lesen: https://github.com/darcien/ese/blob/977371c34621d787a2afae543f3b672c587ab681/SSE_SPEC.md
* Benutze das PasMP Package, und nicht direkt das PasMP.pas
* "SQLite3 Worker" innerhalb des ServiceWorkers erstellen, in der Hoffnung dass hier OPFS geht!
** 08.12.2023: gebe die OPFS Forderung auf akzeptiere dass die Persistenz halt woanders liegt

=== aktuelle Probleme ===

* Im ServiceWorker kann das OPFS wegen nicht vollständiger API nicht genutzt werden
** Lösung: Auf das AsyncKKKK verzichten
** ganze klar Dokumentieren, wie persistenz im ServiceWorker erreicht werden kann

=== Screenshot ===

[[Datei:Screenshot 20260225 191731.png]]

== Quellen ==

* https://mdn.github.io/dom-examples/web-workers/offscreen-canvas-worker/
* https://developer.mozilla.org/en-US/docs/Web/API/Service_Worker_API
* https://github.com/mdn/dom-examples/tree/main/service-worker/simple-service-worker
* https://github.com/nikhilmwarrier/todomanager/blob/main/sw.js
* https://github.com/rhashimoto/wa-sqlite

Polyzalos

2026-03-07T19:50:16Z

Root: /* Rückkanal */

{{Anmerkung|Polyzalos befindet sich noch in Entwicklung, eine erste Demo erschien 2023, mit einer ersten Anwendung wird in 2027 gerechnet}}

== Was ist Polyzalos ==

Polyzalos ist ein Technologie-Update des OrgaMon, mit folgenden Innovationen: 

* Lazarus/FreePascal wird als Programmiersprache verwendet (bisher Delphi)
* ([[Arch]]-)Linux ist die einzige Zielplattform (bisher Win32)
* Es wird ein Server-Dienst unter Linux sein, eine reine Konsolen-Anwendung die via systemd.socket gestartet wird (bisher Windows Anwendung)
* Das Benutzerinterface läuft in einem Browser (bisher Windows-UI)
* Es werden keine proritären Tools (Delphi, IBObjects, FlexCell) mehr verwendet - es ist 100% Open-Source (Lazarus 4.4, Zeos 8.0, fpspreadsheet 2.0)
* Anstelle des "GPL-3.0-or-later" Lizenz wird die "MIT" Lizenz verwendet
* Keine Trennung mehr wie bisher zwischen cOrgaMon und OrgaMon

Was bleibt so wie es ist: 

* der bisherige Funktionsumfang und Mehrwert
* Ein OrgaMon-Verzeichnis im Netzwerk (Mehrplatz-System) oder in .\Dokumente (Einzelplatz-System)
* Firebird als Datenbank-Server mit der bisherigen Datenbank-Struktur

== Wie nutzt man Polyzalos ==

* Start der Anwendung: Ein Web-Browser (Chrome oder Firefox) wird gestartet mit der URL des installierten polyzalos-Servers (z.B. <code>https://polyzalos.joe.local.net/</code>)
* der Server (hier <code>joe</code>) dieser Website kann aber auch ein lokales <code>polyzalos</code>-Binary sein (https://local.orgamon.net/)
* der Server kann auch remote eine VM ist Netzwerk, ein dezidierter Server im Netzwerk oder ein Server in der Cloud sein
** Unsicher ist noch, ob immer eine lokale polyzalos Installation notwendig ist - kommt wohl darauf an von wo aus das OrgaMon-Verzeichnis zugreifbar ist
* Das UI läuft als Web-Code (CSS,HTML5,JavaScript) und erledigt triviale Berechnungen sowie Eingabeprüfung, TAB-Reihenfolgen, Text-Editor, Einfärben von DB-Eingabefeldern
* komplexe Aktionen (Login in einen Server, PDF-Konvertierung, SQL Richtung DB-Server) übernimmt das lokale Binary

Download eines ersten Beispiel-Servers: 

* (Noch Win32) https://cargobay.orgamon.org/polyzalos.html
* (Linux) -- noch nicht verfügbar --
 

__TOC__

== Wie programmiert man Polyzalos ==

* In der Lazarus-IDE!
** (es wird eine Anleitung geben wie man eine Entwicklungsumgebung aufsetzt, Basis ist Arch-Linux)
** (es wird auch eine Anleitung geben wie man eigene Verbesserungen der Allgemeinheit zur Verfügung stellt)
** (der bisherige Test-Suite wird veröffentlicht werden und Neuerungen werden über Git-Actions durch einen Git-Runner geprüft)
* Neben der Datenbank-Logik sind auch Benutzer-Interaktionen im selben Quelltext vermischt
** Der Zugang zu Polyzalos-Entwicklung wird für Programmierer wesentlich einfacher werden wie der Zugang zur OrgaMon-Entwicklung
* Nach F9 soll man auf dem letzten Fokus-Element stehen und seine Änderung testen können

* Es wird immer 2fach compiliert
** Erster Compiler-Lauf: Compilierung für die Serverplattform, ein Compilat <code>./polyzalos</code> (dies inkludiert ein [[HTTP3]]-Server (Kern) mit Verarbeitungs-Code (Logik).
** Zweiter Compiler-Lauf: Compilierung nach JavaScript und Auslieferung der veränderten Code-Anteile in ein Webserver-Verzeichnis
* In Wirklichkeit ist ein Webanteil für das GUI und ein Serveranteil für die Programmlogik entstanden
* dabei werden Objekt-Methoden aufgerufen, die ggf. auf dem Client oder dem Server laufen oder beides

== Technologie ==

* sind Methoden auf dem Client nicht ausführbar (sie erfordern Server-Resourcen wie Dateisystem, Datenbank, oder complexe Bibliotheken) und erfordern somit Aktionen auf dem Server, dies erfolgt grundsätzlich "nonblocking", also der Client wartet nie, sondern setzt nur Requests ab
* sind aber Logik-Anteile des Programmes so trivial oder deren Ergebnise einfach nicht persistent, wird der Code direkt in der GUI ausgeführt ohne Beteiligung des Servers

=== Pure Pascal Prinzip ===

* Das DOM-Modell wird per Pascal-Objekt (also nach javascript compiliertes Pascal) abstrahiert, es soll kein <code>writeln('-b-fett-/b-');</code> geben
** Vegas- Prinzip (What Happens Here, Stays Here)
** Die Tatsache HTML5/CSS/JavaScript wird völlig verborgen, für den Programmierer ist ALLES Pascal
* Auf dem Client lauffähiger Code wird zu JavaScript
* Auf dem Server lauffähiger Code wird zu nativem Linux-Binary
* Der Sync der Variablen / Datenbank darf nicht die UI blockieren
* Abbruch der Verbindung zum Server darf nie ein Problem sein (Notebook-Sleep, Network-Disconnect, Timeout, Long-Timeout)
* die Server-Worker und Client-Worker müssen transaktionsgesteuert und reconnect fähig sein

=== Rückkanal ===

* Polayzalos sendet Logs und Updates lang laufender Aktionen auf der selben TCP Verbindung zum Client zu jeder Zeit ohne das Request/Answer Model
** https://html.spec.whatwg.org/multipage/server-sent-events.html#parsing-an-event-stream
* Dazu öffnet der Client über JavaScript "EventSource()" über die HTTP/2 Stream ID kannn der Netzwerkverkehr hier zugeordnet werden
* Client-Seite:

<script>
var source = new EventSource('/log');
source.onmessage = function(event) {
console.log('Incoming date:' + event.data);
};

// const es = new EventSource('https://my-server.com/sse')
es.addEventListener('notice', (event) => {
console.log(event.data)
})
</script>

=== Asynchron ===

* eine Polyzalos Anwendung läuft im Browser blockiert aber niemals um eine Antwort auf einen Server-Request zu erhalten
** Anfragen und Calls an den Server werden in eine lokale SQLite3 Datenbank geschrieben (SQLite3 in der Webassembly-Version im Browser, nativ auf dem Server)
** Ein Worker versucht Antworten vom Server zu erhalten
** Ein Worker füllt zum passenden Request die Datenbank mit Ergebnisdaten des Servers
** Der Worker ruft Callbacks des UI-OS um das jeweilige DOM von z.B. "unsaved, =gelb" auf "saved, weiß" zu stellen

=== WVCL-OS (Client) ===

* eine Polyzalos-Anwendung benutzt auf der Web-Seite eine API zu einer statischen css+html+JavaScript Monolith Web-Visual-Component-Library-Operating-System (WVCL-OS)
** UI-OS ist ein Unterprojekt von Polyzalos und soll langfristig auch die komplette IDE ins Web bringen können
** UI-OS wird eher durch Web-Leute gepflegt und weiterentwickelt und per JavaScript von der Polyzalos Anwendung gerufen
** Wird UI-OS einmal inkompatibel mit "alten" Polyzalos Anwendungen müssen moderne Anwendungen in eine bestimmte UI-OS Version hochschalten
* Um Erfahrung zu sammeln und nicht bei "0" beginnen zu müssen starte ich mit [[https://qooxdoo.org/ Qooxdoo 8.0]]

=== polyzalos.js ===

* die polyzalos.js ist das 2. Compilat das vom Webserver (integriert in polyzalos) ausgeliefert wird und vom Browser ausgeführt wird
* darin sind lokale "onButtonpressed" Events implementiert, remote- Aktionen gehen an den Service-Worker (PostMessage)

=== ServiceWorker ===

* Es wird ein ServiceWorkerGlobalScope verwendet, er sichert auch die Forderung "Offline" Funktionalität
* Er hat zugriff auf eine Persistenz (SQLite3.wasm)
* Er verarbeitet die Messages der App.js (alle messages sind im JSON Format)
* Er erstellt aus Daten der Datenbank Formulare (statefull)

==== SQLite3.wasm ====

* Only the ServiceWorker see a SQLite3 Database with forms and propertys (edit.text, grids.data)
* every Request to a "Form" is generated by the ServiceWorker with persistent Data from the DB
* The DB is synced (non-blocking) with polyzalos storage (Format is JSONB)

=== Hello World ===

<syntaxhighlight lang="pascal">
program index;

uses
p2020;

begin
writeln('Hello World!');
end.
</syntaxhighlight>

=== PolyzalosD Server ===

* Der Server hat die Möglichkeit spontan über Datenbankänderungen zu informieren
* Der Server kann Alerts beim Client ausführen
** https://www.npmjs.com/package/web-push

=== Formulardesigner ===

* Migrations-Phase: Aus der Delphi Code-Basis werden alle dfm nach lfm übernommen (132 Formulare!)
* Das Design/Redesign/Neudesign von Formularen erfolgt ab dann in der Lazarus IDE
* (unsicher) Ein grober Funktionstest kann so immer in der IDE ohne Web, mit dem Lazarus-Compilier-Ziel LCL (native GUI-Anwendung) gemacht werden
** dies wird wohl nicht für immer und ewig unterstützt, da der User genau wissen muss welche Komponenten er überhaupt verwenden kann, es wird nicht alles unterstüzt
** Zumindest solange bis Chrome unzulänglich als compile Target in Lazarus intergriert ist
** die lfm werden zum Client übertragen der sie in einer Offline-Datenhaltung speichert (Versioning der lfm-Files!)
* die lfm werden mit ihren Propertys als JSON, dann JSONB in der SQLite3 DB des ServiceWorkers gespeichert
* der Worker erzeugt auf "fetch" der app.js das Formular als html5

** Im Endausbau soll Lazarus nativ in ein Chromefenster laufen, ev. gibt es auch mal einen lfm Designer fürs Web
** die compilat erstellung soll aber immer auf einer nativen Plattform ausgeführt werden
* der Worker erzeugt aus den lfm eine wfm (HTML5-DOM) die entsprechend das Aussehen des lcl-Formulares nur grob imitiert aber
** wfm ist nicht mehr pixelgenau
** wfm baut massiv auf der Tab-Order auf, das ist die Vorgabe für das "Verständnis" der UI
** wfm ist reactive
** der Worker implementiert eine WCL welcher TButton, TListbox, TLabel kennt, und das zugehörige html5+js ausliefert

== Namensherkunft ==

=== Historie ===

* Polyzalos, originalschreibweise Πολύζαλός [[https://www.fundus.uni-hamburg.de/de/collection_records/92327]]
* poly = πολύς = viel
* zalos = ζάλος = Schaum, Schwindel, Ehrgeiz
* Polyzalos war der siegreiche Wagenlenker von Delphi
** Es wurde ein Korpus gefunden: https://commons.wikimedia.org/wiki/File:Charioteer_of_Delphi.jpg

* Sein Gewinn eines Wagenrennens (als Gespann-Eigner - nicht als Lenker) wurde einst in einem Büstenmonument verewigt
* das Monument wurde ausgegraben es ist aber nicht mehr vollständig erhalten
** So stellt sich die Wissenschaft das komplette Monument vor: http://www2.oberlin.edu/images/Art200-08/200-033.JPG
** In der Skizze steht der Siegreiche auf dem Wagen als Lenker? oder nicht? Meine persönliche Meinung ist aber dass er als "Eigner" vor den Pferden stand, die Wagenlenker sind in der Regel nackt dargestellt, der Künstler hat viel Arbeit in die Darstellung der Füße gelegt, diese wären auf dem Wagen gar nicht sichtbar) Neue Erkenntnisse sprechen aber davon, dass Polyzalos selbst Teil des Monumentes war, seine Büste aber fehlt!
** [[Datei:Zuegelhalter.png|100px]]
** https://www.john-uebersax.com/plato/plato3.htm
** Der Sponsor oder siegreiche konnte (auch) den Gewinnerkranz für sich beanspruchen, war aber bekleidet

* http://3.bp.blogspot.com/-GwzDsFa2zIA/VCy-_jfVfcI/AAAAAAAAPtY/NtwPdmJIwiM/s1600/Dwie-Judha-Satria-chariot-allegory.jpg
* https://www.khanacademy.org/humanities/ancient-art-civilizations/greek-art/early-classical/v/charioteer-delphi

=== weiter "Poly"- Bezug (=2 Pferde) ===

* 2 Pferde, Kelpies Falkirk Scotland
* Er führt ruhig einen Streitwagen mit 2 sehr unterschiedlichen Pferden (Server/Pascal, Browser/JS)
** ev. auch auseinanderstrebenden Pferden

* http://www.creaturearchives.com/animalia-chariot-allegory/

=== Bezug zu diesem Polyzalos-Projekt ===

* eines der Pferde symbolisiert die JavaScript-Seite des Browsers
* das andere Pferd symbolisiert die Pascal-Seite des Servers
* https://www.insegnadelgiglio.it/prodotto/immagini-di-gela/

== Systemvergleich ==

=== Turbo Pascal 1989 ===

* Der Compiler erzeugt Assemblercode für die x86 Plattform und hat dabei
** Knowhow über den Umgang mit Heap- und Hauptspeicher
** Knowhow über elementare Betriebssystemaufrufe für writeln, readln, AssignFile, ...
* Es wird linearer Code für das Zielsystem DOS erstellt und gestartet (.com)
* Konsolenanwendungen oder Textmode- Anwendungen sind der Standard
* Grafik wird völlig selbst berechnet und ausgegeben

=== Delphi ===

* Anwendungen sind Konsolenanwendungen oder grafische Anwendungen (Windows)
* Es wird an eine MessageLoop des Betriebssystems angedockt und so
** Click- und Mausevents verarbeitet
** Signale für die GUI verabeitet (close-Window, refresh Window usw.)
* Es wird ein Single-Thread-Code für das Zielsystem WIN erstellt und gestartet
* Formulare (GUI), es werden Objekte über deren Namen und Objekt-Eigenschaften als Text-Dateien gespeichert (*.dfm)

=== FreePascal Target Polyzalos ===

* Erstmals werden 2 Compilate erstellt: der Code für UI und der Code für den Server
* Dies erfolgt durch 2-maliges Compilieren der selben Code-Basis
* Server-Code ist nah am Zielbetriebssystem mit nativem Assembler Code und OS-Nutzung (klassischer IDE-Betrieb)
* Client-Code ist erzeugtes JavaScript zusammen mit statischem Content in html5, dem JavaScript steht eine Client-OS-Infrastruktur in Form von einer rtl.js zur Verfügung

* typischer Entwicklungszyklus
** Die Entwicklung soll also ausschliesslich mit der Lazarus-IDE stattfinden
** Coding von Funktionen, dabei erlaubter Mix von UI und Verarbeitungsaktionen
** 1. Compilierung zu einer Server.exe
** 2. Compilierung zu JavaScript und deploy auf Web-Bereich
** Der Pascal-Quelltext soll "debug" infos mit ins JavaScript ausgeben können, so dass ...
** Start des Servers
** der Client-Browser bemerkt den erfolgreichen reconnect zum Server
** ... der native Lazarus-Debugger verwendet werden kann sobald generierter Code durchlaufen wird
** dabei wird Firefox das Debug-Protokoll an die Lazarus-IDE senden
*** https://docs.firefox-dev.tools/backend/protocol.html
*** https://searchfox.org/mozilla-central/source/devtools/docs/backend
*** https://searchfox.org/mozilla-central/source/devtools/docs/backend/client-api.md
*** Infos über den Internen Debugger: https://developer.mozilla.org/en-US/docs/Tools/Debugger/UI_Tour
** alternativ kann zum erzeugten JavaScript eine Sourcemap mitgegeben werden
*** https://developer.mozilla.org/de/docs/Tools/Debugger/How_to/Use_a_source_map

* typische Server-Funktionen
** eine Verbindung zu firebird
** Erstellen und Verarbeiten von Dateien im Dateisystem
** Uploads- Downloads von/auf anderen Servern
** Hosten der index.html (minimales starres Template, unveränderlich über alle Projekte hinweg)
** Hosten des Polyzalos Compilates (.js)
** Hosten der "RTL" (.js)
* typische Client-Funktionen
** wird ein Button gedrückt so werden zunächst andere Controls disabled und eine Server-Anforderung gestellt
** wird eine Drop-Down-Box gedrückt wird eine Liste angefordert, ist eine Liste bereits gespeichert wird geprüft ob diese noch aktuell ist
** Synchronisation der Server-Datenbank mit einer lokalen sqlite3-Datenbank (als .wasm)
** Teil des Frameworks https://docs.emmet.io/cheat-sheet/ zur Hilfe bei html Erstellung

== Roadmap ==

* ?.2027: OrgaMon-Funktionsumfang ausgehend von der polyzalos-Userbase erreicht
* ?.2026: Umstellen auf OpenSSL QUIC Server
* --v-Past----------------^-Future------------------
* 03.03.2026 Server-sent events funktioniert
* 18.02.2026 Portierung von HTTP/2 nach Linux, erster connect gelungen!
* 10.02.2026 erstes Arch-Linux Compilat - jedoch viele "imp pend"s
* 11.12.2024 Michael Jeinski erstellt erste aktualisierte Version
* 08.12.2023 ServiceWorker und sqlite3 laufen, persistenz ist kvv
* in 2023 "cOrgaMon" Codeumfang nach Lazarus migriert, HTTP/2 Server

=== TO DO ===

* Lesen: https://github.com/darcien/ese/blob/977371c34621d787a2afae543f3b672c587ab681/SSE_SPEC.md
* Benutze das PasMP Package, und nicht direkt das PasMP.pas
* "SQLite3 Worker" innerhalb des ServiceWorkers erstellen, in der Hoffnung dass hier OPFS geht!
** 08.12.2023: gebe die OPFS Forderung auf akzeptiere dass die Persistenz halt woanders liegt

=== aktuelle Probleme ===

* Im ServiceWorker kann das OPFS wegen nicht vollständiger API nicht genutzt werden
** Lösung: Auf das AsyncKKKK verzichten
** ganze klar Dokumentieren, wie persistenz im ServiceWorker erreicht werden kann

=== Screenshot ===

[[Datei:Screenshot 20260225 191731.png]]

== Quellen ==

* https://mdn.github.io/dom-examples/web-workers/offscreen-canvas-worker/
* https://developer.mozilla.org/en-US/docs/Web/API/Service_Worker_API
* https://github.com/mdn/dom-examples/tree/main/service-worker/simple-service-worker
* https://github.com/nikhilmwarrier/todomanager/blob/main/sw.js
* https://github.com/rhashimoto/wa-sqlite

Linux.git

2026-03-04T18:41:08Z

Root: /* Daily Driver */

2026-03-04T18:27:19Z

Root: /* Daily Driver */

== "git push" to github ==

* Es ist komplex, hier in aller Kürze

== As Up ==

on github: enable 2 Factor Autentification
local: generate a key
ssh-keygen -t ed25519 -C "andreas.filsinger@orgamon.org"
on github: store the .pub-Part Key in github "SSH Keys save"
local: login in github
ssh -T git@github.com
say "yes"
change the origin of the git
git remote set-url origin git@github.com:Andreas-Filsinger/Polyzalos.git

== Daily Driver ==

git add -u
git commit -m "Describe todays Work"
git push

== Tag it ==

#
# Sample for set a tag "9.004"
#
git tag -a 9.004 -m "Rev. 9.004 - 04.03.2026"
git push origin 9.004