create-yss-spec 3.0.0 → 3.0.1

package/template/.hermes/skills/yss-application/SKILL.md

@@ -1,54 +0,0 @@
----
-name: yss-application
-description: Use when implementing YSS application use cases, transaction boundaries, cross-aggregate orchestration, idempotency, or application-level DTO conversion.
----
-
-# yss-application
-
-Application 层用例编排 skill。负责协调 Domain 与 Gateway，定义事务边界和跨聚合流程，不承载核心领域规则。
-
-## 何时使用
-
-- 用户要实现 Application Service、用例编排或 `@Transactional` 边界。
-- 用户要补 App 层 MapStruct Convertor 或跨聚合协调逻辑。
-- 脚手架生成完成后进入业务实现，Router 按 `backend_impact` 加载本 skill。
-
-## 不适用
-
-- 只做领域建模时，优先 `yss-domain`。
-- 只做持久层时，优先 `yss-repository`。
-- 只做 Controller 时，优先 `yss-web-controller`。
-
-## 工作方式
-
-1. 确认工程来自 `target-domain-model`；`core/client/repository` 等旧架构对本脚手架链路为 `unsupported`。
-2. 确认 Use Case、Application 边界、事务边界已在批准合同中写明。
-3. 实现 AppService 时调用 Domain Service / Gateway，核心规则下沉 Domain。
-4. Web DTO 转 Application Command/Result 属于 Web，PO 转 Domain 属于 Infrastructure；Application 内确有独立模型转换时才加载 `mapstruct`，并统一 Spring Bean 与构造器注入。
-5. 详细包结构、注解、示例和旧架构阻断边界见 `references/application-layer-guide.md`。
-
-## 产物范围
-
-- `application/.../command/*Command.java`、`application/.../query/*Query.java`、`application/.../result/*Result.java`
-- `application/.../port/*QueryPort.java`
-- `application/.../service/*Service.java`
-- `application/.../service/impl/*ServiceImpl.java`
-- `application/.../service/convertor/*Convertor.java`（MapStruct）
-
-## 协同顺序
-
-- 领域建模：`yss-domain`
-- 持久层：`yss-repository`
-- Web 适配：`yss-web-controller`
-- Web DTO / Result 契约：`yss-dto` + `yss-web-controller`
-
-## 阶段 7 合同
-
-- 只消费批准后的 `Slice Implementation Contract` 和当前 `work_unit`。
-- AppService 骨架可 `controlled-generation`；用例编排、事务、幂等、权限和失败行为必须 `behavior-tdd`。
-- 按 `yss-router/references/yss-skill-execution-result.md` 返回统一 `YSS Skill Execution Result`。
-- 发现新 API、权限、状态机或跨上下文影响时填入 `new_impacts` 并暂停。
-
-## 按需读取
-
-- 分层开发规范：`references/application-layer-guide.md`

package/template/.hermes/skills/yss-application/agents/openai.yaml

@@ -1,5 +0,0 @@
-version: 1
-interface:
-  display_name: "YSS Application Layer"
-  short_description: "YSS Application 层用例编排、事务边界与跨聚合协调规范"
-  default_prompt: "Use $yss-application to implement the application layer for a YSS backend module."

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

