Die Uhr laeuft erst, wenn die Anzahlung da ist

Bisher begann der Liefertermin mit der Annahme. Das ist unfair in beide
Richtungen: Wer zehn Tage bis zur Zahlung braucht, verbraucht zehn Tage
der zugesagten Zeit, ohne dass ein Handschlag Arbeit passiert waere --
und ich stehe am Ende als der da, der seinen Termin reisst.

Ein Projekt hat jetzt drei Abschnitte statt zwei:
  1. angenommen, wartet auf Anzahlung  -> Uhr steht
  2. Anzahlung da                      -> Uhr laeuft, Termin ab HEUTE neu
  3. uebergeben oder abgebrochen       -> Uhr steht wieder

Der Zahlungseingang loest alles Weitere von selbst aus: Uhr starten,
Termin neu rechnen, Status von briefing auf design, 'wer ist am Zug' auf
mich, Benachrichtigung in der Verwaltung. Der bei der Annahme genannte
Termin bleibt als termin_geplant_am erhalten, und die Meldung nennt
BEIDE -- so sieht man, dass sich etwas verschoben hat, ohne nachrechnen
zu muessen.

Eingehaengt an der Stelle, an der beide Wege zusammenlaufen (PayPals
Meldung UND das Vermerken von Hand). Nur am Webhook haenge sich die
Seite verschieden verhalten, je nachdem WIE das Geld ankam -- eine von
Hand verbuchte Zahlung startete die Uhr nie.

Zwei Grundsaetze fuer die Automatik: Sie setzt Dinge in Gang, nimmt aber
nie eine Entscheidung zurueck, die ein Mensch getroffen hat (ein von Hand
pausiertes Projekt wird nicht kommentarlos wieder gestartet). Und jeder
Schritt hinterlaesst eine Spur im Verlauf UND als Meldung -- eine
Automatik, die stillschweigend arbeitet, ist kein Helfer, sondern ein
Raetsel.

ABBRECHEN
Ein angenommener Auftrag bleibt abbrechbar: Der Kunde zahlt nicht,
meldet sich nicht, springt ab. Vorschau und Ausfuehrung sind getrennt --
die Seite rechnet aus dem Aufgabenfortschritt vor, wie viel Leistung
erbracht wurde, und schlaegt daraus einen Erstattungsbetrag vor. Der
Betrag ist ein VORSCHLAG: Ob im Einzelfall mehr oder weniger angemessen
ist, haengt an Dingen, die keine Tabelle kennt. Offene Rechnungen werden
storniert (eine Zahlungsaufforderung ohne Gegenleistung), bezahlte
bleiben unangetastet, und die Rueckzahlung loest die Seite bewusst NICHT
selbst aus -- PayPal-Rueckzahlungen sind nicht umkehrbar.

BENACHRICHTIGUNGEN
Eigene Tabelle statt im Verlauf: Der Verlauf haelt fest, WAS geschehen
ist -- vollstaendig, zum Nachschlagen. Eine Benachrichtigung ist ein
Anstupsen, das gelesen und weggelegt wird. Beides in einer Tabelle
hiesse: entweder ein Verlauf voller Rauschen oder Meldungen, die man
nicht wegklicken kann. Wegklicken markiert nur als gelesen, loescht
nichts.

Dazu die Liste der Projekte, die seit ueber einer Woche auf ihre
Anzahlung warten. Sie stehen in keiner anderen Zahl, weil ihre Uhr nie
zu laufen begann -- ohne diesen Hinweis vergisst man sie.

Geprueft: 44 gegen eine echte Datenbank. Darunter der Kern -- die
Annahme wird zehn Tage zurueckdatiert, und der Termin muss danach
trotzdem volle 20 Werktage entfernt liegen. Beim Bauen des Tests selbst
ein Fehler gefunden: Die erste Fassung datierte nur die Annahme zurueck,
nicht den damals errechneten Termin, und bildete damit genau den Fall
nicht ab, um den es geht.

