# sundardstechmind/o-auth-react-java-springboot-api architecture

> Architecture diagram of the GitHub repository sundardstechmind/o-auth-react-java-springboot-api, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-02). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/sundardstechmind/o-auth-react-java-springboot-api
- Repository: https://github.com/sundardstechmind/o-auth-react-java-springboot-api

## Overview

This repository pairs a React login/profile client with a Spring OAuth backend. The main workflow is Google sign-in: the client receives a Google credential, submits it for verification, and uses the resulting cookie-backed session to request account information and show the profile page. The backend verifies Google ID tokens, creates or updates accounts, issues JWTs, and exposes account information. The source excerpts support the principal calls; client-to-server links are dashed because the cross-repository HTTP wiring is not directly shown.

Main entry points: [`spring-oauth/src/main/java/com/google/oauth/service/AccountService.java`](https://github.com/sundardstechmind/o-auth-react-java-springboot-api/blob/main/spring-oauth/src/main/java/com/google/oauth/service/AccountService.java) (Account service), [`react-oauth/src/App.js`](https://github.com/sundardstechmind/o-auth-react-java-springboot-api/blob/main/react-oauth/src/App.js) (Route app), [`react-oauth/src/pages/Login.jsx`](https://github.com/sundardstechmind/o-auth-react-java-springboot-api/blob/main/react-oauth/src/pages/Login.jsx) (Login page), [`react-oauth/src/components/GoogleLogin.jsx`](https://github.com/sundardstechmind/o-auth-react-java-springboot-api/blob/main/react-oauth/src/components/GoogleLogin.jsx) (Google button)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_client["React client"]
  node_app["Route app<br/>[App.js]"]
  node_login["Login page<br/>[Login.jsx]"]
  node_googlebutton["Google button<br/>[GoogleLogin.jsx]"]
  node_script["Script loader<br/>[useScript.jsx]"]
  node_nav["Navigation<br/>[Nav.jsx]"]
  node_posttoken["Token request<br/>[postLoginToken.js]"]
  node_userinfo["Profile request<br/>[getUserInfo.js]"]
  node_mypage["Profile page<br/>[MyPage.jsx]"]
end

subgraph group_auth["Backend authentication"]
  node_server["Spring application"]
  node_logincontroller["Login endpoint"]
  node_tokendto["ID token input"]
end

subgraph group_accounts["Account services"]
  node_accountservice["Account service"]
  node_accountrepo["Account repository"]
  node_account["Account entity<br/>[Account.java]"]
  node_accountcontroller["Account endpoint"]
  node_accountdto["Account response<br/>[AccountDto.java]"]
end

subgraph group_security["Request security"]
  node_securityconfig["Security config"]
  node_jwtfilter["JWT filter"]
  node_jwtutils["JWT utilities<br/>[JWTUtils.java]"]
  node_webconfig["Web config<br/>[WebConfig.java]"]
end

node_user(("User"))
node_google{{"Google Identity"}}

node_user -->|"opens"| node_app
node_app -->|"routes to"| node_login
node_app -->|"routes to"| node_mypage
node_app -->|"checks session"| node_userinfo
node_login -->|"renders"| node_googlebutton
node_login -->|"renders"| node_nav
node_login -->|"submits credential"| node_posttoken
node_googlebutton -->|"loads script"| node_script
node_googlebutton -->|"initializes sign-in"| node_google
node_mypage -->|"requests profile"| node_userinfo
node_posttoken -.->|"posts token"| node_logincontroller
node_userinfo -.->|"requests profile"| node_accountcontroller
node_logincontroller -->|"authenticates"| node_accountservice
node_logincontroller -->|"accepts input"| node_tokendto
node_accountservice -->|"verifies token"| node_google
node_accountservice -->|"reads and saves"| node_accountrepo
node_accountservice -->|"creates JWT"| node_jwtutils
node_accountservice -->|"creates account"| node_account
node_accountrepo -->|"persists"| node_account
node_accountcontroller -->|"loads account"| node_accountservice
node_accountcontroller -->|"converts response"| node_accountdto
node_securityconfig -->|"registers filter"| node_jwtfilter
node_jwtfilter -->|"verifies JWT"| node_jwtutils
node_jwtutils -->|"encodes claims"| node_account

click node_app "https://github.com/sundardstechmind/o-auth-react-java-springboot-api/blob/main/react-oauth/src/App.js"
click node_login "https://github.com/sundardstechmind/o-auth-react-java-springboot-api/blob/main/react-oauth/src/pages/Login.jsx"
click node_googlebutton "https://github.com/sundardstechmind/o-auth-react-java-springboot-api/blob/main/react-oauth/src/components/GoogleLogin.jsx"
click node_script "https://github.com/sundardstechmind/o-auth-react-java-springboot-api/blob/main/react-oauth/src/hooks/useScript.jsx"
click node_nav "https://github.com/sundardstechmind/o-auth-react-java-springboot-api/blob/main/react-oauth/src/components/Nav.jsx"
click node_posttoken "https://github.com/sundardstechmind/o-auth-react-java-springboot-api/blob/main/react-oauth/src/api/postLoginToken.js"
click node_userinfo "https://github.com/sundardstechmind/o-auth-react-java-springboot-api/blob/main/react-oauth/src/api/getUserInfo.js"
click node_mypage "https://github.com/sundardstechmind/o-auth-react-java-springboot-api/blob/main/react-oauth/src/pages/MyPage.jsx"
click node_server "https://github.com/sundardstechmind/o-auth-react-java-springboot-api/blob/main/spring-oauth/src/main/java/com/google/oauth/OauthApplication.java"
click node_logincontroller "https://github.com/sundardstechmind/o-auth-react-java-springboot-api/blob/main/spring-oauth/src/main/java/com/google/oauth/controller/LoginController.java"
click node_tokendto "https://github.com/sundardstechmind/o-auth-react-java-springboot-api/blob/main/spring-oauth/src/main/java/com/google/oauth/dto/IdTokenRequestDto.java"
click node_accountservice "https://github.com/sundardstechmind/o-auth-react-java-springboot-api/blob/main/spring-oauth/src/main/java/com/google/oauth/service/AccountService.java"
click node_accountrepo "https://github.com/sundardstechmind/o-auth-react-java-springboot-api/blob/main/spring-oauth/src/main/java/com/google/oauth/repository/AccountRepository.java"
click node_account "https://github.com/sundardstechmind/o-auth-react-java-springboot-api/blob/main/spring-oauth/src/main/java/com/google/oauth/user/Account.java"
click node_accountcontroller "https://github.com/sundardstechmind/o-auth-react-java-springboot-api/blob/main/spring-oauth/src/main/java/com/google/oauth/controller/AccountController.java"
click node_accountdto "https://github.com/sundardstechmind/o-auth-react-java-springboot-api/blob/main/spring-oauth/src/main/java/com/google/oauth/dto/AccountDto.java"
click node_securityconfig "https://github.com/sundardstechmind/o-auth-react-java-springboot-api/blob/main/spring-oauth/src/main/java/com/google/oauth/config/SecurityConfig.java"
click node_jwtfilter "https://github.com/sundardstechmind/o-auth-react-java-springboot-api/blob/main/spring-oauth/src/main/java/com/google/oauth/config/JWTRequestFilter.java"
click node_jwtutils "https://github.com/sundardstechmind/o-auth-react-java-springboot-api/blob/main/spring-oauth/src/main/java/com/google/oauth/config/JWTUtils.java"
click node_webconfig "https://github.com/sundardstechmind/o-auth-react-java-springboot-api/blob/main/spring-oauth/src/main/java/com/google/oauth/config/WebConfig.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_app,node_login,node_googlebutton,node_script,node_nav,node_posttoken,node_userinfo,node_mypage,node_user toneBlue
class node_server,node_logincontroller,node_tokendto toneAmber
class node_accountservice,node_accountrepo,node_account,node_accountcontroller,node_accountdto toneMint
class node_securityconfig,node_jwtfilter,node_jwtutils,node_webconfig toneRose
class node_google toneIndigo
```

## Components

### React client

- [Route app](https://github.com/sundardstechmind/o-auth-react-java-springboot-api/blob/main/react-oauth/src/App.js): `react-oauth/src/App.js`
- [Login page](https://github.com/sundardstechmind/o-auth-react-java-springboot-api/blob/main/react-oauth/src/pages/Login.jsx): `react-oauth/src/pages/Login.jsx`
- [Google button](https://github.com/sundardstechmind/o-auth-react-java-springboot-api/blob/main/react-oauth/src/components/GoogleLogin.jsx): `react-oauth/src/components/GoogleLogin.jsx`
- [Script loader](https://github.com/sundardstechmind/o-auth-react-java-springboot-api/blob/main/react-oauth/src/hooks/useScript.jsx): `react-oauth/src/hooks/useScript.jsx`
- [Navigation](https://github.com/sundardstechmind/o-auth-react-java-springboot-api/blob/main/react-oauth/src/components/Nav.jsx): `react-oauth/src/components/Nav.jsx`
- [Token request](https://github.com/sundardstechmind/o-auth-react-java-springboot-api/blob/main/react-oauth/src/api/postLoginToken.js): `react-oauth/src/api/postLoginToken.js`
- [Profile request](https://github.com/sundardstechmind/o-auth-react-java-springboot-api/blob/main/react-oauth/src/api/getUserInfo.js): `react-oauth/src/api/getUserInfo.js`
- [Profile page](https://github.com/sundardstechmind/o-auth-react-java-springboot-api/blob/main/react-oauth/src/pages/MyPage.jsx): `react-oauth/src/pages/MyPage.jsx`

### Backend authentication

- [Spring application](https://github.com/sundardstechmind/o-auth-react-java-springboot-api/blob/main/spring-oauth/src/main/java/com/google/oauth/OauthApplication.java): `spring-oauth/src/main/java/com/google/oauth/OauthApplication.java`
- [Login endpoint](https://github.com/sundardstechmind/o-auth-react-java-springboot-api/blob/main/spring-oauth/src/main/java/com/google/oauth/controller/LoginController.java): `spring-oauth/src/main/java/com/google/oauth/controller/LoginController.java`
- [ID token input](https://github.com/sundardstechmind/o-auth-react-java-springboot-api/blob/main/spring-oauth/src/main/java/com/google/oauth/dto/IdTokenRequestDto.java): `spring-oauth/src/main/java/com/google/oauth/dto/IdTokenRequestDto.java`

### Account services

- [Account service](https://github.com/sundardstechmind/o-auth-react-java-springboot-api/blob/main/spring-oauth/src/main/java/com/google/oauth/service/AccountService.java): `spring-oauth/src/main/java/com/google/oauth/service/AccountService.java`
- [Account repository](https://github.com/sundardstechmind/o-auth-react-java-springboot-api/blob/main/spring-oauth/src/main/java/com/google/oauth/repository/AccountRepository.java): `spring-oauth/src/main/java/com/google/oauth/repository/AccountRepository.java`
- [Account entity](https://github.com/sundardstechmind/o-auth-react-java-springboot-api/blob/main/spring-oauth/src/main/java/com/google/oauth/user/Account.java): `spring-oauth/src/main/java/com/google/oauth/user/Account.java`
- [Account endpoint](https://github.com/sundardstechmind/o-auth-react-java-springboot-api/blob/main/spring-oauth/src/main/java/com/google/oauth/controller/AccountController.java): `spring-oauth/src/main/java/com/google/oauth/controller/AccountController.java`
- [Account response](https://github.com/sundardstechmind/o-auth-react-java-springboot-api/blob/main/spring-oauth/src/main/java/com/google/oauth/dto/AccountDto.java): `spring-oauth/src/main/java/com/google/oauth/dto/AccountDto.java`

### Request security

- [Security config](https://github.com/sundardstechmind/o-auth-react-java-springboot-api/blob/main/spring-oauth/src/main/java/com/google/oauth/config/SecurityConfig.java): `spring-oauth/src/main/java/com/google/oauth/config/SecurityConfig.java`
- [JWT filter](https://github.com/sundardstechmind/o-auth-react-java-springboot-api/blob/main/spring-oauth/src/main/java/com/google/oauth/config/JWTRequestFilter.java): `spring-oauth/src/main/java/com/google/oauth/config/JWTRequestFilter.java`
- [JWT utilities](https://github.com/sundardstechmind/o-auth-react-java-springboot-api/blob/main/spring-oauth/src/main/java/com/google/oauth/config/JWTUtils.java): `spring-oauth/src/main/java/com/google/oauth/config/JWTUtils.java`
- [Web config](https://github.com/sundardstechmind/o-auth-react-java-springboot-api/blob/main/spring-oauth/src/main/java/com/google/oauth/config/WebConfig.java): `spring-oauth/src/main/java/com/google/oauth/config/WebConfig.java`

### Other components

- **User**
- **Google Identity**

## Connections

- User → Route app: opens
- Route app → Login page: routes to (evidence: `react-oauth/src/App.js`)
- Route app → Profile page: routes to (evidence: `react-oauth/src/App.js`)
- Route app → Profile request: checks session (evidence: `react-oauth/src/App.js`)
- Login page → Google button: renders (evidence: `react-oauth/src/pages/Login.jsx`)
- Login page → Navigation: renders (evidence: `react-oauth/src/pages/Login.jsx`)
- Login page → Token request: submits credential (evidence: `react-oauth/src/pages/Login.jsx`)
- Google button → Script loader: loads script (evidence: `react-oauth/src/components/GoogleLogin.jsx`)
- Google button → Google Identity: initializes sign-in (evidence: `react-oauth/src/components/GoogleLogin.jsx`)
- Profile page → Profile request: requests profile (evidence: `react-oauth/src/pages/MyPage.jsx`)
- Token request → Login endpoint: posts token
- Profile request → Account endpoint: requests profile
- Login endpoint → Account service: authenticates (evidence: `spring-oauth/src/main/java/com/google/oauth/controller/LoginController.java`)
- Login endpoint → ID token input: accepts input (evidence: `spring-oauth/src/main/java/com/google/oauth/controller/LoginController.java`)
- Account service → Google Identity: verifies token (evidence: `spring-oauth/src/main/java/com/google/oauth/service/AccountService.java`)
- Account service → Account repository: reads and saves (evidence: `spring-oauth/src/main/java/com/google/oauth/service/AccountService.java`)
- Account service → JWT utilities: creates JWT (evidence: `spring-oauth/src/main/java/com/google/oauth/service/AccountService.java`)
- Account service → Account entity: creates account (evidence: `spring-oauth/src/main/java/com/google/oauth/service/AccountService.java`)
- Account repository → Account entity: persists (evidence: `spring-oauth/src/main/java/com/google/oauth/repository/AccountRepository.java`)
- Account endpoint → Account service: loads account (evidence: `spring-oauth/src/main/java/com/google/oauth/controller/AccountController.java`)
- Account endpoint → Account response: converts response (evidence: `spring-oauth/src/main/java/com/google/oauth/controller/AccountController.java`)
- Security config → JWT filter: registers filter (evidence: `spring-oauth/src/main/java/com/google/oauth/config/SecurityConfig.java`)
- JWT filter → JWT utilities: verifies JWT (evidence: `spring-oauth/src/main/java/com/google/oauth/config/JWTRequestFilter.java`)
- JWT utilities → Account entity: encodes claims (evidence: `spring-oauth/src/main/java/com/google/oauth/config/JWTUtils.java`)
