create-yss-spec 2.2.9 → 3.0.0

package/template/.claude/skills/yss-application/references/application-layer-guide.md

@@ -1,132 +1,87 @@
-本 Skill 约束 Application 层的用例边界。它是目标 DDD 架构规则，不等同于现有 YSS 组件仓库中所有 `core/service` 的历史实现；先探测工程布局并记录兼容 profile。
+# YSS Application Target Profile 指南
 
-## 1. 核心职责 (Core Responsibilities)
+Application 是 Web 与 Domain 之间的稳定用例边界。Target Profile 使用 `application` 包；历史 `core/service` 对新脚手架为 `unsupported`。
 
-- **业务用例编排 (Use Case Orchestration)**: 协调 Domain Service 和 Gateway 完成复杂的业务流程。
-- **服务接口实现 (Service Implementation)**: 实现 Application Service 接口，对外提供业务能力。
-- **DTO 转换 (DTO Conversion)**: 只在合同指定时负责 Domain/Application model 与 client/web DTO/VO 的转换；不得把 Repository PO 带入 Application。
-- **事务控制 (Transaction Management)**: 在应用层进行 `@Transactional` 事务管理。
+## 1. 职责
 
-## 2. 代码结构 (Code Structure)
+- 定义 Application Command、Query、Result 和 Use Case Service。
+- 编排 Domain Model、Domain Service 和 Domain Gateway。
+- 定义写用例事务边界、幂等和事件发布时点。
+- 为分页、列表和投影查询定义 Application Query Port。
+- 传播或转换领域错误语义，但不决定 HTTP status 和公开消息。
 
-```
-com.yss.{module}.core
-├── service                 # 应用服务接口
-│   ├── impl                # 应用服务实现
-│   └── convertor           # MapStruct 转换器 (App 层专用)
-├── component               # 业务组件 (Exporter, Handler)
-└── job                     # 任务执行逻辑 (Runner, Func)
-```
-
-## 3. 开发规范 (Development Guidelines)
-
-### 3.1 应用服务实现 (AppServiceImpl)
-
-- **位置**: 新 DDD 工程优先 `application/.../service/impl`；legacy profile 才使用 `core/service/impl`。
-- **注解**: `@Service`，通常配合 `@RequiredArgsConstructor` 进行构造器注入。
-- **事务**: 只在已确认的用例边界添加 `@Transactional(rollbackFor = Exception.class)`；读用例明确 `readOnly` 与总数策略。
-- **逻辑**: 主要负责调用 Domain Service 或 Gateway，**不应包含核心领域逻辑**（应下沉到 Domain 层）。
-
-### 3.2 对象转换 (Convertor)
+Application 不接收 HTTP Request DTO，不返回 Web VO，不依赖 Infrastructure/Web，也不处理 Repository PO。
 
-- **工具**: MapStruct。
-- **位置**: `com.yss.{module}.core.service.convertor`。
-- **职责**: 将 `Domain Object` (VO/Entity) 转换为 `Application VO` 或 `Client VO`。
-- **规范**: 定义 `INSTANCE` 常量，使用 `Mappers.getMapper(...)` 获取实例。
+## 2. 包结构
 
-### 3.3 异常处理
-
-- **业务异常**: 使用 `ExceptionFactory.bizException(...)` 或项目已批准的 `BizException` 错误码。
-- **已知系统异常**: 使用 `ExceptionFactory.sysException(...)` 并保留 cause；未知异常交由全局处理器兜底，不在 Application 吞并或改写。
-
-## 4. Legacy 参考形状（不可复制）
-
-以下 `QualityTemplate*` 代码只是说明 legacy `core/service` 形状的占位示例，不是当前参考源码中已验证存在的通用模块，也不定义新模块的包名、接口或返回模型。新 DDD profile 必须由批准合同生成中性 Application 接口，不能复制这些名称或 DTO/VO Gateway 泄漏。
+```text
+{base_package}.application
+├── command
+├── query
+├── result
+├── port
+└── service
+```
 
