create-yss-spec 2.1.10 → 2.1.13

package/template/.qoder/skills/yss-design-system/references/design-system.md

@@ -39,22 +39,22 @@
 
 | Token | 值 | 用途 |
 | --- | --- | --- |
-| `colorPrimary` | `#1677ff` | 主操作、链接、焦点、选中态 |
+| `colorPrimary` | `#3371ff` | 主操作、链接、焦点、选中态 |
 | `colorPrimaryHover` | `#4096ff` | 主色 hover |
 | `colorPrimaryActive` | `#0958d9` | 主色 active |
 | `colorSuccess` | `#52c41a` | 成功状态 |
 | `colorWarning` | `#faad14` | 警告状态 |
-| `colorError` | `#ff4d4f` | 错误状态 |
-| `colorInfo` | `#1677ff` | 信息提示 |
-| `colorBgLayout` | `#f5f5f5` | 页面背景 |
+| `colorError` | `#f5222d` | 错误状态 |
+| `colorInfo` | `#3371ff` | 信息提示 |
+| `colorBgLayout` | `#f0f2f5` | 页面背景 |
 | `colorBgContainer` | `#ffffff` | 内容容器 |
 | `colorBgElevated` | `#ffffff` | 浮层容器 |
-| `colorText` | `#2e2e2e` | 主文本 |
-| `colorTextSecondary` | `#646464` | 次级文本 |
-| `colorTextTertiary` | `#949494` | 弱说明 |
-| `colorTextQuaternary` | `#c4c4c4` | placeholder / disabled |
-| `colorBorder` | `#dbdbdb` | 主边框 |
-| `colorBorderSecondary` | `#f1f1f1` | 次级分割线 |
+| `colorText` | `rgba(0, 0, 0, 0.88)` | 主文本 |
+| `colorTextSecondary` | `rgba(0, 0, 0, 0.65)` | 次级文本 |
+| `colorTextTertiary` | `#8c8c8c` | 弱说明 |
+| `colorTextQuaternary` | `#bfbfbf` | placeholder / disabled |
+| `colorBorder` | `#d9d9d9` | 主边框 |
+| `colorBorderSecondary` | `#f0f0f0` | 次级分割线 |
 
 颜色规则：
 
@@ -63,7 +63,10 @@
 - 预设色板只用于 Tag、图表、分类可视化，不用于重新定义主操作。
 - 不硬编码白色、灰色、状态色；优先引用 token、CSS variables 或 Ant Design theme。
 - semantic token 优先于色值：页面先声明背景、容器、浮层、文本、边框、状态等角色，再映射到具体 token。
+- 运行时短名 `--primary-color`、`--text-color`、`--bg-color` 必须指向 `--brand-*`，不要再维护第二套色值。
+- `blue` 等预设色板可以仍含官方 `#1677ff`；色板预设 ≠ 品牌主色。
 - accessibility contrast 不足时，通过 `ConfigProvider` 的 seed token 或组件 token 调整；不要为单个页面制造不可复用的深浅色例外。
+- Codex `$design-qa` 的 token / 字体对照读 `references/design-qa-theme.md`。
 
 ### 排版
 
@@ -81,6 +84,7 @@
 
 - UI 默认正文 14px。
 - UI 字重优先 400 / 600。
+- 字体栈使用系统字体，不强制 `Inter`。
 - 不用 700+ 粗体表达选中或激活状态。
 - 选中状态优先使用颜色、边框、下划线、背景表达。
 
@@ -93,8 +97,12 @@
 | 小控件高度 | 24px |
 | 大控件高度 | 40px |
 | 默认字号 | 14px |
-| 当前品牌默认圆角 | 8px |
-| 大容器 / 浮层圆角 | 10px |
+| 字体栈 | 系统栈，不强制 `Inter` |
+| 小控件圆角 | 4px |
+| 默认控件圆角 | 6px |
+| 大容器 / 浮层圆角 | 8px |
+| 顶栏高度 | 64px |
+| 深色侧栏 | `#001529` |
 
 执行规则：
 

package/template/.qoder/skills/yss-domain/SKILL.md

@@ -51,10 +51,15 @@ description: 用于构建或重构 YSS 领域层代码。当用户要求设计
 
 ## 协同顺序
 
