Glossário
Termos da Prophub Cloud Foundation: tenant, NPN, Sentinel, building block, Workload Identity e mais.
Termos usados na documentação. Itens marcados (destino) não fazem parte do estado atual (V1).
| Termo | Definição |
|---|---|
| tenant | Cliente com stack isolada (fsvc, bsvc, resvc, dados). Ex.: blueberry, euro. |
| fsvc | Frontend do tenant (Nuxt.js, porta 3000). |
| bsvc | Backoffice Directus do tenant (CMS headless, porta 8055). Health check: GET /server/ping. |
| resvc / re2svc | Risk Engine primário e secundário (opcional). |
| OKE | Oracle Kubernetes Engine — Kubernetes gerenciado, control plane sem custo. |
| ENHANCED_CLUSTER | Tier de cluster OKE com recursos avançados; exige conta PAYG. |
| NPN | OCI VCN-Native Pod Networking — pods recebem IPs reais do VCN (sem overlay). |
| Cilium | CNI baseado em eBPF. NetworkPolicy, Hubble, substitui kube-proxy. |
| Hubble | Plano de observabilidade do Cilium. Flows L3/L4/L7 em tempo real. |
| Traefik | Ingress controller cloud-agnostic. Roteamento por hostname por tenant. |
| Karpenter | Provisionador de nós Kubernetes. Cria/remove instâncias OCI sob demanda. |
| NodePool | CRD do Karpenter que define shapes, capacidade e restrições. |
| OciNodeClass | CRD do Karpenter para OCI. Define subnet, compartment, image. |
NodePool data | Pool Karpenter dedicado a bancos: ARM on-demand (primaries) + x86 preemptível (replicas). |
| preemptível | Instância OCI ~50% mais barata, reclamável com ~30s de aviso. |
| ArgoCD | GitOps engine. Mantém o cluster sincronizado com o Git. |
| app-of-apps | Padrão ArgoCD onde um Application raiz gerencia todos os componentes. |
| GitOps | Estado desejado declarado em Git, aplicado automaticamente pelo ArgoCD. |
| drift | Divergência entre o estado desejado (Git) e o estado real (cluster). |
| Crossplane | Control plane de infraestrutura dentro do Kubernetes. Provisiona recursos via CRDs. |
| XRD | CompositeResourceDefinition — define o schema de um CRD customizado. |
| Composition | Abstração Crossplane que encapsula recursos como unidade reutilizável. |
| building block | XRD independente: TenantNamespace, PostgresInstance, RedisCache, RedisPersistent. |
| Workload Identity | Autenticação OCI sem API keys (OCI_RESOURCE_PRINCIPAL_VERSION=2.2). Usada por Crossplane e Karpenter. |
| CloudNativePG | Operator CNCF para PostgreSQL no Kubernetes. |
| OpsTree Redis | Operator OSS para Redis Sentinel/Cluster no Kubernetes. |
| Sentinel | Modo Redis HA: primary + N replicas, failover automático (~30s). Compatível com Redis Streams. |
| AOF | Append-Only File — persistência Redis. Habilitada no resvc (streams do Risk Engine). |
| Redis Streams | Mensageria Redis (XADD/XREADGROUP) usada pelo Risk Engine (risk-processors). |
| Vault | HashiCorp Vault — cofre centralizado de secrets (hoje em modo dev). |
| ESO | External Secrets Operator. Sincroniza Vault → Kubernetes Secrets. |
| cert-manager | Emite certificados TLS automáticos (Let's Encrypt). |
| OCIR | OCI Container Registry — pull nativo do OKE sem pull secret. |
| Terraform bootstrap | Execução única que provisiona a fundação (VCN, OKE, IAM). |
| vCluster (opção futura) | Cluster Kubernetes virtual com apiserver dedicado. Opção futura para isolamento forte por tenant — não usado no modelo atual (namespace por tenant). |
| MCP Server (destino) | Ferramenta que permite a um agente de IA operar o cluster (kubectl, Prometheus, etc.). |
| LGTM (fase posterior) | Loki + Grafana + Tempo + Mimir. Observabilidade adiada e planejada fora do cluster de workloads (RFC-0003). |
| ADR | Architecture Decision Record — decisão técnica com contexto, alternativas e trade-offs. |