Richard/Deploymentcenter
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

feat(2.9.1): Die Begruendung zieht ins Deploymentcenter, die Datei wird erzeugt

Browse Source 
Bis hierher galt eine Zweiteilung: Zustand im Deploymentcenter, Begruendung
in docs/ROADMAP.md, verbunden ueber doc_anchor. Die Beschreibung der
uebernommenen Eintraege sagte es woertlich - "Die Begruendung steht weiterhin
in der Datei - hier steht nur der Zustand."

Zwei Folgen, die erst im Betrieb sichtbar wurden:

1. Die Roadmap-Tafel kann die Begruendung nicht zeigen. Sie sieht die
   Datenbank; die Datei liegt auf einem Entwicklungsrechner. Im Seitenpanel
   stand deshalb nur doc_anchor als nicht anklickbarer Text mit dem Hinweis,
   er zeige auf etwas, das das WebUI nie zu sehen bekommt.

2. Schwerer: Die Beschreibung von dc_roadmap wies Agenten an, vor dem
   erneuten Vorschlagen eines zurueckgestellten Vorhabens "diesen Absatz" zu
   lesen. Ein Agent in polytrader oder clawddotnet kann ihn nicht lesen - er
   liegt in einem fremden Repository. Die Anweisung war nicht befolgbar.

Dazu kam, dass cli/roadmap.php --check PHP braucht und auf dem
Windows-Arbeitsplatz keines liegt: Die Haelfte der Pflegemaschinerie, die die
Zweiteilung zusammenhalten sollte, lief dort nie.

== Was sich aendert ==
bugtracker_items und roadmap_epics tragen rationale (Migration 020). Ein
EIGENES Feld neben description, nicht statt dessen: description sagt, was
gemeldet wurde, und kommt oft von einer fremden Maschine; rationale sagt,
warum wir uns so entschieden haben. Zusammengelegt haette jede redaktionelle
Ueberarbeitung den urspruenglichen Wortlaut der Meldung ueberschrieben, also
die Grundlage, auf der entschieden wurde.

Der Verlauf vermerkt nur, DASS die Begruendung sich geaendert hat und um wie
viele Zeichen. Der ganze Absatz ein zweites Mal im Verlauf haette ihn nach
der fuenften Ueberarbeitung unlesbar gemacht.

== Der Weg herauf, einmalig ==
?action=import_rationale liest eine mitgeschickte Roadmap-Datei. Drei Formen
werden erkannt: Bereichsabschnitte, Vorhabensabschnitte und Tabellenzeilen.
Die dritte ist kein Beiwerk - der Abschnitt "Verworfen" fuehrt seine zwoelf
Ablehnungen als Tabelle, und ohne sie bliebe ausgerechnet das nicht am Item
auffindbar, was am haeufigsten gebraucht wird: warum etwas schon einmal
abgelehnt wurde. Ohne overwrite=true bleibt stehen, was im DC schon steht.

== Der Weg herunter, dauerhaft ==
Ein zweites Markerpaar dc:rationale neben dc:roadmap. Bewusst ein zweites und
keine Erweiterung des ersten: Zwischen den beiden steht in jeder gewachsenen
Roadmap-Datei Handgeschriebenes - Einleitung, Leitlinie, Statuszeichen -, und
ein einziger Block haette das beim naechsten Erzeugen verschluckt.
?action=render_file setzt beide Bloecke serverseitig ein, damit die
Markersuche nur einmal umgesetzt ist. Sie hat eine Feinheit, die zweimal
umgesetzt zweimal verschieden waere: Ein im Fliesstext ERWAEHNTER Marker darf
nicht gefunden werden - die Einleitung dieser Datei erwaehnt jetzt beide.

== Werkzeuge ==
scripts/dc.py roadmap-import und roadmap-write, in Python und nicht in
cli/roadmap.php - sonst waeren sie auf dem Arbeitsplatz wieder nicht
aufrufbar. roadmap-write behaelt die Zeilenenden der Datei bei.

== Bestand ==
35 Vorhaben und 6 Bereiche aus docs/ROADMAP.md uebernommen, 476 Zeilen
handgepflegte Prosa durch den erzeugten Block ersetzt. Gegengeprueft auf
Wortebene: Aus dem Fliesstext fehlt nichts, die einzigen Abweichungen sind
die ersetzten Ueberschriften und die alte Einleitung.

Kaertchen ohne hinterlegte Begruendung tragen auf der Tafel eine dezente
Marke - erledigte nicht, dort waere sie ein Vorwurf ohne Adressaten.

MCP-Adapter auf 1.3.0: dc_roadmap_set nimmt rationale, und die Beschreibung
von dc_roadmap verweist nicht mehr auf eine Datei, die der Agent nicht
erreichen kann.

