Proyectos y costos

Los proyectos son contenedores a nivel de trabajo que agrupan listas de tareas relacionadas. Una vez que las listas de tareas están vinculadas a un proyecto, Ziptask consolida automáticamente el progreso de los puntos de esfuerzo, el estado de finalización y —para los propietarios de la cuenta— los costos estimados en dólares de todas ellas.

Nota sobre los puntos: los proyectos usan el campo Puntos de esfuerzo estimados de cada tarea, no los Puntos de recompensa. Los puntos de esfuerzo representan el peso del trabajo de una tarea e impulsan las estimaciones de costos. Los Puntos de recompensa son la moneda de gamificación que se usa para la clasificación y la tienda, y son completamente independientes del cálculo de costos de los proyectos. Ambos campos se establecen por separado en cada tarea por un Admin o Root.

Feature flag: projects_enabled — solo en el plan Business. Root puede activarlo en Configuración de la cuenta → Proyectos y costos.

Permisos

Acción	Usuario	Admin / Team Admin	Root
Ver la lista y el detalle de proyectos	✗	✓	✓
Crear / editar / eliminar proyectos	✗	✓	✓
Archivar / desarchivar un proyecto	✗	✓	✓
Asignar un gerente de proyecto	✗	✓	✓
Ser asignado como gerente de proyecto	✗	✓ (solo ámbito de cuenta)	✓
Asignar una lista de tareas a un proyecto	✗	✓	✓
Ver totales de puntos y progreso	✗	✓	✓
Ver costos en dólares y gastos	✗	✗	✓
Agregar / editar / eliminar gastos	✗	✗	✓
Configurar las etiquetas de consolidación	✗	✓	✓
Ver el informe Resumen del proyecto	✗	✓	✓
Ver el informe Costos del proyecto	✗	✗	✓

Los usuarios estándar nunca ven la sección de Proyectos. La visibilidad de costos y gastos se controla con el permiso Costos del proyecto, que por defecto solo tiene Root. Una cuenta puede otorgarlo a Admin o a un rol personalizado: lectura muestra las cifras de costos y la lista de gastos; gestión además permite agregar, editar y eliminar gastos. Configurar qué etiquetas se consolidan es parte de la edición normal del proyecto (Admin/Root), no del permiso de costos.

Cómo funciona

Crear un proyecto

Root y Admin pueden tocar Nuevo proyecto desde la página de Proyectos. Campos:

Campo	Obligatorio	Descripción
Título	Sí	Debe ser único dentro de la cuenta (máx. 150 caracteres).
Descripción	No	Contexto de texto libre que se muestra en la página de detalle.
Gerente de proyecto	No	Un miembro que puede tanto editar proyectos como gestionar cualquier lista de tareas de la cuenta — en la práctica, Admin o Root. Puede editar el proyecto y gestionar cualquier lista dentro de él. Recibe una notificación en la app y push al ser asignado. Seleccionar “Sin asignar” deja el campo en blanco.
$ por punto	No	Valor en dólares de un punto ganado (p. ej. `5` = $5 por punto). Se usa para las estimaciones de costos. Deja `0` para omitir el seguimiento de costos.
Fecha de inicio	No	Fecha y hora de inicio del proyecto — se elige con un control combinado de fecha y hora, con las 9 AM en la zona horaria de la cuenta por defecto. Se muestra en la barra lateral. Debe ser en o antes del fin.
Fecha de fin	No	Fecha y hora de fin del proyecto — por defecto las 5 PM en la zona horaria de la cuenta. Se muestra en la barra lateral.

Los títulos de los proyectos deben ser únicos dentro de una cuenta. Al intentar guardar un título duplicado aparece un error que te indica que ese nombre ya está en uso.

Editar un proyecto

Cualquier Admin o Root puede editar el título, la descripción, el gerente de proyecto, la tarifa o las fechas de un proyecto en cualquier momento. Si se asigna un nuevo gerente de proyecto distinto del anterior, este recibe una notificación en la app y push. Si se quita el gerente de proyecto, la persona asignada previamente recibe una notificación de eliminación. Ninguna de las dos notificaciones se dispara si la persona que hace el cambio es la misma que se asigna o se quita.

