kaffeekasse-saas/docs/m0/code-inventory.md

M0 Code- und Prozessinventar

Stand: 2026-07-11

Dieses Inventar basiert auf statischer Sichtung des Legacy-Codes im Repository. Das echte Datenbankschema muss noch mit schema-export.sql verifiziert werden.

App-Struktur

Datei	Rolle	Wichtige Beobachtung
config.php	AD-/DB-Konfiguration	Erstellt globale SQL-Server-Verbindung $conn
functions.php	Auth-/User-Helper	Liest $_SERVER['AUTH_USER'], inkludiert LDAP, prüft kl_Mitarbeiter
functionsLDAP.php	LDAP-Mailauflösung	Ermittelt $mailadress aus AD
header.php	HTML-Head und Hinweisbanner	Lädt assets/css/main.css, liest kl_hinweise
footer.php	App-Sidebar und JS	Enthält die sichtbare Navigation und Admin-Menüs
nav.php	Navigation	Aktuell praktisch leer
headerline.php	Headerfragment	Enthält NUL-Zeichen, fachlich unklar
assets/css/main.css	Hauptdesign	HTML5-UP Editorial, grüner Akzent, Tabellen, Buttons, Sidebar
DataTables/	Tabellen-Assets	Wird teilweise eingebunden, aber nicht konsequent initialisiert
PHPMailer/	Mailversand	Für Rundmails/Jahresauswertung genutzt
TCPDF/	PDF-Export	Für Kaffeelisten-Export genutzt

Fachliche Kernseiten

Datei	Prozess	Tabellen
index.php	Persönliches Dashboard, Saldo, Jahreswerte, eigene Striche, PayPal-Links	kl_Mitarbeiter, kl_Einzahlungen, kl_Kaffeeverbrauch, kl_config
kaffeeliste.php	Admin-Gesamtübersicht mit Salden	kl_Mitarbeiter, kl_Einzahlungen, kl_Kaffeeverbrauch
stricheintragen.php	Sammelerfassung von Strichen	kl_Mitarbeiter, kl_Kaffeeverbrauch, kl_config
einzahlung.php	Sammelerfassung von Einzahlungen	kl_Mitarbeiter, kl_Einzahlungen, kl_Kaffeeverbrauch
mitarbeiterverwalten.php	Mitglieder anlegen, bearbeiten, aktivieren, deaktivieren	kl_Mitarbeiter
namenanpassen.php	Anzeigenamen ändern	kl_Mitarbeiter
letzteneintraege.php	Letzte Buchungen anzeigen und löschen	kl_Einzahlungen, kl_Kaffeeverbrauch, kl_Mitarbeiter
csvupload.php	Zahlungs-CSV importieren	kl_Mitarbeiter, kl_Einzahlungen
exportKaffeeliste.php	PDF-/Listenexport	kl_Mitarbeiter, kl_Kaffeeverbrauch, kl_Einzahlungen, kl_config
mailausgebe.php	Mailausgabe/Adressliste	kl_Mitarbeiter
mailversenden.php	Massenmail mit aktuellem Stand	kl_Mitarbeiter, kl_Einzahlungen, kl_Kaffeeverbrauch
hinweise.php	Hinweise pflegen	kl_hinweise
faq.php	FAQ	Keine fachlichen Schreibzugriffe
jahresauswertung.php	Jahresgutschriften und Mailversand	kl_Mitarbeiter, kl_Kaffeeverbrauch, kl_Einzahlungen
umfrage.php	Umfrage	CoffeeSurveyVotedEmails, CoffeeSurveyResponses
umfrageergebnisse.php	Umfrageauswertung	CoffeeSurveyVotedEmails, CoffeeSurveyResponses

Abgeleitete Tabellen und Spalten

Diese Spalten sind aus dem Code abgeleitet und müssen mit dem echten DB-Schema abgeglichen werden.

Tabelle	Abgeleitete Spalten
kl_Mitarbeiter	MitarbeiterID, Name, Email, aktiv, admin, paypalname
kl_Einzahlungen	EinzahlungsID, MitarbeiterID, Betrag, Datum
kl_Kaffeeverbrauch	VerbrauchID, MitarbeiterID, AnzahlStriche, Kosten, KostenproStrich, Datum, Eintragsart
kl_config	KostenproStrich, paypaluse, paypallink, strichperweb
kl_hinweise	id, nachricht, gueltig_bis
CoffeeSurveyVotedEmails	EmailNorm
CoffeeSurveyResponses	diverse Q*_-Antwortspalten, siehe Umfragecode

Prozesslandkarte

Authentifizierung

1. Seite inkludiert functions.php.
2. functions.php liest $_SERVER['AUTH_USER'].
3. functionsLDAP.php ermittelt Mailadresse aus LDAP.
4. Zugriff wird über kl_Mitarbeiter.Email, aktiv und admin geprüft.