+- 需要用例编排时，再接 `yss-application`
 - 需要持久层时，再接 `yss-repository`
 - 需要 Web 层时，再接 `yss-web-controller`
 - 需要完整工程时，先 `yss-ddd-scaffold-generator`
 
+## 分层开发规范
+
+脚手架生成或进入 Domain 实现前，必须加载 `references/domain-layer-guide.md`：其中定义 DTO/Gateway/Domain Service 包结构、命名、校验与示例，与本 skill 的建模约束一并生效。
+
 ## 阶段 7 合同
 
 - 只消费生命周期已批准的 `Slice Implementation Contract` 和当前 `work_unit`；不得扩大 `allowed_write_paths`。

package/template/.qoder/skills/yss-domain/references/domain-layer-guide.md

@@ -0,0 +1,274 @@
+本 Skill 提供了 YSS 数据质量管理服务 **Domain (领域层)** 的开发规范。Domain 层是系统的核心，包含业务逻辑、领域模型和接口定义。
+
+## 1. 核心职责 (Core Responsibilities)
+
+- **定义业务模型 (Model)**: 包含实体 (Entity)、值对象 (VO)、聚合根 (Aggregate Root)。
+- **定义服务接口 (Gateway/Service)**: 定义与 Infrastructure 层交互的接口 (Gateway) 以及领域内部服务 (Domain Service)。
+- **定义数据契约 (DTO)**: 定义 Command (增删改), Query (查询), VO (视图) 等数据传输对象。
+- **业务逻辑实现**: 核心业务规则的校验和处理。
+
+## 2. 代码结构 (Code Structure)
+
+```
+com.yss.{module}
+├── client                  # 对外暴露的数据契约 (DTOs)
+│   ├── dto
+│   │   ├── cmd             # Command: 写操作参数 (e.g., QualityRuleAddCmd)
+│   │   └── query           # Query: 读操作参数 (e.g., QualityRulePage)
+│   └── vo                  # Value Object: 返回结果 (e.g., QualityBusinessRuleVO)
+└── domain                  # 领域核心实现
+    └── {domain_name}       # 具体的领域模块 (e.g., user, metadata)
+        ├── gateway         # 网关接口定义 (e.g., UserGateway)
+        ├── model           # 领域实体/枚举 (e.g., User, UserType)
+        └── service         # 领域服务 (e.g., UserService)
+```
+
+## 3. 开发规范 (Development Guidelines)
+
+### 3.1 数据传输对象 (DTO)
+
+- **Command (Cmd)**: 用于数据修改 (Create/Update/Delete)。
+  - 继承 `com.yss.cloud.dto.CommandDTO`。
+  - 按 `lombok` skill 选择 `@Getter` / `@Setter` / 构造器等最小注解；不默认使用 `@Data`。
+  - 必须使用 JSR-303/380 注解进行参数校验 (`@NotBlank`, `@NotNull`, `@Size` 等)。
+  - **示例**: `QualityRuleAddCmd`
+
+- **Query**: 用于数据查询。
+  - 分页查询继承 `com.yss.cloud.dto.page.PageQuery`。
+  - 普通查询继承 `com.yss.cloud.dto.QueryDTO`。
+  - **示例**: `QualityRulePage`
+
+- **View Object (VO)**: 用于展示层返回数据。
+  - 纯 POJO 仍按 `lombok` skill 选择最小注解；涉及身份、关系、敏感字段或懒加载时不得默认使用 `@Data`。
+  - **示例**: `QualityBusinessRuleVO`
+
+### 3.2 网关接口 (Gateway)
+
+Gateway 定义了领域层对外的依赖接口，通常由 Infrastructure 层实现。
+
+- **命名**: `DomainName` + `Gateway` (e.g., `QualityTemplateGateway`)。
+- **方法定义规范**:
+  - **分页查询**: `PageResult<VO> pageXxx(Query query)`
+  - **列表查询**: `List<VO> listXxx(Query query)`
+  - **单条查询**: `VO getXxxById(Long id)` 或 `VO getXxxByCode(String code)`
+  - **新增**: `Long/ResultVO addXxx(Cmd cmd)` (返回 ID 或 结果对象)
+  - **更新**: `void/ResultVO updateXxx(Cmd cmd)`
+  - **删除**: `void deleteXxx(Cmd cmd)`
+
+### 3.3 领域服务 (Domain Service)
+
+当业务逻辑涉及多个聚合根或不适合放入单一实体时，使用 Domain Service。
+
+- **命名**: `DomainName` + `Service` (e.g., `QualityTemplateService`)。
+- **职责**: 编排领域逻辑，调用 Gateway。
+
+### 3.4 常用类与注解
+
+- **分页结果**: `com.yss.cloud.dto.result.PageResult<T>`
+- **校验注解**: `javax.validation.constraints.*` (`@NotNull`, `@NotBlank`)
+- **Lombok**: 按对象语义选择 `@Getter`, `@Setter`, `@Builder`, `@NoArgsConstructor`, `@AllArgsConstructor`，不默认使用聚合式 `@Data`。
+
+## 4. 详细案例 (Detailed Examples)
+
+### 4.1 Command (新增命令)
+
+```java
+package com.yss.quality.client.dto.cmd;
+
+import com.yss.cloud.dto.CommandDTO;
+import com.yss.quality.domain.QualityRuleTemplateType;
+import com.yss.quality.domain.QualityType;
+import com.yss.quality.domain.datasource.entity.DatabaseType;
+import com.yss.quality.domain.rule.entity.QualityRuleType;
+import lombok.Getter;
+import lombok.Setter;
+
+import javax.validation.constraints.NotBlank;
+import javax.validation.constraints.NotEmpty;
+import javax.validation.constraints.NotNull;
+import java.util.List;
+import java.util.Map;
+
+/**
+ * 数据质量规则模板新增命令对象
+ */
+@Getter
+@Setter
+public class QualityTemplateAddCmd extends CommandDTO {
+
+    @NotBlank(message = "模板名称不能为空")
+    private String templateName;
+
+    @NotBlank(message = "模板编码不能为空")
+    private String templateCode;
+
+    @NotEmpty(message = "数据库类型不能为空")
+    private List<DatabaseType> databaseType;
+
+    @NotNull(message = "模板类型不能为空")
+    private QualityRuleTemplateType templateType;
+
+    @NotNull(message = "模板规则类型不能为空")
+    private QualityType ruleType;
+
+    private String description;
+
+    @NotBlank(message = "异常SQL不能为空")
+    private String exceptionCountSql;
+
+    @NotNull
+    private String resultLabel;
+
+    private Boolean defaultFlag;
+
+    Map<String, Object> ruleTemplateParam;
+}
+```
+
+### 4.2 Query (分页查询)
+
+```java
+package com.yss.quality.client.dto.query;
+
+import com.yss.cloud.dto.page.PageQuery;
+import com.yss.quality.domain.QualityRuleTemplateType;
+import com.yss.quality.domain.QualityType;
+import lombok.Getter;
+import lombok.Setter;
+
+import javax.validation.constraints.NotNull;
+
+/**
+ * 数据质量规则模板查询对象
+ */
+@Getter
+@Setter
+public class QualityTemplatePage extends PageQuery {
+    /**
+     * 模板类型
+     */
+    private QualityRuleTemplateType templateType;
+
+    /**
+     * 规则类型
+     */
+    @NotNull
+    private QualityType ruleType;
+
+    /**
+     * 模板名称
+     */
+    private String templateName;
+
+    private Integer status;
+}
+```
+
+### 4.3 Gateway (网关接口)
+
+```java
+package com.yss.quality.domain.template.gateway;
+
+import com.yss.cloud.dto.result.PageResult;
+import com.yss.quality.client.dto.cmd.QualityTemplateAddCmd;
+import com.yss.quality.client.dto.cmd.QualityTemplateDeleteCmd;
+import com.yss.quality.client.dto.cmd.QualityTemplateUpdateCmd;
+import com.yss.quality.client.dto.query.QualityTemplatePage;
+import com.yss.quality.client.vo.QualityTemplateVO;
+
+/**
+ * 数据质量规则模板网关接口
+ */
+public interface QualityTemplateGateway {
+
+    /**
+     * 分页查询数据质量规则模板
+     */
+    PageResult<QualityTemplateVO> pageQualityTemplate(QualityTemplatePage query);
+
+    /**
+     * 根据ID查询数据质量规则模板
+     */
+    QualityTemplateVO getQualityTemplateById(Long id);
+
+    /**
+     * 新增数据质量规则模板
+     */
+    Long addQualityTemplate(QualityTemplateAddCmd cmd);
+
+    /**
+     * 更新数据质量规则模板
+     */
+    void updateQualityTemplate(QualityTemplateUpdateCmd cmd);
+
+    /**
+     * 删除数据质量规则模板
+     */
+    void deleteQualityTemplate(QualityTemplateDeleteCmd cmd);
+}
+```
+
+### 4.4 Domain Service (领域服务)
+
+```java
+package com.yss.quality.domain.template.service;
+
+import com.yss.cloud.dto.result.PageResult;
+import com.yss.quality.client.dto.cmd.QualityTemplateAddCmd;
+import com.yss.quality.client.dto.query.QualityTemplatePage;
+import com.yss.quality.client.vo.QualityTemplateVO;
+
+/**
+ * 数据质量规则模板服务接口
+ */
+public interface QualityTemplateService {
+
+    PageResult<QualityTemplateVO> pageQualityTemplate(QualityTemplatePage query);
+
+    QualityTemplateVO getQualityTemplateById(Long id);
+
+    Long addQualityTemplate(QualityTemplateAddCmd cmd);
+
+    // 更多业务方法...
+}
+```
+
+### 4.5 Value Object (视图对象)
+
+```java
+package com.yss.quality.client.vo;
+
+import lombok.Getter;
+import lombok.Setter;
+import java.io.Serializable;
+import java.util.Map;
+
+/**
+ * 数据质量规则模板值对象
+ */
+@Getter
+@Setter
+public class QualityTemplateVO implements Serializable {
+    private Long id;
+    private String templateName;
+    private String templateCode;
+    private String resultLabel;
+    private String databaseType;
+    private String qualityRuleType;
+    private String qualityType;
+    private Map<String,Object> ruleTemplateParam;
+    private Boolean defaultFlag;
+}
+```
+
+## 5. 注意事项 (Notes)
+
+1.  **依赖倒置**: Domain 层**不应依赖** Infrastructure 层或 Web 层。所有外部交互通过 Gateway 接口定义。
+2.  **贫血模型 vs 充血模型**: 虽然目前主要是贫血模型 (DTO/VO)，但鼓励将核心业务逻辑下沉到 Domain Model 中。
+3.  **参数校验**: 必须在 Cmd 对象中使用注解进行严格的参数校验，Gateway 实现层应进行 `@Valid` 校验。
+
+## 6. 阶段 7 合同
+
+- 领域规则、状态机和不变量必须使用 `behavior-tdd`；只允许 DTO/VO/接口等机械骨架使用受控生成。
+- 消费批准后的合同和 work unit，写入允许路径，并返回统一 `YSS Skill Execution Result`。
+- 发现新的状态机、权限、数据模型、API 或跨上下文影响时返回 `new_impacts` 并暂停。

