How juvetus/artisanconnect- works
ArtisanConnect is a two-sided artisan marketplace with product listings and a distinct custom-service ordering flow, alongside institutional, subscription, and platform-support capabilities. The documented buyer journey runs from account creation and discovery through ordering, payment confirmation, and review; artisans publish listings and manage sales. Source excerpts verify selected backend controller-to-service calls, while several other branches are included from the repository tree and README. Frontend-to-API wiring and unsampled subsystem internals are not asserted.
Main entry points: listings.service.ts Product listings · auth.service.ts Authentication · service-orders.service.ts Service orders and quotes · app.module.ts NestJS API
Components 22
Application entry
- Marketplace web app
frontend/src/app/page.tsx - NestJS API
backend/src/app.module.ts - PostgreSQL
Identity and accounts
- Authentication
backend/src/modules/auth/auth.service.ts - User accounts
backend/src/modules/users/users.service.ts
Marketplace transactions
- Product listings
backend/src/modules/listings/listings.service.ts - Product orders
backend/src/modules/orders/orders.service.ts - Payments and escrow
backend/src/modules/payments/payments.service.ts - Product reviews
backend/src/modules/reviews/reviews.service.ts - Artisan shops
backend/src/modules/shops/shops.service.ts
Custom services
- Service catalog
backend/src/modules/services/services.service.ts - Service orders and quotes
backend/src/modules/service-orders/service-orders.service.ts - Service reviews
backend/src/modules/service-reviews/service-reviews.service.ts
Platform capabilities
- Media storage
backend/src/modules/storage/storage.service.ts - Subscriptions
backend/src/modules/subscriptions/subscriptions.service.ts - Institutional programs
backend/src/modules/program/program.service.ts - AI assistant
backend/src/modules/assistant - Analytics
backend/src/modules/analytics - Messaging and notifications
backend/src/modules/messages - Moderation and reports
backend/src/modules/moderation - Delivery coordination
backend/src/modules/delivery
Other components
- Buyer or artisan
Connections 18
- Buyer or artisan → Marketplace web app: uses
- Buyer or artisan → Authentication: registers
- Authentication → User accounts: uses
backend/src/modules/auth/auth.service.ts - Authentication → NestJS API: serves authentication
- Buyer or artisan → Product listings: searches
- Buyer or artisan → Product orders: places order
- Buyer or artisan → Payments and escrow: confirms cash
- Buyer or artisan → Product reviews: reviews purchase
- Product listings → Artisan shops: uses shop data
backend/src/modules/listings/listings.controller.ts - Product listings → Media storage: uploads media
backend/src/modules/listings/listings.controller.ts - Product listings → Subscriptions: checks plans
backend/src/modules/listings/listings.controller.ts - Buyer or artisan → Service catalog: discovers services
- Buyer or artisan → Service orders and quotes: requests service
- Service orders and quotes → Service reviews: enables reviews
- Service reviews → Service orders and quotes: checks order
backend/src/modules/service-reviews/service-reviews.service.ts - Institutional programs → Institutional programs: manages programs
backend/src/modules/program/program.service.ts - Subscriptions → Payments and escrow: payment integration
- NestJS API → PostgreSQL: persists data