Ayuda de pulpForge

pulpForge es la herramienta de seguimiento de proyectos de software de pulpSuite. Se inspira en Azure DevOps (tipos de elementos de trabajo, categorías de estados, sprints, repositorios vinculados, planes de pruebas simplificados) con la agilidad de una herramienta como Linear. Funciona en el navegador, sin instalar nada y sin cuenta. Por defecto, todo se queda en su dispositivo; también puede compartir sus proyectos con un equipo o abrirlos en un teléfono: consulte Compartir con un equipo o un teléfono.

Un proyecto se ve en seis pantallas: Cartera, Tablero, Sprints, Consultas, Repositorios y Pruebas. Importar, Papelera y Ajustes completan el menú. Cada proyecto se abre en una pestaña, en la parte superior de la ventana.

Primeros pasos

1. Abra pulpForge. La primera vez que lo abre, aparece solo un proyecto de ejemplo para ver cómo es pulpForge: el área de cliente de una empresa de construcción ficticia, con su cartera, su tablero, sus sprints, su repositorio de código y sus pruebas. Nunca se guarda ni se mezcla con sus proyectos. Empezar desde cero o Eliminar el ejemplo lo quita con un clic (también cerrar su pestaña), Importar mis datos abre una exportación para importar y Archivo › Volver a ver el ejemplo lo vuelve a abrir. Su primer proyecto o su primera importación lo sustituye. Después, elija Nuevo proyecto (una clave de 2 a 10 letras como PRJ da los números legibles PRJ-42, y un proceso Agile, Scrum o Básico da los tipos de elementos y los estados iniciales) o Importar una exportación de otra herramienta.
2. En la Cartera, pulse Nuevo elemento, escriba un título y pulse Intro: el elemento se crea y la escritura continúa. Tab convierte el siguiente elemento en hijo, Mayús+Tab sube un nivel.
3. Pulse un elemento para abrir su ficha: estado, asignado, puntos, horas, fecha límite, etiquetas, descripción en Markdown, criterios de aceptación, enlaces, código, adjuntos e historial.
4. En Sprints, cree un sprint, arrastre elementos de la cartera al sprint y pulse Iniciar. El indicador compara el trabajo restante con la capacidad del equipo.
5. Cada cambio se guarda al instante. Archivo › Guardar como escribe una copia de seguridad completa .pforge.

Tareas habituales

¿Cómo organizo la cartera?

Los elementos se anidan en épicas › funcionalidades › historias › tareas. Un triángulo pliega o despliega una rama; la suma de puntos y del trabajo restante aparece en cada padre. Arrastre el asa de una fila: soltar en la parte superior o inferior de otra fila cambia el orden, soltar en el centro la convierte en hija. Un elemento nunca puede ser hijo de uno de sus propios descendientes: un mensaje lo explica. Con el teclado, Alt+↑ y Alt+↓ reordenan.

¿Cómo funciona la captura rápida?

Mientras escribe, pulpForge sugiere el tipo (error, historia, tarea…) y la prioridad según las palabras del título, en francés, inglés y español, y señala los posibles duplicados («Se parece a PRJ-12»). Enlazar como duplicado crea el enlace a la vez que el elemento. Nada se impone: cambie el tipo en la lista junto al campo.

¿Cómo divido una historia en tareas?

Escriba una lista con viñetas en la descripción de la historia. Aparece un botón Crear N tareas hijas: una viñeta, una tarea.

¿Cómo sigo el avance en el tablero?

El Tablero ordena las tarjetas por categoría de estado (por hacer, en curso, resuelto, terminado); un subestado personalizado aparece como insignia. Arrastre una tarjeta para cambiar su estado: si el flujo de ese tipo lo prohíbe, la tarjeta vuelve con un mensaje. Elija los carriles por asignado o por padre (soltar una tarjeta en el carril de una persona se la asigna). Un límite de trabajo en curso por columna (botón «…» de la columna) pone la columna en rojo al superarlo: es un aviso, no un bloqueo. En el teléfono, el menú «…» de una tarjeta cambia su estado sin arrastrar.

¿Cómo planifico un sprint?

En Sprints, la cartera está a la izquierda y el sprint a la derecha: arrastre o use la flecha de una fila. Editar define las fechas, el objetivo, la capacidad por persona (horas por día, días de ausencia) y los días no laborables del equipo. El indicador se pone rojo si el trabajo restante supera la capacidad. El burndown muestra la curva ideal (del total a cero en los días laborables) y la curva real, anotada cada día la primera vez que se abre pulpForge. Solo hay un sprint activo a la vez; Terminar propone pasar lo que no está acabado al sprint siguiente, devolverlo a la cartera o dejarlo. Resumen compone un texto con las cifras del sprint, y Notas de versión lista los elementos terminados por tipo (Guardar (.md) o Abrir en pulpDoc).

