astrbot_plugin_imagestudio/core/audit_service.py

117 行
3.3 KiB
Python

"""Audit logging service foundation."""
from __future__ import annotations
import json
from dataclasses import dataclass
from datetime import UTC, datetime
from typing import Any
from uuid import uuid4
from core.identity import RequestContext
from database.db_helper import Database, DatabaseSettings
def new_audit_id() -> str:
return f"audit_{uuid4().hex}"
@dataclass(frozen=True)
class AuditRecord:
audit_id: str
request_id: str | None
actor_type: str
actor_id: str | None
action: str
target_type: str
target_id: str | None
before_snapshot: str | None
after_snapshot: str | None
metadata_json: str | None
created_at: str
class AuditService:
def __init__(self, database: Database | None = None):
self.database = database or Database()
def record(
self,
*,
ctx: RequestContext,
action: str,
target_type: str,
target_id: str | None = None,
before_snapshot: Any | None = None,
after_snapshot: Any | None = None,
metadata: dict[str, Any] | None = None,
) -> AuditRecord:
record = AuditRecord(
audit_id=new_audit_id(),
request_id=ctx.request_id,
actor_type=ctx.actor_type,
actor_id=ctx.actor_id,
action=action,
target_type=target_type,
target_id=target_id,
before_snapshot=_json_or_none(before_snapshot),
after_snapshot=_json_or_none(after_snapshot),
metadata_json=_json_or_none(metadata or {"request_id": ctx.request_id}),
created_at=datetime.now(UTC).isoformat(),
)
self._insert(record)
return record
def _insert(self, record: AuditRecord) -> None:
placeholder = self.database._placeholder
sql = f"""
INSERT INTO audit_logs (
audit_id,
request_id,
actor_type,
actor_id,
action,
target_type,
target_id,
before_snapshot,
after_snapshot,
metadata_json,
created_at
) VALUES (
{placeholder}, {placeholder}, {placeholder}, {placeholder},
{placeholder}, {placeholder}, {placeholder}, {placeholder},
{placeholder}, {placeholder}, {placeholder}
)
"""
conn = self.database.connect()
try:
conn.execute(
sql,
(
record.audit_id,
record.request_id,
record.actor_type,
record.actor_id,
record.action,
record.target_type,
record.target_id,
record.before_snapshot,
record.after_snapshot,
record.metadata_json,
record.created_at,
),
)
conn.commit()
finally:
conn.close()
def create_audit_service(settings: DatabaseSettings | None = None) -> AuditService:
return AuditService(Database(settings))
def _json_or_none(value: Any | None) -> str | None:
if value is None:
return None
return json.dumps(value, ensure_ascii=False, sort_keys=True)