-### 4.1 Application Service Implementation
+## 3. 写用例
 
 ```java
-package com.yss.quality.core.service.impl;
-
-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;
-import com.yss.quality.domain.template.gateway.QualityTemplateGateway;
-import com.yss.quality.domain.template.service.QualityTemplateService;
-import lombok.RequiredArgsConstructor;
-import lombok.extern.slf4j.Slf4j;
-import org.springframework.stereotype.Service;
-import org.springframework.transaction.annotation.Transactional;
-
-import java.util.List;
-
-/**
- * 数据质量规则模板应用服务实现类
- */
 @Service
 @RequiredArgsConstructor
-@Slf4j
-public class QualityTemplateServiceImpl implements QualityTemplateService {
-
-    private final QualityTemplateGateway qualityTemplateGateway;
+public class QualityTemplateService {
+    private final QualityTemplateGateway gateway;
 
-    @Override
-    public PageResult<QualityTemplateVO> pageQualityTemplate(QualityTemplatePage query) {
-        // 直接调用 Domain Gateway
-        return qualityTemplateGateway.pageQualityTemplate(query);
-    }
-
-    @Override
     @Transactional(rollbackFor = Exception.class)
-    public Long addQualityTemplate(QualityTemplateAddCmd cmd) {
-        // 可以在此进行简单的应用层校验或编排
-        log.info("Adding quality template");
-        return qualityTemplateGateway.addQualityTemplate(cmd);
+    public QualityTemplateId create(QualityTemplateCreateCommand command) {
+        QualityTemplate aggregate = QualityTemplate.create(command.name());
+        gateway.save(aggregate);
+        return aggregate.id();
     }
 }
 ```
 
-### 4.2 Convertor (MapStruct)
+- WebConvertor 在 Controller 调用前把 Request 转成 Application Command。
+- 核心规则由 Aggregate 公开方法执行，不复制到 AppService。
+- 一次用例一个明确事务 seam；读操作按合同决定 `readOnly` 和总数策略。
+
+## 4. 查询用例
 
 ```java
-package com.yss.quality.core.service.convertor;
-
-import com.yss.quality.client.vo.QualityTechTemplateVO;
-import com.yss.quality.client.vo.QualityTemplateVO;
-import com.yss.quality.params.base.PluginParams;
-import org.mapstruct.Mapper;
-import org.mapstruct.NullValueCheckStrategy;
-import org.mapstruct.NullValuePropertyMappingStrategy;
-import org.mapstruct.factory.Mappers;
-
-import java.util.List;
-
-@Mapper(
-    nullValuePropertyMappingStrategy = NullValuePropertyMappingStrategy.IGNORE,
-    nullValueCheckStrategy = NullValueCheckStrategy.ALWAYS
-)
-public interface QualityTechTemplateConvertor {
-    QualityTechTemplateConvertor INSTANCE = Mappers.getMapper(QualityTechTemplateConvertor.class);
-
-    // 将 Domain VO 和 PluginParams 组合转换为 TechTemplateVO
-    QualityTechTemplateVO useQualityTechTemplateVO(QualityTemplateVO qualityTemplateVO, List<PluginParams> pluginParams);
+public interface QualityTemplateQueryPort {
+    PageResult<QualityTemplateResult> page(QualityTemplatePageQuery query);
 }
 ```
 
-## 5. 注意事项 (Notes)
+- Query Port 属于 Application，Infrastructure 实现。
+- `QualityTemplatePageQuery` 使用 Application 语义，不接受未经白名单转换的数据库列名。
+- Application Result 不等于 Web VO；WebConvertor 负责最后一跳。
+- `PageResult` 可以作为 Application/Infrastructure 的 YSS 分页容器，但不得进入 Domain Gateway。
+
+## 5. MapStruct
+
+只有 Application 内确有不同模型转换时才创建 Convertor，并统一：
+
+```java
+@Mapper(componentModel = "spring")
+public interface QualityTemplateApplicationConvertor {
+}
+```
+
+禁止静态 `INSTANCE`；使用构造器注入。Web DTO 转换仍留在 Web，PO 转换留在 Infrastructure。
+
+## 6. Error seam
 
-1.  **职责分离**: Application 层关注“做什么”（流程编排），Domain 层关注“怎么做”（业务规则）。
-2.  **依赖方向**: Application 层依赖 Domain 层，不应依赖 Adapter 层（Web/Job）。
-3.  **事务边界**: 一个用例一个边界；跨聚合写入、幂等键、事件发布时点必须写入合同并用 `behavior-tdd` 验证。
-4.  **上下文能力**: 当前用户、审计、普通技术日志、校验和异常是条件依赖，按 `yss-router` 影响闭包加载，不在 AppService 内手工解析 Header/JWT。
+- Domain error 保留稳定错误标识和参数。
+- Application 不吞掉 unknown exception，不把 `getLocalizedMessage()` 变成公开响应。
+- Web Exception Translator 依据冻结 API 合同映射 YSS error code、HTTP status 和消毒消息。
 
-## 6. 架构探测门禁
+## 7. 验证
 
