How matthewlbitz/shelf-lookup works
KTRU Shelf Lookup is a local web application for managing a physical music collection. Operators search the catalog, assign or scan barcodes, and use guided stacks to move records through assignment, column sorting, and shelf placement; progress is persisted for later resumption. Separate workflows support artist-name sorting and legacy batch handoffs. The graph includes the indexed core modules and documented capabilities; some browser-to-server links are based on README descriptions because those page implementations were not excerpted.
Main entry points: server.js HTTP server · discogs-lookup.js UPC lookup · workflow-store.js Guided workflow API · masterAlbums.db Collection database
Components 20
Operator workflows
- Catalog tools
index.html - Guided stacks
workflow.html - Workflow client
workflow.js - Batch sorting
batch-sort.js - Stack receiving
receive-stacks.html - Stack receiver
receive-stacks.js - Artist sorter
artist-sorter.html
Catalog services
- HTTP server
server.js - Catalog normalization
catalog-utils.js - Search ranking
search-ranking.js - Ordered barcodes
ordered-search.js - UPC lookup
discogs-lookup.js - Discogs API
Artist sorting
- Artist rules
artist-resolution.js - Artist resolver
resolve-artists.js - MusicBrainz
Persistence
- Guided workflow API
workflow-store.js - Shared stack API
shared-stacks.js - Collection database
masterAlbums.db
Other components
- Operator
Connections 27
- Operator → Catalog tools: uses
README.md - Operator → Guided stacks: uses
README.md - Operator → Artist sorter: uses
README.md - Catalog tools → HTTP server: requests catalog actions
README.md - Guided stacks → Workflow client: runs workflow
README.md - Workflow client → Guided workflow API: updates stacks
- Guided workflow API → Collection database: reads and writes
README.md - Guided workflow API → Ordered barcodes: uses barcode ranges
workflow-store.js - Batch sorting → HTTP server: looks up barcodes
batch-sort.js - Batch sorting → Shared stack API: hands off stacks
README.md - Stack receiving → Stack receiver: runs receiver
README.md - Stack receiver → Shared stack API: claims and advances
- Shared stack API → Collection database: stores handoffs
README.md - Artist sorter → HTTP server: requests sort actions
README.md - HTTP server → Collection database: queries and updates
README.md - HTTP server → Guided workflow API: installs routes
server.js - HTTP server → Artist rules: fills local values
server.js - HTTP server → UPC lookup: looks up UPCs
server.js - HTTP server → Catalog normalization: imports utilities
server.js - HTTP server → Search ranking: uses ranking
server.js - Search ranking → Catalog normalization: normalizes queries
search-ranking.js - UPC lookup → Catalog normalization: normalizes UPCs
discogs-lookup.js - UPC lookup → Search ranking: ranks suggestions
discogs-lookup.js - UPC lookup → Discogs API: queries releases
discogs-lookup.js - Artist resolver → Artist rules: uses shared rules
resolve-artists.js - Artist resolver → MusicBrainz: queries artists
resolve-artists.js - Artist resolver → Collection database: reads and updates
resolve-artists.js