package/template/.qoder/skills/yss-microapp-commit/SKILL.md

@@ -5,6 +5,8 @@ description: Use when committing or analyzing changes in a YSS micro-frontend ap
 
 # 微应用提交规范 Skill
 
+目录与锁文件身份是 `yss-microapp-commit`；Agent 发现名是 `microapp-commit`。二者指向同一技能，注册表以 alias 对齐。
+
 ## 📋 目标
 
 帮助 AI 为微应用项目生成符合 **Conventional Commits** 规范的 Git 提交信息，支持智能分析变更内容并处理复杂提交场景。

package/template/.qoder/skills/yss-product-lifecycle/SKILL.md

@@ -29,7 +29,7 @@ Matt 的 `grill-with-docs`、`to-spec`、`to-tickets`、`implement` 等保留为
 | 入口分诊 | 身份、影响面、最近可信阶段 | `yss-product-lifecycle` | `yss-project.yaml` 合法且影响面可解释 |
 | 机会调研/需求分析 | Discovery、用户/MVP/非目标/成功标准、测试 seam | `work-unit.discovery-opportunity` + `work-unit.discovery-requirements`；市场/竞品事实用 `competitive-intelligence`，技术/标准事实用 `research`；`grill-with-docs` 为兼容入口 | 未决事实已 research 或 handoff，用户确认，无 runnable blocker |
 | Spec/功能架构 | Spec、产品总体设计、功能架构；必要时 Spec Delta | 原生 `work-unit.spec-synthesis`；`to-spec` 为兼容入口 | 初稿先为 `ready-for-human`；只有 Spec baseline 人工批准后资产才为 `approved` 并进入下游 |
