create-yss-spec 3.4.5 → 3.4.7

package/template/docs/engineering/backend-platforms.md

@@ -1,10 +1,10 @@
 # 后端脚手架平台合同
 
-DDD 和 Layered MVC 共同消费 `backend-platforms.json`。平台定义是候选配方，`compatibility` 是维护者核验后的 YSS 组合清单；空清单表示尚无可开放组合，不表示官方框架不支持这些版本。
+DDD 和 Layered MVC 共同消费 `backend-platforms.json`。平台定义是候选配方，`compatibility` 是 YSS 父 POM、BOM、组件能力与证据的同一组合清单。`blocked` 条目只表达已经定位的坐标和缺口，不表示组合已获认证；没有 `verified` 条目表示尚无可开放组合，不表示官方框架不支持这些版本。
 
 ## 用户选择
 
-运行 `scripts/backend-platforms` 展示 Boot 精确补丁、Java、YSS 父 POM/BOM、可选状态和阻塞原因。新建后端在进入 DDD / MVC 分支设计前必须通过 `gate.backend-architecture-platform-approved`；生命周期编排器将平台与架构放在同一次用户决定中。缺少选择时询问；已有批准且当前的选择只展示摘要并复用。既有工程核验并复用登记的 `architecture_identity` 与固定工程基线/POM 中的实际 Spring Boot 版本，该门禁记录为 `not-applicable`，不重复询问；平台升级另行立项。独立子项目可继承或覆盖，也可一次确认明确列出的多个项目。同一 Maven Reactor 不混用平台。
+运行 `scripts/backend-platforms` 展示 Boot 精确补丁、Java、YSS 父 POM/BOM、逐组件状态、构件证据和阻塞原因。`scripts/backend-platforms --require-profile <profile-id>` 只校验指定 Profile 的平台基础组合；缺条目或组合阻断时输出 JSON 诊断并返回非 0。组件状态独立展示，是否可用由编译器针对实际请求的 capability 调用组件解析器判定，单个组件阻断不会降级一个已经验证的平台基础组合。新建后端在进入 DDD / MVC 分支设计前必须通过 `gate.backend-architecture-platform-approved`；生命周期编排器将平台与架构放在同一次用户决定中。缺少选择时询问；已有批准且当前的选择只展示摘要并复用。既有工程核验并复用登记的 `architecture_identity` 与固定工程基线/POM 中的实际 Spring Boot 版本，该门禁记录为 `not-applicable`，不重复询问；平台升级另行立项。独立子项目可继承或覆盖，也可一次确认明确列出的多个项目。同一 Maven Reactor 不混用平台。
 
 候选为 2.7.18 / Java 8、3.5.16 / Java 17 或 21、4.1.1 / Java 17 或 21。3.5 和 4.1 推荐 Java 17。新增补丁必须先通过组合验证，生成合同不接受 `x`、版本范围或 `latest`。
 
@@ -18,17 +18,43 @@ Project Scaffold Contract v4 新增 `platform_configuration` v2，两个脚手
 | `profile_id` | 如 `spring-boot-3.5-jdk17` |
 | `spring_boot_version` | 精确补丁，如 `3.5.16` |
 | `java_version` | 经选择的 `8`、`17` 或 `21` |
+| `component_platform_line` | 组件源码与 Skill 索引平台线；只允许 `boot2-java8` 或 `boot3-java17` |
 | `parent` / `bom` | `group_id`、`artifact_id`、`version` |
 | `compatibility_id` | 清单组合 ID |
 | `compatibility_digest` | `platformRecipeDigest(profile, entry)`，排除证据列表、支持状态和展示提示 |
 
