create-yss-spec 3.3.0 → 3.3.3

package/template/.trae/skills/yss-dto/SKILL.md

@@ -1,93 +0,0 @@
----
-name: yss-dto
-description: Use when YSS `Result`, `SingleResult`, `MultiResult`, `PageResult`, `PageQuery`, `CommandDTO`, `QueryDTO`, pagination, or response-wrapper boundaries are involved.
----
-
-# yss-dto
-
-用于处理 `yss-component-dto` 的使用规范和代码接入。
-
-本 skill 同时负责把中台 DTO 映射到公开 HTTP/JSON 边界。`references/openapi-wire-profile.yaml` 是可复用的机器可读映射源；OpenAPI 治理和 Draft Review 必须消费它，不得各自复制一份 wrapper 或分页字段表。
-
-## 所有权边界
-
-- 先消费 `architecture_identity`：DDD 的 HTTP DTO 在 Web；通用 MVC 私有 DTO 在 server、已批准公开 DTO 在 client；数据分析 MVC 公开 DTO 在 client。service/core 自有内部 Command/Query/Result，不依赖 client DTO；server 用 MapStruct 转换。共用 wire profile 不意味着共用模块路径。
-- `Result` / `SingleResult` / `MultiResult` / `PageResult`、`CommandDTO` / `QueryDTO` / `PageQuery` 的 canonical package、工厂方法、字段语义、默认值、枚举和禁用字段由本 skill 及 `references/openapi-wire-profile.yaml` 唯一持有。
-- Web skill 只生成 endpoint-specific Page Request、Request/Response 与 Convertor，并通过批准合同中的 profile 引用和 digest 消费上述协议；不得生成 wrapper/page base，也不得维护分页字段或默认值副本。
-- OpenAPI skill 只把该 profile 组合进 endpoint schema；不得从 Java getter 或本地常量反向建立第二份 wire 协议。
-
-## 何时使用
-
-- 用户要定义新的分页查询对象。
-- 用户要统一接口返回结构。
-- 用户提到 `Result`、`PageQuery`、`CommandDTO`、`QueryDTO`。
-- 用户在排查分页参数、返回结构或 DTO 继承不一致问题。
-
-## 工作方式
-
-1. 优先沿用项目现有 DTO 体系，不重复造返回包装类。
-2. 涉及真实类名、返回结构、分页字段或排障时，先读 `references/source-index.md`，再定位源码或文档。
-3. 新 Target Profile 的 canonical 包固定为 `com.yss.cloud.dto.result`；`com.yss.cloud.dto.response` 为 `unsupported`，不得在新契约或脚手架输出中引入。检测到旧包时只报告边界，不自动改写；旧项目现代化须单独立项。
-4. 需要设计或审查 API 时，先校验 `references/openapi-wire-profile.yaml`，再把 endpoint 的具体 DTO/VO schema 组合到 wrapper；Java 泛型不是 OpenAPI schema。
-5. 只围绕当前 DTO 结构回答，不泛化到整个微服务理论。
-
-## 源码索引
-
-- 源码位置不要假设固定目录；先按 `yss-skill-source-index-refresh/references/source-location.md` 定位。
-- 当前技能索引：`references/source-index.md`
-- OpenAPI wire profile：`references/openapi-wire-profile.yaml`
-- 重点源码入口通常包括 `CommandDTO`、`QueryDTO`、`PageQuery`、`PageRequestFactory`、`Result`、`SingleResult`、`MultiResult`、`PageResult`。
-
-当组件源码变化后，用 `yss-skill-source-index-refresh` 刷新索引；刷新或读取前先按源码定位策略确认真实位置。
-
-## 使用规则
-
-- 写操作参数优先继承 `CommandDTO`。
-- Application/Infrastructure 内部读参数可按项目 Profile 使用 `QueryDTO` 或 `PageQuery`。
-- 公开 HTTP Page Request 默认不继承 `PageQuery`，只复制冻结 OpenAPI 允许的分页字段，再由 WebConvertor 转为 Application Query；避免继承的 `offset`、`needTotalCount`、`tempTotalCount` 进入绑定面。
-- Controller 返回优先使用项目既有的 `Result` 或派生结果对象。
-- 单对象返回优先 `SingleResult`，列表返回优先 `MultiResult`，分页返回优先 `PageResult`，前提是当前项目已采用这套体系。
-- 三种泛型结果要求 `T extends Serializable`；生成的 VO/响应类型必须满足该编译约束。
-- OpenAPI 响应以 `YssResultMeta` 表达公共字段，并用 `allOf` 叠加 endpoint-specific `data` / page 字段；每个响应声明 `x-yss-response-wrapper: SingleResult|MultiResult|PageResult`，不得把 `SingleResult<T>` 文字写成 schema。
-- wire shape 不是 Java 字段清单：`success` 为 boolean，`dataType` 为 `string|null`，`code` 只允许 `string|integer|null`；不得把全局 `code` 放宽为任意 object。
-- `MultiResult.data` 和 `PageResult.data` 对外是数组，空值按 `[]` 建模；`SingleResult.data` 按 endpoint schema 建模并显式处理 nullability。
-- `PageResult` 当前稳定公共字段为 `totalCount/pageSize/pageIndex/data[]`；`totalPages` 是计算 getter，只有目标 HTTP mapper / contract fixture 证明后才能进入具体契约。
-- `PageQuery` 客户端输入只允许 `pageIndex/pageSize/orderBy/orderDirection/groupBy`（后四项按 profile 的 optional / whitelist 规则）；`orderDirection` 只能是 `ASC|DESC`。`offset`、`needTotalCount`、`tempTotalCount` 是计算或内部协作字段，禁止成为客户端输入。
-- `buildSuccess(...)` 各重载设置 code 的行为并不一致；冻结契约必须测试 `success/code/message/tips/dataType`、nullability 和三种 data shape，不能只测试 data。
-- Java getter、Lombok、`@JsonIgnore` 或默认 Jackson 结果都不是目标 HTTP wire fact；冻结前必须记录 mapper identity、代表性序列化 fixture 和 contract-test / 等价 HTTP 证据。
-- DTO 只表达接口契约，不承载 Repository PO 或领域对象的持久化细节。
-
-## 检查清单
-
-- 分页字段名是否和框架约定一致。
-- `orderBy` / `groupBy` 是否经过 Repository 白名单映射，禁止直接拼接 SQL。
-- Application Query Port / Infrastructure 是否收到批准的分页语义；Domain Gateway 不接收 `PageQuery`。
-- 新增 DTO 是否与现有序列化和校验方式兼容。
-- 返回结构是否和前端或上游调用方契约一致。
-- 是否通过 `scripts/verify-yss-dto-openapi-profile`，并引用 profile 版本。
-- wrapper extension、`YssResultMeta`、`allOf`、具体 data schema 和方向性是否逐 endpoint 对齐。
-- 是否有针对 `offset` / `needTotalCount` / `tempTotalCount` 的负向断言，以及对 `totalPages` 的目标 mapper 证据。
-- Controller、Application Service、Domain、Repository 之间是否存在 DTO/VO/DO/PO 混穿。
-- 前端 Orval 或调用方是否依赖当前返回包装结构。
-
-## 修改约束
-
-- 不要在一个项目里混用多套返回包装类。
-- 不要新建与 `PageQuery` 含义重叠的分页基类。
-- 不要把 `com.yss.cloud.dto.response` 作为新 API 的 canonical 包，也不要从 Java getter 机械生成 wire schema。
-- 不要把 `offset`、`needTotalCount`、`tempTotalCount` 作为客户端分页输入；不要无证据把 `totalPages` 写入所有分页响应。
-- 若项目已有 `SingleResult`、`PageResult`、`MultiResult` 体系，优先保持一致。
-
-## 按需读取
-
-- 源码索引：`references/source-index.md`
-- DTO 基类示例：`assets/CommandDTO.java`、`assets/QueryDTO.java`
-- 分页基类：`assets/PageQuery.java`
-- 返回结构：`assets/Result.java`
-- HTTP/JSON 映射：`references/openapi-wire-profile.yaml`
-
-## 阶段 7 合同
-
-- DTO/VO 必须消费冻结 OpenAPI/no-impact record 和批准合同，写入合同允许路径。
-- POJO 样板可 `controlled-generation`；校验、权限输入、错误结构和序列化行为必须由对应 `behavior-tdd` 工作单元覆盖。
-- 必须加载合同要求的 `lombok`、`mapstruct` 和 `alibaba-java-code-style`，并按统一 `YSS Skill Execution Result` 返回文件、契约测试和偏离。

