Compare commits
| Author | SHA1 | Date | |
|---|---|---|---|
|
|
a2547b9022 | ||
|
|
fd633983b8 | ||
|
|
1b5f3fa1b2 | ||
|
|
6ee529576d | ||
|
|
77567c06cd | ||
|
|
e9f01ba8fa | ||
|
|
7920b6a20f | ||
|
|
6c3f2d5bb6 | ||
|
|
3617222cc1 | ||
|
|
43a4c70053 | ||
|
|
65a31b7cc9 | ||
|
|
ce224bc2a4 | ||
|
|
a264eb0dce | ||
|
|
afe57c4428 | ||
|
|
0ef0b3d5ca | ||
|
|
9cdd51fba8 | ||
|
|
5713facc75 | ||
|
|
52f2d0ce8e |
@@ -64,6 +64,31 @@ SSRF-Schutz (`lib/security/ssrf.ts`).
|
|||||||
- **Datumsangaben** über `lib/utils` formatieren (feste Zeitzone), sonst
|
- **Datumsangaben** über `lib/utils` formatieren (feste Zeitzone), sonst
|
||||||
weichen Server-Render und Hydration voneinander ab. Relative Zeiten
|
weichen Server-Render und Hydration voneinander ab. Relative Zeiten
|
||||||
bekommen `suppressHydrationWarning`.
|
bekommen `suppressHydrationWarning`.
|
||||||
|
- **Die feste Zeitzone gilt auch beim *Rechnen*, nicht nur beim Formatieren.**
|
||||||
|
Im Container läuft die Anwendung nach UTC; „welcher Kalendertag" und
|
||||||
|
„welche Woche" kippen dort abends um einen Tag. `lib/tasks` (`dueBucket`)
|
||||||
|
und `lib/review` (`wocheUm`) rechnen deshalb über Berliner Kalendertage.
|
||||||
|
Und eine Woche ist **nicht** „7 × 24 Stunden" — bei einer Zeitumstellung
|
||||||
|
hat sie 167 oder 169.
|
||||||
|
- **`min-width: auto` bei Flex- und Grid-Kindern.** Hat hier zweimal
|
||||||
|
zugeschlagen: ein Kind weigert sich, unter die Inhaltsbreite seines
|
||||||
|
breitesten Kindes zu schrumpfen, und drückt stattdessen die Nachbarn aus
|
||||||
|
dem Bild. Einmal war es ein Sortierfeld mit `min-width`, das „Neues
|
||||||
|
Projekt" hinausschob; einmal die Heatmap, die die ganze Projektseite
|
||||||
|
doppelt so breit machte. Heilmittel ist beide Male `min-w-0` am Kind —
|
||||||
|
ohne das greift auch ein `overflow-x-auto` darin nicht.
|
||||||
|
- **`body { overflow-x: hidden }` versteckt genau diese Fehler.** Es steht in
|
||||||
|
`globals.css` als Notnagel; was es abschneidet, ist auf dem Telefon
|
||||||
|
schlicht nicht mehr erreichbar. Ursachen gehören in die Komponente.
|
||||||
|
- **Dialoge müssen der Bildschirmtastatur ausweichen.** Sie verkleinert nur
|
||||||
|
das *sichtbare* Fenster, nicht das Layoutfenster — `position: fixed` und
|
||||||
|
`100vh` beziehen sich weiter auf das volle. `components/ui/Modal.tsx` hängt
|
||||||
|
dafür an `window.visualViewport`; wer ein eigenes Overlay baut, braucht
|
||||||
|
dasselbe.
|
||||||
|
- **Blättern über Cursor, nicht über `skip`.** Der Aktivitätsverlauf schreibt
|
||||||
|
mehrere Zeilen im selben Augenblick; ein Offset über so eine Grenze hinweg
|
||||||
|
überspringt oder verdoppelt lautlos. Muster in `lib/timeline.ts`:
|
||||||
|
`(createdAt, id)` als Cursor, Sortierung identisch zur Bedingung.
|
||||||
|
|
||||||
## Migrationen
|
## Migrationen
|
||||||
|
|
||||||
@@ -83,9 +108,24 @@ vergleicht mit der *laufenden* Datenbank. Ist eine eben erzeugte Migration
|
|||||||
dort noch nicht eingespielt, steht ihr Inhalt in der nächsten gleich noch
|
dort noch nicht eingespielt, steht ihr Inhalt in der nächsten gleich noch
|
||||||
einmal.
|
einmal.
|
||||||
|
|
||||||
**Die erzeugte SQL vor dem Anwenden lesen.** Der Volltextindex
|
**Das Zielverzeichnis vorher *nicht* anlegen.** Ein leerer Ordner unter
|
||||||
`Note_fulltext_idx` ist ein Ausdrucksindex, den Prisma nicht kennt (er wird
|
`prisma/migrations/` lässt `--from-migrations` mit `P3015` abbrechen
|
||||||
bislang in Ruhe gelassen, aber das ist nicht garantiert).
|
(„Could not find the migration file"). Erst die SQL woandershin erzeugen,
|
||||||
|
dann Ordner anlegen und hineinkopieren.
|
||||||
|
|
||||||
|
**Die erzeugte SQL vor dem Anwenden lesen.** Die Volltextindizes
|
||||||
|
`Note_fulltext_idx` und `Task_fulltext_idx` sind Ausdrucksindizes, die Prisma
|
||||||
|
nicht kennt (sie werden bislang in Ruhe gelassen, aber das ist nicht
|
||||||
|
garantiert).
|
||||||
|
|
||||||
|
**Ein Ausdrucksindex greift nur bei Zeichengleichheit.** Weicht der Ausdruck
|
||||||
|
in der Abfrage auch nur in einem `coalesce` vom Index ab, rechnet Postgres
|
||||||
|
`to_tsvector` je Zeile neu — ohne Fehlermeldung. Nachsehen statt annehmen:
|
||||||
|
|
||||||
|
```bash
|
||||||
|
docker exec nebula-db psql -U nebula -d <db> -c "SET enable_seqscan = off;
|
||||||
|
EXPLAIN (COSTS OFF) SELECT …" # muss einen Bitmap Index Scan zeigen
|
||||||
|
```
|
||||||
|
|
||||||
**Datenmigrationen von Hand schreiben.** `migrate diff` kennt nur den
|
**Datenmigrationen von Hand schreiben.** `migrate diff` kennt nur den
|
||||||
Zielzustand: Spalten, die woandershin wandern, würde es ersatzlos löschen.
|
Zielzustand: Spalten, die woandershin wandern, würde es ersatzlos löschen.
|
||||||
@@ -103,6 +143,18 @@ Bei Änderungen an der Oberfläche **hinsehen**. Chrome ist installiert, ein
|
|||||||
Skript mit `playwright-core` und `channel: "chrome"` genügt für Screenshots.
|
Skript mit `playwright-core` und `channel: "chrome"` genügt für Screenshots.
|
||||||
Mehrere Anzeigefehler dieses Projekts sind ausschließlich so aufgefallen.
|
Mehrere Anzeigefehler dieses Projekts sind ausschließlich so aufgefallen.
|
||||||
|
|
||||||
|
**Seitlichen Überlauf misst man.** `document.documentElement.scrollWidth`
|
||||||
|
gegen `clientWidth` auf 375 px — das findet in Sekunden, was beim Ansehen
|
||||||
|
durchrutscht. Ein Skript, das dabei nur die *obersten* Verursacher meldet
|
||||||
|
(Eltern, die selbst schon überlaufen, herausfiltern), ist deutlich brauchbarer
|
||||||
|
als eine Liste aller betroffenen Knoten.
|
||||||
|
|
||||||
|
**Die Testdaten müssen die Bausteine enthalten, um die es geht.** Eine
|
||||||
|
Messung gegen ein Projekt ohne Repository, ohne Snapshot und ohne README
|
||||||
|
bescheinigte hier einmal „alles in Ordnung", während die echte Projektseite
|
||||||
|
doppelt so breit war wie der Bildschirm. Erst mit vollständigen Daten
|
||||||
|
nachgestellt trat der Fehler zutage.
|
||||||
|
|
||||||
**Barrierefreiheit misst man, statt sie zu behaupten.** `axe-core` liegt als
|
**Barrierefreiheit misst man, statt sie zu behaupten.** `axe-core` liegt als
|
||||||
Entwicklungsabhängigkeit bereit; ein Skript hängt es per `addScriptTag` in
|
Entwicklungsabhängigkeit bereit; ein Skript hängt es per `addScriptTag` in
|
||||||
die laufende Seite und ruft `axe.run` mit den WCAG-Tags auf. Jeder
|
die laufende Seite und ruft `axe.run` mit den WCAG-Tags auf. Jeder
|
||||||
|
|||||||
+42
-1
@@ -283,6 +283,23 @@ Zurückspielen:
|
|||||||
|
|
||||||
## Updates
|
## Updates
|
||||||
|
|
||||||
|
Es sind zwei getrennte Orte, und das ist der Punkt, an dem es leicht
|
||||||
|
durcheinandergeht:
|
||||||
|
|
||||||
|
| | Was dort liegt |
|
||||||
|
| --- | --- |
|
||||||
|
| **Das Git-Repository** | Der Quellcode. Dorthin wird entwickelt. |
|
||||||
|
| **Diese Instanz** | Die laufende Anwendung, die du im Browser benutzt. |
|
||||||
|
|
||||||
|
Ein Commit im Git ändert am laufenden Nebula **nichts**. Der Server holt sich
|
||||||
|
von allein nichts ab; er betreibt weiter die Fassung, die dort zuletzt gebaut
|
||||||
|
wurde. Ein Update ist der Schritt dazwischen: holen, bauen, umschalten.
|
||||||
|
|
||||||
|
**Woran du siehst, was gerade läuft:** die Versionsnummer unten in der
|
||||||
|
Fußzeile. Ein Klick darauf öffnet den Änderungsverlauf. Steht dort eine
|
||||||
|
ältere Nummer als im Git, fehlen dir die neueren Funktionen — sie sind
|
||||||
|
geschrieben, aber noch nicht auf diesem Server.
|
||||||
|
|
||||||
Dafür gibt es `scripts/update.sh`. Es macht alles in der richtigen
|
Dafür gibt es `scripts/update.sh`. Es macht alles in der richtigen
|
||||||
Reihenfolge und bricht ab, sobald ein Schritt scheitert:
|
Reihenfolge und bricht ab, sobald ein Schritt scheitert:
|
||||||
|
|
||||||
@@ -308,7 +325,7 @@ nennt den Weg zurück.
|
|||||||
|
|
||||||
```bash
|
```bash
|
||||||
./scripts/update.sh --yes # ohne Rückfrage, für Cron
|
./scripts/update.sh --yes # ohne Rückfrage, für Cron
|
||||||
./scripts/update.sh --ref v1.4.0 # auf eine bestimmte Fassung
|
./scripts/update.sh --ref v1.9.0 # auf eine bestimmte Fassung
|
||||||
./scripts/update.sh --no-pull # nur neu bauen, ohne git pull
|
./scripts/update.sh --no-pull # nur neu bauen, ohne git pull
|
||||||
```
|
```
|
||||||
|
|
||||||
@@ -354,6 +371,23 @@ docker system df
|
|||||||
docker image prune -f # alte Abbilder nach mehreren Updates
|
docker image prune -f # alte Abbilder nach mehreren Updates
|
||||||
```
|
```
|
||||||
|
|
||||||
|
### Webhooks
|
||||||
|
|
||||||
|
Der Abgleich holt den Stand in seinem Takt. Wer ihn **sofort** haben will —
|
||||||
|
ein Push ist durch, ein Issue wurde geschlossen —, trägt im Git-System einen
|
||||||
|
Webhook ein. Nebula erzeugt URL und Geheimnis am Repository (Funksymbol im
|
||||||
|
Git-Bereich der Projektseite), eingetragen wird der Haken von Hand.
|
||||||
|
|
||||||
|
Voraussetzung ist, dass **dein Git-System diese Instanz erreicht**. Hinter
|
||||||
|
dem Reverse Proxy ist das gegeben; in einem abgeschotteten Netz nicht. Der
|
||||||
|
Endpunkt liegt unter `/api/webhooks/<repositoryId>` und ist der einzige ohne
|
||||||
|
Anmeldung — ausgewiesen wird sich über eine Signatur, die gegen das
|
||||||
|
hinterlegte Geheimnis geprüft wird.
|
||||||
|
|
||||||
|
**Ohne Webhook geht nichts verloren.** Der Abgleich prüft den Zustand
|
||||||
|
verknüpfter Issues ohnehin mit und hakt erledigte Aufgaben nach. Der Webhook
|
||||||
|
macht es nur sofort statt beim nächsten Durchlauf.
|
||||||
|
|
||||||
### Automatischer Abgleich
|
### Automatischer Abgleich
|
||||||
|
|
||||||
Standardmäßig **aus**. Einzuschalten unter *Admin-Einstellungen →
|
Standardmäßig **aus**. Einzuschalten unter *Admin-Einstellungen →
|
||||||
@@ -383,6 +417,13 @@ Damit du weißt, worum du dich **nicht** kümmern musst:
|
|||||||
Zugriffe; Kontosperre nach acht Fehlversuchen.
|
Zugriffe; Kontosperre nach acht Fehlversuchen.
|
||||||
- **Git-Tokens** liegen AES-256-GCM-verschlüsselt in der Datenbank und
|
- **Git-Tokens** liegen AES-256-GCM-verschlüsselt in der Datenbank und
|
||||||
verlassen den Server nie — auch nicht im Export.
|
verlassen den Server nie — auch nicht im Export.
|
||||||
|
- **Sitzungen** laufen nach 8 Stunden ohne Nutzung ab und spätestens nach
|
||||||
|
30 Tagen (`SESSION_IDLE_HOURS`, `SESSION_TTL_DAYS`). In der Datenbank liegt
|
||||||
|
nur der Hash des Tokens; das Cookie ist `HttpOnly`, `SameSite=Strict` und
|
||||||
|
bei HTTPS zusätzlich mit dem Präfix `__Host-`.
|
||||||
|
- **Passwörter** werden mit scrypt nach der Empfehlung des OWASP Password
|
||||||
|
Storage Cheat Sheet gehasht (N = 2^17). Rechnet mit rund einer halben
|
||||||
|
Sekunde je Anmeldung — das ist gewollt.
|
||||||
- Der **Bildoptimierer** von Next ist abgeschaltet: Nebula benutzt ihn nicht,
|
- Der **Bildoptimierer** von Next ist abgeschaltet: Nebula benutzt ihn nicht,
|
||||||
und `/_next/image` wäre sonst eine Angriffsfläche ohne Gegenwert.
|
und `/_next/image` wäre sonst eine Angriffsfläche ohne Gegenwert.
|
||||||
|
|
||||||
|
|||||||
+97
-6
@@ -145,12 +145,17 @@ dort wäre er auf schmalen Anzeigen mit der Auswahlleiste kollidiert.
|
|||||||
Favoriten bleiben stets oben.
|
Favoriten bleiben stets oben.
|
||||||
- **Vier Ansichten**: freies Raster, **kompakte Liste**, nach Status gruppierte Abschnitte
|
- **Vier Ansichten**: freies Raster, **kompakte Liste**, nach Status gruppierte Abschnitte
|
||||||
oder **Kanban**.
|
oder **Kanban**.
|
||||||
- **Volltextsuche über Notizen.** Die Suche im Board arbeitet auf den geladenen Projekten
|
- **Volltextsuche über Notizen und Aufgaben.** Die Suche im Board arbeitet auf den
|
||||||
(Name, Kurzbeschreibung, Tags, Repo-Pfad). Notizen liegen dort nicht vor — sie
|
geladenen Projekten (Name, Kurzbeschreibung, Tags, Repo-Pfad). Notizen und Aufgaben
|
||||||
mitzuladen würde die Seite aufblähen. Stattdessen sucht Postgres serverseitig mit
|
liegen dort nicht vor — sie mitzuladen würde die Seite aufblähen. Stattdessen sucht
|
||||||
seiner deutschen Textsuche, entprellt ab zwei Zeichen. Treffer erscheinen als eigene
|
Postgres serverseitig mit seiner deutschen Textsuche, entprellt ab zwei Zeichen.
|
||||||
Liste mit hervorgehobener Fundstelle, die betroffenen Projekte werden zusätzlich
|
Treffer erscheinen als zwei eigene Listen mit hervorgehobener Fundstelle, die
|
||||||
eingeblendet. Deutsche Stammformen greifen: „Webhook" findet auch „Webhooks".
|
betroffenen Projekte werden zusätzlich eingeblendet. Deutsche Stammformen greifen:
|
||||||
|
„Webhook" findet auch „Webhooks", „Rechnung" auch „Rechnungen".
|
||||||
|
|
||||||
|
Beide Seiten haben je einen **Ausdrucksindex** (`Note_fulltext_idx`,
|
||||||
|
`Task_fulltext_idx`). Der Ausdruck darin muss Zeichen für Zeichen dem in der Abfrage
|
||||||
|
entsprechen, sonst greift er nicht und Postgres rechnet `to_tsvector` je Zeile neu.
|
||||||
- **Archiv** ist standardmäßig ausgeblendet und per Schalter einblendbar.
|
- **Archiv** ist standardmäßig ausgeblendet und per Schalter einblendbar.
|
||||||
- **Leerzustände** mit direktem Einstieg statt einer leeren Fläche.
|
- **Leerzustände** mit direktem Einstieg statt einer leeren Fläche.
|
||||||
|
|
||||||
@@ -250,6 +255,10 @@ Blockiert · Erledigt**.
|
|||||||
Fälligkeitsdatum und Labels.
|
Fälligkeitsdatum und Labels.
|
||||||
- **Fälligkeiten** färben sich mit: überfällig rot, heute gelb, in den nächsten Tagen
|
- **Fälligkeiten** färben sich mit: überfällig rot, heute gelb, in den nächsten Tagen
|
||||||
gedämpft.
|
gedämpft.
|
||||||
|
- **Hängt ein Git-Issue daran**, trägt die Karte dessen Nummer — vorn in der Fußzeile,
|
||||||
|
vor Beschreibung, Wiederholung, Frist und Labels, damit sich eine Spalte danach
|
||||||
|
überfliegen lässt. Bewusst kein Link: der Weg zum Issue führt über den Dialog (4.6),
|
||||||
|
weil ein `<a>` innerhalb der anklickbaren Karte ungültiges Markup wäre.
|
||||||
- Erledigtes wird durchgestrichen; der Zeitpunkt wird festgehalten und beim Zurückziehen
|
- Erledigtes wird durchgestrichen; der Zeitpunkt wird festgehalten und beim Zurückziehen
|
||||||
wieder gelöscht.
|
wieder gelöscht.
|
||||||
|
|
||||||
@@ -341,6 +350,54 @@ Die Aufgabe kennt keinen Besitzer — die Trennung läuft über das Projekt
|
|||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
|
## 2c. Rückblick und Verlauf
|
||||||
|
|
||||||
|
Zwei Sichten auf denselben Aktivitätsverlauf, über alle Projekte hinweg. Beide teilen
|
||||||
|
sich Zeilendarstellung und Tagesgruppierung (`components/ActivityRow`) — zwei Kopien
|
||||||
|
wären beim nächsten Feinschliff auseinandergelaufen.
|
||||||
|
|
||||||
|
Der Verlauf kennt keinen Besitzer; die Trennung läuft über das Projekt
|
||||||
|
(`project: { ownerId }` als erste Bedingung).
|
||||||
|
|
||||||
|
### Wochenrückblick
|
||||||
|
|
||||||
|
`/rueckblick` beantwortet „was ist diese Woche passiert". Oben Kennzahlen — Vorgänge,
|
||||||
|
berührte Projekte, erledigte und neue Aufgaben —, darunter die Vorgänge nach
|
||||||
|
Kalendertagen gebündelt, neuester Tag zuerst. Über `?woche=-n` geht es bis zu 25 Wochen
|
||||||
|
zurück; weiter lohnt nicht, weil der Verlauf ohnehin nur 200 Einträge je Projekt hält.
|
||||||
|
|
||||||
|
**Gerechnet wird auf Kalendertage in fester Zeitzone** (Europe/Berlin), nicht auf
|
||||||
|
„sieben mal 24 Stunden": liegt eine Zeitumstellung in der Woche, hat sie 167 oder 169
|
||||||
|
Stunden. Und im Container läuft die Anwendung nach UTC — ein Eintrag von Sonntagabend
|
||||||
|
fiele sonst in die falsche Woche. Das Fach bestimmt der **Server**, damit Server-Render
|
||||||
|
und Hydration nicht auseinanderlaufen.
|
||||||
|
|
||||||
|
**„Aufgaben erledigt" wird am `meta`-Feld abgelesen** (`to: "DONE"`), nicht am
|
||||||
|
Anzeigetext. Der Text ist zum Lesen da und ändert sich mit der Formulierung; eine
|
||||||
|
Zählung daran würde beim nächsten umformulierten Einzeiler unbemerkt kippen. Einträge
|
||||||
|
ohne `meta` zählen nicht mit — lieber untertreiben als raten.
|
||||||
|
|
||||||
|
### Globale Zeitleiste
|
||||||
|
|
||||||
|
`/verlauf` zeigt denselben Verlauf **fortlaufend**: ohne Wochengrenze, ohne Fazit, mit
|
||||||
|
„Ältere laden". Die erste Seite kommt serverseitig mit, alles Weitere über
|
||||||
|
`/api/activity`.
|
||||||
|
|
||||||
|
**Geblättert wird per Cursor** über `(createdAt, id)`, nicht per `skip`. Der Verlauf
|
||||||
|
schreibt mehrere Einträge im selben Augenblick — beim Übernehmen von Issues entstehen
|
||||||
|
zehn Zeilen mit identischem Zeitstempel. Ein Offset über eine solche Grenze hinweg
|
||||||
|
überspringt Zeilen oder zeigt sie zweimal, und zwar lautlos. Der zweite Zweig der
|
||||||
|
Bedingung (gleicher Zeitpunkt, kleinere ID) fängt genau das ab.
|
||||||
|
|
||||||
|
Nachgerechnet gegen 144 Einträge mit absichtlichen Blöcken gleicher Zeitstempel: 15
|
||||||
|
Seiten, 144 Zeilen, keine Dublette, streng absteigend.
|
||||||
|
|
||||||
|
Beide Seiten sind über die Schnellsuche erreichbar, der Rückblick zusätzlich über einen
|
||||||
|
Verweis vom Dashboard. Bewusst **kein** weiterer Punkt in der Kopfleiste — die ist auf
|
||||||
|
dem Telefon schon eng.
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
## 3. Notizen
|
## 3. Notizen
|
||||||
|
|
||||||
- **Beliebig viele Notizen pro Projekt**, mit optionalem Titel und mehrzeiligem Text.
|
- **Beliebig viele Notizen pro Projekt**, mit optionalem Titel und mehrzeiligem Text.
|
||||||
@@ -432,6 +489,40 @@ Firmen-Gitea nebeneinander.
|
|||||||
Kurzbeschreibung.
|
Kurzbeschreibung.
|
||||||
- **Löschen** trennt nur die Verknüpfung; die Projekte selbst bleiben erhalten.
|
- **Löschen** trennt nur die Verknüpfung; die Projekte selbst bleiben erhalten.
|
||||||
|
|
||||||
|
#### Nötige Token-Rechte
|
||||||
|
|
||||||
|
Nebula liest fast alles nur. Geschrieben wird an **genau zwei Stellen**: `POST …/issues`
|
||||||
|
beim Anlegen und `PATCH`/`PUT …/issues/{nr}` beim Schließen oder Wiederöffnen (4.6). Wer
|
||||||
|
darauf verzichtet, kommt mit einem rein lesenden Token aus.
|
||||||
|
|
||||||
|
| System | Nur Abgleich | Zusätzlich für die Issue-Anbindung |
|
||||||
|
| --- | --- | --- |
|
||||||
|
| GitHub | *Metadata*, *Contents*, *Issues*, *Pull requests*, *Actions* — je lesend | *Issues: Read and write* |
|
||||||
|
| GitLab | `read_api` | `api` |
|
||||||
|
| Gitea / Forgejo | `read:repository`, `read:issue`, `read:user` | `write:issue` |
|
||||||
|
|
||||||
|
Welcher Aufruf welches Recht verlangt, steht Zeile für Zeile in der
|
||||||
|
[README](README.md#welche-rechte-der-token-braucht) — dort ist jeder ausgehende Aufruf
|
||||||
|
der drei Clients aufgeführt.
|
||||||
|
|
||||||
|
**GitLab kennt keinen schmalen Schreib-Scope.** `api` erlaubt alles, was das Konto darf,
|
||||||
|
Code eingeschlossen. Wem das zu weit geht, bleibt bei `read_api`: der Abgleich läuft
|
||||||
|
vollständig, geschlossene Issues werden weiterhin erkannt — nur schreibt Nebula dann
|
||||||
|
nicht zurück.
|
||||||
|
|
||||||
|
**Nicht verlangt** werden Schreibrechte auf Code, Adminrechte und Rechte zum Anlegen von
|
||||||
|
Webhooks. Der Haken wird von Hand im Git-System eingetragen (4.7); das erspart dem Token
|
||||||
|
genau die Administrationsrechte, die er sonst bräuchte.
|
||||||
|
|
||||||
|
**Kommentare schreibt Nebula nie** — weder beim Anlegen noch beim Schließen. In den
|
||||||
|
Rumpf des angelegten Issues wandert die Aufgabenbeschreibung plus eine Zeile Rückverweis
|
||||||
|
auf das Projekt; danach bleibt der Text unangetastet. Was sonst an Kommentaren und
|
||||||
|
Labels an einem Issue hängt, kommt aus der Weboberfläche oder von einem anderen Werkzeug.
|
||||||
|
|
||||||
|
Ein fehlendes Recht endet in einem `403` mit „Token hat nicht die noetigen Scopes",
|
||||||
|
sichtbar am Repository auf der Projektseite. Klein anfangen und gezielt nachlegen ist
|
||||||
|
deshalb ohne Risiko.
|
||||||
|
|
||||||
### 4.3 Was beim Sync geholt wird
|
### 4.3 Was beim Sync geholt wird
|
||||||
|
|
||||||
| Bereich | Details |
|
| Bereich | Details |
|
||||||
|
|||||||
@@ -22,6 +22,12 @@ Jedes Projekt bekommt einen **Status** (von der rohen Idee bis „Fertig"), beli
|
|||||||
Branches, Tags, Commits, Releases und offene Issues/PRs — egal ob **GitHub**, **GitLab**
|
Branches, Tags, Commits, Releases und offene Issues/PRs — egal ob **GitHub**, **GitLab**
|
||||||
oder eine selbst gehostete **Gitea**-Instanz.
|
oder eine selbst gehostete **Gitea**-Instanz.
|
||||||
|
|
||||||
|
Neben dem Projektbrett gibt es **Aufgaben über alle Projekte hinweg** (nach Fälligkeit
|
||||||
|
geordnet), einen **Wochenrückblick** und eine **fortlaufende Zeitleiste** aus dem
|
||||||
|
Aktivitätsverlauf. Aufgaben lassen sich als **Git-Issue** anlegen; wird das Issue
|
||||||
|
geschlossen, hakt Nebula die Aufgabe ab — sofort per **Webhook** oder verzögert beim
|
||||||
|
nächsten Abgleich.
|
||||||
|
|
||||||
Die Anmeldung läuft über **Benutzername und Passwort oder Passkey** (WebAuthn). Nebula
|
Die Anmeldung läuft über **Benutzername und Passwort oder Passkey** (WebAuthn). Nebula
|
||||||
kennt zwei Betriebsarten: **Einzelbetrieb** für ein Konto oder **Mehrbenutzerbetrieb**, in
|
kennt zwei Betriebsarten: **Einzelbetrieb** für ein Konto oder **Mehrbenutzerbetrieb**, in
|
||||||
dem jede Person ihren eigenen, streng getrennten Bereich hat. Umschalten geht jederzeit in
|
dem jede Person ihren eigenen, streng getrennten Bereich hat. Umschalten geht jederzeit in
|
||||||
@@ -167,14 +173,8 @@ Nebula auffindbare Credentials nutzt.
|
|||||||
|
|
||||||
## Git-Verbindung einrichten
|
## Git-Verbindung einrichten
|
||||||
|
|
||||||
1. Im Git-System einen **Personal Access Token** mit Leserechten erzeugen:
|
1. Im Git-System einen **Personal Access Token** erzeugen — mit den Rechten aus dem
|
||||||
|
Abschnitt [Welche Rechte der Token braucht](#welche-rechte-der-token-braucht).
|
||||||
| System | Scopes |
|
|
||||||
| --- | --- |
|
|
||||||
| GitHub | Fine-grained Token: *Contents: Read*, *Metadata: Read*, *Issues: Read*, *Pull requests: Read* |
|
|
||||||
| GitLab | `read_api` (alternativ `read_repository`) |
|
|
||||||
| Gitea / Forgejo | `repository:read`, `issue:read`, `user:read` |
|
|
||||||
|
|
||||||
2. In Nebula unter **Git-Verbindungen → Verbindung hinzufügen** eintragen:
|
2. In Nebula unter **Git-Verbindungen → Verbindung hinzufügen** eintragen:
|
||||||
System wählen, Basis-URL (z. B. `https://git.meine-firma.de`, ohne `/api`) und Token.
|
System wählen, Basis-URL (z. B. `https://git.meine-firma.de`, ohne `/api`) und Token.
|
||||||
3. Mit **Testen** prüfen — Nebula meldet den erkannten Benutzer zurück.
|
3. Mit **Testen** prüfen — Nebula meldet den erkannten Benutzer zurück.
|
||||||
@@ -186,6 +186,132 @@ Nebula auffindbare Credentials nutzt.
|
|||||||
Der Snapshot bleibt in der Datenbank, das Dashboard funktioniert also auch offline.
|
Der Snapshot bleibt in der Datenbank, das Dashboard funktioniert also auch offline.
|
||||||
Ohne Token gehen nur öffentliche Repositories, mit strengem Rate-Limit.
|
Ohne Token gehen nur öffentliche Repositories, mit strengem Rate-Limit.
|
||||||
|
|
||||||
|
### Welche Rechte der Token braucht
|
||||||
|
|
||||||
|
Nebula liest fast alles nur. Geschrieben wird an **genau zwei Stellen**: wenn du eine
|
||||||
|
Aufgabe als Issue anlegst, und wenn eine Aufgabe auf `DONE` wandert und Nebula das
|
||||||
|
verknüpfte Issue schließt. Alles andere sind `GET`-Aufrufe. Deshalb lohnt es, zwei Fälle
|
||||||
|
zu unterscheiden:
|
||||||
|
|
||||||
|
**Fall A — nur Abgleich.** Branches, Tags, Commits, Releases, CI-Zustand, README,
|
||||||
|
Heatmap, offene Issues und PRs anzeigen. Rein lesend.
|
||||||
|
|
||||||
|
**Fall B — zusätzlich die Issue-Anbindung.** Eine Aufgabe als Issue anlegen; wird das
|
||||||
|
Issue geschlossen, hakt Nebula die Aufgabe ab und schließt sie umgekehrt mit.
|
||||||
|
|
||||||
|
| System | Fall A (nur lesen) | Fall B zusätzlich |
|
||||||
|
| --- | --- | --- |
|
||||||
|
| **GitHub** | Fine-grained Token: *Metadata: Read*, *Contents: Read*, *Issues: Read*, *Pull requests: Read*, *Actions: Read* | *Issues: **Read and write*** |
|
||||||
|
| **GitLab** | `read_api` | `api` — **es gibt nichts dazwischen** |
|
||||||
|
| **Gitea / Forgejo** | `read:repository`, `read:issue`, `read:user` | `write:issue` |
|
||||||
|
|
||||||
|
#### Jeder Aufruf einzeln
|
||||||
|
|
||||||
|
Die folgenden Tabellen sind vollständig: mehr als das ruft Nebula nicht nach draußen.
|
||||||
|
Sie sind aus `src/lib/git/github.ts`, `gitlab.ts` und `gitea.ts` erhoben — wer prüfen
|
||||||
|
will, ob hier etwas fehlt, greppt dort nach `getJson`, `getJsonSafe` und `sendJson`.
|
||||||
|
|
||||||
|
**GitHub** — `https://api.github.com`, Header `Authorization: Bearer …`
|
||||||
|
|
||||||
|
| Aufruf | Wofür | Benötigtes Recht |
|
||||||
|
| --- | --- | --- |
|
||||||
|
| `GET /rate_limit` | Verbindungstest | keins |
|
||||||
|
| `GET /user` | Kontoname beim Testen zurückmelden | keins |
|
||||||
|
| `GET /user/repos` | Auswahlliste hinter **Repos laden** | Metadata: Read |
|
||||||
|
| `GET /repos/{o}/{r}` | Stammdaten, Default-Branch, Sichtbarkeit | Metadata: Read |
|
||||||
|
| `GET …/languages` | Sprachverteilung | Metadata: Read |
|
||||||
|
| `GET …/tags` | Tags | Metadata: Read |
|
||||||
|
| `GET …/stats/commit_activity` | Commit-Heatmap über ein Jahr | Metadata: Read |
|
||||||
|
| `GET …/branches` | Branch-Liste | Contents: Read |
|
||||||
|
| `GET …/commits` | die letzten 100 Commits | Contents: Read |
|
||||||
|
| `GET …/releases` | Releases | Contents: Read |
|
||||||
|
| `GET …/readme` | README-Vorschau | Contents: Read |
|
||||||
|
| `GET …/pulls?state=open` | offene Pull Requests | Pull requests: Read |
|
||||||
|
| `GET …/issues?state=open` | offene Issues | Issues: Read |
|
||||||
|
| `GET …/issues/{nr}` | Abgleich: ist das verknüpfte Issue noch offen? | Issues: Read |
|
||||||
|
| `GET …/actions/runs` | CI-Zustand des Default-Branch | Actions: Read |
|
||||||
|
| `POST …/issues` | **Aufgabe als Issue anlegen** | Issues: Read and write |
|
||||||
|
| `PATCH …/issues/{nr}` | **Issue schließen oder wieder öffnen** | Issues: Read and write |
|
||||||
|
|
||||||
|
Dass `/tags` und `/stats/commit_activity` unter *Metadata* fallen und nicht unter
|
||||||
|
*Contents*, ist nicht zu erraten — es steht so in
|
||||||
|
[GitHubs Berechtigungsübersicht](https://docs.github.com/en/rest/authentication/permissions-required-for-fine-grained-personal-access-tokens).
|
||||||
|
|
||||||
|
**GitLab** — `{Basis-URL}/api/v4`, Header `PRIVATE-TOKEN: …`
|
||||||
|
|
||||||
|
| Aufruf | Wofür | Benötigtes Recht |
|
||||||
|
| --- | --- | --- |
|
||||||
|
| `GET /projects?per_page=1` | Verbindungstest | `read_api` |
|
||||||
|
| `GET /user` | Kontoname beim Testen zurückmelden | `read_user` (in `read_api` enthalten) |
|
||||||
|
| `GET /projects?membership=true` | Auswahlliste hinter **Repos laden** | `read_api` |
|
||||||
|
| `GET /projects/{id}?statistics=true` | Stammdaten, Default-Branch, Sichtbarkeit | `read_api` |
|
||||||
|
| `GET …/repository/branches` · `/tags` · `/commits` | Snapshot und Heatmap | `read_api` |
|
||||||
|
| `GET …/repository/tree` · `/repository/files/{datei}` | README (zwei Aufrufe, GitLab hat keinen README-Endpunkt) | `read_api` |
|
||||||
|
| `GET …/releases` · `/languages` | Releases, Sprachverteilung | `read_api` |
|
||||||
|
| `GET …/merge_requests?state=opened` | offene Merge Requests | `read_api` |
|
||||||
|
| `GET …/issues?state=opened` | offene Issues | `read_api` |
|
||||||
|
| `GET …/issues/{nr}` | Abgleich: ist das verknüpfte Issue noch offen? | `read_api` |
|
||||||
|
| `GET …/pipelines` | CI-Zustand des Default-Branch | `read_api` |
|
||||||
|
| `POST …/issues` | **Aufgabe als Issue anlegen** | `api` |
|
||||||
|
| `PUT …/issues/{nr}` (`state_event`) | **Issue schließen oder wieder öffnen** | `api` |
|
||||||
|
|
||||||
|
**Gitea / Forgejo** — `{Basis-URL}/api/v1`, Header `Authorization: token …`
|
||||||
|
|
||||||
|
| Aufruf | Wofür | Benötigtes Recht |
|
||||||
|
| --- | --- | --- |
|
||||||
|
| `GET /version` | Verbindungstest | keins — der Aufruf darf fehlschlagen, Nebula wertet ihn nur ergänzend aus |
|
||||||
|
| `GET /user` | Kontoname beim Testen zurückmelden | `read:user` |
|
||||||
|
| `GET /user/repos` bzw. `GET /repos/search` | Auswahlliste hinter **Repos laden** | `read:repository` |
|
||||||
|
| `GET /repos/{o}/{r}` | Stammdaten, Default-Branch, Sichtbarkeit | `read:repository` |
|
||||||
|
| `GET …/branches` · `/tags` · `/commits` · `/releases` · `/languages` | Snapshot und Heatmap | `read:repository` |
|
||||||
|
| `GET …/contents` · `/contents/{datei}` | README (zwei Aufrufe, wie bei GitLab) | `read:repository` |
|
||||||
|
| `GET …/commits/{branch}/status` | CI-Zustand des Default-Branch | `read:repository` |
|
||||||
|
| `GET …/pulls?state=open` | offene Pull Requests | `read:repository` — Gitea zählt PRs zum Repository-Scope, nicht zu den Issues |
|
||||||
|
| `GET …/issues?state=open&type=issues` | offene Issues | `read:issue` |
|
||||||
|
| `GET …/issues/{nr}` | Abgleich: ist das verknüpfte Issue noch offen? | `read:issue` |
|
||||||
|
| `POST …/issues` | **Aufgabe als Issue anlegen** | `write:issue` |
|
||||||
|
| `PATCH …/issues/{nr}` | **Issue schließen oder wieder öffnen** | `write:issue` |
|
||||||
|
|
||||||
|
`write:issue` schließt `read:issue` mit ein — Gitea versteht `write:` als „lesen und
|
||||||
|
schreiben". Beide anzuhaken schadet nicht, nötig ist es nicht.
|
||||||
|
|
||||||
|
#### Was Nebula nicht tut
|
||||||
|
|
||||||
|
- **Keine Kommentare.** Nebula schreibt nie einen Issue-Kommentar, weder beim Anlegen
|
||||||
|
noch beim Schließen. Was im Rumpf des angelegten Issues steht, ist die
|
||||||
|
Aufgabenbeschreibung plus eine Zeile Rückverweis — danach fasst Nebula den Text
|
||||||
|
nicht mehr an.
|
||||||
|
- **Kein Code.** Nichts wird committet, gepusht, gemergt oder getaggt. Nebula ist eine
|
||||||
|
Übersicht, keine Entwicklungsumgebung.
|
||||||
|
- **Keine Webhooks anlegen.** Den Haken trägst du selbst im Git-System ein — genau
|
||||||
|
deshalb verlangt Nebula dafür keine Administrationsrechte.
|
||||||
|
- **Keine Labels, keine Meilensteine, keine Zuweisungen.**
|
||||||
|
- **Keine Adminrechte**, keine Organisations- oder Benutzerverwaltung.
|
||||||
|
|
||||||
|
Kommentare und Labels, die an einem Issue hängen, stammen also entweder aus der
|
||||||
|
Weboberfläche deines Git-Systems oder von einem anderen Werkzeug mit eigenem Token —
|
||||||
|
nicht von Nebula.
|
||||||
|
|
||||||
|
#### Der GitLab-Sonderfall
|
||||||
|
|
||||||
|
GitLab kennt keinen schmalen Schreib-Scope für Issues. Laut
|
||||||
|
[Access token scopes](https://docs.gitlab.com/security/tokens/access_token_scopes/)
|
||||||
|
gibt es nur `api` — „complete read and write access to the API" — und darunter direkt
|
||||||
|
`read_api`. Wer bei GitLab Aufgaben als Issue anlegen will, vergibt damit ein Token, das
|
||||||
|
auch Code ändern darf.
|
||||||
|
|
||||||
|
Wenn dir das zu weit geht: bleib bei `read_api` und verzichte auf die Issue-Anbindung.
|
||||||
|
Der Abgleich läuft vollständig, und geschlossene Issues werden weiterhin erkannt und
|
||||||
|
haken ihre Aufgabe ab — nur der Rückweg von Nebula ins Issue fällt weg. Ein eigenes
|
||||||
|
Dienstkonto, das nur Zugriff auf die betroffenen Projekte hat, ist der andere Ausweg.
|
||||||
|
|
||||||
|
#### Im Zweifel klein anfangen
|
||||||
|
|
||||||
|
Ein fehlendes Recht führt zu einem `403` mit dem Hinweis „Token hat nicht die noetigen
|
||||||
|
Scopes"; die Meldung steht am Repository auf der Projektseite. Fang mit Fall A an und
|
||||||
|
leg gezielt nach, wenn du die Issue-Anbindung wirklich benutzt — statt vorsorglich
|
||||||
|
alles zu vergeben.
|
||||||
|
|
||||||
### Automatisch statt auf Knopfdruck
|
### Automatisch statt auf Knopfdruck
|
||||||
|
|
||||||
Unter **Admin-Einstellungen → Automatischer Abgleich** lässt sich der Sync in den
|
Unter **Admin-Einstellungen → Automatischer Abgleich** lässt sich der Sync in den
|
||||||
@@ -275,15 +401,25 @@ nebula/
|
|||||||
└── src/
|
└── src/
|
||||||
├── app/
|
├── app/
|
||||||
│ ├── page.tsx Dashboard (Board, Filter, Kennzahlen)
|
│ ├── page.tsx Dashboard (Board, Filter, Kennzahlen)
|
||||||
│ ├── projects/[id]/ Projektdetail: Beschreibung, Notizen, Git
|
│ ├── projects/[id]/ Projektdetail: Beschreibung, Notizen, Aufgaben, Git
|
||||||
|
│ ├── tasks/ Aufgaben über alle Projekte, nach Fälligkeit
|
||||||
|
│ ├── rueckblick/ Wochenrückblick
|
||||||
|
│ ├── verlauf/ Fortlaufende Zeitleiste
|
||||||
│ ├── connections/ Verwaltung der Git-Verbindungen
|
│ ├── connections/ Verwaltung der Git-Verbindungen
|
||||||
│ └── api/ REST-Endpunkte (Projekte, Notizen, Verbindungen, Sync)
|
│ ├── account/ admin/ Eigenes Konto · Adminbereich
|
||||||
|
│ └── api/ REST-Endpunkte (siehe Abschnitt „API")
|
||||||
├── components/ UI-Komponenten (Board, Karten, Panels, Dialoge)
|
├── components/ UI-Komponenten (Board, Karten, Panels, Dialoge)
|
||||||
├── lib/
|
├── lib/
|
||||||
|
│ ├── auth/ Sitzungen, Passwörter, TOTP, WebAuthn, Zugriffsschutz
|
||||||
│ ├── crypto.ts AES-256-GCM für Access Tokens
|
│ ├── crypto.ts AES-256-GCM für Access Tokens
|
||||||
│ ├── db.ts Prisma-Client
|
│ ├── db.ts Prisma-Client
|
||||||
│ ├── git/ Provider-Adapter: github.ts · gitlab.ts · gitea.ts
|
│ ├── git/ Provider-Adapter: github.ts · gitlab.ts · gitea.ts
|
||||||
│ ├── sync.ts Repo-Snapshot holen und speichern
|
│ ├── sync/ Repo-Snapshot holen, speichern, Zeitgeber
|
||||||
|
│ ├── tasks/ Aufgabenlogik, Brücke zu Git-Issues
|
||||||
|
│ ├── webhooks/ Signaturprüfung eingehender Webhooks
|
||||||
|
│ ├── review.ts Wochengrenzen und Kennzahlen
|
||||||
|
│ ├── timeline.ts Cursor-Blättern für den Verlauf
|
||||||
|
│ ├── security/ SSRF-Schutz, Ratenbegrenzung, Body-Prüfung
|
||||||
│ └── validation.ts Zod-Schemas für alle Eingaben
|
│ └── validation.ts Zod-Schemas für alle Eingaben
|
||||||
└── types/ gemeinsame Typen für Server und Client
|
└── types/ gemeinsame Typen für Server und Client
|
||||||
```
|
```
|
||||||
@@ -347,7 +483,8 @@ ausschließlich Daten des angemeldeten Kontos.
|
|||||||
| `PATCH` `DELETE` | `/api/templates/:id` | Vorlage ändern / löschen |
|
| `PATCH` `DELETE` | `/api/templates/:id` | Vorlage ändern / löschen |
|
||||||
| `POST` | `/api/templates/from-project` | Aus einem Projekt eine Vorlage machen |
|
| `POST` | `/api/templates/from-project` | Aus einem Projekt eine Vorlage machen |
|
||||||
| `GET` | `/api/admin/backup` | Vollständige Sicherung als JSON (Admin) |
|
| `GET` | `/api/admin/backup` | Vollständige Sicherung als JSON (Admin) |
|
||||||
| `GET` | `/api/search?q=` | Volltextsuche über die eigenen Notizen |
|
| `GET` | `/api/search?q=` | Volltextsuche über eigene Notizen **und Aufgaben** |
|
||||||
|
| `GET` | `/api/activity` | Verlauf über alle Projekte, per Cursor (`?vor=&id=&limit=`) |
|
||||||
| `GET` `POST` | `/api/notifications` | Benachrichtigungsziele |
|
| `GET` `POST` | `/api/notifications` | Benachrichtigungsziele |
|
||||||
| `PATCH` `DELETE` | `/api/notifications/:id` | Ziel ändern / entfernen |
|
| `PATCH` `DELETE` | `/api/notifications/:id` | Ziel ändern / entfernen |
|
||||||
| `POST` | `/api/notifications/:id/test` | Testnachricht senden |
|
| `POST` | `/api/notifications/:id/test` | Testnachricht senden |
|
||||||
@@ -359,10 +496,13 @@ ausschließlich Daten des angemeldeten Kontos.
|
|||||||
| `GET` `POST` | `/api/projects/:id/repositories` | Repositories des Projekts |
|
| `GET` `POST` | `/api/projects/:id/repositories` | Repositories des Projekts |
|
||||||
| `PATCH` `DELETE` | `/api/repositories/:id` | Repository ändern / vom Projekt lösen |
|
| `PATCH` `DELETE` | `/api/repositories/:id` | Repository ändern / vom Projekt lösen |
|
||||||
| `POST` | `/api/repositories/:id/sync` | Ein einzelnes Repository abgleichen |
|
| `POST` | `/api/repositories/:id/sync` | Ein einzelnes Repository abgleichen |
|
||||||
|
| `POST` `DELETE` | `/api/repositories/:id/webhook` | Webhook einrichten / zurücknehmen |
|
||||||
|
| `POST` | `/api/webhooks/:repositoryId` | **Eingehend** von GitHub/GitLab/Gitea, per Signatur geprüft |
|
||||||
| `GET` `POST` | `/api/projects/:id/tasks` | Aufgaben des Projekts |
|
| `GET` `POST` | `/api/projects/:id/tasks` | Aufgaben des Projekts |
|
||||||
| `PATCH` | `/api/projects/:id/tasks/reorder` | Neue Reihenfolge nach dem Ziehen |
|
| `PATCH` | `/api/projects/:id/tasks/reorder` | Neue Reihenfolge nach dem Ziehen |
|
||||||
| `POST` | `/api/projects/:id/tasks/from-issues` | Offene Issues als Aufgaben übernehmen |
|
| `POST` | `/api/projects/:id/tasks/from-issues` | Offene Issues als Aufgaben übernehmen |
|
||||||
| `PATCH` `DELETE` | `/api/tasks/:id` | Aufgabe ändern / löschen |
|
| `PATCH` `DELETE` | `/api/tasks/:id` | Aufgabe ändern / löschen |
|
||||||
|
| `POST` | `/api/tasks/:id/issue` | Aufgabe als Issue im verknüpften Repository anlegen |
|
||||||
| `GET` `POST` | `/api/projects/:id/notes` | Notizen des Projekts |
|
| `GET` `POST` | `/api/projects/:id/notes` | Notizen des Projekts |
|
||||||
| `PATCH` `DELETE` | `/api/notes/:id` | Notiz ändern / löschen |
|
| `PATCH` `DELETE` | `/api/notes/:id` | Notiz ändern / löschen |
|
||||||
| `GET` `POST` | `/api/connections` | Git-Verbindungen |
|
| `GET` `POST` | `/api/connections` | Git-Verbindungen |
|
||||||
@@ -434,17 +574,21 @@ Grenzen, die du kennen solltest:
|
|||||||
|
|
||||||
## Getestet mit
|
## Getestet mit
|
||||||
|
|
||||||
Stand 25.07.2026 gegen echte Systeme verifiziert — beide Betriebsarten, alle drei
|
Am 25.07.2026 gegen echte Systeme verifiziert — beide Betriebsarten, alle drei
|
||||||
Git-Adapter (GitHub, GitLab und Gitea jeweils gegen die öffentliche Instanz).
|
Git-Adapter (GitHub, GitLab und Gitea jeweils gegen die öffentliche Instanz). Seitdem
|
||||||
|
laufen die Ende-zu-Ende-Tests bei jeder Änderung mit; live nach draußen geht davon nur
|
||||||
|
ein Test gegen die GitHub-API.
|
||||||
|
|
||||||
|
Werkzeugstand vom 18.08.2026:
|
||||||
|
|
||||||
| | Version |
|
| | Version |
|
||||||
| --- | --- |
|
| --- | --- |
|
||||||
| Node.js | 26.5.0 |
|
| Node.js | 24.19.0 |
|
||||||
| npm | 11.17.0 |
|
| npm | 11.17.0 |
|
||||||
| Next.js | 15.5.21 |
|
| Next.js | 15.5.21 |
|
||||||
| Prisma | 6.19.3 |
|
| Prisma | 6.19.3 |
|
||||||
| PostgreSQL | 17 (Alpine) |
|
| PostgreSQL | 17.11 (Alpine) |
|
||||||
| Docker / Compose | 29.6.2 / v5.3.1 |
|
| Docker | 29.7.2 |
|
||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
|
|||||||
+75
-34
@@ -7,25 +7,21 @@ Stück für Stück abarbeiten. Reihenfolge ist ein Vorschlag, keine Festlegung.
|
|||||||
|
|
||||||
Was bereits steht, listet [FEATURES.md](FEATURES.md).
|
Was bereits steht, listet [FEATURES.md](FEATURES.md).
|
||||||
|
|
||||||
|
**Stand:** v1.10.1. Alle Issues aus dem Dashboard sind abgearbeitet.
|
||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
## 1 · Als Nächstes empfohlen
|
## 1 · Als Nächstes empfohlen
|
||||||
|
|
||||||
### 1.0 Rest aus v1.6.0: persönliche API-Token `M`
|
### 1.1 Persönliche API-Token `M`
|
||||||
|
|
||||||
Schnellerfassung und die projektübergreifende Aufgabenseite sind mit v1.6.0
|
Der letzte offene Teil aus v1.6.0 („unterwegs erfassen"). Derzeit geht die
|
||||||
ausgeliefert. Offen bleibt der dritte Teil — siehe 1.3. Er gehört sachlich
|
API nur mit Sitzungscookie. Ein Token je Konto würde `curl`-Aufrufe und
|
||||||
dazu: erfassen am Telefon, überblicken an einer Stelle, ansprechen per
|
Handy-Shortcuts erlauben — eine Idee aus dem Terminal anlegen, ohne den
|
||||||
Shortcut.
|
Browser zu öffnen. Nur der Hash in der Datenbank, wie bei den Sitzungen.
|
||||||
|
|
||||||
Bewusst nicht mitgeliefert wurde ein **Index für die übergreifende
|
Bewusst noch nicht angefasst, weil sicherheitsrelevant: Geltungsbereich,
|
||||||
Aufgabenabfrage**. `Task` hat kein `ownerId`, die Trennung läuft über
|
Widerruf und Ablauf wollen entschieden sein, nicht nebenbei gebaut.
|
||||||
`project: { ownerId }`, und `[projectId, status, position]` greift dafür
|
|
||||||
nicht. Bei einigen hundert Aufgaben fällt das nicht auf; wird die Seite
|
|
||||||
träge, ist ein Index auf `dueDate` der erste Griff — und dann eine
|
|
||||||
Migration wert.
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
### 1.2 Läuft es noch? `M`
|
### 1.2 Läuft es noch? `M`
|
||||||
|
|
||||||
@@ -34,24 +30,17 @@ 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
|
Nutzt Zeitgeber und Benachrichtigungen, die es schon gibt. Der SSRF-Schutz
|
||||||
greift dabei wie bei den Git-Aufrufen.
|
greift dabei wie bei den Git-Aufrufen.
|
||||||
|
|
||||||
### 1.3 Persönliche API-Token `M`
|
### 1.3 Aufgaben ↔ Issues: der Rest `S`
|
||||||
|
|
||||||
Derzeit geht die API nur mit Sitzungscookie. Ein Token je Konto würde
|
Beide Richtungen stehen — „als Issue anlegen" seit v1.7.0, der Rückweg über
|
||||||
`curl`-Aufrufe und Handy-Shortcuts erlauben — Idee aus dem Terminal anlegen,
|
Webhook (v1.7.0) und zusätzlich über den Abgleich (v1.9.0). Offen ist
|
||||||
ohne den Browser zu öffnen. Nur der Hash in der Datenbank, wie bei den
|
Kleinkram:
|
||||||
Sitzungen.
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
### 1.4 Aufgaben ↔ Issues: was noch fehlt `S`
|
|
||||||
|
|
||||||
Mit v1.7.0 stehen beide Richtungen: „als Issue anlegen“ und der Rückweg über
|
|
||||||
Webhooks. Offen geblieben ist Kleinkram:
|
|
||||||
|
|
||||||
- **Mehrere Repositories.** Der Knopf nimmt immer das führende. Bei einem
|
- **Mehrere Repositories.** Der Knopf nimmt immer das führende. Bei einem
|
||||||
Projekt aus Frontend und Backend fehlt die Wahl.
|
Projekt aus Frontend und Backend fehlt die Wahl.
|
||||||
- **Beim Übernehmen aus Issues** wird der Rückweg nicht automatisch
|
- **Webhook beim Verknüpfen anbieten.** Er ist getrennt einzurichten, und
|
||||||
eingerichtet — der Webhook ist getrennt zu setzen.
|
wer das nicht tut, merkt nur an der Verzögerung, dass etwas fehlt. Ein
|
||||||
|
Hinweis an der richtigen Stelle würde reichen.
|
||||||
|
|
||||||
Was **nicht** kommt, bleibt wie besprochen: eine echte beidseitige
|
Was **nicht** kommt, bleibt wie besprochen: eine echte beidseitige
|
||||||
Synchronisation mit Konfliktauflösung. Die Zustände passen ohnehin nicht
|
Synchronisation mit Konfliktauflösung. Die Zustände passen ohnehin nicht
|
||||||
@@ -75,15 +64,60 @@ Voraussetzung, falls du das Projekt veröffentlichen willst.
|
|||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
## 3 · Kleinigkeiten
|
## 3 · Aufgefallen beim Bauen
|
||||||
|
|
||||||
|
Beobachtungen aus der Arbeit an v1.6.0 bis v1.10.1 — festgehalten, damit sie
|
||||||
|
nicht verloren gehen. Nichts davon ist dringend.
|
||||||
|
|
||||||
|
### 3.1 Anwendungsname bricht in der Kopfleiste ab `S`
|
||||||
|
|
||||||
|
Zwischen 320 und 375 px wird aus „Nebula" ein „Neb…". Gemessen über fünf
|
||||||
|
Breiten und zwei Seiten: betrifft alle Seiten gleichermaßen. Seit die
|
||||||
|
Aufgaben als dritter Punkt danebenstehen, ist es enger geworden.
|
||||||
|
|
||||||
|
### 3.2 Indizes für die projektübergreifenden Seiten `S`
|
||||||
|
|
||||||
|
Weder `Task` noch `Activity` haben einen Besitzer — die Trennung läuft über
|
||||||
|
`project: { ownerId }`. Die vorhandenen Indizes
|
||||||
|
(`[projectId, status, position]` bzw. `[projectId, createdAt]`) greifen für
|
||||||
|
Abfragen über alle Projekte deshalb nicht.
|
||||||
|
|
||||||
|
Betroffen sind inzwischen vier Seiten: Aufgabenübersicht, Wochenrückblick,
|
||||||
|
Zeitleiste und die Volltextsuche. Bei einigen hundert Datensätzen fällt das
|
||||||
|
nicht auf. Wird eine der Seiten träge, sind Indizes auf `Task.dueDate` und
|
||||||
|
`Activity.createdAt` der erste Griff — und dann eine Migration wert.
|
||||||
|
|
||||||
|
### 3.3 Projektfilter auf der Zeitleiste `S`
|
||||||
|
|
||||||
|
Über alle Projekte wird die Liste schnell lang. Der Wochenrückblick hat
|
||||||
|
Wochengrenzen als natürliche Bremse, die Zeitleiste nicht. Bewusst
|
||||||
|
weggelassen, weil das Issue nur „derselbe Verlauf, projektübergreifend"
|
||||||
|
verlangte.
|
||||||
|
|
||||||
|
### 3.4 Abgleich gegen geleakte Passwörter `M`
|
||||||
|
|
||||||
|
ASVS 2.1.7 verlangt es; umgesetzt ist bisher nur eine lokale Sperrliste plus
|
||||||
|
Mustererkennung (Wiederholungen, Zeichenfolgen, Benutzername im Passwort).
|
||||||
|
Have-I-Been-Pwned scheidet aus — Nebula ruft grundsätzlich nichts von außen,
|
||||||
|
und ein Passwort-Präfix nach draußen zu geben widerspräche dem erst recht.
|
||||||
|
Eine lokale Top-10000-Liste als Datei wäre der Kompromiss.
|
||||||
|
|
||||||
|
### 3.5 v0.2.0 und v0.3.0 ohne Release `S`
|
||||||
|
|
||||||
|
Beide stehen im Änderungsverlauf, existierten aber nie in der
|
||||||
|
`package.json` — dort springt die Historie von 0.1.0 auf 0.4.0. Nachgetragen
|
||||||
|
wurden sie in dem Commit, der den Verlauf einführte, und der liegt *nach*
|
||||||
|
0.4.0. Es gibt also keinen ehrlichen Commit, an dem ein Tag hängen könnte.
|
||||||
|
Die übrigen 18 Fassungen haben seit dem 18.08.2026 ein Release in Gitea.
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 4 · Kleinigkeiten
|
||||||
|
|
||||||
| Idee | Aufwand | Nutzen |
|
| 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 |
|
| Suchtreffer in Notizen hervorheben | `S` | In der Notiz selbst, nicht nur in der Trefferliste |
|
||||||
| Aufgabe ↔ Commit verknüpfen | `M` | Enthält ein Commit `#5`, wird die übernommene Aufgabe verlinkt — fällt weitgehend mit 1.4 ab |
|
| Aufgabe ↔ Commit verknüpfen | `M` | Enthält ein Commit `#5`, wird die übernommene Aufgabe verlinkt — fällt weitgehend mit 1.3 ab |
|
||||||
| Tastaturkürzel-Übersicht mit `?` | `S` | Es gibt inzwischen genug davon |
|
| Tastaturkürzel-Übersicht mit `?` | `S` | Es gibt inzwischen genug davon |
|
||||||
| Hell/Dunkel umschaltbar | `M` | Aktuell nur dunkel |
|
| Hell/Dunkel umschaltbar | `M` | Aktuell nur dunkel |
|
||||||
| Eigenes Logo und Farbe | `S` | Ergänzt `APP_NAME` |
|
| Eigenes Logo und Farbe | `S` | Ergänzt `APP_NAME` |
|
||||||
@@ -91,7 +125,7 @@ Voraussetzung, falls du das Projekt veröffentlichen willst.
|
|||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
## 4 · Bewusst nicht
|
## 5 · Bewusst nicht
|
||||||
|
|
||||||
Damit klar ist, was **nicht** kommt und warum:
|
Damit klar ist, was **nicht** kommt und warum:
|
||||||
|
|
||||||
@@ -104,7 +138,10 @@ Damit klar ist, was **nicht** kommt und warum:
|
|||||||
- **Anhänge an Notizen.** Bräuchte Dateispeicher und damit eine zweite Sorge
|
- **Anhänge an Notizen.** Bräuchte Dateispeicher und damit eine zweite Sorge
|
||||||
bei jeder Sicherung. Ein Link ins Git tut es auch.
|
bei jeder Sicherung. Ein Link ins Git tut es auch.
|
||||||
- **Eigene Git-Operationen** (klonen, committen, pushen). Nebula ist eine
|
- **Eigene Git-Operationen** (klonen, committen, pushen). Nebula ist eine
|
||||||
Übersicht, keine Entwicklungsumgebung.
|
Übersicht, keine Entwicklungsumgebung. Issues über die HTTP-API der
|
||||||
|
Provider sind davon nicht berührt — die gibt es seit v1.7.0.
|
||||||
|
- **Beidseitige Synchronisation von Aufgaben und Issues** mit
|
||||||
|
Konfliktauflösung — siehe 1.3.
|
||||||
- **Zeiterfassung, Rechnungen, Kundenverwaltung.** Andere Baustelle.
|
- **Zeiterfassung, Rechnungen, Kundenverwaltung.** Andere Baustelle.
|
||||||
- **Cloud-Synchronisation.** Die Daten bleiben in deiner Datenbank; das ist
|
- **Cloud-Synchronisation.** Die Daten bleiben in deiner Datenbank; das ist
|
||||||
der Punkt.
|
der Punkt.
|
||||||
@@ -138,6 +175,10 @@ Damit klar ist, was **nicht** kommt und warum:
|
|||||||
| **v1.5.0** Sicherheitsdurchsicht, Server-Anleitung und Update-Skript | ✓ |
|
| **v1.5.0** Sicherheitsdurchsicht, Server-Anleitung und Update-Skript | ✓ |
|
||||||
| **v1.6.0** Mobile Ansicht, Listenansicht, Schnellerfassung, Aufgaben über alle Projekte | ✓ |
|
| **v1.6.0** Mobile Ansicht, Listenansicht, Schnellerfassung, Aufgaben über alle Projekte | ✓ |
|
||||||
| **v1.7.0** Aufgabe als Git-Issue anlegen, Webhooks für Push und Issues | ✓ |
|
| **v1.7.0** Aufgabe als Git-Issue anlegen, Webhooks für Push und Issues | ✓ |
|
||||||
|
| **v1.8.0** Anmeldung und Sitzungen nach OWASP: scrypt-Aufwand, Aufzählbarkeit, Leerlauffrist, Cookie-Härtung | ✓ |
|
||||||
|
| **v1.9.0** Geschlossene Issues haken ihre Aufgabe auch ohne Webhook ab | ✓ |
|
||||||
|
| **v1.10.0** Wochenrückblick, globale Zeitleiste, Suche über Aufgaben | ✓ |
|
||||||
|
| **v1.10.1** Issue-Kennzeichen auf der Aufgabenkarte, Token-Rechte Aufruf für Aufruf belegt | ✓ |
|
||||||
|
|
||||||
Zur Entscheidung beim Export: Git-Tokens gehen **nicht** mit. Die Verbindung wird nur
|
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
|
beschrieben, das Token ist nach dem Import neu zu hinterlegen. Snapshots bleiben
|
||||||
|
|||||||
+106
@@ -763,6 +763,112 @@ test("Projektvorlagen: aus Projekt sichern und anwenden", async ({ request, play
|
|||||||
expect((await request.delete(`/api/templates/${vorlage.id}`)).ok()).toBeTruthy();
|
expect((await request.delete(`/api/templates/${vorlage.id}`)).ok()).toBeTruthy();
|
||||||
});
|
});
|
||||||
|
|
||||||
|
test("Verlauf blaettert per Cursor, ohne Zeilen zu verlieren", async ({ request, playwright }) => {
|
||||||
|
await login(request, ADMIN);
|
||||||
|
|
||||||
|
// Die bisherigen Tests haben reichlich Verlauf erzeugt. Erst alles auf
|
||||||
|
// einmal holen, dann in kleinen Seiten – beides muss dieselbe Menge sein.
|
||||||
|
const alles = await (await request.get("/api/activity?limit=100")).json();
|
||||||
|
expect(alles.activities.length).toBeGreaterThan(5);
|
||||||
|
|
||||||
|
const ids: string[] = [];
|
||||||
|
let cursor: { vor: string; id: string } | null = null;
|
||||||
|
for (let seite = 0; seite < 60; seite += 1) {
|
||||||
|
const query = cursor
|
||||||
|
? `?limit=3&vor=${encodeURIComponent(cursor.vor)}&id=${encodeURIComponent(cursor.id)}`
|
||||||
|
: "?limit=3";
|
||||||
|
const antwort = await request.get(`/api/activity${query}`);
|
||||||
|
expect(antwort.ok()).toBeTruthy();
|
||||||
|
const seiteBody = await antwort.json();
|
||||||
|
ids.push(...seiteBody.activities.map((eintrag: { id: string }) => eintrag.id));
|
||||||
|
if (!seiteBody.weitere) break;
|
||||||
|
cursor = seiteBody.naechster;
|
||||||
|
expect(cursor).not.toBeNull();
|
||||||
|
}
|
||||||
|
|
||||||
|
// Der eigentliche Punkt: keine Dubletten und keine Luecken, auch wenn
|
||||||
|
// mehrere Eintraege denselben Zeitstempel tragen.
|
||||||
|
expect(new Set(ids).size).toBe(ids.length);
|
||||||
|
expect(ids.length).toBe(alles.activities.length);
|
||||||
|
|
||||||
|
// Absteigend sortiert.
|
||||||
|
const zeiten: number[] = alles.activities.map((eintrag: { createdAt: string }) =>
|
||||||
|
Date.parse(eintrag.createdAt),
|
||||||
|
);
|
||||||
|
for (let i = 1; i < zeiten.length; i += 1) {
|
||||||
|
expect(zeiten[i]).toBeLessThanOrEqual(zeiten[i - 1]);
|
||||||
|
}
|
||||||
|
|
||||||
|
// Unbrauchbare Cursor fangen von vorn an, statt zu scheitern.
|
||||||
|
const kaputt = await request.get("/api/activity?vor=keindatum&id=x");
|
||||||
|
expect(kaputt.ok()).toBeTruthy();
|
||||||
|
expect((await kaputt.json()).activities.length).toBeGreaterThan(0);
|
||||||
|
|
||||||
|
// Und ein fremdes Konto sieht ausschliesslich seinen eigenen Verlauf.
|
||||||
|
const fremd = await playwright.request.newContext({
|
||||||
|
baseURL: test.info().project.use.baseURL,
|
||||||
|
});
|
||||||
|
await login(fremd, ZWEITER);
|
||||||
|
const fremderVerlauf = await (await fremd.get("/api/activity")).json();
|
||||||
|
const eigeneIds = new Set(ids);
|
||||||
|
for (const eintrag of fremderVerlauf.activities) {
|
||||||
|
expect(eigeneIds.has(eintrag.id)).toBe(false);
|
||||||
|
}
|
||||||
|
await fremd.dispose();
|
||||||
|
});
|
||||||
|
|
||||||
|
test("Volltextsuche findet auch Aufgaben", async ({ request, playwright }) => {
|
||||||
|
await login(request, ADMIN);
|
||||||
|
|
||||||
|
const projekt = (
|
||||||
|
await (await request.post("/api/projects", { data: { name: "Suchprojekt" } })).json()
|
||||||
|
).project;
|
||||||
|
|
||||||
|
for (const task of [
|
||||||
|
{
|
||||||
|
title: "Dockerfile aufraeumen",
|
||||||
|
description: "Die Schichten im Container neu ordnen, damit der Bau schneller wird.",
|
||||||
|
},
|
||||||
|
{ title: "Rechnungen exportieren", description: "Monatlicher Export als CSV." },
|
||||||
|
{ title: "Erledigtes mit Container", description: "Auch das soll gefunden werden.", status: "DONE" },
|
||||||
|
{ title: "Ohne Bezug", description: "Voellig anderer Inhalt." },
|
||||||
|
]) {
|
||||||
|
expect((await request.post(`/api/projects/${projekt.id}/tasks`, { data: task })).status()).toBe(
|
||||||
|
201,
|
||||||
|
);
|
||||||
|
}
|
||||||
|
|
||||||
|
// Titel und Beschreibung werden durchsucht.
|
||||||
|
const container = await (await request.get("/api/search?q=Container")).json();
|
||||||
|
const titel = container.tasks.map((treffer: { title: string }) => treffer.title);
|
||||||
|
expect(titel).toContain("Dockerfile aufraeumen");
|
||||||
|
// Erledigtes bleibt drin – wer sucht, sucht oft gerade das Abgehakte.
|
||||||
|
expect(titel).toContain("Erledigtes mit Container");
|
||||||
|
expect(titel).not.toContain("Ohne Bezug");
|
||||||
|
|
||||||
|
// Deutsche Stammformen: "Rechnung" findet "Rechnungen".
|
||||||
|
const rechnung = await (await request.get("/api/search?q=Rechnung")).json();
|
||||||
|
expect(rechnung.tasks.map((t: { title: string }) => t.title)).toContain(
|
||||||
|
"Rechnungen exportieren",
|
||||||
|
);
|
||||||
|
|
||||||
|
// Das Projekt taucht in projectIds auf, damit das Brett es einblendet.
|
||||||
|
expect(container.projectIds).toContain(projekt.id);
|
||||||
|
|
||||||
|
// Zu kurze Eingaben liefern leere Listen statt Unsinn.
|
||||||
|
const kurz = await (await request.get("/api/search?q=a")).json();
|
||||||
|
expect(kurz.tasks).toEqual([]);
|
||||||
|
expect(kurz.hits).toEqual([]);
|
||||||
|
|
||||||
|
// Und ein fremdes Konto findet nichts davon.
|
||||||
|
const fremd = await playwright.request.newContext({
|
||||||
|
baseURL: test.info().project.use.baseURL,
|
||||||
|
});
|
||||||
|
await login(fremd, ZWEITER);
|
||||||
|
expect((await (await fremd.get("/api/search?q=Container")).json()).tasks).toHaveLength(0);
|
||||||
|
await fremd.dispose();
|
||||||
|
});
|
||||||
|
|
||||||
test("Der Bildoptimierer ist zu", async ({ playwright }) => {
|
test("Der Bildoptimierer ist zu", async ({ playwright }) => {
|
||||||
// /_next/image reicht jedes Bild durch sharp und damit durch libvips, fuer
|
// /_next/image reicht jedes Bild durch sharp und damit durch libvips, fuer
|
||||||
// das es regelmaessig Schwachstellen gibt. Nebula benutzt next/image
|
// das es regelmaessig Schwachstellen gibt. Nebula benutzt next/image
|
||||||
|
|||||||
+70
-1
@@ -223,6 +223,75 @@ test("Aufgabenuebersicht sammelt ueber alle Projekte und hakt ab", async ({ page
|
|||||||
).toBeVisible();
|
).toBeVisible();
|
||||||
});
|
});
|
||||||
|
|
||||||
|
test("Wochenrueckblick zeigt, was diese Woche passiert ist", async ({ page }) => {
|
||||||
|
// Erreichbar vom Dashboard aus, ohne vierten Punkt in der Kopfleiste.
|
||||||
|
await page.getByRole("link", { name: /Wochenrückblick/ }).click();
|
||||||
|
await expect(page).toHaveURL(/\/rueckblick$/);
|
||||||
|
await expect(page.getByRole("heading", { name: "Diese Woche", level: 1 })).toBeVisible();
|
||||||
|
|
||||||
|
// Die Vorgaenge der bisherigen Tests liegen in dieser Woche, es muss also
|
||||||
|
// etwas dastehen – und das Projekt gehoert an jede Zeile.
|
||||||
|
await expect(page.getByRole("link", { name: "Oberflaechentest" }).first()).toBeVisible();
|
||||||
|
|
||||||
|
// Blättern: zurück und wieder her.
|
||||||
|
await page.getByRole("link", { name: "Eine Woche zurück" }).click();
|
||||||
|
await expect(page).toHaveURL(/woche=-1/);
|
||||||
|
await expect(page.getByRole("heading", { name: "Vorige Woche", level: 1 })).toBeVisible();
|
||||||
|
|
||||||
|
await page.getByRole("link", { name: "Diese Woche", exact: true }).click();
|
||||||
|
await expect(page).toHaveURL(/\/rueckblick$/);
|
||||||
|
|
||||||
|
// Auch ueber die Schnellsuche erreichbar.
|
||||||
|
await page.goto("/");
|
||||||
|
await page.keyboard.press("Control+k");
|
||||||
|
await page.getByPlaceholder(/^Projekt, /).fill("Rückblick");
|
||||||
|
await page.keyboard.press("Enter");
|
||||||
|
await expect(page).toHaveURL(/\/rueckblick/);
|
||||||
|
});
|
||||||
|
|
||||||
|
test("Globale Zeitleiste zeigt den Verlauf ueber alle Projekte", async ({ page }) => {
|
||||||
|
// Vom Wochenrueckblick aus verlinkt.
|
||||||
|
await page.goto("/rueckblick");
|
||||||
|
await page.getByRole("link", { name: /Ganzer Verlauf/ }).click();
|
||||||
|
await expect(page).toHaveURL(/\/verlauf$/);
|
||||||
|
await expect(page.getByRole("heading", { name: "Verlauf", level: 1 })).toBeVisible();
|
||||||
|
|
||||||
|
// Eintraege mit Projektbezug – ohne den ist eine uebergreifende Liste
|
||||||
|
// nicht zu lesen.
|
||||||
|
await expect(page.getByRole("link", { name: "Oberflaechentest" }).first()).toBeVisible();
|
||||||
|
await expect(page.getByText(/Vorgänge geladen|Vorgang geladen/)).toBeVisible();
|
||||||
|
|
||||||
|
// Auch ueber die Schnellsuche erreichbar.
|
||||||
|
await page.goto("/");
|
||||||
|
await page.keyboard.press("Control+k");
|
||||||
|
await page.getByPlaceholder(/^Projekt, /).fill("Verlauf");
|
||||||
|
await page.keyboard.press("Enter");
|
||||||
|
await expect(page).toHaveURL(/\/verlauf/);
|
||||||
|
});
|
||||||
|
|
||||||
|
test("Aufgabendashboard laesst sich durchsuchen", async ({ page }) => {
|
||||||
|
await page.getByRole("link", { name: "Aufgaben", exact: true }).click();
|
||||||
|
await expect(page.getByRole("heading", { name: "Aufgaben", level: 1 })).toBeVisible();
|
||||||
|
|
||||||
|
const suchfeld = page.getByLabel("Aufgaben durchsuchen");
|
||||||
|
await expect(suchfeld).toBeVisible();
|
||||||
|
|
||||||
|
// Aus den frueheren Tests gibt es "Erste Aufgabe" und "Zweite Aufgabe".
|
||||||
|
await suchfeld.fill("Erste");
|
||||||
|
await expect(page.getByRole("listitem").filter({ hasText: "Erste Aufgabe" })).toBeVisible();
|
||||||
|
await expect(page.getByRole("listitem").filter({ hasText: "Zweite Aufgabe" })).toBeHidden();
|
||||||
|
|
||||||
|
// Ohne Treffer erklaert der Leerzustand, worin gesucht wurde.
|
||||||
|
await suchfeld.fill("gibtesnichtxyz");
|
||||||
|
await expect(page.getByText("Keine Treffer")).toBeVisible();
|
||||||
|
await expect(page.getByText(/Titel, Beschreibung, Labels und Projektname/)).toBeVisible();
|
||||||
|
|
||||||
|
// Zuruecksetzen bringt alles wieder.
|
||||||
|
await page.getByRole("button", { name: "Suche zuruecksetzen" }).click();
|
||||||
|
await expect(suchfeld).toHaveValue("");
|
||||||
|
await expect(page.getByRole("listitem").filter({ hasText: "Erste Aufgabe" })).toBeVisible();
|
||||||
|
});
|
||||||
|
|
||||||
test("Schnellsuche findet Projekt und Notiz", async ({ page }) => {
|
test("Schnellsuche findet Projekt und Notiz", async ({ page }) => {
|
||||||
await page.keyboard.press("Control+k");
|
await page.keyboard.press("Control+k");
|
||||||
await expect(page.getByRole("dialog", { name: "Schnellsuche" })).toBeVisible();
|
await expect(page.getByRole("dialog", { name: "Schnellsuche" })).toBeVisible();
|
||||||
@@ -230,7 +299,7 @@ test("Schnellsuche findet Projekt und Notiz", async ({ page }) => {
|
|||||||
// Ohne Eingabe stehen Projekte und Bereiche bereit.
|
// Ohne Eingabe stehen Projekte und Bereiche bereit.
|
||||||
await expect(page.getByRole("dialog").getByText("Oberflaechentest")).toBeVisible();
|
await expect(page.getByRole("dialog").getByText("Oberflaechentest")).toBeVisible();
|
||||||
|
|
||||||
await page.getByPlaceholder(/Projekt, Notiz oder Bereich/).fill("Zaunkoenig");
|
await page.getByPlaceholder(/^Projekt, /).fill("Zaunkoenig");
|
||||||
await expect(page.getByRole("dialog").getByText(/in Oberflaechentest/)).toBeVisible();
|
await expect(page.getByRole("dialog").getByText(/in Oberflaechentest/)).toBeVisible();
|
||||||
|
|
||||||
// Enter springt zum ersten Treffer.
|
// Enter springt zum ersten Treffer.
|
||||||
|
|||||||
Generated
+2
-2
@@ -1,12 +1,12 @@
|
|||||||
{
|
{
|
||||||
"name": "nebula",
|
"name": "nebula",
|
||||||
"version": "1.2.0",
|
"version": "1.10.1",
|
||||||
"lockfileVersion": 3,
|
"lockfileVersion": 3,
|
||||||
"requires": true,
|
"requires": true,
|
||||||
"packages": {
|
"packages": {
|
||||||
"": {
|
"": {
|
||||||
"name": "nebula",
|
"name": "nebula",
|
||||||
"version": "1.2.0",
|
"version": "1.10.1",
|
||||||
"hasInstallScript": true,
|
"hasInstallScript": true,
|
||||||
"dependencies": {
|
"dependencies": {
|
||||||
"@dnd-kit/core": "^6.3.1",
|
"@dnd-kit/core": "^6.3.1",
|
||||||
|
|||||||
+1
-1
@@ -1,6 +1,6 @@
|
|||||||
{
|
{
|
||||||
"name": "nebula",
|
"name": "nebula",
|
||||||
"version": "1.9.0",
|
"version": "1.10.1",
|
||||||
"private": true,
|
"private": true,
|
||||||
"description": "Nebula – Dashboard fuer Vibe-Coding Projekte mit Git-Anbindung (GitHub, GitLab, Gitea)",
|
"description": "Nebula – Dashboard fuer Vibe-Coding Projekte mit Git-Anbindung (GitHub, GitLab, Gitea)",
|
||||||
"scripts": {
|
"scripts": {
|
||||||
|
|||||||
@@ -0,0 +1,20 @@
|
|||||||
|
-- Volltextsuche ueber Aufgaben.
|
||||||
|
--
|
||||||
|
-- Wie Note_fulltext_idx ein Ausdrucksindex: Prisma kann so etwas im Schema
|
||||||
|
-- nicht abbilden und kennt ihn deshalb nicht. Nachgeprueft mit
|
||||||
|
-- "prisma migrate diff" gegen das Schema - es kommt "empty migration"
|
||||||
|
-- heraus, der Index wird also weder angelegt noch geloescht. Trotzdem beim
|
||||||
|
-- Erzeugen kuenftiger Migrationen kurz hinsehen.
|
||||||
|
--
|
||||||
|
-- Faellt er doch einmal weg, funktioniert die Suche weiter, nur langsamer:
|
||||||
|
-- Postgres berechnet to_tsvector dann je Zeile.
|
||||||
|
--
|
||||||
|
-- Der Ausdruck muss Zeichen fuer Zeichen dem in src/app/api/search/route.ts
|
||||||
|
-- entsprechen, sonst greift der Index nicht. Die zweistellige Form von
|
||||||
|
-- to_tsvector mit fester Konfiguration ist IMMUTABLE und damit indizierbar.
|
||||||
|
--
|
||||||
|
-- Anders als bei der Notiz ist auch die Beschreibung optional, deshalb steht
|
||||||
|
-- coalesce um beide Spalten.
|
||||||
|
|
||||||
|
CREATE INDEX "Task_fulltext_idx" ON "Task"
|
||||||
|
USING GIN (to_tsvector('german', coalesce("title", '') || ' ' || coalesce("description", '')));
|
||||||
@@ -0,0 +1,58 @@
|
|||||||
|
import { NextResponse } from "next/server";
|
||||||
|
import { requireUserApi } from "@/lib/auth/guard";
|
||||||
|
import { prisma } from "@/lib/db";
|
||||||
|
import {
|
||||||
|
SEITEN_ORDNUNG,
|
||||||
|
cursorAus,
|
||||||
|
seitenBedingung,
|
||||||
|
seitenGroesse,
|
||||||
|
} from "@/lib/timeline";
|
||||||
|
|
||||||
|
export const dynamic = "force-dynamic";
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Der Verlauf ueber alle Projekte, neueste Eintraege zuerst.
|
||||||
|
*
|
||||||
|
* Geblaettert wird per Cursor (`vor` = Zeitpunkt, `id` = Eintrag), nicht per
|
||||||
|
* Offset – siehe lib/timeline. Zurueck kommt der Cursor fuer die naechste
|
||||||
|
* Seite gleich mit, damit der Aufrufer ihn nicht selbst zusammensetzen muss.
|
||||||
|
*/
|
||||||
|
export async function GET(request: Request) {
|
||||||
|
const auth = await requireUserApi();
|
||||||
|
if (!auth.ok) return auth.response;
|
||||||
|
|
||||||
|
const params = new URL(request.url).searchParams;
|
||||||
|
const cursor = cursorAus(params.get("vor"), params.get("id"));
|
||||||
|
const take = seitenGroesse(params.get("limit"));
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Einen mehr holen als angefragt: daran laesst sich ablesen, ob es
|
||||||
|
* weitergeht, ohne dafuer zaehlen zu muessen.
|
||||||
|
*/
|
||||||
|
const gefunden = await prisma.activity.findMany({
|
||||||
|
where: seitenBedingung(auth.user.id, cursor),
|
||||||
|
orderBy: SEITEN_ORDNUNG,
|
||||||
|
take: take + 1,
|
||||||
|
select: {
|
||||||
|
id: true,
|
||||||
|
kind: true,
|
||||||
|
summary: true,
|
||||||
|
createdAt: true,
|
||||||
|
project: { select: { id: true, name: true, accent: true } },
|
||||||
|
user: { select: { username: true, displayName: true } },
|
||||||
|
},
|
||||||
|
});
|
||||||
|
|
||||||
|
const weitere = gefunden.length > take;
|
||||||
|
const activities = weitere ? gefunden.slice(0, take) : gefunden;
|
||||||
|
const letzter = activities[activities.length - 1];
|
||||||
|
|
||||||
|
return NextResponse.json({
|
||||||
|
activities: activities.map((eintrag) => ({
|
||||||
|
...eintrag,
|
||||||
|
createdAt: eintrag.createdAt.toISOString(),
|
||||||
|
})),
|
||||||
|
weitere,
|
||||||
|
naechster: weitere && letzter ? { vor: letzter.createdAt.toISOString(), id: letzter.id } : null,
|
||||||
|
});
|
||||||
|
}
|
||||||
@@ -12,16 +12,30 @@ interface Hit {
|
|||||||
snippet: string;
|
snippet: string;
|
||||||
}
|
}
|
||||||
|
|
||||||
|
interface TaskHit {
|
||||||
|
projectId: string;
|
||||||
|
taskId: string;
|
||||||
|
title: string;
|
||||||
|
status: string;
|
||||||
|
/** Ausschnitt aus der Beschreibung; leer, wenn nur der Titel passte. */
|
||||||
|
snippet: string;
|
||||||
|
}
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* Volltextsuche ueber Notizen.
|
* Volltextsuche ueber Notizen und Aufgaben.
|
||||||
*
|
*
|
||||||
* Die Suche im Board arbeitet auf den bereits geladenen Projekten und deckt
|
* Die Suche im Board arbeitet auf den bereits geladenen Projekten und deckt
|
||||||
* Name, Kurzbeschreibung und Tags ab. Notizen liegen dort nicht vor – die
|
* Name, Kurzbeschreibung und Tags ab. Notizen und Aufgaben liegen dort nicht
|
||||||
* mitzuladen wuerde die Seite unnoetig aufblaehen. Deshalb dieser Endpunkt:
|
* vor – die mitzuladen wuerde die Seite unnoetig aufblaehen. Deshalb dieser
|
||||||
* Postgres sucht mit seiner deutschen Textsuche direkt in der Datenbank.
|
* Endpunkt: Postgres sucht mit seiner deutschen Textsuche direkt in der
|
||||||
|
* Datenbank.
|
||||||
*
|
*
|
||||||
* ts_headline liefert gleich den passenden Ausschnitt mit; die Hervorhebung
|
* ts_headline liefert gleich den passenden Ausschnitt mit; die Hervorhebung
|
||||||
* kommt als [[…]] zurueck, damit die Oberflaeche kein HTML einbetten muss.
|
* kommt als [[…]] zurueck, damit die Oberflaeche kein HTML einbetten muss.
|
||||||
|
*
|
||||||
|
* Das Feld heisst weiterhin "hits" und meint die Notizen – umbenennen haette
|
||||||
|
* nur Aufrufer gebrochen, ohne etwas zu verbessern. Aufgaben kommen als
|
||||||
|
* eigenes Feld dazu.
|
||||||
*/
|
*/
|
||||||
export async function GET(request: Request) {
|
export async function GET(request: Request) {
|
||||||
const auth = await requireUserApi();
|
const auth = await requireUserApi();
|
||||||
@@ -29,7 +43,7 @@ export async function GET(request: Request) {
|
|||||||
|
|
||||||
const query = (new URL(request.url).searchParams.get("q") ?? "").trim();
|
const query = (new URL(request.url).searchParams.get("q") ?? "").trim();
|
||||||
if (query.length < 2) {
|
if (query.length < 2) {
|
||||||
return NextResponse.json({ query, hits: [], projectIds: [] });
|
return NextResponse.json({ query, hits: [], tasks: [], projectIds: [] });
|
||||||
}
|
}
|
||||||
|
|
||||||
// websearch_to_tsquery versteht Eingaben wie "docker -compose" oder
|
// websearch_to_tsquery versteht Eingaben wie "docker -compose" oder
|
||||||
@@ -57,11 +71,48 @@ export async function GET(request: Request) {
|
|||||||
LIMIT 50
|
LIMIT 50
|
||||||
`;
|
`;
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Dieselbe Rechnung fuer Aufgaben.
|
||||||
|
*
|
||||||
|
* Der Ausdruck in to_tsvector muss Zeichen fuer Zeichen dem in der
|
||||||
|
* Migration entsprechen (Task_fulltext_idx), sonst greift der Index nicht
|
||||||
|
* und Postgres rechnet ihn je Zeile neu.
|
||||||
|
*
|
||||||
|
* Erledigtes bleibt drin: wer sucht, sucht oft gerade das, was er letzte
|
||||||
|
* Woche abgehakt hat.
|
||||||
|
*/
|
||||||
|
const tasks = await prisma.$queryRaw<TaskHit[]>`
|
||||||
|
SELECT
|
||||||
|
t."projectId" AS "projectId",
|
||||||
|
t."id" AS "taskId",
|
||||||
|
t."title" AS "title",
|
||||||
|
t."status"::text AS "status",
|
||||||
|
ts_headline(
|
||||||
|
'german',
|
||||||
|
coalesce(t."description", ''),
|
||||||
|
websearch_to_tsquery('german', ${query}),
|
||||||
|
'StartSel=[[, StopSel=]], MaxWords=18, MinWords=6, ShortWord=2, MaxFragments=1'
|
||||||
|
) AS "snippet"
|
||||||
|
FROM "Task" t
|
||||||
|
JOIN "Project" p ON p."id" = t."projectId"
|
||||||
|
WHERE p."ownerId" = ${auth.user.id}
|
||||||
|
AND to_tsvector('german', coalesce(t."title", '') || ' ' || coalesce(t."description", ''))
|
||||||
|
@@ websearch_to_tsquery('german', ${query})
|
||||||
|
ORDER BY ts_rank(
|
||||||
|
to_tsvector('german', coalesce(t."title", '') || ' ' || coalesce(t."description", '')),
|
||||||
|
websearch_to_tsquery('german', ${query})
|
||||||
|
) DESC
|
||||||
|
LIMIT 50
|
||||||
|
`;
|
||||||
|
|
||||||
return NextResponse.json({
|
return NextResponse.json({
|
||||||
query,
|
query,
|
||||||
hits,
|
hits,
|
||||||
|
tasks,
|
||||||
// Die Oberflaeche braucht vor allem die betroffenen Projekte, um sie im
|
// Die Oberflaeche braucht vor allem die betroffenen Projekte, um sie im
|
||||||
// Board einzublenden.
|
// Board einzublenden – jetzt aus beiden Quellen.
|
||||||
projectIds: Array.from(new Set(hits.map((hit) => hit.projectId))),
|
projectIds: Array.from(
|
||||||
|
new Set([...hits.map((hit) => hit.projectId), ...tasks.map((hit) => hit.projectId)]),
|
||||||
|
),
|
||||||
});
|
});
|
||||||
}
|
}
|
||||||
|
|||||||
+11
-1
@@ -1,4 +1,5 @@
|
|||||||
import { CircleDot, GitBranch, Lightbulb, Rocket, Trophy } from "lucide-react";
|
import Link from "next/link";
|
||||||
|
import { CalendarRange, CircleDot, GitBranch, Lightbulb, Rocket, Trophy } from "lucide-react";
|
||||||
import { ProjectBoard } from "@/components/ProjectBoard";
|
import { ProjectBoard } from "@/components/ProjectBoard";
|
||||||
import { StatCard } from "@/components/StatCard";
|
import { StatCard } from "@/components/StatCard";
|
||||||
import { requireUserPage } from "@/lib/auth/guard";
|
import { requireUserPage } from "@/lib/auth/guard";
|
||||||
@@ -50,6 +51,15 @@ export default async function DashboardPage() {
|
|||||||
Ideen festhalten, Status pflegen, Notizen sammeln – und live sehen, was in den
|
Ideen festhalten, Status pflegen, Notizen sammeln – und live sehen, was in den
|
||||||
verknuepften Repositories bei GitHub, GitLab und Gitea passiert.
|
verknuepften Repositories bei GitHub, GitLab und Gitea passiert.
|
||||||
</p>
|
</p>
|
||||||
|
{/* Kein weiterer Punkt in der Kopfleiste – die ist auf dem Telefon
|
||||||
|
schon eng. Der Rueckblick haengt dort, wo man ohnehin hinsieht. */}
|
||||||
|
<Link
|
||||||
|
href="/rueckblick"
|
||||||
|
className="mt-3 inline-flex items-center gap-1.5 text-sm text-violet-300 underline-offset-2 hover:underline"
|
||||||
|
>
|
||||||
|
<CalendarRange className="h-4 w-4" />
|
||||||
|
Wochenrückblick ansehen
|
||||||
|
</Link>
|
||||||
</header>
|
</header>
|
||||||
|
|
||||||
{/* Zwei Spalten schon auf dem Telefon: einspaltig fuellten die fuenf
|
{/* Zwei Spalten schon auf dem Telefon: einspaltig fuellten die fuenf
|
||||||
|
|||||||
@@ -0,0 +1,139 @@
|
|||||||
|
import type { Metadata } from "next";
|
||||||
|
import Link from "next/link";
|
||||||
|
import { ArrowLeft, ArrowRight, CalendarRange, History } from "lucide-react";
|
||||||
|
import { WeeklyReview } from "@/components/WeeklyReview";
|
||||||
|
import { requireUserPage } from "@/lib/auth/guard";
|
||||||
|
import { prisma } from "@/lib/db";
|
||||||
|
import { tagesschluessel, wocheUm, wochenName, wochenTitel, zaehleWoche } from "@/lib/review";
|
||||||
|
import type { ReviewDay, ReviewEntry } from "@/types";
|
||||||
|
|
||||||
|
export const dynamic = "force-dynamic";
|
||||||
|
|
||||||
|
export const metadata: Metadata = { title: "Wochenrückblick" };
|
||||||
|
|
||||||
|
/** Wie weit sich zurueckblaettern laesst – der Verlauf haelt ohnehin nur 200 je Projekt. */
|
||||||
|
const MAX_RUECKBLICK = 25;
|
||||||
|
|
||||||
|
export default async function ReviewPage({
|
||||||
|
searchParams,
|
||||||
|
}: {
|
||||||
|
searchParams: Promise<{ woche?: string }>;
|
||||||
|
}) {
|
||||||
|
const user = await requireUserPage();
|
||||||
|
const params = await searchParams;
|
||||||
|
|
||||||
|
// Nur nach hinten blaettern: die Zukunft ist im Rueckblick leer.
|
||||||
|
const gewuenscht = Number(params.woche ?? 0);
|
||||||
|
const versatz = Number.isFinite(gewuenscht)
|
||||||
|
? Math.min(0, Math.max(-MAX_RUECKBLICK, Math.trunc(gewuenscht)))
|
||||||
|
: 0;
|
||||||
|
|
||||||
|
const woche = wocheUm(new Date(), versatz);
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Der Verlauf kennt keinen Besitzer – die Trennung laeuft ueber das
|
||||||
|
* Projekt. Die Bedingung steht deshalb als erste in der where-Klausel.
|
||||||
|
*/
|
||||||
|
const activities = await prisma.activity.findMany({
|
||||||
|
where: {
|
||||||
|
project: { ownerId: user.id },
|
||||||
|
createdAt: { gte: woche.von, lt: woche.bis },
|
||||||
|
},
|
||||||
|
include: {
|
||||||
|
project: { select: { id: true, name: true, accent: true } },
|
||||||
|
user: { select: { username: true, displayName: true } },
|
||||||
|
},
|
||||||
|
// meta kommt mit, weil die Kennzahlen daran ablesen, was erledigt
|
||||||
|
// wurde – verlaesslicher als der Anzeigetext.
|
||||||
|
orderBy: { createdAt: "desc" },
|
||||||
|
// Deckel gegen eine Woche, in der ein Abgleich Amok gelaufen ist.
|
||||||
|
take: 500,
|
||||||
|
});
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Nach Kalendertagen buendeln – auf dem Server, damit Server-Render und
|
||||||
|
* Hydration nicht auseinanderlaufen. "Welcher Tag" haengt an der Zeitzone.
|
||||||
|
*/
|
||||||
|
const nachTag = new Map<string, ReviewEntry[]>();
|
||||||
|
for (const eintrag of activities) {
|
||||||
|
const schluessel = tagesschluessel(eintrag.createdAt);
|
||||||
|
const liste = nachTag.get(schluessel) ?? [];
|
||||||
|
liste.push({
|
||||||
|
id: eintrag.id,
|
||||||
|
kind: eintrag.kind,
|
||||||
|
summary: eintrag.summary,
|
||||||
|
createdAt: eintrag.createdAt.toISOString(),
|
||||||
|
project: eintrag.project,
|
||||||
|
user: eintrag.user,
|
||||||
|
});
|
||||||
|
nachTag.set(schluessel, liste);
|
||||||
|
}
|
||||||
|
|
||||||
|
// Neuester Tag zuerst, und nur Tage, an denen etwas war.
|
||||||
|
const tage: ReviewDay[] = [...woche.tage]
|
||||||
|
.reverse()
|
||||||
|
.map((tag) => ({ tag, eintraege: nachTag.get(tag) ?? [] }))
|
||||||
|
.filter((eintrag) => eintrag.eintraege.length > 0);
|
||||||
|
|
||||||
|
const kennzahlen = zaehleWoche(activities);
|
||||||
|
|
||||||
|
return (
|
||||||
|
<div className="space-y-5">
|
||||||
|
<header className="fade-up pt-4">
|
||||||
|
<p className="text-[11px] font-semibold uppercase tracking-[0.3em] text-violet-300/70">
|
||||||
|
Über alle Projekte
|
||||||
|
</p>
|
||||||
|
<div className="mt-2 flex flex-wrap items-end justify-between gap-3">
|
||||||
|
<div>
|
||||||
|
<h1 className="text-2xl font-semibold tracking-tight text-white sm:text-3xl">
|
||||||
|
{wochenName(woche)}
|
||||||
|
</h1>
|
||||||
|
<p className="mt-1 flex items-center gap-1.5 text-sm text-slate-400">
|
||||||
|
<CalendarRange className="h-3.5 w-3.5" />
|
||||||
|
{wochenTitel(woche)}
|
||||||
|
</p>
|
||||||
|
</div>
|
||||||
|
|
||||||
|
<nav className="flex items-center gap-2" aria-label="Woche wählen">
|
||||||
|
<Link
|
||||||
|
href={`/rueckblick?woche=${versatz - 1}`}
|
||||||
|
className="btn btn-ghost px-2.5 py-1.5 text-xs"
|
||||||
|
aria-label="Eine Woche zurück"
|
||||||
|
// Am Ende des Zeitraums bleibt der Verweis stehen, wird aber
|
||||||
|
// wirkungslos – die Seite klemmt den Wert ohnehin.
|
||||||
|
aria-disabled={versatz <= -MAX_RUECKBLICK}
|
||||||
|
>
|
||||||
|
<ArrowLeft className="h-3.5 w-3.5" />
|
||||||
|
Früher
|
||||||
|
</Link>
|
||||||
|
{versatz < 0 ? (
|
||||||
|
<Link
|
||||||
|
href={`/rueckblick?woche=${versatz + 1}`}
|
||||||
|
className="btn btn-ghost px-2.5 py-1.5 text-xs"
|
||||||
|
aria-label="Eine Woche vor"
|
||||||
|
>
|
||||||
|
Später
|
||||||
|
<ArrowRight className="h-3.5 w-3.5" />
|
||||||
|
</Link>
|
||||||
|
) : null}
|
||||||
|
{versatz !== 0 ? (
|
||||||
|
<Link href="/rueckblick" className="btn btn-ghost px-2.5 py-1.5 text-xs">
|
||||||
|
Diese Woche
|
||||||
|
</Link>
|
||||||
|
) : null}
|
||||||
|
<Link href="/verlauf" className="btn btn-ghost px-2.5 py-1.5 text-xs">
|
||||||
|
<History className="h-3.5 w-3.5" />
|
||||||
|
Ganzer Verlauf
|
||||||
|
</Link>
|
||||||
|
</nav>
|
||||||
|
</div>
|
||||||
|
</header>
|
||||||
|
|
||||||
|
<WeeklyReview
|
||||||
|
tage={tage}
|
||||||
|
kennzahlen={kennzahlen}
|
||||||
|
istDieseWoche={versatz === 0}
|
||||||
|
/>
|
||||||
|
</div>
|
||||||
|
);
|
||||||
|
}
|
||||||
@@ -0,0 +1,77 @@
|
|||||||
|
import type { Metadata } from "next";
|
||||||
|
import Link from "next/link";
|
||||||
|
import { CalendarRange, History } from "lucide-react";
|
||||||
|
import { Timeline } from "@/components/Timeline";
|
||||||
|
import { requireUserPage } from "@/lib/auth/guard";
|
||||||
|
import { prisma } from "@/lib/db";
|
||||||
|
import { SEITE, SEITEN_ORDNUNG, seitenBedingung } from "@/lib/timeline";
|
||||||
|
import type { ReviewEntry } from "@/types";
|
||||||
|
|
||||||
|
export const dynamic = "force-dynamic";
|
||||||
|
|
||||||
|
export const metadata: Metadata = { title: "Verlauf" };
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Der Verlauf ueber alle Projekte, fortlaufend.
|
||||||
|
*
|
||||||
|
* Die erste Seite kommt serverseitig mit, damit sofort etwas dasteht; alles
|
||||||
|
* Weitere holt der Knopf per Cursor nach. Anders als der Wochenrueckblick
|
||||||
|
* hat diese Seite keine Grenze und kein Fazit – sie laeuft zurueck, solange
|
||||||
|
* es Eintraege gibt.
|
||||||
|
*/
|
||||||
|
export default async function TimelinePage() {
|
||||||
|
const user = await requireUserPage();
|
||||||
|
|
||||||
|
const gefunden = await prisma.activity.findMany({
|
||||||
|
where: seitenBedingung(user.id, null),
|
||||||
|
orderBy: SEITEN_ORDNUNG,
|
||||||
|
// Einen mehr, um zu wissen, ob es weitergeht.
|
||||||
|
take: SEITE + 1,
|
||||||
|
select: {
|
||||||
|
id: true,
|
||||||
|
kind: true,
|
||||||
|
summary: true,
|
||||||
|
createdAt: true,
|
||||||
|
project: { select: { id: true, name: true, accent: true } },
|
||||||
|
user: { select: { username: true, displayName: true } },
|
||||||
|
},
|
||||||
|
});
|
||||||
|
|
||||||
|
const weitere = gefunden.length > SEITE;
|
||||||
|
const erste: ReviewEntry[] = (weitere ? gefunden.slice(0, SEITE) : gefunden).map((eintrag) => ({
|
||||||
|
id: eintrag.id,
|
||||||
|
kind: eintrag.kind,
|
||||||
|
summary: eintrag.summary,
|
||||||
|
createdAt: eintrag.createdAt.toISOString(),
|
||||||
|
project: eintrag.project,
|
||||||
|
user: eintrag.user,
|
||||||
|
}));
|
||||||
|
|
||||||
|
return (
|
||||||
|
<div className="space-y-5">
|
||||||
|
<header className="fade-up pt-4">
|
||||||
|
<p className="text-[11px] font-semibold uppercase tracking-[0.3em] text-violet-300/70">
|
||||||
|
Über alle Projekte
|
||||||
|
</p>
|
||||||
|
<div className="mt-2 flex flex-wrap items-end justify-between gap-3">
|
||||||
|
<div>
|
||||||
|
<h1 className="flex items-center gap-2 text-2xl font-semibold tracking-tight text-white sm:text-3xl">
|
||||||
|
<History className="h-6 w-6 text-violet-300" />
|
||||||
|
Verlauf
|
||||||
|
</h1>
|
||||||
|
<p className="mt-1 text-sm text-slate-400">
|
||||||
|
Alles, was passiert ist – vom Neuesten rückwärts.
|
||||||
|
</p>
|
||||||
|
</div>
|
||||||
|
|
||||||
|
<Link href="/rueckblick" className="btn btn-ghost px-3 py-1.5 text-xs">
|
||||||
|
<CalendarRange className="h-3.5 w-3.5" />
|
||||||
|
Wochenrückblick
|
||||||
|
</Link>
|
||||||
|
</div>
|
||||||
|
</header>
|
||||||
|
|
||||||
|
<Timeline erste={erste} weitere={weitere} />
|
||||||
|
</div>
|
||||||
|
);
|
||||||
|
}
|
||||||
@@ -1,23 +1,9 @@
|
|||||||
"use client";
|
"use client";
|
||||||
|
|
||||||
import { useState } from "react";
|
import { useState } from "react";
|
||||||
import {
|
import { Bot, History, Loader2 } from "lucide-react";
|
||||||
AlertTriangle,
|
import { ACTIVITY_KINDS } from "@/components/activityKinds";
|
||||||
ArrowRight,
|
import type { ActivityEntry } from "@/types";
|
||||||
Bot,
|
|
||||||
Download,
|
|
||||||
GitCommitHorizontal,
|
|
||||||
History,
|
|
||||||
Link2,
|
|
||||||
Loader2,
|
|
||||||
NotebookPen,
|
|
||||||
Pencil,
|
|
||||||
Plus,
|
|
||||||
Signpost,
|
|
||||||
Sparkles,
|
|
||||||
Trash2,
|
|
||||||
} from "lucide-react";
|
|
||||||
import type { ActivityEntry, ActivityKind } from "@/types";
|
|
||||||
import { formatDateTime, formatRelative } from "@/lib/utils";
|
import { formatDateTime, formatRelative } from "@/lib/utils";
|
||||||
|
|
||||||
/**
|
/**
|
||||||
@@ -29,21 +15,6 @@ import { formatDateTime, formatRelative } from "@/lib/utils";
|
|||||||
* obersten fuenf liest.
|
* obersten fuenf liest.
|
||||||
*/
|
*/
|
||||||
|
|
||||||
const KINDS: Record<ActivityKind, { icon: typeof Sparkles; color: string }> = {
|
|
||||||
PROJECT_CREATED: { icon: Sparkles, color: "text-violet-300" },
|
|
||||||
PROJECT_UPDATED: { icon: Pencil, color: "text-slate-400" },
|
|
||||||
STATUS_CHANGED: { icon: Signpost, color: "text-cyan-300" },
|
|
||||||
NOTE_ADDED: { icon: NotebookPen, color: "text-blue-300" },
|
|
||||||
NOTE_UPDATED: { icon: Pencil, color: "text-blue-300" },
|
|
||||||
NOTE_DELETED: { icon: Trash2, color: "text-rose-300" },
|
|
||||||
TASK_ADDED: { icon: Plus, color: "text-emerald-300" },
|
|
||||||
TASK_MOVED: { icon: ArrowRight, color: "text-violet-300" },
|
|
||||||
TASK_DELETED: { icon: Trash2, color: "text-rose-300" },
|
|
||||||
TASKS_IMPORTED: { icon: Download, color: "text-amber-300" },
|
|
||||||
REPO_LINKED: { icon: Link2, color: "text-cyan-300" },
|
|
||||||
REPO_COMMITS: { icon: GitCommitHorizontal, color: "text-emerald-300" },
|
|
||||||
SYNC_FAILED: { icon: AlertTriangle, color: "text-rose-300" },
|
|
||||||
};
|
|
||||||
|
|
||||||
export function ActivityFeed({
|
export function ActivityFeed({
|
||||||
projectId,
|
projectId,
|
||||||
@@ -88,7 +59,7 @@ export function ActivityFeed({
|
|||||||
) : (
|
) : (
|
||||||
<ol className="mt-4 space-y-0">
|
<ol className="mt-4 space-y-0">
|
||||||
{entries.map((entry, index) => {
|
{entries.map((entry, index) => {
|
||||||
const meta = KINDS[entry.kind] ?? KINDS.PROJECT_UPDATED;
|
const meta = ACTIVITY_KINDS[entry.kind] ?? ACTIVITY_KINDS.PROJECT_UPDATED;
|
||||||
const Icon = meta.icon;
|
const Icon = meta.icon;
|
||||||
const letzter = index === entries.length - 1;
|
const letzter = index === entries.length - 1;
|
||||||
|
|
||||||
|
|||||||
@@ -0,0 +1,126 @@
|
|||||||
|
import Link from "next/link";
|
||||||
|
import { ACTIVITY_KINDS } from "@/components/activityKinds";
|
||||||
|
import { accentOf } from "@/lib/status";
|
||||||
|
import { cn } from "@/lib/utils";
|
||||||
|
import type { ReviewDay, ReviewEntry } from "@/types";
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Darstellung von Verlaufseintraegen – eine Zeile und die Gruppierung nach
|
||||||
|
* Kalendertagen.
|
||||||
|
*
|
||||||
|
* Bewusst ohne "use client" und ohne Hooks: so laesst sich beides sowohl aus
|
||||||
|
* einer Server-Komponente (Wochenrueckblick) als auch aus einer
|
||||||
|
* Client-Komponente (Zeitleiste mit Nachladen) heraus benutzen. Zwei Kopien
|
||||||
|
* derselben Zeile waeren beim naechsten Feinschliff auseinandergelaufen.
|
||||||
|
*
|
||||||
|
* Alle Formate mit fester Zeitzone – dieselbe Ueberlegung wie in lib/utils:
|
||||||
|
* sonst weichen Server-Render und Hydration voneinander ab.
|
||||||
|
*/
|
||||||
|
|
||||||
|
const WOCHENTAG = new Intl.DateTimeFormat("de-DE", {
|
||||||
|
timeZone: "Europe/Berlin",
|
||||||
|
weekday: "long",
|
||||||
|
});
|
||||||
|
const TAG_MONAT = new Intl.DateTimeFormat("de-DE", {
|
||||||
|
timeZone: "Europe/Berlin",
|
||||||
|
day: "numeric",
|
||||||
|
month: "long",
|
||||||
|
});
|
||||||
|
const TAG_MONAT_JAHR = new Intl.DateTimeFormat("de-DE", {
|
||||||
|
timeZone: "Europe/Berlin",
|
||||||
|
day: "numeric",
|
||||||
|
month: "long",
|
||||||
|
year: "numeric",
|
||||||
|
});
|
||||||
|
const UHRZEIT = new Intl.DateTimeFormat("de-DE", {
|
||||||
|
timeZone: "Europe/Berlin",
|
||||||
|
hour: "2-digit",
|
||||||
|
minute: "2-digit",
|
||||||
|
});
|
||||||
|
|
||||||
|
/** "2026-08-17" → ein Zeitpunkt mittags, damit die Zeitzone nichts verschiebt. */
|
||||||
|
function alsDatum(tag: string): Date {
|
||||||
|
const [j, m, t] = tag.split("-").map(Number);
|
||||||
|
return new Date(Date.UTC(j, m - 1, t, 12));
|
||||||
|
}
|
||||||
|
|
||||||
|
export function ActivityDayGroups({
|
||||||
|
tage,
|
||||||
|
/** Bei Tagen aus anderen Jahren gehoert die Jahreszahl dazu. */
|
||||||
|
mitJahr = false,
|
||||||
|
}: {
|
||||||
|
tage: ReviewDay[];
|
||||||
|
mitJahr?: boolean;
|
||||||
|
}) {
|
||||||
|
const format = mitJahr ? TAG_MONAT_JAHR : TAG_MONAT;
|
||||||
|
|
||||||
|
return (
|
||||||
|
<div className="space-y-6">
|
||||||
|
{tage.map((tag) => {
|
||||||
|
const datum = alsDatum(tag.tag);
|
||||||
|
return (
|
||||||
|
<section key={tag.tag}>
|
||||||
|
<div className="mb-2.5 flex flex-wrap items-baseline gap-x-2.5 gap-y-1">
|
||||||
|
<h2 className="text-sm font-semibold uppercase tracking-wider text-slate-300">
|
||||||
|
{WOCHENTAG.format(datum)}
|
||||||
|
</h2>
|
||||||
|
<span className="text-xs text-slate-500">{format.format(datum)}</span>
|
||||||
|
<span className="rounded-full bg-white/6 px-2 py-0.5 text-[11px] tabular-nums text-slate-400">
|
||||||
|
{tag.eintraege.length}
|
||||||
|
</span>
|
||||||
|
<span className="h-px flex-1 bg-gradient-to-r from-white/10 to-transparent" />
|
||||||
|
</div>
|
||||||
|
|
||||||
|
<ul className="glass divide-y divide-white/6 overflow-hidden">
|
||||||
|
{tag.eintraege.map((eintrag) => (
|
||||||
|
<ActivityRow key={eintrag.id} eintrag={eintrag} />
|
||||||
|
))}
|
||||||
|
</ul>
|
||||||
|
</section>
|
||||||
|
);
|
||||||
|
})}
|
||||||
|
</div>
|
||||||
|
);
|
||||||
|
}
|
||||||
|
|
||||||
|
export function ActivityRow({ eintrag }: { eintrag: ReviewEntry }) {
|
||||||
|
const art = ACTIVITY_KINDS[eintrag.kind] ?? ACTIVITY_KINDS.PROJECT_UPDATED;
|
||||||
|
const Icon = art.icon;
|
||||||
|
const accent = accentOf(eintrag.project.accent);
|
||||||
|
|
||||||
|
return (
|
||||||
|
<li className="flex items-start gap-2.5 px-3 py-2.5 sm:gap-3 sm:px-4">
|
||||||
|
<span className={cn("mt-0.5 shrink-0", art.color)} title={art.label}>
|
||||||
|
<Icon className="h-4 w-4" />
|
||||||
|
</span>
|
||||||
|
|
||||||
|
<div className="min-w-0 flex-1">
|
||||||
|
<p className="text-sm leading-snug text-slate-200">{eintrag.summary}</p>
|
||||||
|
<div className="mt-1 flex flex-wrap items-center gap-x-2 gap-y-1 text-[11px] text-slate-500">
|
||||||
|
{/* Das Projekt gehoert in jede Zeile – ohne es ist eine
|
||||||
|
projektuebergreifende Liste nicht zu lesen. */}
|
||||||
|
<Link
|
||||||
|
href={`/projects/${eintrag.project.id}`}
|
||||||
|
className="inline-flex max-w-[12rem] items-center gap-1.5 truncate text-slate-400 underline-offset-2 hover:text-violet-300 hover:underline"
|
||||||
|
>
|
||||||
|
<span
|
||||||
|
className="h-1.5 w-1.5 shrink-0 rounded-full"
|
||||||
|
style={{ backgroundColor: accent.from }}
|
||||||
|
aria-hidden="true"
|
||||||
|
/>
|
||||||
|
{eintrag.project.name}
|
||||||
|
</Link>
|
||||||
|
<span className="tabular-nums">{UHRZEIT.format(new Date(eintrag.createdAt))} Uhr</span>
|
||||||
|
{eintrag.user ? (
|
||||||
|
<span className="hidden xs:inline">
|
||||||
|
{eintrag.user.displayName?.trim() || eintrag.user.username}
|
||||||
|
</span>
|
||||||
|
) : (
|
||||||
|
// Ohne Benutzer: das war der Zeitgeber oder ein Webhook.
|
||||||
|
<span className="hidden text-slate-600 xs:inline">automatisch</span>
|
||||||
|
)}
|
||||||
|
</div>
|
||||||
|
</div>
|
||||||
|
</li>
|
||||||
|
);
|
||||||
|
}
|
||||||
@@ -5,9 +5,11 @@ import { createPortal } from "react-dom";
|
|||||||
import { useRouter } from "next/navigation";
|
import { useRouter } from "next/navigation";
|
||||||
import {
|
import {
|
||||||
Bell,
|
Bell,
|
||||||
|
CalendarRange,
|
||||||
CheckSquare,
|
CheckSquare,
|
||||||
CornerDownLeft,
|
CornerDownLeft,
|
||||||
GitBranch,
|
GitBranch,
|
||||||
|
History,
|
||||||
LayoutDashboard,
|
LayoutDashboard,
|
||||||
Loader2,
|
Loader2,
|
||||||
NotebookPen,
|
NotebookPen,
|
||||||
@@ -16,8 +18,9 @@ import {
|
|||||||
Settings,
|
Settings,
|
||||||
UserRound,
|
UserRound,
|
||||||
} from "lucide-react";
|
} from "lucide-react";
|
||||||
import type { ProjectStatus } from "@prisma/client";
|
import type { ProjectStatus, TaskStatus } from "@prisma/client";
|
||||||
import { statusOf } from "@/lib/status";
|
import { statusOf } from "@/lib/status";
|
||||||
|
import { TASK_STATUS_META } from "@/lib/tasks";
|
||||||
import { cn } from "@/lib/utils";
|
import { cn } from "@/lib/utils";
|
||||||
|
|
||||||
/**
|
/**
|
||||||
@@ -38,6 +41,14 @@ interface ProjectHit {
|
|||||||
tags: string[];
|
tags: string[];
|
||||||
}
|
}
|
||||||
|
|
||||||
|
interface TaskHit {
|
||||||
|
projectId: string;
|
||||||
|
taskId: string;
|
||||||
|
title: string;
|
||||||
|
status: string;
|
||||||
|
snippet: string;
|
||||||
|
}
|
||||||
|
|
||||||
interface NoteHit {
|
interface NoteHit {
|
||||||
projectId: string;
|
projectId: string;
|
||||||
noteId: string;
|
noteId: string;
|
||||||
@@ -56,6 +67,20 @@ interface Action {
|
|||||||
|
|
||||||
const ACTIONS: Action[] = [
|
const ACTIONS: Action[] = [
|
||||||
{ id: "dashboard", label: "Dashboard", hint: "Alle Projekte", icon: LayoutDashboard, href: "/" },
|
{ id: "dashboard", label: "Dashboard", hint: "Alle Projekte", icon: LayoutDashboard, href: "/" },
|
||||||
|
{
|
||||||
|
id: "rueckblick",
|
||||||
|
label: "Wochenrückblick",
|
||||||
|
hint: "Was diese Woche passiert ist",
|
||||||
|
icon: CalendarRange,
|
||||||
|
href: "/rueckblick",
|
||||||
|
},
|
||||||
|
{
|
||||||
|
id: "verlauf",
|
||||||
|
label: "Verlauf",
|
||||||
|
hint: "Alles, was passiert ist – über alle Projekte",
|
||||||
|
icon: History,
|
||||||
|
href: "/verlauf",
|
||||||
|
},
|
||||||
{
|
{
|
||||||
id: "tasks",
|
id: "tasks",
|
||||||
label: "Aufgaben",
|
label: "Aufgaben",
|
||||||
@@ -91,7 +116,8 @@ const ACTIONS: Action[] = [
|
|||||||
type Entry =
|
type Entry =
|
||||||
| { kind: "action"; key: string; action: Action }
|
| { kind: "action"; key: string; action: Action }
|
||||||
| { kind: "project"; key: string; project: ProjectHit }
|
| { kind: "project"; key: string; project: ProjectHit }
|
||||||
| { kind: "note"; key: string; note: NoteHit; projectName: string };
|
| { kind: "note"; key: string; note: NoteHit; projectName: string }
|
||||||
|
| { kind: "task"; key: string; task: TaskHit; projectName: string };
|
||||||
|
|
||||||
export function CommandPalette({ isAdmin }: { isAdmin: boolean }) {
|
export function CommandPalette({ isAdmin }: { isAdmin: boolean }) {
|
||||||
const router = useRouter();
|
const router = useRouter();
|
||||||
@@ -100,6 +126,7 @@ export function CommandPalette({ isAdmin }: { isAdmin: boolean }) {
|
|||||||
const [query, setQuery] = useState("");
|
const [query, setQuery] = useState("");
|
||||||
const [projects, setProjects] = useState<ProjectHit[] | null>(null);
|
const [projects, setProjects] = useState<ProjectHit[] | null>(null);
|
||||||
const [notes, setNotes] = useState<NoteHit[]>([]);
|
const [notes, setNotes] = useState<NoteHit[]>([]);
|
||||||
|
const [aufgaben, setAufgaben] = useState<TaskHit[]>([]);
|
||||||
const [active, setActive] = useState(0);
|
const [active, setActive] = useState(0);
|
||||||
const [loading, setLoading] = useState(false);
|
const [loading, setLoading] = useState(false);
|
||||||
const listRef = useRef<HTMLDivElement>(null);
|
const listRef = useRef<HTMLDivElement>(null);
|
||||||
@@ -138,6 +165,7 @@ export function CommandPalette({ isAdmin }: { isAdmin: boolean }) {
|
|||||||
const needle = query.trim();
|
const needle = query.trim();
|
||||||
if (needle.length < 2) {
|
if (needle.length < 2) {
|
||||||
setNotes([]);
|
setNotes([]);
|
||||||
|
setAufgaben([]);
|
||||||
return;
|
return;
|
||||||
}
|
}
|
||||||
const controller = new AbortController();
|
const controller = new AbortController();
|
||||||
@@ -147,8 +175,9 @@ export function CommandPalette({ isAdmin }: { isAdmin: boolean }) {
|
|||||||
signal: controller.signal,
|
signal: controller.signal,
|
||||||
});
|
});
|
||||||
if (!response.ok) return;
|
if (!response.ok) return;
|
||||||
const body = (await response.json()) as { hits: NoteHit[] };
|
const body = (await response.json()) as { hits: NoteHit[]; tasks: TaskHit[] };
|
||||||
setNotes(body.hits ?? []);
|
setNotes(body.hits ?? []);
|
||||||
|
setAufgaben(body.tasks ?? []);
|
||||||
} catch {
|
} catch {
|
||||||
// Abbruch beim Weitertippen ist der Normalfall.
|
// Abbruch beim Weitertippen ist der Normalfall.
|
||||||
}
|
}
|
||||||
@@ -163,6 +192,7 @@ export function CommandPalette({ isAdmin }: { isAdmin: boolean }) {
|
|||||||
if (!open) {
|
if (!open) {
|
||||||
setQuery("");
|
setQuery("");
|
||||||
setNotes([]);
|
setNotes([]);
|
||||||
|
setAufgaben([]);
|
||||||
setActive(0);
|
setActive(0);
|
||||||
}
|
}
|
||||||
}, [open]);
|
}, [open]);
|
||||||
@@ -202,6 +232,17 @@ export function CommandPalette({ isAdmin }: { isAdmin: boolean }) {
|
|||||||
for (const project of passendeProjekte.slice(0, 8)) {
|
for (const project of passendeProjekte.slice(0, 8)) {
|
||||||
result.push({ kind: "project", key: `p-${project.id}`, project });
|
result.push({ kind: "project", key: `p-${project.id}`, project });
|
||||||
}
|
}
|
||||||
|
// Aufgaben vor Notizen: wer tippt, sucht haeufiger etwas zu Tun als
|
||||||
|
// etwas Notiertes.
|
||||||
|
for (const treffer of aufgaben.slice(0, 5)) {
|
||||||
|
result.push({
|
||||||
|
kind: "task",
|
||||||
|
key: `t-${treffer.taskId}`,
|
||||||
|
task: treffer,
|
||||||
|
projectName:
|
||||||
|
(projects ?? []).find((project) => project.id === treffer.projectId)?.name ?? "Projekt",
|
||||||
|
});
|
||||||
|
}
|
||||||
for (const hit of notes.slice(0, 5)) {
|
for (const hit of notes.slice(0, 5)) {
|
||||||
result.push({
|
result.push({
|
||||||
kind: "note",
|
kind: "note",
|
||||||
@@ -215,7 +256,7 @@ export function CommandPalette({ isAdmin }: { isAdmin: boolean }) {
|
|||||||
result.push({ kind: "action", key: `a-${action.id}`, action });
|
result.push({ kind: "action", key: `a-${action.id}`, action });
|
||||||
}
|
}
|
||||||
return result;
|
return result;
|
||||||
}, [query, projects, notes, isAdmin]);
|
}, [query, projects, notes, aufgaben, isAdmin]);
|
||||||
|
|
||||||
useEffect(() => {
|
useEffect(() => {
|
||||||
setActive((current) => Math.min(current, Math.max(0, entries.length - 1)));
|
setActive((current) => Math.min(current, Math.max(0, entries.length - 1)));
|
||||||
@@ -226,6 +267,7 @@ export function CommandPalette({ isAdmin }: { isAdmin: boolean }) {
|
|||||||
setOpen(false);
|
setOpen(false);
|
||||||
if (entry.kind === "action") router.push(entry.action.href);
|
if (entry.kind === "action") router.push(entry.action.href);
|
||||||
else if (entry.kind === "project") router.push(`/projects/${entry.project.id}`);
|
else if (entry.kind === "project") router.push(`/projects/${entry.project.id}`);
|
||||||
|
else if (entry.kind === "task") router.push(`/projects/${entry.task.projectId}`);
|
||||||
else router.push(`/projects/${entry.note.projectId}`);
|
else router.push(`/projects/${entry.note.projectId}`);
|
||||||
},
|
},
|
||||||
[router],
|
[router],
|
||||||
@@ -276,7 +318,7 @@ export function CommandPalette({ isAdmin }: { isAdmin: boolean }) {
|
|||||||
value={query}
|
value={query}
|
||||||
onChange={(event) => setQuery(event.target.value)}
|
onChange={(event) => setQuery(event.target.value)}
|
||||||
onKeyDown={onInputKey}
|
onKeyDown={onInputKey}
|
||||||
placeholder="Projekt, Notiz oder Bereich…"
|
placeholder="Projekt, Aufgabe, Notiz oder Bereich…"
|
||||||
className="w-full bg-transparent text-sm text-slate-100 outline-none placeholder:text-slate-600"
|
className="w-full bg-transparent text-sm text-slate-100 outline-none placeholder:text-slate-600"
|
||||||
/>
|
/>
|
||||||
{loading ? <Loader2 className="h-3.5 w-3.5 animate-spin text-slate-600" /> : null}
|
{loading ? <Loader2 className="h-3.5 w-3.5 animate-spin text-slate-600" /> : null}
|
||||||
@@ -330,6 +372,23 @@ export function CommandPalette({ isAdmin }: { isAdmin: boolean }) {
|
|||||||
{statusOf(entry.project.status).short}
|
{statusOf(entry.project.status).short}
|
||||||
</span>
|
</span>
|
||||||
</>
|
</>
|
||||||
|
) : entry.kind === "task" ? (
|
||||||
|
<>
|
||||||
|
<CheckSquare className="mt-0.5 h-4 w-4 shrink-0 text-emerald-300/70" />
|
||||||
|
<span className="min-w-0">
|
||||||
|
<span className="block truncate text-sm text-slate-200">
|
||||||
|
{entry.task.title}
|
||||||
|
<span className="ml-1.5 text-[11px] text-slate-500">
|
||||||
|
in {entry.projectName}
|
||||||
|
</span>
|
||||||
|
</span>
|
||||||
|
<span className="block truncate text-[11px] text-slate-500">
|
||||||
|
{entry.task.snippet.replace(/\[\[|\]\]/g, "").trim() ||
|
||||||
|
TASK_STATUS_META[entry.task.status as TaskStatus]?.label ||
|
||||||
|
"Aufgabe"}
|
||||||
|
</span>
|
||||||
|
</span>
|
||||||
|
</>
|
||||||
) : (
|
) : (
|
||||||
<>
|
<>
|
||||||
<NotebookPen className="mt-0.5 h-4 w-4 shrink-0 text-violet-300/70" />
|
<NotebookPen className="mt-0.5 h-4 w-4 shrink-0 text-violet-300/70" />
|
||||||
|
|||||||
@@ -3,6 +3,7 @@
|
|||||||
import { useEffect, useMemo, useRef, useState } from "react";
|
import { useEffect, useMemo, useRef, useState } from "react";
|
||||||
import Link from "next/link";
|
import Link from "next/link";
|
||||||
import {
|
import {
|
||||||
|
CheckSquare,
|
||||||
Columns3,
|
Columns3,
|
||||||
Database,
|
Database,
|
||||||
Download,
|
Download,
|
||||||
@@ -16,7 +17,7 @@ import {
|
|||||||
Upload,
|
Upload,
|
||||||
X,
|
X,
|
||||||
} from "lucide-react";
|
} from "lucide-react";
|
||||||
import type { ProjectStatus } from "@prisma/client";
|
import type { ProjectStatus, TaskStatus } from "@prisma/client";
|
||||||
import { BulkBar } from "@/components/BulkBar";
|
import { BulkBar } from "@/components/BulkBar";
|
||||||
import { ImportDialog } from "@/components/ImportDialog";
|
import { ImportDialog } from "@/components/ImportDialog";
|
||||||
import { KanbanBoard } from "@/components/KanbanBoard";
|
import { KanbanBoard } from "@/components/KanbanBoard";
|
||||||
@@ -25,9 +26,18 @@ import { ProjectDialog } from "@/components/ProjectDialog";
|
|||||||
import { ProjectList } from "@/components/ProjectList";
|
import { ProjectList } from "@/components/ProjectList";
|
||||||
import { Popover } from "@/components/ui/Popover";
|
import { Popover } from "@/components/ui/Popover";
|
||||||
import { STATUS_META, STATUS_ORDER } from "@/lib/status";
|
import { STATUS_META, STATUS_ORDER } from "@/lib/status";
|
||||||
|
import { TASK_STATUS_META } from "@/lib/tasks";
|
||||||
import { cn } from "@/lib/utils";
|
import { cn } from "@/lib/utils";
|
||||||
import type { ConnectionSafe, ProjectListItem } from "@/types";
|
import type { ConnectionSafe, ProjectListItem } from "@/types";
|
||||||
|
|
||||||
|
interface TaskHit {
|
||||||
|
projectId: string;
|
||||||
|
taskId: string;
|
||||||
|
title: string;
|
||||||
|
status: string;
|
||||||
|
snippet: string;
|
||||||
|
}
|
||||||
|
|
||||||
interface NoteHit {
|
interface NoteHit {
|
||||||
projectId: string;
|
projectId: string;
|
||||||
noteId: string;
|
noteId: string;
|
||||||
@@ -135,6 +145,7 @@ export function ProjectBoard({
|
|||||||
const [dataMenuOpen, setDataMenuOpen] = useState(false);
|
const [dataMenuOpen, setDataMenuOpen] = useState(false);
|
||||||
const dataButtonRef = useRef<HTMLButtonElement>(null);
|
const dataButtonRef = useRef<HTMLButtonElement>(null);
|
||||||
const [noteHits, setNoteHits] = useState<NoteHit[]>([]);
|
const [noteHits, setNoteHits] = useState<NoteHit[]>([]);
|
||||||
|
const [taskHits, setTaskHits] = useState<TaskHit[]>([]);
|
||||||
const [selection, setSelection] = useState<Set<string>>(new Set());
|
const [selection, setSelection] = useState<Set<string>>(new Set());
|
||||||
|
|
||||||
/**
|
/**
|
||||||
@@ -147,6 +158,7 @@ export function ProjectBoard({
|
|||||||
const needle = query.trim();
|
const needle = query.trim();
|
||||||
if (needle.length < 2) {
|
if (needle.length < 2) {
|
||||||
setNoteHits([]);
|
setNoteHits([]);
|
||||||
|
setTaskHits([]);
|
||||||
return;
|
return;
|
||||||
}
|
}
|
||||||
|
|
||||||
@@ -157,8 +169,9 @@ export function ProjectBoard({
|
|||||||
signal: controller.signal,
|
signal: controller.signal,
|
||||||
});
|
});
|
||||||
if (!response.ok) return;
|
if (!response.ok) return;
|
||||||
const body = (await response.json()) as { hits: NoteHit[] };
|
const body = (await response.json()) as { hits: NoteHit[]; tasks: TaskHit[] };
|
||||||
setNoteHits(body.hits ?? []);
|
setNoteHits(body.hits ?? []);
|
||||||
|
setTaskHits(body.tasks ?? []);
|
||||||
} catch {
|
} catch {
|
||||||
// Abgebrochene Anfragen sind der Normalfall beim Tippen.
|
// Abgebrochene Anfragen sind der Normalfall beim Tippen.
|
||||||
}
|
}
|
||||||
@@ -171,8 +184,12 @@ export function ProjectBoard({
|
|||||||
}, [query]);
|
}, [query]);
|
||||||
|
|
||||||
const noteHitProjectIds = useMemo(
|
const noteHitProjectIds = useMemo(
|
||||||
() => new Set(noteHits.map((hit) => hit.projectId)),
|
() =>
|
||||||
[noteHits],
|
new Set([
|
||||||
|
...noteHits.map((hit) => hit.projectId),
|
||||||
|
...taskHits.map((hit) => hit.projectId),
|
||||||
|
]),
|
||||||
|
[noteHits, taskHits],
|
||||||
);
|
);
|
||||||
|
|
||||||
const counts = useMemo(() => {
|
const counts = useMemo(() => {
|
||||||
@@ -200,7 +217,7 @@ export function ProjectBoard({
|
|||||||
project.repositories.some((repo) =>
|
project.repositories.some((repo) =>
|
||||||
(repo.snapshot?.fullName ?? "").toLowerCase().includes(needle),
|
(repo.snapshot?.fullName ?? "").toLowerCase().includes(needle),
|
||||||
) ||
|
) ||
|
||||||
// Treffer in Notizen kommen vom Server dazu.
|
// Treffer in Notizen und Aufgaben kommen vom Server dazu.
|
||||||
noteHitProjectIds.has(project.id)
|
noteHitProjectIds.has(project.id)
|
||||||
);
|
);
|
||||||
});
|
});
|
||||||
@@ -434,6 +451,60 @@ export function ProjectBoard({
|
|||||||
</div>
|
</div>
|
||||||
</div>
|
</div>
|
||||||
|
|
||||||
|
{/* Treffer in Aufgaben */}
|
||||||
|
{taskHits.length > 0 ? (
|
||||||
|
<div className="glass fade-up p-4">
|
||||||
|
<h2 className="mb-2.5 flex items-center gap-2 text-[11px] font-semibold uppercase tracking-wider text-slate-400">
|
||||||
|
<CheckSquare className="h-3.5 w-3.5 text-emerald-300" />
|
||||||
|
Treffer in Aufgaben
|
||||||
|
<span className="rounded-full bg-white/6 px-2 py-0.5 tabular-nums text-slate-400">
|
||||||
|
{taskHits.length}
|
||||||
|
</span>
|
||||||
|
</h2>
|
||||||
|
<ul className="space-y-1">
|
||||||
|
{taskHits.slice(0, 8).map((hit) => {
|
||||||
|
const project = projects.find((entry) => entry.id === hit.projectId);
|
||||||
|
const status = TASK_STATUS_META[hit.status as TaskStatus];
|
||||||
|
return (
|
||||||
|
<li key={hit.taskId}>
|
||||||
|
<Link
|
||||||
|
href={`/projects/${hit.projectId}`}
|
||||||
|
className="block rounded-lg px-2.5 py-2 transition-colors hover:bg-white/5"
|
||||||
|
>
|
||||||
|
<span className="flex flex-wrap items-baseline gap-x-2">
|
||||||
|
<span className="text-sm text-slate-200">{hit.title}</span>
|
||||||
|
<span className="text-[11px] text-slate-500">
|
||||||
|
· {project?.name ?? "Projekt"}
|
||||||
|
</span>
|
||||||
|
{status ? (
|
||||||
|
<span
|
||||||
|
className="inline-flex items-center gap-1 text-[11px]"
|
||||||
|
style={{ color: status.color }}
|
||||||
|
>
|
||||||
|
{status.label}
|
||||||
|
</span>
|
||||||
|
) : null}
|
||||||
|
</span>
|
||||||
|
{/* Nur wenn die Beschreibung etwas beitraegt – passte
|
||||||
|
allein der Titel, ist der Ausschnitt leer. */}
|
||||||
|
{hit.snippet.trim() ? (
|
||||||
|
<span className="mt-0.5 block text-xs leading-snug text-slate-400">
|
||||||
|
{highlight(hit.snippet)}
|
||||||
|
</span>
|
||||||
|
) : null}
|
||||||
|
</Link>
|
||||||
|
</li>
|
||||||
|
);
|
||||||
|
})}
|
||||||
|
</ul>
|
||||||
|
{taskHits.length > 8 ? (
|
||||||
|
<p className="mt-2 px-2.5 text-[11px] text-slate-600">
|
||||||
|
… und {taskHits.length - 8} weitere
|
||||||
|
</p>
|
||||||
|
) : null}
|
||||||
|
</div>
|
||||||
|
) : null}
|
||||||
|
|
||||||
{/* Treffer in Notizen */}
|
{/* Treffer in Notizen */}
|
||||||
{noteHits.length > 0 ? (
|
{noteHits.length > 0 ? (
|
||||||
<div className="glass fade-up p-4">
|
<div className="glass fade-up p-4">
|
||||||
|
|||||||
@@ -0,0 +1,126 @@
|
|||||||
|
"use client";
|
||||||
|
|
||||||
|
import { useMemo, useState } from "react";
|
||||||
|
import { ChevronDown, History, Loader2 } from "lucide-react";
|
||||||
|
import { ActivityDayGroups } from "@/components/ActivityRow";
|
||||||
|
import { tagesschluessel } from "@/lib/review";
|
||||||
|
import type { ReviewDay, ReviewEntry } from "@/types";
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Die fortlaufende Zeitleiste.
|
||||||
|
*
|
||||||
|
* Client-Komponente, weil hier nachgeladen wird – das ist der Unterschied
|
||||||
|
* zum Wochenrueckblick, der komplett auf dem Server entsteht.
|
||||||
|
*
|
||||||
|
* Die Buendelung nach Tagen passiert hier im Browser. Das ist unbedenklich,
|
||||||
|
* weil tagesschluessel eine feste Zeitzone benutzt: Server und Browser kommen
|
||||||
|
* damit auf denselben Kalendertag, und die erste Seite hydriert ohne
|
||||||
|
* Abweichung.
|
||||||
|
*/
|
||||||
|
export function Timeline({
|
||||||
|
erste,
|
||||||
|
weitere: gabWeitere,
|
||||||
|
}: {
|
||||||
|
erste: ReviewEntry[];
|
||||||
|
weitere: boolean;
|
||||||
|
}) {
|
||||||
|
const [eintraege, setEintraege] = useState(erste);
|
||||||
|
const [weitere, setWeitere] = useState(gabWeitere);
|
||||||
|
const [laedt, setLaedt] = useState(false);
|
||||||
|
const [fehler, setFehler] = useState<string | null>(null);
|
||||||
|
|
||||||
|
const tage: ReviewDay[] = useMemo(() => {
|
||||||
|
// Map behaelt die Einfuegereihenfolge – die Eintraege kommen schon
|
||||||
|
// absteigend, also stimmt die Reihenfolge der Tage von selbst.
|
||||||
|
const nachTag = new Map<string, ReviewEntry[]>();
|
||||||
|
for (const eintrag of eintraege) {
|
||||||
|
const schluessel = tagesschluessel(new Date(eintrag.createdAt));
|
||||||
|
const liste = nachTag.get(schluessel) ?? [];
|
||||||
|
liste.push(eintrag);
|
||||||
|
nachTag.set(schluessel, liste);
|
||||||
|
}
|
||||||
|
return [...nachTag.entries()].map(([tag, liste]) => ({ tag, eintraege: liste }));
|
||||||
|
}, [eintraege]);
|
||||||
|
|
||||||
|
async function mehr() {
|
||||||
|
const letzter = eintraege[eintraege.length - 1];
|
||||||
|
if (!letzter) return;
|
||||||
|
|
||||||
|
setLaedt(true);
|
||||||
|
setFehler(null);
|
||||||
|
try {
|
||||||
|
const antwort = await fetch(
|
||||||
|
`/api/activity?vor=${encodeURIComponent(letzter.createdAt)}&id=${encodeURIComponent(letzter.id)}`,
|
||||||
|
);
|
||||||
|
if (!antwort.ok) throw new Error("Verlauf konnte nicht geladen werden.");
|
||||||
|
const nutzlast = (await antwort.json()) as {
|
||||||
|
activities: ReviewEntry[];
|
||||||
|
weitere: boolean;
|
||||||
|
};
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Gegen Dubletten absichern, auch wenn der Cursor sie ausschliesst:
|
||||||
|
* ein zweimal gedrueckter Knopf oder ein wiederholter Aufruf soll
|
||||||
|
* keine Zeile verdoppeln, und React braucht eindeutige Schluessel.
|
||||||
|
*/
|
||||||
|
setEintraege((bisher) => {
|
||||||
|
const bekannt = new Set(bisher.map((eintrag) => eintrag.id));
|
||||||
|
return [...bisher, ...nutzlast.activities.filter((eintrag) => !bekannt.has(eintrag.id))];
|
||||||
|
});
|
||||||
|
setWeitere(nutzlast.weitere);
|
||||||
|
} catch (gefangen) {
|
||||||
|
setFehler(gefangen instanceof Error ? gefangen.message : String(gefangen));
|
||||||
|
} finally {
|
||||||
|
setLaedt(false);
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
if (eintraege.length === 0) {
|
||||||
|
return (
|
||||||
|
<div className="glass fade-up flex flex-col items-center justify-center gap-4 px-6 py-16 text-center">
|
||||||
|
<span className="grid h-14 w-14 place-items-center rounded-2xl bg-gradient-to-br from-violet-500/25 to-cyan-400/20 text-violet-200">
|
||||||
|
<History className="h-6 w-6" />
|
||||||
|
</span>
|
||||||
|
<div>
|
||||||
|
<h2 className="text-lg font-semibold text-white">Noch kein Verlauf</h2>
|
||||||
|
<p className="mt-1 max-w-md text-sm text-slate-400">
|
||||||
|
Sobald du ein Projekt anlegst, Aufgaben verschiebst oder Notizen schreibst, steht es
|
||||||
|
hier.
|
||||||
|
</p>
|
||||||
|
</div>
|
||||||
|
</div>
|
||||||
|
);
|
||||||
|
}
|
||||||
|
|
||||||
|
return (
|
||||||
|
<div className="space-y-5">
|
||||||
|
{/* Die Jahreszahl gehoert dazu: eine Zeitleiste reicht weit zurueck,
|
||||||
|
und "3. Januar" allein sagt dann nicht genug. */}
|
||||||
|
<ActivityDayGroups tage={tage} mitJahr />
|
||||||
|
|
||||||
|
{fehler ? (
|
||||||
|
<p className="rounded-lg border border-rose-500/30 bg-rose-500/10 px-3 py-2 text-sm text-rose-200">
|
||||||
|
{fehler}
|
||||||
|
</p>
|
||||||
|
) : null}
|
||||||
|
|
||||||
|
<div className="flex flex-col items-center gap-2 pt-1">
|
||||||
|
{weitere ? (
|
||||||
|
<button type="button" className="btn btn-ghost" onClick={mehr} disabled={laedt}>
|
||||||
|
{laedt ? (
|
||||||
|
<Loader2 className="h-4 w-4 animate-spin" />
|
||||||
|
) : (
|
||||||
|
<ChevronDown className="h-4 w-4" />
|
||||||
|
)}
|
||||||
|
Ältere laden
|
||||||
|
</button>
|
||||||
|
) : (
|
||||||
|
<p className="text-xs text-slate-600">Das war alles.</p>
|
||||||
|
)}
|
||||||
|
<p className="text-[11px] text-slate-600 tabular-nums">
|
||||||
|
{eintraege.length} {eintraege.length === 1 ? "Vorgang" : "Vorgänge"} geladen
|
||||||
|
</p>
|
||||||
|
</div>
|
||||||
|
</div>
|
||||||
|
);
|
||||||
|
}
|
||||||
@@ -0,0 +1,108 @@
|
|||||||
|
import { CalendarRange, CheckSquare, FolderGit2, NotebookPen, Plus } from "lucide-react";
|
||||||
|
import { ActivityDayGroups } from "@/components/ActivityRow";
|
||||||
|
import type { Kennzahlen } from "@/lib/review";
|
||||||
|
import type { ReviewDay } from "@/types";
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Der Wochenrueckblick.
|
||||||
|
*
|
||||||
|
* Bewusst eine Server-Komponente: es gibt nichts zu bedienen, alles steht
|
||||||
|
* beim Rendern fest. Das spart dem Browser den ganzen Verlauf als JavaScript.
|
||||||
|
*
|
||||||
|
* Die Tage kommen fertig gebuendelt und in der richtigen Reihenfolge – die
|
||||||
|
* Zuordnung "welcher Kalendertag" haengt an der Zeitzone und gehoert
|
||||||
|
* deshalb auf den Server.
|
||||||
|
*/
|
||||||
|
|
||||||
|
export function WeeklyReview({
|
||||||
|
tage,
|
||||||
|
kennzahlen,
|
||||||
|
istDieseWoche,
|
||||||
|
}: {
|
||||||
|
tage: ReviewDay[];
|
||||||
|
/** Fertig gezaehlt vom Server – die Anzeige rechnet nichts nach. */
|
||||||
|
kennzahlen: Kennzahlen;
|
||||||
|
istDieseWoche: boolean;
|
||||||
|
}) {
|
||||||
|
const { gesamt, projekte, erledigt, neueAufgaben, notizen } = kennzahlen;
|
||||||
|
|
||||||
|
if (gesamt === 0) {
|
||||||
|
return (
|
||||||
|
<div className="glass fade-up flex flex-col items-center justify-center gap-4 px-6 py-16 text-center">
|
||||||
|
<span className="grid h-14 w-14 place-items-center rounded-2xl bg-gradient-to-br from-violet-500/25 to-cyan-400/20 text-violet-200">
|
||||||
|
<CalendarRange className="h-6 w-6" />
|
||||||
|
</span>
|
||||||
|
<div>
|
||||||
|
<h2 className="text-lg font-semibold text-white">
|
||||||
|
{istDieseWoche ? "Diese Woche war es still" : "In dieser Woche ist nichts passiert"}
|
||||||
|
</h2>
|
||||||
|
<p className="mt-1 max-w-md text-sm text-slate-400">
|
||||||
|
{istDieseWoche
|
||||||
|
? "Sobald du Aufgaben abhakst, Notizen schreibst oder etwas gepusht wird, steht es hier."
|
||||||
|
: "Vielleicht lohnt ein Blick auf eine frühere Woche."}
|
||||||
|
</p>
|
||||||
|
</div>
|
||||||
|
</div>
|
||||||
|
);
|
||||||
|
}
|
||||||
|
|
||||||
|
return (
|
||||||
|
<div className="space-y-5">
|
||||||
|
{/* Kennzahlen */}
|
||||||
|
<div className="grid grid-cols-2 gap-3 sm:gap-4 lg:grid-cols-4">
|
||||||
|
<Kennzahl label="Vorgänge" wert={gesamt} icon={CalendarRange} color="#a78bfa" />
|
||||||
|
<Kennzahl label="Projekte berührt" wert={projekte} icon={FolderGit2} color="#38bdf8" />
|
||||||
|
<Kennzahl label="Aufgaben erledigt" wert={erledigt} icon={CheckSquare} color="#34d399" />
|
||||||
|
<Kennzahl label="Neue Aufgaben" wert={neueAufgaben} icon={Plus} color="#fbbf24" />
|
||||||
|
</div>
|
||||||
|
|
||||||
|
{notizen > 0 ? (
|
||||||
|
<p className="flex items-center gap-1.5 px-1 text-xs text-slate-500">
|
||||||
|
<NotebookPen className="h-3.5 w-3.5" />
|
||||||
|
Dazu {notizen} {notizen === 1 ? "neue Notiz" : "neue Notizen"}.
|
||||||
|
</p>
|
||||||
|
) : null}
|
||||||
|
|
||||||
|
{/* Verlauf nach Tagen – dieselbe Darstellung wie in der Zeitleiste. */}
|
||||||
|
<ActivityDayGroups tage={tage} />
|
||||||
|
</div>
|
||||||
|
);
|
||||||
|
}
|
||||||
|
|
||||||
|
function Kennzahl({
|
||||||
|
label,
|
||||||
|
wert,
|
||||||
|
icon: Icon,
|
||||||
|
color,
|
||||||
|
}: {
|
||||||
|
label: string;
|
||||||
|
wert: number;
|
||||||
|
icon: typeof CalendarRange;
|
||||||
|
color: string;
|
||||||
|
}) {
|
||||||
|
return (
|
||||||
|
<div className="glass relative overflow-hidden p-3 sm:p-4">
|
||||||
|
<div
|
||||||
|
className="pointer-events-none absolute -right-6 -top-8 h-24 w-24 rounded-full opacity-25 blur-2xl"
|
||||||
|
style={{ backgroundColor: color }}
|
||||||
|
aria-hidden="true"
|
||||||
|
/>
|
||||||
|
<div className="flex items-start justify-between gap-2">
|
||||||
|
<div className="min-w-0">
|
||||||
|
<p className="text-[11px] font-semibold uppercase leading-tight tracking-[0.14em] text-slate-500">
|
||||||
|
{label}
|
||||||
|
</p>
|
||||||
|
<p className="mt-1.5 text-2xl font-semibold tabular-nums text-white sm:text-3xl">
|
||||||
|
{wert}
|
||||||
|
</p>
|
||||||
|
</div>
|
||||||
|
<span
|
||||||
|
className="grid h-8 w-8 shrink-0 place-items-center rounded-xl sm:h-9 sm:w-9"
|
||||||
|
style={{ backgroundColor: `${color}1f`, color }}
|
||||||
|
>
|
||||||
|
<Icon className="h-4 w-4" />
|
||||||
|
</span>
|
||||||
|
</div>
|
||||||
|
</div>
|
||||||
|
);
|
||||||
|
}
|
||||||
@@ -0,0 +1,43 @@
|
|||||||
|
import {
|
||||||
|
AlertTriangle,
|
||||||
|
ArrowRight,
|
||||||
|
Download,
|
||||||
|
GitCommitHorizontal,
|
||||||
|
Link2,
|
||||||
|
NotebookPen,
|
||||||
|
Pencil,
|
||||||
|
Plus,
|
||||||
|
Signpost,
|
||||||
|
Sparkles,
|
||||||
|
Trash2,
|
||||||
|
} from "lucide-react";
|
||||||
|
import type { ActivityKind } from "@prisma/client";
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Symbol und Farbe je Art eines Verlaufseintrags.
|
||||||
|
*
|
||||||
|
* Ausgelagert, weil sie inzwischen an zwei Stellen gebraucht werden: im
|
||||||
|
* Verlauf eines Projekts und im Wochenrueckblick ueber alle Projekte. Zwei
|
||||||
|
* Kopien liefen beim naechsten neuen Eintragstyp auseinander.
|
||||||
|
*
|
||||||
|
* Bewusst ohne "use client" und ohne Prisma-Zugriff – nur Typen und
|
||||||
|
* Symbole, damit beide Seiten es importieren koennen.
|
||||||
|
*/
|
||||||
|
export const ACTIVITY_KINDS: Record<
|
||||||
|
ActivityKind,
|
||||||
|
{ icon: typeof Sparkles; color: string; label: string }
|
||||||
|
> = {
|
||||||
|
PROJECT_CREATED: { icon: Sparkles, color: "text-violet-300", label: "Projekt angelegt" },
|
||||||
|
PROJECT_UPDATED: { icon: Pencil, color: "text-slate-400", label: "Projekt bearbeitet" },
|
||||||
|
STATUS_CHANGED: { icon: Signpost, color: "text-cyan-300", label: "Status geändert" },
|
||||||
|
NOTE_ADDED: { icon: NotebookPen, color: "text-blue-300", label: "Notiz" },
|
||||||
|
NOTE_UPDATED: { icon: Pencil, color: "text-blue-300", label: "Notiz bearbeitet" },
|
||||||
|
NOTE_DELETED: { icon: Trash2, color: "text-rose-300", label: "Notiz gelöscht" },
|
||||||
|
TASK_ADDED: { icon: Plus, color: "text-emerald-300", label: "Aufgabe angelegt" },
|
||||||
|
TASK_MOVED: { icon: ArrowRight, color: "text-violet-300", label: "Aufgabe verschoben" },
|
||||||
|
TASK_DELETED: { icon: Trash2, color: "text-rose-300", label: "Aufgabe gelöscht" },
|
||||||
|
TASKS_IMPORTED: { icon: Download, color: "text-amber-300", label: "Aufgaben übernommen" },
|
||||||
|
REPO_LINKED: { icon: Link2, color: "text-cyan-300", label: "Repository verknüpft" },
|
||||||
|
REPO_COMMITS: { icon: GitCommitHorizontal, color: "text-emerald-300", label: "Commits" },
|
||||||
|
SYNC_FAILED: { icon: AlertTriangle, color: "text-rose-300", label: "Abgleich fehlgeschlagen" },
|
||||||
|
};
|
||||||
@@ -0,0 +1,82 @@
|
|||||||
|
import { describe, expect, it } from "vitest";
|
||||||
|
import { renderToStaticMarkup } from "react-dom/server";
|
||||||
|
import type { Task } from "@prisma/client";
|
||||||
|
import { TaskCard } from "./TaskCard";
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Die Karte ist die einzige Stelle im Projekt, an der eine Aufgabe im
|
||||||
|
* Vorbeigehen zu sehen ist – der Bearbeiten-Dialog verlangt einen Klick.
|
||||||
|
* Steht die Verknuepfung nur dort, weiss niemand vorher, welche Aufgabe
|
||||||
|
* ein Issue hat.
|
||||||
|
*
|
||||||
|
* Serverseitig gerendert wie bei Markdown.test.tsx: es geht um das
|
||||||
|
* erzeugte Markup, nicht um Verhalten im Browser.
|
||||||
|
*/
|
||||||
|
function aufgabe(felder: Partial<Task> = {}): Task {
|
||||||
|
return {
|
||||||
|
id: "t1",
|
||||||
|
projectId: "p1",
|
||||||
|
title: "Etwas tun",
|
||||||
|
description: null,
|
||||||
|
status: "TODO",
|
||||||
|
position: 0,
|
||||||
|
dueDate: null,
|
||||||
|
labels: [],
|
||||||
|
recurrence: null,
|
||||||
|
sourceIssue: null,
|
||||||
|
sourceUrl: null,
|
||||||
|
sourceRepositoryId: null,
|
||||||
|
createdAt: new Date("2026-08-18T10:00:00Z"),
|
||||||
|
updatedAt: new Date("2026-08-18T10:00:00Z"),
|
||||||
|
...felder,
|
||||||
|
} as Task;
|
||||||
|
}
|
||||||
|
|
||||||
|
const markup = (task: Task) => renderToStaticMarkup(<TaskCard task={task} />);
|
||||||
|
|
||||||
|
describe("Kennzeichen fuer ein verknuepftes Issue", () => {
|
||||||
|
it("zeigt die Nummer, sobald eine Aufgabe an einem Issue haengt", () => {
|
||||||
|
const html = markup(aufgabe({ sourceIssue: 42 }));
|
||||||
|
expect(html).toContain("#42");
|
||||||
|
expect(html).toContain("Verkn");
|
||||||
|
});
|
||||||
|
|
||||||
|
it("erscheint auch ohne Beschreibung, Datum und Labels", () => {
|
||||||
|
// Der eigentliche Fallstrick: die Fusszeile der Karte wird nur
|
||||||
|
// gerendert, wenn es etwas zu zeigen gibt. Faellt die Verknuepfung aus
|
||||||
|
// dieser Bedingung heraus, bleibt genau die nackte Aufgabe unbeschriftet
|
||||||
|
// – und das ist der haeufige Fall bei einer aus einem Issue erzeugten.
|
||||||
|
const html = markup(
|
||||||
|
aufgabe({ sourceIssue: 7, description: null, dueDate: null, labels: [], recurrence: null }),
|
||||||
|
);
|
||||||
|
expect(html).toContain("#7");
|
||||||
|
});
|
||||||
|
|
||||||
|
it("bleibt weg, wenn keine Verknuepfung besteht", () => {
|
||||||
|
const html = markup(aufgabe({ description: "Text" }));
|
||||||
|
expect(html).not.toContain("Verkn");
|
||||||
|
});
|
||||||
|
|
||||||
|
it("bleibt auf einer erledigten Aufgabe sichtbar", () => {
|
||||||
|
// Die erledigte Karte streicht ihren Titel durch; das Kennzeichen bleibt
|
||||||
|
// in voller Helligkeit. Abzudunkeln war versucht und wieder verworfen –
|
||||||
|
// axe-core rechnete es als Kontrastverstoss ab (10px Text, 3,2:1).
|
||||||
|
// Dass hier ein Issue mitgeschlossen wurde, ist ohnehin gerade dann die
|
||||||
|
// interessante Auskunft.
|
||||||
|
const html = markup(aufgabe({ sourceIssue: 5, status: "DONE" }));
|
||||||
|
expect(html).toContain("#5");
|
||||||
|
});
|
||||||
|
|
||||||
|
it("baut keinen Link in die Karte", () => {
|
||||||
|
// Die Karte steckt in einem <button>; ein <a> darin waere ungueltiges
|
||||||
|
// Markup und im Browser nicht verlaesslich anklickbar.
|
||||||
|
const html = markup(aufgabe({ sourceIssue: 42, sourceUrl: "https://example.com/issues/42" }));
|
||||||
|
expect(html).not.toContain("<a ");
|
||||||
|
});
|
||||||
|
|
||||||
|
it("nennt die Verknuepfung auch fuer Vorlesesoftware", () => {
|
||||||
|
// "#42" allein ergibt vorgelesen keinen Sinn.
|
||||||
|
const html = markup(aufgabe({ sourceIssue: 42 }));
|
||||||
|
expect(html).toMatch(/sr-only[^>]*>Verkn/);
|
||||||
|
});
|
||||||
|
});
|
||||||
@@ -1,6 +1,12 @@
|
|||||||
"use client";
|
"use client";
|
||||||
|
|
||||||
import { AlignLeft, CalendarClock, GripVertical, Repeat } from "lucide-react";
|
import {
|
||||||
|
AlignLeft,
|
||||||
|
CalendarClock,
|
||||||
|
GitPullRequestArrow,
|
||||||
|
GripVertical,
|
||||||
|
Repeat,
|
||||||
|
} from "lucide-react";
|
||||||
import type { Task } from "@prisma/client";
|
import type { Task } from "@prisma/client";
|
||||||
import { RECURRENCE_META } from "@/lib/tasks";
|
import { RECURRENCE_META } from "@/lib/tasks";
|
||||||
import { cn, formatDate } from "@/lib/utils";
|
import { cn, formatDate } from "@/lib/utils";
|
||||||
@@ -70,8 +76,26 @@ export function TaskCard({
|
|||||||
{task.title}
|
{task.title}
|
||||||
</p>
|
</p>
|
||||||
|
|
||||||
{(task.description || task.dueDate || task.recurrence || task.labels.length > 0) && (
|
{(task.description ||
|
||||||
|
task.dueDate ||
|
||||||
|
task.recurrence ||
|
||||||
|
task.sourceIssue ||
|
||||||
|
task.labels.length > 0) && (
|
||||||
<div className="mt-1.5 flex flex-wrap items-center gap-x-2 gap-y-1 text-[10px]">
|
<div className="mt-1.5 flex flex-wrap items-center gap-x-2 gap-y-1 text-[10px]">
|
||||||
|
{/* Steht vorn, damit sich eine Spalte danach ueberfliegen laesst.
|
||||||
|
Bewusst kein Link: die Karte steckt in einem <button>, und ein
|
||||||
|
<a> darin waere ungueltig. Der Weg zum Issue fuehrt ueber den
|
||||||
|
Bearbeiten-Dialog, der ihn ohnehin anbietet. */}
|
||||||
|
{task.sourceIssue ? (
|
||||||
|
<span
|
||||||
|
className="inline-flex items-center gap-1 text-violet-300"
|
||||||
|
title={`Verknüpft mit Issue #${task.sourceIssue}`}
|
||||||
|
>
|
||||||
|
<GitPullRequestArrow className="h-2.5 w-2.5" aria-hidden />
|
||||||
|
<span className="sr-only">Verknüpft mit </span>#{task.sourceIssue}
|
||||||
|
</span>
|
||||||
|
) : null}
|
||||||
|
|
||||||
{task.description ? (
|
{task.description ? (
|
||||||
<AlignLeft className="h-2.5 w-2.5 text-slate-600" aria-label="hat Beschreibung" />
|
<AlignLeft className="h-2.5 w-2.5 text-slate-600" aria-label="hat Beschreibung" />
|
||||||
) : null}
|
) : null}
|
||||||
|
|||||||
@@ -10,7 +10,9 @@ import {
|
|||||||
Loader2,
|
Loader2,
|
||||||
Plus,
|
Plus,
|
||||||
Repeat,
|
Repeat,
|
||||||
|
Search,
|
||||||
Square,
|
Square,
|
||||||
|
X,
|
||||||
} from "lucide-react";
|
} from "lucide-react";
|
||||||
import type { TaskStatus } from "@prisma/client";
|
import type { TaskStatus } from "@prisma/client";
|
||||||
import { QuickCapture } from "@/components/QuickCapture";
|
import { QuickCapture } from "@/components/QuickCapture";
|
||||||
@@ -42,6 +44,7 @@ export function TaskOverview({ tasks }: { tasks: TaskOverviewItem[] }) {
|
|||||||
const router = useRouter();
|
const router = useRouter();
|
||||||
const [statusFilter, setStatusFilter] = useState<TaskStatus[]>([]);
|
const [statusFilter, setStatusFilter] = useState<TaskStatus[]>([]);
|
||||||
const [projektFilter, setProjektFilter] = useState("");
|
const [projektFilter, setProjektFilter] = useState("");
|
||||||
|
const [suche, setSuche] = useState("");
|
||||||
const [zeigeErledigte, setZeigeErledigte] = useState(false);
|
const [zeigeErledigte, setZeigeErledigte] = useState(false);
|
||||||
const [erfassenOffen, setErfassenOffen] = useState(false);
|
const [erfassenOffen, setErfassenOffen] = useState(false);
|
||||||
const [laufend, setLaufend] = useState<Set<string>>(new Set());
|
const [laufend, setLaufend] = useState<Set<string>>(new Set());
|
||||||
@@ -63,16 +66,34 @@ export function TaskOverview({ tasks }: { tasks: TaskOverviewItem[] }) {
|
|||||||
}, [tasks]);
|
}, [tasks]);
|
||||||
|
|
||||||
const sichtbar = useMemo(() => {
|
const sichtbar = useMemo(() => {
|
||||||
|
const nadel = suche.toLowerCase().trim();
|
||||||
|
|
||||||
return tasks.filter((task) => {
|
return tasks.filter((task) => {
|
||||||
// Erledigtes fuellt die Liste sonst mit dem, was gerade nicht ansteht.
|
// Erledigtes fuellt die Liste sonst mit dem, was gerade nicht ansteht.
|
||||||
if (!zeigeErledigte && task.status === "DONE" && !statusFilter.includes("DONE")) {
|
// Wer allerdings sucht, sucht auch in Erledigtem – sonst findet man
|
||||||
|
// die Aufgabe von letzter Woche nicht wieder.
|
||||||
|
if (
|
||||||
|
!zeigeErledigte &&
|
||||||
|
!nadel &&
|
||||||
|
task.status === "DONE" &&
|
||||||
|
!statusFilter.includes("DONE")
|
||||||
|
) {
|
||||||
return false;
|
return false;
|
||||||
}
|
}
|
||||||
if (statusFilter.length > 0 && !statusFilter.includes(task.status)) return false;
|
if (statusFilter.length > 0 && !statusFilter.includes(task.status)) return false;
|
||||||
if (projektFilter && task.project.id !== projektFilter) return false;
|
if (projektFilter && task.project.id !== projektFilter) return false;
|
||||||
return true;
|
if (!nadel) return true;
|
||||||
|
|
||||||
|
// Die Aufgaben liegen hier ohnehin alle vor – das filtert ohne
|
||||||
|
// zusaetzliche Abfrage und ohne Verzoegerung beim Tippen.
|
||||||
|
return (
|
||||||
|
task.title.toLowerCase().includes(nadel) ||
|
||||||
|
(task.description ?? "").toLowerCase().includes(nadel) ||
|
||||||
|
task.labels.some((label) => label.toLowerCase().includes(nadel)) ||
|
||||||
|
task.project.name.toLowerCase().includes(nadel)
|
||||||
|
);
|
||||||
});
|
});
|
||||||
}, [tasks, statusFilter, projektFilter, zeigeErledigte]);
|
}, [tasks, statusFilter, projektFilter, zeigeErledigte, suche]);
|
||||||
|
|
||||||
const faecher = useMemo(() => {
|
const faecher = useMemo(() => {
|
||||||
return DUE_BUCKET_ORDER.map((bucket) => ({
|
return DUE_BUCKET_ORDER.map((bucket) => ({
|
||||||
@@ -155,6 +176,27 @@ export function TaskOverview({ tasks }: { tasks: TaskOverviewItem[] }) {
|
|||||||
|
|
||||||
{/* Steuerleiste */}
|
{/* Steuerleiste */}
|
||||||
<div className="glass flex flex-col gap-3 p-3 sm:p-4">
|
<div className="glass flex flex-col gap-3 p-3 sm:p-4">
|
||||||
|
<div className="relative">
|
||||||
|
<Search className="pointer-events-none absolute left-3 top-1/2 h-4 w-4 -translate-y-1/2 text-slate-500" />
|
||||||
|
<input
|
||||||
|
className="field pl-9"
|
||||||
|
placeholder="Aufgaben durchsuchen – Titel, Beschreibung, Labels…"
|
||||||
|
value={suche}
|
||||||
|
onChange={(event) => setSuche(event.target.value)}
|
||||||
|
aria-label="Aufgaben durchsuchen"
|
||||||
|
/>
|
||||||
|
{suche ? (
|
||||||
|
<button
|
||||||
|
type="button"
|
||||||
|
onClick={() => setSuche("")}
|
||||||
|
className="absolute right-2 top-1/2 -translate-y-1/2 rounded p-1 text-slate-500 hover:text-white"
|
||||||
|
aria-label="Suche zuruecksetzen"
|
||||||
|
>
|
||||||
|
<X className="h-3.5 w-3.5" />
|
||||||
|
</button>
|
||||||
|
) : null}
|
||||||
|
</div>
|
||||||
|
|
||||||
<div className="flex flex-wrap items-center gap-2">
|
<div className="flex flex-wrap items-center gap-2">
|
||||||
{TASK_STATUS_ORDER.map((status) => {
|
{TASK_STATUS_ORDER.map((status) => {
|
||||||
const meta = TASK_STATUS_META[status];
|
const meta = TASK_STATUS_META[status];
|
||||||
@@ -220,11 +262,17 @@ export function TaskOverview({ tasks }: { tasks: TaskOverviewItem[] }) {
|
|||||||
</span>
|
</span>
|
||||||
<div>
|
<div>
|
||||||
<h2 className="text-lg font-semibold text-white">
|
<h2 className="text-lg font-semibold text-white">
|
||||||
{tasks.length === 0 ? "Noch keine Aufgaben" : "Nichts offen"}
|
{tasks.length === 0
|
||||||
|
? "Noch keine Aufgaben"
|
||||||
|
: suche.trim()
|
||||||
|
? "Keine Treffer"
|
||||||
|
: "Nichts offen"}
|
||||||
</h2>
|
</h2>
|
||||||
<p className="mt-1 max-w-md text-sm text-slate-400">
|
<p className="mt-1 max-w-md text-sm text-slate-400">
|
||||||
{tasks.length === 0
|
{tasks.length === 0
|
||||||
? "Aufgaben entstehen im Projekt oder hier über „Neue Aufgabe“."
|
? "Aufgaben entstehen im Projekt oder hier über „Neue Aufgabe“."
|
||||||
|
: suche.trim()
|
||||||
|
? `Keine Aufgabe passt zu „${suche.trim()}“ – gesucht wird in Titel, Beschreibung, Labels und Projektname.`
|
||||||
: "Alles abgehakt, was zu den Filtern passt."}
|
: "Alles abgehakt, was zu den Filtern passt."}
|
||||||
</p>
|
</p>
|
||||||
</div>
|
</div>
|
||||||
|
|||||||
@@ -41,6 +41,72 @@ export const KIND_META: Record<ChangeKind, { label: string; className: string }>
|
|||||||
};
|
};
|
||||||
|
|
||||||
export const CHANGELOG: Release[] = [
|
export const CHANGELOG: Release[] = [
|
||||||
|
{
|
||||||
|
version: "1.10.1",
|
||||||
|
date: "2026-08-18",
|
||||||
|
headline: "Sichtbar, welche Aufgabe ein Issue hat — und nachlesbar, was ein Token dafür braucht.",
|
||||||
|
changes: [
|
||||||
|
{
|
||||||
|
kind: "neu",
|
||||||
|
text:
|
||||||
|
"Auf dem Aufgabenbrett eines Projekts trägt eine Karte die Nummer ihres " +
|
||||||
|
"verknüpften Git-Issues. Bisher stand die Verknüpfung nur im Bearbeiten-Dialog " +
|
||||||
|
"und in der projektübergreifenden Übersicht — welche Aufgabe schon ein Issue " +
|
||||||
|
"hat, war im Vorbeigehen nicht zu sehen.",
|
||||||
|
},
|
||||||
|
{
|
||||||
|
kind: "besser",
|
||||||
|
text:
|
||||||
|
"Die Rechte einer Git-Verbindung stehen jetzt Aufruf für Aufruf in der README: " +
|
||||||
|
"je System eine Tabelle aus Endpunkt, Zweck und benötigtem Recht. Getrennt nach " +
|
||||||
|
"reinem Abgleich und zusätzlicher Issue-Anbindung, damit erkennbar ist, was sich " +
|
||||||
|
"weglassen lässt. Bei GitLab ist belegt, dass es unterhalb von „api“ keinen " +
|
||||||
|
"Schreibzugriff auf Issues gibt.",
|
||||||
|
},
|
||||||
|
{
|
||||||
|
kind: "behoben",
|
||||||
|
text:
|
||||||
|
"Der Hinweis unter dem Token-Feld nannte die Rechte für Actions nicht, obwohl " +
|
||||||
|
"der CI-Zustand bei GitHub genau daran hängt. Wer sich daran hielt, sah keinen " +
|
||||||
|
"Build-Status.",
|
||||||
|
},
|
||||||
|
],
|
||||||
|
},
|
||||||
|
{
|
||||||
|
version: "1.10.0",
|
||||||
|
date: "2026-08-18",
|
||||||
|
headline: "Rückblick, Zeitleiste und eine Suche, die auch Aufgaben findet.",
|
||||||
|
changes: [
|
||||||
|
{
|
||||||
|
kind: "neu",
|
||||||
|
text:
|
||||||
|
"Wochenrückblick über alle Projekte: Kennzahlen der Woche und darunter die " +
|
||||||
|
"Vorgänge nach Tagen gebündelt. Blättern in frühere Wochen inbegriffen. " +
|
||||||
|
"Erreichbar über die Schnellsuche und einen Verweis vom Dashboard.",
|
||||||
|
},
|
||||||
|
{
|
||||||
|
kind: "neu",
|
||||||
|
text:
|
||||||
|
"Globale Zeitleiste: derselbe Verlauf, aber fortlaufend und ohne Wochengrenze, " +
|
||||||
|
"mit Nachladen älterer Einträge. Geblättert wird per Cursor — bei mehreren " +
|
||||||
|
"Einträgen im selben Augenblick verliert oder verdoppelt das keine Zeilen.",
|
||||||
|
},
|
||||||
|
{
|
||||||
|
kind: "neu",
|
||||||
|
text:
|
||||||
|
"Das Aufgabendashboard hat ein Suchfeld über Titel, Beschreibung, Labels und " +
|
||||||
|
"Projektname. Wer sucht, sucht dabei auch in Erledigtem — sonst findet man die " +
|
||||||
|
"Aufgabe von letzter Woche nicht wieder.",
|
||||||
|
},
|
||||||
|
{
|
||||||
|
kind: "besser",
|
||||||
|
text:
|
||||||
|
"Die Volltextsuche kannte bisher nur Notizen und findet jetzt auch Aufgaben — " +
|
||||||
|
"mit denselben deutschen Stammformen: „Rechnung“ findet „Rechnungen“. Treffer " +
|
||||||
|
"erscheinen im Projektbrett und in der Schnellsuche.",
|
||||||
|
},
|
||||||
|
],
|
||||||
|
},
|
||||||
{
|
{
|
||||||
version: "1.9.0",
|
version: "1.9.0",
|
||||||
date: "2026-08-17",
|
date: "2026-08-17",
|
||||||
|
|||||||
@@ -0,0 +1,60 @@
|
|||||||
|
import { describe, expect, it } from "vitest";
|
||||||
|
import { PROVIDER_META, guessProvider } from "./meta";
|
||||||
|
|
||||||
|
const PROVIDER = ["GITHUB", "GITLAB", "GITEA"] as const;
|
||||||
|
|
||||||
|
describe("PROVIDER_META", () => {
|
||||||
|
it("kennt jedes unterstuetzte System", () => {
|
||||||
|
for (const provider of PROVIDER) {
|
||||||
|
expect(PROVIDER_META[provider], provider).toBeDefined();
|
||||||
|
}
|
||||||
|
// Und nichts darueber hinaus – ein Eintrag ohne Gegenstueck im Schema
|
||||||
|
// waere ein Ueberbleibsel.
|
||||||
|
expect(Object.keys(PROVIDER_META).sort()).toEqual([...PROVIDER].sort());
|
||||||
|
});
|
||||||
|
|
||||||
|
it("hat zu jedem System Beschriftung, Basis-URL und Dokuverweis", () => {
|
||||||
|
for (const provider of PROVIDER) {
|
||||||
|
const meta = PROVIDER_META[provider];
|
||||||
|
expect(meta.label.length, provider).toBeGreaterThan(0);
|
||||||
|
expect(meta.defaultBaseUrl, provider).toMatch(/^https:\/\//);
|
||||||
|
expect(meta.docsUrl, provider).toMatch(/^https:\/\//);
|
||||||
|
}
|
||||||
|
});
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Der eigentliche Waechter.
|
||||||
|
*
|
||||||
|
* Der Hinweis am Eingabefeld war eine Zeit lang rein lesend formuliert,
|
||||||
|
* obwohl Nebula seit v1.7.0 Issues anlegt und schliesst – wer sich daran
|
||||||
|
* hielt, bekam einen 403. Jeder Provider in GitClient muss createIssue und
|
||||||
|
* setIssueState koennen; folglich muss auch jeder Hinweis sagen, was das
|
||||||
|
* an Rechten kostet.
|
||||||
|
*/
|
||||||
|
it("sagt bei jedem System etwas ueber die Rechte fuer Issues", () => {
|
||||||
|
for (const provider of PROVIDER) {
|
||||||
|
expect(PROVIDER_META[provider].tokenHelp, provider).toMatch(/issue/i);
|
||||||
|
}
|
||||||
|
});
|
||||||
|
|
||||||
|
it("nennt einen konkreten Scope statt nur 'Leserechte'", () => {
|
||||||
|
// GitLab nennt Scopes in Anfuehrungszeichen, GitHub und Gitea
|
||||||
|
// Berechtigungsnamen – gemeinsam ist, dass etwas Nachschlagbares dasteht.
|
||||||
|
expect(PROVIDER_META.GITLAB.tokenHelp).toMatch(/read_api/);
|
||||||
|
expect(PROVIDER_META.GITEA.tokenHelp).toMatch(/read:repository/);
|
||||||
|
expect(PROVIDER_META.GITHUB.tokenHelp).toMatch(/Metadata/);
|
||||||
|
});
|
||||||
|
});
|
||||||
|
|
||||||
|
describe("guessProvider", () => {
|
||||||
|
it("erkennt die oeffentlichen Instanzen am Hostnamen", () => {
|
||||||
|
expect(guessProvider("github.com")).toBe("GITHUB");
|
||||||
|
expect(guessProvider("gitlab.com")).toBe("GITLAB");
|
||||||
|
});
|
||||||
|
|
||||||
|
it("faellt bei allem anderen auf Gitea zurueck", () => {
|
||||||
|
// Selbst gehostet ist hier der haeufigste Fall, und Gitea die
|
||||||
|
// wahrscheinlichste Wahl dafuer.
|
||||||
|
expect(guessProvider("git.wilde-server.de")).toBe("GITEA");
|
||||||
|
});
|
||||||
|
});
|
||||||
+9
-3
@@ -12,19 +12,25 @@ export const PROVIDER_META: Record<
|
|||||||
label: "GitHub",
|
label: "GitHub",
|
||||||
defaultBaseUrl: "https://github.com",
|
defaultBaseUrl: "https://github.com",
|
||||||
tokenHelp:
|
tokenHelp:
|
||||||
"Fine-grained Token mit Lesezugriff auf Contents, Metadata, Issues und Pull Requests.",
|
"Fine-grained Token, alle nur lesend: Metadata, Contents, Issues, Pull requests " +
|
||||||
|
"und Actions. Nur wenn Aufgaben als Issue angelegt werden sollen, Issues " +
|
||||||
|
"zusaetzlich schreiben.",
|
||||||
docsUrl: "https://github.com/settings/tokens",
|
docsUrl: "https://github.com/settings/tokens",
|
||||||
},
|
},
|
||||||
GITLAB: {
|
GITLAB: {
|
||||||
label: "GitLab",
|
label: "GitLab",
|
||||||
defaultBaseUrl: "https://gitlab.com",
|
defaultBaseUrl: "https://gitlab.com",
|
||||||
tokenHelp: "Personal Access Token mit Scope 'read_api' (bzw. 'read_repository').",
|
tokenHelp:
|
||||||
|
"Scope 'read_api' genuegt fuer den Abgleich. Aufgaben als Issue anzulegen verlangt " +
|
||||||
|
"'api' – GitLab kennt keinen schmaleren Schreibzugriff.",
|
||||||
docsUrl: "https://gitlab.com/-/user_settings/personal_access_tokens",
|
docsUrl: "https://gitlab.com/-/user_settings/personal_access_tokens",
|
||||||
},
|
},
|
||||||
GITEA: {
|
GITEA: {
|
||||||
label: "Gitea / Forgejo",
|
label: "Gitea / Forgejo",
|
||||||
defaultBaseUrl: "https://git.example.com",
|
defaultBaseUrl: "https://git.example.com",
|
||||||
tokenHelp: "Access Token mit Leserechten auf repository, issue und user.",
|
tokenHelp:
|
||||||
|
"read:repository, read:issue und read:user. Nur wenn Aufgaben als Issue angelegt " +
|
||||||
|
"werden sollen, zusaetzlich write:issue.",
|
||||||
docsUrl: "https://docs.gitea.com/development/api-usage",
|
docsUrl: "https://docs.gitea.com/development/api-usage",
|
||||||
},
|
},
|
||||||
};
|
};
|
||||||
|
|||||||
@@ -0,0 +1,60 @@
|
|||||||
|
import { readFileSync } from "node:fs";
|
||||||
|
import { join } from "node:path";
|
||||||
|
import { describe, expect, it } from "vitest";
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Waechter ueber eine Zusage in der Dokumentation.
|
||||||
|
*
|
||||||
|
* README und FEATURES sagen zu, dass Nebula an genau zwei Stellen nach
|
||||||
|
* draussen schreibt: ein Issue anlegen und seinen Zustand umsetzen. Auf
|
||||||
|
* dieser Zusage steht die Empfehlung, ein rein lesendes Token zu vergeben,
|
||||||
|
* solange die Issue-Anbindung nicht gebraucht wird.
|
||||||
|
*
|
||||||
|
* Kaeme ein dritter Schreibaufruf dazu, wuerde die Empfehlung still falsch:
|
||||||
|
* niemand bekaeme einen Fehler, nur ein 403 an einer Stelle, die laut
|
||||||
|
* Dokumentation gar nicht schreibt. Deshalb wird hier der Quelltext selbst
|
||||||
|
* abgeklopft – sendJson ist der einzige Weg aus lib/git heraus, der eine
|
||||||
|
* andere Methode als GET benutzt (siehe http.ts).
|
||||||
|
*/
|
||||||
|
const CLIENTS = ["gitea.ts", "github.ts", "gitlab.ts"] as const;
|
||||||
|
|
||||||
|
/** Die Zeile ueber dem Methoden-Argument nennt den Endpunkt. */
|
||||||
|
function schreibaufrufe(quelltext: string): string[] {
|
||||||
|
const zeilen = quelltext.split("\n");
|
||||||
|
const gefunden: string[] = [];
|
||||||
|
zeilen.forEach((zeile, i) => {
|
||||||
|
if (!/\bsendJson[<(]/.test(zeile)) return;
|
||||||
|
// sendJson(url, METHODE, …) – Endpunkt und Methode stehen darunter.
|
||||||
|
const block = zeilen.slice(i, i + 4).join(" ");
|
||||||
|
const methode = block.match(/"(POST|PATCH|PUT)"/)?.[1];
|
||||||
|
const pfad = block.match(/\/issues[^`"']*/)?.[0] ?? "?";
|
||||||
|
gefunden.push(`${methode ?? "?"} ${pfad}`);
|
||||||
|
});
|
||||||
|
return gefunden;
|
||||||
|
}
|
||||||
|
|
||||||
|
describe("Schreibzugriffe nach draussen", () => {
|
||||||
|
it("beschraenken sich auf Issues anlegen und Zustand setzen", () => {
|
||||||
|
for (const datei of CLIENTS) {
|
||||||
|
const quelltext = readFileSync(join(__dirname, datei), "utf8");
|
||||||
|
const aufrufe = schreibaufrufe(quelltext);
|
||||||
|
|
||||||
|
expect(aufrufe.length, `${datei}: Anzahl Schreibaufrufe`).toBe(2);
|
||||||
|
for (const aufruf of aufrufe) {
|
||||||
|
expect(aufruf, `${datei}: ${aufruf}`).toMatch(/^(POST|PATCH|PUT) \/issues/);
|
||||||
|
}
|
||||||
|
// Genau einer legt an, genau einer setzt um.
|
||||||
|
expect(aufrufe.filter((a) => a.startsWith("POST")).length, datei).toBe(1);
|
||||||
|
expect(aufrufe.filter((a) => /^(PATCH|PUT)/.test(a)).length, datei).toBe(1);
|
||||||
|
}
|
||||||
|
});
|
||||||
|
|
||||||
|
it("laufen ueber sendJson, nicht an http.ts vorbei", () => {
|
||||||
|
// Ein direkter fetch in einem Client haette weder SSRF-Schutz noch
|
||||||
|
// Zeitbegrenzung – und wuerde am Waechter oben vorbeilaufen.
|
||||||
|
for (const datei of CLIENTS) {
|
||||||
|
const quelltext = readFileSync(join(__dirname, datei), "utf8");
|
||||||
|
expect(quelltext, datei).not.toMatch(/\bfetch\s*\(/);
|
||||||
|
}
|
||||||
|
});
|
||||||
|
});
|
||||||
@@ -0,0 +1,173 @@
|
|||||||
|
import { describe, expect, it } from "vitest";
|
||||||
|
import {
|
||||||
|
berlinMitternacht,
|
||||||
|
tagesschluessel,
|
||||||
|
wocheUm,
|
||||||
|
wochenName,
|
||||||
|
wochenTitel,
|
||||||
|
zaehleWoche,
|
||||||
|
} from "./review";
|
||||||
|
|
||||||
|
describe("tagesschluessel", () => {
|
||||||
|
it("rechnet in Berliner Kalendertagen, nicht in UTC", () => {
|
||||||
|
// 22:30 UTC ist in Berlin schon der Folgetag (Sommerzeit, UTC+2).
|
||||||
|
expect(tagesschluessel(new Date("2026-08-17T22:30:00Z"))).toBe("2026-08-18");
|
||||||
|
expect(tagesschluessel(new Date("2026-08-17T21:00:00Z"))).toBe("2026-08-17");
|
||||||
|
});
|
||||||
|
});
|
||||||
|
|
||||||
|
describe("berlinMitternacht", () => {
|
||||||
|
it("trifft den Sommerzeit-Beginn des Tages", () => {
|
||||||
|
// Sommerzeit: Berlin = UTC+2, Mitternacht dort ist 22:00 UTC am Vortag.
|
||||||
|
expect(berlinMitternacht("2026-08-17").toISOString()).toBe("2026-08-16T22:00:00.000Z");
|
||||||
|
});
|
||||||
|
|
||||||
|
it("trifft den Winterzeit-Beginn des Tages", () => {
|
||||||
|
// Winterzeit: UTC+1.
|
||||||
|
expect(berlinMitternacht("2026-01-12").toISOString()).toBe("2026-01-11T23:00:00.000Z");
|
||||||
|
});
|
||||||
|
});
|
||||||
|
|
||||||
|
describe("wocheUm", () => {
|
||||||
|
/** Ein Dienstag. */
|
||||||
|
const DIENSTAG = new Date("2026-08-18T09:00:00Z");
|
||||||
|
|
||||||
|
it("beginnt am Montag und endet am folgenden Montag", () => {
|
||||||
|
const woche = wocheUm(DIENSTAG);
|
||||||
|
expect(woche.tage[0]).toBe("2026-08-17");
|
||||||
|
expect(woche.tage[6]).toBe("2026-08-23");
|
||||||
|
expect(woche.tage).toHaveLength(7);
|
||||||
|
expect(woche.von.toISOString()).toBe("2026-08-16T22:00:00.000Z");
|
||||||
|
expect(woche.bis.toISOString()).toBe("2026-08-23T22:00:00.000Z");
|
||||||
|
});
|
||||||
|
|
||||||
|
it("zaehlt den Montag selbst zur laufenden Woche", () => {
|
||||||
|
const montag = new Date("2026-08-17T06:00:00Z");
|
||||||
|
expect(wocheUm(montag).tage[0]).toBe("2026-08-17");
|
||||||
|
});
|
||||||
|
|
||||||
|
it("zaehlt den Sonntagabend noch zur ablaufenden Woche", () => {
|
||||||
|
// 21:00 UTC am Sonntag ist in Berlin 23:00 – noch derselbe Tag.
|
||||||
|
const sonntagAbend = new Date("2026-08-23T21:00:00Z");
|
||||||
|
expect(wocheUm(sonntagAbend).tage[0]).toBe("2026-08-17");
|
||||||
|
// Zwei Stunden spaeter ist Montag und damit die naechste Woche.
|
||||||
|
const montagFrueh = new Date("2026-08-23T22:30:00Z");
|
||||||
|
expect(wocheUm(montagFrueh).tage[0]).toBe("2026-08-24");
|
||||||
|
});
|
||||||
|
|
||||||
|
it("blättert rückwärts", () => {
|
||||||
|
expect(wocheUm(DIENSTAG, -1).tage[0]).toBe("2026-08-10");
|
||||||
|
expect(wocheUm(DIENSTAG, -3).tage[0]).toBe("2026-07-27");
|
||||||
|
});
|
||||||
|
|
||||||
|
it("kommt über den Monats- und Jahreswechsel", () => {
|
||||||
|
const neujahr = new Date("2027-01-01T12:00:00Z"); // ein Freitag
|
||||||
|
const woche = wocheUm(neujahr);
|
||||||
|
expect(woche.tage[0]).toBe("2026-12-28");
|
||||||
|
expect(woche.tage[6]).toBe("2027-01-03");
|
||||||
|
});
|
||||||
|
|
||||||
|
it("bleibt über die Zeitumstellung hinweg sieben Tage lang", () => {
|
||||||
|
// Am 25.10.2026 wird auf Winterzeit zurueckgestellt – die Woche hat
|
||||||
|
// dann 169 Stunden. "von + 7 Tage" waere hier eine Stunde daneben.
|
||||||
|
const inDerWoche = new Date("2026-10-21T12:00:00Z");
|
||||||
|
const woche = wocheUm(inDerWoche);
|
||||||
|
expect(woche.tage[0]).toBe("2026-10-19");
|
||||||
|
expect(woche.tage[6]).toBe("2026-10-25");
|
||||||
|
const stunden = (woche.bis.getTime() - woche.von.getTime()) / 3_600_000;
|
||||||
|
expect(stunden).toBe(169);
|
||||||
|
});
|
||||||
|
|
||||||
|
it("liefert bei der Umstellung im Fruehjahr 167 Stunden", () => {
|
||||||
|
// Vorgestellt wird am letzten Sonntag im Maerz – 2026 ist das der 29.,
|
||||||
|
// er liegt also in der Woche ab Montag, dem 23.
|
||||||
|
const inDerWoche = new Date("2026-03-25T12:00:00Z");
|
||||||
|
const woche = wocheUm(inDerWoche);
|
||||||
|
expect(woche.tage[0]).toBe("2026-03-23");
|
||||||
|
expect(woche.tage[6]).toBe("2026-03-29");
|
||||||
|
const stunden = (woche.bis.getTime() - woche.von.getTime()) / 3_600_000;
|
||||||
|
expect(stunden).toBe(167);
|
||||||
|
});
|
||||||
|
|
||||||
|
it("hat in einer Woche ohne Umstellung genau 168 Stunden", () => {
|
||||||
|
const woche = wocheUm(new Date("2026-03-31T12:00:00Z"));
|
||||||
|
expect(woche.tage[0]).toBe("2026-03-30");
|
||||||
|
expect((woche.bis.getTime() - woche.von.getTime()) / 3_600_000).toBe(168);
|
||||||
|
});
|
||||||
|
});
|
||||||
|
|
||||||
|
describe("Beschriftung", () => {
|
||||||
|
const DIENSTAG = new Date("2026-08-18T09:00:00Z");
|
||||||
|
|
||||||
|
it("nennt die laufende und die vorige Woche beim Namen", () => {
|
||||||
|
expect(wochenName(wocheUm(DIENSTAG))).toBe("Diese Woche");
|
||||||
|
expect(wochenName(wocheUm(DIENSTAG, -1))).toBe("Vorige Woche");
|
||||||
|
});
|
||||||
|
|
||||||
|
it("nennt weiter zurueckliegende Wochen mit Zeitraum", () => {
|
||||||
|
expect(wochenName(wocheUm(DIENSTAG, -2))).toMatch(/\d/);
|
||||||
|
});
|
||||||
|
|
||||||
|
it("nennt den Monat nur einmal, wenn die Woche nicht darueber hinausgeht", () => {
|
||||||
|
expect(wochenTitel(wocheUm(DIENSTAG))).toBe("17.–23. August 2026");
|
||||||
|
});
|
||||||
|
|
||||||
|
it("nennt beide Monate, wenn die Woche sie ueberspannt", () => {
|
||||||
|
// 31.08. bis 06.09.2026.
|
||||||
|
const woche = wocheUm(new Date("2026-09-02T12:00:00Z"));
|
||||||
|
expect(wochenTitel(woche)).toBe("31. August–6. September 2026");
|
||||||
|
});
|
||||||
|
});
|
||||||
|
|
||||||
|
describe("zaehleWoche", () => {
|
||||||
|
const eintrag = (
|
||||||
|
kind: Parameters<typeof zaehleWoche>[0][number]["kind"],
|
||||||
|
projectId: string,
|
||||||
|
meta?: unknown,
|
||||||
|
) => ({ kind, projectId, meta });
|
||||||
|
|
||||||
|
it("zaehlt Erledigtes am meta-Feld, nicht am Text", () => {
|
||||||
|
const zahlen = zaehleWoche([
|
||||||
|
eintrag("TASK_MOVED", "p1", { from: "TODO", to: "DONE" }),
|
||||||
|
// Verschoben, aber nicht erledigt – darf nicht mitzaehlen.
|
||||||
|
eintrag("TASK_MOVED", "p1", { from: "TODO", to: "DOING" }),
|
||||||
|
]);
|
||||||
|
expect(zahlen.erledigt).toBe(1);
|
||||||
|
});
|
||||||
|
|
||||||
|
it("zaehlt einen Eintrag ohne meta nicht als erledigt", () => {
|
||||||
|
// Aeltere Eintraege koennen kein "to" haben. Lieber untertreiben als
|
||||||
|
// eine Zahl behaupten, die aus dem Anzeigetext geraten waere.
|
||||||
|
expect(zaehleWoche([eintrag("TASK_MOVED", "p1")]).erledigt).toBe(0);
|
||||||
|
expect(zaehleWoche([eintrag("TASK_MOVED", "p1", "unsinn")]).erledigt).toBe(0);
|
||||||
|
});
|
||||||
|
|
||||||
|
it("zaehlt neue Aufgaben aus beiden Quellen", () => {
|
||||||
|
const zahlen = zaehleWoche([
|
||||||
|
eintrag("TASK_ADDED", "p1"),
|
||||||
|
eintrag("TASKS_IMPORTED", "p2"),
|
||||||
|
]);
|
||||||
|
expect(zahlen.neueAufgaben).toBe(2);
|
||||||
|
});
|
||||||
|
|
||||||
|
it("zaehlt beruehrte Projekte ohne Dubletten", () => {
|
||||||
|
const zahlen = zaehleWoche([
|
||||||
|
eintrag("NOTE_ADDED", "p1"),
|
||||||
|
eintrag("NOTE_ADDED", "p1"),
|
||||||
|
eintrag("REPO_COMMITS", "p2"),
|
||||||
|
]);
|
||||||
|
expect(zahlen.projekte).toBe(2);
|
||||||
|
expect(zahlen.notizen).toBe(2);
|
||||||
|
expect(zahlen.gesamt).toBe(3);
|
||||||
|
});
|
||||||
|
|
||||||
|
it("kommt mit einer leeren Woche zurecht", () => {
|
||||||
|
expect(zaehleWoche([])).toEqual({
|
||||||
|
gesamt: 0,
|
||||||
|
projekte: 0,
|
||||||
|
erledigt: 0,
|
||||||
|
neueAufgaben: 0,
|
||||||
|
notizen: 0,
|
||||||
|
});
|
||||||
|
});
|
||||||
|
});
|
||||||
@@ -0,0 +1,203 @@
|
|||||||
|
import type { ActivityKind } from "@prisma/client";
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Wochenrueckblick: welche Woche, und was zaehlt darin.
|
||||||
|
*
|
||||||
|
* Die Wochenrechnung steht hier als reine Funktion und nicht in der Seite –
|
||||||
|
* Wochengrenzen sind der Teil, der still falsch wird, und so laesst er sich
|
||||||
|
* pruefen.
|
||||||
|
*/
|
||||||
|
|
||||||
|
/** Wochenbeginn ist Montag, wie in Deutschland ueblich (ISO 8601). */
|
||||||
|
export const WOCHENBEGINN = 1;
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Kalendertag in fester Zeitzone.
|
||||||
|
*
|
||||||
|
* Dieselbe Ueberlegung wie bei den Faelligkeiten in lib/tasks: im Container
|
||||||
|
* laeuft die Anwendung nach UTC. Um 23:30 Berliner Zeit waere dort noch der
|
||||||
|
* Vortag, und ein Eintrag von Sonntagabend fiele in die falsche Woche.
|
||||||
|
*/
|
||||||
|
const TAG_FORMAT = new Intl.DateTimeFormat("en-CA", {
|
||||||
|
timeZone: "Europe/Berlin",
|
||||||
|
year: "numeric",
|
||||||
|
month: "2-digit",
|
||||||
|
day: "2-digit",
|
||||||
|
});
|
||||||
|
|
||||||
|
/** "2026-08-17" in Berliner Zeit. */
|
||||||
|
export function tagesschluessel(wert: Date): string {
|
||||||
|
return TAG_FORMAT.format(wert);
|
||||||
|
}
|
||||||
|
|
||||||
|
/** Wochentag in Berliner Zeit, 0 = Sonntag. */
|
||||||
|
function wochentag(wert: Date): number {
|
||||||
|
const [jahr, monat, tag] = tagesschluessel(wert).split("-").map(Number);
|
||||||
|
return new Date(Date.UTC(jahr, monat - 1, tag)).getUTCDay();
|
||||||
|
}
|
||||||
|
|
||||||
|
export interface Woche {
|
||||||
|
/** Beginn des Montags, als Zeitpunkt fuer die Abfrage. */
|
||||||
|
von: Date;
|
||||||
|
/** Beginn des folgenden Montags – ausschliesslich. */
|
||||||
|
bis: Date;
|
||||||
|
/** 0 = laufende Woche, -1 = vorige, … */
|
||||||
|
versatz: number;
|
||||||
|
/** Die sieben Kalendertage der Woche, Montag zuerst. */
|
||||||
|
tage: string[];
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Grenzen der Woche, in der `jetzt` liegt – um `versatz` Wochen verschoben.
|
||||||
|
*
|
||||||
|
* Gerechnet wird ueber die Kalendertage in Berliner Zeit und dann in UTC
|
||||||
|
* zurueckgerechnet. Der Umweg ist noetig, weil zwischen zwei Montagen eine
|
||||||
|
* Zeitumstellung liegen kann: "sieben mal 24 Stunden" waere dann um eine
|
||||||
|
* Stunde daneben.
|
||||||
|
*/
|
||||||
|
export function wocheUm(jetzt: Date, versatz = 0): Woche {
|
||||||
|
const [jahr, monat, tag] = tagesschluessel(jetzt).split("-").map(Number);
|
||||||
|
const heuteUtc = Date.UTC(jahr, monat - 1, tag);
|
||||||
|
|
||||||
|
// Rueckwaerts bis zum Montag.
|
||||||
|
const abstandZumMontag = (wochentag(jetzt) - WOCHENBEGINN + 7) % 7;
|
||||||
|
const montag = new Date(heuteUtc - (abstandZumMontag - versatz * 7) * 86_400_000);
|
||||||
|
|
||||||
|
const tage: string[] = [];
|
||||||
|
for (let i = 0; i < 7; i += 1) {
|
||||||
|
tage.push(new Date(montag.getTime() + i * 86_400_000).toISOString().slice(0, 10));
|
||||||
|
}
|
||||||
|
|
||||||
|
const von = berlinMitternacht(tage[0]);
|
||||||
|
return {
|
||||||
|
von,
|
||||||
|
// Ende ist die Mitternacht *nach* dem Sonntag – nicht "von + 7 Tage":
|
||||||
|
// liegt eine Zeitumstellung dazwischen, ist die Woche 167 oder 169
|
||||||
|
// Stunden lang.
|
||||||
|
bis: berlinMitternacht(naechsterTag(tage[6])),
|
||||||
|
versatz,
|
||||||
|
tage,
|
||||||
|
};
|
||||||
|
}
|
||||||
|
|
||||||
|
/** Ein Kalendertag weiter, rein auf der Zeichenkette gerechnet. */
|
||||||
|
function naechsterTag(tag: string): string {
|
||||||
|
const [j, m, t] = tag.split("-").map(Number);
|
||||||
|
return new Date(Date.UTC(j, m - 1, t) + 86_400_000).toISOString().slice(0, 10);
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Um wie viel geht die Berliner Uhr zu diesem Zeitpunkt der UTC voraus?
|
||||||
|
*
|
||||||
|
* Ermittelt statt fest verdrahtet, weil zwischen Sommer- und Winterzeit eine
|
||||||
|
* Stunde Unterschied liegt und ein Rueckblick ueber die Umstellung hinweg
|
||||||
|
* sonst um eine Stunde verrutscht.
|
||||||
|
*/
|
||||||
|
function zonenversatzMs(zeitpunkt: Date): number {
|
||||||
|
// sv-SE liefert "2026-08-17 14:30:00" – nah genug an ISO, um es nach dem
|
||||||
|
// Austausch des Leerzeichens wieder einlesen zu koennen.
|
||||||
|
const berlin = new Intl.DateTimeFormat("sv-SE", {
|
||||||
|
timeZone: "Europe/Berlin",
|
||||||
|
dateStyle: "short",
|
||||||
|
timeStyle: "medium",
|
||||||
|
}).format(zeitpunkt);
|
||||||
|
return Date.parse(`${berlin.replace(" ", "T")}Z`) - zeitpunkt.getTime();
|
||||||
|
}
|
||||||
|
|
||||||
|
/** Der Zeitpunkt, an dem in Berlin dieser Kalendertag beginnt. */
|
||||||
|
export function berlinMitternacht(tag: string): Date {
|
||||||
|
const basis = new Date(`${tag}T00:00:00Z`);
|
||||||
|
// Die Umstellung findet nachts um zwei statt, nie um Mitternacht – der
|
||||||
|
// Versatz an dieser Stelle ist also eindeutig.
|
||||||
|
return new Date(basis.getTime() - zonenversatzMs(basis));
|
||||||
|
}
|
||||||
|
|
||||||
|
export interface Kennzahlen {
|
||||||
|
gesamt: number;
|
||||||
|
projekte: number;
|
||||||
|
erledigt: number;
|
||||||
|
neueAufgaben: number;
|
||||||
|
notizen: number;
|
||||||
|
}
|
||||||
|
|
||||||
|
/** Was ein Verlaufseintrag fuer die Zaehlung hergeben muss. */
|
||||||
|
export interface ZaehlbarerEintrag {
|
||||||
|
kind: ActivityKind;
|
||||||
|
projectId: string;
|
||||||
|
meta?: unknown;
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Kennzahlen einer Woche.
|
||||||
|
*
|
||||||
|
* "Erledigt" kommt aus dem `meta`-Feld (`to: "DONE"`) und nicht aus dem
|
||||||
|
* Anzeigetext. Der Text ist zum Lesen da und aendert sich mit der
|
||||||
|
* Formulierung – eine Zaehlung, die daran haengt, wird beim naechsten
|
||||||
|
* umformulierten Einzeiler still falsch.
|
||||||
|
*
|
||||||
|
* Fuer aeltere Eintraege ohne `to` bleibt ein Rueckfall auf den Text: der
|
||||||
|
* Verlauf haelt bis zu 200 Eintraege je Projekt, darunter also durchaus
|
||||||
|
* welche von vor dieser Aenderung.
|
||||||
|
*/
|
||||||
|
export function zaehleWoche(eintraege: ZaehlbarerEintrag[]): Kennzahlen {
|
||||||
|
let erledigt = 0;
|
||||||
|
let neueAufgaben = 0;
|
||||||
|
let notizen = 0;
|
||||||
|
const projekte = new Set<string>();
|
||||||
|
|
||||||
|
for (const eintrag of eintraege) {
|
||||||
|
projekte.add(eintrag.projectId);
|
||||||
|
|
||||||
|
if (eintrag.kind === "TASK_ADDED" || eintrag.kind === "TASKS_IMPORTED") {
|
||||||
|
neueAufgaben += 1;
|
||||||
|
} else if (eintrag.kind === "NOTE_ADDED") {
|
||||||
|
notizen += 1;
|
||||||
|
} else if (eintrag.kind === "TASK_MOVED" && istErledigt(eintrag)) {
|
||||||
|
erledigt += 1;
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
return { gesamt: eintraege.length, projekte: projekte.size, erledigt, neueAufgaben, notizen };
|
||||||
|
}
|
||||||
|
|
||||||
|
function istErledigt(eintrag: ZaehlbarerEintrag): boolean {
|
||||||
|
const meta = eintrag.meta;
|
||||||
|
if (meta && typeof meta === "object" && "to" in meta) {
|
||||||
|
return (meta as { to?: unknown }).to === "DONE";
|
||||||
|
}
|
||||||
|
return false;
|
||||||
|
}
|
||||||
|
|
||||||
|
const MONAT_FORMAT = new Intl.DateTimeFormat("de-DE", {
|
||||||
|
timeZone: "Europe/Berlin",
|
||||||
|
month: "long",
|
||||||
|
});
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Beschriftung einer Woche: "17.–23. August 2026", ueber einen
|
||||||
|
* Monatswechsel hinweg "31. August–6. September 2026".
|
||||||
|
*
|
||||||
|
* Der Punkt hinter der Tageszahl kommt von Hand: Intl liefert bei
|
||||||
|
* `day: "numeric"` nur die Ziffer, und mit `day: "2-digit"` staende dort
|
||||||
|
* "07." statt "7.".
|
||||||
|
*/
|
||||||
|
export function wochenTitel(woche: Woche): string {
|
||||||
|
const teile = (tag: string) => {
|
||||||
|
const [j, m, t] = tag.split("-").map(Number);
|
||||||
|
return { tag: t, monat: MONAT_FORMAT.format(new Date(Date.UTC(j, m - 1, t, 12))), jahr: j };
|
||||||
|
};
|
||||||
|
|
||||||
|
const von = teile(woche.tage[0]);
|
||||||
|
const bis = teile(woche.tage[6]);
|
||||||
|
const gleicherMonat = von.monat === bis.monat && von.jahr === bis.jahr;
|
||||||
|
|
||||||
|
const links = gleicherMonat ? `${von.tag}.` : `${von.tag}. ${von.monat}`;
|
||||||
|
return `${links}–${bis.tag}. ${bis.monat} ${bis.jahr}`;
|
||||||
|
}
|
||||||
|
|
||||||
|
/** "Diese Woche", "Vorige Woche", sonst der Zeitraum. */
|
||||||
|
export function wochenName(woche: Woche): string {
|
||||||
|
if (woche.versatz === 0) return "Diese Woche";
|
||||||
|
if (woche.versatz === -1) return "Vorige Woche";
|
||||||
|
return wochenTitel(woche);
|
||||||
|
}
|
||||||
@@ -116,7 +116,15 @@ export async function completeTaskFromIssue(
|
|||||||
`Issue #${task.sourceIssue} geschlossen → „${shorten(task.title, 40)}“ erledigt` +
|
`Issue #${task.sourceIssue} geschlossen → „${shorten(task.title, 40)}“ erledigt` +
|
||||||
(herkunft === "abgleich" ? " (beim Abgleich bemerkt)" : "") +
|
(herkunft === "abgleich" ? " (beim Abgleich bemerkt)" : "") +
|
||||||
(folge ? ", nächste angelegt" : ""),
|
(folge ? ", nächste angelegt" : ""),
|
||||||
meta: { taskId: task.id, issue: task.sourceIssue, source: herkunft },
|
// "from"/"to" wie beim Verschieben von Hand – der Wochenrueckblick
|
||||||
|
// zaehlt daran ab, was erledigt wurde, statt den Text zu durchsuchen.
|
||||||
|
meta: {
|
||||||
|
taskId: task.id,
|
||||||
|
issue: task.sourceIssue,
|
||||||
|
source: herkunft,
|
||||||
|
from: task.status,
|
||||||
|
to: "DONE",
|
||||||
|
},
|
||||||
});
|
});
|
||||||
|
|
||||||
return true;
|
return true;
|
||||||
|
|||||||
@@ -0,0 +1,64 @@
|
|||||||
|
import { describe, expect, it } from "vitest";
|
||||||
|
import { SEITE, SEITE_MAX, cursorAus, seitenBedingung, seitenGroesse } from "./timeline";
|
||||||
|
|
||||||
|
const ID = "cmstxnrzs00011cx4nd5tiqbt";
|
||||||
|
|
||||||
|
describe("cursorAus", () => {
|
||||||
|
it("liest Zeitpunkt und ID", () => {
|
||||||
|
const cursor = cursorAus("2026-08-17T22:30:00.000Z", ID);
|
||||||
|
expect(cursor?.id).toBe(ID);
|
||||||
|
expect(cursor?.createdAt.toISOString()).toBe("2026-08-17T22:30:00.000Z");
|
||||||
|
});
|
||||||
|
|
||||||
|
it("faengt ohne Cursor von vorn an", () => {
|
||||||
|
expect(cursorAus(null, null)).toBeNull();
|
||||||
|
expect(cursorAus("2026-08-17T22:30:00.000Z", null)).toBeNull();
|
||||||
|
expect(cursorAus(null, ID)).toBeNull();
|
||||||
|
});
|
||||||
|
|
||||||
|
it("weist Unbrauchbares ab, statt es in die Abfrage zu geben", () => {
|
||||||
|
expect(cursorAus("kein datum", ID)).toBeNull();
|
||||||
|
expect(cursorAus("2026-08-17T22:30:00.000Z", "kurz")).toBeNull();
|
||||||
|
expect(cursorAus("2026-08-17T22:30:00.000Z", "'; DROP TABLE x --")).toBeNull();
|
||||||
|
});
|
||||||
|
});
|
||||||
|
|
||||||
|
describe("seitenBedingung", () => {
|
||||||
|
it("filtert immer auf den Besitzer", () => {
|
||||||
|
expect(seitenBedingung("u1", null)).toEqual({ project: { ownerId: "u1" } });
|
||||||
|
});
|
||||||
|
|
||||||
|
it("behaelt den Besitzer auch mit Cursor", () => {
|
||||||
|
const wo = seitenBedingung("u1", { createdAt: new Date("2026-08-17T22:30:00Z"), id: ID });
|
||||||
|
expect(wo.project).toEqual({ ownerId: "u1" });
|
||||||
|
});
|
||||||
|
|
||||||
|
it("fasst gleichzeitige Eintraege ueber die ID auseinander", () => {
|
||||||
|
// Der eigentliche Zweck: beim Uebernehmen von Issues entstehen mehrere
|
||||||
|
// Zeilen mit identischem createdAt. Ohne den zweiten Zweig wuerde die
|
||||||
|
// naechste Seite sie ueberspringen oder wiederholen.
|
||||||
|
const zeitpunkt = new Date("2026-08-17T22:30:00Z");
|
||||||
|
const wo = seitenBedingung("u1", { createdAt: zeitpunkt, id: ID });
|
||||||
|
expect(wo.OR).toEqual([
|
||||||
|
{ createdAt: { lt: zeitpunkt } },
|
||||||
|
{ createdAt: zeitpunkt, id: { lt: ID } },
|
||||||
|
]);
|
||||||
|
});
|
||||||
|
});
|
||||||
|
|
||||||
|
describe("seitenGroesse", () => {
|
||||||
|
it("nimmt die Vorgabe, wenn nichts angefragt wurde", () => {
|
||||||
|
expect(seitenGroesse(null)).toBe(SEITE);
|
||||||
|
expect(seitenGroesse("unsinn")).toBe(SEITE);
|
||||||
|
});
|
||||||
|
|
||||||
|
it("deckelt nach oben und unten", () => {
|
||||||
|
expect(seitenGroesse("1000")).toBe(SEITE_MAX);
|
||||||
|
expect(seitenGroesse("0")).toBe(1);
|
||||||
|
expect(seitenGroesse("-5")).toBe(1);
|
||||||
|
});
|
||||||
|
|
||||||
|
it("nimmt einen gueltigen Wert an", () => {
|
||||||
|
expect(seitenGroesse("25")).toBe(25);
|
||||||
|
});
|
||||||
|
});
|
||||||
@@ -0,0 +1,77 @@
|
|||||||
|
import type { Prisma } from "@prisma/client";
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Fortlaufender Verlauf ueber alle Projekte.
|
||||||
|
*
|
||||||
|
* Geblaettert wird per Cursor, nicht per `skip`. Der Verlauf schreibt
|
||||||
|
* mehrere Eintraege im selben Augenblick – beim Uebernehmen von Issues etwa
|
||||||
|
* entstehen zehn Zeilen mit identischem `createdAt`. Ein Offset ueber eine
|
||||||
|
* solche Grenze hinweg ueberspringt Zeilen oder zeigt sie zweimal, und zwar
|
||||||
|
* lautlos. Der Cursor aus (createdAt, id) ist dagegen eindeutig.
|
||||||
|
*/
|
||||||
|
|
||||||
|
/** Wie viele Eintraege eine Seite hat. */
|
||||||
|
export const SEITE = 40;
|
||||||
|
/** Deckel gegen einen Aufrufer, der sich alles auf einmal holen will. */
|
||||||
|
export const SEITE_MAX = 100;
|
||||||
|
|
||||||
|
export interface Cursor {
|
||||||
|
/** Zeitpunkt des letzten gezeigten Eintrags. */
|
||||||
|
createdAt: Date;
|
||||||
|
/** Seine ID – entscheidet bei gleichem Zeitpunkt. */
|
||||||
|
id: string;
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Liest einen Cursor aus Abfrageparametern.
|
||||||
|
*
|
||||||
|
* Gibt null zurueck, wenn nichts oder Unbrauchbares ankommt – dann faengt
|
||||||
|
* die Seite eben von vorn an. Ein Fehler waere hier die schlechtere Antwort:
|
||||||
|
* ein abgeschnittener Verweis soll die Seite nicht sperren.
|
||||||
|
*/
|
||||||
|
export function cursorAus(vor: string | null, id: string | null): Cursor | null {
|
||||||
|
if (!vor || !id) return null;
|
||||||
|
const zeitpunkt = new Date(vor);
|
||||||
|
if (Number.isNaN(zeitpunkt.getTime())) return null;
|
||||||
|
// Die ID ist eine cuid; alles andere weisen wir ab, statt es in die
|
||||||
|
// Abfrage zu geben.
|
||||||
|
if (!/^[a-z0-9]{20,32}$/i.test(id)) return null;
|
||||||
|
return { createdAt: zeitpunkt, id };
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Die where-Bedingung fuer eine Seite.
|
||||||
|
*
|
||||||
|
* Besitzer zuerst – wie ueberall im Projekt, damit fremde Datensaetze gar
|
||||||
|
* nicht erst getroffen werden. Der Verlauf selbst kennt keinen Besitzer, die
|
||||||
|
* Bedingung laeuft deshalb ueber das Projekt.
|
||||||
|
*
|
||||||
|
* Der Cursor bedeutet "aelter als der letzte gezeigte Eintrag": entweder
|
||||||
|
* frueher, oder gleichzeitig und mit kleinerer ID. Genau so sortiert auch
|
||||||
|
* die Abfrage, weshalb beides zusammenpasst.
|
||||||
|
*/
|
||||||
|
export function seitenBedingung(ownerId: string, cursor: Cursor | null): Prisma.ActivityWhereInput {
|
||||||
|
const basis: Prisma.ActivityWhereInput = { project: { ownerId } };
|
||||||
|
if (!cursor) return basis;
|
||||||
|
|
||||||
|
return {
|
||||||
|
...basis,
|
||||||
|
OR: [
|
||||||
|
{ createdAt: { lt: cursor.createdAt } },
|
||||||
|
{ createdAt: cursor.createdAt, id: { lt: cursor.id } },
|
||||||
|
],
|
||||||
|
};
|
||||||
|
}
|
||||||
|
|
||||||
|
/** Sortierung, die zur Cursor-Bedingung passt. Beide muessen gleich sein. */
|
||||||
|
export const SEITEN_ORDNUNG: Prisma.ActivityOrderByWithRelationInput[] = [
|
||||||
|
{ createdAt: "desc" },
|
||||||
|
{ id: "desc" },
|
||||||
|
];
|
||||||
|
|
||||||
|
/** Begrenzt eine gewuenschte Seitengroesse auf das Erlaubte. */
|
||||||
|
export function seitenGroesse(roh: string | null): number {
|
||||||
|
const angefragt = roh === null ? Number.NaN : Number(roh);
|
||||||
|
if (!Number.isFinite(angefragt)) return SEITE;
|
||||||
|
return Math.min(Math.max(Math.trunc(angefragt), 1), SEITE_MAX);
|
||||||
|
}
|
||||||
@@ -100,6 +100,24 @@ export interface TaskOverviewItem {
|
|||||||
project: { id: string; name: string; accent: string; status: ProjectStatus };
|
project: { id: string; name: string; accent: string; status: ProjectStatus };
|
||||||
}
|
}
|
||||||
|
|
||||||
|
/** Ein Verlaufseintrag im Wochenrueckblick – mit Projekt, ueber Projekte hinweg. */
|
||||||
|
export interface ReviewEntry {
|
||||||
|
id: string;
|
||||||
|
kind: ActivityKind;
|
||||||
|
summary: string;
|
||||||
|
/** ISO – ein Date ueberlebt den Weg zum Browser nicht. */
|
||||||
|
createdAt: string;
|
||||||
|
project: { id: string; name: string; accent: string };
|
||||||
|
user: { username: string; displayName: string | null } | null;
|
||||||
|
}
|
||||||
|
|
||||||
|
/** Ein Kalendertag der Woche samt seiner Eintraege. */
|
||||||
|
export interface ReviewDay {
|
||||||
|
/** "2026-08-17", in Berliner Zeit bestimmt. */
|
||||||
|
tag: string;
|
||||||
|
eintraege: ReviewEntry[];
|
||||||
|
}
|
||||||
|
|
||||||
export interface RepoListEntry {
|
export interface RepoListEntry {
|
||||||
fullPath: string;
|
fullPath: string;
|
||||||
owner: string;
|
owner: string;
|
||||||
|
|||||||
Reference in New Issue
Block a user