projektuebersicht/public/js/plan/plan-history.js

// -----------------------------
// Projektplan — Verlauf über mehrere Sitzungen
// -----------------------------
// Dieses Modul macht die Sitzungs-Historie eines Projekts sichtbar: die
// Kompakt-Karte "Verlauf" unter dem GANTT zeigt den letzten Kommentarwechsel,
// ein Klick öffnet #planHistoryModal mit dem vollständigen Verlauf.
//
// Der Verlauf selbst wird NICHT hier gezeichnet, sondern von
// renderProjektVerlauf() in js/utils.js — derselben Darstellung, die auch der
// Wochenbericht unter der Projektkarte und die Projektliste zeigen. Zuvor
// hatte jede dieser Stellen ihre eigene Fassung mit eigener Auswahl (hier nur
// Sitzungen mit Kommentarwechsel, im Bericht auch Termine und
// Leistungsphasen), weshalb derselbe Projektverlauf je nach Aufrufort anders
// aussah und sich widersprechen konnte. Der Dialog übergibt kein weekLabel:
// Er kennt keine "aktuelle" Fassung, die auszulassen wäre, und zeigt deshalb
// alle Sitzungen einschließlich der geöffneten.
//
// Hintergrund: Beim wöchentlichen cloneWeek() (js/weeks.js) wird der
// Kommentartext in die neue Sitzung kopiert und dort überschrieben. Der alte
// Text bleibt zwar in der alten Sitzung erhalten, war aber praktisch
// unsichtbar, weil niemand in alte Sitzungen zurückwechselt. Damit ging der
// Gesprächsfaden eines Projekts verloren — genau das, wofür das wöchentliche
// Board ursprünglich gedacht war.
//
// WICHTIG — kein neuer Endpunkt nötig: Die Projektplan-Seite lädt über
// GET /load-all ohnehin ALLE Sitzungen mit allen Projekten nach db.weeks
// (siehe loadPlanData() in plan-state.js). Zusammen mit project_uid (der
// dauerhaften, wochenunabhängigen Projekt-Identität, siehe
// migrateAddProjectUid() in server.js) lässt sich der Verlauf daher rein im
// Browser zusammenstellen. Ein serverseitiges GET /projects/:uid/history wird
// erst nötig, wenn der Verlauf auch außerhalb dieser Seite gebraucht wird.
//
// Die hier definierten Helfer projectVersions()/previousProjectVersion()
// werden auch von plan-build-gantt.js gebraucht (Geister-Balken der Vorwoche)
// und deshalb auf window.PlanApp exportiert. Dieses Modul muss daher VOR
// plan-build-gantt.js geladen werden.
//
// Läuft wie alle plan-Module in einem IIFE; Zustand: window.PlanApp
// (plan-state.js).

