feat: sprint 87 — Setup wizard: script de instalação da plataforma GreenCap no minikube

Programado em par com: Claude IA

Author: joseafilho

…h/sprint-76/issues/01-namespaces-view.md …e/sprint-76/issues/01-namespaces-view.md.scratch/sprint-76/issues/01-namespaces-view.md renamed to .scratch/archive/sprint-76/issues/01-namespaces-view.md .scratch/sprint-76/issues/01-namespaces-view.md renamed to .scratch/archive/sprint-76/issues/01-namespaces-view.md

@@ -0,0 +1,36 @@
+---
+id: "87-01"
+title: "Setup wizard: script principal e teardown"
+status: done
+priority: high
+sprint: 87
+---
+
+O GreenCap precisa de um ponto de entrada único para usuários que querem rodar a plataforma localmente via minikube. Atualmente não existe nenhum mecanismo de instalação além do docker-compose (que não usa Kubernetes).
+
+O `setup/setup.sh` deve ser autoexplicativo, declarativo por etapas e re-executável sem efeitos colaterais em caso de re-run. O `setup/teardown.sh` permite ao usuário desfazer tudo com um único comando.
+
+**Escopo do `setup.sh`:**
+
+Etapa 1 — verifica se `docker`, `minikube` e `kubectl` estão instalados no PATH; em caso de ausência, exibe link de instalação e encerra.
+
+Etapa 2 — exibe menu de perfil de instalação e aguarda escolha do usuário:
+- Minimal: 1 nó, 2 CPUs, 4 GB
+- Recommended: 3 nós, 2 CPUs, 3 GB/nó
+- Custom: usuário informa nós, CPUs e memória via `read`
+
+Etapa 3 — inicia minikube com profile `greencap-platform` e o perfil escolhido (driver `docker`); idempotente — pula se o profile já existe.
+
+Etapa 4 — habilita addons `metrics-server`, `ingress` e `registry`; aguarda o ingress-nginx controller ficar pronto; aplica PVC de 8 Gi para persistência do registry e faz patch no Deployment do registry (mesmo padrão do `cluster-provision.sh` do greencap-demo, com nodeSelector e volumeMount).
+
+Etapa 5 — faz `docker build` do `docker/Dockerfile` e push para `localhost:5000/greencap-platform/platform:latest` via registry-proxy do minikube; idempotente — pula o push se a tag já existir no registry.
+
+Etapa 6 — gera `GREENCAP_ENCRYPTION_KEY` e senha do Postgres via `openssl rand -hex 16` caso não estejam definidas como variáveis de ambiente; aplica o Secret `greencap-secrets` no namespace `greencap-platform`.
+
+Etapa 7 — aplica os manifests em `setup/manifests/` (namespace, Postgres, GreenCap); aguarda rollout de todos os Deployments.
+
+Etapa 8 — exibe resumo: URL (`http://greencap.local`), credenciais padrão (`admin`/`admin`), comando sudo para `/etc/hosts` e a `ENCRYPTION_KEY` gerada (com aviso de guarda).
+
+**Escopo do `teardown.sh`:**
+
+Exibe aviso de destruição e aguarda confirmação (`y/N`); deleta o minikube profile `greencap-platform` completamente.

…nt-77/issues/01-ingress-topology-node.md …nt-77/issues/01-ingress-topology-node.md.scratch/sprint-77/issues/01-ingress-topology-node.md renamed to .scratch/archive/sprint-77/issues/01-ingress-topology-node.md .scratch/sprint-77/issues/01-ingress-topology-node.md renamed to .scratch/archive/sprint-77/issues/01-ingress-topology-node.md

