create-yss-spec 3.3.7 → 3.4.1

package/template/docs/process/schemas/strategic-design-handoff-v5.schema.json

@@ -0,0 +1,932 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://yss.dev/schemas/strategic-design-handoff-v5.schema.json",
+  "title": "YSS 业务方案交接包",
+  "type": "object",
+  "additionalProperties": false,
+  "required": [
+    "schema_version",
+    "handoff_id",
+    "handoff_version",
+    "status",
+    "source",
+    "source_context_snapshot",
+    "context_delta",
+    "consumer_routes",
+    "problem_and_business_outcomes",
+    "bounded_context_and_subdomain_map",
+    "context_map_and_translation_responsibility",
+    "ubiquitous_language_and_concept_candidates",
+    "scenarios_and_business_invariants",
+    "tactical_design_questions",
+    "deferred_decisions_and_ownership",
+    "evidence_and_version_digests",
+    "acceptance",
+    "ui_baseline_kind"
+  ],
+  "properties": {
+    "schema_version": {
+      "const": 5
+    },
+    "handoff_id": {
+      "type": "string",
+      "pattern": "^strategic-design-handoff\\.[a-z0-9][a-z0-9-]*$"
+    },
+    "handoff_version": {
+      "type": "string",
+      "pattern": "^v[0-9]+$"
+    },
+    "status": {
+      "enum": [
+        "draft",
+        "ready-for-human",
+        "approved",
+        "stale",
+        "blocked"
+      ]
+    },
+    "source": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "domain_strategy_ref",
+        "stage_decision_package_ref",
+        "spec_ref",
+        "business_ticket_set_ref"
+      ],
+      "properties": {
+        "domain_strategy_ref": {
+          "$ref": "#/$defs/versionedRef"
+        },
+        "stage_decision_package_ref": {
+          "$ref": "#/$defs/versionedRef"
+        },
+        "spec_ref": {
+          "$ref": "#/$defs/versionedRef"
+        },
+        "prototype_ref": {
+          "$ref": "#/$defs/versionedRef"
+        },
+        "visual_baseline_ref": {
+          "$ref": "#/$defs/visualBaselineRef"
+        },
+        "business_ticket_set_ref": {
+          "$ref": "#/$defs/versionedRef"
+        },
+        "existing_ui_baseline_ref": {
+          "$ref": "#/$defs/existingUiBaselineRef"
+        }
+      }
+    },
+    "source_context_snapshot": {
+      "$ref": "#/$defs/contextSnapshot"
+    },
+    "context_delta": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "added",
+        "updated",
+        "deprecated"
+      ],
+      "properties": {
+        "added": {
+          "$ref": "#/$defs/contextTerms"
+        },
+        "updated": {
+          "$ref": "#/$defs/contextTerms"
+        },
+        "deprecated": {
+          "$ref": "#/$defs/contextTerms"
+        }
+      }
+    },
+    "consumer_routes": {
+      "type": "array",
+      "minItems": 3,
+      "maxItems": 3,
+      "items": {
+        "$ref": "#/$defs/consumerRoute"
+      }
+    },
+    "problem_and_business_outcomes": {
+      "$ref": "#/$defs/nonEmptyStrings"
+    },
+    "bounded_context_and_subdomain_map": {
+      "$ref": "#/$defs/nonEmptyStrings"
+    },
+    "context_map_and_translation_responsibility": {
+      "$ref": "#/$defs/nonEmptyStrings"
+    },
+    "ubiquitous_language_and_concept_candidates": {
+      "$ref": "#/$defs/nonEmptyStrings"
+    },
+    "scenarios_and_business_invariants": {
+      "$ref": "#/$defs/nonEmptyStrings"
+    },
+    "tactical_design_questions": {
+      "$ref": "#/$defs/nonEmptyStrings"
+    },
+    "deferred_decisions_and_ownership": {
+      "type": "array",
+      "items": {
+        "$ref": "#/$defs/deferred"
+      }
+    },
+    "evidence_and_version_digests": {
+      "$ref": "#/$defs/nonEmptyStrings"
+    },
+    "acceptance": {
+      "$ref": "#/$defs/nonEmptyStrings"
+    },
+    "package_export": {
+      "$schema": "https://json-schema.org/draft/2020-12/schema",
+      "$id": "https://yss.dev/schemas/strategic-handoff-export.schema.json",
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "schema_version",
+        "approvals",
+        "additional_files",
+        "reference_map",
+        "ui_baseline_kind"
+      ],
+      "properties": {
+        "schema_version": {
+          "const": 2
+        },
+        "approvals": {
+          "type": "object",
+          "additionalProperties": false,
+          "required": [
+            "domain_strategy_ref",
+            "stage_decision_package_ref",
+            "spec_ref",
+            "business_ticket_set_ref",
+            "handoff"
+          ],
+          "properties": {
+            "domain_strategy_ref": {
+              "type": "object",
+              "additionalProperties": false,
+              "required": [
+                "record_ref",
+                "gate_id",
+                "digest_kind"
+              ],
+              "properties": {
+                "record_ref": {
+                  "type": "string",
+                  "minLength": 1
+                },
+                "gate_id": {
+                  "type": "string",
+                  "minLength": 1
+                },
+                "digest_kind": {
+                  "enum": [
+                    "canonical-json",
+                    "sha256-bytes",
+                    "visual-baseline"
+                  ]
+                }
+              }
+            },
+            "stage_decision_package_ref": {
+              "type": "object",
+              "additionalProperties": false,
+              "required": [
+                "record_ref",
+                "gate_id",
+                "digest_kind"
+              ],
+              "properties": {
+                "record_ref": {
+                  "type": "string",
+                  "minLength": 1
+                },
+                "gate_id": {
+                  "type": "string",
+                  "minLength": 1
+                },
+                "digest_kind": {
+                  "enum": [
+                    "canonical-json",
+                    "sha256-bytes",
+                    "visual-baseline"
+                  ]
+                }
+              }
+            },
+            "spec_ref": {
+              "type": "object",
+              "additionalProperties": false,
+              "required": [
+                "record_ref",
+                "gate_id",
+                "digest_kind"
+              ],
+              "properties": {
+                "record_ref": {
+                  "type": "string",
+                  "minLength": 1
+                },
+                "gate_id": {
+                  "type": "string",
+                  "minLength": 1
+                },
+                "digest_kind": {
+                  "enum": [
+                    "canonical-json",
+                    "sha256-bytes",
+                    "visual-baseline"
+                  ]
+                }
+              }
+            },
+            "prototype_ref": {
+              "type": "object",
+              "additionalProperties": false,
+              "required": [
+                "record_ref",
+                "gate_id",
+                "digest_kind"
+              ],
+              "properties": {
+                "record_ref": {
+                  "type": "string",
+                  "minLength": 1
+                },
+                "gate_id": {
+                  "type": "string",
+                  "minLength": 1
+                },
+                "digest_kind": {
+                  "enum": [
+                    "canonical-json",
+                    "sha256-bytes",
+                    "visual-baseline"
+                  ]
+                }
+              }
+            },
+            "visual_baseline_ref": {
+              "type": "object",
+              "additionalProperties": false,
+              "required": [
+                "record_ref",
+                "gate_id",
+                "digest_kind"
+              ],
+              "properties": {
+                "record_ref": {
+                  "type": "string",
+                  "minLength": 1
+                },
+                "gate_id": {
+                  "type": "string",
+                  "minLength": 1
+                },
+                "digest_kind": {
+                  "enum": [
+                    "canonical-json",
+                    "sha256-bytes",
+                    "visual-baseline"
+                  ]
+                }
+              }
+            },
+            "business_ticket_set_ref": {
+              "type": "object",
+              "additionalProperties": false,
+              "required": [
+                "record_ref",
+                "gate_id",
+                "digest_kind"
+              ],
+              "properties": {
+                "record_ref": {
+                  "type": "string",
+                  "minLength": 1
+                },
+                "gate_id": {
+                  "type": "string",
+                  "minLength": 1
+                },
+                "digest_kind": {
+                  "enum": [
+                    "canonical-json",
+                    "sha256-bytes",
+                    "visual-baseline"
+                  ]
+                }
+              }
+            },
+            "handoff": {
+              "type": "object",
+              "additionalProperties": false,
+              "required": [
+                "record_ref",
+                "gate_id",
+                "digest_kind"
+              ],
+              "properties": {
+                "record_ref": {
+                  "type": "string",
+                  "minLength": 1
+                },
+                "gate_id": {
+                  "type": "string",
+                  "minLength": 1
+                },
+                "digest_kind": {
+                  "enum": [
+                    "canonical-json",
+                    "sha256-bytes",
+                    "visual-baseline"
+                  ]
+                }
+              }
+            },
+            "existing_ui_baseline_ref": {
+              "type": "object",
+              "additionalProperties": false,
+              "required": [
+                "record_ref",
+                "gate_id",
+                "digest_kind"
+              ],
+              "properties": {
+                "record_ref": {
+                  "type": "string",
+                  "minLength": 1
+                },
+                "gate_id": {
+                  "type": "string",
+                  "minLength": 1
+                },
+                "digest_kind": {
+                  "const": "sha256-bytes"
+                }
+              }
+            }
+          }
+        },
+        "additional_files": {
+          "type": "array",
+          "items": {
+            "type": "string",
+            "minLength": 1
+          },
+          "minItems": 0
+        },
+        "reference_map": {
+          "type": "object",
+          "additionalProperties": {
+            "type": "string",
+            "minLength": 1
+          }
+        },
+        "prototype": {
+          "type": "object",
+          "additionalProperties": false,
+          "required": [
+            "profile",
+            "preview_root",
+            "entry_ref",
+            "verification_ref",
+            "verification_digest"
+          ],
+          "properties": {
+            "profile": {
+              "enum": [
+                "H1",
+                "H2"
+              ]
+            },
+            "preview_root": {
+              "type": "string",
+              "minLength": 1
+            },
+            "entry_ref": {
+              "type": "string",
+              "minLength": 1
+            },
+            "verification_ref": {
+              "type": "string",
+              "minLength": 1
+            },
+            "source_root": {
+              "type": "string",
+              "minLength": 1
+            },
+            "lock_ref": {
+              "type": "string",
+              "minLength": 1
+            },
+            "verification_digest": {
+              "type": "string",
+              "pattern": "^sha256:[a-f0-9]{64}$"
+            },
+            "source_digest": {
+              "type": "string",
+              "pattern": "^sha256:[a-f0-9]{64}$"
+            }
+          },
+          "allOf": [
+            {
+              "if": {
+                "properties": {
+                  "profile": {
+                    "const": "H2"
+                  }
+                }
+              },
+              "then": {
+                "required": [
+                  "source_root",
+                  "lock_ref",
+                  "source_digest"
+                ]
+              }
+            }
+          ]
+        },
+        "ui_baseline_kind": {
+          "enum": [
+            "prototype",
+            "existing-ui-baseline"
+          ]
+        }
+      },
+      "allOf": [
+        {
+          "if": {
+            "properties": {
+              "ui_baseline_kind": {
+                "const": "prototype"
+              }
+            }
+          },
+          "then": {
+            "required": [
+              "prototype"
+            ],
+            "properties": {
+              "approvals": {
+                "required": [
+                  "prototype_ref",
+                  "visual_baseline_ref"
+                ],
+                "not": {
+                  "required": [
+                    "existing_ui_baseline_ref"
+                  ]
+                }
+              }
+            }
+          },
+          "else": {
+            "not": {
+              "required": [
+                "prototype"
+              ]
+            },
+            "properties": {
+              "approvals": {
+                "required": [
+                  "existing_ui_baseline_ref"
+                ],
+                "not": {
+                  "anyOf": [
+                    {
+                      "required": [
+                        "prototype_ref"
+                      ]
+                    },
+                    {
+                      "required": [
+                        "visual_baseline_ref"
+                      ]
+                    }
+                  ]
+                }
+              }
+            }
+          }
+        }
+      ]
+    },
+    "ui_baseline_kind": {
+      "enum": [
+        "prototype",
+        "existing-ui-baseline"
+      ]
+    }
+  },
+  "$defs": {
+    "termRefs": {
+      "type": "array",
+      "uniqueItems": true,
+      "items": {
+        "type": "string",
+        "pattern": "^(Global|[A-Z][A-Za-z0-9]+)/[A-Z][A-Za-z0-9]+$"
+      }
+    },
+    "contextTerms": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "additionalProperties": false,
+        "required": [
+          "term_ref",
+          "term",
+          "meaning",
+          "english_identifier",
+          "context_id",
+          "forbidden_aliases"
+        ],
+        "properties": {
+          "term_ref": {
+            "type": "string",
+            "pattern": "^(Global|[A-Z][A-Za-z0-9]+)/[A-Z][A-Za-z0-9]+$"
+          },
+          "term": {
+            "type": "string",
+            "minLength": 1
+          },
+          "meaning": {
+            "type": "string",
+            "minLength": 1
+          },
+          "english_identifier": {
+            "type": "string",
+            "pattern": "^[A-Z][A-Za-z0-9]+$"
+          },
+          "context_id": {
+            "type": "string",
+            "pattern": "^(Global|[A-Z][A-Za-z0-9]+)$"
+          },
+          "forbidden_aliases": {
+            "type": "array",
+            "uniqueItems": true,
+            "items": {
+              "type": "string",
+              "minLength": 1
+            }
+          }
+        }
+      }
+    },
+    "contextSnapshot": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "context_ref",
+        "context_schema_version",
+        "document_digest",
+        "referenced_terms_digest",
+        "term_refs"
+      ],
+      "properties": {
+        "context_ref": {
+          "const": "CONTEXT.md"
+        },
+        "context_schema_version": {
+          "const": 1
+        },
+        "document_digest": {
+          "type": "string",
+          "pattern": "^sha256:[a-f0-9]{64}$"
+        },
+        "referenced_terms_digest": {
+          "type": "string",
+          "pattern": "^sha256:[a-f0-9]{64}$"
+        },
+        "term_refs": {
+          "$ref": "#/$defs/termRefs"
+        }
+      }
+    },
+    "nonEmptyStrings": {
+      "type": "array",
+      "minItems": 1,
+      "items": {
+        "type": "string",
+        "minLength": 1
+      }
+    },
+    "versionedRef": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "id",
+        "version",
+        "digest",
+        "status",
+        "persisted_ref"
+      ],
+      "properties": {
+        "id": {
+          "type": "string",
+          "minLength": 1
+        },
+        "version": {
+          "type": "string",
+          "pattern": "^v[0-9]+$"
+        },
+        "digest": {
+          "type": "string",
+          "minLength": 1
+        },
+        "status": {
+          "const": "approved"
+        },
+        "persisted_ref": {
+          "type": "string",
+          "minLength": 1
+        }
+      }
+    },
+    "visualBaselineRef": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "baseline_id",
+        "version",
+        "digest",
+        "status",
+        "persisted_ref",
+        "manifest_ref",
+        "case_ids"
+      ],
+      "properties": {
+        "baseline_id": {
+          "type": "string",
+          "pattern": "^visual-baseline\\.[a-z0-9][a-z0-9-]*$"
+        },
+        "version": {
+          "type": "string",
+          "pattern": "^v[1-9][0-9]*$"
+        },
+        "digest": {
+          "type": "string",
+          "pattern": "^sha256:[a-f0-9]{64}$"
+        },
+        "status": {
+          "const": "approved"
+        },
+        "persisted_ref": {
+          "type": "string",
+          "minLength": 1
+        },
+        "manifest_ref": {
+          "const": "visual-baseline.yaml"
+        },
+        "case_ids": {
+          "type": "array",
+          "minItems": 2,
+          "uniqueItems": true,
+          "items": {
+            "type": "string",
+            "pattern": "^[a-z0-9][a-z0-9-]*$"
+          }
+        }
+      }
+    },
+    "consumerRoute": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "route_id",
+        "capability",
+        "activation",
+        "impact_refs",
+        "entry_work_unit",
+        "expected_outputs",
+        "dependencies",
+        "context_reconciliation"
+      ],
+      "properties": {
+        "route_id": {
+          "type": "string",
+          "pattern": "^route\\.[a-z0-9][a-z0-9-]*$"
+        },
+        "capability": {
+          "enum": [
+            "backend-technical-design",
+            "frontend-engineering-design",
+            "delivery-coordination"
+          ]
+        },
+        "activation": {
+          "enum": [
+            "required",
+            "optional",
+            "not-applicable"
+          ]
+        },
+        "impact_refs": {
+          "type": "array",
+          "minItems": 1,
+          "uniqueItems": true,
+          "items": {
+            "type": "string",
+            "pattern": "^impact_assessment\\.(ui|api|data|backend|frontend|cross_repo|high_risk)$"
+          }
+        },
+        "entry_work_unit": {
+          "enum": [
+            "work-unit.technical-design",
+            "work-unit.frontend-engineering-design",
+            "work-unit.delivery-coordination"
+          ]
+        },
+        "expected_outputs": {
+          "$ref": "#/$defs/nonEmptyStrings"
+        },
+        "dependencies": {
+          "type": "array",
+          "uniqueItems": true,
+          "items": {
+            "type": "string",
+            "pattern": "^route\\.[a-z0-9][a-z0-9-]*$"
+          }
+        },
+        "context_reconciliation": {
+          "type": "object",
+          "additionalProperties": false,
+          "required": [
+            "required",
+            "target_context_ref",
+            "schema_ref"
+          ],
+          "properties": {
+            "required": {
+              "const": true
+            },
+            "target_context_ref": {
+              "const": "CONTEXT.md"
+            },
+            "schema_ref": {
+              "const": "docs/process/schemas/context-reconciliation.schema.json"
+            }
+          }
+        },
+        "reason": {
+          "type": "string",
+          "minLength": 1
+        },
+        "evidence_refs": {
+          "$ref": "#/$defs/nonEmptyStrings"
+        }
+      },
+      "allOf": [
+        {
+          "if": {
+            "properties": {
+              "activation": {
+                "enum": [
+                  "optional",
+                  "not-applicable"
+                ]
+              }
+            },
+            "required": [
+              "activation"
+            ]
+          },
+          "then": {
+            "required": [
+              "reason",
+              "evidence_refs"
+            ]
+          }
+        }
+      ]
+    },
+    "deferred": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "decision",
+        "owner",
+        "next_action",
+        "target_version"
+      ],
+      "properties": {
+        "decision": {
+          "type": "string",
+          "minLength": 1
+        },
+        "owner": {
+          "type": "string",
+          "minLength": 1
+        },
+        "next_action": {
+          "type": "string",
+          "minLength": 1
+        },
+        "target_version": {
+          "type": "string",
+          "minLength": 1
+        }
+      }
+    },
+    "existingUiBaselineRef": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "baseline_id",
+        "version",
+        "digest",
+        "status",
+        "persisted_ref",
+        "manifest_ref",
+        "case_ids"
+      ],
+      "properties": {
+        "baseline_id": {
+          "type": "string",
+          "pattern": "^existing-ui-baseline\\.[a-z0-9][a-z0-9-]*$"
+        },
+        "version": {
+          "type": "string",
+          "pattern": "^v[1-9][0-9]*$"
+        },
+        "digest": {
+          "type": "string",
+          "pattern": "^sha256:[a-f0-9]{64}$"
+        },
+        "status": {
+          "const": "approved"
+        },
+        "persisted_ref": {
+          "type": "string",
+          "minLength": 1
+        },
+        "manifest_ref": {
+          "const": "existing-ui-baseline.json"
+        },
+        "case_ids": {
+          "type": "array",
+          "minItems": 1,
+          "uniqueItems": true,
+          "items": {
+            "type": "string",
+            "pattern": "^[a-z0-9][a-z0-9-]*$"
+          }
+        }
+      }
+    }
+  },
+  "allOf": [
+    {
+      "if": {
+        "properties": {
+          "ui_baseline_kind": {
+            "const": "prototype"
+          }
+        }
+      },
+      "then": {
+        "properties": {
+          "source": {
+            "required": [
+              "prototype_ref",
+              "visual_baseline_ref"
+            ],
+            "not": {
+              "required": [
+                "existing_ui_baseline_ref"
+              ]
+            }
+          }
+        }
+      },
+      "else": {
+        "properties": {
+          "source": {
+            "required": [
+              "existing_ui_baseline_ref"
+            ],
+            "not": {
+              "anyOf": [
+                {
+                  "required": [
+                    "prototype_ref"
+                  ]
+                },
+                {
+                  "required": [
+                    "visual_baseline_ref"
+                  ]
+                }
+              ]
+            }
+          }
+        }
+      }
+    }
+  ]
+}