# Auftragsbuch — die Vorschlags-Inbox der Box

Das Auftragsbuch ist das Mensch-Gate des propose-only-Kreislaufs als Klick statt
Git-Handarbeit: alles, was die Box von allein baut oder sich ausdenkt, landet hier
als Karte — du entscheidest mit **Annehmen** oder **Ablehnen**.

## Woher die Karten kommen

- **Fertige Patches** — Branches auf Gitea (`wartung/*`, `orchestrator/*`, `doku/*`,
  `feature/*`), wie die Werkstatt und der Orchestrator sie hinterlassen. Die Karte
  zeigt Commit-Botschaft, geänderte Dateien und den vollen Diff.
- **Skill-Kandidaten** — Ideen des nächtlichen Traum-Crons aus dem Wissens-Vault
  (`~/wissens-vault/skill-kandidaten/`). „Beauftragen" schickt sie als Auftrag an
  die Werkstatt (Orchestrator-Skill); das Ergebnis kommt als neuer Patch zurück.

## Was „Annehmen" bei einem Patch macht (deploy/auftrag-annehmen.sh)

1. Merge des Branches in einem **isolierten Worktree** (Live-Checkout bleibt unberührt).
2. `py_compile`-Gate über die geänderten Python-Dateien.
3. Push nach `main` auf Gitea (mit Retry).
4. Deploy (als /tmp-Kopie von deploy.sh — Selbst-Reset-Falle) — die Zentrale
   startet dabei kurz neu.
5. Health-Check mit Geduld. **Rot ⇒ automatischer Revert des Merges + Redeploy +
   Alarm.** Grün ⇒ Branch wird aufgeräumt, Meldung an Telegram + Chronik.

Der Lauf ist eine eigene systemd-Unit (detached) — er überlebt den Neustart des
Backends, das ihn gestartet hat. Fortschritt steht live auf der Karte
(`/srv/models/mc2-auftragsbuch.json`).

## Leitplanken

- Propose-only bleibt: **nichts geht ohne Klick live.** Das Gate ist dieses Buch.
- „Frontend ohne Build"-Warnung: die Box kann kein Frontend bauen (kein Node) —
  enthält ein Branch `frontend/src` ohne frisches `frontend/dist`, bleibt die
  Oberfläche nach dem Annehmen alt, bis am PC gebaut wird.
- Ablehnen löscht nur den Remote-Branch; die Historie auf Gitea bleibt.

Diese Datei kam übrigens selbst über das Auftragsbuch ins Repo — als erste echte
End-to-End-Annahme (Probe-Branch `wartung/annahme-probe`, 08.07.2026).