Import documentation: docs/frontend-api-contracts.md

Import the existing local project snapshot. This commit organizes existing files; it does not represent newly developed functionality.
2026-09-18 23:11:39 +03:30
parent 2885f9cc8d
commit d7cb844751
1 changed files with 33 additions and 0 deletions
@@ -0,0 +1,33 @@
+# Frontend API Contracts
+
+Contracts are defined in `src/api/contracts`.
+
+Every service returns:
+
+```json
+{
+  "data": {},
+  "meta": {
+    "requestId": "req_..."
+  },
+  "error": null
+}
+```
+
+Errors return:
+
+```json
+{
+  "data": null,
+  "meta": {
+    "requestId": "req_..."
+  },
+  "error": {
+    "code": "VALIDATION_ERROR",
+    "message": "Human-readable message",
+    "fields": {}
+  }
+}
+```
+
+Shared DTOs cover pagination, filtering, sorting, bulk operations, jobs, job progress, audit metadata, permission checks, and WebSocket events.