How coffeezombietux/customerservice works
Customer Loyalty & Account Service is a REST API for customer identity, profiles, bonus balances, and consent records, serving customers, administrators, and internal services. The main journey runs from registration and consent capture through email activation to login and token-backed sessions; separate paths manage profiles, agreements, and bonus operations. The README describes PostgreSQL persistence and independently secured API surfaces. Sampled services show authentication, token validation, bonus updates, and agreement auditing; unsampled controller-to-service connections are left unverified.
Main entry points: AuthService.java Auth and sessions · CustomerService.java Customer service · internal Internal APIs · AgreementService.java Agreement audit
Components 20
API surfaces
- Auth API
src/main/java/io/customerservice/customerservice/controller/AuthController.java - Customer API
src/main/java/io/customerservice/customerservice/controller/CustomerController.java - Admin API
src/main/java/io/customerservice/customerservice/controller/admin/AdminController.java - Internal APIs
src/main/java/io/customerservice/customerservice/controller/internal
Identity and security
- Auth and sessions
src/main/java/io/customerservice/customerservice/service/AuthService.java - JWT service
src/main/java/io/customerservice/customerservice/security/JwtService.java
Customer domains
- Customer service
src/main/java/io/customerservice/customerservice/service/CustomerService.java - Agreement audit
src/main/java/io/customerservice/customerservice/service/AgreementService.java - Bonus accounts
src/main/java/io/customerservice/customerservice/service/BonusService.java - Address management
src/main/java/io/customerservice/customerservice/service/AddressService.java - Admin operations
src/main/java/io/customerservice/customerservice/service/AdminService.java - Activation email
src/main/java/io/customerservice/customerservice/service/EmailService.java
Persistence
- Customer records
src/main/java/io/customerservice/customerservice/repository/CustomerRepository.java - Refresh sessions
src/main/java/io/customerservice/customerservice/repository/RefreshTokenRepository.java - Consent records
src/main/java/io/customerservice/customerservice/repository/CustomerAgreementRepository.java - PostgreSQL
Other components
- Customer client
- Admin panel
- Internal services
- API Gateway
Connections 25
- Customer client → API Gateway: sends requests
README.md - Admin panel → API Gateway: sends requests
README.md - Internal services → Internal APIs: calls API key routes
README.md - API Gateway → Auth API: routes customer calls
README.md - API Gateway → Customer API: routes customer calls
README.md - API Gateway → Admin API: routes admin calls
README.md - Auth API → Auth and sessions: delegates to
src/main/java/io/customerservice/customerservice/controller/AuthController.java - Customer API → Customer service: delegates to
src/main/java/io/customerservice/customerservice/controller/CustomerController.java - Admin API → Admin operations: delegates to
src/main/java/io/customerservice/customerservice/controller/admin/AdminController.java - Auth and sessions → Customer records: reads and saves
src/main/java/io/customerservice/customerservice/service/AuthService.java - Auth and sessions → Refresh sessions: rotates sessions
src/main/java/io/customerservice/customerservice/service/AuthService.java - Auth and sessions → JWT service: generates tokens
src/main/java/io/customerservice/customerservice/service/AuthService.java - Auth and sessions → Activation email: sends activation email
src/main/java/io/customerservice/customerservice/service/AuthService.java - Customer service → JWT service: validates token claims
src/main/java/io/customerservice/customerservice/service/CustomerService.java - Customer service → Customer records: reads and updates
src/main/java/io/customerservice/customerservice/service/CustomerService.java - Customer service → Refresh sessions: checks sessions
src/main/java/io/customerservice/customerservice/service/CustomerService.java - Agreement audit → Consent records: reads and appends
src/main/java/io/customerservice/customerservice/service/AgreementService.java - Internal APIs → Bonus accounts: dispatches bonus calls
src/main/java/io/customerservice/customerservice/controller/internal/InternalBonusController.java - Internal APIs → Customer service: dispatches customer calls
src/main/java/io/customerservice/customerservice/controller/internal/InternalCustomerController.java - Internal APIs → Agreement audit: dispatches agreement calls
src/main/java/io/customerservice/customerservice/controller/internal/InternalAgreementController.java - Auth and sessions → Consent records: records registration consents
src/main/java/io/customerservice/customerservice/service/AuthService.java - Auth and sessions → PostgreSQL: persists account data
README.md - Bonus accounts → PostgreSQL: persists balances and transactions
README.md - Agreement audit → PostgreSQL: persists consent history
README.md - Address management → PostgreSQL: persists addresses
README.md