@@ -0,0 +1,27 @@
+---
+id: "87-02"
+title: "Manifests Kubernetes: Postgres e GreenCap no namespace greencap-platform"
+status: done
+priority: high
+sprint: 87
+---
+
+O `setup.sh` aplica os manifests em `setup/manifests/` na ordem numérica. Cada manifest é responsável por um recurso específico da plataforma.
+
+**Manifests necessários:**
+
+`00-namespace.yaml` — namespace `greencap-platform`.
+
+`01-secrets.yaml` — Secret `greencap-secrets` com `DB_PASSWORD` e `GREENCAP_ENCRYPTION_KEY`; os valores são placeholders substituídos pelo `setup.sh` via `envsubst` ou `kubectl create secret` imperativo antes do apply dos demais manifests.
+
+`02-postgres-pvc.yaml` — PersistentVolumeClaim `postgres-data`, 2 Gi, ReadWriteOnce, StorageClass `standard`.
+
+`03-postgres-deployment.yaml` — Deployment `postgres` com `postgres:16-alpine`; variáveis `POSTGRES_DB=greencap`, `POSTGRES_USER=greencap`, `POSTGRES_PASSWORD` lidas do Secret; volume montado em `/var/lib/postgresql/data`; readinessProbe via `pg_isready`.
+
+`04-postgres-service.yaml` — Service ClusterIP `greencap-db` na porta 5432; sem exposição externa.
+
+`05-greencap-deployment.yaml` — Deployment `greencap` com a imagem `localhost:5000/greencap-platform/platform:latest` (imagePullPolicy `Always`); variáveis de ambiente: `SPRING_PROFILES_ACTIVE=prod`, `SPRING_DATASOURCE_URL=jdbc:postgresql://greencap-db:5432/greencap`, `SPRING_DATASOURCE_USERNAME=greencap`, `SPRING_DATASOURCE_PASSWORD` e `GREENCAP_ENCRYPTION_KEY` lidas do Secret; readinessProbe via `/actuator/health`; 1 réplica.
+
+`06-greencap-service.yaml` — Service ClusterIP `greencap` na porta 8080.
+
+`07-greencap-ingress.yaml` — Ingress com host `greencap.local` apontando para o Service `greencap` na porta 8080; sem TLS; sem IngressClass explícita (usa o default do addon `ingress` do minikube).

…int-77/issues/02-goto-resource-button.md …int-77/issues/02-goto-resource-button.md.scratch/sprint-77/issues/02-goto-resource-button.md renamed to .scratch/archive/sprint-77/issues/02-goto-resource-button.md .scratch/sprint-77/issues/02-goto-resource-button.md renamed to .scratch/archive/sprint-77/issues/02-goto-resource-button.md

@@ -705,3 +705,19 @@
 - `DeployApplicationView` (nova, rota `/deploy`): wizard 6 passos (Name, Image & Port, Resources, Volume, External Access, Review); sugestões de StorageClass e IngressClass carregadas do cluster; sugestão de host `<namespace>.greencap.local`; execução assíncrona em thread virtual; em sucesso navega para Topologia
 - `Permission.PROJECT_DEPLOY_APPLICATION` (novo): `V25__add_deploy_application_permission.sql`
 - Issues: `.scratch/archive/sprint-75/issues/`
+
+
+### Sprint 76 ✅ — Namespaces View: listagem com contagens de recursos, Create e Delete Namespace
+
+- `NamespaceService`: `listNamespacesWithCounts()`, `createNamespace()`, `deleteNamespace()`; filtra namespaces em fase `Terminating` no combobox da navbar
+- `NamespacesView` (nova, rota `global/namespaces`): grid Name/Status/Pods/Deployments/Services/Age; Create com validação DNS; Delete type-to-confirm; system namespaces bloqueados; chama `MainLayout.refreshClusterState()` após operações
+- `Permission.GLOBAL_NAMESPACES_VIEW/WRITE/DELETE`; `V26__add_namespace_permissions.sql`
+- Issue: `.scratch/archive/sprint-76/issues/`
+
+### Sprint 77 ✅ — Topologia: nó Ingress + botão "Go to resource" + pré-filtro ?name= nas views
+
+- `TopologyService`: listagem de Ingresses via Fabric8; `ingressNode()` com ingressClass/hosts/TLS; `extractBackendServiceNames()`; `resourceViewUrl()` mapeia cada tipo para rota da view com `?name=`
+- `topology-graph.ts`: cor Ingress `#06B6D4`; cor de arestas `#64748B`; fcose separado da inicialização; `fixedNodeConstraint` desabilitado quando compound nodes presentes
+- `TopologyNodeDrawer`: bloco `isIngress` com Hosts, badge TLS, IngressClass; botão "Go to resource" substitui "Ver YAML"
+- `DeploymentsView`, `ReplicaSetView`, `ServicesView`, `PersistentVolumeClaimsView`, `IngressView`: `nameFilter` instância; `beforeEnter` lê `?name=`
+- Issues: `.scratch/archive/sprint-77/issues/`

…/issues/03-prefilter-name-query-param.md …/issues/03-prefilter-name-query-param.md.scratch/sprint-77/issues/03-prefilter-name-query-param.md renamed to .scratch/archive/sprint-77/issues/03-prefilter-name-query-param.md .scratch/sprint-77/issues/03-prefilter-name-query-param.md renamed to .scratch/archive/sprint-77/issues/03-prefilter-name-query-param.md

@@ -8,7 +8,6 @@
 
 | Sprint | Tema | Status |
 |--------|------|--------|
