feat: sprint 80 — Add Cluster dialog: Minikube (Docker), aviso OpenShift e comando kubectl copiável

Programado em par com: Claude IA

Author: joseafilho

…egistry-permission-treeview-view-tags.md …egistry-permission-treeview-view-tags.md.scratch/sprint-69/issues/01-fix-registry-permission-treeview-view-tags.md renamed to .scratch/archive/sprint-69/issues/01-fix-registry-permission-treeview-view-tags.md .scratch/sprint-69/issues/01-fix-registry-permission-treeview-view-tags.md renamed to .scratch/archive/sprint-69/issues/01-fix-registry-permission-treeview-view-tags.md

@@ -0,0 +1,31 @@
+---
+title: Add Cluster dialog — UX improvements (provider list, OpenShift warning, copyable command)
+status: done
+sprint: 80
+---
+
+## Problem
+The Add Cluster dialog has three UX gaps:
+1. `ClusterProvider.Kubernetes` is semantically wrong — the only supported local provider is Minikube (Docker driver). The enum value misleads users into thinking any generic Kubernetes cluster is the target.
+2. Selecting OpenShift gives no feedback that it is not yet supported.
+3. The kubeconfig placeholder mentions `kubectl config view --flatten --minify` but it is not copyable — users have to type it manually.
+
+## Expected
+
+### 1 — ClusterProvider rename
+- Rename enum value `Kubernetes` → `MinikubeDocker`, displayed as `"Minikube (Docker)"` in the Select via `ItemLabelGenerator`.
+- Flyway migration `V{n}__rename_provider_kubernetes_to_minikube_docker.sql`:
+  - Drop CHECK constraint on `clusters.provider`
+  - UPDATE existing rows: `'Kubernetes'` → `'MinikubeDocker'`
+  - Re-add CHECK constraint with new values `('MinikubeDocker', 'OpenShift')`
+- Default value in the dialog Select updated to `ClusterProvider.MinikubeDocker`.
+
+### 2 — OpenShift "coming soon"
+- When the user selects `OpenShift` in the provider Select, show an inline warning message below the field: `"OpenShift support is coming in a future release."`.
+- The Save button is disabled while OpenShift is selected.
+- Selecting any other provider hides the warning and re-enables Save.
+
+### 3 — Copyable kubectl command
+- Below the kubeconfig TextArea, add a styled code block (dark background) displaying `kubectl config view --flatten --minify`.
+- The block has a copy icon button on the right that copies the command to the clipboard via `UI.getCurrent().getPage().executeJs(...)`.
+- The TextArea placeholder is simplified to reference the block below rather than repeating the command inline.

.scratch/sprint-80/issues/01-add-cluster-dialog-ux.md

