Version 04 als eigenes Repository

Erster Commit des Strangs "Optimierte Entscheidungsfindung mit Python"
(Version 04). Die Historie der 71 Commits bis zur Trennung bleibt im
uebergeordneten Repository OR_mit_Python liegen, das ab jetzt nur noch
Version_03 (eingefroren) verwaltet und Version_04/ ignoriert.

Bewusst kein "git subtree split": Der Pfad Version_04/ existiert erst seit
der Verzeichnistrennung, ein Split braechte daher nur 7 der 41 einschlaegigen
Commits - eine Teilhistorie, die vollstaendig aussieht und es nicht ist.

Stand: 5 Teile, 23 Kapitel, 5 Anhaenge, 292 Abschnitte, 703 Querverweise,
325 Indexmarken, 73 Beispielprogramme, 32 SVGs, 4 Plotly-Figuren,
25 Notebooks, PDF mit 715 Seiten.

Zusaetzlich in diesem Commit:

* pyproject.toml mit Abhaengigkeitsgruppen finance, large-scale, api,
  figures, dev, empfehlungen. Die abgedruckte requirements.txt bleibt
  unveraendert daneben bestehen. ortools steht in der Grundausstattung,
  highspy erst in [large-scale] - so kann der HiGHS-Symbolkonflikt bei der
  schlanken Installation gar nicht erst auftreten.

* Dabei zwei Funde: graphviz wird von erzeuge_architektur_diagramme.py
  importiert, fehlt aber in requirements.txt (jetzt in [figures]); pymoo
  steht in requirements.txt, wird aber von keinem Programm importiert,
  sondern nur im Kapitel Metaheuristiken empfohlen (jetzt in
  [empfehlungen]).

* NEUER_TITEL.md nach Kritik_und_Verbesserungsvorschlaege/ verschoben - es
  ist die Vorlage des Titelblatts, kein Bestandteil des Werks. Die beiden
  Fundstellen in PROGRESS.md und erzeuge_titelseite.py nachgezogen.

* PROGRESS.md nannte noch den Untertitel der ersten Fassung; auf den
  tatsaechlichen aus erzeuge_titelseite.py korrigiert.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>

pyproject.toml

@@ -0,0 +1,105 @@
+# Paketbeschreibung fuer die Beispielprogramme des Buchs
+# "Optimierte Entscheidungsfindung mit Python".
+#
+# Zweck: schlanke, gezielt zusammengestellte Umgebungen. Wer nur die ersten
+# Kapitel durcharbeitet, braucht weder yfinance noch FastAPI.
+#
+#   pip install -e .                  # Grundausstattung, traegt den Grossteil des Buchs
+#   pip install -e ".[finance]"       # Teil "Anwendungen": Markowitz, CVaR, Handelsmaschine
+#   pip install -e ".[large-scale]"   # HiGHS, Pyomo, linopy, polars
+#   pip install -e ".[api]"           # Kapitel "Testen, Messen, Ausliefern"
+#   pip install -e ".[figures]"       # nur zum Neuerzeugen der Diagramme
+#   pip install -e ".[dev]"           # Tests
+#   pip install -e ".[alles]"         # alles zusammen - siehe Warnung unten
+#
+# ACHTUNG, Solverkonflikt: ortools und highspy bringen jeweils eine eigene
+# HiGHS-Kopie mit und lassen sich nicht im selben Prozess importieren. ortools
+# steht deshalb in der Grundausstattung, highspy erst in [large-scale] - wer nur
+# "pip install -e ." nutzt, kann in den Konflikt gar nicht geraten. cvxpy zieht
+# ein installiertes highspy bei der Solver-Erkennung selbst mit hinein, [finance]
+# loest ihn also indirekt ebenfalls aus. Die Programme des Buchs umgehen das
+# durch getrennte Prozesse (Muster: Ein_System_Vier_Ansaetze.py); ausfuehrlich
+# steht es im Kapitel "Das Python-Oekosystem fuer OR".
+#
+# Die Datei ergaenzt
+# Operations_Research_mit_Python_Version_04_Programme/requirements.txt und
+# ersetzt sie nicht: Jene ist im Buch abgedruckt und installiert bewusst alles
+# auf einen Schlag.
+
+[build-system]
+requires = ["setuptools>=68"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "or-mit-python"
+version = "4.0.0"
+description = "Beispielprogramme zum Buch 'Optimierte Entscheidungsfindung mit Python'"
+readme = "README.md"
+requires-python = ">=3.10"
+authors = [{ name = "Dieter Schlüter", email = "dieter.schlueter@linix.de" }]
+keywords = ["operations-research", "optimierung", "linear-programming",
+            "constraint-programming", "milp", "lehrbuch"]
+
+# Grundausstattung: traegt die Kapitel bis einschliesslich Graphen und Touren.
+# scipy liefert linprog/milp, ortools den CP-SAT-Solver und pywraplp.
+dependencies = [
+    "numpy>=2.5.2",
+    "scipy>=1.17.1",
+    "pandas>=3.0.1",
+    "matplotlib>=3.10.8",
+    "openpyxl>=3.1.5",   # kein direkter Import: Excel-Motor hinter pandas
+    "pydantic>=2.12",
+    "ortools>=9.15.6755",
+]
+
+[project.optional-dependencies]
+# Teil "Anwendungen - Energiewirtschaft und Finanzmaerkte"
+finance = [
+    "cvxpy>=1.9.2",
+    "scikit-learn>=1.8.0",
+    "yfinance>=1.2.0",
+]
+
+# Groessere Modelle, alternative Solver und Modellierungsschichten
+large-scale = [
+    "highspy>=1.15.1",
+    "Pyomo>=6.7",
+    "linopy>=0.3",
+    "polars>=1.0",
+]
+
+# Kapitel "Testen, Messen, Ausliefern": der Optimierungsdienst
+api = [
+    "fastapi>=0.115",
+    "uvicorn>=0.30",
+    "httpx>=0.27",       # Selbsttest des Dienstes ueber den TestClient
+]
+
+# Nur zum Neuerzeugen der Diagramme in bilder_04/ - fuer das Lesen und
+# Ausfuehren des Buchs nicht noetig. graphviz braucht zusaetzlich das
+# Kommandozeilenwerkzeug 'dot' aus dem Betriebssystempaket.
+figures = [
+    "plotly>=6.0",
+    "graphviz>=0.20",
+]
+
+dev = [
+    "pytest>=8.0",
+]
+
+# pymoo wird im Buch als Bibliothek fuer genetische Algorithmen empfohlen
+# (Kapitel Metaheuristiken), aber von keinem Beispielprogramm importiert.
+# Deshalb steht es hier eigenstaendig und nicht in der Grundausstattung.
+empfehlungen = [
+    "pymoo>=0.6",
+]
+
+alles = [
+    "or-mit-python[finance,large-scale,api,figures,dev,empfehlungen]",
+]
+
+[tool.setuptools]
+# Die Beispielprogramme sind ein erzeugtes Artefakt (extract_programme_04.py)
+# und kein installierbares Paket - hier wird nur der Abhaengigkeitsbaum
+# beschrieben.
+packages = []