vtasks-automate-cli

Automatizá el flujo de trabajo de tus tareas en vTasks con un solo comando.

🚀 ¿Qué hace este CLI?

vtasks-automate-cli es una herramienta diseñada para integrarse fácilmente en tu proyecto con frontend (Next.js o create-react-app) y backend (Node.js), y así automatizar el movimiento de tarjetas en vTasks mientras trabajás con ramas vinculadas a tareas.

Con solo ejecutar el comando en la raíz del proyecto:

npx vtasks-automate-cli

La herramienta hará lo siguiente:

1. 📦 Instalará automáticamente la dependencia de automatización en el frontend y el backend del proyecto.
2. 🔧 Modificarán los scripts de ejecución:
   • En el backend: actualiza npm start
   • En el frontend (Next.js): actualiza npm run dev (o si el proyecto aun utiliza create-react-app actaualiza npm start)
3. 🛠️ Agrega un githook para detectar los cambios de ramas y notificar que cambiaste la tarea en la que estas trabajando
4. ⚙️ Al quedar configurado, las tarjetas de vTasks se moverán automáticamente a medida que que estés trabajando en las distintas ramas.

📦 Instalación

Solo ejecutá:

npx vtasks-automate-cli

Te pedira una confirmación para instalar los paquetes necesarios. Basta con aceptar.

Este comando detectará automáticamente tus carpetas de frontend y backend, instalará lo necesario, y actualizará los scripts.

🧠 ¿Cómo funciona?

El paquete se integra en el ciclo de desarrollo de tu equipo. Cuando ejecutás los scripts habituales (npm start o npm run dev), se activa el sistema de automatización, que:

• Detecta la rama en la que estás trabajando.
• Detecta el usuario y el nombre del proyecto desde la configuración de git.
• Se comunica con la API de vTasks.
• Mueve la tarjeta correspondiente al estado "En Progreso".

🛠️ Requisitos

• Un proyecto con:
  • Backend con Node.js y script npm start o
  • Backend de React y script npm start o
  • Frontend con Next.js y script npm run dev
• Tener ramas creadas a través de vTasks, siguiendo el formato sugerido por la plataforma.

🔄 Actualizar versión

Para actualizar la versión del paquete vtasks-automate-cli en los proyectos, seguí estos pasos:

1. Ir a las carpetas donde se ejecutan los programas, por ejemplo:

   • server
   • client
   • client-nextjs (según correspondan o existan en tu entorno)

2. En cada una de esas carpetas, ejecutar el siguiente comando para instalar la última versión del paquete:

   npm i vtasks-automate-cli@latest
   

3. Verificar que la instalación se haya completado correctamente y que el paquete se haya actualizado en el package.json de cada proyecto.

⚠️ Importante:
No ejecutar este comando en la raíz del proyecto.
Por ejemplo, no correrlo en:

/Venturing-Fullstack-Boilerplate

Sino en las rutas específicas:

/Venturing-Fullstack-Boilerplate/server
/Venturing-Fullstack-Boilerplate/client