create-yss-spec 1.0.0

package/template/.codex/skills/yss-jdbc/references/README.md

@@ -0,0 +1,55 @@
+# 参考资料
+
+本文档详细介绍了 `yss-component-jdbc` 组件的核心类和配置类。该组件基于 Hutool-db 进行了封装，提供了便捷的 JDBC 操作能力。
+
+## 核心类 (Core Classes)
+
+### 1. DefaultHutoolDbHolder.java
+
+**位置**: `../assets/DefaultHutoolDbHolder.java`
+
+基于 Hutool Db 的数据源持有者。
+
+**功能**:
+
+- **初始化**: 通过 `MultiDataSourceHolder` 获取系统配置的所有数据源。
+- **获取 Db/Session**: 提供了静态方法 `getDb(dsName)` 和 `getSession(dsName)`，允许根据数据源名称快速获取 Hutool 的 `Db` 或 `Session` 对象。
+
+### 2. JdbcSqlUtil.java
+
+**位置**: `../assets/JdbcSqlUtil.java`
+
+JDBC 操作工具类，提供了更底层的数据库操作封装。
+
+**核心功能**:
+
+- **动态连接**: 支持通过 `DsParam` (包含 url, user, password, driver) 动态创建连接，不依赖 Spring 容器管理的数据源。
+- **批量插入**:
+  - `batchAddTableData`: 将 `List<Entity>` 批量插入指定表。
+  - `batchAddMapData`: 将 `List<Map<String, String>>` 批量插入指定表。
+- **参数构建**: 提供了辅助方法构建批量参数。
+
+### 3. DsParam.java
+
+**位置**: `../assets/DsParam.java`
+
+数据源参数实体类。
+
+**属性**:
+
+- `driverClass`: 驱动类名
+- `jdbc`: JDBC URL
+- `userName`: 用户名
+- `password`: 密码
+
+### 4. DefaultHutoolConfiguration.java
+
+**位置**: `../assets/DefaultHutoolConfiguration.java`
+
+Spring 配置类，负责扫描并注册组件。
+
+## 使用场景
+
+1. **多数据源操作**: 当系统配置了多数据源时，可以使用 `DefaultHutoolDbHolder` 方便地切换数据源进行 CRUD。
+2. **临时/动态连接**: 当需要连接未在配置文件中定义的数据源（如用户输入的连接信息）时，使用 `JdbcSqlUtil` 配合 `DsParam`。
+3. **批量数据处理**: 处理大量数据导入导出时，`JdbcSqlUtil` 提供了高效的批量插入方法。

package/template/.codex/skills/yss-jdbc/references/source-index.md

@@ -0,0 +1,31 @@
+# yss-jdbc Source Index
+
+Generated: 2026-06-29T16:11:14+00:00
+Indexed source root: resolved at refresh time; set `YSS_SOURCE_ROOT` to reproduce or refresh.
+
+This file is generated by `yss-source-index/scripts/refresh-yss-skill-index.py`. 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-jdbc` (existed when indexed)
+
+## Documentation Files
+
+- No component documentation files found.
+
+## Maven Modules
+
+- `yss-microservice-components/yss-component-jdbc`
+
+## Key Java Entry Points
+
+- `yss-microservice-components/yss-component-jdbc/src/main/java/com/yss/cloud/jdbc/db/DefaultHutoolConfiguration.java`
+- `yss-microservice-components/yss-component-jdbc/src/main/java/com/yss/cloud/jdbc/db/JdbcSqlUtil.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.

package/template/.codex/skills/yss-liquibase/SKILL.md