@@ -1,87 +0,0 @@
-# YSS Application Target Profile 指南
-
-Application 是 Web 与 Domain 之间的稳定用例边界。Target Profile 使用 `application` 包；历史 `core/service` 对新脚手架为 `unsupported`。
-
-## 1. 职责
-
-- 定义 Application Command、Query、Result 和 Use Case Service。
-- 编排 Domain Model、Domain Service 和 Domain Gateway。
-- 定义写用例事务边界、幂等和事件发布时点。
-- 为分页、列表和投影查询定义 Application Query Port。
-- 传播或转换领域错误语义，但不决定 HTTP status 和公开消息。
-
-Application 不接收 HTTP Request DTO，不返回 Web VO，不依赖 Infrastructure/Web，也不处理 Repository PO。
-
-## 2. 包结构
-
-```text
-{base_package}.application
-├── command
-├── query
-├── result
-├── port
-└── service
-```
-
-## 3. 写用例
-
-```java
-@Service
-@RequiredArgsConstructor
-public class QualityTemplateService {
-    private final QualityTemplateGateway gateway;
-
-    @Transactional(rollbackFor = Exception.class)
-    public QualityTemplateId create(QualityTemplateCreateCommand command) {
-        QualityTemplate aggregate = QualityTemplate.create(command.name());
-        gateway.save(aggregate);
-        return aggregate.id();
-    }
-}
-```
-
-- WebConvertor 在 Controller 调用前把 Request 转成 Application Command。
-- 核心规则由 Aggregate 公开方法执行，不复制到 AppService。
-- 一次用例一个明确事务 seam；读操作按合同决定 `readOnly` 和总数策略。
-
-## 4. 查询用例
-
-```java
-public interface QualityTemplateQueryPort {
-    PageResult<QualityTemplateResult> page(QualityTemplatePageQuery query);
-}
-```
-
-- Query Port 属于 Application，Infrastructure 实现。
-- `QualityTemplatePageQuery` 使用 Application 语义，不接受未经白名单转换的数据库列名。
-- Application Result 不等于 Web VO；WebConvertor 负责最后一跳。
-- `PageResult` 可以作为 Application/Infrastructure 的 YSS 分页容器，但不得进入 Domain Gateway。
-
-## 5. MapStruct
-
-只有 Application 内确有不同模型转换时才创建 Convertor，并统一：
-
-```java
-@Mapper(componentModel = "spring")
-public interface QualityTemplateApplicationConvertor {
-}
-```
-
-禁止静态 `INSTANCE`；使用构造器注入。Web DTO 转换仍留在 Web，PO 转换留在 Infrastructure。
-
-## 6. Error seam
-
-- Domain error 保留稳定错误标识和参数。
-- Application 不吞掉 unknown exception，不把 `getLocalizedMessage()` 变成公开响应。
-- Web Exception Translator 依据冻结 API 合同映射 YSS error code、HTTP status 和消毒消息。
-
-## 7. 验证
-
-- 写用例通过 Application Service seam 测试事务、幂等和领域行为。
-- 查询用例通过 Query Port seam 测试分页和白名单。
-- ArchUnit 证明 Application 不依赖 Infrastructure/Web。
-- 实际执行项目根 `./mvnw test/package`。
-
-## 8. 旧架构边界
-
-检测到 AppService 接收 client Cmd、返回 client VO、调用返回 VO 的 Domain Gateway 或位于 `core/service` 时，返回 `unsupported`，不得由新 scaffold 或本指南自动改写。旧项目继续按原工程维护；现代化改造必须单独立项、先评估再逐切片迁移。

package/template/.hermes/skills/yss-audit-log/SKILL.md

