================================================================
 USER STORY TEMPLATE (v1.0)
 Source: ad1tya.tech/knowledge
================================================================

TITLE: 
[ROLE] - [ACTION] - [CONTEXT]
(e.g., Admin - Delete User - Soft Delete only)

----------------------------------------------------------------
1. THE STORY (The "Card")
----------------------------------------------------------------
AS A:    [Role / Persona]
I WANT:  [Action / Feature]
SO THAT: [Benefit / Value]

----------------------------------------------------------------
2. THE CONTEXT (The "Conversation")
----------------------------------------------------------------
Description:
[Provide 2-3 sentences on HOW this should work. Mention any specific UI constraints or logic.]

Links:
- Design (Figma): [Insert Link]
- API Docs (Swagger): [Insert Link]

----------------------------------------------------------------
3. ACCEPTANCE CRITERIA (The "Confirmation")
----------------------------------------------------------------
Scenario 1: Happy Path
GIVEN: [User is on the page]
WHEN:  [User performs action]
THEN:  [System saves data AND shows success message]

Scenario 2: Error Handling
GIVEN: [User enters invalid data]
WHEN:  [User clicks submit]
THEN:  [System shows red error "XYZ" AND data is NOT saved]

----------------------------------------------------------------
4. TECHNICAL NOTES (For Devs)
----------------------------------------------------------------
- Database fields affected: [e.g., Users Table]
- Browser compatibility: [e.g., Mobile responsive?]
- Analytics events to track: [e.g., "user_deleted" event]