create-yss-spec 1.0.0

package/template/.codex/skills/yss-source-index/scripts/refresh-yss-skill-index.py

@@ -0,0 +1,380 @@
+#!/usr/bin/env python3
+from __future__ import annotations
+
+import datetime as dt
+import os
+from pathlib import Path
+
+SKILLS_ROOT = Path(os.environ.get("YSS_SKILLS_ROOT", "/Users/zhudaoming/.codex/skills")).expanduser()
+
+BACKEND_SKILLS = {
+    "yss-cache": [
+        "yss-microservice-components/yss-component-cache-parent",
+    ],
+    "yss-mybatis": [
+        "yss-microservice-components/yss-component-persistence",
+    ],
+    "yss-dto": [
+        "yss-microservice-components/yss-component-dto",
+    ],
+    "yss-audit-log": [
+        "yss-microservice-components/yss-component-audit-log",
+    ],
+    "yss-excel-mvc": [
+        "yss-microservice-components/yss-component-excel-mvc",
+        "yss-microservice-components/yss-component-excel-starter",
+    ],
+    "yss-distributed-id": [
+        "yss-microservice-components/yss-component-distributed-id",
+        "yss-microservice-components/yss-component-leaf",
+    ],
+    "yss-jdbc": [
+        "yss-microservice-components/yss-component-jdbc",
+    ],
+    "yss-dictionary": [
+        "yss-microservice-components/yss-component-dictionary-parent",
+    ],
+    "yss-dir": [
+        "yss-microservice-components/yss-component-dir-parent",
+    ],
+    "yss-file": [
+        "yss-microservice-components/yss-component-file",
+        "yss-microservice-components/yss-component-file-parser",
+        "yss-microservice-components/yss-component-filemanager-common",
+    ],
+    "yss-log": [
+        "yss-microservice-components/yss-component-log-starter",
+    ],
+    "yss-liquibase": [
+        "yss-microservice-components/yss-component-liquibase-starter",
+    ],
+    "yss-resilience4j": [
+        "yss-microservice-components/yss-component-resilience4j-starter",
+    ],
+    "yss-sql-condition": [
+        "yss-microservice-components/yss-component-sql-condition",
+    ],
+    "yss-sql-tpl": [
+        "yss-microservice-components/yss-component-sql-tpl-parent",
+    ],
+    "yss-taskflow": [
+        "yss-microservice-components/yss-component-taskflow",
+    ],
+    "yss-validation": [
+        "yss-microservice-components/yss-component-validation-engine-parent",
+        "yss-microservice-components/yss-component-validation-jsr303",
+    ],
+    "yss-security-algorithm": [
+        "yss-microservice-components/yss-component-security-algorithm",
+    ],
+    "yss-userinfo": [
+        "yss-microservice-components/yss-component-userinfo-starter",
+    ],
+    "yss-variable": [
+        "yss-microservice-components/yss-component-variable",
+    ],
+    "yss-quality": [
+        "yss-microservice-components/yss-component-quality-starter",
+    ],
+    "yss-anti-scheduler": [
+        "yss-microservice-components/yss-component-anti-corrosion/yss-component-anti-scheduler",
+    ],
+    "yss-exception": [
+        "yss-microservice-components/yss-component-exception",
+    ],
+    "yss-mail": [
+        "yss-microservice-components/yss-component-mail-starter",
+    ],
+    "yss-filerunner": [
+        "yss-microservice-components/yss-component-filerunner-parent",
+    ],
+    "yss-valuation": [
+        "yss-microservice-components/yss-component-valuation",
+    ],
+    "yss-duckdb": [
+        "yss-microservice-components/yss-component-duckdb",
+    ],
+    "yss-mapper-dynamic": [
+        "yss-microservice-components/yss-component-mapper-dynamic",
+    ],
+}
+
+FRONTEND_DOCS = {
+    "components": "http://192.168.164.27:3200/components",
+    "hooks": "http://192.168.164.27:3200/hooks",
+    "skills": "http://192.168.164.27:3200/skills",
+}
+
+FRONTEND_SKILLS = {
+    "yss-ui": ["components", "hooks", "skills"],
+    "yss-components": ["components"],
+    "yss-hook": ["hooks"],
+    "yss-page-module-development": ["components", "hooks", "skills"],
+    "yss-use-table-height": ["hooks"],
+    "yss-use-tree-height": ["hooks"],
+}
+
+KEY_NAME_PARTS = (
+    "Audit",
+    "Cache",
+    "Clear",
+    "Command",
+    "Configuration",
+    "Controller",
+    "DTO",
+    "Data",
+    "Enable",
+    "Excel",
+    "Handler",
+    "Interceptor",
+    "Jdbc",
+    "Mapper",
+    "Mybatis",
+    "Page",
+    "Properties",
+    "Query",
+    "Repository",
+    "Request",
+    "Response",
+    "Result",
+    "Update",
+    "Aspect",
+    "Leaf",
+    "Id",
+    "Dir",
+    "Dic",
+    "Dictionary",
+    "File",
+    "Upload",
+    "Log",
+    "Message",
+    "Mail",
+    "Liquibase",
+    "Circuit",
+    "Breaker",
+    "Sql",
+    "Tpl",
+    "Tag",
+    "Task",
+    "Flow",
+    "Report",
+    "Validation",
+    "Validator",
+    "Security",
+    "Crypto",
+    "User",
+    "Variable",
+    "Quality",
+    "Search",
+    "Similarity",
+    "Scheduler",
+    "Runner",
+    "Duck",
+    "Dynamic",
+    "Factory",
+    "Client",
+    "Feign",
+    "Gateway",
+    "Convertor",
+    "Adapter",
+    "Bridge",
+    "Route",
+    "Uploader",
+    "Sftp",
+    "Minio",
+    "Parser",
+    "Express",
+    "Rule",
+    "Template",
+    "Generator",
+    "Importer",
+    "Engine",
+    "Event",
+    "Submitter",
+    "Executor",
+    "Context",
+    "Status",
+    "Type",
+    "State",
+)
+
+DOC_NAMES = {"README.md", "readme.md", "HELP.md", "TECHNICAL_DESIGN.md"}
+
+
+def has_component_root(path: Path) -> bool:
+    return (path / "yss-microservice-components").is_dir()
+
+
+def source_root_candidates() -> list[Path]:
+    cwd = Path.cwd().resolve()
+    home = Path.home()
+    candidates: list[Path] = [cwd, *cwd.parents]
+    candidates.extend(
+        [
+            home / "Documents/yss-project/yss-cloud-microservice",
+            home / "Documents/yss-project",
+            home / "Projects/yss-cloud-microservice",
+            home / "Projects",
+        ]
+    )
+    for base in [home / "Projects", home / "Documents", home / "Documents/yss-project"]:
+        if base.is_dir():
+            candidates.extend(path for path in base.glob("*") if path.is_dir())
+    return candidates
+
+
+def resolve_source_root() -> Path:
+    explicit = os.environ.get("YSS_SOURCE_ROOT")
+    if explicit:
+        root = Path(explicit).expanduser().resolve()
+        if not has_component_root(root):
+            raise SystemExit(
+                "YSS_SOURCE_ROOT must point to the repository root containing "
+                f"`yss-microservice-components`: {root}"
+            )
+        return root
+
+    for candidate in source_root_candidates():
+        candidate = candidate.expanduser().resolve()
+        if has_component_root(candidate):
+            return candidate
+
+    raise SystemExit(
+        "Could not find a YSS source repository containing `yss-microservice-components`. "
+        "Set YSS_SOURCE_ROOT=/absolute/path/to/yss-cloud-microservice and rerun."
+    )
+
+
+SOURCE_ROOT = resolve_source_root()
+
+
+def rel(path: Path) -> str:
+    try:
+        return str(path.relative_to(SOURCE_ROOT))
+    except ValueError:
+        return str(path)
+
+
+def collect_files(paths: list[Path]) -> dict[str, list[Path]]:
+    docs: list[Path] = []
+    poms: list[Path] = []
+    java: list[Path] = []
+    for base in paths:
+        if not base.exists():
+            continue
+        for path in base.rglob("*"):
+            if not path.is_file():
+                continue
+            if path.name in DOC_NAMES:
+                docs.append(path)
+            elif path.name == "pom.xml":
+                poms.append(path)
+            elif path.suffix == ".java" and "/src/main/java/" in str(path):
+                java.append(path)
+    return {
+        "docs": sorted(docs),
+        "poms": sorted(poms),
+        "java": sorted(java),
+    }
+
+
+def interesting_java(paths: list[Path]) -> list[Path]:
+    selected = []
+    for path in paths:
+        name = path.stem
+        if any(part in name for part in KEY_NAME_PARTS):
+            selected.append(path)
+    return selected[:120]
+
+
+def write_backend_index(skill: str, subpaths: list[str], generated_at: str) -> None:
+    bases = [SOURCE_ROOT / subpath for subpath in subpaths]
+    files = collect_files(bases)
+    selected_java = interesting_java(files["java"])
+    target_dir = SKILLS_ROOT / skill / "references"
+    target_dir.mkdir(parents=True, exist_ok=True)
+    target = target_dir / "source-index.md"
+
+    lines = [
+        f"# {skill} Source Index",
+        "",
+        f"Generated: {generated_at}",
+        "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",
+        "",
+    ]
+    for base in bases:
+        status = "existed when indexed" if base.exists() else "missing when indexed"
+        lines.append(f"- `{rel(base)}` ({status})")
+
+    lines += ["", "## Documentation Files", ""]
+    if files["docs"]:
+        lines.extend(f"- `{rel(path)}`" for path in files["docs"])
+    else:
+        lines.append("- No component documentation files found.")
+
+    lines += ["", "## Maven Modules", ""]
+    if files["poms"]:
+        lines.extend(f"- `{rel(path.parent)}`" for path in files["poms"])
+    else:
+        lines.append("- No Maven modules found.")
+
+    lines += ["", "## Key Java Entry Points", ""]
+    if selected_java:
+        lines.extend(f"- `{rel(path)}`" for path in selected_java)
+    else:
+        lines.append("- No key Java entry points matched the configured name patterns.")
+
+    lines += [
+        "",
+        "## 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.",
+        "",
+    ]
+    target.write_text("\n".join(lines), encoding="utf-8")
+
+
+def write_frontend_docs(skill: str, doc_keys: list[str], generated_at: str) -> None:
+    target_dir = SKILLS_ROOT / skill / "references"
+    if not (SKILLS_ROOT / skill).exists():
+        return
+    target_dir.mkdir(parents=True, exist_ok=True)
+    target = target_dir / "frontend-docs.md"
+    lines = [
+        f"# {skill} Frontend Documentation",
+        "",
+        f"Generated: {generated_at}",
+        "",
+        "Use these YSS UI documentation entry points as authoritative references when local repo examples are insufficient.",
+        "",
+    ]
+    for key in doc_keys:
+        lines.append(f"- {key}: {FRONTEND_DOCS[key]}")
+    lines += [
+        "",
+        "When documentation and local code differ, inspect the current project code before editing and prefer established local usage.",
+        "",
+    ]
+    target.write_text("\n".join(lines), encoding="utf-8")
+
+
+def main() -> int:
+    generated_at = dt.datetime.now(dt.timezone.utc).isoformat(timespec="seconds")
+    for skill, subpaths in BACKEND_SKILLS.items():
+        write_backend_index(skill, subpaths, generated_at)
+    for skill, doc_keys in FRONTEND_SKILLS.items():
+        write_frontend_docs(skill, doc_keys, generated_at)
+    print(f"Updated {len(BACKEND_SKILLS)} backend indexes and {len(FRONTEND_SKILLS)} frontend doc references.")
+    return 0
+
+
+if __name__ == "__main__":
+    raise SystemExit(main())