@@ -0,0 +1,47 @@
+---
+name: yss-liquibase
+description: 用于 YSS Liquibase starter、数据库变更脚本、changelog、启动迁移和 Liquibase 配置排障。
+---
+
+# yss-liquibase
+
+Use this skill for YSS Liquibase 组件. Keep implementation grounded in the local project and resolvable YSS backend component source.
+
+中文说明：本技能用于 YSS Liquibase 组件。执行时优先读取源码索引，避免凭记忆猜类名、配置项或接入方式。
+
+## Source Index First
+
+- Backend source location is environment-specific; resolve it with `yss-source-index/references/source-location.md`.
+- Generated index: `references/source-index.md`
+- Component path hints: `yss-microservice-components/yss-component-liquibase-starter`
+
+Read `references/source-index.md` as a path-hint index whenever the task depends on exact modules, annotations, auto configuration, properties, controllers, clients, repositories, DTOs, handlers, or troubleshooting.
+
+## Workflow
+
+1. Read `references/source-index.md`, then read `readme.md`; this component is mainly documentation/configuration oriented.
+2. Identify whether the task is Spring Boot Liquibase setup, changelog structure, SQL file naming, rollback, environment contexts, or migration troubleshooting.
+3. Prefer Spring Boot `spring.liquibase.*` configuration and `classpath:db/changelog/db.changelog-master.yml` style wiring.
+4. For SQL migrations, follow the repository README conventions: versioned filename, semicolon-terminated statements, lower snake-case object names, and explicit constraint/index naming.
+5. Require rollback thinking for schema changes, especially destructive DDL.
+
+## Migration Rules
+
+- Use Liquibase changesets or formatted SQL with author/id comments.
+- Keep migrations small, ordered, and environment-aware via contexts/labels where needed.
+- Store sensitive DB connection data in environment/config, not migration scripts.
+- Avoid database-specific syntax unless the target database set is explicit.
+
+## Checklist
+
+- Required dependency or starter module is present.
+- `spring.liquibase.enabled`, `contexts`, `default-schema`, `rollback-file`, and `change-log` are correct for the environment.
+- Changelog file includes new migration files in the intended order.
+- SQL files are idempotent where required and compatible with target databases.
+- Rollback or recovery plan is documented for risky changes.
+
+## Do Not
+
+- Do not invent class names or configuration keys without checking the source index.
+- Do not replace component extension points with business-local framework code.
+- Do not broaden the task into unrelated YSS components unless the user asks.

package/template/.codex/skills/yss-liquibase/agents/openai.yaml

@@ -0,0 +1,4 @@
+interface:
+  display_name: "yss-liquibase"
+  short_description: "YSS component skill for yss-liquibase"
+  default_prompt: "Use yss-liquibase for this YSS backend component task."

package/template/.codex/skills/yss-liquibase/references/source-index.md