Eliminar un proyecto

Eliminar un proyecto no elimina sus listas de tareas. Todas las listas de tareas vinculadas se desvinculan y quedan completamente intactas con todas sus tareas e historial.

Un diálogo de confirmación muestra el título del proyecto antes de que se ejecute la eliminación.

Vincular listas de tareas a un proyecto

Al crear o editar una lista de tareas, aparece un selector de Proyecto debajo del selector de Equipo — pero solo cuando projects_enabled está activado y existe al menos un proyecto activo en la cuenta.

Una lista de tareas puede pertenecer a un proyecto a la vez.
Seleccionar un proyecto vincula la lista; seleccionar “Sin proyecto” la desvincula.
Desvincular una lista de tareas no afecta a ninguna tarea ni punto de esa lista.
Solo los proyectos activos (no archivados) aparecen en el selector. Los proyectos archivados no se pueden asignar a listas nuevas ni existentes hasta que se desarchiven.

Página de la lista de proyectos

La lista de proyectos muestra una tarjeta por cada proyecto. Cada tarjeta muestra:

Título y descripción del proyecto
Rango de fechas (fechas de inicio – fin)
Barra de progreso (puntos ganados ÷ puntos estimados)
Recuentos de puntos: X / Y pts
Número de listas de tareas vinculadas
Una insignia Atrasado si alguna lista vinculada ha pasado su fecha de vencimiento con tareas incompletas

Las tarjetas se ordenan alfabéticamente. El campo de búsqueda filtra por título.

El interruptor Míos / Todos limita la lista a los proyectos que el miembro gestiona o a todos los proyectos que puede ver. El botón Filtros (icono de embudo) abre un panel con un control de Estado —Activos o Archivados— y muestra una insignia con el recuento cuando se aplica un filtro distinto del predeterminado.

Opciones de diseño (escritorio). Un selector de vista en la barra de herramientas permite a cada miembro mostrar los proyectos como Tarjetas (la cuadrícula predeterminada), Filas (la misma tarjeta, a todo el ancho) o una Tabla densa. La vista de Tabla añade un interruptor de densidad Compacta / Cómoda. La elección se recuerda por persona y por dispositivo —dos personas que comparten un navegador conservan su propia preferencia— y el término de búsqueda, el ámbito y la selección de Estado ahora persisten al abrir un proyecto y regresar. En los teléfonos, la lista siempre muestra tarjetas apiladas sin importar la elección guardada.

Página de detalle del proyecto

Al hacer clic en un proyecto se abre su página de detalle, que tiene una barra lateral y un área principal de contenido.

Barra lateral

Sección	Qué muestra
Progreso	Barra de progreso, fracción de puntos ganados/estimados, porcentaje de finalización y un desglose de los totales de puntos Estimados / Ganados / Restantes.
Calendario	Fecha de inicio, fecha de fin y número de listas de tareas vinculadas (solo se muestra cuando hay al menos una fecha establecida).
Gerente de proyecto	El nombre del miembro asignado con un icono de persona (solo se muestra cuando hay un gerente asignado).
Costo	(Permiso Costos del proyecto — Root por defecto) La tarifa $/pt; Costo Estimado / Ganado / Restante; más Gastos y un Total (estimación de mano de obra + gastos) en dólares.
Acciones	Botones de Editar, Archivar (o Desarchivar si el proyecto está archivado) y Eliminar.

Contenido principal

Sección	Qué muestra
Advertencia sin puntos	Un banner de advertencia que enumera cuántas listas tienen tareas con un valor de Puntos de esfuerzo estimados igual a 0. Esto significa que las estimaciones de costos y progreso pueden estar incompletas para esas listas.
Puntos por etiqueta	Una tabla que agrupa los puntos estimados y ganados por etiqueta en todas las listas vinculadas. Los usuarios Root ven una columna de Costo adicional. Qué etiquetas aparecen aquí es configurable por proyecto (ver Etiquetas de consolidación abajo).
Gastos	(Permiso Costos del proyecto) Una lista del dinero gastado en el proyecto —materiales, equipo, subcontratistas, etc.— cada uno con una categoría, un importe, una fecha y un recibo opcional. El total alimenta la columna de costo de la barra lateral. Ver Gastos abajo.
Listas de tareas	Cada lista de tareas vinculada a este proyecto. Cada fila muestra el título de la lista, una minibarra de progreso, el recuento de tareas completadas/totales, los totales de puntos (si tienen puntaje) y una insignia Atrasado cuando corresponde. Al hacer clic en una fila se navega a esa lista de tareas.

