How patmesh/social-feed-system works
This repository implements a social application as several Spring services: authentication, posts and feeds, a user-follow graph, persisted notifications, and WebSocket delivery. A typical user creates a post through the post API; the post service saves it and publishes an event, while graph-side fanout gathers followers and publishes notification events. Users can also query their notifications. Auth signup/login and follow notifications are separate flows. The excerpts show service-layer calls and some persistence/event publishing; cross-service routing and several event consumers are not shown, so those links are omitted or marked unverified.
Main entry points: GatewayConfig.java API Gateway · AuthService.java Auth Service · PostService.java Post Service · PostFanoutService.java Follower Fanout
Components 29
API Edge
- API Gateway
api-gateway-service/src/main/java/com/dev/apigatewayservice/config/GatewayConfig.java
Identity
- Auth API
user-auth-service/src/main/java/com/dev/userauthservice/controller/AuthController.java - Auth Service
user-auth-service/src/main/java/com/dev/userauthservice/service/AuthService.java - Account Storage
user-auth-service/src/main/java/com/dev/userauthservice/repository/UserRepository.java - Refresh Tokens
user-auth-service/src/main/java/com/dev/userauthservice/service/RefreshTokenService.java - User Event Producer
user-auth-service/src/main/java/com/dev/userauthservice/kafka/producer/KafkaEventProducer.java
Posts and Graph
- Post API
user-post-service/src/main/java/com/dev/user_post_service/controller/PostController.java - Post Service
user-post-service/src/main/java/com/dev/user_post_service/service/PostService.java - Post Storage
user-post-service/src/main/java/com/dev/user_post_service/repository/PostRepository.java - Graph Client
user-post-service/src/main/java/com/dev/user_post_service/client/GraphClient.java - Post Event Producer
user-post-service/src/main/java/com/dev/user_post_service/kafka/producer/KafkaEventProducer.java - Graph API
graph-service/src/main/java/com/dev/graphservice/controller/GraphController.java - Graph User Service
graph-service/src/main/java/com/dev/graphservice/service/UserService.java - Graph Repository
graph-service/src/main/java/com/dev/graphservice/core/GraphRepository.java - Gremlin Query Engine
graph-service/src/main/java/com/dev/graphservice/core/QueryExecutionEngineImpl.java - Graph Database
graph-service/src/main/java/com/dev/graphservice/config/GremlinConfig.java - Post Event Consumer
graph-service/src/main/java/com/dev/graphservice/kafka/consumer/PostEventConsumer.java - Follower Fanout
graph-service/src/main/java/com/dev/graphservice/service/PostFanoutService.java - Notification Event Producer
graph-service/src/main/java/com/dev/graphservice/kafka/producer/KafkaEventProducer.java
Notifications
- Notification Consumer
notification-service/src/main/java/com/dev/notification_service/kafka/consumer/NotificationConsumer.java - Notification Processor
notification-service/src/main/java/com/dev/notification_service/service/NotificationProcessor.java - Notification Storage
notification-service/src/main/java/com/dev/notification_service/repository/NotificationRepository.java - Notification API
notification-service/src/main/java/com/dev/notification_service/controller/NotificationController.java - Notification Query
notification-service/src/main/java/com/dev/notification_service/service/NotificationQueryService.java
Realtime Delivery
- WebSocket Handler
ws-notification-service/src/main/java/com/dev/ws_notification_service/handler/NotificationWebSocketHandler.java - Presence Service
ws-notification-service/src/main/java/com/dev/ws_notification_service/service/PresenceService.java - Redis Presence Store
ws-notification-service/src/main/java/com/dev/ws_notification_service/config/RedisConfig.java
Other components
- Application Client
- Kafka
Connections 29
- Application Client → API Gateway: sends requests
- API Gateway → Auth API: routes requests
- API Gateway → Post API: routes requests
- API Gateway → Notification API: routes requests
- Auth API → Auth Service: calls
user-auth-service/src/main/java/com/dev/userauthservice/controller/AuthController.java - Auth Service → Account Storage: reads and writes
user-auth-service/src/main/java/com/dev/userauthservice/service/AuthService.java - Auth Service → Refresh Tokens: manages tokens
user-auth-service/src/main/java/com/dev/userauthservice/service/AuthService.java - Auth Service → User Event Producer: publishes signup
user-auth-service/src/main/java/com/dev/userauthservice/service/AuthService.java - User Event Producer → Kafka: publishes events
- Post API → Post Service: calls
user-post-service/src/main/java/com/dev/user_post_service/controller/PostController.java - Post Service → Post Storage: reads and writes
user-post-service/src/main/java/com/dev/user_post_service/service/PostService.java - Post Service → Post Event Producer: publishes post event
user-post-service/src/main/java/com/dev/user_post_service/service/PostService.java - Post Service → Graph Client: fetches followings
user-post-service/src/main/java/com/dev/user_post_service/service/PostService.java - Post Event Producer → Kafka: publishes events
- Graph API → Graph User Service: dispatches graph actions
graph-service/src/main/java/com/dev/graphservice/controller/GraphController.java - Graph User Service → Graph Repository: reads and mutates graph
graph-service/src/main/java/com/dev/graphservice/service/UserService.java - Graph Repository → Gremlin Query Engine: executes graph queries
- Gremlin Query Engine → Graph Database: runs Gremlin
- Post Event Consumer → Follower Fanout: dispatches post events
- Follower Fanout → Graph User Service: loads followers
graph-service/src/main/java/com/dev/graphservice/service/PostFanoutService.java - Follower Fanout → Notification Event Producer: publishes batches
graph-service/src/main/java/com/dev/graphservice/service/PostFanoutService.java - Notification Event Producer → Kafka: publishes events
- Kafka → Notification Consumer: delivers events
- Notification Consumer → Notification Processor: processes events
- Notification Processor → Notification Storage: persists notifications
- Notification API → Notification Query: calls
notification-service/src/main/java/com/dev/notification_service/controller/NotificationController.java - Notification Query → Notification Storage: queries notifications
notification-service/src/main/java/com/dev/notification_service/service/NotificationQueryService.java - Presence Service → Redis Presence Store: stores presence
ws-notification-service/src/main/java/com/dev/ws_notification_service/service/PresenceService.java - Notification Consumer → WebSocket Handler: delivers live updates