@@ -1,67 +0,0 @@
----
-name: yss-audit-log
-description: Use when YSS `AuditLog`, `EnableAuditLog`, audit SpEL summaries, async publication, subscriber registration, queue loss, or audit delivery failures are involved.
----
-
-# yss-audit-log
-
-用于处理 `yss-component-audit-log` 的接入、排障和代码修改。
-
-## 何时使用
-
-- 用户要求接入或修改审计日志。
-- 用户提到 `@AuditLog`、`@EnableAuditLog`、SpEL 摘要、审计订阅器、异步发布。
-- 用户反馈审计日志未生效、摘要解析失败、日志未下发到系统管理。
-
-## 工作方式
-
-1. 先确认用户是在做“接入”还是“排障”。
-2. 涉及真实类名、配置项、订阅器或排障时，先读 `references/source-index.md`，再定位源码或文档。
-3. 优先检查项目里是否已有注解、配置项和订阅器实现，再决定改法。
-4. 只给出与当前问题直接相关的接入点：注解、配置、切面链路、订阅器扩展。
-5. 需要看实现细节时，再读取 `assets/` 下源码，不要先讲整套组件原理。
-
-## 源码索引
-
-- 源码位置不要假设固定目录；先按 `yss-source-index/references/source-location.md` 定位。
-- 当前技能索引：`references/source-index.md`
-- 重点源码入口通常包括审计注解、启用注解、切面、发布服务、事件模型、默认订阅器。
-
-当组件源码变化后，用 `yss-source-index` 刷新索引；刷新或读取前先按源码定位策略确认真实位置。
-
-## 接入检查清单
-
-- 启动类是否启用了类似 `@EnableAuditLog` 的能力。
-- 目标方法是否是可被 AOP 代理拦截的 Spring Bean 方法。
-- `@AuditLog` 是否标在正确的方法上。
-- `summary` 中的 SpEL 变量必须使用源码实际暴露的 context keys (`参数审计` / `结果审计`)；方法参数名不会自动进入 context。
-- 当前源码的变量正则只接受 ASCII 字母、数字、下划线和路径符号，不能可靠识别中文 context key；涉及 `#{参数审计...}` / `#{结果审计...}` 时先标记 `blocked`，除非组件修复并有表达式测试，不要声称摘要会被解析。
-- 项目编译参数是否保留了参数名。
-- `yss.audit.enabled` 是否开启；`sendSysManageEnabled` 与 `auditLogPrintEnabled` 在当前实现中不会自动阻止订阅器注册，需按源码验证，不能假设开关生效。
-
-## 排障顺序
-
-1. 注解是否生效。
-2. 切面是否拦截到方法。
-3. SpEL 是否能从参数和返回值取到值。
-4. 发布服务是否成功入队。
-5. 订阅器是否被 Spring 扫描并注册。
-6. 下游系统管理或打印订阅器是否被开关禁用。
-7. 异步线程池或事件发布异常是否被吞掉。
-8. 参数名、返回值字段、异常分支是否满足摘要模板。
-
-审计切面当前是 `@AfterReturning`，只记录成功返回；异常审计、参数脱敏、队列满丢弃、线程池关闭、重试和幂等必须单独设计并测试。
-
-## 修改约束
-
-- 不要把业务日志和审计日志混为一套机制。
-- 不要把审计规则硬编码在 Controller。
-- 需要扩展新日志落点时，优先新增订阅器实现，不要改坏默认发布链路。
-- 若无法确认真实注解或配置名，先在代码库里搜索现有实现，再修改。
-
-## 按需读取
-
-- 源码索引：`references/source-index.md`
-- 审计切面与 SpEL 解析：`assets/AuditLogAspect.java`
-- 异步发布链路：`assets/YssAuditPublishService.java`
-- 默认订阅器：`assets/YssAuditLogPrintSubscriberImpl.java`、`assets/YssAuditLogSysManagerSubscriberImpl.java`

package/template/.hermes/skills/yss-audit-log/agents/openai.yaml

@@ -1,5 +0,0 @@
-version: 1
-interface:
-  display_name: "YSS Audit Log"
-  short_description: "审计日志接入、SpEL 描述、发布订阅与扩展实现规范"
-  default_prompt: "Use $yss-audit-log to implement or debug audit-log publishing, SpEL descriptions, and subscription handling."

package/template/.hermes/skills/yss-audit-log/assets/AuditLogAspect.java

