feat(ai): add expense application feedback ledger

server/src/app/services/expense_claims.py

@@ -4,6 +4,7 @@ import json
 import re
 import shutil
 import uuid
+from collections.abc import Callable
 from collections import defaultdict
 from datetime import UTC, date, datetime, timedelta
 from decimal import Decimal, InvalidOperation
@@ -20,6 +21,7 @@ from app.api.deps import CurrentUserContext
 from app.core.agent_enums import AgentAssetDomain, AgentAssetStatus, AgentAssetType
 from app.models.agent_asset import AgentAsset
 from app.models.employee import Employee
+from app.models.expense_case import BusinessEvent
 from app.models.financial_record import ExpenseClaim, ExpenseClaimItem
 from app.models.hermes_report import HermesRiskReport
 from app.models.risk_observation import RiskObservation, RiskObservationFeedback
@@ -563,7 +565,14 @@ class ExpenseClaimItemActionMixin:
             "item_id": item.id,
         }
 
-    def submit_claim(self, claim_id: str, current_user: CurrentUserContext) -> ExpenseClaim | None:
+    def submit_claim(
+        self,
+        claim_id: str,
+        current_user: CurrentUserContext,
+        *,
+        correlation_id: str | None = None,
+        before_commit: Callable[[BusinessEvent], None] | None = None,
+    ) -> ExpenseClaim | None:
         claim = self.get_claim(claim_id, current_user)
         if claim is None:
             return None
@@ -646,11 +655,12 @@ class ExpenseClaimItemActionMixin:
 
         claim.risk_flags_json = dedupe_claim_risk_flags(claim.risk_flags_json)
 
-        self._expense_cases.record_claim_event(
+        _, submission_event = self._expense_cases.record_claim_event(
             claim,
             event_type=("application_submitted" if is_application_claim else "claim_submitted"),
             actor_id=current_user.username,
             tenant_id=getattr(current_user, "tenant_id", None),
+            correlation_id=correlation_id,
             idempotency_key=(
                 f"submit:{claim.id}:{claim.submitted_at.isoformat()}"
                 if claim.submitted_at is not None
@@ -659,6 +669,8 @@ class ExpenseClaimItemActionMixin:
             previous_status=str(before_json.get("status") or ""),
             previous_approval_stage=str(before_json.get("approval_stage") or ""),
         )
+        if before_commit is not None:
+            before_commit(submission_event)
 
         self.db.commit()
         self.db.refresh(claim)