package/template/.trae/skills/yss-dto/agents/openai.yaml

@@ -1,5 +0,0 @@
-version: 1
-interface:
-  display_name: "YSS DTO"
-  short_description: "统一响应、分页查询、Command 与 DTO 设计规范"
-  default_prompt: "Use $yss-dto to define YSS-style DTOs, page queries, commands, unified response models, and their OpenAPI HTTP/JSON wire shapes."

package/template/.trae/skills/yss-dto/assets/CommandDTO.java

@@ -1,8 +0,0 @@
-package com.yss.cloud.dto;
-
-import java.io.Serializable;
-
-public abstract class CommandDTO implements Serializable {
-
-  private static final long serialVersionUID = 1L;
-}

package/template/.trae/skills/yss-dto/assets/PageQuery.java

@@ -1,133 +0,0 @@
-package com.yss.cloud.dto.page;
-
-import com.fasterxml.jackson.annotation.JsonIgnore;
-import com.yss.cloud.dto.QueryDTO;
-
-public class PageQuery extends QueryDTO {
-
-  private static final long serialVersionUID = 1L;
-
-  public static final String ASC = "ASC";
-
-  public static final String DESC = "DESC";
-
-  private static final int DEFAULT_PAGE_SIZE = 10;
-  /**
-   * 每页显示
-   * @mock 10
-   */
-  private int pageSize = DEFAULT_PAGE_SIZE;
-
-  /**
-   * 当前页
-   * @mock 1
-   */
-  private int pageIndex = 1;
-
-  /**
-   * 排序字段
-   * @mock id
-   */
-  private String orderBy;
-
-  /**
-   * 默认倒序
-   * @mock DESC
-   */
-  private String orderDirection = DESC;
-
-  /** 分组字段 */
-  private String groupBy;
-
-  /**
-   * 是否需要总数
-   * @apiNote 暂时未实现
-   * @mock true
-   */
-  @JsonIgnore
-  private boolean needTotalCount = true;
-
-  /**
-   * 总数dto临时字段，忽略即可
-   * @mock 0
-   */
-  @JsonIgnore
-  private long tempTotalCount = 0;
-
-  public int getPageIndex() {
-    return Math.max(pageIndex, 1);
-  }
-
-  public PageQuery setPageIndex(int pageIndex) {
-    this.pageIndex = pageIndex;
-    return this;
-  }
-
-  public int getPageSize() {
-    if (pageSize < 1) {
-      pageSize = DEFAULT_PAGE_SIZE;
-    }
-    return pageSize;
-  }
-
-  public PageQuery setPageSize(int pageSize) {
-    if (pageSize < 1) {
-      pageSize = DEFAULT_PAGE_SIZE;
-    }
-    this.pageSize = pageSize;
-    return this;
-  }
-
-  public int getOffset() {
-    return (getPageIndex() - 1) * getPageSize();
-  }
-
-  public String getOrderBy() {
-    return orderBy;
-  }
-
-  public PageQuery setOrderBy(String orderBy) {
-    this.orderBy = orderBy;
-    return this;
-  }
-
-  public String getOrderDirection() {
-    return orderDirection;
-  }
-
-  public PageQuery setOrderDirection(String orderDirection) {
-    if (ASC.equalsIgnoreCase(orderDirection) || DESC.equalsIgnoreCase(orderDirection)) {
-      this.orderDirection = orderDirection;
-    }
-    return this;
-  }
-
-  public long getTempTotalCount() {
-    return tempTotalCount;
-  }
-
-  public void setTempTotalCount(long tempTotalCount) {
-    this.tempTotalCount = tempTotalCount;
-  }
-
-  public String getGroupBy() {
-    return groupBy;
-  }
-
-  public void setGroupBy(String groupBy) {
-    this.groupBy = groupBy;
-  }
-
-  public boolean isNeedTotalCount() {
-    return needTotalCount;
-  }
-
-  public void setNeedTotalCount(boolean needTotalCount) {
-    this.needTotalCount = needTotalCount;
-  }
-
-  @Override
-  public String toString() {
-    return "PageQuery(" + "pageSize=" + pageSize + ", pageIndex=" + pageIndex + ')';
-  }
-}

