AchieveApex: app operations
Generado desde
achieveApex-Frontend/public/ai-docsel 2026-10-15. Contiene 58 archivos de la appoperations. Para el contexto general del producto verapex-resumen.md.
Operations
Proyectos, tareas, equipos y OKRs.
- Etapa: Produccion
- Landing:
/{orgId}/operations/tasks
Modulos
| Modulo | Slug | Estado | Proposito |
|---|---|---|---|
| Proyectos | proyectos |
shipped | Workspaces con tasks, scope, roadmap, docs y miembros. |
| My Tasks | my-tasks |
shipped | Hub de tareas cross-project. |
| Teams | teams |
shipped | Equipos de operaciones. |
| Strategy / OKRs | strategy-okrs |
shipped | Estrategias, ciclos, objetivos y key results. |
| Reports | reports |
shipped | Reportes de operaciones. |
Funcionalidades internas
52 funcionalidades documentadas en 5 modulos. Ver la tabla de cada modulo.
id: my-tasks app: operations nombre: Mis tareas estado: shipped permiso: can_access_tasks
Mis tareas
Hub transversal para consultar y ejecutar tareas de proyectos, de una persona o de un equipo.
Para que sirve
- Una consultora permite a cada especialista concentrar los compromisos de varios clientes en una sola vista personal.
- Una agencia revisa la carga de un equipo y redistribuye tareas vencidas antes de afectar una entrega.
- Un equipo de implementación coordina bloqueos, subtareas, comentarios y responsables para cerrar un despliegue.
- Un estudio profesional sigue tareas por proyecto, hito y prioridad sin separar el trabajo operativo de su contexto.
Que lo hace diferente
- Reúne tareas de Projects y tareas que ejecutan resultados clave de Strategy / OKRs.
- Las asignaciones se apoyan en miembros de proyectos y equipos, y actualizan My Tasks, Workload y Reports.
- Las tareas alimentan progreso de proyecto, hitos, bitácora de actividad y reportes de cumplimiento.
- Nova y el MCP de AchieveApex pueden crear, consultar y actualizar tareas, dependencias, comentarios y asignaciones.
Acceso
- Ruta principal:
/[orgId]/operations/tasks - Como se llega:
Operations sidebar > My Tasks. - Permiso requerido:
can_access_tasks; las acciones respetan permisos de Tasks para todos o tareas propias.
Alcance tecnico
- Frontend:
operations/tasks, tablero de tareas y panel/detalle. - Backend:
ops-project-tasks,ops-tasks, statuses, listas, assignees, comments, dependencies, attachments y activities. - Integraciones externas: notificaciones de asignación.
Funcionalidades internas
| Funcionalidad | Archivo | Resumen |
|---|---|---|
| Hub cross-project | cross-project-hub.md | Consulta tareas propias, de una persona o equipo. |
| Crear y editar tareas | task-management.md | Gestiona atributos y programación. |
| Vistas de tareas | task-views.md | Alterna List, Kanban, Calendar, Timeline, Swimlane y Workload. |
| Buscar, filtrar y agrupar | task-filtering.md | Reduce y organiza el conjunto visible. |
| Acciones masivas | bulk-task-actions.md | Actualiza o elimina tareas seleccionadas. |
| Subtareas | subtasks.md | Crea, completa y elimina tareas hijas. |
| Asignación | task-assignees.md | Asigna miembros y notifica cambios. |
| Estados e hitos | task-statuses-milestones.md | Define estados y vincula tareas a hitos. |
| Comentarios | task-comments.md | Conversaciones con respuestas en hilo. |
| Dependencias | task-dependencies.md | Conecta bloqueos y relaciones. |
| Actividad | task-activity.md | Consulta la bitácora de cambios. |
| Adjuntos | task-attachments.md | Consulta y elimina adjuntos existentes. |
Relaciones
- Depende de: Projects y Teams.
- Usado por: Reports, Project Tasks y Strategy / OKRs.
Limitaciones y notas
My Taskses el destino por defecto al abrir Operations.- La carga de archivos desde
AttachmentsmuestraComing soon; solo pueden abrirse o eliminarse adjuntos existentes. - El panel lateral no administra dependencias; están únicamente en la página completa de tarea.
id: bulk-task-actions modulo: my-tasks app: operations nombre: Acciones masivas de tareas tipo: accion
Acciones masivas de tareas
Actualiza varias tareas seleccionadas desde List view.
Que se logra
- Resultado: aplica una decisión operativa a varias tareas sin editarlas una por una.
- Caso de uso: un líder de implementación reasigna y cambia la fecha de todas las tareas afectadas por un retraso del cliente.
- Se combina con: filtros, estados e hitos, asignación y actividad.
Donde esta
- Ruta:
/[orgId]/operations/projects/[projectId]/tasks - Acceso en UI:
List > task checkboxes > bulk actions bar. - Componente(s):
BulkTaskActions.tsx.
Como funciona
- En
List, selecciona una o varias filas;Shift+clickpermite rangos. - Actualiza Status, Priority, Assignees, Milestone o Due date.
- Selecciona
Deletey confirma para eliminar las tareas.
Reglas y validaciones
- La asignación masiva reemplaza los asignados existentes; aplicar una selección vacía los elimina.
- La eliminación es soft-delete.
Backend
- Servicios:
ops-project-tasks(patch/remove),ops-task-assignees(create/remove).
Relaciones
- Requiere: Task management.
- Dispara / afecta: Activity y Project progress.
id: cross-project-hub modulo: my-tasks app: operations nombre: Hub transversal de tareas tipo: vista
Hub transversal de tareas
Concentra tareas de varios proyectos según una persona o equipo seleccionado.
Que se logra
- Resultado: ofrece una cola única de trabajo para una persona o equipo aunque sus tareas pertenezcan a proyectos distintos.
- Caso de uso: una consultora revisa las tareas de un consultor asignado a varias implementaciones y prioriza su jornada.
- Se combina con: equipos, asignación de tareas y vistas de tareas.
Donde esta
- Ruta:
/[orgId]/operations/tasks - Acceso en UI:
Operations sidebar > My Tasks. - Componente(s):
TaskViewAsPicker.tsx,ProjectTasksBoard.tsx.
Como funciona
- Abre
My Tasks. - En
View as, escoge tus tareas, otro miembro o un equipo. - Activa
Group by projectpara ver secciones plegables por proyecto. - Abre el enlace de una sección para continuar en las tareas de ese proyecto.
Reglas y validaciones
- Solo aparecen tareas cuando la persona o equipo está asignada mediante
ops-task-assignees. - El filtro de asignado se oculta porque
View asya determina ese alcance.
Backend
- Servicios:
ops-project-tasks,ops-task-assignees,ops-teams,ops-team-members(find).
Relaciones
- Requiere: Projects y Teams.
- Dispara / afecta: abre Project Tasks.
id: subtasks modulo: my-tasks app: operations nombre: Subtareas tipo: accion
Subtareas
Organiza trabajo hijo bajo una tarea principal mediante una lista de verificación.
Que se logra
- Resultado: descompone una tarea en pasos controlables sin perder la relación con el trabajo principal.
- Caso de uso: un estudio de arquitectura separa las revisiones de un plano en subtareas antes de marcar completa la entrega.
- Se combina con: gestión de tareas, vistas y actividad.
Donde esta
- Ruta:
/[orgId]/operations/projects/[projectId]/tasks/[taskId] - Acceso en UI:
Task detail > Subtasks. - Componente(s):
TaskSubtasks.tsx.
Como funciona
- Escribe en
Add subtask...y confirma. - Marca la casilla para completar o usa su selector de estado.
- Pasa el cursor sobre la fila y selecciona el icono de papelera para eliminarla.
Reglas y validaciones
- Las subtareas se numeran con el prefijo del proyecto.
- La eliminación pide confirmación y realiza soft-delete.
- La opción global de subtareas define si se ocultan, anidan o muestran separadas.
Backend
- Servicios:
ops-project-tasks(find/create/patch/remove).
Relaciones
- Requiere: Task management.
- Dispara / afecta: List, Timeline y Swimlane.
id: task-activity modulo: my-tasks app: operations nombre: Actividad de tarea tipo: vista
Actividad de tarea
Muestra en orden reciente los cambios relevantes de una tarea.
Que se logra
- Resultado: aporta una bitácora verificable de quién cambió qué y cuándo durante la ejecución.
- Caso de uso: una consultora revisa si una fecha o asignación fue modificada antes de analizar un retraso.
- Se combina con: comentarios, gestión de tareas y Activity Timeline.
Donde esta
- Ruta:
/[orgId]/operations/projects/[projectId]/tasks/[taskId] - Acceso en UI:
Task detail > Activity. - Componente(s):
TaskActivityLog.tsx.
Como funciona
- Abre una tarea en panel o página completa.
- Selecciona
Activity. - Consulta creación, cambios de estado, prioridad, fechas, asignados, lista, título, descripción y comentarios.
Reglas y validaciones
- Las marcas de tiempo usan la zona horaria de organización.
Backend
- Servicios:
ops-task-activities(find),ops-project-tasksyops-task-assignees.
Relaciones
- Requiere: Task management.
- Dispara / afecta: Activity Timeline report.
id: task-assignees modulo: my-tasks app: operations nombre: Asignación de tareas tipo: accion
Asignación de tareas
Asocia uno o varios miembros de proyecto a una tarea y comunica la nueva asignación.
Que se logra
- Resultado: establece responsables claros y hace aparecer el trabajo en las vistas personales y de capacidad.
- Caso de uso: una consultora asigna una configuración a analista y líder técnico, quienes reciben el contexto dentro de
My Tasks. - Se combina con: miembros de proyecto, equipos, carga de trabajo y notificaciones.
Donde esta
- Ruta:
/[orgId]/operations/projects/[projectId]/tasks/[taskId] - Acceso en UI:
Task detail > Assignees. - Componente(s):
TaskAssigneesSelect.tsx.
Como funciona
- Abre la tarea y selecciona
Assignees. - Escoge o desmarca miembros del proyecto.
- Guarda el cambio; la tarea aparece en My Tasks de la persona o equipo pertinente.
Reglas y validaciones
- Solo aparecen usuarios que pertenecen simultáneamente a organización y proyecto.
- Los cambios generan actividad y pueden enviar notificación de asignación.
Backend
- Servicios:
ops-task-assignees(find/create/remove),ops-project-members(find). - Efectos: registra actividad y notifica asignaciones.
Relaciones
- Requiere: Project Members.
- Dispara / afecta: My Tasks, Workload y Reports.
id: task-attachments modulo: my-tasks app: operations nombre: Adjuntos de tarea tipo: vista
Adjuntos de tarea
Lista archivos ya asociados a una tarea y permite abrirlos o quitarlos.
Que se logra
- Resultado: permite consultar o retirar los archivos ya vinculados a una tarea.
- Caso de uso: un equipo de implementación abre un archivo de referencia adjunto antes de ejecutar una configuración.
- Se combina con: gestión de tareas y duplicación de proyectos cuando se habilita copiar adjuntos.
Donde esta
- Ruta:
/[orgId]/operations/projects/[projectId]/tasks/[taskId] - Acceso en UI:
Task detail > Attachments. - Componente(s):
TaskAttachments.tsx.
Como funciona
- Abre la tarea y elige
Attachments. - Haz clic en un archivo para abrir su URL.
- Usa la papelera para eliminar un adjunto.
Reglas y validaciones
Uploadactualmente solo muestra un avisoComing soon; no carga archivos.
Backend
- Servicios:
ops-task-attachments(find/remove).
Relaciones
- Requiere: Task management.
- Dispara / afecta: duplicación de proyectos cuando se activa la opción de copiar adjuntos.
id: task-comments modulo: my-tasks app: operations nombre: Comentarios de tarea tipo: accion
Comentarios de tarea
Permite discutir una tarea y responder mensajes en hilo.
Que se logra
- Resultado: conserva decisiones y aclaraciones junto al trabajo al que pertenecen.
- Caso de uso: una agencia deja en la tarea los ajustes solicitados por una cuenta para que diseño y gestión trabajen sobre la misma instrucción.
- Se combina con: actividad de tarea y gestión de tareas.
Donde esta
- Ruta:
/[orgId]/operations/projects/[projectId]/tasks/[taskId] - Acceso en UI:
Task detail > Comments. - Componente(s):
TaskComments.tsx.
Como funciona
- Abre la tarea y selecciona
Comments. - Escribe en
Add a comment...y envía. - Selecciona
Replypara responder a un comentario existente.
Reglas y validaciones
- No se envían comentarios vacíos.
- La lista se actualiza en tiempo real con eventos del servicio.
Backend
- Servicios:
ops-task-comments(find/create). - Efectos: crea un registro de actividad.
Relaciones
- Requiere: Task management.
- Dispara / afecta: Task Activity.
id: task-dependencies modulo: my-tasks app: operations nombre: Dependencias de tareas tipo: accion
Dependencias de tareas
Relaciona tareas que bloquean, son bloqueadas o están relacionadas entre sí.
Que se logra
- Resultado: muestra bloqueos y secuencias de trabajo para evitar iniciar tareas sin sus precondiciones.
- Caso de uso: un equipo de implementación marca la configuración del cliente como bloqueo de la capacitación posterior.
- Se combina con: gestión de tareas, subtareas y actividad.
Donde esta
- Ruta:
/[orgId]/operations/projects/[projectId]/tasks/[taskId] - Acceso en UI:
full task page > Dependencies. - Componente(s):
TaskDependencies.tsx.
Como funciona
- Abre la página completa de una tarea.
- En
Dependencies, seleccionaAddy busca otra tarea. - Elige
Blocked byoRelates to. - Usa
Xpara remover una relación.
Reglas y validaciones
- Las tareas ya vinculadas se identifican como
Addedy no se vuelven a agregar. - Esta sección no existe en el panel lateral.
Backend
- Servicios:
ops-task-dependencies(find/create/remove),ops-project-tasks(find).
Relaciones
- Requiere: Task management.
- Dispara / afecta: contexto de ejecución de la tarea.
id: task-filtering modulo: my-tasks app: operations nombre: Buscar, filtrar y agrupar tareas tipo: vista
Buscar, filtrar y agrupar tareas
Reduce el conjunto de tareas y organiza las vistas por atributos operativos.
Que se logra
- Resultado: enfoca la revisión en el trabajo relevante por estado, prioridad, fecha, responsable o proyecto.
- Caso de uso: una agencia filtra las tareas vencidas de una cuenta y las agrupa por responsable para desbloquear la entrega.
- Se combina con: hub transversal, vistas y acciones masivas de tareas.
Donde esta
- Ruta:
/[orgId]/operations/tasks - Acceso en UI:
task toolbar > search,Filters,Subtasks,Group by. - Componente(s):
TaskFilters.tsx,TaskGroupingSelector.tsx,TaskSubtaskVisibilityControl.tsx.
Como funciona
- Busca por texto y elige
Active,CompletedoAll. - En
Filters, combina estado, prioridad y fecha; Project Tasks también permite asignado. - Agrupa por Status, Milestone, Assignee, Priority o Due Date.
- En
Subtasks, usaHide subtasks,Nested in parentoShow as separate tasks.
Reglas y validaciones
- En My Tasks los estados se filtran por categoría; en Project Tasks se muestran estados configurados.
viewysubtasksquedan reflejados en la URL.
Backend
- Servicios:
ops-project-tasks,ops-task-statuses,ops-task-assignees(find).
Relaciones
- Requiere: Task management.
- Dispara / afecta: todas las Task Views.
id: task-management modulo: my-tasks app: operations nombre: Crear y editar tareas tipo: accion
Crear y editar tareas
Crea tareas de proyecto y edita sus datos desde el panel lateral o la página completa.
Que se logra
- Resultado: convierte el plan del proyecto en trabajo asignable, fechable y medible.
- Caso de uso: una agencia divide la entrega de una campaña en tareas con prioridad, responsables y fecha de compromiso con el cliente.
- Se combina con: estados e hitos, asignaciones, dependencias, actividad y reportes.
Donde esta
- Ruta:
/[orgId]/operations/projects/[projectId]/tasks - Acceso en UI:
Tasks > Add task, una fila/tarjeta oOpen full page. - Componente(s):
CreateTaskDialog.tsx,TaskDetailPanel.tsx.
Como funciona
- Crea una tarea desde List, Kanban o Calendar y escribe
Title. - Configura descripción, fechas, prioridad, estado, hito, horas estimadas y asignados.
- Haz clic en la tarea para editarla rápidamente en el panel.
- Abre
Open full pagepara la edición completa.
Campos y opciones
| Campo | Tipo | Obligatorio | Notas |
|---|---|---|---|
Title |
texto | Sí | No admite solo espacios. |
| Descripción | Markdown | No | Se guarda automáticamente. |
| Fechas | fecha | No | Inicio, vencimiento y compromiso del cliente. |
Priority |
selección | No | Urgent, High, Medium, Low o None. |
Estimated Hours |
número | No | Mínimo cero; pasos de media hora. |
Reglas y validaciones
- Crear, editar y eliminar siguen permisos granulares de Tasks.
- El panel lateral muestra el identificador con prefijo y número de tarea.
Backend
- Servicios:
ops-project-tasks(find/get/create/patch/remove). - Efectos: numera tareas, asigna creador, sincroniza fechas y actualiza progreso del proyecto.
Relaciones
- Requiere: Projects, statuses, milestones y Project Members.
- Dispara / afecta: Activity, Reports y Assignment notifications.
id: task-statuses-milestones modulo: my-tasks app: operations nombre: Estados e hitos de tareas tipo: configuracion
Estados e hitos de tareas
Clasifica tareas por estado y las vincula con hitos del proyecto.
Que se logra
- Resultado: traduce el avance diario de tareas en progreso del proyecto y en fases visibles del roadmap.
- Caso de uso: un equipo de implementación agrupa tareas de salida a producción en un hito y mide cuánto falta para cerrarlo.
- Se combina con: roadmap, dashboard, acciones masivas y Deadline Accuracy.
Donde esta
- Ruta:
/[orgId]/operations/projects/[projectId]/tasks - Acceso en UI:
Task detail > StatusyMilestone. - Componente(s):
TaskStatusSelect.tsx,BulkMilestoneSelect.tsx.
Como funciona
- Selecciona una tarea.
- Elige su estado configurado para el proyecto.
- Elige un hito o
No milestone. - Usa las mismas opciones en acciones masivas.
Reglas y validaciones
- Los estados son específicos del proyecto y cuentan con uno predeterminado al crear este.
- Un estado marcado como hecho actualiza la finalización y el progreso del proyecto.
Backend
- Servicios:
ops-task-statuses,ops-task-lists,ops-project-tasks(find/create/patch).
Relaciones
- Requiere: Projects y Roadmap.
- Dispara / afecta: Project progress, dashboard y Reports.
id: task-views modulo: my-tasks app: operations nombre: Vistas de tareas tipo: vista
Vistas de tareas
Presenta el mismo trabajo en seis disposiciones que se guardan en la URL.
Que se logra
- Resultado: permite revisar y actualizar el mismo conjunto de tareas desde la visualización apropiada para planificar, ejecutar o balancear carga.
- Caso de uso: un equipo de implementación usa
Timelinepara ajustar fechas yWorkloadpara detectar sobrecarga por responsable. - Se combina con: filtros, estados e hitos y asignación de tareas.
Donde esta
- Ruta:
/[orgId]/operations/tasksy/[orgId]/operations/projects/[projectId]/tasks - Acceso en UI:
task toolbar > view switcher. - Componente(s):
TaskViewSwitcher.tsxy vistasTask*View.tsx.
Como funciona
- Elige
List,Kanban,Calendar,Timeline,SwimlaneoWorkload. - Comparte la URL para preservar
view. - En List y Kanban reordena o mueve tareas; en Calendar navega
Month,WeekoDay. - En Timeline ajusta fechas arrastrando barras y cambia zoom
D/W/M/Y. - En Swimlane mueve entre celdas de estado; en Workload revisa carga por asignado.
Reglas y validaciones
- Calendar usa la fecha de vencimiento.
- Timeline requiere fecha de inicio o vencimiento para dibujar tareas.
- Agrupación no está disponible en Calendar, Timeline ni Workload.
Backend
- Servicios:
ops-project-tasks(find/patch).
Relaciones
- Requiere: Task filtering y Task management.
- Dispara / afecta: estado, hito, asignado, prioridad o fechas al arrastrar.
id: proyectos app: operations nombre: Proyectos estado: shipped permiso: can_access_projects
Proyectos
Workspaces para planificar y ejecutar trabajo por proyecto. Reúnen tareas, alcance, roadmap, documentos, miembros y vínculos con CRM.
Para que sirve
- Una agencia digital convierte cada
Dealganado en un proyecto con responsable, entregables y fechas comprometidas con el cliente. - Una consultora conserva alcance, documentos y cambios aprobados de una implementación en el mismo workspace que ejecuta el equipo.
- Un estudio de arquitectura organiza hitos, planos y entregables de cada obra, sin perder la relación con la empresa contratante.
- Un equipo de servicios recurrentes genera y sigue los entregables de cada período para detectar compromisos pendientes.
Que lo hace diferente
- Vincula el proyecto con Contacts, Companies, Deals, Invoices y Quotes del CRM; desde esos registros se puede volver al trabajo de entrega.
- Formaliza entregables, documentos de alcance y cambios manuales o generados al modificar el alcance.
- Conecta la ejecución con My Tasks, Teams, Strategy / OKRs y los reportes de plazos y alcance.
- Nova y el MCP de AchieveApex pueden crear y consultar proyectos, tareas, documentos, entregables y cambios de alcance.
Acceso
- Ruta principal:
/[orgId]/operations/projects - Como se llega:
Operations sidebar > Projectso una colección/proyecto del sidebar. - Permiso requerido:
can_access_projects; crear, editar y eliminar respetan permisos granulares de Projects. Los miembrosAdminpueden administrar miembros y archivar su proyecto.
Alcance tecnico
- Frontend: rutas de Projects, workspace del proyecto y
Operations settings. - Backend:
ops-projects, miembros, documentos, entregables, cambios de alcance, hitos, colecciones y duplicación. - Integraciones externas: vínculos con Contactos, Companies, Deals, Invoices y Quotes del CRM.
Funcionalidades internas
| Funcionalidad | Archivo | Resumen |
|---|---|---|
| Crear y editar proyectos | project-management.md | Configura identidad, fechas, visibilidad, colección y CRM. |
| Explorar proyectos | project-browse.md | Busca, filtra y abre workspaces. |
| Dashboard del proyecto | project-dashboard.md | Resume progreso, tareas, miembros, alcance e hitos. |
| Vínculos CRM | project-crm-links.md | Relaciona el proyecto con entidades comerciales. |
| Favoritos | project-favorites.md | Fija proyectos personales en el sidebar. |
| Miembros del proyecto | project-members.md | Agrega usuarios y asigna roles. |
| Documentos de proyecto | project-documents.md | Crea, edita y organiza documentos Markdown. |
| Acceso a documentos | document-access.md | Define quién puede ver, editar y administrar documentos. |
| Entregables | deliverables.md | Define y sigue entregables del alcance. |
| Entregables recurrentes | recurring-deliverables.md | Genera y administra instancias periódicas. |
| Cambios de alcance | scope-changes.md | Registra cambios manuales y automáticos. |
| Documentos de entregable | deliverable-documents.md | Vincula documentos de alcance con entregables. |
| Roadmap e hitos | roadmap-milestones.md | Planifica hitos y tareas en una línea de tiempo. |
| Archivado y restauración | project-archiving.md | Archiva, restaura y elimina proyectos archivados. |
| Colecciones | project-collections.md | Agrupa proyectos y administra miembros. |
| Duplicación de proyecto | project-duplication.md | Previsualiza y copia un proyecto. |
| Templates | project-templates.md | Expone el estado actual de templates. |
Relaciones
- Depende de: My Tasks, Teams, Strategy / OKRs, Contactos, Companies y Deals.
- Usado por: Reports, CRM y el sidebar de Operations.
Limitaciones y notas
- El layout del proyecto expone
Dashboard,Scope,Roadmap,Tasks,DocsyMembers; no existe una pestañaCalendarpropia. - El acceso rápido
Calendarde la página raíz de Operations apunta a/[orgId]/operations/calendar, pero esa ruta no tiene página implementada. Templatesy usarTemplatecomo fuente de duplicación están marcados comoComing soon.
id: deliverable-documents modulo: proyectos app: operations nombre: Documentos de entregable tipo: accion
Documentos de entregable
Vincula documentos Scope of Work del proyecto con un entregable específico.
Que se logra
- Resultado: conecta cada entregable con la evidencia documental de lo que fue acordado para su entrega.
- Caso de uso: un estudio de arquitectura asocia las especificaciones de una fase al entregable correspondiente para revisar el alcance.
- Se combina con: documentos de proyecto, entregables y cambios de alcance.
Donde esta
- Ruta:
/[orgId]/operations/projects/[projectId]/scope/[deliverableId] - Acceso en UI:
deliverable detail > Docs > Link Document. - Componente(s):
DeliverableDocumentsTab.tsx.
Como funciona
- Crea un documento de tipo
Scope of WorkenProject > Docs. - Abre el entregable y selecciona
Docs. - Usa
Link Documentpara asociarlo. - Abre el documento con el enlace externo o desvincúlalo con
X.
Reglas y validaciones
- Solo aparecen documentos
Scope of Workaún no vinculados. - Vincular o desvincular produce un cambio de alcance automático.
Backend
- Servicios:
ops-deliverable-documents(find/create/remove),ops-project-documents(find).
Relaciones
- Requiere: Project Docs y Deliverables.
- Dispara / afecta: Scope Changes.
id: deliverables modulo: proyectos app: operations nombre: Entregables tipo: accion
Entregables
Define y realiza seguimiento de los resultados comprometidos en el alcance de un proyecto.
Que se logra
- Resultado: hace visible qué resultados se prometieron, cuál es su estado y si se entregaron en la fecha comprometida.
- Caso de uso: una agencia registra cada pieza de una campaña como entregable y detecta lo pendiente antes de la fecha de lanzamiento.
- Se combina con: documentos de alcance, cambios de alcance y Scope Compliance.
Donde esta
- Ruta:
/[orgId]/operations/projects/[projectId]/scope - Acceso en UI:
project header > Scope > Create; detalle al seleccionar una fila. - Componente(s):
DeliverableTable.tsx,CreateDeliverableDialog.tsx,EditDeliverableDialog.tsx.
Como funciona
- Crea un entregable con título, descripción y fecha prometida opcionales.
- Busca por título, modifica el estado desde la tabla o abre su detalle.
- En el detalle edita título, descripción, estado y fechas.
- Usa el menú de fila para ver detalle o remover el entregable.
Campos y opciones
| Campo | Tipo | Obligatorio | Notas |
|---|---|---|---|
Title |
texto | Sí | Identifica el entregable. |
Description |
texto largo | No | Editable en el detalle. |
Status |
selección | Sí | Pending, In Progress, Completed o Cancelled. |
| Fechas | fecha | No | Prometida y entregada. |
Reglas y validaciones
- Al completar se puede registrar la fecha entregada; se puede reabrir un entregable completado o cancelado.
- El resumen de progreso cuenta únicamente entregables padre.
Backend
- Servicios:
ops-project-deliverables(find/get/create/patch/remove). - Efectos: registra cambios de alcance al modificar o retirar entregables.
Relaciones
- Requiere: Project Scope.
- Dispara / afecta: Scope Changes y Scope Compliance report.
id: document-access modulo: proyectos app: operations nombre: Acceso a documentos tipo: configuracion
Acceso a documentos
Define acceso explícito de usuarios del proyecto a cada documento.
Que se logra
- Resultado: protege documentos del proyecto y permite compartirlos solo con quienes deben leerlos, editarlos o administrarlos.
- Caso de uso: una consultora deja el alcance visible para el equipo y restringe la edición de notas internas a los responsables.
- Se combina con: miembros y documentos de proyecto.
Donde esta
- Ruta:
/[orgId]/operations/projects/[projectId]/docs - Acceso en UI:
Docs > documento seleccionado > Manage access. - Componente(s):
DocumentAccessEditor.tsx.
Como funciona
- Crea un documento con la lista de acceso inicial o selecciona uno existente.
- Abre
Manage access. - Agrega o ajusta participantes y guarda los cambios.
- Los usuarios sin edición ven el documento identificado como solo lectura.
Reglas y validaciones
- El botón
Manage accesssolo se muestra a quien puede administrar el acceso. - El backend filtra los documentos por la autorización efectiva y enriquece la respuesta con capacidades de vista, edición y administración.
Backend
- Servicios:
ops-project-documents(find/create/patch). - Hooks relevantes: verifica, captura, aplica y filtra listas de acceso.
Relaciones
- Requiere: Project Members.
- Dispara / afecta: lectura y edición en Project Docs.
id: project-archiving modulo: proyectos app: operations nombre: Archivado y restauración de proyectos tipo: accion
Archivado y restauración de proyectos
Oculta proyectos sin perder su trabajo, permite restaurarlos y ofrece eliminación desde el archivo.
Que se logra
- Resultado: retira proyectos terminados de la operación diaria y preserva la posibilidad de recuperar su historial.
- Caso de uso: una consultora archiva una implementación cerrada para limpiar el portafolio activo, sin borrar sus tareas y entregables.
- Se combina con: explorar proyectos, colecciones y reportes.
Donde esta
- Ruta:
/[orgId]/operations/settings/archived-projects - Acceso en UI:
Operations sidebar > Settings > Archived Projects; también desde el menú del encabezado del proyecto. - Componente(s):
ArchivedProjectsTable.tsx, diálogos de archive, restore y delete.
Como funciona
- Desde el proyecto o el selector de activos, confirma
Archive Project. - El proyecto sale del sidebar y de las listas principales.
- En
Archived Projects, seleccionaRestorepara devolverlo a activo. - Owners y admins ven
Deletepara eliminar un proyecto archivado.
Reglas y validaciones
- Archivar preserva tareas y el proyecto puede restaurarse.
- Restaurar establece el proyecto como activo.
- La eliminación está restringida a owners y admins; elimina el proyecto y sus registros relacionados de las superficies de producto.
Backend
- Servicios:
ops-projects(find/patch/remove). - Efectos: al eliminar, el soft-delete se propaga a tareas, hitos, entregables y registros relacionados.
Relaciones
- Requiere: Operations Settings.
- Dispara / afecta: sidebar, Projects y Reports.
id: project-browse modulo: proyectos app: operations nombre: Explorar proyectos tipo: vista
Explorar proyectos
Presenta proyectos en tarjetas y permite encontrarlos por estado o nombre.
Que se logra
- Resultado: localiza rápidamente el workspace correcto entre proyectos activos, completados o archivados.
- Caso de uso: una agencia encuentra los proyectos activos de una cuenta antes de revisar su avance semanal.
- Se combina con: colecciones, favoritos y dashboard del proyecto.
Donde esta
- Ruta:
/[orgId]/operations/projects - Acceso en UI:
Operations sidebar > Projects. - Componente(s):
ProjectCard.tsx,OperationsSidebar.tsx.
Como funciona
- Abre
Projects. - Filtra con
All,Active,ArchivedoCompleted. - Usa la búsqueda por nombre.
- Selecciona una tarjeta para abrir
Tasksdel proyecto. - En el sidebar, busca colecciones y proyectos y despliega una colección.
Reglas y validaciones
- Los proyectos archivados no se muestran en el sidebar principal.
- La visibilidad y los permisos de Projects determinan qué proyectos se pueden consultar.
Backend
- Servicios:
ops-projects(find/get),ops-collections(find),ops-project-favorites(find).
Relaciones
- Requiere: permisos de Projects.
- Dispara / afecta: abre el workspace del proyecto.
id: project-collections modulo: proyectos app: operations nombre: Colecciones de proyectos tipo: configuracion
Colecciones de proyectos
Agrupa proyectos en el sidebar y permite administrar miembros aplicables a esos proyectos.
Que se logra
- Resultado: organiza el portafolio y acelera la incorporación consistente de personas a proyectos relacionados.
- Caso de uso: una agencia agrupa las cuentas de una línea de negocio y añade a su equipo de cuentas a los proyectos existentes y futuros.
- Se combina con: miembros de proyecto, explorar proyectos y archivado.
Donde esta
- Ruta:
/[orgId]/operations/projects - Acceso en UI:
Operations sidebar > Add Collection; iconos de colección para renombrar y administrar miembros. - Componente(s):
CreateCollectionDialog.tsx,RenameCollectionDialog.tsx,CollectionMembersDialog.tsx.
Como funciona
- Crea una colección con nombre, descripción, color e icono.
- Despliega la colección para navegar a sus proyectos.
- Renómbrala o abre el icono de miembros.
- Agrega miembros y activa opcionalmente
Add new members to existing projects.
Reglas y validaciones
- Crear requiere
can_create_collections; editar, archivar y restaurar requierencan_edit_collections. - Los miembros de colección se agregan automáticamente a proyectos nuevos dentro de ella.
- La sincronización opcional agrega miembros nuevos también a proyectos existentes.
- Archivar una colección archiva sus proyectos activos y completados; restaurar la colección no restaura sus proyectos.
Backend
- Servicios:
ops-collections,ops-collection-members,ops-project-members(find/create/patch/remove). - Efectos: sincroniza miembros y estado de archivado de proyectos.
Relaciones
- Requiere: Project Members.
- Dispara / afecta: navegación y archivado de Projects.
id: project-crm-links modulo: proyectos app: operations nombre: Vínculos CRM del proyecto tipo: integracion
Vínculos CRM del proyecto
Relaciona un proyecto con Contact, Company y Deal, y permite consultar relaciones comerciales asociadas.
Que se logra
- Resultado: conserva la trazabilidad entre el trabajo entregado y el cliente, empresa u oportunidad que lo originó.
- Caso de uso: una agencia vincula la producción de una campaña con su
Deal, empresa y presupuesto para que cuentas y operaciones consulten el mismo contexto. - Se combina con: proyectos, Contacts, Companies, Deals, Invoices y Quotes.
Donde esta
- Ruta:
/[orgId]/operations/projects/[projectId]/dashboard - Acceso en UI:
Dashboard > Linked entities. - Componente(s):
ProjectRelatedCRM.tsx,CRMProjectsSection.tsx.
Como funciona
- En
Linked entities, abre la selección de Contact, Company o Deal. - Vincula o desvincula los registros necesarios.
- Con una relación CRM configurada, usa las pestañas
InvoicesoQuotespara enlazar sus líneas al proyecto. - Desde los detalles CRM, abre el acordeón
Projectspara volver al proyecto vinculado.
Reglas y validaciones
- Los selectores de invoices y quotes dependen de que exista primero un vínculo Contact, Company o Deal.
Backend
- Servicios:
ops-projects(patch), servicios CRM relacionados (find).
Relaciones
- Requiere: módulos CRM.
- Dispara / afecta: Projects aparece en Contacts, Companies y Deals.
id: project-dashboard modulo: proyectos app: operations nombre: Dashboard del proyecto tipo: vista
Dashboard del proyecto
Ofrece una lectura rápida de ejecución, equipo, alcance, hitos y vínculos CRM.
Que se logra
- Resultado: identifica el estado operativo y los riesgos de un proyecto sin recorrer cada tarea o documento.
- Caso de uso: un director de implementación revisa tareas vencidas, entregables y cambios de alcance antes de una reunión de seguimiento con el cliente.
- Se combina con: tareas, entregables, cambios de alcance, hitos y vínculos CRM.
Donde esta
- Ruta:
/[orgId]/operations/projects/[projectId]/dashboard - Acceso en UI:
project header > Dashboard. - Componente(s):
ProjectDashboardPage.tsx,DeliverablesPanel.tsx,ScopeChangeTimeline.tsx.
Como funciona
- Abre un proyecto y selecciona
Dashboard. - Revisa total, completadas, en progreso y vencidas de las tareas.
- Consulta el porcentaje de progreso y la vista previa de miembros.
- Revisa entidades CRM, entregables, hitos y cambios de alcance recientes.
Reglas y validaciones
- Un hito es una lista de tareas que tiene fecha de inicio.
- La tarjeta de entregables compacta muestra hasta cinco elementos.
- La línea de cambios de alcance compacta muestra los cinco más recientes.
Backend
- Servicios:
ops-projects,ops-project-tasks,ops-project-members,ops-task-lists,ops-project-deliverables,ops-scope-changes(find/get).
Relaciones
- Requiere: tareas, miembros, entregables e hitos del proyecto.
- Dispara / afecta: enlaza a Scope y a registros CRM.
id: project-documents modulo: proyectos app: operations nombre: Documentos de proyecto tipo: accion
Documentos de proyecto
Centraliza documentos Markdown del proyecto, clasificados como alcance, notas, notas de reunión u otros.
Que se logra
- Resultado: mantiene el conocimiento, acuerdos y documentos de trabajo junto al proyecto que los necesita.
- Caso de uso: un estudio de arquitectura guarda minutas y el documento de alcance de una obra para que el equipo consulte la versión vigente.
- Se combina con: acceso a documentos, entregables y cambios de alcance.
Donde esta
- Ruta:
/[orgId]/operations/projects/[projectId]/docs - Acceso en UI:
project header > Docs. - Componente(s):
DocumentMarkdownEditor.tsx.
Como funciona
- Selecciona
New Document, indica título, tipo y, opcionalmente, acceso inicial. - Encuentra documentos por
RecentsoBy type. - Edita título y contenido en el editor; el contenido se guarda automáticamente tras un breve retraso.
- Cambia entre
MarkdownyCode; el modo de código permitePreview. - Elimina un documento desde su fila cuando tiene permiso para administrarlo.
Campos y opciones
| Campo | Tipo | Obligatorio | Notas |
|---|---|---|---|
| Título | texto | Sí | No admite solo espacios. |
| Tipo | selección | Sí | Scope of Work, Notes, Meeting Notes u Other. |
| Contenido | Markdown | No | Admite formato y archivos/imágenes desde el editor. |
Reglas y validaciones
- Un documento sin permiso de edición es de solo lectura.
- La eliminación y la administración de acceso requieren permiso de administración sobre el documento.
Backend
- Servicios:
ops-project-documents(find/create/patch/remove).
Relaciones
- Requiere: proyecto y sus miembros.
- Dispara / afecta: documentos vinculables a entregables.
id: project-duplication modulo: proyectos app: operations nombre: Duplicación de proyecto tipo: accion
Duplicación de proyecto
Duplica un proyecto mediante una previsualización que permite controlar fechas, estado, personas y contenido copiado.
Que se logra
- Resultado: reutiliza una estructura probada de proyecto y adapta responsables, fechas y contenido antes de crear la copia.
- Caso de uso: una consultora replica la implementación estándar para un nuevo cliente, conservando tareas y dependencias pero reiniciando su ejecución.
- Se combina con: proyectos, tareas, entregables, documentos y vínculos CRM.
Donde esta
- Ruta:
/[orgId]/operations/settings - Acceso en UI:
Operations settings > Project Duplication. - Componente(s):
ProjectDuplicationSettingsPage.tsx.
Como funciona
- En
Source, selecciona un proyecto de origen. - En
Identity, define la identidad destino, fechas, CRM y opciones de copia. - En
People, conserva, limpia o mapea asignados tras usarAnalyze source project. - En
Status, reinicia, conserva o mapea estados. - En
Preview, actualiza la previsualización y confirmaDuplicate project.
Reglas y validaciones
- Solo owners, admins y platform admins acceden al wizard.
- La fuente
Templateestá deshabilitada. - El nombre destino, si se omite, se forma como una copia del nombre fuente.
- La previsualización queda obsoleta después de cambiar la configuración y debe regenerarse.
- Por defecto no se copian elementos completados, documentos, adjuntos, comentarios ni actividad; se pueden activar en opciones.
Backend
- Servicios:
ops-project-duplicate(create),ops-projects, Tasks, statuses, lists, members, deliverables y documentos. - Efectos: crea proyecto activo, estados, tareas, subtareas, dependencias y relaciones seleccionadas; puede desplazar o limpiar fechas.
Relaciones
- Requiere: Projects y usuarios activos de la organización.
- Dispara / afecta: todo el workspace del proyecto destino.
id: project-favorites modulo: proyectos app: operations nombre: Favoritos de proyectos tipo: configuracion
Favoritos de proyectos
Permite fijar proyectos personales para acceso rápido en el sidebar de Operations.
Que se logra
- Resultado: reduce el tiempo para volver a los proyectos que un usuario consulta con frecuencia.
- Caso de uso: una líder de cuentas fija las implementaciones que supervisa para abrirlas desde el sidebar durante la jornada.
- Se combina con: explorar proyectos y colecciones.
Donde esta
- Ruta:
/[orgId]/operations/projects/[projectId]/* - Acceso en UI:
project header > star; resultado enOperations sidebar > Favorites. - Componente(s):
ProjectHeader.tsx,OperationsSidebar.tsx.
Como funciona
- Abre cualquier workspace de proyecto.
- Selecciona la estrella del encabezado para agregar o quitar el favorito.
- Abre la sección
Favoritesdel sidebar y elige el proyecto.
Reglas y validaciones
- La lista es individual para cada usuario.
- Solo contiene proyectos que siguen disponibles para el usuario.
Backend
- Servicios:
ops-project-favorites(find/create/remove).
Relaciones
- Requiere: un proyecto accesible y usuario autenticado.
- Dispara / afecta: navegación del sidebar.
id: project-management modulo: proyectos app: operations nombre: Crear y editar proyectos tipo: accion
Crear y editar proyectos
Crea un proyecto y actualiza su información operativa y sus vínculos comerciales.
Que se logra
- Resultado: convierte un servicio, iniciativa o compromiso comercial en un workspace con responsables, tareas, alcance y fechas.
- Caso de uso: una consultora abre un proyecto al cerrar una implementación y vincula el cliente y el
Dealpara entregar con contexto. - Se combina con: Vínculos CRM, tareas, entregables, hitos y reportes.
Donde esta
- Ruta:
/[orgId]/operations/projects - Acceso en UI:
Projects > Create Project; para editar,project header > project name > Edit project. - Componente(s):
CreateProjectDialog.tsx,EditProjectDialog.tsx.
Como funciona
- Crea el proyecto desde la lista o desde el botón
+de una colección. - Define nombre, colección, tipo, prefijo de tareas, color, visibilidad y fechas.
- Opcionalmente vincula Contact, Company y Deal.
- Al crear, se abre la pestaña
Tasksdel proyecto. - Desde el encabezado se puede modificar la misma información y registrar la fecha de finalización real.
Campos y opciones
| Campo | Tipo | Obligatorio | Notas |
|---|---|---|---|
Name |
texto | Sí | No admite solo espacios. |
Collection |
selección | No | Incluye colecciones activas. |
Project Type |
selección | No | One-off, Recurring o Internal. |
Task Prefix |
texto | No | Se genera desde el nombre si se deja vacío; máximo 10 caracteres en mayúsculas. |
Visibility |
selección | No | Public o Private. |
| Fechas | fecha | No | Inicio, fin interno y compromiso con cliente. |
| CRM | relación | No | Contact, Company y Deal. |
Reglas y validaciones
- Crear requiere permiso
can_create_projects. - Edición y eliminación se limitan a todos o propios según permisos granulares; owners y admins tienen acceso total.
- Al crear se agregan estados de tarea predeterminados y el creador queda como miembro del proyecto.
Backend
- Servicios:
ops-projects(find/get/create/patch/remove). - Efectos: sincroniza fechas de compromiso cuando corresponde, miembros de colección y estados predeterminados.
Relaciones
- Requiere: Colecciones y miembros de organización.
- Dispara / afecta: Tasks, members, dashboard y Reports.
id: project-members modulo: proyectos app: operations nombre: Miembros del proyecto tipo: configuracion
Miembros del proyecto
Controla qué usuarios de la organización pueden participar en un proyecto y con qué rol.
Que se logra
- Resultado: delimita quién puede colaborar y administrar un proyecto, y quién estará disponible para asignar tareas.
- Caso de uso: una consultora incorpora a analistas como
Membery deja a un líder comoAdminen una implementación sensible. - Se combina con: asignación de tareas, documentos y equipos.
Donde esta
- Ruta:
/[orgId]/operations/projects/[projectId]/members - Acceso en UI:
project header > Members. - Componente(s):
ProjectMembersPage.tsx.
Como funciona
- Abre
Membersy busca entre los miembros existentes. - Selecciona
Add Member, escoge uno o varios usuarios de la organización y defineAdmin,MemberoViewer. - Actualiza el rol desde cada fila o elimina al miembro con su menú.
Reglas y validaciones
- Solo owners/admins de la organización o un
Admindel proyecto administran miembros. MemberyViewerpueden ver la lista sin editarla.- Solo se pueden añadir usuarios que pertenezcan a la organización y aún no estén en el proyecto.
Backend
- Servicios:
ops-project-members(find/create/patch/remove),organizations-users(find).
Relaciones
- Requiere: miembros de organización.
- Dispara / afecta: disponibilidad de asignados para tareas.
id: project-templates modulo: proyectos app: operations nombre: Templates de proyecto tipo: vista
Templates de proyecto
Reserva la superficie donde se administrarán templates de proyectos y tareas.
Que se logra
- Resultado: informa que los templates aún no están disponibles y orienta hacia el flujo existente de duplicación.
- Caso de uso: una agencia que necesita repetir una estructura de campaña usa por ahora la duplicación de un proyecto anterior.
- Se combina con: duplicación de proyecto.
Donde esta
- Ruta:
/[orgId]/operations/settings/templates - Acceso en UI:
Operations settings > Templates. - Componente(s):
TemplatesComingSoonSection.tsx.
Como funciona
- Abre
Templatesdesde Operations Settings. - La pantalla muestra
Coming soon. - Usa
Project Duplicationpara copiar un proyecto existente mientras los templates no estén disponibles.
Reglas y validaciones
- No existen acciones de creación, edición ni selección de templates.
Templatetampoco está habilitado como fuente del wizard de duplicación.
Backend
- Servicios: ninguno para templates.
Relaciones
- Requiere: Operations Settings.
- Dispara / afecta: mientras permanece en
Coming soon, dirige a Duplicación de proyecto como alternativa disponible.
id: recurring-deliverables modulo: proyectos app: operations nombre: Entregables recurrentes tipo: automatizacion
Entregables recurrentes
Convierte un entregable en una programación repetitiva y conserva sus instancias por período.
Que se logra
- Resultado: controla compromisos repetitivos mediante instancias individuales con sus propios estados y fechas.
- Caso de uso: una agencia de marketing genera el entregable mensual de optimización para cada período y mide cuáles siguen pendientes.
- Se combina con: entregables, cambios de alcance y Scope Compliance.
Donde esta
- Ruta:
/[orgId]/operations/projects/[projectId]/scope/[deliverableId] - Acceso en UI:
deliverable detail > Recurring; luegoInstances > Add Instance. - Componente(s):
CreateDeliverableDialog.tsx,CreateInstanceDialog.tsx.
Como funciona
- Al crear o editar el entregable, activa
Recurring. - Selecciona
Weekly,Every 2 weeks,MonthlyoQuarterlyy una fecha de inicio. - El sistema crea la primera instancia de inmediato.
- Desde
Instances, crea una instancia para un período y ajusta su fecha prometida si hace falta.
Reglas y validaciones
- La fecha de inicio es obligatoria para un entregable recurrente.
- Una instancia pertenece a un entregable padre y se ve anidada en Scope.
- No se permite duplicar el mismo período para un padre.
- Las instancias tienen sus propios estado y fechas.
Backend
- Servicios:
ops-project-deliverables(create/find/patch). - Efectos: el hook crea automáticamente la instancia vigente al crear el padre; el cron de entregables recurrentes genera las futuras mientras el proyecto esté activo.
Relaciones
- Requiere: Deliverables.
- Dispara / afecta: Scope y Scope Compliance report.
id: roadmap-milestones modulo: proyectos app: operations nombre: Roadmap e hitos tipo: vista
Roadmap e hitos
Muestra un timeline de hitos y tareas planificadas y permite reprogramarlos visualmente.
Que se logra
- Resultado: permite planificar y ajustar la secuencia de hitos y trabajo sin perder las fechas comprometidas.
- Caso de uso: un equipo de implementación reprograma una fase bloqueada y ve el efecto en las tareas del roadmap.
- Se combina con: tareas de proyecto, dashboard y Deadline Accuracy.
Donde esta
- Ruta:
/[orgId]/operations/projects/[projectId]/roadmap - Acceso en UI:
project header > Roadmap. - Componente(s):
ProjectRoadmapBoard.tsx,RoadmapTimeline.tsx,CreateMilestoneDialog.tsx,EditMilestoneDialog.tsx.
Como funciona
- Abre
Roadmap; los hitos son listas de tareas con fecha de inicio. - Filtra hitos
Active,CompletedoAlly elige orden. - Navega al día actual y cambia zoom con
D,W,MoY. - Crea un hito desde
Add Milestone. - Haz clic o arrastra barras para editar o reprogramar hitos; despliega tareas y ajusta sus fechas.
Campos y opciones
| Campo | Tipo | Obligatorio | Notas |
|---|---|---|---|
Name |
texto | Sí al crear | Nombre del hito. |
| Fechas | fecha | Sí al crear | Inicio y fin interno. |
Client Deadline |
fecha | No | Se usa en reportes de precisión. |
Status |
selección | No | Upcoming, Active o Completed. |
Progress |
número | No | Se edita en el hito. |
Reglas y validaciones
- El orden manual es el único que permite arrastrar filas para reordenarlas.
- Arrastrar una barra guarda las nuevas fechas sin abrir el diálogo.
Backend
- Servicios:
ops-task-lists(find/create/patch),ops-project-tasks(find/patch).
Relaciones
- Requiere: Project Tasks.
- Dispara / afecta: dashboard y Deadline Accuracy.
id: scope-changes modulo: proyectos app: operations nombre: Cambios de alcance tipo: accion
Cambios de alcance
Mantiene la bitácora de adiciones, modificaciones y remociones del alcance.
Que se logra
- Resultado: deja evidencia cronológica de cómo cambió lo acordado y por qué, incluso cuando el cambio se genera desde el sistema.
- Caso de uso: una consultora registra una funcionalidad adicional solicitada por un cliente y la distingue del alcance original.
- Se combina con: entregables, documentos de entregable, dashboard y Scope Compliance.
Donde esta
- Ruta:
/[orgId]/operations/projects/[projectId]/scope/[deliverableId] - Acceso en UI:
Scope Changes > Add Scope Change; vista resumida enDashboard. - Componente(s):
DeliverableScopeChangesTab.tsx,ScopeChangeTimeline.tsx,CreateScopeChangeDialog.tsx.
Como funciona
- Abre un entregable y selecciona
Scope Changes. - Selecciona
Add Scope Change. - Registra título, tipo, razón y, opcionalmente, descripción y entregable.
- Revisa el historial; los elementos manuales pueden editarse o eliminarse.
Campos y opciones
| Campo | Tipo | Obligatorio | Notas |
|---|---|---|---|
Title |
texto | Sí | Describe el cambio. |
Change Type |
selección | Sí | Addition, Modification o Removal. |
Reason |
texto largo | Sí | Justificación del cambio. |
Linked Deliverable |
selección | No | Asocia el cambio a un entregable. |
Reglas y validaciones
- Las entradas con etiqueta
Autoson generadas por el sistema y no se editan ni eliminan en UI. - Título y razón son obligatorios.
Backend
- Servicios:
ops-scope-changes(find/create/patch/remove). - Efectos: entregables y vínculos de documentos pueden generar entradas automáticas.
Relaciones
- Requiere: Deliverables.
- Dispara / afecta: dashboard y Scope Compliance.
id: reports app: operations nombre: Reportes de operaciones estado: shipped permiso: can_access_operations
Reportes de operaciones
Analiza ejecución, carga, plazos y alcance de Operations.
Para que sirve
- Una agencia detecta proyectos con tareas vencidas, entregables atrasados o cambios de alcance antes de la reunión con el cliente.
- Una consultora compara la carga y las horas estimadas por miembro para reasignar trabajo.
- Un equipo de implementación evalúa si sus entregas se completan antes, en o después de las fechas comprometidas.
- Un estudio profesional revisa el volumen de actividad y avance del portafolio en un período común.
Que lo hace diferente
- Reporta sobre proyectos, tareas, hitos, entregables y cambios de alcance que se ejecutan dentro de AchieveApex.
- Relaciona cumplimiento de plazos y alcance con los proyectos que pueden estar vinculados a Deals, Contacts y Companies del CRM.
- Usa equipos, miembros, colecciones y proyectos como filtros compartidos con Operations.
- Complementa el seguimiento operativo con OKRs conectados a tareas, en vez de limitarse a tableros aislados.
Acceso
- Ruta principal:
/[orgId]/operations/reports - Como se llega:
Operations sidebar > Reports. - Permiso requerido: acceso a Operations.
Alcance tecnico
- Frontend:
ReportsPage.tsx, filtros y siete pestañas. - Backend:
ops-reporting.
Funcionalidades internas
| Funcionalidad | Archivo | Resumen |
|---|---|---|
| Filtros globales | report-filters.md | Acota todos los reportes. |
| Resumen ejecutivo | executive-summary.md | KPIs y salud del portafolio. |
| Vista de proyectos | projects-overview.md | Progreso, plazos e hitos. |
| Analítica de tareas | task-analytics.md | Estado, prioridad y tendencia. |
| Carga de equipos | team-workload.md | Distribución por miembro. |
| Actividad | activity-timeline.md | Tendencias y feed operativo. |
| Precisión de plazos | deadline-accuracy.md | Desviación de proyectos y tareas. |
| Cumplimiento de alcance | scope-compliance.md | Entregables y cambios de alcance. |
Relaciones
- Depende de: Projects, My Tasks y Teams.
- Usado por: responsables de Operations.
Limitaciones y notas
- El período inicial corresponde a los últimos 30 días.
id: activity-timeline modulo: reports app: operations nombre: Línea de tiempo de actividad tipo: vista
Línea de tiempo de actividad
Visualiza actividad operativa por volumen, tipo y eventos recientes.
Que se logra
- Resultado: permite auditar el ritmo de ejecución y consultar los cambios recientes con su proyecto y tarea de origen.
- Caso de uso: un líder de una agencia verifica qué acciones realizó el equipo en una cartera durante la última semana.
- Se combina con: actividad de tarea, filtros globales y proyectos.
Donde esta
- Ruta:
/[orgId]/operations/reports - Acceso en UI:
Reports > Activity Timeline. - Componente(s):
ActivityTimelineTab.tsx.
Como funciona
- Consulta Activity Volume y Activity by Type.
- Recorre Recent Activity para ver usuario, acción, tarea, proyecto y tiempo relativo.
Backend
- Servicios:
ops-reporting,ops-task-activities(find).
Relaciones
- Requiere: Task Activity.
id: deadline-accuracy modulo: reports app: operations nombre: Precisión de plazos tipo: vista
Precisión de plazos
Evalúa desempeño de fechas comprometidas de proyectos y tareas.
Que se logra
- Resultado: cuantifica si los proyectos y tareas se completan antes, en o después de lo comprometido.
- Caso de uso: una consultora identifica las fases que sistemáticamente se entregan tarde para corregir su planificación futura.
- Se combina con: roadmap, tareas, proyectos y filtros globales.
Donde esta
- Ruta:
/[orgId]/operations/reports - Acceso en UI:
Reports > Deadline Accuracy. - Componente(s):
DeadlineAccuracyTab.tsx.
Como funciona
- Alterna
ProjectsyTasks. - En Projects revisa KPIs, tipos y detalle de fechas.
- En Tasks revisa distribución de finalización y cortes por proyecto o miembro.
Notas
- Las categorías de tareas van desde 3+ días temprano hasta 7+ días tarde.
Backend
- Servicios:
ops-reporting(find).
Relaciones
- Requiere: Projects, My Tasks y Roadmap.
id: executive-summary modulo: reports app: operations nombre: Resumen ejecutivo tipo: vista
Resumen ejecutivo
Presenta KPIs, salud de proyectos, distribución de tareas, entregables y alcance.
Que se logra
- Resultado: ofrece una visión consolidada para detectar qué proyectos requieren atención por avance, entregables o alcance.
- Caso de uso: el director de una consultora revisa el portafolio semanal y prioriza las implementaciones en riesgo.
- Se combina con: filtros globales, proyectos, tareas, entregables y cambios de alcance.
Donde esta
- Ruta:
/[orgId]/operations/reports - Acceso en UI:
Reports > Executive Summary. - Componente(s):
ExecutiveSummaryTab.tsx.
Como funciona
- Revisa proyectos totales/activos, completitud, vencidas, progreso y miembros.
- Consulta entregables, entregas a tiempo y cambios de alcance.
- Analiza salud por proyecto, estados, prioridades y tendencia creada/completada.
Backend
- Servicios:
ops-reporting(find).
Relaciones
- Requiere: filtros, Projects y Tasks.
id: projects-overview modulo: reports app: operations nombre: Vista general de proyectos tipo: vista
Vista general de proyectos
Ordena proyectos y permite expandir sus hitos.
Que se logra
- Resultado: permite comparar el avance y los vencimientos de proyectos e hitos desde una sola lista.
- Caso de uso: una agencia revisa qué campañas próximas a vencer tienen hitos o tareas aún pendientes.
- Se combina con: filtros globales, proyectos y roadmap.
Donde esta
- Ruta:
/[orgId]/operations/reports - Acceso en UI:
Reports > Projects Overview. - Componente(s):
ProjectsOverviewTab.tsx.
Como funciona
- Ordena por Name, Progress, Status o Due Date.
- Expande un proyecto para consultar hitos, progreso y tareas.
- Identifica vencimientos con su etiqueta.
Backend
- Servicios:
ops-reporting(find).
Relaciones
- Requiere: Projects y Roadmap.
id: report-filters modulo: reports app: operations nombre: Filtros globales de reportes tipo: vista
Filtros globales de reportes
Acota todas las pestañas por colección, proyecto, equipo, miembro y período.
Que se logra
- Resultado: compara todos los indicadores sobre el mismo subconjunto operativo y período.
- Caso de uso: una agencia filtra una colección de cuentas y el último mes para preparar una revisión de cartera.
- Se combina con: proyectos, equipos y todas las vistas de reportes.
Donde esta
- Ruta:
/[orgId]/operations/reports - Acceso en UI:
Reports > filter bar. - Componente(s):
ReportFilters.tsx.
Como funciona
- Elige Collection, Project, Team o Member.
- Selecciona un rango: Today, Yesterday, últimos 7/30/90 días, mes actual/anterior o personalizado.
- Usa
Clearpara limpiar filtros de entidad sin cambiar el rango.
Reglas y validaciones
- Cambiar colección limpia Project porque la lista se limita a esa colección.
Backend
- Servicios:
ops-reporting(find),ops-collections,ops-projects,ops-teams(find).
Relaciones
- Dispara / afecta: todas las pestañas de Reports.
id: scope-compliance modulo: reports app: operations nombre: Cumplimiento de alcance tipo: vista
Cumplimiento de alcance
Analiza entregables y cambios de alcance por proyecto.
Que se logra
- Resultado: permite comparar el alcance comprometido con entregables completados y cambios registrados durante el proyecto.
- Caso de uso: una agencia prepara la revisión de una cuenta mostrando qué se entregó a tiempo y qué solicitudes ampliaron el alcance.
- Se combina con: entregables, cambios de alcance, documentos de entregable y filtros globales.
Donde esta
- Ruta:
/[orgId]/operations/reports - Acceso en UI:
Reports > Scope Compliance. - Componente(s):
ScopeComplianceTab.tsx.
Como funciona
- Revisa total, completitud, entregas a tiempo y cambios.
- Compara estados de entregable y adiciones, modificaciones o remociones.
- Consulta cambios por semana, entregables y cambios por proyecto cuando existan datos.
Backend
- Servicios:
ops-reporting(find).
Relaciones
- Requiere: Deliverables y Scope Changes.
id: task-analytics modulo: reports app: operations nombre: Analítica de tareas tipo: vista
Analítica de tareas
Desglosa las tareas por estado, prioridad y evolución temporal.
Que se logra
- Resultado: muestra si el equipo está creando, cerrando o acumulando trabajo y dónde se concentra la prioridad.
- Caso de uso: un equipo de implementación detecta que las tareas urgentes crecen más rápido que las completadas durante un ciclo.
- Se combina con: filtros globales, My Tasks y carga de equipo.
Donde esta
- Ruta:
/[orgId]/operations/reports - Acceso en UI:
Reports > Task Analytics. - Componente(s):
TaskAnalyticsTab.tsx.
Como funciona
- Consulta el gráfico y lista de estados.
- Revisa distribución por prioridad.
- Compara creadas frente a completadas en el período.
Notas
- Los nombres de estado pueden ser personalizados; el gráfico agrega por categoría.
Backend
- Servicios:
ops-reporting(find).
Relaciones
- Requiere: My Tasks y filtros.
id: team-workload modulo: reports app: operations nombre: Carga de equipo tipo: vista
Carga de equipo
Compara volumen, avance, vencimientos y horas estimadas por miembro.
Que se logra
- Resultado: revela desequilibrios de carga y responsables con trabajo vencido o capacidad excedida.
- Caso de uso: una consultora mueve tareas de un especialista sobrecargado a otro miembro antes de comprometer una nueva fecha.
- Se combina con: equipos, asignación de tareas y filtros globales.
Donde esta
- Ruta:
/[orgId]/operations/reports - Acceso en UI:
Reports > Team Workload. - Componente(s):
TeamWorkloadTab.tsx.
Como funciona
- Filtra adicionalmente por
All Teams. - Consulta asignadas, en progreso, completadas, vencidas, tasa y horas.
- Revisa capacidad
Overloaded(>15),Busy(>8) oBalanced. - Observa Assignment Distribution.
Backend
- Servicios:
ops-reporting(find).
Relaciones
- Requiere: Teams y My Tasks.
id: strategy-okrs app: operations nombre: Estrategia y OKRs estado: shipped permiso: can_access_strategy
Estrategia y OKRs
Espacio para definir estrategias, ciclos, objetivos, resultados clave y las tareas que los ejecutan.
Para que sirve
- Una consultora traduce su plan anual en ciclos, objetivos medibles y tareas con responsables.
- Una agencia conecta la meta de retención de clientes con resultados clave y el trabajo que debe ejecutarla.
- Un equipo de implementación actualiza avances y notas para detectar objetivos que requieren intervención.
- Un estudio profesional prioriza iniciativas por ciclo y revisa si su ejecución alcanza la meta definida.
Que lo hace diferente
- Une objetivos y resultados clave con tareas ejecutables que también aparecen en My Tasks.
- Calcula progreso de objetivos y estrategias al cambiar resultados o registrar actualizaciones.
- Los equipos y responsables de la organización se usan en la planeación y ejecución, en lugar de mantener listas separadas.
- Nova y el MCP de AchieveApex pueden crear y consultar objetivos, key results, ciclos y tareas de OKR.
Acceso
- Ruta principal:
/[orgId]/operations/strategy - Como se llega:
Operations sidebar > Strategy. - Permiso requerido:
can_access_strategy; vista, creación, edición y eliminación distinguen registros propios y todos.
Alcance tecnico
- Frontend: lista de estrategias, detalle y árbol de OKRs.
- Backend:
ops-strategies, ciclos, objetivos, grupos, key results, actualizaciones, motivaciones yops-tasks.
Funcionalidades internas
| Funcionalidad | Archivo | Resumen |
|---|---|---|
| Estrategias | strategy-management.md | Crea y consulta programas estratégicos. |
| Ciclos | strategy-cycles.md | Administra períodos simples o por lotes. |
| Grupos de objetivos | objective-groups.md | Filtra objetivos por agrupación. |
| Objetivos | objectives.md | Crea y edita objetivos. |
| Cálculo ponderado | weighted-objectives.md | Configura ponderación de resultados clave. |
| Key results | key-results.md | Mide objetivos con varios tipos de resultado. |
| Progreso | okr-progress-updates.md | Actualiza y consulta el historial de avance. |
| Motivación y factibilidad | objective-context.md | Mantiene contexto cualitativo del objetivo. |
| Árbol de OKRs | okr-tree.md | Navega jerarquía de objetivos, resultados y tareas. |
| Tareas de OKR | okr-tasks.md | Ejecuta tareas dependientes de un key result. |
| Acciones masivas de tareas | okr-task-bulk-actions.md | Actualiza varias tareas del árbol. |
Relaciones
- Depende de: Teams y miembros de organización.
- Usado por: My Tasks y Reports.
Limitaciones y notas
- Las tareas de estrategia usan
ops-tasks; no son Project Tasks. - Componentes alternos de tarjetas y diálogos existen en el código, pero la interfaz actual usa
StrategyTreey paneles laterales.
id: key-results modulo: strategy-okrs app: operations nombre: Resultados clave tipo: accion
Resultados clave
Mide el avance de un objetivo con resultados numéricos, monetarios, booleanos o porcentuales.
Que se logra
- Resultado: hace comprobable el avance de un objetivo mediante una meta y un tipo de medición explícitos.
- Caso de uso: una consultora mide un objetivo de crecimiento con ingresos, cantidad de proyectos y un hito de cumplimiento.
- Se combina con: objetivos, actualizaciones de progreso y tareas de OKR.
Donde esta
- Ruta:
/[orgId]/operations/strategy/[strategyId] - Acceso en UI:
objective row > Add Key Resulto fila de key result. - Componente(s):
EditKeyResultSheet.tsx.
Como funciona
- Agrega o abre un key result.
- Define título, owner, estado, descripción y tipo de medición.
- Según el tipo, configura valores inicial/meta/unidad, completado o porcentaje.
- Guarda para reflejarlo en el árbol.
Reglas y validaciones
- Título y tipo de medición son obligatorios.
- El método de cálculo aplica a Number y Currency.
Backend
- Servicios:
ops-key-results(find/create/patch/remove). - Efectos: actualiza el progreso del objetivo y estrategia.
Relaciones
- Requiere: Objectives.
- Dispara / afecta: Progress Updates y OKR Tasks.
id: objective-context modulo: strategy-okrs app: operations nombre: Contexto del objetivo tipo: configuracion
Contexto del objetivo
Registra motivación, factibilidad y memo como contexto cualitativo del objetivo.
Que se logra
- Resultado: documenta por qué importa una meta, qué tan viable es y qué decisiones la acompañan.
- Caso de uso: una consultora deja los supuestos y riesgos de un objetivo de expansión para que el equipo lo priorice con contexto.
- Se combina con: objetivos, key results y actualizaciones de progreso.
Donde esta
- Ruta:
/[orgId]/operations/strategy/[strategyId] - Acceso en UI:
objective sheet > Motivation,FeasibilityyMemo. - Componente(s):
EditObjectiveSheet.tsx.
Como funciona
- Abre un objetivo.
- Agrega o ajusta elementos de Motivation y Feasibility.
- Escribe el Memo y guarda.
Backend
- Servicios:
ops-objective-motivations,ops-objectives(find/create/patch/remove).
Relaciones
- Requiere: Objectives.
- Dispara / afecta: contexto de planeación del objetivo.
id: objective-groups modulo: strategy-okrs app: operations nombre: Grupos de objetivos tipo: configuracion
Grupos de objetivos
Agrupa y filtra objetivos dentro de una estrategia.
Que se logra
- Resultado: ordena objetivos relacionados y reduce el ruido al revisar una estrategia extensa.
- Caso de uso: una consultora agrupa sus objetivos por líneas de servicio para revisarlas por separado.
- Se combina con: estrategias, ciclos y objetivos.
Donde esta
- Ruta:
/[orgId]/operations/strategy/[strategyId] - Acceso en UI:
strategy detail > Group > +. - Componente(s):
CreateGroupDialog.tsx.
Como funciona
- Pulsa
+junto a Group. - Indica
Group Name. - Selecciona el grupo para mostrar sus objetivos.
Reglas y validaciones
- El nombre es obligatorio.
Backend
- Servicios:
ops-objective-groups(find/create).
Relaciones
- Requiere: Strategies.
- Dispara / afecta: filtro de Objectives.
id: objectives modulo: strategy-okrs app: operations nombre: Objetivos tipo: accion
Objetivos
Define objetivos de una estrategia y sus responsables.
Que se logra
- Resultado: convierte una prioridad estratégica en una meta con responsable, período y resultados medibles.
- Caso de uso: un equipo de implementación fija el objetivo de reducir el tiempo de activación y asigna sus indicadores a un líder.
- Se combina con: ciclos, key results, actualizaciones de progreso y tareas de OKR.
Donde esta
- Ruta:
/[orgId]/operations/strategy/[strategyId] - Acceso en UI:
strategy detail > New Objectiveo menú del objetivo. - Componente(s):
CreateOKRDialog.tsx,EditObjectiveSheet.tsx.
Como funciona
- Selecciona ciclo y grupo opcionales.
- Pulsa
New Objective, escribe objetivo y al menos un key result. - Edita título, descripción, owner, ciclo, grupo, fecha final y memo desde el panel.
Reglas y validaciones
- El ciclo es requerido al editar; el objetivo y el título del key result son obligatorios al crear.
Backend
- Servicios:
ops-objectives(find/create/patch/remove). - Efectos: actualiza el progreso de la estrategia.
Relaciones
- Requiere: Strategy Cycles.
- Dispara / afecta: Key Results y progreso.
id: okr-progress-updates modulo: strategy-okrs app: operations nombre: Actualizaciones de progreso tipo: accion
Actualizaciones de progreso
Registra una nueva medición y notas para un objetivo o key result.
Que se logra
- Resultado: conserva el historial de mediciones y contexto que explica cómo evolucionó una meta.
- Caso de uso: un equipo de implementación actualiza cada semana el avance de activaciones y deja la causa de cualquier desvío.
- Se combina con: objetivos, key results y árbol de OKRs.
Donde esta
- Ruta:
/[orgId]/operations/strategy/[strategyId] - Acceso en UI:
objective/key result row > Update Progress. - Componente(s):
UpdateProgressDialog.tsx,ProgressTimelineDialog.tsx.
Como funciona
- Abre
Update Progress. - Revisa la línea de tiempo anterior.
- Introduce el nuevo valor o marca completado en resultados booleanos.
- Añade nota opcional y confirma.
Reglas y validaciones
- El control se adapta al tipo de medición.
Backend
- Servicios:
ops-objective-updates(find/create),ops-objectives,ops-key-results(patch).
Relaciones
- Requiere: Objectives o Key Results.
- Dispara / afecta: progreso y Strategy Tree.
id: okr-task-bulk-actions modulo: strategy-okrs app: operations nombre: Acciones masivas de tareas OKR tipo: accion
Acciones masivas de tareas OKR
Actualiza varias tareas seleccionadas dentro del árbol.
Que se logra
- Resultado: ajusta en conjunto las tareas que ejecutan una misma parte de la estrategia.
- Caso de uso: una consultora reasigna las tareas de un resultado clave cuando cambia el responsable de la iniciativa.
- Se combina con: tareas de OKR, key results y árbol de OKRs.
Donde esta
- Ruta:
/[orgId]/operations/strategy/[strategyId] - Acceso en UI:
StrategyTree > shift+click tasks > floating toolbar. - Componente(s):
BulkTaskActions.tsx.
Como funciona
- Usa
Shift+clickpara seleccionar tareas. - Cambia estado, asignado o vencimiento, o elimina las tareas.
- Pulsa
EscoXpara limpiar selección.
Reglas y validaciones
ListyTargetse muestran comoComing soon.
Backend
- Servicios:
ops-tasks(patch/remove).
Relaciones
- Requiere: OKR Tasks.
- Dispara / afecta: progreso visible en Strategy Tree.
id: okr-tasks modulo: strategy-okrs app: operations nombre: Tareas de OKR tipo: accion
Tareas de OKR
Ejecuta trabajo asociado a un key result dentro del árbol estratégico.
Que se logra
- Resultado: vincula la ejecución diaria con el resultado clave que debe mejorar.
- Caso de uso: una agencia asigna tareas de optimización a un key result de retención y las consulta junto al resto de su trabajo.
- Se combina con: key results, My Tasks y asignaciones.
Donde esta
- Ruta:
/[orgId]/operations/strategy/[strategyId] - Acceso en UI:
key result > Add Tasko fila de tarea. - Componente(s):
EditTaskSheet.tsx.
Como funciona
- Crea una tarea bajo un key result o abre una existente.
- Edita owner, vencimiento, descripción, valor registrado, tiempo, recurrencia, recordatorio y memo.
- Comparte
?task={taskId}para abrirla directamente.
Reglas y validaciones
- Estas tareas pertenecen a
ops-tasks, no a Project Tasks.
Backend
- Servicios:
ops-tasks(find/create/patch/remove). - Efectos: puede notificar asignación.
Relaciones
- Requiere: Key Results.
- Dispara / afecta: Strategy Tree y My Tasks.
id: okr-tree modulo: strategy-okrs app: operations nombre: Árbol de OKRs tipo: vista
Árbol de OKRs
Navega la jerarquía expandible de objetivos, key results y tareas.
Que se logra
- Resultado: permite seguir desde una estrategia hasta las tareas concretas que impulsan cada resultado clave.
- Caso de uso: una líder de operaciones abre un objetivo atrasado y localiza las tareas pendientes que están frenando su indicador.
- Se combina con: objetivos, key results, tareas de OKR y actualizaciones de progreso.
Donde esta
- Ruta:
/[orgId]/operations/strategy/[strategyId] - Acceso en UI:
strategy detail > Objectives & Key Results. - Componente(s):
StrategyTree.tsx.
Como funciona
- Expande un objetivo para ver resultados y tareas.
- Usa menús de fila para editar, añadir o eliminar.
- Filtra las tareas con
Active,CompletedoAll Tasks.
Reglas y validaciones
- El filtro no elimina tareas.
Backend
- Servicios:
ops-objectives,ops-key-results,ops-tasks(find).
Relaciones
- Requiere: Objectives, Key Results y OKR Tasks.
id: strategy-cycles modulo: strategy-okrs app: operations nombre: Ciclos estratégicos tipo: configuracion
Ciclos estratégicos
Organiza los objetivos en períodos de ejecución.
Que se logra
- Resultado: separa objetivos por períodos comparables para enfocar y revisar la ejecución estratégica.
- Caso de uso: una agencia crea ciclos trimestrales para evaluar metas de crecimiento y retención por trimestre.
- Se combina con: estrategias, objetivos y árbol de OKRs.
Donde esta
- Ruta:
/[orgId]/operations/strategy/[strategyId] - Acceso en UI:
strategy detail > calendar > Manage Cycles. - Componente(s):
CycleManagerDialog.tsx.
Como funciona
- Abre
Manage Cycles. - Crea uno en
Add Singleo varios ciclos quarterly, half-yearly o yearly. - Edita fechas o elimina un ciclo.
- Selecciona un ciclo o
All cyclespara filtrar objetivos.
Reglas y validaciones
- Nombre, inicio y fin son obligatorios.
- No se puede eliminar el último ciclo.
Backend
- Servicios:
ops-strategy-cycles(find/create/patch/remove).
Relaciones
- Requiere: Strategies.
- Dispara / afecta: filtrado y asignación de Objectives.
id: strategy-management modulo: strategy-okrs app: operations nombre: Estrategias tipo: accion
Estrategias
Crea programas estratégicos y abre su workspace de OKRs.
Que se logra
- Resultado: establece un espacio común para medir el avance de una iniciativa estratégica y sus responsables.
- Caso de uso: una consultora crea la estrategia anual de expansión y reúne sus ciclos, objetivos y resultados clave.
- Se combina con: ciclos, objetivos, key results y tareas de OKR.
Donde esta
- Ruta:
/[orgId]/operations/strategy - Acceso en UI:
Strategy > Create Strategy. - Componente(s):
CreateStrategyDialog.tsx,StrategyCard.tsx.
Como funciona
- Selecciona
Create Strategy. - Define
Strategy Name, descripción yOwner. - Confirma y abre la tarjeta para administrar su detalle.
Reglas y validaciones
- Nombre y owner son obligatorios; las estrategias nuevas comienzan activas.
- Aplica
can_access_strategyy permisos propios/todos.
Backend
- Servicios:
ops-strategies(find/get/create/patch/remove). - Efectos: recalcula progreso de la estrategia.
Relaciones
- Dispara / afecta: cycles, objectives y key results.
id: weighted-objectives modulo: strategy-okrs app: operations nombre: Cálculo ponderado de objetivos tipo: configuracion
Cálculo ponderado de objetivos
Permite calcular el avance del objetivo ponderando sus key results.
Que se logra
- Resultado: refleja que algunos resultados clave aportan más que otros al avance total de una meta.
- Caso de uso: una agencia da mayor peso a la renovación de cuentas que a una métrica secundaria dentro de su objetivo de retención.
- Se combina con: objetivos, key results y actualizaciones de progreso.
Donde esta
- Ruta:
/[orgId]/operations/strategy/[strategyId] - Acceso en UI:
objective sheet > Weight. - Componente(s):
EditObjectiveSheet.tsx,EditKeyResultSheet.tsx.
Como funciona
- Abre un objetivo.
- Activa
Weight. - Configura el peso de cada key result al editarlo.
- Guarda para recalcular el avance.
Reglas y validaciones
- Los pesos se configuran en key results; el modo pertenece al objetivo.
Backend
- Servicios:
ops-objectives,ops-key-results(patch). - Efectos: recalcula progreso de objetivo y estrategia.
Relaciones
- Requiere: Objectives y Key Results.
id: teams app: operations nombre: Equipos estado: shipped permiso: can_access_operations
Equipos
Agrupa miembros de organización para visualizar carga de trabajo y filtrar Operations.
Para que sirve
- Una agencia separa diseño, cuentas y desarrollo para revisar el trabajo asignado a cada disciplina.
- Una consultora compara la carga de sus equipos de implementación antes de aceptar una nueva fase.
- Un estudio de arquitectura identifica qué equipo concentra tareas vencidas o demasiadas horas estimadas.
Que lo hace diferente
- Los equipos se usan directamente en
View as teamde My Tasks y en los filtros de Operations Reports. - La carga se calcula sobre tareas reales de Projects y no sobre una planificación aislada.
- Convive con los miembros específicos de cada proyecto, de modo que asignación y capacidad pueden revisarse en conjunto.
Acceso
- Ruta principal:
/[orgId]/operations/team - Como se llega:
Operations sidebar > Team. - Permiso requerido: acceso a Operations.
Alcance tecnico
- Frontend: página y diálogos de Teams.
- Backend:
ops-teamsyops-team-members.
Funcionalidades internas
| Funcionalidad | Archivo | Resumen |
|---|---|---|
| Explorar equipos | team-browse.md | Consulta tarjetas, información y miembros. |
| Crear equipos | team-create.md | Crea un equipo identificado por nombre y color. |
| Editar y eliminar equipos | team-edit-delete.md | Mantiene o retira un equipo. |
| Miembros de equipo | team-members.md | Agrega y elimina miembros de organización. |
Relaciones
- Depende de: miembros de organización.
- Usado por: My Tasks y Operations Reports.
Limitaciones y notas
- La eliminación se ejecuta desde el menú del equipo y no muestra un diálogo de confirmación.
id: team-browse modulo: teams app: operations nombre: Explorar equipos tipo: vista
Explorar equipos
Muestra los equipos de la organización mediante tarjetas con su descripción, color y miembros.
Que se logra
- Resultado: permite identificar equipos y consultar rápidamente quién los compone.
- Caso de uso: una agencia revisa qué personas integran el equipo de diseño antes de filtrar su carga de trabajo.
- Se combina con: My Tasks y Team Workload.
Donde esta
- Ruta:
/[orgId]/operations/team - Acceso en UI:
Operations sidebar > Team. - Componente(s):
TeamsPage.tsx,TeamCard.tsx.
Como funciona
- Abre
Team. - Revisa las tarjetas de equipos y sus avatares.
- Haz clic en la fila de miembros para administrarlos.
Backend
- Servicios:
ops-teams,ops-team-members(find).
Relaciones
- Requiere: miembros de organización.
- Dispara / afecta:
View as teamen My Tasks y filtros de Reports.
id: team-create modulo: teams app: operations nombre: Crear equipos tipo: accion
Crear equipos
Da de alta equipos de Operations con identidad visual y descripción opcional.
Que se logra
- Resultado: crea una unidad de trabajo reutilizable para consultar capacidad y tareas por disciplina o área.
- Caso de uso: una consultora crea el equipo de onboarding para revisar sus implementaciones como grupo.
- Se combina con: miembros de equipo, My Tasks y Team Workload.
Donde esta
- Ruta:
/[orgId]/operations/team - Acceso en UI:
Team > New TeamoCreate your first team. - Componente(s):
CreateTeamDialog.tsx.
Como funciona
- Selecciona
New Team. - Ingresa
Name. - Opcionalmente añade
Descriptiony selecciona un color. - Confirma
Create.
Campos y opciones
| Campo | Tipo | Obligatorio | Notas |
|---|---|---|---|
Name |
texto | Sí | No admite solo espacios. |
Description |
texto largo | No | Contexto del equipo. |
Color |
color | No | Usa uno de los tonos predefinidos. |
Backend
- Servicios:
ops-teams(create).
Relaciones
- Dispara / afecta: Team Members y filtros de Operations.
id: team-edit-delete modulo: teams app: operations nombre: Editar y eliminar equipos tipo: accion
Editar y eliminar equipos
Actualiza la identidad de un equipo o lo elimina desde su tarjeta.
Que se logra
- Resultado: mantiene la estructura de equipos alineada con la operación actual o retira agrupaciones que dejaron de aplicar.
- Caso de uso: una agencia renombra su equipo de contenido tras reorganizar sus servicios y elimina una unidad ya disuelta.
- Se combina con: explorar equipos, My Tasks y filtros de reportes.
Donde esta
- Ruta:
/[orgId]/operations/team - Acceso en UI:
team card > ⋮ > EditoDelete. - Componente(s):
EditTeamDialog.tsx,TeamCard.tsx.
Como funciona
- Abre
⋮en una tarjeta. - Selecciona
Edit, cambia nombre, descripción o color y guarda. - Selecciona
Deletepara retirar el equipo.
Reglas y validaciones
- Editar requiere un nombre no vacío.
- Delete no solicita confirmación y no es reversible desde esta interfaz.
Backend
- Servicios:
ops-teams(patch/remove).
Relaciones
- Dispara / afecta: My Tasks y filtros de Reports dejan de usar el equipo eliminado.
id: team-members modulo: teams app: operations nombre: Miembros de equipo tipo: configuracion
Miembros de equipo
Agrega o retira usuarios de organización dentro de un equipo.
Que se logra
- Resultado: define los grupos con los que se revisa trabajo y capacidad en Operations.
- Caso de uso: una consultora incorpora nuevos analistas al equipo que atenderá las tareas de varias implementaciones.
- Se combina con: equipos, hub transversal de tareas y carga de equipo.
Donde esta
- Ruta:
/[orgId]/operations/team - Acceso en UI:
team card > members row. - Componente(s):
TeamMembersDialog.tsx.
Como funciona
- Selecciona la fila de avatares y miembros.
- En
Current members, usaXpara retirar un usuario. - En
Add members, selecciona usuarios para añadirlos.
Reglas y validaciones
- Solo se muestran usuarios unidos a la organización.
- Un usuario ya incluido no vuelve a aparecer como candidato.
Backend
- Servicios:
ops-team-members(find/create/remove),organizations-users(find).
Relaciones
- Requiere: Teams y miembros de organización.
- Dispara / afecta: My Tasks por equipo y Team Workload.