// ----------------------------- // Projektübersicht — Daten laden, Speichern // ----------------------------- // Diese Datei bildet die Schnittstelle zum Server: Sie lädt beim Start alle // (firmenweit globalen, nicht mehr abteilungsgetrennten) Sitzungen und speichert // den kompletten Datenbestand (alle Wochen + globale Personenliste). Die Daten // liegen serverseitig in einer SQLite-Datenbank und werden als strukturierte // JSON-Objekte über die API ausgetauscht (keine CSV-Strings). Sie wird von // `Test.html` nach `js/date-picker.js` und `js/server.js` geladen und stellt // die globalen Funktionen `save()`, `syncAllToServer()`, `load()`, `seed()` // und `demoProj()` bereit. Aufrufer sind u.a. `js/weeks.js`, `js/board/board.js`, // `js/people/people.js`, `js/projects/projects.js` und `js/load/load.js`; das // Speichern ist über `saveSyncTimer` (in `js/globals.js` deklariert) um 500 ms // debounced. // save: plant einen (debounced) Sync. Standardmäßig wird die aktuell gewählte // Woche als geändert markiert, da sich die meisten Bearbeitungen auf die // aktuelle Sitzung beziehen. Optionen: // { week:false } – aktuelle Woche NICHT markieren (z. B. reine Personen-Aktionen) function save(opts = {}){ if(opts.week !== false){ const w = currentWeek(); if(w) markWeekDirty(w.label); } scheduleSessionSync(); } // Dirty-Tracking: merkt sich, welche Wochen seit dem letzten Sync lokal // geändert wurden. Gespeichert wird nur das, was sich wirklich geändert hat // (statt wie früher immer alle Wochen). Die globale Personenliste hat seit der // Ablösung von people/person_roles/person_absences keinen eigenen Schreibpfad // mehr (Projektbeteiligte werden über die Benutzerverwaltung gepflegt). let dirtyWeeks = new Set(); // weekChangeCounter: zählt je Woche die Änderungen mit. syncAllToServer merkt // sich den Stand beim Absenden und räumt die Dirty-Markierung nur auf, wenn er // sich bis zur Antwort nicht verändert hat. Ohne diesen Zähler verlor eine // Änderung, die WÄHREND eines laufenden Speichervorgangs entsteht, ihre // Markierung: Der eingereihte Nachlauf-Sync fand dann nichts mehr zu senden, // und das Getippte stand nur noch im Browser. const weekChangeCounter = new Map(); // syncProblemTimer: Wiederholungsversuch nach einem fehlgeschlagenen Speichern. let syncProblemTimer = null; // In-Flight-Schutz für syncAllToServer: läuft bereits ein Sync, wird kein // zweiter gestartet (sonst senden zwei Syncs dieselbe Woche mit gleicher // Revisions-Basis und der zweite bekäme einen scheinbaren 409-Konflikt). // Stattdessen wird ein Nachlauf-Sync eingereiht und nach Abschluss ausgeführt. let syncInFlight = false; let syncQueued = false; // showSyncProblem: blendet unten rechts ein Band ein, wenn das Speichern // fehlschlägt. Vorher stand der Fehler ausschließlich in der Browser-Konsole — // der Nutzer arbeitete ahnungslos weiter, während seit Stunden nichts mehr // gespeichert wurde. Parameter: message (Text) oder null zum Ausblenden. function showSyncProblem(message){ let el = document.getElementById('syncProblemBar'); if(!message){ if(el) el.style.display = 'none'; return; } if(!el){ el = document.createElement('div'); el.id = 'syncProblemBar'; el.className = 'sync-problem-bar'; document.body.appendChild(el); } el.textContent = message; el.style.display = ''; } // scheduleSyncRetry: versucht ein fehlgeschlagenes Speichern nach 20 Sekunden // erneut. Ohne das blieb eine Woche nach einem Netzaussetzer dauerhaft // ungespeichert, bis der Nutzer zufällig etwas anderes bearbeitete. function scheduleSyncRetry(){ if(syncProblemTimer || dirtyWeeks.size === 0) return; syncProblemTimer = setTimeout(() => { syncProblemTimer = null; if(dirtyWeeks.size > 0) syncAllToServer(); }, 20000); } // scheduleSessionSync: plant den Speichervorgang für alle Wochen und Personen // über einen 500-ms-Timer (Debounce). Bei erneutem Aufruf wird ein laufender // Timer zurückgesetzt, damit aufeinanderfolgende Änderungen in einem Sync enden. function scheduleSessionSync(){ if(saveSyncTimer){ clearTimeout(saveSyncTimer); } saveSyncTimer = setTimeout(() => { syncAllToServer(); saveSyncTimer = null; }, 500); } // syncAllToServer: schreibt nur die seit dem letzten Sync geänderten Wochen // zum Server. Konflikte (409) auf einer Woche werden über // handleWeekConflict() gemeldet. Fehlerhaft gespeicherte Wochen bleiben dirty, // damit der nächste Sync sie erneut versucht; nur erfolgreich gespeicherte // werden aus dem Dirty-Satz entfernt. function syncAllToServer(){ if(syncInFlight){ syncQueued = true; return; } syncInFlight = true; const jobs = []; const weekLabels = Array.from(dirtyWeeks); let problem = ''; weekLabels.forEach(label => { // Die Planung-Sandbox steckt bewusst nicht in db.weeks (siehe // db.sandboxWeek, oben in load()) — ohne diesen Zweig würde jede // Sandbox-Änderung hier lautlos verworfen (dirtyWeeks.delete ohne // jemals zu speichern), weil db.weeks.find() sie nie findet. const w = label === SANDBOX_WEEK_LABEL ? db.sandboxWeek : db.weeks.find(x => x.label === label); if(!w){ dirtyWeeks.delete(label); return; } // Stand der Änderungen zum Zeitpunkt des Absendens merken (siehe // weekChangeCounter): Nur wenn er bei der Antwort unverändert ist, sind // wirklich alle Änderungen dieser Woche beim Server angekommen. const sentGeneration = weekChangeCounter.get(label) || 0; jobs.push(sendWeekToServer(w) .then(res => { if(res && res.ok){ console.log('Sitzung gespeichert:', w.label); // Lokale Revisions-Basis aktualisieren, damit spätere eigene Saves // nicht fälschlich als Konflikt gemeldet werden. if(res.updatedAt) w.updatedAt = res.updatedAt; if((weekChangeCounter.get(label) || 0) === sentGeneration) dirtyWeeks.delete(label); } else { problem = 'Sitzung "' + w.label + '" konnte nicht gespeichert werden.'; console.error('Sitzung konnte nicht gespeichert werden:', w.label, res && res.error ? res.error : 'unbekannter Fehler'); } }) .catch(err => { if(err && err.conflict){ dirtyWeeks.delete(label); handleWeekConflict(w, err); } else if(err && err.status === 401){ // Sitzung am Server abgelaufen: Anmeldefenster zeigen, statt still // weiterzuarbeiten und alles Weitere zu verlieren. problem = 'Nicht mehr angemeldet — bitte neu anmelden, sonst gehen Änderungen verloren.'; if(typeof showLoginOverlay === 'function') showLoginOverlay(); console.error('Speichern abgelehnt (nicht angemeldet):', w.label); } else { problem = 'Speichern fehlgeschlagen (' + (err && err.message ? err.message : 'unbekannt') + ') — neuer Versuch in 20 Sekunden.'; console.error('Sitzung konnte nicht gespeichert werden:', w.label, (err && err.message) || err); // Label bleibt dirty -> der nächste Sync versucht es erneut. } })); }); Promise.all(jobs).then(() => { syncInFlight = false; showSyncProblem(problem || null); if(problem) scheduleSyncRetry(); if(syncQueued){ syncQueued = false; syncAllToServer(); } }); } // markWeekDirty: markiert eine bestimmte Woche (label) als geändert – für // Aktionen, die Wochen AUFßER der aktuellen betreffen (z. B. Auto-Lock). function markWeekDirty(label){ if(typeof label !== 'string' || !label) return; dirtyWeeks.add(label); weekChangeCounter.set(label, (weekChangeCounter.get(label) || 0) + 1); } // handleWeekConflict: wird aufgerufen, wenn der Server eine zwischenzeitlich // geänderte Woche meldet (409). Nur diese eine Woche wird vom Server neu // geladen; andere lokal geänderte Wochen (dirtyWeeks) und die Personenliste // bleiben unangetastet und gehen nicht verloren. function handleWeekConflict(week, err){ const label = (week && week.label) || (err && err.label) || ''; alert('Achtung: ' + label + ' wurde zwischenzeitlich von einer anderen Person ' + 'geändert. Ihre Änderungen an dieser Sitzung wurden nicht gespeichert; ' + 'die aktuellen Daten dieser Sitzung werden geladen.'); if(label) reloadWeekFromServer(label); else load(); } // reloadWeekFromServer: lädt alle Sitzungen neu und ersetzt NUR die // übergebene Woche (bzw. entfernt sie, falls sie am Server gelöscht wurde). // Der Dirty-Zustand der konfliktbehafteten Woche wurde bereits von // syncAllToServer entfernt; alle anderen Dirty-Änderungen bleiben erhalten. function reloadWeekFromServer(label){ fetch(baseUrl() + '/load-all') .then(r => { if(!r.ok) throw new Error('Server HTTP '+r.status); return r.json(); }) .then(data => { const fresh = (Array.isArray(data.weeks) ? data.weeks : []) .find(w => w && w.label === label); const idx = db.weeks.findIndex(w => w.label === label); if(idx >= 0){ if(fresh){ // Felder absichern (wie in load()), damit keine kaputten Daten crashen if(!Array.isArray(fresh.people)) fresh.people = []; if(!Array.isArray(fresh.projects)) fresh.projects = []; if(!fresh.attendance) fresh.attendance = {}; db.weeks[idx] = fresh; } else { db.weeks.splice(idx, 1); } // Wurde die aktuelle Woche entfernt, auf die letzte verbleibende wechseln if(!db.weeks.some(w => w.id === db.currentWeek)){ db.currentWeek = db.weeks.length ? db.weeks[db.weeks.length - 1].id : null; } } renderAll(); showTab(currentTab); }) .catch(err => { // KEIN load() als Rückfall: Das leert dirtyWeeks und ersetzt alle Wochen, // also gingen auch die noch ungespeicherten Änderungen an ANDEREN // Sitzungen verloren — genau das, was diese Funktion vermeiden soll. console.error('Neu laden der Sitzung fehlgeschlagen:', err); showSyncProblem('Die Sitzung "' + label + '" konnte nicht neu geladen werden. Bitte die Seite neu laden.'); }); } // load: liest alle Sitzungen und die globale Personenliste über `/load-all` // als JSON vom Server und baut daraus `db.weeks` auf. Sortiert nach // `weekSortKey()`, wendet `applyAutoLock()` an und rendert die Ansicht. Kein // Parameter, keine Rückgabe; bei Fehlern oder fehlenden Daten werden // Beispieldaten über `seed()` geladen. // loadAppSettings: holt die firmenweiten Einstellungen (GET /app-settings) // und die Feiertage (GET /holidays) und legt sie in APP_SETTINGS/HOLIDAYS ab // (js/globals.js). Beides wird zum RECHNEN gebraucht — Auslastung, Ampel, // Terminplan aus dem Honorar —, deshalb sind die Routen für jedes angemeldete // Konto lesbar; nur das Ändern ist Administratoren vorbehalten. // // Scheitert der Abruf, bleiben die Vorgaben aus js/globals.js stehen. Das ist // Absicht: Die Anwendung rechnet dann wie vor dem Ausbau der Einstellungen // weiter, statt mit leeren Werten falsche Zahlen zu zeigen. // Rückgabe: Promise (wird nie abgelehnt). function loadAppSettings(){ const settings = fetch(baseUrl() + '/app-settings') .then(r => { if(!r.ok) throw new Error('Server HTTP ' + r.status); return r.json(); }) .then(data => { if(data && data.settings) APP_SETTINGS = Object.assign({}, APP_SETTINGS, data.settings); }) .catch(err => { console.warn('Firmenweite Einstellungen konnten nicht geladen werden, es gelten die Vorgabewerte:', err); }); const holidays = fetch(baseUrl() + '/holidays') .then(r => { if(!r.ok) throw new Error('Server HTTP ' + r.status); return r.json(); }) .then(data => { const list = Array.isArray(data.holidays) ? data.holidays : []; HOLIDAYS = new Set(list.map(h => h.date)); HOLIDAY_NAMES = {}; list.forEach(h => { HOLIDAY_NAMES[h.date] = h.name || ''; }); // Die Bundesländer liefert dieselbe Route mit (siehe server.js); die // Pflege-Maske im Admin-Bereich baut daraus ihre Auswahl. if(data.states) GERMAN_STATES = data.states; }) .catch(err => { console.warn('Feiertage konnten nicht geladen werden:', err); }); // Honorar-Anteile je Leistungsphase: Die Auslastung rechnet den offenen // Wert einer Phase in Stunden um und braucht dafür deren Anteil am // Gesamthonorar. Zusammen mit den übrigen Vorgaben geladen, also VOR // /load-all und damit vor dem ersten renderAll(). const honorar = fetch(baseUrl() + '/honorar-config') .then(r => { if(!r.ok) throw new Error('Server HTTP ' + r.status); return r.json(); }) .then(data => { HONORAR_ANTEILE = (data && data.anteile) || {}; }) .catch(err => { console.warn('Honorar-Anteile konnten nicht geladen werden, die Auslastung weist sie als fehlend aus:', err); }); return Promise.all([settings, holidays, honorar]); } function load(){ // Nach einem (Neu-)Load sind die lokalen Daten serverseitig aktuell: // laufenden Debounce abbrechen und Dirty-Zustand verwerfen. if(saveSyncTimer){ clearTimeout(saveSyncTimer); saveSyncTimer = null; } dirtyWeeks.clear(); if(!window.fetch){ alert('Ihr Browser unterstützt keine Netzwerk-Anfragen. Bitte verwenden Sie einen aktuellen Browser.'); return; } const url = baseUrl() + '/load-all'; console.log('Loading from', url); // Erst die firmenweiten Einstellungen und Feiertage, dann die Sitzungen: // renderAll() am Ende rechnet bereits damit (Ampel-Schwellen, Balkenskala, // Aufwandsvorlage, Arbeitstage). loadAppSettings() lehnt nie ab, ein // Fehlschlag lässt also nur die Vorgabewerte stehen. loadAppSettings().then(() => fetch(url) .then(r => { if(!r.ok) throw new Error('Server HTTP '+r.status); return r.json(); }) .then(data => { // Globale Personenliste laden (flaches Array, keine Abteilungstrennung) db.globalPeople = Array.isArray(data.people) ? data.people : []; // db.sandboxWeek: die Planung-Sandbox (SANDBOX_WEEK_LABEL) — bewusst // NICHT Teil von db.weeks (siehe /load-all, server.js), sondern ein // eigenes, synthetisches Wochen-ähnliches Objekt, hier und nur hier // aufgebaut. Damit sehen renderBoard()/berichtProjekte()/ // berechneAuslastung()/die Sitzungs-PDFs/Admin→Sitzungen sie nie — // sie iterieren alle ausschließlich db.weeks. people wird aus der // globalen Personenliste abgeleitet (dieselbe Form wie week.people), // damit die Beteiligten-Matrix im Projektbereich auch für einen // Sandbox-Plan Kandidaten zur Auswahl hat. db.sandboxWeek = { id: 'sandbox', label: SANDBOX_WEEK_LABEL, date: '', people: db.globalPeople.map(p => ({ id: p.id, name: p.name, fullName: p.fullName })), projects: Array.isArray(data.sandboxPlans) ? data.sandboxPlans : [], attendance: {}, locked: false, updatedAt: data.sandboxUpdatedAt || '' }; db.weeks = (Array.isArray(data.weeks) ? data.weeks : []) .filter(w => w && typeof w.label === 'string') .map(w => { // Felder absichern, damit alte/kaputte Dokumente nicht crashen if(!Array.isArray(w.people)) w.people = []; if(!Array.isArray(w.projects)) w.projects = []; if(!w.attendance) w.attendance = {}; return w; }); if(db.weeks.length === 0){ console.warn('Server lieferte 0 Sitzungen. Es werden Beispieldaten (seed) angezeigt. Pruefen Sie, ob die SQLite-Datenbank sessions/projektuebersicht.db existiert.'); seed(); } else { db.weeks.sort((a,b) => weekSortKey(a.label).localeCompare(weekSortKey(b.label))); applyAutoLock(); const latest = db.weeks[db.weeks.length - 1]; if(!db.currentWeek || !db.weeks.some(w => w.id === db.currentWeek)){ db.currentWeek = latest.id; } console.log(`Server-Load erfolgreich: ${db.weeks.length} Sitzung(en).`); } // Geschützte Tabs ('projects'/'people') dürfen nur mit Passwort angezeigt // werden. showTab() öffnet dafür automatisch das Passwort-Modal – auch // wenn der Tab per Deep-Link-URL (z. B. "/Projekte") gewählt wurde. renderAll(); showTab(currentTab); }) .catch(err => { console.error('Laden vom Server fehlgeschlagen:', err); const serverUrl = baseUrl(); const msg = 'Server unter ' + serverUrl + ' nicht erreichbar.\n\n' + 'Mögliche Ursachen:\n' + '- Der Server wurde nicht gestartet\n' + '- Der Server läuft auf einem anderen Port (Standard: 3003)\n' + '- Firewall/Antivirus blockiert ' + serverUrl + '\n\n' + 'Es werden keine Daten angezeigt. Bitte die Seite neu laden, sobald der Server wieder läuft.'; alert(msg); // BEWUSST KEIN seed(): Die Beispieldaten enthalten eine Woche "KW 30 / 2026" // und wurden früher über save() an den Server geschickt, sobald die // Verbindung zurückkam — sie überschrieben damit die echte gleichnamige // Sitzung. Bei einem Ladefehler bleibt der Bestand jetzt einfach leer. db.weeks = []; db.currentWeek = null; renderAll(); })); } // seed: initialisiert Beispiel-Daten (Personen + eine Woche mit Projekten). // Wird als Fallback verwendet, wenn der Server nicht erreichbar ist oder keine // Sitzungsdateien liefert. function seed(){ const people = [ {id:personIdForName('AP'), name:"AP", fullName:"Anton Peters", role:["Planung"]}, {id:personIdForName('SK'), name:"SK", fullName:"Stefan Krause", role:["Planung"]}, {id:personIdForName('AK'), name:"AK", fullName:"Alexander Klein", role:["Planung"]}, {id:personIdForName('ED'), name:"ED", fullName:"Eva Dreyer", role:["Planung"]}, {id:personIdForName('SE'), name:"SE", fullName:"Stefan Eschweiler", role:["Planung"]}, {id:personIdForName('THK'), name:"THK", fullName:"Thorsten H. Klein", role:["Projektleitung"]}, {id:personIdForName('SP'), name:"SP", fullName:"Sven Peschke", role:["Projektleitung"]}, {id:personIdForName('SG'), name:"SG", fullName:"Sandra Gloag", role:["Projektleitung"]}, {id:personIdForName('TW'), name:"TW", fullName:"Thorsten Wörster", role:["Projektleitung"]}, {id:personIdForName('RR'), name:"RR", fullName:"Robert Rahn", role:["Bauüberwachung"]}, {id:personIdForName('MK'), name:"MK", fullName:"Martin Kluge", role:["Bauüberwachung"]}, {id:personIdForName('HR'), name:"HR", fullName:"Hartwig Rauch", role:["Bauüberwachung"]}, ]; db.globalPeople = JSON.parse(JSON.stringify(people)); const wid = uid(); db.weeks = [{ id: wid, label:"KW 30 / 2026", date:"2026-07-24", attendance:{}, people, projects: [ demoProj("18-4007","Janusz-Korczak-Gesamtsch. Bottrop","Aktive Projekte","LPH5 als Vorabzug raus. NW-Räume vorauss. August.",{"LPH 1":100,"LPH 2":100,"LPH 3":100,"LPH 5":100,"LPH 6":100,"LPH 7":100,"LPH 8":95}), demoProj("21-4030","NSHV Köln Immobilienprüfung in Hof","Aktive Projekte","Thorsten W. klärt und übernimmt Schriftverkehr. LV liegt zur Sichtung bei T.W.",{"LPH 1":100,"LPH 2":100,"LPH 3":100,"LPH 5":100,"LPH 6":100}), demoProj("22-4056","Gymnasium Hemer","Aktive Projekte","",{"LPH 1":100,"LPH 2":100,"LPH 3":100,"LPH 5":100,"LPH 6":100,"LPH 7":100,"LPH 8":90}), demoProj("22-4066","DSW 21 – Umbau E-Mobilität","Aktive Projekte","Elt-Montagen ab KW 33.",{"LPH 1":100,"LPH 2":100,"LPH 3":100,"LPH 5":100,"LPH 6":100,"LPH 7":100,"LPH 8":20}), demoProj("24-4043","S-K ODL-Heim Sanierung Krefeld","Aktive Projekte","Voraussichtlich LV-Abgabe.",{"LPH 1":100,"LPH 2":100,"LPH 3":100,"LPH 5":100}), ] }]; db.currentWeek = wid; save(); } // demoProj: Helfer zum Erzeugen eines Projekt-Objekts (für seed/Tests). // projectUid: dauerhafte, wochenunabhängige Identität (siehe saveNewProj() // in js/load/load.js für die Erklärung, warum sie sich von id unterscheidet). function demoProj(nr,name,group,status,lph){ return {id:uid(), projectUid: uid(), nr, name, group, status, lph: {...lph}, assign:{}, plan: null, aufwandProLP: undefined, aktuelleLP: undefined}; }