How gemstore/gemstore-api works
GemStore is a Spring Boot gemstone marketplace backend. Users authenticate, manage listings and profiles, interact through follows/favorites, message one another, and request price predictions; administrators moderate users and reports. The README documents PostgreSQL persistence, Kafka messaging, WebSocket notifications, and an external ML service. Source excerpts confirm selected service-to-repository and service-to-service calls; many controller and integration links are documented only at the product level, so those are cited to the README.
Main entry points: AuthService.java Authentication · ListingService.java Listing lifecycle · ListingController.java Listings API · MessageService.java Message workflow
Components 24
Identity & Access
- Auth API
src/main/java/com/gemstore/backend/controllers/auth/AuthController.java - Authentication
src/main/java/com/gemstore/backend/services/auth/AuthService.java - OAuth handlers
src/main/java/com/gemstore/backend/config/OAuth2SuccessHandler.java - JWT security
src/main/java/com/gemstore/backend/config/JwtFilter.java - User profiles
src/main/java/com/gemstore/backend/services/user/UserService.java
Marketplace & Social
- Listings API
src/main/java/com/gemstore/backend/controllers/listing/ListingController.java - Listing lifecycle
src/main/java/com/gemstore/backend/services/listing/ListingService.java - Social actions
src/main/java/com/gemstore/backend/controllers/user/FollowController.java - Follow relationships
src/main/java/com/gemstore/backend/services/user/FollowService.java
Messaging & Alerts
- Messaging API
src/main/java/com/gemstore/backend/controllers/message/MessageController.java - Message workflow
src/main/java/com/gemstore/backend/services/message/MessageService.java - Notification management
src/main/java/com/gemstore/backend/services/notification/NotificationService.java - WebSocket delivery
src/main/java/com/gemstore/backend/services/notification/NotificationWebSocketService.java
Prediction & Moderation
- Price prediction API
src/main/java/com/gemstore/backend/controllers/prediction/GemPriceController.java - Price estimation client
src/main/java/com/gemstore/backend/services/prediction/GemPriceService.java - Reports & moderation API
src/main/java/com/gemstore/backend/controllers/report/ReportController.java - Report moderation
src/main/java/com/gemstore/backend/services/report/ReportService.java
Persistence & Integrations
- Listing data
src/main/java/com/gemstore/backend/repositories/listing/ListingRepository.java - Kafka topics
- FastAPI ML service
- PostgreSQL
- WSO2 API Manager
Other components
- Marketplace user
- Administrator
Connections 27
- Marketplace user → Auth API: authenticates
README.md - Auth API → Authentication: delegates to
src/main/java/com/gemstore/backend/controllers/auth/AuthController.java - Authentication → User profiles: uses user mapping
- Authentication → JWT security: issues JWT
src/main/java/com/gemstore/backend/services/auth/AuthService.java - OAuth handlers → JWT security: issues JWT
src/main/java/com/gemstore/backend/config/OAuth2SuccessHandler.java - Marketplace user → Listings API: manages listings
README.md - Listings API → Listing lifecycle: delegates to
src/main/java/com/gemstore/backend/controllers/listing/ListingController.java - Listing lifecycle → Listing data: queries listings
src/main/java/com/gemstore/backend/services/listing/ListingService.java - Listing lifecycle → User profiles: uses seller data
- Marketplace user → Social actions: follows users
README.md - Social actions → Follow relationships: delegates to
src/main/java/com/gemstore/backend/controllers/user/FollowController.java - Follow relationships → Notification management: notifies events
src/main/java/com/gemstore/backend/services/user/FollowService.java - Marketplace user → Messaging API: sends messages
README.md - Messaging API → Message workflow: delegates to
src/main/java/com/gemstore/backend/controllers/message/MessageController.java - Message workflow → Kafka topics: publishes events
src/main/java/com/gemstore/backend/services/message/MessageService.java - Kafka topics → Message workflow: delivers events
- Notification management → WebSocket delivery: sends notification
src/main/java/com/gemstore/backend/services/notification/NotificationService.java - Marketplace user → Price prediction API: requests estimate
README.md - Price prediction API → Price estimation client: delegates to
src/main/java/com/gemstore/backend/controllers/prediction/GemPriceController.java - Price estimation client → FastAPI ML service: requests prediction
README.md - Administrator → Reports & moderation API: moderates reports
README.md - Reports & moderation API → Report moderation: delegates to
src/main/java/com/gemstore/backend/controllers/report/ReportController.java - Report moderation → Listing data: checks listing reports
src/main/java/com/gemstore/backend/services/report/ReportService.java - Authentication → PostgreSQL: persists users
- Listing lifecycle → PostgreSQL: persists marketplace data
README.md - Marketplace user → WSO2 API Manager: routes listings through
README.md - WSO2 API Manager → Listings API: forwards requests
README.md