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	Só desenho	Nada implementado
Atendimento Instagram	Só desenho	Instagram só existe como origem de lead

Tracking e Instagram não existem no sistema

Os dois foram desenhados em sessões de design e aparecem 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.

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.