How yayauheny/bidplace works
bidplace is a curated marketplace for creator-associated items, centered on timed auctions rather than general resale. Its MVP flow is seller authentication and product/listing creation, public link discovery, buyer bidding, timed auction closure, winner selection, and creation of a minimal order. Other documented product areas include seller pages, image handling, moderation, and administration. The README documents PostgreSQL and realtime bidding; sampled controllers show several API-to-service calls, but unsampled implementation wiring is not asserted.
Main entry points: request.ts API client · _layout.tsx Mobile app · product-screen.tsx Auction screens · orders.service.ts Orders service
Components 28
Client experience
- Mobile app
apps/mobile/src/app/_layout.tsx - Seller screens
apps/mobile/src/features/sellers/product-draft-screen.tsx - Auction screens
apps/mobile/src/features/products/product-screen.tsx - API client
packages/api-client/src/request.ts
Seller and catalog
- Product API
apps/api/src/products/products.controller.ts - Product service
apps/api/src/products/products.service.ts - Seller API
apps/api/src/sellers/sellers.controller.ts - Seller service
apps/api/src/sellers/sellers.service.ts - Image API
apps/api/src/images/images.controller.ts - Image service
apps/api/src/images/images.service.ts - Discovery API
apps/api/src/discovery/discovery.controller.ts - Portfolio API
apps/api/src/portfolio/portfolio.controller.ts
Auction and orders
- Listing API
apps/api/src/listings/listings.controller.ts - Listing service
apps/api/src/listings/listings.service.ts - Bidding API
apps/api/src/bids/bids.controller.ts - Bidding service
apps/api/src/bids/bids.service.ts - Auction rules
apps/api/src/core/auction/state-machine.ts - Auction lifecycle
apps/api/src/lifecycle/listing-lifecycle.service.ts - Orders API
apps/api/src/orders/orders.controller.ts - Orders service
apps/api/src/orders/orders.service.ts - Realtime gateway
apps/api/src/realtime/realtime.gateway.ts
Platform operations
- Authentication API
apps/api/src/auth/auth.controller.ts - Authentication service
apps/api/src/auth/auth.service.ts - Admin API
apps/api/src/admin/admin.controller.ts - PostgreSQL access
apps/api/src/core/database/prisma.service.ts
Other components
- Seller
- Buyer
- PostgreSQL
Connections 23
- Seller → Mobile app: uses
- Buyer → Mobile app: uses
- Mobile app → Seller screens: renders
- Mobile app → Auction screens: renders
- Seller screens → API client: requests
- Auction screens → API client: requests
- API client → Authentication API: calls REST
- API client → Product API: calls REST
- API client → Seller API: calls REST
- API client → Listing API: calls REST
- API client → Bidding API: calls REST
- API client → Orders API: calls REST
- Product API → Product service: delegates
- Seller API → Seller service: delegates
- Image API → Image service: delegates
- Listing API → Listing service: delegates
- Bidding API → Bidding service: delegates
- Orders API → Orders service: delegates
- Admin API → Orders service: manages orders
- Admin API → PostgreSQL access: queries
- Auction lifecycle → Orders service: creates winner order
- Realtime gateway → Auction screens: broadcasts bids
- PostgreSQL access → PostgreSQL: reads and writes