spec: finalize wealth-ledger SDD migration

2026-10-09 20:41:46 +03:00
parent b24a686188
commit 13e3e53d06
97 changed files with 3444 additions and 244 deletions
@@ -0,0 +1,54 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "reconcile-hourly-investment-sync/investment-resource-envelope.schema.json",
+  "title": "Target investment resource envelope",
+  "description": "Target cross-system semantics only; the backend-generated OpenAPI remains the executable HTTP contract.",
+  "type": "object",
+  "required": ["data", "meta"],
+  "properties": {
+    "data": {
+      "description": "The last confirmed complete result, an allowed incomplete ledger first-load result, or null when no complete result is available."
+    },
+    "meta": { "$ref": "#/$defs/resourceMeta" },
+    "sync": { "$ref": "#/$defs/hourlyWalk" }
+  },
+  "$defs": {
+    "resourceMeta": {
+      "type": "object",
+      "required": ["freshness", "completeness", "lastSuccessfulAt", "lastAttempt", "availability"],
+      "properties": {
+        "freshness": { "enum": ["fresh", "stale", "unknown"] },
+        "completeness": { "enum": ["complete", "incomplete"] },
+        "lastSuccessfulAt": { "type": ["string", "null"], "format": "date-time" },
+        "lastAttempt": { "$ref": "#/$defs/attempt" },
+        "availability": { "enum": ["available", "initial-loading", "temporarily-unavailable", "connection-unavailable"] }
+      }
+    },
+    "attempt": {
+      "type": "object",
+      "required": ["state", "startedAt", "finishedAt", "problems"],
+      "properties": {
+        "state": { "enum": ["none", "running", "succeeded", "partial", "failed"] },
+        "startedAt": { "type": ["string", "null"], "format": "date-time" },
+        "finishedAt": { "type": ["string", "null"], "format": "date-time" },
+        "problems": { "type": "array", "items": { "$ref": "#/$defs/problemSection" } }
+      }
+    },
+    "hourlyWalk": {
+      "description": "Present only on Accounts; absent from other resource envelopes.",
+      "oneOf": [
+        { "type": "null" },
+        { "$ref": "#/$defs/attempt" }
+      ]
+    },
+    "problemSection": {
+      "type": "object",
+      "required": ["section", "accountId", "errorCode"],
+      "properties": {
+        "section": { "enum": ["membership", "portfolio", "operations", "events"] },
+        "accountId": { "type": ["string", "null"] },
+        "errorCode": { "type": ["string", "null"] }
+      }
+    }
+  }
+}