# checo894/oci-mytodolist architecture

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

- Interactive diagram: https://gitdiagram.com/checo894/oci-mytodolist
- Repository: https://github.com/checo894/oci-mytodolist

## Overview

##### Main Components
- Frontend Component:
- Represented by the React JS application (located in backend/src/main/frontend).
- Includes UI pages like LoginPage, ManagerView, DeveloperView, and components for list and task management.
- Backend Component:
- A Spring Boot Java application (in the package com.springboot/MyTodoList) with controllers, services, repositories, and configuration classes handling business logic.
- Contains REST API endpoints (DeveloperController, SprintController, etc.) that interface with the frontend.
- Database:
- While there isn’t a dedicated DB folder, the presence of Oracle wallet files (under Wallet_BDDC1 and Wallet_reacttodolp41q) suggests connectivity to an Oracle database.
- The configuration files (ojdbc.properties, sqlnet.ora, tnsnames.ora, etc.) provide the secure connection details.
- Infrastructure & Deployment:
- Terraform scripts in the terraform/ directory indicate provisioning of cloud resources such as API gateways, container engines, databases, and object storage on OCI.
- Other scripts (deploy.sh, build.sh, dockerfile, etc.) along with container image generation indicate CI/CD and containerized deployment.
- Cloud Native & DevOps Tools:
- The OCI DevOps pipeline (oci_devops.yml) and additional utilities (in utils/) for Kubernetes, load balancing, and a container image generator.

##### Relationships and Data Flow
- Users access the application via a web browser.
- The frontend makes HTTP API calls to the backend (Spring Boot REST controllers).
- The backend processes these requests using its service and repository layers.
- The backend interacts with the Oracle database for persistence, leveraging secure connections provided by the wallet configuration.
- Terraform scripts and OCI resources are in charge of provisioning the runtime environment.
- The dockerfile and container scripts indicate how the application is containerized for deployment.

##### Architectural Patterns and Principles
- Separation of Concerns / Layered Architecture: UI (React) vs. business logic (Spring Boot controllers, services) vs. data persistence (Oracle Database).
- RESTful API design: Frontend-to-backend communications follow standard REST patterns.
- Cloud Native and Containerization: Use of Docker, Kubernetes (kubectl, terraform/kubernetes resource files), and infrastructure as code (Terraform) emphasize scalable, cloud-deployable design.
- Security best practices: Utilization of Oracle wallet files to secure database connections.

##### Relevant Technologies & Frameworks
- Frontend: React JS, JavaScript/ES6, potentially npm for package management.
- Backend: Java, Spring Boot, Maven (pom.xml, mvnw scripts).
- Database: Oracle (with Oracle JDBC, Oracle wallet configurations).
- CI/CD and Infrastructure: Terraform scripts for OCI resource provisioning, docker containerization via dockerfile, and OCI CLI integrations.
- DevOps: OCI devops configuration (oci_devops.yml) and scripts in utils/ for managing deployments.

## Diagram (Mermaid)

```mermaid
flowchart TD
    %% Main Components
    U["User Browser"]:::user
    FE["Frontend (React JS)"]:::frontend
    BE["Backend (Spring Boot)"]:::backend

    %% Database and Security Subgraph
    subgraph "Database & Security"
        DB["Oracle Database"]:::database
        W1["Wallet Config: BDDC1"]:::config
        W2["Wallet Config: reacttodolp41q"]:::config
    end

    %% Deployment & Infrastructure Subgraph
    subgraph "Deployment & Infrastructure"
        IN["Infrastructure Provisioning (Terraform)"]:::infrastructure
        subgraph "Containerization & Deployment Scripts"
            DF["Dockerfile"]:::deployment
            BS["Build Script"]:::deployment
            DS["Deploy Script"]:::deployment
            US["Undeploy Script"]:::deployment
        end
        subgraph "DevOps Pipeline & Utilities"
            DP["OCI DevOps Pipeline"]:::devops
            UT["Deployment Utilities"]:::devops
        end
    end

    %% Data Flow
    U -->|"accesses"| FE
    FE -->|"calls_API"| BE
    BE -->|"queries_DB"| DB
    BE -->|"uses_wallet"| W1
    BE -->|"uses_wallet"| W2

    %% Deployment Flow Connections
    IN -->|"supports"| DF
    DF -->|"builds"| BS
    BS -->|"deploys"| DS
    DS -->|"releases"| BE
    DP -->|"triggers"| DS
    UT -->|"supports"| DS
    US -->|"rollbacks"| BE

    %% Styles
    classDef user fill:#f9e79f,stroke:#7f8c8d,stroke-width:2px;
    classDef frontend fill:#aed6f1,stroke:#2471a3,stroke-width:2px;
    classDef backend fill:#a9dfbf,stroke:#239b56,stroke-width:2px;
    classDef database fill:#f5b7b1,stroke:#c0392b,stroke-width:2px;
    classDef config fill:#f7dc6f,stroke:#b7950b,stroke-width:2px;
    classDef infrastructure fill:#d2b4de,stroke:#7d3c98,stroke-width:2px;
    classDef deployment fill:#aed6f1,stroke:#2471a3,stroke-width:2px;
    classDef devops fill:#fadbd8,stroke:#cb4335,stroke-width:2px;

    %% Click Events
    click FE "https://github.com/checo894/oci-mytodolist/tree/main/MtdrSpring/backend/src/main/frontend"
    click BE "https://github.com/checo894/oci-mytodolist/tree/main/MtdrSpring/backend/src/main/java/com/springboot/MyTodoList"
    click W1 "https://github.com/checo894/oci-mytodolist/tree/main/MtdrSpring/backend/Wallet_BDDC1"
    click W2 "https://github.com/checo894/oci-mytodolist/tree/main/MtdrSpring/backend/Wallet_reacttodolp41q"
    click IN "https://github.com/checo894/oci-mytodolist/tree/main/MtdrSpring/terraform"
    click DF "https://github.com/checo894/oci-mytodolist/tree/main/MtdrSpring/backend/dockerfile"
    click BS "https://github.com/checo894/oci-mytodolist/blob/main/MtdrSpring/backend/build.sh"
    click DS "https://github.com/checo894/oci-mytodolist/blob/main/MtdrSpring/backend/deploy.sh"
    click US "https://github.com/checo894/oci-mytodolist/blob/main/MtdrSpring/backend/undeploy.sh"
    click DP "https://github.com/checo894/oci-mytodolist/blob/main/oci_devops.yml"
    click UT "https://github.com/checo894/oci-mytodolist/tree/main/MtdrSpring/utils"
```
