63 lines
2.7 KiB
Markdown
63 lines
2.7 KiB
Markdown
# Planer2 — Feature-Verwaltung
|
|
|
|
Verwaltet Features meiner Projekte als Cards und definiert damit die „Wahrheit" je Projekt.
|
|
Rein manuelle Pflege: Sidebar links = Projekte, Hauptbereich = Feature-Cards.
|
|
|
|
- `make dev` — Entwicklung: Backend auf 8200, Frontend auf http://localhost:5274
|
|
- `make build && make web` — Produktion: http://localhost:8200
|
|
- `make test` — Backend-Tests
|
|
|
|
## Karten prüfen
|
|
|
|
Das ⌾-Icon in der Sidebar prüft alle Karten des aktiven Projekts gegen
|
|
`backend/stil.md` (eine Anfrage je Karte). Fehlerhafte Karten öffnen sich rot markiert
|
|
und zeigen unter jeder Stelle einen Vorschlag mit ✓/✕; ✓ schreibt ihn in die Datei, die
|
|
übrigen Vorschläge bleiben stehen. Rechts läuft ein Panel mit Fortschritt und Problemliste.
|
|
|
|
Zugang über `.env` (Vorlage: `.env.example`) — `MINIMAX_API_KEY`, `MINIMAX_MODELL`,
|
|
`MINIMAX_URL`, dazu `PRUEFUNG_PARALLEL` (gleichzeitig geprüfte Karten, Standard 10).
|
|
Fehlt einer der Zugangswerte, bricht die Prüfung mit sichtbarer Meldung ab;
|
|
es wird nie still auf ein anderes Modell ausgewichen. Ergebnisse liegen nur im
|
|
Serverspeicher und überleben keinen Neustart.
|
|
|
|
## Datenablage
|
|
|
|
Markdown-Dateien unter `daten/<projekt>/<feature>.md` — Projekt = Ordner, die Datei ist
|
|
die Wahrheit. Der Editor bearbeitet immer den rohen Text; geparst wird nur für die Anzeige.
|
|
|
|
Format (Marker allein auf einer Zeile; `<!-- funktion -->` ist wiederholbar; `<!-- ziel -->`,
|
|
`<!-- regeln -->` und `<!-- testen -->` nach einer Funktion gehören zu ihr — `ziel`/`regeln`
|
|
vor der ersten Funktion gehören zur Karte; regeln/testen: je eine `- `-Zeile pro Eintrag;
|
|
`<!-- regel -->`-Blöcke aus dem Alt-Format werden zu Zeilen zusammengeführt;
|
|
Trennzeilen aus `---` sind Optik):
|
|
|
|
```markdown
|
|
<!-- titel -->
|
|
Login
|
|
<!-- art -->
|
|
kern
|
|
<!-- ziel -->
|
|
Kurzer Satz, was das Ziel ist.
|
|
<!-- funktion -->
|
|
Anmeldung mit E-Mail
|
|
<!-- regeln -->
|
|
- Passwort nie loggen
|
|
<!-- testen -->
|
|
- Formular öffnen
|
|
- Daten eingeben
|
|
<!-- funktion -->
|
|
Abmeldung
|
|
```
|
|
|
|
Der Kompaktmodus zeigt Ziel und Funktionstitel, der Vollmodus alles — umgeschaltet per
|
|
mittlerer Maustaste auf die Karte oder das Augen-Icon. Bearbeitet wird nur im Vollmodus:
|
|
Klick auf den Text, Verlassen speichert, Escape verwirft; Anlegen und Entfernen laufen
|
|
über das Kontextmenü (Rechtsklick) mit Bestätigung im Modal. Jedes Speichern setzt die
|
|
Datei neu zusammen, Titeländerungen benennen sie passend um.
|
|
|
|
Text vor dem ersten Marker, Inhalt unbekannter Marker und verwaiste regeln/testen-Blöcke
|
|
(auch Alt-Marker `flow`) werden nicht angezeigt, aber beim Speichern erhalten.
|
|
|
|
Hinweis: Sektionen werden im Frontend als Markdown gerendert (`marked`, ohne Sanitizing) —
|
|
die Daten sind lokal und selbst geschrieben.
|