Lógica de la insignia “Atrasado”

Una lista de tareas se marca como Atrasado cuando se cumplen las tres condiciones:

La lista tiene una fecha de vencimiento establecida.
Esa fecha y hora de vencimiento han pasado (comparadas con el momento actual).
Al menos una tarea de la lista aún no está completada.

La insignia aparece tanto en la página de la lista de proyectos (como un recuento en la tarjeta del proyecto) como en las filas de listas individuales dentro de la página de detalle del proyecto.

Seguimiento de costos (solo Root)

Si la tarifa $ por punto está establecida en un proyecto, el propietario de la cuenta (Root) ve una sección de costos en la barra lateral de detalle del proyecto y en el informe Costos del proyecto:

Valor	Cálculo
Costo Estimado	Puntos de esfuerzo estimados × tarifa $/pt
Costo Ganado	Puntos de esfuerzo de las tareas completadas × tarifa
Costo Restante	Costo Estimado − Costo Ganado
Gastos	Suma de todos los gastos registrados en el proyecto
Total	Costo Estimado + Gastos

Las primeras tres líneas son la estimación de mano de obra (a partir de los puntos de esfuerzo). Gastos es dinero real gastado, y Total combina ambos. Los costos se actualizan en vivo a medida que se completan tareas, cambian los valores de puntos de esfuerzo o se agregan gastos. Por defecto solo Root ve estas cifras; el permiso Costos del proyecto se puede otorgar a otros.

Los Puntos de recompensa no afectan los cálculos de costos. El valor de Puntos de recompensa de una tarea puede diferir de sus Puntos de esfuerzo estimados — esto es intencional. Por ejemplo, una tarea rápida pero de alto valor podría tener 50 Puntos de recompensa y solo 2 Puntos de esfuerzo.

Puntos por etiqueta

La página de detalle incluye una tabla de desglose que agrupa los puntos estimados y ganados por etiqueta en todas las listas de tareas vinculadas. Esto es útil para entender qué categorías de trabajo están impulsando el esfuerzo estimado.

Las etiquetas se extraen de la biblioteca de etiquetas de la cuenta. Solo se muestran las etiquetas que aparecen en al menos una lista dentro del proyecto.

Etiquetas de consolidación

Por defecto, cada etiqueta de cualquier lista vinculada aparece en el desglose, lo que puede saturarlo con etiquetas que no son relevantes (p. ej. una etiqueta “Urgente” mostrándose junto a etiquetas de fase) y puede contar dos veces una lista que lleva dos etiquetas. Para controlar esto, elige una lista blanca de consolidación por proyecto — solo las etiquetas elegidas aparecen en el desglose:

En el formulario de Crear/Editar proyecto, usa el selector de Etiquetas de consolidación.
En la página de detalle del proyecto, toca Configurar en la tarjeta Puntos por etiqueta para cambiarlo en línea.
Dejar la selección vacía consolida todas las etiquetas (el comportamiento original), por lo que los proyectos existentes no se ven afectados.

Configurar las etiquetas de consolidación solo cambia lo que el desglose muestra — nunca cambia los puntos o costos totales del proyecto, que siempre se suman a partir de cada lista vinculada.

Gastos

Más allá de la estimación de mano de obra basada en el esfuerzo, puedes registrar gastos reales en un proyecto —materiales, equipo, subcontratistas, etc.— para que la columna de costo refleje el dinero real gastado, no solo la mano de obra estimada.

La sección de Gastos se ubica entre la tarjeta Puntos por etiqueta y las listas de tareas en la página de detalle del proyecto. Cada gasto tiene:

Campo	Notas
Descripción	Para qué fue el gasto (obligatorio).
Importe	Cantidad en dólares (obligatorio).
Categoría	Una categoría codificada por color. Cuatro vienen integradas —Materiales, Equipo, Subcontratista, Otro— y puedes agregar las tuyas (ver abajo). (No hay categoría “Mano de obra” — la mano de obra de tu cuadrilla ya se mide con los puntos de esfuerzo; la mano de obra externa que pagas va en Subcontratista.)
Fecha	Cuándo se incurrió (por defecto hoy).
Recibo	Una foto o PDF opcional del recibo, adjunto por gasto.

La suma de todos los gastos se muestra como la línea de Gastos en la columna de costo, y se suma a la estimación de mano de obra para dar un Total. Los gastos también aparecen en el informe Costos del proyecto.

Categorías de gasto personalizadas. Las cuatro categorías integradas encajan con trabajos de estilo construcción, pero no todos los negocios gastan igual — un servicio de catering registra Local, Comida y bebida, y Personal en su lugar. Al registrar o editar un gasto, abre el selector de Categoría y elige una categoría existente o escribe un nombre nuevo y elige un color para crear una al instante. Las categorías personalizadas se guardan en tu cuenta y aparecen en el selector para cada gasto futuro, codificadas por color en el desglose de gasto por categoría. Las cuatro categorías integradas son predeterminadas compartidas y no se pueden renombrar ni eliminar. Cualquiera que pueda agregar gastos (el permiso Costos del proyecto de gestión) puede crear categorías nuevas.

Quién puede usarlo: ver los gastos requiere el permiso Costos del proyecto (lectura); agregar o editar gastos y crear categorías requiere el nivel de gestión de ese permiso. Solo Root lo tiene por defecto — otórgalo a Admin o a un rol personalizado para darles acceso a otros. Los recibos son parte del gasto, así que funcionan tanto si la función general de Adjuntos está activada como si no.

Notificaciones

Evento	Quién recibe la notificación
Asignado como gerente de proyecto	El miembro recién asignado (en la app + push)
Quitado como gerente de proyecto	El miembro asignado previamente (en la app + push)

Las notificaciones no se envían cuando un administrador se asigna a sí mismo como gerente de proyecto, ni cuando se quita a sí mismo. Al tocar una notificación de gerente de proyecto se navega directamente a la página de detalle del proyecto.

Archivar proyectos

Los proyectos se pueden archivar en lugar de eliminar. Archivar quita un proyecto de la lista de proyectos activos sin perder ningún dato — todas las listas de tareas vinculadas, el historial de puntos y las cifras de costos se conservan.

Cómo archivar: desde la página de la lista de proyectos, toca el menú ⋯ en la tarjeta de un proyecto y elige Archivar proyecto. Desde la página de detalle del proyecto, usa el botón Archivar en las acciones de la barra lateral. Ambos muestran una confirmación antes de ejecutarse.

Opción en cascada: la confirmación de archivar incluye un interruptor opcional: Archivar también todas las listas activas (N). Cuando está activado, todas las listas de tareas activas vinculadas al proyecto se archivan al mismo tiempo. Está desactivado por defecto. Las listas que ya estaban archivadas antes de archivar el proyecto no se ven afectadas.

Ver proyectos archivados: abre Filtros en la barra de herramientas de la página de Proyectos y elige Archivados en Estado para cambiar a la vista de archivados. Las tarjetas de proyectos archivados muestran un borde izquierdo discontinuo, un título en cursiva y texto atenuado para distinguirlas de los proyectos activos.

Desarchivar: desde la vista de archivados, toca ⋯ en la tarjeta de un proyecto y elige Desarchivar proyecto, o usa el botón Desarchivar en la barra lateral de la página de detalle. Se muestra una confirmación. La confirmación de desarchivar también incluye un interruptor opcional: Desarchivar también todas las listas archivadas (N). Cuando está activado, todas las listas archivadas vinculadas al proyecto se restauran a activas. Está desactivado por defecto — las listas también se pueden desarchivar individualmente desde la página de listas de tareas.

Totales de puntos y costos: archivar una lista de tareas que pertenece a un proyecto no la quita de los totales del proyecto. Todas las listas siempre contribuyen a las consolidaciones de puntos y costos sin importar su estado de archivo. Esto garantiza que los proyectos archivados conserven cifras históricas precisas.

Informes

