Can I vibe code ZigZag Global?

Build a full-stack Shopify app for managing returns and exchanges using Node.js/Express, React (Shopify Polaris UI), Prisma ORM, and PostgreSQL.

DATA MODEL:
1. MerchantConfig: shopifyDomain, portalSettings (logo, secondaryColor, customCss), returnWindowDays, defaultReturnPolicy, allowsExchanges, allowsStoreCredit.
2. ReturnRule: id, merchantId, name, condition (e.g., reason == 'DEFECTIVE' OR category == 'FINAL_SALE'), action (REJECT, APPROVE, MANUAL_REVIEW, REASON_REQUIRED), feeType (FIXED, PERCENTAGE, FREE), feeAmount.
3. ReturnRequest: id, shopifyOrderId, orderName, customerEmail, status (PENDING, APPROVED, REJECTED, LABEL_GENERATED, RECEIVED, COMPLETED, REFUNDED), returnMethod (CARRIER_LABEL, QR_CODE, IN_STORE), trackingNumber, trackingUrl, carrierName, labelPdfUrl, totalRefundAmount, exchangeOrderId, createdAt.
4. ReturnLineItem: id, returnRequestId, shopifyLineItemId, sku, title, variantTitle, quantity, reason, conditionNotes, itemStatus (PENDING, ACCEPTED, RESTOCKED, DISPOSED).

CUSTOMER RETURN PORTAL (Public Route):
- Hosted page accessible at /apps/returns/:shop Domain or embedded via app proxy.
- Step 1: Authentication via Order Number (#1001) and Email/Zip Code. Fetch line items from Shopify Admin API (graphql: `orders`). Filter out non-returnable items based on purchase date vs ReturnConfig.returnWindowDays.
- Step 2: Item Selection. Checkbox per item, dropdown for return reasons (e.g., Too Small, Item Defective, Changed Mind), quantity selector, upload image attachment.
- Step 3: Resolution Choice. Options: Refund to Original Payment, Exchange for Variant (fetch available variants via Shopify GraphQL API), or Issue Store Credit (Shopify Gift Card / Customer Credit).
- Step 4: Submission & Label Generation. Evaluate ReturnRules. If APPROVED, invoke carrier API (EasyPost or Shippo API wrapper) to create a return shipping label with prepaid tracking. Display printable label PDF and QR code for carrier drop-off (Evri / Royal Mail / USPS).

MERCHANT ADMIN DASHBOARD (Shopify Embedded App using Polaris):
- Dashboard View: KPI metrics (Total Returns, Return Rate %, Pending Approvals, Total Value Refunded).
- Returns List View: Table showing return status, customer name, items, tracking info, quick actions (Approve, Reject, Issue Refund, Restock).
- Return Detail Page: Full view of returned line items, inspection status selector (Restock, Damage, Dispose), manual override for label generation, and action buttons:
  * "Issue Shopify Refund": Calls Shopify GraphQL API `returnRequest` / `refundCreate` to recalculate taxes, restock inventory items to specified location, and execute partial/full refund.
  * "Create Exchange": Calls Shopify GraphQL API `draftOrderCreate` for exchange items, applying full credit of returned items, and triggering fulfillment.
- Rules Engine Settings: UI to build conditional logic (e.g., "If reason is Defective, fee is $0; if reason is Changed Mind, deduct $5.00 label fee from refund").

CARRIER & SYSTEM INTEGRATION:
- Carrier Provider Interface: Pluggable service supporting EasyPost, Shippo, or raw API calls to create return labels. Generate label PDF buffer and store in S3-compatible storage.
- Webhooks: Listen to Shopify `orders/fulfilled`, `refunds/create`, and carrier tracking webhooks (e.g., package scanned in transit, delivered to hub) to update ReturnRequest status automatically.

OUT OF SCOPE:
- Physical warehouse consolidation logistics.
- Custom international customs duty reclaim filing engines.

FAILURE MODES TO HANDLE:
- Shopify API rate limiting during high-volume sales (use leaky bucket queue).
- Carrier API error response (e.g., invalid address) - fall back to MANUAL_REVIEW state gracefully without failing customer session.

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