pomaster 0.3.0 → 0.5.0

package/seeds/specs/hard/stacks/css/index.md

@@ -0,0 +1,20 @@
+---
+seed_source: pomaster/components/frontend-hard-spec/assets/stacks/css/index.md
+seed_source_sha256: eb09e17e34b577df39889213194207a3335f151d7c0f6655fa2f6aca63f0dc63
+seed_version: B6G
+lane: frontend
+status: CURRENT
+authority_scope: mixed_required_and_advisory
+applies_to: [frontend]
+related_evidence_specs: []
+related_tools: []
+---
+
+# CSS 体系 Overlay 索引
+
+本目录只描述项目 CSS 体系能力（SFC scoped 作用域、Ant Design Vue CSS-in-JS 主题 token 与官方全局重置的官方词形），不推断 Vue 版本与 UI 组件库选型，也不混用 React 版 Ant Design 形态。
+
+| ID | 文件 | 能力 |
+|---|---|---|
+| `frontend-stack:css` | `css-system-overlay.md` | `css-system` |
+

package/seeds/specs/hard/stacks/geist/geist-design-system-overlay.md

@@ -0,0 +1,48 @@
+---
+seed_source: pomaster/components/frontend-hard-spec/assets/stacks/geist/geist-design-system-overlay.md
+seed_source_sha256: a9edc3d23708ccef6aeade6669dd638117f341052c47e0145347a5b51e085680
+seed_version: B6F
+lane: frontend
+status: CURRENT
+authority_scope: mixed_required_and_advisory
+applies_to: [frontend]
+related_evidence_specs: []
+related_tools: []
+legacy_id: frontend-stack:geist
+capability: design-system
+requires: []
+conflicts: []
+coexistence: independent
+stages: [prepare, implement, check, release]
+x-research-anchors:
+  note: >-
+    Vercel Geist 设计体系参照（2026-09-02 实抓，external-design-references 批次——
+    external-sites-index 既有在册锚）：Foundations 现状为 colors / typography /
+    materials（无 spacing foundation——缺席诚实）；70 组件清单；Button variant+state
+    词表；Best Practices icon-only validator 抛错 = fail-closed 先例。设计体系站点
+    无 npm 包版本位，时效以 verified 时点为准，过期引用须重新核实。
+  sources:
+    - url: https://vercel.com/geist
+      fetched: 2026-09-02
+    - url: https://vercel.com/font
+      fetched: 2026-09-02
+---
+
+# Geist 设计体系 Overlay
+
+## Scope
+
+本 Overlay 具体化以 Vercel Geist 为设计体系参照的 foundations 词形、组件词表与使用规则引用边界。
+
+## Rules
+
+- Foundations 词形（colors / typography / materials）必须以实抓现状为准；Geist 现状无 spacing foundation——缺席诚实记录，禁杜撰 foundation 词形。
+- 组件清单与 variant / state 词表以 Geist 组件页为词形锚；项目侧组件命名与变体词形引用时必须与锚一致或在册声明差异。
+- 引用 Best Practices 要点（如 icon-only validator 抛错 = fail-closed 先例）必须带实抓时点；页面内容随后可能变动，过期引用须重新核实。
+- Geist 为设计体系参照而非实现依赖——不得由 geist 参照推断框架、UI 组件库或 CSS 方案选型；与 UI 组件库 overlay 并存时各守各轴。
+
+## Checklist
+
+- [ ] 引用的 foundations / 组件词表 / 使用规则带 verified 时点（2026-09-02）且未过期或已重新核实。
+- [ ] 参照边界在册：geist 参照不绑定实现依赖，token 消费与主题协议的衔接已显式声明。
+

package/seeds/specs/hard/stacks/geist/index.md

@@ -0,0 +1,20 @@
+---
+seed_source: pomaster/components/frontend-hard-spec/assets/stacks/geist/index.md
+seed_source_sha256: af0097581fdcac786ff234938bed8237be3185b72ed64d9c19e1a43f7b7a79df
+seed_version: B6F
+lane: frontend
+status: CURRENT
+authority_scope: mixed_required_and_advisory
+applies_to: [frontend]
+related_evidence_specs: []
+related_tools: []
+---
+
+# Geist Overlay 索引
+
+本目录只描述以 Vercel Geist 为参照的设计体系能力（foundations / 组件词表 / 使用规则），不隐式选择框架、UI 组件库实现或 CSS 方案。
+
+| ID | 文件 | 能力 |
+|---|---|---|
+| `frontend-stack:geist` | `geist-design-system-overlay.md` | `design-system` |
+

