Class Diagram

NovaShield 风控类图

8 个核心类型及其字段、方法与组合关系，覆盖输入→处理→输出全链路

类图 (Class Diagram) — 结构性图形。核心图，展现系统的静态结构，包括类、接口、属性和关系。

0..1 1..* 1..* 0..* 0..1 STRUCT OrderMessage region string queue string jobId string tenant string version string triggerType string kind string region string userNotes string IN ScanInput → message *OrderMessage jobId string version string workDir string skipEnrichment bool tenant string region string STRUCT OrderInfoResponse → storageConfig *DBConfig status string replicas int payMethod string STORE DBConfig region string ak string sk string OUT ScanResult jobId string traceID string status string → riskResults []RiskResult → stageResults map[string]*StageResult VALUE StageResult name string status string duration time.Duration CORE RiskResult # risk_category string # risk_subtype string # is_known_pattern bool # confidence int (0-5) # evidence string # remediation string risk_detail string extra_metadata map[string]string + Validate() error STRUCT AlertReport # jobId string → results []RiskResult → warnings []AlertNote createdAt time.Time + Validate() error VALUE AlertNote type string message string LEGEND 核心类 普通类 值类型 组合 # 必填 选填 → 引用 0..1 / 1..* 基数

RELATIONSHIPS

6 条组合关系

  • • ScanInput → OrderMessage (0..1, RabbitMQ 路径持有引用)
  • • ScanResult → RiskResult (1..*, 风控产出)
  • • ScanResult → StageResult (1..*, 每阶段执行记录)
  • • AlertReport → RiskResult (1..*, 按 confidence 降序)
  • • AlertReport → AlertNote (0..*, unknown_code 等)
  • • OrderInfoResponse → DBConfig (0..1, 数据库配置)

RISKRESULT

核心风控结果

  • • 6 个必填字段 (# 前缀) + 2 个选填
  • • is_known_pattern: bool (true=已知, false=未知)
  • • confidence: 0-5 整数, 0 合法
  • • Validate() 校验必填 + credibility 范围
  • • JSON tag 使用 snake_case
nova-shield · github.com/novashield/risk-engine