Can I vibe code Swap Commerce?

1. System Overview: Build a lightweight customer self-service return portal integrated with Shopify Admin API and a shipping aggregator API (e.g., EasyPost or Shippo). The system enables customers to initiate returns, select reasons, choose exchanges or store credit, and download pre-paid shipping labels.

2. Data Model:
- ReturnRequest: id, order_id, customer_id, status (pending, approved, received, refunded), return_type (refund, store_credit, exchange), tracking_number, label_url, shipping_cost, created_at.
- ReturnItem: id, return_request_id, line_item_id, sku, quantity, reason_code, condition, exchange_sku.
- ReturnPolicyRule: id, max_days_allowed, restocking_fee, non_returnable_categories, allow_exchanges.

3. Core Logic & API Integrations:
- Shopify Admin API: Fetch order history by order number + email. Validate eligibility against store policy rules.
- Shipping API (EasyPost/Shippo): Create a return label using merchant's carrier account. Store tracking code and PDF label URL.
- Exchange Workflow: Allow selecting a new SKU. Calculate price delta. If balance due, trigger Shopify draft order checkout; if credit due, queue a partial refund or Shopify Gift Card.
- Webhooks: Listen to carrier tracking updates (DELIVERED status). Automatically trigger Shopify restock/refund mutation based on merchant approval settings.

4. Failure Modes & Edge Cases:
- Expired return window: Display policy explanation and allow custom contact form fallback.
- Out of stock exchange items: Revert selection and default to store credit or refund.
- Carrier API outage: Queue label generation job and inform user label will be emailed within 1 hour.

5. Out of Scope: Cross-border duty drawback calculations, physical warehouse receiving/inspection workflows, and B2B recycling network liquidation.

$ each button prefixes agent-specific run instructions · build your own product, never copy proprietary code, trademarks or designs