# codefarm0/auth-service architecture

> Architecture diagram of the GitHub repository codefarm0/auth-service, 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/codefarm0/auth-service
- Repository: https://github.com/codefarm0/auth-service

## Overview

This is a Spring-based authentication service exposing registration, login, access-token validation and revocation, and refresh-token rotation. The main workflow enters through the auth API and is handled by AuthService, which coordinates credential checks, JWT operations, token persistence, and response DTOs. Persistence and token generation are distinct internal layers. The source index and excerpts support the main service relationships; wiring to the database is not shown, so no database connection is asserted.

Main entry points: [`src/main/java/in/codefarm/auth/service/service/AuthService.java`](https://github.com/codefarm0/auth-service/blob/main/src/main/java/in/codefarm/auth/service/service/AuthService.java) (Auth orchestration), [`src/main/java/in/codefarm/auth/service/controller/AuthController.java`](https://github.com/codefarm0/auth-service/blob/main/src/main/java/in/codefarm/auth/service/controller/AuthController.java) (Auth endpoints), [`src/main/java/in/codefarm/auth/service/service/RefreshTokenService.java`](https://github.com/codefarm0/auth-service/blob/main/src/main/java/in/codefarm/auth/service/service/RefreshTokenService.java) (Refresh tokens), [`src/main/java/in/codefarm/auth/service/repository`](https://github.com/codefarm0/auth-service/tree/main/src/main/java/in/codefarm/auth/service/repository) (Data repositories)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_api["HTTP API"]
  node_controller["Auth endpoints"]
  node_dto["Auth DTOs"]
end

subgraph group_auth["Authentication"]
  node_auth_service["Auth orchestration<br/>[AuthService.java]"]
end

subgraph group_tokens["Token Security"]
  node_jwt["JWT operations<br/>[JwtService.java]"]
  node_jwt_config["JWT settings<br/>[JwtProperties.java]"]
  node_refresh_service["Refresh tokens"]
end

subgraph group_persistence["Persistence"]
  node_repositories["Data repositories"]
  node_entities[("User and tokens")]
end

node_client(("API client"))

node_client -->|"calls endpoints"| node_controller
node_controller -->|"delegates to"| node_auth_service
node_controller -->|"accepts and returns"| node_dto
node_auth_service -->|"builds responses"| node_dto
node_auth_service -->|"reads and writes"| node_repositories
node_auth_service -->|"validates and issues"| node_jwt
node_auth_service -->|"issues and hashes"| node_refresh_service
node_refresh_service -->|"stores tokens"| node_repositories
node_repositories -->|"maps entities"| node_entities
node_jwt -->|"uses settings"| node_jwt_config
node_refresh_service -->|"reads token TTL"| node_jwt_config

click node_controller "https://github.com/codefarm0/auth-service/blob/main/src/main/java/in/codefarm/auth/service/controller/AuthController.java"
click node_dto "https://github.com/codefarm0/auth-service/tree/main/src/main/java/in/codefarm/auth/service/dto"
click node_auth_service "https://github.com/codefarm0/auth-service/blob/main/src/main/java/in/codefarm/auth/service/service/AuthService.java"
click node_jwt "https://github.com/codefarm0/auth-service/blob/main/src/main/java/in/codefarm/auth/service/security/JwtService.java"
click node_jwt_config "https://github.com/codefarm0/auth-service/blob/main/src/main/java/in/codefarm/auth/service/security/JwtProperties.java"
click node_refresh_service "https://github.com/codefarm0/auth-service/blob/main/src/main/java/in/codefarm/auth/service/service/RefreshTokenService.java"
click node_repositories "https://github.com/codefarm0/auth-service/tree/main/src/main/java/in/codefarm/auth/service/repository"
click node_entities "https://github.com/codefarm0/auth-service/tree/main/src/main/java/in/codefarm/auth/service/entity"

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_controller,node_dto,node_client toneBlue
class node_auth_service toneAmber
class node_jwt,node_jwt_config,node_refresh_service toneMint
class node_repositories,node_entities toneRose
```

## Components

### HTTP API

- [Auth endpoints](https://github.com/codefarm0/auth-service/blob/main/src/main/java/in/codefarm/auth/service/controller/AuthController.java): `src/main/java/in/codefarm/auth/service/controller/AuthController.java`
- [Auth DTOs](https://github.com/codefarm0/auth-service/tree/main/src/main/java/in/codefarm/auth/service/dto): `src/main/java/in/codefarm/auth/service/dto`

### Authentication

- [Auth orchestration](https://github.com/codefarm0/auth-service/blob/main/src/main/java/in/codefarm/auth/service/service/AuthService.java): `src/main/java/in/codefarm/auth/service/service/AuthService.java`

### Token Security

- [JWT operations](https://github.com/codefarm0/auth-service/blob/main/src/main/java/in/codefarm/auth/service/security/JwtService.java): `src/main/java/in/codefarm/auth/service/security/JwtService.java`
- [JWT settings](https://github.com/codefarm0/auth-service/blob/main/src/main/java/in/codefarm/auth/service/security/JwtProperties.java): `src/main/java/in/codefarm/auth/service/security/JwtProperties.java`
- [Refresh tokens](https://github.com/codefarm0/auth-service/blob/main/src/main/java/in/codefarm/auth/service/service/RefreshTokenService.java): `src/main/java/in/codefarm/auth/service/service/RefreshTokenService.java`

### Persistence

- [Data repositories](https://github.com/codefarm0/auth-service/tree/main/src/main/java/in/codefarm/auth/service/repository): `src/main/java/in/codefarm/auth/service/repository`
- [User and tokens](https://github.com/codefarm0/auth-service/tree/main/src/main/java/in/codefarm/auth/service/entity): `src/main/java/in/codefarm/auth/service/entity`

### Other components

- **API client**

## Connections

- API client → Auth endpoints: calls endpoints (evidence: `src/main/java/in/codefarm/auth/service/controller/AuthController.java`)
- Auth endpoints → Auth orchestration: delegates to (evidence: `src/main/java/in/codefarm/auth/service/controller/AuthController.java`)
- Auth endpoints → Auth DTOs: accepts and returns (evidence: `src/main/java/in/codefarm/auth/service/controller/AuthController.java`)
- Auth orchestration → Auth DTOs: builds responses (evidence: `src/main/java/in/codefarm/auth/service/service/AuthService.java`)
- Auth orchestration → Data repositories: reads and writes (evidence: `src/main/java/in/codefarm/auth/service/service/AuthService.java`)
- Auth orchestration → JWT operations: validates and issues (evidence: `src/main/java/in/codefarm/auth/service/service/AuthService.java`)
- Auth orchestration → Refresh tokens: issues and hashes (evidence: `src/main/java/in/codefarm/auth/service/service/AuthService.java`)
- Refresh tokens → Data repositories: stores tokens (evidence: `src/main/java/in/codefarm/auth/service/service/RefreshTokenService.java`)
- Data repositories → User and tokens: maps entities (evidence: `src/main/java/in/codefarm/auth/service/repository/RefreshTokenRepository.java`)
- JWT operations → JWT settings: uses settings (evidence: `src/main/java/in/codefarm/auth/service/security/JwtService.java`)
- Refresh tokens → JWT settings: reads token TTL (evidence: `src/main/java/in/codefarm/auth/service/service/RefreshTokenService.java`)