package/template/.trae/skills/yss-dto/assets/QueryDTO.java

@@ -1,6 +0,0 @@
-package com.yss.cloud.dto;
-
-public abstract class QueryDTO extends CommandDTO {
-
-  private static final long serialVersionUID = 1L;
-}

package/template/.trae/skills/yss-dto/assets/Result.java

@@ -1,105 +0,0 @@
-package com.yss.cloud.dto.result;
-
-import java.io.Serializable;
-
-/**
- * @author zhudaoming
- */
-public class Result implements Serializable {
-
-  private static final long serialVersionUID = 2405172041950251807L;
-
-  private static final String DEFAULT_MESSAGE = "数据返回正常";
-  private static final String DEFAULT_TIPS = "信息返回正常";
-
-  /** 状态 */
-  private boolean success;
-  /** 返回数据格式 */
-  private String dataType;
-  /** 返回状态码 */
-  private Object code;
-  /** 返回消息 */
-  private String message = DEFAULT_MESSAGE;
-  /** 返回提示消息 */
-  private String tips = DEFAULT_TIPS;
-  public Object getCode() {
-    return code;
-  }
-
-  public Result setCode(Object code) {
-    this.code = code;
-    return this;
-  }
-
-  public String getMessage() {
-    return message;
-  }
-
-  public Result setMessage(String message) {
-    this.message = message;
-    return this;
-  }
-
-  public String getTips() {
-    return tips;
-  }
-
-  public void setTips(String tips) {
-    this.tips = tips;
-  }
-
-  public boolean isSuccess() {
-    return success;
-  }
-
-  public void setSuccess(boolean success) {
-    this.success = success;
-  }
-
-  public String getDataType() {
-    return dataType;
-  }
-
-  public void setDataType(String dataType) {
-    this.dataType = dataType;
-  }
-
-  public static Result buildSuccess() {
-    Result response = new Result();
-    response.setSuccess(true);
-    response.setCode("DM-A0001");
-    return response;
-  }
-
-  public static Result buildSuccess(String message) {
-    Result response = new Result();
-    response.setSuccess(true);
-    response.setMessage(message);
-    return response;
-  }
-  public static Result buildSuccess(String code,String message) {
-    Result response = new Result();
-    response.setSuccess(true);
-    response.setCode(code);
-    response.setMessage(message);
-    return response;
-  }
-  public static Result buildFailure(String message) {
-    Result response = new Result();
-    response.setSuccess(false);
-    response.setMessage(message);
-    return response;
-  }
-  public static Result buildFailure(String errCode,String message) {
-    Result response = new Result();
-    response.setSuccess(false);
-    response.setCode(errCode);
-    response.setMessage(message);
-    return response;
-  }
-  @Override
-  public String toString() {
-    return "Response [success=" + success + "]";
-  }
-
-}