-| 原型设计 | 交互说明、低保真、状态矩阵、高保真 HTML、评审记录 | `yss-design-system` → `yss-prototype-stage` → Codex `product-design:index`（非 Codex 交付等价合同） | `gate.prototype-reviewed`、`gate.prototype-verified`、`gate.user-confirmation` 均有证据 |
+| 原型设计 | 交互说明、低保真、状态矩阵、高保真 HTML、评审记录 | `yss-design-system` → `yss-prototype-stage` → `yss-antd-design`（仅原型事实）→ Codex `product-design:index`（非 Codex 交付等价合同）。前端落地改用 `yss-ui` | `gate.prototype-reviewed`、`gate.prototype-verified`、`gate.user-confirmation` 均有证据 |
 | 技术分析 | OpenAPI Draft/Freeze、数据架构、工程基线、架构审查 | `yss-openapi-governance` / `yss-openapi-draft-review`、`codebase-design`、`implementation-repo-onboarding`、`yss-router` | API/架构契约冻结；无 API 影响有明确记录；脚手架策略满足 |
 | Ticket 正式化 | 功能父 Ticket、垂直切片、Slice Implementation Contract | 原生 `work-unit.ticket-decomposition`；`to-tickets` 为兼容入口；生命周期复算 | 依赖、验收、测试 seam 可执行；合同已批准、持久化且为当前版本 |
 | 技术实现 | 前端/后端代码、TDD 证据、YSS Skill Execution Result | 原生 `work-unit.slice-implementation`；`implement` 为兼容入口；前端按 `yss-ui` + `yss-page-module-development`，后端按 `yss-router` 最小闭包，业务行为统一 `tdd` | 只写允许路径；业务行为用 `behavior-tdd`；UI 影响必须有还原计划 |

