- *.archify-decision files: id (unique, words), title, status, date, elements, diagrams, supersedes, and prose; parsed, merged and link-checked in the model index; diagnostics on the file - diagrams point at decisions with decisions: [...] on the diagram, nodes and edges; stripped before Archify, unknown ids reported, completion, hover and go-to-definition for the ids and for elements/diagrams/ supersedes in decision files - Decisions panel on the main.archify page; Decisions rail panel under a diagram (hover lights up the node or connection); decisions on element cards and in the element dialog; decision view for the file, with a lost-model note outside a model - Archify | New Decision… command and template; editor schemas; the three New Model examples carry decisions; docs, changelog, 0.8.0
300 lines
7.7 KiB
JSON
300 lines
7.7 KiB
JSON
{
|
|
"$schema": "https://json-schema.org/draft/2020-12/schema",
|
|
"title": "Archify Sequence Diagram",
|
|
"type": "object",
|
|
"additionalProperties": false,
|
|
"required": [
|
|
"schema_version",
|
|
"diagram_type",
|
|
"meta",
|
|
"participants",
|
|
"messages"
|
|
],
|
|
"properties": {
|
|
"schema_version": {
|
|
"const": 1
|
|
},
|
|
"diagram_type": {
|
|
"const": "sequence"
|
|
},
|
|
"meta": {
|
|
"type": "object",
|
|
"additionalProperties": false,
|
|
"required": [
|
|
"title",
|
|
"output"
|
|
],
|
|
"properties": {
|
|
"title": {
|
|
"type": "string",
|
|
"minLength": 1
|
|
},
|
|
"locale": {
|
|
"$ref": "common.schema.json#/$defs/locale"
|
|
},
|
|
"translations": {
|
|
"$ref": "common.schema.json#/$defs/translations"
|
|
},
|
|
"subtitle": {
|
|
"type": "string"
|
|
},
|
|
"output": {
|
|
"$ref": "common.schema.json#/$defs/portableOutputPath"
|
|
},
|
|
"animation": {
|
|
"$ref": "common.schema.json#/$defs/animation"
|
|
},
|
|
"visual_preset": {
|
|
"$ref": "common.schema.json#/$defs/visualPreset"
|
|
},
|
|
"quality_profile": {
|
|
"$ref": "common.schema.json#/$defs/qualityProfile"
|
|
},
|
|
"column_fit": {
|
|
"description": "Horizontal participant layout. Omit this field or use fixed for the stable 86px boxes and 108px gap. Use spread when a wide viewBox would leave unused horizontal space or meaningful participant labels do not fit the fixed boxes; spread derives wider boxes and gaps from the viewBox without changing participant order or message semantics.",
|
|
"enum": [
|
|
"fixed",
|
|
"spread"
|
|
]
|
|
},
|
|
"repository": {
|
|
"$ref": "common.schema.json#/$defs/repository"
|
|
},
|
|
"views": {
|
|
"$ref": "common.schema.json#/$defs/guidedViews"
|
|
},
|
|
"legend": {
|
|
"type": "object",
|
|
"additionalProperties": false,
|
|
"properties": {
|
|
"mode": {
|
|
"$ref": "common.schema.json#/$defs/legendMode"
|
|
},
|
|
"entries": {
|
|
"type": "object",
|
|
"additionalProperties": false,
|
|
"properties": {
|
|
"default": {
|
|
"$ref": "common.schema.json#/$defs/legendEntry"
|
|
},
|
|
"emphasis": {
|
|
"$ref": "common.schema.json#/$defs/legendEntry"
|
|
},
|
|
"security": {
|
|
"$ref": "common.schema.json#/$defs/legendEntry"
|
|
},
|
|
"dashed": {
|
|
"$ref": "common.schema.json#/$defs/legendEntry"
|
|
},
|
|
"return": {
|
|
"$ref": "common.schema.json#/$defs/legendEntry"
|
|
}
|
|
}
|
|
}
|
|
}
|
|
},
|
|
"viewBox": {
|
|
"type": "array",
|
|
"prefixItems": [
|
|
{
|
|
"type": "number",
|
|
"minimum": 480
|
|
},
|
|
{
|
|
"type": "number",
|
|
"minimum": 480
|
|
}
|
|
],
|
|
"items": false,
|
|
"minItems": 2,
|
|
"maxItems": 2
|
|
}
|
|
}
|
|
},
|
|
"participants": {
|
|
"type": "array",
|
|
"minItems": 2,
|
|
"items": {
|
|
"type": "object",
|
|
"additionalProperties": false,
|
|
"required": [
|
|
"id",
|
|
"type",
|
|
"label"
|
|
],
|
|
"properties": {
|
|
"id": {
|
|
"$ref": "common.schema.json#/$defs/id"
|
|
},
|
|
"type": {
|
|
"$ref": "common.schema.json#/$defs/componentType"
|
|
},
|
|
"label": {
|
|
"type": "string",
|
|
"minLength": 1
|
|
},
|
|
"sublabel": {
|
|
"type": "string"
|
|
},
|
|
"icon": {
|
|
"$ref": "common.schema.json#/$defs/nodeIcon"
|
|
},
|
|
"brand": {
|
|
"$ref": "common.schema.json#/$defs/brandMark"
|
|
},
|
|
"sources": {
|
|
"$ref": "common.schema.json#/$defs/sourceReferences"
|
|
},
|
|
"decisions": {
|
|
"type": "array",
|
|
"items": {
|
|
"type": "string",
|
|
"minLength": 1
|
|
},
|
|
"description": "Ids of architecture decisions (*.archify-decision files of the model) this is about. Shown in the Decisions panel under the diagram."
|
|
}
|
|
}
|
|
}
|
|
},
|
|
"segments": {
|
|
"type": "array",
|
|
"items": {
|
|
"type": "object",
|
|
"additionalProperties": false,
|
|
"required": [
|
|
"from",
|
|
"to",
|
|
"label"
|
|
],
|
|
"properties": {
|
|
"from": {
|
|
"type": "number"
|
|
},
|
|
"to": {
|
|
"type": "number"
|
|
},
|
|
"label": {
|
|
"type": "string",
|
|
"minLength": 1
|
|
}
|
|
}
|
|
}
|
|
},
|
|
"messages": {
|
|
"type": "array",
|
|
"minItems": 1,
|
|
"items": {
|
|
"type": "object",
|
|
"additionalProperties": false,
|
|
"required": [
|
|
"from",
|
|
"to",
|
|
"y",
|
|
"label"
|
|
],
|
|
"properties": {
|
|
"id": {
|
|
"$ref": "common.schema.json#/$defs/id"
|
|
},
|
|
"from": {
|
|
"$ref": "common.schema.json#/$defs/id"
|
|
},
|
|
"to": {
|
|
"$ref": "common.schema.json#/$defs/id"
|
|
},
|
|
"y": {
|
|
"type": "number",
|
|
"minimum": 160
|
|
},
|
|
"label": {
|
|
"type": "string",
|
|
"minLength": 1
|
|
},
|
|
"variant": {
|
|
"enum": [
|
|
"default",
|
|
"emphasis",
|
|
"security",
|
|
"dashed",
|
|
"return"
|
|
]
|
|
},
|
|
"note": {
|
|
"type": "string"
|
|
},
|
|
"decisions": {
|
|
"type": "array",
|
|
"items": {
|
|
"type": "string",
|
|
"minLength": 1
|
|
},
|
|
"description": "Ids of architecture decisions (*.archify-decision files of the model) this is about. Shown in the Decisions panel under the diagram."
|
|
}
|
|
}
|
|
}
|
|
},
|
|
"activations": {
|
|
"type": "array",
|
|
"items": {
|
|
"type": "object",
|
|
"additionalProperties": false,
|
|
"required": [
|
|
"participant",
|
|
"from",
|
|
"to"
|
|
],
|
|
"properties": {
|
|
"participant": {
|
|
"$ref": "common.schema.json#/$defs/id"
|
|
},
|
|
"from": {
|
|
"type": "number"
|
|
},
|
|
"to": {
|
|
"type": "number"
|
|
},
|
|
"type": {
|
|
"$ref": "common.schema.json#/$defs/componentType"
|
|
}
|
|
}
|
|
}
|
|
},
|
|
"cards": {
|
|
"$ref": "common.schema.json#/$defs/cards"
|
|
},
|
|
"model": {
|
|
"type": "object",
|
|
"description": "Only in main.archify: the entry point of a model (a folder of diagrams that belong together).",
|
|
"additionalProperties": false,
|
|
"required": [
|
|
"id",
|
|
"name"
|
|
],
|
|
"properties": {
|
|
"id": {
|
|
"type": "string",
|
|
"pattern": "^[a-zA-Z][a-zA-Z0-9_-]*$",
|
|
"description": "Stable id of the model."
|
|
},
|
|
"name": {
|
|
"type": "string",
|
|
"minLength": 1,
|
|
"description": "Name shown on the model page."
|
|
},
|
|
"description": {
|
|
"type": "string",
|
|
"description": "What the model covers; shown on the model page."
|
|
}
|
|
}
|
|
},
|
|
"decisions": {
|
|
"type": "array",
|
|
"items": {
|
|
"type": "string",
|
|
"minLength": 1
|
|
},
|
|
"description": "Ids of architecture decisions (*.archify-decision files of the model) this is about. Shown in the Decisions panel under the diagram."
|
|
}
|
|
}
|
|
}
|