Editar Proyecto
El diálogo Editar Proyecto permite actualizar el nombre, tipo, color, estado, responsable, fechas, etiquetas y descripción de un proyecto existente. Se abre sobre la página de detalle del proyecto y envía solo los campos modificados (envío tipo patch).
Cómo acceder
Sección titulada «Cómo acceder»Abra el Detalle de Proyecto y haga clic en el botón Editar en el encabezado de la página. El diálogo se abre sobre /projects/projects/:projectId.
| Campo | Requerido | Tipo | Descripción | Predeterminado | Validación |
|---|---|---|---|---|---|
| Nombre | Sí | Texto | Nombre visible del proyecto | Valor actual | Máx. 200 caracteres; se recorta al guardar; guardar deshabilitado cuando está vacío |
| Tipo de Proyecto | Sí | Selección | Conjunto de tipos de elemento del proyecto | Valor actual | Bloqueado (solo lectura) cuando el proyecto ya tiene tareas |
| Color | No | Selector de color + Texto | Color de acento visual | Valor actual | Código hexadecimal; máx. 9 caracteres; editable con la paleta o el campo hexadecimal |
| Estado | No | Selección | Estado actual del proyecto | Valor actual | Opciones limitadas por las transiciones permitidas desde el estado persistido |
| Responsable | No | Selección de usuario | Usuario responsable del proyecto | Valor actual | Solo usuarios activos; se puede limpiar; obligatorio cuando la configuración del tenant exige responsable |
| Fecha de Inicio | No | Fecha | Fecha de inicio planificada | Valor actual | Se convierte a ISO al patchear |
| Fecha de Fin | No | Fecha | Fecha de fin planificada | Valor actual | Se convierte a ISO al patchear |
| Etiquetas | No | Selección múltiple | Chips de etiquetas en minúsculas | Valor actual | Máx. 50 etiquetas; se reemplazan (no se adjuntan) al cambiar |
| Descripción | No | Área de texto | Descripción detallada del proyecto | Valor actual | Máx. 4000 caracteres; valor vacío se convierte en null |
Reglas de Transición de Estado
Sección titulada «Reglas de Transición de Estado»Las opciones disponibles dependen del estado actual (persistido) del proyecto, no del valor en el diálogo. No puede deshacer una transición mientras el diálogo está abierto.
| Desde | Transiciones permitidas |
|---|---|
| Borrador | Borrador, Activo, Cancelado |
| Activo | Activo, En Pausa, Completado, Cancelado |
| En Pausa | En Pausa, Activo, Cancelado |
| Completado | Completado, Archivado |
| Cancelado | Cancelado, Archivado |
| Archivado | Solo Archivado (bloqueado) |
Las transiciones a Completado, Cancelado y Archivado son irreversibles. Al seleccionar uno de estos estados, el diálogo muestra un aviso de confirmación antes de guardar.
Bloqueo del Tipo de Proyecto
Sección titulada «Bloqueo del Tipo de Proyecto»Cuando el proyecto ya tiene tareas, el selector Tipo de Proyecto está deshabilitado y muestra el mensaje:
El tipo de proyecto no se puede cambiar una vez que se han creado tareas.
Envío Tipo Patch
Sección titulada «Envío Tipo Patch»Solo los campos que modificó se envían en el patch de la API:
- Si abre el diálogo y lo cierra sin hacer cambios, el botón Guardar permanece deshabilitado y no se realiza ninguna llamada a la API.
- Los campos que no tocó conservan sus valores actuales en el servidor.
Reglas de Validación
Sección titulada «Reglas de Validación»| Regla | Comportamiento |
|---|---|
| Nombre requerido | El botón Guardar se deshabilita mientras el Nombre esté vacío |
| Longitud del nombre | Máx. 200 caracteres |
| Longitud de la descripción | Máx. 4000 caracteres |
| Cantidad de etiquetas | Máx. 50 etiquetas |
| Tipo de Proyecto requerido | El botón Guardar se deshabilita si se borra el Tipo de Proyecto |
| Sin cambios | El botón Guardar se deshabilita cuando no hay campos modificados |
| Estado irreversible | Se muestra un diálogo de confirmación antes de guardar Completado, Cancelado o Archivado |
| Responsable requerido (condicional) | Si la configuración del tenant requiere responsable, el campo Responsable se vuelve obligatorio |
| Participantes requeridos para activación | Si la gobernanza del tenant requiere participantes antes de la activación y el proyecto no tiene ninguno, mover a Activo está bloqueado |
| Protección de cambios sin guardar | Cerrar con cambios sin guardar muestra un diálogo de confirmación |
Comportamiento al Guardar
Sección titulada «Comportamiento al Guardar»- Solo los campos modificados se envían en el payload de actualización.
- Tras un guardado exitoso el diálogo se cierra y la página de detalle se actualiza con los nuevos valores.
Tareas Comunes
Sección titulada «Tareas Comunes»- Abra el Detalle de Proyecto y haga clic en Editar.
- Actualice los campos necesarios — por ejemplo, cambie el Estado o asigne un Responsable.
- Si está moviendo a un estado terminal (Completado, Cancelado, Archivado), confirme el diálogo de transición irreversible.
- Haga clic en Guardar. El diálogo se cierra y el detalle muestra los datos actualizados.
Permisos y Comportamiento del Sistema
Sección titulada «Permisos y Comportamiento del Sistema»- Editar proyectos requiere acceso al módulo Proyectos y el permiso
canWriteProjects. - El campo Responsable es obligatorio solo cuando la configuración del tenant tiene activada la opción Requerir responsable del proyecto.
- Solo los campos modificados se incluyen en el patch de la API, minimizando efectos secundarios.
Páginas Relacionadas
Sección titulada «Páginas Relacionadas»- Crear Proyecto — Crear un nuevo proyecto
- Detalle de Proyecto — Ver un proyecto específico
- Lista de Proyectos — Ver y buscar todos los proyectos
- Participantes del Proyecto — Agregar participantes requeridos antes de activar el proyecto
- Configuración de Gobernanza de Proyectos — Configurar requisitos de responsable y participantes (solo superusuarios)