How pi3-tcg/tcgmarket works
TCG Market is a trading-card platform for catalog discovery, personal collection management, profiles, administration, and user-to-user sales or trades. The user workflow begins in the React interface, reaches the REST API, and uses backend services to query the internal MongoDB catalog and manage user-owned records; purchase, trade, and review capabilities are also represented because they exist in the repository. The README documents catalog imports from external TCG sources. Only selected backend and frontend files were sampled, so unsampled subsystem links are marked unverified rather than presented as inspected call paths.
Main entry points: controller REST API controllers · AuthService.java Auth and JWT · CatalogSearchService.java Catalog search · ReviewService.java Transaction reviews
Components 23
Web experience
- React application
frontend/src/App.tsx - Page routing
frontend/src/router.tsx - REST API controllers
backend/src/main/java/com/pitcc/controller
Identity and profiles
- Auth and JWT
backend/src/main/java/com/pitcc/service/AuthService.java - User records
backend/src/main/java/com/pitcc/repository/UserRepository.java - Profiles and users
backend/src/main/java/com/pitcc/service/ProfileService.java
Catalog and collection
- Catalog search
backend/src/main/java/com/pitcc/service/CatalogSearchService.java - Card catalog
backend/src/main/java/com/pitcc/repository/CardRepository.java - Catalog import
backend/src/main/java/com/pitcc/service/CatalogImportService.java - TCG data providers
backend/src/main/java/com/pitcc/integration/catalog - Personal collection
backend/src/main/java/com/pitcc/service/CollectionService.java - Collection records
backend/src/main/java/com/pitcc/repository/CollectionSearchRepository.java
Trading and commerce
- Ads and marketplace
backend/src/main/java/com/pitcc/service/MarketplaceService.java - Cart and checkout
backend/src/main/java/com/pitcc/service/PlaceOrderService.java - Payment gateway
backend/src/main/java/com/pitcc/integration/payment/PaymentGateway.java - Trade proposals
backend/src/main/java/com/pitcc/service/CreateTradeProposalService.java - Transaction reviews
backend/src/main/java/com/pitcc/service/ReviewService.java - Review records
backend/src/main/java/com/pitcc/repository/ReviewRepository.java
Administration
- Admin tools
backend/src/main/java/com/pitcc/service/AdminDashboardService.java
Other components
- Player / collector
- MongoDB
- External card APIs
- Payment provider
Connections 26
- Player / collector → React application: uses
- React application → Page routing: renders routes
- Page routing → REST API controllers: requests data
- REST API controllers → Auth and JWT: delegates auth
- Auth and JWT → User records: reads users
backend/src/main/java/com/pitcc/service/AuthService.java - Auth and JWT → MongoDB: persists users
- REST API controllers → Personal collection: delegates collection
backend/src/main/java/com/pitcc/controller/CollectionController.java - Personal collection → Collection records: searches records
- Collection records → MongoDB: queries
- REST API controllers → Catalog search: serves catalog
- Catalog search → Card catalog: reads cards
backend/src/main/java/com/pitcc/service/CatalogSearchService.java - Catalog search → MongoDB: queries cards
backend/src/main/java/com/pitcc/service/CatalogSearchService.java - External card APIs → TCG data providers: supplies card data
- TCG data providers → Catalog import: provides imports
- Catalog import → Card catalog: imports cards
- Card catalog → MongoDB: stores cards
- REST API controllers → Profiles and users: serves profiles
- REST API controllers → Ads and marketplace: serves listings
- REST API controllers → Cart and checkout: delegates checkout
- Cart and checkout → Payment gateway: requests payment
- Payment gateway → Payment provider: charges through
- REST API controllers → Trade proposals: serves trades
- REST API controllers → Transaction reviews: delegates reviews
- Transaction reviews → Review records: saves and reads
backend/src/main/java/com/pitcc/service/ReviewService.java - Transaction reviews → MongoDB: persists reviews
- REST API controllers → Admin tools: serves admin