Orders & Disputes

Overview

The orders module manages marketplace transactions from both buyer and seller perspectives, including a dispute resolution system.

Module path: src/lib/modules/orders/ Route: /orders

Order Data Model

interface Order {
  id: string;
  amountInCents: number;
  applicationFeeAmount: number; // 5% platform fee
  buyerId: string;
  sellerId: string;
  serviceId: string;
  packageId: string;
  checkoutSessionId: string;
  stripeAccountId: string;
  status: OrderStatus;
  disputeId?: string | null;
  createdAt: Timestamp;
  updatedAt: Timestamp;
}

type OrderStatus = 'pending' | 'in_progress' | 'completed' | 'cancelled' | 'refunded';

Firestore collection: marketplace_orders

Order Views

Two tabs on the orders page:

• Purchases - Orders where current user is the buyer
• Sales - Orders where current user is the seller

Filtering

• By status: pending, in_progress, completed, cancelled, refunded, disputed
• By search query

Order Stats

• Pending count
• Completed count
• Disputed count
• Total spent (purchases) / Total earned (sales)

State Management

ordersManager

ordersManager.purchases;         // Buyer orders
ordersManager.sales;             // Seller orders
ordersManager.currentOrders;     // Based on active tab
ordersManager.filteredOrders;    // After status/search filters
ordersManager.stats;             // OrderStats aggregation

ordersManager.setView('purchases' | 'sales');
ordersManager.setStatus(status);
ordersManager.setSearchQuery(query);

Dispute System

Dispute Data Model

interface Dispute {
  id: string;
  orderId: string;
  reporterId: string;
  reporterRole: 'buyer' | 'seller';
  description: string;
  evidence: DisputeEvidence[];
  status: DisputeStatus;
  resolution: DisputeResolution;
  resolvedAt?: Timestamp;
  resolvedBy?: string;
  adminNotes?: string;
  createdAt: Timestamp;
  updatedAt: Timestamp;
}

type DisputeStatus = 'open' | 'in_review' | 'resolved';
type DisputeResolution = 'fee_refunded' | 'handle_directly' | null;

interface DisputeEvidence {
  id: string;
  url: string;
  name: string;
  type: string;
  size: number;
  uploadedAt: Timestamp;
}

Firestore collection: marketplace_disputes

Creating a Dispute

1. User clicks “Report Issue” on an order card
2. Enters description (min 20 characters)
3. Uploads evidence files (max 5 files, 10MB each, images/PDFs)
4. Files uploaded to Firebase Storage: disputes/{orderId}/{fileId}_{filename}
5. Dispute created and linked to order via disputeId
6. Email templates generated for admin, buyer, and seller

Dispute Resolution

Admin resolves with either:

• fee_refunded - Platform fee refunded
• handle_directly - Parties handle directly

disputesManager

disputesManager.allDisputes;       // Admin view
disputesManager.userDisputes;      // Current user's disputes
disputesManager.filteredDisputes;  // After filters

disputesManager.createDispute(orderId, description, evidence, role);
disputesManager.resolveDispute(disputeId, resolution, adminNotes);
disputesManager.hasOpenDispute(orderId);

Components

Component	Purpose
orders-list.svelte	Main view with tabs and filters
orders-stats.svelte	Stats cards
order-card.svelte	Individual order with actions
order-details-modal.svelte	Full order information
report-issue-modal.svelte	Dispute creation with file upload
dispute-details-modal.svelte	Dispute information and evidence

Order Actions

Per order card:

• View Details - Full order information
• Message - Open chat with other party
• Report Issue - Create dispute (if no open dispute)
• View Dispute - See existing dispute details