Conceptos

Conceptos

Organización, proyecto, flujo de estados, perfiles, severidad, horas y documentos.

  • Organización: la empresa cliente. Los datos de una organización nunca aparecen en otra.
  • Plataforma: el equipo de Aquarela que administra tracker. El dueño de la plataforma define lo que cada persona ve o gestiona (empresas, soporte, invitaciones, créditos de IA, registro); una empresa suspendida queda sin acceso hasta que se reactive.
  • Beta: tracker está en beta, con acceso por invitación. El equipo de la plataforma genera la invitación a la beta (create_beta_invite, POST /beta-invites); quien la usa crea la cuenta y su propia empresa, y la invitación registra quién invitó a quién.
  • Proyecto: tiene un prefijo (ej.: MOB) usado en el código de las issues (MOB-0001), y sus propios tipos de issue, etiquetas, módulos y campos personalizados.
  • Flujo de estados: cada proyecto tiene sus estados, cada uno en un grupo (todo, in_progress, done), con los perfiles que pueden mover issues a él y desde qué estados puede venir. Los proyectos empiezan con la plantilla Software + QA (Triaje, Por hacer, Haciendo, En revisión, En prueba, Hecho, Cancelado), la plantilla Software (Por hacer, Haciendo, En revisión, Hecho) o la plantilla QA (Borrador, Abierto, Triaje, Priorizado, En desarrollo, Listo para QA, En retest, Aprobado, Rechazado, Completado y Cerrado). "Abierta" es todo lo que no está en el grupo done.
  • Retest: QA registra el resultado con versión y dispositivo. En Software + QA, aprobar lleva a Hecho y rechazar devuelve a Por hacer con la marca de rechazada (retest_failed), hasta que pase; en la plantilla QA, va a Aprobado o Rechazado.
  • Cerrado (plantilla QA): un solo estado para lo que se cierra sin resolverse, con el motivo (close_reason: duplicada, cancelada, no reproducida o no se hará).
  • Bloqueo: una marca en la issue, con el motivo, que vale en cualquier estado y flujo (no es una columna). Filtra con blocked_only o bloqueio = sim en la consulta avanzada.
  • Los proyectos creados antes de estos flujos siguen con los estados anteriores (En retest, Aprobado, Rechazado, Bloqueado, Reabierto, Duplicado...) hasta que alguien pide "Simplificar el flujo" en Configuración > Flujo de estados.
  • Severidad: S1 (crítica) a S4 (baja), impacto técnico. Prioridad: urgent, high, medium, low, importancia de negocio.
  • Horas: cada issue tiene estimación, inicio y plazo, y registros de horas (quién, día, cuánto, qué hizo). Restante = estimación menos lo registrado. Duración en texto: "2h", "1h30", "45m", "1d" (8 h).
  • Documentos: la base de conocimiento de la empresa (manuales, reglas de negocio, preguntas frecuentes, procesos), en markdown, de toda la empresa o de un proyecto. El borrador (draft) solo lo ve quien edita; internal vale para el equipo (admins y quien es PO/PM, QA o dev del proyecto; los stakeholders no lo ven) y para los agentes conectados en su nombre; public aparece también en el centro de ayuda público de la empresa, que tiene su propio llms.txt (y llms-full.txt, con todos los textos) para chatbots y RAG sin login. La búsqueda (search_docs, GET /docs/search) devuelve fragmentos por sección, sin distinguir tildes.