feat: Phase 4 — Wetter-Widget, Wiederkehrende Aufgaben, Kanban-Ansicht, PWA

- server/routes/weather.js: OpenWeatherMap-Proxy (aktuelles Wetter + 3-Tage-Forecast, 30-min-Cache, graceful fallback wenn kein API-Key gesetzt) - public/pages/dashboard.js: Weather-Widget parallel mit Dashboard-Daten laden - public/styles/dashboard.css: Weather-Widget-Styles (Gradient, Forecast-Strip) - server/services/recurrence.js: RRULE-Parser (FREQ=DAILY/WEEKLY/MONTHLY, BYDAY, INTERVAL, UNTIL) + nextOccurrence()-Funktion - server/routes/tasks.js: Bei PATCH /:id/status = done → nächste Instanz wiederkehrender Aufgaben automatisch anlegen - public/pages/tasks.js: Kanban-Ansicht (3 Spalten: Offen/In Bearbeitung/Erledigt) mit HTML5 Drag & Drop, View-Toggle (Liste/Kanban) - public/styles/tasks.css: Kanban-Board-Styles (Spalten, Cards, Drag-over-Highlight) - public/sw.js: Cache-Version auf v2, alle Modul-CSS-Dateien im APP_SHELL-Cache Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-03-24 21:32:22 +01:00
parent 74b6e5f078
commit 450ae37f42
8 changed files with 669 additions and 26 deletions
@@ -1,12 +1,99 @@
 /**
 * Modul: Wiederholungsregeln (Recurrence)
- * Zweck: RRULE-Parser und -Generator für wiederkehrende Aufgaben und Termine
- * Abhängigkeiten: keine externen (eigene Implementierung für FREQ=DAILY/WEEKLY/MONTHLY)
+ * Zweck: RRULE-Subset-Parser (FREQ=DAILY/WEEKLY/MONTHLY, BYDAY, INTERVAL, UNTIL)
+ *        + Berechnung des nächsten Fälligkeitsdatums für wiederkehrende Aufgaben
+ * Abhängigkeiten: keine
 */

-// Platzhalter — wird in Phase 4 implementiert
+'use strict';

-module.exports = {
-  nextOccurrence: () => null,
-  expandRule: () => [],
-};
+const DAY_MAP = { MO: 1, TU: 2, WE: 3, TH: 4, FR: 5, SA: 6, SU: 0 };
+
+/**
+ * Parsed einen RRULE-String in ein Objekt.
+ * Beispiel: "FREQ=WEEKLY;BYDAY=MO,TH;INTERVAL=1"
+ * @param {string} rule
+ * @returns {{ freq, interval, byday, until }|null}
+ */
+function parseRRule(rule) {
+  if (!rule) return null;
+  const parts = {};
+  for (const segment of rule.split(';')) {
+    const eq = segment.indexOf('=');
+    if (eq === -1) continue;
+    parts[segment.slice(0, eq).toUpperCase()] = segment.slice(eq + 1);
+  }
+
+  const freq     = parts.FREQ ?? null;
+  const interval = parseInt(parts.INTERVAL ?? '1', 10) || 1;
+  const byday    = (parts.BYDAY ?? '').split(',')
+    .map((d) => DAY_MAP[d.trim().toUpperCase()])
+    .filter((d) => d !== undefined);
+  const until    = parts.UNTIL ? parseUntilDate(parts.UNTIL) : null;
+
+  if (!['DAILY', 'WEEKLY', 'MONTHLY'].includes(freq)) return null;
+
+  return { freq, interval, byday, until };
+}
+
+function parseUntilDate(str) {
+  // Akzeptiert YYYYMMDD oder YYYYMMDDTHHmmssZ
+  const clean = str.replace(/[TZ]/g, '');
+  const y = parseInt(clean.slice(0, 4), 10);
+  const m = parseInt(clean.slice(4, 6), 10) - 1;
+  const d = parseInt(clean.slice(6, 8), 10);
+  return new Date(Date.UTC(y, m, d));
+}
+
+/**
+ * Berechnet das nächste Fälligkeitsdatum nach dem gegebenen Basisdatum.
+ * @param {string} baseDateStr - ISO-Datums-String (YYYY-MM-DD)
+ * @param {string} rrule       - RRULE-String
+ * @returns {string|null}      - Nächstes Datum als YYYY-MM-DD oder null (Ende der Serie)
+ */
+function nextOccurrence(baseDateStr, rrule) {
+  const parsed = parseRRule(rrule);
+  if (!parsed || !baseDateStr) return null;
+
+  const base = new Date(baseDateStr + 'T00:00:00Z');
+  if (isNaN(base.getTime())) return null;
+
+  const { freq, interval, byday, until } = parsed;
+  const next = new Date(base);
+
+  if (freq === 'DAILY') {
+    next.setUTCDate(next.getUTCDate() + interval);
+
+  } else if (freq === 'WEEKLY') {
+    if (byday.length === 0) {
+      // Kein BYDAY → selber Wochentag, nächste Woche
+      next.setUTCDate(next.getUTCDate() + 7 * interval);
+    } else {
+      // Finde den nächsten passenden Wochentag (nach heute)
+      const currentDay = base.getUTCDay();
+      const sorted = [...byday].sort((a, b) => {
+        const da = (a - currentDay + 7) % 7 || 7;
+        const db = (b - currentDay + 7) % 7 || 7;
+        return da - db;
+      });
+      // Tage bis zum nächsten Vorkommen (mind. 1, damit nicht derselbe Tag)
+      let daysUntil = (sorted[0] - currentDay + 7) % 7;
+      if (daysUntil === 0) daysUntil = 7 * interval;
+      next.setUTCDate(next.getUTCDate() + daysUntil);
+    }
+
+  } else if (freq === 'MONTHLY') {
+    const targetDay = base.getUTCDate();
+    next.setUTCMonth(next.getUTCMonth() + interval);
+    // Monatsüberlauf korrigieren (z.B. 31. März + 1 Monat → 30. April)
+    const lastDay = new Date(Date.UTC(next.getUTCFullYear(), next.getUTCMonth() + 1, 0)).getUTCDate();
+    next.setUTCDate(Math.min(targetDay, lastDay));
+  }
+
+  // UNTIL-Grenze prüfen
+  if (until && next > until) return null;
+
+  return next.toISOString().slice(0, 10); // YYYY-MM-DD
+}
+
+module.exports = { parseRRule, nextOccurrence };