Clean-Slate Re-Inventory

Replaces the original Square catalog import (~1,700 items, many stale). Medusa starts clean, populated via physical re-inventory of the store.

Workflow

  1. Fork Agilo’s Medusa POS Starter (Expo + React Native, already has barcode scanning + Medusa API integration) and adapt into ISBN scanner app
  2. Walk the store, scan each book’s ISBN
  3. App queries Ingram Web Service (or Open Library) by ISBN for metadata (title, author, publisher, cover image, description, price, format)
  4. Product created in Medusa as draft
  5. Staff reviews and publishes
  6. Non-ISBN items (dice, minis, totes, stickers) entered manually

Why This Approach

  • Medusa catalog starts clean — only what’s physically on shelves
  • This IS the Ingram enrichment tool from the spec, just used for initial inventory instead of ongoing expansion — build it once, use it forever
  • Square catalog stays as-is for POS — no cleanup required upfront
  • The sync layer only maps ISBNs that exist in both systems, which after re-inventory is exactly the active physical inventory
  • Everything in Square without a Medusa counterpart is implicitly archivable

Impact on Task Briefs

  • Brief 1.3 changes from “Square→Medusa migration script” to “ISBN scanner app + Ingram/OpenLibrary enrichment tool”
  • Phase 3 (Square POS sync) gets simpler — smaller, cleaner mapping set
  • Post-MVP Ingram integration is partially built from day one