package audit import ( "context" "strings" "sync/atomic" "go.uber.org/zap" "github.com/break/junhong_cmp_fiber/pkg/constants" "github.com/break/junhong_cmp_fiber/pkg/logger" "github.com/break/junhong_cmp_fiber/pkg/sanitizer" ) // persistDecision 是一次审计写入的去向。 type persistDecision int const ( decisionWrite persistDecision = iota decisionLog decisionSkip ) // auditLoggerName 是应用日志中审计行的固定 logger 名,日志同步端按它过滤。 const auditLoggerName = "audit" // persistOverrides 是运行时按动作覆盖的落库策略(只作用于系统任务、定时任务操作者)。 var persistOverrides atomic.Pointer[map[string]PersistPolicy] // SetPersistOverrides 解析并设置运行时覆盖,格式为 "动作编码=策略,动作编码=策略";返回被忽略的非法项。 func SetPersistOverrides(raw string) []string { overrides := map[string]PersistPolicy{} var invalid []string for _, item := range strings.Split(raw, ",") { item = strings.TrimSpace(item) if item == "" { continue } code, policy, ok := strings.Cut(item, "=") code, policy = strings.TrimSpace(code), strings.TrimSpace(policy) if !ok || code == "" || !validPersistPolicy(PersistPolicy(policy)) { invalid = append(invalid, item) continue } overrides[code] = PersistPolicy(policy) } persistOverrides.Store(&overrides) return invalid } // effectivePolicy 返回机器操作者下动作实际采用的策略:运行时覆盖 > 注册表声明 > 默认只写应用日志。 func effectivePolicy(action ActionDefinition) PersistPolicy { if overrides := persistOverrides.Load(); overrides != nil { if policy, ok := (*overrides)[action.Code]; ok { return policy } } if action.Persist != "" { return action.Persist } return PersistLogOnly } // decidePersist 按"动作 × 操作者"决定写表、写应用日志还是跳过;人工与外部操作者始终写表。 func decidePersist(action ActionDefinition, input AppendInput) persistDecision { if !isMachineActor(input.Actor.Kind) { return decisionWrite } switch effectivePolicy(action) { case PersistAlways: return decisionWrite case PersistOnSuccess: if input.Result == constants.AuditResultSuccess { return decisionWrite } return decisionLog case PersistOutcome: if input.Final { return decisionWrite } return decisionLog case PersistNone: return decisionSkip default: return decisionLog } } // writeAuditLog 把未落表的审计写成一行应用日志;只含标识类字段,不含快照与主体数据。 func writeAuditLog(ctx context.Context, action ActionDefinition, input AppendInput) { resourceType, resourceKey := primaryResource(input) fields := []zap.Field{ zap.String("action_code", action.Code), zap.String("actor_kind", input.Actor.Kind), zap.String("actor_id", input.Actor.ID), zap.String("source", input.Source), zap.String("result", input.Result), zap.String("resource_type", resourceType), zap.String("resource_key", resourceKey), zap.String("correlation_id", input.CorrelationID), zap.String("request_id", input.RequestID), zap.String("error_code", input.ErrorCode), zap.String("summary", sanitizer.SanitizeText(input.Summary)), } if input.Attempt > 0 { fields = append(fields, zap.Int("attempt", input.Attempt)) } if input.AttemptRecordID != "" { fields = append(fields, zap.String("attempt_record_id", input.AttemptRecordID)) } auditLogger := logger.GetAppLogger().Named(auditLoggerName) if input.Result == constants.AuditResultSuccess { auditLogger.Info("audit_event", fields...) return } auditLogger.Warn("audit_event", fields...) } // primaryResource 返回主资源的类型与键,没有主资源时取第一条资源。 func primaryResource(input AppendInput) (string, string) { for _, resource := range input.Resources { if resource.Relation == constants.AuditResourceRelationPrimary { return resource.Type, resource.Key } } if len(input.Resources) > 0 { return input.Resources[0].Type, input.Resources[0].Key } return "", "" }