Initial commit: a0_software_orchestrator v1.0

- Auto-Registration-Bug behoben (register_project/get_project_id/resolve_project Trennung)
- 25 Tests gruen (Pytest)
- block_compactor-Tool refactored (Option B: Soft-Check statt Hard-Block)
- 4 Restbaustellen gefixt
- DB-Schema: plugin_settings-Tabelle hinzugefuegt
- 3 Schattenprojekte aus DB geloescht
- Plan v3 + Refactor-Plan + Worklog dokumentiert

help/coolify-deploy/14_api_usage.md

@@ -0,0 +1,63 @@
+# 14_api_usage.md
+
+# API Usage
+
+Keine Coolify-Endpunkte erfinden.
+
+## Workflow
+
+```text
+Auth prüfen
+Version/Health prüfen
+Teams/Projects/Servers/Destinations lesen
+Resource lesen
+Änderung planen
+Write ausführen
+Readback
+Deploy
+Logs/Status
+Report
+```
+
+## Regeln
+
+```text
+404 = stoppen, nicht raten.
+422 = Payload/Schema prüfen.
+Delete nie ohne expliziten Auftrag.
+Write immer mit Readback.
+Capability Check vor Key-, Domain-, Env-, Deploy-Workflow.
+```
+
+## Write Actions
+
+```text
+create/update resource
+set env
+set domain
+set volumes
+set build settings
+deploy/restart
+```
+
+## Fallback
+
+Wenn API nicht reicht:
+
+```text
+UI-Schritt dokumentieren
+manuelle Aktion nennen
+nicht behaupten, API könne es
+```
+
+## Report
+
+```yaml
+api_report:
+  checked:
+  used:
+  writes:
+  readback:
+  unsupported:
+  manual_steps:
+```