M0-Feststellung: Login-Konto, Kaffee-Teilnehmer und Rolle sind im Legacy-Modell gekoppelt. Für SaaS müssen users, participants und tenant_memberships getrennt werden.

Persönliches Dashboard

Quelle: index.php.

Berechnungen:

• Mitarbeiter per E-Mail suchen.
• Gesamteinzahlung: Summe kl_Einzahlungen.Betrag.
• Gesamtausgabe: Summe kl_Kaffeeverbrauch.Kosten.
• Gesamtstriche: Summe kl_Kaffeeverbrauch.AnzahlStriche.
• Aktueller Stand: Einzahlungen minus Ausgaben.
• Jahreswerte: dieselben Summen für aktuelles Jahr.
• Bei aktivem strichperweb: eigener Strich-Eintrag.
• Bei aktivem paypaluse: PayPal-Links anzeigen.

Sammelerfassung Striche

Quelle: stricheintragen.php.

Berechnungen:

• Preis pro Strich aus kl_config.KostenproStrich.
• Pro Mitarbeiter eine Anzahl erfassen.
• Kosten = Anzahl Striche mal Kosten pro Strich.
• Neue Zeile in kl_Kaffeeverbrauch.
• Filter vorderseite/rueckseite anhand der letzten 100 Tage und mindestens 10 Strichen.

Sammelerfassung Einzahlungen

Quelle: einzahlung.php.

Berechnungen:

• Pro Mitarbeiter Betrag erfassen.
• Neue Zeile in kl_Einzahlungen.
• Filter vorderseite/rueckseite anhand der letzten 100 Tage und mindestens 10 Strichen.

Mitgliederverwaltung

Quelle: mitarbeiterverwalten.php.

Aktionen:

• Mitglied anlegen.
• Name/E-Mail/aktiv/admin bearbeiten.
• Mitglied aktivieren/deaktivieren.

M0-Feststellung: Das admin-Flag ist fachlich eine Rolleninformation und sollte in der SaaS-App in tenant_memberships.role wandern.

Korrektur letzter Einträge

Quelle: letzteneintraege.php.

Aktionen:

• Letzte 100 Einzahlungen anzeigen.
• Einzahlung hart löschen.
• Letzte 100 Strich-Einträge anzeigen.
• Strich-Eintrag hart löschen.

M0-Feststellung: Finanznahe Korrekturen sollten im Zielmodell nicht hart löschen, sondern als Storno/Reversal mit Audit-Trail gespeichert werden.

CSV-Import

Quelle: csvupload.php.

Ablauf:

• Datei hochladen.
• CSV mit Komma-Trennung lesen.
• Name aus Spalte 3, Betrag aus Spalte 7, Datum aus Spalte 0.
• Mitarbeiter per Name oder paypalname finden.
• Dublette anhand Mitarbeiter, Betrag und Datumstag prüfen.
• Einzahlung einfügen.
• Ergebnis in Erfolg/Fehler klassifizieren.

Jahresauswertung

Quelle: jahresauswertung.php.

Ablauf:

• Gesamtstriche des aktuellen Jahres je aktivem Mitarbeiter berechnen.
• Konstante Anzahl neuer Striche/Gutschrift proportional verteilen.
• Einzahlung je Mitarbeiter einfügen.
• Mail an Mitarbeiter senden.

M0-Feststellung: Das ist ein Job/Skript mit direktem Schreibzugriff und Mailversand. Für SaaS braucht es Dry-Run, Audit, Tenant-Scope und expliziten Operator.

Offene Schemafragen

• Gibt es Primary Keys, Foreign Keys und Indizes für die kl_-Tabellen?
• Sind Datentypen für Geldwerte decimal, money, float oder etwas anderes?
• Gibt es historische Spalten, die im Code nicht sichtbar sind?
• Gibt es Trigger oder Stored Procedures?
• Gibt es weitere Jobs außer jahresauswertung.php?
• Sind Umfragetabellen produktiv relevant oder Archiv/Randmodul?

Technische Legacy-Inkonsistenzen

• csvupload.php sucht in getMitarbeiterID nach Name = ? or paypalname = ?, übergibt aber nur einen Parameter. Das sollte vor der Übernahme des CSV-Flows verifiziert werden.
• einzahlung.php prüft auf $_GET["action"], die Buttons erzeugen aber URLs mit aktion=.... Der Vorderseite-/Rückseite-Filter kann dadurch abweichend vom erwarteten Verhalten laufen.
• exportKaffeeliste.php referenziert tcpdf/tcpdf.php, während der Ordner im Repository TCPDF/ heißt. Auf case-sensitiven Dateisystemen kann das brechen.
• headerline.php ist fachlich leer beziehungsweise mit NUL-Zeichen gefüllt. Vor der neuen App-Shell sollte geklärt werden, ob die Datei entfernt werden kann.