package/template/.codex/skills/yss-sql-condition/SKILL.md

@@ -0,0 +1,58 @@
+---
+name: yss-sql-condition
+description: 用于 YSS SQL condition 组件、SqlTranspiler、CaseWhenSqlGenerator、SqlTemplateRenderer、SqlValidator、动态 SQL 条件生成和 SQL 校验排障。
+---
+
+# yss-sql-condition
+
+Use this skill for YSS SQL 条件组件. Keep implementation grounded in the local project and resolvable YSS backend component source.
+
+中文说明：本技能用于 YSS SQL 条件组件。执行时优先读取源码索引，避免凭记忆猜类名、配置项或接入方式。
+
+## 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-sql-condition`
+
+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 the component `README.md` before changing behavior.
+2. Identify whether the task is rule import, DSL-to-SQL conversion, CASE WHEN generation, SQL template rendering, or SQL validation.
+3. Use `RuleConfig` / `RuleConfigImporter` for Excel/CSV rule configuration instead of inventing a new config format.
+4. Use `SqlTranspiler` for simple expression conversion (`&&`, `||`, `==`, `!=`, null checks, quoted strings).
+5. Use `CaseWhenSqlGenerator` when the desired output is a SQL `CASE WHEN` fragment by rule code and priority.
+6. Use `SqlTemplateRenderer` for template placeholder replacement, then `SqlValidator` to parse-check the final SQL.
+7. Treat generated SQL as code: validate before execution and keep raw user input out of unchecked templates.
+
+## Capability Split
+
+- Rule storage/import: `RuleConfig`, `RuleConfigImporter`, `rule_config.sql`.
+- Expression conversion: `SqlTranspiler` / QLExpress-to-SQL style conversion.
+- CASE WHEN generation: `CaseWhenSqlGenerator`.
+- Template assembly: `SqlTemplateRenderer`.
+- Syntax validation: `SqlValidator` with JSqlParser.
+
+## SQL Safety Notes
+
+- Empty expressions may become broad conditions such as `1=1`; confirm this is intended.
+- Null comparisons should become `IS NULL` / `IS NOT NULL`, not `= null`.
+- Rendered SQL should be parsed by `SqlValidator` before use in ETL/batch jobs.
+- Keep rule priority explicit because first matching `CASE WHEN` branches change output semantics.
+
+## Checklist
+
+- Required dependency or starter module is present.
+- Rule code, rule priority, enabled flag, result value, and default ELSE value are defined.
+- Rule import validates required fields before persisting.
+- Generated SQL fragment has an alias only when the caller expects one.
+- Template placeholders are controlled by the application, not raw external input.
+- SQL validation failures are surfaced with the parser error message.
+
+## 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-sql-condition/agents/openai.yaml

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

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