package/template/.qoder/skills/yss-product-lifecycle/references/orchestration-contract.yaml

@@ -111,7 +111,7 @@ skill_source_contract:
   lock_version: 3
   source_revisions_required: [mattpocock/skills]
   adaptation_ref_required_when_effective_diff: true
-  retired_shared_skills: [batch-grill-me]
+  retired_shared_skills: [batch-grill-me, product-design-prototype, yss-dictionary, yss-jdbc, yss-log, yss-taskflow, yss-backend-scaffold-application, yss-backend-scaffold-domain, yss-backend-scaffold-infrastructure, yss-backend-scaffold-web]
 
 # 生命周期默认走原生工作单元；Matt user-invoked skill 仅保留为兼容入口。
 lifecycle_native_entries:
@@ -138,7 +138,7 @@ work_unit_routes:
     human_gate: spec-baseline
   work-unit.prototype-design:
     native: {source: yss-product-lifecycle, skill: yss-product-lifecycle, invocation_mode: model-invoked}
-    skills: [yss-design-system, yss-prototype-stage, product-design:index]
+    skills: [yss-design-system, yss-prototype-stage, yss-antd-design, product-design:index]
     human_gate: prototype-confirmation
   work-unit.technical-analysis:
     native: {source: yss-product-lifecycle, skill: yss-product-lifecycle, invocation_mode: model-invoked}

package/template/.qoder/skills/yss-prototype-stage/SKILL.md

@@ -11,7 +11,7 @@ description: Use when a YSS feature has product-design impact on a primary flow,
 
 - 先由 `yss-product-lifecycle` 判断产品设计影响；无行为变化的孤立视觉修复记录 `not-applicable`，不创建空资产。
 - Codex 的产出主入口是 `product-design:index`；其他 Agent 使用等价的产品设计能力，但必须产出本技能规定的相同资产和证据。能力或证据不能等价时，暂停并回到人工确认。
-- `product-design-prototype`、`high-fidelity-html-prototype` 仅为兼容入口；从它们进入时立即回到本合同。已退休的原型技能不得继续路由。
+- `high-fidelity-html-prototype` 仅为历史兼容入口；从它进入时立即回到本合同。已退休的原型技能（含 `product-design-prototype`）不得继续路由。
 
 ## 资产与门禁顺序
 
@@ -25,7 +25,9 @@ description: Use when a YSS feature has product-design impact on a primary flow,
 
 优先级固定为：官方 `design.md` 的上游默认 → `docs/design/design.md` 与项目 token 的 `project_design` 项目覆盖 → 当前功能的语义组件映射。不得用上游默认覆盖项目 token。
 
