# Implementation summary — AN-88

**Design:** Opportunity Contact Role Close-Won Guard

## Files written
- `force-app/main/default/triggers/OpportunityTrigger.trigger`
- `force-app/main/default/triggers/OpportunityTrigger.trigger-meta.xml`
- `force-app/main/default/classes/OpportunityContactRoleCloseWonHandler.cls`
- `force-app/main/default/classes/OpportunityContactRoleCloseWonHandler.cls-meta.xml`
- `force-app/main/default/classes/OpportunityContactRoleCloseWonHandlerTest.cls`
- `force-app/main/default/classes/OpportunityContactRoleCloseWonHandlerTest.cls-meta.xml`

## Retrieved existing metadata

- Source: repo:agentnovatech-cloud/POC@main
- No existing versions found — all files are new

## Acceptance criteria

- When a user attempts to change an Opportunity's Stage to Closed Won, check whether it has at least one related OpportunityContactRole record.
- If no related Contact Role exists, block the save and display: "Validation Error: You cannot close-win this Opportunity without assigning at least one Contact Role. Please add a contact to the Opportunity Contact Roles related list and try again."
- Apply the rule to users editing via the UI; exclude standard system integration users if applicable.