# Linux-Testumgebung — PolyTrader-Teil

**Stand: 28.08.2026**

> ## ⚠️ Die Anleitung ist umgezogen
>
> Die vollständige, gepflegte Fassung liegt jetzt im **Deploymentcenter-Repo**:
>
> **`J:\Softwareprojekte\Deploymentcenter\docs\TESTUMGEBUNG.md`**
>
> Diese Datei hier enthält nur noch, was **PolyTrader-eigen** ist.

**Warum der Umzug.** Die Anleitung galt von Anfang an projektübergreifend — sie regelt
Datenbanknamen, X-Displays und Portvergabe für *alle* Projekte auf der geteilten VM. Sie lag
trotzdem im PolyTrader-Repo, weil sie beim ersten Linux-Lauf von PolyTrader entstanden ist.

Das war die falsche Heimat, und es fiel auf, als die Testumgebung an die vorhandene Infrastruktur
angeschlossen wurde: Lizenzschlüssel, Release-Ablage und Bugtracker gehören dem Deploymentcenter,
und die Beschreibung, wie ein Agent sie benutzt, gehört dorthin, wo sie mit ihnen gemeinsam
gepflegt wird. Ein Agent in Predictalytics hätte die Regeln für sein X-Display sonst in einem
fremden Handelsprojekt suchen müssen.

---

## Was neu ist

Auf der VM muss nichts mehr von Hand besorgt werden, was das Deploymentcenter schon hat:

```bash
curl -fsSL https://dc.mhdf.de/testkit/dc-testkit.sh -o ~/bin/dc-testkit && chmod +x ~/bin/dc-testkit

dc-testkit doctor      # Werkzeuge, Netz, Token, Projekt
dc-testkit license     # befristeten DEV-Lizenzschlüssel selbst holen
dc-testkit run         # ausliefern, prüfen, aktualisieren — meldet, was scheitert
dc-testkit report --type bug --title "…" --desc "…"
```

Voraussetzung ist ein **Werkbank-Token** für PolyTrader (Besitzerart `dev_agent`, Rechte
`bugtracker:manage` und `license:dev`). Das legt ein Mensch einmalig im Deploymentcenter-WebUI an;
siehe `TESTUMGEBUNG.md` §4.2.

**Kein Kundenschlüssel mehr auf der Test-VM.** Ein DEV-Schlüssel läuft nach 30 Tagen ab, ist in
der Aktivierungsliste als Testhardware erkennbar und verbraucht keine Aktivierungsplätze einer
echten Lizenz.

---

## PolyTrader-eigene Festlegungen

Diese Werte stehen auch in der Belegungsliste der Hauptanleitung (§7); hier stehen sie, damit man
sie beim Arbeiten am Projekt nicht dort suchen muss.

| Was | Wert |
|---|---|
| X-Display | **`:99`** — fest für PolyTrader |
| Datenbank | `polytrader_test`, Benutzer `polytrader_test`@`localhost` |
| Passwortdatei | `~/.polytrader_test_dbpw` (Rechte 600) |
| systemd-Unit | `polytrader.service`, Konto `polytrader`, Verzeichnis `/opt/polytrader` |
| Publish-Verzeichnis | `~/polytrader-test` |
| Dateien in `/tmp` | immer mit Präfix `polytrader_` |
| Fenstername für `xdotool` | `^PolyTrader$` |

⚠️ **`xvfb-run -n 99`, niemals `-a`.** Das `-a` sucht sich selbst ein freies Display und beginnt
dabei bei `:99` — also ausgerechnet auf PolyTraders Nummer.

⚠️ **Keine Produktivdatenbank verbinden.** Der `MarketSyncService` synchronisiert selbständig
Marktdaten, sobald er läuft — auch dann, wenn niemand ihn darum gebeten hat.

---

## Wo die alten Abschnitte jetzt stehen

Ältere Dokumente in diesem Repo verweisen auf Abschnittsnummern dieser Datei. Die Nummerierung hat
sich durch den neuen Testkit-Abschnitt verschoben:

| Alt (hier) | Neu (`Deploymentcenter/docs/TESTUMGEBUNG.md`) |
|---|---|
| §1 Was diese Maschine ist | §1 — unverändert |
| §2 Zugang einrichten | §2 — unverändert |
| §3 Was installiert ist | §3 — unverändert |
| — | **§4 Das Testkit** (neu) |
| §4.1 Datenbanken | §5.1 |
| §4.2 Verzeichnisse | §5.2 |
| §4.3 systemd-Dienste | §5.3 |
| §4.4 Ports | §5.4 |
| §4.5 X-Displays | §5.5 |
| §4.6 Erhöhte Rechte | §5.6 |
| §4.7 GUI ohne Bildschirm | §5.7 |
| **§4.8 Oberflächen selbst begutachten** | **§5.8** |
| §5 Was hier nicht passieren darf | §6 |
| §6 Belegung | §7 |
| **§7 Aufräumen** | **§8** |
| §8 Bekannte Einschränkungen | §9 |

Betroffen sind [BEFUND-Linux-Betrieb-2026-08-26.md](./pruefplaene/BEFUND-Linux-Betrieb-2026-08-26.md)
(§4.8 und §7) und [ROADMAP.md](./ROADMAP.md). Die Verweise wurden bewusst **nicht** umgeschrieben:
Ein Befundbericht ist eine Momentaufnahme und soll lesen wie am Tag seiner Erstellung. Diese
Tabelle löst sie auf.