name: business-logic description: Business logic, order lifecycle, workflow states, quality gates, and pricing rules. Use when implementing order features or understanding business workflows. user-invocable: true

Business Logic & Workflows

Order Lifecycle

NEW → PROCESSING → QA → READY → DELIVERED → COMPLETED

Order States

• NEW: Order created, awaiting processing
• PROCESSING: Items being cleaned
• QA: Quality assurance check
• READY: Ready for pickup/delivery
• DELIVERED: Delivered to customer
• COMPLETED: Payment received, order closed

Workflow Transitions

const validTransitions = {
  NEW: ['PROCESSING', 'CANCELLED'],
  PROCESSING: ['QA', 'CANCELLED'],
  QA: ['READY', 'PROCESSING'],  // Can return to processing if fails QA
  READY: ['DELIVERED', 'CANCELLED'],
  DELIVERED: ['COMPLETED'],
  COMPLETED: [],
  CANCELLED: []
};

Pricing Rules

Base Pricing

• Price per item based on service type
• Weight-based pricing for bulk items
• Express service surcharge (20%)

Discounts

• Loyalty points redemption
• Bulk order discounts
• Subscription/plan discounts

Tax Calculation

function calculateOrderTotal(items: OrderItem[], customerId: string) {
  const subtotal = items.reduce((sum, item) => {
    return sum + (item.quantity * item.unitPrice);
  }, 0);

  const discounts = calculateDiscounts(customerId, subtotal);
  const subtotalAfterDiscount = subtotal - discounts;

  const tax = subtotalAfterDiscount * getTaxRate();
  const total = subtotalAfterDiscount + tax;

  return { subtotal, discounts, tax, total };
}

Quality Gates

QA Checklist

• All items cleaned per specifications
• No damage to items
• Proper folding/packaging
• Customer special instructions followed

Failed QA

If QA fails, order returns to PROCESSING with notes on what needs correction.

Payment Workflows

Payment Methods

• Cash on delivery
• Card payment
• Wallet/credit balance
• Multiple payment methods allowed per order

Payment Recording

{
  order_id: 'uuid',
  payment_method: 'CASH' | 'CARD' | 'WALLET',
  amount: 100.00,
  status: 'PENDING' | 'COMPLETED' | 'FAILED',
  payment_date: '2025-01-29T10:00:00Z'
}

Customer Loyalty

Points Earning

• Earn points on each completed order
• 1 point per OMR spent
• Bonus points for referrals

Points Redemption

• Redeem points for discounts
• 100 points = 1 OMR discount
• Minimum redemption: 500 points

Additional Resources

• See reference.md for complete business logic documentation