docs(ZMS): require routing.php for new zmsbackend API controllers

Call out that new controllers must be registered in zmsbackend/routing.php as part of the API-layer checklist.

Author: ThomasAFink

docs/de/setup-and-development/getting-started/implement-a-user-story.md

@@ -45,7 +45,7 @@ flowchart TD
     schemaModel --> apiController[In API-Controller propagieren<br/><code>Api</code>-Ordner in <code>zmsbackend</code>]
     maybeController --> apiController
     apiController --> apiElse{"Muss ich sonst noch etwas<br/>in der <code>zmsbackend</code>-<br/>API-Schicht ändern?"}
-    apiElse -->|Ja| apiMore[Routen, neue Endpunkte,<br/>Request-Handling, Statuscodes, …]
+    apiElse -->|Ja| apiMore[Neuer Controller → in<br/><code>zmsbackend/routing.php</code> eintragen<br/>plus Request-Handling, Statuscodes, …]
     apiElse -->|Nein| apiDone[API-Schicht für diese Story fertig]
     apiMore --> apiDone
   end
@@ -136,6 +136,7 @@ Typisches Layout:
 - `zmsentities/schema/` — JSON Schema für Entities (und zugehörige Citizen-API-Schemas)
 - `zmsentities` PHP-Entity-Klassen — die Modelle zu diesen Schemas
 - `zmsbackend/src/Zmsbackend/.../Api/` — API-Controller, die diese Entities in Responses zurückgeben
+- `zmsbackend/routing.php` — Slim-Routen, die URL-Pfade an diese Controller binden
 
 **Frage 4: Muss ich das JSON-Schema / Modell in `zmsentities` ändern oder ergänzen, damit ich die Änderung in der API-Controller-Response propagieren kann?**
 
@@ -146,13 +147,14 @@ Typisches Layout:
 
 Wenn die Response-Form stimmt, mache einen letzten Check der API-Oberfläche in `zmsbackend` (typisch unter `.../Api/`):
 
-- neue oder geänderte Routen / Endpunkte
+- **neuer Controller** → du **musst** ihn in [`zmsbackend/routing.php`](https://github.com/it-at-m/eappointment/blob/main/zmsbackend/routing.php) registrieren (Slim-Route → Controller-Klasse); die Controller-Datei allein reicht nicht
+- neue oder geänderte Routen / Endpunkte für bestehende Controller (ebenfalls in `routing.php`)
 - Request-Parsing oder Validierung
 - welcher Service-Aufruf im Controller
 - HTTP-Statuscodes, Fehler oder Auth-/Rechteprüfungen
 - verwandte Controller, die denselben Contract einhalten müssen
 
-- **Ja** — schließe diese API-Schicht-Änderungen ab, bevor du `zmsbackend` verlässt.
+- **Ja** — schließe diese API-Schicht-Änderungen ab (inkl. `routing.php`, wenn du einen Controller hinzugefügt hast), bevor du `zmsbackend` verlässt.
 - **Nein** — die API-Schicht ist für diese Story fertig.
 
 Beide Antworten **schließen** den Backend-Pfad für diese Story. Weiter unter [Oberhalb der API](#oberhalb-der-api).

docs/en/setup-and-development/getting-started/implement-a-user-story.md

@@ -45,7 +45,7 @@ flowchart TD
     schemaModel --> apiController[Propagate in API controller<br/><code>Api</code> folders in <code>zmsbackend</code>]
     maybeController --> apiController
     apiController --> apiElse{"Do I need to change anything<br/>else in the <code>zmsbackend</code><br/>API layer?"}
-    apiElse -->|Yes| apiMore[Routes, new endpoints,<br/>request handling, status codes, …]
+    apiElse -->|Yes| apiMore[New controller → register in<br/><code>zmsbackend/routing.php</code><br/>plus request handling, status codes, …]
     apiElse -->|No| apiDone[API layer done for this story]
     apiMore --> apiDone
   end
@@ -136,6 +136,7 @@ Typical layout:
 - `zmsentities/schema/` — JSON Schema for entities (and related citizen API schemas)
 - `zmsentities` PHP entity classes — the models that follow those schemas
 - `zmsbackend/src/Zmsbackend/.../Api/` — API controllers that return those entities in responses
+- `zmsbackend/routing.php` — Slim routes that wire URL paths to those controllers
 
 **Question 4: Do I need to change or add the JSON schema / model in `zmsentities` so I can propagate the changes in my API controller response?**
 
@@ -146,13 +147,14 @@ Typical layout:
 
 After the response shape is right, do a final pass on the API surface in `zmsbackend` (typically under `.../Api/`):
 
-- new or changed routes / endpoints
+- **new controller** → you **must** register it in [`zmsbackend/routing.php`](https://github.com/it-at-m/eappointment/blob/main/zmsbackend/routing.php) (Slim route → controller class); a controller file alone is not enough
+- new or changed routes / endpoints for existing controllers (also in `routing.php`)
 - request parsing or validation
 - which service method the controller calls
 - HTTP status codes, errors, or auth/permission checks
 - related controllers that must stay consistent with the same contract
 
-- **Yes** — finish those API-layer changes before leaving `zmsbackend`.
+- **Yes** — finish those API-layer changes (including `routing.php` when you added a controller) before leaving `zmsbackend`.
 - **No** — the API layer is done for this story.
 
 Either answer **closes** the backend path for this story. Continue at [Above the API](#above-the-api).