$itSrSSKJr SSKJr SSKJr SSKJr SSK J r SSK J r \ "\ 5r"SS 5rg ) zAudit logging for data changes and corrections. Provides the AuditLogger class for recording and querying data modifications across the system, enabling traceability of data corrections. ) annotations)Any)desc)Session) get_logger)AuditLogc\rSrSrSr\SS Sjj5r\S Sj5r\S S Sjj5rSr g) AuditLoggeruLogger for recording and querying data changes. Usage:: audit = AuditLogger() audit.log_change( session, table_name="starters", record_id="42", action="CORRECT", old_values={"placing": 3}, new_values={"placing": 2}, changed_by="admin", change_reason="Manual correction from video review", ) All methods are safe to call — failures are logged but never raised, ensuring audit logging never blocks the primary operation. Nc pUR5R5nUS;a[RSU5 g[ U[ U5UUUUUS9n UR U 5 UR5 [RSUUUS.S9 U $![a [RSUUUS.S9 gf=f) uwRecord a data change in the audit log. Args: session: Database session. table_name: Name of the table that was changed. record_id: Primary key value of the changed record (stringified). action: Type of change — ``INSERT``, ``UPDATE``, ``DELETE``, or ``CORRECT``. old_values: Snapshot of values before the change (optional). new_values: Snapshot of values after the change (optional). changed_by: Identifier of the user/system that made the change (optional). change_reason: Human-readable reason for the change (optional). Returns: The created AuditLog entry, or ``None`` if logging failed. )INSERTUPDATEDELETECORRECTuHInvalid audit action '%s' — must be INSERT, UPDATE, DELETE, or CORRECTN) table_name record_idaction old_values new_values changed_by change_reasonzAudit log entry created)rrrextraz Failed to create audit log entry) upperstriploggerwarningrstraddflushdebug Exception exception) sessionrrrrrrr action_upperentrys @/root/tipsharks/tipsharks-elo-api/packages/core/storage/audit.py log_changeAuditLogger.log_change$s4||~++- H H NNZ  %i.#%%%+E KK  MMO LL)",!**  L    2",!**   sAB"B54B5c\UR[5R[RU:H[R[ U5:H5R [[R55R5$![a [RSXS.S9 /s$f=f)zRetrieve all audit log entries for a specific record. Args: session: Database session. table_name: Name of the table. record_id: Primary key value of the record (stringified). Returns: List of AuditLog entries, newest first. z$Failed to query audit log for record)rrr) queryrfilterrrrorder_byr created_atallr"rr#)r$rrs r'get_changes_for_record"AuditLogger.get_changes_for_recordfs   h''':5&&#i.8$x2234     6%/H  I  sBB"B+*B+cUR[5R[[R55R U5R 5$![a [RS5 /s$f=f)zRetrieve the most recent audit log entries across all tables. Args: session: Database session. limit: Maximum number of entries to return (default 100). Returns: List of recent AuditLog entries, newest first. z(Failed to query recent audit log entries) r+rr-rr.limitr/r"rr#)r$r3s r'get_recent_changesAuditLogger.get_recent_changessb  h'$x2234u       G HI sAA!A>=A>)NNNN)r$rrrrrrrrdict[str, Any] | Nonerr7r str | Nonerr8returnzAuditLog | None)r$rrrrrr9list[AuditLog])d)r$rr3intr9r:) __name__ __module__ __qualname____firstlineno____doc__ staticmethodr(r0r4__static_attributes__r6r'r r s  -1,0!%$(???? ? * ? * ??"? ??B  @ rDr N)rA __future__rtypingr sqlalchemyrsqlalchemy.ormrpackages.core.common.loggingrpackages.core.storage.modelsrr=rr r6rDr'rKs4 #"31 H JJrD