Added logic to handle cross validation for AWARD_REF and REF_NUMBER u…

…niqueness

backend/audit/cross_validation/award_ref_and_references_uniqueness.py

@@ -0,0 +1,42 @@
+from .errors import (
+    err_award_ref_repeat_reference,
+)
+from collections import defaultdict
+
+
+def award_ref_and_references_uniqueness(sac_dict, *_args, **_kwargs):
+    """
+    Ensure the REFERENCE numbers uniqueness for a given AWARD in findings.
+    """
+
+    all_sections = sac_dict.get("sf_sac_sections", {})
+    findings_uniform_guidance_section = (
+        all_sections.get("findings_uniform_guidance") or {}
+    )
+    findings_uniform_guidance = findings_uniform_guidance_section.get(
+        "findings_uniform_guidance_entries", []
+    )
+
+    ref_numbers = defaultdict(set)
+    duplicate_ref_number = defaultdict(set)
+    errors = []
+
+    for finding in findings_uniform_guidance:
+        award_ref = finding["program"]["award_reference"]
+        ref_number = finding["findings"]["reference_number"]
+        if ref_number in ref_numbers[award_ref]:
+            duplicate_ref_number[award_ref].add(ref_number)
+        ref_numbers[award_ref].add(ref_number)
+
+    for award_ref, ref_nums in duplicate_ref_number.items():
+        for ref_num in ref_nums:
+            errors.append(
+                {
+                    "error": err_award_ref_repeat_reference(
+                        award_ref,
+                        ref_num,
+                    )
+                }
+            )
+
+    return errors

backend/audit/cross_validation/errors.py

@@ -29,3 +29,7 @@ def err_missing_tribal_data_sharing_consent():
         "As a tribal organization, you must complete the data "
         "sharing consent statement before submitting your audit."
     )
+
+
+def err_award_ref_repeat_reference(award_ref, ref_number):
+    return f"Award {award_ref} repeats reference {ref_number}. The reference {ref_number} should only appear once for award {award_ref}."