create-yss-spec 3.4.1 → 3.4.4

package/template/docs/process/schemas/review-bundle.schema.json

@@ -0,0 +1,42 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://yss.dev/schemas/review-bundle.schema.json",
+  "title": "YSS Review Bundle v1",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["schema_version", "kind", "bundle_id", "task_id", "work_unit_id", "review_session_id", "role_id", "runtime_id", "principal_ref", "reviews"],
+  "properties": {
+    "schema_version": { "const": 1 },
+    "kind": { "const": "review-bundle" },
+    "bundle_id": { "type": "string", "pattern": "^review-bundle\\.[a-z0-9][a-z0-9-]*$" },
+    "task_id": { "type": "string", "minLength": 1 },
+    "work_unit_id": { "type": "string", "pattern": "^work-unit\\.[a-z0-9][a-z0-9-]*$" },
+    "review_session_id": { "type": "string", "minLength": 1 },
+    "role_id": { "type": "string", "pattern": "^role\\.[a-z0-9][a-z0-9-]*$" },
+    "runtime_id": { "type": "string", "pattern": "^runtime\\.[a-z0-9][a-z0-9-]*$" },
+    "principal_ref": { "type": "string", "minLength": 1 },
+    "reviews": {
+      "type": "array",
+      "minItems": 1,
+      "items": {
+        "type": "object",
+        "additionalProperties": true,
+        "required": ["schema_version", "gate_id", "decision", "actor_kind", "role_id", "runtime_id", "principal_ref", "drafter_principal_ref", "subject_ref", "subject_digest", "approval_scope", "evidence_refs"],
+        "properties": {
+          "schema_version": { "const": 1 },
+          "gate_id": { "type": "string", "pattern": "^check\\.[a-z0-9][a-z0-9-]*$" },
+          "decision": { "enum": ["approved", "rejected", "vetoed"] },
+          "actor_kind": { "const": "digital-human" },
+          "role_id": { "type": "string", "minLength": 1 },
+          "runtime_id": { "type": "string", "minLength": 1 },
+          "principal_ref": { "type": "string", "minLength": 1 },
+          "drafter_principal_ref": { "type": "string", "minLength": 1 },
+          "subject_ref": { "type": "string", "minLength": 1 },
+          "subject_digest": { "type": "string", "pattern": "^[a-f0-9]{64}$" },
+          "approval_scope": { "type": "array", "minItems": 1, "uniqueItems": true, "items": { "type": "string", "minLength": 1 } },
+          "evidence_refs": { "type": "array", "minItems": 1, "uniqueItems": true, "items": { "type": "string", "minLength": 1 } }
+        }
+      }
+    }
+  }
+}

package/template/docs/process/schemas/scaffold-architecture-decisions.schema.json

@@ -4,64 +4,348 @@
   "title": "YSS 后端脚手架架构选择记录",
   "type": "object",
   "additionalProperties": false,
