동의권

# 동의 관리 시스템 구현 예제
from dataclasses import dataclass, field
from datetime import datetime
from typing import List, Dict, Optional
from enum import Enum
import uuid
import hashlib

class ConsentPurpose(Enum):
    """동의 목적 (GDPR 제6조 기반)"""
    SERVICE_PROVISION = "service_provision"      # 서비스 제공
    AI_TRAINING = "ai_training"                  # AI 모델 학습
    AI_PERSONALIZATION = "ai_personalization"   # AI 개인화
    MARKETING = "marketing"                      # 마케팅
    RESEARCH = "research"                        # 연구 목적
    THIRD_PARTY_SHARING = "third_party_sharing" # 제3자 제공

class ConsentStatus(Enum):
    GRANTED = "granted"
    WITHDRAWN = "withdrawn"
    EXPIRED = "expired"

@dataclass
class ConsentRecord:
    """개별 동의 기록"""
    consent_id: str
    user_id: str
    purpose: ConsentPurpose
    status: ConsentStatus
    granted_at: datetime
    withdrawn_at: Optional[datetime] = None
    expiry_date: Optional[datetime] = None
    version: str = "1.0"  # 동의 약관 버전
    ip_address: Optional[str] = None
    proof_hash: str = field(default="")  # 동의 증빙 해시

    def __post_init__(self):
        if not self.proof_hash:
            # 동의 증빙용 해시 생성
            content = f"{self.user_id}:{self.purpose.value}:{self.granted_at}"
            self.proof_hash = hashlib.sha256(content.encode()).hexdigest()

class ConsentManager:
    """GDPR/개인정보보호법 준수 동의 관리 시스템"""

    def __init__(self):
        self.consents: Dict[str, List[ConsentRecord]] = {}  # user_id -> consents

    def grant_consent(self, user_id: str, purpose: ConsentPurpose,
                      expiry_days: int = 365, version: str = "1.0") -> ConsentRecord:
        """동의 획득 (GDPR 제7조 요건 준수)"""
        consent = ConsentRecord(
            consent_id=str(uuid.uuid4())[:8],
            user_id=user_id,
            purpose=purpose,
            status=ConsentStatus.GRANTED,
            granted_at=datetime.now(),
            expiry_date=datetime.now().replace(
                year=datetime.now().year + (expiry_days // 365)
            ) if expiry_days else None,
            version=version
        )

        if user_id not in self.consents:
            self.consents[user_id] = []
        self.consents[user_id].append(consent)

        print(f"[동의 획득] 사용자 {user_id}, 목적: {purpose.value}")
        return consent

    def withdraw_consent(self, user_id: str, purpose: ConsentPurpose) -> bool:
        """동의 철회 (GDPR 제7조 제3항: 동의 철회는 동의만큼 쉬워야 함)"""
        if user_id not in self.consents:
            return False

        for consent in self.consents[user_id]:
            if consent.purpose == purpose and consent.status == ConsentStatus.GRANTED:
                consent.status = ConsentStatus.WITHDRAWN
                consent.withdrawn_at = datetime.now()
                print(f"[동의 철회] 사용자 {user_id}, 목적: {purpose.value}")
                print(f"  -> AI 학습 데이터 제외 처리 필요")
                return True
        return False

    def check_consent(self, user_id: str, purpose: ConsentPurpose) -> bool:
        """특정 목적에 대한 유효한 동의 존재 여부 확인"""
        if user_id not in self.consents:
            return False

        for consent in self.consents[user_id]:
            if consent.purpose == purpose:
                if consent.status == ConsentStatus.GRANTED:
                    # 만료 여부 확인
                    if consent.expiry_date and consent.expiry_date < datetime.now():
                        consent.status = ConsentStatus.EXPIRED
                        return False
                    return True
        return False

    def get_users_with_consent(self, purpose: ConsentPurpose) -> List[str]:
        """특정 목적에 동의한 사용자 목록 (AI 학습 데이터 필터링용)"""
        users = []
        for user_id, user_consents in self.consents.items():
            if self.check_consent(user_id, purpose):
                users.append(user_id)
        return users

    def get_withdrawn_users(self, purpose: ConsentPurpose,
                            since: datetime = None) -> List[str]:
        """동의 철회 사용자 목록 (Machine Unlearning 대상)"""
        users = []
        for user_id, user_consents in self.consents.items():
            for consent in user_consents:
                if consent.purpose == purpose and consent.status == ConsentStatus.WITHDRAWN:
                    if since is None or (consent.withdrawn_at and consent.withdrawn_at >= since):
                        users.append(user_id)
                        break
        return users

    def generate_consent_audit_log(self, user_id: str) -> Dict:
        """감사용 동의 이력 생성 (GDPR 제7조 제1항: 동의 증명 의무)"""
        if user_id not in self.consents:
            return {"user_id": user_id, "consents": []}

        return {
            "user_id": user_id,
            "consents": [
                {
                    "consent_id": c.consent_id,
                    "purpose": c.purpose.value,
                    "status": c.status.value,
                    "granted_at": c.granted_at.isoformat(),
                    "withdrawn_at": c.withdrawn_at.isoformat() if c.withdrawn_at else None,
                    "version": c.version,
                    "proof_hash": c.proof_hash
                }
                for c in self.consents[user_id]
            ]
        }

# 사용 예시
cm = ConsentManager()

# AI 학습 목적 동의 획득
cm.grant_consent("user_001", ConsentPurpose.AI_TRAINING)
cm.grant_consent("user_002", ConsentPurpose.AI_TRAINING)
cm.grant_consent("user_003", ConsentPurpose.AI_TRAINING)

# 학습 데이터 필터링 (동의한 사용자만)
consented_users = cm.get_users_with_consent(ConsentPurpose.AI_TRAINING)
print(f"AI 학습 가능 사용자: {consented_users}")

# 동의 철회 처리
cm.withdraw_consent("user_002", ConsentPurpose.AI_TRAINING)

# 철회 사용자 데이터 처리 (재학습 또는 unlearning)
withdrawn = cm.get_withdrawn_users(ConsentPurpose.AI_TRAINING)
print(f"데이터 제외 필요: {withdrawn}")