1. What Are Large Services?

Large Services on Mujtahid Ofaq Platform are complex, high-value tasks requiring private tutor assignment, milestone tracking, and escrow-protected payments. Unlike Small Services (AI-powered instant answers), Large Services involve:

Code Reference: ServiceRequest::$requestSizeLarge = 'large' (app/Models/ServiceRequest.php:63)

2. Request Lifecycle (8 Official Statuses)

Every Large Service request on Mujtahid Ofaq Platform follows this workflow:

            const STATUS_PENDING = 'pending';                          // Awaiting student decision
            const STATUS_AWAITING_PAYMENT = 'awaiting_payment';        // Proposal accepted, payment processing
            const STATUS_AWAITING_STUDENT_DECISION = 'awaiting_student_decision';  // Private tutor delivered
            const STATUS_IN_PROGRESS = 'in_progress';                  // Active work phase
            const STATUS_REVISION_REQUESTED = 'revision_requested';    // Student requested changes
            const STATUS_COMPLETED = 'completed';                      // Final approval
            const STATUS_REJECTED = 'rejected';                        // Proposal declined
            const STATUS_CANCELLED = 'cancelled';                      // Assignment terminated
            

3. Proposal System

On Mujtahid Ofaq Platform, private tutors submit competitive proposals with pricing, timeline, and approach. Students compare and select:

3.1 Proposal Statuses

• Waiting for review: Private tutor submitted, student reviewing
• Accepted: Student chose this proposal, payment processing begins
• Declined: Student declined this proposal

3.2 Proposal Contents

Each proposal includes:

• Proposed Price: Private tutor's quote (student sees final price including 10% platform fee)
• Estimated Delivery: Timeline (minimum 1 hour, maximum 30 days)
• Approach: Text explaining methodology
• Private Tutor Profile: Rating, completed tasks, specializations

3.3 Auto-Assignment

When demand is high (workload > 80%), Mujtahid Ofaq Platform may auto-assign to the highest-rated tutor to maintain service quality.

Code: app/Services/ExpertPressure/ExpertLoadCalculator.php

4. Escrow & Financial Protection

Mujtahid Ofaq Platform holds all payments in secure escrow until delivery confirmation:

4.1 Escrow Flow

        Student Payment → Platform Escrow (held 30 days) → Private Tutor's Wallet (ready for withdrawal)
                                                        ↓
                                                Auto-release after 100 days (safety mechanism)
        

4.2 Configuration

Source: app/Services/LargeService/LargeServiceFinancialProcessor.php:20-22

        freeze_period_minutes: 43,200           // = 30 days (production)
        SAFETY_PERIOD: 100 days                 // Maximum hold duration
        

4.3 Release Triggers

1. Student Approval: Student approves → funds released immediately
2. Automatic Approval: 48 business hours after delivery with no dispute
3. Safety Release: After 100 days (prevents indefinite hold)

4.4 Release Code Example

        if ($serviceRequest->status === 'completed') {
            $earning->update([
                'status' => 'available',              // Ready for withdrawal
                'release_reason' => 'task_completed',
                'released_at' => now()
            ]);
        }

        if ($earning->created_at <= now()->subDays(100)) {
            $earning->update([
                'status' => 'available',              // Ready for withdrawal
                'release_reason' => 'auto_safety_release_100d'
            ]);
        }
        

Source: app/Services/LargeService/LargeServiceFinancialProcessor.php:159-186

5. Dispute System (6 Official Types)

When issues arise, either party can open a dispute with evidence. Mujtahid Ofaq Platform provides structured resolution:

5.1 Dispute Types & Refund Percentages

Source: app/Models/LargeService/Dispute/ServiceDispute.php:44-49

5.2 Dispute Lifecycle (8 Statuses)

1. Dispute opened: Dispute submitted, waiting for private tutor response
2. Waiting for tutor: Private tutor has 24 hours to respond
3. Tutor accepted: Private tutor agreed to proposed resolution
4. Escalated to admin: Requires Mujtahid Ofaq Platform mediation
5. Under review: Admin team investigating with evidence
6. Waiting for response: Waiting for one party to respond
7. Settled: Decision made, funds distributed
8. Closed: Dispute closed (no action taken)