(function(){
  const app = window.PlanApp;

  // projectVersions: alle Fassungen des aktuellen Projekts über alle
  // geladenen Sitzungen, chronologisch aufsteigend. Die eigentliche Logik
  // liegt seit der Kommentar-Überarbeitung in js/utils.js
  // (projectVersionsForUid), weil das Board sie ebenfalls braucht; hier bleibt
  // nur die Bindung an das aktuell geöffnete Projekt.
  function projectVersions(){
    return projectVersionsForUid(app.project && app.project.projectUid);
  }

  // previousProjectVersion: die Fassung des Projekts aus der Sitzung
  // unmittelbar VOR der gerade geöffneten, oder null (früheste Sitzung bzw.
  // kein projectUid). Rückgabe: { week, project } | null.
  function previousProjectVersion(){
    const versions = projectVersions();
    const idx = versions.findIndex(v => app.week && v.week.label === app.week.label);
    return idx > 0 ? versions[idx - 1] : null;
  }

  // previousPlannedProjectVersion: die jüngste frühere Fassung, die überhaupt
  // einen befüllten Terminplan hat (mindestens eine Aufgabe oder einen
  // Meilenstein). Grundlage für die Geister-Balken im GANTT.
  //
  // Warum nicht einfach previousProjectVersion(): In der Praxis gibt es
  // Sitzungen, in denen ein Projekt zwar geführt wird, aber (noch) keinen
  // Terminplan hat — etwa weil die Sitzung neu angelegt statt dupliziert
  // wurde. Ein Vergleich gegen so eine leere Fassung würde gar nichts
  // anzeigen und die Funktion wirkte kaputt, obwohl es zwei Sitzungen weiter
  // hinten sehr wohl Vergleichsdaten gibt. Deshalb wird rückwärts gesucht,
  // bis eine Fassung mit Planinhalt gefunden ist. Die gefundene Sitzung wird
  // in den Tooltips namentlich genannt, damit der Bezug nie unklar ist.
  // Rückgabe: { week, project } | null.
  function previousPlannedProjectVersion(){
    const versions = projectVersions();
    const idx = versions.findIndex(v => app.week && v.week.label === app.week.label);
    if(idx <= 0) return null;
    for(let i = idx - 1; i >= 0; i--){
      const plan = versions[i].project.plan;
      if(!plan) continue;
      const hasTodos = Array.isArray(plan.todos) && plan.todos.length > 0;
      const hasMilestones = Array.isArray(plan.milestones) && plan.milestones.length > 0;
      if(hasTodos || hasMilestones) return versions[i];
    }
    return null;
  }

  // historyEntries: die Verlaufsliste des aktuell geöffneten Projekts
  // (neueste zuerst, Wiederholungen desselben Textes gefiltert). Logik in
  // js/utils.js, siehe projectStatusHistory().
  function historyEntries(){
    return projectStatusHistory(app.project && app.project.projectUid);
  }

  // renderPlanHistory: füllt die Kompakt-Karte "Verlauf" (#planHistorySummary
  // in Test.html) — Anzahl der Einträge und die Sitzung des letzten
  // Kommentarwechsels. Wird von renderPlanPage() (plan-state.js) nach dem
  // Laden aufgerufen. Keine Parameter, keine Rückgabe.
  window.renderPlanHistory = function(){
    const summaryEl = document.getElementById('planHistorySummary');
    if(!summaryEl || !app.project) return;

    // Ein Sandbox-Plan der Planung lebt in genau einer, nie geklonten Sitzung
    // (SANDBOX_WEEK_LABEL) — es gibt also nie einen "Verlauf über mehrere
    // Sitzungen" zu zeigen, nur immer denselben einen Schnappschuss.
    if(app.isSandboxPlan && app.isSandboxPlan()){
      summaryEl.innerHTML = '<span class="hint">Kein Verlauf — dieser Terminplan gehört zu keiner Sitzung.</span>';
      return;
    }

    if(!app.project.projectUid){
      summaryEl.innerHTML = '<span class="hint">Für dieses Projekt ist kein Verlauf verfügbar.</span>';
      return;
    }
    const entries = historyEntries();
    if(entries.length === 0){
      summaryEl.innerHTML = '<span class="hint">Noch keine Kommentare erfasst.</span>';
      return;
    }
    const latest = entries[0];
    const versionCount = projectVersions().length;
    summaryEl.innerHTML = `<div class="plan-mini-card-preview">${esc(latest.text)}</div>
      <div class="plan-mini-chip-row">
        <span class="plan-mini-chip">${entries.length} Eintrag${entries.length === 1 ? '' : 'e'}</span>
        <span class="plan-mini-chip">zuletzt ${esc(latest.week.label)}</span>
        <span class="plan-mini-chip">${versionCount} Sitzung${versionCount === 1 ? '' : 'en'}</span>
      </div>`;
  };

  // openHistoryModal/closeHistoryModal: öffnen bzw. schließen das
  // Verlaufs-Modal (#planHistoryModal). Der Inhalt wird beim Öffnen frisch
  // aufgebaut, damit ein gerade im Projektinfo-Modal geänderter Kommentar
  // sofort mit auftaucht.
  window.openHistoryModal = function(){
    const listEl = document.getElementById('planHistoryList');
    if(listEl){
      if(!app.project || !app.project.projectUid){
        listEl.innerHTML = '<span class="hint">Dieses Projekt hat keine dauerhafte Projekt-Kennung und kann daher nicht über Sitzungen hinweg verfolgt werden.</span>';
      } else {
        // Dieselbe Darstellung wie im Wochenbericht und im Projektboard
        // (renderProjektVerlauf(), js/utils.js). Der Dialog hatte zuvor eine
        // eigene, enger gefasste Liste — sie zeigte nur Kommentartexte und
        // konnte dem Verlauf an den anderen Stellen widersprechen.
        //
        // weekLabel bleibt leer: Im Dialog gibt es keine "aktuelle" Fassung,
        // die auszulassen wäre — hier sollen ALLE Sitzungen erscheinen,
        // einschließlich der gerade geöffneten.
        listEl.innerHTML = renderProjektVerlauf(app.project, '', app.isLocked());
      }
    }
    document.getElementById('planHistoryModal').style.display = 'flex';
  };

  window.closeHistoryModal = function(){
    document.getElementById('planHistoryModal').style.display = 'none';
  };

  // Export für die anderen plan-Module (plan-gantt.js/plan-build-gantt.js:
  // Geister-Balken der letzten geplanten Sitzung).
  app.projectVersions = projectVersions;
  app.previousProjectVersion = previousProjectVersion;
  app.previousPlannedProjectVersion = previousPlannedProjectVersion;
})();