Hay dos tipos de informes disponibles cuando reporting_enabled y projects_enabled están ambos activados:

Informe	Acceso	Qué muestra
Resumen del proyecto	Root, Admin	Una fila por proyecto: recuento de listas, puntos estimados, puntos ganados, % completado, recuento de atrasadas.
Costos del proyecto	Permiso Costos del proyecto (Root por defecto)	Todos los campos del Resumen del proyecto más: tarifa $/pt, costo estimado, costo ganado, costo restante, gastos y costo total.

Ambos informes aceptan un filtro por rango de fechas. Un proyecto se incluye si su período activo (Fecha de inicio a Fecha de fin) se solapa con el rango seleccionado.

Notas de soporte

El feature flag es por cuenta. Desactivar projects_enabled oculta la sección de Proyectos y el selector de proyecto en los formularios de listas de tareas. Las asociaciones de proyecto existentes se conservan y se restauran cuando el flag se reactiva.
Eliminar un proyecto no elimina las listas de tareas. Borra el vínculo del proyecto en esas listas. Las listas y todas sus tareas quedan intactas.
La unicidad del título es por cuenta. Dos cuentas distintas pueden tener proyectos con el mismo nombre sin conflicto.
El campo de gerente de proyecto es funcional, no solo una etiqueta. El gerente de proyecto asignado puede editar, archivar y eliminar el proyecto aunque no lo haya creado. Solo los miembros que pueden tanto editar proyectos como gestionar cualquier lista de tareas de la cuenta aparecen en el selector de gerente de proyecto — normalmente Admin o Root. Un rol personalizado debe incluir ambas capacidades para calificar.
El seguimiento de costos es opcional. Establecer $/pt en 0 omite la estimación de mano de obra. Los gastos se registran por separado y siguen contribuyendo a las líneas de Gastos y Total incluso cuando $/pt es 0.
Los gastos necesitan el permiso Costos del proyecto. Si alguien no puede ver ni agregar gastos, revisa su rol — ver requiere Costos del proyecto (lectura), y agregar/editar requiere el nivel de gestión. Solo Root lo tiene por defecto.
Las etiquetas de consolidación son solo de visualización. Restringir qué etiquetas se consolidan nunca cambia los puntos o el costo total de un proyecto — solo ordena el desglose de Puntos por etiqueta. Una selección vacía consolida todas las etiquetas.
Puntos de esfuerzo ≠ Puntos de recompensa. Los proyectos usan los Puntos de esfuerzo estimados para las consolidaciones de costos — no los Puntos de recompensa. Ambos campos se establecen de forma independiente en cada tarea. Una tarea puede tener cualquier combinación de valores (p. ej. recompensa alta pero esfuerzo bajo, o al revés).
La advertencia sin puntos aparece cuando alguna lista vinculada tiene tareas con un valor de Puntos de esfuerzo estimados igual a 0. Resuélvela estableciendo puntos de esfuerzo en esas tareas — los Puntos de recompensa no afectan las estimaciones de costos del proyecto.
Los puntos están en vivo. Los puntos estimados y ganados de un proyecto se actualizan en tiempo real a medida que las tareas se completan, agregan o eliminan. No hay un paso de recálculo manual.
Los informes requieren ambos flags. reporting_enabled también debe estar activado para que aparezcan los informes Resumen del proyecto y Costos del proyecto.
Si un proyecto “falta” en la lista, es posible que se haya archivado. Los proyectos archivados solo aparecen cuando se selecciona Archivados en Filtros → Estado en la página de Proyectos.
Archivar un proyecto no se propaga en cascada automáticamente. Las listas permanecen en su estado actual a menos que el usuario active explícitamente el interruptor de cascada en la confirmación de archivar. Las listas siempre se pueden archivar o desarchivar de forma independiente desde la página de listas de tareas.
Las listas archivadas siguen contando en los totales del proyecto. Las consolidaciones de puntos y costos siempre incluyen todas las listas vinculadas sin importar el estado de archivo, así que las cifras históricas de los proyectos archivados siguen siendo precisas.
El selector de proyecto solo muestra proyectos activos. Si un Admin informa que un proyecto no aparece como opción al crear o editar una lista de tareas, revisa si ese proyecto ha sido archivado.