-先确认工程是新 DDD `application/domain/infrastructure/adapter`，还是 legacy `core/client/repository`。没有 `backend_repository`、Maven Wrapper 和已批准合同版本时输出 `blocked`；不得用示例包名推断真实接口。
+- 写用例通过 Application Service seam 测试事务、幂等和领域行为。
+- 查询用例通过 Query Port seam 测试分页和白名单。
+- ArchUnit 证明 Application 不依赖 Infrastructure/Web。
+- 实际执行项目根 `./mvnw test/package`。
 
-## 7. 阶段 7 合同
+## 8. 旧架构边界
 
-- 明确当前 Use Case、Application 边界、事务边界、跨聚合协调和异常映射，只消费批准后的合同版本。
-- AppService 骨架可受控生成；用例编排、事务、幂等、权限和失败行为必须使用 `behavior-tdd`。
-- 返回统一 `YSS Skill Execution Result`，证据至少包含 Application 代码、测试、MapStruct/Lombok 条件和实际 `./mvnw ...` 结果。
+检测到 AppService 接收 client Cmd、返回 client VO、调用返回 VO 的 Domain Gateway 或位于 `core/service` 时，返回 `unsupported`，不得由新 scaffold 或本指南自动改写。旧项目继续按原工程维护；现代化改造必须单独立项、先评估再逐切片迁移。

package/template/.claude/skills/yss-components/SKILL.md

@@ -12,7 +12,7 @@ description: Use when YSS Vue 页面涉及布局、YTable、YEditTable、YFormil
 - YSS UI 组件文档：`http://192.168.164.27:3200/components`（组件契约以该手册为准；本技能依据 2026-08-18 可见内容整理）
 - 本地引用索引：`references/frontend-docs.md`
 
-本技能只负责页面组件、布局和交互呈现规范。请求、分页参数、接口映射交给 `yss-hook` 或 `yss-api-integration`；完整页面生成流程交给 `yss-page-module-development`；表格/树高度细节交给 `yss-use-table-height` 或 `yss-use-tree-height`。
+本技能只负责页面组件、布局和交互呈现规范。请求、分页参数、接口映射交给 `yss-hook` 或 `yss-api-integration`；新建或改造完整业务页面交给 `yss-ui-business-page-generation`，生命周期编排和旧触发词兼容交给 `yss-page-module-development`；表格/树高度细节交给 `yss-use-table-height` 或 `yss-use-tree-height`。
 
 组件文档与当前项目的已验证用法冲突时，先检查当前项目代码和依赖版本，再决定是否迁移；不得把上游 Ant Design Vue、vxe-table、Univer 或 Monaco 的未验证 API 当作 YSS 顶层契约。
 

package/template/.claude/skills/yss-ddd-scaffold-generator/SKILL.md

@@ -23,21 +23,27 @@ description: 用于生成完整的 YSS DDD 多模块后端脚手架。当用户
 
 ## 优先流程
 
-1. 确认项目名、基础包名、输出目录、数据库类型。
+1. 确认服务级 `scaffold_request_id`、项目名、基础包名、Maven 项目坐标、父 POM GAV、YSS Components BOM 版本、输出目录和批准 Profile。Java `base_package` 与 Maven `group_id` 是两个独立输入，不得相互推导；脚手架发生在 Ticket 正式化前，不使用 `slice_id` 伪造切片身份。
    Harness 内输出目录必须是 `apps/backend/` 容器，生成器再以 `project_name` 创建 `apps/backend/<project>/`；禁止使用 `app/backend/`、`app/frontend/` 或把 `apps/backend/` 之外的容器根当作后端项目根。
-2. 运行 `node scripts/generate_scaffold.mjs` 生成骨架。
-3. 检查生成的模块名、POM、基础配置文件和包路径。
-4. 由生命周期受控工作单元在生成项目根目录实际执行 `./mvnw validate`、`./mvnw test` 和 `./mvnw package`；生成器打印的下一步命令不构成验证证据。
-5. 如需继续细化，再追加其他 YSS skill 补全领域、仓储和 Web。
+2. 优先运行 `node scripts/generate_and_verify_scaffold.mjs`，在同一个受控工作流中生成骨架并执行真实 Maven 验证。`generate_scaffold.mjs` 只是底层生成原语，单独返回 0 不代表脚手架完成。
+3. 检查生成的模块名、POM、机械启动入口、基础配置文件和包路径。
+4. 受控工作流必须在生成项目根目录实际执行 `./mvnw validate`、`./mvnw test` 和 `./mvnw package`；三条命令全部返回 0 后才能报告完成。
+5. 三条 Wrapper 命令通过只得到 `empty-scaffold-verified`。如需声称已满足下游技能的首切片就绪条件，必须使用 `node scripts/run_first_slice_verification.mjs` 校验批准且版本当前的 Slice Implementation Contract、完整分层产物、skill tree digest 与根 Wrapper；只有验证器成功更新 Manifest 后才得到 `first-slice-verified`。
 
