create-yss-spec 3.4.5 → 3.4.7

package/README.md

@@ -2,7 +2,7 @@
 
 用于初始化、接管已有项目并持续同步 `yss-spec-project-template` 研发管理资产的 npm CLI。
 
-源码候选版本：`3.4.5`。当前固定模板身份、来源状态和摘要见 `template.snapshot.json`；CLI 运行时不会拉取模板仓库。`npm create yss-spec@latest` 获取的是实际已发布 npm 包，发布版本请以 `npm view create-yss-spec version` 为准，并用 `create-yss-spec --version` 核对当前执行版本。
+源码候选版本：`3.4.6`。当前固定模板身份、来源状态和摘要见 `template.snapshot.json`；CLI 运行时不会拉取模板仓库。`npm create yss-spec@latest` 获取的是实际已发布 npm 包，发布版本请以 `npm view create-yss-spec version` 为准，并用 `create-yss-spec --version` 核对当前执行版本。
 
 ## 本版模板能力
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "create-yss-spec",
-  "version": "3.4.5",
+  "version": "3.4.7",
   "description": "Initialize a YSS spec project template repository",
   "main": "src/api/index.js",
   "repository": {

package/template/.agents/skills/.strategic-design-skills-manifest.json

@@ -3,7 +3,7 @@
   "source": "iloveZzz/yss-harness-design-agent",
   "source_type": "git-submodule",
   "source_root": ".agents/skills",
-  "source_revision": "e9a28b4cb0d3003a730b0113bb4dad59665e38b5",
+  "source_revision": "4891d8cc15a453df4bf057874c6127419c6c77d8",
   "adaptation_ref": "docs/agents/strategic-design-skills-integration.md",
   "skills": [
     {

package/template/.agents/skills/.yss-skills-manifest.json

@@ -5,7 +5,7 @@
   "source_root": "packages/skills",
   "source_category": "app",
   "excluded_categories": ["library"],
-  "excluded_skills": ["java-backend-commit", "page-module-development", "prototype-page-acceptance"],
+  "excluded_skills": ["component-selection-imports", "java-backend-commit", "page-form-module", "page-list-module", "page-module-development", "page-skeleton", "prototype-page-acceptance", "use-table-height", "use-tree-height", "vue3-best-practices"],
   "source_revision": "c4d958f18cc947cb91cbe1bd48783fa4601cc18f",
   "adaptation_ref": "docs/agents/yss-ui-skills-integration.md",
   "package": {
@@ -14,20 +14,13 @@
   },
   "skills": [
     { "upstream": "api-integration", "canonical": "yss-api-integration", "upstream_hash": "53d265c846f767c5dee9c92f2dc0caced341efd8888631f4b37a46eb486fbbeb" },
-    { "upstream": "component-selection-imports", "canonical": "component-selection-imports", "upstream_hash": "f89c536a23823b540749bab77248c1a09b3e2f43a1bc23e1a59c886a2be5ff94" },
     { "upstream": "file-export-download", "canonical": "file-export-download", "upstream_hash": "3c281969780e6e6ea6e38818211d84b61655bcc242536785b0375de30d05a458" },
     { "upstream": "formily-foundation", "canonical": "formily-foundation", "upstream_hash": "7736711494f368750d930e96f918bc8ae2d8a0c6b7fd404be165d03441546d9d" },
     { "upstream": "formily-linkage-effects", "canonical": "formily-linkage-effects", "upstream_hash": "2b30d5755b672affdfbe1a21742be2ae4423361ca82d28fc5c1b7b55ef256b6e" },
     { "upstream": "formily-mode-slot-detail", "canonical": "formily-mode-slot-detail", "upstream_hash": "857d4416264c7aadffc19560a6b04eeb4df72a3b1b9110f30d97b2e15de8ce2b" },
     { "upstream": "formily-step-flow", "canonical": "formily-step-flow", "upstream_hash": "600a0a9a72f3bcb30db83d274b8d1082c036adf10c197dff616f76bec1a33d80" },
     { "upstream": "frontend-commit", "canonical": "frontend-commit", "upstream_hash": "ffc1c7813607705c7c1158f4c5d3111aca79e73f1843e33bbc95eda9b5c726de" },
-    { "upstream": "page-form-module", "canonical": "page-form-module", "upstream_hash": "4df686c7267c6be00680ea1faa908e0cf02e59bfe01c8111bbcaa80dea63c9b8" },
-    { "upstream": "page-list-module", "canonical": "page-list-module", "upstream_hash": "303d8fc2161465ec3e81692c7b750ed814307ccf65f4fb51e0de69fe7af38d4f" },
-    { "upstream": "page-skeleton", "canonical": "page-skeleton", "upstream_hash": "d82c44770054d9bb0bc17849c25675e5672f01144614b3ffb846ec575ac19dec" },
     { "upstream": "theme-token-usage", "canonical": "theme-token-usage", "upstream_hash": "b38acb4caf5012c9134df16a312b6be31b2b5d3fd6b976cfccee8d845f27c0ef" },
-    { "upstream": "use-table-height", "canonical": "yss-use-table-height", "upstream_hash": "8a5baa8ca6a8dd2b2ed123391838b1a13e3f5cab8196225ed3429ca5b513d43f" },
-    { "upstream": "use-tree-height", "canonical": "yss-use-tree-height", "upstream_hash": "2a9265cc997c2c20b6cfebbdc19b66b04450278fca5d5db252a5d855b2d95bed" },
-    { "upstream": "vue3-best-practices", "canonical": "vue3-best-practices", "upstream_hash": "924b3b4a6f603aa852e561b975c3e9652b9aad5e237411559c1d24f1f3ef7623" },
     { "upstream": "yedit-table-usage", "canonical": "yedit-table-usage", "upstream_hash": "a2fa606b85783fc140dd1775f02d7cddde02d8f4fc2dc3c2a017cc2f9fe998b1" },
     { "upstream": "yss-formily", "canonical": "yss-formily", "upstream_hash": "f30e312a632c592c9050d00c35c22f2dc032658e6d9fdd6e2b5dc4ac0ea970c8" },
     { "upstream": "yss-ui-business-page-generation", "canonical": "yss-ui-business-page-generation", "upstream_hash": "97ef56c4b60c0281039996ac582ab01987b4d2bbb89989662594a6ce8a77c95f" },

package/template/.agents/skills/formily-mode-slot-detail/SKILL.md

@@ -29,7 +29,7 @@ description: 指导 YFormily 新增、编辑、查看三态与插槽渲染；当
 - 描述列表配置使用 `:detail-options`。默认 `responsive=true`，此时 `columns` 被忽略；响应式列数使用 `maxColumns`、`minColumns`、`minWidth`，固定列数才组合 `responsive: false` 与 `columns`。
 - 查看态插槽命名固定为 `#detail-<path>`，字段路径中的 `.` 替换为 `-`；作用域为 `{ value, item, values }`。
 - 编辑态插槽使用 `x-component: 'Slot'` 与 `x-component-props.name`；`value/onChange` 默认提供，仅在需要 `field` 或整表数据时配置 `params`。
-- 运行时切换 mode 时加 `:key="mode"`，确保当前实现重新创建 form/schema 上下文并避免状态残留。
+- 运行时切换 mode 默认由响应式 `:mode` 与已准备好的 model 驱动，不加动态 `:key` 强制重挂载。只有目标工程当前源码或可复现测试证明 mode 热切换无法正确重建上下文时，才记录证据后局部使用 key；Modal/Drawer 闭环优先通过 `destroy-on-close + v-if="open"` 隔离实例。
 - 查看态不会发送 `update:modelValue`；回填优先在渲染前准备好 `v-model`/`initial-values`，或通过已公开的 `setValues` 更新。
 - 只使用公开实例方法：`getValues`、`setValues`、`submit`、`setFieldState`、`toggle/expand/collapse`；禁止编造 `validate/reset/clearValidate`。
 - 加载详情的 Orval API 错误已由 `mutator.ts` 统一 `message.error` 并 reject，业务 `else`/`catch` 禁止重复提示。
@@ -97,7 +97,6 @@ const schema: ISchema = {
 
 <template>
   <YFormily
-    :key="mode"
     :schema="schema"
     :initial-values="initialValues"
     :mode="mode"
@@ -120,7 +119,7 @@ const schema: ISchema = {
 
 ## 交付检查清单
 
-- [ ] mode 语义和默认值正确，运行时切换配置了 `:key="mode"`。
+- [ ] mode 语义和默认值正确，回填在打开前完成；未无条件使用动态 `:key` 强制重挂载。
 - [ ] 未生成 `detail-as`、旧式详情开关或虚构实例方法。
 - [ ] `detail-options` 已区分响应式 `maxColumns` 与固定列 `columns`。
 - [ ] 查看态插槽路径映射正确，作用域只使用 `{ value, item, values }`。
@@ -133,5 +132,5 @@ const schema: ISchema = {
 
 - 查看态插槽不生效时，先按详情收集后的数据路径核对 `detail-<path>`，不要把 `FormLayout/FormGrid` 容器名拼入路径。
 - 编辑态插槽不生效时，核对 `x-component-props.name` 与模板名；需要整表值时再加入 `params: ['$values']`。
-- 模式切换错乱时先确认 `:key="mode"`，再检查回填数据是否在新实例挂载前准备好。
+- 模式切换错乱时先检查回填数据是否在打开或模式切换前准备好，再核验当前版本对响应式 mode 的行为；只有可复现证据表明必须重建时才使用 key。
 - API 调用 reject 时只恢复 loading 或保留原数据，不重复弹出错误提示。

package/template/.agents/skills/yedit-table-usage/SKILL.md

@@ -36,6 +36,7 @@ description: "配置或修复 YSS UI YEditTable 的行内编辑、候选联动
 - 删除使用 `type: 'action' + actionConfig.buttons[].isConfirm`；不默认使用 `Modal.confirm`。
 - `validate()` 真实返回 `Promise<{ valid: boolean; errorMsg: Map<string, string> }>`。组件 ref 未就绪时不得误判为校验成功。
 - 弹窗/抽屉内使用添加按钮时，高度 Hook 配置 `withAddButton: true`；如果同时分页或开启工具栏，一并开启对应偏移。
+- 自适应高度使用 `useTableHeight(tableAreaRef, options)` 并绑定 `:height="tableHeight"`；直接父容器必须可计算且设置 `min-height: 0`。若表格内容会反向撑开观察容器，改用稳定 `boundaryRef`；弹层展开后高度仍不准时才调用 `nextTick(recalculateHeight)`。
 - API 失败由 `mutator.ts` 统一提示并 reject。Hook 中不写 `success === false` 分支，不在 `else/catch` 重复 `message.error`；清理状态放在 `finally`。
 
 ## 标准代码骨架
@@ -218,6 +219,7 @@ const textFilterColumn: YEditTableColumn = {
 - [ ] 查看态同时禁用编辑、隐藏添加按钮和移除操作列。
 - [ ] `validate()` 按 `{ valid, errorMsg }` 处理，组件 ref 未就绪时不提交。
 - [ ] API Hook 没有重复 `message.error`，前端临时 key 不传给后端。
+- [ ] `withAddButton/withPagination/withToolbar` 与实际开关一致，观察容器稳定且没有双滚动条。
 
 ## 失败兜底策略
 

package/template/.agents/skills/yss-application/SKILL.md

@@ -27,13 +27,15 @@ Application 层用例编排 skill。负责协调 Domain 与 Gateway，定义事
 
 ## 工作方式
 
-1. 确认工程来自 `target-domain-model`；`core/client/repository` 等旧架构对本脚手架链路为 `unsupported`。
-2. 确认 Use Case、Application 边界、事务边界已在批准合同中写明。
-3. 实现 AppService 时调用 Domain Service / Gateway，核心规则下沉 Domain。
-4. Web DTO 转 Application Command/Result 属于 Web，PO 转 Domain 属于 Infrastructure；Application 内确有独立模型转换时才加载 `mapstruct`，并统一 Spring Bean 与构造器注入。
-5. 详细包结构、注解、示例和旧架构阻断边界见 `references/application-layer-guide.md`。
+1. 按 `architecture_identity.architecture_profile` 选择且只选择对应 Profile reference；Profile 未登记、与 Manifest 不一致或成熟度不满足当前任务时返回 `blocked`。
+2. `target-domain-model` 才执行 Domain Service / Gateway、跨聚合编排和下述 DDD 产物规则；`layered-mvc-service` 与 `mvc-data-analysis-v1` 分别按其 service/core Profile 承载用例、规则和事务，不加载 DDD Gateway。
+3. 确认 Use Case、Application/service/core 边界与事务边界已在批准合同中写明。
+4. Web DTO 到内部 Command/Result 的转换归 Web 边界，持久化转换归 Repository/Infrastructure；用例层确有独立模型转换时才加载 `mapstruct`，并统一 Spring Bean 与构造器注入。
+5. DDD 的详细包结构、注解、示例和旧架构阻断边界见 `references/application-layer-guide.md`；MVC 不读取该 guide。
 
-## 产物范围
+## DDD 产物范围
+
+以下路径只适用于 `target-domain-model`；MVC 产物以选中的 Profile reference 和合同为准。
 
 - `application/.../command/*Command.java`、`application/.../query/*Query.java`、`application/.../result/*Result.java`
 - `application/.../port/*QueryPort.java`

package/template/.agents/skills/yss-audit-log/SKILL.md

@@ -18,7 +18,7 @@ description: "接入或排查 YSS AuditLog 的 SpEL 摘要、异步发布、订
 1. 先确认用户是在做“接入”还是“排障”。
 2. 涉及真实类名、配置项、订阅器或排障时，先读 `references/source-index.md`，再定位源码或文档。
 3. 优先检查项目里是否已有注解、配置项和订阅器实现，再决定改法。
-4. 只给出与当前问题直接相关的接入点：注解、配置、切面链路、订阅器扩展。
+4. 只给出与当前问题直接相关的接入点：注解、配置、切面链路、`CurrentUserProvider` 和订阅器扩展。
 5. 需要看实现细节时，再读取 `assets/` 下源码，不要先讲整套组件原理。
 
 ## 源码索引
@@ -34,23 +34,24 @@ description: "接入或排查 YSS AuditLog 的 SpEL 摘要、异步发布、订
 - 启动类是否启用了类似 `@EnableAuditLog` 的能力。
 - 目标方法是否是可被 AOP 代理拦截的 Spring Bean 方法。
 - `@AuditLog` 是否标在正确的方法上。
-- `summary` 中的 SpEL 变量必须使用源码实际暴露的 context keys (`参数审计` / `结果审计`)；方法参数名不会自动进入 context。
-- 当前源码的变量正则只接受 ASCII 字母、数字、下划线和路径符号，不能可靠识别中文 context key；涉及 `#{参数审计...}` / `#{结果审计...}` 时先标记 `blocked`，除非组件修复并有表达式测试，不要声称摘要会被解析。
-- 项目编译参数是否保留了参数名。
+- `boot3-java17` 的 SpEL 根上下文只暴露 ASCII key：`args` 和 `result`；例如 `#{args[0]}`、`#{result[name]}`。方法参数名不会自动进入上下文。
+- `args` 仅在 `@AuditLog(isNeedArgs = true)` 时写入，`result` 仅在 `isNeedResult = true` 时写入；表达式引用未启用的 key 属于配置错误，必须由组件 seam 测试覆盖。
+- `boot3-java17` 不再使用中文 context key，也不得把 Boot 2 的历史模板直接复制到 Boot 3。处理旧模板时先读取所选平台线索引并显式迁移。
 - `yss.audit.enabled` 是否开启；`sendSysManageEnabled` 与 `auditLogPrintEnabled` 在当前实现中不会自动阻止订阅器注册，需按源码验证，不能假设开关生效。
+- 审计身份由 `CurrentUserProvider` 提供；不得在审计切面中重新解析 Header 或未验签 JWT。
 
 ## 排障顺序
 
 1. 注解是否生效。
 2. 切面是否拦截到方法。
-3. SpEL 是否能从参数和返回值取到值。
+3. SpEL 是否能从已启用的 `args` / `result` 取到值。
 4. 发布服务是否成功入队。
 5. 订阅器是否被 Spring 扫描并注册。
 6. 下游系统管理或打印订阅器是否被开关禁用。
 7. 异步线程池或事件发布异常是否被吞掉。
-8. 参数名、返回值字段、异常分支是否满足摘要模板。
+8. 参数位置、返回值字段、异常分支是否满足摘要模板。
 
-审计切面当前是 `@AfterReturning`，只记录成功返回；异常审计、参数脱敏、队列满丢弃、线程池关闭、重试和幂等必须单独设计并测试。
+`boot3-java17` 审计切面当前是 `@AfterReturning`，只记录成功返回；异常审计、参数脱敏、队列满丢弃、线程池关闭、重试和幂等必须单独设计并测试。组件测试至少覆盖 `#{result[name]}`、`args` / `result` 资源写入和可信身份来源。
 
 ## 修改约束
 
@@ -65,3 +66,7 @@ description: "接入或排查 YSS AuditLog 的 SpEL 摘要、异步发布、订
 - 审计切面与 SpEL 解析：`assets/AuditLogAspect.java`
 - 异步发布链路：`assets/YssAuditPublishService.java`
 - 默认订阅器：`assets/YssAuditLogPrintSubscriberImpl.java`、`assets/YssAuditLogSysManagerSubscriberImpl.java`
+
+## 平台与源码门禁
+
+接入、修改、代码生成或给出精确类名/配置前，读取 [后端组件平台与源码门禁](../yss-skill-source-index-refresh/references/backend-component-platform-compatibility.md)，从批准的 `platform_configuration.component_platform_line` 选择 `source-index.boot2-java8.md` 或 `source-index.boot3-java17.md`，并以 `--skill yss-audit-log --platform-line <line> --source-root <matching-root>` 运行统一 freshness 校验。平台线与源码根不匹配、组件 tree 不一致、组件子树 dirty、索引缺少平台信号，或 Manifest / 组件 GAV 缺少 verified 兼容证据时返回 `blocked`；不得回退另一代索引，也不在业务实现中升级、降级或替换 YSS 组件。既有工程只读分诊可继续，但不得据此宣称跨 Boot/JDK 兼容。

package/template/.agents/skills/yss-audit-log/references/source-index.boot2-java8.md

@@ -0,0 +1,57 @@
+# yss-audit-log Source Index
+
+Index schema: `backend-component-source-index-v2`
+Platform line: `boot2-java8`
+Generated: 2026-09-18T18:40:26.031Z
+Source commit: `a3be2b2e33dca4545782e2b31894aaa00d0305cd`
+Component worktree: `clean`
+Component tree `yss-microservice-components/yss-component-audit-log`: `d00f2e156714e43e8ec70b28e0bd33967d130485`
+Indexed source root: resolved at refresh time; set `YSS_SOURCE_ROOT_BOOT2_JAVA8` to reproduce or refresh.
+
+This file is generated by `yss-skill-source-index-refresh/scripts/refresh-yss-skill-index.mjs`. Do not hand-edit generated sections.
+
+Paths are relocatable source hints. Exact guidance requires a matching component tree and a clean indexed component subtree; the repository commit is trace metadata and may differ when unrelated components change.
+
+## Component Path Hints
+
+- `yss-microservice-components/yss-component-audit-log` (existed when indexed)
+
+## Documentation Files
+
+- No component documentation files found.
+
+Component documentation is a discovery aid. For API signatures, conditions and defaults, prefer the indexed source facts below when documentation differs.
+
+## Maven Modules
+
+- `yss-microservice-components/yss-component-audit-log/pom.xml` — GAV `com.yss.cloud:yss-component-audit-log:2.0.0-SNAPSHOT`; parent `com.yss.cloud:yss-microservice-components:2.0.0-SNAPSHOT`
+
+## Platform Signals
+
+- Inherited Java signals: `1.8`.
+- Inherited Spring Boot signals: `2.7.18`.
+- Namespace source signals: `javax.*` in 2 main Java files; `jakarta.*` in 0 main Java files.
+- Auto-configuration metadata: 0 `spring.factories`; 0 `AutoConfiguration.imports` files.
+- These are source observations, not compatibility certification. Use the approved `platform_configuration` and verified compatibility evidence before integration or generation.
+
+## Key Java Entry Points
+
+- `yss-microservice-components/yss-component-audit-log/src/main/java/com/yss/cloud/audit/AuditLog.java` — `sha256:09d7d6cae894bbb9d5e9651812d0cc599dd5907cc728b81c82843e57845d3a11`
+- `yss-microservice-components/yss-component-audit-log/src/main/java/com/yss/cloud/audit/EnableAuditLog.java` — `sha256:cc1085f77fcd3ffd995a73d4eca083059d204c8aee3c51779fa9427797033a9b`
+- `yss-microservice-components/yss-component-audit-log/src/main/java/com/yss/cloud/audit/configuration/AuditConfiguration.java` — `sha256:abf75caddee4ade5169a178be11b56ad2a5da9525b50e11d4e6306fef6430ca4`
+- `yss-microservice-components/yss-component-audit-log/src/main/java/com/yss/cloud/audit/configuration/AuditConfigurationProperties.java` — `sha256:32664d23f229583e05a1f14a3a45547b585d9f521d2f20c08604b04fcc1e2b3d`
+- `yss-microservice-components/yss-component-audit-log/src/main/java/com/yss/cloud/audit/configuration/AuditLogAspect.java` — `sha256:e66fc07f1a13b03cfb5d01299cee273d58534d66761d729ea133e850848980c3`
+- `yss-microservice-components/yss-component-audit-log/src/main/java/com/yss/cloud/audit/configuration/EnableAuditLogImportSelector.java` — `sha256:4877f5c1319d16c8796a2cd775d20d8703c6000a33069b4eff2a566b685b47ef`
+- `yss-microservice-components/yss-component-audit-log/src/main/java/com/yss/cloud/audit/configuration/UUIDGenerator.java` — `sha256:02f61fcd3e1c225acc7aaf36dfdc16f1ccb429b79711f969bb3fdf40a7bcbfaa`
+- `yss-microservice-components/yss-component-audit-log/src/main/java/com/yss/cloud/audit/subscriber/YssAuditPublishService.java` — `sha256:741031682d4ae8776c3cfdc6def08a6e3ab962f7159d6941599d32ed9dbc0c96`
+- `yss-microservice-components/yss-component-audit-log/src/main/java/com/yss/cloud/audit/subscriber/YssAuditSubscriber.java` — `sha256:f8274254df0be009f26f5fd1bbffd801b5410f28c0dd2981182bfe4940be66da`
+- `yss-microservice-components/yss-component-audit-log/src/main/java/com/yss/cloud/audit/subscriber/impl/YssAuditLogPrintSubscriberImpl.java` — `sha256:bf74f628ffa94b3f58402960b0808663410235f979cf83cafeadacbe4de7a798`
+- `yss-microservice-components/yss-component-audit-log/src/main/java/com/yss/cloud/audit/subscriber/impl/YssAuditLogSysManagerSubscriberImpl.java` — `sha256:f5be56e112c046957f5589f66450bea9421e32b1aaf1cd0d42f97c998338dab4`
+
+## Freshness and Use
+
+- Locate the current source root using `YSS_SOURCE_ROOT_BOOT2_JAVA8`, CodeGraph, Maven artifact names or repository search.
+- Compare each indexed `Component tree` with `git rev-parse HEAD:<component-path>` and require the current component subtree to be clean before exact guidance.
+- Run `node ../yss-skill-source-index-refresh/scripts/check-backend-skill-source-index.mjs --skill <skill-id> --platform-line boot2-java8 --source-root <root>` from the canonical skill root before exact integration guidance.
+- A repository commit difference alone is not stale when the component tree is unchanged; a component tree mismatch or component-local dirty state is stale.
+- Read only the source entries needed for the current decision or troubleshooting path.

package/template/.agents/skills/yss-audit-log/references/source-index.boot3-java17.md

@@ -0,0 +1,58 @@
+# yss-audit-log Source Index
+
+Index schema: `backend-component-source-index-v2`
+Platform line: `boot3-java17`
+Generated: 2026-09-18T18:40:26.031Z
+Source commit: `5041c41fbe96c25821bbc15f688c0521b8c97a3d`
+Component worktree: `clean`
+Component tree `yss-microservice-components/yss-component-audit-log`: `c642c01ee64abd557d3637eb7fe15f9f4947cb2d`
+Indexed source root: resolved at refresh time; set `YSS_SOURCE_ROOT_BOOT3_JAVA17` to reproduce or refresh.
+
+This file is generated by `yss-skill-source-index-refresh/scripts/refresh-yss-skill-index.mjs`. Do not hand-edit generated sections.
+
+Paths are relocatable source hints. Exact guidance requires a matching component tree and a clean indexed component subtree; the repository commit is trace metadata and may differ when unrelated components change.
+
+## Component Path Hints
+
+- `yss-microservice-components/yss-component-audit-log` (existed when indexed)
+
+## Documentation Files
+
+- No component documentation files found.
+
+Component documentation is a discovery aid. For API signatures, conditions and defaults, prefer the indexed source facts below when documentation differs.
+
+## Maven Modules
+
+- `yss-microservice-components/yss-component-audit-log/pom.xml` — GAV `com.yss.cloud:yss-component-audit-log:3.0.0-SNAPSHOT`; parent `com.yss.cloud:yss-microservice-components:3.0.0-SNAPSHOT`
+
+## Platform Signals
+
+- Inherited Java signals: `17`.
+- Inherited Spring Boot signals: `3.5.16`.
+- Namespace source signals: `javax.*` in 0 main Java files; `jakarta.*` in 2 main Java files.
+- Auto-configuration metadata: 0 `spring.factories`; 0 `AutoConfiguration.imports` files.
+- These are source observations, not compatibility certification. Use the approved `platform_configuration` and verified compatibility evidence before integration or generation.
+
+## Key Java Entry Points
+
+- `yss-microservice-components/yss-component-audit-log/src/main/java/com/yss/cloud/audit/AuditLog.java` — `sha256:09d7d6cae894bbb9d5e9651812d0cc599dd5907cc728b81c82843e57845d3a11`
+- `yss-microservice-components/yss-component-audit-log/src/main/java/com/yss/cloud/audit/EnableAuditLog.java` — `sha256:cc1085f77fcd3ffd995a73d4eca083059d204c8aee3c51779fa9427797033a9b`
+- `yss-microservice-components/yss-component-audit-log/src/main/java/com/yss/cloud/audit/configuration/AuditConfiguration.java` — `sha256:abf75caddee4ade5169a178be11b56ad2a5da9525b50e11d4e6306fef6430ca4`
+- `yss-microservice-components/yss-component-audit-log/src/main/java/com/yss/cloud/audit/configuration/AuditConfigurationProperties.java` — `sha256:32664d23f229583e05a1f14a3a45547b585d9f521d2f20c08604b04fcc1e2b3d`
+- `yss-microservice-components/yss-component-audit-log/src/main/java/com/yss/cloud/audit/configuration/AuditLogAspect.java` — `sha256:3db4297a0d52e97cff70a13800ae4f412f87799abc231e9cd8b9b43ecf7c1c00`
+- `yss-microservice-components/yss-component-audit-log/src/main/java/com/yss/cloud/audit/configuration/EnableAuditLogImportSelector.java` — `sha256:4877f5c1319d16c8796a2cd775d20d8703c6000a33069b4eff2a566b685b47ef`
+- `yss-microservice-components/yss-component-audit-log/src/main/java/com/yss/cloud/audit/configuration/UUIDGenerator.java` — `sha256:02f61fcd3e1c225acc7aaf36dfdc16f1ccb429b79711f969bb3fdf40a7bcbfaa`
+- `yss-microservice-components/yss-component-audit-log/src/main/java/com/yss/cloud/audit/feign/YssDmSystemManageFeign.java` — `sha256:3a76cd33dbff182f964975c7ce4a63405660c0edb15057ff57eeebf0085b942a`
+- `yss-microservice-components/yss-component-audit-log/src/main/java/com/yss/cloud/audit/subscriber/YssAuditPublishService.java` — `sha256:0de3ddc7ff56051d7b955a4d9d0f0ec3230d5674abfb2a3cc10ba457dbcc7afd`
+- `yss-microservice-components/yss-component-audit-log/src/main/java/com/yss/cloud/audit/subscriber/YssAuditSubscriber.java` — `sha256:f8274254df0be009f26f5fd1bbffd801b5410f28c0dd2981182bfe4940be66da`
+- `yss-microservice-components/yss-component-audit-log/src/main/java/com/yss/cloud/audit/subscriber/impl/YssAuditLogPrintSubscriberImpl.java` — `sha256:bf74f628ffa94b3f58402960b0808663410235f979cf83cafeadacbe4de7a798`
+- `yss-microservice-components/yss-component-audit-log/src/main/java/com/yss/cloud/audit/subscriber/impl/YssAuditLogSysManagerSubscriberImpl.java` — `sha256:5f8853eea7484726ba3816899b3ea3afb7fb3c74635ff7008d331ec9b697d2ef`
+
+## Freshness and Use
+
+- Locate the current source root using `YSS_SOURCE_ROOT_BOOT3_JAVA17`, CodeGraph, Maven artifact names or repository search.
+- Compare each indexed `Component tree` with `git rev-parse HEAD:<component-path>` and require the current component subtree to be clean before exact guidance.
+- Run `node ../yss-skill-source-index-refresh/scripts/check-backend-skill-source-index.mjs --skill <skill-id> --platform-line boot3-java17 --source-root <root>` from the canonical skill root before exact integration guidance.
+- A repository commit difference alone is not stale when the component tree is unchanged; a component tree mismatch or component-local dirty state is stale.
+- Read only the source entries needed for the current decision or troubleshooting path.

package/template/.agents/skills/yss-audit-log/references/source-index.md

@@ -1,43 +1,10 @@
-# yss-audit-log Source Index
+# yss-audit-log Source Index Router
 
-Generated: 2026-08-17T12:03:37.436Z
-Source commit: `38b556a5081e6c66c0c538cbc1ef839b19996ed3`
-Source worktree: `dirty`
-Indexed source root: resolved at refresh time; set `YSS_SOURCE_ROOT` to reproduce or refresh.
+Index schema: `backend-component-source-index-router-v1`
 
-This file is generated by `yss-skill-source-index-refresh/scripts/refresh-yss-skill-index.mjs`. Do not hand-edit generated sections.
+Select the source index from the approved `platform_configuration.component_platform_line`; do not infer a line from imports, a branch name or a requested upgrade.
 
-Paths below are source path hints captured at refresh time. If they do not exist in the current workspace, locate sources using `YSS_SOURCE_ROOT`, CodeGraph, package/class names, Maven artifact names, or repository search before assuming the source is unavailable.
+- `boot2-java8` — [Spring Boot 2.7 / Java 8 maintenance line](source-index.boot2-java8.md)
+- `boot3-java17` — [Spring Boot 3.5 / Java 17 mainline](source-index.boot3-java17.md)
 
-## Component Path Hints
-
-- `yss-microservice-components/yss-component-audit-log` (existed when indexed)
-
-## Documentation Files
-
-- No component documentation files found.
-
-## Maven Modules
-
-- `yss-microservice-components/yss-component-audit-log`
-
-## Key Java Entry Points
-
-- `yss-microservice-components/yss-component-audit-log/src/main/java/com/yss/cloud/audit/AuditLog.java`
-- `yss-microservice-components/yss-component-audit-log/src/main/java/com/yss/cloud/audit/EnableAuditLog.java`
-- `yss-microservice-components/yss-component-audit-log/src/main/java/com/yss/cloud/audit/configuration/AuditConfiguration.java`
-- `yss-microservice-components/yss-component-audit-log/src/main/java/com/yss/cloud/audit/configuration/AuditConfigurationProperties.java`
-- `yss-microservice-components/yss-component-audit-log/src/main/java/com/yss/cloud/audit/configuration/AuditLogAspect.java`
-- `yss-microservice-components/yss-component-audit-log/src/main/java/com/yss/cloud/audit/configuration/EnableAuditLogImportSelector.java`
-- `yss-microservice-components/yss-component-audit-log/src/main/java/com/yss/cloud/audit/configuration/UUIDGenerator.java`
-- `yss-microservice-components/yss-component-audit-log/src/main/java/com/yss/cloud/audit/feign/YssDmSystemManageFeign.java`
-- `yss-microservice-components/yss-component-audit-log/src/main/java/com/yss/cloud/audit/subscriber/YssAuditPublishService.java`
-- `yss-microservice-components/yss-component-audit-log/src/main/java/com/yss/cloud/audit/subscriber/YssAuditSubscriber.java`
-- `yss-microservice-components/yss-component-audit-log/src/main/java/com/yss/cloud/audit/subscriber/impl/YssAuditLogPrintSubscriberImpl.java`
-- `yss-microservice-components/yss-component-audit-log/src/main/java/com/yss/cloud/audit/subscriber/impl/YssAuditLogSysManagerSubscriberImpl.java`
-
-## Recommended Next Reads
-
-- Start with the documentation files above when learning component usage.
-- Search the key Java entry points for annotations, auto configuration, properties, aspects, interceptors, handlers, and result objects before changing application code.
-- Prefer existing component extension points over rewriting framework logic in business modules.
+Run the freshness checker with the same explicit `--platform-line` and its matching clean source root before exact integration guidance.

package/template/.agents/skills/yss-cache/SKILL.md

@@ -39,6 +39,10 @@ description: "接入或排查 YSS QueryCache、UpdateCache、ClearCache、TTL、
 
 - `scripts/inspect-cache-usage.sh <project-root>`：只读扫描消费项目；发现阻断缺陷返回 1，输入或环境错误返回 2。
 - `scripts/verify-cache-component.sh [--source-root PATH] [--consumer-root PATH --consumer-module MODULE]`：验证组件、真实 Redis、Java 8 字节码及可选消费模块。
-- `scripts/check-skill-freshness.sh [source-root]`：比较技能契约与当前组件源码；发现漂移返回 1。
+- `scripts/check-skill-freshness.sh <boot2-java8|boot3-java17> [source-root]`：比较所选平台线的技能契约与当前组件源码；发现平台错配或漂移返回 1。
 
 当组件源码变化后，用 `yss-skill-source-index-refresh` 刷新 [source-index.md](references/source-index.md)，再运行 freshness 检查。不要手工修改生成索引。
+
+## 平台与源码门禁
+
+接入、修改、代码生成或给出精确类名/配置前，读取 [后端组件平台与源码门禁](../yss-skill-source-index-refresh/references/backend-component-platform-compatibility.md)，从批准的 `platform_configuration.component_platform_line` 选择 `source-index.boot2-java8.md` 或 `source-index.boot3-java17.md`，并以 `--skill yss-cache --platform-line <line> --source-root <matching-root>` 运行统一 freshness 校验。平台线与源码根不匹配、组件 tree 不一致、组件子树 dirty、索引缺少平台信号，或 Manifest / 组件 GAV 缺少 verified 兼容证据时返回 `blocked`；不得回退另一代索引，也不在业务实现中升级、降级或替换 YSS 组件。既有工程只读分诊可继续，但不得据此宣称跨 Boot/JDK 兼容。

package/template/.agents/skills/yss-cache/references/source-index.boot2-java8.md

@@ -0,0 +1,81 @@
+# yss-cache Source Index
+
+Index schema: `backend-component-source-index-v2`
+Platform line: `boot2-java8`
+Generated: 2026-09-18T18:40:26.031Z
+Source commit: `a3be2b2e33dca4545782e2b31894aaa00d0305cd`
+Component worktree: `clean`
+Component tree `yss-microservice-components/yss-component-cache-parent`: `bc17b39c68a6ad0a96a5fad506f82652a70a461c`
+Indexed source root: resolved at refresh time; set `YSS_SOURCE_ROOT_BOOT2_JAVA8` to reproduce or refresh.
+
+This file is generated by `yss-skill-source-index-refresh/scripts/refresh-yss-skill-index.mjs`. Do not hand-edit generated sections.
+
+Paths are relocatable source hints. Exact guidance requires a matching component tree and a clean indexed component subtree; the repository commit is trace metadata and may differ when unrelated components change.
+
+## Component Path Hints
+
+- `yss-microservice-components/yss-component-cache-parent` (existed when indexed)
+
+## Documentation Files
+
+- `yss-microservice-components/yss-component-cache-parent/readme.md`
+
+Component documentation is a discovery aid. For API signatures, conditions and defaults, prefer the indexed source facts below when documentation differs.
+
+## Maven Modules
+
+- `yss-microservice-components/yss-component-cache-parent/pom.xml` — GAV `com.yss.cloud:yss-component-cache-parent:3.0.0-SNAPSHOT`; parent `com.yss.cloud:yss-microservice-components:2.0.0-SNAPSHOT`
+- `yss-microservice-components/yss-component-cache-parent/yss-component-cache-starter/pom.xml` — GAV `com.yss.cloud:yss-component-cache-starter:3.0.0-SNAPSHOT`; parent `com.yss.cloud:yss-component-cache-parent:3.0.0-SNAPSHOT`
+- `yss-microservice-components/yss-component-cache-parent/yss-component-caffeine-cache/pom.xml` — GAV `com.yss.cloud:yss-component-caffeine-cache:3.0.0-SNAPSHOT`; parent `com.yss.cloud:yss-component-cache-parent:3.0.0-SNAPSHOT`
+- `yss-microservice-components/yss-component-cache-parent/yss-component-hazelcast-cache/pom.xml` — GAV `com.yss.cloud:yss-component-hazelcast-cache:3.0.0-SNAPSHOT`; parent `com.yss.cloud:yss-component-cache-parent:3.0.0-SNAPSHOT`
+- `yss-microservice-components/yss-component-cache-parent/yss-component-jetcache/pom.xml` — GAV `com.yss.cloud:yss-component-jetcache:3.0.0-SNAPSHOT`; parent `com.yss.cloud:yss-component-cache-parent:3.0.0-SNAPSHOT`
+- `yss-microservice-components/yss-component-cache-parent/yss-component-redis-cache/pom.xml` — GAV `com.yss.cloud:yss-component-redis-cache:3.0.0-SNAPSHOT`; parent `com.yss.cloud:yss-component-cache-parent:3.0.0-SNAPSHOT`
+- `yss-microservice-components/yss-component-cache-parent/yss-component-spring-cache/pom.xml` — GAV `com.yss.cloud:yss-component-spring-cache:3.0.0-SNAPSHOT`; parent `com.yss.cloud:yss-component-cache-parent:3.0.0-SNAPSHOT`
+
+## Platform Signals
+
+- Inherited Java signals: `1.8`.
+- Inherited Spring Boot signals: `2.7.18`.
+- Namespace source signals: `javax.*` in 3 main Java files; `jakarta.*` in 0 main Java files.
+- Auto-configuration metadata: 4 `spring.factories`; 0 `AutoConfiguration.imports` files.
+- These are source observations, not compatibility certification. Use the approved `platform_configuration` and verified compatibility evidence before integration or generation.
+
+## Key Java Entry Points
+
+- `yss-microservice-components/yss-component-cache-parent/yss-component-caffeine-cache/src/main/java/com/yss/cloud/cache/caffeine/config/CacheCaffeineManagerConfig.java` — `sha256:3a24a45d5958d2b854f7a1a58e33e90f71fac5ea1ded71545cdb6e6467c17165`
+- `yss-microservice-components/yss-component-cache-parent/yss-component-caffeine-cache/src/main/java/com/yss/cloud/cache/caffeine/config/CacheCaffeineResolver.java` — `sha256:a4c55043da2519763d2ff41f02eee49a3c48e9e300d57e349c57b4a7a3d5ff0d`
+- `yss-microservice-components/yss-component-cache-parent/yss-component-caffeine-cache/src/main/java/com/yss/cloud/cache/caffeine/config/CaffeineCacheBackendProvider.java` — `sha256:a1abe2aa93b43a296c281f8fe6c10d48623f2702897ecddfd0f598aead9c3c1e`
+- `yss-microservice-components/yss-component-cache-parent/yss-component-hazelcast-cache/src/main/java/com/yss/cloud/cache/hazelcast/config/CacheHazelcastManagerConfig.java` — `sha256:4636be7f75c4ac4e14e32fc84d79c1cbd52bfba7c3db46144b924a8f970ba73d`
+- `yss-microservice-components/yss-component-cache-parent/yss-component-hazelcast-cache/src/main/java/com/yss/cloud/cache/hazelcast/config/HazelcastCacheBackendProvider.java` — `sha256:8dff13225a69fb3f22a0640754ba0c9c314ce2f048c6145740400350f0d22514`
+- `yss-microservice-components/yss-component-cache-parent/yss-component-hazelcast-cache/src/main/java/com/yss/cloud/cache/hazelcast/config/YssCacheHazelcastProperties.java` — `sha256:52568d1eadaafd7a054b5fd765303b5c840b9a4660370ace933267da716424ac`
+- `yss-microservice-components/yss-component-cache-parent/yss-component-jetcache/src/main/java/com/yss/cloud/cache/jetcache/CacheManagerCompose.java` — `sha256:dbce39f2a3b0f13e8ea8da9ae952ace9bba5c89e1dcec8e1a71cc8f2e4dfabe9`
+- `yss-microservice-components/yss-component-cache-parent/yss-component-redis-cache/src/main/java/com/yss/cloud/cache/redis/config/RedisCacheBackendProvider.java` — `sha256:fd9dea0dd93a9325c2399b80c88ca47b8a3c7ad886ae29ef0973ea986ff6314b`
+- `yss-microservice-components/yss-component-cache-parent/yss-component-redis-cache/src/main/java/com/yss/cloud/cache/redis/config/RedisConnFactoryConfig.java` — `sha256:7e0bc3a62ab0a202c0a450d87b2eb486440483f7a1f4bcc1920ea38310e397ec`
+- `yss-microservice-components/yss-component-cache-parent/yss-component-redis-cache/src/main/java/com/yss/cloud/cache/redis/config/RedisTemplateConfig.java` — `sha256:d6939ee2408beebfe8866e547155c13d372e061c50646961e1b40c77e017fecf`
+- `yss-microservice-components/yss-component-cache-parent/yss-component-redis-cache/src/main/java/com/yss/cloud/cache/redis/config/SafeRedisCache.java` — `sha256:cab1c61c2284ddcc2f88435f76882378175e8d3674113df2da715775d9e265b2`
+- `yss-microservice-components/yss-component-cache-parent/yss-component-redis-cache/src/main/java/com/yss/cloud/cache/redis/config/YssCacheRedisResolver.java` — `sha256:786af0511754e90f70315c106bd34ba24a50024cbc3e9feff46ff62ba65ff964`
+- `yss-microservice-components/yss-component-cache-parent/yss-component-redis-cache/src/main/java/com/yss/cloud/cache/repository/BaseRedisRepository.java` — `sha256:c79736715e3881a3c8fcb57f44b9024813954c8bc4d9185d9ddbe78f1d6eb749`
+- `yss-microservice-components/yss-component-cache-parent/yss-component-redis-cache/src/main/java/com/yss/cloud/cache/repository/YssDatamiddle.java` — `sha256:e6f29975ea8b282c8ff51318855a86161cc213210669a735ec68c53268493dc1`
+- `yss-microservice-components/yss-component-cache-parent/yss-component-spring-cache/src/main/java/com/yss/cloud/cache/ApplicationContextCacheHelper.java` — `sha256:218246ded19de9fb5a3c5d448f50bd34a208b569e0c5b5c0f9d8b8ec8e25982c`
+- `yss-microservice-components/yss-component-cache-parent/yss-component-spring-cache/src/main/java/com/yss/cloud/cache/CacheComposeResolver.java` — `sha256:d70f6743f3cab0384cda7860e345206b341148e30b9c72bacf7bf7674ac2b923`
+- `yss-microservice-components/yss-component-cache-parent/yss-component-spring-cache/src/main/java/com/yss/cloud/cache/CacheManagerCompose.java` — `sha256:57d0a7a2f31d12d4bea6ac4cbc975cede9d35797f0ee6f4781c39388ed6b9c0a`
+- `yss-microservice-components/yss-component-cache-parent/yss-component-spring-cache/src/main/java/com/yss/cloud/cache/CacheMemResolver.java` — `sha256:206c53772d6d5ca59ff30c16967e2b7048614a887e65489667f07d0b4fc9cf93`
+- `yss-microservice-components/yss-component-cache-parent/yss-component-spring-cache/src/main/java/com/yss/cloud/cache/CacheRedisResolver.java` — `sha256:eae6535764caa0f8023051173a81f490408c436055f396f59a965fb4db5df8d4`
+- `yss-microservice-components/yss-component-cache-parent/yss-component-spring-cache/src/main/java/com/yss/cloud/cache/EnableYssCloudCache.java` — `sha256:5db0b797d3deb45f06fd68f9d17b66d7248c6c78dcb90d147c6f6c5b04afc214`
+- `yss-microservice-components/yss-component-cache-parent/yss-component-spring-cache/src/main/java/com/yss/cloud/cache/EnableYssCloudRedisCache.java` — `sha256:1310f6d89a470c0057e6cf25ff095af1024825f27fde376beefbcdde81cb902a`
+- `yss-microservice-components/yss-component-cache-parent/yss-component-spring-cache/src/main/java/com/yss/cloud/cache/YssCacheBackendProvider.java` — `sha256:a58c8b7634a8608766c9bdd5180bcb2949c4ee47af3497c573a006703fc38489`
+- `yss-microservice-components/yss-component-cache-parent/yss-component-spring-cache/src/main/java/com/yss/cloud/cache/YssCacheInterceptor.java` — `sha256:80449fa08d253b0defbdc3d859a797b84aaeaf9098d52cf93b2a45e40416411e`
+- `yss-microservice-components/yss-component-cache-parent/yss-component-spring-cache/src/main/java/com/yss/cloud/cache/YssCacheProperties.java` — `sha256:4b6d6850096fe4ac06567e7a2a2802802853d4aa824c22f17530efdcfb3191a4`
+- `yss-microservice-components/yss-component-cache-parent/yss-component-spring-cache/src/main/java/com/yss/cloud/cache/annotation/ClearCache.java` — `sha256:61dd140b8a2126e2619f19484908757409766a0647bd2fdd7c0d96a1600452cf`
+- `yss-microservice-components/yss-component-cache-parent/yss-component-spring-cache/src/main/java/com/yss/cloud/cache/annotation/QueryCache.java` — `sha256:7368d795819edc21ecf38a9c1604e5642cdb4d841251e85634d6a877e5b13529`
+- `yss-microservice-components/yss-component-cache-parent/yss-component-spring-cache/src/main/java/com/yss/cloud/cache/annotation/UpdateCache.java` — `sha256:2efe5f0d1134cba3bc0076770f3fb4b2cf78433bc2c53d21c256bb3dd7aa2a92`
+- `yss-microservice-components/yss-component-cache-parent/yss-component-spring-cache/src/main/java/com/yss/cloud/cache/annotation/YssCacheAnnotationParser.java` — `sha256:9838e82ae26fa8b52c74e95946c4f837379b010efb06f6ce75d5187b9bb546d2`
+- `yss-microservice-components/yss-component-cache-parent/yss-component-spring-cache/src/main/java/com/yss/cloud/cache/config/CacheOperationSourceConfiguration.java` — `sha256:59266cc7f9f78d35369983dae6dd15debe6f6335e4cf2f20446945412adb3d05`
+
+## Freshness and Use
+
+- Locate the current source root using `YSS_SOURCE_ROOT_BOOT2_JAVA8`, CodeGraph, Maven artifact names or repository search.
+- Compare each indexed `Component tree` with `git rev-parse HEAD:<component-path>` and require the current component subtree to be clean before exact guidance.
+- Run `node ../yss-skill-source-index-refresh/scripts/check-backend-skill-source-index.mjs --skill <skill-id> --platform-line boot2-java8 --source-root <root>` from the canonical skill root before exact integration guidance.
+- A repository commit difference alone is not stale when the component tree is unchanged; a component tree mismatch or component-local dirty state is stale.
+- Read only the source entries needed for the current decision or troubleshooting path.

package/template/.agents/skills/yss-cache/references/source-index.boot3-java17.md

@@ -0,0 +1,83 @@
+# yss-cache Source Index
+
+Index schema: `backend-component-source-index-v2`
+Platform line: `boot3-java17`
+Generated: 2026-09-18T18:40:26.031Z
+Source commit: `5041c41fbe96c25821bbc15f688c0521b8c97a3d`
+Component worktree: `clean`
+Component tree `yss-microservice-components/yss-component-cache-parent`: `f4f8d5018b5d6ae791d709057751fc892f664abd`
+Indexed source root: resolved at refresh time; set `YSS_SOURCE_ROOT_BOOT3_JAVA17` to reproduce or refresh.
+
+This file is generated by `yss-skill-source-index-refresh/scripts/refresh-yss-skill-index.mjs`. Do not hand-edit generated sections.
+
+Paths are relocatable source hints. Exact guidance requires a matching component tree and a clean indexed component subtree; the repository commit is trace metadata and may differ when unrelated components change.
+
+## Component Path Hints
+
+- `yss-microservice-components/yss-component-cache-parent` (existed when indexed)
+
+## Documentation Files
+
+- `yss-microservice-components/yss-component-cache-parent/readme.md`
+
+Component documentation is a discovery aid. For API signatures, conditions and defaults, prefer the indexed source facts below when documentation differs.
+
+## Maven Modules
+
+- `yss-microservice-components/yss-component-cache-parent/pom.xml` — GAV `com.yss.cloud:yss-component-cache-parent:3.1.0-SNAPSHOT`; parent `com.yss.cloud:yss-microservice-components:3.0.0-SNAPSHOT`
+- `yss-microservice-components/yss-component-cache-parent/yss-component-cache-starter/pom.xml` — GAV `com.yss.cloud:yss-component-cache-starter:3.1.0-SNAPSHOT`; parent `com.yss.cloud:yss-component-cache-parent:3.1.0-SNAPSHOT`
+- `yss-microservice-components/yss-component-cache-parent/yss-component-caffeine-cache/pom.xml` — GAV `com.yss.cloud:yss-component-caffeine-cache:3.1.0-SNAPSHOT`; parent `com.yss.cloud:yss-component-cache-parent:3.1.0-SNAPSHOT`
+- `yss-microservice-components/yss-component-cache-parent/yss-component-hazelcast-cache/pom.xml` — GAV `com.yss.cloud:yss-component-hazelcast-cache:3.1.0-SNAPSHOT`; parent `com.yss.cloud:yss-component-cache-parent:3.1.0-SNAPSHOT`
+- `yss-microservice-components/yss-component-cache-parent/yss-component-jetcache/pom.xml` — GAV `com.yss.cloud:yss-component-jetcache:3.1.0-SNAPSHOT`; parent `com.yss.cloud:yss-component-cache-parent:3.1.0-SNAPSHOT`
+- `yss-microservice-components/yss-component-cache-parent/yss-component-redis-cache/pom.xml` — GAV `com.yss.cloud:yss-component-redis-cache:3.1.0-SNAPSHOT`; parent `com.yss.cloud:yss-component-cache-parent:3.1.0-SNAPSHOT`
+- `yss-microservice-components/yss-component-cache-parent/yss-component-spring-cache/pom.xml` — GAV `com.yss.cloud:yss-component-spring-cache:3.1.0-SNAPSHOT`; parent `com.yss.cloud:yss-component-cache-parent:3.1.0-SNAPSHOT`
+
+## Platform Signals
+
+- Inherited Java signals: `17`.
+- Inherited Spring Boot signals: `3.5.16`.
+- Namespace source signals: `javax.*` in 0 main Java files; `jakarta.*` in 3 main Java files.
+- Auto-configuration metadata: 5 `spring.factories`; 5 `AutoConfiguration.imports` files.
+- These are source observations, not compatibility certification. Use the approved `platform_configuration` and verified compatibility evidence before integration or generation.
+
+## Key Java Entry Points
+
+- `yss-microservice-components/yss-component-cache-parent/yss-component-cache-starter/src/main/java/com/yss/cloud/cache/CacheAutoConfiguration.java` — `sha256:b135b1c05fd827d3a71a6caa7df09d8a4b8be31adb1706a0e54bdbf334bb5dc0`
+- `yss-microservice-components/yss-component-cache-parent/yss-component-caffeine-cache/src/main/java/com/yss/cloud/cache/caffeine/config/CacheCaffeineManagerConfig.java` — `sha256:3a24a45d5958d2b854f7a1a58e33e90f71fac5ea1ded71545cdb6e6467c17165`
+- `yss-microservice-components/yss-component-cache-parent/yss-component-caffeine-cache/src/main/java/com/yss/cloud/cache/caffeine/config/CacheCaffeineResolver.java` — `sha256:a4c55043da2519763d2ff41f02eee49a3c48e9e300d57e349c57b4a7a3d5ff0d`
+- `yss-microservice-components/yss-component-cache-parent/yss-component-caffeine-cache/src/main/java/com/yss/cloud/cache/caffeine/config/CaffeineCacheBackendProvider.java` — `sha256:a1abe2aa93b43a296c281f8fe6c10d48623f2702897ecddfd0f598aead9c3c1e`
+- `yss-microservice-components/yss-component-cache-parent/yss-component-hazelcast-cache/src/main/java/com/yss/cloud/cache/hazelcast/config/CacheHazelcastManagerConfig.java` — `sha256:4636be7f75c4ac4e14e32fc84d79c1cbd52bfba7c3db46144b924a8f970ba73d`
+- `yss-microservice-components/yss-component-cache-parent/yss-component-hazelcast-cache/src/main/java/com/yss/cloud/cache/hazelcast/config/HazelcastCacheBackendProvider.java` — `sha256:8dff13225a69fb3f22a0640754ba0c9c314ce2f048c6145740400350f0d22514`
+- `yss-microservice-components/yss-component-cache-parent/yss-component-hazelcast-cache/src/main/java/com/yss/cloud/cache/hazelcast/config/YssCacheHazelcastProperties.java` — `sha256:52568d1eadaafd7a054b5fd765303b5c840b9a4660370ace933267da716424ac`
+- `yss-microservice-components/yss-component-cache-parent/yss-component-jetcache/src/main/java/com/yss/cloud/cache/jetcache/CacheManagerCompose.java` — `sha256:4c9fd8a98140246d6d896133abea70139e18656cde6ae64af1ee6ddf21bb3c33`
+- `yss-microservice-components/yss-component-cache-parent/yss-component-redis-cache/src/main/java/com/yss/cloud/cache/redis/config/RedisCacheBackendProvider.java` — `sha256:2c49245c4ecdbc16a2845a765a9a5fcb6e516ae982380cf819a8ae41a7f6c330`
+- `yss-microservice-components/yss-component-cache-parent/yss-component-redis-cache/src/main/java/com/yss/cloud/cache/redis/config/RedisConnFactoryConfig.java` — `sha256:e7d614ef4df624fdd64c7e7aaf4e4e6237f65a2e604ad02d7bbc61bc0044ee80`
+- `yss-microservice-components/yss-component-cache-parent/yss-component-redis-cache/src/main/java/com/yss/cloud/cache/redis/config/RedisLegacyPropertiesEnvironmentPostProcessor.java` — `sha256:db87505b069217633fa443890241063d9914e4f46b5dc2a0323f725a3b166120`
+- `yss-microservice-components/yss-component-cache-parent/yss-component-redis-cache/src/main/java/com/yss/cloud/cache/redis/config/RedisTemplateConfig.java` — `sha256:d6939ee2408beebfe8866e547155c13d372e061c50646961e1b40c77e017fecf`
+- `yss-microservice-components/yss-component-cache-parent/yss-component-redis-cache/src/main/java/com/yss/cloud/cache/redis/config/SafeRedisCache.java` — `sha256:cab1c61c2284ddcc2f88435f76882378175e8d3674113df2da715775d9e265b2`
+- `yss-microservice-components/yss-component-cache-parent/yss-component-redis-cache/src/main/java/com/yss/cloud/cache/redis/config/YssCacheRedisResolver.java` — `sha256:786af0511754e90f70315c106bd34ba24a50024cbc3e9feff46ff62ba65ff964`
+- `yss-microservice-components/yss-component-cache-parent/yss-component-redis-cache/src/main/java/com/yss/cloud/cache/repository/BaseRedisRepository.java` — `sha256:c79736715e3881a3c8fcb57f44b9024813954c8bc4d9185d9ddbe78f1d6eb749`
+- `yss-microservice-components/yss-component-cache-parent/yss-component-redis-cache/src/main/java/com/yss/cloud/cache/repository/YssDatamiddle.java` — `sha256:e6f29975ea8b282c8ff51318855a86161cc213210669a735ec68c53268493dc1`
+- `yss-microservice-components/yss-component-cache-parent/yss-component-spring-cache/src/main/java/com/yss/cloud/cache/ApplicationContextCacheHelper.java` — `sha256:6bc327316cac2b1aca82ef89d7ca7c02524a6b41a7ab6a28df6430db225d179f`
+- `yss-microservice-components/yss-component-cache-parent/yss-component-spring-cache/src/main/java/com/yss/cloud/cache/CacheComposeResolver.java` — `sha256:d70f6743f3cab0384cda7860e345206b341148e30b9c72bacf7bf7674ac2b923`
+- `yss-microservice-components/yss-component-cache-parent/yss-component-spring-cache/src/main/java/com/yss/cloud/cache/CacheManagerCompose.java` — `sha256:cd437707e645215a2951858e21dc584cec10ce93dc16fc518253bd7560cf96a6`
+- `yss-microservice-components/yss-component-cache-parent/yss-component-spring-cache/src/main/java/com/yss/cloud/cache/CacheMemResolver.java` — `sha256:206c53772d6d5ca59ff30c16967e2b7048614a887e65489667f07d0b4fc9cf93`
+- `yss-microservice-components/yss-component-cache-parent/yss-component-spring-cache/src/main/java/com/yss/cloud/cache/CacheRedisResolver.java` — `sha256:eae6535764caa0f8023051173a81f490408c436055f396f59a965fb4db5df8d4`
+- `yss-microservice-components/yss-component-cache-parent/yss-component-spring-cache/src/main/java/com/yss/cloud/cache/EnableYssCloudCache.java` — `sha256:5db0b797d3deb45f06fd68f9d17b66d7248c6c78dcb90d147c6f6c5b04afc214`
+- `yss-microservice-components/yss-component-cache-parent/yss-component-spring-cache/src/main/java/com/yss/cloud/cache/EnableYssCloudRedisCache.java` — `sha256:1310f6d89a470c0057e6cf25ff095af1024825f27fde376beefbcdde81cb902a`
+- `yss-microservice-components/yss-component-cache-parent/yss-component-spring-cache/src/main/java/com/yss/cloud/cache/YssCacheBackendProvider.java` — `sha256:a58c8b7634a8608766c9bdd5180bcb2949c4ee47af3497c573a006703fc38489`
+- `yss-microservice-components/yss-component-cache-parent/yss-component-spring-cache/src/main/java/com/yss/cloud/cache/YssCacheInterceptor.java` — `sha256:80449fa08d253b0defbdc3d859a797b84aaeaf9098d52cf93b2a45e40416411e`
+- `yss-microservice-components/yss-component-cache-parent/yss-component-spring-cache/src/main/java/com/yss/cloud/cache/YssCacheProperties.java` — `sha256:4b6d6850096fe4ac06567e7a2a2802802853d4aa824c22f17530efdcfb3191a4`
+- `yss-microservice-components/yss-component-cache-parent/yss-component-spring-cache/src/main/java/com/yss/cloud/cache/annotation/ClearCache.java` — `sha256:61dd140b8a2126e2619f19484908757409766a0647bd2fdd7c0d96a1600452cf`
+- `yss-microservice-components/yss-component-cache-parent/yss-component-spring-cache/src/main/java/com/yss/cloud/cache/annotation/QueryCache.java` — `sha256:7368d795819edc21ecf38a9c1604e5642cdb4d841251e85634d6a877e5b13529`
+- `yss-microservice-components/yss-component-cache-parent/yss-component-spring-cache/src/main/java/com/yss/cloud/cache/annotation/UpdateCache.java` — `sha256:2efe5f0d1134cba3bc0076770f3fb4b2cf78433bc2c53d21c256bb3dd7aa2a92`
+- `yss-microservice-components/yss-component-cache-parent/yss-component-spring-cache/src/main/java/com/yss/cloud/cache/annotation/YssCacheAnnotationParser.java` — `sha256:9838e82ae26fa8b52c74e95946c4f837379b010efb06f6ce75d5187b9bb546d2`
+- `yss-microservice-components/yss-component-cache-parent/yss-component-spring-cache/src/main/java/com/yss/cloud/cache/config/CacheOperationSourceConfiguration.java` — `sha256:59266cc7f9f78d35369983dae6dd15debe6f6335e4cf2f20446945412adb3d05`
+
+## Freshness and Use
+
+- Locate the current source root using `YSS_SOURCE_ROOT_BOOT3_JAVA17`, CodeGraph, Maven artifact names or repository search.
+- Compare each indexed `Component tree` with `git rev-parse HEAD:<component-path>` and require the current component subtree to be clean before exact guidance.
+- Run `node ../yss-skill-source-index-refresh/scripts/check-backend-skill-source-index.mjs --skill <skill-id> --platform-line boot3-java17 --source-root <root>` from the canonical skill root before exact integration guidance.
+- A repository commit difference alone is not stale when the component tree is unchanged; a component tree mismatch or component-local dirty state is stale.
+- Read only the source entries needed for the current decision or troubleshooting path.