u

.cursor/rules/no-assumed-api.mdc

@@ -0,0 +1,53 @@
+---
+description: Nie API-Verträge raten — immer Backend-Doku lesen
+alwaysApply: true
+---
+
+# Keine angenommenen APIs
+
+API-Shapes, Endpoints und Response-Felder **niemals erraten**, **niemals** aus ähnlichen Endpoints ableiten, **niemals** im Chat „vorschlagen“ und dann direkt implementieren.
+
+## Quelle der Wahrheit (in dieser Reihenfolge)
+
+1. **Laufendes Backend** — `dashback/docs/api/` (Markdown pro Route) und `dashback/docs/api/openapi.json`
+2. **`src/api/index.js`** — nur Spiegel des Backend-Vertrags, keine Erfindung
+3. **Explizite User-Vorgabe** — nur wenn der User den Vertrag wörtlich nennt
+
+Fehlt (1): **nicht implementieren**. Stattdessen Doku lesen oder User fragen.
+
+## Verboten
+
+```js
+// ❌ „PATCH liefert { article }, also sicher auch POST …/image“
+requireObject(res.article, 'article');
+
+// ❌ Endpoint oder Feldname erfinden
+return httpMultipart(`/api/article/${sku}/photos`, …);
+
+// ❌ Response-Shape aus Konvention ableiten
+onArticleUpdated?.(res.article ?? res.data);
+```
+
+```js
+// ✅ Vertrag aus dashback übernommen, in index.js dokumentiert
+// POST /api/article/:sku/image → 201 { image: { picId, sort, full, thumb, hash, thumbHash } }
+requireObject(res.image, 'image');
+```
+
+## Pflicht-Workflow bei neuem oder geändertem Endpoint
+
+1. Route in `dashback/docs/api` oder `openapi.json` finden und lesen
+2. Method, Path, Request-Body, Status-Codes, Response-JSON exakt notieren
+3. `src/api/index.js` kommentieren und Client-Methode schreiben
+4. Response mit `requireObject` / `requireArray` / `requireDefined` aus `apiShape.js` validieren
+5. Kein Frontend-Code, der Felder nutzt, die nicht im Vertrag stehen (z. B. `photo.url` wenn nur `thumbHash` dokumentiert ist)
+
+## Erlaubt
+
+- **Backend-Doku aktualisieren**, wenn der User den Vertrag bewusst ändert — danach Frontend anpassen
+- **Blockieren mit Frage**, wenn Vertrag unklar oder widersprüchlich ist
+
+## Zusammenspiel mit `no-silent-fallbacks`
+
+- Keine Fallbacks auf alternative Feldnamen oder Endpoints
+- Kein „vielleicht heißt es `article` oder `image`“ — der Vertrag legt es fest