> For the complete documentation index, see [llms.txt](https://dise0.gitbook.io/h4cker_b00k/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://dise0.gitbook.io/h4cker_b00k/proyectos/command-vault-beta.md).
# Command Vault (BETA)
Documentación Técnica – BETA
Repositorio de `GitHub` donde esta subido el proyecto: [GitHub Command\_Vault](https://github.com/D1se0/Command_Vault)
***
### 1. Visión General
**Command Vault** es una aplicación web local diseñada para almacenar, organizar y reutilizar comandos utilizados habitualmente en:
* Hacking ético
* Pruebas de penetración
* Operaciones Red Team y Blue Team
* Administración de sistemas
* Flujos de trabajo DevOps
El objetivo del proyecto es crear una **base de datos de comandos rápida y offline**, optimizada para el uso diario de usuarios técnicos que reutilizan comandos constantemente en distintos entornos y tecnologías.
Este proyecto se encuentra actualmente en **BETA** y en desarrollo activo.
#### Capturas del proyecto
***
### 2. Filosofía y Motivación
Durante pentests reales, CTFs, auditorías o tareas de administración, los ingenieros reutilizan comandos de forma constante:
* Snippets de enumeración
* Ayudas para explotación
* One-liners
* Plantillas de payloads
* Helpers de automatización
Normalmente estos comandos terminan:
* Dispersos en notas
* Perdidos en historiales de chat
* Duplicados en múltiples herramientas
**Command Vault** nace para solucionar esto ofreciendo:
* Una base de datos estructurada de comandos
* Organización clara por workspaces y secciones
* Acceso rápido sin servicios externos
* Ejecución completamente local
El proyecto está construido **por y para hackers**, con la productividad y la simplicidad como principios fundamentales.
***
### 3. Características Principales
* Interfaz web local
* Organización por workspaces
* Agrupación de comandos por secciones
* Bloques de código con resaltado de sintaxis
* Resaltado de sintaxis en tiempo real al editar
* Soporte multi-lenguaje (bash, PowerShell, Python, etc.)
* Arquitectura offline-first
* Sin dependencias cloud
* Despliegue portable y sencillo
***
### 4. Visión General de la Arquitectura
El proyecto sigue una **arquitectura local cliente-servidor**:
```
┌──────────────┐
│ Navegador │
│ (Frontend) │
└──────┬───────┘
│ HTTP (localhost)
┌──────▼───────┐
│ Backend │
│ Node + API │
└──────┬───────┘
│
┌──────▼───────┐
│ BD Local │
│ SQLite / FS │
└──────────────┘
```
Todo se ejecuta **de forma local** en la máquina del usuario.
***
### 5. Stack Tecnológico
#### Frontend
* **React**
* **TypeScript**
* **Vite**
* **Framer Motion**
* **React Syntax Highlighter**
* **Sistema UI personalizado**
Responsabilidades:
* Renderizado de la interfaz
* Edición de comandos
* Resaltado de sintaxis
* Interacción con el usuario
***
#### Backend
* **Node.js**
* **TypeScript**
* **API REST**
* **Base de datos local**
Responsabilidades:
* Persistencia de datos
* CRUD de Workspaces / Secciones / Comandos
* Exposición de la API
***
#### Principios de Desarrollo
* Tipado fuerte (TypeScript en todo el proyecto)
* Dependencias mínimas
* Lógica explícita
* Sin abstracciones mágicas
* Código hackeable y extensible
***
### 6. Modelo de Datos
#### Workspace
Representa un agrupador lógico (proyecto, cliente, laboratorio, categoría).
```ts
Workspace {
id: string
name: string
}
```
***
#### Section
Se utiliza para agrupar comandos dentro de un workspace.
```ts
Section {
id: string
workspace_id: string
title: string
icon: string // clave del icono, no el glyph
position: number
}
```
Los iconos se almacenan como **claves**, no como SVG ni Unicode, permitiendo flexibilidad en la UI.
***
#### Command
Representa un comando o snippet reutilizable.
```ts
Command {
id: string
section_id: string
title: string
description: string
language: string
command: string
position: number
updated_at: string
}
```
***
### 7. Sistema de Iconos
Los iconos se gestionan mediante un **sistema basado en claves**:
* La capa de datos almacena claves de iconos:
```ts
"terminal" | "folder" | "sections" | ...
```
* La capa UI resuelve los iconos dinámicamente:
```tsx
{Icons[s.icon as keyof typeof Icons]}
```
Esto evita acoplar los datos a recursos visuales y facilita cambios futuros.
***
### 8. Resaltado de Sintaxis
#### Modo Lectura
Los comandos se renderizan usando **resaltado de sintaxis basado en Prism** con un tema personalizado:
* Fondo transparente
* Contraste afinado
* Optimizado para interfaces oscuras
***
#### Modo Edición (Resaltado en Vivo)
Al editar un comando:
* Un `