How harashsuq-ui/harashsuq works
Harashsuq is a browser-based marketplace for AI-work assets, with seller uploads and reviewed listings, buyer checkout, and access to purchased files. The browser app calls the Node HTTP server, which dispatches API routes to business services and persists marketplace state in SQLite. Payments use an external on-chain fee-splitting rail; the repository also documents a PYMSTR checkout option. The graph preserves these product areas while grouping unsampled route and service details at their existing directories; some internal wiring is therefore shown only where supported by the README or excerpts.
Main entry points: routes Marketplace routes · db/index.js SQLite database · server.js HTTP server · routes/index.js API dispatch
Components 23
Browser application
- Marketplace UI
marketplace/public/js/app.js - Product pages
marketplace/public/js/pages - Browser API
marketplace/public/js/api.js
HTTP and identity
- HTTP server
marketplace/server.js - API dispatch
marketplace/src/routes/index.js - Identity routes
marketplace/src/routes/auth.js - Marketplace routes
marketplace/src/routes
Marketplace operations
- Account services
marketplace/src/services/userService.js - Listings and search
marketplace/src/services/assetService.js - Upload review
marketplace/src/lib/review.js - Buyer reviews
marketplace/src/services/reviewService.js
Orders and payments
- Cart and orders
marketplace/src/services/orderService.js - On-chain checkout
marketplace/src/services/invoiceService.js - PYMSTR checkout
marketplace/src/services/pymstrRail.js - Purchase access
marketplace/src/services/entitlementService.js - File delivery
marketplace/src/services/downloadService.js
State and integrations
- SQLite database
marketplace/src/db/index.js - Asset storage
marketplace/src/lib/storage.js - BSC and fee proxy
- Cloudflare R2
- PYMSTR provider
Other components
- Buyer
- Seller
Connections 29
- Buyer → Marketplace UI: browses and buys
- Seller → Marketplace UI: lists assets
- Marketplace UI → Product pages: renders routes
- Product pages → Browser API: requests data
- Browser API → HTTP server: sends API requests
- HTTP server → API dispatch: dispatches requests
- API dispatch → Identity routes: dispatches auth
- API dispatch → Marketplace routes: dispatches marketplace
- Identity routes → Account services: uses account logic
- Marketplace routes → Listings and search: uses listing logic
- Marketplace routes → Upload review: reviews uploads
- Marketplace routes → Buyer reviews: uses review logic
- Marketplace routes → Cart and orders: uses order logic
- Marketplace routes → On-chain checkout: uses checkout logic
- Marketplace routes → PYMSTR checkout: uses alternate rail
- Marketplace routes → Purchase access: uses access logic
- Marketplace routes → File delivery: serves downloads
- Listings and search → SQLite database: reads and writes
- Buyer reviews → SQLite database: reads and writes
- Cart and orders → SQLite database: reads and writes
- On-chain checkout → SQLite database: reads and writes
- Account services → SQLite database: reads and writes
- Cart and orders → Purchase access: activates purchases
- File delivery → Asset storage: reads asset files
- Upload review → Asset storage: stores uploads
- Asset storage → Cloudflare R2: stores large assets
- On-chain checkout → BSC and fee proxy: verifies payments
- PYMSTR checkout → PYMSTR provider: uses provider
- HTTP server → SQLite database: initializes database