# fairies-pixels/curlylab-backend architecture

> Architecture diagram of the GitHub repository fairies-pixels/curlylab-backend, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-04). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/fairies-pixels/curlylab-backend
- Repository: https://github.com/fairies-pixels/curlylab-backend

## Overview

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: [`src/main/kotlin/com/curlylab/curlylabback/service/GoogleAuthService.kt`](https://github.com/fairies-pixels/curlylab-backend/blob/master/src/main/kotlin/com/curlylab/curlylabback/service/GoogleAuthService.kt) (Google Auth), [`src/main/kotlin/com/curlylab/curlylabback/service/AuthService.kt`](https://github.com/fairies-pixels/curlylab-backend/blob/master/src/main/kotlin/com/curlylab/curlylabback/service/AuthService.kt) (Local Auth), [`src/main/kotlin/com/curlylab/curlylabback/repository/UserRepository.kt`](https://github.com/fairies-pixels/curlylab-backend/blob/master/src/main/kotlin/com/curlylab/curlylabback/repository/UserRepository.kt) (User Repository), [`src/main/kotlin/com/curlylab/curlylabback/controller/AuthController.kt`](https://github.com/fairies-pixels/curlylab-backend/blob/master/src/main/kotlin/com/curlylab/curlylabback/controller/AuthController.kt) (Auth API)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_api["HTTP API"]
  node_auth_api["Auth API<br/>[AuthController.kt]"]
  node_favourites_api["Favourites API"]
  node_hair_api["Hair Type API"]
  node_products_api["Products API"]
  node_reviews_api["Reviews API"]
  node_users_api["Users API<br/>[UserController.kt]"]
end

subgraph group_services["Application Services"]
  node_auth_service["Local Auth<br/>[AuthService.kt]"]
  node_google_auth["Google Auth"]
  node_favourites_service["Favourites"]
  node_hair_service["Hair Types<br/>[HairTypeService.kt]"]
  node_product_service["Products<br/>[ProductService.kt]"]
  node_reviews_service["Reviews<br/>[ReviewsService.kt]"]
  node_user_service["User Profiles<br/>[UserService.kt]"]
end

subgraph group_persistence["Data Access"]
  node_user_repo["User Repository<br/>[UserRepository.kt]"]
  node_auth_repo["Credentials Repository"]
  node_provider_repo["Provider Repository"]
  node_refresh_repo["Refresh Tokens"]
  node_favourites_repo["Favourites Repository"]
  node_hair_repo["Hair Type Repository"]
  node_product_repo["Product Repository"]
  node_reviews_repo["Reviews Repository"]
  node_domain_models["Domain Models"]
end

subgraph group_integrations["Security And Storage"]
  node_jwt_service["JWT Tokens<br/>[JwtService.kt]"]
  node_s3_service["Avatar Storage<br/>[S3Service.kt]"]
end

node_client(("API Client"))
node_sql_store[("Relational Database")]
node_google(("Google Identity"))
node_s3[("Amazon S3")]

node_client -->|"sends requests"| node_auth_api
node_client -->|"sends requests"| node_favourites_api
node_client -->|"sends requests"| node_hair_api
node_client -->|"sends requests"| node_products_api
node_client -->|"sends requests"| node_reviews_api
node_client -->|"sends requests"| node_users_api
node_auth_api -->|"calls"| node_auth_service
node_auth_api -->|"calls"| node_google_auth
node_reviews_api -->|"calls"| node_reviews_service
node_hair_api -->|"calls"| node_hair_service
node_products_api -->|"calls"| node_product_service
node_users_api -->|"calls"| node_user_service
node_reviews_service -->|"queries"| node_reviews_repo
node_auth_service -->|"checks credentials"| node_auth_repo
node_auth_service -->|"reads and creates users"| node_user_repo
node_auth_service -->|"stores and revokes tokens"| node_refresh_repo
node_auth_service -->|"creates access token"| node_jwt_service
node_google_auth -->|"reads and creates users"| node_user_repo
node_google_auth -->|"looks up provider"| node_provider_repo
node_google_auth -->|"stores refresh token"| node_refresh_repo
node_google_auth -->|"creates access token"| node_jwt_service
node_google_auth -->|"verifies identity"| node_google
node_reviews_repo -->|"queries and updates"| node_sql_store
node_user_repo -->|"maps user data"| node_domain_models
node_auth_repo -->|"maps credentials"| node_domain_models
node_reviews_repo -->|"maps reviews"| node_domain_models
node_favourites_service -->|"uses repository"| node_favourites_repo
node_hair_service -->|"uses repository"| node_hair_repo
node_product_service -->|"uses repository"| node_product_repo
node_user_service -->|"uploads and deletes avatars"| node_s3_service
node_user_service -->|"reads and updates profile"| node_user_repo
node_s3_service -.->|"stores avatar files"| node_s3

click node_auth_api "https://github.com/fairies-pixels/curlylab-backend/blob/master/src/main/kotlin/com/curlylab/curlylabback/controller/AuthController.kt"
click node_favourites_api "https://github.com/fairies-pixels/curlylab-backend/blob/master/src/main/kotlin/com/curlylab/curlylabback/controller/FavouritesController.kt"
click node_hair_api "https://github.com/fairies-pixels/curlylab-backend/blob/master/src/main/kotlin/com/curlylab/curlylabback/controller/HairTypeController.kt"
click node_products_api "https://github.com/fairies-pixels/curlylab-backend/blob/master/src/main/kotlin/com/curlylab/curlylabback/controller/ProductController.kt"
click node_reviews_api "https://github.com/fairies-pixels/curlylab-backend/blob/master/src/main/kotlin/com/curlylab/curlylabback/controller/ReviewsController.kt"
click node_users_api "https://github.com/fairies-pixels/curlylab-backend/blob/master/src/main/kotlin/com/curlylab/curlylabback/controller/UserController.kt"
click node_auth_service "https://github.com/fairies-pixels/curlylab-backend/blob/master/src/main/kotlin/com/curlylab/curlylabback/service/AuthService.kt"
click node_google_auth "https://github.com/fairies-pixels/curlylab-backend/blob/master/src/main/kotlin/com/curlylab/curlylabback/service/GoogleAuthService.kt"
click node_favourites_service "https://github.com/fairies-pixels/curlylab-backend/blob/master/src/main/kotlin/com/curlylab/curlylabback/service/FavouritesService.kt"
click node_hair_service "https://github.com/fairies-pixels/curlylab-backend/blob/master/src/main/kotlin/com/curlylab/curlylabback/service/HairTypeService.kt"
click node_product_service "https://github.com/fairies-pixels/curlylab-backend/blob/master/src/main/kotlin/com/curlylab/curlylabback/service/ProductService.kt"
click node_reviews_service "https://github.com/fairies-pixels/curlylab-backend/blob/master/src/main/kotlin/com/curlylab/curlylabback/service/ReviewsService.kt"
click node_user_service "https://github.com/fairies-pixels/curlylab-backend/blob/master/src/main/kotlin/com/curlylab/curlylabback/service/UserService.kt"
click node_jwt_service "https://github.com/fairies-pixels/curlylab-backend/blob/master/src/main/kotlin/com/curlylab/curlylabback/service/JwtService.kt"
click node_s3_service "https://github.com/fairies-pixels/curlylab-backend/blob/master/src/main/kotlin/com/curlylab/curlylabback/service/S3Service.kt"
click node_user_repo "https://github.com/fairies-pixels/curlylab-backend/blob/master/src/main/kotlin/com/curlylab/curlylabback/repository/UserRepository.kt"
click node_auth_repo "https://github.com/fairies-pixels/curlylab-backend/blob/master/src/main/kotlin/com/curlylab/curlylabback/repository/UserAuthRepository.kt"
click node_provider_repo "https://github.com/fairies-pixels/curlylab-backend/blob/master/src/main/kotlin/com/curlylab/curlylabback/repository/UserProviderRepository.kt"
click node_refresh_repo "https://github.com/fairies-pixels/curlylab-backend/blob/master/src/main/kotlin/com/curlylab/curlylabback/repository/RefreshTokenRepository.kt"
click node_favourites_repo "https://github.com/fairies-pixels/curlylab-backend/blob/master/src/main/kotlin/com/curlylab/curlylabback/repository/FavouriteRepository.kt"
click node_hair_repo "https://github.com/fairies-pixels/curlylab-backend/blob/master/src/main/kotlin/com/curlylab/curlylabback/repository/HairTypeRepository.kt"
click node_product_repo "https://github.com/fairies-pixels/curlylab-backend/blob/master/src/main/kotlin/com/curlylab/curlylabback/repository/ProductRepository.kt"
click node_reviews_repo "https://github.com/fairies-pixels/curlylab-backend/blob/master/src/main/kotlin/com/curlylab/curlylabback/repository/ReviewsRepository.kt"
click node_domain_models "https://github.com/fairies-pixels/curlylab-backend/tree/master/src/main/kotlin/com/curlylab/curlylabback/model"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_auth_api,node_favourites_api,node_hair_api,node_products_api,node_reviews_api,node_users_api,node_client toneBlue
class node_auth_service,node_google_auth,node_favourites_service,node_hair_service,node_product_service,node_reviews_service,node_user_service,node_sql_store,node_s3 toneAmber
class node_user_repo,node_auth_repo,node_provider_repo,node_refresh_repo,node_favourites_repo,node_hair_repo,node_product_repo,node_reviews_repo,node_domain_models toneMint
class node_jwt_service,node_s3_service toneRose
class node_google toneIndigo
```

## Components

### HTTP API

- [Auth API](https://github.com/fairies-pixels/curlylab-backend/blob/master/src/main/kotlin/com/curlylab/curlylabback/controller/AuthController.kt): `src/main/kotlin/com/curlylab/curlylabback/controller/AuthController.kt`
- [Favourites API](https://github.com/fairies-pixels/curlylab-backend/blob/master/src/main/kotlin/com/curlylab/curlylabback/controller/FavouritesController.kt): `src/main/kotlin/com/curlylab/curlylabback/controller/FavouritesController.kt`
- [Hair Type API](https://github.com/fairies-pixels/curlylab-backend/blob/master/src/main/kotlin/com/curlylab/curlylabback/controller/HairTypeController.kt): `src/main/kotlin/com/curlylab/curlylabback/controller/HairTypeController.kt`
- [Products API](https://github.com/fairies-pixels/curlylab-backend/blob/master/src/main/kotlin/com/curlylab/curlylabback/controller/ProductController.kt): `src/main/kotlin/com/curlylab/curlylabback/controller/ProductController.kt`
- [Reviews API](https://github.com/fairies-pixels/curlylab-backend/blob/master/src/main/kotlin/com/curlylab/curlylabback/controller/ReviewsController.kt): `src/main/kotlin/com/curlylab/curlylabback/controller/ReviewsController.kt`
- [Users API](https://github.com/fairies-pixels/curlylab-backend/blob/master/src/main/kotlin/com/curlylab/curlylabback/controller/UserController.kt): `src/main/kotlin/com/curlylab/curlylabback/controller/UserController.kt`

### Application Services

- [Local Auth](https://github.com/fairies-pixels/curlylab-backend/blob/master/src/main/kotlin/com/curlylab/curlylabback/service/AuthService.kt): `src/main/kotlin/com/curlylab/curlylabback/service/AuthService.kt`
- [Google Auth](https://github.com/fairies-pixels/curlylab-backend/blob/master/src/main/kotlin/com/curlylab/curlylabback/service/GoogleAuthService.kt): `src/main/kotlin/com/curlylab/curlylabback/service/GoogleAuthService.kt`
- [Favourites](https://github.com/fairies-pixels/curlylab-backend/blob/master/src/main/kotlin/com/curlylab/curlylabback/service/FavouritesService.kt): `src/main/kotlin/com/curlylab/curlylabback/service/FavouritesService.kt`
- [Hair Types](https://github.com/fairies-pixels/curlylab-backend/blob/master/src/main/kotlin/com/curlylab/curlylabback/service/HairTypeService.kt): `src/main/kotlin/com/curlylab/curlylabback/service/HairTypeService.kt`
- [Products](https://github.com/fairies-pixels/curlylab-backend/blob/master/src/main/kotlin/com/curlylab/curlylabback/service/ProductService.kt): `src/main/kotlin/com/curlylab/curlylabback/service/ProductService.kt`
- [Reviews](https://github.com/fairies-pixels/curlylab-backend/blob/master/src/main/kotlin/com/curlylab/curlylabback/service/ReviewsService.kt): `src/main/kotlin/com/curlylab/curlylabback/service/ReviewsService.kt`
- [User Profiles](https://github.com/fairies-pixels/curlylab-backend/blob/master/src/main/kotlin/com/curlylab/curlylabback/service/UserService.kt): `src/main/kotlin/com/curlylab/curlylabback/service/UserService.kt`

### Data Access

- [User Repository](https://github.com/fairies-pixels/curlylab-backend/blob/master/src/main/kotlin/com/curlylab/curlylabback/repository/UserRepository.kt): `src/main/kotlin/com/curlylab/curlylabback/repository/UserRepository.kt`
- [Credentials Repository](https://github.com/fairies-pixels/curlylab-backend/blob/master/src/main/kotlin/com/curlylab/curlylabback/repository/UserAuthRepository.kt): `src/main/kotlin/com/curlylab/curlylabback/repository/UserAuthRepository.kt`
- [Provider Repository](https://github.com/fairies-pixels/curlylab-backend/blob/master/src/main/kotlin/com/curlylab/curlylabback/repository/UserProviderRepository.kt): `src/main/kotlin/com/curlylab/curlylabback/repository/UserProviderRepository.kt`
- [Refresh Tokens](https://github.com/fairies-pixels/curlylab-backend/blob/master/src/main/kotlin/com/curlylab/curlylabback/repository/RefreshTokenRepository.kt): `src/main/kotlin/com/curlylab/curlylabback/repository/RefreshTokenRepository.kt`
- [Favourites Repository](https://github.com/fairies-pixels/curlylab-backend/blob/master/src/main/kotlin/com/curlylab/curlylabback/repository/FavouriteRepository.kt): `src/main/kotlin/com/curlylab/curlylabback/repository/FavouriteRepository.kt`
- [Hair Type Repository](https://github.com/fairies-pixels/curlylab-backend/blob/master/src/main/kotlin/com/curlylab/curlylabback/repository/HairTypeRepository.kt): `src/main/kotlin/com/curlylab/curlylabback/repository/HairTypeRepository.kt`
- [Product Repository](https://github.com/fairies-pixels/curlylab-backend/blob/master/src/main/kotlin/com/curlylab/curlylabback/repository/ProductRepository.kt): `src/main/kotlin/com/curlylab/curlylabback/repository/ProductRepository.kt`
- [Reviews Repository](https://github.com/fairies-pixels/curlylab-backend/blob/master/src/main/kotlin/com/curlylab/curlylabback/repository/ReviewsRepository.kt): `src/main/kotlin/com/curlylab/curlylabback/repository/ReviewsRepository.kt`
- [Domain Models](https://github.com/fairies-pixels/curlylab-backend/tree/master/src/main/kotlin/com/curlylab/curlylabback/model): `src/main/kotlin/com/curlylab/curlylabback/model`

### Security And Storage

- [JWT Tokens](https://github.com/fairies-pixels/curlylab-backend/blob/master/src/main/kotlin/com/curlylab/curlylabback/service/JwtService.kt): `src/main/kotlin/com/curlylab/curlylabback/service/JwtService.kt`
- [Avatar Storage](https://github.com/fairies-pixels/curlylab-backend/blob/master/src/main/kotlin/com/curlylab/curlylabback/service/S3Service.kt): `src/main/kotlin/com/curlylab/curlylabback/service/S3Service.kt`

### Other components

- **API Client**
- **Relational Database**
- **Google Identity**
- **Amazon S3**

## Connections

- API Client → Auth API: sends requests (evidence: `src/main/kotlin/com/curlylab/curlylabback/controller/AuthController.kt`)
- API Client → Favourites API: sends requests (evidence: `src/main/kotlin/com/curlylab/curlylabback/controller/FavouritesController.kt`)
- API Client → Hair Type API: sends requests (evidence: `src/main/kotlin/com/curlylab/curlylabback/controller/HairTypeController.kt`)
- API Client → Products API: sends requests (evidence: `src/main/kotlin/com/curlylab/curlylabback/controller/ProductController.kt`)
- API Client → Reviews API: sends requests (evidence: `src/main/kotlin/com/curlylab/curlylabback/controller/ReviewsController.kt`)
- API Client → Users API: sends requests (evidence: `src/main/kotlin/com/curlylab/curlylabback/controller/UserController.kt`)
- Auth API → Local Auth: calls (evidence: `src/main/kotlin/com/curlylab/curlylabback/controller/AuthController.kt`)
- Auth API → Google Auth: calls (evidence: `src/main/kotlin/com/curlylab/curlylabback/controller/AuthController.kt`)
- Reviews API → Reviews: calls (evidence: `src/main/kotlin/com/curlylab/curlylabback/controller/ReviewsController.kt`)
- Hair Type API → Hair Types: calls (evidence: `src/main/kotlin/com/curlylab/curlylabback/controller/HairTypeController.kt`)
- Products API → Products: calls (evidence: `src/main/kotlin/com/curlylab/curlylabback/controller/ProductController.kt`)
- Users API → User Profiles: calls (evidence: `src/main/kotlin/com/curlylab/curlylabback/controller/UserController.kt`)
- Reviews → Reviews Repository: queries (evidence: `src/main/kotlin/com/curlylab/curlylabback/service/ReviewsService.kt`)
- Local Auth → Credentials Repository: checks credentials (evidence: `src/main/kotlin/com/curlylab/curlylabback/service/AuthService.kt`)
- Local Auth → User Repository: reads and creates users (evidence: `src/main/kotlin/com/curlylab/curlylabback/service/AuthService.kt`)
- Local Auth → Refresh Tokens: stores and revokes tokens (evidence: `src/main/kotlin/com/curlylab/curlylabback/service/AuthService.kt`)
- Local Auth → JWT Tokens: creates access token (evidence: `src/main/kotlin/com/curlylab/curlylabback/service/AuthService.kt`)
- Google Auth → User Repository: reads and creates users (evidence: `src/main/kotlin/com/curlylab/curlylabback/service/GoogleAuthService.kt`)
- Google Auth → Provider Repository: looks up provider (evidence: `src/main/kotlin/com/curlylab/curlylabback/service/GoogleAuthService.kt`)
- Google Auth → Refresh Tokens: stores refresh token (evidence: `src/main/kotlin/com/curlylab/curlylabback/service/GoogleAuthService.kt`)
- Google Auth → JWT Tokens: creates access token (evidence: `src/main/kotlin/com/curlylab/curlylabback/service/GoogleAuthService.kt`)
- Google Auth → Google Identity: verifies identity (evidence: `src/main/kotlin/com/curlylab/curlylabback/service/GoogleAuthService.kt`)
- Reviews Repository → Relational Database: queries and updates (evidence: `src/main/kotlin/com/curlylab/curlylabback/repository/ReviewsRepository.kt`)
- User Repository → Domain Models: maps user data (evidence: `src/main/kotlin/com/curlylab/curlylabback/repository/UserRepository.kt`)
- Credentials Repository → Domain Models: maps credentials (evidence: `src/main/kotlin/com/curlylab/curlylabback/repository/UserAuthRepository.kt`)
- Reviews Repository → Domain Models: maps reviews (evidence: `src/main/kotlin/com/curlylab/curlylabback/repository/ReviewsRepository.kt`)
- Favourites → Favourites Repository: uses repository (evidence: `src/main/kotlin/com/curlylab/curlylabback/service/FavouritesService.kt`)
- Hair Types → Hair Type Repository: uses repository (evidence: `src/main/kotlin/com/curlylab/curlylabback/service/HairTypeService.kt`)
- Products → Product Repository: uses repository (evidence: `src/main/kotlin/com/curlylab/curlylabback/service/ProductService.kt`)
- User Profiles → Avatar Storage: uploads and deletes avatars (evidence: `src/main/kotlin/com/curlylab/curlylabback/service/UserService.kt`)
- User Profiles → User Repository: reads and updates profile (evidence: `src/main/kotlin/com/curlylab/curlylabback/service/UserService.kt`)
- Avatar Storage → Amazon S3: stores avatar files
