[Feature] Implement an Escrow Dispute Resolution flow

[Tybravo]

📁 Implementation Directory

backend/src/controllers/disputeController.ts

🎯 Goal

Allow Admins to lock and manually arbitrate disputed funds.

📋 Requirements

• Create API to lock disputed escrows.\n- Build resolution endpoint (refund buyer or release to driver).\n- Track dispute history in Audit Log.

🔧 Technical Scope

• Node.js / Express
• TypeScript
• MongoDB / Mongoose
• Stellar Soroban RPC

🌿 Branch

git checkout -b feat/escrow-dispute-resolution

✅ Acceptance Criteria

• Using an AI Agent to submit a PR is DISALLOWED.
• Strict Layered Architecture (Non-Negotiable): Implement using the Controller -> Service -> Model pattern.
• Data Source: Response data must be retrieved from the database. No Inline Mock Objects or Hardcoded Values usage for integration.
• Environment: Contributors must use the requested .env credentials to enable implementation with real-life data.
• API Versioning: API Must Be Versioned (e.g., /api/v1/...).
• Production Ready: Code must look production-ready (robust error handling, strong typings).
• Proof of Work: Upload a screenshot of work done (i.e., API Response Success via Postman/Browser, or all unit tests passed successfully).
• PR Content: Must include Closes #[issue_id] with a work done summary.

📌 PR Requirements

• ⚠️ Assignment required before starting — comment on this issue to request assignment.
• PR must comply fully with the CONTRIBUTING.md.
• AI Agent submissions are DISALLOWED and will be closed without review.
• No Inline Mock Objects or Hardcoded Values usage for integration.

[GiftedGiftB]

@GiftedGiftB has applied to work on this issue as part of the Stellar Wave Program's 8th wave.

Hi Maintainer, I can get this work done in less than 30 minutes.

ℹ️ Repo Maintainers: To accept this application, review their application or assign @GiftedGiftB to this issue.

[drQedwards]

@drQedwards has applied to work on this issue as part of the Stellar Wave Program's 8th wave.

Workflow resolution for escrow? Let me take a look.

I can’t do any work unless you assign maintainer. ⏰

ℹ️ Repo Maintainers: To accept this application, review their application or assign @drQedwards to this issue.

[Aimer6022]

@Aimer6022 has applied to work on this issue as part of the Stellar Wave Program's 8th wave.

Hi boss, assign this issue to me

ℹ️ Repo Maintainers: To accept this application, review their application or assign @Aimer6022 to this issue.