-配置可由 `platformBinding(profile, entry)` 机械构造；该函数不批准用户选择或开放支持。修改平台、YSS 坐标或依赖配方会使绑定失效；仅更新同配方证据不改变用户选择摘要。历史 Manifest 继续只读验证，不自动补字段或重写批准。仅继承架构不等于继承平台批准。
+配置可由 `platformBinding(profile, entry)` 机械构造；该函数把 Profile 中规范化的 `component_platform_line` 持久化到 v2 binding，并由 schema、解析器、架构身份摘要和 Slice 组件绑定摘要共同校验。组件平台线表示可消费的双平台源码索引，不承载 `maintenance`、`candidate` 或 `blocked` 生命周期；生命周期继续由 compatibility 与 capability 状态表达。当前 Boot 2 与 Boot 3 分别固定为 `boot2-java8`、`boot3-java17`。Boot 4 没有现有组件平台线，不生成可批准的 v2 `platform_configuration`，继续在选择阶段阻断。该函数不批准用户选择或开放支持。修改平台、YSS 坐标或依赖配方会使绑定失效；仅更新同配方证据不改变用户选择摘要。历史 Manifest 继续只读验证，不自动补字段或重写批准。仅继承架构不等于继承平台批准。
+
+`resolveBackendPlatform(binding, { root })` 在未显式传入 catalog 时读取该 `root` 下的 `docs/engineering/backend-platforms.json`；未传 `root` 时读取模板仓目录。这样 Slice freshness 与隔离 fixture 使用各自的目录事实，不会意外回退到模板工作区。
+
+## 组件能力绑定
+
+组件能力不在 catalog 顶层建立第二套目录。它只存在于绑定组合内，以注册表 capability ID 为键：`compatibility[].component_capabilities.<capability-id>`。当前登记 11 项：`contract.dto-wire`、`contract.request-validation`、`contract.error-mapping`、`framework.mybatis`、`component.cache`、`component.current-user-context`、`component.audit-log`、`component.excel-import-export`、`component.distributed-id`、`component.security-algorithm`、`component.gateway-resilience`。Maven `artifact_id` 只出现在 `artifacts`。
+
+每项记录 `status`、`verified_architectures`、`artifacts`、`evidence`、`blockers` 和 `component_digest`。每个构件固定字段为 `group_id`、`artifact_id`、`declared_version`、`resolved_version`、`pom_sha256`、`jar_sha256`、`source_tree`。SNAPSHOT 的声明版本与仓库实际解析版本必须分离；已验证条目的 POM/JAR 摘要使用 `sha256:<64 位小写十六进制>`，`source_tree` 使用 40 位小写 Git tree SHA。阻断条目可将尚未取得的解析版本、摘要和 tree 设为 `null`，但必须给出稳定 blocker。
+
+Boot 3.5 / JDK 17 Profile 固定 `Spring Cloud 2025.0.3`、`Spring Cloud Alibaba 2025.0.0.0`、Jakarta Validation、Jackson 2，并要求 `META-INF/spring/org.springframework.boot.autoconfigure.AutoConfiguration.imports`。同一 compatibility entry 通过 `platform_artifact_bindings.parent/bom` 保存父 POM 与组件 BOM 候选，通过 `external_snapshot_bindings` 和 `external_artifact_bindings` 区分外部 SNAPSHOT 与正式发布构件。候选未发布或未完成本地解析时，`resolved_version`、`published_at`、POM/JAR SHA、`source_tree` 保持 `null`，`evidence` 保持空数组并写明 blocker；这些字段参与平台 recipe digest，不能在批准后静默变化。
+
+`resolveComponentCapabilities(binding, capabilityIds, architectureFamily, options?)` 先按 binding 精确找到同一 compatibility entry，再解析其中的 capability map。成功结果是可序列化 binding 数组；未登记、非 `verified`、架构不符、构件字段缺失、同坐标解析不一致、组件摘要或证据字节漂移均 fail-closed。错误前缀及稳定码为：
+
+- `component-capability: component-unavailable-for-platform`
+- `component-capability: component-artifact-coordinate-conflict`
+- `component-capability: component-evidence-missing`
+- `component-capability: component-binding-drift`
+
+编译器在需要组件而缺少平台 binding 时使用 `component-capability: component-platform-binding-required`。平台解析和组件解析保持两个独立步骤；组件 evidence 不伪装成平台空脚手架的 Maven、启动或集成测试证据。
+
+当前 `spring-boot-2.7-jdk8` 组合登记为 `blocked`。阿里云 Maven 私服已解析出 12 个 timestamped SNAPSHOT 及 POM/JAR SHA-256；其中 11 个构件的发布 POM 与 sources JAR 可逐字节绑定到固定 Git tree，Cache 3.x 没有发布 sources JAR，仍缺源码绑定。Exception、UserInfo、Security 和 Resilience4j 的已解析构件对应固定提交，不包含当前隔离工作树中的加固候选。所有能力仍缺 DDD 与 Layered MVC 消费应用认证，因此未写入 `verified_architectures` 或组件 evidence。
+
+Boot 2 私服中的 Cache `3.0.0-SNAPSHOT` 使用 JDK 8 构建且 BOM 2.x 管理的是 `2.0.0-SNAPSHOT`；Distributed ID 3.x 同样是 JDK 8 / `javax` 代际。这两个坐标不能作为 Boot 3 主线证据。UserInfo 源模块继承 `com.yss.cloud`，BOM 仍登记 `com.yss.datamiddle`，坐标冲突继续阻断。Boot 3.5 候选单独绑定 Cache 与 Distributed ID `3.1.0-SNAPSHOT`，Validation 使用平台管理的 `org.springframework.boot:spring-boot-starter-validation:3.5.16`；Excel 只保留 `yss-component-excel-mvc`，已移除的 `yss-component-excel-starter` 不再登记。Fesod `2.1.0-SNAPSHOT` 在当前私服不可解析，因此 `external_snapshot_bindings` 为空；Excel 外部依赖改用 Apache 正式发布的 `org.apache.fesod:fesod-sheet:2.0.2-incubating`，并以实际 POM、二进制 JAR 与 sources JAR SHA-256 保存为不可变 `resolved` release binding。Fesod 字节绑定不替代消费认证；YSS parent/BOM、timestamped SNAPSHOT、源码绑定、`AutoConfiguration.imports` 与 DDD/Layered MVC 消费证据仍未闭合，所以 Boot 3.5 compatibility 继续 `blocked`。Boot 4.1 没有 compatibility entry；当前目录不对任何 Profile 宣称可选择。
+
+`compatibility[].artifact_resolution_evidence` 绑定私服解析报告的相对路径和原始字节摘要。加载 catalog 时会同时核对 report ID、仓库 ID、timestamped version、POM/JAR SHA-256 与可证明的 Git tree；报告字节或任一构件绑定变化都返回 `component-binding-drift`。报告不保存 Maven 用户名、密码或令牌。用户级 `settings.xml` 只提供下载配置；其中 profile 下的 `distributionManagement` 会被 Maven 忽略，发布目标必须由发布 POM 持有。
 
 ## 依赖与验证
 