@@ -1,262 +0,0 @@
-package com.yss.cloud.audit.configuration;
-
-import cn.hutool.jwt.JWT;
-import cn.hutool.jwt.JWTUtil;
-import com.fasterxml.jackson.annotation.JsonInclude;
-import com.fasterxml.jackson.databind.ObjectMapper;
-import com.fasterxml.jackson.datatype.jsr310.JavaTimeModule;
-import com.yss.cloud.audit.AuditLog;
-import com.yss.cloud.audit.subscriber.YssAuditPublishService;
-import com.yss.cloud.dto.audit.message.AuditMessage;
-import com.yss.cloud.dto.audit.message.AuditResourceType;
-import com.yss.cloud.dto.audit.message.EventMessage;
-import com.yss.cloud.dto.user.UserInfo;
-import com.yss.cloud.user.AuthUserInfoUtil;
-import lombok.SneakyThrows;
-import lombok.extern.slf4j.Slf4j;
-import org.aspectj.lang.JoinPoint;
-import org.aspectj.lang.Signature;
-import org.aspectj.lang.annotation.AfterReturning;
-import org.aspectj.lang.annotation.Aspect;
-import org.aspectj.lang.reflect.MethodSignature;
-import org.springframework.beans.factory.annotation.Autowired;
-import org.springframework.cglib.beans.BeanMap;
-import org.springframework.context.expression.EnvironmentAccessor;
-import org.springframework.context.expression.MapAccessor;
-import org.springframework.expression.Expression;
-import org.springframework.expression.ExpressionParser;
-import org.springframework.expression.ParserContext;
-import org.springframework.expression.spel.standard.SpelExpressionParser;
-import org.springframework.expression.spel.support.StandardEvaluationContext;
-import org.springframework.util.StringUtils;
-import org.springframework.web.context.request.RequestContextHolder;
-import org.springframework.web.context.request.ServletRequestAttributes;
-
-import javax.servlet.ServletRequest;
-import javax.servlet.ServletResponse;
-import javax.servlet.http.HttpServletRequest;
-import java.io.File;
-import java.io.InputStream;
-import java.net.NetworkInterface;
-import java.security.Principal;
-import java.time.LocalDateTime;
-import java.util.*;
-import java.util.regex.Matcher;
-import java.util.regex.Pattern;
-import java.util.stream.Collectors;
-
-@Aspect
-@Slf4j
-public class AuditLogAspect {
-    public static final String USER_AGENT = "User-Agent";
-    /**
-     * 引用来源
-     */
-    public static final String REFERER = "Referer";
-    public static final String UNKNOWN = "unknown";
-    private static final ExpressionParser parser = new SpelExpressionParser();
-    /**
-     * 正则表达式，匹配 #{xxx} 格式的变量表达式
-     */
-    private static final Pattern varPattern = Pattern.compile("#\\{[a-zA-Z0-9_\\[\\]\\?\\.]+\\}");
-    @Autowired
-    private YssAuditPublishService yssAuditPublishService;
-    private static final ObjectMapper OM = new ObjectMapper();
-    static {
-        OM.registerModule(new JavaTimeModule());
-        OM.setSerializationInclusion(JsonInclude.Include.NON_NULL);
-    }
-    private static boolean containsPattern(String text) {
-        Matcher matcher = varPattern.matcher(text);
-        return matcher.find();
-    }
-
-    private static String getMacAddr() {
-        try {
-            Enumeration<NetworkInterface> networkInterfaces = NetworkInterface.getNetworkInterfaces();
-            while (networkInterfaces.hasMoreElements()) {
-                NetworkInterface networkInterface = networkInterfaces.nextElement();
-                if (networkInterface.getName().startsWith("en")) {
-                    byte[] macAddress = networkInterface.getHardwareAddress();
-                    if (macAddress != null) {
-                        StringJoiner macAddressBuilder = new StringJoiner("-");
-                        for (byte b : macAddress) {
-                            macAddressBuilder.add(String.format("%02X", b));
-                        }
-                        return macAddressBuilder.toString();
-                    }
-                }
-            }
-        } catch (Exception e) {
-            return "";
-        }
-        return "";
-    }
-
-    @SneakyThrows
-    @AfterReturning(value = "@annotation(com.yss.cloud.audit.AuditLog)&&execution(public * *(..))", returning = "result")
-    public void logAudit(JoinPoint joinPoint, Object result) {
-        Signature signature = joinPoint.getSignature();
-
-        AuditMessage.AuditMessageBuilder builder = AuditMessage.builder();
-        Map<String, Object> referencedResources = new HashMap<>();
-
-        Class<?> declaringType = signature.getDeclaringType();
-        if (signature instanceof MethodSignature) {
-            AuditLog audit = ((MethodSignature) signature).getMethod().getAnnotation(AuditLog.class);
-            if (audit.isNeedArgs()) {
-                referencedResources.put("参数审计", buildLogArgsDetails(joinPoint));
-            }
-            if (audit.isNeedResult()) {
-                referencedResources.put("结果审计", result);
-            }
-            String summary = StringUtils.hasLength(audit.value()) ? audit.value() : audit.summary();
-
-            boolean containsVariableExpression = containsPattern(summary);
-
-            if (containsVariableExpression) {
-                log.info("文本中包含变量表达式。");
-                StandardEvaluationContext context = new StandardEvaluationContext(referencedResources);
-                context.addPropertyAccessor(new MapAccessor());
-                context.addPropertyAccessor(new EnvironmentAccessor());
-                try {
-                    Expression expression = parser.parseExpression(summary, ParserContext.TEMPLATE_EXPRESSION);
-                    summary = expression.getValue(context, String.class);
-                } catch (Exception e) {
-                    log.warn(e.getLocalizedMessage());
-                }
-
-            }
-
-            builder.operation(Objects.isNull(audit.operation())
-                            ? signature.getName()
-                            : audit.operation().getOperationType())
-                    .content(summary)
-                    .resourceType(audit.resource().getResourceType());
-        }
-
-        EventMessage.EventMessageBuilder eventMessageBuilder = EventMessage.builder()
-                .eventId(UUIDGenerator.generateUUID())
-                .serviceName(declaringType.getName())
-                .eventTime(LocalDateTime.now())
-                .userIdentity(AuthUserInfoUtil.currentUserJson())
-                .macAddr(getMacAddr());
-        if (result instanceof Principal){
-            //登录情况获取用户信息
-            BeanMap beanMap = BeanMap.create(result);
-            Object additionalParameters = beanMap.get("additionalParameters");
-            if (Objects.nonNull(additionalParameters)){
-                Map<String,String> additionalParametersMap = (Map<String,String>)additionalParameters;
-                log.info("[登录用户信息] additionalParametersMap=>{}",additionalParametersMap);
-                String idToken = additionalParametersMap.get("id_token");
-                final JWT jwt = JWTUtil.parseToken(idToken);
-                UserInfo userInfo = new UserInfo();
-                userInfo.setUserName(String.valueOf(jwt.getPayload("sub")));
-
-                String loginDisplayName = Objects.nonNull(jwt.getPayload("loginDisplayName"))?
-                        String.valueOf(jwt.getPayload("loginDisplayName")):
-                        String.valueOf(jwt.getPayload("sub"));
-                userInfo.setLoginDisplayName(loginDisplayName);
-                eventMessageBuilder.userIdentity(OM.writeValueAsString(userInfo));
-            }
-
-        }
-        try{
-            HttpServletRequest request = ((ServletRequestAttributes) RequestContextHolder.currentRequestAttributes()).getRequest();
-            String realIp = getIpAddr(request);
-            eventMessageBuilder.userAgent(request.getHeader(USER_AGENT))
-                    .sourceIpAddress(realIp)
-                    .eventName(signature.getName())
-                    .requestUrl(request.getRequestURL().toString())
-                    .eventSource(Objects.isNull(request.getHeader(REFERER)) ? request.getRequestURL().toString() : request.getHeader(REFERER));
-        }catch (Exception e){
-            log.warn("非rest请求无法获取客户端ip");
-            eventMessageBuilder.userAgent("")
-                    .sourceIpAddress("")
-                    .eventName(signature.getName())
-                    .requestUrl("")
-                    .eventSource("");
-        }
-
-        AuditMessage auditMessage = builder
-                .eventMessage(
-                        eventMessageBuilder.build()
-                )
-                .referencedResources(referencedResources)
-                .build();
-
-
-        auditMessage.setResourceName(AuditResourceType.valueOf(auditMessage.getResourceType()).getResourceName());
-
-        yssAuditPublishService.publish(auditMessage);
-    }
-
-    /**
-     * 辅助方法，构建日志详情
-     *
-     * @param joinPoint 参数点
-     */
-    @SneakyThrows
-    private List<Object> buildLogArgsDetails(JoinPoint joinPoint) {
-        Object[] args = joinPoint.getArgs();
-        return Arrays.stream(args)
-                .filter(arg -> !(arg instanceof ServletRequest || arg instanceof ServletResponse))
-                .map(arg -> {
-                    if (arg instanceof File) {
-                        return ((File) arg).getName();
-                    } else if (arg instanceof InputStream) {
-                        return "参数为输入流";
-                    } else {
-                        return arg;
-                    }
-                })
-                .collect(Collectors.toList());
-    }
-
-    /**
-     * 获取真实ip地址,不返回内网地址
-     *
-     * @param request 请求对象
-     * @return 真实客户ip
-     */
-    public String getIpAddr(HttpServletRequest request) {
-        //目前则是网关ip
-        String ip = request.getHeader("X-Forwarded-For");
-        if (ip != null && !ip.isEmpty() && !UNKNOWN.equalsIgnoreCase(ip)) {
-            return getFirstIpAddr(ip);
-        }
-        if (ip == null || ip.isEmpty() || UNKNOWN.equalsIgnoreCase(ip)) {
-            ip = request.getHeader("Proxy-Client-IP");
-        }
-        if (ip == null || ip.isEmpty() || UNKNOWN.equalsIgnoreCase(ip)) {
-            ip = request.getHeader("WL-Proxy-Client-IP");
-        }
-        if (ip == null || ip.isEmpty() || UNKNOWN.equalsIgnoreCase(ip)) {
-            ip = request.getHeader("HTTP_CLIENT_IP");
-        }
-        if (ip == null || ip.isEmpty() || UNKNOWN.equalsIgnoreCase(ip)) {
-            ip = request.getHeader("HTTP_X_FORWARDED_FOR");
-        }
-        if (ip == null || ip.isEmpty() || UNKNOWN.equalsIgnoreCase(ip)) {
-            ip = request.getRemoteAddr();
-        }
-
-
-        return getFirstIpAddr(ip);
-    }
-
-    private static String getFirstIpAddr(String ip) {
-        if (ip != null && !ip.isEmpty() && !UNKNOWN.equalsIgnoreCase(ip)) {
-            int index = ip.indexOf(',');
-            if (index != -1) {
-                //只获取第一个值
-                return ip.substring(0, index);
-            } else {
-                return ip;
-            }
-        } else {
-            //取不到真实ip则返回空，不能返回内网地址。
-            return "";
-        }
-    }
-}