package/seeds/specs/hard/stacks/java/index.md

@@ -0,0 +1,20 @@
+---
+seed_source: pomaster/components/backend-hard-spec/assets/stacks/java/index.md
+seed_source_sha256: b7a9c253b74acaf5fbda84dc9650cb807838a74ad062393c08679701029d6cd4
+seed_version: B6C
+lane: backend
+status: CURRENT
+authority_scope: mixed_required_and_advisory
+applies_to: [backend]
+related_evidence_specs: []
+related_tools: []
+---
+
+# Java Overlay 索引
+
+本目录只描述 Java 语言与 JVM 构建边界，不隐式选择 Spring、数据库、缓存、入口代理或容器。
+
+| ID | 文件 | 能力 |
+|---|---|---|
+| `backend-stack:java` | `java-language-overlay.md` | `language-runtime` |
+

package/seeds/specs/hard/stacks/java/java-language-overlay.md

@@ -0,0 +1,35 @@
+---
+seed_source: pomaster/components/backend-hard-spec/assets/stacks/java/java-language-overlay.md
+seed_source_sha256: 38b592a5beaa899abb45e871e5097cafedeea80502baee00bcfbfcfa313dab85
+seed_version: B6C
+lane: backend
+status: CURRENT
+authority_scope: mixed_required_and_advisory
+applies_to: [backend]
+related_evidence_specs: []
+related_tools: []
+legacy_id: backend-stack:java
+capability: language-runtime
+requires: []
+conflicts: []
+coexistence: independent
+stages: [prepare, implement, check, release]
+---
+
+# Java 语言 Overlay
+
+## Scope
+
+本 Overlay 具体化 Java 源码、构建、JDK 与 JVM 兼容边界。
+
+## Rules
+
+- 必须固定并记录 JDK、编译目标、构建工具和依赖解析来源。
+- 不得由 Java 选择推断 Spring Boot、数据库、Redis、Nginx 或 Tomcat。
+- 语言升级必须验证字节码、运行时、测试与部署环境兼容性。
+
+## Checklist
+
+- [ ] 版本来源、构建命令和 CI 运行时可复现。
+- [ ] 项目技术基线记录实际 JDK 与打包方式。
+

package/seeds/specs/hard/stacks/jpa/index.md

@@ -0,0 +1,20 @@
+---
+seed_source: pomaster/components/backend-hard-spec/assets/stacks/jpa/index.md
+seed_source_sha256: 6a1bb930d58d7ee19a65f871829e7f347bbb83eee93412def4c3720a32f2d1f5
+seed_version: B6C
+lane: backend
+status: CURRENT
+authority_scope: mixed_required_and_advisory
+applies_to: [backend]
+related_evidence_specs: []
+related_tools: []
+---
+
+# JPA Overlay 索引
+
+本目录只描述 JPA 持久化能力，不绑定数据库产品。
+
+| ID | 文件 | 能力 |
+|---|---|---|
+| `backend-stack:jpa` | `jpa-persistence-overlay.md` | `persistence-framework` |
+

package/seeds/specs/hard/stacks/jpa/jpa-persistence-overlay.md

@@ -0,0 +1,35 @@
+---
+seed_source: pomaster/components/backend-hard-spec/assets/stacks/jpa/jpa-persistence-overlay.md
+seed_source_sha256: e43479fd8659b89863cf47dee9fee3c52727cc2978ffd1b854ea17c777b1e9e6
+seed_version: B6C
+lane: backend
+status: CURRENT
+authority_scope: mixed_required_and_advisory
+applies_to: [backend]
+related_evidence_specs: []
+related_tools: []
+legacy_id: backend-stack:jpa
+capability: persistence-framework
+requires: [backend-stack:java]
+conflicts: []
+coexistence: explicit-scope
+stages: [prepare, implement, check]
+---
+
+# JPA 持久化 Overlay
+
+## Scope
+
+本 Overlay 具体化实体生命周期、关联加载、查询与持久化上下文边界。
+
+## Rules
+
+- Entity 不得直接替代 API DTO 或领域契约。
+- 必须验证关联加载、N+1、脏检查、批处理和事务边界。
+- 与 MyBatis 并存时必须声明模块或数据源范围。
+
+## Checklist
+
+- [ ] Java 依赖已显式选择。
+- [ ] schema、迁移和实体映射不存在未经解释的漂移。
+

