Resumen de Arquitectura

KuaDashboard usa una arquitectura de tres capas: Backend API → Frontend SPA → Shell Electron (opcional).

Diagrama General

┌─────────────────────────────────────────────────────────┐
│                    Electron (opcional)                   │
│  ┌──────────────────────────────────────────────────┐   │
│  │           Servidor Express + WebSocket            │   │
│  │  ┌──────────┐  ┌──────────┐  ┌───────────────┐   │   │
│  │  │ K8s API  │  │ AWS SDK  │  │  GCP SDK      │   │   │
│  │  └──────────┘  └──────────┘  └───────────────┘   │   │
│  │  ┌──────────┐  ┌──────────┐  ┌───────────────┐   │   │
│  │  │ REST API │  │ WS Logs  │  │  WS Exec/Shell│   │   │
│  │  └──────────┘  └──────────┘  └───────────────┘   │   │
│  └──────────────────────────────────────────────────┘   │
│  ┌──────────────────────────────────────────────────┐   │
│  │           Vue 3 + Pinia + Vite (SPA)              │   │
│  │  ┌──────────┐  ┌──────────┐  ┌───────────────┐   │   │
│  │  │  Stores  │  │Components│  │  Composables  │   │   │
│  │  └──────────┘  └──────────┘  └───────────────┘   │   │
│  └──────────────────────────────────────────────────┘   │
└─────────────────────────────────────────────────────────┘

Estructura del Proyecto

kuadashboard/
├── server.js              # Servidor Express + WebSocket
├── package.json           # Paquete raíz (backend + Electron)
├── electron/
│   ├── main.js            # Proceso principal de Electron
│   └── preload.js         # Puente IPC seguro
├── routes/
│   ├── aws.js             # Rutas de servicios AWS
│   ├── gcp.js             # Rutas de servicios GCP
│   ├── envManager.js      # Gestión de credenciales/perfiles
│   ├── localShell.js      # WebSocket de terminal local
│   └── systemTools.js     # Detección de herramientas CLI
├── lib/
│   ├── credentialStore.js  # Almacenamiento de credenciales
│   └── crypto.js          # Utilidades de cifrado
├── frontend/
│   ├── src/
│   │   ├── App.vue         # Componente raíz
│   │   ├── components/     # Componentes UI
│   │   ├── stores/         # Gestión de estado Pinia
│   │   ├── composables/    # Composables Vue (hooks)
│   │   └── config/         # Definiciones de recursos
│   ├── vite.config.js
│   └── package.json
├── public/                 # Frontend compilado (servido por Express)
├── assets/                 # Recursos de electron-builder (iconos)
├── docs/                   # Documentación VitePress
└── scripts/                # Utilidades de build