¿Cómo vinculo elementos entre sí y con otras aplicaciones?

En la ficha, Enlaces: bloquea, bloqueado por, duplicado de, relacionado con, prueba… Para vincular un elemento a una solicitud de cambio de pulpProduct o a una oportunidad de pulpClient, pegue la referencia pulp:… copiada en la otra aplicación. El botón Copiar la referencia de la ficha hace lo contrario.

¿Cómo vinculo commits, ramas y solicitudes de fusión?

En Repositorios, añada la dirección web de un repositorio (nunca un usuario ni un token: se rechaza una dirección que lo contenga). pulpForge no contacta con el repositorio. Importar un registro de Git muestra un comando que debe ejecutar en su repositorio (botón Copiar); después importe el archivo que produce o pegue su contenido. Los commits que citan PRJ-12, AB#12 o #12 se vinculan a los elementos, igual que las ramas feature/PRJ-12-…. «Fixes PRJ-3» o «cierra #4» propone cerrar el elemento: una lista de casillas pide su confirmación, no se cierra nada automáticamente.

¿Cómo importo resultados de pruebas?

En Pruebas, importe un informe JUnit XML. Los resultados se asocian a sus casos de prueba (por clave de origen o, si no, por el nombre de la prueba) y pulpForge propone crear los casos que faltan. La tasa de éxito se muestra por compilación. Una prueba fallida tiene un botón Crear un error, rellenado con el mensaje de fallo en los pasos para reproducir.

¿Cómo importo desde Jira, Azure DevOps, GitHub o GitLab?

Importar (o suelte el archivo en la ventana). El asistente reconoce el formato y propone el proyecto de destino (un proyecto nuevo toma la clave de origen), las correspondencias (tipos, estados, prioridades, personas), una vista previa (por crear, por actualizar, avisos) y la importación. Los números de origen se conservan cuando la clave de proyecto es la misma (PRJ-12 sigue siendo PRJ-12). Un estado desconocido conserva su nombre como estado personalizado. Una importación añade, nunca sobrescribe: reimportar un archivo no crea nada, y los elementos ya presentes se ofrecen como «actualizar» (con las diferencias) u «omitir».

¿Cómo exporto o imprimo?

Consultas: filtros combinables (tipo, estado, categoría, asignado, etiqueta, sprint, zona, texto), que Guardar la consulta conserva para más tarde, y luego Exportar: CSV en formato Jira, CSV en formato Azure DevOps, JSON en formato GitHub o CSV con los encabezados en su idioma. El menú Archivo ofrece también las exportaciones Jira, Azure DevOps y GitHub de todo el proyecto, las Notas de versión e Imprimir (toda la cartera o el sprint activo).

¿Cómo configuro un proyecto?

En Ajustes: Proyectos (nombre, proceso, Zonas para ordenar los elementos y Mostrar los fines de sprint en la agenda de la suite), Flujos de estados (añadir un estado, elegir su categoría, Limitar las transiciones permitidas, Restablecer el flujo predeterminado), Personas (la lista de asignados, que también sirve para la capacidad de los sprints), Pantalla (tema) y Datos (copia de seguridad, búsqueda inteligente, Volver a ver el ejemplo).

¿Cómo recupero lo que eliminé?

Papelera: los elementos, sprints, repositorios, proyectos, personas y consultas eliminados están allí y se pueden restaurar. En esta versión no hay eliminación definitiva.

Compartir con un equipo o un teléfono

