Compare commits
| Author | SHA1 | Date | |
|---|---|---|---|
  florian.wildeandClaude Opus 5
|
72e5eb43c4 | ||
|
florian.wildeandClaude Opus 5
|
e97bd43b23 | ||
|
florian.wildeandClaude Opus 5
|
f8e6c66876 | ||
|
florian.wildeandClaude Opus 5
|
01884f4747 | ||
|
florian.wildeandClaude Opus 5
|
04a07bd36c | ||
|
florian.wildeandClaude Opus 5
|
a3093dc68a |
@@ -102,6 +102,13 @@ Bei Änderungen an der Oberfläche **hinsehen**. Chrome ist installiert, ein
|
||||
Skript mit `playwright-core` und `channel: "chrome"` genügt für Screenshots.
|
||||
Mehrere Anzeigefehler dieses Projekts sind ausschließlich so aufgefallen.
|
||||
|
||||
**Barrierefreiheit misst man, statt sie zu behaupten.** `axe-core` liegt als
|
||||
Entwicklungsabhängigkeit bereit; ein Skript hängt es per `addScriptTag` in
|
||||
die laufende Seite und ruft `axe.run` mit den WCAG-Tags auf. Jeder
|
||||
Dialogzustand ist eine eigene Prüfung — geschlossene Dialoge stehen nicht im
|
||||
DOM. Der Kontrast gedämpfter Texte ist der Punkt, der hier schon einmal
|
||||
gerissen wurde; die aufgehellten Stufen stehen in `globals.css` im `@theme`.
|
||||
|
||||
Wer den Standalone-Bau von Hand startet (`node .next/standalone/server.js`),
|
||||
muss vorher `.next/static` und `public` danebenkopieren — sonst lädt kein
|
||||
JavaScript, die Seite bleibt serverseitig gerendert, und Formulare senden
|
||||
|
||||
+50
-3
@@ -207,6 +207,23 @@ Blockiert · Erledigt**.
|
||||
- Erledigtes wird durchgestrichen; der Zeitpunkt wird festgehalten und beim Zurückziehen
|
||||
wieder gelöscht.
|
||||
|
||||
### Wiederkehrende Aufgaben
|
||||
|
||||
Täglich, wöchentlich, alle zwei Wochen oder monatlich. Wandert die Aufgabe nach
|
||||
**Erledigt** — im Dialog oder durch Ziehen —, entsteht die nächste von selbst. Die
|
||||
erledigte bleibt stehen, sonst ginge die Historie verloren.
|
||||
|
||||
- **Gerechnet wird vom Fälligkeitsdatum, nicht vom Abhaken.** Eine wöchentliche Aufgabe
|
||||
bleibt auf ihrem Montag, auch wenn sie einmal erst am Mittwoch erledigt wurde.
|
||||
- Lange Liegengebliebenes rutscht so weit vor, bis der Termin in der Zukunft liegt — eine
|
||||
Aufgabe, die schon bei ihrer Entstehung überfällig ist, hilft niemandem.
|
||||
- Beim Monatsintervall bleibt der Tag im Monat erhalten. Der 31. Januar wird zum
|
||||
28. Februar, nicht zum 3. März.
|
||||
- Nur der **Übergang** nach Erledigt löst aus. Eine bereits erledigte Aufgabe erneut zu
|
||||
speichern erzeugt keine zweite Fassung.
|
||||
- Bewusst grob gehalten: feinere Regeln („jeden zweiten Dienstag im Monat") braucht ein
|
||||
Projektdashboard nicht und wären ohne Kalenderansicht kaum nachvollziehbar.
|
||||
|
||||
### Aus Git-Issues übernehmen
|
||||
|
||||
Im Git-Panel, Reiter *Issues*: ein Klick macht aus den offenen Issues Aufgaben — Titel,
|
||||
@@ -282,6 +299,29 @@ App und Infrastruktur. Sie gehören trotzdem in **eine** Karte.
|
||||
Der Projektdialog bearbeitet weiterhin nur das führende Repository; weitere verwaltet das
|
||||
Git-Panel. Beim Anlegen eines Projekts entsteht aus den Git-Feldern das erste.
|
||||
|
||||
### 4.0a README-Vorschau
|
||||
|
||||
Das README des führenden Repositories steht auf der Projektseite — man muss nicht ins Git
|
||||
wechseln, nur um zu sehen, worum ein halbvergessenes Projekt eigentlich ging. Lange
|
||||
READMEs sind eingeklappt, ein Knopf zeigt alles.
|
||||
|
||||
- Geholt wird **höchstens einmal am Tag**, wie die Heatmap. GitHub hat einen eigenen
|
||||
Endpunkt, der jede Schreibweise findet; bei GitLab und Gitea braucht es zwei Aufrufe
|
||||
(Wurzelverzeichnis auflisten, dann die Datei holen).
|
||||
- Erkannt werden `README.md` und die üblichen Varianten, Groß- und Kleinschreibung egal.
|
||||
Markdown hat Vorrang — nur das lässt sich wirklich darstellen.
|
||||
- Bei 60 000 Zeichen wird an einer **Zeilengrenze** abgeschnitten, damit kein halber
|
||||
Codeblock stehen bleibt.
|
||||
- **Relative Links** werden gegen das Verzeichnis der Datei im Repository aufgelöst, sonst
|
||||
liefen sie ins Leere.
|
||||
- **Bilder werden nicht geladen.** Die Content-Security-Policy erlaubt `img-src` nur von
|
||||
der eigenen Instanz; sie dafür zu öffnen hieße, jedem fremden README das Nachladen
|
||||
beliebiger Bilder zu gestatten — also auch Zählpixeln. Für Abzeichen und
|
||||
Bildschirmfotos, die in einer Vorschau ohnehin Beiwerk sind, ist das kein guter Tausch.
|
||||
Stattdessen steht ein anklickbarer Verweis mit dem Alternativtext.
|
||||
- Der Inhalt stammt aus einem fremden Repository und läuft deshalb durch dieselbe
|
||||
Bereinigung wie Notizen (`rehype-sanitize`).
|
||||
|
||||
### 4.1 Unterstützte Systeme
|
||||
|
||||
| System | API | Authentifizierung | Besonderheit |
|
||||
@@ -502,8 +542,14 @@ letzten Zustellung stehen an der Karte.
|
||||
- **Animationen**: gestaffelt einblendende Karten, Hover-Lift mit Farbverlaufsrand,
|
||||
animierte Fortschrittsbalken.
|
||||
- **Responsiv** von Handy bis Ultrawide (bis zu vier Kartenspalten).
|
||||
- **Barrierearm**: durchgehende ARIA-Labels, Escape schließt Dialoge, sichtbarer
|
||||
Fokusring, `prefers-reduced-motion` schaltet Animationen ab.
|
||||
- **Barrierefrei nach WCAG 2.1 AA**, und zwar geprüft statt behauptet: axe-core läuft über
|
||||
zehn Seitenzustände einschließlich der Dialoge und meldet keine Verstöße. Durchgehende
|
||||
ARIA-Labels, Escape schließt Dialoge, sichtbarer Fokusring, `prefers-reduced-motion`
|
||||
schaltet Animationen ab.
|
||||
Bei der ersten Durchsicht fielen 26 Kontrastverstöße auf: gedämpfter Text erreichte auf
|
||||
dem sehr dunklen Untergrund nur 3,8 statt 4,5 zu 1. Statt an hundert Stellen die Klasse
|
||||
zu tauschen, sind die beiden gedämpften Stufen im Theme aufgehellt — der Abstand
|
||||
zwischen ihnen bleibt sichtbar.
|
||||
- **Deutschsprachig**, Datums- und Zahlenformate in `de-DE` mit fester Zeitzone
|
||||
Europe/Berlin, damit Server- und Browser-Darstellung übereinstimmen.
|
||||
- **Als App installierbar.** Ein Web-Manifest mit eigenen Symbolen — auf dem Handy
|
||||
@@ -532,7 +578,8 @@ letzten Zustellung stehen an der Karte.
|
||||
| `AppSettings` | Betriebsart und Registrierung (eine Zeile) |
|
||||
| `Project` | Projektstammdaten, Status, Fortschritt, Besitzer |
|
||||
| `Repository` | Repositories eines Projekts inkl. Abgleichstand (n:1 zu Projekt) |
|
||||
| `Task` | Aufgaben mit Spalte, Position, Fälligkeit, Labels und Issue-Herkunft |
|
||||
| `Task` | Aufgaben mit Spalte, Position, Fälligkeit, Labels, Wiederholung und Issue-Herkunft |
|
||||
| `ProjectTemplate` | Vorlagen je Konto: Stammdaten, Tags, Notizen und Aufgaben |
|
||||
| `Activity` | Verlauf je Projekt, neueste zuerst, auf 200 Einträge begrenzt |
|
||||
| `NotificationTarget` | Zustellwege je Konto, mit verschlüsseltem Geheimnis |
|
||||
| `Note` | Notizen (n:1 zu Projekt, Cascade-Delete) |
|
||||
|
||||
+28
-2
@@ -20,6 +20,22 @@ erreichbar ist. Der Zeitplan bleibt als Rückfalllösung.
|
||||
|
||||
---
|
||||
|
||||
### 1.2 Läuft es noch? `M`
|
||||
|
||||
Eine Health-Check-URL je Projekt, die der Zeitgeber regelmäßig anpingt.
|
||||
Nebula wüsste dann, ob ein Projekt nicht nur existiert, sondern auch läuft.
|
||||
Nutzt Zeitgeber und Benachrichtigungen, die es schon gibt. Der SSRF-Schutz
|
||||
greift dabei wie bei den Git-Aufrufen.
|
||||
|
||||
### 1.3 Persönliche API-Token `M`
|
||||
|
||||
Derzeit geht die API nur mit Sitzungscookie. Ein Token je Konto würde
|
||||
`curl`-Aufrufe und Handy-Shortcuts erlauben — Idee aus dem Terminal anlegen,
|
||||
ohne den Browser zu öffnen. Nur der Hash in der Datenbank, wie bei den
|
||||
Sitzungen.
|
||||
|
||||
---
|
||||
|
||||
## 2 · Größere Brocken
|
||||
|
||||
### 2.1 Passwort-Zurücksetzen per E-Mail `M`
|
||||
@@ -38,11 +54,14 @@ Voraussetzung, falls du das Projekt veröffentlichen willst.
|
||||
|
||||
| Idee | Aufwand | Nutzen |
|
||||
| --- | --- | --- |
|
||||
| Wochenrückblick | `S` | „Was ist diese Woche passiert" über alle Projekte, aus dem Aktivitätsverlauf |
|
||||
| Globale Zeitleiste | `S` | Derselbe Verlauf, aber projektübergreifend als eigene Seite |
|
||||
| Suche über Aufgaben | `S` | Die Volltextsuche deckt bisher nur Notizen ab |
|
||||
| Suchtreffer in Notizen hervorheben | `S` | In der Notiz selbst, nicht nur in der Trefferliste |
|
||||
| Wiederkehrende Aufgaben | `M` | Etwa „jeden Montag Abhängigkeiten prüfen" |
|
||||
| Aufgabe ↔ Commit verknüpfen | `M` | Enthält ein Commit `#5`, wird die übernommene Aufgabe verlinkt |
|
||||
| Tastaturkürzel-Übersicht mit `?` | `S` | Es gibt inzwischen genug davon |
|
||||
| Hell/Dunkel umschaltbar | `M` | Aktuell nur dunkel |
|
||||
| Eigenes Logo und Farbe | `S` | Ergänzt `APP_NAME` |
|
||||
| Barrierefreiheits-Durchsicht | `M` | Fokusreihenfolge, Screenreader, Kontraste |
|
||||
| Audit-Log für Adminaktionen | `M` | Nachvollziehbar, wer Konten geändert hat |
|
||||
|
||||
---
|
||||
@@ -54,6 +73,11 @@ Damit klar ist, was **nicht** kommt und warum:
|
||||
- **Geteilte Projekte zwischen Konten.** Die Trennung ist derzeit hart und
|
||||
einfach zu prüfen. Freigaben bringen eine Rechteverwaltung mit sich — nur
|
||||
sinnvoll, wenn wirklich mehrere Leute zusammenarbeiten.
|
||||
- **Veraltete Abhängigkeiten prüfen.** Klingt verlockend, aber Renovate und
|
||||
Dependabot machen das besser, und es wären viele Aufrufe an fremde
|
||||
Registries — für eine Zahl, die im Repo selbst schon steht.
|
||||
- **Anhänge an Notizen.** Bräuchte Dateispeicher und damit eine zweite Sorge
|
||||
bei jeder Sicherung. Ein Link ins Git tut es auch.
|
||||
- **Eigene Git-Operationen** (klonen, committen, pushen). Nebula ist eine
|
||||
Übersicht, keine Entwicklungsumgebung.
|
||||
- **Zeiterfassung, Rechnungen, Kundenverwaltung.** Andere Baustelle.
|
||||
@@ -84,6 +108,8 @@ Damit klar ist, was **nicht** kommt und warum:
|
||||
| **v1.0.0** Aktivitätsverlauf je Projekt, Zwei-Faktor per TOTP, mehrere Repositories je Projekt | ✓ |
|
||||
| **v1.1.0** Freie Reihenfolge im Brett, Mehrfachauswahl, installierbar als App, Änderungsverlauf | ✓ |
|
||||
| **v1.2.0** Commit-Heatmap über ein Jahr, Projektvorlagen | ✓ |
|
||||
| **v1.3.0** Wiederkehrende Aufgaben, Barrierefreiheit nach WCAG 2.1 AA | ✓ |
|
||||
| **v1.4.0** README-Vorschau auf der Projektseite | ✓ |
|
||||
|
||||
Zur Entscheidung beim Export: Git-Tokens gehen **nicht** mit. Die Verbindung wird nur
|
||||
beschrieben, das Token ist nach dem Import neu zu hinterlegen. Snapshots bleiben
|
||||
|
||||
@@ -374,6 +374,76 @@ test("Brett: Reihenfolge und Mehrfachauswahl", async ({ request, playwright }) =
|
||||
expect((await geloescht.json()).changed).toBe(3);
|
||||
});
|
||||
|
||||
test("Wiederkehrende Aufgaben legen die naechste Fassung an", async ({ request }) => {
|
||||
await login(request, ADMIN);
|
||||
|
||||
const projekt = (
|
||||
await (await request.post("/api/projects", { data: { name: "Wiederkehrend" } })).json()
|
||||
).project;
|
||||
|
||||
const woechentlich = (
|
||||
await (
|
||||
await request.post(`/api/projects/${projekt.id}/tasks`, {
|
||||
data: {
|
||||
title: "Abhaengigkeiten pruefen",
|
||||
dueDate: "2026-07-06T12:00:00",
|
||||
recurrence: "WEEKLY",
|
||||
labels: ["wartung"],
|
||||
},
|
||||
})
|
||||
).json()
|
||||
).task;
|
||||
|
||||
// Ein Zwischenschritt loest noch nichts aus.
|
||||
await request.patch(`/api/tasks/${woechentlich.id}`, { data: { status: "DOING" } });
|
||||
let alle = (await (await request.get(`/api/projects/${projekt.id}/tasks`)).json()).tasks;
|
||||
expect(alle).toHaveLength(1);
|
||||
|
||||
// Erst der Uebergang nach ERLEDIGT.
|
||||
const erledigt = await request.patch(`/api/tasks/${woechentlich.id}`, {
|
||||
data: { status: "DONE" },
|
||||
});
|
||||
expect((await erledigt.json()).next).not.toBeNull();
|
||||
|
||||
alle = (await (await request.get(`/api/projects/${projekt.id}/tasks`)).json()).tasks;
|
||||
expect(alle).toHaveLength(2);
|
||||
|
||||
const folge = alle.find((task: { id: string }) => task.id !== woechentlich.id);
|
||||
expect(folge.status).toBe("TODO");
|
||||
expect(folge.title).toBe("Abhaengigkeiten pruefen");
|
||||
expect(folge.labels).toEqual(["wartung"]);
|
||||
expect(folge.recurrence).toBe("WEEKLY");
|
||||
expect(folge.recurredFrom).toBe(woechentlich.id);
|
||||
// Der Termin liegt in der Zukunft und auf demselben Wochentag.
|
||||
expect(new Date(folge.dueDate).getTime()).toBeGreaterThan(Date.now());
|
||||
expect(new Date(folge.dueDate).getUTCDay()).toBe(1);
|
||||
|
||||
// Erneut speichern erzeugt keine dritte.
|
||||
await request.patch(`/api/tasks/${woechentlich.id}`, { data: { title: "Umbenannt" } });
|
||||
alle = (await (await request.get(`/api/projects/${projekt.id}/tasks`)).json()).tasks;
|
||||
expect(alle).toHaveLength(2);
|
||||
|
||||
// Der zweite Weg: durch Ziehen in die Spalte ERLEDIGT.
|
||||
const gezogen = await request.patch(`/api/projects/${projekt.id}/tasks/reorder`, {
|
||||
data: { columns: { DONE: [folge.id] } },
|
||||
});
|
||||
expect(gezogen.ok()).toBeTruthy();
|
||||
|
||||
alle = (await (await request.get(`/api/projects/${projekt.id}/tasks`)).json()).tasks;
|
||||
expect(alle).toHaveLength(3);
|
||||
expect(alle.filter((task: { status: string }) => task.status === "TODO")).toHaveLength(1);
|
||||
|
||||
// Eine einmalige Aufgabe bleibt einmalig.
|
||||
const einmalig = (
|
||||
await (
|
||||
await request.post(`/api/projects/${projekt.id}/tasks`, { data: { title: "Nur einmal" } })
|
||||
).json()
|
||||
).task;
|
||||
await request.patch(`/api/tasks/${einmalig.id}`, { data: { status: "DONE" } });
|
||||
alle = (await (await request.get(`/api/projects/${projekt.id}/tasks`)).json()).tasks;
|
||||
expect(alle).toHaveLength(4);
|
||||
});
|
||||
|
||||
test("Projektvorlagen: aus Projekt sichern und anwenden", async ({ request, playwright }) => {
|
||||
await login(request, ADMIN);
|
||||
|
||||
|
||||
Generated
+13
-2
@@ -1,12 +1,12 @@
|
||||
{
|
||||
"name": "nebula",
|
||||
"version": "1.0.0",
|
||||
"version": "1.2.0",
|
||||
"lockfileVersion": 3,
|
||||
"requires": true,
|
||||
"packages": {
|
||||
"": {
|
||||
"name": "nebula",
|
||||
"version": "1.0.0",
|
||||
"version": "1.2.0",
|
||||
"hasInstallScript": true,
|
||||
"dependencies": {
|
||||
"@dnd-kit/core": "^6.3.1",
|
||||
@@ -34,6 +34,7 @@
|
||||
"@types/qrcode": "^1.5.6",
|
||||
"@types/react": "^19.1.5",
|
||||
"@types/react-dom": "^19.1.5",
|
||||
"axe-core": "^4.12.1",
|
||||
"dotenv": "^17.4.2",
|
||||
"prisma": "^6.8.2",
|
||||
"tailwindcss": "^4.1.7",
|
||||
@@ -2536,6 +2537,16 @@
|
||||
"node": ">=12"
|
||||
}
|
||||
},
|
||||
"node_modules/axe-core": {
|
||||
"version": "4.12.1",
|
||||
"resolved": "https://registry.npmjs.org/axe-core/-/axe-core-4.12.1.tgz",
|
||||
"integrity": "sha512-s7iGf5GaVMxEG0ENN9x+xTr7GFZCb1ZP/1uATUpCEK2X78nDB3RwbtFCo9pGAf9ru+VwoQ464DkaLEeRM08wJA==",
|
||||
"dev": true,
|
||||
"license": "MPL-2.0",
|
||||
"engines": {
|
||||
"node": ">=4"
|
||||
}
|
||||
},
|
||||
"node_modules/bail": {
|
||||
"version": "2.0.2",
|
||||
"resolved": "https://registry.npmjs.org/bail/-/bail-2.0.2.tgz",
|
||||
|
||||
+2
-1
@@ -1,6 +1,6 @@
|
||||
{
|
||||
"name": "nebula",
|
||||
"version": "1.2.0",
|
||||
"version": "1.4.0",
|
||||
"private": true,
|
||||
"description": "Nebula – Dashboard fuer Vibe-Coding Projekte mit Git-Anbindung (GitHub, GitLab, Gitea)",
|
||||
"scripts": {
|
||||
@@ -56,6 +56,7 @@
|
||||
"@types/qrcode": "^1.5.6",
|
||||
"@types/react": "^19.1.5",
|
||||
"@types/react-dom": "^19.1.5",
|
||||
"axe-core": "^4.12.1",
|
||||
"dotenv": "^17.4.2",
|
||||
"prisma": "^6.8.2",
|
||||
"tailwindcss": "^4.1.7",
|
||||
|
||||
@@ -0,0 +1,6 @@
|
||||
-- CreateEnum
|
||||
CREATE TYPE "Recurrence" AS ENUM ('DAILY', 'WEEKLY', 'BIWEEKLY', 'MONTHLY');
|
||||
|
||||
-- AlterTable
|
||||
ALTER TABLE "Task" ADD COLUMN "recurredFrom" TEXT,
|
||||
ADD COLUMN "recurrence" "Recurrence";
|
||||
@@ -0,0 +1,5 @@
|
||||
-- AlterTable
|
||||
ALTER TABLE "RepoSnapshot" ADD COLUMN "readme" TEXT,
|
||||
ADD COLUMN "readmeAt" TIMESTAMP(3),
|
||||
ADD COLUMN "readmeBaseUrl" TEXT,
|
||||
ADD COLUMN "readmePath" TEXT;
|
||||
@@ -71,6 +71,16 @@ enum ActivityKind {
|
||||
SYNC_FAILED
|
||||
}
|
||||
|
||||
/// Wie oft sich eine Aufgabe wiederholt. Bewusst grob: feinere Regeln
|
||||
/// (jeden zweiten Dienstag im Monat) braucht ein Projektdashboard nicht,
|
||||
/// und sie waeren ohne Kalenderansicht kaum nachvollziehbar.
|
||||
enum Recurrence {
|
||||
DAILY
|
||||
WEEKLY
|
||||
BIWEEKLY
|
||||
MONTHLY
|
||||
}
|
||||
|
||||
/// Spalten des Aufgabenbretts innerhalb eines Projekts.
|
||||
enum TaskStatus {
|
||||
TODO
|
||||
@@ -450,6 +460,15 @@ model Task {
|
||||
/// Zeitpunkt, zu dem die Aufgabe nach DONE gewandert ist.
|
||||
doneAt DateTime?
|
||||
|
||||
/// Wiederholt sich die Aufgabe? Wandert sie nach ERLEDIGT, entsteht die
|
||||
/// naechste Fassung mit fortgeschriebenem Faelligkeitsdatum. Die erledigte
|
||||
/// bleibt stehen – sonst ginge die Historie verloren.
|
||||
recurrence Recurrence?
|
||||
/// Aus welcher Aufgabe diese hervorgegangen ist. Nur zur Nachvollziehbarkeit;
|
||||
/// bewusst ohne Fremdschluessel, damit das Loeschen der Vorgaengerin die
|
||||
/// Nachfolgerin nicht mitnimmt.
|
||||
recurredFrom String?
|
||||
|
||||
/// Stammt die Aufgabe aus einem Git-Issue? Nummer, Repository und Link
|
||||
/// merken, damit dasselbe Issue nicht zweimal uebernommen wird.
|
||||
sourceIssue Int?
|
||||
@@ -593,6 +612,16 @@ model RepoSnapshot {
|
||||
commitCalendar Json @default("{}")
|
||||
commitCalendarAt DateTime?
|
||||
|
||||
/// Das README des Repositories, roh als Markdown. Wie der Kalender
|
||||
/// hoechstens einmal am Tag geholt – es aendert sich selten, und der
|
||||
/// Abgleich laeuft im Zweifel stuendlich.
|
||||
readme String?
|
||||
/// Dateiname, wie er im Repository steht ("README.md", "readme.rst" …).
|
||||
readmePath String?
|
||||
/// Wogegen relative Links im README aufzuloesen sind.
|
||||
readmeBaseUrl String?
|
||||
readmeAt DateTime?
|
||||
|
||||
// ── Letzter CI-Lauf auf dem Default-Branch ─────────────────
|
||||
/// success | failure | running | pending | cancelled
|
||||
ciState String?
|
||||
|
||||
@@ -3,7 +3,7 @@ import type { Prisma, TaskStatus } from "@prisma/client";
|
||||
import { requireUserApi } from "@/lib/auth/guard";
|
||||
import { prisma } from "@/lib/db";
|
||||
import { jsonError, readJsonBody } from "@/lib/security/request";
|
||||
import { ownedProject, refreshDerivedProgress } from "@/lib/tasks";
|
||||
import { ownedProject, refreshDerivedProgress, spawnRecurrence } from "@/lib/tasks";
|
||||
import { formatZodError, taskReorderSchema } from "@/lib/validation";
|
||||
|
||||
export const dynamic = "force-dynamic";
|
||||
@@ -52,11 +52,14 @@ export async function PATCH(request: Request, { params }: Params) {
|
||||
|
||||
const now = new Date();
|
||||
const updates: Prisma.PrismaPromise<unknown>[] = [];
|
||||
/** Wer eben erst nach ERLEDIGT gewandert ist – nicht, wer dort schon lag. */
|
||||
const frischErledigt: string[] = [];
|
||||
|
||||
for (const [status, ids] of Object.entries(columns) as Array<[TaskStatus, string[]]>) {
|
||||
ids.forEach((taskId, index) => {
|
||||
if (!ownedIds.has(taskId)) return;
|
||||
const before = previousStatus.get(taskId);
|
||||
if (status === "DONE" && before !== "DONE") frischErledigt.push(taskId);
|
||||
updates.push(
|
||||
prisma.task.update({
|
||||
where: { id: taskId },
|
||||
@@ -77,6 +80,14 @@ export async function PATCH(request: Request, { params }: Params) {
|
||||
|
||||
if (updates.length > 0) {
|
||||
await prisma.$transaction(updates);
|
||||
|
||||
// Wiederkehrende Aufgaben, die eben nach ERLEDIGT gezogen wurden,
|
||||
// bekommen ihre naechste Fassung. Erst nach der Transaktion: vorher
|
||||
// stuende doneAt noch nicht, aus dem der Folgetermin gerechnet wird.
|
||||
for (const taskId of frischErledigt) {
|
||||
await spawnRecurrence(taskId);
|
||||
}
|
||||
|
||||
await refreshDerivedProgress(id);
|
||||
}
|
||||
|
||||
|
||||
@@ -46,7 +46,7 @@ export async function POST(request: Request, { params }: Params) {
|
||||
);
|
||||
}
|
||||
|
||||
const { title, description, status, dueDate, labels } = parsed.data;
|
||||
const { title, description, status, dueDate, labels, recurrence } = parsed.data;
|
||||
|
||||
const task = await prisma.task.create({
|
||||
data: {
|
||||
@@ -58,6 +58,7 @@ export async function POST(request: Request, { params }: Params) {
|
||||
position: await nextPosition(id, status),
|
||||
dueDate: dueDate ? new Date(dueDate) : null,
|
||||
labels,
|
||||
recurrence: recurrence ?? null,
|
||||
doneAt: status === "DONE" ? new Date() : null,
|
||||
},
|
||||
});
|
||||
|
||||
@@ -4,7 +4,12 @@ import { recordActivity, shorten } from "@/lib/activity";
|
||||
import { requireUserApi } from "@/lib/auth/guard";
|
||||
import { prisma } from "@/lib/db";
|
||||
import { jsonError, readJsonBody } from "@/lib/security/request";
|
||||
import { TASK_STATUS_META, nextPosition, refreshDerivedProgress } from "@/lib/tasks";
|
||||
import {
|
||||
TASK_STATUS_META,
|
||||
nextPosition,
|
||||
refreshDerivedProgress,
|
||||
spawnRecurrence,
|
||||
} from "@/lib/tasks";
|
||||
import { formatZodError, taskUpdateSchema } from "@/lib/validation";
|
||||
|
||||
export const dynamic = "force-dynamic";
|
||||
@@ -44,6 +49,7 @@ export async function PATCH(request: Request, { params }: Params) {
|
||||
if (data.title !== undefined) update.title = data.title;
|
||||
if (data.description !== undefined) update.description = data.description;
|
||||
if (data.labels !== undefined) update.labels = data.labels;
|
||||
if (data.recurrence !== undefined) update.recurrence = data.recurrence;
|
||||
if (data.dueDate !== undefined) {
|
||||
update.dueDate = data.dueDate ? new Date(data.dueDate) : null;
|
||||
}
|
||||
@@ -57,6 +63,15 @@ export async function PATCH(request: Request, { params }: Params) {
|
||||
}
|
||||
|
||||
const task = await prisma.task.update({ where: { id }, data: update });
|
||||
|
||||
// Genau beim Uebergang nach ERLEDIGT entsteht die naechste Fassung. Ein
|
||||
// erneutes Speichern einer schon erledigten Aufgabe darf keine zweite
|
||||
// erzeugen – deshalb haengt es an update.status und nicht an data.status.
|
||||
const folge =
|
||||
update.status === "DONE" && existing.status !== "DONE"
|
||||
? await spawnRecurrence(id)
|
||||
: null;
|
||||
|
||||
await refreshDerivedProgress(existing.projectId);
|
||||
|
||||
// Nur der Spaltenwechsel kommt in den Verlauf. Ein umbenannter Titel oder
|
||||
@@ -68,12 +83,14 @@ export async function PATCH(request: Request, { params }: Params) {
|
||||
projectId: existing.projectId,
|
||||
userId: auth.user.id,
|
||||
kind: "TASK_MOVED",
|
||||
summary: `Aufgabe „${shorten(task.title, 50)}“ → ${TASK_STATUS_META[nach].label}`,
|
||||
meta: { taskId: id, from: existing.status, to: nach },
|
||||
summary: folge
|
||||
? `Aufgabe „${shorten(task.title, 40)}“ erledigt, nächste angelegt`
|
||||
: `Aufgabe „${shorten(task.title, 50)}“ → ${TASK_STATUS_META[nach].label}`,
|
||||
meta: { taskId: id, from: existing.status, to: nach, ...(folge ? { next: folge.id } : {}) },
|
||||
});
|
||||
}
|
||||
|
||||
return NextResponse.json({ task });
|
||||
return NextResponse.json({ task, next: folge });
|
||||
}
|
||||
|
||||
export async function DELETE(_request: Request, { params }: Params) {
|
||||
|
||||
@@ -124,6 +124,30 @@
|
||||
}
|
||||
.md a:hover { color: #ddd6fe; }
|
||||
|
||||
/* Bilder werden nicht geladen, sondern als Marke gezeigt – siehe die
|
||||
Begruendung in Markdown.tsx. Damit sie nicht wie Fliesstext aussieht,
|
||||
bekommt sie einen Rahmen und ein Symbol davor. */
|
||||
.md .md-image {
|
||||
display: inline-flex;
|
||||
align-items: center;
|
||||
gap: 0.3em;
|
||||
border: 1px dashed rgba(255, 255, 255, 0.16);
|
||||
border-radius: 0.4rem;
|
||||
padding: 0.05em 0.45em;
|
||||
font-size: 0.85em;
|
||||
color: #8a98b0;
|
||||
text-decoration: none;
|
||||
vertical-align: baseline;
|
||||
}
|
||||
.md .md-image::before {
|
||||
content: "▣";
|
||||
opacity: 0.6;
|
||||
}
|
||||
.md a.md-image:hover {
|
||||
color: #c4b5fd;
|
||||
border-color: rgba(196, 181, 253, 0.4);
|
||||
}
|
||||
|
||||
.md strong { color: #f1f5f9; font-weight: 600; }
|
||||
|
||||
.md ul, .md ol { margin: 0.75em 0; padding-left: 1.35em; }
|
||||
|
||||
@@ -16,6 +16,22 @@
|
||||
--color-void-soft: #0a0c1a;
|
||||
--color-haze: #12142b;
|
||||
|
||||
/* ── Gedaempfte Textfarben ──────────────────────────────────
|
||||
Tailwinds slate-500 und slate-600 kommen auf diesem sehr dunklen
|
||||
Untergrund nur auf 3,8 bzw. 2,5 zu 1. WCAG AA verlangt 4,5 fuer
|
||||
normalen Text, und beide werden hier reichlich fuer Hinweise und
|
||||
Nebenangaben benutzt – axe-core hat das an 26 Stellen beanstandet.
|
||||
|
||||
Statt an hundert Stellen die Klasse zu tauschen, werden die beiden
|
||||
Stufen hier aufgehellt. Der Abstand zwischen ihnen bleibt sichtbar,
|
||||
der Rest des Entwurfs unangetastet.
|
||||
|
||||
Geprueft gegen die drei vorkommenden Untergruende #0b0d1c (Seite),
|
||||
#0e0f17 (.glass) und #14141d (.popover) – der schlechteste Wert
|
||||
zaehlt. */
|
||||
--color-slate-500: #8a98b0; /* 6,3 : 1 */
|
||||
--color-slate-600: #78879f; /* 5,0 : 1 */
|
||||
|
||||
--font-sans: ui-sans-serif, system-ui, -apple-system, "Segoe UI", Roboto,
|
||||
"Helvetica Neue", Arial, "Noto Sans", sans-serif;
|
||||
--font-mono: ui-monospace, "Cascadia Code", "Source Code Pro", Menlo,
|
||||
|
||||
@@ -5,6 +5,7 @@ import { ActivityFeed } from "@/components/ActivityFeed";
|
||||
import { GitPanel } from "@/components/GitPanel";
|
||||
import { Markdown } from "@/components/Markdown";
|
||||
import { NotesPanel } from "@/components/NotesPanel";
|
||||
import { ReadmePanel } from "@/components/ReadmePanel";
|
||||
import { ProjectHeader } from "@/components/ProjectHeader";
|
||||
import { TaskBoard } from "@/components/tasks/TaskBoard";
|
||||
import { requireUserPage } from "@/lib/auth/guard";
|
||||
@@ -54,6 +55,20 @@ export default async function ProjectPage({ params }: PageProps) {
|
||||
|
||||
const detail = project as unknown as ProjectDetail;
|
||||
|
||||
const fuehrend = detail.repositories[0]?.snapshot;
|
||||
const readme = fuehrend?.readme
|
||||
? {
|
||||
content: fuehrend.readme,
|
||||
path: fuehrend.readmePath,
|
||||
baseUrl: fuehrend.readmeBaseUrl,
|
||||
// Die Basis endet auf dem Verzeichnis; angehaengt ergibt das die Datei.
|
||||
fileUrl:
|
||||
fuehrend.readmeBaseUrl && fuehrend.readmePath
|
||||
? `${fuehrend.readmeBaseUrl}${fuehrend.readmePath.split("/").pop()}`
|
||||
: (fuehrend.htmlUrl ?? null),
|
||||
}
|
||||
: null;
|
||||
|
||||
return (
|
||||
<div className="space-y-6 pt-4">
|
||||
<ProjectHeader
|
||||
@@ -83,6 +98,17 @@ export default async function ProjectPage({ params }: PageProps) {
|
||||
)}
|
||||
</section>
|
||||
|
||||
{/* Das README des fuehrenden Repositories – bei mehreren waere eine
|
||||
zweite Vorschau untereinander mehr Laenge als Nutzen. */}
|
||||
{readme ? (
|
||||
<ReadmePanel
|
||||
content={readme.content}
|
||||
path={readme.path}
|
||||
baseUrl={readme.baseUrl}
|
||||
fileUrl={readme.fileUrl}
|
||||
/>
|
||||
) : null}
|
||||
|
||||
<NotesPanel projectId={detail.id} notes={detail.notes} />
|
||||
</div>
|
||||
|
||||
|
||||
@@ -24,12 +24,93 @@ const schema = {
|
||||
},
|
||||
};
|
||||
|
||||
/** Loest relative Verweise gegen die Basis auf; laesst absolute in Ruhe. */
|
||||
function absolut(href: string | undefined, base: string | null | undefined): string | undefined {
|
||||
if (!href || !base) return href;
|
||||
if (/^[a-z][a-z0-9+.-]*:/i.test(href) || href.startsWith("//") || href.startsWith("#")) {
|
||||
return href;
|
||||
}
|
||||
try {
|
||||
return new URL(href, base).toString();
|
||||
} catch {
|
||||
return href;
|
||||
}
|
||||
}
|
||||
|
||||
type HastNode = {
|
||||
type: string;
|
||||
tagName?: string;
|
||||
properties?: Record<string, unknown>;
|
||||
children?: HastNode[];
|
||||
value?: string;
|
||||
};
|
||||
|
||||
/**
|
||||
* Ersetzt Bilder durch eine anklickbare Marke – siehe die Begruendung
|
||||
* unten am `.md-image`-Stil.
|
||||
*
|
||||
* Das passiert im Baum und nicht ueber eine Komponente, weil es auf den
|
||||
* Elternknoten ankommt: `[](ziel)` ist in READMEs die
|
||||
* Regel, und ein `<a>` in einem `<a>` ist ungueltiges HTML. Der Browser
|
||||
* zieht es beim Parsen auseinander, was zu einem Hydrationsfehler fuehrt –
|
||||
* genau daran ist es beim ersten Versuch gescheitert. Innerhalb eines Links
|
||||
* bleibt deshalb nur der Text stehen; der umgebende Link ist ohnehin das,
|
||||
* was man anklicken will.
|
||||
*/
|
||||
function bilderAlsMarke(base: string | null | undefined) {
|
||||
return () => (tree: HastNode) => {
|
||||
const gehe = (knoten: HastNode, inLink: boolean) => {
|
||||
const kinder = knoten.children;
|
||||
if (!kinder) return;
|
||||
|
||||
for (let index = 0; index < kinder.length; index += 1) {
|
||||
const kind = kinder[index];
|
||||
|
||||
if (kind.type === "element" && kind.tagName === "img") {
|
||||
const quelle = typeof kind.properties?.src === "string" ? kind.properties.src : undefined;
|
||||
const alt = typeof kind.properties?.alt === "string" ? kind.properties.alt.trim() : "";
|
||||
const text: HastNode = { type: "text", value: alt || "Bild" };
|
||||
const ziel = absolut(quelle, base);
|
||||
|
||||
kinder[index] =
|
||||
inLink || !ziel
|
||||
? { type: "element", tagName: "span", properties: { className: ["md-image"] }, children: [text] }
|
||||
: {
|
||||
type: "element",
|
||||
tagName: "a",
|
||||
properties: {
|
||||
className: ["md-image"],
|
||||
href: ziel,
|
||||
title: ziel,
|
||||
target: "_blank",
|
||||
rel: "noreferrer noopener nofollow",
|
||||
},
|
||||
children: [text],
|
||||
};
|
||||
continue;
|
||||
}
|
||||
|
||||
gehe(kind, inLink || (kind.type === "element" && kind.tagName === "a"));
|
||||
}
|
||||
};
|
||||
|
||||
gehe(tree, false);
|
||||
};
|
||||
}
|
||||
|
||||
export function Markdown({
|
||||
children,
|
||||
className,
|
||||
baseUrl,
|
||||
}: {
|
||||
children: string | null | undefined;
|
||||
className?: string;
|
||||
/**
|
||||
* Wogegen relative Verweise aufzuloesen sind. Gesetzt beim README aus
|
||||
* einem Repository – dort zeigen Links auf Dateien daneben, die ohne
|
||||
* Basis ins Leere liefen.
|
||||
*/
|
||||
baseUrl?: string | null;
|
||||
}) {
|
||||
if (!children?.trim()) return null;
|
||||
|
||||
@@ -37,12 +118,22 @@ export function Markdown({
|
||||
<div className={cn("md", className)}>
|
||||
<ReactMarkdown
|
||||
remarkPlugins={[remarkGfm]}
|
||||
rehypePlugins={[[rehypeSanitize, schema]]}
|
||||
// Erst bereinigen, dann umbauen: die Marke soll nicht selbst durch
|
||||
// die Bereinigung laufen und dabei ihre Klassen verlieren.
|
||||
rehypePlugins={[[rehypeSanitize, schema], bilderAlsMarke(baseUrl)]}
|
||||
components={{
|
||||
// Links aus fremdem Inhalt immer in neuem Tab und ohne
|
||||
// Zugriff auf das oeffnende Fenster.
|
||||
a: ({ href, children: content }) => (
|
||||
<a href={href} target="_blank" rel="noreferrer noopener nofollow">
|
||||
// className muss durchgereicht werden, sonst verlieren die
|
||||
// Bildmarken aus dem Umbau oben ihre Gestalt.
|
||||
a: ({ href, className: klasse, title, children: content }) => (
|
||||
<a
|
||||
href={absolut(href, baseUrl)}
|
||||
className={klasse}
|
||||
title={title}
|
||||
target="_blank"
|
||||
rel="noreferrer noopener nofollow"
|
||||
>
|
||||
{content}
|
||||
</a>
|
||||
),
|
||||
|
||||
@@ -0,0 +1,86 @@
|
||||
"use client";
|
||||
|
||||
import { useState } from "react";
|
||||
import { BookOpen, ChevronDown, ExternalLink } from "lucide-react";
|
||||
import { Markdown } from "@/components/Markdown";
|
||||
import { cn } from "@/lib/utils";
|
||||
|
||||
/**
|
||||
* Das README des verknuepften Repositories.
|
||||
*
|
||||
* Erspart den Wechsel ins Git, nur um zu sehen, worum ein halbvergessenes
|
||||
* Projekt eigentlich ging. Nicht zum Lesen ganzer Handbuecher gedacht:
|
||||
* eingeklappt zeigt es die ersten Zeilen, ausgeklappt alles.
|
||||
*/
|
||||
export function ReadmePanel({
|
||||
content,
|
||||
path,
|
||||
baseUrl,
|
||||
fileUrl,
|
||||
}: {
|
||||
content: string;
|
||||
path: string | null;
|
||||
baseUrl: string | null;
|
||||
/** Direktlink auf die Datei im Git-System. */
|
||||
fileUrl: string | null;
|
||||
}) {
|
||||
const [offen, setOffen] = useState(false);
|
||||
|
||||
// Kurze READMEs vollstaendig zu zeigen ist einfacher, als sie mit einem
|
||||
// Knopf zu versehen, der nichts freigibt.
|
||||
const kurz = content.length < 900;
|
||||
|
||||
return (
|
||||
<section className="glass p-5">
|
||||
<div className="mb-3 flex flex-wrap items-center justify-between gap-2">
|
||||
<h2 className="flex items-center gap-2 text-sm font-semibold uppercase tracking-wider text-slate-300">
|
||||
<BookOpen className="h-4 w-4 text-cyan-300" />
|
||||
{path ?? "README"}
|
||||
</h2>
|
||||
{fileUrl ? (
|
||||
<a
|
||||
href={fileUrl}
|
||||
target="_blank"
|
||||
rel="noreferrer noopener"
|
||||
className="inline-flex items-center gap-1.5 text-xs text-slate-500 transition-colors hover:text-violet-300"
|
||||
>
|
||||
Im Git öffnen
|
||||
<ExternalLink className="h-3 w-3" />
|
||||
</a>
|
||||
) : null}
|
||||
</div>
|
||||
|
||||
<div className="relative">
|
||||
<div
|
||||
className={cn(
|
||||
"overflow-hidden transition-[max-height] duration-300",
|
||||
!kurz && !offen && "max-h-72",
|
||||
)}
|
||||
>
|
||||
<Markdown baseUrl={baseUrl}>{content}</Markdown>
|
||||
</div>
|
||||
|
||||
{/* Verlauf ueber den abgeschnittenen Rand, damit erkennbar ist, dass
|
||||
es weitergeht. Nur wenn wirklich etwas verdeckt wird. */}
|
||||
{!kurz && !offen ? (
|
||||
<div
|
||||
aria-hidden
|
||||
className="pointer-events-none absolute inset-x-0 bottom-0 h-16 bg-gradient-to-t from-[#0b0d1c] to-transparent"
|
||||
/>
|
||||
) : null}
|
||||
</div>
|
||||
|
||||
{!kurz ? (
|
||||
<button
|
||||
type="button"
|
||||
onClick={() => setOffen((wert) => !wert)}
|
||||
className="btn btn-ghost mt-2 w-full text-xs"
|
||||
aria-expanded={offen}
|
||||
>
|
||||
<ChevronDown className={cn("h-3.5 w-3.5 transition-transform", offen && "rotate-180")} />
|
||||
{offen ? "Weniger" : "Ganzes README anzeigen"}
|
||||
</button>
|
||||
) : null}
|
||||
</section>
|
||||
);
|
||||
}
|
||||
@@ -1,7 +1,8 @@
|
||||
"use client";
|
||||
|
||||
import { AlignLeft, CalendarClock, GripVertical } from "lucide-react";
|
||||
import { AlignLeft, CalendarClock, GripVertical, Repeat } from "lucide-react";
|
||||
import type { Task } from "@prisma/client";
|
||||
import { RECURRENCE_META } from "@/lib/tasks";
|
||||
import { cn, formatDate } from "@/lib/utils";
|
||||
|
||||
/** Faelligkeit einordnen: ueberfaellig, heute, demnaechst. */
|
||||
@@ -69,12 +70,22 @@ export function TaskCard({
|
||||
{task.title}
|
||||
</p>
|
||||
|
||||
{(task.description || task.dueDate || task.labels.length > 0) && (
|
||||
{(task.description || task.dueDate || task.recurrence || task.labels.length > 0) && (
|
||||
<div className="mt-1.5 flex flex-wrap items-center gap-x-2 gap-y-1 text-[10px]">
|
||||
{task.description ? (
|
||||
<AlignLeft className="h-2.5 w-2.5 text-slate-600" aria-label="hat Beschreibung" />
|
||||
) : null}
|
||||
|
||||
{task.recurrence ? (
|
||||
<span
|
||||
className="inline-flex items-center gap-1 text-slate-500"
|
||||
title={`Wiederholt sich: ${RECURRENCE_META[task.recurrence].label}`}
|
||||
>
|
||||
<Repeat className="h-2.5 w-2.5" />
|
||||
{RECURRENCE_META[task.recurrence].short}
|
||||
</span>
|
||||
) : null}
|
||||
|
||||
{task.dueDate ? (
|
||||
<span className={cn("inline-flex items-center gap-1", due?.className)}>
|
||||
<CalendarClock className="h-2.5 w-2.5" />
|
||||
|
||||
@@ -3,9 +3,9 @@
|
||||
import { useEffect, useState } from "react";
|
||||
import { useRouter } from "next/navigation";
|
||||
import { Loader2, Trash2 } from "lucide-react";
|
||||
import type { Task, TaskStatus } from "@prisma/client";
|
||||
import type { Recurrence, Task, TaskStatus } from "@prisma/client";
|
||||
import { Modal } from "@/components/ui/Modal";
|
||||
import { TASK_STATUS_META, TASK_STATUS_ORDER } from "@/lib/tasks";
|
||||
import { RECURRENCE_META, TASK_STATUS_META, TASK_STATUS_ORDER } from "@/lib/tasks";
|
||||
import { cn, parseTags } from "@/lib/utils";
|
||||
|
||||
/** Datum fuer <input type="date"> – ortszeitbezogen, nicht UTC. */
|
||||
@@ -36,6 +36,7 @@ export function TaskDialog({
|
||||
const [status, setStatus] = useState<TaskStatus>(initialStatus);
|
||||
const [dueDate, setDueDate] = useState("");
|
||||
const [labels, setLabels] = useState("");
|
||||
const [recurrence, setRecurrence] = useState<string>("");
|
||||
const [busy, setBusy] = useState(false);
|
||||
const [error, setError] = useState<string | null>(null);
|
||||
|
||||
@@ -48,6 +49,7 @@ export function TaskDialog({
|
||||
setStatus(task?.status ?? initialStatus);
|
||||
setDueDate(toDateInput(task?.dueDate ?? null));
|
||||
setLabels(task?.labels.join(", ") ?? "");
|
||||
setRecurrence(task?.recurrence ?? "");
|
||||
setError(null);
|
||||
}, [open, task, initialStatus]);
|
||||
|
||||
@@ -64,6 +66,7 @@ export function TaskDialog({
|
||||
// Datum nicht auf den Vortag ziehen.
|
||||
dueDate: dueDate ? `${dueDate}T12:00:00` : null,
|
||||
labels: parseTags(labels),
|
||||
recurrence: recurrence || null,
|
||||
};
|
||||
|
||||
try {
|
||||
@@ -194,6 +197,32 @@ export function TaskDialog({
|
||||
placeholder="bug, ui"
|
||||
/>
|
||||
</div>
|
||||
|
||||
<div className="sm:col-span-2">
|
||||
<label className="field-label" htmlFor="task-recurrence">
|
||||
Wiederholung
|
||||
</label>
|
||||
<select
|
||||
id="task-recurrence"
|
||||
className="field"
|
||||
value={recurrence}
|
||||
onChange={(event) => setRecurrence(event.target.value)}
|
||||
>
|
||||
<option value="">– einmalig –</option>
|
||||
{(Object.keys(RECURRENCE_META) as Recurrence[]).map((key) => (
|
||||
<option key={key} value={key}>
|
||||
{RECURRENCE_META[key].label}
|
||||
</option>
|
||||
))}
|
||||
</select>
|
||||
{recurrence ? (
|
||||
<p className="mt-1 text-xs text-slate-500">
|
||||
Sobald die Aufgabe nach „Erledigt“ wandert, entsteht die nächste. Gerechnet
|
||||
wird vom Fälligkeitsdatum, nicht vom Abhaken — eine wöchentliche Aufgabe
|
||||
bleibt also auf ihrem Wochentag.
|
||||
</p>
|
||||
) : null}
|
||||
</div>
|
||||
</div>
|
||||
|
||||
{error ? (
|
||||
|
||||
@@ -41,6 +41,65 @@ export const KIND_META: Record<ChangeKind, { label: string; className: string }>
|
||||
};
|
||||
|
||||
export const CHANGELOG: Release[] = [
|
||||
{
|
||||
version: "1.4.0",
|
||||
date: "2026-07-26",
|
||||
headline: "Worum ging es hier nochmal?",
|
||||
changes: [
|
||||
{
|
||||
kind: "neu",
|
||||
text:
|
||||
"README-Vorschau auf der Projektseite. Erspart den Wechsel ins Git, nur um zu " +
|
||||
"sehen, worum ein halbvergessenes Projekt eigentlich ging.",
|
||||
},
|
||||
{
|
||||
kind: "besser",
|
||||
text:
|
||||
"Relative Links im README zeigen dorthin, wo sie hingehören — aufgelöst gegen " +
|
||||
"das Verzeichnis der Datei im Repository.",
|
||||
},
|
||||
{
|
||||
kind: "besser",
|
||||
text:
|
||||
"Bilder im README werden bewusst nicht geladen, sondern als anklickbarer " +
|
||||
"Verweis gezeigt. Die Content-Security-Policy dafür zu öffnen hieße, jedem " +
|
||||
"fremden README das Nachladen beliebiger Bilder zu erlauben — auch Zählpixeln.",
|
||||
},
|
||||
],
|
||||
},
|
||||
{
|
||||
version: "1.3.0",
|
||||
date: "2026-07-26",
|
||||
headline: "Was sich wiederholt, und was besser lesbar ist.",
|
||||
changes: [
|
||||
{
|
||||
kind: "neu",
|
||||
text:
|
||||
"Wiederkehrende Aufgaben: täglich, wöchentlich, alle zwei Wochen oder monatlich. " +
|
||||
"Wandert die Aufgabe nach „Erledigt“, entsteht die nächste von selbst.",
|
||||
},
|
||||
{
|
||||
kind: "behoben",
|
||||
text:
|
||||
"Gedämpfter Text erreichte auf dem dunklen Untergrund nur 3,8 statt der " +
|
||||
"geforderten 4,5 zu 1 — an 26 Stellen. Beide Stufen sind jetzt aufgehellt, " +
|
||||
"der Abstand zwischen ihnen bleibt sichtbar.",
|
||||
},
|
||||
{
|
||||
kind: "besser",
|
||||
text:
|
||||
"Die Barrierefreiheit ist mit axe-core über zehn Seitenzustände geprüft, " +
|
||||
"einschließlich der Dialoge. Keine Verstöße mehr gegen WCAG 2.1 AA.",
|
||||
},
|
||||
{
|
||||
kind: "besser",
|
||||
text:
|
||||
"Der Folgetermin rechnet vom Fälligkeitsdatum, nicht vom Abhaken — eine " +
|
||||
"wöchentliche Aufgabe bleibt auf ihrem Wochentag. Lange Liegengebliebenes " +
|
||||
"rutscht so weit vor, bis der Termin in der Zukunft liegt.",
|
||||
},
|
||||
],
|
||||
},
|
||||
{
|
||||
version: "1.2.0",
|
||||
date: "2026-07-26",
|
||||
|
||||
@@ -5,6 +5,7 @@ import {
|
||||
calendarSince,
|
||||
type CommitCalendar,
|
||||
} from "./calendar";
|
||||
import { capReadme, decodeBase64, pickReadme, type RepoReadme } from "./readme";
|
||||
import type {
|
||||
BranchInfo,
|
||||
CiInfo,
|
||||
@@ -246,6 +247,43 @@ export class GiteaClient implements GitClient {
|
||||
return commits.map((commit) => toIso(commit.commit?.author?.date));
|
||||
});
|
||||
}
|
||||
|
||||
/**
|
||||
* Gitea kennt keinen README-Endpunkt. Erst das Wurzelverzeichnis
|
||||
* auflisten, dann die gefundene Datei holen – zwei Aufrufe.
|
||||
*/
|
||||
async fetchReadme(ref: RepoRef): Promise<RepoReadme | null> {
|
||||
const base = `${this.apiBase}/repos/${encodeURIComponent(ref.owner)}/${encodeURIComponent(ref.name)}`;
|
||||
const headers = this.headers();
|
||||
|
||||
const eintraege = await getJsonSafe<Array<{ name: string; type: string }>>(
|
||||
`${base}/contents`,
|
||||
[],
|
||||
{ headers },
|
||||
);
|
||||
const name = pickReadme(
|
||||
eintraege.filter((eintrag) => eintrag.type === "file").map((eintrag) => eintrag.name),
|
||||
);
|
||||
if (!name) return null;
|
||||
|
||||
const datei = await getJson<{
|
||||
content?: string;
|
||||
encoding?: string;
|
||||
path?: string;
|
||||
html_url?: string | null;
|
||||
}>(`${base}/contents/${encodeURIComponent(name)}`, { headers });
|
||||
if (!datei?.content || datei.encoding !== "base64") return null;
|
||||
|
||||
const { content, truncated } = capReadme(decodeBase64(datei.content));
|
||||
return {
|
||||
content,
|
||||
path: datei.path ?? name,
|
||||
// html_url zeigt auf die Datei; fuer relative Links braucht es das
|
||||
// Verzeichnis darum herum.
|
||||
baseUrl: datei.html_url ? datei.html_url.replace(/\/[^/]*$/, "/") : null,
|
||||
truncated,
|
||||
};
|
||||
}
|
||||
}
|
||||
|
||||
function mapCommitStatus(state: string): CiState {
|
||||
|
||||
@@ -16,6 +16,7 @@ import type {
|
||||
TicketInfo,
|
||||
} from "./types";
|
||||
import { dayKey } from "./calendar";
|
||||
import { capReadme, decodeBase64, type RepoReadme } from "./readme";
|
||||
import { GitApiError, bucketCommitActivity } from "./types";
|
||||
|
||||
/**
|
||||
@@ -252,6 +253,43 @@ export class GitHubClient implements GitClient {
|
||||
|
||||
return { from: von, to: heute, days, source: "stats", truncated: false };
|
||||
}
|
||||
|
||||
/**
|
||||
* GitHub hat einen eigenen Endpunkt, der jede Schreibweise findet – ein
|
||||
* Aufruf genuegt. Ohne README antwortet er mit 404; das ist kein Fehler,
|
||||
* sondern die Auskunft "gibt es nicht".
|
||||
*/
|
||||
async fetchReadme(ref: RepoRef): Promise<RepoReadme | null> {
|
||||
const base = `${this.apiBase}/repos/${encodeURIComponent(ref.owner)}/${encodeURIComponent(ref.name)}`;
|
||||
|
||||
let datei: GitHubContent;
|
||||
try {
|
||||
datei = await getJson<GitHubContent>(`${base}/readme`, { headers: this.headers() });
|
||||
} catch (error) {
|
||||
if (error instanceof GitApiError && error.status === 404) return null;
|
||||
throw error;
|
||||
}
|
||||
|
||||
if (!datei?.content || datei.encoding !== "base64") return null;
|
||||
|
||||
const { content, truncated } = capReadme(decodeBase64(datei.content));
|
||||
return {
|
||||
content,
|
||||
path: datei.path ?? datei.name ?? "README",
|
||||
// html_url zeigt auf die Datei; fuer relative Links braucht es das
|
||||
// Verzeichnis darum herum.
|
||||
baseUrl: datei.html_url ? datei.html_url.replace(/\/[^/]*$/, "/") : null,
|
||||
truncated,
|
||||
};
|
||||
}
|
||||
}
|
||||
|
||||
interface GitHubContent {
|
||||
name?: string;
|
||||
path?: string;
|
||||
content?: string;
|
||||
encoding?: string;
|
||||
html_url?: string | null;
|
||||
}
|
||||
|
||||
interface GitHubWeek {
|
||||
|
||||
@@ -5,6 +5,7 @@ import {
|
||||
calendarSince,
|
||||
type CommitCalendar,
|
||||
} from "./calendar";
|
||||
import { capReadme, decodeBase64, pickReadme, type RepoReadme } from "./readme";
|
||||
import type {
|
||||
BranchInfo,
|
||||
CiInfo,
|
||||
@@ -227,6 +228,44 @@ export class GitLabClient implements GitClient {
|
||||
return commits.map((commit) => toIso(commit.committed_date ?? commit.created_at));
|
||||
});
|
||||
}
|
||||
|
||||
/**
|
||||
* GitLab kennt keinen README-Endpunkt. Erst das Wurzelverzeichnis
|
||||
* auflisten, dann die gefundene Datei holen – zwei Aufrufe.
|
||||
*/
|
||||
async fetchReadme(ref: RepoRef): Promise<RepoReadme | null> {
|
||||
const base = `${this.apiBase}/projects/${this.projectPath(ref)}`;
|
||||
const headers = this.headers();
|
||||
|
||||
const eintraege = await getJsonSafe<Array<{ name: string; type: string }>>(
|
||||
`${base}/repository/tree?per_page=100`,
|
||||
[],
|
||||
{ headers },
|
||||
);
|
||||
const name = pickReadme(
|
||||
eintraege.filter((eintrag) => eintrag.type === "blob").map((eintrag) => eintrag.name),
|
||||
);
|
||||
if (!name) return null;
|
||||
|
||||
const datei = await getJson<{ content?: string; encoding?: string; file_path?: string }>(
|
||||
`${base}/repository/files/${encodeURIComponent(name)}?ref=HEAD`,
|
||||
{ headers },
|
||||
);
|
||||
if (!datei?.content || datei.encoding !== "base64") return null;
|
||||
|
||||
const { content, truncated } = capReadme(decodeBase64(datei.content));
|
||||
const projekt = await getJsonSafe<GitLabProject>(base, {} as GitLabProject, { headers });
|
||||
|
||||
return {
|
||||
content,
|
||||
path: datei.file_path ?? name,
|
||||
baseUrl:
|
||||
projekt?.web_url && projekt.default_branch
|
||||
? `${projekt.web_url}/-/blob/${encodeURIComponent(projekt.default_branch)}/`
|
||||
: null,
|
||||
truncated,
|
||||
};
|
||||
}
|
||||
}
|
||||
|
||||
function mapPipelineState(status: string | null): CiState {
|
||||
|
||||
@@ -0,0 +1,72 @@
|
||||
import { describe, expect, it } from "vitest";
|
||||
import { README_MAX_CHARS, capReadme, decodeBase64, pickReadme } from "./readme";
|
||||
|
||||
describe("pickReadme", () => {
|
||||
it("findet die uebliche Schreibweise", () => {
|
||||
expect(pickReadme(["src", "README.md", "package.json"])).toBe("README.md");
|
||||
});
|
||||
|
||||
it("ist bei der Gross- und Kleinschreibung nachsichtig", () => {
|
||||
expect(pickReadme(["readme.md"])).toBe("readme.md");
|
||||
expect(pickReadme(["ReadMe.MD"])).toBe("ReadMe.MD");
|
||||
});
|
||||
|
||||
it("zieht Markdown den uebrigen Formaten vor", () => {
|
||||
// Beides kommt vor; nur das erste laesst sich wirklich darstellen.
|
||||
expect(pickReadme(["README.rst", "README.md"])).toBe("README.md");
|
||||
});
|
||||
|
||||
it("nimmt auch ein README ohne Endung", () => {
|
||||
expect(pickReadme(["LICENSE", "README"])).toBe("README");
|
||||
});
|
||||
|
||||
it("liefert null, wenn keines dabei ist", () => {
|
||||
expect(pickReadme(["src", "package.json"])).toBeNull();
|
||||
expect(pickReadme([])).toBeNull();
|
||||
});
|
||||
|
||||
it("verwechselt Aehnliches nicht mit dem README", () => {
|
||||
expect(pickReadme(["README-CONTRIBUTING.md", "readme.md.bak"])).toBeNull();
|
||||
});
|
||||
});
|
||||
|
||||
describe("capReadme", () => {
|
||||
it("laesst Kurzes unangetastet", () => {
|
||||
const { content, truncated } = capReadme("# Titel\n\nEin Satz.");
|
||||
expect(content).toBe("# Titel\n\nEin Satz.");
|
||||
expect(truncated).toBe(false);
|
||||
});
|
||||
|
||||
it("kuerzt Langes an einer Zeilengrenze", () => {
|
||||
// Sonst bliebe womoeglich ein halber Codeblock stehen.
|
||||
const zeile = "x".repeat(80);
|
||||
const lang = Array.from({ length: 2000 }, () => zeile).join("\n");
|
||||
const { content, truncated } = capReadme(lang);
|
||||
expect(truncated).toBe(true);
|
||||
expect(content.length).toBeLessThanOrEqual(README_MAX_CHARS);
|
||||
expect(content.endsWith("x")).toBe(true);
|
||||
expect(content.split("\n").at(-1)).toBe(zeile);
|
||||
});
|
||||
|
||||
it("kuerzt notfalls hart, wenn es gar keine Zeilengrenze gibt", () => {
|
||||
// Eine einzige riesige Zeile: hier waere der letzte Umbruch bei -1.
|
||||
const { content, truncated } = capReadme("y".repeat(README_MAX_CHARS + 500));
|
||||
expect(truncated).toBe(true);
|
||||
expect(content).toHaveLength(README_MAX_CHARS);
|
||||
});
|
||||
});
|
||||
|
||||
describe("decodeBase64", () => {
|
||||
it("dekodiert UTF-8 richtig", () => {
|
||||
// Ueber Bytes gedacht kaeme hier Kauderwelsch heraus.
|
||||
const kodiert = Buffer.from("# Nebula – Übersicht", "utf8").toString("base64");
|
||||
expect(decodeBase64(kodiert)).toBe("# Nebula – Übersicht");
|
||||
});
|
||||
|
||||
it("uebergeht Zeilenumbrueche in der Kodierung", () => {
|
||||
// GitHub bricht den base64-Block alle 60 Zeichen um.
|
||||
const roh = Buffer.from("Hallo Welt", "utf8").toString("base64");
|
||||
const umgebrochen = `${roh.slice(0, 4)}\n${roh.slice(4)}`;
|
||||
expect(decodeBase64(umgebrochen)).toBe("Hallo Welt");
|
||||
});
|
||||
});
|
||||
@@ -0,0 +1,78 @@
|
||||
/**
|
||||
* Das README eines Repositories – gemeinsame Teile fuer alle drei Anbieter.
|
||||
*
|
||||
* Gezeigt wird es auf der Projektseite, damit man nicht ins Git wechseln
|
||||
* muss, nur um zu sehen, worum ein halbvergessenes Projekt eigentlich ging.
|
||||
*/
|
||||
|
||||
export interface RepoReadme {
|
||||
/** Roher Markdown-Text. */
|
||||
content: string;
|
||||
/** Dateiname im Repository, etwa "README.md". */
|
||||
path: string;
|
||||
/**
|
||||
* Basis, gegen die relative Links im Text aufzuloesen sind – die
|
||||
* Web-Ansicht des Repositories im Verzeichnis des READMEs.
|
||||
*/
|
||||
baseUrl: string | null;
|
||||
/** Wurde am Deckel abgeschnitten? */
|
||||
truncated: boolean;
|
||||
}
|
||||
|
||||
/**
|
||||
* Hoechstlaenge. Ein README von einem Megabyte gibt es, und es waere in
|
||||
* einer Vorschau ohnehin unlesbar – abgeschnitten wird an einer
|
||||
* Zeilengrenze, damit kein halber Codeblock stehen bleibt.
|
||||
*/
|
||||
export const README_MAX_CHARS = 60_000;
|
||||
|
||||
/**
|
||||
* Dateinamen, die als README gelten – in dieser Reihenfolge. Markdown zuerst,
|
||||
* weil nur das dargestellt werden kann; die uebrigen landen als Klartext in
|
||||
* einem Codeblock, was immer noch besser ist als nichts.
|
||||
*/
|
||||
const KANDIDATEN = [
|
||||
"readme.md",
|
||||
"readme.markdown",
|
||||
"readme.mdown",
|
||||
"readme",
|
||||
"readme.txt",
|
||||
"readme.rst",
|
||||
];
|
||||
|
||||
/**
|
||||
* Sucht aus einer Verzeichnisauflistung die README-Datei heraus.
|
||||
* Gross- und Kleinschreibung ist egal; die Reihenfolge oben entscheidet.
|
||||
*/
|
||||
export function pickReadme(namen: string[]): string | null {
|
||||
const klein = new Map(namen.map((name) => [name.toLowerCase(), name]));
|
||||
for (const kandidat of KANDIDATEN) {
|
||||
const treffer = klein.get(kandidat);
|
||||
if (treffer) return treffer;
|
||||
}
|
||||
return null;
|
||||
}
|
||||
|
||||
/** Kuerzt am Deckel, aber an einer Zeilengrenze. */
|
||||
export function capReadme(text: string): { content: string; truncated: boolean } {
|
||||
if (text.length <= README_MAX_CHARS) return { content: text, truncated: false };
|
||||
|
||||
const roh = text.slice(0, README_MAX_CHARS);
|
||||
const letzterUmbruch = roh.lastIndexOf("\n");
|
||||
return {
|
||||
// Nur wenn der Umbruch nicht ganz am Anfang liegt – sonst bliebe fast
|
||||
// nichts uebrig.
|
||||
content: letzterUmbruch > README_MAX_CHARS / 2 ? roh.slice(0, letzterUmbruch) : roh,
|
||||
truncated: true,
|
||||
};
|
||||
}
|
||||
|
||||
/**
|
||||
* Dekodiert, was die Anbieter als base64 liefern.
|
||||
*
|
||||
* Bewusst ueber Buffer und nicht ueber atob: der Inhalt ist UTF-8, und atob
|
||||
* gaebe Bytes zurueck, aus denen Umlaute als Kauderwelsch herauskaemen.
|
||||
*/
|
||||
export function decodeBase64(value: string): string {
|
||||
return Buffer.from(value.replace(/\s/g, ""), "base64").toString("utf8");
|
||||
}
|
||||
@@ -1,7 +1,8 @@
|
||||
import type { GitProvider } from "@prisma/client";
|
||||
import type { CommitCalendar } from "./calendar";
|
||||
import type { RepoReadme } from "./readme";
|
||||
|
||||
export type { CommitCalendar };
|
||||
export type { CommitCalendar, RepoReadme };
|
||||
|
||||
export type ProviderKind = GitProvider;
|
||||
|
||||
@@ -181,6 +182,12 @@ export interface GitClient {
|
||||
* hoechstens einmal am Tag noetig ist. null heisst: nichts zu holen.
|
||||
*/
|
||||
fetchCommitCalendar(ref: RepoRef): Promise<CommitCalendar | null>;
|
||||
/**
|
||||
* Das README des Repositories. Wie der Kalender getrennt, weil es
|
||||
* zusaetzliche Aufrufe kostet und sich selten aendert. null heisst: es
|
||||
* gibt keins.
|
||||
*/
|
||||
fetchReadme(ref: RepoRef): Promise<RepoReadme | null>;
|
||||
}
|
||||
|
||||
/** Fehler mit HTTP-Kontext, damit die UI verstaendliche Meldungen zeigen kann. */
|
||||
|
||||
+44
-2
@@ -58,9 +58,10 @@ export async function syncRepository(repositoryId: string): Promise<SyncResult>
|
||||
try {
|
||||
const data = await client.fetchRepo(ref);
|
||||
await persistSnapshot(repository, data);
|
||||
// Erst nach dem Snapshot: die Zeile muss existieren, bevor der Kalender
|
||||
// hineingeschrieben werden kann.
|
||||
// Erst nach dem Snapshot: die Zeile muss existieren, bevor Kalender und
|
||||
// README hineingeschrieben werden koennen.
|
||||
await maybeRefreshCalendar(repository.id, client, ref);
|
||||
await maybeRefreshReadme(repository.id, client, ref);
|
||||
// Nach dem Speichern, damit die Meldung den neuen Stand sieht.
|
||||
await notifyAfterSync(repository.id);
|
||||
return {
|
||||
@@ -196,6 +197,47 @@ async function maybeRefreshCalendar(
|
||||
}
|
||||
}
|
||||
|
||||
/**
|
||||
* Holt das README – wie der Kalender hoechstens einmal am Tag.
|
||||
*
|
||||
* Ein eigener Zeitstempel und nicht der des Kalenders: schlaegt das eine
|
||||
* fehl, soll das andere nicht mit blockiert werden.
|
||||
*/
|
||||
async function maybeRefreshReadme(
|
||||
repositoryId: string,
|
||||
client: GitClient,
|
||||
ref: { owner: string; name: string },
|
||||
): Promise<void> {
|
||||
try {
|
||||
const snapshot = await prisma.repoSnapshot.findUnique({
|
||||
where: { repositoryId },
|
||||
select: { readmeAt: true },
|
||||
});
|
||||
|
||||
const zuletzt = snapshot?.readmeAt?.getTime() ?? 0;
|
||||
if (Date.now() - zuletzt < CALENDAR_TTL_MS) return;
|
||||
|
||||
const readme = await client.fetchReadme(ref);
|
||||
|
||||
// Kein README im Repository: das ist eine Auskunft, kein Fehlschlag.
|
||||
// Der Zeitstempel wird gesetzt, damit nicht jeder Abgleich erneut sucht,
|
||||
// und ein etwaiger alter Stand verschwindet.
|
||||
await prisma.repoSnapshot.update({
|
||||
where: { repositoryId },
|
||||
data: {
|
||||
readme: readme?.content ?? null,
|
||||
readmePath: readme?.path ?? null,
|
||||
readmeBaseUrl: readme?.baseUrl ?? null,
|
||||
readmeAt: new Date(),
|
||||
},
|
||||
});
|
||||
} catch (error) {
|
||||
// Wie beim Kalender: Beiwerk. Ohne Zeitstempel versucht es der naechste
|
||||
// Durchgang von selbst wieder.
|
||||
console.error("[nebula] README konnte nicht geholt werden:", error);
|
||||
}
|
||||
}
|
||||
|
||||
/** Owner/Name aus den Feldern oder ersatzweise aus der URL bestimmen. */
|
||||
export function resolveRepoRef(
|
||||
repository: Pick<Repository, "repoOwner" | "repoName" | "repoUrl">,
|
||||
|
||||
+55
-1
@@ -1,5 +1,10 @@
|
||||
import { describe, expect, it } from "vitest";
|
||||
import { TASK_STATUS_META, TASK_STATUS_ORDER, progressFromTasks } from "./tasks";
|
||||
import {
|
||||
TASK_STATUS_META,
|
||||
TASK_STATUS_ORDER,
|
||||
nextDueDate,
|
||||
progressFromTasks,
|
||||
} from "./tasks";
|
||||
|
||||
describe("progressFromTasks", () => {
|
||||
it("rechnet den Anteil erledigter Aufgaben in Prozent um", () => {
|
||||
@@ -34,3 +39,52 @@ describe("Spaltenreihenfolge", () => {
|
||||
}
|
||||
});
|
||||
});
|
||||
|
||||
describe("nextDueDate", () => {
|
||||
const abhaken = (iso: string) => new Date(iso);
|
||||
|
||||
it("rechnet vom bisherigen Termin, nicht vom Abhaken", () => {
|
||||
// Woechentlich, faellig Montag, erledigt erst Mittwoch: der naechste
|
||||
// Termin bleibt der Montag darauf, nicht der uebernaechste Mittwoch.
|
||||
const next = nextDueDate("WEEKLY", new Date("2026-07-06T12:00:00Z"), abhaken("2026-07-08T09:00:00Z"));
|
||||
expect(next.toISOString().slice(0, 10)).toBe("2026-07-13");
|
||||
});
|
||||
|
||||
it("nimmt ohne bisherigen Termin den Zeitpunkt des Abhakens", () => {
|
||||
const next = nextDueDate("DAILY", null, abhaken("2026-07-26T09:00:00Z"));
|
||||
expect(next.toISOString().slice(0, 10)).toBe("2026-07-27");
|
||||
});
|
||||
|
||||
it("schiebt so lange weiter, bis der Termin in der Zukunft liegt", () => {
|
||||
// Ein halbes Jahr liegengeblieben: die naechste Fassung darf nicht
|
||||
// schon bei ihrer Entstehung ueberfaellig sein.
|
||||
const next = nextDueDate("WEEKLY", new Date("2026-01-05T12:00:00Z"), abhaken("2026-07-26T09:00:00Z"));
|
||||
expect(next.getTime()).toBeGreaterThan(abhaken("2026-07-26T09:00:00Z").getTime());
|
||||
// Und es bleibt ein Montag.
|
||||
expect(next.getUTCDay()).toBe(1);
|
||||
});
|
||||
|
||||
it("haelt beim Monatsintervall den Tag im Monat", () => {
|
||||
const next = nextDueDate("MONTHLY", new Date("2026-03-15T12:00:00Z"), abhaken("2026-03-16T09:00:00Z"));
|
||||
expect(next.toISOString().slice(0, 10)).toBe("2026-04-15");
|
||||
});
|
||||
|
||||
it("rollt beim Monatsintervall nicht ueber kurze Monate hinweg", () => {
|
||||
// Der 31. Januar plus ein Monat ist der 28. Februar, nicht der 3. Maerz.
|
||||
const next = nextDueDate("MONTHLY", new Date("2026-01-31T12:00:00Z"), abhaken("2026-02-01T09:00:00Z"));
|
||||
expect(next.toISOString().slice(0, 10)).toBe("2026-02-28");
|
||||
});
|
||||
|
||||
it("kennt zwei Wochen", () => {
|
||||
const next = nextDueDate("BIWEEKLY", new Date("2026-07-01T12:00:00Z"), abhaken("2026-07-02T09:00:00Z"));
|
||||
expect(next.toISOString().slice(0, 10)).toBe("2026-07-15");
|
||||
});
|
||||
|
||||
it("endet auch bei einem absurd alten Termin", () => {
|
||||
// Ohne Deckel liefe die Schleife bei einem taeglichen Intervall und
|
||||
// einem Datum von 1970 sehr lange.
|
||||
const next = nextDueDate("DAILY", new Date("1970-01-01T00:00:00Z"), abhaken("2026-07-26T09:00:00Z"));
|
||||
expect(next instanceof Date).toBe(true);
|
||||
expect(Number.isNaN(next.getTime())).toBe(false);
|
||||
});
|
||||
});
|
||||
|
||||
+98
-1
@@ -1,4 +1,4 @@
|
||||
import type { TaskStatus } from "@prisma/client";
|
||||
import type { Recurrence, TaskStatus } from "@prisma/client";
|
||||
import { prisma } from "@/lib/db";
|
||||
|
||||
/** Spaltenreihenfolge des Aufgabenbretts. */
|
||||
@@ -64,6 +64,103 @@ export async function refreshDerivedProgress(projectId: string): Promise<void> {
|
||||
});
|
||||
}
|
||||
|
||||
// ── Wiederkehrende Aufgaben ──────────────────────────────────
|
||||
|
||||
export const RECURRENCE_META: Record<Recurrence, { label: string; short: string }> = {
|
||||
DAILY: { label: "Täglich", short: "1 T" },
|
||||
WEEKLY: { label: "Wöchentlich", short: "1 W" },
|
||||
BIWEEKLY: { label: "Alle zwei Wochen", short: "2 W" },
|
||||
MONTHLY: { label: "Monatlich", short: "1 M" },
|
||||
};
|
||||
|
||||
/** Einen Termin um ein Intervall weiterschieben. */
|
||||
function addInterval(from: Date, recurrence: Recurrence): Date {
|
||||
const next = new Date(from);
|
||||
switch (recurrence) {
|
||||
case "DAILY":
|
||||
next.setDate(next.getDate() + 1);
|
||||
break;
|
||||
case "WEEKLY":
|
||||
next.setDate(next.getDate() + 7);
|
||||
break;
|
||||
case "BIWEEKLY":
|
||||
next.setDate(next.getDate() + 14);
|
||||
break;
|
||||
case "MONTHLY": {
|
||||
// setMonth rollt ueber: der 31. Januar wuerde zum 3. Maerz. Bei einem
|
||||
// kuerzeren Folgemonat gehoert der Termin auf dessen letzten Tag.
|
||||
const tag = next.getDate();
|
||||
next.setDate(1);
|
||||
next.setMonth(next.getMonth() + 1);
|
||||
const letzterTag = new Date(next.getFullYear(), next.getMonth() + 1, 0).getDate();
|
||||
next.setDate(Math.min(tag, letzterTag));
|
||||
break;
|
||||
}
|
||||
}
|
||||
return next;
|
||||
}
|
||||
|
||||
/**
|
||||
* Wann die naechste Fassung faellig ist.
|
||||
*
|
||||
* Gerechnet wird vom bisherigen Termin, nicht vom Zeitpunkt des Abhakens:
|
||||
* eine woechentliche Aufgabe soll auf ihrem Montag bleiben, auch wenn sie
|
||||
* einmal erst am Mittwoch erledigt wurde.
|
||||
*
|
||||
* Wurde sie lange liegengelassen, laege der naechste Termin allerdings
|
||||
* immer noch in der Vergangenheit – dann wird so lange weitergeschoben, bis
|
||||
* er in der Zukunft liegt. Sonst entstuende eine Aufgabe, die schon bei
|
||||
* ihrer Entstehung ueberfaellig ist.
|
||||
*
|
||||
* Ohne bisherigen Termin zaehlt der Zeitpunkt des Abhakens.
|
||||
*/
|
||||
export function nextDueDate(
|
||||
recurrence: Recurrence,
|
||||
previousDue: Date | null,
|
||||
completedAt: Date = new Date(),
|
||||
): Date {
|
||||
if (!previousDue) return addInterval(completedAt, recurrence);
|
||||
|
||||
let next = addInterval(previousDue, recurrence);
|
||||
// Deckel gegen eine Endlosschleife bei absurden Datumsangaben.
|
||||
for (let schritt = 0; schritt < 500 && next <= completedAt; schritt += 1) {
|
||||
next = addInterval(next, recurrence);
|
||||
}
|
||||
return next;
|
||||
}
|
||||
|
||||
/**
|
||||
* Legt die naechste Fassung einer wiederkehrenden Aufgabe an.
|
||||
*
|
||||
* Wird genau beim Uebergang nach ERLEDIGT aufgerufen – aus dem Dialog wie
|
||||
* aus dem Ziehen im Brett. Ein erneutes Speichern einer bereits erledigten
|
||||
* Aufgabe darf keine zweite Fassung erzeugen.
|
||||
*
|
||||
* Gibt die neue Aufgabe zurueck oder null, wenn nichts zu tun war.
|
||||
*/
|
||||
export async function spawnRecurrence(taskId: string) {
|
||||
const erledigt = await prisma.task.findUnique({ where: { id: taskId } });
|
||||
if (!erledigt?.recurrence) return null;
|
||||
|
||||
const faellig = nextDueDate(erledigt.recurrence, erledigt.dueDate, erledigt.doneAt ?? new Date());
|
||||
|
||||
return prisma.task.create({
|
||||
data: {
|
||||
projectId: erledigt.projectId,
|
||||
title: erledigt.title,
|
||||
description: erledigt.description,
|
||||
status: "TODO",
|
||||
position: await nextPosition(erledigt.projectId, "TODO"),
|
||||
dueDate: faellig,
|
||||
labels: erledigt.labels,
|
||||
recurrence: erledigt.recurrence,
|
||||
recurredFrom: erledigt.id,
|
||||
// Die Herkunft aus einem Issue wandert nicht mit: das Issue ist
|
||||
// abgearbeitet, und die Eindeutigkeit je Repository verboete es ohnehin.
|
||||
},
|
||||
});
|
||||
}
|
||||
|
||||
/** Naechste freie Position am Ende einer Spalte. */
|
||||
export async function nextPosition(
|
||||
projectId: string,
|
||||
|
||||
@@ -4,6 +4,7 @@ const STATUS = ["IDEA", "OPEN", "PLANNING", "IN_DEVELOPMENT", "DONE", "ARCHIVED"
|
||||
const PROVIDERS = ["GITHUB", "GITLAB", "GITEA"] as const;
|
||||
const ACCENTS = ["violet", "cyan", "emerald", "amber", "rose", "blue"] as const;
|
||||
const TASK_STATUS = ["TODO", "DOING", "BLOCKED", "DONE"] as const;
|
||||
const RECURRENCE = ["DAILY", "WEEKLY", "BIWEEKLY", "MONTHLY"] as const;
|
||||
|
||||
const emptyToNull = (value: unknown) =>
|
||||
typeof value === "string" && value.trim() === "" ? null : value;
|
||||
@@ -157,6 +158,8 @@ export const taskCreateSchema = z.object({
|
||||
status: z.enum(TASK_STATUS).default("TODO"),
|
||||
dueDate: dueDateField,
|
||||
labels: z.array(z.string().trim().min(1).max(30)).max(8).default([]),
|
||||
/** Wiederholt sich die Aufgabe? null = einmalig. */
|
||||
recurrence: z.preprocess(emptyToNull, z.enum(RECURRENCE).nullable().optional()),
|
||||
});
|
||||
|
||||
export const taskUpdateSchema = taskCreateSchema.partial();
|
||||
|
||||
Reference in New Issue
Block a user