package/template/.hermes/skills/yss-audit-log/assets/YssAuditLogPrintSubscriberImpl.java

@@ -1,37 +0,0 @@
-/*
- * Licensed to the Apache Software Foundation (ASF) under one or more
- * contributor license agreements.  See the NOTICE file distributed with
- * this work for additional information regarding copyright ownership.
- * The ASF licenses this file to You under the Apache License, Version 2.0
- * (the "License"); you may not use this file except in compliance with
- * the License.  You may obtain a copy of the License at
- *
- *    http://www.apache.org/licenses/LICENSE-2.0
- *
- * Unless required by applicable law or agreed to in writing, software
- * distributed under the License is distributed on an "AS IS" BASIS,
- * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
- * See the License for the specific language governing permissions and
- * limitations under the License.
- */
-
-package com.yss.cloud.audit.subscriber.impl;
-
-import com.yss.cloud.audit.subscriber.YssAuditSubscriber;
-import com.yss.cloud.dto.audit.message.AuditMessage;
-import lombok.extern.slf4j.Slf4j;
-
-/**
- * 日志打印操作日志订阅器
- *
- * @author zhudaoming
- * @since 1.0.0
- */
-@Slf4j
-public class YssAuditLogPrintSubscriberImpl implements YssAuditSubscriber {
-
-    @Override
-    public void execute(AuditMessage message) {
-        log.info("[AUDIT_MESSAGE] 审计日志 => {}",message.toString());
-    }
-}