@@ -0,0 +1,30 @@
+# yss-liquibase Source Index
+
+Generated: 2026-06-29T16:11:14+00:00
+Indexed source root: resolved at refresh time; set `YSS_SOURCE_ROOT` to reproduce or refresh.
+
+This file is generated by `yss-source-index/scripts/refresh-yss-skill-index.py`. 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-liquibase-starter` (existed when indexed)
+
+## Documentation Files
+
+- `yss-microservice-components/yss-component-liquibase-starter/readme.md`
+
+## Maven Modules
+
+- `yss-microservice-components/yss-component-liquibase-starter`
+
+## Key Java Entry Points
+
+- No key Java entry points matched the configured name patterns.
+
+## 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.

package/template/.codex/skills/yss-log/SKILL.md

@@ -0,0 +1,46 @@
+---
+name: yss-log
+description: 用于 YSS 日志 starter、日志链路、日志配置、请求日志或业务日志接入和排障。当用户提到 yss-component-log-starter、日志 starter 或日志不输出时调用。
+---
+
+# yss-log
+
+Use this skill for YSS 日志组件. Keep implementation grounded in the local project and resolvable YSS backend component source.
+
+中文说明：本技能用于 YSS 日志组件。执行时优先读取源码索引，避免凭记忆猜类名、配置项或接入方式。
+
+## Source Index First
+
+- Backend source location is environment-specific; resolve it with `yss-source-index/references/source-location.md`.
+- Generated index: `references/source-index.md`
+- Component path hints: `yss-microservice-components/yss-component-log-starter`
+
+Read `references/source-index.md` as a path-hint index whenever the task depends on exact modules, annotations, auto configuration, properties, controllers, clients, repositories, DTOs, handlers, or troubleshooting.
+
+## Workflow
+
+1. Identify whether the task is catch-and-log annotation usage, aspect behavior, auto-configuration, or centralized log collection guidance.
+2. Read `references/source-index.md`, then read `README.md` and inspect `CatchAndLog`, `CatchLogAspect`, and `CatchLogAutoConfiguration`.
+3. Use `CatchAndLog`/aspect behavior for method-level exception logging concerns; do not duplicate broad try/catch logging everywhere.
+4. For platform logging architecture, follow the README guidance around Logstash/Filebeat/ELK-style collection.
+5. Keep application logging, audit logging, and distributed tracing separate; load `yss-audit-log` for business audit events.
+
+## Capability Split
+
+- Code-level logging helper: `CatchAndLog` annotation and `CatchLogAspect`.
+- Auto-configuration: `CatchLogAutoConfiguration`.
+- Platform log collection: README guidance for Logstash/Filebeat/central storage/visualization.
+
+## Checklist
+
+- Required dependency or starter module is present.
+- Logs include enough context but avoid secrets and oversized payloads.
+- Exceptions are not swallowed unless the annotation/aspect contract explicitly says so.
+- Logback/Log4j2 output format is compatible with collection pipeline.
+- Business audit requirements are not implemented with ordinary technical logs.
+
+## Do Not
+
+- Do not invent class names or configuration keys without checking the source index.
+- Do not replace component extension points with business-local framework code.
+- Do not broaden the task into unrelated YSS components unless the user asks.

package/template/.codex/skills/yss-log/agents/openai.yaml

@@ -0,0 +1,4 @@
+interface:
+  display_name: "yss-log"
+  short_description: "YSS component skill for yss-log"
+  default_prompt: "Use yss-log for this YSS backend component task."

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

@@ -0,0 +1,32 @@
+# yss-log Source Index
+
+Generated: 2026-06-29T16:11:14+00:00
+Indexed source root: resolved at refresh time; set `YSS_SOURCE_ROOT` to reproduce or refresh.
+
+This file is generated by `yss-source-index/scripts/refresh-yss-skill-index.py`. 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-log-starter` (existed when indexed)
+
+## Documentation Files
+
+- `yss-microservice-components/yss-component-log-starter/README.md`
+
+## Maven Modules
+
+- `yss-microservice-components/yss-component-log-starter`
+
+## Key Java Entry Points
+
+- `yss-microservice-components/yss-component-log-starter/src/main/java/com/yss/cloud/log/CatchAndLog.java`
+- `yss-microservice-components/yss-component-log-starter/src/main/java/com/yss/cloud/log/CatchLogAspect.java`
+- `yss-microservice-components/yss-component-log-starter/src/main/java/com/yss/cloud/log/CatchLogAutoConfiguration.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.

package/template/.codex/skills/yss-mail/SKILL.md

@@ -0,0 +1,48 @@
+---
+name: yss-mail
+description: 用于 YSS mail starter、邮件发送、邮件配置、SMTP 集成和邮件发送失败排障。
+---
+
+# yss-mail
+
+Use this skill for YSS 邮件组件. Keep implementation grounded in the local project and resolvable YSS backend component source.
+
+中文说明：本技能用于 YSS 邮件组件。执行时优先读取源码索引，避免凭记忆猜类名、配置项或接入方式。
+
+## Source Index First
+
+- Backend source location is environment-specific; resolve it with `yss-source-index/references/source-location.md`.
+- Generated index: `references/source-index.md`
+- Component path hints: `yss-microservice-components/yss-component-mail-starter`
+
+Read `references/source-index.md` as a path-hint index whenever the task depends on exact modules, annotations, auto configuration, properties, controllers, clients, repositories, DTOs, handlers, or troubleshooting.
+
+## Workflow
+
+1. Identify whether the task is SMTP sending, attachment sending, validation, configuration, or send-failure troubleshooting.
+2. Read `references/source-index.md`, then inspect `SendMail`, `SmtpEmailRequest`, and `MailParamsConstants`.
+3. Use `SendMail.sendEmailBySmtp(SmtpEmailRequest)` for SMTP sends; it builds a JavaMail `Session`, MIME body, and optional attachments.
+4. Build requests with host, port, username, password, from, to, subject, content, `useSSL`, and optional `mapFile`.
+5. Externalize SMTP credentials and host/port; do not hardcode them in business code.
+6. Surface `MessagingException` to the caller or map it through the project's exception policy.
+
+## Source-Backed Notes
+
+- `SmtpEmailRequest` uses validation annotations for required fields.
+- Attachments are provided as `Map<String, byte[]>`.
+- The current send method sets `mail.smtp.auth=true` and controls `mail.smtp.starttls.enable` with `useSSL`.
+
+## Checklist
+
+- Required dependency or starter module is present.
+- SMTP host/port/auth/TLS settings match the mail server.
+- Passwords and SMTP tokens are externalized.
+- Attachment filenames and byte arrays are non-null.
+- Multiple recipients are formatted correctly for `InternetAddress.parse`.
+- Sensitive content is not logged.
+
+## Do Not
+
+- Do not invent class names or configuration keys without checking the source index.
+- Do not replace component extension points with business-local framework code.
+- Do not broaden the task into unrelated YSS components unless the user asks.

package/template/.codex/skills/yss-mail/agents/openai.yaml

@@ -0,0 +1,4 @@
+interface:
+  display_name: "yss-mail"
+  short_description: "YSS component skill for yss-mail"
+  default_prompt: "Use yss-mail for this YSS backend component task."

package/template/.codex/skills/yss-mail/references/source-index.md

@@ -0,0 +1,32 @@
+# yss-mail Source Index
+
+Generated: 2026-06-29T16:11:14+00:00
+Indexed source root: resolved at refresh time; set `YSS_SOURCE_ROOT` to reproduce or refresh.
+
+This file is generated by `yss-source-index/scripts/refresh-yss-skill-index.py`. 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-mail-starter` (existed when indexed)
+
+## Documentation Files
+
+- No component documentation files found.
+
+## Maven Modules
+
+- `yss-microservice-components/yss-component-mail-starter`
+
+## Key Java Entry Points
+
+- `yss-microservice-components/yss-component-mail-starter/src/main/java/com/yss/cloud/mail/MailParamsConstants.java`
+- `yss-microservice-components/yss-component-mail-starter/src/main/java/com/yss/cloud/mail/SendMail.java`
+- `yss-microservice-components/yss-component-mail-starter/src/main/java/com/yss/cloud/mail/SmtpEmailRequest.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.

package/template/.codex/skills/yss-mapper-dynamic/SKILL.md

@@ -0,0 +1,50 @@
+---
+name: yss-mapper-dynamic
+description: 用于 YSS mapper-dynamic 组件、动态 Mapper、动态 SQL 映射和 Mapper 生成/加载排障。
+---
+
+# yss-mapper-dynamic
+
+Use this skill for YSS 动态 Mapper 组件. Keep implementation grounded in the local project and resolvable YSS backend component source.
+
+中文说明：本技能用于 YSS 动态 Mapper 组件。执行时优先读取源码索引，避免凭记忆猜类名、配置项或接入方式。
+
+## Source Index First
+
+- Backend source location is environment-specific; resolve it with `yss-source-index/references/source-location.md`.
+- Generated index: `references/source-index.md`
+- Component path hints: `yss-microservice-components/yss-component-mapper-dynamic`
+
+Read `references/source-index.md` as a path-hint index whenever the task depends on exact modules, annotations, auto configuration, properties, controllers, clients, repositories, DTOs, handlers, or troubleshooting.
+
+## Workflow
+
+1. Identify whether the task is dynamic datasource creation, dynamic mapper definition, SQL execution/debugging, API generation, cache strategy, or datasource listener behavior.
+2. Read `references/source-index.md`, then inspect the relevant package: `cmd`, `config`, `constant`, `core/datasource`, `core/execute`, `domain`, or `util`.
+3. For datasource support, inspect processors for MySQL, PostgreSQL, Oracle, OceanBase, DWS PostgreSQL, and `HikariDataSourceFactory`.
+4. For query execution, inspect `DataQueryExecute`, `MybatisQuerySqlExecute`, and `DebugSqlSession`.
+5. For metadata conversion, inspect `DasConfig2MybatisConvert`, `DatasourceUtil`, and `MapperUtil`.
+6. Keep SQL, datasource credentials, and generated API exposure under explicit validation/authorization.
+
+## Capability Split
+
+- Commands: data/query/debug request models.
+- Datasource layer: processors, factory, datasource constants/enums.
+- Dynamic mapper lifecycle: events, binders, listeners.
+- Execution layer: data query and debug SQL sessions.
+- Domain model: mapper/result map/select/cache strategy/query config.
+
+## Checklist
+
+- Required dependency or starter module is present.
+- Datasource type and connection parameters are complete and protected.
+- SQL/debug execution is not exposed without authorization.
+- Mapper/result-map definitions align with returned columns.
+- Timeout/cache strategy is explicit for expensive dynamic queries.
+- Generated API request/response params match the actual SQL contract.
+
+## Do Not
+
+- Do not invent class names or configuration keys without checking the source index.
+- Do not replace component extension points with business-local framework code.
+- Do not broaden the task into unrelated YSS components unless the user asks.

package/template/.codex/skills/yss-mapper-dynamic/agents/openai.yaml

@@ -0,0 +1,4 @@
+interface:
+  display_name: "yss-mapper-dynamic"
+  short_description: "YSS component skill for yss-mapper-dynamic"
+  default_prompt: "Use yss-mapper-dynamic for this YSS backend component task."

package/template/.codex/skills/yss-mapper-dynamic/references/source-index.md

@@ -0,0 +1,75 @@
+# yss-mapper-dynamic Source Index
+
+Generated: 2026-06-29T16:11:14+00:00
+Indexed source root: resolved at refresh time; set `YSS_SOURCE_ROOT` to reproduce or refresh.
+
+This file is generated by `yss-source-index/scripts/refresh-yss-skill-index.py`. 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-mapper-dynamic` (existed when indexed)
+
+## Documentation Files
+
+- No component documentation files found.
+
+## Maven Modules
+
+- `yss-microservice-components/yss-component-mapper-dynamic`
+
+## Key Java Entry Points
+
+- `yss-microservice-components/yss-component-mapper-dynamic/src/main/java/com/yss/datamiddle/mybatis/cmd/DataParam.java`
+- `yss-microservice-components/yss-component-mapper-dynamic/src/main/java/com/yss/datamiddle/mybatis/cmd/DebugSqlCmd.java`
+- `yss-microservice-components/yss-component-mapper-dynamic/src/main/java/com/yss/datamiddle/mybatis/cmd/HttpDataParam.java`
+- `yss-microservice-components/yss-component-mapper-dynamic/src/main/java/com/yss/datamiddle/mybatis/cmd/QuerySqlDataParamModel.java`
+- `yss-microservice-components/yss-component-mapper-dynamic/src/main/java/com/yss/datamiddle/mybatis/config/MapperDynamicConfig.java`
+- `yss-microservice-components/yss-component-mapper-dynamic/src/main/java/com/yss/datamiddle/mybatis/config/MapperTimeoutConfig.java`
+- `yss-microservice-components/yss-component-mapper-dynamic/src/main/java/com/yss/datamiddle/mybatis/constant/DMDatasourceTypeEnum.java`
+- `yss-microservice-components/yss-component-mapper-dynamic/src/main/java/com/yss/datamiddle/mybatis/constant/DasQueryConstant.java`
+- `yss-microservice-components/yss-component-mapper-dynamic/src/main/java/com/yss/datamiddle/mybatis/constant/DataSourceConstants.java`
+- `yss-microservice-components/yss-component-mapper-dynamic/src/main/java/com/yss/datamiddle/mybatis/constant/DbConnectType.java`
+- `yss-microservice-components/yss-component-mapper-dynamic/src/main/java/com/yss/datamiddle/mybatis/constant/DbType.java`
+- `yss-microservice-components/yss-component-mapper-dynamic/src/main/java/com/yss/datamiddle/mybatis/constant/SyncStatusEnum.java`
+- `yss-microservice-components/yss-component-mapper-dynamic/src/main/java/com/yss/datamiddle/mybatis/core/datasource/AbstractDataSourceProcessor.java`
+- `yss-microservice-components/yss-component-mapper-dynamic/src/main/java/com/yss/datamiddle/mybatis/core/datasource/DWSPostgreSQLDataSourceProcessor.java`
+- `yss-microservice-components/yss-component-mapper-dynamic/src/main/java/com/yss/datamiddle/mybatis/core/datasource/DataSourceProcessor.java`
+- `yss-microservice-components/yss-component-mapper-dynamic/src/main/java/com/yss/datamiddle/mybatis/core/datasource/HikariDataSourceFactory.java`
+- `yss-microservice-components/yss-component-mapper-dynamic/src/main/java/com/yss/datamiddle/mybatis/core/datasource/MySQLDataSourceProcessor.java`
+- `yss-microservice-components/yss-component-mapper-dynamic/src/main/java/com/yss/datamiddle/mybatis/core/datasource/OceanbaseDataSourceProcessor.java`
+- `yss-microservice-components/yss-component-mapper-dynamic/src/main/java/com/yss/datamiddle/mybatis/core/datasource/OracleDataSourceProcessor.java`
+- `yss-microservice-components/yss-component-mapper-dynamic/src/main/java/com/yss/datamiddle/mybatis/core/datasource/PostgreSQLDataSourceProcessor.java`
+- `yss-microservice-components/yss-component-mapper-dynamic/src/main/java/com/yss/datamiddle/mybatis/core/event/MybatisDatasourceInsertBinder.java`
+- `yss-microservice-components/yss-component-mapper-dynamic/src/main/java/com/yss/datamiddle/mybatis/core/event/MybatisEvent.java`
+- `yss-microservice-components/yss-component-mapper-dynamic/src/main/java/com/yss/datamiddle/mybatis/core/event/MybatisMapperInsertBinder.java`
+- `yss-microservice-components/yss-component-mapper-dynamic/src/main/java/com/yss/datamiddle/mybatis/core/event/MybatisSessionEvent.java`
+- `yss-microservice-components/yss-component-mapper-dynamic/src/main/java/com/yss/datamiddle/mybatis/core/execute/DataQueryExecute.java`
+- `yss-microservice-components/yss-component-mapper-dynamic/src/main/java/com/yss/datamiddle/mybatis/core/execute/DebugSqlSession.java`
+- `yss-microservice-components/yss-component-mapper-dynamic/src/main/java/com/yss/datamiddle/mybatis/core/execute/MybatisQuerySqlExecute.java`
+- `yss-microservice-components/yss-component-mapper-dynamic/src/main/java/com/yss/datamiddle/mybatis/core/listener/DatasourceListener.java`
+- `yss-microservice-components/yss-component-mapper-dynamic/src/main/java/com/yss/datamiddle/mybatis/core/listener/MybatisMapperListener.java`
+- `yss-microservice-components/yss-component-mapper-dynamic/src/main/java/com/yss/datamiddle/mybatis/domain/CacheStrategy.java`
+- `yss-microservice-components/yss-component-mapper-dynamic/src/main/java/com/yss/datamiddle/mybatis/domain/DataQueryMybatis.java`
+- `yss-microservice-components/yss-component-mapper-dynamic/src/main/java/com/yss/datamiddle/mybatis/domain/Mapper.java`
+- `yss-microservice-components/yss-component-mapper-dynamic/src/main/java/com/yss/datamiddle/mybatis/domain/MapperSelect.java`
+- `yss-microservice-components/yss-component-mapper-dynamic/src/main/java/com/yss/datamiddle/mybatis/domain/ResultMap.java`
+- `yss-microservice-components/yss-component-mapper-dynamic/src/main/java/com/yss/datamiddle/mybatis/domain/SqlConditionOption.java`
+- `yss-microservice-components/yss-component-mapper-dynamic/src/main/java/com/yss/datamiddle/mybatis/domain/agg/DataQueryConfig.java`
+- `yss-microservice-components/yss-component-mapper-dynamic/src/main/java/com/yss/datamiddle/mybatis/domain/api/ApiBasicInfoRequestParam.java`
+- `yss-microservice-components/yss-component-mapper-dynamic/src/main/java/com/yss/datamiddle/mybatis/domain/api/ApiCreateRequestParam.java`
+- `yss-microservice-components/yss-component-mapper-dynamic/src/main/java/com/yss/datamiddle/mybatis/domain/api/ApiCreateResponseParam.java`
+- `yss-microservice-components/yss-component-mapper-dynamic/src/main/java/com/yss/datamiddle/mybatis/domain/api/ApiCreateSqlRequestParam.java`
+- `yss-microservice-components/yss-component-mapper-dynamic/src/main/java/com/yss/datamiddle/mybatis/domain/ds/BaseDataSourceParamDTO.java`
+- `yss-microservice-components/yss-component-mapper-dynamic/src/main/java/com/yss/datamiddle/mybatis/domain/ds/DatasourceConnectInfo.java`
+- `yss-microservice-components/yss-component-mapper-dynamic/src/main/java/com/yss/datamiddle/mybatis/domain/ds/DatasourceInfo.java`
+- `yss-microservice-components/yss-component-mapper-dynamic/src/main/java/com/yss/datamiddle/mybatis/util/DasConfig2MybatisConvert.java`
+- `yss-microservice-components/yss-component-mapper-dynamic/src/main/java/com/yss/datamiddle/mybatis/util/DatasourceUtil.java`
+- `yss-microservice-components/yss-component-mapper-dynamic/src/main/java/com/yss/datamiddle/mybatis/util/MapperUtil.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.