Schema

1{
2  "$schema": "https://json-schema.org/draft/2020-12/schema",
3  "$id": "https://wix.com/replatform/domain-knowledge.schema.json",
4  "title": "RePlatform Wix Domain Knowledge Entity",
5  "type": "object",
6  "additionalProperties": true,
7  "required": [
8    "schemaVersion",
9    "domain",
10    "entity",
11    "displayName",
12    "target",
13    "sourceAliases",
14    "preferredWrite",
15    "reliability",
16    "pitfalls",
17    "mappingGuidance",
18    "evidence"
19  ],
20  "properties": {
21    "schemaVersion": { "const": 1 },
22    "domain": { "type": "string", "minLength": 1 },
23    "entity": { "type": "string", "minLength": 1 },
24    "displayName": { "type": "string", "minLength": 1 },
25    "target": {
26      "type": "object",
27      "required": ["classification", "idPolicy", "crosswalkRequired"],
28      "properties": {
29        "classification": {
30          "enum": [
31            "native",
32            "cms",
33            "native-plus-cms",
34            "setup-config",
35            "skip-by-default",
36            "unsupported-native-gap"
37          ]
38        },
39        "nativeEntity": { "type": ["string", "null"] },
40        "verifiedFqdn": { "type": ["string", "null"] },
41        "idPolicy": {
42          "enum": ["client-assigned", "server-assigned", "natural-key", "not-applicable"]
43        },
44        "crosswalkRequired": { "type": "boolean" }
45      }
46    },
47    "preferredWrite": {
48      "type": "object",
49      "required": ["surface", "endpoint", "writerId", "verification", "importSafe", "bulk"],
50      "properties": {
51        "surface": { "type": "string" },
52        "endpoint": { "type": ["string", "null"] },
53        "writerId": { "type": ["string", "null"] },
54        "verification": {
55          "enum": ["verified-live", "docs", "source-review", "internal-only", "unverified", "none"]
56        },
57        "importSafe": { "type": "boolean" },
58        "bulk": { "type": "boolean" }
59      }
60    },
61    "reliability": {
62      "type": "object",
63      "required": ["status", "flags"],
64      "properties": {
65        "status": { "enum": ["reliable", "partially-reliable", "unreliable", "unknown"] },
66        "flags": { "type": "array", "items": { "type": "string" } }
67      }
68    },
69    "safeModeContactFields": {
70      "type": "array",
71      "items": {
72        "type": "object",
73        "required": ["kind", "targetPath", "source"],
74        "properties": {
75          "kind": { "enum": ["email", "phone"] },
76          "targetPath": { "type": "string", "minLength": 1 },
77          "source": { "type": "string", "minLength": 1 },
78          "notes": { "type": "string" }
79        },
80        "additionalProperties": true
81      }
82    }
83  }
84}