Files
celtic-life-science/app/audit/service.py
T
Shubhankar45 8fdd20b29f Production
2026-09-22 06:23:46 +00:00

81 lines
2.6 KiB
Python

"""Explicit, application-level audit logging.
Deliberately NOT automatic row-versioning (report §14.3 C4): an automatic versioner
records *what* changed but cannot record *why* — and the manager's return reason is
the single most important thing in this audit trail.
Every `log()` call happens inside the caller's transaction, so a state change and its
audit row commit together or not at all (V12).
"""
import uuid
from typing import Any
from sqlalchemy import select
from sqlalchemy.ext.asyncio import AsyncSession
from app.audit.models import AuditLog
from app.common.enums import AuditAction, EntityType
class AuditService:
def __init__(self, db: AsyncSession) -> None:
self.db = db
async def log(
self,
*,
actor_user_id: uuid.UUID,
entity_type: EntityType,
entity_id: uuid.UUID,
action: AuditAction,
before: dict[str, Any] | None = None,
after: dict[str, Any] | None = None,
comment: str | None = None,
ip_address: str | None = None,
) -> AuditLog:
entry = AuditLog(
actor_user_id=actor_user_id,
entity_type=entity_type,
entity_id=entity_id,
action=action,
before_data=before,
after_data=after,
comment=comment,
ip_address=ip_address,
)
self.db.add(entry)
# Flush, not commit — the caller owns the transaction boundary.
await self.db.flush()
return entry
async def history_for(
self, entity_type: EntityType, entity_id: uuid.UUID
) -> list[AuditLog]:
stmt = (
select(AuditLog)
.where(AuditLog.entity_type == entity_type, AuditLog.entity_id == entity_id)
.order_by(AuditLog.created_at.asc())
)
return list((await self.db.execute(stmt)).scalars().all())
async def approval_history_for(self, dcr_id: uuid.UUID) -> list[AuditLog]:
""""Approval history" is a FILTERED QUERY, not a second table (report §13.2)."""
workflow_actions = [
AuditAction.CREATE,
AuditAction.SUBMIT,
AuditAction.FORWARD,
AuditAction.RETURN,
AuditAction.APPROVE,
]
stmt = (
select(AuditLog)
.where(
AuditLog.entity_type == EntityType.DCR,
AuditLog.entity_id == dcr_id,
AuditLog.action.in_(workflow_actions),
)
.order_by(AuditLog.created_at.asc())
)
return list((await self.db.execute(stmt)).scalars().all())