@@ -82,7 +82,7 @@ A write operation on a CronJob that pauses new Job creation by patching `spec.su
 _Avoid_: Pause, stop, disable
 
 **ClusterProvider**:
-Contextual metadata describing the Kubernetes distribution behind a Cluster (OKD, OpenShift, Kubernetes, Rancher). Does not alter GreenCap's behavior — used for display and identification only.
+Contextual metadata describing the Kubernetes distribution behind a Cluster. Current values: `MinikubeDocker` (displayed as "Minikube (Docker)") and `OpenShift` (planned, not yet supported). Does not alter GreenCap's behavior — used for display and identification only.
 _Avoid_: Type, flavor, vendor
 
 **Kubeconfig**:

CONTEXT.md

@@ -651,3 +651,9 @@
 - `samples/greencap-demo/cluster-provision.sh`: addon `registry` habilitado junto de `metrics-server`/`ingress`; `create-demo.sh` refatorado — addons (antes espalhados entre os dois scripts) agora centralizados em `cluster-provision.sh`, `create-demo.sh` passa a só aplicar os manifests do demo; `README.md` atualizado
 - Validado ponta a ponta no `greencap-demo`: addon `registry` habilitado, imagens de teste (`greencap-demo/hello` com tags `v1`/`v2`/`latest`, `greencap-demo/backend` com tag `v1`) buildadas e enviadas via port-forward + `docker push`; menu "Container Registry" lista os repositories com contagem de tags e "View Tags" exibe nome/digest/size/created corretamente
 - Issues: `.scratch/archive/sprint-68/issues/01-registry-menu-and-repository-listing.md`, `02-repository-tags-view.md`
+
+### Sprint 69 ✅ — Fix: Container Registry — item ausente na treeview de permissões + ação View Tags na grid
+
+- `UserManagementView.buildGlobalGroups()`: novo grupo "Container Registry" (`GLOBAL_REGISTRY_VIEW`) — permission introduzida na sprint 68 que não havia sido exposta na treeview de permissões (GLOBAL), mesmo padrão de grupo único do "Infrastructure"
+- `RegistryView`: ação "View Tags" sai da barra de título (selection action) e passa para uma coluna de ações na própria grid (`UiConstants.addActionsColumn`, botão por linha), mesmo padrão de `JobsView` ("View Pods")
+- Issue: `.scratch/archive/sprint-69/issues/01-fix-registry-permission-treeview-view-tags.md`

docs/sprints-archive.md

@@ -8,7 +8,6 @@
 
 | Sprint | Tema | Status |
 |--------|------|--------|
-| 69 | Fix — Container Registry: item ausente na treeview de permissões + View Tags na grid | ✅ Concluído |
 | 70 | Platform Settings — auto-refresh: nova opção "3 seconds" e novo default | ✅ Concluído |
 | 71 | Infraestrutura de Demo — PVC para persistir o Container Registry interno | ✅ Concluído |
 | 73 | Container Registry — Build & push de imagem via Kaniko a partir de Git Repository público | ✅ Concluído |
@@ -18,6 +17,7 @@
 | 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 |
 
 ---
 
@@ -83,6 +83,15 @@
 
 > Mostra apenas as últimas 10 sprints. Histórico completo em `docs/sprints-archive.md` (ver `docs/agents/sprint-archiving.md`).
 
+### Sprint 80 ✅ — Add Cluster dialog: provider Minikube (Docker), aviso OpenShift e comando kubectl copiável
+
+- `ClusterProvider`: enum renomeado de `Kubernetes` → `MinikubeDocker`; método `displayName()` retorna `"Minikube (Docker)"` / `"OpenShift"`
+- `V27__rename_provider_kubernetes_to_minikube_docker.sql`: DROP/re-ADD CHECK constraint; UPDATE `'Kubernetes'` → `'MinikubeDocker'` em linhas existentes
+- `ClustersView` grid: coluna Provider usa `displayName()` em vez de `.name()`
+- `ClustersView` dialog: Select usa `ItemLabelGenerator` com `displayName()`; default alterado para `MinikubeDocker`; ao selecionar OpenShift, exibe aviso inline `"OpenShift support is coming in a future release."` e desabilita o botão Save; code block escuro com `kubectl config view --flatten --minify` e botão de cópia via `navigator.clipboard.writeText`
+- `CONTEXT.md`: entrada `ClusterProvider` atualizada com os valores reais (`MinikubeDocker`, `OpenShift`)
+- Issue: `.scratch/sprint-80/issues/01-add-cluster-dialog-ux.md`
+
 ### Sprint 79 ✅ — UX: padronização de header em ClustersView e UserManagementView
 
 - `ClustersView`: `buildToolbar()` com `H2` removido; substituído por `UiConstants.buildSectionHeader` com H3 + botão "Add Cluster" (`LUMO_PRIMARY + LUMO_SMALL`) como extra leading button; ações "Test Connection" (`VaadinIcon.CONNECT`) e "Remove" (`VaadinIcon.TRASH`, destrutivo) movidas para `SelectionAction` no header (habilitadas pela seleção de linha); coluna de ações inline removida do grid; `GridSelectionMemory` injetado com `configureSingleSelection`; `refreshGrid()` retorna `boolean` para uso como `BooleanSupplier`; imports `H2` e `HorizontalLayout` removidos
@@ -176,12 +185,6 @@
 - `MainLayout`: default do field `currentRefreshInterval` e fallback em `onAttach()` passam de `NONE` para `THREE_SECONDS` — auto-refresh a 3s ativo desde o login para quem nunca configurou; usuários que já salvaram explicitamente "No auto refresh" (0) ou outro valor continuam inalterados; aplicado uniformemente a todas as views `Refreshable`, sem migration Flyway (mesmo padrão do fallback de tema `"DARK"`)
 - Issue: `.scratch/sprint-70/issues/01-auto-refresh-3-seconds-default.md`
 
-### Sprint 69 ✅ — Fix: Container Registry — item ausente na treeview de permissões + ação View Tags na grid
-
-- `UserManagementView.buildGlobalGroups()`: novo grupo "Container Registry" (`GLOBAL_REGISTRY_VIEW`) — permission introduzida na sprint 68 que não havia sido exposta na treeview de permissões (GLOBAL), mesmo padrão de grupo único do "Infrastructure"
-- `RegistryView`: ação "View Tags" sai da barra de título (selection action) e passa para uma coluna de ações na própria grid (`UiConstants.addActionsColumn`, botão por linha), mesmo padrão de `JobsView` ("View Pods")
-- Issue: `.scratch/sprint-69/issues/01-fix-registry-permission-treeview-view-tags.md`
-
 
 ---
 

docs/sprints.md

@@ -1,5 +1,13 @@
 package io.greencap.k8s.domain.cluster;
 
 public enum ClusterProvider {
-    Kubernetes, OpenShift
+    MinikubeDocker,
+    OpenShift;
+
+    public String displayName() {
+        return switch (this) {
+            case MinikubeDocker -> "Minikube (Docker)";
+            case OpenShift -> "OpenShift";
+        };
+    }
 }

src/main/java/io/greencap/k8s/domain/cluster/ClusterProvider.java

@@ -6,10 +6,13 @@
 import com.vaadin.flow.component.formlayout.FormLayout;
 import com.vaadin.flow.component.grid.Grid;
 import com.vaadin.flow.component.html.Div;
+import com.vaadin.flow.component.html.Paragraph;
 import com.vaadin.flow.component.html.Span;
+import com.vaadin.flow.component.icon.Icon;
 import com.vaadin.flow.component.icon.VaadinIcon;
 import com.vaadin.flow.component.notification.Notification;
 import com.vaadin.flow.component.notification.NotificationVariant;
+import com.vaadin.flow.component.orderedlayout.HorizontalLayout;
 import com.vaadin.flow.component.orderedlayout.VerticalLayout;
 import com.vaadin.flow.component.select.Select;
 import com.vaadin.flow.component.textfield.TextArea;
@@ -102,7 +105,7 @@ public void beforeEnter(BeforeEnterEvent event) {
     private void buildGrid() {
         grid.addComponentColumn(this::buildRadioCell).setHeader("Active").setWidth("90px").setFlexGrow(0).setResizable(true);
         grid.addColumn(Cluster::getName).setHeader("Name").setSortable(true).setFlexGrow(1).setResizable(true);
-        grid.addColumn(c -> c.getProvider().name()).setHeader("Provider").setWidth("120px").setResizable(true);
+        grid.addColumn(c -> c.getProvider().displayName()).setHeader("Provider").setWidth("140px").setResizable(true);
         grid.addComponentColumn(c -> statusBadge(c.getConnectionStatus()))
                 .setHeader("Status").setWidth("140px").setResizable(true);
         grid.setSizeFull();
@@ -212,17 +215,25 @@ private void openAddDialog() {
         Select<ClusterProvider> providerSelect = new Select<>();
         providerSelect.setLabel("Provider");
         providerSelect.setItems(ClusterProvider.values());
-        providerSelect.setValue(ClusterProvider.Kubernetes);
+        providerSelect.setItemLabelGenerator(ClusterProvider::displayName);
+        providerSelect.setValue(ClusterProvider.MinikubeDocker);
         providerSelect.setWidthFull();
 
+        Paragraph openShiftWarning = new Paragraph("OpenShift support is coming in a future release.");
+        openShiftWarning.getStyle()
+                .set("color", "var(--lumo-secondary-text-color)")
+                .set("font-size", "var(--lumo-font-size-s)")
+                .set("margin", "0");
+        openShiftWarning.setVisible(false);
+
         TextArea kubeconfigArea = new TextArea("Kubeconfig YAML");
         kubeconfigArea.setWidthFull();
         kubeconfigArea.setMinHeight("200px");
         kubeconfigArea.setPlaceholder(
                 "Paste the kubeconfig content or upload the file.\n\n" +
-                "⚠️ The kubeconfig must be portable and self-contained: generate it with\n" +
-                "kubectl config view --flatten --minify\n" +
-                "to embed certificates and export only the required context.");
+                "⚠️ The kubeconfig must be portable and self-contained — use the command below to generate it.");
+
+        Div commandBlock = buildCopyableCommand("kubectl config view --flatten --minify");
 
         MemoryBuffer buffer = new MemoryBuffer();
         Upload upload = new Upload(buffer);
@@ -241,15 +252,24 @@ private void openAddDialog() {
             }
         });
 
+        Button saveBtn = new Button("Save");
+        saveBtn.addThemeVariants(ButtonVariant.LUMO_PRIMARY);
+
+        providerSelect.addValueChangeListener(e -> {
+            boolean isOpenShift = e.getValue() == ClusterProvider.OpenShift;
+            openShiftWarning.setVisible(isOpenShift);
+            saveBtn.setEnabled(!isOpenShift);
+        });
+
         FormLayout form = new FormLayout(nameField, providerSelect);
         form.setResponsiveSteps(new FormLayout.ResponsiveStep("0", 1));
 
-        VerticalLayout content = new VerticalLayout(form, upload, kubeconfigArea);
+        VerticalLayout content = new VerticalLayout(form, openShiftWarning, commandBlock, upload, kubeconfigArea);
         content.setPadding(false);
         content.setSpacing(true);
         dialog.add(content);
 
-        Button saveBtn = new Button("Save", e -> {
+        saveBtn.addClickListener(e -> {
             if (nameField.isEmpty()) {
                 nameField.setErrorMessage("Name is required");
                 nameField.setInvalid(true);
@@ -284,7 +304,6 @@ private void openAddDialog() {
                             ? NotificationVariant.LUMO_SUCCESS
                             : NotificationVariant.LUMO_WARNING);
         });
-        saveBtn.addThemeVariants(ButtonVariant.LUMO_PRIMARY);
 
         Button cancelBtn = new Button("Cancel", e -> dialog.close());
 
@@ -293,6 +312,47 @@ private void openAddDialog() {
         nameField.focus();
     }
 
+    private Div buildCopyableCommand(String command) {
+        Span commandText = new Span(command);
+        commandText.getStyle()
+                .set("font-family", "monospace")
+                .set("font-size", "var(--lumo-font-size-s)")
+                .set("color", "#e2e8f0")
+                .set("flex", "1");
+
+        Icon copyIcon = VaadinIcon.COPY_O.create();
+        copyIcon.setSize("20px");
+        copyIcon.getStyle().set("color", "#94a3b8").set("flex-shrink", "0");
+
+        Button copyBtn = new Button(copyIcon);
+        copyBtn.addThemeVariants(ButtonVariant.LUMO_TERTIARY_INLINE, ButtonVariant.LUMO_SMALL);
+        copyBtn.getStyle()
+                .set("color", "#94a3b8")
+                .set("padding", "0")
+                .set("cursor", "pointer");
+        copyBtn.addClickListener(e -> {
+            getUI().ifPresent(ui -> ui.getPage().executeJs(
+                    "navigator.clipboard.writeText($0)", command));
+            notify("Command copied to clipboard", NotificationVariant.LUMO_SUCCESS);
+        });
+
+        HorizontalLayout row = new HorizontalLayout(commandText, copyBtn);
+        row.setAlignItems(com.vaadin.flow.component.orderedlayout.FlexComponent.Alignment.CENTER);
+        row.setWidthFull();
+        row.setPadding(false);
+        row.setSpacing(false);
+        row.getStyle().set("gap", "8px");
+
+        Div block = new Div(row);
+        block.setWidthFull();
+        block.getStyle()
+                .set("background", "#1e293b")
+                .set("border-radius", "6px")
+                .set("padding", "10px 12px")
+                .set("box-sizing", "border-box");
+        return block;
+    }
+
     private java.util.Optional<MainLayout> getMainLayout() {
         return getUI().flatMap(ui -> ui.getChildren()
                 .filter(c -> c instanceof MainLayout)

src/main/java/io/greencap/k8s/ui/ClustersView.java

@@ -0,0 +1,6 @@
+ALTER TABLE clusters DROP CONSTRAINT clusters_provider_check;
+
+UPDATE clusters SET provider = 'MinikubeDocker' WHERE provider = 'Kubernetes';
+
+ALTER TABLE clusters ADD CONSTRAINT clusters_provider_check
+    CHECK (provider IN ('MinikubeDocker', 'OpenShift'));