-| 77 | Topologia: nó Ingress + botão "Go to resource" + pré-filtro ?name= nas views | ✅ Concluído |
 | 78 | Topologia: correções de layout (randomize), tap em group nodes e botão Reset Positions | ✅ Concluído |
 | 79 | UX — Padronização de header: ClustersView e UserManagementView com buildSectionHeader | ✅ Concluído |
 | 80 | Add Cluster dialog — provider Minikube (Docker), aviso OpenShift e comando kubectl copiável | ✅ Concluído |
@@ -18,6 +17,7 @@
 | 84 | Bug fixes: Registry remove persistente (rm -rf do diretório após GC), Namespace Terminating bloqueado, seleção de linha ao clicar em View Tags | ✅ Concluído |
 | 85 | Deploy from Dockerfile — terceiro modo de deploy: wizard 6 passos, build Kaniko inline + provisão de recursos Kubernetes | ✅ Concluído |
 | 86 | EventsView — seletor de limite de Events exibidos (50/100/200/500/All, padrão 100) no section header | ✅ Concluído |
+| 87 | Setup wizard: script de instalação da plataforma GreenCap no minikube | ✅ Concluído |
 
 ---
 
@@ -87,6 +87,16 @@
 
 > Mostra apenas as últimas 10 sprints. Histórico completo em `docs/sprints-archive.md` (ver `docs/agents/sprint-archiving.md`).
 
+### Sprint 87 ✅ — Setup wizard: script de instalação da plataforma GreenCap no minikube
+
+- `setup/setup.sh`: script idempotente em 7 etapas — verifica/instala ferramentas ausentes (docker, kubectl, minikube) com `sg docker` para ativar grupo sem logout; menu de perfil (Minimal/Recommended/Custom); inicia minikube com driver docker; habilita addons metrics-server, ingress e registry (PVC 8 Gi + nodeSelector para persistência); build + push da imagem via registry-proxy; cria Secret `greencap-secrets` com `DB_PASSWORD`, `GREENCAP_ENCRYPTION_KEY` e `GREENCAP_SELF_CLUSTER_KUBECONFIG`; aplica manifests e aguarda rollout; adiciona entrada `greencap.local` no `/etc/hosts` automaticamente se ausente
+- `setup/teardown.sh`: exige confirmação `yes` antes de deletar o profile minikube `greencap-platform`
+- `setup/manifests/`: 7 manifests Kubernetes — namespace, PVC Postgres (2 Gi), Deployment Postgres 16, Service ClusterIP `greencap-db`, Deployment GreenCap (imagePullPolicy Always), Service ClusterIP `greencap`, Ingress `greencap.local`
+- `DataInitializer`: auto-registra o cluster `greencap-platform` na primeira inicialização quando `GREENCAP_SELF_CLUSTER_KUBECONFIG` está definido; define como cluster e namespace ativos do admin
+- `ClusterRepository`: método `existsByName(String)` para idempotência do auto-registro
+- `MainLayout`: namespace combobox alargado de 180 px para 220 px; fix de seleção do namespace inicial via dois ciclos de push separados (itens primeiro, valor depois)
+- Issues: `.scratch/sprint-87/issues/` (2 issues, ambas `done`)
+
 ### Sprint 86 ✅ — EventsView: seletor de limite de Events exibidos
 
 - `ObservabilityService.listEvents()`: novo parâmetro `int limit` (0 = All); stream truncado após ordenação por `lastTimestamp` desc — garante sempre os N mais recentes
@@ -174,20 +184,6 @@
 - `CONTEXT.md`: entradas `Namespace`, `Create Namespace`, `Delete Namespace` detalhadas; `Global` atualizado para incluir Namespaces
 - Issue: `.scratch/sprint-76/issues/01-namespaces-view.md`
 