package/seeds/specs/hard/stacks/kubernetes-ingress/index.md

@@ -0,0 +1,20 @@
+---
+seed_source: pomaster/components/backend-hard-spec/assets/stacks/kubernetes-ingress/index.md
+seed_source_sha256: 847ab143549d2776913bdb403abe4283143e188fdc665ae4a045fd2699d8bb30
+seed_version: B6C
+lane: backend
+status: CURRENT
+authority_scope: mixed_required_and_advisory
+applies_to: [backend]
+related_evidence_specs: []
+related_tools: []
+---
+
+# Kubernetes Ingress Overlay 索引
+
+本目录只描述 Kubernetes Ingress 入口能力，不推断具体控制器实现。
+
+| ID | 文件 | 能力 |
+|---|---|---|
+| `backend-stack:kubernetes-ingress` | `kubernetes-ingress-overlay.md` | `cluster-ingress` |
+

package/seeds/specs/hard/stacks/kubernetes-ingress/kubernetes-ingress-overlay.md

@@ -0,0 +1,35 @@
+---
+seed_source: pomaster/components/backend-hard-spec/assets/stacks/kubernetes-ingress/kubernetes-ingress-overlay.md
+seed_source_sha256: 4369b51a677453c24b5ec4d4b97001c91932918fc779c55562012ebc6b312bf5
+seed_version: B6C
+lane: backend
+status: CURRENT
+authority_scope: mixed_required_and_advisory
+applies_to: [backend]
+related_evidence_specs: []
+related_tools: []
+legacy_id: backend-stack:kubernetes-ingress
+capability: cluster-ingress
+requires: []
+conflicts: []
+coexistence: explicit-entry-chain
+stages: [prepare, implement, check, release]
+---
+
+# Kubernetes Ingress Overlay
+
+## Scope
+
+本 Overlay 具体化集群入口、Service 路由、TLS、annotation 与健康检查边界。
+
+## Rules
+
+- 必须记录实际 Ingress Controller、入口类和可信代理链。
+- annotation 与超时不得依赖未审计的集群默认值。
+- 与 Nginx 并存时必须记录完整入口链路与各自责任。
+
+## Checklist
+
+- [ ] manifest、路由、证书和回滚路径可复核。
+- [ ] 控制器特有行为已在项目技术基线中声明。
+

package/seeds/specs/hard/stacks/messaging/index.md

@@ -0,0 +1,20 @@
+---
+seed_source: pomaster/components/backend-hard-spec/assets/stacks/messaging/index.md
+seed_source_sha256: ab5a2cf4ab18168ea59e1788e1c156d00a059ead9eb509e24266c684feb7b5ea
+seed_version: B6C
+lane: backend
+status: CURRENT
+authority_scope: mixed_required_and_advisory
+applies_to: [backend]
+related_evidence_specs: []
+related_tools: []
+---
+
+# Messaging Overlay 索引
+
+本目录描述与具体厂商无关的消息可靠性能力，不隐式选择任何 broker。
+
+| ID | 文件 | 能力 |
+|---|---|---|
+| `backend-stack:messaging` | `messaging-reliability-overlay.md` | `asynchronous-messaging` |
+

package/seeds/specs/hard/stacks/messaging/messaging-reliability-overlay.md

@@ -0,0 +1,35 @@
+---
+seed_source: pomaster/components/backend-hard-spec/assets/stacks/messaging/messaging-reliability-overlay.md
+seed_source_sha256: ed7f82208521675510ab4a42b229f9be269a52514cf5188c9bf83323d7590572
+seed_version: B6C
+lane: backend
+status: CURRENT
+authority_scope: mixed_required_and_advisory
+applies_to: [backend]
+related_evidence_specs: []
+related_tools: []
+legacy_id: backend-stack:messaging
+capability: asynchronous-messaging
+requires: []
+conflicts: []
+coexistence: explicit-channel
+stages: [prepare, implement, check, release]
+---
+
+# 消息可靠性 Overlay
+
+## Scope
+
+本 Overlay 具体化消息契约、投递、消费、重试、死信与可观测边界。
+
+## Rules
+
+- topic、事件 schema、版本、顺序和重复投递语义必须明确。
+- 消费者必须按契约处理幂等、毒消息、重试和死信。
+- 不得把 broker 可用性等同于业务处理成功。
+
+## Checklist
+
+- [ ] 生产、消费、补偿和对账证据可关联。
+- [ ] 敏感数据、保留期和权限符合安全与隐私协议。
+

