create-yss-spec 3.3.1 → 3.3.4

package/template/.qoder/skills/yss-mvc-data-analysis-project-initializer/scripts/generate_project.mjs

@@ -1,77 +0,0 @@
-#!/usr/bin/env node
-import { createHash } from "node:crypto";
-import { spawnSync } from "node:child_process";
-import { cp, lstat, mkdir, mkdtemp, readFile, rename, rm, writeFile } from "node:fs/promises";
-import path from "node:path";
-import { fileURLToPath } from "node:url";
-import { generate, parseArgs } from "../../yss-layered-mvc-scaffold-generator/scripts/generate_scaffold.mjs";
-
-const root = path.resolve(path.dirname(fileURLToPath(import.meta.url)), "../../../..");
-const skillId = "yss-mvc-data-analysis-project-initializer";
-const digest = (value) => `sha256:${createHash("sha256").update(value).digest("hex")}`;
-async function present(target) { try { await lstat(target); return true; } catch (error) { if (error.code === "ENOENT") return false; throw error; } }
-async function put(target, text) { await mkdir(path.dirname(target), { recursive: true }); await writeFile(target, `${text.trimEnd()}\n`); }
-function within(parent, target) { const relative = path.relative(parent, target); return relative === "" || (!relative.startsWith("..") && !path.isAbsolute(relative)); }
-
-async function sharedTools(outputDir, contract) {
-  const destination = path.join(outputDir, "skillUtils");
-  if (!contract.allowed_write_paths.some((item) => within(path.resolve(outputDir, item), destination))) throw new Error("skillUtils 不在批准写范围内");
-  const lock = await readFile(path.join(root, "skills-lock.json"));
-  if (await present(destination)) {
-    if (!await present(path.join(destination, "skill-utils.yaml")) || !lock.equals(await readFile(path.join(destination, "skills-lock.json")))) throw new Error("已有 skillUtils 不匹配；须独立批准刷新，初始化不会覆盖");
-    return digest(lock);
-  }
-  const staging = await mkdtemp(path.join(outputDir, ".skillUtils.staging-"));
-  try {
-    for (const relative of [".agents/skills", ".codex/skills", ".claude/skills", ".cursor/skills", ".pi/skills", ".qoder/skills", ".trae/skills", "scripts", "docs/agents", "docs/process", "AGENTS.md", "skills-lock.json"]) {
-      await mkdir(path.dirname(path.join(staging, relative)), { recursive: true });
-      await cp(path.join(root, relative), path.join(staging, relative), { recursive: true });
-    }
-    await put(path.join(staging, "skill-utils.yaml"), "schema_version: 1\nkind: yss-skill-utils\ncompatibility: skill-utils-v1\ncanonical_root: .agents/skills");
-    await rename(staging, destination);
-  } catch (error) { await rm(staging, { recursive: true, force: true }); throw error; }
-  return digest(lock);
-}
-
-export async function initialize(options) {
-  // Shared generation validates approval, decision, target and write scope before invoking this callback.
-  return generate(options, { skillId, architectureProfile: "mvc-data-analysis-v1", finalize: async ({ projectRoot, contract, architectureIdentity }) => {
-    if (!contract.context_handoff_ref || !contract.context_handoff_digest) throw new Error("缺少批准的 context_handoff_ref/context_handoff_digest");
-    const handoffPath = path.resolve(path.dirname(path.resolve(options.contractFile)), contract.context_handoff_ref);
-    const context = await readFile(handoffPath);
-    if (digest(context) !== contract.context_handoff_digest || !/^---\r?\ncontext_schema_version: 1\r?\n---/m.test(context.toString())) throw new Error("CONTEXT handoff schema/digest 不匹配");
-    if (spawnSync("git", ["--version"]).status !== 0) throw new Error("Git 不可用");
-    for (const relative of ["docs/agents", "docs/process", "docs/templates", "docs/architecture/templates"]) {
-      await mkdir(path.dirname(path.join(projectRoot, relative)), { recursive: true });
-      await cp(path.join(root, relative), path.join(projectRoot, relative), { recursive: true });
-    }
-    await put(path.join(projectRoot, "CONTEXT.md"), context.toString());
-    const agents = (await readFile(path.join(root, "AGENTS.md"), "utf8"))
-      .replace(/## 4\. `template-source` 模板维护路由[\s\S]*?(?=## 5\.)/, "## 4. 模板维护\n\n本仓为 project-instance；模板维护回上游执行。\n\n")
-      .replaceAll(".agents/skills", "../skillUtils/.agents/skills");
-    await put(path.join(projectRoot, "AGENTS.md"), agents);
-    await put(path.join(projectRoot, "yss-project.yaml"), "schema_version: 1\nrepository_mode: project-instance");
-    await put(path.join(projectRoot, ".artifact-workspace.yaml"), `schema_version: 1\nkind: service\nservice_id: ${options.projectName}`);
-    await cp(path.join(root, "scripts/lib"), path.join(projectRoot, "scripts/lib"), { recursive: true });
-    await cp(path.join(root, "scripts/vendor"), path.join(projectRoot, "scripts/vendor"), { recursive: true });
-    for (const name of ["repository-mode", "implementation-path-policy", "repository-scope-policy", "generate-lifecycle-artifacts", "node-generate-lifecycle-artifacts.mjs", "verify-lifecycle-registry", "node-verify-lifecycle-registry.mjs", "verify-lifecycle-checkpoint", "verify-context-reconciliation", "verify-approval-record", "verify-user-decision", "verify-digital-human-task-package", "verify-yss-dto-openapi-profile", "verify-frontend-implementation-evidence"]) {
-      await cp(path.join(root, "scripts", name), path.join(projectRoot, "scripts", name));
-    }
-    const lockDigest = await sharedTools(path.resolve(options.outputDir), contract);
-    await put(path.join(projectRoot, "skills-lock.json"), JSON.stringify({ version: 1, distribution: { mode: "sibling-directory", skillUtilsDir: "../skillUtils", required: true, compatibility: "skill-utils-v1", lock_digest: lockDigest } }, null, 2));
-    await put(path.join(projectRoot, "docs/process/engineering-baseline.json"), JSON.stringify({ schema_version: 1, architecture_identity: architectureIdentity, platform_profile: contract.profiles.platform, scaffold_completion: "generated" }, null, 2));
-    await put(path.join(projectRoot, "docs/process/implementation-repo-registry.yaml"), JSON.stringify({ schema_version: 1, projects: [{ project_type: "backend", project_name: options.projectName, project_root: ".", git_root: ".", repository_scope: "external-repository", scaffold_status: "initialized", default_branch: "main", architecture_identity: architectureIdentity, allowed_write_paths: ["."], verification_commands: contract.verification_commands, expected_evidence_files: contract.expected_evidence_files, ci: "not-configured", rollback_point: "initial-empty-repository" }] }, null, 2));
-    await put(path.join(projectRoot, "docs/process/service-initialization.json"), JSON.stringify({ work_unit: "work-unit.service-project-initialization", context_handoff_ref: contract.context_handoff_ref, context_handoff_digest: contract.context_handoff_digest, contract_id: contract.contract_id, architecture_identity: architectureIdentity, status: "generated" }, null, 2));
-    await put(path.join(projectRoot, ".gitignore"), "target/\n**/target/\n.idea/\n*.iml\n.env\n.env.*\n.local/");
-    const git = spawnSync("git", ["init", "--initial-branch=main"], { cwd: projectRoot, encoding: "utf8" });
-    if (git.status !== 0) throw new Error(`Git 初始化失败: ${git.stderr}`);
-  } });
-}
-
-if (process.argv[1] === fileURLToPath(import.meta.url)) {
-  try {
-    const options = parseArgs(process.argv.slice(2));
-    if (options.help) process.stdout.write("使用批准的 MVC schema v3 合同与 Maven 坐标参数；输出独立数据分析项目，无数据库/Mock 选项。\n");
-    else await initialize(options);
-  } catch (error) { process.stderr.write(`数据分析项目初始化失败: ${error.message}\n`); process.exitCode = 1; }
-}

package/template/.qoder/skills/yss-mvc-data-analysis-project-initializer/scripts/run_scaffold_verification.mjs

@@ -1,9 +0,0 @@
-#!/usr/bin/env node
-import { run } from "../../yss-ddd-scaffold-generator/scripts/run_scaffold_verification.mjs";
-try {
-  const [projectRoot, evidenceDir] = process.argv.slice(2);
-  if (!projectRoot || !evidenceDir) throw new Error("用法: run_scaffold_verification.mjs <project-root> <evidence-dir>");
-  const report = await run(projectRoot, evidenceDir);
-  process.stdout.write(`${JSON.stringify(report, null, 2)}\n`);
-  process.exitCode = report.status === "passed" ? 0 : 1;
-} catch (error) { process.stderr.write(`${error.message}\n`); process.exitCode = 1; }

package/template/.qoder/skills/yss-mvc-design/SKILL.md

@@ -1,16 +0,0 @@
----
-name: yss-mvc-design
-description: 为已确认 layered-mvc 的 YSS 项目设计分层职责、用例、业务规则、事务和持久化映射，不生成代码。
----
-
-# YSS MVC 技术设计
-
-由 `yss-technical-design` 在 `layered-mvc` 分支调用，输入和批准边界由通用技术设计合同持有。既有工程按已登记 Profile 设计，不重选架构。
-
-必须说明模块职责与依赖方向、用例流程、业务规则、状态转换、事务边界、失败回滚、幂等与并发、持久化映射、外部集成与公开测试 seam。无状态流转或外部集成时记录有原因的不适用，不硬造对象。
-
-分层边界消费 `docs/agents/backend-architecture-profiles.md`：Controller 处理 HTTP 边界；service/core 承载用例、规则与事务；Repository 负责持久化；适用时 Adapter 承接外部集成。不得为 MVC 加载 `yss-domain` 或生成 DDD Gateway。
-
-输出 Technical Design Contract 的 `design` 分支，结构见 `references/mvc-design.schema.json`。业务规则和关键场景必须关联具体用例与测试 seam；关键场景覆盖成功和失败。与 DDD 使用同一承接和审查要求，不能因采用 MVC 省略规则、一致性或测试设计。
-
-由通用入口校验整个合同并回交生命周期独立审查。本技能不自行批准、不创建 Ticket、不设置 `ready-for-agent`，不生成 Java、SQL 或生产 API。实现由编译器按批准的架构 Profile 和最小技能闭包路由。

package/template/.qoder/skills/yss-mvc-design/agents/openai.yaml

@@ -1,4 +0,0 @@
-interface:
-  display_name: "YSS MVC 技术设计"
-  short_description: "设计 MVC 用例、分层、事务和测试边界"
-  default_prompt: "基于当前批准输入和已确认架构，设计 MVC 用例、分层、事务和测试边界，返回待生命周期审查的结果。"

package/template/.qoder/skills/yss-mvc-design/references/mvc-design.schema.json

@@ -1,315 +0,0 @@
-{
-  "type": "object",
-  "properties": {
-    "module_catalog": {
-      "type": "array",
-      "minItems": 1,
-      "items": {
-        "type": "object",
-        "properties": {
-          "module_id": {
-            "type": "string",
-            "minLength": 1
-          },
-          "responsibility": {
-            "type": "string",
-            "minLength": 1
-          },
-          "layer": {
-            "enum": [
-              "server",
-              "service",
-              "core",
-              "repository",
-              "adapter",
-              "client",
-              "feign-client"
-            ]
-          },
-          "depends_on": {
-            "type": "array",
-            "items": {
-              "type": "string",
-              "minLength": 1
-            },
-            "uniqueItems": true
-          }
-        },
-        "required": [
-          "module_id",
-          "responsibility",
-          "layer",
-          "depends_on"
-        ],
-        "additionalProperties": false
-      }
-    },
-    "use_case_catalog": {
-      "type": "array",
-      "minItems": 1,
-      "items": {
-        "type": "object",
-        "properties": {
-          "use_case_id": {
-            "type": "string",
-            "minLength": 1
-          },
-          "module_ref": {
-            "type": "string",
-            "minLength": 1
-          },
-          "flow": {
-            "type": "array",
-            "items": {
-              "type": "string",
-              "minLength": 1
-            },
-            "uniqueItems": true,
-            "minItems": 1
-          },
-          "rule_refs": {
-            "type": "array",
-            "items": {
-              "type": "string",
-              "minLength": 1
-            },
-            "uniqueItems": true,
-            "minItems": 1
-          },
-          "failure_handling": {
-            "type": "string",
-            "minLength": 1
-          }
-        },
-        "required": [
-          "use_case_id",
-          "module_ref",
-          "flow",
-          "rule_refs",
-          "failure_handling"
-        ],
-        "additionalProperties": false
-      }
-    },
-    "rule_catalog": {
-      "type": "array",
-      "minItems": 1,
-      "items": {
-        "type": "object",
-        "properties": {
-          "rule_id": {
-            "type": "string",
-            "minLength": 1
-          },
-          "statement": {
-            "type": "string",
-            "minLength": 1
-          },
-          "use_case_refs": {
-            "type": "array",
-            "items": {
-              "type": "string",
-              "minLength": 1
-            },
-            "uniqueItems": true,
-            "minItems": 1
-          }
-        },
-        "required": [
-          "rule_id",
-          "statement",
-          "use_case_refs"
-        ],
-        "additionalProperties": false
-      }
-    },
-    "state_transition_catalog": {
-      "type": "array",
-      "minItems": 0,
-      "items": {
-        "type": "object",
-        "properties": {
-          "transition_id": {
-            "type": "string",
-            "minLength": 1
-          },
-          "use_case_ref": {
-            "type": "string",
-            "minLength": 1
-          },
-          "from": {
-            "type": "string",
-            "minLength": 1
-          },
-          "to": {
-            "type": "string",
-            "minLength": 1
-          },
-          "guard": {
-            "type": "string",
-            "minLength": 1
-          }
-        },
-        "required": [
-          "transition_id",
-          "use_case_ref",
-          "from",
-          "to",
-          "guard"
-        ],
-        "additionalProperties": false
-      }
-    },
-    "state_not_applicable_reason": {
-      "type": "string"
-    },
-    "consistency_policy": {
-      "type": "object",
-      "properties": {
-        "transaction_boundary": {
-          "type": "string",
-          "minLength": 1
-        },
-        "rollback": {
-          "type": "string",
-          "minLength": 1
-        },
-        "concurrency": {
-          "type": "string",
-          "minLength": 1
-        },
-        "idempotency": {
-          "type": "string",
-          "minLength": 1
-        }
-      },
-      "required": [
-        "transaction_boundary",
-        "rollback",
-        "concurrency",
-        "idempotency"
-      ],
-      "additionalProperties": false
-    },
-    "persistence_mapping": {
-      "type": "array",
-      "minItems": 1,
-      "items": {
-        "type": "object",
-        "properties": {
-          "mapping_id": {
-            "type": "string",
-            "minLength": 1
-          },
-          "use_case_ref": {
-            "type": "string",
-            "minLength": 1
-          },
-          "repository_ref": {
-            "type": "string",
-            "minLength": 1
-          },
-          "storage_model": {
-            "type": "string",
-            "minLength": 1
-          },
-          "notes": {
-            "type": "string",
-            "minLength": 1
-          }
-        },
-        "required": [
-          "mapping_id",
-          "use_case_ref",
-          "repository_ref",
-          "storage_model",
-          "notes"
-        ],
-        "additionalProperties": false
-      }
-    },
-    "integration_catalog": {
-      "type": "array",
-      "minItems": 0,
-      "items": {
-        "type": "object",
-        "properties": {
-          "integration_id": {
-            "type": "string",
-            "minLength": 1
-          },
-          "adapter_ref": {
-            "type": "string",
-            "minLength": 1
-          },
-          "capability": {
-            "type": "string",
-            "minLength": 1
-          },
-          "failure_handling": {
-            "type": "string",
-            "minLength": 1
-          }
-        },
-        "required": [
-          "integration_id",
-          "adapter_ref",
-          "capability",
-          "failure_handling"
-        ],
-        "additionalProperties": false
-      }
-    },
-    "integration_not_applicable_reason": {
-      "type": "string"
-    },
-    "test_seams": {
-      "type": "array",
-      "minItems": 1,
-      "items": {
-        "type": "object",
-        "properties": {
-          "seam_id": {
-            "type": "string",
-            "minLength": 1
-          },
-          "kind": {
-            "type": "string",
-            "minLength": 1
-          },
-          "subject_ref": {
-            "type": "string",
-            "minLength": 1
-          },
-          "assertion": {
-            "type": "string",
-            "minLength": 1
-          }
-        },
-        "required": [
-          "seam_id",
-          "kind",
-          "subject_ref",
-          "assertion"
-        ],
-        "additionalProperties": false
-      }
-    }
-  },
-  "required": [
-    "module_catalog",
-    "use_case_catalog",
-    "rule_catalog",
-    "state_transition_catalog",
-    "state_not_applicable_reason",
-    "consistency_policy",
-    "persistence_mapping",
-    "integration_catalog",
-    "integration_not_applicable_reason",
-    "test_seams"
-  ],
-  "additionalProperties": false,
-  "$schema": "https://json-schema.org/draft/2020-12/schema",
-  "$id": "https://yss.dev/schemas/mvc-design-v1.json",
-  "title": "YSS MVC 技术设计内容"
-}

package/template/.qoder/skills/yss-mvc-scaffold-generator/SKILL.md

@@ -1,8 +0,0 @@
----
-name: yss-mvc-scaffold-generator
-description: 已退役的数据分析 MVC 初始化旧入口；仅用于识别历史合同并指引重新批准，不执行生成或自动迁移。
----
-
-# 已退役入口
-
-本 ID 为 deprecated，只读保留历史合同解释。通用 MVC 使用 yss-layered-mvc-scaffold-generator；独立数据分析项目使用 yss-mvc-data-analysis-project-initializer。旧 Oracle/Mock 合同不得静默别名或重放；经生命周期确认 Profile 与 H2 新合同后才执行新入口。历史说明位于 references/history/skill.md，不是现行执行规范。

package/template/.qoder/skills/yss-mvc-scaffold-generator/agents/openai.yaml

@@ -1,4 +0,0 @@
-interface:
-  display_name: "YSS MVC Scaffold Generator"
-  short_description: "初始化独立 Git 的 YSS MVC 数据分析项目实例"
-  default_prompt: "Use $yss-mvc-scaffold-generator to initialize an independent Git-managed YSS MVC data-analysis project-instance with six Oracle backend modules and a mock HTTP profile."

package/template/.qoder/skills/yss-mvc-scaffold-generator/assets/logback-spring.xml.template

@@ -1,50 +0,0 @@
-<?xml version="1.0" encoding="UTF-8"?>
-<configuration>
-  <include resource="org/springframework/boot/logging/logback/defaults.xml"/>
-  <include resource="org/springframework/boot/logging/logback/console-appender.xml"/>
-
-  <property name="CONSOLE_LOG_PATTERN"
-            value="%clr(%d{yyyy-MM-dd HH:mm:ss.SSS}){faint} %clr(${LOG_LEVEL_PATTERN:-%5p}) %clr(${PID:- }){magenta} %clr(---){faint} %clr([%15.15t]){faint} %clr(%-40.40logger{39}){cyan} %clr(:){faint} %m%n${LOG_EXCEPTION_CONVERSION_WORD:-%wEx}"/>
-  <springProperty name="APP_NAME" scope="context" source="spring.application.name" defaultValue="{{PROJECT_NAME}}"/>
-  <springProperty name="LOG_PATH" scope="context" source="logging.file.path" defaultValue="logs"/>
-
-  <springProfile name="dev,mock">
-    <logger level="DEBUG" name="org.apache.ibatis"/>
-    <logger level="DEBUG" name="{{BASE_PACKAGE}}"/>
-    <root level="INFO">
-      <appender-ref ref="CONSOLE"/>
-    </root>
-  </springProfile>
-
-  <springProfile name="uat,pro,oracle,oceanbase-oracle">
-    <logger level="INFO" name="org.apache.ibatis"/>
-    <logger level="INFO" name="com.yss.cloud.log"/>
-    <logger level="INFO" name="com.yss.cloud.breaker"/>
-    <logger level="INFO" name="com.yss.cloud.exception"/>
-    <logger level="INFO" name="{{BASE_PACKAGE}}"/>
-    <logger level="INFO" name="com.alibaba"/>
-    <logger level="INFO" name="org.apache.commons"/>
-    <logger level="INFO" name="org.springframework"/>
-    <appender name="FILE" class="ch.qos.logback.core.rolling.RollingFileAppender">
-      <encoder>
-        <pattern>%d{yy-MM-dd.HH:mm:ss.SSS} [%-16t] %-5p %-22c{0} - %m%n</pattern>
-      </encoder>
-      <prudent>true</prudent>
-      <rollingPolicy class="ch.qos.logback.core.rolling.TimeBasedRollingPolicy">
-        <fileNamePattern>${LOG_PATH}/${APP_NAME}_%d{yyyyMMdd}_%i.log</fileNamePattern>
-        <maxHistory>7</maxHistory>
-        <timeBasedFileNamingAndTriggeringPolicy class="ch.qos.logback.core.rolling.SizeAndTimeBasedFNATP">
-          <maxFileSize>100MB</maxFileSize>
-        </timeBasedFileNamingAndTriggeringPolicy>
-      </rollingPolicy>
-    </appender>
-    <root level="INFO">
-      <appender-ref ref="FILE"/>
-      <appender-ref ref="CONSOLE"/>
-    </root>
-  </springProfile>
-
-  <root level="INFO">
-    <appender-ref ref="CONSOLE"/>
-  </root>
-</configuration>

package/template/.qoder/skills/yss-mvc-scaffold-generator/assets/smart-doc.json.template

@@ -1,42 +0,0 @@
-{
-  "serverUrl": "http://localhost:8080",
-  "pathPrefix": "",
-  "isStrict": true,
-  "allInOne": true,
-  "outPath": "target/openapi",
-  "coverOld": true,
-  "createDebugPage": true,
-  "packageFilters": "{{BASE_PACKAGE}}.server.controller.*",
-  "md5EncryptedHtmlName": false,
-  "style": "xt256",
-  "projectName": "{{PROJECT_NAME}}",
-  "skipTransientField": true,
-  "sortByTitle": false,
-  "ignoreRequestParams": [
-    "com.yss.cloud.excel.annotation.RequestExcel",
-    "com.yss.cloud.excel.ExcelDataRequest"
-  ],
-  "showAuthor": true,
-  "requestFieldToUnderline": false,
-  "responseFieldToUnderline": false,
-  "inlineEnum": true,
-  "recursionLimit": 7,
-  "allInOneDocFileName": "{{PROJECT_NAME}}-v2.0.0",
-  "requestExample": true,
-  "responseExample": true,
-  "displayActualType": false,
-  "componentType": "NORMAL",
-  "appToken": "",
-  "openUrl": "",
-  "debugEnvName": "local",
-  "debugEnvUrl": "http://localhost:8080",
-  "revisionLogs": [
-    {
-      "version": "2.0.0",
-      "revisionTime": "{{GENERATED_AT}}",
-      "status": "create",
-      "author": "system",
-      "remarks": "项目初始化版本v2.0.0"
-    }
-  ]
-}

package/template/.qoder/skills/yss-mvc-scaffold-generator/references/architecture.md

@@ -1,28 +0,0 @@
-# 固定架构
-
-| 模块 | 职责 |
-|---|---|
-| `client` | HTTP DTO 与稳定调用契约 |
-| `core` | 查询用例和 `AnalysisQueryExecutor` seam |
-| `repository` | 查询定义、元数据和后续持久化扩展 |
-| `adapter` | Oracle 与 Mock 执行器实现 |
-| `feign-client` | 面向其他服务的客户端契约扩展点 |
-| `server` | Spring Boot 装配和 REST Controller |
-
-依赖方向：
-
-```text
-server -> core + adapter + client
-core -> client
-repository -> client
-adapter -> core + client
-feign-client -> client
-```
-
-`core` 不依赖 Spring MVC、Oracle 驱动或具体数据源。Mock 和 Oracle 不能形成两套 HTTP 接口；二者只在 `AnalysisQueryExecutor` 的实现与 Profile 上不同。
-
-## 项目边界
-
-`target-dir` 同时是 `project-instance`、独立 Git 根和 Maven 聚合项目根。六个模块直接位于项目根；模板工具仓库只提供生成器；每个生成项目自行持有生命周期事实源、共享 skills、业务上下文、草案目录及 `external-repository` 实现仓库登记。Git 初始化只建立 `main` 分支，不创建 commit、remote 或跨项目父仓关系。
-
-工程基线固定为 Java 8、项目版本 `2.0.0-SNAPSHOT`、`com.yss.cloud:yss-cloud-microservice:2.0.0-SNAPSHOT` 父 POM 和同版本 `yss-components-bom`。标准预设包含审计、分布式 ID、Excel、Nacos、Redis Cache、OpenFeign、Smart-doc、Userinfo、Actuator 与 Mock；持久层使用 YSS MyBatis-Plus，数据库在 Oracle 与 OceanBase Oracle 中选择且驱动互斥。Smart-doc 只是人工按需生成 Controller 辅助文档的工具，不绑定 Maven 生命周期，不进入默认 AI Coding 验证链路，也不替代冻结的 OpenAPI 3.1 YAML。