-Boot BOM 管理 Spring Framework/MVC、嵌入式容器、Servlet、Validation、Jackson 等依赖，Boot Plugin 与 Boot 精确版本相同。YSS 父 POM/BOM 仍由用户确认，解析结果冲突则阻断，不能依靠属性覆盖宣称兼容。清单记录构建工具、Lombok、MapStruct、Swagger、ArchUnit 的候选版本；YSS 组件源码不在脚手架步骤中改造。
+Boot BOM 管理 Spring Framework/MVC、嵌入式容器、Servlet、Validation、Jackson 等依赖，Boot Plugin 与 Boot 精确版本相同。Boot 3.5 Validation 作为 `platform-managed` capability 解析，不再要求 YSS Validation starter。YSS 父 POM/BOM 仍由用户确认，解析结果冲突则阻断，不能依靠属性覆盖宣称兼容。清单记录构建工具、Lombok、MapStruct、Swagger、ArchUnit 的候选版本；YSS 组件源码不在脚手架步骤中改造。
 
-Boot 4 使用对应 MVC / MVC 测试 starter、Jackson 3 默认栈与新的模块结构；MyBatis-Plus 必须使用相应 Boot 分支。Web/Validation 的 Jakarta 迁移不替换 `javax.sql` 等 Java SE API。Feign 等可选能力须在兼容条目的 `capabilities` 内有验证记录。清单记录 Cloud 2021.0 / 2025.0 / 2025.1（Boot 4.1 至少 2025.1.2）及 OpenFeign 3.1 / 4.3 / 5.0 线；实际内部 BOM 必须解析到对应组合。测试覆盖 Validation、JSON、MyBatis 查询映射和适用的 Feign JSON Decoder。
+Boot 4 使用对应 MVC / MVC 测试 starter、Jackson 3 默认栈与新的模块结构；MyBatis-Plus 必须使用相应 Boot 分支。Web/Validation 的 Jakarta 迁移不替换 `javax.sql` 等 Java SE API。Feign 等可选能力须在兼容条目的 `capabilities` 内有验证记录。清单记录 Boot 3.5 的 Spring Cloud `2025.0.3`、Spring Cloud Alibaba `2025.0.0.0`，以及其他候选线；实际内部 BOM 必须解析到对应组合。测试覆盖 Validation、JSON、MyBatis 查询映射和适用的 Feign JSON Decoder。
 
 真实验证保存 Maven 实际 JDK、effective POM、每个模块的依赖树、固定三条 Wrapper 命令结果，以及显式 `scaffold-local` 打包启动结果。启动检查只绑定回环地址，通过启动日志与 HTTP 响应验证机械 Web 服务；测试内 Controller 通过随机端口覆盖 JSON POST 往返及非法参数 400，不编译进生产 Jar，并终止验证进程。H2 仅用于测试和显式本地 Profile，不绑定生产数据库。生成器不添加用户业务示例。
 
