OPS 1518/pre award approval approver side

.gitignore

@@ -204,6 +204,7 @@ yarn-error.log*
 *.drawio.bkp
 *.db
 claude.sh
+.claude
 
 # Local .terraform directories
 **/.terraform/*

backend/alembic/versions/2026_03_23_1600-d6e7f8a9b0c1_add_pre_award_approval_response_fields.py

@@ -0,0 +1,50 @@
+"""Add pre_award approval response fields to procurement tracker step
+
+Revision ID: d6e7f8a9b0c1
+Revises: c9a1b2d3e4f5
+Create Date: 2026-03-23 16:00:00.000000+00:00
+
+"""
+from typing import Sequence, Union
+
+from alembic import op
+import sqlalchemy as sa
+
+
+# revision identifiers, used by Alembic.
+revision: str = 'd6e7f8a9b0c1'
+down_revision: Union[str, None] = 'c9a1b2d3e4f5'
+branch_labels: Union[str, Sequence[str], None] = None
+depends_on: Union[str, Sequence[str], None] = None
+
+
+def upgrade() -> None:
+    # ### commands auto generated by Alembic - please adjust! ###
+    op.add_column('procurement_tracker_step', sa.Column('pre_award_approval_status', sa.String(length=20), nullable=True))
+    op.add_column('procurement_tracker_step', sa.Column('pre_award_approval_responded_by', sa.Integer(), nullable=True))
+    op.add_column('procurement_tracker_step', sa.Column('pre_award_approval_responded_date', sa.Date(), nullable=True))
+    op.add_column('procurement_tracker_step', sa.Column('pre_award_approval_reviewer_notes', sa.Text(), nullable=True))
+    op.create_foreign_key(
+        'fk_pre_award_responded_by',
+        'procurement_tracker_step', 'ops_user',
+        ['pre_award_approval_responded_by'], ['id']
+    )
+    op.add_column('procurement_tracker_step_version', sa.Column('pre_award_approval_status', sa.String(length=20), autoincrement=False, nullable=True))
+    op.add_column('procurement_tracker_step_version', sa.Column('pre_award_approval_responded_by', sa.Integer(), autoincrement=False, nullable=True))
+    op.add_column('procurement_tracker_step_version', sa.Column('pre_award_approval_responded_date', sa.Date(), autoincrement=False, nullable=True))
+    op.add_column('procurement_tracker_step_version', sa.Column('pre_award_approval_reviewer_notes', sa.Text(), autoincrement=False, nullable=True))
+    # ### end Alembic commands ###
+
+
+def downgrade() -> None:
+    # ### commands auto generated by Alembic - please adjust! ###
+    op.drop_column('procurement_tracker_step_version', 'pre_award_approval_reviewer_notes')
+    op.drop_column('procurement_tracker_step_version', 'pre_award_approval_responded_date')
+    op.drop_column('procurement_tracker_step_version', 'pre_award_approval_responded_by')
+    op.drop_column('procurement_tracker_step_version', 'pre_award_approval_status')
+    op.drop_constraint('fk_pre_award_responded_by', 'procurement_tracker_step', type_='foreignkey')
+    op.drop_column('procurement_tracker_step', 'pre_award_approval_reviewer_notes')
+    op.drop_column('procurement_tracker_step', 'pre_award_approval_responded_date')
+    op.drop_column('procurement_tracker_step', 'pre_award_approval_responded_by')
+    op.drop_column('procurement_tracker_step', 'pre_award_approval_status')
+    # ### end Alembic commands ###

backend/models/agreement_history.py

@@ -992,9 +992,50 @@ def create_procurement_tracker_step_update_history_event(
     """A method that generates an AgreementHistory event for an updated procurement tracker step."""
     procurement_tracker_step = event.event_details["procurement_tracker_step"]
     updates = event.event_details["procurement_tracker_step_updates"]["changes"]
+    procurement_tracker = session.get(ProcurementTracker, procurement_tracker_step["procurement_tracker_id"])
+
+    # Handle approval request events
+    if "approval_requested" in updates and updates["approval_requested"]["new_value"] is True:
+        return AgreementHistory(
+            agreement_id=procurement_tracker.agreement_id,
+            agreement_id_record=procurement_tracker.agreement_id,
+            ops_event_id=event.id,
+            history_title="Pre-Award Approval Requested",
+            history_message=f"{event_user.full_name} requested pre-award approval for step 5 of the Procurement Tracker.",
+            timestamp=event.created_on.strftime("%Y-%m-%dT%H:%M:%S.%fZ"),
+            history_type=AgreementHistoryType.PROCUREMENT_TRACKER_STEP_UPDATED,
+        )
+
+    # Handle approval response events
+    if "approval_status" in updates:
+        status = updates["approval_status"]["new_value"]
+        if status == "APPROVED":
+            history_title = "Pre-Award Approval Approved"
+            history_message = (
+                f"{event_user.full_name} approved the pre-award approval request for step 5 of the Procurement Tracker."
+            )
+        elif status == "DECLINED":
+            history_title = "Pre-Award Approval Declined"
+            history_message = (
+                f"{event_user.full_name} declined the pre-award approval request for step 5 of the Procurement Tracker."
+            )
+        else:
+            history_title = None
+
+        if history_title:
+            return AgreementHistory(
+                agreement_id=procurement_tracker.agreement_id,
+                agreement_id_record=procurement_tracker.agreement_id,
+                ops_event_id=event.id,
+                history_title=history_title,
+                history_message=history_message,
+                timestamp=event.created_on.strftime("%Y-%m-%dT%H:%M:%S.%fZ"),
+                history_type=AgreementHistoryType.PROCUREMENT_TRACKER_STEP_UPDATED,
+            )
+
+    # Handle status change events (step completion)
     if "status" not in updates:
         return None  # Only create history event for status changes
-    procurement_tracker = session.get(ProcurementTracker, procurement_tracker_step["procurement_tracker_id"])
     new_value = updates["status"]["new_value"]
     step_type = procurement_tracker_step["step_type"]
     if new_value != str(ProcurementTrackerStepStatus.COMPLETED):