Compare commits
| Author | SHA1 | Date | |
|---|---|---|---|
|
|
a2547b9022 | ||
|
|
fd633983b8 | ||
|
|
1b5f3fa1b2 | ||
|
|
6ee529576d | ||
|
|
77567c06cd | ||
|
|
e9f01ba8fa | ||
|
|
7920b6a20f | ||
|
|
6c3f2d5bb6 | ||
|
|
3617222cc1 | ||
|
|
43a4c70053 | ||
|
|
65a31b7cc9 | ||
|
|
ce224bc2a4 | ||
|
|
a264eb0dce | ||
|
|
afe57c4428 | ||
|
|
0ef0b3d5ca | ||
|
|
9cdd51fba8 | ||
|
|
5713facc75 | ||
|
|
52f2d0ce8e | ||
|
|
7b60667633 |
@@ -64,6 +64,31 @@ SSRF-Schutz (`lib/security/ssrf.ts`).
|
||||
- **Datumsangaben** über `lib/utils` formatieren (feste Zeitzone), sonst
|
||||
weichen Server-Render und Hydration voneinander ab. Relative Zeiten
|
||||
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
|
||||
|
||||
@@ -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
|
||||
einmal.
|
||||
|
||||
**Die erzeugte SQL vor dem Anwenden lesen.** Der Volltextindex
|
||||
`Note_fulltext_idx` ist ein Ausdrucksindex, den Prisma nicht kennt (er wird
|
||||
bislang in Ruhe gelassen, aber das ist nicht garantiert).
|
||||
**Das Zielverzeichnis vorher *nicht* anlegen.** Ein leerer Ordner unter
|
||||
`prisma/migrations/` lässt `--from-migrations` mit `P3015` abbrechen
|
||||
(„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
|
||||
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.
|
||||
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
|
||||
Entwicklungsabhängigkeit bereit; ein Skript hängt es per `addScriptTag` in
|
||||
die laufende Seite und ruft `axe.run` mit den WCAG-Tags auf. Jeder
|
||||
|
||||
+42
-1
@@ -283,6 +283,23 @@ Zurückspielen:
|
||||
|
||||
## 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
|
||||
Reihenfolge und bricht ab, sobald ein Schritt scheitert:
|
||||
|
||||
@@ -308,7 +325,7 @@ nennt den Weg zurück.
|
||||
|
||||
```bash
|
||||
./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
|
||||
```
|
||||
|
||||
@@ -354,6 +371,23 @@ docker system df
|
||||
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
|
||||
|
||||
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.
|
||||
- **Git-Tokens** liegen AES-256-GCM-verschlüsselt in der Datenbank und
|
||||
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,
|
||||
und `/_next/image` wäre sonst eine Angriffsfläche ohne Gegenwert.
|
||||
|
||||
|
||||
+123
-7
@@ -145,12 +145,17 @@ dort wäre er auf schmalen Anzeigen mit der Auswahlleiste kollidiert.
|
||||
Favoriten bleiben stets oben.
|
||||
- **Vier Ansichten**: freies Raster, **kompakte Liste**, nach Status gruppierte Abschnitte
|
||||
oder **Kanban**.
|
||||
- **Volltextsuche über Notizen.** Die Suche im Board arbeitet auf den geladenen Projekten
|
||||
(Name, Kurzbeschreibung, Tags, Repo-Pfad). Notizen liegen dort nicht vor — sie
|
||||
mitzuladen würde die Seite aufblähen. Stattdessen sucht Postgres serverseitig mit
|
||||
seiner deutschen Textsuche, entprellt ab zwei Zeichen. Treffer erscheinen als eigene
|
||||
Liste mit hervorgehobener Fundstelle, die betroffenen Projekte werden zusätzlich
|
||||
eingeblendet. Deutsche Stammformen greifen: „Webhook" findet auch „Webhooks".
|
||||
- **Volltextsuche über Notizen und Aufgaben.** Die Suche im Board arbeitet auf den
|
||||
geladenen Projekten (Name, Kurzbeschreibung, Tags, Repo-Pfad). Notizen und Aufgaben
|
||||
liegen dort nicht vor — sie mitzuladen würde die Seite aufblähen. Stattdessen sucht
|
||||
Postgres serverseitig mit seiner deutschen Textsuche, entprellt ab zwei Zeichen.
|
||||
Treffer erscheinen als zwei eigene Listen mit hervorgehobener Fundstelle, die
|
||||
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.
|
||||
- **Leerzustände** mit direktem Einstieg statt einer leeren Fläche.
|
||||
|
||||
@@ -250,6 +255,10 @@ Blockiert · Erledigt**.
|
||||
Fälligkeitsdatum und Labels.
|
||||
- **Fälligkeiten** färben sich mit: überfällig rot, heute gelb, in den nächsten Tagen
|
||||
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
|
||||
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
|
||||
|
||||
- **Beliebig viele Notizen pro Projekt**, mit optionalem Titel und mehrzeiligem Text.
|
||||
@@ -432,6 +489,40 @@ Firmen-Gitea nebeneinander.
|
||||
Kurzbeschreibung.
|
||||
- **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
|
||||
|
||||
| Bereich | Details |
|
||||
@@ -529,7 +620,32 @@ soll jemand gewollt haben. Danach wandert der Zustand allerdings mit — erledig
|
||||
das Issue, ein Zurückziehen öffnet es wieder. Schlägt der Aufruf fehl, zieht die Aufgabe
|
||||
trotzdem um; ein nicht erreichbares Git-System darf das Abhaken nicht verhindern.
|
||||
|
||||
**Git → Nebula** über Webhooks, siehe unten.
|
||||
**Git → Nebula** auf zwei Wegen, die sich ergänzen:
|
||||
|
||||
- **Webhook** — sofort, sobald das Issue geschlossen wird. Setzt voraus, dass die Instanz
|
||||
von außen erreichbar ist und der Haken eingetragen wurde (siehe 4.7).
|
||||
- **Beim Abgleich** — verzögert, aber verlässlich. Der Abgleich fragt den Zustand
|
||||
verknüpfter Issues nach und hakt ab, was in Git geschlossen ist. Damit funktioniert der
|
||||
Rückweg auch ohne Webhook, ohne öffentliche Erreichbarkeit und selbst dann, wenn ein
|
||||
Haken einmal ausfällt.
|
||||
|
||||
Gespart wird, wo es geht: Nummern, die der gerade geholte Snapshot als offen führt,
|
||||
werden nicht einzeln nachgefragt. Umgekehrt gilt das nicht — die Liste der offenen
|
||||
Issues ist gedeckelt, aus dem Fehlen einer Nummer folgt also nichts. Pro Durchgang
|
||||
fragt der Abgleich höchstens 25 Issues nach.
|
||||
|
||||
**Der Abgleich hakt nur ab, er nimmt nie zurück.** Er sieht Zustände, keine Ereignisse:
|
||||
ein offenes Issue kann auch bedeuten, dass das Schließen von Nebula aus fehlgeschlagen
|
||||
ist. Ein symmetrischer Abgleich würde dann eine bewusst erledigte Aufgabe wieder
|
||||
aufmachen. Das Zurücknehmen bleibt dem Webhook vorbehalten, der ein echtes „reopened“
|
||||
sieht.
|
||||
|
||||
Ein gelöschtes Issue ist kein erledigtes — die Aufgabe bleibt stehen.
|
||||
|
||||
In beiden Fällen bewirkt ein geschlossenes Issue dasselbe wie ein Haken in der
|
||||
Oberfläche: bei einer wiederkehrenden Aufgabe entsteht die nächste Fassung, und der
|
||||
Vorgang landet im Projektverlauf (ohne Benutzer — das hat nicht jemand in Nebula getan,
|
||||
sondern das Git-System gemeldet).
|
||||
|
||||
**Die Zustände passen nicht aufeinander, und das bleibt so.** Nebula kennt
|
||||
`Offen · In Arbeit · Blockiert · Erledigt`, ein Issue nur offen oder geschlossen. Nach
|
||||
|
||||
@@ -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**
|
||||
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
|
||||
kennt zwei Betriebsarten: **Einzelbetrieb** für ein Konto oder **Mehrbenutzerbetrieb**, 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
|
||||
|
||||
1. Im Git-System einen **Personal Access Token** mit Leserechten erzeugen:
|
||||
|
||||
| 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` |
|
||||
|
||||
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).
|
||||
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.
|
||||
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.
|
||||
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
|
||||
|
||||
Unter **Admin-Einstellungen → Automatischer Abgleich** lässt sich der Sync in den
|
||||
@@ -275,15 +401,25 @@ nebula/
|
||||
└── src/
|
||||
├── app/
|
||||
│ ├── 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
|
||||
│ └── 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)
|
||||
├── lib/
|
||||
│ ├── auth/ Sitzungen, Passwörter, TOTP, WebAuthn, Zugriffsschutz
|
||||
│ ├── crypto.ts AES-256-GCM für Access Tokens
|
||||
│ ├── db.ts Prisma-Client
|
||||
│ ├── 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
|
||||
└── 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 |
|
||||
| `POST` | `/api/templates/from-project` | Aus einem Projekt eine Vorlage machen |
|
||||
| `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 |
|
||||
| `PATCH` `DELETE` | `/api/notifications/:id` | Ziel ändern / entfernen |
|
||||
| `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 |
|
||||
| `PATCH` `DELETE` | `/api/repositories/:id` | Repository ändern / vom Projekt lösen |
|
||||
| `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 |
|
||||
| `PATCH` | `/api/projects/:id/tasks/reorder` | Neue Reihenfolge nach dem Ziehen |
|
||||
| `POST` | `/api/projects/:id/tasks/from-issues` | Offene Issues als Aufgaben übernehmen |
|
||||
| `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 |
|
||||
| `PATCH` `DELETE` | `/api/notes/:id` | Notiz ändern / löschen |
|
||||
| `GET` `POST` | `/api/connections` | Git-Verbindungen |
|
||||
@@ -434,17 +574,21 @@ Grenzen, die du kennen solltest:
|
||||
|
||||
## Getestet mit
|
||||
|
||||
Stand 25.07.2026 gegen echte Systeme verifiziert — beide Betriebsarten, alle drei
|
||||
Git-Adapter (GitHub, GitLab und Gitea jeweils gegen die öffentliche Instanz).
|
||||
Am 25.07.2026 gegen echte Systeme verifiziert — beide Betriebsarten, alle drei
|
||||
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 |
|
||||
| --- | --- |
|
||||
| Node.js | 26.5.0 |
|
||||
| Node.js | 24.19.0 |
|
||||
| npm | 11.17.0 |
|
||||
| Next.js | 15.5.21 |
|
||||
| Prisma | 6.19.3 |
|
||||
| PostgreSQL | 17 (Alpine) |
|
||||
| Docker / Compose | 29.6.2 / v5.3.1 |
|
||||
| PostgreSQL | 17.11 (Alpine) |
|
||||
| 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).
|
||||
|
||||
**Stand:** v1.10.1. Alle Issues aus dem Dashboard sind abgearbeitet.
|
||||
|
||||
---
|
||||
|
||||
## 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
|
||||
ausgeliefert. Offen bleibt der dritte Teil — siehe 1.3. Er gehört sachlich
|
||||
dazu: erfassen am Telefon, überblicken an einer Stelle, ansprechen per
|
||||
Shortcut.
|
||||
Der letzte offene Teil aus v1.6.0 („unterwegs erfassen"). Derzeit geht die
|
||||
API nur mit Sitzungscookie. Ein Token je Konto würde `curl`-Aufrufe und
|
||||
Handy-Shortcuts erlauben — eine Idee aus dem Terminal anlegen, ohne den
|
||||
Browser zu öffnen. Nur der Hash in der Datenbank, wie bei den Sitzungen.
|
||||
|
||||
Bewusst nicht mitgeliefert wurde ein **Index für die übergreifende
|
||||
Aufgabenabfrage**. `Task` hat kein `ownerId`, die Trennung läuft über
|
||||
`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.
|
||||
|
||||
---
|
||||
Bewusst noch nicht angefasst, weil sicherheitsrelevant: Geltungsbereich,
|
||||
Widerruf und Ablauf wollen entschieden sein, nicht nebenbei gebaut.
|
||||
|
||||
### 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
|
||||
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
|
||||
`curl`-Aufrufe und Handy-Shortcuts erlauben — Idee aus dem Terminal anlegen,
|
||||
ohne den Browser zu öffnen. Nur der Hash in der Datenbank, wie bei den
|
||||
Sitzungen.
|
||||
|
||||
---
|
||||
|
||||
### 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:
|
||||
Beide Richtungen stehen — „als Issue anlegen" seit v1.7.0, der Rückweg über
|
||||
Webhook (v1.7.0) und zusätzlich über den Abgleich (v1.9.0). Offen ist
|
||||
Kleinkram:
|
||||
|
||||
- **Mehrere Repositories.** Der Knopf nimmt immer das führende. Bei einem
|
||||
Projekt aus Frontend und Backend fehlt die Wahl.
|
||||
- **Beim Übernehmen aus Issues** wird der Rückweg nicht automatisch
|
||||
eingerichtet — der Webhook ist getrennt zu setzen.
|
||||
- **Webhook beim Verknüpfen anbieten.** Er ist getrennt einzurichten, und
|
||||
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
|
||||
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 |
|
||||
| --- | --- | --- |
|
||||
| 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 |
|
||||
| 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 |
|
||||
| Hell/Dunkel umschaltbar | `M` | Aktuell nur dunkel |
|
||||
| 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:
|
||||
|
||||
@@ -104,7 +138,10 @@ Damit klar ist, was **nicht** kommt und warum:
|
||||
- **Anhänge an Notizen.** Bräuchte Dateispeicher und damit eine zweite Sorge
|
||||
bei jeder Sicherung. Ein Link ins Git tut es auch.
|
||||
- **Eigene Git-Operationen** (klonen, committen, pushen). Nebula ist eine
|
||||
Übersicht, keine Entwicklungsumgebung.
|
||||
Ü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.
|
||||
- **Cloud-Synchronisation.** Die Daten bleiben in deiner Datenbank; das ist
|
||||
der Punkt.
|
||||
@@ -138,6 +175,10 @@ Damit klar ist, was **nicht** kommt und warum:
|
||||
| **v1.5.0** Sicherheitsdurchsicht, Server-Anleitung und Update-Skript | ✓ |
|
||||
| **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.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
|
||||
beschrieben, das Token ist nach dem Import neu zu hinterlegen. Snapshots bleiben
|
||||
|
||||
+188
@@ -1,4 +1,13 @@
|
||||
import { expect, test, type APIRequestContext } from "@playwright/test";
|
||||
import { PrismaClient } from "@prisma/client";
|
||||
|
||||
/**
|
||||
* Dieselbe Datenbank wie global-setup.ts. Gebraucht fuer den einen Fall, in
|
||||
* dem ein Zustand herzustellen ist, den die API bewusst nicht anbietet.
|
||||
*/
|
||||
const DATABASE_URL =
|
||||
process.env.E2E_DATABASE_URL ??
|
||||
"postgresql://nebula:nebula@localhost:5432/nebula_e2e_test?schema=public";
|
||||
|
||||
/**
|
||||
* Tests ueber HTTP gegen die laufende Anwendung – also durch Middleware,
|
||||
@@ -325,6 +334,79 @@ test("Die Anmeldung verraet nicht, welche Konten es gibt", async ({ request, pla
|
||||
await request.delete(`/api/admin/users/${id}`);
|
||||
});
|
||||
|
||||
test("Abgleich hakt Aufgaben ab, deren Issue geschlossen wurde", async ({ request }) => {
|
||||
await login(request, ADMIN);
|
||||
|
||||
// Ein oeffentliches Repository mit sicher geschlossenen Issues. Der
|
||||
// Abgleich laeuft anonym gegen die GitHub-API – kein Token noetig.
|
||||
const projekt = (
|
||||
await (
|
||||
await request.post("/api/projects", {
|
||||
data: { name: "Rueckweg", repoUrl: "https://github.com/vercel/swr" },
|
||||
})
|
||||
).json()
|
||||
).project;
|
||||
const repoId = projekt.repositories[0].id;
|
||||
|
||||
const angelegt = await request.post(`/api/projects/${projekt.id}/tasks`, {
|
||||
data: { title: "Haengt an einem geschlossenen Issue" },
|
||||
});
|
||||
const taskId = (await angelegt.json()).task.id;
|
||||
|
||||
/**
|
||||
* Die Verknuepfung direkt in der Datenbank setzen.
|
||||
*
|
||||
* Ueber die API gibt es dafuer keinen Weg, und das ist richtig so: "als
|
||||
* Issue anlegen" wuerde ein neues Issue in einem fremden Repository
|
||||
* erzeugen. Ein Endpunkt nur fuer Tests waere eine Hintertuer im
|
||||
* Produktionscode – dafuer greift der Test lieber selbst zur Datenbank.
|
||||
*
|
||||
* Issue 1 von vercel/swr ist seit Jahren geschlossen.
|
||||
*/
|
||||
const prisma = new PrismaClient({
|
||||
datasources: { db: { url: DATABASE_URL } },
|
||||
});
|
||||
try {
|
||||
await prisma.task.update({
|
||||
where: { id: taskId },
|
||||
data: { sourceRepositoryId: repoId, sourceIssue: 1 },
|
||||
});
|
||||
} finally {
|
||||
await prisma.$disconnect();
|
||||
}
|
||||
|
||||
const vorher = await (await request.get(`/api/projects/${projekt.id}`)).json();
|
||||
const alsAngelegt = vorher.project.tasks.find(
|
||||
(t: { id: string }) => t.id === taskId,
|
||||
);
|
||||
expect(alsAngelegt.sourceIssue).toBe(1);
|
||||
expect(alsAngelegt.status).toBe("TODO");
|
||||
|
||||
// Abgleich anstossen – er fragt den Zustand des Issues nach.
|
||||
const sync = await request.post(`/api/repositories/${repoId}/sync`);
|
||||
const syncBody = await sync.json();
|
||||
|
||||
/**
|
||||
* Dieser Test greift als einziger wirklich nach draussen. Ist GitHub nicht
|
||||
* erreichbar oder das anonyme Rate-Limit ausgeschoepft, sagt er das statt
|
||||
* rot zu werden – ein fremder Dienst darf die Testreihe nicht bestimmen.
|
||||
*/
|
||||
if (!sync.ok()) {
|
||||
test.skip(true, `GitHub nicht erreichbar: ${syncBody.message ?? sync.status()}`);
|
||||
return;
|
||||
}
|
||||
|
||||
const nachher = await (await request.get(`/api/projects/${projekt.id}`)).json();
|
||||
const abgehakt = nachher.project.tasks.find((t: { id: string }) => t.id === taskId);
|
||||
expect(abgehakt.status).toBe("DONE");
|
||||
expect(abgehakt.doneAt).not.toBeNull();
|
||||
|
||||
// Und ein zweiter Lauf aendert nichts mehr – abgehakt bleibt abgehakt,
|
||||
// ohne dass erneut nachgefragt wird.
|
||||
const nochmal = await request.post(`/api/repositories/${repoId}/sync`);
|
||||
expect((await nochmal.json()).message ?? "").not.toMatch(/abgehakt/);
|
||||
});
|
||||
|
||||
test("Webhook: Signatur entscheidet, sonst passiert nichts", async ({ request, playwright }) => {
|
||||
await login(request, ADMIN);
|
||||
|
||||
@@ -681,6 +763,112 @@ test("Projektvorlagen: aus Projekt sichern und anwenden", async ({ request, play
|
||||
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 }) => {
|
||||
// /_next/image reicht jedes Bild durch sharp und damit durch libvips, fuer
|
||||
// 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();
|
||||
});
|
||||
|
||||
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 }) => {
|
||||
await page.keyboard.press("Control+k");
|
||||
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.
|
||||
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();
|
||||
|
||||
// Enter springt zum ersten Treffer.
|
||||
|
||||
Generated
+2
-2
@@ -1,12 +1,12 @@
|
||||
{
|
||||
"name": "nebula",
|
||||
"version": "1.2.0",
|
||||
"version": "1.10.1",
|
||||
"lockfileVersion": 3,
|
||||
"requires": true,
|
||||
"packages": {
|
||||
"": {
|
||||
"name": "nebula",
|
||||
"version": "1.2.0",
|
||||
"version": "1.10.1",
|
||||
"hasInstallScript": true,
|
||||
"dependencies": {
|
||||
"@dnd-kit/core": "^6.3.1",
|
||||
|
||||
+1
-1
@@ -1,6 +1,6 @@
|
||||
{
|
||||
"name": "nebula",
|
||||
"version": "1.8.0",
|
||||
"version": "1.10.1",
|
||||
"private": true,
|
||||
"description": "Nebula – Dashboard fuer Vibe-Coding Projekte mit Git-Anbindung (GitHub, GitLab, Gitea)",
|
||||
"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;
|
||||
}
|
||||
|
||||
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
|
||||
* Name, Kurzbeschreibung und Tags ab. Notizen liegen dort nicht vor – die
|
||||
* mitzuladen wuerde die Seite unnoetig aufblaehen. Deshalb dieser Endpunkt:
|
||||
* Postgres sucht mit seiner deutschen Textsuche direkt in der Datenbank.
|
||||
* Name, Kurzbeschreibung und Tags ab. Notizen und Aufgaben liegen dort nicht
|
||||
* vor – die mitzuladen wuerde die Seite unnoetig aufblaehen. Deshalb dieser
|
||||
* Endpunkt: Postgres sucht mit seiner deutschen Textsuche direkt in der
|
||||
* Datenbank.
|
||||
*
|
||||
* ts_headline liefert gleich den passenden Ausschnitt mit; die Hervorhebung
|
||||
* 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) {
|
||||
const auth = await requireUserApi();
|
||||
@@ -29,7 +43,7 @@ export async function GET(request: Request) {
|
||||
|
||||
const query = (new URL(request.url).searchParams.get("q") ?? "").trim();
|
||||
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
|
||||
@@ -57,11 +71,48 @@ export async function GET(request: Request) {
|
||||
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({
|
||||
query,
|
||||
hits,
|
||||
tasks,
|
||||
// Die Oberflaeche braucht vor allem die betroffenen Projekte, um sie im
|
||||
// Board einzublenden.
|
||||
projectIds: Array.from(new Set(hits.map((hit) => hit.projectId))),
|
||||
// Board einzublenden – jetzt aus beiden Quellen.
|
||||
projectIds: Array.from(
|
||||
new Set([...hits.map((hit) => hit.projectId), ...tasks.map((hit) => hit.projectId)]),
|
||||
),
|
||||
});
|
||||
}
|
||||
|
||||
@@ -3,7 +3,7 @@ import { tryDecryptSecret } from "@/lib/crypto";
|
||||
import { prisma } from "@/lib/db";
|
||||
import { rateLimit } from "@/lib/security/rateLimit";
|
||||
import { syncRepository } from "@/lib/sync";
|
||||
import { statusForIssueState } from "@/lib/tasks/issues";
|
||||
import { completeTaskFromIssue, statusForIssueState } from "@/lib/tasks/issues";
|
||||
import { refreshDerivedProgress } from "@/lib/tasks";
|
||||
import { parseEvent, verifySignature } from "@/lib/webhooks/verify";
|
||||
|
||||
@@ -118,13 +118,19 @@ export async function POST(request: Request, { params }: Params) {
|
||||
}
|
||||
|
||||
const ziel = statusForIssueState(ereignis.open, task.status);
|
||||
if (ziel !== task.status) {
|
||||
|
||||
if (ziel === "DONE" && task.status !== "DONE") {
|
||||
// Ueber die gemeinsame Funktion, damit ein geschlossenes Issue
|
||||
// dasselbe bewirkt wie ein Haken in der Oberflaeche: naechste Fassung
|
||||
// einer wiederkehrenden Aufgabe und ein Eintrag im Verlauf.
|
||||
await completeTaskFromIssue(task.id, "webhook");
|
||||
} else if (ziel !== task.status) {
|
||||
// Wieder geoeffnet. Das darf nur der Webhook, weil hier ein echtes
|
||||
// "reopened" vorliegt – der Abgleich sieht nur Zustaende und wuerde
|
||||
// sonst eine bewusst erledigte Aufgabe aufmachen.
|
||||
await prisma.task.update({
|
||||
where: { id: task.id },
|
||||
data: {
|
||||
status: ziel,
|
||||
doneAt: ziel === "DONE" ? new Date() : null,
|
||||
},
|
||||
data: { status: ziel, doneAt: null },
|
||||
});
|
||||
await refreshDerivedProgress(task.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 { StatCard } from "@/components/StatCard";
|
||||
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
|
||||
verknuepften Repositories bei GitHub, GitLab und Gitea passiert.
|
||||
</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>
|
||||
|
||||
{/* 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";
|
||||
|
||||
import { useState } from "react";
|
||||
import {
|
||||
AlertTriangle,
|
||||
ArrowRight,
|
||||
Bot,
|
||||
Download,
|
||||
GitCommitHorizontal,
|
||||
History,
|
||||
Link2,
|
||||
Loader2,
|
||||
NotebookPen,
|
||||
Pencil,
|
||||
Plus,
|
||||
Signpost,
|
||||
Sparkles,
|
||||
Trash2,
|
||||
} from "lucide-react";
|
||||
import type { ActivityEntry, ActivityKind } from "@/types";
|
||||
import { Bot, History, Loader2 } from "lucide-react";
|
||||
import { ACTIVITY_KINDS } from "@/components/activityKinds";
|
||||
import type { ActivityEntry } from "@/types";
|
||||
import { formatDateTime, formatRelative } from "@/lib/utils";
|
||||
|
||||
/**
|
||||
@@ -29,21 +15,6 @@ import { formatDateTime, formatRelative } from "@/lib/utils";
|
||||
* 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({
|
||||
projectId,
|
||||
@@ -88,7 +59,7 @@ export function ActivityFeed({
|
||||
) : (
|
||||
<ol className="mt-4 space-y-0">
|
||||
{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 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 {
|
||||
Bell,
|
||||
CalendarRange,
|
||||
CheckSquare,
|
||||
CornerDownLeft,
|
||||
GitBranch,
|
||||
History,
|
||||
LayoutDashboard,
|
||||
Loader2,
|
||||
NotebookPen,
|
||||
@@ -16,8 +18,9 @@ import {
|
||||
Settings,
|
||||
UserRound,
|
||||
} from "lucide-react";
|
||||
import type { ProjectStatus } from "@prisma/client";
|
||||
import type { ProjectStatus, TaskStatus } from "@prisma/client";
|
||||
import { statusOf } from "@/lib/status";
|
||||
import { TASK_STATUS_META } from "@/lib/tasks";
|
||||
import { cn } from "@/lib/utils";
|
||||
|
||||
/**
|
||||
@@ -38,6 +41,14 @@ interface ProjectHit {
|
||||
tags: string[];
|
||||
}
|
||||
|
||||
interface TaskHit {
|
||||
projectId: string;
|
||||
taskId: string;
|
||||
title: string;
|
||||
status: string;
|
||||
snippet: string;
|
||||
}
|
||||
|
||||
interface NoteHit {
|
||||
projectId: string;
|
||||
noteId: string;
|
||||
@@ -56,6 +67,20 @@ interface Action {
|
||||
|
||||
const ACTIONS: Action[] = [
|
||||
{ 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",
|
||||
label: "Aufgaben",
|
||||
@@ -91,7 +116,8 @@ const ACTIONS: Action[] = [
|
||||
type Entry =
|
||||
| { kind: "action"; key: string; action: Action }
|
||||
| { 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 }) {
|
||||
const router = useRouter();
|
||||
@@ -100,6 +126,7 @@ export function CommandPalette({ isAdmin }: { isAdmin: boolean }) {
|
||||
const [query, setQuery] = useState("");
|
||||
const [projects, setProjects] = useState<ProjectHit[] | null>(null);
|
||||
const [notes, setNotes] = useState<NoteHit[]>([]);
|
||||
const [aufgaben, setAufgaben] = useState<TaskHit[]>([]);
|
||||
const [active, setActive] = useState(0);
|
||||
const [loading, setLoading] = useState(false);
|
||||
const listRef = useRef<HTMLDivElement>(null);
|
||||
@@ -138,6 +165,7 @@ export function CommandPalette({ isAdmin }: { isAdmin: boolean }) {
|
||||
const needle = query.trim();
|
||||
if (needle.length < 2) {
|
||||
setNotes([]);
|
||||
setAufgaben([]);
|
||||
return;
|
||||
}
|
||||
const controller = new AbortController();
|
||||
@@ -147,8 +175,9 @@ export function CommandPalette({ isAdmin }: { isAdmin: boolean }) {
|
||||
signal: controller.signal,
|
||||
});
|
||||
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 ?? []);
|
||||
setAufgaben(body.tasks ?? []);
|
||||
} catch {
|
||||
// Abbruch beim Weitertippen ist der Normalfall.
|
||||
}
|
||||
@@ -163,6 +192,7 @@ export function CommandPalette({ isAdmin }: { isAdmin: boolean }) {
|
||||
if (!open) {
|
||||
setQuery("");
|
||||
setNotes([]);
|
||||
setAufgaben([]);
|
||||
setActive(0);
|
||||
}
|
||||
}, [open]);
|
||||
@@ -202,6 +232,17 @@ export function CommandPalette({ isAdmin }: { isAdmin: boolean }) {
|
||||
for (const project of passendeProjekte.slice(0, 8)) {
|
||||
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)) {
|
||||
result.push({
|
||||
kind: "note",
|
||||
@@ -215,7 +256,7 @@ export function CommandPalette({ isAdmin }: { isAdmin: boolean }) {
|
||||
result.push({ kind: "action", key: `a-${action.id}`, action });
|
||||
}
|
||||
return result;
|
||||
}, [query, projects, notes, isAdmin]);
|
||||
}, [query, projects, notes, aufgaben, isAdmin]);
|
||||
|
||||
useEffect(() => {
|
||||
setActive((current) => Math.min(current, Math.max(0, entries.length - 1)));
|
||||
@@ -226,6 +267,7 @@ export function CommandPalette({ isAdmin }: { isAdmin: boolean }) {
|
||||
setOpen(false);
|
||||
if (entry.kind === "action") router.push(entry.action.href);
|
||||
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}`);
|
||||
},
|
||||
[router],
|
||||
@@ -276,7 +318,7 @@ export function CommandPalette({ isAdmin }: { isAdmin: boolean }) {
|
||||
value={query}
|
||||
onChange={(event) => setQuery(event.target.value)}
|
||||
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"
|
||||
/>
|
||||
{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}
|
||||
</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" />
|
||||
|
||||
@@ -3,6 +3,7 @@
|
||||
import { useEffect, useMemo, useRef, useState } from "react";
|
||||
import Link from "next/link";
|
||||
import {
|
||||
CheckSquare,
|
||||
Columns3,
|
||||
Database,
|
||||
Download,
|
||||
@@ -16,7 +17,7 @@ import {
|
||||
Upload,
|
||||
X,
|
||||
} from "lucide-react";
|
||||
import type { ProjectStatus } from "@prisma/client";
|
||||
import type { ProjectStatus, TaskStatus } from "@prisma/client";
|
||||
import { BulkBar } from "@/components/BulkBar";
|
||||
import { ImportDialog } from "@/components/ImportDialog";
|
||||
import { KanbanBoard } from "@/components/KanbanBoard";
|
||||
@@ -25,9 +26,18 @@ import { ProjectDialog } from "@/components/ProjectDialog";
|
||||
import { ProjectList } from "@/components/ProjectList";
|
||||
import { Popover } from "@/components/ui/Popover";
|
||||
import { STATUS_META, STATUS_ORDER } from "@/lib/status";
|
||||
import { TASK_STATUS_META } from "@/lib/tasks";
|
||||
import { cn } from "@/lib/utils";
|
||||
import type { ConnectionSafe, ProjectListItem } from "@/types";
|
||||
|
||||
interface TaskHit {
|
||||
projectId: string;
|
||||
taskId: string;
|
||||
title: string;
|
||||
status: string;
|
||||
snippet: string;
|
||||
}
|
||||
|
||||
interface NoteHit {
|
||||
projectId: string;
|
||||
noteId: string;
|
||||
@@ -135,6 +145,7 @@ export function ProjectBoard({
|
||||
const [dataMenuOpen, setDataMenuOpen] = useState(false);
|
||||
const dataButtonRef = useRef<HTMLButtonElement>(null);
|
||||
const [noteHits, setNoteHits] = useState<NoteHit[]>([]);
|
||||
const [taskHits, setTaskHits] = useState<TaskHit[]>([]);
|
||||
const [selection, setSelection] = useState<Set<string>>(new Set());
|
||||
|
||||
/**
|
||||
@@ -147,6 +158,7 @@ export function ProjectBoard({
|
||||
const needle = query.trim();
|
||||
if (needle.length < 2) {
|
||||
setNoteHits([]);
|
||||
setTaskHits([]);
|
||||
return;
|
||||
}
|
||||
|
||||
@@ -157,8 +169,9 @@ export function ProjectBoard({
|
||||
signal: controller.signal,
|
||||
});
|
||||
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 ?? []);
|
||||
setTaskHits(body.tasks ?? []);
|
||||
} catch {
|
||||
// Abgebrochene Anfragen sind der Normalfall beim Tippen.
|
||||
}
|
||||
@@ -171,8 +184,12 @@ export function ProjectBoard({
|
||||
}, [query]);
|
||||
|
||||
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(() => {
|
||||
@@ -200,7 +217,7 @@ export function ProjectBoard({
|
||||
project.repositories.some((repo) =>
|
||||
(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)
|
||||
);
|
||||
});
|
||||
@@ -434,6 +451,60 @@ export function ProjectBoard({
|
||||
</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 */}
|
||||
{noteHits.length > 0 ? (
|
||||
<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";
|
||||
|
||||
import { AlignLeft, CalendarClock, GripVertical, Repeat } from "lucide-react";
|
||||
import {
|
||||
AlignLeft,
|
||||
CalendarClock,
|
||||
GitPullRequestArrow,
|
||||
GripVertical,
|
||||
Repeat,
|
||||
} from "lucide-react";
|
||||
import type { Task } from "@prisma/client";
|
||||
import { RECURRENCE_META } from "@/lib/tasks";
|
||||
import { cn, formatDate } from "@/lib/utils";
|
||||
@@ -70,8 +76,26 @@ export function TaskCard({
|
||||
{task.title}
|
||||
</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]">
|
||||
{/* 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 ? (
|
||||
<AlignLeft className="h-2.5 w-2.5 text-slate-600" aria-label="hat Beschreibung" />
|
||||
) : null}
|
||||
|
||||
@@ -10,7 +10,9 @@ import {
|
||||
Loader2,
|
||||
Plus,
|
||||
Repeat,
|
||||
Search,
|
||||
Square,
|
||||
X,
|
||||
} from "lucide-react";
|
||||
import type { TaskStatus } from "@prisma/client";
|
||||
import { QuickCapture } from "@/components/QuickCapture";
|
||||
@@ -42,6 +44,7 @@ export function TaskOverview({ tasks }: { tasks: TaskOverviewItem[] }) {
|
||||
const router = useRouter();
|
||||
const [statusFilter, setStatusFilter] = useState<TaskStatus[]>([]);
|
||||
const [projektFilter, setProjektFilter] = useState("");
|
||||
const [suche, setSuche] = useState("");
|
||||
const [zeigeErledigte, setZeigeErledigte] = useState(false);
|
||||
const [erfassenOffen, setErfassenOffen] = useState(false);
|
||||
const [laufend, setLaufend] = useState<Set<string>>(new Set());
|
||||
@@ -63,16 +66,34 @@ export function TaskOverview({ tasks }: { tasks: TaskOverviewItem[] }) {
|
||||
}, [tasks]);
|
||||
|
||||
const sichtbar = useMemo(() => {
|
||||
const nadel = suche.toLowerCase().trim();
|
||||
|
||||
return tasks.filter((task) => {
|
||||
// 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;
|
||||
}
|
||||
if (statusFilter.length > 0 && !statusFilter.includes(task.status)) 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(() => {
|
||||
return DUE_BUCKET_ORDER.map((bucket) => ({
|
||||
@@ -155,6 +176,27 @@ export function TaskOverview({ tasks }: { tasks: TaskOverviewItem[] }) {
|
||||
|
||||
{/* Steuerleiste */}
|
||||
<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">
|
||||
{TASK_STATUS_ORDER.map((status) => {
|
||||
const meta = TASK_STATUS_META[status];
|
||||
@@ -220,11 +262,17 @@ export function TaskOverview({ tasks }: { tasks: TaskOverviewItem[] }) {
|
||||
</span>
|
||||
<div>
|
||||
<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>
|
||||
<p className="mt-1 max-w-md text-sm text-slate-400">
|
||||
{tasks.length === 0
|
||||
? "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."}
|
||||
</p>
|
||||
</div>
|
||||
|
||||
@@ -41,6 +41,93 @@ export const KIND_META: Record<ChangeKind, { label: string; className: string }>
|
||||
};
|
||||
|
||||
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",
|
||||
date: "2026-08-17",
|
||||
headline: "Geschlossene Issues haken ihre Aufgabe auch ohne Webhook ab.",
|
||||
changes: [
|
||||
{
|
||||
kind: "neu",
|
||||
text:
|
||||
"Der Abgleich prüft jetzt den Zustand verknüpfter Issues: was in Git geschlossen " +
|
||||
"wurde, wird in Nebula abgehakt. Bisher konnte das nur der Webhook — war keiner " +
|
||||
"eingerichtet, blieb der Rückweg ganz aus.",
|
||||
},
|
||||
{
|
||||
kind: "besser",
|
||||
text:
|
||||
"Ein über Git geschlossenes Issue bewirkt jetzt dasselbe wie ein Haken in der " +
|
||||
"Oberfläche: bei wiederkehrenden Aufgaben entsteht die nächste Fassung, und der " +
|
||||
"Vorgang steht im Projektverlauf.",
|
||||
},
|
||||
],
|
||||
},
|
||||
{
|
||||
version: "1.8.0",
|
||||
date: "2026-08-15",
|
||||
|
||||
@@ -71,6 +71,15 @@ export class GiteaClient implements GitClient {
|
||||
);
|
||||
}
|
||||
|
||||
async getIssueState(ref: RepoRef, number: number): Promise<"open" | "closed" | null> {
|
||||
const issue = await getJson<{ state?: string } | null>(
|
||||
`${this.repoBase(ref)}/issues/${number}`,
|
||||
{ headers: this.headers(), allow404: true },
|
||||
);
|
||||
if (!issue?.state) return null;
|
||||
return issue.state === "closed" ? "closed" : "open";
|
||||
}
|
||||
|
||||
async check(): Promise<ConnectionCheck> {
|
||||
try {
|
||||
const version = await getJsonSafe<{ version?: string }>(
|
||||
|
||||
@@ -70,6 +70,15 @@ export class GitHubClient implements GitClient {
|
||||
);
|
||||
}
|
||||
|
||||
async getIssueState(ref: RepoRef, number: number): Promise<"open" | "closed" | null> {
|
||||
const issue = await getJson<{ state?: string } | null>(
|
||||
`${this.repoBase(ref)}/issues/${number}`,
|
||||
{ headers: this.headers(), allow404: true },
|
||||
);
|
||||
if (!issue?.state) return null;
|
||||
return issue.state === "closed" ? "closed" : "open";
|
||||
}
|
||||
|
||||
async check(): Promise<ConnectionCheck> {
|
||||
try {
|
||||
if (!this.token) {
|
||||
|
||||
@@ -70,6 +70,16 @@ export class GitLabClient implements GitClient {
|
||||
);
|
||||
}
|
||||
|
||||
async getIssueState(ref: RepoRef, number: number): Promise<"open" | "closed" | null> {
|
||||
const issue = await getJson<{ state?: string } | null>(
|
||||
`${this.apiBase}/projects/${this.projectPath(ref)}/issues/${number}`,
|
||||
{ headers: this.headers(), allow404: true },
|
||||
);
|
||||
if (!issue?.state) return null;
|
||||
// GitLab nennt den offenen Zustand "opened".
|
||||
return issue.state === "closed" ? "closed" : "open";
|
||||
}
|
||||
|
||||
async check(): Promise<ConnectionCheck> {
|
||||
try {
|
||||
if (!this.token) {
|
||||
|
||||
@@ -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",
|
||||
defaultBaseUrl: "https://github.com",
|
||||
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",
|
||||
},
|
||||
GITLAB: {
|
||||
label: "GitLab",
|
||||
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",
|
||||
},
|
||||
GITEA: {
|
||||
label: "Gitea / Forgejo",
|
||||
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",
|
||||
},
|
||||
};
|
||||
|
||||
@@ -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*\(/);
|
||||
}
|
||||
});
|
||||
});
|
||||
@@ -190,6 +190,17 @@ export interface GitClient {
|
||||
* geoeffnet – daher der Schalter statt zweier Methoden.
|
||||
*/
|
||||
setIssueState(ref: RepoRef, number: number, open: boolean): Promise<void>;
|
||||
/**
|
||||
* Liest den Zustand eines einzelnen Issues.
|
||||
*
|
||||
* Gebraucht fuer den Abgleich: der Snapshot fuehrt nur die *offenen*
|
||||
* Issues und ist ausserdem gedeckelt – aus dem Fehlen einer Nummer laesst
|
||||
* sich deshalb nicht schliessen, dass sie geschlossen wurde. Sie koennte
|
||||
* ebenso geloescht oder einfach jenseits des Deckels sein.
|
||||
*
|
||||
* null heisst: gibt es nicht (mehr).
|
||||
*/
|
||||
getIssueState(ref: RepoRef, number: number): Promise<"open" | "closed" | null>;
|
||||
/** Repos, auf die der Token Zugriff hat (fuer die Auswahl beim Verknuepfen). */
|
||||
listRepos(query?: string): Promise<RepoListItem[]>;
|
||||
/** Vollstaendiger Stand eines Repositories. */
|
||||
|
||||
@@ -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);
|
||||
}
|
||||
+22
-1
@@ -5,6 +5,7 @@ import { clientForConnection, createClient, parseRepoUrl } from "@/lib/git";
|
||||
import type { GitClient } from "@/lib/git/types";
|
||||
import { notifyAfterSync } from "@/lib/notify";
|
||||
import { repoTitle } from "@/lib/repositories";
|
||||
import { reconcileLinkedIssues } from "@/lib/tasks/issues";
|
||||
import type { RepoSnapshotData } from "@/lib/git/types";
|
||||
|
||||
export interface SyncResult {
|
||||
@@ -62,11 +63,31 @@ export async function syncRepository(repositoryId: string): Promise<SyncResult>
|
||||
// README hineingeschrieben werden koennen.
|
||||
await maybeRefreshCalendar(repository.id, client, ref);
|
||||
await maybeRefreshReadme(repository.id, client, ref);
|
||||
|
||||
/**
|
||||
* Verknuepfte Aufgaben nachziehen: was in Git geschlossen wurde, wird
|
||||
* hier abgehakt. Der Webhook macht das sofort – ist keiner eingerichtet
|
||||
* oder faellt er aus, greift der Abgleich.
|
||||
*
|
||||
* Die offenen Issues aus dem gerade geholten Snapshot gehen mit hinein:
|
||||
* fuer jede Nummer, die dort steht, ist die Nachfrage gespart.
|
||||
*/
|
||||
const abgehakt = await reconcileLinkedIssues(
|
||||
repository.id,
|
||||
client,
|
||||
ref,
|
||||
data.issues.map((issue) => issue.number),
|
||||
);
|
||||
|
||||
// Nach dem Speichern, damit die Meldung den neuen Stand sieht.
|
||||
await notifyAfterSync(repository.id);
|
||||
return {
|
||||
ok: true,
|
||||
message: `Snapshot aktualisiert: ${data.branches.length} Branches, ${data.tags.length} Tags.`,
|
||||
message:
|
||||
`Snapshot aktualisiert: ${data.branches.length} Branches, ${data.tags.length} Tags.` +
|
||||
(abgehakt > 0
|
||||
? ` ${abgehakt} Aufgabe(n) abgehakt, weil das Issue geschlossen wurde.`
|
||||
: ""),
|
||||
fetchedAt: new Date().toISOString(),
|
||||
};
|
||||
} catch (error) {
|
||||
|
||||
@@ -1,6 +1,9 @@
|
||||
import type { TaskStatus } from "@prisma/client";
|
||||
import { recordActivity, shorten } from "@/lib/activity";
|
||||
import { prisma } from "@/lib/db";
|
||||
import { clientForConnection } from "@/lib/git";
|
||||
import type { GitClient, RepoRef } from "@/lib/git/types";
|
||||
import { nextPosition, refreshDerivedProgress, spawnRecurrence } from "@/lib/tasks";
|
||||
|
||||
/**
|
||||
* Die Bruecke zwischen Nebula-Aufgabe und Git-Issue.
|
||||
@@ -68,3 +71,130 @@ export async function mirrorStatusToIssue(
|
||||
return false;
|
||||
}
|
||||
}
|
||||
|
||||
/**
|
||||
* Hakt eine Aufgabe ab, weil ihr Issue geschlossen wurde.
|
||||
*
|
||||
* Bewusst an einer Stelle fuer beide Wege – Webhook und Abgleich. Vorher
|
||||
* setzte der Webhook nur den Status und liess dabei aus, was die Oberflaeche
|
||||
* tut: die naechste Fassung einer wiederkehrenden Aufgabe anlegen und den
|
||||
* Vorgang in den Verlauf schreiben.
|
||||
*
|
||||
* Gibt false zurueck, wenn nichts zu tun war (Aufgabe fehlt oder ist schon
|
||||
* erledigt) – der Aufrufer kann daran zaehlen, was er bewirkt hat.
|
||||
*/
|
||||
export async function completeTaskFromIssue(
|
||||
taskId: string,
|
||||
herkunft: "webhook" | "abgleich",
|
||||
): Promise<boolean> {
|
||||
const task = await prisma.task.findUnique({
|
||||
where: { id: taskId },
|
||||
select: { id: true, title: true, status: true, projectId: true, sourceIssue: true },
|
||||
});
|
||||
if (!task || task.status === "DONE") return false;
|
||||
|
||||
await prisma.task.update({
|
||||
where: { id: task.id },
|
||||
data: {
|
||||
status: "DONE",
|
||||
doneAt: new Date(),
|
||||
position: await nextPosition(task.projectId, "DONE"),
|
||||
},
|
||||
});
|
||||
|
||||
// Wie beim Abhaken von Hand: eine wiederkehrende Aufgabe erzeugt ihre
|
||||
// naechste Fassung.
|
||||
const folge = await spawnRecurrence(task.id);
|
||||
await refreshDerivedProgress(task.projectId);
|
||||
|
||||
await recordActivity({
|
||||
projectId: task.projectId,
|
||||
// Kein userId: das hat nicht ein Mensch in Nebula getan, sondern das
|
||||
// Git-System gemeldet.
|
||||
kind: "TASK_MOVED",
|
||||
summary:
|
||||
`Issue #${task.sourceIssue} geschlossen → „${shorten(task.title, 40)}“ erledigt` +
|
||||
(herkunft === "abgleich" ? " (beim Abgleich bemerkt)" : "") +
|
||||
(folge ? ", nächste angelegt" : ""),
|
||||
// "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;
|
||||
}
|
||||
|
||||
/** Wie viele Issues ein Abgleich hoechstens einzeln nachfragt. */
|
||||
const MAX_NACHFRAGEN = 25;
|
||||
|
||||
/**
|
||||
* Gleicht beim Abgleich die verknuepften Issues ab: was in Git geschlossen
|
||||
* ist, wird in Nebula abgehakt.
|
||||
*
|
||||
* Warum zusaetzlich zum Webhook: der Webhook wirkt sofort, setzt aber voraus,
|
||||
* dass die Instanz von aussen erreichbar ist und der Haken eingetragen wurde.
|
||||
* Ist er das nicht – oder faellt er einmal aus –, bliebe der Rueckweg sonst
|
||||
* ganz aus. Hier kommt er verzoegert, aber verlaesslich.
|
||||
*
|
||||
* **Nur abhaken, nie zuruecknehmen.** Der Abgleich sieht Zustaende, keine
|
||||
* Ereignisse. Ein offenes Issue kann auch bedeuten, dass das Schliessen von
|
||||
* Nebula aus fehlgeschlagen ist – dann wuerde ein symmetrischer Abgleich eine
|
||||
* bewusst erledigte Aufgabe wieder aufmachen. Das Zuruecknehmen bleibt dem
|
||||
* Webhook vorbehalten, der ein echtes "reopened" sieht.
|
||||
*
|
||||
* Fehler werden geschluckt: ein nicht erreichbares Issue darf den Abgleich
|
||||
* des Repositories nicht scheitern lassen.
|
||||
*/
|
||||
export async function reconcileLinkedIssues(
|
||||
repositoryId: string,
|
||||
client: GitClient,
|
||||
ref: RepoRef,
|
||||
/** Nummern, die der Snapshot gerade als offen gemeldet hat. */
|
||||
offeneNummern: number[] = [],
|
||||
): Promise<number> {
|
||||
const offen = new Set(offeneNummern);
|
||||
|
||||
const kandidaten = await prisma.task.findMany({
|
||||
where: {
|
||||
sourceRepositoryId: repositoryId,
|
||||
sourceIssue: { not: null },
|
||||
status: { not: "DONE" },
|
||||
},
|
||||
select: { id: true, sourceIssue: true },
|
||||
orderBy: { createdAt: "asc" },
|
||||
});
|
||||
|
||||
let abgehakt = 0;
|
||||
let nachfragen = 0;
|
||||
|
||||
for (const task of kandidaten) {
|
||||
const nummer = task.sourceIssue;
|
||||
if (nummer === null) continue;
|
||||
|
||||
// Steht die Nummer in der Liste der offenen Issues, ist nichts zu tun –
|
||||
// und der Aufruf gespart. Umgekehrt gilt das nicht: die Liste ist
|
||||
// gedeckelt, aus dem Fehlen folgt also nichts.
|
||||
if (offen.has(nummer)) continue;
|
||||
|
||||
if (nachfragen >= MAX_NACHFRAGEN) break;
|
||||
nachfragen += 1;
|
||||
|
||||
try {
|
||||
const zustand = await client.getIssueState(ref, nummer);
|
||||
// null heisst "gibt es nicht mehr" – geloescht ist nicht erledigt,
|
||||
// also bleibt die Aufgabe stehen.
|
||||
if (zustand !== "closed") continue;
|
||||
if (await completeTaskFromIssue(task.id, "abgleich")) abgehakt += 1;
|
||||
} catch {
|
||||
// Nichts erreichbar, nichts geaendert – der naechste Lauf versucht es.
|
||||
}
|
||||
}
|
||||
|
||||
return abgehakt;
|
||||
}
|
||||
|
||||
@@ -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 };
|
||||
}
|
||||
|
||||
/** 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 {
|
||||
fullPath: string;
|
||||
owner: string;
|
||||
|
||||
Reference in New Issue
Block a user