Dev Machine (CLI)
La Yastubo Dev Machine es una interfaz de terminal interactiva (TUI) diseñada para centralizar cada aspecto del desarrollo en un panel de control único y visual. Olvida memorizar decenas de comandos; la CLI es el cerebro operativo que orquestra Docker, Pytest, Alembic y el scaffolding del proyecto.
🚀 Inicio Inmediato
Section titled “🚀 Inicio Inmediato”Para lanzar el panel de control, ejecute el siguiente comando desde la raíz del proyecto:
make cli🎨 Tour Visual (Visual Tour)
Section titled “🎨 Tour Visual (Visual Tour)”La consola se organiza mediante un sistema de pestañas diseñado para agilizar el flujo de trabajo diario de un arquitecto de backend.
1. 🏠 Inicio (Dashboard)
Section titled “1. 🏠 Inicio (Dashboard)”Es la cabina de mando. Al iniciar, el CLI realiza un diagnóstico automático de la salud de tu entorno local:
- Health Check: Estado real de las conexiones a PostgreSQL y Redis.
- Configuración: Alertas visuales si faltan variables críticas en tu
.env. - Software Stack: Verificación de versiones de Python (
3.12+) y uv.
2. 📂 Gestión de Módulos (Architecture)
Section titled “2. 📂 Gestión de Módulos (Architecture)”En esta pestaña puedes inspeccionar la arquitectura del Monolito Modular. No es solo visual: facilita la creación de nuevos dominios (ej. marketing, partnerships) asegurando que se sigan los estándares de estructura models -> schemas -> services -> routers.
3. 🧪 Laboratorio de Tests (Lab)
Section titled “3. 🧪 Laboratorio de Tests (Lab)”Un selector dinámico para ejecutar la suite completa de pruebas o suites individuales. Se integra con Pytest para mostrar errores estilizados y logs de depuración directamente en la TUI.
⌨️ Atajos de Control Maestro
Section titled “⌨️ Atajos de Control Maestro”La Dev Machine está optimizada para que nunca tengas que soltar el teclado.
| Tecla | Acción |
|---|---|
| 1 - 5 | Navegación instantánea entre pestañas |
| D | Cambiar entre tema Dark y Light |
| Q | Salir de la CLI |
🏗️ Filosofía de Automatización
Section titled “🏗️ Filosofía de Automatización”En Yastubo, creemos que el tiempo del desarrollador es sagrado. La CLI abstrae tareas complejas como:
- Scaffolding Atómico: Creación de carpetas de módulos y archivos base en un clic.
- Mantenimiento: Sincronización de dependencias (
uv sync) y limpieza de caché. - Calidad: Ejecución del Quality Gate (
make build) antes de enviar cambios al repositorio.