How fairies-pixels/curlylab-backend works
Curlylabback is a Kotlin/Spring backend for user accounts and a hair-care product catalog, with reviews, favourites, user profiles, and avatar storage. Its main workflow is an HTTP request entering a controller, being handled by a service, and—where shown—using a repository to read or change application data. Authentication supports local credentials and Google sign-in, issuing JWT access and refresh tokens. Source excerpts establish several calls and repository operations; the README is empty, and connections for unsampled controllers, services, and repositories are omitted where their call paths cannot be verified.
Main entry points: GoogleAuthService.kt Google Auth · AuthService.kt Local Auth · UserRepository.kt User Repository · AuthController.kt Auth API
Components 28
HTTP API
- Auth API
src/main/kotlin/com/curlylab/curlylabback/controller/AuthController.kt - Favourites API
src/main/kotlin/com/curlylab/curlylabback/controller/FavouritesController.kt - Hair Type API
src/main/kotlin/com/curlylab/curlylabback/controller/HairTypeController.kt - Products API
src/main/kotlin/com/curlylab/curlylabback/controller/ProductController.kt - Reviews API
src/main/kotlin/com/curlylab/curlylabback/controller/ReviewsController.kt - Users API
src/main/kotlin/com/curlylab/curlylabback/controller/UserController.kt
Application Services
- Local Auth
src/main/kotlin/com/curlylab/curlylabback/service/AuthService.kt - Google Auth
src/main/kotlin/com/curlylab/curlylabback/service/GoogleAuthService.kt - Favourites
src/main/kotlin/com/curlylab/curlylabback/service/FavouritesService.kt - Hair Types
src/main/kotlin/com/curlylab/curlylabback/service/HairTypeService.kt - Products
src/main/kotlin/com/curlylab/curlylabback/service/ProductService.kt - Reviews
src/main/kotlin/com/curlylab/curlylabback/service/ReviewsService.kt - User Profiles
src/main/kotlin/com/curlylab/curlylabback/service/UserService.kt
Data Access
- User Repository
src/main/kotlin/com/curlylab/curlylabback/repository/UserRepository.kt - Credentials Repository
src/main/kotlin/com/curlylab/curlylabback/repository/UserAuthRepository.kt - Provider Repository
src/main/kotlin/com/curlylab/curlylabback/repository/UserProviderRepository.kt - Refresh Tokens
src/main/kotlin/com/curlylab/curlylabback/repository/RefreshTokenRepository.kt - Favourites Repository
src/main/kotlin/com/curlylab/curlylabback/repository/FavouriteRepository.kt - Hair Type Repository
src/main/kotlin/com/curlylab/curlylabback/repository/HairTypeRepository.kt - Product Repository
src/main/kotlin/com/curlylab/curlylabback/repository/ProductRepository.kt - Reviews Repository
src/main/kotlin/com/curlylab/curlylabback/repository/ReviewsRepository.kt - Domain Models
src/main/kotlin/com/curlylab/curlylabback/model
Security And Storage
- JWT Tokens
src/main/kotlin/com/curlylab/curlylabback/service/JwtService.kt - Avatar Storage
src/main/kotlin/com/curlylab/curlylabback/service/S3Service.kt
Other components
- API Client
- Relational Database
- Google Identity
- Amazon S3
Connections 32
- API Client → Auth API: sends requests
src/main/kotlin/com/curlylab/curlylabback/controller/AuthController.kt - API Client → Favourites API: sends requests
src/main/kotlin/com/curlylab/curlylabback/controller/FavouritesController.kt - API Client → Hair Type API: sends requests
src/main/kotlin/com/curlylab/curlylabback/controller/HairTypeController.kt - API Client → Products API: sends requests
src/main/kotlin/com/curlylab/curlylabback/controller/ProductController.kt - API Client → Reviews API: sends requests
src/main/kotlin/com/curlylab/curlylabback/controller/ReviewsController.kt - API Client → Users API: sends requests
src/main/kotlin/com/curlylab/curlylabback/controller/UserController.kt - Auth API → Local Auth: calls
src/main/kotlin/com/curlylab/curlylabback/controller/AuthController.kt - Auth API → Google Auth: calls
src/main/kotlin/com/curlylab/curlylabback/controller/AuthController.kt - Reviews API → Reviews: calls
src/main/kotlin/com/curlylab/curlylabback/controller/ReviewsController.kt - Hair Type API → Hair Types: calls
src/main/kotlin/com/curlylab/curlylabback/controller/HairTypeController.kt - Products API → Products: calls
src/main/kotlin/com/curlylab/curlylabback/controller/ProductController.kt - Users API → User Profiles: calls
src/main/kotlin/com/curlylab/curlylabback/controller/UserController.kt - Reviews → Reviews Repository: queries
src/main/kotlin/com/curlylab/curlylabback/service/ReviewsService.kt - Local Auth → Credentials Repository: checks credentials
src/main/kotlin/com/curlylab/curlylabback/service/AuthService.kt - Local Auth → User Repository: reads and creates users
src/main/kotlin/com/curlylab/curlylabback/service/AuthService.kt - Local Auth → Refresh Tokens: stores and revokes tokens
src/main/kotlin/com/curlylab/curlylabback/service/AuthService.kt - Local Auth → JWT Tokens: creates access token
src/main/kotlin/com/curlylab/curlylabback/service/AuthService.kt - Google Auth → User Repository: reads and creates users
src/main/kotlin/com/curlylab/curlylabback/service/GoogleAuthService.kt - Google Auth → Provider Repository: looks up provider
src/main/kotlin/com/curlylab/curlylabback/service/GoogleAuthService.kt - Google Auth → Refresh Tokens: stores refresh token
src/main/kotlin/com/curlylab/curlylabback/service/GoogleAuthService.kt - Google Auth → JWT Tokens: creates access token
src/main/kotlin/com/curlylab/curlylabback/service/GoogleAuthService.kt - Google Auth → Google Identity: verifies identity
src/main/kotlin/com/curlylab/curlylabback/service/GoogleAuthService.kt - Reviews Repository → Relational Database: queries and updates
src/main/kotlin/com/curlylab/curlylabback/repository/ReviewsRepository.kt - User Repository → Domain Models: maps user data
src/main/kotlin/com/curlylab/curlylabback/repository/UserRepository.kt - Credentials Repository → Domain Models: maps credentials
src/main/kotlin/com/curlylab/curlylabback/repository/UserAuthRepository.kt - Reviews Repository → Domain Models: maps reviews
src/main/kotlin/com/curlylab/curlylabback/repository/ReviewsRepository.kt - Favourites → Favourites Repository: uses repository
src/main/kotlin/com/curlylab/curlylabback/service/FavouritesService.kt - Hair Types → Hair Type Repository: uses repository
src/main/kotlin/com/curlylab/curlylabback/service/HairTypeService.kt - Products → Product Repository: uses repository
src/main/kotlin/com/curlylab/curlylabback/service/ProductService.kt - User Profiles → Avatar Storage: uploads and deletes avatars
src/main/kotlin/com/curlylab/curlylabback/service/UserService.kt - User Profiles → User Repository: reads and updates profile
src/main/kotlin/com/curlylab/curlylabback/service/UserService.kt - Avatar Storage → Amazon S3: stores avatar files