-受控验证命令由本 skill 的 `node scripts/run_scaffold_verification.mjs` 固定执行；验证器先检查 `.yss/scaffold-generation.json` 的合同元数据，再在指定 evidence 目录写入每条命令的 stdout/stderr、`exit_code`、耗时、执行时间和 `scaffold-verification.json`；任何一条命令失败或未执行都必须阻断。
+受控验证命令由本 skill 的 `node scripts/run_scaffold_verification.mjs` 固定执行；验证器先检查 `.yss/scaffold-generation.json` 的合同元数据和 Wrapper、Java、项目级 Maven settings/profile、仓库凭据是否就绪，再在指定 evidence 目录写入每条命令的 stdout/stderr、`exit_code`、`failure_category`、耗时、执行时间和 `scaffold-verification.json`。仓库或凭据失败归为 `repository-access`，与 `project-model`、`compilation`、`bootstrap-entrypoint`、`test-failure`、`packaging` 分开；任何一条命令失败或未执行都必须阻断。
 
 ## 推荐命令
 
 ```bash
-node scripts/generate_scaffold.mjs \
+node scripts/generate_and_verify_scaffold.mjs \
   --project-name my-service \
   --base-package com.yss.myservice \
+  --group-id com.yss.datamiddle \
+  --project-version 1.0.0-SNAPSHOT \
+  --parent-group-id com.yss.datamiddle \
+  --parent-artifact-id yss-datamiddle-parent \
+  --parent-version 2.0.0-SNAPSHOT \
+  --yss-components-version 2.0.0-SNAPSHOT \
   --output-dir /path/to/implementation-repo \
   --database mysql \
   --contract-id <approved-scaffold-contract-id> \
@@ -45,7 +51,17 @@ node scripts/generate_scaffold.mjs \
   --approval-ref <lifecycle-approval-ref> \
   --router-draft-ref <router-draft-ref> \
   --persisted-ref <persisted-contract-ref> \
-  --contract-file /path/to/persisted-scaffold-contract.json
+  --contract-file /path/to/persisted-scaffold-contract.json \
+  --evidence-dir /path/to/evidence/scaffold
+```
+
+完成批准的 golden first slice 后运行：
+
+```bash
+node scripts/run_first_slice_verification.mjs \
+  --project-root /path/to/implementation-repo/my-service \
+  --slice-contract-file /path/to/approved-slice-contract.json \
+  --evidence-dir /path/to/evidence/first-slice
 ```
 
 ## 生成结果应包含
@@ -56,34 +72,43 @@ node scripts/generate_scaffold.mjs \
 - `*-infrastructure`
 - `*-adapter`
 - `*-bootstrap`
+- `*-bootstrap` 下可被 Spring Boot Maven Plugin 发现的机械 `*Application` 启动入口
 - 基础配置、机械模板、构建脚本
 
 ## 使用约束
 
 - 先在生命周期批准的脚手架受控生成合同下生成骨架，再做业务化定制；不要直接把脚手架当最终代码交付。
 - 永不生成 `User CRUD` 示例；`--with-example` 已禁用，业务代码必须按批准的 Slice Implementation Contract 逐切片实现。
-- 若仓库已经存在相同工程，先核对覆盖范围。
-- 输出目录必须显式指定；非空目录默认拒绝写入，确认覆盖时才使用 `--force`。
+- 若目标工程已经存在，直接返回 `unsupported`。旧项目继续按原工程维护；需要现代化时单独立项、先评估再逐切片迁移，不属于本 skill。
+- 输出目录必须显式指定；目标工程目录必须不存在，`--force` 永久拒绝。
 - Harness 内多项目布局必须使用 `apps/backend/<project>/`；`apps/backend/` 只能是生成器的父容器，`app/backend/`、`app/frontend/` 及其子路径一律拒绝。`git-submodule` gitlink、空挂载点、detached HEAD 工作树不得覆盖生成，即使传入 `--force` 也不得当成普通目录，且不得走「请显式传入 `--force`」普通目录覆盖 / rename 路径。`--output-dir` 指向 detached HEAD 子仓时不得 mkdir、staging 或生成工程。先 `git submodule update --init` 并在子仓附加分支工作树内生成。生成器必须先调用 `gitSubmoduleScaffoldViolation`，再在 exists / `--force` / rename 之前调用 `refuseGitlinkAsRegularDirectory`。
 - 不要在 skill 里硬编码用户业务字段或真实连接信息。
 - 生成后要检查依赖关系是否仍符合分层约束。
