feat(2.7.0): Roadmap im DC, Testinstanz mit Testtor, Supervisor und MCP
Sammelcommit fuer den ueber mehrere Sitzungen gewachsenen, bisher nicht
eingecheckten Stand. Getrennte Commits waeren ehrlicher gewesen, sind es
nachtraeglich aber nicht mehr: BugRepo, changelog.json und die Doku tragen
Aenderungen aus allen Straengen gleichzeitig, und keine Zwischenstufe waere
lauffaehig.
ROADMAP IM DEPLOYMENTCENTER (2.7.0)
Planungsstand, Reihenfolge und Zustaendigkeit lagen in handgepflegten
Markdown-Dateien neben einem Bugtracker, der genau diese drei Dinge bereits
fuehrt. Zwei Pfleger fuer dasselbe Feld - Drift war eine Frage der Zeit.
Ab jetzt: Zustand im DC, Begruendung in der Datei. Kein Feld hat zwei Pfleger.
- Migration 016: epic, roadmap_rank, target_build, defer_trigger,
doc_anchor, Status "deferred", Tabelle roadmap_epics.
KEINE Roadmap-Tabelle - ein Eintrag ist ein bugtracker_item.
- Zugehoerigkeit ist ein Feld: Ein Item steht auf der Roadmap, wenn es ein
epic hat. Ein zweites Kennzeichen daneben koennte auseinanderlaufen.
- Kennung ist die Item-ID. Handvergebene Kuerzel ("A12") erzeugen die
schlimmste Fehlerart: Beide Seiten stimmig, Verschiedenes gemeint, weil
die Kennung nach einer Loeschung neu vergeben wurde.
- Zurueckstellen verlangt defer_trigger. Ohne benannten Anlass ist ein
Vorhaben nicht zurueckgestellt, sondern vergessen. Die Regel sitzt im
Repository, damit sie auf allen drei Schreibwegen gleich greift.
- Modules/Bugtracker/Roadmap.php, /api/bugtracker/v1/roadmap.php,
WebUI-Modul mit Filtern, cli/roadmap.php --write/--check,
dc_roadmap und dc_roadmap_set im MCP-Adapter.
- cli/roadmap.php --write ERZEUGT den Zustandsteil der Markdown-Datei;
--check prueft nur die Prosa. Was erzeugt wird, kann nicht driften.
- docs/ROADMAP_MIGRATION.md: Uebernahme fuer die anderen Projekte.
TESTINSTANZ UND TESTTOR
- dc-dev.mhdf.de: zweite Installation, eigene DB, eigene Schluessel,
Basic-Auth davor, Rocket.Chat aus.
- 124 Testfaelle in tests/e2e gegen API, Rechte, Migrationen, Sperre.
- scripts/deploy.py bringt vor jedem Upload erst den anstehenden Stand auf
die Testinstanz und laesst dann den Testlauf laufen. Erst bei
Rueckgabewert 0 geht etwas auf die Produktion (--ohne-test als Notausgang).
Andersherum prueft der Lauf aelteren Code als den, der gleich hochgeht.
- tests/ ist aus dem Produktiv-Deploy ausgeschlossen; testctl.php kann
nicht versehentlich auf dc.mhdf.de landen.
- Ein Lauf mit mehr uebersprungenen als geprueften Faellen endet mit
Rueckgabewert 2 statt 0. Nichts ist kaputt, geprueft wurde es aber auch
nicht - der Unterschied darf nicht am Rueckgabewert verschwinden.
SUPERVISOR, PROJEKTLANDSCHAFT, NACHPRUEFUNG (2.6.0/2.6.1)
- Migration 013: projektuebergreifend melden (dev_agent, evidence,
triage_external, affects).
- Migration 014: supervisor_findings, Katalog, fuenf serverseitige
Detektoren im Tick.
- Migration 015: Nachpruefung als Arbeitsschlange statt Benachrichtigung.
- DEV-Lizenzschluessel zur Selbstbedienung, dc-testkit fuer die Test-VM.
- MCP-Adapter: 15 Werkzeuge, ohne Fremdabhaengigkeiten, mit Abgrenzung
von Fremddaten gegen Prompt-Injektion.
BEHOBEN
- observe und status im Supervisor legten den Zustand des Befundes als
"status" in die Antwort. Http::ok() merged ['status' => 'success']
darunter, also gewann der Befundzustand - eine angenommene Meldung kam
als status="open" an. Heisst jetzt finding_status. War Item #59.
Migrationen 013-016 sind auf dem Produktivserver noch NICHT ausgefuehrt.
Ohne sie bricht das WebUI, weil die Roadmap-Ansicht bei jedem Seitenaufruf
gegen bugtracker_items.epic abfragt.
Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
This commit is contained in:
co-authored by
Claude Opus 5
parent
9d0261306c
commit
1d5ac92051
@@ -1,7 +1,23 @@
|
||||
#!/usr/bin/env python3
|
||||
"""
|
||||
Deployment auf die Produktion (dc.mhdf.de).
|
||||
|
||||
Vor dem Upload laeuft der Testlauf gegen die Testinstanz: erst wird der
|
||||
aktuelle Stand nach dc-dev.mhdf.de gebracht, dann tests/e2e ausgefuehrt.
|
||||
Erst wenn der durchlaeuft, geht etwas auf die Produktion.
|
||||
|
||||
Warum in dieser Reihenfolge und nicht "Tests gegen den vorhandenen Dev-Stand":
|
||||
Sonst prueft der Lauf einen aelteren Stand als den, der gleich hochgeht - und
|
||||
gibt gruenes Licht fuer Code, den er nie gesehen hat.
|
||||
|
||||
python scripts/deploy.py # mit Testlauf
|
||||
python scripts/deploy.py --dry-run # nur anzeigen (ohne Testlauf)
|
||||
python scripts/deploy.py --ohne-test # Testlauf ueberspringen
|
||||
"""
|
||||
import os
|
||||
import json
|
||||
import ftplib
|
||||
import subprocess
|
||||
import sys
|
||||
import hashlib
|
||||
from pathlib import Path
|
||||
@@ -33,6 +49,11 @@ IGNORE_PATTERNS = {
|
||||
# von upload_installer.py dorthin gebracht - ueber diesen Weg landeten
|
||||
# sonst ~100 MB zusaetzlich unter /artifacts/ im Webroot.
|
||||
'artifacts',
|
||||
# Testcode. Er laeuft gegen die Testinstanz, nicht auf dem Server. Darin
|
||||
# liegt testctl.php, das Tabellen loeschen kann - auf der Produktion hat
|
||||
# das nichts zu suchen, auch nicht gesperrt. Ausgeliefert wird es
|
||||
# ausschliesslich von scripts/deploy_dev.py.
|
||||
'tests',
|
||||
}
|
||||
|
||||
def load_config():
|
||||
@@ -211,8 +232,51 @@ def deploy():
|
||||
|
||||
print(f"\nDeployment abgeschlossen: {uploaded} von {len(files_to_upload)} Datei(en) uebertragen.")
|
||||
|
||||
def testlauf() -> None:
|
||||
"""
|
||||
Testinstanz aktualisieren und tests/e2e ausfuehren. Bricht bei einem
|
||||
Fehlschlag ab, bevor irgendetwas auf die Produktion geht.
|
||||
|
||||
Bekannte, im Bugtracker gemeldete Befunde lassen den Lauf durch (siehe
|
||||
tests/e2e/bekannte_befunde.json). Ohne diese Unterscheidung waere das Tor
|
||||
entweder dauerhaft zu oder es wuerde nach der ersten Umgehung nie wieder
|
||||
ernst genommen.
|
||||
"""
|
||||
dev_config = SCRIPT_DIR / 'deploy_dev_config.json'
|
||||
if not dev_config.exists():
|
||||
print("Abbruch: %s fehlt - ohne Testinstanz laesst sich der Testlauf nicht" % dev_config)
|
||||
print("ausfuehren. Vorlage: scripts/deploy_dev_config.example.json")
|
||||
print("Notfalls (und nur dann): python scripts/deploy.py --ohne-test")
|
||||
sys.exit(1)
|
||||
|
||||
for beschreibung, befehl in (
|
||||
("Testinstanz aktualisieren", [sys.executable, str(SCRIPT_DIR / 'deploy_dev.py')]),
|
||||
("Testlauf", [sys.executable, str(PROJECT_DIR / 'tests' / 'e2e' / 'run.py')]),
|
||||
):
|
||||
print("=" * 70)
|
||||
print("%s ..." % beschreibung)
|
||||
print("=" * 70)
|
||||
# Ohne flush stuende die Ueberschrift bei umgeleiteter Ausgabe hinter
|
||||
# der Ausgabe des Unterprozesses - das Protokoll waere unlesbar.
|
||||
sys.stdout.flush()
|
||||
ergebnis = subprocess.run(befehl, cwd=str(PROJECT_DIR))
|
||||
if ergebnis.returncode != 0:
|
||||
print("")
|
||||
print("Abbruch: %s fehlgeschlagen (Rueckgabewert %d)." % (beschreibung, ergebnis.returncode))
|
||||
print("Auf die Produktion wurde nichts uebertragen.")
|
||||
print("")
|
||||
print("Einzelne Faelle nachsehen:")
|
||||
print(" python tests/e2e/run.py --nur \"<Name>\" --log")
|
||||
sys.exit(ergebnis.returncode)
|
||||
print("")
|
||||
|
||||
|
||||
if __name__ == '__main__':
|
||||
if '--dry-run' in sys.argv or '-n' in sys.argv:
|
||||
dry_run()
|
||||
else:
|
||||
if '--ohne-test' in sys.argv:
|
||||
print("Testlauf uebersprungen (--ohne-test).")
|
||||
else:
|
||||
testlauf()
|
||||
deploy()
|
||||
|
||||
Reference in New Issue
Block a user