# paduartesre/project-root architecture

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

- Interactive diagram: https://gitdiagram.com/paduartesre/project-root
- Repository: https://github.com/paduartesre/project-root

## Overview

Para criar um diagrama de arquitetura que reflita com precisão este projeto “WordPress em Kubernetes via Terraform”, siga estas orientações, específicas para o seu cenário:

##### Identificação do Tipo de Projeto e Propósito
- Trata-se de uma aplicação full-stack em Kubernetes, orquestrada via Terraform (Infraestrutura como Código).
- Objetivo: provisionar automaticamente um ambiente local (Minikube) com WordPress, PostgreSQL, Redis e um job de carregamento de dados via script Python.

##### Análise da Estrutura de Diretórios
- Top-level:
- main.tf / módulos Terraform
- configmaps/ – definições de ConfigMap
- data/ – CSV de exemplo
- jobs/ – Terraform que cria um Job Kubernetes para carregar dados
- scripts/ – load_data.py
- databases/ – módulo Terraform p/ Postgres e Redis
- wordpress/ – módulo Terraform p/ WordPress
- Cada subdiretório Terraform gerencia recursos em seu namespace correspondente (wordpress, databases).

##### Componentes Principais (caixas no diagrama)
a. Infraestrutura como Código
– Terraform Controller (máquina local ou CI)
– Módulos: databases, configmaps, jobs, wordpress
b. Cluster Kubernetes (Minikube)
– API Server
– Scheduler, etcd, kube-proxy
c. Namespaces
– databases
– wordpress
d. Workloads e Recursos Kubernetes
– StatefulSet “postgresql” + PersistentVolumeClaim
– StatefulSet “redis” + PVC
– Deployment “wordpress”
– Service “postgres-service”, “redis-service”, “wordpress-service”
– Ingress (Nginx) para expor WordPress
– ConfigMap (script + CSV)
– Job “load-data” que monta ConfigMap, roda load_data.py
– Secrets (credenciais do DB)
e. Rede e Fluxos de Dados
– Cliente Browser → Ingress → Service WordPress → Pod WordPress
– WordPress Pod → Service postgres-service → Pod PostgreSQL
– WordPress Pod → Service redis-service → Pod Redis
– Job Pod (load-data) → lê CSV do ConfigMap → grava em PostgreSQL e Redis via Services
f. Elementos Externos
– kubectl / Minikube Dashboard
– Usuário Operacional (execução de terraform apply)

##### Relações e Interações (setas direcionais)
- Terraform CLI → Kubernetes API (cria todos os recursos)
- Ingress Controller ← tráfego HTTP externo
- WordPress Pod ↔ PostgreSQL Pod (TCP 5432)
- WordPress Pod ↔ Redis Pod (TCP 6379)
- Job Pod → ConfigMap (montagem de volume)
- Job Pod → bases de dados (inserção de dados)

##### Padrões Arquiteturais e Princípios
- Infraestrutura como Código (modularização de módulos Terraform).
- Isolamento por Namespaces.
- StatefulSets para bancos de dados (persistência + estabilidade).
- Deployment para aplicação stateless (WordPress).
- Uso de ConfigMaps e Secrets para configuração dinâmica e credenciais.
- Job para tarefas batch de carregamento de dados.

##### Tecnologias e Frameworks
- Terraform v1.6.3
- Minikube v1.32.0 (Kubernetes v1.28)
- Kubernetes (Deployment, StatefulSet, Service, Ingress, ConfigMap, Secret, Job)
- Python (load_data.py)
- CSV (data/dados.csv)

##### Diretrizes de Desenho do Diagrama
- Desenhe três grandes camadas/zonas:
1) IaC (Terraform CLI + módulos)
2) Cluster Kubernetes (control plane + nodes)
3) Consumidores/Usuários finais (browser, kubectl)
- Dentro da zona do Cluster, represente dois Namespaces paralelos: “databases” e “wordpress”.
- Utilize caixas retangulares para componentes (ex.: StatefulSet Postgres), cilindros para volumes (PVC), ícones de nuvem ou cubo para ConfigMaps/Secrets.
- Setas unidirecionais ou bidirecionais para fluxo de dados e dependências.
- Aplique cores ou estilos de borda:
- Azul para infra (Terraform).
- Verde para recursos de banco (StatefulSets).
- Laranja para aplicação (Deployment).
- Roxo para config e jobs.
- Adicione legendas para namespaces e protocolos de comunicação (TCP/HTTP).

##### Checklist para o Diagrama Final
- Componentes claramente rotulados (ex.: “StatefulSet: postgresql”).
- Fluxo de dados (setas) com rótulos de porta/protocolo se relevante.
- Cores ou formas distintas para tipos de recurso (apps, infra, dados).
- Indicação de namespaces delimitando áreas de deploy.
- Conexões do Terraform CLI à API Kubernetes.
- Camada de Ingress e tráfego externo.

Seguindo essas orientações, você obterá um diagrama completo, granular e fiel à arquitetura real deste projeto.

## Diagram (Mermaid)

