How miusicbox/miusic works
MIUSIC BOX is a browser-based music catalog and sales application with customer ordering and an administrative interface. Customers browse songs and playlists, add items to a cart, receive discount and promotion pricing, and place or look up orders. Administrators manage catalog and pricing data, accounts, and order processing, including ZIP downloads. The tree and excerpts support the client-to-Worker-to-D1 architecture and selected storage flows; some page wiring and feature details are inferred only from filenames, so uncertain links are omitted.
Main entry points: index.js API and ZIP jobs · db-client.js Document API client · app-user.js Catalog and orders · storage-adapter.js Upload adapter
Components 20
Customer storefront
- Storefront page
index.html - Catalog and orders
app-user.js - Cart and checkout
app-cart.js - Discounts and promotions
app-promotion.js
Administration
- Admin page
admin.html - Catalog management
app-admin.js - Order management
orders.js - Admin roles
admin-roles.js - Authentication client
auth-client.js - Upload adapter
storage-adapter.js
Worker services
- Document API client
db-client.js - API and ZIP jobs
worker/index.js - Session and passwords
worker/auth-helpers.js - Document operations
worker/db-helpers.js - Streaming ZIP format
worker/zip-format.js
Persistence and files
- Cloudflare D1
- Object storage
Other components
- Customer
- Administrator
- Cloudinary
Connections 25
- Customer → Storefront page: opens
- Storefront page → Catalog and orders: loads
- Catalog and orders → Cart and checkout: adds items
- Catalog and orders → Discounts and promotions: loads pricing
- Cart and checkout → Discounts and promotions: gets pricing
- Catalog and orders → Document API client: reads catalog
- Cart and checkout → Document API client: reads and saves
- Administrator → Admin page: opens
- Admin page → Catalog management: loads
- Admin page → Order management: loads
- Catalog management → Document API client: manages catalog
- Catalog management → Upload adapter: uploads files
- Order management → Document API client: manages orders
- Order management → Upload adapter: requests files
- Admin roles → Document API client: accesses data
- Authentication client → API and ZIP jobs: calls auth API
- Document API client → API and ZIP jobs: calls data API
- API and ZIP jobs → Session and passwords: uses sessions
- API and ZIP jobs → Document operations: uses document operations
- Session and passwords → Cloudflare D1: reads and writes sessions
- Document operations → Cloudflare D1: reads and writes documents
- API and ZIP jobs → Streaming ZIP format: builds ZIP streams
- API and ZIP jobs → Object storage: reads and writes files
- Upload adapter → Cloudinary: uploads
- Upload adapter → API and ZIP jobs: requests R2 upload