@@ -0,0 +1,35 @@
+# yss-sql-condition 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-sql-condition` (existed when indexed)
+
+## Documentation Files
+
+- `yss-microservice-components/yss-component-sql-condition/README.md`
+
+## Maven Modules
+
+- `yss-microservice-components/yss-component-sql-condition`
+
+## Key Java Entry Points
+
+- `yss-microservice-components/yss-component-sql-condition/src/main/java/com/yss/cloud/component/sqlcondition/CaseWhenSqlGenerator.java`
+- `yss-microservice-components/yss-component-sql-condition/src/main/java/com/yss/cloud/component/sqlcondition/RuleConfig.java`
+- `yss-microservice-components/yss-component-sql-condition/src/main/java/com/yss/cloud/component/sqlcondition/RuleConfigImporter.java`
+- `yss-microservice-components/yss-component-sql-condition/src/main/java/com/yss/cloud/component/sqlcondition/SqlTemplateRenderer.java`
+- `yss-microservice-components/yss-component-sql-condition/src/main/java/com/yss/cloud/component/sqlcondition/SqlTranspiler.java`
+- `yss-microservice-components/yss-component-sql-condition/src/main/java/com/yss/cloud/component/sqlcondition/SqlValidator.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-sql-tpl/SKILL.md

@@ -0,0 +1,49 @@
+---
+name: yss-sql-tpl
+description: 用于 YSS SQL 模板管理、EnableSqlTplManage、SqlTplConfig、SqlTplResource、SQL 模板 Repository/Gateway/Feign 接入和排障。
+---
+
+# yss-sql-tpl
+
+Use this skill for YSS SQL 模板组件. Keep implementation grounded in the local project and resolvable YSS backend component source.
+
+中文说明：本技能用于 YSS SQL 模板组件。执行时优先读取源码索引，避免凭记忆猜类名、配置项或接入方式。
+
+## 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-sql-tpl-parent`
+
+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 SQL template management, resource binding, history/rollback, cache behavior, starter enablement, or repository persistence.
+2. Read `references/source-index.md`, then inspect client/core/repository/starter according to the task.
+3. For API behavior, start with `SqlTemplateConfigController`, `SqlTemplateConfigService`, and `SqlTemplateResourceService`.
+4. For persistence, use `SqlTplConfigGateway`, `SqlTplResourceGateway`, repository implementations, entities, and convertors.
+5. For integration enablement, check `EnableSqlTplManage`, `DefaultSqlTplConfiguration`, and `DefaultSqlTplProperties`.
+6. For contracts, reuse `SqlTplConfigAddCmd`, update/delete/rollback commands, page queries, VO classes, and enums.
+
+## Capability Split
+
+- `client`: commands, page queries, VO contracts, cache/datasource/typehandler enums.
+- `core`: controller, domain model, service, gateway contracts.
+- `repository`: MyBatis config, entities, repositories, convertors, gateway implementations.
+- `yss-component-sql-tpl-starter`: enable annotation and default configuration/properties.
+
+## Checklist
+
+- Required dependency or starter module is present.
+- SQL template and SQL resource are modeled separately.
+- History/rollback behavior is preserved when updating templates.
+- Cache type and datasource type match the deployment.
+- Type handler choices are explicit for parameter/result mapping.
+- Raw SQL text changes consider validation, audit, and rollback requirements.
+
+## 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-sql-tpl/agents/openai.yaml

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

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

