Conceitos

Conceitos

Organização, projeto, fluxo de status, perfis, severidade, horas e documentos.

  • Organização: a empresa cliente. Os dados de uma organização nunca aparecem em outra.
  • Plataforma: a equipe da Aquarela que administra o tracker. O dono da plataforma define o que cada pessoa vê ou gerencia (empresas, suporte, convites, créditos de IA, registro); empresa suspensa fica sem acesso até ser reativada.
  • Beta: o tracker está em beta, com acesso por convite. A equipe da plataforma gera o convite do beta (create_beta_invite, POST /beta-invites); quem usa cria a conta e a própria empresa, e o convite registra quem convidou quem.
  • Projeto: tem um prefixo (ex.: MOB) usado no código das issues (MOB-0001), tipos de issue, labels, módulos e campos personalizados próprios.
  • Fluxo de status: cada projeto tem os seus status, cada um num grupo (todo, in_progress, done), com os perfis que podem mover para ele e de quais status ele pode vir. Projetos começam no modelo Software + QA (Triagem, A fazer, Fazendo, Em revisão, Em teste, Feito, Cancelado), no modelo Software (A fazer, Fazendo, Em revisão, Feito) ou no modelo QA (Rascunho, Aberto, Triagem, Priorizado, Em desenvolvimento, Pronto para QA, Em reteste, Aprovado, Reprovado, Concluído e Fechado). "Em aberto" é tudo que não está no grupo done.
  • Reteste: o QA registra o resultado com versão e dispositivo. No Software + QA, passar leva para Feito e reprovar devolve para A fazer com a marca de reprovada (retest_failed), até passar; no modelo QA, vai para Aprovado ou Reprovado.
  • Fechado (modelo QA): um status só para o que fecha sem resolver, com o motivo (close_reason: duplicada, cancelada, não reproduzida ou não será feita).
  • Bloqueio: uma marca na issue, com o motivo, que vale em qualquer status e fluxo (não é uma coluna). Filtre com blocked_only ou bloqueio = sim na consulta avançada.
  • Projetos criados antes desses fluxos continuam com os status antigos (Em reteste, Aprovado, Reprovado, Bloqueado, Reaberto, Duplicado...) até alguém pedir "Simplificar o fluxo" em Configurações > Fluxo de status.
  • Severidade: S1 (crítica) a S4 (baixa), impacto técnico. Prioridade: urgent, high, medium, low, importância de negócio.
  • Horas: cada issue tem estimativa, início e prazo, e registros de horas (quem, dia, quanto, o que fez). Restante = estimativa menos o registrado. Duração em texto: "2h", "1h30", "45m", "1d" (8 h).
  • Documentos: a base de conhecimento da empresa (manuais, regras de negócio, FAQs, processos), em markdown, da empresa toda ou de um projeto. Rascunho (draft) só quem edita vê; internal vale para a equipe (admins e quem é PO/PM, QA ou dev do projeto; stakeholders não veem) e para os agentes conectados em nome dela; public aparece também na central de ajuda pública da empresa, que tem o próprio llms.txt (e llms-full.txt, com todos os textos) para chatbots e RAG sem login. A busca (search_docs, GET /docs/search) devolve trechos por seção, sem diferenciar acento.