5.3 Evidence Requirements

Mujtahid Ofaq Platform automatically collects:

• All conversation messages (timestamps preserved)
• File uploads (immutable after submission)
• Delivery confirmations
• Revision requests and responses
• Budget change history

6. Budget Change Requests

When project scope expands, either party can request budget adjustment:

6.1 Who Can Request?

• Private tutor-initiated: Additional work discovered, requires more budget (5% fee applies)
• Student-initiated: Student wants to add features (3% fee applies)

6.2 Budget Change Fees

Source: app/Models/LargeService/Budget/BudgetChangeRequest.php:78-79

        const FEE_PERCENTAGE_EXPERT_REQUEST = 5;    // Private tutor pays 5% on increase
        const FEE_PERCENTAGE_STUDENT_REQUEST = 3;   // Student pays 3% on increase
        

6.3 Validation Rules

• Amount: min: original_budget × 0.1, max: original_budget × 3
• Validity: 48 hours to accept/reject
• Limit: Max 3 budget changes per request

6.4 Statuses

1. Waiting for approval: Other party reviewing the request
2. Approved: Accepted, payment processed
3. Declined: Request rejected, project continues with original budget
4. Expired: No response within 48 hours

7. Team Delegation System

On Mujtahid Ofaq Platform, private tutors can delegate tasks to collaborators with granular permission control:

7.1 Delegation Roles

• Primary Private Tutor (Owner): Full control, receives payment
• Collaborator: Assigned specific permissions, receives compensation share
• Observer: View-only access

7.2 Permission Types (60+ Available)

Sample permissions:

        'view_request_details'
        'submit_delivery'
        'respond_to_revision'
        'upload_files'
        'send_messages'
        'request_budget_change'
        'accept_proposal'           // Only owner by default
        'cancel_request'            // Only owner
        

7.3 Compensation Distribution

Owner sets compensation percentage for each collaborator:

• Total collaborator shares cannot exceed 70% of private tutor earnings
• Owner must retain at least 30%
• Compensation calculated AFTER Mujtahid Ofaq Platform fee deduction

Example:

        Service Price: $1,000
        Mujtahid Ofaq Platform Fee (10%): -$100
        Net Private Tutor Earnings: $900

        Owner: 50% = $450
        Collaborator A: 30% = $270
        Collaborator B: 20% = $180
        

8. Fees & Commission Structure

8.1 Mujtahid Ofaq Platform Fee: 10%

VERIFIED: Mujtahid Ofaq Platform charges 10% across all service types (courses, books, large services, subscriptions).

Source: app/Listeners/ProcessCreditPayment.php:354

        $platformFeeRate = config('finance.subscription_platform_fee_rate', 0.10); // 10%
        

8.2 Complete Commission Breakdown

8.3 Revenue Distribution (Mujtahid Ofaq Platform)

How Mujtahid Ofaq Platform uses the 10% fee:

        60% → Shareholders
        25% → Marketing & Growth
        10% → Operations
         5% → Reserve Fund
        

8.4 Payment Calculation Example

        Service Request: $1,000 (excluding VAT)

        STEP 1: Platform Fee
        Platform Fee (10%): $100
        Remaining: $900

        STEP 2: Referral Commission (if applicable)
        Referral Commission (5% of net): $45
        After Referral: $855

        STEP 3: Private Tutor Receives
        Private Tutor Net Earnings: $855

        STEP 4: Delegation (if applicable)
        If private tutor delegated 30% to collaborator:
          Owner: $598.50 (70% of $855)
          Collaborator: $256.50 (30% of $855)
        

8.5 Payment Status Explained

• In escrow: Payment held securely by Mujtahid Ofaq Platform, waiting for delivery confirmation
• On hold: Under dispute or compliance review
• Ready for withdrawal: Released, you can withdraw to your bank account
• Withdrawn: Successfully transferred to your bank account