class ADDWSystemSpec:
    """
    EU ADDW法规技术规格
    
    来源: Regulation (EU) 2023/2590
    """
    
    # 激活条件
    ACTIVATION_SPEED_KMH = 20  # ≥20km/h开始工作
    
    # 警告阈值
    WARN_THRESHOLD_HIGH_SPEED = 3.5  # 秒, ≥50km/h
    WARN_THRESHOLD_LOW_SPEED = 6.0   # 秒, 20-50km/h
    
    # 非标称条件容差
    NON_NOMINAL_TOLERANCE = 1.0  # 秒, 额外容差
    
    # 驾驶任务区域定义
    # 法规定义为"远距离区域外的主驾驶任务区域"
    DRIVING_TASK_AREAS = [
        "前方道路",
        "左右后视镜",
        "仪表盘",
        "挡风玻璃区域"
    ]
    
    # 警告方式
    WARNING_TYPES = {
        "visual": True,   # 必须有
        "acoustic": False, # 声音或振动至少其一
        "haptic": False,   # 振动
        "require_both_acoustic_haptic": False  # 二选一即可
    }
    
    # 隐私要求
    PRIVACY_RULES = {
        "biometric_identification": False,  # 禁止生物识别
        "permanent_storage": False,         # 禁止永久存储
        "processing_location": "onboard",   # 车载处理
        "data_minimization": True           # 仅处理必要数据
    }
    
    # 驾驶员控制
    DRIVER_CONTROLS = {
        "deactivation_allowed": True,       # 允许驾驶员关闭警告
        "deactivation_allowed_system": True, # 允许关闭系统
        "auto_reactivation_on_restart": True # 重启后自动恢复
    }

# 驾驶任务区域定义（法规要求）
DRIVING_TASK_REGIONS = {
    "front_windshield": {
        "description": "前挡风玻璃区域",
        "gaze_yaw_range": (-30, 30),  # degrees
        "gaze_pitch_range": (-20, 10)
    },
    "left_mirror": {
        "description": "左侧后视镜",
        "gaze_yaw_range": (-60, -30),
        "gaze_pitch_range": (-10, 10)
    },
    "right_mirror": {
        "description": "右侧后视镜",
        "gaze_yaw_range": (30, 60),
        "gaze_pitch_range": (-10, 10)
    },
    "instrument_cluster": {
        "description": "仪表盘",
        "gaze_yaw_range": (-15, 15),
        "gaze_pitch_range": (-40, -20)
    }
}

# 分心区域（触发ADDW）
DISTRACTION_REGIONS = {
    "center_console": {
        "description": "中控屏幕/手机",
        "gaze_pitch_range": (-60, -40),
        "gaze_yaw_range": (-20, 20)
    },
    "passenger_seat": {
        "description": "副驾方向",
        "gaze_yaw_range": (45, 90)
    },
    "rear_seats": {
        "description": "后排方向",
        "gaze_yaw_range": (-90, -45)  # 或 >90
    },
    "lap": {
        "description": "腿部/手机",
        "gaze_pitch_range": (-80, -60)
    }
}

def check_addw_violation(gaze_yaw, gaze_pitch, speed_kmh, 
                          time_in_distraction_s):
    """
    检查是否违反ADDW法规
    
    Args:
        gaze_yaw: 视线偏航角 (degrees)
        gaze_pitch: 视线俯仰角 (degrees)
        speed_kmh: 车速 (km/h)
        time_in_distraction_s: 视线在分心区域的持续时间 (秒)
    
    Returns:
        violation: bool 是否违规
        threshold: float 适用的阈值
    """
    # 确定阈值
    if speed_kmh >= 50:
        threshold = 3.5
    elif speed_kmh >= 20:
        threshold = 6.0
    else:
        return False, None  # 速度低于20km/h，ADDW不工作
    
    # 检查是否在驾驶任务区域
    in_driving_task = False
    for region, ranges in DRIVING_TASK_REGIONS.items():
        yaw_ok = ranges["gaze_yaw_range"][0] <= gaze_yaw <= ranges["gaze_yaw_range"][1]
        pitch_ok = ranges["gaze_pitch_range"][0] <= gaze_pitch <= ranges["gaze_pitch_range"][1]
        if yaw_ok and pitch_ok:
            in_driving_task = True
            break
    
    # 如果在分心区域且超时
    if not in_driving_task and time_in_distraction_s > threshold:
        return True, threshold
    
    return False, threshold


# 测试
if __name__ == "__main__":
    test_cases = [
        # (yaw, pitch, speed, time, expected_violation, description)
        (0, 0, 80, 2.0, False, "正常看前方"),
        (50, 0, 80, 4.0, True, "看副驾>3.5s@80km/h"),
        (50, 0, 30, 7.0, True, "看副驾>6s@30km/h"),
        (50, 0, 30, 5.0, False, "看副驾5s@30km/h（未超6s）"),
        (-45, -50, 60, 4.0, True, "看中控>3.5s@60km/h"),
        (0, 0, 10, 10.0, False, "低速不激活ADDW"),
    ]
    
    print(f"{'场景':<30} {'违规?':<8} {'阈值':<8}")
    print("-" * 50)
    for yaw, pitch, speed, time, expected, desc in test_cases:
        violation, threshold = check_addw_violation(yaw, pitch, speed, time)
        status = "✅" if violation == expected else "❌"
        print(f"{desc:<30} {status}{'是' if violation else '否':<7} {threshold}")