# baezzys/google-oauth2-login-spring-react-demo architecture

> Architecture diagram of the GitHub repository baezzys/google-oauth2-login-spring-react-demo, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2025-04-13). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/baezzys/google-oauth2-login-spring-react-demo
- Repository: https://github.com/baezzys/google-oauth2-login-spring-react-demo

## Overview

##### Main Components
- Frontend Client (React):
- Located under the “react-oauth” directory.
- Handles obtaining the Google ID token and displaying user information once authenticated.
- Backend Server (Spring Boot):
- Found under the “spring-oauth” directory.
- Contains the main Java application (OauthApplication.java), configuration classes (JWTRequestFilter, SecurityConfig, WebConfig), controllers (AccountController, LoginController), DTOs, repositories (AccountRepository), and service handling (AccountService).
- Manages validation of the Google ID token, account creation, JWT generation, cookie management, and securing API endpoints.
- External Google OAuth Service:
- Represents Google’s OAuth service which issues the ID token needed for authentication.
- Database (Embedded/H2):
- Although not explicitly shown as a separate directory, usage of Spring Data JPA and H2 (via configuration in application.yml) indicates that an H2 database is used for account persistence.

##### Relationships and Interactions
- The frontend sends the Google-provided ID token to the backend (through postLoginToken API) upon user login.
- The backend validates the ID token, creates (or verifies) the user account, and generates a custom JWT.
- The JWT is sent back as a cookie to the frontend.
- For subsequent processes (like user information retrieval), the frontend includes this JWT cookie along with API calls (via getUserInfo API) to the backend.
- Internal interactions in the backend include filtering requests (JWTRequestFilter) and controlling access with the SecurityConfig.

##### Architectural Patterns & Technologies
- Use of OAuth 2.0 for authentication.
- Use of JWT for stateless authentication and session management.
- MVC pattern in the Spring Boot part (controllers, services, repositories, DTOs).
- Separation of concerns between the frontend (React components, pages, API integrations) and backend (REST controllers, business logic, security filters, data access).
- Configuration management via application.yml (Spring Boot) and .env (React).

##### Additional Detail Inclusions
- Clearly label configuration elements like environment variables (.env in React and application.yml in Spring Boot) as they are integral to the OAuth2 and JWT configurations.
- Security flow where the JWT filter (JWTRequestFilter) intercepts API requests to validate tokens.
- Dependencies, such as Spring Boot’s dependency on gradle for builds, and React’s npm management.

## Diagram (Mermaid)

