Editor de Tipo de Proyecto

El Editor de Tipo de Proyecto es una página dedicada (no un diálogo) que controla tanto los metadatos del tipo como el esquema ordenado de tipos de elemento de trabajo utilizado por los proyectos y tareas descendientes. Ábralo desde la lista Tipos de Proyecto haciendo clic en + Nuevo Tipo de Proyecto o en el ícono de lápiz de cualquier tipo existente.

Cómo Acceder

Abra Proyectos desde la barra lateral, navegue a Configuración → Tipos de Proyecto, luego haga clic en + Nuevo Tipo de Proyecto (crea un nuevo tipo) o en el ícono de lápiz de una tarjeta existente (edita ese tipo). Se requiere permiso de Escritura en projects.project_types para guardar.

Campos a Nivel de Tipo

Campo	Requerido	Notas
Nombre	Sí	Máx. 100 caracteres. Genera automáticamente la Clave cuando la Clave no ha sido editada manualmente.
Clave	Sí	Formato slug; máx. 60 caracteres. Se deriva automáticamente del Nombre al crear. Bloqueada después de guardar (no se puede cambiar al editar).
Descripción	No	Texto libre; se muestra en la tarjeta del tipo en el catálogo.
Ícono	No	Abre el panel Selector de Ícono — busque y seleccione desde el catálogo de íconos Lucide.
Color	No	Control combinado de muestra de color y campo de texto hexadecimal (#RRGGBB). Ambos controles se mantienen sincronizados.

Una franja de vista previa en vivo aparece debajo de los campos una vez que se establece un nombre o ícono, mostrando el chip del ícono y la clave exactamente como aparecen en las tarjetas de proyecto.

Inicio desde Plantilla

Solo en la ruta Nuevo Tipo, aparece el botón Comenzar desde plantilla en la tarjeta de metadatos del tipo. Al hacer clic se abre el diálogo Selector de Plantilla, que lista plantillas de tipos de proyecto predefinidas (por ejemplo, Desarrollo de Software, Campaña de Marketing). Seleccionar una plantilla completa todos los campos de metadatos y pre-rellena las filas del esquema de elementos de trabajo en un solo paso. Puede modificar cualquier campo antes de guardar.

El inicio desde plantilla no está disponible en modo edición para evitar sobreescribir datos existentes.

Editor de Esquema de Tipos de Elemento de Trabajo

La sección inferior de la página gestiona la lista ordenada de tipos de elemento de trabajo (TETs) para este tipo de proyecto. El editor es responsivo: en escritorio se muestra como una tabla con desplazamiento horizontal; en móvil se muestra como tarjetas apiladas. Ambos diseños comparten los mismos campos y comportamiento de arrastre.

Columnas / Campos por Fila

Campo	Requerido	Notas
Nombre	Sí	Nombre visible para este tipo de elemento de trabajo. Genera automáticamente la Clave cuando está en blanco.
Clave	Sí	Formato slug; debe ser único entre las filas activas (no eliminadas) de este tipo. Bloqueada para TETs existentes en modo edición.
Ícono	No	Abre el Selector de Ícono; valor predeterminado CheckSquare.
Color	No	Muestra de color + campo de texto hexadecimal; valor predeterminado #3b82f6.
Nivel de jerarquía	No	1, 2 o 3 — controla la profundidad de anidamiento dentro de un proyecto.
Permitir hijos	No	Activar/desactivar; cuando está desactivado, este TET no puede contener elementos de trabajo hijo.

Agregar Filas

Haga clic en + Agregar fila (debajo de la tabla en escritorio, o el botón con borde discontinuo en móvil) para agregar una fila de tipo de elemento de trabajo en blanco. Complete al menos el Nombre y la Clave antes de guardar.

Reordenamiento por Arrastre

Cada fila tiene un asa de arrastre (ícono de seis puntos) en su borde izquierdo. Para reordenar:

• Escritorio / dispositivo con puntero — Haga clic y mantenga el asa, luego arrastre la fila hacia arriba o abajo. Una tarjeta fantasma sigue el cursor. Suelte para soltar en la nueva posición.
• Móvil / pantalla táctil — Toque y mantenga el asa durante 200 ms para activar el arrastre, luego arrastre. Una tolerancia de 5 px evita arrastres accidentales.
• Teclado — Enfoque el asa y use las teclas de flecha (sensor de teclado de dnd-kit).

El orden de clasificación está determinado por la posición de la fila en la lista al momento de guardar. Los cambios de posición se aplican localmente y persisten al hacer clic en Guardar.

Eliminación Suave y Restauración (Modo Edición)

En modo edición, eliminar una fila la marca como eliminada (tachada, atenuada) en lugar de quitarla de la interfaz de inmediato. Esto permite deshacer una eliminación antes de guardar. Haga clic en el botón Restaurar (ícono de flecha circular) para reactivar una fila. Las filas eliminadas se excluyen del payload guardado.

En modo creación, eliminar una fila la quita permanentemente del formulario local.

Reglas de Validación

La validación se ejecuta al perder el foco del campo y al enviar.

Regla	Comportamiento
Nombre requerido (tipo)	El botón Guardar está deshabilitado mientras el Nombre esté vacío
Clave requerida (tipo)	El botón Guardar está deshabilitado mientras la Clave esté vacía
Nombre requerido (fila TET)	Se muestra el error en el nombre de la fila; el guardado está bloqueado
Clave requerida (fila TET)	Se muestra el error en la clave de la fila; el guardado está bloqueado
Clave única (filas TET)	Una clave duplicada entre filas activas muestra “Clave ya en uso”; el guardado está bloqueado
Formato de color	El color debe ser un hexadecimal válido de 6 dígitos (#RRGGBB); un valor inválido muestra un error en línea

Guardar y Cancelar

• Guardar — Crea un nuevo tipo (/projects/types/new) o actualiza el tipo existente (/projects/types/:id/edit). Solo las filas TET activas (no eliminadas) se incluyen en el payload guardado, renumeradas con un orden de clasificación normalizado. Después de guardar, el editor navega de regreso a la lista de Tipos de Proyecto e invalida las consultas del módulo.
• Cancelar — Si el formulario tiene cambios sin guardar, un diálogo de confirmación del navegador pregunta si desea salir. Al confirmar, navega de regreso a la lista de Tipos de Proyecto sin guardar.

Permisos

Acción	Permiso requerido
Abrir el editor	Escritura (projects.project_types)
Guardar nuevo tipo	Escritura (projects.project_types)
Guardar ediciones	Escritura (projects.project_types)
Eliminar un tipo	Admin (projects.project_types) — se hace desde la lista de Tipos de Proyecto

Los superusuarios omiten las verificaciones de permisos.

Páginas Relacionadas

• Tipos de Proyecto — Volver al catálogo después de guardar
• Lista de Proyectos — Usar un tipo de proyecto al crear un proyecto