需在SpringBoot后端用AOP切面拦截assignSeatToUser()等Copilot配置变更方法，结合@CopilotAudit注解或正则匹配，提取脱敏参数、用户IP与异常堆栈，异步写入含联合索引的sys_copilot_log表，并映射GitHub审计事件码。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
要让GitHub Copilot Business组织内的关键操作（如座位分配、策略变更）自动落库为可审计的操作日志，需在后端服务中嵌入AOP切面，而非依赖GitHub原生日志导出。
确认日志采集范围与权限边界
仅当你的SpringBoot服务已接入GitHub Copilot Business的OAuth 2.0令牌，并具备read:org和admin:org_hook权限时，才能捕获到与Copilot策略变更强相关的内部调用事件。若服务仅调用/api/v3/orgs/{org}/copilot/billing等公开API，则无法获取copilot.cfb_policy_updated这类审计事件——这些事件只存在于GitHub后台审计日志中，不通过REST API暴露。
因此，AOP日志必须作用于你自建服务中**实际执行Copilot配置变更的业务方法**，例如updateCopilotPolicy()或assignSeatToUser()，而不是试图拦截对GitHub API的HTTP请求。
定义@CopilotAudit注解并绑定切点
方法一：声明式注解标记
创建自定义注解@CopilotAudit，设置@Target(ElementType.METHOD)和@Retention(RetentionPolicy.RUNTIME)。该注解不带参数，仅作标识用途。
方法二：正则表达式匹配方法名
在切面类中直接使用@Pointcut("execution(* com.example.service..*Copilot*.*(..))")，匹配所有含“Copilot”关键词且位于service包下的公有方法。此方式无需修改业务代码，但可能误捕非审计级操作，【务必排除健康检查、定时任务等无关方法】。
编写OperLogAspect切面逻辑
第一步：注入HttpServletRequest与用户上下文
通过RequestContextHolder获取当前请求对象，再从JWT或SecurityContext中提取登录用户名；若未登录，则记录为anonymous。这一步失败将导致日志中username字段为空，影响后续审计追踪。
第二步：提取方法参数并脱敏处理
调用JSON.toJSONString(params, new SimplePropertyPreFilter(...))过滤掉密码、token、密钥等敏感字段；未脱敏直接入库属于严重安全违规。
第三步：捕获异常并填充exception_detail
在@AfterThrowing通知中获取Throwable，用ExceptionUtils.getStackTrace()转为字符串。注意：此处不能只记录e.getMessage()，否则丢失堆栈定位能力。
第四步：构造OperationLog实体并异步写入数据库
使用@Async标注保存方法，避免阻塞主业务线程；同时设置ThreadPoolTaskExecutor的队列容量上限，防止日志洪峰压垮DB连接池。
配置日志表结构与索引
执行SQL创建sys_copilot_log表，字段必须包含log_type VARCHAR(32)（固定值'COPILOT'）、action_code VARCHAR(64)（如'cfb_seat_assignment_created'）、target_user VARCHAR(128)（被操作用户登录名）、request_ip VARCHAR(45)（支持IPv6）。
在create_time和action_code上建立联合索引，否则按action:copilot.cfb_seat_assignment_created检索时将全表扫描。
对接GitHub审计日志事件命名规范
方法1：硬编码映射
在切面内维护Map<string string></string>，将Java方法名如assignSeat映射为GitHub审计事件码copilot.cfb_seat_assignment_created。每次新增Copilot操作类型，都需同步更新该映射表。
方法2：从注解参数注入
扩展@CopilotAudit(action = "copilot.cfb_policy_updated")，直接在业务方法上声明对应事件码。这种方式更清晰，但要求开发人员严格遵守命名约定，【一旦填错，审计系统将无法关联原始事件】。