• Archivo compartido: Archivo › Guardar como archivo compartido… coloca sus proyectos (por ejemplo Producto.pforge) en una carpeta sincronizada (OneDrive, Nextcloud, kDrive) o en una unidad de red. Sus compañeros lo abren con Archivo › Abrir una carpeta compartida…; cada uno ve los cambios de los demás en cuanto la carpeta se sincroniza. Abrir una copia .pforge antigua añade su contenido al archivo abierto.
• Estado del archivo: el distintivo de la barra de título indica En este ordenador o Compartido · N dispositivos; un clic muestra quién ha visto sus cambios («5 cambios aún no vistos por Paul») y propone Sincronizar ahora.
• Cambios a la vez: si dos personas cambian el mismo campo de un elemento, se conserva el valor más reciente y un aviso se lo indica, con Conservar o Usar el otro valor.
• Números repetidos: dos personas sin conexión pueden crear cada una un PRJ-42. Al combinar los cambios, el más reciente se renumera («PRJ-42 ahora es PRJ-57») y un aviso lo indica. La ficha muestra Número anterior: PRJ-42, y la búsqueda, los enlaces y el registro de Git siguen entendiendo el número anterior.
• Adjuntos: acompañan al archivo. Hasta 8 MB llegan solos a cada dispositivo; por encima, el adjunto muestra Por descargar. Un adjunto que indica Aún no ha llegado estará disponible cuando la carpeta termine de sincronizarse.
• Copia de seguridad automática: Archivo › Copia de seguridad automática… hace una copia completa cada día en la carpeta que usted elija; un recordatorio aparece si sus proyectos nunca se han copiado o no se han copiado desde hace más de 7 días.
• Mi teléfono: Archivo › Abrir en mi teléfono… muestra un código QR; escanéelo, compruebe que el código de 6 cifras es el mismo en los dos dispositivos, elija Solo lectura o Edición y la duración. El teléfono muestra sus proyectos en directo desde el ordenador, sin guardar nada.
• Invitado en un ticket: en la ficha de un elemento, Invitar a esta ficha envía un código QR o un enlace. La persona solo ve ese ticket, sus subelementos, sus enlaces y su historial. En su ordenador aparece una ventana de autorización: compare el código y elija Rechazar, Solo lectura o Edición. En solo lectura, toda la ficha aparece atenuada bajo el aviso Solo lectura; un invitado puede abrir los adjuntos, pero no añadirlos.
• Quién está conectado: «N dispositivo(s) conectado(s)» aparece en la cabecera; Archivo › Dispositivos conectados… muestra las sesiones, y Cortar el acceso termina una de ellas al instante.
• Límites: la carpeta compartida requiere un ordenador con Chrome o Edge; cualquiera que tenga acceso a la carpeta ve y modifica todos los proyectos del archivo (sin permisos por persona; cífrelo si hace falta); los cambios llegan al ritmo de la sincronización de la carpeta, no en tiempo real. Para el teléfono y los invitados, el ordenador debe seguir encendido, con pulpForge abierto.

Todos los detalles: Compartir un archivo con su equipo o su teléfono y Dónde están sus datos y cómo trabajar con otras personas.

Formatos admitidos

Atajos de teclado

En Mac, Cmd sustituye a Ctrl.

La IA en pulpForge

Todo se calcula en su dispositivo.

• Clasificación automática: tipo y prioridad sugeridos según el título (reglas de palabras, sin descarga).
• Posibles duplicados: sin el módulo, comparación por palabras comunes; con la búsqueda inteligente (Ajustes › Datos, un pequeño módulo descargado una vez con su aprobación), comparación del significado de los textos. Vaciar la memoria de la búsqueda inteligente borra lo que ha retenido en este dispositivo.
• Estimación sugerida: mediana de los puntos de los cinco elementos terminados más parecidos, nunca impuesta.
• Correspondencias de importación: los tipos, estados, prioridades y personas se proponen automáticamente.
• Resumen de sprint: texto compuesto a partir de las cifras, sin redacción automática.
• pulpAssist: búsqueda de elementos, creación, cambio de estado, estado del sprint y notas de versión; cada modificación pasa por una tarjeta de confirmación.

Preguntas frecuentes y solución de problemas

¿Se envían mis datos a algún sitio?

No sin que usted lo decida. Por defecto, se quedan en su navegador, en este dispositivo: active la copia de seguridad automática o exporte una copia .pforge de vez en cuando. Si comparte un archivo, va a la carpeta que usted eligió; nada se envía a pulpSuite.

¿Pueden trabajar varias personas a la vez?

Sí, compartiendo un archivo: en una carpeta sincronizada, por intercambio directo entre ordenadores, en su teléfono o invitando a alguien a un ticket (consulte Compartir con un equipo o un teléfono). El servidor de pulpSuite (tiempo real, permisos por persona, acceso desde todos los navegadores y teléfonos) aún no está disponible; la conexión con una base de datos de empresa existente está prevista, sin fecha anunciada. En un mismo dispositivo, dos pestañas abiertas se mantienen sincronizadas, y dos ediciones del mismo campo a la vez abren un cuadro para elegir el valor que se conserva.

¿Por qué falta un estado en la lista de movimiento?

El flujo de estados del tipo puede limitar los cambios permitidos (Ajustes › Flujos de estados). Los estados rechazados aparecen atenuados.

¿Está pulpForge conectado a GitHub o GitLab?

No: lee los archivos que usted le entrega (exportaciones de incidencias, registro de Git, informes de pruebas) y nunca contacta con sus repositorios.