How lele97/pagatu-backend works
PagaTu is a Java/Spring backend for coordinating coffee turns, group payments and identity across microservices. A client request enters through the gateway; the documented routing sends it to Auth or Coffee, where users authenticate or manage groups and payments. Coffee also provides balances, rankings, invitations, karma and awards. Auth and Coffee publish events through transactional outboxes and NATS for Mail delivery. The graph follows the README’s documented architecture and sampled calls; several Coffee features and service-discovery links are documented but their implementation was not sampled.
Main entry points: GatewayConfig.java API gateway · AuthController.java Auth endpoints · OutboxProcessor.java Transactional outbox · AuthService.java Identity and OAuth
Components 19
Edge and discovery
- API gateway
gateway-service/src/main/java/com/pagatu/gateway_service/config/GatewayConfig.java - Service discovery
eureka-server/src/main/java/com/pagatu/eureka_server/EurekaServerApplication.java
Identity service
- Auth endpoints
auth/src/main/java/com/pagatu/auth/controller/AuthController.java - Identity and OAuth
auth/src/main/java/com/pagatu/auth/service/AuthService.java - Provider sign-in
auth/src/main/java/com/pagatu/auth/service/OAuthService.java - Email verification
auth/src/main/java/com/pagatu/auth/service/EmailVerificationService.java - Auth database
auth/src/main/java/com/pagatu/auth/repository/UserRepository.java
Coffee domain
- Group endpoints
coffee/src/main/java/com/pagatu/coffee/controller/GroupController.java - Group management
coffee/src/main/java/com/pagatu/coffee/service/GroupService.java - Payment endpoints
coffee/src/main/java/com/pagatu/coffee/controller/PaymentController.java - Turns and payments
coffee/src/main/java/com/pagatu/coffee/service/PaymentService.java - Karma and awards
coffee/src/main/java/com/pagatu/coffee/service/AwardService.java - Coffee database
coffee/src/main/java/com/pagatu/coffee/repository/GroupRepository.java
Events and mail
- Transactional outbox
coffee/src/main/java/com/pagatu/coffee/service/OutboxProcessor.java - NATS messaging
coffee/src/main/java/com/pagatu/coffee/nats/NatsPublisher.java - Mail subscribers
mail/src/main/java/com/pagatu/mail/nats/NatsSubscriber.java - Email delivery
mail/src/main/java/com/pagatu/mail/service/EmailService.java
Other components
- Web client
- OAuth providers
Connections 22
- Web client → API gateway: sends requests
README.md - API gateway → Auth endpoints: routes requests
README.md - API gateway → Group endpoints: routes requests
README.md - API gateway → Service discovery: resolves services
README.md - Auth endpoints → Identity and OAuth: delegates auth
auth/src/main/java/com/pagatu/auth/controller/AuthController.java - Auth endpoints → Provider sign-in: delegates OAuth
auth/src/main/java/com/pagatu/auth/controller/AuthController.java - Auth endpoints → Email verification: delegates verification
auth/src/main/java/com/pagatu/auth/controller/AuthController.java - Identity and OAuth → Auth database: reads and writes
auth/src/main/java/com/pagatu/auth/service/AuthService.java - Provider sign-in → Auth database: reads and writes
auth/src/main/java/com/pagatu/auth/service/OAuthService.java - Provider sign-in → OAuth providers: exchanges tokens
auth/src/main/java/com/pagatu/auth/service/OAuthService.java - Email verification → Auth database: persists tokens
auth/src/main/java/com/pagatu/auth/service/EmailVerificationService.java - Group endpoints → Group management: delegates group actions
coffee/src/main/java/com/pagatu/coffee/controller/GroupController.java - Group management → Coffee database: reads and writes
coffee/src/main/java/com/pagatu/coffee/service/GroupService.java - Payment endpoints → Turns and payments: delegates payments
coffee/src/main/java/com/pagatu/coffee/controller/PaymentController.java - Turns and payments → Coffee database: updates payment state
coffee/src/main/java/com/pagatu/coffee/service/PaymentService.java - Karma and awards → Coffee database: reads payment history
- Identity and OAuth → Transactional outbox: records mail events
README.md - Group management → Transactional outbox: records group events
README.md - Turns and payments → Transactional outbox: records payment events
README.md - Transactional outbox → NATS messaging: publishes events
README.md - NATS messaging → Mail subscribers: dispatches events
README.md - Mail subscribers → Email delivery: handles notifications