Portal: Aufgabenliste und Postfach fuer den Kunden

Schritt 4 von 4 -- damit sind beide Wuensche vom 22.08.2026 vollstaendig:
"wenn sie drauf druecken sollen sie auch sehen was ich schon gemacht habe
von dem was im plan war" und "die kunden sollen mir auch nachrichten
hinterlassen koennen".

AUFGABENLISTE IM PROJEKT

Bisher sah der Kunde nur die Phase ("Design . 3/7") -- eine Zahl ohne
Inhalt. Sie beantwortet die eigentliche Frage nicht: WAS ist denn fertig?

Die Liste steht GANZ OBEN, direkt nach dem Projektkopf, noch vor
Zahlungen und Dateien. Die sind wichtig, aber sie sind nicht der Grund
fuer den Klick.

Zwei Entscheidungen praegen die Ansicht:

1. Offene Kundenpunkte stehen in einem EIGENEN Kasten ganz oben ("Das
   brauche ich noch von dir"), nicht nur farblich markiert irgendwo
   mittendrin. Wer eine lange Liste sieht, liest sie als Bericht ueber
   fremde Arbeit und ueberliest seinen eigenen Teil -- genau daraus
   entstehen die meisten Verzoegerungen. Ist nichts offen, steht das
   auch da: "Von dir wird gerade nichts gebraucht." Eine gute Nachricht
   darf ausgesprochen werden.

2. Der Kunde hakt seine eigenen Punkte selbst ab. Nur diese haben einen
   Knopf; bei fremden Punkten ist das Zeichen reine Anzeige. Ein Knopf,
   der nichts tut, laesst die Seite kaputt wirken. Geprueft: 4 Knoepfe
   bei 2 offenen eigenen Punkten (sie erscheinen zweimal), 5 feste.

Grosse Zahl statt Prozent: "2 von 6 erledigt" ist greifbar, "33 %" ist
eine Rechnung, die niemand fuehlt. Der Balken traegt die vier
Prozessfarben -- dieselben wie auf der Ablaufseite und in der Verwaltung.

Der Ton ist bewusst gewaehlt. Der Kunde liest die Liste, wenn er unsicher
ist -- also im Zweifel schon angespannt. "Wir warten auf dich" waere
Druck, "Das brauche ich noch von dir" ist eine Bitte.

POSTFACH AUF DER UEBERSICHT

Bewusst auf der Uebersicht, nicht im Projekt: Wer kein Projekt hat -- oder
eine Frage, die zu keinem gehoert -- konnte vorher gar nicht schreiben und
musste zur E-Mail greifen. Damit war der Verlauf weg, sobald man ihn
brauchte.

Niedrigschwellig: kein Betreff, kein Pflichtfeld, der Projektbezug ist
freiwillig. Wer glaubt, eine Nachricht muesse eine "richtige" Anfrage
sein, schreibt gar nicht erst -- und genau die kurzen Fragen sollen hier
landen. Wird nachgeladen, damit die Uebersicht sofort dasteht.

Projekt- und Aufgabendaten werden gleichzeitig angefordert statt
nacheinander -- sonst waere die Wartezeit die Summe beider Anfragen. Die
Aufgabenliste darf dabei fehlschlagen, ohne die Seite mitzureissen: Wer
wegen einer leeren Liste seine Zahlungen nicht mehr saehe, waere
schlechter dran als vorher.

EIN SICHTBARER FEHLER GEFUNDEN

Auf dem Screenshot stand "Ideen & Aenderungswuensche". Ursache ist
eine Falle mit zwei Wegen: Texte ueber data-i18n landen als HTML in der
Seite, dort ist "&" richtig. Derselbe Text im JavaScript laeuft aber
durch die Absicherung und wird ein zweites Mal kodiert. Derselbe Baustein
ist also je nach Verwendungsort richtig oder falsch.

Das kann man nicht im Kopf behalten -- deshalb neu pruef-texte.mjs mit
ZWEI Pruefungen:

  Anzeige:   alle 11 Seiten x 5 Sprachen = 55 Kombinationen, sichtbarer
             Text darf keine Kodierungsreste enthalten.
  Quelltext: welcher Baustein mit "&" wird irgendwo abgesichert
             eingesetzt?

Beide sind noetig. Gegengeprueft: Die Anzeigepruefung allein haette den
Fehler NICHT gefunden, weil die Ideen-Karte erst nach einer Anmeldung
erscheint. Die Quelltextpruefung findet ihn ohne Anzeige.

Auch die Quelltextpruefung selbst wurde zweimal gegengeprueft: Zuerst
meldete sie zusaetzlich po_senden ("Senden", voellig harmlos) -- ihre
Blockerkennung lief bis zum naechsten Schluessel und schluckte dabei
einen Kommentar mit "&". Jetzt zaehlt sie geschweifte Klammern. Ein
Fehlalarm im Pruefwerkzeug ist fast so schaedlich wie ein uebersehener
Fehler: Man gewoehnt sich daran, ihn wegzusehen.

GEPRUEFT

32 Pruefungen im Portal (Computer und Handy), alle bestanden. Darunter:
114 Texte in allen fuenf Sprachen vollstaendig, Kundenpunkte stehen vor
der langen Liste, Aufgaben vor den Zahlungen, Abhaken meldet den
richtigen Punkt, alle Kaestchen mindestens 24 px, keine Fehler im
Protokoll. Dazu 55 Seiten-Sprach-Kombinationen ohne Kodierungsreste.

Ein Fehler im Test selbst gefunden und behoben: Die Adressabfrage prueft
jetzt den PFAD statt der ganzen Adresse. Der API-Server heisst
"postfach.dogfather-universe.com" -- ein includes("/postfach") traf den
HOSTNAMEN und damit jede Anfrage, auch die Uebersicht.

Versionsstempel und Cache-Name auf v5.

Co-Authored-By: Claude Opus 5 <[email protected]>
This commit is contained in:
2026-08-23 10:46:09 +02:00
co-authored by Claude Opus 5
parent b7c333fca3
commit 469a6c195f
17 changed files with 1065 additions and 48 deletions
+275 -1
View File
@@ -144,6 +144,133 @@
s(window.WD.t(wartet === "kunde" ? "po_wartet_kunde" : "po_wartet_dogfather")) + "</span>";
}
/* ---------------- Aufgabenliste (22.08.2026) ----------------
"wenn sie drauf drücken sollen sie auch sehen was ich schon gemacht
habe von dem was im plan war."
Bis hierher sah der Kunde nur die Phase ("Design · 3/7") — eine Zahl
ohne Inhalt. Sie beantwortet die eigentliche Frage nicht: WAS ist
denn schon fertig?
Zwei Entscheidungen prägen diese Ansicht:
1. Punkte, die auf den KUNDEN warten, stehen ganz oben in einem
eigenen Kasten — nicht nur farblich markiert irgendwo mittendrin.
Wer eine lange Liste sieht, liest sie als Bericht über MEINE
Arbeit und übersieht seinen eigenen Teil. Genau daraus entstehen
die meisten Verzögerungen.
2. Der Kunde kann seine eigenen Punkte selbst abhaken. Das ist keine
Spielerei: Es gibt ihm einen sichtbaren Anteil am Fortschritt,
und ich sehe sofort, dass die Texte da sind, ohne dass er extra
schreiben muss.
---------------------------------------------------------------- */
var KATS = ["start", "gestaltung", "umsetzung", "abschluss"];
var KAT_KEY = { start: "po_k1", gestaltung: "po_k2", umsetzung: "po_k3", abschluss: "po_k4" };
function aufgabeZeile(a, hervor) {
var klasse = "po-aufg";
if (a.status === "erledigt") klasse += " po-aufg--fertig";
else if (a.status === "in_arbeit") klasse += " po-aufg--jetzt";
else if (a.status === "entfaellt") klasse += " po-aufg--weg";
var duBistDran = a.wer_dran === "kunde" && a.status !== "erledigt" && a.status !== "entfaellt";
if (duBistDran) klasse += " po-aufg--du";
if (hervor) klasse += " po-aufg--hervor";
/* Nur EIGENE offene Punkte bekommen einen Knopf. Bei allen anderen
ist das Zeichen reine Anzeige — sonst klickt der Kunde darauf,
nichts passiert, und er hält die Seite für kaputt. */
var eigen = a.wer_dran === "kunde" && !a.nicht_enthalten && a.status !== "entfaellt";
var zeichen = a.status === "erledigt" ? "✓" : a.status === "in_arbeit" ? "•" : a.status === "entfaellt" ? "–" : "";
var kaestchen = eigen
? '<button type="button" class="po-aufg-haken" data-haken="' + s(a.id) + '" title="' +
s(window.WD.t(a.status === "erledigt" ? "po_aufg_zurueck" : "po_aufg_hake")) + '" aria-label="' +
s(window.WD.t(a.status === "erledigt" ? "po_aufg_zurueck" : "po_aufg_hake")) + ": " + s(a.titel) + '">' +
zeichen + "</button>"
: '<span class="po-aufg-haken po-aufg-haken--fest" aria-hidden="true">' + zeichen + "</span>";
var marke = a.status === "erledigt"
? '<span class="po-aufg-marke po-aufg-marke--ok">' + s(window.WD.t("po_aufg_erledigt_marke")) + "</span>"
: a.status === "in_arbeit"
? '<span class="po-aufg-marke po-aufg-marke--jetzt">' + s(window.WD.t("po_aufg_arbeit_marke")) + "</span>"
: duBistDran
? '<span class="po-aufg-marke po-aufg-marke--du">' + s(window.WD.t("po_aufg_du_marke")) + "</span>"
: "";
return '<div class="' + klasse + '">' + kaestchen +
'<span class="po-aufg-titel">' + s(a.titel) +
(a.nicht_enthalten ? '<span class="po-aufg-nicht">' + s(window.WD.t("po_aufg_nicht")) + "</span>" : "") +
"</span>" +
'<span class="po-aufg-marken">' + marke + "</span>" +
(a.beschreibung || a.hinweis
? '<span class="po-aufg-text">' + s(a.beschreibung || "") +
(a.hinweis ? " " + s(a.hinweis) : "") + "</span>"
: "") +
"</div>";
}
function aufgabenKarte(d) {
var f = d.fortschritt || { gesamt: 0, erledigt: 0, beimKunden: 0, jeKategorie: {} };
var alle = d.aufgaben || [];
var html = '<div class="wd-karte" style="margin-bottom:1.2rem"><h3>' +
s(window.WD.t("po_aufgaben")) + "</h3>";
if (!alle.length) {
return html + '<p class="wd-leise wd-klein">' + s(window.WD.t("po_aufg_leer")) + "</p></div>";
}
html += '<p class="wd-klein wd-leise" style="margin-top:-.3rem">' +
s(window.WD.t("po_aufg_text")) + "</p>";
/* Grosse Zahl statt Prozent. "9 von 14 erledigt" ist greifbar,
"64 %" ist eine Rechnung, die niemand fuehlt. */
html += '<div class="po-aufg-stand"><b>' + f.erledigt + "</b> " +
s(window.WD.t("po_aufg_fertig").replace("{gesamt}", f.gesamt)) + "</div>";
/* Der Balken in den vier Prozessfarben — dieselben wie auf der
Ablaufseite und in der Verwaltung. */
html += '<div class="po-fortschritt">' + KATS.map(function (k) {
var z = (f.jeKategorie && f.jeKategorie[k]) || { gesamt: 0, erledigt: 0 };
var breite = z.gesamt ? Math.round((z.erledigt / z.gesamt) * 100) : 0;
return '<span class="po-fs-teil" data-k="' + k + '" title="' +
s(window.WD.t(KAT_KEY[k])) + ": " + z.erledigt + "/" + z.gesamt +
'"><i style="width:' + breite + '%"></i></span>';
}).join("") + "</div>";
/* --- Was auf den Kunden wartet, ZUERST und in einem eigenen Kasten. --- */
var meine = alle.filter(function (a) {
return a.wer_dran === "kunde" && a.status !== "erledigt" && a.status !== "entfaellt" && !a.nicht_enthalten;
});
if (meine.length) {
html += '<div class="po-dubist"><h4>' +
s(window.WD.t(meine.length === 1 ? "po_aufg_dubist_eins"
: "po_aufg_dubist_viele").replace("{n}", meine.length)) + "</h4>" +
'<p class="wd-klein wd-leise" style="margin:.1rem 0 .7rem">' +
s(window.WD.t("po_aufg_dubist")) + "</p>" +
meine.map(function (a) { return aufgabeZeile(a, true); }).join("") +
"</div>";
} else {
html += '<p class="po-allesgut">' + s(window.WD.t("po_aufg_allesbei")) + "</p>";
}
/* --- Danach die vollstaendige Liste nach Abschnitten. --- */
html += KATS.map(function (k) {
var drin = alle.filter(function (a) { return a.kategorie === k; });
if (!drin.length) return "";
var z = (f.jeKategorie && f.jeKategorie[k]) || { gesamt: 0, erledigt: 0 };
return '<div class="po-aufg-gruppe" data-k="' + k + '">' +
'<div class="po-aufg-kopf">' + s(window.WD.t(KAT_KEY[k])) +
'<span class="po-aufg-zahl">' + z.erledigt + " / " + z.gesamt + "</span></div>" +
drin.map(function (a) { return aufgabeZeile(a, false); }).join("") +
"</div>";
}).join("");
return html + "</div>";
}
async function ladeUebersicht() {
zeige("po-uebersicht");
var ziel = document.getElementById("po-inhalt");
@@ -261,10 +388,23 @@
}).join("") + "</ul></div>";
}
/* Der allgemeine Nachrichtenbereich steht auf der ÜBERSICHT, nicht
im Projekt. Genau das war der Punkt: Wer kein Projekt hat — oder
eine Frage, die zu keinem gehört — konnte vorher gar nicht
schreiben und musste zur E-Mail greifen. Damit war der Verlauf
weg, sobald man ihn brauchte.
Er wird nachgeladen, nicht mitgeliefert: Die Übersicht soll
sofort dastehen. Ein paar Zehntelsekunden später erscheinen die
Nachrichten — das ist besser, als die ganze Seite auf sie warten
zu lassen. */
html += '<div id="po-postfach" style="margin-top:1.8rem"></div>';
ziel.innerHTML = html;
ziel.querySelectorAll("[data-projekt]").forEach(function (b) {
b.addEventListener("click", function () { ladeProjekt(b.dataset.projekt); });
});
ladePostfach();
} catch (fehler) {
if (behandleFehler(fehler)) return;
ziel.innerHTML = "";
@@ -273,6 +413,100 @@
}
/* ---------------- Projektdetail ---------------- */
/* ---------------- Allgemeines Postfach ----------------
"auf dieser seite sollen die kunden mir auch nachrichten hinterlassen
können, für noch kleinigkeiten oder sachen die ich brauch."
Bewusst niedrigschwellig: kein Betreff, kein Pflichtfeld, der Bezug
zu einem Projekt ist freiwillig. Wer glaubt, eine Nachricht müsse
eine "richtige" Anfrage sein, schreibt gar nicht erst — und genau
die kurzen Fragen sollen hier landen.
---------------------------------------------------------------- */
async function ladePostfach() {
var kasten = document.getElementById("po-postfach");
if (!kasten) return;
var d;
try {
d = await api("/webdesign/portal/postfach");
} catch (fehler) {
/* Still bleiben. Der Bereich ist eine Ergänzung — eine rote
Fehlermeldung über der Projektübersicht wäre alarmierender, als
der Anlass es hergibt. */
return;
}
var html = "<h2>" + s(window.WD.t("po_postfach")) + "</h2>" +
'<div class="wd-karte">' +
'<p class="wd-klein wd-leise" style="margin-top:0">' + s(window.WD.t("po_postfach_text")) + "</p>";
if (!d.nachrichten.length) {
html += '<p class="wd-leise wd-klein">' + s(window.WD.t("po_postfach_leer")) + "</p>";
} else {
html += '<div class="po-pf-verlauf" id="po-pf-verlauf">' + d.nachrichten.map(function (n) {
var vonMir = n.autor === "kunde";
return '<div class="po-nachricht po-nachricht--' + (vonMir ? "ich" : "du") + '">' +
'<div class="po-nachricht-kopf">' +
(vonMir ? "" : s(window.WD.t("po_von_dogfather")) + " · ") +
window.WD.datum(n.erstellt_am) +
(n.projekt_titel ? " · " + s(n.projekt_titel) : "") +
"</div><p>" + s(n.text) + "</p></div>";
}).join("") + "</div>";
}
html += '<div class="wd-feld" style="margin:1rem 0 .6rem" id="po-pf-feld">' +
'<textarea id="po-pf-text" rows="3" placeholder="' +
s(window.WD.t("po_postfach_platzhalter")) + '"></textarea>' +
'<p class="wd-feld-fehler"></p></div>';
if (d.projekte && d.projekte.length) {
html += '<div class="wd-feld" style="margin-bottom:.6rem">' +
'<label for="po-pf-projekt" class="wd-klein">' + s(window.WD.t("po_postfach_bezug")) + "</label>" +
'<select id="po-pf-projekt"><option value="">' +
s(window.WD.t("po_postfach_kein_bezug")) + "</option>" +
d.projekte.map(function (p) {
return '<option value="' + s(p.id) + '">' + s(p.titel) + "</option>";
}).join("") + "</select></div>";
}
html += '<button type="button" class="wd-btn wd-btn--zweit wd-btn--klein" id="po-pf-senden">' +
s(window.WD.t("po_senden")) + "</button></div>";
kasten.innerHTML = html;
var lauf = document.getElementById("po-pf-verlauf");
if (lauf) lauf.scrollTop = lauf.scrollHeight;
var eingabe = document.getElementById("po-pf-text");
var feld = document.getElementById("po-pf-feld");
var knopf = document.getElementById("po-pf-senden");
knopf.addEventListener("click", async function () {
var inhalt = eingabe.value.trim();
feld.classList.remove("wd-feld--fehler");
if (!inhalt) {
feld.classList.add("wd-feld--fehler");
feld.querySelector(".wd-feld-fehler").textContent = window.WD.t("po_postfach_leer_fehler");
eingabe.focus();
return;
}
var wahl = document.getElementById("po-pf-projekt");
window.WD.knopfSperren(knopf, true, "…");
try {
await api("/webdesign/portal/postfach", {
method: "POST",
body: { text: inhalt, projektId: wahl ? wahl.value : null },
});
window.WD.meldung(meldung, window.WD.t("po_postfach_gesendet"), "ok");
await ladePostfach();
} catch (fehler) {
if (behandleFehler(fehler)) return;
window.WD.knopfSperren(knopf, false);
window.WD.meldung(meldung, fehler.message, "fehler");
}
});
}
var aktuellesProjekt = null;
document.getElementById("po-zurueck").addEventListener("click", function () {
@@ -287,7 +521,21 @@
ziel.innerHTML = '<div class="po-laedt">' + s(window.WD.t("laedt")) + "</div>";
try {
var d = await api("/webdesign/portal/projekt/" + encodeURIComponent(id));
/* Beides gleichzeitig anfordern statt nacheinander. Nacheinander
waere die Wartezeit die Summe beider Anfragen — bei einer
Mobilfunkverbindung deutlich spuerbar.
Die Aufgabenliste darf dabei fehlschlagen, ohne die ganze Seite
mitzureissen: Sie ist eine Ergaenzung, keine Voraussetzung. Wer
wegen einer leeren Liste seine Zahlungen und Dateien nicht mehr
saehe, waere schlechter dran als vorher. */
var beides = await Promise.all([
api("/webdesign/portal/projekt/" + encodeURIComponent(id)),
api("/webdesign/portal/projekt/" + encodeURIComponent(id) + "/aufgaben")
.catch(function () { return { aufgaben: [], fortschritt: null }; }),
]);
var d = beides[0];
var aufg = beides[1];
var p = d.projekt;
var html = "";
@@ -302,6 +550,12 @@
: "") +
"</div>";
/* Die Aufgabenliste steht GANZ OBEN, direkt nach dem Projektkopf.
Sie beantwortet die Frage, mit der man das Projekt oeffnet
("wie weit ist es?"). Zahlungen und Dateien sind wichtig, aber
sie sind nicht der Grund fuer den Klick. */
html += aufgabenKarte(aufg);
/* --- Zahlungen --- */
html += '<div class="wd-karte" style="margin-bottom:1.2rem"><h3>' + s(window.WD.t("po_zahlungen")) + "</h3>";
if (!d.zahlungen.length) {
@@ -420,6 +674,26 @@
});
});
/* Eigene Punkte abhaken. Der Punkt erscheint in der Liste zweimal
(oben unter "Das brauche ich noch von dir" und unten im
Abschnitt), deshalb wird nach dem Umschalten die ganze Ansicht
neu aufgebaut — sonst stuenden beide Fassungen widerspruechlich
nebeneinander. */
ziel.querySelectorAll("[data-haken]").forEach(function (b) {
b.addEventListener("click", async function () {
window.WD.knopfSperren(b, true, "…");
try {
await api("/webdesign/portal/aufgabe/" + encodeURIComponent(b.dataset.haken) + "/erledigt",
{ method: "POST", body: {} });
ladeProjekt(id);
} catch (f) {
if (behandleFehler(f)) return;
window.WD.knopfSperren(b, false);
window.WD.meldung(meldung, f.message, "fehler");
}
});
});
ziel.querySelector("#po-idee-senden").addEventListener("click", async function (e) {
var titel = ziel.querySelector("#po-idee-titel").value.trim();
var beschreibung = ziel.querySelector("#po-idee-text").value.trim();