# r1aguilar/oracled2rc architecture

> Architecture diagram of the GitHub repository r1aguilar/oracled2rc, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2025-08-29). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/r1aguilar/oracled2rc
- Repository: https://github.com/r1aguilar/oracled2rc

## Overview

##### Project type and purpose
- This is a full-stack, cloud-native Task Manager (“MyTodoList”) application.
- Frontend: React.js SPA living under backend/src/main/frontend.
- Backend: Spring Boot microservice (Java) exposing REST APIs, handling auth (JWT), business logic, persistence.
- Infrastructure as Code: Terraform scripts provisioning OCI resources (API Gateway, Container Engine (OKE), Autonomous DB, Object Storage, etc.).
- Utilities and scripts for CI/CD, cluster setup, container image builds, and database initialization.

##### File structure
Top-level directories:
– MtdrSpring/backend: Maven-based Spring Boot project, includes Dockerfile, build/deploy scripts, Java source (controller, service, repository, model, security, config), React frontend under src/main/frontend.
– MtdrSpring/terraform: OCI resource definitions for API gateway, Kubernetes cluster, DB, storage, networking.
– MtdrSpring/utils: shell & Python helper scripts for environment setup, destroy, and token management.
– MtdrSpring/*.sh: high-level setup/destroy wrappers.
– test/: sample Dockerfile and Python test script.
Key patterns:
– Monorepo with combined frontend and backend artifacts.
– Spring Boot serves frontend static assets (built React bundle) from /static.
– Terraform defines cloud infra; scripts invoke terraform & OCI-CLI.

##### README insights
- Emphasizes React frontend + multiple possible backends on OCI Cloud Shell.
- Dependencies: oci-cli, python2.7, terraform, kubectl, maven.
- Shows an ER model for the Autonomous Transaction Processing (ATP) database.

## Diagram (Mermaid)

```mermaid
flowchart TB
    %% User and Frontend
    Browser["User Web Browser"]:::frontend
    Browser --> ReactSPA["React SPA"]:::frontend
    click ReactSPA "https://github.com/r1aguilar/oracled2rc/tree/master/MtdrSpring/backend/src/main/frontend"

    %% OCI Boundary
    subgraph "OCI Cloud" 
        direction TB
        APIGateway["OCI API Gateway"]:::infra
        LoadBalancer["OCI Load Balancer"]:::infra
        subgraph "OKE Cluster"
            direction TB
            K8sService["Kubernetes Service"]:::infra
            Pod["Spring Boot Pod"]:::backend
        end
        ATPDB["Autonomous Transaction Processing DB"]:::datastore
        RedisCluster["Redis Cluster"]:::datastore
        ObjectStorage["Object Storage"]:::datastore
        ContainerRegistry["Container Registry"]:::infra
    end

    %% Flows
    ReactSPA --> APIGateway
    APIGateway --> LoadBalancer
    LoadBalancer --> K8sService
    K8sService --> Pod
    Pod -->|"JDBC"| ATPDB
    Pod -->|"Redis GET/SET"| RedisCluster
    Pod -->|"Static Content"| ObjectStorage

    %% Spring Boot Detailed Components
    subgraph "Spring Boot Application" 
        direction TB
        AppMain["MyTodoListApplication"]:::backend
        subgraph Controllers
            direction TB
            AuthController["AuthenticationController"]:::backend
            ProyectoController["ProyectoController"]:::backend
            TareaController["TareaController"]:::backend
            ToDoItemController["ToDoItemController"]:::backend
            UsuarioController["UsuarioController"]:::backend
            SprintsController["SprintsController"]:::backend
            BotController["BotController"]:::backend
            ForwardController["ForwardController"]:::backend
            ToDoItemBotController["ToDoItemBotController"]:::backend
        end
        subgraph Security
            direction TB
            JwtFilter["JwtAuthenticationFilter"]:::backend
            JwtService["JwtService"]:::backend
            WebSecConfig["WebSecurityConfiguration"]:::backend
        end
        subgraph Configurations
            direction TB
            OracleConfig["OracleConfiguration"]:::backend
            RedisConfig["RedisClusterConfig"]:::backend
            CorsConfig["CorsConfig"]:::backend
            AppConfig["ApplicationConfig"]:::backend
        end
        subgraph Services
            direction TB
            ProyectoService["ProyectoService"]:::backend
            TareaService["TareaService"]:::backend
            UsuarioService["UsuarioService"]:::backend
        end
        subgraph Repositories
            direction TB
            ProyectoRepo["ProyectoRepository"]:::backend
            TareaRepo["TareaRepository"]:::backend
            UsuarioRepo["UsuarioRepository"]:::backend
        end
        Entities["Model Entities"]:::backend
        Utils["Utility Classes"]:::backend
        StaticAssets["Static Asset Serving"]:::backend
        WalletFiles["Wallet Files"]:::backend
        %% Internal flows
        AppMain --> Controllers
        Controllers --> Services
        Services --> Repositories
        Repositories --> Entities
        AppMain --> Security
        AppMain --> Configurations
        AppMain --> Utils
        StaticAssets --> Pod
        WalletFiles --> OracleConfig
    end

    Pod --> AppMain

    %% CI/CD and IaC
    subgraph "CI/CD & IaC" 
        direction TB
        GitHubActions["GitHub Actions"]:::infra
        OCIDevOps["OCI DevOps Pipeline"]:::infra
        Terraform["Terraform Scripts"]:::infra
        ShellUtils["Utility & Setup Scripts"]:::infra
    end
    GitHubActions --> ContainerRegistry
    GitHubActions --> OCIDevOps
    OCIDevOps --> ContainerRegistry
    Terraform --> APIGateway
    Terraform --> LoadBalancer
    Terraform --> K8sService
    Terraform --> ATPDB
    Terraform --> RedisCluster
    Terraform --> ObjectStorage
    ShellUtils --> Terraform

    %% Click Events
    click AppMain "https://github.com/r1aguilar/oracled2rc/blob/master/MtdrSpring/backend/src/main/java/com/springboot/MyTodoList/MyTodoListApplication.java"
    click AuthController "https://github.com/r1aguilar/oracled2rc/blob/master/MtdrSpring/backend/src/main/java/com/springboot/MyTodoList/controller/Auth/AuthenticationController.java"
    click JwtFilter "https://github.com/r1aguilar/oracled2rc/blob/master/MtdrSpring/backend/src/main/java/com/springboot/MyTodoList/security/JwtAuthenticationFilter.java"
    click JwtService "https://github.com/r1aguilar/oracled2rc/blob/master/MtdrSpring/backend/src/main/java/com/springboot/MyTodoList/security/JwtService.java"
    click WebSecConfig "https://github.com/r1aguilar/oracled2rc/blob/master/MtdrSpring/backend/src/main/java/com/springboot/MyTodoList/security/WebSecurityConfiguration.java"
    click OracleConfig "https://github.com/r1aguilar/oracled2rc/blob/master/MtdrSpring/backend/src/main/java/com/springboot/MyTodoList/config/OracleConfiguration.java"
    click RedisConfig "https://github.com/r1aguilar/oracled2rc/blob/master/MtdrSpring/backend/src/main/java/com/springboot/MyTodoList/config/RedisClusterConfig.java"
    click CorsConfig "https://github.com/r1aguilar/oracled2rc/blob/master/MtdrSpring/backend/src/main/java/com/springboot/MyTodoList/config/CorsConfig.java"
    click AppConfig "https://github.com/r1aguilar/oracled2rc/blob/master/MtdrSpring/backend/src/main/java/com/springboot/MyTodoList/config/ApplicationConfig.java"
    click ProyectoController "https://github.com/r1aguilar/oracled2rc/blob/master/MtdrSpring/backend/src/main/java/com/springboot/MyTodoList/controller/ProyectoController.java"
    click TareaController "https://github.com/r1aguilar/oracled2rc/blob/master/MtdrSpring/backend/src/main/java/com/springboot/MyTodoList/controller/TareaController.java"
    click ToDoItemController "https://github.com/r1aguilar/oracled2rc/blob/master/MtdrSpring/backend/src/main/java/com/springboot/MyTodoList/controller/ToDoItemController.java"
    click UsuarioController "https://github.com/r1aguilar/oracled2rc/blob/master/MtdrSpring/backend/src/main/java/com/springboot/MyTodoList/controller/UsuarioController.java"
    click SprintsController "https://github.com/r1aguilar/oracled2rc/blob/master/MtdrSpring/backend/src/main/java/com/springboot/MyTodoList/controller/SprintsController.java"
    click BotController "https://github.com/r1aguilar/oracled2rc/blob/master/MtdrSpring/backend/src/main/java/com/springboot/MyTodoList/controller/BotController.java"
    click ForwardController "https://github.com/r1aguilar/oracled2rc/blob/master/MtdrSpring/backend/src/main/java/com/springboot/MyTodoList/controller/ForwardController.java"
    click ToDoItemBotController "https://github.com/r1aguilar/oracled2rc/blob/master/MtdrSpring/backend/src/main/java/com/springboot/MyTodoList/controller/ToDoItemBotController.java"
    click ProyectoService "https://github.com/r1aguilar/oracled2rc/blob/master/MtdrSpring/backend/src/main/java/com/springboot/MyTodoList/service/ProyectoService.java"
    click TareaService "https://github.com/r1aguilar/oracled2rc/blob/master/MtdrSpring/backend/src/main/java/com/springboot/MyTodoList/service/TareaService.java"
    click UsuarioService "https://github.com/r1aguilar/oracled2rc/blob/master/MtdrSpring/backend/src/main/java/com/springboot/MyTodoList/service/UsuarioService.java"
    click ProyectoRepo "https://github.com/r1aguilar/oracled2rc/blob/master/MtdrSpring/backend/src/main/java/com/springboot/MyTodoList/repository/ProyectoRepository.java"
    click TareaRepo "https://github.com/r1aguilar/oracled2rc/blob/master/MtdrSpring/backend/src/main/java/com/springboot/MyTodoList/repository/TareaRespositories/TareaRepository.java"
    click UsuarioRepo "https://github.com/r1aguilar/oracled2rc/blob/master/MtdrSpring/backend/src/main/java/com/springboot/MyTodoList/repository/UsuarioRepository.java"
    click Entities "https://github.com/r1aguilar/oracled2rc/tree/master/MtdrSpring/backend/src/main/java/com/springboot/MyTodoList/model"
    click Utils "https://github.com/r1aguilar/oracled2rc/tree/master/MtdrSpring/backend/src/main/java/com/springboot/MyTodoList/util"
    click StaticAssets "https://github.com/r1aguilar/oracled2rc/tree/master/MtdrSpring/backend/src/main/resources/static"
    click WalletFiles "https://github.com/r1aguilar/oracled2rc/tree/master/MtdrSpring/backend/wallet"
    click Terraform "https://github.com/r1aguilar/oracled2rc/tree/master/MtdrSpring/terraform"
    click GitHubActions "https://github.com/r1aguilar/oracled2rc/blob/master/.github/workflows/lint.yml"
    click OCIDevOps "https://github.com/r1aguilar/oracled2rc/blob/master/oci_devops.yml"
    click ShellUtils "https://github.com/r1aguilar/oracled2rc/tree/master/MtdrSpring/utils"
    click ReactSPA "https://github.com/r1aguilar/oracled2rc/tree/master/MtdrSpring/backend/src/main/frontend"
    click setup "https://github.com/r1aguilar/oracled2rc/blob/master/MtdrSpring/setup.sh"
    click destroy "https://github.com/r1aguilar/oracled2rc/blob/master/MtdrSpring/destroy.sh"
    click deploy "https://github.com/r1aguilar/oracled2rc/blob/master/MtdrSpring/backend/deploy.sh"
    click deploy "https://github.com/r1aguilar/oracled2rc/blob/master/MtdrSpring/backend/undeploy.sh"

    %% Styles
    classDef frontend fill:#D0E8FF,stroke:#3B82F6,color:#1E40AF;
    classDef backend fill:#DCFCE7,stroke:#10B981,color:#065F46;
    classDef datastore fill:#FEF3C7,stroke:#F59E0B,color:#78350F;
    classDef infra fill:#F3E8FF,stroke:#A78BFA,color:#5B21B6;
```