@@ -0,0 +1,75 @@
+# yss-sql-tpl 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-sql-tpl-parent` (existed when indexed)
+
+## Documentation Files
+
+- No component documentation files found.
+
+## Maven Modules
+
+- `yss-microservice-components/yss-component-sql-tpl-parent/client`
+- `yss-microservice-components/yss-component-sql-tpl-parent/core`
+- `yss-microservice-components/yss-component-sql-tpl-parent`
+- `yss-microservice-components/yss-component-sql-tpl-parent/repository`
+- `yss-microservice-components/yss-component-sql-tpl-parent/yss-component-sql-tpl-starter`
+
+## Key Java Entry Points
+
+- `yss-microservice-components/yss-component-sql-tpl-parent/client/src/main/java/com/yss/cloud/sql/tpl/dto/cmd/SqlTplConfigAddCmd.java`
+- `yss-microservice-components/yss-component-sql-tpl-parent/client/src/main/java/com/yss/cloud/sql/tpl/dto/cmd/SqlTplConfigDelBatchCmd.java`
+- `yss-microservice-components/yss-component-sql-tpl-parent/client/src/main/java/com/yss/cloud/sql/tpl/dto/cmd/SqlTplConfigRebackCmd.java`
+- `yss-microservice-components/yss-component-sql-tpl-parent/client/src/main/java/com/yss/cloud/sql/tpl/dto/cmd/SqlTplConfigUpdateCmd.java`
+- `yss-microservice-components/yss-component-sql-tpl-parent/client/src/main/java/com/yss/cloud/sql/tpl/dto/cmd/SqlTplResourceAddCmd.java`
+- `yss-microservice-components/yss-component-sql-tpl-parent/client/src/main/java/com/yss/cloud/sql/tpl/dto/query/SqlTplConfigPageQuery.java`
+- `yss-microservice-components/yss-component-sql-tpl-parent/client/src/main/java/com/yss/cloud/sql/tpl/dto/query/SqlTplHistoryPageQuery.java`
+- `yss-microservice-components/yss-component-sql-tpl-parent/client/src/main/java/com/yss/cloud/sql/tpl/enums/CacheTypeEnum.java`
+- `yss-microservice-components/yss-component-sql-tpl-parent/client/src/main/java/com/yss/cloud/sql/tpl/enums/DatasourceTypeEnum.java`
+- `yss-microservice-components/yss-component-sql-tpl-parent/client/src/main/java/com/yss/cloud/sql/tpl/typehandler/TypeHandlerEnum.java`
+- `yss-microservice-components/yss-component-sql-tpl-parent/client/src/main/java/com/yss/cloud/sql/tpl/vo/SqlParamVO.java`
+- `yss-microservice-components/yss-component-sql-tpl-parent/client/src/main/java/com/yss/cloud/sql/tpl/vo/SqlRespFieldVO.java`
+- `yss-microservice-components/yss-component-sql-tpl-parent/client/src/main/java/com/yss/cloud/sql/tpl/vo/SqlTplConfigSimpleHisVO.java`
+- `yss-microservice-components/yss-component-sql-tpl-parent/client/src/main/java/com/yss/cloud/sql/tpl/vo/SqlTplConfigSimpleVO.java`
+- `yss-microservice-components/yss-component-sql-tpl-parent/client/src/main/java/com/yss/cloud/sql/tpl/vo/SqlTplConfigVO.java`
+- `yss-microservice-components/yss-component-sql-tpl-parent/core/src/main/java/com/yss/cloud/sql/tpl/config/SqlTplServiceNameProperties.java`
+- `yss-microservice-components/yss-component-sql-tpl-parent/core/src/main/java/com/yss/cloud/sql/tpl/controller/SqlTemplateConfigController.java`
+- `yss-microservice-components/yss-component-sql-tpl-parent/core/src/main/java/com/yss/cloud/sql/tpl/convertor/SqlTplConfigConvertor.java`
+- `yss-microservice-components/yss-component-sql-tpl-parent/core/src/main/java/com/yss/cloud/sql/tpl/domain/SqlTplConfig.java`
+- `yss-microservice-components/yss-component-sql-tpl-parent/core/src/main/java/com/yss/cloud/sql/tpl/domain/SqlTplResource.java`
+- `yss-microservice-components/yss-component-sql-tpl-parent/core/src/main/java/com/yss/cloud/sql/tpl/gateway/SqlTplConfigGateway.java`
+- `yss-microservice-components/yss-component-sql-tpl-parent/core/src/main/java/com/yss/cloud/sql/tpl/gateway/SqlTplResourceGateway.java`
+- `yss-microservice-components/yss-component-sql-tpl-parent/core/src/main/java/com/yss/cloud/sql/tpl/service/SqlTemplateConfigService.java`
+- `yss-microservice-components/yss-component-sql-tpl-parent/core/src/main/java/com/yss/cloud/sql/tpl/service/SqlTemplateResourceService.java`
+- `yss-microservice-components/yss-component-sql-tpl-parent/core/src/main/java/com/yss/cloud/sql/tpl/service/impl/SqlTemplateConfigServiceImpl.java`
+- `yss-microservice-components/yss-component-sql-tpl-parent/core/src/main/java/com/yss/cloud/sql/tpl/service/impl/SqlTemplateResourceServiceImpl.java`
+- `yss-microservice-components/yss-component-sql-tpl-parent/repository/src/main/java/com/yss/cloud/sql/tpl/config/MybatisSqlTplConfiguration.java`
+- `yss-microservice-components/yss-component-sql-tpl-parent/repository/src/main/java/com/yss/cloud/sql/tpl/convertor/Audit2AddMapping.java`
+- `yss-microservice-components/yss-component-sql-tpl-parent/repository/src/main/java/com/yss/cloud/sql/tpl/convertor/Audit2EditMapping.java`
+- `yss-microservice-components/yss-component-sql-tpl-parent/repository/src/main/java/com/yss/cloud/sql/tpl/convertor/SqlTplConfigEitityConvertor.java`
+- `yss-microservice-components/yss-component-sql-tpl-parent/repository/src/main/java/com/yss/cloud/sql/tpl/convertor/SqlTplResourceEitityConvertor.java`
+- `yss-microservice-components/yss-component-sql-tpl-parent/repository/src/main/java/com/yss/cloud/sql/tpl/entity/AuditableEntity.java`
+- `yss-microservice-components/yss-component-sql-tpl-parent/repository/src/main/java/com/yss/cloud/sql/tpl/entity/SqlTplConfigEntity.java`
+- `yss-microservice-components/yss-component-sql-tpl-parent/repository/src/main/java/com/yss/cloud/sql/tpl/entity/SqlTplResourceEntity.java`
+- `yss-microservice-components/yss-component-sql-tpl-parent/repository/src/main/java/com/yss/cloud/sql/tpl/gateway/impl/SqlTplConfigGatewayImpl.java`
+- `yss-microservice-components/yss-component-sql-tpl-parent/repository/src/main/java/com/yss/cloud/sql/tpl/gateway/impl/SqlTplResourceGatewayImpl.java`
+- `yss-microservice-components/yss-component-sql-tpl-parent/repository/src/main/java/com/yss/cloud/sql/tpl/repository/SqlTplConfigRepository.java`
+- `yss-microservice-components/yss-component-sql-tpl-parent/repository/src/main/java/com/yss/cloud/sql/tpl/repository/SqlTplResourceRepository.java`
+- `yss-microservice-components/yss-component-sql-tpl-parent/yss-component-sql-tpl-starter/src/main/java/com/yss/cloud/sql/tpl/EnableSqlTplManage.java`
+- `yss-microservice-components/yss-component-sql-tpl-parent/yss-component-sql-tpl-starter/src/main/java/com/yss/cloud/sql/tpl/EnableSqlTplManageImportSelector.java`
+- `yss-microservice-components/yss-component-sql-tpl-parent/yss-component-sql-tpl-starter/src/main/java/com/yss/cloud/sql/tpl/config/DefaultSqlTplConfiguration.java`
+- `yss-microservice-components/yss-component-sql-tpl-parent/yss-component-sql-tpl-starter/src/main/java/com/yss/cloud/sql/tpl/config/DefaultSqlTplProperties.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.