package/template/.hermes/skills/yss-audit-log/assets/YssAuditLogSysManagerSubscriberImpl.java

@@ -1,18 +0,0 @@
-package com.yss.cloud.audit.subscriber.impl;
-
-import com.yss.cloud.audit.subscriber.YssAuditSubscriber;
-import com.yss.cloud.dto.audit.message.AuditMessage;
-import com.yss.datamiddle.feign.YssDmSystemManageFeign;
-import org.springframework.beans.factory.annotation.Autowired;
-
-/**
- * @author zhudaoming
- */
-public class YssAuditLogSysManagerSubscriberImpl implements YssAuditSubscriber {
-    @Autowired
-    private YssDmSystemManageFeign yssDmSystemManageFeign;
-    @Override
-    public void execute(AuditMessage message) {
-        yssDmSystemManageFeign.saveAuditLog(message);
-    }
-}

package/template/.hermes/skills/yss-audit-log/assets/YssAuditPublishService.java

@@ -1,69 +0,0 @@
-package com.yss.cloud.audit.subscriber;
-
-import com.yss.cloud.audit.configuration.AuditConfigurationProperties;
-import com.yss.cloud.dto.audit.message.AuditMessage;
-import lombok.extern.slf4j.Slf4j;
-import org.springframework.beans.factory.annotation.Autowired;
-
-import javax.annotation.PostConstruct;
-import java.util.List;
-import java.util.concurrent.ArrayBlockingQueue;
-import java.util.concurrent.BlockingQueue;
-import java.util.concurrent.ExecutorService;
-import java.util.concurrent.Executors;
-
-@Slf4j
-public class YssAuditPublishService {
-
-    private final BlockingQueue<AuditMessage> auditMessageQueue = new ArrayBlockingQueue<>(1000);
-    private final ExecutorService executorService = Executors.newFixedThreadPool(10);
-    @Autowired
-    private List<YssAuditSubscriber> subscribers;
-    @Autowired
-    private AuditConfigurationProperties auditConfigurationProperties;
-
-    /**
-     * Initialize the service and start the message processing.
-     */
-    @PostConstruct
-    private void init() {
-        for (int i = 0; i < 10; i++) {
-            executorService.submit(this::doPublish);
-        }
-    }
-
-    /**
-     * Publish a new audit message.
-     *
-     * @param message audit message
-     */
-    public void publish(AuditMessage message) {
-        if (auditConfigurationProperties.getEnabled()) {
-            if (!auditMessageQueue.offer(message)) {
-                log.error("Publish audit message failed, message:{}", message);
-            }
-        }
-    }
-
-    /**
-     * Execute the message processor for each subscriber.
-     */
-    private void doPublish() {
-        while (true) {
-            try {
-                AuditMessage message = auditMessageQueue.take();
-                for (YssAuditSubscriber subscriber : subscribers) {
-                    try {
-                        subscriber.execute(message);
-                    } catch (Exception e) {
-                        log.error("Consume audit message failed, message:{}", message, e);
-                    }
-                }
-            } catch (InterruptedException e) {
-                log.error("Consume audit message failed", e);
-                Thread.currentThread().interrupt();
-                break;
-            }
-        }
-    }
-}

