Guía de uso
Proyectos
Un proyecto siempre pertenece a un cliente. Reúne tareas, tickets, código, despliegues, tiempo, costes y mediciones.
La lista de proyectos
En Proyectos filtras por «Todos», «Activos», «Bloqueados», «Revisión» y «En pausa» y eliges entre tarjetas y tabla (proyecto, cliente, estado, progreso, tareas, despliegue). La búsqueda filtra por nombre y cliente.
Crear un proyecto
«Añadir proyecto» (o «+ Nuevo» › Proyecto, tecla p) pide:
- Cliente (obligatorio) y nombre (al menos dos caracteres),
- Dirección: el slug que propone VentionDesk; las diéresis alemanas se transcriben («mueller», no «muller»). Después aparece en cada URL y en la configuración del ejecutor de tareas, así que elígelo con cuidado,
- Tipo (Web, App, API, Interno, Datos), estado, repositorio de GitHub (como
owner/name), rama, URL en producción y descripción.
La cabecera de la página del proyecto
- Desplegar (solo propietario) abre «Iniciar despliegue» con los destinos del proyecto. Se lanza un despliegue; si sale bien se ve después en la pestaña «Despliegues». Cuando a un destino aún le falta algo, se indica qué, por ejemplo «Asignar hosting». Los proveedores de hosting solo se pueden asignar una vez conectados en Operaciones › Fuentes.
- Temporizador del proyecto para iniciar el registro de tiempo de este proyecto.
- Crear factura (solo propietario) y Abrir repo.
- El lápiz abre «Editar proyecto»; solo el propietario puede usar «Eliminar proyecto».
- Cambiar de empresa (solo propietario) asigna el proyecto a otro cliente. Los tickets, las notas, los documentos y los borradores se mueven con él. Las facturas finalizadas y los presupuestos enviados no: en ese caso el cambio se interrumpe e indica los documentos; anúlalos y emítelos de nuevo.
Debajo están las cifras clave Progreso, Pendientes, Tickets, Presupuesto y Sin facturar; un clic cambia a la pestaña correspondiente.
Las pestañas
Resumen
Actividad (las seis entradas más recientes; «Más filas» despliega el resto), próximos pasos, presupuesto («Costes y presupuesto», solo propietario), enlaces (cliente, repositorio, hosting, entrada de tickets, entrada por correo) y las ideas del proyecto.
La fila Entrada de tickets se mide: «conectado» con el último aviso en cuanto ha llegado un ticket a este proyecto por formulario, app o servidor, da igual si con la clave pública o con una clave de entrada. «configurado» significa: hay una vía abierta, pero todavía no ha llegado nada. «Configurar» (solo propietario) te lleva a Ajustes › Entrada de tickets con este proyecto desplegado; allí están las claves, los orígenes y los buzones.
Las ideas del proyecto (solo propietario), la idea de la que surgió el proyecto o cualquier otra asignada a este proyecto en la página Ideas, aparecen como una pequeña tarjeta con título, estado y una línea de texto. Un clic en el título abre la idea en la página Ideas para editarla.
Tareas
El tablero Kanban del proyecto; consulta Tareas y tablero.
Tickets
Los tickets de este proyecto; un clic abre el ticket. Los canales de entrada no se configuran aquí, sino en Ajustes › Entrada de tickets.
Git y PR
Commits, pull requests, ramas y check runs de GitHub, en cuanto el repositorio está introducido y GitHub está conectado. «Sincronizar ahora» trae lo que aún no ha llegado; si no, la sincronización se ejecuta cada noche, y los eventos nuevos llegan al instante. Un commit cuyo mensaje contiene la línea VentionDesk-Task: <task ID> queda vinculado a esa tarea. Commits y pull requests muestran cada uno las ocho primeras filas (primero los PR abiertos); «Más filas» despliega el resto.
Despliegues
Tabla con entorno, estado, commit, duración, origen y hora, alimentada desde GitHub, Vercel, Render y los demás proveedores de hosting: las ocho ejecuciones más recientes; «Más filas» muestra las anteriores. En la vista de detalle: «Abrir el registro del build en el proveedor» y «Abrir el sitio desplegado».
Hoja de ruta
Fases con título, desde y hasta («Añadir fase»); por fase, «Marcar como hecha», «Reabrir» y «Editar fase». Una clave de agente con roadmap:write crea, modifica, ordena y da por hechas fases; no puede eliminar ninguna.
Tiempo
«Añadir tiempo», horas por semana, el reparto y todas las entradas de tiempo de este proyecto; consulta Registro de tiempo.
Costes (solo propietario)
Costes corrientes con nombre, tipo, importe por mes o por año y duración («Añadir partida»). El presupuesto lo fijas con «Fijar presupuesto». El consumo se calcula, no se mantiene: tiempo registrado por tarifa por hora.
Analítica
Tres secciones: Uso y rendimiento (tasa de errores y tiempo de carga P95 de los monitores de los últimos siete días; visitas y conversión quedan vacías mientras ninguna fuente las mida; el signo de interrogación de la tarjeta explica por qué), Errores (con la fila «Fuente de errores» para asignarla) y Monitores (lista y formulario en una tarjeta).
- Crear monitor: URL, tipo («Disponibilidad» o «Certificado») e intervalo. Si un monitor falla dos veces seguidas, se crea un ticket; en cuanto vuelve a estar accesible, el ticket se resuelve.
- Errores de Sentry, Bugsnag o Rollbar, en cuanto se elige un proyecto del proveedor en «Asignar fuente de errores». «Crear como tarea» convierte un error en una tarea. «Resuelto» lo marca primero como resuelto en el proveedor, con el acceso de tu fuente de errores, y solo después aquí; el botón lo tienen el propietario y los miembros del equipo. Si el acceso en el proveedor es de solo lectura (Sentry sin
event:write, Bugsnag sin el rol Organization Administrator o Project Owner, Rollbar sin un project access token con el scope «write»), si el proveedor ya no conoce el error o no responde en diez segundos, el error sigue abierto y el motivo aparece debajo de la lista. Una clave de agente conerrors:readlee los errores de sus proyectos; conerrors:writemarca uno como resuelto de la misma forma. Si el error vuelve a aparecer después, cuenta como regresión.