-使用官方 `antd` skill / CLI 查询事实，始终用 `--format json`，并记录实际 `antd`、CLI 和目标组件版本。至少保存 `antd design.md`、已选组件的 `info`/`demo`/`token`/`semantic` 查询和 `antd lint` 结果；目标版本存在时，将同一 `<target_antd_version>` 传给版本敏感查询，禁止在模板中固化某个 CLI 或组件版本。
+Codex `$design-qa` 仍走官方对比流程；Colors/tokens 与 Fonts/typography 必须以项目覆盖为 source visual truth。对照清单见 `yss-design-system/references/design-qa-theme.md`。仍用官方 `#1677ff`、强制 `Inter` 或历史 8px 品牌圆角当默认主题，视为项目覆盖漂移。
+
+Ant Design v6 事实由 `yss-antd-design` 查询并回写证据，不要并列调用官方 `antd` skill，也不要在前端代码落地时继续使用它。进入实现后改走 `yss-ui`。
 
 ## 验证与回流
 

package/template/.qoder/skills/yss-repository/SKILL.md

@@ -59,10 +59,15 @@ description: Use when generating or refactoring YSS persistence models, BaseRepo
 
 - metadata / DDL 输入准备：确认输入完整
 - 领域建模：`yss-domain`
+- 用例编排：`yss-application`
 - POJO 样板代码：`lombok`
 - 对象转换：`mapstruct`
 - Web 补齐：`yss-web-controller`
 
+## 分层开发规范
+
+实现 PO / Repository / GatewayImpl 前，必须加载 `references/infrastructure-layer-guide.md`：其中定义持久化对象、Repository、Convertor 与 Gateway 实现的结构与示例。
+
 ## 阶段 7 合同
 
 - 前置条件：数据架构、领域元数据、实现仓库和批准后的 `Slice Implementation Contract` 均可用；否则不执行本 skill，由 Router 返回 `blocked`。

package/template/.qoder/skills/yss-repository/references/infrastructure-layer-guide.md