package/seeds/specs/hard/stacks/mybatis/index.md

@@ -0,0 +1,20 @@
+---
+seed_source: pomaster/components/backend-hard-spec/assets/stacks/mybatis/index.md
+seed_source_sha256: 3248739d1cca70a4d95c62553cddcc308ebe8e85dac8bde0c98440b03d250410
+seed_version: B6C
+lane: backend
+status: CURRENT
+authority_scope: mixed_required_and_advisory
+applies_to: [backend]
+related_evidence_specs: []
+related_tools: []
+---
+
+# MyBatis Overlay 索引
+
+本目录只描述 MyBatis 持久化能力，不绑定数据库产品。
+
+| ID | 文件 | 能力 |
+|---|---|---|
+| `backend-stack:mybatis` | `mybatis-persistence-overlay.md` | `persistence-framework` |
+

package/seeds/specs/hard/stacks/mybatis/mybatis-persistence-overlay.md

@@ -0,0 +1,35 @@
+---
+seed_source: pomaster/components/backend-hard-spec/assets/stacks/mybatis/mybatis-persistence-overlay.md
+seed_source_sha256: 968bfa7df9b4c675161427809fd3d4e9e5b62b2b53a880420f36af00d2c60e57
+seed_version: B6C
+lane: backend
+status: CURRENT
+authority_scope: mixed_required_and_advisory
+applies_to: [backend]
+related_evidence_specs: []
+related_tools: []
+legacy_id: backend-stack:mybatis
+capability: persistence-framework
+requires: [backend-stack:java]
+conflicts: []
+coexistence: explicit-scope
+stages: [prepare, implement, check]
+---
+
+# MyBatis 持久化 Overlay
+
+## Scope
+
+本 Overlay 具体化 Mapper、SQL 映射、结果映射和动态 SQL 边界。
+
+## Rules
+
+- SQL 必须参数化并绑定可复核的 Mapper 与测试坐标。
+- 动态条件、分页、批处理和结果映射必须覆盖空值与类型边界。
+- 与 JPA 并存时必须声明模块或数据源范围。
+
+## Checklist
+
+- [ ] Java 依赖已显式选择。
+- [ ] SQL、索引、事务和迁移证据相互一致。
+

package/seeds/specs/hard/stacks/mysql/index.md

@@ -0,0 +1,20 @@
+---
+seed_source: pomaster/components/backend-hard-spec/assets/stacks/mysql/index.md
+seed_source_sha256: d3b40d3d12bfb2b6f2af4aa918dade0c8ee762b02e7a1290e1a0a6064400b355
+seed_version: B6C
+lane: backend
+status: CURRENT
+authority_scope: mixed_required_and_advisory
+applies_to: [backend]
+related_evidence_specs: []
+related_tools: []
+---
+
+# MySQL Overlay 索引
+
+本目录只描述 MySQL 数据库能力，不绑定持久化框架。
+
+| ID | 文件 | 能力 |
+|---|---|---|
+| `backend-stack:mysql` | `mysql-database-overlay.md` | `relational-database` |
+

package/seeds/specs/hard/stacks/mysql/mysql-database-overlay.md

@@ -0,0 +1,35 @@
+---
+seed_source: pomaster/components/backend-hard-spec/assets/stacks/mysql/mysql-database-overlay.md
+seed_source_sha256: a47d8c61959c120707bb907275e74ce13b4b36b03fa493bc09cc7d47fcc949d7
+seed_version: B6C
+lane: backend
+status: CURRENT
+authority_scope: mixed_required_and_advisory
+applies_to: [backend]
+related_evidence_specs: []
+related_tools: []
+legacy_id: backend-stack:mysql
+capability: relational-database
+requires: []
+conflicts: []
+coexistence: explicit-data-source
+stages: [prepare, implement, check, release]
+---
+
+# MySQL 数据库 Overlay
+
+## Scope
+
+本 Overlay 具体化 MySQL schema、InnoDB、索引、事务与迁移验证边界。
+
+## Rules
+
+- 字符集、排序规则、类型、约束和索引必须由 migration 明确表达。
+- 隔离级别、锁行为和执行计划必须以实际版本证据为准。
+- 与其他数据库并存时必须声明数据源与数据所有权。
+
+## Checklist
+
+- [ ] migration、rollback 或 roll-forward 路径可验证。
+- [ ] 生产兼容性不依赖本地默认值。
+

