Tarea / Proyecto — Gestión Operativa del Equipo — Cómo Quaza organiza tareas internas, proyectos y flujos del equipo
Esta wiki explica el módulo Tarea/Proyecto — para gestionar el trabajo interno del equipo (no confundir con CRON de Tareas Financieras).
Pantalla "Tarea" — listado central
Visión general — el módulo Tarea/Proyecto
OJO: este módulo (
page/tarefa/) es para
gestión operativa interna — proyectos, fluxos de trabajo, tareas del equipo.
No confundir con
Tareas Financieras
(CRON automático).
CICLO COMPLETO — VISIÓN DETALLADA
──────────────────────────────────
┌─────────────────────────────────────────────┐
│ INICIALIZACIÓN │
│ • Configuración validada │
│ • Permisos definidos por rol │
│ • Equipo entrenado en las operaciones │
│ • Procedimientos documentados │
└─────────────────────┬───────────────────────┘
▼
┌─────────────────────────────────────────────┐
│ OPERACIÓN RECURRENTE │
│ • Input por operador, API o cron │
│ • Validación automática │
│ • Persistencia transaccional │
│ • Log de auditoría (timestamp + usuario) │
│ • Notificaciones por email/Slack/webhook │
└─────────────────────┬───────────────────────┘
▼
┌─────────────────────────────────────────────┐
│ ACOMPAÑAMIENTO │
│ • Dashboard con KPIs en tiempo real │
│ • Alertas configuradas para excepciones │
│ • Reporte periódico (diario/semanal) │
│ • Análisis de tendencias │
└─────────────────────┬───────────────────────┘
▼
┌─────────────────────────────────────────────┐
│ REVISIÓN Y MEJORA │
│ • Auditoría mensual de inconsistencias │
│ • Análisis de cuellos │
│ • Ajuste de configuración │
│ • Entrenamiento continuo del equipo │
└─────────────────────────────────────────────┘
Una tarea tiene Cliente, Responsable, Sector, Prioridad, Situación, Previsión. Puede pertenecer a un Proyecto (agrupador). Un Fluxo genera N tareas en secuencia (batch).
Glosario
| Término |
Significa |
| Tarea |
Unidad de trabajo con título, responsable, cliente, situação, previsão. |
| Proyecto |
Agrupador de tareas con valor, prazo, panel Kanban. |
| Fluxo |
Plantilla de tareas en secuencia. Se "ejecuta" para un cliente y crea N tareas con prazos relativos. |
| FluxoItem |
Cada paso del fluxo: nombre tarea, días de prazo, tiempo estimado, tipo. |
| Situação |
Estado configurable (ej. Pendente, Andamento, Concluído). Cada uno tiene cor + importância (orden). |
| Sector |
Equipo/área responsable (Comercial, Soporte, Técnico, etc.). |
| Prioridad |
Nivel (Baja, Media, Alta, Urgente) con cor. |
| Movimento |
Registro de tiempo trabajado en una tarea (início, fim, duración). |
| Painel |
Tablero Kanban — agrupa tareas/proyectos visualmente. |
| Histórico Situação |
Auditoría de cambios de situação (de→para, quién, cuándo). |
Pantallas
| Pantalla |
Para qué sirve |
| Tarea |
CRUD completo de tareas individuales. |
| Lista |
Listado agrupado por proyecto o situação. |
| Calendario |
Visualización temporal con filtros (responsable, proyecto, sector). |
| Painel |
Configuración de Kanban (nombre + situación). |
| Proyecto |
Agrupador con cliente, valor, prazo. |
| Fluxo |
Define plantilla; al ejecutar, genera N tareas para un cliente. |
| Fluxo Item |
Pasos del fluxo (nombre, prazo en días, tiempo estimado). |
| Situação |
Catálogo de estados con cor + ordem. |
| Prioridade |
Catálogo de prioridades con cor. |
| Sector |
Áreas/equipos responsables. |
| Tipo |
Tipos de tarea (catálogo libre). |
| Movimento |
Tiempo trabajado por tarea. |
| Repositorio |
Referencias a repos Git/SVN (con caminho, usuário, senha). |
Flujo: Fluxo automático y movimentación manual
A) Fluxo automático
1 Admin crea un Fluxo con N FluxoItem (cada uno con prazo en días desde el início).
2 Usuario abre "Ejecutar Fluxo" → selecciona Cliente + Data de Início.
3 Sistema crea:
- (opcional) Proyecto agrupador — si
criarProjeto=1
- (opcional) Tarea padre — si
criarTarefaPai=1
- N tareas, una por FluxoItem, con previsão = data_inicio + dias_prazo
B) Movimentación manual
Cambias situacao en la tarea → sistema registra en HistoricoSituacao (de→para, alterador, fecha).
Tiempo trabajado: al salir de situação "Andamento" (importância=30), registraTempo() calcula tempoRealizadoSegundos usando horario 8h-17h, descontando 1.5h de almuerzo.
Integraciones
-
Cliente:
idCliente obrigatório en Tarea y Proyecto.
-
CRM (Oportunidad): Tarea puede vincularse a
idOportunidade.
-
Chat: Tarea puede tener
idConversa para discusión interna.
-
ElementMe (notificaciones): Cambios de situação disparan notificaciones.
-
Repositorio: Vincula tareas a commits de código (Git/SVN).
PADRÓN OPERACIONAL — FLUJO COMÚN
─────────────────────────────────
1. Cadastro inicial / configuración
│
▼
2. Permisos definidos por rol
│
▼
3. Operación normal:
┌──────────────────────────────────┐
│ - input del operador / cron │
│ - validación automática │
│ - persistencia en la BD │
│ - log de auditoría │
│ - notificación (si aplica) │
└──────────────┬───────────────────┘
│
▼
4. Revisión / supervisión
│
┌──────┴──────┐
▼ ▼
OK normal Desvío detectado
│ │
▼ ▼
Histórico Acción correctiva +
alerta al supervisor
CICLO OPERACIONAL — DETALLADO
────────────────────────────────
Fase 1 — Preparación
┌────────────────────────────────────┐
│ Configuración validada │
│ Permisos atribuidos │
│ Equipo entrenado │
└──────────────┬─────────────────────┘
▼
Fase 2 — Operación
┌────────────────────────────────────┐
│ Input (operador / API / cron) │
│ Validación automática │
│ Persistencia │
│ Log de auditoría │
│ Notificaciones (email/webhook) │
└──────────────┬─────────────────────┘
▼
Fase 3 — Acompañamiento
┌────────────────────────────────────┐
│ Dashboard actualizado │
│ Alertas de excepción │
│ Reporte periódico │
└──────────────┬─────────────────────┘
▼
Fase 4 — Revisión / mejora
┌────────────────────────────────────┐
│ Análisis de KPIs │
│ Identificación de cuellos │
│ Ajuste de configuración │
└────────────────────────────────────┘
Trampas frecuentes
Trampa 1 — No hay fluxo de situação obligatorio: Puedes pasar directamente de "Pendente" a "Concluído" sin pasar por "Andamento". Si quieres workflow estricto, hay que validar manualmente.
Trampa 2 — Días en Fluxo = días corridos: prazoDias del FluxoItem suma días corridos, no días útiles. Si Fluxo de 5 días empieza viernes, vence miércoles (incluyendo fin de semana).
Trampa 3 — Tiempo realizado usa horario fijo: Cálculo usa 8h-17h con almuerzo 12h-13:30. Trabajo fuera de ese horario no se cuenta automáticamente — registrar via Movimento.
Trampa 4 — Repositorio guarda senha en BD: El campo senha del repositorio queda en BD (encriptado en algunos casos). Mejor usar acceso SSH con clave que usuario/senha.
Trampa 5 — Sin SLA automático: Este módulo NO calcula SLA — la
previsão es manual. Para SLA contratual, usar módulo
SLA
.
Galería de pantallas
Tarefa
Projeto
Fluxo
Painel
Calendario
Lista
Situacao
Setor
Preguntas frecuentes
¿Cómo empezar a usar este módulo?
Configure los pre-requisitos listados arriba, haga un teste en ambiente seguro (o con pocos registros), valide con el equipo, y solo después active en producción.
¿Necesito permiso especial para acceder?
Sí. Cada rol (operador/supervisor/admin) tiene permisos distintos. Confirme con el administrador del Quaza.
¿Puedo integrar con sistemas externos?
Vía API REST del Quaza. Webhooks notifican eventos importantes. Consulte el equipo técnico para credenciales.
¿Qué pasa si hay error?
Los logs quedan en el panel de tareas/auditoría. Configure alertas (email/Slack) para fallas críticas — no confíe en nadie mirando log manualmente.
¿Cómo acompañar cambios?
Cada registro tiene histórico (timestamp, usuario, acción). Use el filtro de auditoría para rastrear modificaciones sospechosas.
¿El módulo funciona multi-filial?
Sí — vía centro de costo (filial) atribuido al asiento. Reportes filtran por filial.
Documentos relacionados
-
Tareas Financieras
— CRON automático (no confundir con este módulo)
- Cliente
-
SLA
— para acordos contratuales
-
Chat
— conversación interna por tarea
-
CRM
— Oportunidad y tareas comerciales
Preguntas frecuentes
¿Puedo tener mismo Fluxo para diferentes clientes?
Sí, eso es el propósito — plantilla reutilizable. Cada ejecución genera tareas nuevas con previsiones específicas.
¿Cómo veo tareas en mora?
En la pantalla "Lista" con filtro previsao < hoy AND situacao != Concluído.
¿Diferencia con Tareas Financieras?
Tareas Financieras = CRON del sistema (rodam sozinhas). Este módulo = trabajo del equipo (humano).
¿Tiene Kanban funcional?
Existe Painel pero el drag-drop entre situaciones depende del frontend — no consegui inferir si está implementado o sólo es visualización.