@@ -40,7 +66,7 @@ Boot 4 使用对应 MVC / MVC 测试 starter、Jackson 3 默认栈与新的模
 - `java_homes`：以 `8`、`17`、`21` 为键的实际 JDK 根目录。
 - `combinations`：每项有 `profile_id`、`spring_boot_version`、`architecture_family`、`contract_ref`，合同须真实批准、当前且指向不存在的输出目录。
 
-兼容条目包含 `id`、`profile_id`、`spring_boot_version`、`parent`、`bom`、`status`、`capabilities` 和 `evidence`。未验证时使用 `candidate`。每条证据绑定架构、可读取报告的 `ref` 与原始字节 `digest`。报告须匹配 Boot、Java、父 POM/BOM，三条 Maven 命令真实成功，并通过依赖、Surefire 实际用例和启动检查；跳过测试不通过。报告的 `verified_capabilities` 逐架构覆盖所选能力。`evidence_artifacts` 绑定日志、effective POM、依赖树和 `platform-tests.xml` 的相对路径与字节摘要，缺失或漂移即阻断。
+兼容条目包含 `id`、`profile_id`、`spring_boot_version`、`parent`、`bom`、`status`、`capabilities`、`component_capabilities` 和 `evidence`。未验证时使用 `candidate` 或 `blocked`。每条证据绑定架构、可读取报告的 `ref` 与原始字节 `digest`。报告须匹配 Boot、Java、父 POM/BOM，三条 Maven 命令真实成功，并通过依赖、Surefire 实际用例和启动检查；跳过测试不通过。报告的 `verified_capabilities` 逐架构覆盖所选能力。`evidence_artifacts` 绑定日志、effective POM、依赖树和 `platform-tests.xml` 的相对路径与字节摘要，缺失或漂移即阻断。
 
 候选工程始终标记 `platform_verification=candidate`，不能进入普通验证完成升级、业务生成或首切片验证。维护者将真实证据及相关日志保存为可分发的相对路径包，审阅全部适用能力后才可把对应组合登记为 `verified`。候选晋级或替换同配方证据不改变配置摘要；真正的依赖配方变化才重新确认。矩阵命令不自动修改兼容清单、不批准合同、不发布版本。
 
@@ -72,6 +98,6 @@ Boot 4 使用对应 MVC / MVC 测试 starter、Jackson 3 默认栈与新的模
 
 空脚手架验证的证据目录必须位于生成工程外部，避免证据文件被误认为新增源码。首切片验证在批准的切片合同通过既有门禁后复用构建检查，但记录 `verification_scope=first-slice`；其证据不能用于开放平台组合，也不要求业务代码保持空脚手架摘要。
 
-兼容条目 `components` 按 `groupId:artifactId` → 精确版本记录实际引入的 MyBatis-Plus、Springdoc、Spring Cloud 与 YSS 运行时依赖；依赖树出现未登记组件或版本不符时阻断。独立 Boot BOM 管理的组件优先按 BOM 核验。
+通用运行时依赖仍由真实依赖树和 Boot BOM 核验。YSS 组件能力的精确构件绑定只读取同一兼容条目内的 `component_capabilities`，不得再从 catalog 顶层列表或平行 `components` 目录推断。
 
 Jar 核验拒绝未登记或版本不符的额外库；仅允许 Boot 对应版本的 jarmode 工具以及已选配方中的 provided Lombok 随包出现。原因是 [Boot repackage 默认包含 provided 依赖](https://docs.spring.io/spring-boot/maven-plugin/packaging.html)；这些打包例外不能补足必须存在于 compile/runtime 树的 Web、Servlet、JSON 等能力。

package/template/docs/process/schemas/backend-architecture-identity.schema.json

@@ -68,6 +68,7 @@
             "profile_id",
             "spring_boot_version",
             "java_version",
+            "component_platform_line",
             "parent",
             "bom",
             "compatibility_id",
@@ -95,6 +96,12 @@
                 21
               ]
             },