package/template/.hermes/skills/yss-audit-log/references/README.md

@@ -1,69 +0,0 @@
-# 参考资料
-
-本文档详细介绍了 `yss-component-audit-log` 组件的核心类和配置类。
-
-## 核心类 (Core Classes)
-
-### 1. AuditLogAspect.java
-
-**位置**: `../assets/AuditLogAspect.java`
-
-审计日志切面，是日志收集的核心入口。
-
-**拦截逻辑**:
-
-- **切点**: 拦截带有 `@AuditLog` 注解且为 public 的方法。
-- **处理流程**:
-  1. **解析注解**: 获取 `@AuditLog` 中的操作类型、描述、资源类型等信息。
-  2. **SpEL 解析**: 如果 `summary` 中包含 `#{...}` 表达式，会解析方法参数和返回值，动态生成日志内容。
-  3. **构建消息**:
-     - 收集用户信息（从 JWT 解析）。
-     - 收集请求信息（URL, IP, User-Agent）。
-     - 收集参数和结果（根据 `isNeedArgs` 和 `isNeedResult` 配置）。
-  4. **发布消息**: 调用 `YssAuditPublishService.publish` 将构建好的 `AuditMessage` 发布出去。
-
-### 2. YssAuditPublishService.java
-
-**位置**: `../assets/YssAuditPublishService.java`
-
-异步日志发布服务。
-
-**机制**:
-
-- 维护一个内部阻塞队列 `ArrayBlockingQueue` (容量1000)。
-- 启动固定线程池（10个线程）作为消费者，不断从队列中获取消息。
-- 将消息分发给所有注册的 `YssAuditSubscriber` 实现类。
-
-### 3. Subscriber 实现
-
-#### YssAuditLogPrintSubscriberImpl.java
-
-**位置**: `../assets/YssAuditLogPrintSubscriberImpl.java`
-
-- **功能**: 简单的控制台日志打印，用于开发调试。
-- **开关**: 通过 `yss.audit.auditLogPrintEnabled` 控制。
-
-#### YssAuditLogSysManagerSubscriberImpl.java
-
-**位置**: `../assets/YssAuditLogSysManagerSubscriberImpl.java`
-
-- **功能**: 调用 `YssDmSystemManageFeign` 将审计日志发送到系统管理服务进行持久化存储。
-- **开关**: 通过 `yss.audit.sendSysManageEnabled` 控制。
-
-## 关键注解
-
-### @AuditLog
-
-用于标记需要审计的方法。
-
-```java
-@Target({ElementType.TYPE, ElementType.METHOD})
-@Retention(RetentionPolicy.RUNTIME)
-public @interface AuditLog {
-    String summary() default ""; // 操作描述，支持 SpEL
-    AuditOperationType operation(); // 操作类型 (ADD, UPDATE, DELETE, QUERY, etc.)
-    AuditResourceType resource() default AuditResourceType.DM; // 资源类型
-    boolean isNeedResult() default false; // 是否记录返回值
-    boolean isNeedArgs() default true; // 是否记录参数
-}
-```