2026-07-04 23:08:05 +08:00
|
|
|
"""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)
|