package/template/.trae/skills/yss-dto/references/README.md

@@ -1,67 +0,0 @@
-# 参考资料
-
-本文档详细介绍了 `yss-component-dto` 组件的核心数据传输对象（DTO）。这些 DTO 类被广泛应用于各个服务项目，用于规范数据交互格式。公开 HTTP/JSON 的可复用映射以 `openapi-wire-profile.yaml` 为准；本文不把 Java 字段或 getter 自动等同于 wire shape。
-
-## 核心类 (Core Classes)
-
-### 1. Result.java
-
-**位置**: `../assets/Result.java`
-
-通用响应包装类，用于统一 API 接口的返回格式。
-
-**核心字段**:
-
-- `success`: 操作是否成功 (boolean)
-- `code`: Java 内部类型为 `Object`；公开 wire contract 仅允许 `string | integer | null`
-- `message`: 消息描述 (String, 默认 "数据返回正常")
-- `dataType`: 返回数据格式
-- `tips`: 提示消息
-
-**常用静态方法**:
-
-- `buildSuccess()`: 构建成功响应
-- `buildSuccess(String message)`: 构建带消息的成功响应
-- `buildFailure(String message)`: 构建失败响应
-- `buildFailure(String errCode, String message)`: 构建带错误码的失败响应
-
-### 2. PageQuery.java
-
-**位置**: `../assets/PageQuery.java`
-
-分页查询基础类，所有需要分页的查询参数都应继承此类。
-
-**核心字段**:
-
-- `pageIndex`: 当前页码 (默认 1)
-- `pageSize`: 每页条数 (默认 10)
-- `orderBy`: 排序字段
-- `orderDirection`: 排序方向 (ASC/DESC, 默认 DESC)
-- `tempTotalCount`: 临时总数字段（由分页插件回填）
-
-**功能**:
-
-- 提供了链式调用的 Setter 方法 (`setPageIndex`, `setPageSize` 等)。
-- 自动计算偏移量 `getOffset()`。
-
-## HTTP/JSON 映射边界
-
-- 新 Target Profile 只使用 `com.yss.cloud.dto.result`；`com.yss.cloud.dto.response` 为 `unsupported`，不得由新契约或脚手架引入，也不自动迁移旧项目。
-- 公共响应 schema 使用 `YssResultMeta`，具体 endpoint schema 使用 `allOf` 组合，并声明 `x-yss-response-wrapper`。
-- `MultiResult.data` 和 `PageResult.data` 为数组；`SingleResult.data` 绑定具体 endpoint schema。不要把 `SingleResult<T>`、`MultiResult<T>` 或 `PageResult<T>` 的 Java 泛型文字直接写成 OpenAPI schema。
-- `PageQuery` 的客户端字段是 `pageIndex/pageSize/orderBy/orderDirection/groupBy`；`offset`、`needTotalCount`、`tempTotalCount` 不属于客户端输入。`totalPages` 只有目标 mapper / contract evidence 证明后才进入响应契约。
-
-### 3. CommandDTO.java & QueryDTO.java
-
-**位置**: `../assets/CommandDTO.java`, `../assets/QueryDTO.java`
-
-基础 DTO 抽象类，用于区分命令（写操作）和查询（读操作）对象。
-
-- **CommandDTO**: 实现 `Serializable` 接口，所有命令参数应继承此类。
-- **QueryDTO**: 继承自 `CommandDTO`，所有查询参数应继承此类。
-
-## 使用场景
-
-1. **API 响应**: 所有 Controller 方法应返回 `Result` 或其子类（如 `PageResult`, `SingleResult`）。
-2. **分页查询**: `PageQuery` 用于 Application/Infrastructure 内部协作；公开 HTTP Page Request 默认只声明冻结 OpenAPI 允许的字段，再由 WebConvertor 转换，避免内部字段被继承到绑定面。MyBatis 拦截器所需形状必须由 Query Port 集成测试证明。
-3. **参数封装**: 使用 `CommandDTO` 封装增删改参数，使用 `QueryDTO` 封装查询参数，保持代码语义清晰。

