Saltar al contenido principal

wiki-Shortcuts

Ver en Git

Shortcuts

Shortcuts Modal - Documentación Completa

Este componente muestra un modal de atajos (Shortcuts) que permite ejecutar comandos rápidos y acceder a información relevante del usuario y del entorno de la aplicación. Está diseñado con una arquitectura modular y escalable.

Cómo Abrir el Modal​

Atajo de teclado:

  • Windows/Linux: Ctrl + Shift + A
  • Mac: Cmd + Shift + A

Comandos Disponibles​

A continuación se listan los comandos que puedes ejecutar en el campo de búsqueda del modal. Los comandos se escriben en el campo de búsqueda y se ejecutan presionando Enter.

1. FEATURE​

  • Descripción: Busca y muestra aplicaciones del marketplace (Aurapps).
  • Ejemplo:
feature aurapp
  • Alcance: Todos los usuarios

2. ESPACIO​

  • Descripción: Permite seleccionar un espacio (campo/farm) disponible para el usuario.
  • Ejemplo:
espacio auravant
  • Alcance: Todos los usuarios

3. SELECT-FARM​

  • Descripción: Permite seleccionar un campo (farm) disponible para el usuario.
  • Ejemplo:
select-farm
  • Alcance: Todos los usuarios

4. SELECT-FIELD​

  • Descripción: Permite seleccionar un lote (field) específico.
  • Ejemplo:
select-field 23648
  • Alcance: Todos los usuarios

5. SET-THEME​

  • Descripción: Cambia el tema visual de la aplicación (oscuro/claro o personalizado).
  • Ejemplo:
set-theme
  • Alcance: Todos los usuarios

6. SET-LANGUAGE​

  • Descripción: Cambia el idioma de la aplicación.
  • Ejemplo:
set-language
  • Alcance: Todos los usuarios

7. SUDO​

  • Descripción: Comando especial para usuarios con permisos de sudo (administrador). Muestra opciones avanzadas.
  • Ejemplo:
sudo
  • Alcance: Solo usuarios con permisos de sudo

Botones de Información​

Además de los comandos, puedes acceder rápidamente a la siguiente información y acciones mediante los botones del modal. El contenido de estos botones varía según el alcance del usuario:

Botones para Todos los Usuarios:​

  • Datos Usuario: Muestra información detallada del usuario actual (ID, nombre, tipo de usuario, etc.).
  • Theme: Muestra el tema personalizado actual (si existe) y permite cambiarlo.

Botones Exclusivos para Usuarios Sudo:​

  • Permisos: Muestra los permisos actuales del usuario administrador.
  • Token: Muestra el token JWT actual para debugging.
  • Entorno Desarrollo: Muestra información detallada del entorno de desarrollo (variables, configuración, etc.).

Alcance por Usuario​

El modal adapta su contenido según el nivel de acceso del usuario:

Usuarios Regulares:​

  • Acceso a comandos básicos: feature, espacio, select-farm, select-field, set-theme, set-language
  • Botones limitados: Datos Usuario y Theme
  • Funcionalidad enfocada en navegación y personalización básica

Usuarios Sudo (Administradores):​

  • Todos los comandos de usuarios regulares
  • Comando adicional: sudo para opciones avanzadas
  • Botones adicionales: Permisos, Token, Entorno Desarrollo
  • Acceso completo a información de debugging y configuración

Notas Importantes​

  • Comandos en minúsculas: Todos los comandos se ejecutan en minúsculas. Por ejemplo, escribe feature en lugar de FEATURE.
  • Comandos no reconocidos: Si escribes un comando no válido o no tienes permisos suficientes, el modal mostrará un mensaje informativo.
  • Navegación por teclado: Puedes navegar por los resultados usando las flechas del teclado y presionar Enter para ejecutar la acción seleccionada.
  • Búsqueda incremental: El modal soporta búsqueda incremental, mostrando resultados en tiempo real mientras escribes.
  • Comandos personalizados: El sistema está diseñado para ser extensible, permitiendo agregar nuevos comandos fácilmente.
  • Seguridad: Los comandos y botones sensibles solo están disponibles para usuarios con los permisos adecuados.

Arquitectura del Componente​

Shortcuts/
├── components/ # Componentes UI modulares
│ ├── ActionButtons.tsx # Botones de acción
│ ├── DisplayText.tsx # Área de texto con efecto typewriter
│ ├── ShortcutList.tsx # Lista de comandos disponibles
│ └── index.ts # Exportaciones
├── hooks/ # Hooks personalizados
│ ├── useShortcutItems.ts # Gestión de elementos del shortcut
│ └── useTypewriter.ts # Efecto de escritura letra por letra
├── services/ # Lógica de negocio
│ └── commandHandlers.ts # Manejadores de comandos
├── constants.ts # Constantes y configuración
├── types.ts # Interfaces TypeScript
├── index.tsx # Componente principal
├── style.module.css # Estilos CSS
└── README.md # Esta documentación

Uso en Código​

import Shortcuts from './components/Shortcuts'

<Shortcuts
 onCancel={handleCancel}
 isSudo={isSudo}
 token={token}
 // ... otras props necesarias
/>

Versión: 1.0.0 Última actualización: 28 de agosto de 2025