Pular para conteúdo

Glossário

Um termo, uma definição. Onde o vocabulário do negócio e o do banco divergem, os dois aparecem.

Termo Definição
Mentoria O produto final da empresa, composto por Sessões ordenadas e Entregáveis. No banco é products.
Especialidade A área de atuação de um tutor, como Vendas ou Comunicação. No banco é specialties.
Sessão de catálogo Entidade de primeira classe, com duração, especialidade, tutores habilitados e preço avulso.
Entregável O que o aluno recebe além das sessões. product_deliverables no catálogo, student_deliverables quando já é de alguém.
Pacote Não existe. Foi removido do vocabulário e do banco na reestruturação do catálogo.

Dois nomes que o sistema já trocou

O sistema chamava de "Mentoria" o que na verdade era a Especialidade, e chamava de "Pacote" o que hoje é a Mentoria. A correção foi condição do cliente para ativar a produção. Texto antigo que use esses nomes está errado, não desatualizado.

Comercial

Termo Definição
Lead Contato em processo comercial. crm_leads.
Pipeline Um funil. Cada um tem suas próprias etapas e sua própria autorização.
Etapa Posição do lead dentro de um pipeline. São 12.
Papel da etapa (role) A semântica da etapa, usada por métricas e marcos. Nunca o slug nem a posição (AD-008).
Origem De onde o lead veio. 27 opções espelhadas do ClickUp.
Contrato O registro da venda. contracts.
Pacote congelado O que foi efetivamente vendido, gravado em contract_items no fechamento (AD-017).
Prazo de referência contracts.end_date, congelado no fechamento e imóvel.
Prazo real effective_end_date, que só muda por prorrogação explícita (AD-018).

Atendimento

Termo Definição
Instância Um número de WhatsApp conectado, com seu próprio token. whatsapp_instances.
Natureza do número empresarial ou pessoal. Decide o alcance da supervisão.
Número compartilhado Instância com mais de uma pessoa cadastrada para atender.
Dono da conversa Quem assumiu aquela conversa. Conversa de grupo não tem dono.
Fila Consulta, não tabela: as conversas sem dono que o usuário alcança.
Captura Assumir uma conversa da fila. Resolvida por corrida no banco.
Devolução Conversa parada volta para a fila, por tempo configurável.
Regra de ação Frase reconhecida numa mensagem que dispara um efeito, como criar tarefa.
Efeito O que uma ação faz, em classe própria registrada no ActionEffectRegistry (AD-015).

Agenda

Termo Definição
Sessão do aluno Ocorrência agendada. sessions.
Compromisso Tarefa de agenda que não é sessão de aluno. calendar_tasks.
Disponibilidade Janela em que o tutor aceita agendamento. tutor_availability.
Slot agendável Horário concreto derivado da disponibilidade. tutor_bookable_slots.
Liberação de agenda Ato do tutor de abrir um período. tutor_schedule_releases.

Acesso

Termo Definição
Perfil Conjunto de permissões atribuído a um usuário. São cinco de fábrica.
Permissão Uma tela e uma ação nela, no formato módulo.tela.ação. Descreve tela, nunca registro.
Vínculo Tabela que liga um perfil ou usuário a um registro e carrega as habilidades como colunas (AD-016).
Tela inicial Onde cada perfil começa depois do login. Declarada por perfil.

Permissão e vínculo não são a mesma coisa

Permissão responde "esta pessoa abre esta tela". Vínculo responde "esta pessoa pode agir sobre este registro". Confundir os dois produziu dois defeitos em produção numa semana. Ver AD-020.