package/template/.trae/skills/yss-dto/references/openapi-wire-profile.yaml

@@ -1,187 +0,0 @@
-schema_version: 1
-kind: yss-dto-openapi-wire-profile
-
-# This profile is the reusable mapping source consumed by the OpenAPI skills.
-# It describes the public HTTP/JSON shape, not every Java field or getter.
-canonical:
-  java_package: com.yss.cloud.dto.result
-  type_parameter:
-    name: T
-    java_bound: java.io.Serializable
-  openapi:
-    response_meta_schema: YssResultMeta
-    concrete_schema_composition: allOf
-    response_wrapper_extension: x-yss-response-wrapper
-    literal_java_generic_schema: false
-
-unsupported_packages:
-  - java_package: com.yss.cloud.dto.response
-    status: unsupported
-    use_for_new_contracts: false
-    policy: reject-in-new-contracts-no-auto-migration
-
-common_response:
-  schema_name: YssResultMeta
-  fields:
-    success:
-      direction: response
-      wire_types: [boolean]
-      nullable: false
-      required: true
-    dataType:
-      direction: response
-      wire_types: [string, "null"]
-      nullable: true
-      required: true
-    code:
-      direction: response
-      wire_types: [string, integer, "null"]
-      nullable: true
-      required: true
-      policy: do-not-widen-global-wrapper
-    message:
-      direction: response
-      wire_types: [string, "null"]
-      nullable: true
-      required: true
-    tips:
-      direction: response
-      wire_types: [string, "null"]
-      nullable: true
-      required: true
-
-wrappers:
-  SingleResult:
-    java_type: com.yss.cloud.dto.result.SingleResult<T>
-    response_kind: single
-    java_factory:
-      method: of
-      arguments: [data]
-    data:
-      direction: response
-      wire_shape: endpoint-schema-or-null
-      nullable: true
-      required: true
-  MultiResult:
-    java_type: com.yss.cloud.dto.result.MultiResult<T>
-    response_kind: non-page-list
-    data:
-      direction: response
-      wire_types: [array]
-      items: endpoint-schema
-      nullable: false
-      required: true
-      empty_value: []
-  PageResult:
-    java_type: com.yss.cloud.dto.result.PageResult<T>
-    response_kind: page
-    java_factory:
-      method: of
-      arguments: [data, totalCount, pageSize, pageIndex]
-    fields:
-      totalCount:
-        direction: response
-        wire_types: [integer]
-        format: int64
-        minimum: 0
-        nullable: false
-        required: true
-      pageSize:
-        direction: response
-        wire_types: [integer]
-        format: int32
-        minimum: 1
-        nullable: false
-        required: true
-      pageIndex:
-        direction: response
-        wire_types: [integer]
-        format: int32
-        minimum: 1
-        nullable: false
-        required: true
-      data:
-        direction: response
-        wire_types: [array]
-        items: endpoint-schema
-        nullable: false
-        required: true
-        empty_value: []
-    computed_fields:
-      totalPages:
-        java_getter: getTotalPages
-        status: mapper-dependent
-        policy: include-only-with-target-wire-evidence
-
-page_query:
-  java_type: com.yss.cloud.dto.page.PageQuery
-  request_direction: query
-  fields:
-    pageIndex:
-      direction: request
-      wire_types: [integer]
-      format: int32
-      minimum: 1
-      default: 1
-      nullable: false
-      required: false
-    pageSize:
-      direction: request
-      wire_types: [integer]
-      format: int32
-      minimum: 1
-      default: 10
-      nullable: false
-      required: false
-    orderBy:
-      direction: request
-      wire_types: [string, "null"]
-      nullable: true
-      required: false
-      policy: endpoint-whitelist-required
-    orderDirection:
-      direction: request
-      wire_types: [string]
-      enum: [ASC, DESC]
-      default: DESC
-      nullable: false
-      required: false
-    groupBy:
-      direction: request
-      wire_types: [string, "null"]
-      nullable: true
-      required: false
-      policy: endpoint-whitelist-required
-  forbidden_client_fields:
-    - offset
-    - needTotalCount
-    - tempTotalCount
-  computed_fields:
-    offset:
-      java_getter: getOffset
-      status: computed
-      policy: exclude-from-client-input
-    needTotalCount:
-      java_getter: isNeedTotalCount
-      status: internal-or-ignored
-      policy: exclude-from-client-input
-    tempTotalCount:
-      java_getter: getTempTotalCount
-      status: internal-or-ignored
-      policy: exclude-from-client-input
-
-request_bases:
-  command:
-    java_type: com.yss.cloud.dto.CommandDTO
-    direction: request
-  query:
-    java_type: com.yss.cloud.dto.QueryDTO
-    direction: request
-    extends: command
-
-wire_evidence:
-  required_before_freeze:
-    - target-http-mapper-identity
-    - representative-serialization-fixtures
-    - contract-test-or-equivalent-http-evidence
-  rule: Java fields and computed getters are not public wire facts until target-boundary evidence confirms them.