@@ -0,0 +1,192 @@
+本 Skill 提供了 YSS **Infrastructure (基础设施层)** 的通用开发规范。Infrastructure 层负责实现 Domain 层定义的网关接口，处理数据持久化、外部服务调用和配置管理。
+
+## 1. 核心职责 (Core Responsibilities)
+
+- **实现网关接口 (Gateway Implementation)**: 实现 Domain 层定义的 `Gateway` 接口。
+- **数据持久化 (Persistence)**: 定义 `Repository` 接口和 `PO` (Persistent Object) 实体，操作数据库。
+- **对象转换 (Conversion)**: 使用 MapStruct 实现 PO 与 Domain Model/DTO 之间的转换。
+- **外部适配 (External Adapters)**: 集成外部服务 (如文件存储、消息队列)。
+
+## 2. 代码结构 (Code Structure)
+
+```
+com.yss.{module}.repository
+├── entity                  # 持久化对象 (PO)
+├── gateway.impl            # Domain Gateway 接口实现
+├── convertor               # MapStruct 转换器
+├── util                    # 工具类
+└── {Domain}Repository.java # MyBatis Plus Repository 接口
+```
+
+## 3. 开发规范 (Development Guidelines)
+
+### 3.1 持久化对象 (PO)
+
+- **命名**: `DomainName` + `PO` (e.g., `QualityTemplatePO`)。
+- **继承**: 推荐继承 `AuditableEntity` 以自动处理审计字段 (`created_by`, `created_date` 等)，但非强制要求。
+- **注解**:
+  - `@TableName("t_table_name")`: 指定数据库表名。
+  - `@TableId(value = "id", type = IdType.ASSIGN_ID)`: 指定主键策略 (雪花算法)。
+  - `@TableField("column_name")`: 指定字段映射。
+  - 按 `lombok` skill 选择最小注解；PO 默认使用 `@Getter` / `@Setter`，不得无条件使用 `@Data`。继承基类时再审查 `equals/hashCode/toString` 风险。
+
+### 3.2 Repository 接口
+
+- **继承**: `com.yss.cloud.mybatis.support.BasePlusRepository<PO>`。
+- **位置**: 直接位于 `com.yss.{module}.repository` 包下。
+- **Mapper XML**: 对应的 XML 文件位于 `src/main/resources/mappers`。
+
+### 3.3 Gateway 实现
+
+- **位置**: `com.yss.{module}.repository.gateway.impl`。
+- **注解**: `@Repository` 或 `@Service`。
+- **依赖注入**: 使用 `@RequiredArgsConstructor` (Lombok) 或 `@Autowired` 注入 Repository。
+- **查询逻辑**: 使用 `Wrappers.lambdaQuery()` 构建类型安全的查询条件。
+- **分页处理**: 使用 `PageUtil.page(query)` 构建分页对象，返回 `PageResult.of(...)`。
+
+### 3.4 对象转换 (Convertor)
+
+- **工具**: MapStruct。
+- **位置**: `com.yss.{module}.repository.convertor`。
+- **命名**: `DomainName` + `Convertor` (e.g., `QualityTemplateConvertor`)。
+- **规范**: 定义 `INSTANCE` 常量，使用 `Mappers.getMapper(...)` 获取实例。
+
+## 4. 详细案例 (Detailed Examples)
+
+### 4.1 Persistent Object (PO)
+
+```java
+package com.yss.quality.repository.entity;
+
+import com.baomidou.mybatisplus.annotation.IdType;
+import com.baomidou.mybatisplus.annotation.TableField;
+import com.baomidou.mybatisplus.annotation.TableId;
+import com.baomidou.mybatisplus.annotation.TableName;
+import lombok.Getter;
+import lombok.Setter;
+import lombok.EqualsAndHashCode;
+
+@Getter
+@Setter
+@EqualsAndHashCode(callSuper = true)
+@TableName("t_quality_template")
+public class QualityTemplatePO extends AuditableEntity {
+
+    @TableId(value = "id", type = IdType.ASSIGN_ID)
+    private Long id;
+
+    @TableField("template_name")
+    private String templateName;
+
+    @TableField("template_code")
+    private String templateCode;
+
+    @TableField("status")
+    private Integer status;
+}
+```
+
+### 4.2 Repository Interface
+
+```java
+package com.yss.quality.repository;
+
+import com.yss.cloud.mybatis.support.BasePlusRepository;
+import com.yss.quality.repository.entity.QualityTemplatePO;
+
+public interface QualityTemplateRepository extends BasePlusRepository<QualityTemplatePO> {
+}
+```
+
+### 4.3 Gateway Implementation
+
+```java
+package com.yss.quality.repository.gateway.impl;
+
+import com.baomidou.mybatisplus.core.conditions.query.LambdaQueryWrapper;
+import com.baomidou.mybatisplus.core.metadata.IPage;
+import com.baomidou.mybatisplus.core.toolkit.Wrappers;
+import com.yss.cloud.dto.result.PageResult;
+import com.yss.quality.client.dto.query.QualityTemplatePage;
+import com.yss.quality.client.vo.QualityTemplateVO;
+import com.yss.quality.domain.template.gateway.QualityTemplateGateway;
+import com.yss.quality.repository.QualityTemplateRepository;
+import com.yss.quality.repository.convertor.QualityTemplateConvertor;
+import com.yss.quality.repository.entity.QualityTemplatePO;
+import com.yss.quality.repository.util.PageUtil;
+import lombok.RequiredArgsConstructor;
+import org.springframework.stereotype.Repository;
+import org.springframework.util.StringUtils;
+
+import java.util.List;
+
+@Repository
+@RequiredArgsConstructor
+public class QualityTemplateGatewayImpl implements QualityTemplateGateway {
+
+    private final QualityTemplateRepository qualityTemplateRepository;
+
+    @Override
+    public PageResult<QualityTemplateVO> pageQualityTemplate(QualityTemplatePage query) {
+        LambdaQueryWrapper<QualityTemplatePO> wrapper = Wrappers.lambdaQuery(QualityTemplatePO.class);
+
+        // 构建查询条件
+        if (StringUtils.hasText(query.getTemplateName())) {
+            wrapper.like(QualityTemplatePO::getTemplateName, query.getTemplateName());
+        }
+        if (query.getStatus() != null) {
+            wrapper.eq(QualityTemplatePO::getStatus, query.getStatus());
+        }
+
+        wrapper.orderByDesc(QualityTemplatePO::getCreatedDate);
+
+        // 执行分页查询
+        IPage<QualityTemplatePO> result = qualityTemplateRepository.selectPage(PageUtil.page(query), wrapper);
+
+        // 转换结果
+        List<QualityTemplateVO> records = QualityTemplateConvertor.INSTANCE.toQualityTemplateVOList(result.getRecords());
+
+        return PageResult.of(
+                records,
+                result.getTotal(),
+                result.getSize(),
+                result.getCurrent()
+        );
+    }
+}
+```
+
+### 4.4 Convertor (MapStruct)
+
+```java
+package com.yss.quality.repository.convertor;
+
+import com.yss.quality.client.vo.QualityTemplateVO;
+import com.yss.quality.repository.entity.QualityTemplatePO;
+import org.mapstruct.Mapper;
+import org.mapstruct.factory.Mappers;
+
+import java.util.List;
+
+@Mapper
+public interface QualityTemplateConvertor {
+    QualityTemplateConvertor INSTANCE = Mappers.getMapper(QualityTemplateConvertor.class);
+
+    QualityTemplateVO toQualityTemplateVO(QualityTemplatePO po);
+
+    List<QualityTemplateVO> toQualityTemplateVOList(List<QualityTemplatePO> pos);
+}
+```
+
+## 5. 注意事项 (Notes)
+
+1.  **AuditableEntity**: 推荐业务 PO 继承此基类，以便自动维护审计信息。
+2.  **Lombok 使用**: 使用 `@RequiredArgsConstructor` 进行构造器注入是推荐的最佳实践。
+3.  **Wrapper 使用**: 优先使用 `Wrappers.lambdaQuery()` 而不是字符串列名，以提高重构安全性。
+4.  **分页工具**: 使用 `PageUtil` 统一处理分页参数，避免手动计算 offset。
+
+## 6. 阶段 7 合同
+
+- 前置条件是批准的数据架构、Repository 策略和 Slice Contract。
+- PO/Repository/Convertor 骨架可受控生成；复杂查询、分页语义、数据源、事务、迁移和并发使用 `behavior-tdd`。
+- 返回统一 `YSS Skill Execution Result`，证据包含实际文件、集成测试、MapStruct/Lombok 配置和 `./mvnw ...` 结果。