```mermaid
flowchart TD
    %% Global Entities
    User("User"):::user

    %% Frontend (React)
    subgraph "Frontend (React)"
        frontendEnv("Environment (.env)"):::frontend
        frontendAssets("Public Assets (index.html & icons)"):::frontend
        apiGetUser("getUserInfo.js"):::frontend
        apiPostLogin("postLoginToken.js"):::frontend
        compGoogle("GoogleLogin.jsx"):::frontend
        compNav("Nav.jsx"):::frontend
        hookScript("useScript.jsx"):::frontend
        pageLogin("Login.jsx"):::frontend
        pageMyPage("MyPage.jsx"):::frontend
    end

    %% Backend (Spring Boot)
    subgraph "Backend (Spring Boot)"
        backendApp("OauthApplication.java"):::backend
        configJWTRequest("JWTRequestFilter.java"):::backend
        configJWTUtils("JWTUtils.java"):::backend
        configSecurity("SecurityConfig.java"):::backend
        configWeb("WebConfig.java"):::backend
        controllerAccount("AccountController.java"):::backend
        controllerLogin("LoginController.java"):::backend
        dtoAccount("AccountDto.java"):::backend
        dtoIdToken("IdTokenRequestDto.java"):::backend
        repoAccount("AccountRepository.java"):::backend
        serviceAccount("AccountService.java"):::backend
        resourceYml("application.yml"):::backend
    end

    %% External Services and Database
    databaseH2("H2 Database"):::database
    googleOAuth("Google OAuth"):::external

    %% Relationships & Data Flow

    %% User interactions on Frontend
    User -->|"initiatesLogin"| compGoogle
    User -->|"viewsLoginPage"| pageLogin
    User -->|"navigates"| compNav

    %% Google OAuth flow
    compGoogle -->|"requestsToken"| googleOAuth
    googleOAuth -->|"sendsIDToken"| compGoogle

    %% Frontend to Backend communication for login
    compGoogle -->|"triggersPostToken"| apiPostLogin
    apiPostLogin -->|"postsIDToken"| controllerLogin

    %% Backend authentication flow
    controllerLogin -->|"validatesToken"| serviceAccount
    serviceAccount -->|"checksOrCreatesAccount"| repoAccount
    repoAccount -->|"queries"| databaseH2
    serviceAccount -->|"returnsJWTCookie"| controllerLogin
    controllerLogin -->|"sendsJWTCookie"| compGoogle

    %% Subsequent user info retrieval
    apiGetUser -->|"requestsUserInfo"| controllerAccount
    controllerAccount -->|"fetchesAccountInfo"| serviceAccount
    serviceAccount -->|"queriesAccount"| repoAccount

    %% Security configuration flow in Backend
    configSecurity -->|"configuresFilter"| configJWTRequest
    controllerLogin -->|"securedByFilter"| configJWTRequest
    controllerAccount -->|"securedByFilter"| configJWTRequest

    %% Visual Associations within Frontend (dashed links)
    frontendEnv -.-> compGoogle
    frontendAssets -.-> compGoogle
    hookScript -.-> compGoogle
    pageMyPage -.-> compNav

    %% Click Events for Frontend Components
    click frontendEnv "https://github.com/baezzys/google-oauth2-login-spring-react-demo/blob/main/react-oauth/.env"
    click frontendAssets "https://github.com/baezzys/google-oauth2-login-spring-react-demo/blob/main/react-oauth/public/index.html"
    click frontendAssets "https://github.com/baezzys/google-oauth2-login-spring-react-demo/tree/main/react-oauth/public/icon"
    click apiGetUser "https://github.com/baezzys/google-oauth2-login-spring-react-demo/blob/main/react-oauth/src/api/getUserInfo.js"
    click apiPostLogin "https://github.com/baezzys/google-oauth2-login-spring-react-demo/blob/main/react-oauth/src/api/postLoginToken.js"
    click compGoogle "https://github.com/baezzys/google-oauth2-login-spring-react-demo/blob/main/react-oauth/src/components/GoogleLogin.jsx"
    click compNav "https://github.com/baezzys/google-oauth2-login-spring-react-demo/blob/main/react-oauth/src/components/Nav.jsx"
    click hookScript "https://github.com/baezzys/google-oauth2-login-spring-react-demo/blob/main/react-oauth/src/hooks/useScript.jsx"
    click pageLogin "https://github.com/baezzys/google-oauth2-login-spring-react-demo/blob/main/react-oauth/src/pages/Login.jsx"
    click pageMyPage "https://github.com/baezzys/google-oauth2-login-spring-react-demo/blob/main/react-oauth/src/pages/MyPage.jsx"

    %% Click Events for Backend Components
    click backendApp "https://github.com/baezzys/google-oauth2-login-spring-react-demo/blob/main/spring-oauth/src/main/java/com/google/oauth/OauthApplication.java"
    click configJWTRequest "https://github.com/baezzys/google-oauth2-login-spring-react-demo/blob/main/spring-oauth/src/main/java/com/google/oauth/config/JWTRequestFilter.java"
    click configJWTUtils "https://github.com/baezzys/google-oauth2-login-spring-react-demo/blob/main/spring-oauth/src/main/java/com/google/oauth/config/JWTUtils.java"
    click configSecurity "https://github.com/baezzys/google-oauth2-login-spring-react-demo/blob/main/spring-oauth/src/main/java/com/google/oauth/config/SecurityConfig.java"
    click configWeb "https://github.com/baezzys/google-oauth2-login-spring-react-demo/blob/main/spring-oauth/src/main/java/com/google/oauth/config/WebConfig.java"
    click controllerAccount "https://github.com/baezzys/google-oauth2-login-spring-react-demo/blob/main/spring-oauth/src/main/java/com/google/oauth/controller/AccountController.java"
    click controllerLogin "https://github.com/baezzys/google-oauth2-login-spring-react-demo/blob/main/spring-oauth/src/main/java/com/google/oauth/controller/LoginController.java"
    click dtoAccount "https://github.com/baezzys/google-oauth2-login-spring-react-demo/blob/main/spring-oauth/src/main/java/com/google/oauth/dto/AccountDto.java"
    click dtoIdToken "https://github.com/baezzys/google-oauth2-login-spring-react-demo/blob/main/spring-oauth/src/main/java/com/google/oauth/dto/IdTokenRequestDto.java"
    click repoAccount "https://github.com/baezzys/google-oauth2-login-spring-react-demo/blob/main/spring-oauth/src/main/java/com/google/oauth/repository/AccountRepository.java"
    click serviceAccount "https://github.com/baezzys/google-oauth2-login-spring-react-demo/blob/main/spring-oauth/src/main/java/com/google/oauth/service/AccountService.java"
    click resourceYml "https://github.com/baezzys/google-oauth2-login-spring-react-demo/blob/main/spring-oauth/src/main/resources/application.yml"

    %% Style Classes
    classDef frontend fill:#bbdefb,stroke:#1976d2,stroke-width:2px;
    classDef backend fill:#ffcdd2,stroke:#c62828,stroke-width:2px;
    classDef external fill:#c8e6c9,stroke:#388e3c,stroke-width:2px;
    classDef database fill:#fff9c4,stroke:#f9a825,stroke-width:2px;
    classDef user fill:#e0e0e0,stroke:#616161,stroke-width:2px;
```
