# scaleracademy/twitter-backend-java architecture

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

- Interactive diagram: https://gitdiagram.com/scaleracademy/twitter-backend-java
- Repository: https://github.com/scaleracademy/twitter-backend-java

## Overview

Moo is a Spring Boot backend for a Twitter-style social network. Clients use its REST API to authenticate, manage profiles and follows, publish and interact with posts, browse hashtags, and search posts or users. Controllers delegate to service implementations, which use repositories and JPA entities backed by MySQL (or H2). The tree and source index document these capability areas, but most controller and service implementations were not sampled; uncertain internal links are omitted. JWT and rotating refresh tokens are documented capabilities, with their detailed runtime wiring not fully shown here.

Main entry points: [`src/main/java/xyz/subho/clone/twitter/repository/UsersRepository.java`](https://github.com/scaleracademy/twitter-backend-java/blob/master/src/main/java/xyz/subho/clone/twitter/repository/UsersRepository.java) (User repository), [`src/main/java/xyz/subho/clone/twitter/controller/AuthenticationController.java`](https://github.com/scaleracademy/twitter-backend-java/blob/master/src/main/java/xyz/subho/clone/twitter/controller/AuthenticationController.java) (Authentication API), [`src/main/java/xyz/subho/clone/twitter/service/impl/PostServiceImpl.java`](https://github.com/scaleracademy/twitter-backend-java/blob/master/src/main/java/xyz/subho/clone/twitter/service/impl/PostServiceImpl.java) (Posts and reactions), [`src/main/java/xyz/subho/clone/twitter/service/impl/UserServiceImpl.java`](https://github.com/scaleracademy/twitter-backend-java/blob/master/src/main/java/xyz/subho/clone/twitter/service/impl/UserServiceImpl.java) (Profile and follows)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_api["REST API"]
  node_auth_api["Authentication API"]
  node_post_api["Post API"]
  node_user_api["User API"]
  node_hashtag_api["Hashtag API"]
  node_search_api["Search API"]
end

subgraph group_identity["Identity and profiles"]
  node_user_logic["Profile and follows"]
  node_auth_logic["Token lifecycle"]
  node_user_auth["User authentication lookup"]
  node_jwt["JWT utilities<br/>[JwtUtil.java]"]
  node_security["Request security"]
end

subgraph group_social["Social content"]
  node_post_logic["Posts and reactions"]
  node_hashtag_logic["Hashtag browsing"]
  node_search_logic["Post and user search"]
end

subgraph group_persistence["Persistence"]
  node_user_repo["User repository"]
  node_post_repo["Post repository"]
  node_hashtag_repo["Hashtag repositories"]
  node_social_repos["Social data repositories"]
  node_user_entity["User and follow entities<br/>[Users.java]"]
  node_post_entity["Post entities<br/>[Posts.java]"]
end

node_client(("API client"))
node_mysql[("MySQL / H2")]

node_client -->|"sends requests"| node_auth_api
node_client -->|"sends requests"| node_post_api
node_client -->|"sends requests"| node_user_api
node_client -->|"sends requests"| node_hashtag_api
node_client -->|"sends requests"| node_search_api
node_auth_api -->|"calls"| node_user_logic
node_auth_api -->|"rotates tokens"| node_auth_logic
node_auth_api -->|"uses"| node_jwt
node_user_api -->|"calls"| node_user_logic
node_post_api -->|"calls"| node_post_logic
node_hashtag_api -->|"calls"| node_hashtag_logic
node_search_api -->|"calls"| node_search_logic
node_user_logic -->|"queries and updates"| node_user_repo
node_user_logic -->|"manages follows"| node_social_repos
node_auth_logic -.->|"persists tokens"| node_social_repos
node_user_auth -->|"loads users"| node_user_repo
node_post_logic -->|"reads and writes"| node_post_repo
node_post_logic -->|"updates hashtag data"| node_hashtag_repo
node_post_logic -->|"manages likes"| node_social_repos
node_search_logic -->|"searches posts"| node_post_repo
node_search_logic -->|"searches users"| node_user_repo
node_hashtag_logic -.->|"loads hashtags"| node_hashtag_repo
node_user_repo -->|"persists"| node_user_entity
node_post_repo -->|"persists"| node_post_entity
node_hashtag_repo -->|"queries associations"| node_post_entity
node_user_repo -->|"stores data"| node_mysql
node_post_repo -->|"stores data"| node_mysql
node_hashtag_repo -->|"stores data"| node_mysql
node_security -.->|"validates tokens"| node_jwt

click node_auth_api "https://github.com/scaleracademy/twitter-backend-java/blob/master/src/main/java/xyz/subho/clone/twitter/controller/AuthenticationController.java"
click node_post_api "https://github.com/scaleracademy/twitter-backend-java/blob/master/src/main/java/xyz/subho/clone/twitter/controller/PostController.java"
click node_user_api "https://github.com/scaleracademy/twitter-backend-java/blob/master/src/main/java/xyz/subho/clone/twitter/controller/UserController.java"
click node_hashtag_api "https://github.com/scaleracademy/twitter-backend-java/blob/master/src/main/java/xyz/subho/clone/twitter/controller/HashtagController.java"
click node_search_api "https://github.com/scaleracademy/twitter-backend-java/blob/master/src/main/java/xyz/subho/clone/twitter/controller/SearchController.java"
click node_user_logic "https://github.com/scaleracademy/twitter-backend-java/blob/master/src/main/java/xyz/subho/clone/twitter/service/impl/UserServiceImpl.java"
click node_auth_logic "https://github.com/scaleracademy/twitter-backend-java/blob/master/src/main/java/xyz/subho/clone/twitter/service/impl/RefreshTokenServiceImpl.java"
click node_user_auth "https://github.com/scaleracademy/twitter-backend-java/blob/master/src/main/java/xyz/subho/clone/twitter/security/UserDetailsServiceImpl.java"
click node_jwt "https://github.com/scaleracademy/twitter-backend-java/blob/master/src/main/java/xyz/subho/clone/twitter/security/JwtUtil.java"
click node_security "https://github.com/scaleracademy/twitter-backend-java/blob/master/src/main/java/xyz/subho/clone/twitter/security/JwtRequestFilter.java"
click node_post_logic "https://github.com/scaleracademy/twitter-backend-java/blob/master/src/main/java/xyz/subho/clone/twitter/service/impl/PostServiceImpl.java"
click node_hashtag_logic "https://github.com/scaleracademy/twitter-backend-java/blob/master/src/main/java/xyz/subho/clone/twitter/service/impl/HashtagServiceImpl.java"
click node_search_logic "https://github.com/scaleracademy/twitter-backend-java/blob/master/src/main/java/xyz/subho/clone/twitter/service/impl/SearchServiceImpl.java"
click node_user_repo "https://github.com/scaleracademy/twitter-backend-java/blob/master/src/main/java/xyz/subho/clone/twitter/repository/UsersRepository.java"
click node_post_repo "https://github.com/scaleracademy/twitter-backend-java/blob/master/src/main/java/xyz/subho/clone/twitter/repository/PostsRepository.java"
click node_hashtag_repo "https://github.com/scaleracademy/twitter-backend-java/blob/master/src/main/java/xyz/subho/clone/twitter/repository/HashtagsRepository.java"
click node_social_repos "https://github.com/scaleracademy/twitter-backend-java/tree/master/src/main/java/xyz/subho/clone/twitter/repository"
click node_user_entity "https://github.com/scaleracademy/twitter-backend-java/blob/master/src/main/java/xyz/subho/clone/twitter/entity/Users.java"
click node_post_entity "https://github.com/scaleracademy/twitter-backend-java/blob/master/src/main/java/xyz/subho/clone/twitter/entity/Posts.java"

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_post_api,node_user_api,node_hashtag_api,node_search_api,node_client toneBlue
class node_user_logic,node_auth_logic,node_user_auth,node_jwt,node_security,node_mysql toneAmber
class node_post_logic,node_hashtag_logic,node_search_logic toneMint
class node_user_repo,node_post_repo,node_hashtag_repo,node_social_repos,node_user_entity,node_post_entity toneRose
```

## Components

### REST API

- [Authentication API](https://github.com/scaleracademy/twitter-backend-java/blob/master/src/main/java/xyz/subho/clone/twitter/controller/AuthenticationController.java): `src/main/java/xyz/subho/clone/twitter/controller/AuthenticationController.java`
- [Post API](https://github.com/scaleracademy/twitter-backend-java/blob/master/src/main/java/xyz/subho/clone/twitter/controller/PostController.java): `src/main/java/xyz/subho/clone/twitter/controller/PostController.java`
- [User API](https://github.com/scaleracademy/twitter-backend-java/blob/master/src/main/java/xyz/subho/clone/twitter/controller/UserController.java): `src/main/java/xyz/subho/clone/twitter/controller/UserController.java`
- [Hashtag API](https://github.com/scaleracademy/twitter-backend-java/blob/master/src/main/java/xyz/subho/clone/twitter/controller/HashtagController.java): `src/main/java/xyz/subho/clone/twitter/controller/HashtagController.java`
- [Search API](https://github.com/scaleracademy/twitter-backend-java/blob/master/src/main/java/xyz/subho/clone/twitter/controller/SearchController.java): `src/main/java/xyz/subho/clone/twitter/controller/SearchController.java`

### Identity and profiles

- [Profile and follows](https://github.com/scaleracademy/twitter-backend-java/blob/master/src/main/java/xyz/subho/clone/twitter/service/impl/UserServiceImpl.java): `src/main/java/xyz/subho/clone/twitter/service/impl/UserServiceImpl.java`
- [Token lifecycle](https://github.com/scaleracademy/twitter-backend-java/blob/master/src/main/java/xyz/subho/clone/twitter/service/impl/RefreshTokenServiceImpl.java): `src/main/java/xyz/subho/clone/twitter/service/impl/RefreshTokenServiceImpl.java`
- [User authentication lookup](https://github.com/scaleracademy/twitter-backend-java/blob/master/src/main/java/xyz/subho/clone/twitter/security/UserDetailsServiceImpl.java): `src/main/java/xyz/subho/clone/twitter/security/UserDetailsServiceImpl.java`
- [JWT utilities](https://github.com/scaleracademy/twitter-backend-java/blob/master/src/main/java/xyz/subho/clone/twitter/security/JwtUtil.java): `src/main/java/xyz/subho/clone/twitter/security/JwtUtil.java`
- [Request security](https://github.com/scaleracademy/twitter-backend-java/blob/master/src/main/java/xyz/subho/clone/twitter/security/JwtRequestFilter.java): `src/main/java/xyz/subho/clone/twitter/security/JwtRequestFilter.java`

### Social content

- [Posts and reactions](https://github.com/scaleracademy/twitter-backend-java/blob/master/src/main/java/xyz/subho/clone/twitter/service/impl/PostServiceImpl.java): `src/main/java/xyz/subho/clone/twitter/service/impl/PostServiceImpl.java`
- [Hashtag browsing](https://github.com/scaleracademy/twitter-backend-java/blob/master/src/main/java/xyz/subho/clone/twitter/service/impl/HashtagServiceImpl.java): `src/main/java/xyz/subho/clone/twitter/service/impl/HashtagServiceImpl.java`
- [Post and user search](https://github.com/scaleracademy/twitter-backend-java/blob/master/src/main/java/xyz/subho/clone/twitter/service/impl/SearchServiceImpl.java): `src/main/java/xyz/subho/clone/twitter/service/impl/SearchServiceImpl.java`

### Persistence

- [User repository](https://github.com/scaleracademy/twitter-backend-java/blob/master/src/main/java/xyz/subho/clone/twitter/repository/UsersRepository.java): `src/main/java/xyz/subho/clone/twitter/repository/UsersRepository.java`
- [Post repository](https://github.com/scaleracademy/twitter-backend-java/blob/master/src/main/java/xyz/subho/clone/twitter/repository/PostsRepository.java): `src/main/java/xyz/subho/clone/twitter/repository/PostsRepository.java`
- [Hashtag repositories](https://github.com/scaleracademy/twitter-backend-java/blob/master/src/main/java/xyz/subho/clone/twitter/repository/HashtagsRepository.java): `src/main/java/xyz/subho/clone/twitter/repository/HashtagsRepository.java`
- [Social data repositories](https://github.com/scaleracademy/twitter-backend-java/tree/master/src/main/java/xyz/subho/clone/twitter/repository): `src/main/java/xyz/subho/clone/twitter/repository`
- [User and follow entities](https://github.com/scaleracademy/twitter-backend-java/blob/master/src/main/java/xyz/subho/clone/twitter/entity/Users.java): `src/main/java/xyz/subho/clone/twitter/entity/Users.java`
- [Post entities](https://github.com/scaleracademy/twitter-backend-java/blob/master/src/main/java/xyz/subho/clone/twitter/entity/Posts.java): `src/main/java/xyz/subho/clone/twitter/entity/Posts.java`

### Other components

- **API client**
- **MySQL / H2**

## Connections

- API client → Authentication API: sends requests (evidence: `README.md`)
- API client → Post API: sends requests (evidence: `README.md`)
- API client → User API: sends requests (evidence: `README.md`)
- API client → Hashtag API: sends requests (evidence: `README.md`)
- API client → Search API: sends requests (evidence: `README.md`)
- Authentication API → Profile and follows: calls (evidence: `src/main/java/xyz/subho/clone/twitter/controller/AuthenticationController.java`)
- Authentication API → Token lifecycle: rotates tokens (evidence: `src/main/java/xyz/subho/clone/twitter/controller/AuthenticationController.java`)
- Authentication API → JWT utilities: uses (evidence: `src/main/java/xyz/subho/clone/twitter/controller/AuthenticationController.java`)
- User API → Profile and follows: calls (evidence: `src/main/java/xyz/subho/clone/twitter/controller/UserController.java`)
- Post API → Posts and reactions: calls (evidence: `src/main/java/xyz/subho/clone/twitter/controller/PostController.java`)
- Hashtag API → Hashtag browsing: calls (evidence: `src/main/java/xyz/subho/clone/twitter/controller/HashtagController.java`)
- Search API → Post and user search: calls (evidence: `src/main/java/xyz/subho/clone/twitter/controller/SearchController.java`)
- Profile and follows → User repository: queries and updates (evidence: `src/main/java/xyz/subho/clone/twitter/service/impl/UserServiceImpl.java`)
- Profile and follows → Social data repositories: manages follows (evidence: `src/main/java/xyz/subho/clone/twitter/service/impl/UserServiceImpl.java`)
- Token lifecycle → Social data repositories: persists tokens (evidence: `src/main/java/xyz/subho/clone/twitter/service/impl/RefreshTokenServiceImpl.java`)
- User authentication lookup → User repository: loads users (evidence: `src/main/java/xyz/subho/clone/twitter/security/UserDetailsServiceImpl.java`)
- Posts and reactions → Post repository: reads and writes (evidence: `src/main/java/xyz/subho/clone/twitter/service/impl/PostServiceImpl.java`)
- Posts and reactions → Hashtag repositories: updates hashtag data (evidence: `src/main/java/xyz/subho/clone/twitter/service/impl/PostServiceImpl.java`)
- Posts and reactions → Social data repositories: manages likes (evidence: `src/main/java/xyz/subho/clone/twitter/service/impl/PostServiceImpl.java`)
- Post and user search → Post repository: searches posts (evidence: `src/main/java/xyz/subho/clone/twitter/service/impl/SearchServiceImpl.java`)
- Post and user search → User repository: searches users (evidence: `src/main/java/xyz/subho/clone/twitter/service/impl/SearchServiceImpl.java`)
- Hashtag browsing → Hashtag repositories: loads hashtags
- User repository → User and follow entities: persists (evidence: `src/main/java/xyz/subho/clone/twitter/repository/UsersRepository.java`)
- Post repository → Post entities: persists (evidence: `src/main/java/xyz/subho/clone/twitter/repository/PostsRepository.java`)
- Hashtag repositories → Post entities: queries associations (evidence: `src/main/java/xyz/subho/clone/twitter/repository/HashtagsRepository.java`)
- User repository → MySQL / H2: stores data (evidence: `README.md`)
- Post repository → MySQL / H2: stores data (evidence: `README.md`)
- Hashtag repositories → MySQL / H2: stores data (evidence: `README.md`)
- Request security → JWT utilities: validates tokens