package/template/.qoder/skills/yss-router/references/boundaries.md

@@ -22,8 +22,8 @@ Default for a new page: first verify the approved product design, state matrix,
 ## Backend Boundaries
 
 - `yss-ddd-scaffold-generator`: Create a whole multi-module backend skeleton.
-- `yss-domain`: Domain modeling and domain gateway contracts.
-- `yss-backend-scaffold-application`: Application use cases, transaction boundaries, and cross-aggregate orchestration.
+- `yss-domain`: Domain modeling, domain gateway contracts, and domain-layer conventions.
+- `yss-application`: Application use cases, transaction boundaries, and cross-aggregate orchestration.
 - `yss-repository`: Persistence implementation, PO, Repository, Convertor, GatewayImpl.
 - `yss-web-controller`: REST adapter layer, request/response DTOs, VO, web convertor.
 - `yss-mybatis`: Framework behavior for MyBatis/MyBatis-Plus, BaseRepository, pagination, mapper scanning, batch, datasource issues.
@@ -39,11 +39,7 @@ Default for end-to-end backend CRUD: include Domain, Application, Infrastructure
 - `yss-audit-log`: Audit annotations, SpEL summaries, async publication, subscribers.
 - `yss-excel-mvc`: Spring MVC Excel import/export annotations and handlers.
 - `yss-distributed-id`: ID strategies, AutoIdInterceptor, Leaf/CosId/Snowflake, batch ID injection.
-- `yss-jdbc`: Hutool Db, dynamic datasource JDBC, JdbcSqlUtil, batch SQL execution.
-- `yss-dictionary`: Dictionary/domain item APIs and dictionary component integration.
-- `yss-log`: DEBUG request-parameter/success-latency logging, starter auto-configuration, and centralized collection; current `CatchAndLog` is not exception logging.
 - `yss-resilience4j`: Circuit breaker, fallback, and gateway resilience integration.
-- `yss-taskflow`: Task flow definition/execution component behavior.
 - `yss-validation`: Validation engine and JSR-303 integration.
 - `yss-security-algorithm`: RSA/AES/SM/JWT/JWK/password-encoding compatibility and production key-management safety gates.
 - `yss-userinfo`: Current-user info propagation and starter integration.