-- 生成后必须继续使用 `yss-backend-scaffold-parent` 校验工程基线，再按垂直切片加载 `yss-domain`、`yss-application`、`yss-repository`、`yss-web-controller` 等行为 skill；各 skill 的 `references/*-layer-guide.md` 承载分层开发规范。
+- 生成时的静态依赖由技能注册表与 Router 共同约束为 `yss-backend-scaffold-parent`、`alibaba-java-code-style`。生成后必须回到 Router，并按批准切片加载 `yss-domain`、`yss-application`、`yss-repository`、`yss-mybatis`、`yss-web-controller`、`yss-dto`、`yss-exception`、`yss-validation`、`mapstruct`、`lombok`、`alibaba-java-code-style` 等实际命中的行为 skill。
 - 当前脚手架第一阶段仅支持经过验证的 `mysql`；未提供完整模板和验证的数据库类型不得伪装成已支持。
 - 生成后的后端工程必须使用项目根目录 `./mvnw ...` 执行构建、测试、运行和 CI 验证；不得在 README、实施记录、Ticket、Review 或 Release 中默认写裸 `mvn ...`。既有仓库确实无法使用 wrapper 时，必须记录受控例外。
 - 原型确认后，`scaffold_status=required` 才能进入本 skill；本 skill 的生成边界是工程结构、POM、配置、Wrapper 和机械模板，不是业务实现。
 - 脚手架合同必须携带 `contract_id`、`contract_version`、Router draft 引用、生命周期批准引用、持久化引用、当前版本、允许写路径、预期证据文件和验证命令；字段缺失或版本过期时阻断。
-- 运行生成器必须传入 `--contract-file`；生成器会校验合同 `status=approved`、`current_version`、`primary_skill`、`controlled-generation` 和固定三条验证命令，不接受仅凭任意字符串引用的放行。
-- 生成项目必须写入非业务元数据清单 `.yss/scaffold-generation.json`，回勾合同 ID、版本、批准引用、生成输入、受控模式和固定验证命令；清单缺失时不得交给后续 Router。
+- 新脚手架合同只接受 schema v2，必须分别携带 `project_name`、`base_package` 和 `maven_coordinates`；后者包含项目 `group_id` / `project_version`、父 POM GAV 与 `yss_components_version`，并由 CLI 原样传入。schema v1 为 `unsupported`，直接拒绝且不自动升级。
+- 合同 `profiles` 只支持 `target-domain-model`、`mybatis-plus`、`mysql`、`spring-boot-2.7-jdk8`、`javax`、`web`、`yss-internal`。普通 MyBatis、Boot 3、独立 client module、client-in-domain 和其他旧架构均为 `unsupported`，不提供回退分支。
+- 运行生成器必须传入 `--contract-file`；生成器会校验合同 `status=approved`、`current_version`、`primary_skill`、`controlled-generation`、实际输出路径和固定三条验证命令，不接受仅凭任意字符串引用的放行。
+- 生成项目必须写入 Manifest v2 `.yss/scaffold-generation.json`，记录合同 digest、Target Profile、模板 digest、下游完整 skill tree digest、脚手架父合同与 Router 合同 digest、generator-owned 文件 hash、严格 `generation_policy` 和完成等级；清单缺失或不一致时不得交给后续 Router。
+- `first-slice-verified` 只能由 `run_first_slice_verification.mjs` 写入。手工改 Manifest、只生成 Controller、只通过局部模块测试或仅有结构扫描都不能升级完成等级。
 - 严禁把领域规则、状态机、权限、事务、复杂查询、错误映射、业务字段或用户可见行为塞进脚手架生成步骤。`./mvnw validate`、输出目录存在或“生成成功”都不等于生命周期批准、架构放行或 `ready-for-agent`。