+            "component_platform_line": {
+              "enum": [
+                "boot2-java8",
+                "boot3-java17"
+              ]
+            },
             "compatibility_id": {
               "type": "string",
               "minLength": 1
@@ -200,6 +207,101 @@
         "build_units_digest": {
           "type": "string",
           "pattern": "^sha256:[a-f0-9]{64}$"
+        },
+        "platform_configuration": {
+          "type": "object",
+          "additionalProperties": false,
+          "required": [
+            "schema_version",
+            "profile_id",
+            "spring_boot_version",
+            "java_version",
+            "component_platform_line",
+            "parent",
+            "bom",
+            "compatibility_id",
+            "compatibility_digest"
+          ],
+          "properties": {
+            "schema_version": {
+              "const": 2
+            },
+            "profile_id": {
+              "type": "string",
+              "minLength": 1
+            },
+            "spring_boot_version": {
+              "type": "string",
+              "pattern": "^\\d+\\.\\d+\\.\\d+$"
+            },
+            "java_version": {
+              "enum": [
+                8,
+                17,
+                21
+              ]
+            },
+            "component_platform_line": {
+              "enum": [
+                "boot2-java8",
+                "boot3-java17"
+              ]
+            },
+            "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_.-]+$"
+                }
+              }
+            }
+          }
         }
       }
     }

package/template/docs/process/schemas/project-scaffold-contract.schema.json

@@ -88,7 +88,6 @@
       "enum": [
         "yss-ddd-scaffold-generator",
         "yss-layered-mvc-scaffold-generator",
-        "yss-mvc-data-analysis-project-initializer",
         "yss-frontend-scaffold-generator"
       ]
     },
@@ -468,6 +467,7 @@
         "profile_id",
         "spring_boot_version",
         "java_version",
+        "component_platform_line",
         "parent",
         "bom",
         "compatibility_id",
@@ -495,6 +495,12 @@
             21
           ]
         },
+        "component_platform_line": {
+          "enum": [
+            "boot2-java8",
+            "boot3-java17"
+          ]
+        },
         "compatibility_id": {
           "type": "string",
           "minLength": 1
@@ -607,12 +613,12 @@
     {
       "if": {
         "properties": {
-          "generator_skill": {
-            "const": "yss-mvc-data-analysis-project-initializer"
+          "architecture_profile": {
+            "const": "mvc-data-analysis-v1"
           }
         },
         "required": [
-          "generator_skill"
+          "architecture_profile"
         ]
       },
       "then": {
@@ -626,6 +632,12 @@
           },
           "architecture_family": {
             "const": "layered-mvc"
+          },
+          "generator_skill": {
+            "const": "yss-layered-mvc-scaffold-generator"
+          },
+          "init_git": {
+            "const": true
           }
         }
       }

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

@@ -263,6 +263,7 @@
             "profile_id",
             "spring_boot_version",
             "java_version",
+            "component_platform_line",
             "parent",
             "bom",
             "compatibility_id",
@@ -290,6 +291,12 @@
                 21
               ]
             },
