How venomous-pie/knot-and-bloom works
Knot & Bloom is a curated marketplace connecting buyers with verified Filipino makers. Buyers discover products, place deposit-backed orders, and track fulfillment; sellers onboard and manage listings and orders, while admins curate products and resolve disputes. The graph separates the customer-facing app, API entry and domain handlers, marketplace services, and persistence. Source excerpts show product routing, checkout dependencies, and review routing; other capability links reflect the README or are left unconnected where implementation wiring was not sampled.
Main entry points: index.ts HTTP API · CheckoutController.ts Checkout and orders · prismaUtils.ts Database client · productRoutes.ts Product routes
Components 25
Marketplace app
- Buyer experience
frontend/app - Seller workspace
frontend/app/seller-dashboard - Admin workspace
frontend/app/admin
API and domain handlers
- HTTP API
backend/src/index.ts - Product routes
backend/src/routes/productRoutes.ts - Catalog management
backend/src/controllers/ProductController.ts - Checkout and orders
backend/src/controllers/CheckoutController.ts - Review routes
backend/src/routes/reviewRoutes.ts - Reviews
backend/src/controllers/ReviewController.ts - Accounts
backend/src/controllers/AccountController.ts - Seller onboarding
backend/src/controllers/SellerController.ts - Disputes
backend/src/controllers/DisputeController.ts - Authentication
backend/src/middleware/authMiddleware.ts
Marketplace services
- Listing assistance
backend/src/services/GenerateService.ts - Payment handling
backend/src/services/PaymentService.ts - Pricing and fees
backend/src/utils/pricingUtils.ts - Shipping configuration
backend/src/utils/platformConfigUtils.ts - Audit records
backend/src/services/AuditService.ts - Scheduled operations
backend/src/services/cronService.ts - Media storage
backend/src/services/SupabaseService.ts
Persistence
- Database client
backend/src/utils/prismaUtils.ts - Marketplace database
Other components
- Buyers
- Makers
- Marketplace admins
Connections 24
- Buyers → Buyer experience: browse and buy
README.md - Makers → Seller workspace: manage storefront
README.md - Marketplace admins → Admin workspace: curate and resolve
README.md - Buyer experience → HTTP API: requests
- Seller workspace → HTTP API: requests
- Admin workspace → HTTP API: requests
- HTTP API → Product routes: mounts routes
backend/src/index.ts - Product routes → Catalog management: dispatches catalog
backend/src/routes/productRoutes.ts - Product routes → Listing assistance: generates listing data
backend/src/routes/productRoutes.ts - Catalog management → Database client: queries catalog
backend/src/controllers/ProductController.ts - HTTP API → Checkout and orders: mounts routes
backend/src/index.ts - Checkout and orders → Payment handling: initiates payment
backend/src/controllers/CheckoutController.ts - Checkout and orders → Pricing and fees: calculates charges
backend/src/controllers/CheckoutController.ts - Checkout and orders → Shipping configuration: loads configuration
backend/src/controllers/CheckoutController.ts - Checkout and orders → Database client: persists orders
backend/src/controllers/CheckoutController.ts - HTTP API → Review routes: mounts routes
backend/src/index.ts - Review routes → Reviews: dispatches reviews
backend/src/routes/reviewRoutes.ts - Reviews → Database client: queries reviews
backend/src/controllers/ReviewController.ts - HTTP API → Seller onboarding: mounts routes
backend/src/index.ts - HTTP API → Accounts: mounts routes
backend/src/index.ts - HTTP API → Disputes: mounts admin routes
backend/src/index.ts - HTTP API → Authentication: applies authentication
backend/src/index.ts - Authentication → Database client: uses auth claims
- Database client → Marketplace database: reads and writes