-- 生命周期脚手架生成必须关闭 `--with-example`，不得把 User CRUD 或业务字段当作样板；非空目标目录使用 `--force` 默认禁止，除非覆盖范围、备份、回滚点和批准引用已经进入当前合同。
+- 生命周期脚手架生成必须关闭 `--with-example`，不得把 User CRUD 或业务字段当作样板。生成器严格 `initialize-only`：非空目标、`--force`、旧项目迁移和当前模板升级一律 `unsupported`。未来若支持同一 Target Profile 内的模板升级，必须另行设计和批准，当前不预留可执行承诺。
 - 脚手架完成后，所有后续生成的后端代码必须回到 `yss-router`，消费批准且版本当前的 Slice Implementation Contract 和对应 YSS skill；业务行为使用 `behavior-tdd`，机械生成才使用 `controlled-generation`。
 - `.mvn/settings.xml` 只能通过 `${env.MAVEN_REPO_USERNAME}` 和 `${env.MAVEN_REPO_PASSWORD}` 读取 Maven 仓库凭据；内部仓库构建前由 CI 或本地安全环境注入变量，禁止把 Maven 仓库用户名、明文密码或 Maven 加密密码写入 skill、模板或生成工程。
+- `.mvn/maven.config` 必须显式加载项目级 `.mvn/settings.xml` 并激活 `yss-internal`；仓库 URL 来自 `YSS_MAVEN_REPOSITORY_URL`，凭据来自 `MAVEN_REPO_USERNAME` / `MAVEN_REPO_PASSWORD`。预检缺失时先于 Maven 执行阻断，日志必须脱敏。
+- Domain POM 不得依赖 YSS DTO/Exception、Web Validation、Swagger 或 Jackson；DTO/Exception/OpenAPI 注解属于 Web。MapStruct 统一 `componentModel="spring"`，父 POM 负责 processor 与 `lombok-mapstruct-binding`。
+- 生成工程必须携带 ArchUnit、Maven Enforcer 和 Wrapper checksum；DEBUG 与 MyBatis stdout SQL 只能进入 `application-local.yml`。
 - 涉及 API 契约时，先确认 `docs/.scratch/<feature>/api/<feature>.yaml` 中的 OpenAPI Draft / Freeze 状态；不要用脚手架生成结果反向替代产品契约设计。
 
 ## 按需读取
 
 - 主脚本：`scripts/generate_scaffold.mjs`
+- 推荐的一键生成验证入口：`scripts/generate_and_verify_scaffold.mjs`
 - 受控验证器：`scripts/run_scaffold_verification.mjs`
+- 首切片验证器：`scripts/run_first_slice_verification.mjs`
 - 模板目录：`assets/templates/`
 - 分层细化参考：`references/yss-backend-scaffold-parent/` 及其子 skill
 

package/template/.claude/skills/yss-ddd-scaffold-generator/assets/templates/config/application-local.yml.template

@@ -0,0 +1,8 @@
+mybatis-plus:
+  configuration:
+    log-impl: org.apache.ibatis.logging.stdout.StdOutImpl
+
+logging:
+  level:
+    {{base_package}}: DEBUG
+    org.springframework.jdbc: DEBUG

package/template/.claude/skills/yss-ddd-scaffold-generator/assets/templates/config/application.yml.template

@@ -21,7 +21,6 @@ spring:
 mybatis-plus:
   configuration:
     map-underscore-to-camel-case: true
-    log-impl: org.apache.ibatis.logging.stdout.StdOutImpl
   global-config:
     db-config:
       id-type: assign_id
@@ -31,7 +30,7 @@ mybatis-plus:
 
 logging:
   level:
-    {{base_package}}: DEBUG
-    org.springframework.jdbc: DEBUG
+    root: INFO
+    {{base_package}}: INFO
   pattern:
     console: "%d{yyyy-MM-dd HH:mm:ss.SSS} [%thread] %-5level %logger{36} - %msg%n"

package/template/.claude/skills/yss-ddd-scaffold-generator/assets/templates/java/architecture-rules-test.java.template

@@ -0,0 +1,36 @@
+package {{base_package}};
+
+import com.tngtech.archunit.core.importer.ImportOption;
+import com.tngtech.archunit.junit.AnalyzeClasses;
+import com.tngtech.archunit.junit.ArchTest;
+import com.tngtech.archunit.lang.ArchRule;
+
+import static com.tngtech.archunit.lang.syntax.ArchRuleDefinition.noClasses;
+
+/**
+ * Target DDD 的最小可执行边界。规则允许空包，首个业务切片加入后立即生效。
+ */
+@AnalyzeClasses(packages = "{{base_package}}", importOptions = ImportOption.DoNotIncludeTests.class)
+class ArchitectureRulesTest {
+
+    @ArchTest
+    static final ArchRule domain_is_technology_free = noClasses()
+            .that().resideInAPackage("..domain..")
+            .should().dependOnClassesThat().resideInAnyPackage(
+                    "..application..", "..infrastructure..", "..repository..", "..rest..")
+            .allowEmptyShould(true);
+
+    @ArchTest
+    static final ArchRule application_does_not_depend_on_adapters = noClasses()
+            .that().resideInAPackage("..application..")
+            .should().dependOnClassesThat().resideInAnyPackage(
+                    "..infrastructure..", "..repository..", "..rest..")
+            .allowEmptyShould(true);
+
+    @ArchTest
+    static final ArchRule web_does_not_reach_infrastructure = noClasses()
+            .that().resideInAPackage("..rest..")
+            .should().dependOnClassesThat().resideInAnyPackage(
+                    "..infrastructure..", "..repository..")
+            .allowEmptyShould(true);
+}

