Add AQMM task evidence and review notes workflow

app/modules/documents/services.py

@@ -527,6 +527,17 @@ def release_document_final(
         raise ValueError("UDIN is required before final release for this document.")
     if document.udin_required and document.udin_status != "generated":
         raise ValueError("UDIN status must be Generated before final release.")
+
+    # Phase 4 AQMM final release gate. Assurance engagements can release final
+    # documents only after the AQMM-tagged task evidence/review trail is complete.
+    engagement = document.engagement or db.get(ClientServiceSubscription, document.engagement_id)
+    if engagement is not None:
+        from app.modules.services.client_services import quality_required_for_engagement
+        from app.modules.services.execution import assert_aqmm_quality_tasks_complete
+
+        if quality_required_for_engagement(getattr(engagement, "engagement_type", None)):
+            assert_aqmm_quality_tasks_complete(db, subscription_id=int(engagement.id))
+
     document.final_release_status = "released"
     document.status = "final"
     document.released_by_user_id = getattr(user, "id", None)