docs: import qa workflow knowledge from grilling session

docs/workflow-steps.md

@@ -0,0 +1,46 @@
+---
+last_updated: 2025-07-15
+tags: [workflow, steps, blame, claim, yara724]
+source: import-knowledge
+---
+
+# Workflow Steps — Yara724 Case Lifecycle
+
+Granular progression within each phase. Steps are ordered — a Case moves through them sequentially.
+
+## Relationships
+
+- **Case** is the top-level entity — contains one Blame and one Claim.
+- **Blame** determines whether the Case proceeds to **Claim** (via Expert) or resolves directly (parties agree).
+- **Claim** is only active when Blame results in DISAGREEMENT and Expert is involved.
+- A Case can end at any point via CANCELLED or AUTO_CLOSED.
+
+## Blame Steps
+
+1. CREATED
+2. FIRST_BLAME_CONFESSION
+3. FIRST_VIDEO
+4. FIRST_INITIAL_FORM
+5. FIRST_LOCATION
+6. FIRST_VOICE
+7. FIRST_DESCRIPTION
+8. FIRST_INVITE_SECOND
+9. SECOND_INITIAL_FORM
+10. SECOND_LOCATION
+11. SECOND_VOICE
+12. SECOND_DESCRIPTION
+
+## Claim Workflow Steps
+
+1. CLAIM_CREATED
+2. SELECT_OUTER_PARTS
+3. SELECT_OTHER_PARTS
+4. CAPTURE_PART_DAMAGES
+5. UPLOAD_REQUIRED_DOCUMENTS
+6. USER_SUBMISSION_COMPLETE
+7. USER_EXPERT_RESEND (user fulfills Expert's request for more documents/photos)
+8. EXPERT_DAMAGE_ASSESSMENT
+9. EXPERT_FINAL_REPLY (after user objection — Expert's last priced reply)
+10. EXPERT_COST_EVALUATION
+11. INSURER_REVIEW
+12. CLAIM_COMPLETED