```mermaid
flowchart TD
    %% IaC Layer
    subgraph "Infrastructure as Code" 
        direction TB
        TerraformCLI["Terraform CLI"]:::infra
        DatabasesModule["Databases Module"]:::infra
        WordPressModule["WordPress Module"]:::infra
        ConfigMapsModule["ConfigMaps Module"]:::infra
        JobsModule["Job Module"]:::infra
    end

    %% Kubernetes Cluster Layer
    subgraph "Kubernetes Cluster"
        direction TB
        %% Control Plane
        subgraph "Control Plane"
            direction TB
            APIServer["API Server"]:::infra
            Scheduler["Scheduler"]:::infra
            Etcd["etcd"]:::infra
            KubeProxy["kube-proxy"]:::infra
        end

        %% Namespaces
        subgraph "Namespace: databases"
            direction TB
            PG[(StatefulSet: postgresql)]:::db
            PVC_PG[(PVC: postgresql)]:::db
            RS[(StatefulSet: redis)]:::db
            PVC_RS[(PVC: redis)]:::db
            PSvc["Service: postgres-service"]:::db
            RSvc["Service: redis-service"]:::db
        end

        subgraph "Namespace: wordpress"
            direction TB
            WPDep["Deployment: wordpress"]:::app
            WSvc["Service: wordpress-service"]:::app
            Ingress["Ingress: wordpress"]:::app
            Secret["Secrets: DB Credentials"]:::config
        end

        %% Config and Jobs
        subgraph "Batch and Config"
            direction TB
            ConfigMap["ConfigMap: load-data"]:::config
            DataCSV["CSV Data Source"]:::config
            LoadScript["load_data.py"]:::config
            Job["Job: load-data"]:::config
            MySQLDep["MySQL Deployment"]:::config
            MySQLSvc["MySQL Service"]:::config
            HPA["HPA"]:::config
        end
    end

    %% Users and Tools
    subgraph "Users & Tools"
        direction TB
        Browser["Browser"]:::user
        Kubectl["kubectl / Dashboard"]:::user
    end

    %% Connections
    Kubectl -->|executes terraform apply| TerraformCLI
    TerraformCLI -->|calls Kubernetes API| APIServer

    %% Cluster Wklds creation
    APIServer -->|create| PG
    APIServer -->|create| PVC_PG
    APIServer -->|create| RS
    APIServer -->|create| PVC_RS
    APIServer -->|create| PSvc
    APIServer -->|create| RSvc
    APIServer -->|create| WPDep
    APIServer -->|create| WSvc
    APIServer -->|create| Ingress
    APIServer -->|create| ConfigMap
    APIServer -->|create| Secret
    APIServer -->|create| Job
    APIServer -->|create| MySQLDep
    APIServer -->|create| MySQLSvc
    APIServer -->|create| HPA

    %% Data Flows
    Browser -->|HTTP| Ingress
    Ingress -->|forward| WSvc
    WSvc -->|route| WPDep
    WPDep -->|"TCP 5432"| PSvc
    PSvc -->|connect| PG
    WPDep -->|"TCP 6379"| RSvc
    RSvc -->|connect| RS
    Job -->|mount| ConfigMap
    Job -->|read| DataCSV
    Job -->|"write to DB"| PSvc
    Job -->|"write to Cache"| RSvc

    %% IaC Modules Dependencies
    TerraformCLI --> DatabasesModule
    TerraformCLI --> WordPressModule
    TerraformCLI --> ConfigMapsModule
    TerraformCLI --> JobsModule

    %% Click Events
    click TerraformCLI "https://github.com/paduartesre/project-root/blob/main/main.tf"
    click DatabasesModule "https://github.com/paduartesre/project-root/blob/main/databases/main.tf"
    click WordPressModule "https://github.com/paduartesre/project-root/blob/main/wordpress/main.tf"
    click ConfigMap "https://github.com/paduartesre/project-root/blob/main/configmaps/configmap-load-data.yaml"
    click DataCSV "https://github.com/paduartesre/project-root/blob/main/data/dados.csv"
    click Job "https://github.com/paduartesre/project-root/blob/main/jobs/load-data.tf"
    click LoadScript "https://github.com/paduartesre/project-root/blob/main/scripts/load_data.py"
    click Secret "https://github.com/paduartesre/project-root/blob/main/wordpress/k8s-config/secrets.yaml"
    click MySQLDep "https://github.com/paduartesre/project-root/blob/main/wordpress/k8s-config/mysql-deployment.yaml"
    click MySQLSvc "https://github.com/paduartesre/project-root/blob/main/wordpress/k8s-config/mysql-service.yaml"
    click HPA "https://github.com/paduartesre/project-root/blob/main/wordpress/k8s-config/autoscaling.yaml"

    %% Styles
    classDef infra fill:#D0E6FF,stroke:#3166CC,color:#003366
    classDef db fill:#E8F5E9,stroke:#388E3C,color:#1B5E20
    classDef app fill:#FFF3E0,stroke:#FB8C00,color:#E65100
    classDef config fill:#F3E5F5,stroke:#8E24AA,color:#4A148C
    classDef user fill:#ECEFF1,stroke:#90A4AE,color:#455A64
```