package/template/.claude/skills/yss-ddd-scaffold-generator/assets/templates/java/bootstrap-application.java.template

@@ -0,0 +1,15 @@
+package {{base_package}};
+
+import org.springframework.boot.SpringApplication;
+import org.springframework.boot.autoconfigure.SpringBootApplication;
+
+/**
+ * {{project_name}} 服务的机械启动入口。
+ */
+@SpringBootApplication(scanBasePackages = "{{base_package}}")
+public class {{application_class_name}} {
+
+    public static void main(String[] args) {
+        SpringApplication.run({{application_class_name}}.class, args);
+    }
+}

package/template/.claude/skills/yss-ddd-scaffold-generator/assets/templates/pom/adapter-pom.xml.template

@@ -5,9 +5,9 @@
     <modelVersion>4.0.0</modelVersion>
 
     <parent>
-        <groupId>com.yss.datamiddle</groupId>
+        <groupId>{{group_id}}</groupId>
         <artifactId>{{project_name}}-parent</artifactId>
-        <version>1.0.0-SNAPSHOT</version>
+        <version>{{project_version}}</version>
     </parent>
 
     <artifactId>{{project_name}}-adapter</artifactId>
@@ -16,4 +16,4 @@
     <modules>
         <module>{{project_name}}-web</module>
     </modules>
-</project>
+</project>

package/template/.claude/skills/yss-ddd-scaffold-generator/assets/templates/pom/application-pom.xml.template

@@ -5,18 +5,22 @@
     <modelVersion>4.0.0</modelVersion>
 
     <parent>
-        <groupId>com.yss.datamiddle</groupId>
+        <groupId>{{group_id}}</groupId>
         <artifactId>{{project_name}}-parent</artifactId>
-        <version>1.0.0-SNAPSHOT</version>
+        <version>{{project_version}}</version>
     </parent>
 
     <artifactId>{{project_name}}-application</artifactId>
 
     <dependencies>
         <dependency>
-            <groupId>com.yss.datamiddle</groupId>
+            <groupId>{{group_id}}</groupId>
             <artifactId>{{project_name}}-domain</artifactId>
         </dependency>
+        <dependency>
+            <groupId>com.yss.cloud</groupId>
+            <artifactId>yss-component-dto</artifactId>
+        </dependency>
         <dependency>
             <groupId>org.springframework.boot</groupId>
             <artifactId>spring-boot-starter</artifactId>
@@ -39,5 +43,10 @@
             <artifactId>mapstruct</artifactId>
             <version>${mapstruct.version}</version>
         </dependency>
+        <dependency>
+            <groupId>org.springframework.boot</groupId>
+            <artifactId>spring-boot-starter-test</artifactId>
+            <scope>test</scope>
+        </dependency>
     </dependencies>
-</project>
+</project>

package/template/.claude/skills/yss-ddd-scaffold-generator/assets/templates/pom/bootstrap-pom.xml.template

@@ -5,20 +5,20 @@
     <modelVersion>4.0.0</modelVersion>
 
     <parent>
-        <groupId>com.yss.datamiddle</groupId>
+        <groupId>{{group_id}}</groupId>
         <artifactId>{{project_name}}-parent</artifactId>
-        <version>1.0.0-SNAPSHOT</version>
+        <version>{{project_version}}</version>
     </parent>
 
     <artifactId>{{project_name}}-bootstrap</artifactId>
 
     <dependencies>
         <dependency>
-            <groupId>com.yss.datamiddle</groupId>
+            <groupId>{{group_id}}</groupId>
             <artifactId>{{project_name}}-web</artifactId>
         </dependency>
         <dependency>
-            <groupId>com.yss.datamiddle</groupId>
+            <groupId>{{group_id}}</groupId>
             <artifactId>{{project_name}}-infrastructure</artifactId>
         </dependency>
         <dependency>
