KP Business¶

Documentação interna do produto: o que cada módulo faz, quais regras de negócio valem, quais decisões já foram tomadas e o que ainda está aberto.

A marca é KP Business

O repositório e parte dos arquivos ainda se chamam kpmentoring. A marca mudou em 12/08/2026. A entidade de negócio Mentoria continua com esse nome e não deve ser renomeada.

Produto

Visão geral, glossário, perfis de acesso e o registro de decisões.

Começar aqui
Módulos

Atendimento, CRM, Vendas, Agenda e Cadastros.

Navegar
Integrações

Evolution API para WhatsApp e o ClickUp.

Conferir
Design

Identidade, componentes e padrões de interface.

Ver o sistema

Estado de cada módulo¶

O que está em produção, o que está só desenhado e o que não existe. Esta tabela é a primeira coisa a atualizar quando uma feature entra.

Módulo	Estado	Onde vive
Atendimento WhatsApp	Em produção	`whatsapp_*`, Evolution API
CRM Comercial	Em produção	`crm_*`, 12 etapas, pipelines
Vendas e contratos	Em produção	`contracts`, `contract_items`
Agenda e sessões	Em produção	`sessions`, `calendar_tasks`
Cadastros	Em produção	Mentoria, Especialidade, Sessão
Importação ClickUp	Em produção	Motor próprio, mão única
Sincronização ClickUp	A descontinuar	`clickup_*`, merge de 3 vias
Tracking	Em produção	`tracking_*`, link curto `/l/CODIGO`
Atendimento Instagram	Só desenho	Instagram só existe como origem de lead

Instagram não existe no sistema

O atendimento por Instagram foi desenhado em sessões de design e aparece em handoffs, mas não há código. Instagram existe apenas como origem de lead e como tipo de rede social no cadastro, nunca como canal de mensagem. Quem for planejar em cima disso começa do zero.

O Tracking, que estava na mesma situação, foi construído e entrou em produção em 2026-09-13. Ver Tracking.

Por onde começar, segundo o que você faz¶

Se você…	Leia
Vai mexer em qualquer código	Decisões de arquitetura
Vai mexer em autorização	Perfis de acesso
Vai mexer em tela	Padrões de interface
Vai publicar	Ambientes e deploy

Como contribuir¶

Edite o .md correspondente em documentacao/docs/.
Rode mkdocs serve e confira o resultado.
Abra o PR descrevendo o que mudou de regra, não só o que mudou de texto.

Convenções de escrita, nomes de página e onde registrar decisão estão em Padrões de interface.