package/template/.trae/skills/yss-dto/references/source-index.md

@@ -1,55 +0,0 @@
-# yss-dto Source Index
-
-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.
-
-This file is generated by `yss-skill-source-index-refresh/scripts/refresh-yss-skill-index.mjs`. Do not hand-edit generated sections.
-
-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.
-
-## Component Path Hints
-
-- `yss-microservice-components/yss-component-dto` (existed when indexed)
-
-## Documentation Files
-
-- `yss-microservice-components/yss-component-dto/readme.md`
-
-## Maven Modules
-
-- `yss-microservice-components/yss-component-dto`
-
-## Key Java Entry Points
-
-- `yss-microservice-components/yss-component-dto/src/main/java/com/yss/cloud/SystemIdEnum.java`
-- `yss-microservice-components/yss-component-dto/src/main/java/com/yss/cloud/cache/CacheKey.java`
-- `yss-microservice-components/yss-component-dto/src/main/java/com/yss/cloud/cache/CacheKeyCode.java`
-- `yss-microservice-components/yss-component-dto/src/main/java/com/yss/cloud/cache/CacheType.java`
-- `yss-microservice-components/yss-component-dto/src/main/java/com/yss/cloud/dto/CommandDTO.java`
-- `yss-microservice-components/yss-component-dto/src/main/java/com/yss/cloud/dto/QueryDTO.java`
-- `yss-microservice-components/yss-component-dto/src/main/java/com/yss/cloud/dto/audit/message/AuditMessage.java`
-- `yss-microservice-components/yss-component-dto/src/main/java/com/yss/cloud/dto/audit/message/AuditOperationType.java`
-- `yss-microservice-components/yss-component-dto/src/main/java/com/yss/cloud/dto/audit/message/AuditResourceType.java`
-- `yss-microservice-components/yss-component-dto/src/main/java/com/yss/cloud/dto/audit/message/EventMessage.java`
-- `yss-microservice-components/yss-component-dto/src/main/java/com/yss/cloud/dto/page/PageQuery.java`
-- `yss-microservice-components/yss-component-dto/src/main/java/com/yss/cloud/dto/page/PageRequestFactory.java`
-- `yss-microservice-components/yss-component-dto/src/main/java/com/yss/cloud/dto/response/MultiResult.java`
-- `yss-microservice-components/yss-component-dto/src/main/java/com/yss/cloud/dto/response/PageResult.java`
-- `yss-microservice-components/yss-component-dto/src/main/java/com/yss/cloud/dto/response/Result.java`
-- `yss-microservice-components/yss-component-dto/src/main/java/com/yss/cloud/dto/response/SingleResult.java`
-- `yss-microservice-components/yss-component-dto/src/main/java/com/yss/cloud/dto/result/MultiResult.java`
-- `yss-microservice-components/yss-component-dto/src/main/java/com/yss/cloud/dto/result/PageResult.java`
-- `yss-microservice-components/yss-component-dto/src/main/java/com/yss/cloud/dto/result/Result.java`
-- `yss-microservice-components/yss-component-dto/src/main/java/com/yss/cloud/dto/result/SingleResult.java`
-- `yss-microservice-components/yss-component-dto/src/main/java/com/yss/cloud/dto/support/DicMapUtil.java`
-- `yss-microservice-components/yss-component-dto/src/main/java/com/yss/cloud/dto/upload/FileInfo.java`
-- `yss-microservice-components/yss-component-dto/src/main/java/com/yss/cloud/dto/user/UserInfo.java`
-- `yss-microservice-components/yss-component-dto/src/main/java/com/yss/cloud/sankuai/GenerationTypeSeq.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.