@@ -37,6 +37,26 @@
             <groupId>com.yss.cloud</groupId>
             <artifactId>yss-component-spring-cache</artifactId>
         </dependency>
+        <dependency>
+            <groupId>org.springframework.boot</groupId>
+            <artifactId>spring-boot-starter-actuator</artifactId>
+        </dependency>
+        <dependency>
+            <groupId>org.springframework.boot</groupId>
+            <artifactId>spring-boot-starter-test</artifactId>
+            <scope>test</scope>
+        </dependency>
+        <dependency>
+            <groupId>com.tngtech.archunit</groupId>
+            <artifactId>archunit-junit5</artifactId>
+            <version>${archunit.version}</version>
+            <scope>test</scope>
+        </dependency>
+        <dependency>
+            <groupId>com.h2database</groupId>
+            <artifactId>h2</artifactId>
+            <scope>test</scope>
+        </dependency>
     </dependencies>
 
     <build>

package/template/.claude/skills/yss-ddd-scaffold-generator/assets/templates/pom/domain-pom.xml.template

@@ -5,32 +5,18 @@
     <modelVersion>4.0.0</modelVersion>
 
     <parent>
-        <groupId>com.yss.datamiddle</groupId>
+        <groupId>{{group_id}}</groupId>
         <artifactId>{{project_name}}-parent</artifactId>
-        <version>1.0.0-SNAPSHOT</version>
+        <version>{{project_version}}</version>
     </parent>
 
     <artifactId>{{project_name}}-domain</artifactId>
 
     <dependencies>
         <dependency>
-            <groupId>com.yss.cloud</groupId>
-            <artifactId>yss-component-dto</artifactId>
-        </dependency>
-        <dependency>
-            <groupId>javax.validation</groupId>
-            <artifactId>validation-api</artifactId>
-        </dependency>
-        <dependency>
-            <groupId>org.projectlombok</groupId>
-            <artifactId>lombok</artifactId>
-            <scope>provided</scope>
-        </dependency>
-        <dependency>
-            <groupId>io.swagger</groupId>
-            <artifactId>swagger-annotations</artifactId>
-            <version>1.6.16</version>
-            <scope>compile</scope>
+            <groupId>org.junit.jupiter</groupId>
+            <artifactId>junit-jupiter</artifactId>
+            <scope>test</scope>
         </dependency>
     </dependencies>
-</project>
+</project>

package/template/.claude/skills/yss-ddd-scaffold-generator/assets/templates/pom/infrastructure-pom.xml.template

@@ -5,21 +5,29 @@
     <modelVersion>4.0.0</modelVersion>
 
     <parent>
-        <groupId>com.yss.datamiddle</groupId>
+        <groupId>{{group_id}}</groupId>
         <artifactId>{{project_name}}-parent</artifactId>
-        <version>1.0.0-SNAPSHOT</version>
+        <version>{{project_version}}</version>
     </parent>
 
     <artifactId>{{project_name}}-infrastructure</artifactId>
 
     <dependencies>
         <dependency>
-            <groupId>com.yss.datamiddle</groupId>
+            <groupId>{{group_id}}</groupId>
             <artifactId>{{project_name}}-domain</artifactId>
         </dependency>
+        <dependency>
+            <groupId>{{group_id}}</groupId>
+            <artifactId>{{project_name}}-application</artifactId>
+        </dependency>
         <dependency>
             <groupId>com.yss.cloud</groupId>
-            <artifactId>yss-component-mybatis-starter</artifactId>
+            <artifactId>yss-component-mybatis-plus-starter</artifactId>
+        </dependency>
+        <dependency>
+            <groupId>org.springframework.boot</groupId>
+            <artifactId>spring-boot-starter-jdbc</artifactId>
         </dependency>
         <dependency>
             <groupId>org.mapstruct</groupId>
@@ -30,5 +38,17 @@
             <groupId>org.projectlombok</groupId>
             <artifactId>lombok</artifactId>
             <scope>provided</scope>
-        </dependency> {{db_dependency}} </dependencies>
-</project>
+        </dependency>
+        <dependency>
+            <groupId>org.springframework.boot</groupId>
+            <artifactId>spring-boot-starter-test</artifactId>
+            <scope>test</scope>
+        </dependency>
+        <dependency>
+            <groupId>com.h2database</groupId>
+            <artifactId>h2</artifactId>
+            <scope>test</scope>
+        </dependency>
+        {{db_dependency}}
+    </dependencies>
+</project>