From 3e5c6fc627e0f386c509d038088440dc3aea97d6 Mon Sep 17 00:00:00 2001 From: dschlueter Date: Tue, 8 Sep 2026 13:26:40 +0200 Subject: [PATCH] PROGRESS.md Abschnitt 7 auf den heutigen Stand bringen Der Wiederaufnahme-Anker nannte noch 74 Programme, 32 Diagramme und "Phase 6 hat begonnen" - alles ueberholt. Jetzt steht dort: der erreichte Stand, die drei Schritte, die von aussen kommen muessen (Remote-Repository, COLAB_BASIS_URL, Veroeffentlichen), die fuenf bewusst zurueckgestellten Pakete mit Begruendung, der eine rein redaktionelle Punkt (53 gekuerzte Loesungstitel) und vier Dinge, die einer spaeteren Sitzung auffallen und keine Fehler sind. Co-Authored-By: Claude Opus 5 --- PROGRESS.md | 58 ++++++++++++++++++++++++++++++++++++++++++----------- 1 file changed, 46 insertions(+), 12 deletions(-) diff --git a/PROGRESS.md b/PROGRESS.md index 4c3f39e..81fb452 100644 --- a/PROGRESS.md +++ b/PROGRESS.md @@ -1327,11 +1327,13 @@ pytest-Tests grün, Version 03 unberührt. ## 7. Was als Nächstes ansteht -### Der konkret nächste Handgriff +### Der Stand -**Alle sechs Phasen sind abgeschlossen. Seit dem 08.09.2026 ist `Version_04/` ein eigenes -Git-Repository**, und Phase 6 (Umsetzung von `Verbesserungen_02/_03`) hat begonnen. -23 Kapitel, 5 Anhänge, 74 lauffähige Programme, Website mit vier interaktiven Figuren. +**Alle Phasen sind abgeschlossen** — die sechs des Umbaus, dazu Phase 6 bis 8 aus +`Verbesserungen_02.md`/`_03.md`. `Version_04/` ist seit dem 08.09.2026 ein eigenes +Git-Repository. 23 Kapitel, 5 Anhänge, 5 Teil-Synthesen, **76** lauffähige Programme, +141 Aufgaben mit 141 Lösungen, 33 Diagramme, PDF mit 760 Seiten, Website mit vier +interaktiven Figuren. **Zum eigenen Repository — eine Korrektur der früheren Angabe hier:** `git subtree split -P Version_04` hätte die Historie **nicht** mitgenommen. Der Pfad `Version_04/` existiert erst @@ -1341,18 +1343,50 @@ Teilhistorie, die vollständig aussieht und es nicht ist. Volle Historie ginge n übergeordnete Repository bleibt das Archiv der 71 Commits und trägt `Version_04/` in seiner `.gitignore`. -Offen ist weiterhin, was von außen kommt: +### Was von außen kommen muss -* **Veröffentlichen.** `Version_04/OR_HTML_04/` ist selbstgenügsam und direkt auf einen - Webserver kopierbar. -* **Remote-Repository anlegen.** Danach **`COLAB_BASIS_URL`** in `build_version_04.py` auf - Kontoname und Repository-Name setzen — die 25 Colab-Badges hängen daran, und ein falscher - Wert fällt erst beim Klicken auf. +1. **Remote-Repository anlegen und pushen.** +2. **Danach `COLAB_BASIS_URL`** in `build_version_04.py` (Zeile 88) auf Kontoname und + Repository-Namen setzen. Der Wert dort ist ein **Platzhalter** + (`dschlueter/or-mit-python`); die 25 Colab-Badges hängen daran, und ein falscher Wert + fällt erst beim Klicken auf. Danach `--html` neu bauen. +3. **Veröffentlichen.** `OR_HTML_04/` ist selbstgenügsam und direkt auf einen Webserver + kopierbar. -Was einer späteren Sitzung als Erstes auffallen wird und **kein Fehler** ist: +### Bewusst zurückgestellt (aus `Verbesserungen_02/_03`) -* **14 der 32 Diagramme haben keinen Generator.** Dokumentierte Entscheidung — Kästen, +* **Streamlit-Apps** (V03/1, 2, 5) — Entscheidung des Autors. Sie wären eine neue + Artefaktklasse: nicht über die Programmsuite prüfbar, ohne abgedruckte Ausgabe (Regel 4). + Der „Was-wäre-wenn"-Gedanke daraus ist in {ref:sec:praxisfallen-attribution} ohne UI + eingelöst. +* **Zielgruppen-Callouts in allen Kapiteln** (V02/5) — die Lernpfade und die One-Pager aus + 7.1 leisten dasselbe gezielter, ohne Eingriff in jeden Abschnitt. +* **`joblib`/`ray`** (V02/2) — `num_workers` und `ProcessPoolExecutor` decken den Bedarf; + ein Cluster-Framework wäre eine Abhängigkeit ohne Beispiel, das sie braucht. +* **Folium-Karten** (V03/3) — **blockiert durch eine offene Entscheidung**: Die VRP-Instanz + ist ein synthetisches 100 × 100-km-Raster ohne Geokoordinaten. Eine echte Karte verlangt + entweder eine neue Instanz (und damit neue abgedruckte Zahlen) oder eine willkürliche + Verankerung an einem realen Ort. +* **Executive-PDF-Report** (V03/6) — ohne Streamlit-Apps fehlt der Ort, an dem er entstünde. + +### Offen, rein redaktionell + +**53 der 141 Lösungstitel weichen vom Aufgabentitel ab** — durchweg Kürzungen +(„Zweistufiges Modell rechnen" → „Zweistufig rechnen"), alle in den 15 Abschnitten aus +Version 03; die acht in Phase 3 ergänzten stimmen vollständig. Seit 6.1a trägt jede Lösung +wieder die richtige Nummer, die Navigation ist also intakt. Ein Angleichen wäre Kosmetik, +kein Fehler — aber es würde den Anhang lesbarer machen. + +### Was einer späteren Sitzung auffällt und **kein** Fehler ist + +* **14 der 33 Diagramme haben keinen Generator.** Dokumentierte Entscheidung — Kästen, Pfeile, beschriftete Formeln, generische Funktionsverläufe. Kriterium in Abschnitt 6c. +* **`Mutationstest.py` benutzt weiterhin `subprocess`.** Richtig so: Dort läuft pytest auf + einer mutierten Kopie, das ist ein externes Werkzeug auf veränderten Dateien und keine + Import-Isolation (Abschnitt 8.2). +* **Die abgedruckte Ausgabe von `Parallele_Suche.py` ist absichtlich nicht byteidentisch + reproduzierbar.** Die Zahl der verschiedenen Pläne schwankt — und genau das ist die + Aussage des Abschnitts. * **Version 03 ist eingefroren** und liegt in `../Version_03/`. Ihre READMEs nennen als Arbeitsverzeichnis noch `OR_mit_Python`, und ihr generiertes Gesamtdokument liegt minimal hinter den Quellen zurück. Beides bleibt bewusst stehen.