package/seeds/specs/hard/stacks/nginx/index.md

@@ -0,0 +1,20 @@
+---
+seed_source: pomaster/components/backend-hard-spec/assets/stacks/nginx/index.md
+seed_source_sha256: b5046069aec65ff56187cec0f237e996821ac46c85693164f7f2cb118ffa74b0
+seed_version: B6C
+lane: backend
+status: CURRENT
+authority_scope: mixed_required_and_advisory
+applies_to: [backend]
+related_evidence_specs: []
+related_tools: []
+---
+
+# Nginx Overlay 索引
+
+本目录只描述 Nginx 入口代理能力，不推断后端容器。
+
+| ID | 文件 | 能力 |
+|---|---|---|
+| `backend-stack:nginx` | `nginx-proxy-overlay.md` | `edge-proxy` |
+

package/seeds/specs/hard/stacks/nginx/nginx-proxy-overlay.md

@@ -0,0 +1,35 @@
+---
+seed_source: pomaster/components/backend-hard-spec/assets/stacks/nginx/nginx-proxy-overlay.md
+seed_source_sha256: 442da24b2bb5274003978636cf793bae02b25f24aa080fcc926c5347da39ce19
+seed_version: B6C
+lane: backend
+status: CURRENT
+authority_scope: mixed_required_and_advisory
+applies_to: [backend]
+related_evidence_specs: []
+related_tools: []
+legacy_id: backend-stack:nginx
+capability: edge-proxy
+requires: []
+conflicts: []
+coexistence: explicit-entry-chain
+stages: [prepare, implement, check, release]
+---
+
+# Nginx 入口代理 Overlay
+
+## Scope
+
+本 Overlay 具体化 TLS 终止、代理头、超时、上传限制和入口路由边界。
+
+## Rules
+
+- 必须声明可信代理链、原始客户端地址与协议头的处理方式。
+- 超时、body 限制和缓冲策略必须与应用行为一致。
+- 与 Kubernetes Ingress 并存时必须记录完整入口链路与各自责任。
+
+## Checklist
+
+- [ ] 配置语法、路由、TLS 与健康检查有可复核证据。
+- [ ] 默认页、管理面和敏感头未意外暴露。
+

package/seeds/specs/hard/stacks/postgresql/index.md

@@ -0,0 +1,20 @@
+---
+seed_source: pomaster/components/backend-hard-spec/assets/stacks/postgresql/index.md
+seed_source_sha256: 1321160386166639c011a3a9af649ee54668282343160305b0a451f4abcb677a
+seed_version: B6C
+lane: backend
+status: CURRENT
+authority_scope: mixed_required_and_advisory
+applies_to: [backend]
+related_evidence_specs: []
+related_tools: []
+---
+
+# PostgreSQL Overlay 索引
+
+本目录只描述 PostgreSQL 数据库能力，不绑定持久化框架。
+
+| ID | 文件 | 能力 |
+|---|---|---|
+| `backend-stack:postgresql` | `postgresql-database-overlay.md` | `relational-database` |
+

package/seeds/specs/hard/stacks/postgresql/postgresql-database-overlay.md

@@ -0,0 +1,35 @@
+---
+seed_source: pomaster/components/backend-hard-spec/assets/stacks/postgresql/postgresql-database-overlay.md
+seed_source_sha256: dbe9f21a72c1124519375176efb2b2b4138b21c45becebfc66eaa2ab41def16e
+seed_version: B6C
+lane: backend
+status: CURRENT
+authority_scope: mixed_required_and_advisory
+applies_to: [backend]
+related_evidence_specs: []
+related_tools: []
+legacy_id: backend-stack:postgresql
+capability: relational-database
+requires: []
+conflicts: []
+coexistence: explicit-data-source
+stages: [prepare, implement, check, release]
+---
+
+# PostgreSQL 数据库 Overlay
+
+## Scope
+
+本 Overlay 具体化 PostgreSQL schema、类型、索引、事务与迁移验证边界。
+
+## Rules
+
+- schema、extension、类型、约束和索引必须由受控 migration 表达。
+- 锁、隔离、执行计划和 vacuum 相关判断必须绑定实际版本证据。
+- 与其他数据库并存时必须声明数据源与数据所有权。
+
+## Checklist
+
+- [ ] migration 与兼容窗口可复核。
+- [ ] SQL 未依赖未声明的 search path 或环境默认值。
+