Co-Authored-By: Claude Opus 5 <[email protected]>
This commit is contained in:
2026-08-24 11:56:08 +02:00
co-authored by Claude Opus 5
parent 6b818fd6f6
commit 65b98ace89
9 changed files with 852 additions and 12 deletions
+57 -9
View File
@@ -52,6 +52,8 @@ import { brauchtKunde } from "./webdesign-portal.js";
import { zustimmungSpeichern } from "./webdesign-widerruf.js";
import * as paypal from "../lib/webdesign-paypal.js";
import * as geheim from "../lib/webdesign-geheimnisse.js";
import { zahlungVerbucht, meldungenLesen, meldungenOffen, erstattungsVorschlag, wartetAufAnzahlung }
from "../lib/webdesign-automatik.js";
import {
jetzt, neueId, naechsteNummer, text, verlauf, centZuText,
besucherIp, spracheOderDe,
@@ -286,16 +288,32 @@ function zahlungAlsBezahltVermerken(zahlungId, einzug, wer) {
nun, nun, zahlungId
);
/* Anzahlung/Rest am Projekt mitführen, damit die Verwaltung den Stand
sieht, ohne die Zahlungen einzeln durchzugehen. */
const z = db.prepare(`SELECT art, projekt_id FROM wd_zahlungen WHERE id = ?`).get(zahlungId);
if (z?.projekt_id && (z.art === "anzahlung" || z.art === "rest")) {
const feld = z.art === "anzahlung" ? "anzahlung_bezahlt" : "rest_bezahlt";
db.prepare(`UPDATE wd_projekte SET ${feld} = 1, aktualisiert_am = ? WHERE id = ?`)
.run(nun, z.projekt_id);
}
verlauf("zahlung", zahlungId, "bezahlt", wer, { captureId: einzug.captureId || null });
/* AB HIER UEBERNIMMT DIE AUTOMATIK.
Vorher wurde hier nur ein Haekchen am Projekt gesetzt. Das reichte,
solange der Liefertermin mit der Annahme begann -- jetzt haengt an
einer eingehenden Anzahlung deutlich mehr: Die Uhr startet, der
Termin wird ab heute NEU gerechnet, der Status wechselt, und ich
bekomme eine Benachrichtigung.
Bewusst an DIESER Stelle und nicht im Webhook: Hier laufen beide
Wege zusammen -- PayPals Meldung und das Vermerken von Hand. Haenge
man es nur an den Webhook, verhielte sich die Seite verschieden, je
nachdem WIE das Geld ankam, und eine von Hand verbuchte Zahlung
starte die Uhr nie. */
try {
zahlungVerbucht(zahlungId, wer);
} catch (fehler) {
/* Die Zahlung selbst ist zu diesem Zeitpunkt schon sicher verbucht.
Scheitert die Automatik danach, darf das NICHT die Buchung
umwerfen -- lieber ein Projekt, dessen Uhr man von Hand startet,
als eine Zahlung, die verlorengeht. Der Fehler wird aber
festgehalten, damit er nicht unbemerkt bleibt. */
verlauf("zahlung", zahlungId, "automatik_fehlgeschlagen", "system",
String(fehler && fehler.message || fehler).slice(0, 300));
}
}
/* ---------------------------------------------------------------------
@@ -722,5 +740,35 @@ export async function uebersicht(req, res) {
eingerichtet: paypal.istEingerichtet("einmal"),
live: paypal.istLive(),
},
/* Benachrichtigungen. Sie stehen ganz oben im Cockpit, weil sie das
Einzige sind, was seit dem letzten Hinsehen NEU ist -- alles
andere sind Bestaende, die man auch morgen noch sieht. */
meldungen: meldungenLesen(true, 8),
meldungenOffen: meldungenOffen(),
/* Projekte, die seit einer Woche auf ihre Anzahlung warten. Ohne
diese Liste vergisst man sie: Sie stehen in keiner Zahl, weil
ihre Uhr nie zu laufen begann. */
wartetAufAnzahlung: wartetAufAnzahlung(7),
});
}
/* Eine Benachrichtigung wegklicken.
Nur als gelesen markieren, nicht löschen: Der Verlauf soll
nachvollziehbar bleiben, und ein versehentliches Wegklicken darf
nichts endgültig verschwinden lassen. */
export async function meldungGelesen(req, res) {
const p = await darf(req, "WD_ANFRAGEN_VIEW");
if (!p.erlaubt) return json(res, { ok: false, error: "Kein Zugriff." }, p.grund);
const id = String(req.params.id || "");
if (id === "alle") {
const n = db.prepare(
`UPDATE wd_meldungen SET gelesen = 1, gelesen_am = ? WHERE gelesen = 0`
).run(jetzt()).changes;
return json(res, { ok: true, anzahl: n });
}
db.prepare(`UPDATE wd_meldungen SET gelesen = 1, gelesen_am = ? WHERE id = ?`)
.run(jetzt(), id);
return json(res, { ok: true, anzahl: 1 });
}