-### Sprint 75 ✅ — Deploy Application: wizard multi-step para criar Namespace + Deployment + Service + PVC + Ingress
-
-- `DeployApplicationService` (novo): cria Namespace → Deployment → Service → PVC → Ingress em sequência best-effort; falha parcial retorna `DeployApplicationResult` com recurso falho sem rollback (ver ADR 0009)
-- `DeployApplicationRequest` / `DeployApplicationResult` (novos DTOs em `kubernetes/dto/`)
-- `Permission.PROJECT_DEPLOY_APPLICATION` (novo, ADMIN/OPERATOR); `V25__add_deploy_application_permission.sql` concede a usuários com `GLOBAL_CLUSTERS_WRITE`
-- `NetworkingService.listIngressClassNames`: lista IngressClasses disponíveis no cluster via Fabric8
-- `DeployApplicationView`: wizard 6 passos (Name → Image & Port → Resources → Volume → External Access → Review); sugestões do Registry interno no `ComboBox` de imagem; StorageClass pré-selecionada com a default do cluster; host sugerido `<namespace>.greencap.local`; após sucesso navega para `TopologiaView` do novo Namespace
-- `DashboardView`: CTA "New Application" quando namespace não tem Deployments (visível apenas com permissão `PROJECT_DEPLOY_APPLICATION`)
-- `MainLayout`: item **"New Application"** com ícone `PLUS_CIRCLE` adicionado acima da seção PROJECT (renomeado de "Deploy Application", extraído para `SideNav` próprio, ícone diferenciado do Workloads/Deployments)
-- Fix: `PodLogsView` — polling para automaticamente ao receber `KubernetesOperationException` (ex: `ImagePullBackOff`, container em espera); exibe `[Polling stopped] <mensagem>` no corpo dos logs em vez de toast infinito a cada intervalo
-- Fix: `DeployApplicationView.REGISTRY_INTERNAL_HOST` corrigido de `registry.kube-system.svc.cluster.local:80` para `localhost:5000` — DNS de cluster não é resolvível no nível do kubelet/Docker daemon do nó; `registry-proxy` (DaemonSet) expõe o registry em `localhost:5000` via `hostPort` em cada nó
-- `docs/adr/0009-deploy-application-sem-rastreamento.md` (novo)
-- Issues: `.scratch/sprint-75/issues/01-deploy-application-backend.md`, `02-deploy-application-wizard-ui.md`
-
 ---
 
 ## Legenda

.scratch/sprint-87/issues/01-setup-wizard-script.md

@@ -324,6 +324,12 @@ if [ "$GENERATED_KEY" = true ]; then
   echo ""
 fi
 
-echo "    Add to /etc/hosts (run once with sudo):"
-echo "    echo \"$MINIKUBE_IP  greencap.local\" | sudo tee -a /etc/hosts"
+HOSTS_ENTRY="$MINIKUBE_IP  greencap.local  # GreenCap K8s — managed by setup.sh"
+if grep -q "greencap.local" /etc/hosts 2>/dev/null; then
+  ok "/etc/hosts already contains greencap.local — skipping"
+else
+  echo "    Adding greencap.local to /etc/hosts..."
+  echo "$HOSTS_ENTRY" | $SUDO tee -a /etc/hosts > /dev/null
+  ok "greencap.local → $MINIKUBE_IP added to /etc/hosts"
+fi
 echo ""

.scratch/sprint-87/issues/02-kubernetes-manifests-plataforma.md

@@ -1,5 +1,9 @@
 package io.greencap.k8s.config;
 
+import io.greencap.k8s.domain.cluster.ClusterProvider;
+import io.greencap.k8s.domain.cluster.ClusterRepository;
+import io.greencap.k8s.domain.cluster.ClusterService;
+import io.greencap.k8s.domain.cluster.CreateClusterRequest;
 import io.greencap.k8s.domain.user.Permission;
 import io.greencap.k8s.domain.user.UserRepository;
 import io.greencap.k8s.domain.user.UserService;
@@ -14,14 +18,31 @@
 @RequiredArgsConstructor
 public class DataInitializer implements ApplicationRunner {
 
+    private static final String SELF_CLUSTER_NAME = "greencap-platform";
+    private static final String SELF_CLUSTER_KUBECONFIG_ENV = "GREENCAP_SELF_CLUSTER_KUBECONFIG";
+
     private final UserRepository userRepository;
     private final UserService userService;
+    private final ClusterRepository clusterRepository;
+    private final ClusterService clusterService;
 
     @Override
     public void run(ApplicationArguments args) {
         if (!userRepository.existsByUsername("admin")) {
             userService.createUser("admin", "admin@greencap.local", "admin", Permission.allPermissions());
             log.info("Admin user created — login: admin / admin");
         }
+
+        String kubeconfig = System.getenv(SELF_CLUSTER_KUBECONFIG_ENV);
+        if (kubeconfig != null && !kubeconfig.isBlank() && !clusterRepository.existsByName(SELF_CLUSTER_NAME)) {
+            var cluster = clusterService.createCluster(new CreateClusterRequest(
+                    SELF_CLUSTER_NAME,
+                    ClusterProvider.MinikubeDocker,
+                    kubeconfig
+            ));
+            userService.updateActiveCluster("admin", cluster);
+            userService.updateActiveNamespace("admin", SELF_CLUSTER_NAME);
+            log.info("Cluster '{}' auto-registered, set as active cluster and namespace for admin", SELF_CLUSTER_NAME);
+        }
     }
 }