package/seeds/specs/hard/stacks/redis/index.md

@@ -0,0 +1,20 @@
+---
+seed_source: pomaster/components/backend-hard-spec/assets/stacks/redis/index.md
+seed_source_sha256: 707ec932880648c55219a73f46a8b219bb91ff76de45b924ad336a67035f3ffb
+seed_version: B6C
+lane: backend
+status: CURRENT
+authority_scope: mixed_required_and_advisory
+applies_to: [backend]
+related_evidence_specs: []
+related_tools: []
+---
+
+# Redis Overlay 索引
+
+本目录只描述 Redis 缓存或协调能力，不作为企业项目的隐式基线。
+
+| ID | 文件 | 能力 |
+|---|---|---|
+| `backend-stack:redis` | `redis-cache-overlay.md` | `cache-store` |
+

package/seeds/specs/hard/stacks/redis/redis-cache-overlay.md

@@ -0,0 +1,35 @@
+---
+seed_source: pomaster/components/backend-hard-spec/assets/stacks/redis/redis-cache-overlay.md
+seed_source_sha256: 6ae4d18ce2658a77d34bb3cf2a2c38745b646a730eb3c270c2a4c2a0a24497c7
+seed_version: B6C
+lane: backend
+status: CURRENT
+authority_scope: mixed_required_and_advisory
+applies_to: [backend]
+related_evidence_specs: []
+related_tools: []
+legacy_id: backend-stack:redis
+capability: cache-store
+requires: []
+conflicts: []
+coexistence: explicit-purpose
+stages: [prepare, implement, check, release]
+---
+
+# Redis 缓存 Overlay
+
+## Scope
+
+本 Overlay 具体化 Redis key、value schema、TTL、原子操作与故障降级边界。
+
+## Rules
+
+- key namespace、租户范围、序列化版本和 TTL 必须显式定义。
+- Redis 不得成为未声明的数据权威来源。
+- 分布式锁、缓存失效和降级必须有失败语义与测试证据。
+
+## Checklist
+
+- [ ] 一致性、容量、淘汰和恢复路径已记录。
+- [ ] 敏感数据与日志处理满足安全和隐私协议。
+

package/seeds/specs/hard/stacks/spring-batch/index.md

@@ -0,0 +1,20 @@
+---
+seed_source: pomaster/components/backend-hard-spec/assets/stacks/spring-batch/index.md
+seed_source_sha256: 946bfff0f9ec268cb33e9492053ceba842f7b0aa663eb8d847e601e7f39e00a0
+seed_version: B6C
+lane: backend
+status: CURRENT
+authority_scope: mixed_required_and_advisory
+applies_to: [backend]
+related_evidence_specs: []
+related_tools: []
+---
+
+# Spring Batch Overlay 索引
+
+本目录只描述 Spring Batch 作业能力，不作为 Spring Boot 的隐式能力。
+
+| ID | 文件 | 能力 |
+|---|---|---|
+| `backend-stack:spring-batch` | `spring-batch-job-overlay.md` | `batch-processing` |
+

package/seeds/specs/hard/stacks/spring-batch/spring-batch-job-overlay.md

@@ -0,0 +1,35 @@
+---
+seed_source: pomaster/components/backend-hard-spec/assets/stacks/spring-batch/spring-batch-job-overlay.md
+seed_source_sha256: 58f710fcfeeaeafcaa19fd4ef27bce22c3c34d8d1ef7992f95f65a3e1bd9cd78
+seed_version: B6C
+lane: backend
+status: CURRENT
+authority_scope: mixed_required_and_advisory
+applies_to: [backend]
+related_evidence_specs: []
+related_tools: []
+legacy_id: backend-stack:spring-batch
+capability: batch-processing
+requires: [backend-stack:java, backend-stack:spring-boot]
+conflicts: []
+coexistence: explicit-job
+stages: [prepare, implement, check, release]
+---
+
+# Spring Batch 作业 Overlay
+
+## Scope
+
+本 Overlay 具体化 Job、Step、重启、分片、元数据和批处理事务边界。
+
+## Rules
+
+- 作业参数、实例身份、重启语义和幂等边界必须稳定。
+- 分片、重试、跳过和失败恢复必须有数据一致性证据。
+- 调度系统与 Spring Batch 的职责必须分开记录。
+
+## Checklist
+
+- [ ] Java 与 Spring Boot 依赖已显式选择。
+- [ ] 重跑、取消、并发和结果保留策略已验证。
+