Geprueft: 7 neue Testfaelle, Suite gesamt 179 von 179.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
This commit is contained in:
Deploymentcenter Bot
2026-09-20 18:59:06 +02:00
co-authored by Claude Opus 5
parent 700be4614c
commit 8f514eb17a
12 changed files with 1416 additions and 191 deletions
Download Patch File Download Diff File Expand all files Collapse all files
public/api/bugtracker/v1/roadmap.php
+76 -4
View File
@@ -35,8 +35,8 @@ use Deploymentcenter\Modules\Bugtracker\RoadmapBoard;
Http::beginJson(['GET', 'POST', 'OPTIONS'], true);
const READ_ACTIONS = ['list', 'epics', 'next', 'active', 'render', 'check', 'board'];
const WRITE_ACTIONS = ['set', 'move', 'reorder', 'epic', 'rank_between'];
const READ_ACTIONS = ['list', 'epics', 'next', 'active', 'render', 'render_file', 'check', 'board'];
const WRITE_ACTIONS = ['set', 'move', 'reorder', 'epic', 'rank_between', 'import_rationale'];
$action = strtolower(Http::str('action') ?? 'list');
@@ -115,9 +115,47 @@ switch ($action) {
case 'render': {
$project = requireProject($scope, $context);
// Zwei erzeugte Bloecke: der Zustand (Vorgabe) und die
// Begruendungen. Getrennt abrufbar, weil sie an verschiedenen
// Stellen der Datei stehen und je ein eigenes Markerpaar haben.
$part = strtolower(Http::str('part') ?? 'state');
if (!in_array($part, ['state', 'rationale'], true)) {
Http::fail(400, 'unknown_part', 'Erlaubt sind "state" und "rationale".');
}
Http::ok([
'project_slug' => $project,
'markdown' => $roadmap->renderBlock($project),
'part' => $part,
'markdown' => $part === 'rationale'
? $roadmap->renderRationaleBlock($project)
: $roadmap->renderBlock($project),
]);
}
case 'render_file': {
// Die ganze Datei, beide erzeugten Bloecke eingesetzt.
//
// Das Einsetzen laeuft hier und nicht im Aufrufer: Die Markersuche
// hat Feinheiten - ein im Fliesstext ERWAEHNTER Marker darf nicht
// gefunden werden -, und die zweimal umzusetzen hiesse, sie beim
// zweiten Mal anders umzusetzen. Der Aufrufer schickt den
// Dateiinhalt und schreibt zurueck, was er bekommt.
$project = requireProject($scope, $context);
$content = Http::str('content');
if ($content === null) {
Http::fail(400, 'missing_content', 'Das Feld "content" mit dem Dateiinhalt fehlt.');
}
$neu = Roadmap::spliceBlock($content, $roadmap->renderBlock($project));
$neu = Roadmap::spliceRationaleBlock($neu, $roadmap->renderRationaleBlock($project));
Http::ok([
'project_slug' => $project,
'markdown' => $neu,
'changed' => $neu !== $content,
]);
}
@@ -196,7 +234,7 @@ switch ($action) {
// weiterhin ueber /manage - ein zweiter Schreibweg auf dieselben
// Spalten waere eine zweite Stelle, an der Regeln gelten muessten.
$updates = [];
foreach (['epic', 'target_build', 'defer_trigger', 'doc_anchor'] as $field) {
foreach (['epic', 'target_build', 'defer_trigger', 'doc_anchor', 'rationale'] as $field) {
if (Http::input($field) !== null) {
$updates[$field] = Http::str($field);
}
@@ -314,6 +352,40 @@ switch ($action) {
]);
}
case 'import_rationale': {
// Einmaliger Weg herauf: Die Begruendungen, die bisher nur in der
// Projektdatei standen, werden eingelesen. Der Dateiinhalt kommt
// mitgeschickt - genau wie bei action=check und aus demselben Grund:
// Die Datei liegt im Repository des Projekts, oft auf einer anderen
// Maschine, und der Server soll nicht anfangen, in Verzeichnissen zu
// suchen.
$project = requireProject($writeProject ?? $angefragt, $context);
$content = Http::str('content');
if ($content === null) {
Http::fail(400, 'missing_content', 'Das Feld "content" mit dem Dateiinhalt fehlt.');
}
// Ohne overwrite bleibt stehen, was schon hinterlegt ist. Ein zweiter
// Lauf soll eine im Deploymentcenter ueberarbeitete Begruendung nicht
// stillschweigend auf den Stand der Datei zuruecksetzen.
$overwrite = (bool)Http::input('overwrite', false);
$bericht = $roadmap->importRationale($project, $content, $overwrite);
Http::ok([
'project_slug' => $project,
'overwrite' => $overwrite,
'report' => $bericht,
'message' => sprintf(
'%d Abschnitt(e) gelesen, %d Vorhaben und %d Bereich(e) uebernommen.',
$bericht['gefunden'],
$bericht['items']['gespeichert'],
$bericht['epics']['gespeichert']
),
]);
}
case 'reorder': {
$project = requireProject($writeProject ?? $angefragt, $context);
$epic = Http::str('epic');