Docs: alle Markdown-Dokumente auf Stand v1.10.0 #9
+74
-34
@@ -7,25 +7,21 @@ Stück für Stück abarbeiten. Reihenfolge ist ein Vorschlag, keine Festlegung.
|
|||||||
|
|
||||||
Was bereits steht, listet [FEATURES.md](FEATURES.md).
|
Was bereits steht, listet [FEATURES.md](FEATURES.md).
|
||||||
|
|
||||||
|
**Stand:** v1.10.0. Alle Issues aus dem Dashboard sind abgearbeitet.
|
||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
## 1 · Als Nächstes empfohlen
|
## 1 · Als Nächstes empfohlen
|
||||||
|
|
||||||
### 1.0 Rest aus v1.6.0: persönliche API-Token `M`
|
### 1.1 Persönliche API-Token `M`
|
||||||
|
|
||||||
Schnellerfassung und die projektübergreifende Aufgabenseite sind mit v1.6.0
|
Der letzte offene Teil aus v1.6.0 („unterwegs erfassen"). Derzeit geht die
|
||||||
ausgeliefert. Offen bleibt der dritte Teil — siehe 1.3. Er gehört sachlich
|
API nur mit Sitzungscookie. Ein Token je Konto würde `curl`-Aufrufe und
|
||||||
dazu: erfassen am Telefon, überblicken an einer Stelle, ansprechen per
|
Handy-Shortcuts erlauben — eine Idee aus dem Terminal anlegen, ohne den
|
||||||
Shortcut.
|
Browser zu öffnen. Nur der Hash in der Datenbank, wie bei den Sitzungen.
|
||||||
|
|
||||||
Bewusst nicht mitgeliefert wurde ein **Index für die übergreifende
|
Bewusst noch nicht angefasst, weil sicherheitsrelevant: Geltungsbereich,
|
||||||
Aufgabenabfrage**. `Task` hat kein `ownerId`, die Trennung läuft über
|
Widerruf und Ablauf wollen entschieden sein, nicht nebenbei gebaut.
|
||||||
`project: { ownerId }`, und `[projectId, status, position]` greift dafür
|
|
||||||
nicht. Bei einigen hundert Aufgaben fällt das nicht auf; wird die Seite
|
|
||||||
träge, ist ein Index auf `dueDate` der erste Griff — und dann eine
|
|
||||||
Migration wert.
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
### 1.2 Läuft es noch? `M`
|
### 1.2 Läuft es noch? `M`
|
||||||
|
|
||||||
@@ -34,24 +30,17 @@ Nebula wüsste dann, ob ein Projekt nicht nur existiert, sondern auch läuft.
|
|||||||
Nutzt Zeitgeber und Benachrichtigungen, die es schon gibt. Der SSRF-Schutz
|
Nutzt Zeitgeber und Benachrichtigungen, die es schon gibt. Der SSRF-Schutz
|
||||||
greift dabei wie bei den Git-Aufrufen.
|
greift dabei wie bei den Git-Aufrufen.
|
||||||
|
|
||||||
### 1.3 Persönliche API-Token `M`
|
### 1.3 Aufgaben ↔ Issues: der Rest `S`
|
||||||
|
|
||||||
Derzeit geht die API nur mit Sitzungscookie. Ein Token je Konto würde
|
Beide Richtungen stehen — „als Issue anlegen" seit v1.7.0, der Rückweg über
|
||||||
`curl`-Aufrufe und Handy-Shortcuts erlauben — Idee aus dem Terminal anlegen,
|
Webhook (v1.7.0) und zusätzlich über den Abgleich (v1.9.0). Offen ist
|
||||||
ohne den Browser zu öffnen. Nur der Hash in der Datenbank, wie bei den
|
Kleinkram:
|
||||||
Sitzungen.
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
### 1.4 Aufgaben ↔ Issues: was noch fehlt `S`
|
|
||||||
|
|
||||||
Mit v1.7.0 stehen beide Richtungen: „als Issue anlegen“ und der Rückweg über
|
|
||||||
Webhooks. Offen geblieben ist Kleinkram:
|
|
||||||
|
|
||||||
- **Mehrere Repositories.** Der Knopf nimmt immer das führende. Bei einem
|
- **Mehrere Repositories.** Der Knopf nimmt immer das führende. Bei einem
|
||||||
Projekt aus Frontend und Backend fehlt die Wahl.
|
Projekt aus Frontend und Backend fehlt die Wahl.
|
||||||
- **Beim Übernehmen aus Issues** wird der Rückweg nicht automatisch
|
- **Webhook beim Verknüpfen anbieten.** Er ist getrennt einzurichten, und
|
||||||
eingerichtet — der Webhook ist getrennt zu setzen.
|
wer das nicht tut, merkt nur an der Verzögerung, dass etwas fehlt. Ein
|
||||||
|
Hinweis an der richtigen Stelle würde reichen.
|
||||||
|
|
||||||
Was **nicht** kommt, bleibt wie besprochen: eine echte beidseitige
|
Was **nicht** kommt, bleibt wie besprochen: eine echte beidseitige
|
||||||
Synchronisation mit Konfliktauflösung. Die Zustände passen ohnehin nicht
|
Synchronisation mit Konfliktauflösung. Die Zustände passen ohnehin nicht
|
||||||
@@ -75,15 +64,60 @@ Voraussetzung, falls du das Projekt veröffentlichen willst.
|
|||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
## 3 · Kleinigkeiten
|
## 3 · Aufgefallen beim Bauen
|
||||||
|
|
||||||
|
Beobachtungen aus der Arbeit an v1.6.0 bis v1.10.0 — festgehalten, damit sie
|
||||||
|
nicht verloren gehen. Nichts davon ist dringend.
|
||||||
|
|
||||||
|
### 3.1 Anwendungsname bricht in der Kopfleiste ab `S`
|
||||||
|
|
||||||
|
Zwischen 320 und 375 px wird aus „Nebula" ein „Neb…". Gemessen über fünf
|
||||||
|
Breiten und zwei Seiten: betrifft alle Seiten gleichermaßen. Seit die
|
||||||
|
Aufgaben als dritter Punkt danebenstehen, ist es enger geworden.
|
||||||
|
|
||||||
|
### 3.2 Indizes für die projektübergreifenden Seiten `S`
|
||||||
|
|
||||||
|
Weder `Task` noch `Activity` haben einen Besitzer — die Trennung läuft über
|
||||||
|
`project: { ownerId }`. Die vorhandenen Indizes
|
||||||
|
(`[projectId, status, position]` bzw. `[projectId, createdAt]`) greifen für
|
||||||
|
Abfragen über alle Projekte deshalb nicht.
|
||||||
|
|
||||||
|
Betroffen sind inzwischen vier Seiten: Aufgabenübersicht, Wochenrückblick,
|
||||||
|
Zeitleiste und die Volltextsuche. Bei einigen hundert Datensätzen fällt das
|
||||||
|
nicht auf. Wird eine der Seiten träge, sind Indizes auf `Task.dueDate` und
|
||||||
|
`Activity.createdAt` der erste Griff — und dann eine Migration wert.
|
||||||
|
|
||||||
|
### 3.3 Projektfilter auf der Zeitleiste `S`
|
||||||
|
|
||||||
|
Über alle Projekte wird die Liste schnell lang. Der Wochenrückblick hat
|
||||||
|
Wochengrenzen als natürliche Bremse, die Zeitleiste nicht. Bewusst
|
||||||
|
weggelassen, weil das Issue nur „derselbe Verlauf, projektübergreifend"
|
||||||
|
verlangte.
|
||||||
|
|
||||||
|
### 3.4 Abgleich gegen geleakte Passwörter `M`
|
||||||
|
|
||||||
|
ASVS 2.1.7 verlangt es; umgesetzt ist bisher nur eine lokale Sperrliste plus
|
||||||
|
Mustererkennung (Wiederholungen, Zeichenfolgen, Benutzername im Passwort).
|
||||||
|
Have-I-Been-Pwned scheidet aus — Nebula ruft grundsätzlich nichts von außen,
|
||||||
|
und ein Passwort-Präfix nach draußen zu geben widerspräche dem erst recht.
|
||||||
|
Eine lokale Top-10000-Liste als Datei wäre der Kompromiss.
|
||||||
|
|
||||||
|
### 3.5 v0.2.0 und v0.3.0 ohne Release `S`
|
||||||
|
|
||||||
|
Beide stehen im Änderungsverlauf, existierten aber nie in der
|
||||||
|
`package.json` — dort springt die Historie von 0.1.0 auf 0.4.0. Nachgetragen
|
||||||
|
wurden sie in dem Commit, der den Verlauf einführte, und der liegt *nach*
|
||||||
|
0.4.0. Es gibt also keinen ehrlichen Commit, an dem ein Tag hängen könnte.
|
||||||
|
Die übrigen 18 Fassungen haben seit dem 18.08.2026 ein Release in Gitea.
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 4 · Kleinigkeiten
|
||||||
|
|
||||||
| Idee | Aufwand | Nutzen |
|
| Idee | Aufwand | Nutzen |
|
||||||
| --- | --- | --- |
|
| --- | --- | --- |
|
||||||
| Wochenrückblick | `S` | „Was ist diese Woche passiert" über alle Projekte, aus dem Aktivitätsverlauf |
|
|
||||||
| Globale Zeitleiste | `S` | Derselbe Verlauf, aber projektübergreifend als eigene Seite |
|
|
||||||
| Suche über Aufgaben | `S` | Die Volltextsuche deckt bisher nur Notizen ab |
|
|
||||||
| Suchtreffer in Notizen hervorheben | `S` | In der Notiz selbst, nicht nur in der Trefferliste |
|
| Suchtreffer in Notizen hervorheben | `S` | In der Notiz selbst, nicht nur in der Trefferliste |
|
||||||
| Aufgabe ↔ Commit verknüpfen | `M` | Enthält ein Commit `#5`, wird die übernommene Aufgabe verlinkt — fällt weitgehend mit 1.4 ab |
|
| Aufgabe ↔ Commit verknüpfen | `M` | Enthält ein Commit `#5`, wird die übernommene Aufgabe verlinkt — fällt weitgehend mit 1.3 ab |
|
||||||
| Tastaturkürzel-Übersicht mit `?` | `S` | Es gibt inzwischen genug davon |
|
| Tastaturkürzel-Übersicht mit `?` | `S` | Es gibt inzwischen genug davon |
|
||||||
| Hell/Dunkel umschaltbar | `M` | Aktuell nur dunkel |
|
| Hell/Dunkel umschaltbar | `M` | Aktuell nur dunkel |
|
||||||
| Eigenes Logo und Farbe | `S` | Ergänzt `APP_NAME` |
|
| Eigenes Logo und Farbe | `S` | Ergänzt `APP_NAME` |
|
||||||
@@ -91,7 +125,7 @@ Voraussetzung, falls du das Projekt veröffentlichen willst.
|
|||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
## 4 · Bewusst nicht
|
## 5 · Bewusst nicht
|
||||||
|
|
||||||
Damit klar ist, was **nicht** kommt und warum:
|
Damit klar ist, was **nicht** kommt und warum:
|
||||||
|
|
||||||
@@ -104,7 +138,10 @@ Damit klar ist, was **nicht** kommt und warum:
|
|||||||
- **Anhänge an Notizen.** Bräuchte Dateispeicher und damit eine zweite Sorge
|
- **Anhänge an Notizen.** Bräuchte Dateispeicher und damit eine zweite Sorge
|
||||||
bei jeder Sicherung. Ein Link ins Git tut es auch.
|
bei jeder Sicherung. Ein Link ins Git tut es auch.
|
||||||
- **Eigene Git-Operationen** (klonen, committen, pushen). Nebula ist eine
|
- **Eigene Git-Operationen** (klonen, committen, pushen). Nebula ist eine
|
||||||
Übersicht, keine Entwicklungsumgebung.
|
Übersicht, keine Entwicklungsumgebung. Issues über die HTTP-API der
|
||||||
|
Provider sind davon nicht berührt — die gibt es seit v1.7.0.
|
||||||
|
- **Beidseitige Synchronisation von Aufgaben und Issues** mit
|
||||||
|
Konfliktauflösung — siehe 1.3.
|
||||||
- **Zeiterfassung, Rechnungen, Kundenverwaltung.** Andere Baustelle.
|
- **Zeiterfassung, Rechnungen, Kundenverwaltung.** Andere Baustelle.
|
||||||
- **Cloud-Synchronisation.** Die Daten bleiben in deiner Datenbank; das ist
|
- **Cloud-Synchronisation.** Die Daten bleiben in deiner Datenbank; das ist
|
||||||
der Punkt.
|
der Punkt.
|
||||||
@@ -138,6 +175,9 @@ Damit klar ist, was **nicht** kommt und warum:
|
|||||||
| **v1.5.0** Sicherheitsdurchsicht, Server-Anleitung und Update-Skript | ✓ |
|
| **v1.5.0** Sicherheitsdurchsicht, Server-Anleitung und Update-Skript | ✓ |
|
||||||
| **v1.6.0** Mobile Ansicht, Listenansicht, Schnellerfassung, Aufgaben über alle Projekte | ✓ |
|
| **v1.6.0** Mobile Ansicht, Listenansicht, Schnellerfassung, Aufgaben über alle Projekte | ✓ |
|
||||||
| **v1.7.0** Aufgabe als Git-Issue anlegen, Webhooks für Push und Issues | ✓ |
|
| **v1.7.0** Aufgabe als Git-Issue anlegen, Webhooks für Push und Issues | ✓ |
|
||||||
|
| **v1.8.0** Anmeldung und Sitzungen nach OWASP: scrypt-Aufwand, Aufzählbarkeit, Leerlauffrist, Cookie-Härtung | ✓ |
|
||||||
|
| **v1.9.0** Geschlossene Issues haken ihre Aufgabe auch ohne Webhook ab | ✓ |
|
||||||
|
| **v1.10.0** Wochenrückblick, globale Zeitleiste, Suche über Aufgaben | ✓ |
|
||||||
|
|
||||||
Zur Entscheidung beim Export: Git-Tokens gehen **nicht** mit. Die Verbindung wird nur
|
Zur Entscheidung beim Export: Git-Tokens gehen **nicht** mit. Die Verbindung wird nur
|
||||||
beschrieben, das Token ist nach dem Import neu zu hinterlegen. Snapshots bleiben
|
beschrieben, das Token ist nach dem Import neu zu hinterlegen. Snapshots bleiben
|
||||||
|
|||||||
Reference in New Issue
Block a user