-  "required": ["schema_version", "kind", "template", "status", "decisions"],
+  "required": [
+    "schema_version",
+    "kind",
+    "template",
+    "status",
+    "decisions"
+  ],
   "properties": {
-    "schema_version": { "const": 1 },
-    "kind": { "const": "scaffold-architecture-decisions" },
-    "template": { "type": "boolean" },
-    "status": { "enum": ["draft", "current", "stale", "blocked"] },
+    "schema_version": {
+      "const": 1
+    },
+    "kind": {
+      "const": "scaffold-architecture-decisions"
+    },
+    "template": {
+      "type": "boolean"
+    },
+    "status": {
+      "enum": [
+        "draft",
+        "current",
+        "stale",
+        "blocked"
+      ]
+    },
     "decisions": {
       "type": "array",
       "minItems": 1,
-      "items": { "$ref": "#/$defs/decision" }
+      "items": {
+        "$ref": "#/$defs/decision"
+      }
     }
   },
   "$defs": {
-    "digest": { "type": "string", "pattern": "^sha256:[a-f0-9]{64}$" },
-    "architecture": { "enum": ["domain-driven", "layered-mvc"] },
+    "digest": {
+      "type": "string",
+      "pattern": "^sha256:[a-f0-9]{64}$"
+    },
+    "architecture": {
+      "enum": [
+        "domain-driven",
+        "layered-mvc"
+      ]
+    },
     "decision": {
       "type": "object",
       "additionalProperties": false,
       "required": [
-        "decision_id", "project_id", "parent_project_id", "status",
-        "recommended_architecture", "recommendation_reasons", "confirmed_architecture",
-        "override_reason", "inheritance_mode", "inherited_from", "platform_profile",
-        "architecture_profile", "verification_database", "production_database", "requested_capabilities", "resolved_modules",
-        "resolution_version", "user_confirmation", "decision_inputs_digest"
+        "decision_id",
+        "project_id",
+        "parent_project_id",
+        "status",
+        "recommended_architecture",
+        "recommendation_reasons",
+        "confirmed_architecture",
+        "override_reason",
+        "inheritance_mode",
+        "inherited_from",
+        "platform_profile",
+        "architecture_profile",
+        "verification_database",
+        "production_database",
+        "requested_capabilities",
+        "resolved_modules",
+        "resolution_version",
+        "user_confirmation",
+        "decision_inputs_digest"
       ],
       "properties": {
-        "decision_id": { "type": "string", "pattern": "^scaffold-decision\\.[a-z][a-z0-9-]*$" },
-        "project_id": { "type": "string", "pattern": "^[a-z][a-z0-9-]*$" },
-        "parent_project_id": { "type": ["string", "null"], "pattern": "^[a-z][a-z0-9-]*$" },
-        "status": { "enum": ["undecided", "recommended", "awaiting-user-decision", "user-confirmed", "lifecycle-approved", "consumed", "stale"] },
-        "recommended_architecture": { "$ref": "#/$defs/architecture" },
-        "recommendation_reasons": { "type": "array", "minItems": 1, "items": { "type": "string", "minLength": 1 } },
-        "confirmed_architecture": { "anyOf": [{ "$ref": "#/$defs/architecture" }, { "type": "null" }] },
-        "override_reason": { "type": ["string", "null"] },
-        "inheritance_mode": { "enum": ["root-default", "inherit", "override"] },
-        "inherited_from": { "type": ["string", "null"], "pattern": "^[a-z][a-z0-9-]*$" },
-        "platform_profile": { "const": "spring-boot-2.7-jdk8" },
-        "architecture_profile": { "enum": ["target-domain-model", "layered-mvc-service", "mvc-data-analysis-v1"] },
-        "verification_database": { "const": "h2" },
-        "production_database": { "const": "not-bound" },
-        "requested_capabilities": { "type": "array", "uniqueItems": true, "items": { "enum": ["external-integration", "published-client", "feign-client"] } },
-        "resolved_modules": { "type": "array", "minItems": 3, "uniqueItems": true, "items": { "enum": ["server", "core", "service", "repository", "adapter", "client", "feign-client", "domain", "application", "infrastructure", "bootstrap"] } },
-        "resolution_version": { "const": 1 },
+        "decision_id": {
+          "type": "string",
+          "pattern": "^scaffold-decision\\.[a-z][a-z0-9-]*$"
+        },
+        "project_id": {
+          "type": "string",
+          "pattern": "^[a-z][a-z0-9-]*$"
+        },
+        "parent_project_id": {
+          "type": [
+            "string",
+            "null"
+          ],
+          "pattern": "^[a-z][a-z0-9-]*$"
+        },
+        "status": {
+          "enum": [
+            "undecided",
+            "recommended",
+            "awaiting-user-decision",
+            "user-confirmed",
+            "lifecycle-approved",
+            "consumed",
+            "stale"
+          ]
+        },
+        "recommended_architecture": {
+          "$ref": "#/$defs/architecture"
+        },
+        "recommendation_reasons": {
+          "type": "array",
+          "minItems": 1,
+          "items": {
+            "type": "string",
+            "minLength": 1
+          }
+        },
+        "confirmed_architecture": {
+          "anyOf": [
+            {
+              "$ref": "#/$defs/architecture"
+            },
+            {
+              "type": "null"
+            }
+          ]
+        },
+        "override_reason": {
+          "type": [
+            "string",
+            "null"
+          ]
+        },
+        "inheritance_mode": {
+          "enum": [
+            "root-default",
+            "inherit",
+            "override"
+          ]
+        },
+        "inherited_from": {
+          "type": [
+            "string",
+            "null"
+          ],
+          "pattern": "^[a-z][a-z0-9-]*$"
+        },
+        "platform_profile": {
+          "enum": [
+            "spring-boot-2.7-jdk8",
+            "spring-boot-3.5-jdk17",
+            "spring-boot-3.5-jdk21",
+            "spring-boot-4.1-jdk17",
+            "spring-boot-4.1-jdk21"
+          ]
+        },
+        "architecture_profile": {
+          "enum": [
+            "target-domain-model",
+            "layered-mvc-service",
+            "mvc-data-analysis-v1"
+          ]
+        },
+        "verification_database": {
+          "const": "h2"
+        },
+        "production_database": {
+          "const": "not-bound"
+        },
+        "requested_capabilities": {
+          "type": "array",
+          "uniqueItems": true,
+          "items": {
+            "enum": [
+              "external-integration",
+              "published-client",
+              "feign-client"
+            ]
+          }
+        },
+        "resolved_modules": {
+          "type": "array",
+          "minItems": 3,
+          "uniqueItems": true,
+          "items": {
+            "enum": [
+              "server",
+              "core",
+              "service",
+              "repository",
+              "adapter",
+              "client",
+              "feign-client",
+              "domain",
+              "application",
+              "infrastructure",
+              "bootstrap"
+            ]
+          }
+        },
+        "resolution_version": {
+          "const": 1
+        },
         "user_confirmation": {
           "type": "object",
           "additionalProperties": false,
-          "required": ["confirmed_by", "channel", "confirmation_ref", "confirmed_at", "normalized_text"],
+          "required": [
+            "confirmed_by",
+            "channel",
+            "confirmation_ref",
+            "confirmed_at",
+            "normalized_text"
+          ],
           "properties": {
-            "user_decision_ref": { "type": ["string", "null"] },
-            "decision_subject_ref": { "type": ["string", "null"] },
-            "confirmed_by": { "type": ["string", "null"] },
-            "channel": { "type": ["string", "null"] },
-            "confirmation_ref": { "type": ["string", "null"] },
-            "confirmed_at": { "type": ["string", "null"], "format": "date-time" },
-            "normalized_text": { "type": ["string", "null"] }
+            "user_decision_ref": {
+              "type": [
+                "string",
+                "null"
+              ]
+            },
+            "decision_subject_ref": {
+              "type": [
+                "string",
+                "null"
+              ]
+            },
+            "confirmed_by": {
+              "type": [
+                "string",
+                "null"
+              ]
+            },
+            "channel": {
+              "type": [
+                "string",
+                "null"
+              ]
+            },
+            "confirmation_ref": {
+              "type": [
+                "string",
+                "null"
+              ]
+            },
+            "confirmed_at": {
+              "type": [
+                "string",
+                "null"
+              ],
+              "format": "date-time"
+            },
+            "normalized_text": {
+              "type": [
+                "string",
+                "null"
+              ]
+            }
           }
         },
-        "decision_inputs_digest": { "$ref": "#/$defs/digest" }
+        "decision_inputs_digest": {
+          "$ref": "#/$defs/digest"
+        },
+        "platform_configuration": {
+          "type": "object",
+          "additionalProperties": false,
+          "required": [
+            "schema_version",
+            "profile_id",
+            "spring_boot_version",
+            "java_version",
+            "parent",
+            "bom",
+            "compatibility_id",
+            "compatibility_digest"
+          ],
+          "properties": {
+            "schema_version": {
+              "enum": [
+                1,
+                2
+              ]
+            },
+            "profile_id": {
+              "type": "string",
+              "minLength": 1
+            },
+            "spring_boot_version": {
+              "type": "string",
+              "pattern": "^\\d+\\.\\d+\\.\\d+$"
+            },
+            "java_version": {
+              "enum": [
+                8,
+                17,
+                21
+              ]
+            },
+            "compatibility_id": {
+              "type": "string",
+              "minLength": 1
+            },
+            "compatibility_digest": {
+              "type": "string",
+              "pattern": "^sha256:[a-f0-9]{64}$"
+            },
+            "parent": {
+              "type": "object",
+              "additionalProperties": false,
+              "required": [
+                "group_id",
+                "artifact_id",
+                "version"
+              ],
+              "properties": {
+                "group_id": {
+                  "type": "string",
+                  "pattern": "^[A-Za-z0-9_.-]+$"
+                },
+                "artifact_id": {
+                  "type": "string",
+                  "pattern": "^[A-Za-z0-9_.-]+$"
+                },
+                "version": {
+                  "type": "string",
+                  "pattern": "^[A-Za-z0-9_.-]+$"
+                }
+              }
+            },
+            "bom": {
+              "type": "object",
+              "additionalProperties": false,
+              "required": [
+                "group_id",
+                "artifact_id",
+                "version"
+              ],
+              "properties": {
+                "group_id": {
+                  "type": "string",
+                  "pattern": "^[A-Za-z0-9_.-]+$"
+                },
+                "artifact_id": {
+                  "type": "string",
+                  "pattern": "^[A-Za-z0-9_.-]+$"
+                },
+                "version": {
+                  "type": "string",
+                  "pattern": "^[A-Za-z0-9_.-]+$"
+                }
+              }
+            }
+          }
+        }
       }
     }
   }