baiyue-firstleg/common-audit/AGENTS.md

Common Audit 模块指引

职责边界

• 负责业务审计事件采集、注解切面、敏感字段脱敏以及日志/HTTP 输出。
• 审计记录持久化属于 audit-service/；本模块不依赖具体业务 Entity 或数据库。

快速索引

功能	入口
审计注解与切面	src/main/java/com/baiyue/common/audit/BusinessAudit.java、BusinessAuditAspect.java
事件模型	AuditEvent.java
输出抽象与实现	AuditSink.java、LoggingAuditSink.java、HttpAuditSink.java
敏感数据脱敏	SensitiveDataSanitizer.java
baiyue.audit 配置	AuditProperties.java
自动配置	BaiyueAuditAutoConfiguration.java 与 src/main/resources/META-INF/spring/org.springframework.boot.autoconfigure.AutoConfiguration.imports
远程发送鉴权测试	src/test/java/com/baiyue/common/audit/HttpAuditSinkTest.java

修改与验证

• 新增审计字段时先确认不会泄露密码、令牌、证件或客户敏感数据，并检查 audit-service 接收 DTO。
• 审计失败不应破坏核心业务；调整输出策略时保留超时、关闭开关和安全降级。
• 从父目录运行 mvn -pl common-audit -am test，并按影响追加验证 audit-service。