Skip to content

ServerKit is a lightweight, modern server control panel for managing web applications, databases, and services on your VPS or dedicated server. Built with Python/Flask backend and React frontend.

docs(18): Complete Node Configuration Panels phase

Juan Denisc3b729203771
diff --git a/.planning/ROADMAP.md b/.planning/ROADMAP.md
index 11820bad..f58e8ee6 100644
--- a/.planning/ROADMAP.md
+++ b/.planning/ROADMAP.md
@@ -29,7 +29,7 @@ Completed 2026-01-19 | 5 phases | Multi-environment app linking, shared DB suppo
|-------|------|--------|------|
| 16 | Workflow Canvas Foundation | **completed** | React Flow canvas with pan/zoom, node rendering, connection system |
| 17 | Resource Node Types | **completed** | Create node types for Docker apps, databases, domains |
-| 18 | Node Configuration Panels | pending | Side panels for configuring each node type |
+| 18 | Node Configuration Panels | **completed** | Side panels for configuring each node type |
| 19 | Connection Logic | pending | Define and validate connections between nodes |
| 20 | Workflow Save/Load | pending | Save workflows to backend, load existing infrastructure |
| 21 | Deploy from Workflow | pending | Execute workflow to create/update actual resources |
@@ -82,22 +82,26 @@ Completed 2026-01-19 | 5 phases | Multi-environment app linking, shared DB suppo
---
-## Phase 18: Node Configuration Panels
+## Phase 18: Node Configuration Panels ✓
**Goal**: Create side panels for configuring each node type
-### Tasks
-1. Create sliding panel component
-2. Adapt existing Docker app form to panel
-3. Adapt existing database form to panel
-4. Adapt existing domain form to panel
-5. Wire panel open/close to node selection
-6. Handle form validation in panels
+**Status**: Completed 2026-01-19
+
+### What Was Built
+- ConfigPanel base component with slide animation
+- DockerAppConfigPanel with ports list and memory input
+- DatabaseConfigPanel with type-aware default ports
+- DomainConfigPanel with SSL/DNS status fields
+- ServiceConfigPanel with service type selector
+- Panel wiring in WorkflowBuilder with real-time updates
### Success Criteria
-- [ ] Clicking node opens config panel
-- [ ] Panel contains appropriate form for node type
-- [ ] Form changes reflect in node display
-- [ ] Panel can be closed/dismissed
+- [x] Clicking node opens config panel
+- [x] Panel contains appropriate form for node type
+- [x] Form changes reflect in node display
+- [x] Panel can be closed/dismissed
+
+[Full Summary](./phases/18-node-configuration-panels/SUMMARY.md)
---
diff --git a/.planning/STATE.md b/.planning/STATE.md
index 36096db0..fbec8a76 100644
--- a/.planning/STATE.md
+++ b/.planning/STATE.md
@@ -2,8 +2,8 @@
## Current Status
- **Milestone**: 3 - Visual Workflow Builder
-- **Current Phase**: 18 - Node Configuration Panels
-- **Phase Status**: Planned
+- **Current Phase**: 19 - Connection Logic
+- **Phase Status**: Pending
- **Last Updated**: 2026-01-19
## Phase Progress
@@ -12,11 +12,21 @@
|-------|--------|---------|-----------|
| 16 | completed | 2026-01-19 | 2026-01-19 |
| 17 | completed | 2026-01-19 | 2026-01-19 |
-| 18 | pending | - | - |
+| 18 | completed | 2026-01-19 | 2026-01-19 |
| 19 | pending | - | - |
| 20 | pending | - | - |
| 21 | pending | - | - |
+## Phase 18 Summary
+Node Configuration Panels completed:
+- Created ConfigPanel base component with slide animation
+- Created DockerAppConfigPanel with ports list
+- Created DatabaseConfigPanel with type-aware defaults
+- Created DomainConfigPanel with SSL/DNS fields
+- Created ServiceConfigPanel with service type selector
+- Wired panels to node selection in WorkflowBuilder
+- Added comprehensive panel styles
+
## Phase 17 Summary
Resource Node Types completed:
- Created DockerAppNode with status, ports, memory display
diff --git a/.planning/phases/18-node-configuration-panels/SUMMARY.md b/.planning/phases/18-node-configuration-panels/SUMMARY.md
new file mode 100644
index 00000000..cb2b494e
--- /dev/null
+++ b/.planning/phases/18-node-configuration-panels/SUMMARY.md
@@ -0,0 +1,129 @@
+# Phase 18: Node Configuration Panels - Summary
+
+## Overview
+Created sliding side panels for configuring each node type when selected on the workflow canvas. Changes in panels update node display in real-time.
+
+## Completed: 2026-01-19
+
+## What Was Built
+
+### 1. ConfigPanel Base Component
+**File**: `frontend/src/components/workflow/ConfigPanel.jsx`
+
+Reusable sliding panel component with:
+- Slide-in from right animation (CSS transitions)
+- Header with icon, title, close button
+- Scrollable body for form content
+- Optional footer slot
+- Escape key handler to close
+- Props: isOpen, title, icon, headerColor, onClose, children, footer
+
+### 2. DockerAppConfigPanel
+**File**: `frontend/src/components/workflow/panels/DockerAppConfigPanel.jsx`
+
+Configuration form for Docker apps:
+- Name input
+- Image input with placeholder
+- Status selector (running/stopped/error)
+- Dynamic port mappings list (add/remove)
+- Memory limit input
+
+### 3. DatabaseConfigPanel
+**File**: `frontend/src/components/workflow/panels/DatabaseConfigPanel.jsx`
+
+Configuration form for databases:
+- Name input
+- Type selector (MySQL, PostgreSQL, MongoDB, Redis)
+- Auto-update port when type changes
+- Host and port inputs (row layout)
+- Status selector
+- Read-only size display
+
+### 4. DomainConfigPanel
+**File**: `frontend/src/components/workflow/panels/DomainConfigPanel.jsx`
+
+Configuration form for domains:
+- Domain name input with hint
+- SSL status selector (none/valid/expired)
+- Conditional SSL expiry date picker
+- DNS status selector (pending/propagated)
+
+### 5. ServiceConfigPanel
+**File**: `frontend/src/components/workflow/panels/ServiceConfigPanel.jsx`
+
+Configuration form for services:
+- Name input
+- Service type selector (Redis, Memcached, RabbitMQ, Queue)
+- Auto-update port when type changes
+- Port input
+- Description textarea
+- Status selector
+
+### 6. WorkflowBuilder Integration
+**File**: `frontend/src/pages/WorkflowBuilder.jsx`
+
+Wired panels to canvas:
+- Track selectedNode state
+- onNodeClick handler opens appropriate panel
+- onPaneClick handler closes panel
+- handleNodeDataChange updates node data in real-time
+- renderConfigPanel switches panel by node type
+
+### 7. Panel Styles
+**File**: `frontend/src/styles/pages/_workflow.less`
+
+Added ~200 lines of styles:
+- Fixed panel on right side (320px width)
+- Slide-in animation with transform/opacity
+- Panel header with type-specific border color
+- Form styling within panels
+- Port list with add/remove buttons
+- btn-icon and btn-danger-ghost utilities
+
+## Commits
+
+| Hash | Message |
+|------|---------|
+| `da6ae4d` | feat(18-1): Create ConfigPanel base component |
+| `4eebd34` | feat(18-2): Create DockerAppConfigPanel |
+| `1a61942` | feat(18-3): Create DatabaseConfigPanel |
+| `b803a3e` | feat(18-4): Create DomainConfigPanel |
+| `37ee145` | feat(18-5): Create ServiceConfigPanel |
+| `8b39d87` | feat(18-6): Wire panel to node selection in WorkflowBuilder |
+| `69b2339` | feat(18-7): Add configuration panel styles |
+
+## Files Changed
+
+| File | Type | Lines |
+|------|------|-------|
+| `frontend/src/components/workflow/ConfigPanel.jsx` | New | ~53 |
+| `frontend/src/components/workflow/panels/DockerAppConfigPanel.jsx` | New | ~120 |
+| `frontend/src/components/workflow/panels/DatabaseConfigPanel.jsx` | New | ~108 |
+| `frontend/src/components/workflow/panels/DomainConfigPanel.jsx` | New | ~77 |
+| `frontend/src/components/workflow/panels/ServiceConfigPanel.jsx` | New | ~93 |
+| `frontend/src/pages/WorkflowBuilder.jsx` | Modified | +59 |
+| `frontend/src/styles/pages/_workflow.less` | Modified | +204 |
+
+## Success Criteria
+
+- [x] Clicking node opens config panel
+- [x] Panel contains appropriate form for node type
+- [x] Form changes reflect in node display immediately
+- [x] Panel can be closed/dismissed
+- [x] Build passes without errors
+
+## Technical Notes
+
+- ConfigPanel uses CSS class `.open` for animation state
+- All panels receive `{ node, onChange, onClose }` props
+- onChange calls setNodes with functional update to modify node data
+- Panel appears inside workflow-canvas div (positioned absolute)
+- Escape key closes panel via useEffect keyboard listener
+
+## Bug Fix
+
+- Fixed `@shadow-2xl` → `@shadow-lg` (undefined variable)
+
+## Next Phase
+
+Phase 19 will implement connection logic to validate and manage connections between nodes.