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
- Fork Agilo’s Medusa POS Starter (Expo + React Native, already has barcode scanning + Medusa API integration) and adapt into ISBN scanner app
- Walk the store, scan each book’s ISBN
- App queries Ingram Web Service (or Open Library) by ISBN for metadata (title, author, publisher, cover image, description, price, format)
- Product created in Medusa as draft
- Staff reviews and publishes
- 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