+            "component_platform_line": {
+              "enum": [
+                "boot2-java8",
+                "boot3-java17"
+              ]
+            },
             "compatibility_id": {
               "type": "string",
               "minLength": 1

package/template/docs/process/schemas/slice-implementation-contract-v3.schema.json

@@ -331,6 +331,149 @@
         },
         "architecture_identity": {
           "type": "object"
+        },
+        "component_bindings": {
+          "type": "array",
+          "minItems": 1,
+          "items": {
+            "type": "object",
+            "additionalProperties": false,
+            "properties": {
+              "capability_id": {
+                "type": "string",
+                "minLength": 1
+              },
+              "status": {
+                "const": "verified"
+              },
+              "verified_architectures": {
+                "type": "array",
+                "minItems": 1,
+                "uniqueItems": true,
+                "items": {
+                  "enum": [
+                    "domain-driven",
+                    "layered-mvc"
+                  ]
+                }
+              },
+              "artifacts": {
+                "type": "array",
+                "minItems": 1,
+                "items": {
+                  "type": "object",
+                  "additionalProperties": false,
+                  "properties": {
+                    "group_id": {
+                      "type": "string",
+                      "minLength": 1
+                    },
+                    "artifact_id": {
+                      "type": "string",
+                      "minLength": 1
+                    },
+                    "declared_version": {
+                      "type": "string",
+                      "minLength": 1
+                    },
+                    "resolved_version": {
+                      "type": "string",
+                      "minLength": 1
+                    },
+                    "pom_sha256": {
+                      "type": "string",
+                      "pattern": "^sha256:[a-f0-9]{64}$"
+                    },
+                    "jar_sha256": {
+                      "type": "string",
+                      "pattern": "^sha256:[a-f0-9]{64}$"
+                    },
+                    "source_tree": {
+                      "type": "string",
+                      "pattern": "^[a-f0-9]{40}$"
+                    }
+                  },
+                  "required": [
+                    "group_id",
+                    "artifact_id",
+                    "declared_version",
+                    "resolved_version",
+                    "pom_sha256",
+                    "jar_sha256",
+                    "source_tree"
+                  ]
+                }
+              },
+              "evidence": {
+                "type": "array",
+                "minItems": 1,
+                "items": {
+                  "type": "object",
+                  "additionalProperties": false,
+                  "properties": {
+                    "architecture_family": {
+                      "enum": [
+                        "domain-driven",
+                        "layered-mvc"
+                      ]
+                    },
+                    "ref": {
+                      "type": "string",
+                      "minLength": 1
+                    },
+                    "digest": {
+                      "type": "string",
+                      "pattern": "^sha256:[a-f0-9]{64}$"
+                    }
+                  },
+                  "required": [
+                    "architecture_family",
+                    "ref",
+                    "digest"
+                  ]
+                }
+              },
+              "component_digest": {
+                "type": "string",
+                "pattern": "^sha256:[a-f0-9]{64}$"
+              },
+              "architecture_family": {
+                "enum": [
+                  "domain-driven",
+                  "layered-mvc"
+                ]
+              },
+              "platform_configuration": {
+                "type": "object",
+                "minProperties": 1,
+                "required": [
+                  "component_platform_line"
+                ],
+                "properties": {
+                  "component_platform_line": {
+                    "enum": [
+                      "boot2-java8",
+                      "boot3-java17"
+                    ]
+                  }
+                }
+              }
+            },
+            "required": [
+              "capability_id",
+              "status",
+              "verified_architectures",
+              "artifacts",
+              "evidence",
+              "component_digest",
+              "architecture_family",
+              "platform_configuration"
+            ]
+          }
+        },
+        "component_bindings_digest": {
+          "type": "string",
+          "pattern": "^[a-f0-9]{64}$"
         }
       },
       "required": [

package/template/docs/process/strategic-handoff-package.md

@@ -78,7 +78,7 @@ scripts/verify-strategic-handoff-consumption --root <研发项目根> --slice <
 node .agents/skills/yss-technical-design/scripts/validate-technical-design.mjs <技术设计合同> --root <研发项目根>
 ```
 
-Handoff v4/v5 后端消费必须绑定 `backend-technical-design` 的 `route_id`，先对账，再由 `yss-technical-design` 依据已批准架构调用 `yss-tactical-design` 或 `yss-mvc-design`。Handoff v3/v4 仅作历史只读兼容，不修改已冻结包。`tactical_refs` 在 v2 Technical Design 可指向 MVC 或 DDD 分支对象；无战略交接包的 MVC 项目直接消费批准需求，不补造战略 DDD。
+Handoff v4/v5 后端消费必须绑定 `backend-technical-design` 的 `route_id`，先对账，再由 `yss-technical-design` 依据已批准架构进入自身 `layered-mvc` 分支或调用 `yss-tactical-design`。Handoff v3/v4 仅作历史只读兼容，不修改已冻结包。`tactical_refs` 在 v2 Technical Design 可指向 MVC 或 DDD 分支对象；无战略交接包的 MVC 项目直接消费批准需求，不补造战略 DDD。
 
 前端先验证与交接版本匹配的 Strategic Preflight：Handoff v4 使用 v1，Handoff v5 使用 v2 的 `ui_baseline_kind/ui_baseline_ref`，只允许起草前端工程设计与实现计划，固定返回 `ready_for_agent: false`。最终 Frontend Delivery Acceptance v2（Handoff v4）或 v3（Handoff v5）在 Backend/API/Data 有影响时必须绑定真实 Backend Delivery 收据与版本探测；UI-only 时使用与战略路由一致的 `backend-not-applicable`，此时 `operation_ids` 必须为空。无论哪条路径，当前且已批准的 Slice Contract 仍是实现入口。
 

package/template/docs/templates/implementation-routing-template.md

@@ -253,7 +253,7 @@ owner: ai
 | 生成选项 | 关闭 `--with-example`；生成器严格 initialize-only，非空目录、`--force`、旧项目迁移和当前模板升级均为 `unsupported` |
 | Profile | DDD：`target-domain-model`；MVC：`layered-mvc-service`；Spring Boot / Java 使用用户确认且兼容清单验证通过的精确组合，不使用版本范围或 `latest` |
 | 验证 | 使用一键生成验证入口，实际执行项目根目录 `./mvnw validate`、`./mvnw test`、`./mvnw package`；通过后仅为 `empty-scaffold-verified`，golden first slice 通过后才是 `first-slice-verified` |
-| 后置 | `yss-backend-scaffold-parent`、`yss-implementation-contract-compiler` 业务合同重编译、YSS Skill Execution Result |
+| 后置 | 生成器内部工程基线校验、`yss-implementation-contract-compiler` 业务合同重编译、YSS Skill Execution Result |
 
 所有后续生成代码必须绑定当前批准且版本一致的 Slice Implementation Contract、主 YSS skill、依赖闭包、允许写路径、预期证据和 Execution Result。业务行为必须使用 `behavior-tdd`；缺任一条件即阻断，不得以脚手架成功或时间压力豁免。
 

package/template/docs/user-guide//346/212/200/346/234/257/350/256/276/350/256/241/347/224/250/346/210/267/346/214/207/345/215/227.md

@@ -1,6 +1,6 @@
 # 技术设计用户指南
 
-本指南说明批准战略或 Spec 如何进入后端技术设计。统一入口是 `yss-technical-design`；工程采用 `domain-driven` 时调用 `yss-tactical-design`，采用 `layered-mvc` 时调用 `yss-mvc-design`。架构类型来自当前工程登记或经用户确认的脚手架决定，不能按目录或个人偏好猜测。
+本指南说明批准战略或 Spec 如何进入后端技术设计。统一入口是 `yss-technical-design`；工程采用 `domain-driven` 时调用 `yss-tactical-design`，采用 `layered-mvc` 时使用统一入口内的 MVC 分支。架构类型来自当前工程登记或经用户确认的脚手架决定，不能按目录或个人偏好猜测。
 
 ## 开始前检查
 
@@ -9,7 +9,7 @@
 ```text
 请读取当前批准战略或 Spec、根 CONTEXT.md 和工程登记。
 核对架构身份与既有工程证据，再用 yss-technical-design 起草当前技术设计。
-domain-driven 使用 yss-tactical-design；layered-mvc 使用 yss-mvc-design。
+domain-driven 使用 yss-tactical-design；layered-mvc 使用 yss-technical-design 的 MVC 分支。
 说明状态、事务、并发、幂等、持久化和公开测试 seam，并逐项映射源规则与关键场景。
 列出冲突、延期、依赖和需要的批准；不要提前实现代码。
 ```

package/template/scripts/backend-platforms

@@ -1,14 +1,83 @@
 #!/usr/bin/env node
 import { loadBackendPlatforms, platformBinding, resolveBackendPlatform } from "./lib/backend-platform.mjs";
+
+function parseArgs(argv) {
+  const result = { requireVerified: false, requireProfile: null };
+  for (let index = 0; index < argv.length; index += 1) {
+    const arg = argv[index];
+    if (arg === "--require-verified") result.requireVerified = true;
+    else if (arg === "--require-profile") {
+      const value = argv[++index];
+      if (!value || value.startsWith("--")) throw new TypeError("--require-profile requires a profile id");
+      result.requireProfile = value;
+    } else if (arg.startsWith("--require-profile=")) {
+      result.requireProfile = arg.slice("--require-profile=".length);
+      if (!result.requireProfile) throw new TypeError("--require-profile requires a profile id");
+    } else throw new TypeError(`unknown argument: ${arg}`);
+  }
+  return result;
+}
+
+function componentView(entry) {
+  return Object.fromEntries(Object.entries(entry.component_capabilities ?? {}).map(([capabilityId, item]) => [capabilityId, {
+    status: item.status,
+    provider_kind: item.provider_kind ?? "yss-component",
+    lifecycle: item.lifecycle ?? "active",
+    adoption_policy: item.adoption_policy ?? "allowed",
+    platform_line: item.platform_line ?? null,
+    replacement_gav: item.replacement_gav ?? null,
+    verified_architectures: item.verified_architectures,
+    artifacts: item.artifacts,
+    evidence: item.evidence,
+    blockers: item.blockers,
+    component_digest: item.component_digest
+  }]));
+}
+
 try {
+  const args = parseArgs(process.argv.slice(2));
   const catalog = loadBackendPlatforms();
   const rows = catalog.profiles.map(profile => {
-    const combinations = catalog.compatibility.filter(entry => entry.profile_id === profile.id && entry.spring_boot_version === profile.spring_boot_version).map(entry => {
-      try { resolveBackendPlatform(platformBinding(profile, entry)); return { id: entry.id, status: "verified", parent: entry.parent, bom: entry.bom, architectures: entry.evidence.map(item => item.architecture_family), capabilities: entry.capabilities ?? [] }; }
-      catch (error) { return { id: entry.id, status: "blocked", reason: error.message }; }
-    });
-    return { profile_id: profile.id, spring_boot_version: profile.spring_boot_version, java_version: profile.java_version, recommended_java: profile.java_version === 8 || profile.java_version === 17, selectable: combinations.some(entry => entry.status === "verified"), combinations, blockers: combinations.some(entry => entry.status === "verified") ? [] : profile.candidate_blockers };
+    const combinations = catalog.compatibility
+      .filter(entry => entry.profile_id === profile.id && entry.spring_boot_version === profile.spring_boot_version)
+      .map(entry => {
+        let platformReason = null;
+        try { resolveBackendPlatform(platformBinding(profile, entry)); }
+        catch (error) { platformReason = error.message; }
+        const componentCapabilities = componentView(entry);
+        const componentValues = Object.values(componentCapabilities);
+        return {
+          id: entry.id,
+          status: platformReason ? "blocked" : "verified",
+          parent: entry.parent,
+          bom: entry.bom,
+          architectures: [...new Set(componentValues.flatMap(item => item.verified_architectures))],
+          capabilities: entry.capabilities ?? [],
+          platform_artifact_bindings: entry.platform_artifact_bindings ?? {},
+          external_snapshot_bindings: entry.external_snapshot_bindings ?? [],
+          external_artifact_bindings: entry.external_artifact_bindings ?? [],
+          component_capabilities: componentCapabilities,
+          component_status: {
+            verified: componentValues.filter(item => item.status === "verified").length,
+            blocked: componentValues.filter(item => item.status !== "verified").length
+          },
+          blockers: platformReason ? [platformReason] : []
+        };
+      });
+    const selectable = combinations.some(entry => entry.status === "verified");
+    const blockers = selectable ? [] : [...new Set([...profile.candidate_blockers, ...combinations.flatMap(item => item.blockers)])];
+    return { profile_id: profile.id, spring_boot_version: profile.spring_boot_version, java_version: profile.java_version, component_platform_line: profile.component_platform_line ?? null, recommended_java: profile.java_version === 8 || profile.java_version === 17, selectable, combinations, blockers };
   });
-  process.stdout.write(`${JSON.stringify({ schema_version: 1, profiles: rows }, null, 2)}\n`);
-  if (process.argv.includes("--require-verified") && rows.some(row => !row.selectable)) process.exitCode = 1;
-} catch (error) { process.stderr.write(`${error.message}\n`); process.exitCode = 1; }
+  const matches = args.requireProfile ? rows.filter(row => row.profile_id === args.requireProfile) : [];
+  const requiredProfile = !args.requireProfile ? null : matches.length === 1 ? matches[0] : {
+    profile_id: args.requireProfile,
+    selectable: false,
+    combinations: [],
+    blockers: [matches.length ? "backend-platform: multiple patches require an exact catalog selection" : `backend-platform: unsupported platform_profile: ${args.requireProfile}`]
+  };
+  process.stdout.write(`${JSON.stringify({ schema_version: 2, requested_profile: args.requireProfile, required_profile: requiredProfile, profiles: rows }, null, 2)}\n`);
+  if ((args.requireVerified && rows.some(row => !row.selectable)) || (requiredProfile && !requiredProfile.selectable)) process.exitCode = 1;
+} catch (error) {
+  process.stderr.write(`${error.message}\n`);
+  process.exitCode = 1;
+}