from app.models.platform_audit import PlatformAuditLog
from app.services.audit import sanitize

def record_platform_audit(db, actor_user_id, action, entity_type, entity_id=None, reason=None, details=None):
    entry = PlatformAuditLog(actor_user_id=actor_user_id, action=action, entity_type=entity_type, entity_id=entity_id, reason=reason, details=sanitize(details or {}))
    db.add(entry)
    return entry